Expand description
Always-on memory agent for Nexus Memory System
Provides three core services:
- Ingest: Extract structured info from raw text using LLM
- Consolidate: Find patterns across memories
- Query: Answer questions with memory citations
Re-exports§
pub use cognitive_cache::CognitiveCache;pub use cognitive_cache::ConfidenceTier;pub use cognitive_cache::HotCache;pub use cognitive_cache::HotCacheEntry;pub use consolidate::ConsolidateService;pub use context_builder::build_context_md;pub use derive::DeriveService;pub use derive::DerivedObservation;pub use digest::DigestResult;pub use digest::DigestService;pub use dream_cycle::run_dream_cycle;pub use dream_cycle::DreamCycleRequest;pub use error::AgentError;pub use error::Result;pub use inbox::InboxScanner;pub use inbox::ScanResult;pub use ingest::IngestService;pub use query::introspect_query;pub use query::QueryService;pub use reflect::ReflectService;pub use reflect::ReflectionCase;pub use reflect::ReflectionOutput;pub use reflect::ReflectionResult;pub use representation::RepresentationService;pub use runtime::create_embedding_service;pub use runtime::derive_session_key;pub use runtime::RuntimeController;pub use runtime::RuntimeMode;pub use runtime::RuntimeShutdownReason;pub use supervisor::AgentSupervisor;pub use token_budget::TokenBudget;pub use util::CognitionSnapshot;pub use types::*;
Modules§
- activity_
monitor - Activity monitoring and sleep detection for dream cycle calibration.
- cognitive_
cache - Cognitive cache data models for tiering and ranking.
- consolidate
- Consolidate service - finds patterns across memories
- context_
builder - Builds context.md from hot and cold caches with budget awareness.
- derive
- Derivation service - converts raw memories into explicit observations.
- digest
- Digest service - produces short and long session summaries.
- distill
- Activity distillation pipeline — summarises raw hook events into structured session memories using LLM or a deterministic fallback.
- dream_
cycle - Dream cycle orchestration — signal collection, adaptive scheduling, job enqueue, and cognition draining.
- error
- Agent-specific error types
- identity
- Cross-session identity resolution.
- inbox
- Inbox scanner - watches directory for new files
- ingest
- Ingest service - extracts structured info from raw text
- job_
processor - Job processing for derive, reflect, and digest cognition jobs.
- prompts
- LLM prompt templates for agent operations
- pulse
- Agent pulse file for cross-process status communication
- query
- Query service - answers questions using memory context.
- reflect
- Reflection service - deterministic reinforcement and contradiction detection.
- representation
- Representation service - assembles bounded working-memory context.
- runtime
- Session-scoped runtime controller for hook-driven cognition.
- runtime_
state - Runtime state persistence, session key derivation, and helper types.
- session_
manager - Manages session scratch files and learning extraction.
- soul
- Soul management for unified user identity and cross-project learnings.
- supervisor
- Agent supervisor - manages background agent loops
- token_
budget - Token budget management for context window allocation.
- types
- Types for agent operations
- util
- Shared utility functions for agent services