Skip to content

Compaction strategies

Souveraine offers five compaction strategies. During normal operation the agent chooses via memory compact --strategy <name>. Warnings above 80%, 90% and 95% are advisory; above 95% the runtime narrows the available output budget.

StrategyLLM?What it doesBest for
MicrocompactNoClears old tool result contents, keeps the call shellsFirst response when tool output carries the bulk
CullNoDrops a closed list of trivial messages while preserving system and tool roundsCheap release of known noise
SlidingWindowNoDrops middle messages, keeps opening + tailFast release when the middle need not be interpreted
SlidingReflectYesReads the middle, then carries its commitments, decisions and threads across the slideContinuity-sensitive work
SummaryYesReplaces old messages with structured boundaryConscious agent who needs the throughline

The hard-overflow recovery path is an exception. If the subconscious is already past the provider’s context ceiling and cannot run, the runtime may invoke its default strategy and record that intervention. Every compaction that changes the session writes a record to Git-backed memory.