Struct TranscriptSession 

pub struct TranscriptSession {
    pub harness_id: String,
    pub harness_session_id: String,
    pub harness_version: Option<String>,
    pub cwd: Option<String>,
    pub org_id: String,
    pub auth_subject: String,
}

The session a transcript belongs to, as the ingest lane needs it.

A client’s own session registry will carry more than this (a pid to watch, bookkeeping for backoff); this is the subset that reaches the wire. Kept owned rather than borrowed so a client can build one from a swept transcript (see super::sweep) as easily as from a live registry entry.

Fields

harness_id: String

Which harness produced it — claude today. Should match the X-Tapes-Harness-Id the same session’s wire traffic carries, so the deriver fuses both sources under one session row.

harness_session_id: String

The harness session id. Required by the server for transcripts; it is what names <sid>.jsonl and keys the upload.

harness_version: Option<String>

Harness version, when known.

cwd: Option<String>

Working directory the harness ran in, when known.

org_id: String

Organization id, or empty.

The server’s envelope validation requires a UUID here, so a client whose own organization identifier is some other shape leaves this empty deliberately rather than sending a value that would be rejected. That is not a loss: on a deployment with an authenticating edge, the wire-capture path derives org identity from the validated credential rather than from this envelope.

auth_subject: String

Acting subject, or empty. A standalone client conventionally sets local:<os-username>; on the platform the cloud edge stamps it from validated JWT claims. Nothing parses the prefix — see crate::attribution::Attribution::auth_subject.

Implementations

impl TranscriptSession

pub fn new( harness_id: impl Into<String>, harness_session_id: impl Into<String>, ) -> Self

A session envelope with only the required fields set.

pub fn with_harness_version(self, version: Option<String>) -> Self

Set the harness version.

pub fn with_cwd(self, cwd: Option<String>) -> Self

Set the working directory.

pub fn with_auth_subject(self, auth_subject: impl Into<String>) -> Self

Set the acting subject.

Trait Implementations

impl Clone for TranscriptSession

fn clone(&self) -> TranscriptSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TranscriptSession

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

Formats the value using the given formatter.

impl Eq for TranscriptSession

impl PartialEq for TranscriptSession

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TranscriptSession