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 tool_names(&self) -> Vec<&str>

Return the list of registered tool names.

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.