Struct ToolCatalog 

pub struct ToolCatalog { /* private fields */ }

Inventory of all locally known capabilities, keyed by stable ToolId in deterministic order, with a generation that advances on every mutation.

Implementations

impl ToolCatalog

pub fn empty() -> ToolCatalog

pub fn from_registry( registry: &ToolRegistry, ) -> Result<ToolCatalog, CatalogError>

Read-only snapshot of the catalog integrated into a live registry.

Kept as a compatibility shim over super::ToolRegistry::catalog; the registry maintains its catalog through every construction and mutation path, so this is a pure read with no process start, network access, schema exposure, or execution grant.

pub fn generation(&self) -> CatalogGeneration

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn get(&self, id: &ToolId) -> Option<&CapabilityRecord>

pub fn iter(&self) -> impl Iterator<Item = &CapabilityRecord>

Iterate records in deterministic ToolId order.

pub fn insert(&mut self, record: CapabilityRecord) -> Result<(), CatalogError>

Insert one capability. Duplicate IDs fail closed (no silent replacement, no generation advance); generation exhaustion fails closed (no entry change). On success the catalog generation advances by exactly one. The record’s factory is stored, never invoked.

pub fn upsert( &mut self, replaced: Option<&ToolId>, record: CapabilityRecord, ) -> Result<(), CatalogError>

Insert-or-replace one capability as a single mutation, optionally dropping the entry it shadows (registry replacement by runtime name can change the capability identity; the stale identity must not linger and keep validating old grants).

Occupied-identity safety: if the incoming id is already cataloged and it is NOT the unchanged identity of the same-runtime-name tool being replaced (replaced == Some(record.id)), the mutation fails typed with CatalogError::DuplicateToolId before any entry or generation change — two distinct runtime names must never silently share one capability identity, or live tools and catalog would diverge. Fails closed without touching entries when no new generation is available.

pub fn rebase_past( &mut self, prior: CatalogGeneration, ) -> Result<(), CatalogGenerationOverflow>

Advance strictly past both this catalog’s generation and a prior registry generation. Used when a mutation rebuilds the catalog from scratch (e.g. disable): the rebuilt catalog must not reuse generation values already observed, or stale grants could survive.

Trait Implementations

impl Clone for ToolCatalog

fn clone(&self) -> ToolCatalog

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolCatalog

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.