graph-based persistent memory storage with uri-hierarchical addressing
Stores AI agent memories as a four-layer graph model (Node-Memory-Edge-Path) with URI-based hierarchical addressing (e.g., core://agent/identity, user://preferences/language) instead of flat vector embeddings. Each memory is a first-class entity with metadata, relationships, and structural context preserved across sessions. The system uses SQLite or PostgreSQL as the backing store with domain-scoped URI routing enabling semantic organization without semantic shredding.
Unique: Uses URI-based hierarchical addressing (domain://path) with a four-layer graph model (Node-Memory-Edge-Path) instead of vector embeddings, preserving structural relationships and enabling deterministic path-based queries. This is fundamentally different from Vector RAG which fragments knowledge into embedding vectors and loses hierarchy.
vs alternatives: Preserves memory structure and relationships unlike Vector RAG which causes 'semantic shredding'; enables deterministic URI-based retrieval instead of probabilistic cosine similarity matching, making memory queries reliable and debuggable.
version-controlled memory mutations with rollback capability
Implements dual version control: Memory version chains track the evolution of individual memory objects (create → update → update), while ChangesetStore records all mutations as atomic transactions with timestamps and metadata. Each change is immutable and reversible, enabling agents to modify their own memories while humans can audit, review, and rollback to any prior state. Uses SQLite/PostgreSQL transaction logs to maintain consistency.
Unique: Implements dual version control (Memory version chains + ChangesetStore) where each mutation is immutable and reversible, with full transaction semantics. This enables agents to autonomously modify memories while maintaining complete human-auditable history and point-in-time rollback — a pattern borrowed from version control systems like Git but applied to agent cognition.
vs alternatives: Unlike Vector RAG systems which are append-only and immutable, Nocturne enables agents to modify their own memories with full auditability and rollback, combining the mutability of traditional databases with the traceability of version control systems.
change review and approval workflow for memory mutations
Implements an optional review workflow where memory mutations (create, update, delete) are staged as pending changesets that require human approval before persisting to the main memory graph. Reviewers can inspect the changeset (before/after state), add comments, and approve or reject. Rejected changes are discarded; approved changes are committed atomically. This enables human-in-the-loop learning for agents.
Unique: Implements a staged changeset review workflow where mutations are pending until human approval, enabling mandatory oversight of agent learning. This is a safety mechanism not found in Vector RAG systems.
vs alternatives: Provides human-in-the-loop control over agent memory mutations through a review workflow, whereas Vector RAG systems have no mechanism for oversight or rejection of learned knowledge.
memory content versioning and diff visualization
Tracks versions of individual memory content (not just mutations) and generates diffs showing what changed between versions. The diff system highlights additions, deletions, and modifications at the character or line level. Humans can browse version history and compare any two versions side-by-side. This enables understanding how a memory evolved and identifying when incorrect information was introduced.
Unique: Provides fine-grained content versioning and diff visualization for individual memories, enabling humans to understand exactly how a memory evolved. This is a developer-friendly debugging tool absent from Vector RAG systems.
vs alternatives: Enables detailed inspection of memory content evolution through diffs, whereas Vector RAG systems provide no visibility into how knowledge changed over time.
cross-session memory persistence and agent identity continuity
Ensures memories created in one session persist and are accessible in subsequent sessions, enabling agents to maintain continuous identity and knowledge across disconnected conversations. The system stores memories with session metadata (session_id, timestamp) but retrieves them without session filtering, so an agent can access all its memories regardless of which session created them. This solves the stateless agent problem where each conversation starts fresh.
Unique: Solves the fundamental stateless agent problem by persisting memories across sessions and enabling agents to maintain continuous identity. This is the core value proposition of Nocturne Memory — agents are no longer amnesiacs.
vs alternatives: Enables true agent continuity and identity across sessions, whereas stateless LLM APIs (OpenAI, Anthropic) lose all context between conversations; Vector RAG can retrieve documents but doesn't solve agent identity.
mcp-native tool interface for agent memory operations
Exposes memory operations as MCP tools (create_memory, read_memory, update_memory, delete_memory, query_memory_by_uri, traverse_graph) that agents can call directly via the Model Context Protocol. Each tool validates inputs against the URI schema, enforces domain constraints, and returns structured responses. The MCP server acts as the AI-facing interface, translating agent intents into graph operations while maintaining consistency and access control.
Unique: Implements MCP tools as the primary agent interface, allowing Claude/Gemini to autonomously perform full CRUD operations on its own memory graph. This is distinct from Vector RAG which typically exposes only read-only retrieval; Nocturne agents are active memory managers, not passive consumers.
vs alternatives: Provides full CRUD memory operations via MCP tools (not just retrieval), enabling agents to learn and evolve their own knowledge base autonomously, whereas Vector RAG systems force agents into a read-only retrieval pattern.
uri-based memory querying with domain scoping and path pattern matching
Enables agents and humans to query memories using URI patterns (e.g., 'core://agent/*', 'user://preferences/language') with wildcard matching, prefix filtering, and domain-scoped isolation. The URI system acts as a semantic namespace where domain (core, user, task, knowledge) determines memory category and path determines hierarchical location. Queries return all memories matching the pattern with their full graph context (edges, relationships, metadata).
Unique: Uses URI-based hierarchical path matching (domain://path/to/memory) with wildcard support instead of semantic similarity, providing deterministic, debuggable queries. This is a filesystem-like approach to memory retrieval rather than the probabilistic vector similarity used in RAG systems.
vs alternatives: Deterministic URI-based queries are debuggable and reproducible, unlike Vector RAG which returns different results based on embedding similarity; enables structural memory organization without semantic shredding.
graph traversal and relationship navigation across memory nodes
Implements graph traversal algorithms (BFS, DFS, path-finding) to navigate relationships between memory nodes (edges) and discover connected memories. The four-layer model (Node-Memory-Edge-Path) enables rich relationship types: memories can reference other memories, form hierarchies, or represent temporal sequences. Traversal respects domain boundaries and returns full context including intermediate nodes and relationship metadata.
Unique: Implements explicit graph traversal with relationship navigation (edges as first-class entities) rather than implicit similarity-based retrieval. This allows agents to discover memories through explicit relationships and understand the reasoning chain that connected them, not just semantic proximity.
vs alternatives: Enables agents to reason about memory relationships explicitly (following edges) rather than implicitly (similarity scores), making reasoning chains auditable and debuggable; Vector RAG has no relationship model.
+5 more capabilities