Struct SidSession 

pub struct SidSession { /* private fields */ }

On-disk representation of a single interactive agent session.

See the module-level documentation for an overview of the session lifecycle.

Implementations

impl SidSession

pub fn create(config_root: &Path<'_>) -> Result<Self, SError>

Create a fresh session under the default sessions root for config_root.

Errors

Returns an error when the sessions directory cannot be created or a unique session identifier cannot be allocated.

pub fn create_compacted( config_root: &Path<'_>, provenance: CompactionProvenance, ) -> Result<Self, SError>

Create a compacted continuation session linked to a parent via provenance.

Errors

Returns an error when the sessions directory cannot be created or a unique session identifier cannot be allocated.

pub fn resume(config_root: &Path<'_>, spec: &str) -> Result<Self, SError>

Resume an existing session identified by spec.

spec can be an absolute path to a session directory, a path to its session.json metadata file, or a bare session name relative to the default sessions root.

Errors

Returns an error when the session directory does not exist or its metadata cannot be read.

pub fn id(&self) -> &str

Return the session’s unique identifier (a timestamp-based string).

pub fn sessions_root(&self) -> &PathBuf

Return the parent directory that contains all session directories.

pub fn root(&self) -> &PathBuf

Return the on-disk root directory for this session.

pub fn compaction_provenance(&self) -> Option<&CompactionProvenance>

Return the compaction provenance if this session was created via compaction.

pub fn transcript_path(&self) -> PathBuf

Return the path to the transcript JSON file for this session.

pub fn read_bash_state(&self) -> Result<Option<String>, SError>

Read the saved bash session state, if any.

Returns Ok(None) when no state file exists or the file is empty.

Errors

Returns an error on I/O failure.

pub fn write_bash_state(&self, state: &str) -> Result<(), SError>

Persist bash session state to disk for later resumption.

Errors

Returns an error on I/O failure.

Trait Implementations

impl Debug for SidSession

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

Formats the value using the given formatter.

impl Drop for SidSession

fn drop(&mut self)

Executes the destructor for this type.