From 971ab6a85f2d0c15b36770e8166517694423c165 Mon Sep 17 00:00:00 2001 From: Alex Clarke Date: Wed, 22 Jul 2026 13:22:19 -0600 Subject: [PATCH] docs: updated agent docs to include renamed agent__list -> agent__list_running and the new agent__list_available functions --- Agents.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Agents.md b/Agents.md index 5ec6b9c..3b3871c 100644 --- a/Agents.md +++ b/Agents.md @@ -559,13 +559,14 @@ escalation_timeout: 600 When `can_spawn_agents` is enabled, the agent receives tools for spawning and managing child agents: -| Tool | Description | -|------------------|-------------------------------------------------------------------------| -| `agent__spawn` | Spawn a child agent in the background. Returns an agent ID immediately. | -| `agent__check` | Non-blocking check: is the agent done? Returns `PENDING` or the result. | -| `agent__collect` | Blocking wait: wait for an agent to finish, return its output. | -| `agent__list` | List all spawned agents and their status. | -| `agent__cancel` | Cancel a running agent by ID. | +| Tool | Description | +|-------------------------|------------------------------------------------------------------------------------------------------------------------| +| `agent__spawn` | Spawn a child agent in the background. Returns an agent ID immediately. | +| `agent__check` | Non-blocking check: is the agent done? Returns `PENDING` or the result. | +| `agent__collect` | Blocking wait: wait for an agent to finish, return its output. | +| `agent__list_available` | List all agent types installed and available to spawn (name + description). Discovery counterpart to `agent__spawn`. | +| `agent__list_running` | List all subagents you have spawned, with their status. | +| `agent__cancel` | Cancel a running agent by ID. | The core pattern is **Spawn -> Continue -> Collect**: @@ -865,4 +866,4 @@ path table and the [official sbx mixin reference](https://docs.docker.com/ai/san installs/domains they bring. Not a bug, just visibility. - **The `sql` agent's `usql` install is in the base kit, not a per-agent mixin.** Same for `pandoc` (used by `fetch_url_via_curl`). Both ship with every Coyote sandbox automatically. See `assets/sbx-kit/spec.yaml` for the - full base prereq list. \ No newline at end of file + full base prereq list.