Struct SessionFile 

pub struct SessionFile {
    pub schema_version: u32,
    pub goal: String,
    pub model: String,
    pub provider: String,
    pub tool_registry_hash: String,
    pub steps_consumed: usize,
    pub transcript: Vec<Message>,
    pub preset: Option<String>,
}

A saved session that can be resumed.

Fields

schema_version: u32

goal: String

The original goal string.

model: String

Model name (e.g. “gpt-4o-mini”).

provider: String

Provider identifier (e.g. “openai”).

tool_registry_hash: String

BLAKE3 hash of the tool registry specs at the time of save. Used to detect tool changes that would make the session invalid.

steps_consumed: usize

Number of steps already consumed.

transcript: Vec<Message>

The full transcript so far (system prompt + user goal + all exchanges).

preset: Option<String>

Resolved provider preset id (e.g. “deepseek”) at session creation time. None when the user did not configure a preset — kept optional for back-compat with pre-preset-config session files.

Implementations

impl SessionFile

pub fn new( goal: String, model: String, provider: String, tool_specs: &[ToolSpec], steps_consumed: usize, transcript: Vec<Message>, ) -> Self

Create a new session file from the agent’s current state.

pub fn write_to(&self, path: &Path) -> Result<()>

Write the session to a JSON file at path.

pub fn read_from(path: &Path) -> Result<Self>

Read a session from a JSON file at path.

pub fn validate_tool_registry( &self, current_specs: &[ToolSpec], ) -> Result<(), String>

Validate that the tool registry hash matches the current tool specs. Returns Ok(()) if they match, or an error describing the mismatch.

pub fn messages(&self) -> &[Message]

Return the transcript messages.

pub fn into_transcript(self) -> Vec<Message>

Consume self and return the transcript.

Trait Implementations

impl Clone for SessionFile

fn clone(&self) -> SessionFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionFile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.