Module checkpoint 

Read-only and save checkpoint tools that surface the session’s checkpoint chain.

checkpoint_list and checkpoint_diff are read-only observer tools. checkpoint_save (Goal 284) lets the agent create explicit restore points on demand — the only path that creates new shadow-git objects during a run.

Restoration remains runtime/CLI-driven (see recursive sessions rewind).

Structs

CheckpointDiff

CheckpointList

CheckpointSave

CheckpointSaveCtx

Context for the on-demand checkpoint_save tool.

CheckpointToolCtx

Shared state for the read-only checkpoint tools.

Functions

build_checkpoint_save_tool

Build a CheckpointSave tool wired to the given shared state.

build_checkpoint_tools

Build the read-only checkpoint tools for a given session. Returns None if the shadow repo cannot be opened (e.g. git missing).

build_checkpoint_tools_at

Like build_checkpoint_tools, but with an explicit shadow_dir, for tests that want to bypass paths::user_data_dir() resolution.