Enum ModelCacheState 

pub enum ModelCacheState {
    NotAcquired {
        missing_files: Vec<String>,
        needs_consent: bool,
    },
    Acquiring {
        staging_dir: PathBuf,
        bytes_present: u64,
        total_bytes: u64,
    },
    Acquired {
        model_dir: PathBuf,
    },
    ChecksumMismatch {
        file: String,
        expected: String,
        actual: String,
    },
    IncompatibleVersion {
        current_revision: String,
        expected_revision: String,
    },
    DisabledByPolicy {
        reason: String,
    },
    BudgetBlocked {
        required_bytes: u64,
        max_bytes: u64,
    },
    QuarantinedCorrupt {
        marker_path: PathBuf,
        reason: String,
    },
    PreseededLocal {
        model_dir: PathBuf,
    },
    MirrorSourced {
        model_dir: PathBuf,
        mirror_base_url: String,
    },
    OfflineBlocked {
        missing_files: Vec<String>,
    },
}

Precise on-disk semantic model cache state.

Variants

NotAcquired

Required files are absent or incomplete.

Fields

missing_files: Vec<String>

Missing manifest files, expressed as local filenames.

needs_consent: bool

Whether the next acquisition step is consent rather than download.

Acquiring

A staged/resumable acquisition is present.

Fields

staging_dir: PathBuf

bytes_present: u64

total_bytes: u64

Acquired

All files are installed, verified, and revision-compatible.

Fields

model_dir: PathBuf

ChecksumMismatch

At least one file exists but its checksum does not match the manifest.

Fields

file: String

expected: String

actual: String

IncompatibleVersion

Files are complete, but the installed revision does not match the manifest.

Fields

current_revision: String

expected_revision: String

DisabledByPolicy

Semantic model acquisition is disabled by user or policy.

Fields

reason: String

BudgetBlocked

The model exceeds the active byte budget.

Fields

required_bytes: u64

max_bytes: u64

QuarantinedCorrupt

A previous corrupt cache has been quarantined.

Fields

marker_path: PathBuf

reason: String

PreseededLocal

Files were preseeded locally and verified without a cass marker.

Fields

model_dir: PathBuf

MirrorSourced

Files were acquired from a configured mirror and verified.

Fields

model_dir: PathBuf

mirror_base_url: String

OfflineBlocked

Acquisition is needed, but the host is offline.

Fields

missing_files: Vec<String>

Implementations

impl ModelCacheState

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

Stable machine-readable state code.

pub fn summary(&self) -> String

Human-readable state detail for CLI and robot diagnostics.

pub fn next_step(&self) -> Option<&'static str>

Suggested next operator action.

pub fn is_usable(&self) -> bool

Whether the installed files can be used by the embedder immediately.

Trait Implementations

impl Clone for ModelCacheState

fn clone(&self) -> ModelCacheState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelCacheState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelCacheState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ModelCacheState

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ModelCacheState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ModelCacheState

impl StructuralPartialEq for ModelCacheState