rig_memvid/
lib.rs

1//! Memvid-backed persistent memory for [Rig](https://crates.io/crates/rig-core).
2//!
3//! See the crate-level [README](../README.md) for a quick-start. The two
4//! main types are:
5//!
6//! - [`MemvidStore`] — implements [`rig::vector_store::VectorStoreIndex`].
7//!   Wire it into an agent with `agent.dynamic_context(n, store.clone())`.
8//! - [`MemvidPersistHook`] — implements
9//!   [`rig::agent::PromptHook`]. Attach with
10//!   `prompt.with_hook(hook)` to record every turn into the same store.
11//!
12//! Sharing a single [`MemvidStore`] between recall and persistence is the
13//! intended pattern: writes through the hook are visible to subsequent
14//! searches in the same process.
15//!
16//! # Re-exports
17//!
18//! [`memvid_core`] is re-exported so callers do not need to add it as a
19//! direct dependency to construct [`memvid_core::PutOptions`],
20//! [`memvid_core::AclContext`], or [`memvid_core::SearchRequest`] when
21//! reaching for [`MemvidStore::search`] / [`MemvidStore::put_text`].
22//!
23//! # Platform support
24//!
25//! The crate is `cfg`-gated off on `wasm`: memvid relies on synchronous
26//! file I/O and a process-level file lock that have no analogue under
27//! `wasm32-unknown-unknown`. On wasm targets the crate is intentionally
28//! empty so that downstream crates can still depend on it transitively
29//! without a build break.
30
31#![cfg_attr(not(target_family = "wasm"), deny(missing_docs))]
32
33#[cfg(target_family = "wasm")]
34compile_error!(
35    "rig-memvid does not currently support `wasm` targets: memvid-core requires \
36     synchronous file I/O and OS-level file locks. Disable rig-memvid for wasm \
37     builds via Cargo target-specific dependencies."
38);
39
40#[cfg(not(target_family = "wasm"))]
41mod cards_context;
42#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
43mod compactor;
44#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
45mod dedup;
46#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
47mod demotion;
48#[cfg(not(target_family = "wasm"))]
49mod error;
50#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
51mod frame_writer;
52#[cfg(not(target_family = "wasm"))]
53mod hook;
54#[cfg(not(target_family = "wasm"))]
55pub mod inmem;
56#[cfg(not(target_family = "wasm"))]
57mod memory_graph;
58#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
59pub mod metadata;
60#[cfg(all(not(target_family = "wasm"), feature = "context-projection"))]
61pub mod projection;
62#[cfg(all(not(target_family = "wasm"), feature = "context-projection"))]
63pub use projection::{
64    IntoContextItem, MemoryCandidate, MemoryContextPack, SupersededCandidate,
65    card_docs_to_context_items, inmem_hits_to_context_items, items_to_memory_candidates,
66    memory_cards_to_context_items, search_hits_to_context_items, supersede,
67};
68#[cfg(not(target_family = "wasm"))]
69mod store;
70
71#[cfg(not(target_family = "wasm"))]
72pub use cards_context::{CardDoc, CardSelection, MemoryCardContext};
73#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
74pub use compactor::MemvidStoringCompactor;
75#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
76pub use demotion::MemvidDemotionHook;
77#[cfg(not(target_family = "wasm"))]
78pub use error::MemvidError;
79#[cfg(not(target_family = "wasm"))]
80pub use hook::{
81    MemoryConfig, MemoryConfigBuilder, MemvidPersistHook, WriteFailure, WriteFailureAction,
82    WriteFailurePhase, WritePolicy, WriteTransform,
83};
84#[cfg(not(target_family = "wasm"))]
85pub use inmem::{Episode, InMemoryError, InMemoryHit, InMemoryStore};
86#[cfg(not(target_family = "wasm"))]
87pub use memory_graph::MemoryGraph;
88#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
89pub use metadata::{FrameKind, MemvidFrameMetadata};
90/// Re-exports of the `rig-memory` compaction surface so callers can
91/// build a `CompactingMemory<M, P, MemvidStoringCompactor<C>>` without
92/// adding `rig-memory` as a direct dependency.
93#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
94pub use rig::memory::{Compactor, DemotionHook, MemoryError};
95#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
96pub use rig_memory::{CompactingMemory, TemplateCompactor, TextSummary};
97#[cfg(not(target_family = "wasm"))]
98pub use store::{MemvidFilter, MemvidStore, MemvidStoreBuilder};
99
100#[cfg(not(target_family = "wasm"))]
101pub use memvid_core::types::{LogicMeshStats, SearchHitEntity};
102/// Re-exports of the memvid-core memory-card surface that
103/// [`MemvidStore`] returns from
104/// [`MemvidStore::entity_memories`] and friends. Re-exported here so
105/// callers do not need a direct `memvid-core` dependency just to name
106/// the structured-memory types.
107#[cfg(not(target_family = "wasm"))]
108pub use memvid_core::{
109    EntityKind, FollowResult, MemoryCard, MemoryCardId, MemoryKind, MeshEdge, MeshNode, Polarity,
110    VersionRelation,
111};
112
113#[cfg(not(target_family = "wasm"))]
114pub use memvid_core;
rig_memvid/lib.rs

rig_memvid/
lib.rs
