Jeden/Docs

CLI command

jeden todo answer

Answer, from a blocked task, the ask it waits on.

Exact invocation#

Shell
jeden todo answer <task-id> --revision <n> --text "answer" [--session <id-or-path>] [--json]

Inputs and options#

  • Optional --session &lt;id-or-path&gt; selects a recorded session; otherwise the workspace's latest session is used. --json returns the authoritative completion snapshot.
  • --revision must match the latest snapshot. --text is your answer: the value, the decision, or where you put the secret. Over RPC the same operation is session/completion/control with action answer and the answer in reason; Jeden Desktop shows a Your answer field under the task.

Output and state effect#

A task blocks with an ask when the independent review finds that only you can supply what it needs: a secret, a credential, a decision, a value that exists in no file. The ask goes into the operator ask register (jeden asks) and onto the task, and the session stops as waiting_for_operator instead of retrying. Answering from the task answers that register ask: the answer is recorded once with its time and handed to this task and to every other task, in any session, waiting on the same ask; each returns to pending, and the next todo continue hands the agent your words as yours. The review refuses to block a task again on an answered ask unless a step of the task failed after your answer. The agent has no way to answer its own ask.

Refusals and boundaries#

  • Without a selected session in a workspace that recorded none: jeden.session.find.last-session-unrecorded (finding the last session of &lt;cwd&gt; for jeden todo: … no session is recorded for &lt;cwd&gt; yet, fix: name one with --session &lt;id-or-path&gt;), exit 1. A recorded last session that is gone is session-not-found of the same functionality.
  • A stale revision is jeden.completion.state.revision-changed, naming the revision the change was asked of and the one the state is at, with the jeden todo list to read it again; nothing is changed.
  • Missing fields are jeden.completion.command.control-incomplete (exit 2), naming --text and --revision; blank text is jeden.completion.asks.answer.answer-blank (exit 2).
  • A task is answered as jeden.completion.control: an unknown id is id-unknown; completed or cancelled work is task-terminal; a task that asked nothing is answer-unasked (fix: resume it with a reason); a task already holding its answer is answer-taken, naming when and what was answered.
  • When the register ask was already answered elsewhere: jeden.completion.asks.answer.answer-held, naming when and the answer; todo continue hands that answer to the task. An answer recorded that the task did not take is answer-untaken, with what the delivery said.
  • A command line of the wrong form (an unknown command or option, a missing, unexpected or invalid argument, a missing confirmation) prints the error and the usage and exits 2; a refusal that retrying unchanged can help (a dependency down or not answering, a rate limit) exits 69; any other refusal or failure exits 1. A refusal a functionality declares ends with fix: … and cause: &lt;operation&gt;.&lt;cause&gt;, and jeden errors show &lt;operation&gt; lists every cause of that functionality.