Struct RunCheckpoint 

#[non_exhaustive]
pub struct RunCheckpoint {
    pub run_id: RunId,
    pub step_index: u32,
    pub thread_id: ThreadId,
    pub messages: Vec<Message>,
    pub pending_tool_calls: Option<Vec<ToolCall>>,
    pub resume_attempted: bool,
    pub created_at: DateTime<Utc>,
}

Minimal state required to resume a suspended run. Excludes the Agent (its Arc<dyn _> ports are not serializable) — only the conversation and the tool calls awaiting approval are captured.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

run_id: RunId

Stable across resume; doubles as the KvStore key for this checkpoint.

step_index: u32

1-indexed step the resume re-enters the loop at.

thread_id: ThreadId

Thread whose short-term history is cleared and restored from messages.

messages: Vec<Message>

Short-term history captured at suspend time, oldest first.

pending_tool_calls: Option<Vec<ToolCall>>

Tool calls held back for approval; Some only when the paused step’s finish reason was ToolCalls.

resume_attempted: bool

Latched true by the first resume before it dispatches the pending calls, so a later (retried, cross-process) resume can tell it is not the first attempt. A retry that finds this set refuses to re-dispatch a non-idempotent pending call rather than risk a duplicate side effect (ADR-045 fail-closed). #[serde(default)] keeps pre-existing persisted checkpoints (no field) readable — they default to false, the first-attempt state.

created_at: DateTime<Utc>

Suspend timestamp, for TTL/GC of abandoned checkpoints.

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 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.