Struct EpisodicStore 

pub struct EpisodicStore { /* private fields */ }

Stores episodic (event-based) memories for agents, ordered by insertion time.

Guarantees

• Thread-safe via Arc<Mutex<_>>
• Ordered: recall returns items in descending importance order
• Bounded by optional capacity

Implementations

impl EpisodicStore

pub fn new() -> Self

Create a new unbounded episodic store without decay.

pub fn with_decay(policy: DecayPolicy) -> Self

Create a new episodic store with the given decay policy.

pub fn with_recall_policy(policy: RecallPolicy) -> Self

Create a new episodic store with the given recall policy.

pub fn with_per_agent_capacity(capacity: usize) -> Self

Create a new episodic store with the given per-agent capacity limit.

When an agent exceeds this capacity, the lowest-importance item for that agent is evicted.

pub fn add_episode( &self, agent_id: AgentId, content: impl Into<String> + Debug, importance: f32, ) -> Result<MemoryId, AgentRuntimeError>

Record a new episode for the given agent.

Returns

The MemoryId of the newly created memory item.

pub fn add_episode_at( &self, agent_id: AgentId, content: impl Into<String> + Debug, importance: f32, timestamp: DateTime<Utc>, ) -> Result<MemoryId, AgentRuntimeError>

Add an episode with an explicit timestamp.

pub fn recall( &self, agent_id: &AgentId, limit: usize, ) -> Result<Vec<MemoryItem>, AgentRuntimeError>

Recall up to limit memories for the given agent.

Applies decay if configured, increments recall_count for each recalled item in-place, then returns items sorted according to the configured RecallPolicy (default: descending importance).

pub fn len(&self) -> Result<usize, AgentRuntimeError>

Return the total number of stored episodes across all agents.

pub fn is_empty(&self) -> Result<bool, AgentRuntimeError>

Return true if no episodes have been stored.

Trait Implementations

impl Clone for EpisodicStore

fn clone(&self) -> EpisodicStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EpisodicStore

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

Formats the value using the given formatter.

impl Default for EpisodicStore

fn default() -> Self

Returns the “default value” for a type.