Module checkpoint 

Task Checkpointing & Persistence

Enables resumable long-running tasks by saving state to disk. Captures:

• Task description and status
• Conversation messages
• Tool call history with timing
• Git state for reproducibility
• Error logs for debugging

Checkpoints are stored as JSON files and can be resumed with Agent::resume().

Structs

CheckpointDelta

Represents the delta/diff between two checkpoints

CheckpointManager

Manager for saving and loading task checkpoints

ErrorLog

Log of an error during execution

GitCheckpointInfo

Git state at checkpoint time

GuardCounters

Anti-thrash guard counters persisted across resume. These are in-memory on the agent and otherwise reset to 0 on every restart — so a watchdog that auto-resumes a crash-looping task would hand it fresh rope forever, turning crash-loops into amnesiac infinite loops. Persisting them lets the guards (prefill breaker, mutation-gate abort, no-action abort) fire ACROSS resumes.

MemoryEntry

A memory entry for serialization

TaskCheckpoint

A complete checkpoint of task state

TaskSummary

Summary of a task for listing

ToolCallLog

Log of a tool execution

VerificationResult

Result of a visual verification check (used for verification results)

VisualAssertion

A persistent visual assertion that gates task progression. Can be used both for pending assertions (to verify) and completed assertions (in history).

Enums

TaskStatus

Status of a task checkpoint

Constants

CURRENT_CHECKPOINT_VERSION

Current version of the checkpoint format

Functions

capture_git_state

Capture current git state for checkpoint