Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

A name-keyed collection of Tool implementations.

The registry owns Arc-wrapped tools and is passed to a BasicToolExecutor (or consumed by ToolCapabilityProvider) so the agent loop can look up tools by name at execution time.

Example

use agentkit_tools_core::ToolRegistry;

let registry = ToolRegistry::new()
    .with(NoopTool(ToolSpec::new(
        ToolName::new("noop"),
        "Does nothing",
        json!({"type": "object"}),
    )));

assert!(registry.get(&ToolName::new("noop")).is_some());
assert_eq!(registry.specs().len(), 1);

Implementations

impl ToolRegistry

pub fn new() -> Self

Creates an empty registry.

pub fn register<T>(&mut self, tool: T) -> &mut Self

where T: Tool + 'static,

Registers a tool by value and returns &mut self for imperative chaining.

pub fn with<T>(self, tool: T) -> Self

where T: Tool + 'static,

Registers a tool by value and returns self for builder-style chaining.

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

Registers a pre-wrapped Arc<dyn Tool>.

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

Looks up a tool by name, returning None if not registered.

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

Returns all registered tools as a Vec.

pub fn merge(self, other: Self) -> Self

Merges all tools from another registry into this one, consuming it.

Supports builder-style chaining:

let registry = agentkit_tool_fs::registry()
    .merge(agentkit_tool_shell::registry());

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

Returns the ToolSpec for every registered tool.

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 Default for ToolRegistry

fn default() -> ToolRegistry

Returns the “default value” for a type.

impl ToolSource for ToolRegistry

fn specs(&self) -> Vec<ToolSpec>

Returns the current spec for every tool in this source.

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

Looks up a tool by name, returning None if not present.

fn drain_catalog_events(&self) -> Vec<ToolCatalogEvent>

Drains pending catalog change events. Static sources return an empty list; dynamic sources surface added/removed/changed batches that the loop forwards to the model on the next turn.

fn prefixed(self, prefix: impl Into<String>) -> Prefixed<Self>

where Self: Sized,

Wraps this source so every advertised tool name is prefixed with <prefix>_. Useful for mounting the same source under multiple namespaces, or for avoiding collisions between MCP catalogs.

fn filtered<F>(self, predicate: F) -> Filtered<Self, F>

where Self: Sized, F: Fn(&ToolName) -> bool + Send + Sync + 'static,

Wraps this source so only tools whose name passes predicate are advertised and resolvable. Tools rejected by the predicate are invisible to the model and return None on lookup.

fn renamed<I>(self, mapping: I) -> Renamed<Self>

where Self: Sized, I: IntoIterator<Item = (ToolName, ToolName)>,

Wraps this source with a name remapping. Each (original, new) pair in mapping causes the tool to be advertised as new and resolved from new back to original on lookup. Tools not in the mapping pass through unchanged.