Struct MemoryPolicy 

pub struct MemoryPolicy {

    pub working_ttl_seconds: Option<u64>,
    pub episodic_ttl_seconds: Option<u64>,
    pub semantic_ttl_seconds: Option<u64>,
    pub procedural_ttl_seconds: Option<u64>,
    pub working_decay: DecayStrategy,
    pub episodic_decay: DecayStrategy,
    pub semantic_decay: DecayStrategy,
    pub procedural_decay: DecayStrategy,
    pub spaced_repetition_factor: f64,
    pub spaced_repetition_base_interval_seconds: u64,
    pub consolidation_enabled: bool,
    pub consolidation_threshold: f32,
    pub consolidation_interval_hours: u32,
    pub consolidated_count: u64,
    pub rate_limit_enabled: bool,
    pub rate_limit_stores_per_minute: Option<u32>,
    pub rate_limit_recalls_per_minute: Option<u32>,
}

Per-namespace memory lifecycle policy (COG-1).

Controls type-specific TTLs, decay curves, and spaced repetition behaviour. All fields have sensible defaults; only override what you need.

Fields

working_ttl_seconds: Option<u64>

Default TTL for working memories in seconds (default: 4 h = 14 400 s).

episodic_ttl_seconds: Option<u64>

Default TTL for episodic memories in seconds (default: 30 d = 2 592 000 s).

semantic_ttl_seconds: Option<u64>

Default TTL for semantic memories in seconds (default: 365 d = 31 536 000 s).

procedural_ttl_seconds: Option<u64>

Default TTL for procedural memories in seconds (default: 730 d = 63 072 000 s).

working_decay: DecayStrategy

Decay strategy for working memories (default: exponential).

episodic_decay: DecayStrategy

Decay strategy for episodic memories (default: power_law).

semantic_decay: DecayStrategy

Decay strategy for semantic memories (default: logarithmic).

procedural_decay: DecayStrategy

Decay strategy for procedural memories (default: flat — no decay).

spaced_repetition_factor: f64

Multiplier applied to the TTL extension on each recall. Extension = access_count × sr_factor × sr_base_interval_seconds. Set to 0.0 to disable spaced repetition. (default: 1.0)

spaced_repetition_base_interval_seconds: u64

Base interval in seconds for spaced repetition TTL extension (default: 86 400 = 1 day).

consolidation_enabled: bool

Enable background deduplication of semantically similar memories (default: false).

consolidation_threshold: f32

Cosine-similarity threshold for merging memories (default: 0.92, range 0.85–0.99).

consolidation_interval_hours: u32

How often the background consolidation job runs, in hours (default: 24).

consolidated_count: u64

Total number of memories merged since namespace creation (read-only).

rate_limit_enabled: bool

Master rate-limit switch (default: false — opt-in to avoid breaking existing clients). Set to true to enforce rate_limit_stores_per_minute / rate_limit_recalls_per_minute.

rate_limit_stores_per_minute: Option<u32>

Maximum POST /v1/memory/store operations per minute for this namespace. None = unlimited. Only enforced when rate_limit_enabled = true.

rate_limit_recalls_per_minute: Option<u32>

Maximum POST /v1/memory/recall operations per minute for this namespace. None = unlimited. Only enforced when rate_limit_enabled = true.

Implementations

impl MemoryPolicy

pub fn ttl_for_type(&self, memory_type: &MemoryType) -> Option<u64>

Return the configured TTL for the given memory type, in seconds.

pub fn decay_for_type(&self, memory_type: &MemoryType) -> DecayStrategy

Return the configured decay strategy for the given memory type.

pub fn spaced_repetition_extension(&self, access_count: u32) -> u64

Compute the spaced repetition TTL extension in seconds.

extension = access_count × sr_factor × sr_base_interval_seconds

Trait Implementations

impl Clone for MemoryPolicy

fn clone(&self) -> MemoryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryPolicy

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

Formats the value using the given formatter.

impl Default for MemoryPolicy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MemoryPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoryPolicy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.