Struct DelegateTool 

pub struct DelegateTool { /* private fields */ }

Implementations

impl DelegateTool

pub const NAME: &'static str = "delegate"

Canonical tool name. Referenced by REENTRANT_AGENT_TOOLS so a rename cannot desync the two.

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

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

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

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, ) -> Self

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

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

pub fn with_runtime(self, runtime: Arc<dyn RuntimeAdapter>) -> Self

Attach the runtime adapter used to build target-owned tools for independent agentic delegation.

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

Attach multimodal configuration for sub-agent tool loops.

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

Attach global delegate tool configuration for default timeout values.

pub fn parent_tools_handle(&self) -> Arc<RwLock<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) -> Self

Attach the workspace directory for system prompt enrichment.

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

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>) -> Self

Attach memory for namespace isolation on delegate agents.

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

Attach nested model provider map for brain resolution.

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

Attach risk profiles for depth/timeout resolution.

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

Attach runtime profiles for agentic/tools/iteration resolution.

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

Attach skill bundles for skills-directory resolution.

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

Attach the loaded root config so DelegateTool can resolve delegate reachability, target mode, and per-target SecurityPolicy from the canonical agent config at delegate time.

pub fn with_live_config(self, live_config: Option<Arc<RwLock<Config>>>) -> Self

Attach the daemon’s shared live-config handle alongside Self::with_root_config.

with_root_config supplies the snapshot this tool reads synchronously (reachability, target mode, per-target policy). This supplies the handle that every nested registry built for a delegated target needs so its per-execution resolvers follow reloads. Passing None is the documented one-shot behavior and keeps the snapshot fallback; dropping the handle when the caller has one silently pins delegated plugin tools to startup config for the parent’s whole lifetime.

pub fn with_caller_alias(self, alias: impl Into<String>) -> Self

Set the owning agent’s alias so it can be excluded from the advertised delegation roster (an agent must never delegate to itself).

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

fn tool_provenance(&self) -> ToolProvenance

Classifies whether a tool implementation is first-party native code or an extension. The conservative default prevents a new wrapper from inheriting native presentation privileges accidentally.

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>> + Send + 'async_trait>>

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

Execute the tool with given arguments

fn output_schema(&self) -> Option<Value>

JSON schema describing the structured output this tool attaches to ToolOutput::data, when it declares one. None means the tool emits display text only; authoring surfaces fall back to sample-derived shapes from captured runs.

fn param_domains(&self) -> Vec<(&'static str, OptionDomain)>

Option domains for parameters whose value sets live in runtime config rather than the static schema (channel refs, peer targets, …). Surfaces resolve these through the runtime to render real selectable choices. Default: no domain-typed parameters.

fn invocation_triggers(&self) -> Vec<String>

Lowercase phrases that suggest an inbound message wants this tool — e.g. routing wording or configured destination names for a delivery tool. A pre-turn prefilter may scan the message against these and nudge the model to consider the tool; the tool itself is never called by the prefilter.

fn spec(&self) -> ToolSpec

Assemble this tool’s spec. The default recomposes it from parameters_schema() and allocates a fresh Arc per call, so tools with large stored schemas override it to hand out Arc::clone instead (see McpToolWrapper). Delegating wrappers around a dyn Tool MUST forward spec() to the inner tool — relying on this default silently reintroduces a per-iteration deep clone of the inner schema and breaks Arc identity for downstream sharing.