Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of available tools for the agent loop.

Implementations

impl ToolRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn with_cache(self, cache: Arc<dyn ToolCache>) -> Self

Attach a tool result cache.

pub fn register(&mut self, spec: ToolSpec)

Register a tool. Overwrites any existing tool with the same name.

pub fn register_tools(&mut self, specs: impl IntoIterator<Item = ToolSpec>)

Register multiple tools at once.

Equivalent to calling register for each spec in order. Duplicate names overwrite earlier entries.

pub fn with_tool(self, spec: ToolSpec) -> Self

Fluent builder: register a tool and return self.

Allows chaining multiple registrations:

use llm_agent_runtime::agent::{ToolRegistry, ToolSpec};

let registry = ToolRegistry::new()
    .with_tool(ToolSpec::new("search", "Search", |args| args.clone()))
    .with_tool(ToolSpec::new("calc", "Calculate", |args| args.clone()));

pub async fn call( &self, name: &str, args: Value, ) -> Result<Value, AgentRuntimeError>

Call a tool by name.

Errors

• AgentRuntimeError::AgentLoop — tool not found, required field missing, or custom validator rejected the arguments
• AgentRuntimeError::CircuitOpen — the tool’s circuit breaker is open (only possible when the orchestrator feature is enabled)

pub fn get(&self, name: &str) -> Option<&ToolSpec>

Look up a registered tool by name. Returns None if not registered.

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

Return true if a tool with the given name is registered.

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

Remove a tool by name. Returns true if the tool was registered.

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

Return the list of registered tool names.

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

Return all registered tool names as owned Strings.

Unlike tool_names this does not borrow self, making the result usable after the registry is moved or mutated.

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

Return all registered tool names sorted alphabetically.

Useful for deterministic output in help text, diagnostics, or tests.

pub fn tool_specs(&self) -> Vec<&ToolSpec>

Return references to all registered ToolSpecs.

pub fn filter_tools<F: Fn(&ToolSpec) -> bool>(&self, pred: F) -> Vec<&ToolSpec>

Return references to all ToolSpecs that satisfy the given predicate.

Example

let registry = ToolRegistry::new();
let long_desc: Vec<_> = registry.filter_tools(|s| s.description.len() > 20);

pub fn rename_tool( &mut self, old_name: &str, new_name: impl Into<String>, ) -> bool

Rename a registered tool from old_name to new_name.

The tool’s name field and its registry key are both updated. Returns true if the tool was found and renamed, false if old_name is not registered. If new_name is already registered, it is overwritten.

pub fn tool_count(&self) -> usize

Return the number of registered tools.

pub fn is_empty(&self) -> bool

Return true if no tools are registered.

pub fn clear(&mut self)

Remove all registered tools.

Useful for resetting the registry between test runs or for dynamic agent reconfiguration.

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

Remove a tool from the registry by name.

Returns Some(spec) if the tool was registered, None if not found.

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

Return true if a tool with the given name is registered.

pub fn descriptions(&self) -> Vec<(&str, &str)>

Return (name, description) pairs for all registered tools, sorted by name.

Useful for generating help text or logging the tool set at startup.

pub fn find_by_description_keyword(&self, keyword: &str) -> Vec<&ToolSpec>

Return references to all tool specs whose description contains keyword (case-insensitive).

pub fn tool_count_with_required_fields(&self) -> usize

Return the number of tools that have at least one required field.

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

Return the names of all registered tools, sorted alphabetically.

pub fn tool_names_starting_with(&self, prefix: &str) -> Vec<&str>

Return the names of all registered tools whose name starts with prefix, sorted alphabetically.

pub fn description_for(&self, name: &str) -> Option<&str>

Return the description of the tool with the given name, or None if no such tool is registered.

pub fn count_with_description_containing(&self, keyword: &str) -> usize

Return the count of tools whose description contains keyword (case-insensitive).

pub fn unregister_all(&mut self)

Remove all registered tools.

pub fn names_containing(&self, substring: &str) -> Vec<&str>

Return a sorted list of tool names that contain substring (case-insensitive).

pub fn shortest_description(&self) -> Option<&str>

Return the description of the tool with the shortest description string.

Returns None if the registry is empty.

pub fn longest_description(&self) -> Option<&str>

Return the description of the tool with the longest description string.

Returns None if the registry is empty.

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

Return a sorted list of all tool descriptions.

pub fn tool_names_with_keyword(&self, keyword: &str) -> Vec<&str>

Return the names of tools whose description contains keyword (case-insensitive).

pub fn avg_description_length(&self) -> f64

Return the mean byte length of all tool descriptions.

Returns 0.0 if the registry is empty.

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

Return all registered tool names in ascending sorted order.

pub fn description_contains_count(&self, keyword: &str) -> usize

Return the count of tools whose description contains keyword (case-insensitive).

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() -> Self

Returns the “default value” for a type.