Skip to main content

Module snapshot

Module snapshot 

Source
Expand description

W2-2: First-class KernelSnapshot โ€” live kernel state serialization.

Enables:

  • Crash recovery (save state, restart, restore)
  • Agent migration (move running agent between hosts)
  • Checkpointing for long-running tasks
  • Cross-session state persistence

The snapshot captures the essential kernel state needed to resume execution:

  • TaskTable (all TCBs with budget, wait state, proc info)
  • Context summary (messages, task state, signals)
  • Turn counter and budget totals

NOT captured (recreated on restore):

  • SignalRouter dedup set (cleared on restore)
  • Governance pipeline closures (recreated from policy data)
  • MilestoneTracker state (recreated from config)
  • HandleTable (recreated from context history)

Structsยง

ContextSnapshot
Snapshot of context state (simplified representation).
KernelSnapshot
Full kernel snapshot.
ProcInfoSnapshot
Snapshot of ProcInfo (sub-agent identity).
ResultSnapshot
Snapshot of SubAgentResult.
TcbSnapshot
Serializable snapshot of a TCB (Task Control Block).