Skip to main content

Module persistence

ravenclaws

Module persistence 

Source
Expand description

§Conversation Persistence (SQLite backend)

Provides SQLite-backed storage for conversation history so agents survive pod restarts without losing context. Supports configurable retention policies (time-based, count-based, token-budget-based).

§Architecture

  • ConversationStore — manages a SQLite database with sessions and messages tables
  • Sessions are identified by a session ID (UUID or user-provided)
  • Messages are stored with role, content, timestamp, and token count
  • Retention policies are applied on read (not on write) for simplicity

§Usage

use ravenclaws::persistence::ConversationStore;

let store = ConversationStore::open(":memory:")?;
store.create_session("session-1", "You are a helpful assistant.")?;
store.add_message("session-1", "user", "Hello!", None)?;
let history = store.get_history("session-1", None)?;

Structs§

ConversationStore
SQLite-backed conversation store
StoredMessage
A stored conversation message
StoredSession
A stored conversation session

Enums§

RetentionPolicy
Retention policy for pruning old conversations