Trait ToolDyn 

pub trait ToolDyn: Send + Sync {
    // Required methods
    fn name(&self) -> &str;
    fn description(&self) -> &str;
    fn input_schema(&self) -> Value;
    fn call(
        &self,
        input: Value,
    ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + '_>>;

    // Provided methods
    fn maybe_streaming(&self) -> Option<&dyn ToolDynStreaming> { ... }
    fn concurrency_hint(&self) -> ToolConcurrencyHint { ... }
}

Object-safe trait for tool implementations.

Any tool source (local function, MCP server, HTTP endpoint) implements this trait. Tools are stored as Arc<dyn ToolDyn> in ToolRegistry.

Required Methods

fn name(&self) -> &str

The tool’s unique name.

fn description(&self) -> &str

Human-readable description of what the tool does.

fn input_schema(&self) -> Value

JSON Schema for the tool’s input parameters.

fn call( &self, input: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + '_>>

Execute the tool with the given input.

Provided Methods

fn maybe_streaming(&self) -> Option<&dyn ToolDynStreaming>

If this tool also supports streaming, return a reference to its streaming interface. Default is None; streaming is opt-in and non-disruptive.

fn concurrency_hint(&self) -> ToolConcurrencyHint

Optional concurrency hint used by planners/deciders.

Default is Exclusive to preserve backward-compatible behavior.

Implementors

impl ToolDyn for AliasedTool