Struct RunCheckpoint 

pub struct RunCheckpoint {

    pub checkpoint_id: String,
    pub run_id: RunId,
    pub checkpoint_seq: u64,
    pub covers_journal_seq: u64,
    pub loop_state: String,
    pub turn_id: Option<TurnId>,
    pub attempt_id: Option<AttemptId>,
    pub runtime_package_fingerprint: String,
    pub pending_side_effects: Vec<PendingSideEffect>,
    pub pending_approvals: Vec<String>,
    pub content_ref_manifest: Vec<ContentRef>,
    pub state_hash: String,
    pub created_at_millis: u64,
    pub writer_id: String,
}

Carries the run checkpoint record payload for journal, event, or fixture surfaces. Creating or cloning it only preserves serialized SDK state; append, publish, replay, or export effects are documented on the runtime and port methods that store it.

Fields

checkpoint_id: String

Stable checkpoint id used for typed lineage, lookup, or dedupe.

run_id: RunId

Run identifier used for lineage, filtering, replay, and dedupe.

checkpoint_seq: u64

Checkpoint seq used by this record or request.

covers_journal_seq: u64

Covers journal seq used by this record or request.

loop_state: String

Loop state used by this record or request.

turn_id: Option<TurnId>

Turn identifier for one loop turn within a run.

attempt_id: Option<AttemptId>

Attempt identifier for retry, repair, provider, or tool execution evidence.

runtime_package_fingerprint: String

Fingerprint of the runtime package snapshot in force when this value was produced. Use it for replay, dedupe, and package-lineage checks; the field is evidence and does not execute package behavior.

pending_side_effects: Vec<PendingSideEffect>

Collection of pending side effects values. Ordering and membership should be treated as part of the serialized contract when relevant.

pending_approvals: Vec<String>

Collection of pending approvals values. Ordering and membership should be treated as part of the serialized contract when relevant.

content_ref_manifest: Vec<ContentRef>

Content reference associated with this value. Resolve it through policy-gated content stores instead of embedding raw content.

state_hash: String

Deterministic state hash used for stale checks, package evidence, or replay comparisons.

created_at_millis: u64

Time value in milliseconds for created at millis. Use it for timeout, ordering, or diagnostic calculations.

writer_id: String

Stable writer id used for typed lineage, lookup, or dedupe.

Implementations

impl RunCheckpoint

pub fn validate_against_latest_seq( &self, latest_journal_seq: u64, ) -> Result<(), AgentError>

Validates the records::journal invariants and returns a typed error on failure. Validation is pure and does not perform I/O, dispatch, journal appends, or adapter calls.

Trait Implementations

impl Clone for RunCheckpoint

fn clone(&self) -> RunCheckpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunCheckpoint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunCheckpoint

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RunCheckpoint

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RunCheckpoint

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RunCheckpoint

impl StructuralPartialEq for RunCheckpoint