Struct DelegateTool 

pub struct DelegateTool { /* private fields */ }

Tool that delegates a subtask to a named agent with a different model_provider/model configuration. Enables multi-agent workflows where a primary agent can hand off specialized work (research, coding, summarization) to purpose-built sub-agents.

Supports three execution modes:

• Synchronous (default): blocks until the sub-agent completes.
• Background (background: true): spawns the sub-agent in a tokio task and returns a task_id immediately.
• Parallel (parallel: [...]): runs multiple agents concurrently and returns all results.

Background results are persisted to workspace/delegate_results/{task_id}.json and can be retrieved via action: "check_result".

Implementations

impl DelegateTool

pub fn new( agents: HashMap<String, AliasedAgentConfig>, global_credential: Option<String>, security: Arc<SecurityPolicy>, ) -> DelegateTool

pub fn new_with_options( agents: HashMap<String, AliasedAgentConfig>, global_credential: Option<String>, security: Arc<SecurityPolicy>, provider_runtime_options: ModelProviderRuntimeOptions, ) -> DelegateTool

pub fn with_depth( agents: HashMap<String, AliasedAgentConfig>, global_credential: Option<String>, security: Arc<SecurityPolicy>, depth: u32, ) -> DelegateTool

Create a DelegateTool for a sub-agent (with incremented depth). When sub-agents eventually get their own tool registry, construct their DelegateTool via this method with depth: parent.depth + 1.

pub fn with_depth_and_options( agents: HashMap<String, AliasedAgentConfig>, global_credential: Option<String>, security: Arc<SecurityPolicy>, depth: u32, provider_runtime_options: ModelProviderRuntimeOptions, ) -> DelegateTool

pub fn with_parent_tools( self, parent_tools: Arc<RwLock<RawRwLock, Vec<Arc<dyn Tool>>>>, ) -> DelegateTool

Attach parent tools used to build sub-agent allowlist registries.

pub fn with_multimodal_config(self, config: MultimodalConfig) -> DelegateTool

Attach multimodal configuration for sub-agent tool loops.

pub fn with_delegate_config(self, config: DelegateToolConfig) -> DelegateTool

Attach global delegate tool configuration for default timeout values.

pub fn parent_tools_handle(&self) -> Arc<RwLock<RawRwLock, Vec<Arc<dyn Tool>>>>

Return a shared handle to the parent tools list. Callers can push additional tools (e.g. MCP wrappers) after construction.

pub fn with_workspace_dir(self, workspace_dir: PathBuf) -> DelegateTool

Attach the workspace directory for system prompt enrichment.

pub fn with_cancellation_token(self, token: CancellationToken) -> DelegateTool

Attach a cancellation token for cascade control of background tasks. When the token is cancelled, all background sub-agents are aborted.

pub fn cancellation_token(&self) -> &CancellationToken

Return the cancellation token for external cascade control.

pub fn with_memory(self, memory: Arc<dyn Memory>) -> DelegateTool

Attach memory for namespace isolation on delegate agents.

pub fn with_providers_models( self, m: HashMap<String, HashMap<String, ModelProviderConfig>>, ) -> DelegateTool

Attach nested model provider map for brain resolution.

pub fn with_risk_profiles( self, m: HashMap<String, RiskProfileConfig>, ) -> DelegateTool

Attach risk profiles for depth/timeout resolution.

pub fn with_runtime_profiles( self, m: HashMap<String, RuntimeProfileConfig>, ) -> DelegateTool

Attach runtime profiles for agentic/tools/iteration resolution.

pub fn with_skill_bundles( self, m: HashMap<String, SkillBundleConfig>, ) -> DelegateTool

Attach skill bundles for skills-directory resolution.

pub fn with_root_config(self, config: Arc<Config>) -> DelegateTool

Attach the loaded root config so DelegateTool can resolve a per-target SecurityPolicy at delegate time, validate it as a subset of the caller’s policy, and share the caller’s PerSenderTracker with the delegated run.

impl DelegateTool

pub fn cancel_all_background_tasks(&self)

Cancel all background tasks (cascade control). Call this when the parent session ends.

Trait Implementations

impl Attributable for DelegateTool

fn role(&self) -> Role

fn alias(&self) -> &str

impl Tool for DelegateTool

fn name(&self) -> &str

Tool name (used in LLM function calling)

fn description(&self) -> &str

Human-readable description

fn parameters_schema(&self) -> Value

JSON schema for parameters

fn execute<'life0, 'async_trait>( &'life0 self, args: Value, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, DelegateTool: 'async_trait,

Execute the tool with given arguments

fn spec(&self) -> ToolSpec

Get the full spec for LLM registration