Struct CatalogRegistry 

pub struct CatalogRegistry { /* private fields */ }

The catalogs an agent knows about.

Names are how the application refers to a catalog; ids are what goes on the wire. They are usually different — a registry entry called "standard" may carry catalogId: "https://a2ui.org/..." — so the registry keeps both and CatalogRegistry::supported_catalog_ids reports the wire ids.

Implementations

impl CatalogRegistry

pub fn new() -> Self

An empty registry.

pub fn insert(&mut self, name: impl Into<String>, schema: Value)

Registers a catalog document under a local name.

pub fn load( &mut self, name: impl Into<String>, path: impl AsRef<Path>, ) -> Result<()>

Registers a catalog document read from disk.

Errors

Returns Error::Catalog if the file cannot be read or is not JSON.

pub fn relax_strict_validation(&mut self)

Applies additionalProperties relaxation to every registered catalog.

Structured-output APIs reject schemas that forbid extra properties, so this is usually applied at load time when the catalogs feed one.

pub fn entries(&self) -> &[RegistryEntry]

The registered catalogs, in registration order.

pub fn schemas(&self) -> Vec<Value>

The catalog documents, for select_catalog_schema.

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

The wire ids of every registered catalog.

pub fn get(&self, id: &str) -> Option<&RegistryEntry>

Looks a catalog up by wire id or by local name.

pub fn select( &self, capabilities: &ClientCapabilities, accepts_inline: bool, ) -> Result<SchemaBundle>

Negotiates a catalog from this registry.

Errors

See select_catalog_schema.

Trait Implementations

impl Clone for CatalogRegistry

fn clone(&self) -> CatalogRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CatalogRegistry

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

Formats the value using the given formatter.

impl Default for CatalogRegistry

fn default() -> CatalogRegistry

Returns the “default value” for a type.