task-manager

Task Manager

Use task_manager as the team lead's durable control plane. It is scoped to the current workflow execution and only permits assignment to agents connected to this lead's input-teammates handle.

Required workflow

1. Call list_tasks with include_history=true before assigning work so you do not duplicate a mission from an earlier workflow execution.
2. Split independent work into bounded tasks with explicit acceptance criteria.
3. Call assign_task once per mission. Use the connected teammate node ID or the exact delegate name reported by the lead's available teammate list. Do not call delegate_to_* directly; delegate descriptors are internal dispatch identities, not the lead's task-creation interface.
4. Independent tasks may be assigned together. The durable queue starts at most three descendants across the whole agent tree; excess tasks remain queued. After assign_task returns queued, report that delegation started and return immediately. Do not poll or wait in the assigning invocation.
5. When a teammate submits work or an attempt fails, call get_task, then use inspect_task_trace before retrying, reassigning, or reporting a terminal failure. Start with detail="summary"; use failures or a paginated timeline only when the summary does not explain the outcome. For large histories use detail="search" with a narrow query, inspect the returned context lines, and follow next_cursor until the match is found or the cursor is empty. Prefer categories and all_terms over broad searches. Copy task.id to task_id and task.revision to expected_revision for the review mutation.
6. Choose exactly one review outcome:
   • accept_task when the result satisfies the task;
   • modify_task for blocked or queued work;
   • retry_task when the mission is still valid;
   • reassign_task to another connected teammate with revision context;
   • cancel_task when the work is no longer needed.
7. Call finish_team only after every required task is accepted or intentionally cancelled. Synthesize accepted results in the final report and disclose any unresolved failure.