Crate vex_temporal 

VEX Temporal

Time-aware memory compression for hierarchical agents.

Features

• Multi-scale time horizons (5 min → permanent)
• Automatic context decay with configurable strategies
• Episodic memory management with importance scoring

Quick Start

use vex_temporal::{EpisodicMemory, Episode, HorizonConfig};

// Create memory with custom config
let mut memory = EpisodicMemory::new(HorizonConfig {
    max_entries: 100,
    ..Default::default()
});

// Remember events with importance scores
memory.remember("User asked about quantum computing", 0.8);
memory.remember("Provided detailed explanation", 0.9);

// Add pinned memories (never evicted)
memory.add(Episode::pinned("System configuration"));

// Get summary
println!("{}", memory.summarize());

Time Horizons

Horizon	Duration	Max Entries
Immediate	5 min	10
ShortTerm	1 hour	25
MediumTerm	24 hours	50
LongTerm	1 week	100
Permanent	∞	500

Re-exports

pub use compression::DecayStrategy;

pub use compression::TemporalCompressor;

pub use horizon::HorizonConfig;

pub use horizon::TimeHorizon;

pub use memory::Episode;

pub use memory::EpisodicMemory;

Modules

compression

Temporal compression strategies

horizon

Time horizon definitions for agents

memory

Episodic memory management