devin-subagents
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tasks | {
"requests": {
"tools": {
"call": {}
}
}
} |
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| spawnA | Create a new Devin session and start it on a task in the background. Returns immediately; use poll to watch progress. Multiple subagents can run in parallel. |
| sendA | Send a follow-up prompt to a subagent. While a turn is running the message is queued in FIFO order and starts as the next turn once the current one finishes (turns are strictly serialized per session). Stopped/dead subagents must be resumed first. |
| pollA | Two observation modes. detail='inspect' (default): a persistent snapshot of what the subagent is doing — lifecycle fields, pending permission, current/latest turn timing and duration, last actual output, active tool calls (merged by id, with elapsed ms), current plan step, latest text, latest error, and last-activity/last-content ages. It is independent of the event log: unaffected by reads or by buffer eviction. detail='logs': the chronological normalized event log (message/thinking/tool/plan/usage/mode/queued/turn_start/turn_end/permission_*) with seq and bridge receipt timestamps, paged by an implicit read cursor; 'limit' bounds each page and nextCursor/hasMore continue it, droppedEvents counts buffer-evicted events. 'since': in inspect mode, a snapshot cursor — wait_ms blocks for events newer than it; in logs mode it replays events after that seq without moving the read cursor. wait_ms blocks briefly while a turn can still produce events. |
| waitA | Block until the subagent needs you, then return what happened. Wakes on: turn drained to idle (wake='done'), a pending permission request (wake='permission' — answer via the permission tool), a report() checkpoint from the subagent (wake='report' — a report is delivered once, even if it arrived before this call), terminal states (wake='stopped'/'dead'), or timeout (wake='timeout', snapshot shows live state). Already-attention states return immediately, so it doubles as 'is it done?'. On hosts supporting MCP tasks this runs as a background task; elsewhere it blocks. |
| interruptA | Cancel the in-flight turn (ACP session/cancel) and drop queued messages. The session stays alive and resumable. |
| stopA | Interrupt any running turn, drop queued messages and mark the subagent stopped. The session is kept and can be continued later with resume. |
| resumeA | Re-activate a stopped/dead/persisted Devin session (survives bridge restarts). Safe no-op on already-running subagents. |
| listA | List live, persisted, and agent-side sessions with status. |
| permissionA | Grant or deny a pending tool-permission request surfaced by poll (used when permission=operator — the calling agent decides). Pass optionId to approve, omit to deny. |
| set_modeA | Switch the session's mode (e.g. 'bypass', 'smart'). Validated against the session's advertised availableModes when known. |
| modelsA | With 'name': the session's current model/mode and the agent-advertised available lists. Without: the bridge's configured defaults plus the last-advertised agent-level lists (null until the first session is created). Devin model ids are e.g. swe-2-medium / swe-2-high / swe-2-max. |
| set_modelA | Switch an idle session's model via session/set_config_option and confirm the echoed value (e.g. 'swe-2-high'). Rejected while the session is starting/running/stopped/dead — resume or wait for idle first. Validated against the advertised model list when known. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools have distinct purposes: spawn creates sessions, send queues prompts, poll and wait observe but in different modes (snapshot vs. event log vs. blocking on attention), interrupt/stop/resume manage lifecycle, list enumerates, permission handles approvals, set_mode/set_model configure. Minor overlap between poll and wait (both report on state) but their interfaces are distinct enough to disambiguate.
Most are short imperative verbs (spawn, send, poll, wait, interrupt, stop, resume, list, permission) with a few two-word names (set_mode, set_model). The style is consistent (all lowercase, underscore for compound names), but the verbs are not a predictable verb_noun pattern (e.g., no create_session vs. list_sessions). Some naming like 'permission' is a noun rather than a verb (grant_permission would be clearer).
Twelve tools is well-scoped for a subagent management server. Each tool addresses a distinct lifecycle aspect: creation, communication, observation, control, listing, permission, and configuration. No redundancy in count, and the size supports both granular control and ease of discovery.
The surface covers the full lifecycle: create (spawn), interact (send), observe (poll/wait), control (interrupt/stop/resume), enumerate (list), authorize (permission), and configure (set_mode/set_model). Missing features like killing without resume or session cleanup are not core gaps; they're likely handled via stop and resume. The tool set is comprehensive for subagent management.