Enum CompactionStrategy 

#[non_exhaustive]
pub enum CompactionStrategy {
    SlidingWindow {
        keep_recent_turns: usize,
    },
    TokenBudget {
        max_tokens: usize,
        keep_recent_turns: usize,
    },
    ClearToolUses {
        keep_recent_turns: usize,
        placeholder: String,
    },
}

How to compact. All strategies drop the oldest turns and keep at least CompactionConfig::min_recent_turns recent ones.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SlidingWindow

Keep only the most recent keep_recent_turns steps (sliding window).

Fields

keep_recent_turns: usize

Number of recent steps to keep.

TokenBudget

Drop the oldest steps until the estimated token footprint is within max_tokens, but never below keep_recent_turns steps.

Fields

max_tokens: usize

Estimated token ceiling for the retained history.

keep_recent_turns: usize

Number of recent steps always kept, even over budget.

ClearToolUses

ClearToolUses (C2, v0.22.1 §S8): trim context without dropping turns.

Replaces the tool observation text of steps older than the most recent keep_recent_turns with a short placeholder. Every step is retained — history length is preserved and no action is orphaned from its (placeholder) observation, so the model still sees the full k-ary sequence of tool calls, just without the bulky results. Idempotent: already-clear observations are left untouched on later compactions.

Fields

keep_recent_turns: usize

Number of most recent steps whose observations stay intact.

placeholder: String

Placeholder text inserted in place of cleared observations.

Trait Implementations

impl Clone for CompactionStrategy

fn clone(&self) -> CompactionStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactionStrategy

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

Formats the value using the given formatter.