docs: updated agent docs to include renamed agent__list -> agent__list_running and the new agent__list_available functions

2026-07-22 13:22:19 -06:00
parent 66384bebb4
commit 971ab6a85f
+8 -7
@@ -559,13 +559,14 @@ escalation_timeout: 600
When `can_spawn_agents` is enabled, the agent receives tools for spawning and managing child agents: When `can_spawn_agents` is enabled, the agent receives tools for spawning and managing child agents:
| Tool | Description | | Tool | Description |
|------------------|-------------------------------------------------------------------------| |-------------------------|------------------------------------------------------------------------------------------------------------------------|
| `agent__spawn` | Spawn a child agent in the background. Returns an agent ID immediately. | | `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__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__collect` | Blocking wait: wait for an agent to finish, return its output. |
| `agent__list` | List all spawned agents and their status. | | `agent__list_available` | List all agent types installed and available to spawn (name + description). Discovery counterpart to `agent__spawn`. |
| `agent__cancel` | Cancel a running agent by ID. | | `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**: The core pattern is **Spawn -> Continue -> Collect**: