Struct ModelFacts 

pub struct ModelFacts { /* private fields */ }

The facts a completion wire encodes with: the spec of the model it was connected to, and the catalog that spec came from, which answers for any other model a request names. Every completion wire holds one, and its Descriptor hands it to the completion fold, which prices usage from it.

The default binds no spec and answers from Catalog::builtin. Facts are not part of a wire’s serialized form or of its equality: a wire read back from storage answers from the built-in catalog until it is given facts again. Clones are cheap.

use rig_core::catalog::{Catalog, ModelFacts, Pricing};
use rig_core::providers::registry::ProviderId;

let anthropic = ProviderId::catalog("anthropic").ok_or("a known vendor")?;
let mut catalog = Catalog::builtin().clone();
let spec = catalog.get_exact(anthropic, "claude-haiku-4-5").ok_or("listed")?;
catalog.insert(spec.clone().with_pricing(Pricing::new(0.5, 2.5)));

let facts = catalog.facts(anthropic, "claude-haiku-4-5-20990101");
let spec = facts.for_model("anthropic", "claude-haiku-4-5-20990101").ok_or("bound")?;
assert_eq!(spec.pricing.as_ref().map(|pricing| pricing.input), Some(0.5));

Implementations

impl ModelFacts

pub fn new(spec: impl Into<Arc<ModelSpec>>) -> Self

The facts of spec, for the model it lists. Any other model is answered from Catalog::builtin.

pub fn with_catalog(self, catalog: &Catalog) -> Self

The same facts, answering every model but the bound one from catalog.

pub fn spec(&self) -> Option<&ModelSpec>

The spec of the model the wire was connected to, when it was connected through the catalog or given one.

pub fn catalog(&self) -> &Catalog

The catalog that answers for every model but the bound one.

pub fn for_model(&self, vendor: &str, model: &str) -> Option<&ModelSpec>

The facts of vendor’s model: the bound spec when model is the id the wire was connected to (or the id the spec lists), otherwise the catalog’s entry by Catalog::get’s rule. None for a model the catalog does not list. vendor is the provider’s descriptor name ("anthropic", "aws_bedrock").

A spec under a catalog vendor answers only under that vendor, since a wire also asks about other vendors’ rows for its model. A spec under a declared vendor answers under any: no wire carries a declared vendor’s name, so the wire it was bound to asks under its own.

Trait Implementations

impl Clone for ModelFacts

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 ModelFacts

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

Formats the value using the given formatter.

impl Default for ModelFacts

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ModelFacts

impl PartialEq for ModelFacts

Facts take no part in a wire’s equality, as they take none in its serialized form: two wires that send the same requests are equal.

fn eq(&self, _other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.