Start a work session for a project goal. mode "outside" = bounded autonomous run (no human; requires budgetMinutes, the total wall-clock autonomy for the whole session, not per task). mode "desk" = human in the loop. Returns a sessionId handle (pass it to every other tool), a repository snapshot and analysis instructions. Next: analyze the project, then update_work_graph.

List recorded sessions (newest first) with state, budget and open decision counts. Use to find a session to inspect or resume.

Current state, mode, budget, unit counts, in-flight units and run history of one session.

The phase goal, exit criteria and constraints this session owns, progress toward it, and the project context recorded during analysis.

Pause an active session. Stops the budget clock and keeps in-flight claims. Optional handoff notes.

Resume a paused, halted or interrupted session from its handoff. Optionally switch mode (desk/outside) and add budget. Recovers in-flight units of an interrupted run (they return to pending with their checkpoints). Returns the handoff.

End the current run. In-flight units are released with their checkpoints and the session is classified (resumable, waiting_for_human, blocked or completed). markFailed: true ends it permanently as failed. Returns the final report.

Units with status, derived readiness and root causes (decision:, blocker:, failure:, cancelled:), plus dependency edges. Filter: all | remaining | ready | in_progress | done.

Add or update units (upsert by id), cancel or reopen units, and record project context (summary, key files, commands). The first call submits the initial plan. Rejected as a whole if ids, references or dependencies are invalid or cyclic. Units added after the initial plan need a rationale. Never add work only to use remaining budget.

Re-evaluate the graph, budget and policy and claim the next work. action "execute" = do the dispatched units (direct, or parallel with subagents when justified); "wait" = finish in-flight units first; "plan" = analysis/graph needed; "stop" = the run is over (budget spent, waiting for human, blocked, or completed). Call after every report_work. Only "stop" ends an OUTSIDE_MODE run.

Report a claimed unit: progress (checkpoint), completed (requires validation evidence), failed, blocked (requires blocker), or released. Completed with failing checks counts as a failed attempt. Then call next_work: a finished unit never ends the session.

Queue a question that needs human judgment (architecture, product, scope, security...). Never guess instead. Affected units wait; everything else continues. Returns impact and the independent work that can proceed. Does not block and does not wait for an answer.

The decision queue, most blocking first, with why each matters, options, the agent suggestion and blocked/independent work.

Record a decision made by a human (or withdraw a question that no longer applies). Only call with the human's explicit answer. Refused while an OUTSIDE_MODE run is active. Releases the units the decision gated.

Exactly where to pick up: state and why, decisions needed (most blocking first), in-flight checkpoints, ready units, blocked units with causes, completed work, project context, repository state and ordered next actions. Start DESK_MODE here.

Session report: outcome, budget used and why any was left unused, completed work with validation evidence, unresolved work, decisions, parallel dispatches and their rationale, scope added mid-session, and next steps.