Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry that stores tools by name and provides lookup + schema listing.

Example

let mut registry = ToolRegistry::new();
registry.register(my_search_tool)?;
registry.register(my_calculator_tool)?;

// Get schemas for LLM prompt
let schemas = registry.schemas();

// Look up tool for execution
let tool = registry.get("search").unwrap();
let result = tool.execute(input).await?;

Implementations

impl ToolRegistry

pub fn new() -> Self

Create an empty registry.

pub fn register( &mut self, tool: impl Tool + 'static, ) -> Result<&mut Self, PeError>

Register a tool with typed duplicate-name handling.

pub fn register_arc( &mut self, tool: Arc<dyn Tool>, ) -> Result<&mut Self, PeError>

Register a pre-wrapped Arc<dyn Tool> with typed duplicate-name handling.

pub fn try_register( &mut self, tool: impl Tool + 'static, ) -> Result<&mut Self, PeError>

Fallible registration path for dynamic/runtime-owned insertion.

pub fn try_register_arc( &mut self, tool: Arc<dyn Tool>, ) -> Result<&mut Self, PeError>

Fallible registration path for pre-wrapped Arc<dyn Tool>.

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

Get a tool by name.

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

Produce ToolSchema list for the LLM — all registered tools.

pub fn filter(&self, names: &[&str]) -> ToolRegistry

Create a subset registry containing only tools with the given names. Used by ToolPolicy::filter() to enforce per-agent tool allowlists. Tools not found in this registry are silently skipped.

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

All registered tool names.

pub fn len(&self) -> usize

Number of registered tools.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

Trait Implementations

impl Clone for ToolRegistry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolRegistry

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

Formats the value using the given formatter.

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.