Struct Tool 

pub struct Tool {
    pub name: String,
    pub description: String,
    pub input_schema: Value,
    pub source: ToolSource,
    pub execute: ExecuteFn,
    pub hints: Option<ToolHints>,
    pub concurrency_safe: Option<ConcurrencySafeFn>,
    pub output_schema: Option<Value>,
    pub annotations: Option<ToolAnnotations>,
}

A named, described, schema’d callable (SPEC §1).

Fields

name: String

description: String

input_schema: Value

JSON-Schema object for the arguments.

source: ToolSource

execute: ExecuteFn

hints: Option<ToolHints>

Advisory hints (read-only / destructive / open-world); None = unknown.

concurrency_safe: Option<ConcurrencySafeFn>

Decides per call whether this tool may run alongside other safe calls of the same model response (SPEC §8 “Tool scheduling”). None ⇒ safe only when hints.read_only. See is_concurrency_safe.

output_schema: Option<Value>

JSON Schema of ToolResult::structured (§1). MCP serve advertises it as outputSchema; None ⇒ omitted.

annotations: Option<ToolAnnotations>

MCP annotations, passed through verbatim by the MCP handler (else derived from hints, else omitted). Never sent to the model.

Implementations

impl Tool

pub fn with_output_schema(self, schema: Value) -> Self

This tool with an output schema (§1).

pub fn with_annotations(self, annotations: ToolAnnotations) -> Self

This tool with MCP annotations (§7C.1).

pub fn with_concurrency_safe( self, f: impl Fn(&Value) -> bool + Send + Sync + 'static, ) -> Self

This tool with a per-call concurrency-safety predicate.

impl Tool

pub async fn call(&self, args: Value, ctx: ToolContext) -> ToolResult

Run the tool. A missing/null args value is passed as {}.

Trait Implementations

impl Clone for Tool

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Tool

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

Formats the value using the given formatter.