Struct Catalog 

pub struct Catalog { /* private fields */ }

Model facts by provider and model id.

Implementations

impl Catalog

pub fn builtin() -> &'static Catalog

The catalog this build ships.

pub fn get(&self, provider: ProviderId, model: &str) -> Option<&ModelSpec>

The model provider serves as model, by exact id. Any selection of a vendor finds that vendor’s models.

pub fn resolve(&self, reference: &str) -> Option<&ModelSpec>

The model a reference names: vendor/model (anthropic/claude-opus-5-5, openrouter/anthropic/claude-sonnet-4.5) or vendor[/format]:model as ProviderRef spells it. The second form applies when the text before the first : is a vendor or a vendor/format pair, so a model id holding a : (ollama/qwen3:4b) still reads as the first.

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

Every model, by vendor then id.

pub fn from_json(json: &str) -> Result<Catalog, CatalogError>

Read a models.dev-style catalog: an object of provider keys, each with a models object keyed by model id. A provider key is a models.dev key (google, amazon-bedrock) or a rig vendor name (gcp.gemini); a key that is neither is skipped, so models.dev’s own api.json reads whole. Rig’s hand-entered facts go under each row’s rig object.

pub fn merge(self, overrides: Catalog) -> Catalog

This catalog with overrides laid over it. A model in both keeps every field the override leaves out; a model only in overrides is added.

pub fn find(&self, provider: ProviderId, model: &str) -> Option<&ModelSpec>

The model provider serves as model, as the encoders look it up: by exact id or, failing that, without a dated snapshot suffix (-20251001, -2025-08-07), so claude-sonnet-4-5-20250929 finds claude-sonnet-4-5. Self::get matches the exact id only.

Trait Implementations

impl Clone for Catalog

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Catalog

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

Formats the value using the given formatter.

impl Default for Catalog

fn default() -> Self

Returns the “default value” for a type.