rig-memvid 0.2.0

Memvid-backed persistent memory and lexical store for Rig agents.
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Memvid-backed persistent memory for [Rig](https://crates.io/crates/rig-core).
//!
//! See the crate-level [README](../README.md) for a quick-start. The two
//! main types are:
//!
//! - [`MemvidStore`] — implements [`rig::vector_store::VectorStoreIndex`].
//!   Wire it into an agent with `agent.dynamic_context(n, store.clone())`.
//! - [`MemvidPersistHook`] — implements
//!   [`rig::agent::PromptHook`]. Attach with
//!   `prompt.with_hook(hook)` to record every turn into the same store.
//!
//! Sharing a single [`MemvidStore`] between recall and persistence is the
//! intended pattern: writes through the hook are visible to subsequent
//! searches in the same process.
//!
//! # Re-exports
//!
//! [`memvid_core`] is re-exported so callers do not need to add it as a
//! direct dependency to construct [`memvid_core::PutOptions`],
//! [`memvid_core::AclContext`], or [`memvid_core::SearchRequest`] when
//! reaching for [`MemvidStore::search`] / [`MemvidStore::put_text`].
//!
//! # Platform support
//!
//! The crate is `cfg`-gated off on `wasm`: memvid relies on synchronous
//! file I/O and a process-level file lock that have no analogue under
//! `wasm32-unknown-unknown`. On wasm targets the crate is intentionally
//! empty so that downstream crates can still depend on it transitively
//! without a build break.

#![cfg_attr(not(target_family = "wasm"), deny(missing_docs))]

#[cfg(target_family = "wasm")]
compile_error!(
    "rig-memvid does not currently support `wasm` targets: memvid-core requires \
     synchronous file I/O and OS-level file locks. Disable rig-memvid for wasm \
     builds via Cargo target-specific dependencies."
);

#[cfg(not(target_family = "wasm"))]
mod cards_context;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
mod compactor;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
mod dedup;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
mod demotion;
#[cfg(not(target_family = "wasm"))]
mod error;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
mod frame_writer;
#[cfg(not(target_family = "wasm"))]
mod hook;
#[cfg(not(target_family = "wasm"))]
pub mod inmem;
#[cfg(not(target_family = "wasm"))]
mod memory_graph;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub mod metadata;
#[cfg(all(not(target_family = "wasm"), feature = "context-projection"))]
pub mod projection;
#[cfg(all(not(target_family = "wasm"), feature = "context-projection"))]
pub use projection::{
    IntoContextItem, MemoryCandidate, MemoryContextPack, SupersededCandidate,
    card_docs_to_context_items, inmem_hits_to_context_items, items_to_memory_candidates,
    memory_cards_to_context_items, search_hits_to_context_items, supersede,
};
#[cfg(not(target_family = "wasm"))]
mod store;

#[cfg(not(target_family = "wasm"))]
pub use cards_context::{CardDoc, CardSelection, MemoryCardContext};
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub use compactor::MemvidStoringCompactor;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub use demotion::MemvidDemotionHook;
#[cfg(not(target_family = "wasm"))]
pub use error::MemvidError;
#[cfg(not(target_family = "wasm"))]
pub use hook::{
    MemoryConfig, MemoryConfigBuilder, MemvidPersistHook, WriteFailure, WriteFailureAction,
    WriteFailurePhase, WritePolicy, WriteTransform,
};
#[cfg(not(target_family = "wasm"))]
pub use inmem::{Episode, InMemoryError, InMemoryHit, InMemoryStore};
#[cfg(not(target_family = "wasm"))]
pub use memory_graph::MemoryGraph;
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub use metadata::{FrameKind, MemvidFrameMetadata};
/// Re-exports of the `rig-memory` compaction surface so callers can
/// build a `CompactingMemory<M, P, MemvidStoringCompactor<C>>` without
/// adding `rig-memory` as a direct dependency.
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub use rig::memory::{Compactor, DemotionHook, MemoryError};
#[cfg(all(not(target_family = "wasm"), feature = "compaction"))]
pub use rig_memory::{CompactingMemory, TemplateCompactor, TextSummary};
#[cfg(not(target_family = "wasm"))]
pub use store::{MemvidFilter, MemvidStore, MemvidStoreBuilder};

#[cfg(not(target_family = "wasm"))]
pub use memvid_core::types::{LogicMeshStats, SearchHitEntity};
/// Re-exports of the memvid-core memory-card surface that
/// [`MemvidStore`] returns from
/// [`MemvidStore::entity_memories`] and friends. Re-exported here so
/// callers do not need a direct `memvid-core` dependency just to name
/// the structured-memory types.
#[cfg(not(target_family = "wasm"))]
pub use memvid_core::{
    EntityKind, FollowResult, MemoryCard, MemoryCardId, MemoryKind, MeshEdge, MeshNode, Polarity,
    VersionRelation,
};

#[cfg(not(target_family = "wasm"))]
pub use memvid_core;