Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Available on crate feature async only.

In-memory registry of tools keyed by name.

Names must be unique; registering twice with the same name replaces the existing entry. Use Self::contains to check first when overwrite is undesired.

Implementations

impl ToolRegistry

pub fn new() -> Self

An empty registry.

pub fn register_tool<T: Tool>(&mut self, tool: T) -> &mut Self

Register a value that implements Tool directly. Useful for tools that have their own state or non-trivial logic worth giving a dedicated type.

pub fn register<F, Fut>( &mut self, name: impl Into<String>, schema: Value, handler: F, ) -> &mut Self

where F: Fn(Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, ToolError>> + Send + 'static,

Register a closure-based tool. The closure receives the model’s raw input as a serde_json::Value and returns the tool result. Use ToolError::invalid_input for input-shape failures and ToolError::execution to wrap any other error type.

Example

use claude_api::tool_dispatch::ToolRegistry;
use serde_json::json;

let mut registry = ToolRegistry::new();
registry.register(
    "echo",
    json!({"type": "object", "properties": {"text": {"type": "string"}}}),
    |input| async move { Ok(input) },
);
assert!(registry.contains("echo"));

pub fn register_described<F, Fut>( &mut self, name: impl Into<String>, description: impl Into<String>, schema: Value, handler: F, ) -> &mut Self

where F: Fn(Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, ToolError>> + Send + 'static,

Like Self::register but also attaches a description.

pub fn get(&self, name: &str) -> Option<&Arc<dyn Tool>>

Borrow a registered tool by name.

pub fn contains(&self, name: &str) -> bool

Whether a tool with the given name is registered.

pub fn len(&self) -> usize

Number of registered tools.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

pub fn names(&self) -> impl Iterator<Item = &str>

Iterator over registered tool names.

pub fn to_messages_tools(&self) -> Vec<MessagesTool>

Build the Vec<MessagesTool> you pass to CreateMessageRequestBuilder::tools. Includes name, description, and schema for every registered tool.

pub async fn dispatch( &self, name: &str, input: Value, ) -> Result<Value, ToolError>

Look up a tool by name and invoke it with the given input.

Returns ToolError::Unknown if no tool by that name is registered. Other errors are propagated from the tool’s invoke impl.

impl ToolRegistry

pub fn register_typed<A, F, Fut>( &mut self, name: impl Into<String>, handler: F, ) -> &mut Self

where A: JsonSchema + DeserializeOwned + Send + Sync + 'static, F: Fn(A) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, ToolError>> + Send + 'static,

Available on crate feature schemars-tools only.

Register a tool with a typed input struct.

The schema is generated from A via schemars, and the model’s raw Value input is deserialized into A before the handler runs. Deserialization failures surface as ToolError::InvalidInput so the model can self-correct.

pub fn register_typed_described<A, F, Fut>( &mut self, name: impl Into<String>, description: impl Into<String>, handler: F, ) -> &mut Self

where A: JsonSchema + DeserializeOwned + Send + Sync + 'static, F: Fn(A) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, ToolError>> + Send + 'static,

Available on crate feature schemars-tools only.

Like Self::register_typed but also attaches a description.

Trait Implementations

impl Debug for ToolRegistry

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

Formats the value using the given formatter.

impl Default for ToolRegistry

fn default() -> ToolRegistry

Returns the “default value” for a type.