Struct EngineSnapshot 

pub struct EngineSnapshot {

    pub magic: [u8; 8],
    pub version: u32,
    pub arch_id: String,
    pub model_path: String,
    pub tokenizer_path: Option<String>,
    pub model_fingerprint: ModelFingerprint,
    pub tokens: Vec<u32>,
    pub sequence_state: SequenceStatePayload,
    pub sampler_state: SamplerStatePayload,
    pub grammar_state: Option<GrammarStatePayload>,
    pub max_context_length: usize,
    pub num_threads: usize,
    pub prefill_chunk_size: usize,
}

The complete engine snapshot — opaque to callers outside this module.

Callers should treat the serialized form as opaque bytes: construct via InferenceEngine::snapshot(), persist however is appropriate, then pass the bytes to InferenceEngine::resume().

Fields

magic: [u8; 8]

Magic bytes: must equal SNAPSHOT_MAGIC.

version: u32

Format version. Current: EngineSnapshot::VERSION.

arch_id: String

Architecture identifier (e.g. "llama", "qwen3", …).

model_path: String

Absolute path to the model file at snapshot time.

tokenizer_path: Option<String>

Optional explicit tokenizer path (None = auto-detect).

model_fingerprint: ModelFingerprint

Bounded fingerprint of the model file.

tokens: Vec<u32>

All token IDs processed so far (prompt + generated).

sequence_state: SequenceStatePayload

Sequence / KV state at snapshot time.

sampler_state: SamplerStatePayload

Sampler state at snapshot time.

grammar_state: Option<GrammarStatePayload>

Optional grammar state (None when no grammar is configured).

max_context_length: usize

Maximum context length the engine was configured with.

num_threads: usize

Number of parallel inference threads.

prefill_chunk_size: usize

Prefill chunk size.

Implementations

impl EngineSnapshot

pub const VERSION: u32 = 1

Current snapshot format version.

pub fn serialize(&self) -> RuntimeResult<Vec<u8>>

Serialize this snapshot to bytes using oxicode.

pub fn deserialize(bytes: &[u8]) -> RuntimeResult<Self>

Deserialize a snapshot from bytes.

Returns SnapshotIncompatible if the bytes cannot be decoded, the magic is wrong, or the version is not supported.

Trait Implementations

impl Clone for EngineSnapshot

fn clone(&self) -> EngineSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EngineSnapshot

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

Formats the value using the given formatter.

impl Decode for EngineSnapshot

fn decode<__D: Decoder<Context = ()>>(decoder: &mut __D) -> Result<Self, Error>

Decode a value from the given decoder

impl Encode for EngineSnapshot

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), Error>

Encode this value into the given encoder