Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Composable tool registry - stores and queries tool definitions.

Unlike the CLI’s registry which auto-registers all tools, this registry is empty by default. Callers compose it by registering tools from whichever modules they need.

Example

use brainwires_tools::{ToolRegistry, BashTool, FileOpsTool, GitTool};

let mut registry = ToolRegistry::new();
registry.register_tools(BashTool::get_tools());
registry.register_tools(FileOpsTool::get_tools());
registry.register_tools(GitTool::get_tools());

Implementations

impl ToolRegistry

pub const CORE_TOOL_NAMES: &'static [&'static str]

Core tool names used for basic project exploration. Exposed so callers can extend the default set with extras from config without forking the list. Keep alphabetised so the serialised tools array is a stable prefix — that is what makes the Anthropic prompt cache break points in brainwires_providers::anthropic actually land cache hits.

pub fn new() -> Self

Create an empty registry

pub fn with_builtins() -> Self

Create a registry pre-populated with all built-in tools

pub fn register(&mut self, tool: Tool)

Register a single tool

pub fn register_tools(&mut self, tools: Vec<Tool>)

Register multiple tools at once

pub fn get_all(&self) -> &[Tool]

Get all registered tools

pub fn get_all_with_extra(&self, extra: &[Tool]) -> Vec<Tool>

Get all tools including additional external tools (e.g., MCP tools)

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

Look up a tool by name

pub fn get_initial_tools(&self) -> Vec<&Tool>

Get tools that should be loaded initially (defer_loading = false)

pub fn get_deferred_tools(&self) -> Vec<&Tool>

Get only deferred tools (defer_loading = true)

pub fn search_tools(&self, query: &str) -> Vec<&Tool>

Search tools by query string matching name and description

pub fn get_by_category(&self, category: ToolCategory) -> Vec<&Tool>

Get tools by category

pub fn get_all_with_mcp(&self, mcp_tools: &[Tool]) -> Vec<Tool>

Get all tools including MCP tools

pub fn get_core(&self) -> Vec<&Tool>

Get core tools for basic project exploration, returned in the canonical order defined by CORE_TOOL_NAMES so the resulting tools array is byte-stable across turns.

pub fn get_core_with_extras(&self, extra_names: &[String]) -> Vec<&Tool>

Get core tools plus any extras named by extra_names (deduplicated, extras appended after core in the order given). Unknown names are silently skipped.

pub fn get_primary(&self) -> Vec<&Tool>

Get primary meta-tools (always available)

pub fn filtered_view(&self, allow: &[&str]) -> Vec<Tool>

Return a filtered view containing only the named tools.

Useful when constructing a provider call for a constrained agent role — the caller supplies the allow-list (e.g. from AgentRole::allowed_tools) and receives only the matching Tool definitions.

Tools not present in the registry are silently skipped, so the list may be shorter than allow if some tools are not registered.

pub fn len(&self) -> usize

Total number of registered tools

pub fn is_empty(&self) -> bool

Whether the registry is empty

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.