Struct TierConfig 

pub struct TierConfig {
    pub enabled: bool,
    pub promotion_min_sessions: u32,
    pub similarity_threshold: f32,
    pub sweep_interval_secs: u64,
    pub sweep_batch_size: usize,
    pub scene_enabled: bool,
    pub scene_similarity_threshold: f32,
    pub scene_batch_size: usize,
    pub scene_provider: ProviderName,
    pub scene_sweep_interval_secs: u64,
}

Configuration for the AOI three-layer memory tier promotion system ([memory.tiers]).

When enabled = true, a background sweep promotes frequently-accessed episodic messages to semantic tier by clustering near-duplicates and distilling them via an LLM call.

Validation

Constraints enforced at deserialization time:

• similarity_threshold in [0.5, 1.0]
• promotion_min_sessions >= 2
• sweep_batch_size >= 1
• scene_similarity_threshold in [0.5, 1.0]
• scene_batch_size >= 1

Fields

enabled: bool

Enable the tier promotion system. When false, all messages remain episodic. Default: false.

promotion_min_sessions: u32

Minimum number of distinct sessions a fact must appear in before promotion. Must be >= 2. Default: 3.

similarity_threshold: f32

Cosine similarity threshold for clustering near-duplicate facts during sweep. Must be in [0.5, 1.0]. Default: 0.92.

sweep_interval_secs: u64

How often the background promotion sweep runs, in seconds. Default: 3600.

sweep_batch_size: usize

Maximum number of messages to evaluate per sweep cycle. Must be >= 1. Default: 100.

scene_enabled: bool

Enable MemScene consolidation of semantic-tier messages. Default: false.

scene_similarity_threshold: f32

Cosine similarity threshold for MemScene clustering. Must be in [0.5, 1.0]. Default: 0.80.

scene_batch_size: usize

Maximum unassigned semantic messages processed per scene consolidation sweep. Default: 50.

scene_provider: ProviderName

Provider name from [[llm.providers]] for scene label/profile generation. Falls back to the primary provider when empty. Default: "".

scene_sweep_interval_secs: u64

How often the background scene consolidation sweep runs, in seconds. Default: 7200.

Trait Implementations

impl Clone for TierConfig

fn clone(&self) -> TierConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TierConfig

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

Formats the value using the given formatter.

impl Default for TierConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TierConfig

where TierConfig: 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 TierConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.