Struct Checkpoint 

pub struct Checkpoint {

    pub id: String,
    pub graph_name: String,
    pub current_node: String,
    pub state_snapshot: Value,
    pub path: Vec<String>,
    pub step_count: usize,
    pub created_at: DateTime<Utc>,
    pub pending_action: Option<Value>,
    pub interrupt_type: InterruptType,
    pub parent_checkpoint_id: Option<String>,
    pub label: Option<String>,
    pub tags: Vec<String>,
    pub branch: Option<String>,
}

Checkpoint - snapshot of graph execution state

Contains all information needed to resume execution:

• Execution path and step count
• Shared state snapshot
• Pending node information

Supports time-travel debugging via parent_checkpoint_id lineage, human-readable label/tags, and branch forking.

Fields

id: String

Unique identifier

graph_name: String

Graph name

current_node: String

Current node

state_snapshot: Value

State snapshot (JSON serialized)

path: Vec<String>

Execution path

step_count: usize

Step count

created_at: DateTime<Utc>

Creation time

pending_action: Option<Value>

Pending tool calls (if any)

interrupt_type: InterruptType

Interrupt type

parent_checkpoint_id: Option<String>

Parent checkpoint ID for lineage tracking. None for the first checkpoint in a session.

label: Option<String>

Human-readable label (e.g., “before risky operation”, “branch:feature-x”)

tags: Vec<String>

Tags for filtering and discovery

branch: Option<String>

Branch name if this checkpoint is a fork

Implementations

impl Checkpoint

pub fn new( graph_name: String, current_node: String, state: &SharedState, path: Vec<String>, step_count: usize, interrupt_type: InterruptType, ) -> Checkpoint

Create a new Checkpoint

pub fn with_parent( parent_id: impl Into<String>, graph_name: String, current_node: String, state: &SharedState, path: Vec<String>, step_count: usize, interrupt_type: InterruptType, ) -> Checkpoint

Create a new Checkpoint with explicit parent for lineage tracking.

pub fn branch( parent_id: impl Into<String>, branch_name: impl Into<String>, graph_name: String, current_node: String, state: &SharedState, path: Vec<String>, step_count: usize, interrupt_type: InterruptType, ) -> Checkpoint

Create a new branch checkpoint (fork off an existing checkpoint).

pub fn with_label(self, label: impl Into<String>) -> Checkpoint

Set a human-readable label on this checkpoint.

pub fn with_tags(self, tags: Vec<String>) -> Checkpoint

Add tags to this checkpoint.

pub fn restore_state(&self) -> Result<SharedState, ReactError>

Restore SharedState from a Checkpoint

Trait Implementations

impl Clone for Checkpoint

fn clone(&self) -> Checkpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Checkpoint

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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Checkpoint> for CheckpointInfo

fn from(cp: &Checkpoint) -> CheckpointInfo

Converts to this type from the input type.

impl Serialize for Checkpoint

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

where __S: Serializer,

Serialize this value into the given Serde serializer.