Struct ToolSearchTool 

pub struct ToolSearchTool { /* private fields */ }

Fetches full schemas for admitted deferred built-ins and MCP tools.

Implementations

impl ToolSearchTool

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

The native creator’s callable name; ownership is claimed on creation.

pub fn new( deferred: DeferredMcpToolSet, activated: Arc<Mutex<ActivatedToolSet>>, ) -> ToolSearchTool

pub fn for_builtin_schemas( activated: Arc<Mutex<ActivatedToolSet>>, ) -> ToolSearchTool

Built-in schema discovery requires no MCP registry or executable wrapper.

pub fn with_access_policy(self, policy: ToolAccessPolicy) -> ToolSearchTool

pub fn with_activation_hook( self, hook: Arc<dyn Fn(Arc<dyn Tool>) + Send + Sync>, ) -> ToolSearchTool

pub fn narrow_to_caller(&self, allowed: &[String])

Remove revoked schemas and activated tools together. Recovering a poisoned guard is safe here because every surviving entry is checked against the current ceiling before execution can resume.

pub fn deferred_prompt_section(&self) -> String

Advertise only still-loadable, not-yet-activated tools, from the same registry used by both keyword search and exact selection.

Trait Implementations

impl Attributable for ToolSearchTool

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 ToolSearchTool

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, ToolSearchTool: 'async_trait,

Execute the tool with given arguments

fn requires_unrestricted_principal(&self) -> bool

True when this tool starts nested execution without carrying the RPC principal’s current tool and agent ceilings. Constrained RPC sessions must omit it. Wrappers forward the target’s value so a renamed skill cannot bypass that restriction. This describes implementation support, not a stored authorization decision.

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 execute_with_context<'life0, 'life1, 'async_trait>( &'life0 self, args: Value, context: &'life1 ToolExecutionContext, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, Error>> + Send + 'async_trait>>

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

Execute with turn-scoped cancellation while preserving legacy tools. Tools that start child work can override this method to pass the context or a child token explicitly, and use ToolExecutionContext::run to scope and cancel their execution future.

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.