Enum SessionRecord 

pub enum SessionRecord {
    SessionMeta {
        schema_version: u32,
        seq: u64,
        time: String,
        session_id: String,
        cwd: String,
        title: String,
        provider: String,
        model: String,
        websearch: String,
        app_version: String,
        config: Option<SessionConfigMeta>,
    },
    Context {
        schema_version: u32,
        seq: u64,
        time: String,
        sources: Vec<ContextSourceMeta>,
    },
    ContextLedger {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        ledger: ContextLedgerMeta,
    },
    ContextPin {
        schema_version: u32,
        seq: u64,
        time: String,
        item: ContextItemMeta,
        reason: String,
    },
    ContextDrop {
        schema_version: u32,
        seq: u64,
        time: String,
        item: ContextItemMeta,
        reason: String,
    },
    ContextRecovery {
        schema_version: u32,
        seq: u64,
        time: String,
        item: ContextItemMeta,
        reason: String,
    },
    Compaction {
        schema_version: u32,
        seq: u64,
        time: String,
        audit: CompactionAudit,
    },
    CompactionReview {
        schema_version: u32,
        seq: u64,
        time: String,
        recovery_handle: String,
        review: CompactionReviewResult,
    },
    User {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        text: String,
    },
    PromptMetadata {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        metadata: PromptMetadata,
    },
    AssistantFinished {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        text: String,
    },
    ReasoningFinished {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        text: String,
    },
    Usage {
        schema_version: u32,
        seq: u64,
        time: String,
        input_tokens: u64,
        output_tokens: u64,
    },
    RequestAccounting {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        accounting: ProviderRequestAccounting,
    },
    ToolStarted {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        call_id: String,
        name: String,
        arguments: String,
        mcp: Option<McpToolSessionMeta>,
    },
    ToolFinished {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        call_id: String,
        status: ToolStatus,
        output: Vec<String>,
        artifact: Option<ArtifactMetadata>,
        mcp: Option<McpToolSessionMeta>,
    },
    Cancelled {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        reason: String,
    },
    Failed {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        error: String,
    },
    AcpSession {
        schema_version: u32,
        seq: u64,
        time: String,
        local_session_id: String,
        agent_name: String,
        acp_session_id: String,
        command: String,
        protocol_version: String,
        agent_info_name: Option<String>,
        agent_info_version: Option<String>,
        client_info_name: Option<String>,
        client_info_version: Option<String>,
    },
    SessionRenamed {
        schema_version: u32,
        seq: u64,
        time: String,
        title: String,
    },
    FileWrite {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        op: WriteOp,
        path: String,
        before_hash: Option<u64>,
        before_bytes: Option<usize>,
        after_hash: u64,
        after_bytes: usize,
        status: ToolStatus,
    },
    McpConfigChanged {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        previous_files: Vec<SessionConfigFile>,
        current_files: Vec<SessionConfigFile>,
        diagnostics: Vec<String>,
    },
    ShellExec {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        process_id: Option<u64>,
        command: String,
        cwd: String,
        process_status: String,
        exit_code: Option<i32>,
        elapsed_ms: u64,
        kind: String,
    },
    SkillActivated {
        schema_version: u32,
        seq: u64,
        time: String,
        name: String,
        path: String,
        content_hash: u64,
        byte_count: usize,
        rendered_content_hash: u64,
        rendered_byte_count: usize,
        loaded_references: Vec<SkillReferenceRecord>,
    },
    QueuedInput {
        schema_version: u32,
        seq: u64,
        time: String,
        kind: String,
        text: String,
    },
    AcpPermissionRequest {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        tool_call_id: String,
        title: String,
        options: Vec<AcpPermissionOptionRecord>,
    },
    AcpPermissionOutcome {
        schema_version: u32,
        seq: u64,
        time: String,
        turn_id: String,
        tool_call_id: String,
        outcome: String,
    },
}

A single line in a session JSONL file.

Every record carries schema_version, seq (monotonic within the session), time (ISO 8601 UTC), and a type tag. Records are never rewritten; appends are the only mutation.

Variants

SessionMeta

First line of a session: identity and environment.

Fields

schema_version: u32

seq: u64

time: String

session_id: String

cwd: String

title: String

provider: String

model: String

websearch: String

app_version: String

config: Option<SessionConfigMeta>

Effective config metadata: loaded config files, key origins, and diagnostics. None when config metadata was not captured.

Context

Loaded context source metadata (AGENTS.md etc.).

Fields

schema_version: u32

seq: u64

time: String

sources: Vec<ContextSourceMeta>

ContextLedger

Content-free context working-set snapshot for one prompt turn.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

ledger: ContextLedgerMeta

ContextPin

A user pin action for a context item.

Fields

schema_version: u32

seq: u64

time: String

item: ContextItemMeta

reason: String

ContextDrop

A user drop action for a context item.

Fields

schema_version: u32

seq: u64

time: String

item: ContextItemMeta

reason: String

ContextRecovery

A user recovery action for a context item.

Fields

schema_version: u32

seq: u64

time: String

item: ContextItemMeta

reason: String

Compaction

A manual or automatic compaction audit record.

Fields

schema_version: u32

seq: u64

time: String

audit: CompactionAudit

CompactionReview

The user’s decision on a compaction summary that required review.

Fields

schema_version: u32

seq: u64

time: String

recovery_handle: String

review: CompactionReviewResult

User

A user-submitted prompt.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

text: String

PromptMetadata

Prompt assembly metadata for one user turn.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

metadata: PromptMetadata

AssistantFinished

Final replayable assistant text.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

text: String

ReasoningFinished

Final replayable reasoning text.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

text: String

Usage

Provider token usage increment.

Fields

schema_version: u32

seq: u64

time: String

input_tokens: u64

output_tokens: u64

RequestAccounting

Exact request-size accounting and provider usage for one request.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

accounting: ProviderRequestAccounting

ToolStarted

A tool call started.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

call_id: String

name: String

arguments: String

mcp: Option<McpToolSessionMeta>

MCP metadata when this tool came from an MCP server.

ToolFinished

A tool call finished.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

call_id: String

status: ToolStatus

output: Vec<String>

artifact: Option<ArtifactMetadata>

Metadata and handle for bounded redacted recoverable evidence.

mcp: Option<McpToolSessionMeta>

MCP metadata when this tool came from an MCP server.

Cancelled

The agent run was cancelled.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

reason: String

Failed

The agent run failed.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

error: String

AcpSession

ACP session metadata.

Fields

schema_version: u32

seq: u64

time: String

local_session_id: String

Local append-only thndrs session id.

agent_name: String

Configured ACP agent name.

acp_session_id: String

Opaque external ACP session id returned by the agent.

command: String

Redacted command display used to start the agent.

protocol_version: String

Selected ACP protocol version.

agent_info_name: Option<String>

Optional ACP agent info name.

agent_info_version: Option<String>

Optional ACP agent info version.

client_info_name: Option<String>

Optional ACP client info name.

client_info_version: Option<String>

Optional ACP client info version.

SessionRenamed

Session title was renamed (latest wins).

Fields

schema_version: u32

seq: u64

time: String

title: String

FileWrite

A file write operation completed.

Records the operation type, target path, and before/after metadata for session audit. Only hashes and byte counts are persisted but not file content.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

op: WriteOp

path: String

before_hash: Option<u64>

before_bytes: Option<usize>

after_hash: u64

after_bytes: usize

status: ToolStatus

McpConfigChanged

MCP configuration changed after the session was created.

Records only file paths, sources, hashes, and loader diagnostics; raw MCP server command, env, and header values are not persisted here.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

previous_files: Vec<SessionConfigFile>

current_files: Vec<SessionConfigFile>

diagnostics: Vec<String>

ShellExec

A shell command lifecycle event.

One-shot commands produce a terminal record. Background commands produce a running start record followed by a terminal record when they exit, time out, or are cancelled. stdout/stderr are not stored directly — they are captured in redacted, capped output records.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

process_id: Option<u64>

Registry id for a background process, when applicable.

command: String

Full argv (program + args) joined with spaces.

cwd: String

Working directory the command ran in.

process_status: String

Lifecycle status: ok, failed, timeout, cancelled.

exit_code: Option<i32>

Exit code if the process exited normally, else None.

elapsed_ms: u64

Elapsed time in milliseconds.

kind: String

“one-shot” or “background”.

SkillActivated

A skill was explicitly opened/activated in the session.

Fields

schema_version: u32

seq: u64

time: String

name: String

path: String

content_hash: u64

Hash of the raw SKILL.md file at path.

byte_count: usize

Byte count of the raw SKILL.md file at path.

rendered_content_hash: u64

Hash of the model-visible activation text after references are appended.

rendered_byte_count: usize

Byte count of the model-visible activation text after references are appended.

loaded_references: Vec<SkillReferenceRecord>

QueuedInput

Queued input recorded for audit. Resume does not rebuild pending queues.

Fields

schema_version: u32

seq: u64

time: String

kind: String

“steering” or “follow-up”.

text: String

AcpPermissionRequest

ACP permission request metadata.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

tool_call_id: String

title: String

options: Vec<AcpPermissionOptionRecord>

AcpPermissionOutcome

ACP permission request outcome.

Fields

schema_version: u32

seq: u64

time: String

turn_id: String

tool_call_id: String

outcome: String

Implementations

impl SessionRecord

pub fn seq(&self) -> u64

The sequence number of this record.

pub fn to_json(&self) -> Result<String, Error>

Serialize to a JSON string for JSONL append.

pub fn from_json(json: &str) -> Result<Self, Error>

Deserialize from a JSON string.

pub fn from_entry( entry: &Entry, seq: u64, time: &str, turn_id: &str, ) -> Option<SessionRecord>

Convert a transcript Entry into a SessionRecord.

Only finalized entries are converted — streaming entries (assistant/ reasoning still streaming, tools still running) are skipped because they represent incomplete live state.

pub fn from_entry_with_artifact( entry: &Entry, seq: u64, time: &str, turn_id: &str, artifact: Option<ArtifactMetadata>, ) -> Option<SessionRecord>

Convert a transcript entry while attaching bounded artifact metadata.

pub fn to_entry(&self) -> Option<Entry>

Reconstruct a transcript Entry from this record.

Returns None for records that don’t map to a transcript row (session_meta, context, session_renamed).

Trait Implementations

impl Clone for SessionRecord

fn clone(&self) -> SessionRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SessionRecord

impl PartialEq for SessionRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SessionRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SessionRecord