Struct CompressionSpectrumConfig 

pub struct CompressionSpectrumConfig {
    pub enabled: bool,
    pub promotion_output_dir: Option<String>,
    pub promotion_provider: ProviderName,
    pub promotion_window: usize,
    pub min_occurrences: u32,
    pub min_sessions: u32,
    pub cluster_threshold: f32,
    pub retrieval_low_budget_ratio: f32,
    pub retrieval_mid_budget_ratio: f32,
}

Experience compression spectrum configuration, nested under [memory.compression_spectrum].

When enabled = true, the agent uses a three-tier memory retrieval policy (Episodic → Procedural → Declarative) keyed on remaining token budget, and runs a background promotion engine that converts recurring episodic patterns into generated SKILL.md files.

Example (TOML)

[memory.compression_spectrum]
enabled = true
promotion_output_dir = "~/.config/zeph/skills/promoted"
promotion_provider = "quality"

Fields

enabled: bool

Enable the compression spectrum. Default: false.

promotion_output_dir: Option<String>

Directory where promoted SKILL.md files are written.

promotion_provider: ProviderName

Provider name for SKILL.md generation during promotion. Empty = primary provider.

promotion_window: usize

Maximum number of recent episodic messages to scan for promotion candidates. Default: 200.

min_occurrences: u32

Minimum number of times a pattern must appear across all sessions to be promoted. Default: 3.

min_sessions: u32

Minimum number of distinct sessions containing the pattern. Default: 2.

cluster_threshold: f32

Cosine similarity threshold for clustering episodic messages. Default: 0.85.

retrieval_low_budget_ratio: f32

Remaining-token ratio below which only episodic recall is used. Default: 0.20.

retrieval_mid_budget_ratio: f32

Remaining-token ratio below which episodic + procedural recall is used. Default: 0.50.

Trait Implementations

impl Debug for CompressionSpectrumConfig

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

Formats the value using the given formatter.

impl Default for CompressionSpectrumConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompressionSpectrumConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompressionSpectrumConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.