Skip to main content

checkpoints.config

Checkpoint configuration.

CheckpointConfig Objects​

@dataclass
class CheckpointConfig()

Configuration for conversation checkpointing.

Parameters​

enabled : bool Whether checkpointing is active. frequency : str When to auto-checkpoint: "every_tool", "every_turn", or "manual_only". max_checkpoints : int Rolling window — oldest pruned when exceeded. store : str Storage backend: "in_memory", "file", or "s3". file_dir : str Directory for file-based storage.

frequency​

"every_tool" | "every_turn" | "manual_only"

store​

"in_memory" | "file" | "s3"

from_spec​

@classmethod
def from_spec(cls, spec_checkpoints: dict | None) -> "CheckpointConfig"

Create from AgentSpec checkpoints section.

from_env​

@classmethod
def from_env(cls) -> "CheckpointConfig"

Create from environment variables.