Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Thread-safe tool registry.

Manages a collection of tools with concurrent access support. Uses a DashMap for lock-free concurrent operations.

Features

• Thread-safe registration and lookup
• Tool schema generation for LLM
• Global singleton registry support

Example

let registry = ToolRegistry::new();

// Register tools
registry.register(ReadFileTool::new())?;
registry.register(WriteFileTool::new())?;

// List all tool schemas
let schemas = registry.list_tools();

// Get and execute a tool
if let Some(tool) = registry.get("read_file") {
    let result = tool.execute(json!({"path": "test.txt"})).await?;
}

Implementations

impl ToolRegistry

pub fn new() -> ToolRegistry

Create a new empty tool registry.

pub fn register<T>(&self, tool: T) -> Result<(), RegistryError>

where T: Tool + 'static,

Register a tool in the registry.

Arguments

• tool - Tool to register

Errors

Returns RegistryError::DuplicateTool if tool name already exists. Returns RegistryError::InvalidTool if tool name is empty.

Example

registry.register(MyTool::new())?;

pub fn register_shared(&self, tool: Arc<dyn Tool>) -> Result<(), RegistryError>

Register a shared tool reference.

Arguments

• tool - Shared tool reference

Errors

Same as register.

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

Get a tool by name.

Arguments

• name - Tool name

Returns

Shared tool reference if found, None otherwise.

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

Check if a tool exists in the registry.

pub fn list_tools(&self) -> Vec<ToolSchema>

List all tool schemas.

Returns schemas sorted alphabetically by tool name.

pub fn list_tool_names(&self) -> Vec<String>

List all tool names.

Returns names sorted alphabetically.

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

Remove a tool from the registry.

Returns

true if tool was removed, false if not found.

pub fn len(&self) -> usize

Get the number of registered tools.

pub fn is_empty(&self) -> bool

Check if registry is empty.

pub fn clear(&self)

Remove all tools from the registry.

Trait Implementations

impl Default for ToolRegistry

fn default() -> ToolRegistry

Returns the “default value” for a type.