Call first when considering delegation or heterogeneous execution. Lists configured local agent names, optional live availability probes, facade tools, and execution limits so you can decide whether and how to delegate.

Create a managed child agent for a self-contained subtask that benefits from parallel work, a different agent runtime, specialization, or independent review. Call cs_agent_capabilities before choosing an agent; do not delegate trivial or tightly coupled work.

Inspect managed agents in the caller's delegation subtree before creating duplicates or when coordinating parallel work. Supports filtering and cursor pagination; it cannot reveal sibling or ancestor subtrees.

Inspect one managed agent's lifecycle, queue, pending permission, last error, and runtime state. Use it to diagnose a delegated task before deciding to wait, respond to permission, cancel, or retry.

Read or briefly wait for structured delegation events after an opaque cursor. Use for progress monitoring across agents or turns when a reply-oriented cs_agent_wait_message call is not sufficient.

Assign a self-contained task to a managed descendant agent. Include the objective, scope, constraints, expected deliverable, and verification criteria; the idempotency key makes retries safe. For parallel work, send all independent turns before waiting with cs_agent_wait_many.

Read one immutable delegated request or reply message when you already have its id. Use cs_agent_wait_message instead when waiting for an unfinished task.

Preferred blocking wait after cs_agent_send for one turn. For multiple turns, send all independent turns first and use cs_agent_wait_many. Returns a terminal reply, a permission request requiring cs_agent_respond_permission, a terminal turn without a reply, or a bounded timeout.

Wait for multiple turns after you send all independent turns first. Mode any returns all currently ready items; mode all waits until every turn is terminal but returns early for permissions or timeout. Accumulate ready items by turnId and continue with pendingTurnIds after an interrupted all wait.

Read one immutable-point-in-time turn snapshot by id. Use it for detailed state, revision, error, and permission diagnostics without waiting.

Wait for a turn revision, permission request, or terminal state. Use this instead of cs_agent_wait_message when state transitions matter more than reply content.

Resolve a pending permission request surfaced by wait or status. Apply least privilege: prefer one-time approval unless repeated access is explicitly intended; rejection or cancel can stop delegated work.

Cancel obsolete, unsafe, or no-longer-needed queued or active work, including unfinished descendant turns. This is a destructive control action; inspect status first when the outcome is uncertain.

Destroy a managed agent after its work is complete or abandoned, optionally cascading through descendants and discarding its session. This releases the managed lifecycle and is destructive.