Struct DurableSession 

pub struct DurableSession { /* private fields */ }

A UUID-backed durable session bound to an opaque host external ID.

Implementations

impl DurableSession

pub fn id(&self) -> Uuid

Returns Talos’s UUID identity used for the safe TLOG filename.

pub fn external_id(&self) -> &str

Returns the host-provided logical key; it is never used as a filename.

pub fn file_path(&self) -> &Path

Returns the UUID-named TLOG path under the host-selected directory.

pub fn read_messages(&self) -> Result<Vec<Message>, SessionError>

Returns model messages suitable for automatic Runtime history recovery.

pub fn session(&self) -> &Session

Returns the underlying session for read-only inspection.

pub fn capabilities(&self) -> SessionCapabilities

Returns durable format capabilities without inferring support from extensions.

pub fn transcript( &self, cursor: Option<&str>, limit: usize, ) -> Result<Vec<DurableTranscriptEntry>, SessionError>

Returns a normalized transcript page after an optional entry-ID cursor.

The cursor entry is excluded. The method exposes no raw TLOG lines, provider payloads, HTTP headers, raw_content metadata, or hidden terminal outcome markers.

pub fn commit_turn( &self, turn_id: &str, messages: &[Message], policy: &PersistencePolicy, ) -> Result<TurnCommit, SessionError>

Atomically commits every model-visible message and the hidden Success marker of one completed turn.

Repeating a committed turn_id returns the original model-visible IDs without writing duplicates. The outcome marker is written in the same atomic replacement as the messages so startup can distinguish a proven Success from partial or ambiguous transcript state.

pub fn finalize_turn( &self, turn_id: &str, messages: &[Message], policy: &PersistencePolicy, outcome: TurnTranscriptOutcome, ) -> Result<TurnCommit, SessionError>

Atomically finalizes one turn with its admitted display-safe prefix.

The first terminal outcome wins. Retrying the same outcome with the same filtered role/content sequence returns the original entry IDs without a write. A conflicting outcome or payload is rejected without mutation.

pub fn abort_turn( &self, turn_id: &str, _reason: &str, ) -> Result<(), SessionError>

Marks an uncommitted turn as aborted. No transcript state is written.

pub fn delete(self) -> Result<(), SessionError>

Deletes the TLOG and its external-ID binding.

impl DurableSession

pub fn committed_turn_entry_ids( &self, turn_id: &str, ) -> Result<Vec<String>, SessionError>

Returns transcript evidence associated with one Turn.

Model-visible entry IDs are returned when present. A hidden terminal outcome marker contributes one synthetic evidence token so the Actor’s existing startup path invokes the journal classifier even for an Error, Cancelled, or empty successful Turn. The pending journal then maps the authoritative outcome to Committed, TerminalError, or TerminalCancelled. No message or outcome evidence returns an empty vector and remains frozen.

Trait Implementations

impl Clone for DurableSession

fn clone(&self) -> DurableSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DurableSession

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

Formats the value using the given formatter.