Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Registry for managing tools with tiered visibility.

All tools are always executable. Tier controls which definitions are sent to the LLM to save prompt tokens on simple tasks.

Implementations

impl ToolRegistry

pub fn new() -> Self

Create a new empty registry

pub fn with_defaults(workspace_root: PathBuf) -> Self

Create a registry with all default tools, assigned to tiers.

Core (always in LLM prompt): bash, read/write/edit, ast_grep, glob/grep Standard (in prompt by default): git, agents Extended (in prompt after first use): ripgrep, fd, sd, erd, mise, zoxide

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

Register a tool at Standard tier (default)

pub fn register_with_tier(&mut self, tool: Arc<dyn Tool>, tier: ToolTier)

Register a tool at a specific tier

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

Get a tool by name

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

Check if a tool exists

pub async fn execute(&self, name: &str, args: Value) -> Result<Value>

Execute a tool by name

pub fn get_definitions(&self) -> Vec<ToolDefinition>

Get tool definitions visible to the LLM (Core + Standard + activated Extended). Extended tools become visible after first use or explicit activation.

pub fn select_for_query( &self, query: &str, max_tools: usize, ) -> Vec<ToolDefinition>

Dynamic tool selection — pick the most relevant tools for a given query.

Returns Core tools (always) + top-K scored Standard/Extended tools based on keyword matching between the query and tool names/descriptions. This reduces 22+ tools to ~8-10, making MCP and extended tools visible.

pub fn get_all_definitions(&self) -> Vec<ToolDefinition>

Get ALL tool definitions regardless of tier (for tests and introspection)

pub fn activate(&self, name: &str)

Activate an extended tool (makes it visible to the LLM)

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

Get tool names

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.