Struct CompactionConfig 

pub struct CompactionConfig {
    pub max_truncation_recoveries: u8,
    pub auto_enabled: bool,
    pub auto_threshold_percent: u8,
    pub tail_turns: usize,
    pub tail_token_budget: usize,
    pub tool_output_max_chars: usize,
    pub summary_max_tokens: usize,
    pub summarizer_input_token_budget: usize,
    pub min_response_reserve_tokens: usize,
    pub max_response_reserve_tokens: usize,
}

Context-compaction settings.

Every field maps onto a crate::domain::CompactionPolicy knob that was previously a hard-coded constant. Values are sanitized on the way out (see CompactionConfig::policy) rather than validated on the way in: a bad number should degrade to the nearest sane one, not refuse to start the app.

Fields

max_truncation_recoveries: u8

Cap on consecutive auto-compact-and-continue recoveries after a context-window truncation, before the run stops and shows the manual levers (/context max, /context offload on). The counter resets whenever the run makes progress, so this bounds only no-progress thrashing on a too-small window. 0 means uncapped.

Example:

[compaction]
max_truncation_recoveries = 0  # never give up on its own

auto_enabled: bool

Compact automatically when the context crosses the threshold below. false leaves compaction entirely to /compact — the provider’s own context limit then becomes the only backstop.

auto_threshold_percent: u8

Window fill (percent) at which auto-compaction triggers. Clamped to 1..=100; a value of 100 effectively means “only when the response reserve no longer fits”.

tail_turns: usize

How many trailing user turns survive compaction verbatim. Clamped to at least 1 — a compaction that preserved no turn would hand the model a summary with no live thread to continue.

tail_token_budget: usize

Token ceiling on that preserved tail. When the last tail_turns exceed it, older turns are dropped from the tail until it fits.

tool_output_max_chars: usize

Per-message character cap applied to tool output inside the summarizer’s history excerpt (prose gets 4x this). Keeps one enormous tool result from crowding out the rest of the conversation.

summary_max_tokens: usize

Ceiling on the checkpoint the summarizer may produce. Scaled DOWN automatically for small context windows (see CompactionPolicy::summary_output_tokens), so this is a cap and not a demand.

summarizer_input_token_budget: usize

Ceiling on the summarizer’s input (prompt scaffold plus history excerpt). Also scaled down to fit a small window.

min_response_reserve_tokens: usize

Floor and ceiling on the window room held back for the model’s reply when deciding whether the context counts as “full”. Swapped values are corrected rather than rejected.

max_response_reserve_tokens: usize

Implementations

impl CompactionConfig

pub fn policy(&self) -> CompactionPolicy

The live policy, with every value clamped into a range compaction can actually operate in.

Sanitizing here rather than at load time means a hand-edited config can never put the app in a state where compaction silently cannot run — the failure mode that motivated it is a min_response_reserve above max_response_reserve, which would make response_reserve return the smaller maximum and quietly under-reserve on every turn.

Trait Implementations

impl Clone for CompactionConfig

fn clone(&self) -> CompactionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CompactionConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CompactionConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompactionConfig

where CompactionConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompactionConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.