Skip to main content

Module subagents

Module subagents 

Source
Expand description

Subagent declaration shapes. Pure data - no callbacks.

SubagentDefinition and its nested types reach no CLI path today: the initialize control_request’s agents field was the only one. SubagentEffort and EffortPreset share this module and are separate: they have their own path through Options::effort, which the argv builder emits as --effort.

Re-exportsΒ§

use serde::Deserialize; πŸ”’
use serde::Deserialize; πŸ”’
use serde::Serialize; πŸ”’
use serde::Serialize; πŸ”’
use serde_json::Value; πŸ”’
use crate::options::PermissionMode; πŸ”’

ModulesΒ§

inline_mcp_server πŸ”’

StructsΒ§

SubagentDefinition

EnumsΒ§

EffortPreset
Named reasoning-effort presets. Wire shape: Literal["low","medium","high","max"].
SubagentEffort
Reasoning-effort hint on a subagent. Wire shape: Literal["low","medium","high","max"] | int. Named SubagentEffort to disambiguate from the runtime model effort in forge_primitives::runtime::EffortLevel.
SubagentMcpServerRef
One entry in SubagentDefinition::mcp_servers. Either the name of an MCP server configured at the top level, or an inline {name: config} object. Matches the CLI’s list[str | dict[str, Any]] type.
SubagentMemory
CLAUDE.md scope surfaced to a subagent. Wire shape: Literal["user", "project", "local"].