Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry for dynamically registered tools.

The registry provides:

• O(1) tool lookup by name
• Collision detection (no duplicate names)
• Bulk operations (list, export)
• Format conversion for OpenAI/Anthropic

Thread Safety

The registry itself is not thread-safe. Wrap in Arc<RwLock<ToolRegistry>> if you need concurrent access. Tools within the registry are Arc<dyn Tool>.

Example

let mut registry = ToolRegistry::new();
registry.register(Arc::new(MyCalculatorTool::new()));

if let Some(tool) = registry.get("calculator") {
    let result = tool.execute(json!({"expr": "2+2"})).await?;
}

Implementations

impl ToolRegistry

pub fn new() -> Self

Create an empty registry

pub fn register(&mut self, tool: Arc<dyn Tool>) -> bool

Register a tool.

Returns

true if the tool was added, false if a tool with that name already exists.

Security

Name collisions are rejected to prevent tool impersonation attacks.

pub fn register_replace(&mut self, tool: Arc<dyn Tool>)

Register a tool, replacing any existing tool with the same name.

Security Warning

Use with caution — this can replace trusted tools with untrusted ones.

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

Get a tool by name

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

Check if a tool exists

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

Remove a tool by name

pub fn names(&self) -> Vec<&str>

List all tool names

pub fn definitions(&self) -> Vec<&ToolDefinition>

List all tool definitions

pub fn to_openai_format(&self) -> Vec<Value>

Generate OpenAI-compatible tool list

pub fn to_anthropic_format(&self) -> Vec<Value>

Generate Anthropic Claude-compatible tool list

pub fn len(&self) -> usize

Number of registered tools

pub fn is_empty(&self) -> bool

Check if registry is empty

pub fn available(&self) -> Vec<Arc<dyn Tool>>

Get available tools only (where is_available() returns true)

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.