Crate brainwires_memory 

brainwires-memory

Tiered hot/warm/cold agent memory orchestration.

The schema layer (the five tier stores — MessageStore, SummaryStore, FactStore, MentalModelStore, TierMetadataStore, plus the shared tier_types) lives in brainwires_stores. This crate adds:

• TieredMemory — multi-factor adaptive search across all four tiers (similarity × recency × importance), plus promotion / demotion of entries when access patterns change.
• dream — offline consolidation engine that summarises hot-tier messages into warm-tier summaries, extracts cold-tier facts, and demotes by retention score. Feature-gated behind dream.

Re-exports

pub use tiered_memory::CanonicalWriteToken;

pub use tiered_memory::MultiFactorScore;

pub use tiered_memory::TieredMemory;

pub use tiered_memory::TieredMemoryConfig;

pub use tiered_memory::TieredMemoryStats;

pub use tiered_memory::TieredSearchResult;

Modules

dream

Offline memory consolidation — the write path for warm/cold tiers.

tiered_memory

Tiered Memory Storage System

Structs

FactStore

Store for cold tier key facts with semantic search

KeyFact

Key fact extracted from messages for cold-tier storage.

MentalModel

A synthesised mental model stored in the lowest memory tier.

MentalModelStore

Persistent storage for the mental-model tier.

MessageMetadata

Metadata for a message

MessageStore

Store for managing messages with semantic search

MessageSummary

Summary of a message for warm-tier storage.

SummaryStore

Store for warm tier message summaries with semantic search

TierMetadata

Metadata tracking for tiered storage.

TierMetadataStore

Store for tier metadata

Enums

FactType

Type of key fact.

MemoryAuthority

Trust level of a memory entry’s origin.

MemoryTier

Memory tier classification.

ModelType

The kind of pattern a mental model encodes.