human_needed

Raise a decision you are waiting on a human for - it appears as a todo in the dashboard and pauses that branch of work until a person resolves it. Use this the moment you hit a choice that is the founder's to make (never guess a business rule): merge vs keep-separate, an ambiguous source, an irreversible action. Provide clear options when there is a discrete set. Free (0 credits).

Parameters

Name	Type		Description
project_uuid	string	optional	Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
session_id	string	optional	Agent session id returned by session_start. Optional: defaults to this server's active session, so you normally omit it after calling session_start.
question	string	required	The decision, phrased for a human, e.g. "Merge duplicate 'Save' keys or keep them separate?".
detail	string	optional	Optional context that helps the human decide.
deep_link	string	optional	Optional relative dashboard path to the thing needing attention; defaults to the session thread.
options	array	optional	Optional suggested choices, e.g. ['merge', 'keep separate'].

Example

{
  "tool": "human_needed",
  "arguments": {
    "question": "<question>"
  }
}