Struct SpawnAgentTool 

pub struct SpawnAgentTool { /* private fields */ }

Tool that spawns a nested agent through a shared SessionHost.

This is the dynamic delegation entry point for a parent agent’s ReAct loop: the model calls spawn_agent, the tool blocks until the child finishes, and the child’s output is returned as the tool result.

Nesting depth is derived from ToolCallContext::spawn_depth: a top-level session turn spawns at depth 0; a host-spawned agent at depth d spawns at d + 1.

Implementations

impl SpawnAgentTool

pub fn new(host: Arc<dyn SessionHost>) -> Self

Bind to a host.

pub const fn with_default_capability(self, mode: CapabilityMode) -> Self

Default capability mode for children when the model omits it.

pub fn with_allowed_agent_types( self, types: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Restrict spawnable agent_type values (W5.3). Empty allowlist rejects all typed spawns.

Trait Implementations

impl Debug for SpawnAgentTool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DynTool for SpawnAgentTool

fn name(&self) -> &'static str

Tool name.

fn description(&self) -> &'static str

Description.

fn parameters(&self) -> Value

JSON schema parameters.

fn metadata(&self) -> ToolMetadata

Metadata.

fn call<'life0, 'async_trait>( &'life0 self, ctx: ToolCallContext, arguments: Value, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, MachiError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute with JSON arguments (blocking convenience).

fn definition(&self) -> ToolDefinition

Model-facing definition.

fn execute<'life0, 'async_trait>( &'life0 self, ctx: ToolCallContext, arguments: Value, ) -> Pin<Box<dyn Future<Output = Pin<Box<dyn Stream<Item = ToolStreamItem> + Send>>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Streaming entry point. Default wraps DynTool::call as a single terminal.