brainwires-stores 0.11.0

Opinionated minimum data-store set for the Brainwires Agent Framework — sessions, conversations, tasks, plans, locks, images, and tiered hot/warm/cold memory. All built on the brainwires-storage StorageBackend trait.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! # brainwires-stores
//!
//! Schema + CRUD for the framework's opinionated minimum data-store set.
//!
//! Every store is built on the [`brainwires_storage::StorageBackend`] trait —
//! consumers can swap backends without touching store code. Each store
//! family is gated behind a Cargo feature so consumers only pay for what
//! they use.
//!
//! This crate is **schema only**. Orchestration (multi-tier search,
//! promotion / demotion logic) and the offline `dream` consolidation
//! engine live in the **`brainwires-memory`** crate, which depends on
//! the schema types here.
//!
//! ## Feature flags
//!
//! - `session` *(default)* — `SessionStore` trait + `InMemorySessionStore`
//!   (and `SqliteSessionStore` with the `sqlite` feature). Full-transcript
//!   persistence keyed by session id.
//! - `task` *(default)* — `TaskStore` + `AgentStateStore`.
//! - `plan` *(default)* — `PlanStore` + `TemplateStore`.
//! - `conversation` *(default)* — `ConversationStore` (catalog metadata).
//! - `memory` — tier schema stores: `MessageStore`, `SummaryStore`,
//!   `FactStore`, `MentalModelStore`, `TierMetadataStore`, plus the
//!   shared `tier_types` (`MemoryTier`, `MemoryAuthority`, `TierMetadata`,
//!   `MessageSummary`, `KeyFact`, `FactType`).
//! - `lock` — `LockStore`. Coordination locks (rusqlite-backed).
//! - `image` — `ImageStore` with hashing + metadata.
//! - `sqlite` — pulls rusqlite for backends that need it.

#[cfg(feature = "session")]
pub mod session;

#[cfg(feature = "memory")]
pub mod memory;

#[cfg(feature = "conversation")]
pub mod conversation_store;

#[cfg(feature = "image")]
pub mod image_store;

#[cfg(feature = "lock")]
pub mod lock_store;

#[cfg(feature = "plan")]
pub mod plan_store;

#[cfg(feature = "task")]
pub mod task_store;

#[cfg(feature = "plan")]
pub mod template_store;

#[cfg(feature = "session")]
pub use session::{
    ArcSessionStore, InMemorySessionStore, ListOptions, Message, SessionBroker, SessionError,
    SessionId, SessionMessage, SessionRecord, SessionStore, SessionSummary, SpawnRequest,
    SpawnedSession,
};

#[cfg(all(feature = "session", feature = "sqlite"))]
pub use session::SqliteSessionStore;

#[cfg(feature = "memory")]
pub use memory::{
    FactStore, FactType, KeyFact, MemoryAuthority, MemoryTier, MentalModel, MentalModelStore,
    MessageMetadata, MessageStore, MessageSummary, ModelType, SummaryStore, TierMetadata,
    TierMetadataStore, facts_field_defs, facts_schema, messages_schema, summaries_field_defs,
    summaries_schema, tier_types,
};

#[cfg(feature = "conversation")]
pub use conversation_store::{ConversationMetadata, ConversationStore};

#[cfg(feature = "image")]
pub use image_store::ImageStore;

#[cfg(feature = "lock")]
pub use lock_store::{LockRecord, LockStats, LockStore};

#[cfg(feature = "plan")]
pub use plan_store::PlanStore;

#[cfg(feature = "task")]
pub use task_store::{AgentStateMetadata, AgentStateStore, TaskMetadata, TaskStore};

#[cfg(feature = "plan")]
pub use template_store::{PlanTemplate, TemplateStore};