Skip to content

cayu.sessions.TerminalSessionEvidence

Part of cayu.sessions.base. Read the Python API overview and install the required extra.

from cayu.sessions import TerminalSessionEvidence

One exact, bounded store snapshot through a terminal run.

Ordinary terminal-evidence reads remain completed/failed-only. A store may also return this model for an interrupted session through the narrower runner-owned operation, which requires an exact emitted sequence/type match inside the same snapshot.

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
session Session required
events tuple[EventRecord, ...] required
transcript tuple[TranscriptRecord, ...] required
terminal_publication_marker TerminalPublicationMarker | None None
boundary TerminalSessionEvidenceBoundary required
TerminalSessionEvidence.copy_session(value: Session) -> Session
TerminalSessionEvidence.copy_events(value) -> tuple[EventRecord, ...]
TerminalSessionEvidence.copy_transcript(value) -> tuple[TranscriptRecord, ...]
TerminalSessionEvidence.validate_boundaries() -> TerminalSessionEvidence
TerminalSessionEvidence.terminal_event() -> EventRecord

Return the matching terminal event at the snapshot boundary.

TerminalSessionEvidence.lifecycle_events() -> tuple[EventRecord, ...]

Return invocation and interaction lifecycle records in durable order.

TerminalSessionEvidence.initial_interaction_id() -> str | None

Return the first admitted interaction identity, when recorded.

Release source · Runtime guarantees · Capability guides