Struct TypedTool 

pub struct TypedTool<H>(pub H);

Wraps a typed ToolHandler as a type-erased DynTool.

This adapter is where erasure happens for native Rust tools: call_json deserializes the incoming Value into the handler’s Input, calls the typed handler, and serializes its Output back to a Value. A Suspension passes through untouched.

A newtype wrapper is used rather than a blanket impl<H: ToolHandler> DynTool for H, so that MCP-backed tools remain free to implement DynTool directly for their own types without a coherence conflict.

ToolSet::register wraps handlers in this automatically, so most callers never name it.

Tuple Fields

0: H

Implementations

impl<H> TypedTool<H>

pub fn new(handler: H) -> Self

Wraps a handler.

Trait Implementations

impl<H: ToolHandler> DynTool for TypedTool<H>

fn idempotency_key(&self, input: &Value) -> Option<String>

Forwards to the typed ToolHandler::idempotency_key, which sees the deserialized input rather than raw JSON.

The input is deserialized a second time here, once per keyed dispatch, because the key is needed before call_json runs and that is where the first deserialization happens. Input that does not deserialize yields None: the dispatch below is about to reject it as ToolError::InvalidInput anyway, and a call that cannot run has no effect to name.

fn name(&self) -> &str

The name the model calls this tool by.

fn description(&self) -> &str

The human-readable description handed to the model.

fn effect(&self) -> Effect

The side-effect class governing retry and resume behavior.

fn input_schema(&self) -> Value

The JSON Schema the tool’s input must satisfy.

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

The JSON Schema a completion for this tool must satisfy, if the tool declares one. Provided, defaulting to None, so no existing implementor of this trait breaks.

fn call_json<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 ToolCtx, input: Value, ) -> Pin<Box<dyn Future<Output = Result<ToolOutcome<Value>, ToolError>> + Send + 'async_trait>>

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

Dispatches the tool with JSON input, returning JSON output or a suspension.

fn descriptor(&self) -> ToolDescriptor

A cloneable metadata snapshot for handing to a model. Provided; built from the accessors above.