Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Composable tool registry — stores and queries tool definitions.

This registry is empty by default; callers compose it by registering tools from whichever modules they need. The umbrella brainwires-tools crate provides a registry_with_builtins() helper that pre-populates one with every concrete builtin (BashTool, FileOpsTool, …).

Example

use brainwires_tool_runtime::ToolRegistry;
// From brainwires-tool-builtins (concrete tools + registry helper):
// use brainwires_tool_builtins::{registry_with_builtins, BashTool};

let mut registry = ToolRegistry::new();
// registry.register_tools(BashTool::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_provider::anthropic actually land cache hits.

pub fn new() -> Self

Create an empty registry

pub fn with_runtime_meta_tools() -> Self

Always-available tools — currently just the meta tool_search. The concrete builtins are not in this crate; use brainwires_tool_builtins::registry_with_builtins() for a pre-populated registry, or call Self::register_tools manually.

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 semantic_search_tools( &self, query: &str, limit: usize, min_score: f32, ) -> Result<Vec<(&Tool, f32)>>

Search tools by semantic similarity using embeddings.

Returns tools with their similarity scores, sorted by relevance. Requires the rag feature to be enabled.

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.