Struct SessionEventEnvelope 

pub struct SessionEventEnvelope {
    pub seq: u64,
    pub ts_ms: i64,
    pub turn_id: Option<u64>,
    pub parent_seq: Option<u64>,
    pub kind: SessionEvent,
    pub chain: Option<String>,
}

One line of a session’s events.jsonl append-only log.

Examples

use zeph_session::event::{SessionEvent, SessionEventEnvelope};

let envelope = SessionEventEnvelope::new(
    0,
    None,
    None,
    SessionEvent::UserMessage { text: "hello".to_owned(), image_refs: vec![] },
);
let line = serde_json::to_string(&envelope).expect("serializable");
let round_tripped: SessionEventEnvelope =
    serde_json::from_str(&line).expect("deserializable");
assert_eq!(round_tripped.seq, 0);

Fields

seq: u64

Monotonic, gap-free, per-session sequence number starting at 0.

ts_ms: i64

Wall-clock milliseconds (UTC) at append time. Informational only — seq orders events.

turn_id: Option<u64>

Groups events emitted within one agent turn.

parent_seq: Option<u64>

Fork provenance: set only on the first event of a forked child log, referencing the parent’s seq at the fork point.

kind: SessionEvent

The tagged event payload, nested under the kind key (spec §4.2).

chain: Option<String>

Keyed-BLAKE3 hash chain link (hex-encoded), binding this event’s content and the previous event’s hash (issue #6360). None on every event means this log predates the feature or history-chain verification is disabled for this process (legacy, auto-trusted-once per spec-069 FR-006). Additive field: #[serde(default)] means an older reader/writer that doesn’t know this field ignores it, and legacy logs without it parse unchanged.

Implementations

impl SessionEventEnvelope

pub fn new( seq: u64, turn_id: Option<u64>, parent_seq: Option<u64>, kind: SessionEvent, ) -> Self

Construct an envelope with ts_ms set to the current wall-clock time.

Trait Implementations

impl Clone for SessionEventEnvelope

fn clone(&self) -> SessionEventEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionEventEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionEventEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionEventEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.