Skip to main content

Crate rig_memory_policy

Crate rig_memory_policy 

Source
Expand description

Backend-agnostic memory-policy primitives shared across Rig memory-store adapters (rig-memvid and future backends like SQLite, LanceDB, Qdrant, plain filesystem, etc.).

Public surface:

  • dedup — in-process content-hash dedup for hooks/compactors that must satisfy rig::memory::{DemotionHook, Compactor}’s idempotency contract.
  • metadata — typed envelope written into a backend’s per-entry metadata so downstream tools (evals, inspectors, RAG pipelines) can reason about the lifecycle that produced each entry.
  • inmem — a deterministic no-disk reference store for tests, examples, and offline modes.
  • store — the minimal TextWriter + Committable capability traits backends impl so hooks and compactors can be generic over the storage engine.
  • error — neutral PolicyError for failures in the above helpers.

This crate has no dependency on memvid-core or any specific storage engine. Backends are expected to wrap these primitives in their own adapter (e.g. rig-memvid adds .mv2 framing on top).

See the store module docs for the audit-driven rationale behind the deliberately narrow trait surface.

Re-exports§

pub use error::PolicyError;
pub use inmem::Episode;
pub use inmem::InMemoryHit;
pub use inmem::InMemoryStore;
pub use store::Committable;
pub use store::TextWriter;

Modules§

dedup
In-process content-hash dedup for memory-store hooks and compactors.
error
Neutral error type for rig-memory-policy helpers.
inmem
In-memory append-only episode store with lexical retrieval.
metadata
Typed metadata envelope for entries written by memory-lifecycle hooks.
store
Backend-agnostic memory-store capability traits.