Struct ModelSpec 

pub struct ModelSpec {
    pub key: String,
    pub api_id: String,
    pub protocol: Protocol,
    pub thinking: ThinkingMode,
    pub context_window_tokens: u64,
    pub max_image_base64_bytes: u64,
    pub max_truncated_resumes: u32,
    pub auto_compact_at_tokens: Option<u64>,
}

A resolved model: everything the protocol drivers need, minus credentials (those live in BackendConfig). Built by the application configuration from the [models] / [gateways] catalog in config.toml — myco ships no built-in models.

Fields

key: String

Catalog key: what the user types after --model and what sessions record. Distinct from api_id so one wire model can appear under several keys (e.g. routed via different gateways).

api_id: String

Wire id sent to the provider (the request model field).

protocol: Protocol

thinking: ThinkingMode

context_window_tokens: u64

Context window for UX (USER n/m) and auto-compact heuristics.

max_image_base64_bytes: u64

Largest image this model accepts, measured on the base64 payload. Enforced locally by view_image and by REPL @path attachments so an oversized image fails with a clear message instead of a provider 400. Always concrete: config resolution applies the max_image_base64_bytes entry or its default, and callers downstream take this value.

max_truncated_resumes: u32

How many consecutive max_tokens truncations one turn resumes through before handing control back (0 never resumes). Resolved from the model’s max_truncated_resumes or its default; the agent takes this value via the agent’s continuation policy.

auto_compact_at_tokens: Option<u64>

Prompt size at which the session runner compacts without being asked. Myco’s config defaults to the full context window. Library callers can use None when they own compaction policy themselves.

Resolved from the model’s auto_compact_at fraction and output reserve against context_window_tokens so the comparison downstream is a plain token count, and the fraction is validated once, at startup.

Trait Implementations

impl Clone for ModelSpec

fn clone(&self) -> ModelSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelSpec

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

Formats the value using the given formatter.

impl Display for ModelSpec

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

Formats the value using the given formatter.

impl Eq for ModelSpec

impl PartialEq for ModelSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ModelSpec