Skip to main content

meerkat_mobkit/memory/
mod.rs

1//! MobKit agent-memory record layer (docs/design/agent-memory-architecture.md).
2//!
3//! Deterministic structure only — record model and scopes (`records`),
4//! staged mutations with the commit validator (`staged`), and the bundled
5//! per-realm SQLite store (`sqlite_store`). This module sits inside the
6//! §12 bright-line ratchet (`scripts/check-memory-bright-line`): it must
7//! never grow retrieval-index machinery; that is hub material.
8
9pub mod coordinator;
10pub mod distiller;
11pub mod events;
12pub mod guards;
13pub mod hygienist;
14pub mod records;
15pub mod secrets;
16pub mod selector;
17pub mod spawn_customizer;
18pub mod sqlite_store;
19pub mod staged;
20pub mod steward;
21pub mod taint;
22
23pub use coordinator::{
24    MobScopeResolver, OperatorResolver, RecallCoordinator, ScopeBudget, compose_identity_scope_set,
25    compose_identity_scope_set_with_bindings, compose_identity_scope_set_with_operator,
26    compose_scope_budgets,
27};
28pub use distiller::{
29    CompactionDiscardSource, CompactionFollowUp, DistillCause, DistillOutcome,
30    DistillerClientHandle, DistillerConfig, DistillerEngine, DistillerError, DistillerProfile,
31    DistillerTriggers, FactoryDistillerHandle, HnswDiscardSource, SessionStoreTranscriptSource,
32    TombstoneMeta, TombstoneSource, TranscriptSource,
33};
34pub use events::{MemoryEventSink, MemoryTimelineEvent};
35pub use guards::{BackgroundBudget, BackgroundBudgetConfig, BudgetDenied, BudgetPermit};
36pub use hygienist::{
37    AppliedRevision, DistillationGate, FactoryHygienistHandle, HygieneCause, HygieneOutcome,
38    HygienistClientHandle, HygienistConfig, HygienistEngine, HygienistError, HygienistProfile,
39    HygienistTriggers, RevisionAction, RevisionOp, RevisionProposal, RevisionReject,
40    SessionServiceRevisionSeam, SpanReference, SpanReferenceSource, StoreSpanReferenceSource,
41    TranscriptRevisionSeam, ValidatedRevision, distiller_follow_up, parse_revision_reply,
42    validate_revision,
43};
44pub use records::{
45    CalibrationRef, EvidenceRef, InjectionLogEntry, InjectionSurface, ManifestTier, MemoryAuthor,
46    MemoryId, MemoryKind, MemoryProvenance, MemoryRecord, MemoryScope, NewMemoryRecord, ProposalId,
47    RecordMeta, RecordStatus, TrustTier, UsageEvent, UsageStats, VerificationClaim, content_hash,
48};
49pub use selector::{
50    AnnotatedRecord, Coverage, FactorySelectorHandle, RecordProvenance, SELECTOR_ENV_VAR,
51    SelectedRecordFetch, Selection, SelectorError, SelectorHandle, SelectorProfile,
52    SelectorRuntime, SelectorSpec, SelectorStage, select,
53};
54pub use spawn_customizer::MemorySpawnCustomizer;
55pub use sqlite_store::{
56    EvidenceRefResolver, PendingHarvest, PendingPromotion, PendingProposal, ScopeOverview,
57    SqliteAgentMemoryStore,
58};
59pub use staged::{
60    CommitReceipt, StageToken, StagedBatchError, StagedBatchView, StagedMemoryStore,
61    StagedMutationBatch, StagedOp, StagedRecordView, validate_batch,
62};
63pub use steward::{
64    DreamOutcome, DreamRun, FactoryStewardHandle, MemoryConflictBridge, MemoryGatingBridge,
65    MobPurposeSource, PromotionGateResolver, SessionStoreEvidenceResolver, StewardClientHandle,
66    StewardConfig, StewardEngine, StewardError, StewardProfile, StewardTriggers,
67};
68pub use taint::{
69    CompactionResetSink, ContentTrustConfig, LlmWriteGate, MemberAgentEventSink,
70    SessionTaintTracker, TaintLlmWriteGate, TaintObserverGuard, TaintState, ToolContentTrust,
71    spawn_member_event_observer, spawn_taint_observer,
72};