Struct McpToolWrapper 

pub struct McpToolWrapper { /* private fields */ }

A zeroclaw Tool backed by an MCP server tool. The prefixed_name (e.g. filesystem__read_file) is what the agent loop sees. The registry knows how to route it to the correct server.

security is the execution-scope SecurityPolicy snapshot (source of truth for workspace_dir) — an immutable Arc, not a reloadable live handle. The workspace path is resolved from it at execute time, not cached.

Implementations

impl McpToolWrapper

pub fn new( prefixed_name: String, def: McpToolDef, registry: Arc<McpRegistry>, security: Arc<SecurityPolicy>, ) -> Self

Trait Implementations

impl Attributable for McpToolWrapper

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 McpToolWrapper

fn spec(&self) -> ToolSpec

Override the default: hand out the stored schema by Arc::clone (pointer copy + refcount increment) instead of deep-cloning it. MCP schemas can be tens of KB and specs are rebuilt every agent-loop iteration, so this is the hot path of

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.