Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Canonical tool registry — single source of truth.

Implementations

impl ToolRegistry

pub fn new() -> Self

pub async fn register(&self, entry: ToolEntry)

Register a tool. Overwrites if already present.

pub fn try_register(&self, entry: ToolEntry) -> bool

Register a tool from a NON-async context. Returns false if the lock was held and nothing was registered.

The Runtime::with_* builders are synchronous by convention (they take and return Self, so they compose in a let rt = Runtime::new() .with_x().with_y(); chain), which leaves them unable to .await this registry’s lock. They run during construction, before the runtime is shared with anything, so the lock is uncontended and try_write succeeds — the same reasoning Runtime::with_inference / with_executor already rely on for try_write/try_lock. Async callers should keep using Self::register.

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

Get a tool entry by name.

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

Check if a tool exists.

pub async fn remove(&self, name: &str) -> Option<ToolEntry>

Remove a tool.

pub async fn names(&self) -> Vec<String>

List all tool names.

pub async fn entries(&self) -> Vec<ToolEntry>

List all entries.

pub async fn schemas(&self) -> Vec<ToolSchema>

Get all tool schemas (for model prompt generation).

pub async fn allowed_schemas(&self) -> Vec<ToolSchema>

Get schemas filtered by permission (e.g., only non-denied tools for model).

pub async fn by_source(&self, source_match: &ToolSource) -> Vec<ToolEntry>

Get tools by source type.

pub async fn by_category(&self, category: &str) -> Vec<ToolEntry>

Get tools by category.

pub async fn validate(&self) -> Vec<RegistryValidationError>

Validate all entries — check for common issues.

pub async fn to_schema_map(&self) -> HashMap<String, ToolSchema>

Export the full HashMap of schemas (for backward compat with Runtime.tools).

pub async fn len(&self) -> usize

Count of registered tools.

pub async fn is_empty(&self) -> bool

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.