Module compaction 

Compaction storage for memory summarization.

Compactions are AI-generated summaries of memories stored as separate JSON files. Each compaction covers all memories through a specific sequence number. The raw memory log is never truncated - compactions provide a compressed view.

Files are named compaction_<through_seq>.json (e.g., compaction_42.json).

Structs

Compaction

A compaction record representing a summary of memories through a specific sequence number.

CompactionStore

Manages compaction files in a directory.

Functions

memories_since_last_compaction

Count memories since the last compaction.

run_compaction

Run compaction: summarize new memories since last compaction using an AI agent. Returns None if there are no new memories to compact.