What lives in a checkpoint

  • Session ID + user ID
  • Full message history (or ref to it)
  • In-flight tool calls with args
  • Agent-level attributes
  • Wake-up timer if paused
Advertisement

Standard checkpoint points

  1. Before every tool call (so we know what we were about to do).
  2. After every model call (so we know what was decided).
  3. On explicit pause (waiting for human, timer, webhook).
  4. Before graceful shutdown.

Advertisement

Skip these

Every token delta. Every log line. Every trace span. Checkpoints are for resumption, not observability.