Struct ModelReferenceCard 

pub struct ModelReferenceCard {
    pub provider: String,
    pub provider_kind: Option<ProviderKind>,
    pub model_id: String,
    pub canonical_model: Option<String>,
    pub family: Option<String>,
    pub context_window: Option<u64>,
    pub max_output: Option<u64>,
    pub modality: Modality,
    pub pricing: Option<OfferingPricing>,
    pub source: CatalogSource,
}

A factual reference card for one provider offering.

Every field is either a stated fact or an explicit unknown. This is a labels-only projection: it carries no routing, tier, or selection concept.

Fields

provider: String

Provider id serving this offering, exactly as the catalog row states it.

provider_kind: Option<ProviderKind>

Resolved built-in provider kind, when the provider id maps to one.

None for an unrecognized / user-named custom provider — an unknown kind, not a guess.

model_id: String

The provider wire model id, verbatim. Never normalized or prefixed.

canonical_model: Option<String>

Canonical model identity, only when the row carried an explicit join.

family: Option<String>

Model family / series, when stated.

context_window: Option<u64>

Context-window tokens, when stated.

max_output: Option<u64>

Max-output tokens, when stated.

modality: Modality

Text vs multimodal, or unknown.

pricing: Option<OfferingPricing>

Per-token pricing facts, when priced. None is unknown, never free.

source: CatalogSource

Provenance of the underlying catalog row (bundled / live / override).

Implementations

impl ModelReferenceCard

pub fn from_offering(offering: &CatalogOffering) -> Self

Project a catalog offering into its factual reference card.

pub fn provider_kind_label(&self) -> &'static str

Label for the resolved provider kind, or "unknown".

pub fn context_window_label(&self) -> String

Human context-window label such as "1M", "131K", "512", or "unknown". The exact token count remains on Self::context_window.

pub fn max_output_label(&self) -> String

Human max-output label, same shape as Self::context_window_label.

pub fn price_label(&self) -> String

Short factual price label, e.g. "$0.30 / $1.20 per Mtok", or "unknown" when no per-token input/output rate is sourced.

A ? in one slot means that single rate is unknown while the other is stated; a fully unknown price collapses to "unknown" rather than a fabricated zero.

Trait Implementations

impl Clone for ModelReferenceCard

fn clone(&self) -> ModelReferenceCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelReferenceCard

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelReferenceCard

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ModelReferenceCard

fn eq(&self, other: &ModelReferenceCard) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ModelReferenceCard

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ModelReferenceCard