Skip to main content

Module memory

Module memory 

Source
Expand description

MobKit agent-memory record layer (docs/design/agent-memory-architecture.md).

Deterministic structure only — record model and scopes (records), staged mutations with the commit validator (staged), and the bundled per-realm SQLite store (sqlite_store). This module sits inside the §12 bright-line ratchet (scripts/check-memory-bright-line): it must never grow retrieval-index machinery; that is hub material.

Re-exports§

pub use coordinator::MobScopeResolver;
pub use coordinator::OperatorResolver;
pub use coordinator::RecallCoordinator;
pub use coordinator::ScopeBudget;
pub use coordinator::compose_identity_scope_set;
pub use coordinator::compose_identity_scope_set_with_bindings;
pub use coordinator::compose_identity_scope_set_with_operator;
pub use coordinator::compose_scope_budgets;
pub use distiller::CompactionDiscardSource;
pub use distiller::CompactionFollowUp;
pub use distiller::DistillCause;
pub use distiller::DistillOutcome;
pub use distiller::DistillerClientHandle;
pub use distiller::DistillerConfig;
pub use distiller::DistillerEngine;
pub use distiller::DistillerError;
pub use distiller::DistillerProfile;
pub use distiller::DistillerTriggers;
pub use distiller::FactoryDistillerHandle;
pub use distiller::HnswDiscardSource;
pub use distiller::SessionStoreTranscriptSource;
pub use distiller::TombstoneMeta;
pub use distiller::TombstoneSource;
pub use distiller::TranscriptSource;
pub use events::MemoryEventSink;
pub use events::MemoryTimelineEvent;
pub use guards::BackgroundBudget;
pub use guards::BackgroundBudgetConfig;
pub use guards::BudgetDenied;
pub use guards::BudgetPermit;
pub use hygienist::AppliedRevision;
pub use hygienist::DistillationGate;
pub use hygienist::FactoryHygienistHandle;
pub use hygienist::HygieneCause;
pub use hygienist::HygieneOutcome;
pub use hygienist::HygienistClientHandle;
pub use hygienist::HygienistConfig;
pub use hygienist::HygienistEngine;
pub use hygienist::HygienistError;
pub use hygienist::HygienistProfile;
pub use hygienist::HygienistTriggers;
pub use hygienist::RevisionAction;
pub use hygienist::RevisionOp;
pub use hygienist::RevisionProposal;
pub use hygienist::RevisionReject;
pub use hygienist::SessionServiceRevisionSeam;
pub use hygienist::SpanReference;
pub use hygienist::SpanReferenceSource;
pub use hygienist::StoreSpanReferenceSource;
pub use hygienist::TranscriptRevisionSeam;
pub use hygienist::ValidatedRevision;
pub use hygienist::distiller_follow_up;
pub use hygienist::parse_revision_reply;
pub use hygienist::validate_revision;
pub use records::CalibrationRef;
pub use records::EvidenceRef;
pub use records::InjectionLogEntry;
pub use records::InjectionSurface;
pub use records::ManifestTier;
pub use records::MemoryAuthor;
pub use records::MemoryId;
pub use records::MemoryKind;
pub use records::MemoryProvenance;
pub use records::MemoryRecord;
pub use records::MemoryScope;
pub use records::NewMemoryRecord;
pub use records::ProposalId;
pub use records::RecordMeta;
pub use records::RecordStatus;
pub use records::TrustTier;
pub use records::UsageEvent;
pub use records::UsageStats;
pub use records::VerificationClaim;
pub use records::content_hash;
pub use selector::AnnotatedRecord;
pub use selector::Coverage;
pub use selector::FactorySelectorHandle;
pub use selector::RecordProvenance;
pub use selector::SELECTOR_ENV_VAR;
pub use selector::SelectedRecordFetch;
pub use selector::Selection;
pub use selector::SelectorError;
pub use selector::SelectorHandle;
pub use selector::SelectorProfile;
pub use selector::SelectorRuntime;
pub use selector::SelectorSpec;
pub use selector::SelectorStage;
pub use selector::select;
pub use spawn_customizer::MemorySpawnCustomizer;
pub use sqlite_store::EvidenceRefResolver;
pub use sqlite_store::PendingHarvest;
pub use sqlite_store::PendingPromotion;
pub use sqlite_store::PendingProposal;
pub use sqlite_store::ScopeOverview;
pub use sqlite_store::SqliteAgentMemoryStore;
pub use staged::CommitReceipt;
pub use staged::StageToken;
pub use staged::StagedBatchError;
pub use staged::StagedBatchView;
pub use staged::StagedMemoryStore;
pub use staged::StagedMutationBatch;
pub use staged::StagedOp;
pub use staged::StagedRecordView;
pub use staged::validate_batch;
pub use steward::DreamOutcome;
pub use steward::DreamRun;
pub use steward::FactoryStewardHandle;
pub use steward::MemoryConflictBridge;
pub use steward::MemoryGatingBridge;
pub use steward::MobPurposeSource;
pub use steward::PromotionGateResolver;
pub use steward::SessionStoreEvidenceResolver;
pub use steward::StewardClientHandle;
pub use steward::StewardConfig;
pub use steward::StewardEngine;
pub use steward::StewardError;
pub use steward::StewardProfile;
pub use steward::StewardTriggers;
pub use taint::CompactionResetSink;
pub use taint::ContentTrustConfig;
pub use taint::LlmWriteGate;
pub use taint::MemberAgentEventSink;
pub use taint::SessionTaintTracker;
pub use taint::TaintLlmWriteGate;
pub use taint::TaintObserverGuard;
pub use taint::TaintState;
pub use taint::ToolContentTrust;
pub use taint::spawn_member_event_observer;
pub use taint::spawn_taint_observer;

Modules§

coordinator
Recall coordinator (docs/design/agent-memory-architecture.md §9).
distiller
Distiller — extraction from evidence (docs/design/agent-memory-architecture.md §8.4).
events
Typed memory timeline events (§9.3).
guards
Background-work resource guards (§8.1).
hygienist
Hygienist — context curation at boundaries (§8.6).
records
Durable agent-memory record model.
secrets
§10.4 secret hygiene: curated gitleaks-class scanning on the memory write path.
selector
LLM Selector — recall judgment without a horizon (docs/design/agent-memory-architecture.md §8.3).
spawn_customizer
Classic-mob agent memory (docs/design/agent-memory-architecture.md §8.2, §9.1) without the identity-first orchestration layer.
sqlite_store
Bundled per-realm SQLite agent-memory store (§7.3).
staged
Staged mutation batches and the deterministic commit validator.
steward
Steward — the dreaming consolidator (docs/design/agent-memory-architecture.md §8.5).
taint
Coarse session-sticky content-taint tracking (§10.1, P1).