Skip to main content

Checkpoint

Struct Checkpoint 

Source
pub struct Checkpoint {
    pub id: String,
    pub thread_id: String,
    pub step: usize,
    pub state: State,
    pub next_nodes: Vec<String>,
    pub created_at: DateTime<Utc>,
    pub base: Option<String>,
    pub header: CheckpointHeader,
    pub journal_ref: Option<JournalRef>,
}
Expand description

A versioned snapshot of one thread’s state at a super-step boundary.

Fields§

§id: String

Unique checkpoint id (UUID v4; also serves as a fork handle for time travel).

§thread_id: String

The thread (session) this checkpoint belongs to. Threads cannot see each other’s state.

§step: usize

Zero-based super-step index at whose boundary this snapshot was taken.

§state: State

The full channel state at the boundary.

In a delta checkpoint (Checkpoint::base set — a storage detail only opting-in backends produce and no read method ever returns) this holds just the channels whose values changed since the base, as full per-channel values. Channels are never deleted from a state, so overlaying the delta onto the materialized base restores the full state (fold_delta).

§next_nodes: Vec<String>

The node set scheduled to run in the next super-step. Restored on resume so execution continues exactly where it suspended.

§created_at: DateTime<Utc>

Wall-clock creation time (UTC).

§base: Option<String>

The checkpoint this one diffs against (R0.7 wave 4 delta checkpoints). None is a full snapshot — every checkpoint written before W4, and every checkpoint a read method returns: folding is checkpointer-internal, so base is only ever observed inside a backend’s storage (checkpoint files, database rows). Additive: absent from the wire when unset, so pre-W4 checkpoints deserialize unchanged.

§header: CheckpointHeader

Flight Recorder provenance (R0.5): checkpoint format version, graph version/content hash, active policy version, and the run’s logical clock value at creation. See CheckpointHeader for the semantics.

#[serde(default)] keeps checkpoints written before R0.5 (which have no header field) deserializable: they load with CheckpointHeader::default — current format version, unversioned graph, static policy.

§journal_ref: Option<JournalRef>

The journal head at this boundary (None pre-R0.5), binding this state snapshot to the run evidence that produced it.

Implementations§

Source§

impl Checkpoint

Source

pub fn new( thread_id: impl Into<String>, step: usize, state: State, next_nodes: Vec<String>, ) -> Self

A new checkpoint with a fresh UUID v4 id and current timestamp.

Convenience constructor used by tests and pre-R0.5 call paths: the header falls back to CheckpointHeader::default and no journal reference is stamped. The executor mints checkpoints field-by-field instead, sourcing id/timestamp from the run’s determinism seams and stamping the real header and journal head.

Trait Implementations§

Source§

impl Clone for Checkpoint

Source§

fn clone(&self) -> Checkpoint

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Checkpoint

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for Checkpoint

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for Checkpoint

Source§

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

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more