Struct ModelSchema 

pub struct ModelSchema {

    pub id: String,
    pub name: String,
    pub provider: String,
    pub family: String,
    pub version: String,
    pub capabilities: Vec<ModelCapability>,
    pub context_length: usize,
    pub param_count: String,
    pub quantization: Option<String>,
    pub performance: PerformanceEnvelope,
    pub cost: CostModel,
    pub source: ModelSource,
    pub tags: Vec<String>,
    pub available: bool,
}

The full declarative schema for a model.

Analogous to ToolSchema — describes what a model is, what it can do, and how to access it. The router uses this for constraint-based filtering and cold-start scoring before observed performance data is available.

Fields

id: String

Unique identifier: “provider/model-name:variant” (e.g., “qwen/qwen3-4b:q4_k_m”).

name: String

Human-readable display name.

provider: String

Provider (qwen, openai, anthropic, google, meta, ollama, custom).

family: String

Model family for grouping (qwen3, gpt-4, claude-4, llama-3).

version: String

Semantic version or checkpoint label.

capabilities: Vec<ModelCapability>

What this model can do — ordered by primary capability first.

context_length: usize

Context window in tokens.

param_count: String

Parameter count as human-readable string (e.g., “4B”, “30B (3B active)”).

quantization: Option<String>

Quantization (Q4_K_M, Q8_0, F16, none).

performance: PerformanceEnvelope

Declared performance envelope (initial estimate, overridden by observed data).

cost: CostModel

Cost structure.

source: ModelSource

How to access this model.

tags: Vec<String>

Free-form tags for filtering (e.g., “fast”, “multilingual”, “moe”).

available: bool

Whether this model is currently available (downloaded / reachable). Not serialized — computed at runtime.

Implementations

impl ModelSchema

pub fn has_capability(&self, cap: ModelCapability) -> bool

Check if this model has a given capability.

pub fn is_local(&self) -> bool

Check if this model is local (runs on-device).

pub fn is_remote(&self) -> bool

Check if this model is remote (requires API call).

pub fn size_mb(&self) -> u64

Get the size in MB (from cost model or 0 if unknown).

pub fn ram_mb(&self) -> u64

Get the RAM requirement in MB (from cost model, falls back to size_mb).

pub fn cost_per_1k_output(&self) -> f64

Estimated cost per 1K output tokens in USD. Returns 0.0 for local models.

Trait Implementations

impl Clone for ModelSchema

fn clone(&self) -> ModelSchema

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelSchema

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelSchema

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&ModelSchema> for ModelInfo

fn from(s: &ModelSchema) -> Self

Converts to this type from the input type.

impl Serialize for ModelSchema

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

where __S: Serializer,

Serialize this value into the given Serde serializer.