Expand description
Dynamic subagent definitions, sessions, and management tools.
Subagents let an engine delegate focused work to named worker agents with their own instructions, allowed tools, resource tags, optional output schemas, and optional long-lived session state. This module also owns session compaction and background progress forwarding for those workers.
Structs§
- Background
Task Info - Metadata tracked for a background task running inside a subagent session.
- Execution
Identity - Stable worker instance identity, independent of its reusable definition and session alias.
- SubAgent
- Configurable worker agent that can be registered at runtime.
- SubAgent
Args - Arguments used to run a subagent.
- SubAgent
Checkpoint - Idle-only snapshot. It contains no provider raw history or executable permissions.
- SubAgent
Checkpoints - Optional host state enabling checkpoint persistence and idle-only restoration.
- SubAgent
Conversation Recorder - Persistent conversation recorder used by subagents when installed in context state.
- SubAgent
Event - Compact event; full conversation history never enters the event channel.
- SubAgent
Events - Result of an event read or bounded wait.
- SubAgent
Handoff - Explicit, single-generation inherited context. Install on the invocation context; subagents consume it without forwarding it automatically to their own children.
- SubAgent
Limits - Host policy shared by a root execution and all of its workers.
- SubAgent
Manager - Tool and registry for creating, updating, loading, and running subagents.
- SubAgent
Manager Args - Arguments accepted by the subagent manager tool.
- SubAgent
Message - Attributed worker data. The envelope is not a new user authorization.
- SubAgent
Scope - Host-created task scope. Install a clone in context state to continue the same root task.
- SubAgent
SetManager - Type-indexed collection of subagent registries.
- SubSession
- Long-lived conversation session for a subagent.
- SubSession
Status - Live progress snapshot for a subagent session.
- SubSessions
- Registry of active subagent sessions for one subagent definition.
Enums§
- Message
Delivery - Whether input may start an idle worker.
- SubAgent
Event Kind - Lifecycle events distinguish a completed work turn from a closed session.
- Wait
Mode - Condition used by
SubAgentScope::wait.
Traits§
- Checkpoint
Store - Storage for resumable idle snapshots, separate from audit conversation records.
- Conversation
Records - Persistence seam for subagent conversation records.
- SubAgent
Set - Object-safe registry interface for groups of subagents.