Struct ToolRegistry 

pub struct ToolRegistry<Ctx> { /* private fields */ }

Registry of available tools.

Tools are stored with their names erased to allow different Name types in the same registry. The registry uses string-based lookup for LLM compatibility.

Supports both synchronous Tools and asynchronous AsyncTools.

Implementations

impl<Ctx: Send + Sync + 'static> ToolRegistry<Ctx>

pub fn new() -> Self

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

where T: Tool<Ctx> + 'static,

Register a synchronous tool in the registry.

The tool’s name is converted to a string via serde serialization and used as the lookup key.

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

where T: AsyncTool<Ctx> + 'static,

Register an async tool in the registry.

Async tools have two phases: execute (lightweight, starts operation) and check_status (streams progress until completion).

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

where T: ListenExecuteTool<Ctx> + 'static,

Register a listen/execute tool in the registry.

Listen/execute tools start by streaming updates via listen(), then run final execution with execute() once confirmed.

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

Get a synchronous tool by name.

pub fn get_async(&self, name: &str) -> Option<&Arc<dyn ErasedAsyncTool<Ctx>>>

Get an async tool by name.

pub fn get_listen(&self, name: &str) -> Option<&Arc<dyn ErasedListenTool<Ctx>>>

Get a listen/execute tool by name.

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

Check if a tool name refers to an async tool.

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

Check if a tool name refers to a listen/execute tool.

pub fn all(&self) -> impl Iterator<Item = &Arc<dyn ErasedTool<Ctx>>>

Get all registered synchronous tools.

pub fn all_async(&self) -> impl Iterator<Item = &Arc<dyn ErasedAsyncTool<Ctx>>>

Get all registered async tools.

pub fn all_listen( &self, ) -> impl Iterator<Item = &Arc<dyn ErasedListenTool<Ctx>>>

Get all registered listen/execute tools.

pub fn len(&self) -> usize

Get the number of registered tools (sync + async).

pub fn is_empty(&self) -> bool

Check if the registry is empty.

pub fn filter<F>(&mut self, predicate: F)

where F: Fn(&str) -> bool,

Filter tools by a predicate.

Removes tools for which the predicate returns false. The predicate receives the tool name. Applies to both sync and async tools.

Example

registry.filter(|name| name != "bash");

pub fn to_llm_tools(&self) -> Vec<Tool>

Convert all tools (sync + async) to LLM tool definitions.

Trait Implementations

impl<Ctx> Clone for ToolRegistry<Ctx>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Ctx: Send + Sync + 'static> Default for ToolRegistry<Ctx>

fn default() -> Self

Returns the “default value” for a type.