Struct GroupedRegistry 

pub struct GroupedRegistry { /* private fields */ }

A tool registry that organizes tools into named groups with group-level activation and deactivation.

Only tools in active groups are returned by get_tools(), while find_tool() searches all groups (active or not) to ensure tool execution is always possible even for deactivated groups.

Uses RwLock for interior mutability — group switching is safe from &self.

Example

use traitclaw_core::registries::GroupedRegistry;
use traitclaw_core::traits::tool_registry::ToolRegistry;

let registry = GroupedRegistry::new();
assert!(registry.is_empty());

use traitclaw_core::registries::GroupedRegistry;
use traitclaw_core::traits::tool_registry::ToolRegistry;

let registry = GroupedRegistry::new()
    // .group("search", vec![web_search, deep_search])
    // .group("code", vec![read_file, write_file])
    .activate("search");

// Only "search" tools are returned by get_tools()
// But find_tool() can still find "code" tools

Implementations

impl GroupedRegistry

pub fn new() -> GroupedRegistry

Create an empty grouped registry.

pub fn group( self, name: impl Into<String>, tools: Vec<Arc<dyn ErasedTool>>, ) -> GroupedRegistry

Add a named group of tools.

Tools are provided as Arc<dyn ErasedTool>. The group is not activated automatically — call activate() to enable it.

If a group with the same name already exists, it is replaced.

pub fn activate(self, name: impl Into<String>) -> GroupedRegistry

Activate a group, making its tools visible via get_tools().

Multiple groups can be active simultaneously. Activating an already-active group is a no-op.

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

Activate a group at runtime (non-builder).

Returns true if the group exists and was activated.

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

Deactivate a group at runtime.

Returns true if the group was previously active.

pub fn group_names(&self) -> Vec<String>

Get the names of all registered groups.

pub fn active_group_names(&self) -> Vec<String>

Get the names of currently active groups.

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

Check if a specific group is currently active.

Trait Implementations

impl Default for GroupedRegistry

fn default() -> GroupedRegistry

Returns the “default value” for a type.

impl ToolRegistry for GroupedRegistry

fn get_tools(&self) -> Vec<Arc<dyn ErasedTool>>

Returns tools from active groups only.

fn find_tool(&self, name: &str) -> Option<Arc<dyn ErasedTool>>

Searches all groups (active or not) for a tool by name.

This allows tool execution even when the tool’s group is deactivated.

fn len(&self) -> usize

Returns the number of tools in active groups only.

fn is_empty(&self) -> bool

Check if the registry has no enabled tools.

fn register(&self, _tool: Arc<dyn ErasedTool>) -> bool

Register a new tool. Returns true if the tool was added.

fn unregister(&self, _name: &str) -> bool

Unregister a tool by name. Returns true if the tool was removed.

fn set_enabled(&self, _name: &str, _enabled: bool) -> bool

Enable or disable a tool by name. Returns true if the state changed.

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

Check if a tool is currently enabled.