Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry of tools available to an agent.

Implementations

impl ToolRegistry

pub fn new() -> Self

An empty registry.

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

Register a tool, compiling its schemas; duplicate or invalid tools are rejected.

pub fn extend(&mut self, other: &Self) -> Result<(), String>

Merge another registry; conflicting names are rejected.

pub fn is_empty(&self) -> bool

Whether no tools are registered.

pub fn len(&self) -> usize

Number of registered tools.

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

Whether name (internal or model form) is registered.

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

Look up a tool by internal or model name.

pub fn validate_arguments( &self, name: &str, arguments: &Value, ) -> Result<(), String>

Validate arguments against the tool’s schema.

pub fn validate_output(&self, name: &str, output: &Value) -> Result<(), String>

Validate a result against the tool’s output schema.

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

Stable tool names for validation, diagnostics, and capability policy.

pub fn confirmation_required_names(&self) -> impl Iterator<Item = &str>

Tools whose metadata requires confirmation.

pub fn filtered<'a>(&self, allowed: impl IntoIterator<Item = &'a str>) -> Self

Return a registry containing only explicitly allowed tools.

pub fn specs(&self) -> Vec<LlmTool>

LLM-facing tool specs for the tools field of a completion request.

pub fn runtime_manifest(&self) -> Result<Vec<Value>, String>

Stable implementation and execution contract persisted by profile revisions.

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

Best-effort canonical name for case mistakes or an alphabetic junk prefix glued to a registered tool name.

pub async fn execute_with_context( &self, name: &str, context: &ToolExecutionContext, args: Value, ) -> Result<Value, String>

Validate, execute and validate the result of one tool call.

pub fn canonical_name<'a>(&'a self, name: &'a str) -> Option<&'a str>

Internal name for an internal or model-facing name.

Trait Implementations

impl Clone for ToolRegistry

fn clone(&self) -> ToolRegistry

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

Returns the “default value” for a type.