Assemble an agent for a task and store it in the pool under agent_key, returning the stored entry — the create/update entry point an orchestrating agent uses to stand up a new pooled agent (or re-assemble an existing one).

Return the pooled entry stored under agent_key, or None when the pool holds no such entry.

A safe probe: returns None rather than raising when the id is absent, so an orchestrating agent can check existence without handling an error.

Return every pooled agent, most-recently-updated first.

Returns: Every stored pool entry, newest-updated first.

Rediscover pooled agents by re-describing the problem, ranked most-relevant first — the fuzzy path for when the exact agent_key isn't at hand.

Remove the pooled entry stored under agent_key.

This is also the legitimate dismissal path for a teammate: deleting its teammate.* entry discards its standing conversation, and the next run_teammate call re-creates it fresh from its roster template. No guard against the teammate namespace here — unlike create_agent/run_agent, dismissal is intentional deletion, not accidental bypass. Dismissing a teammate with a live run discards that run's record along with the entry, and the still-running background task dies unrecorded when it eventually finishes or fails.

Return every run recorded for agent_key, most-recently-started first.

Return one run record by its run_id, or None when the pool holds no such run.

A safe probe, mirroring get_agent: returns None rather than raising when the id is absent, so an orchestrating agent can check existence without handling an error.

List every agent that ran within one run and the real, resumable session id each was given.

This is how an orchestrating agent discovers the independently-resumable session_id of every agent — the run's main/supervisor agent and any subagents it dispatched — that participated in a specific run_id (obtained from list_runs, get_run, or a RunOutcome). Each captured session id can then be used to resume that one agent's conversation on its own, independently of the others, later.

Return the pooled agent's findings oldest-first — the assembled-document reading order.

Run the pooled agent live and record every agent that participates. The entry's first-ever run starts a fresh session; later runs resume it. Requires the claude CLI at runtime.

Every run is granted the full capability set — for the main agent and, when named, for each dispatched subagent: fan-out subagents (resolved from their own pool entries and wired in via with_subagents), the run-scoped findings-writer (with_findings_tool), and dynamic capability acquisition (with_acquire_tool). The findings tool needs the run id at wiring time, so the run is started here and its id handed to run_with_capture rather than minted inside it.