🧠 AgentDB v3 Controllers

Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.13) providing 20+ memory controllers accessible via MCP tools and the CLI. As of @claude-flow/cli@3.7.0-alpha.8, the integration includes the new Cypher-routed delete API (deleteNode, deleteEdge, deleteEdgesByEndpoints, deleteHyperedge, plus ReflexionMemory.deleteEpisode) for full re-index support.

Core Memory:

Controller	MCP Tool	Description
HierarchicalMemory	agentdb_hierarchical-store/recall	Working → episodic → semantic memory tiers with Ebbinghaus forgetting curves and spaced repetition
MemoryConsolidation	agentdb_consolidate	Automatic clustering and merging of related memories into semantic summaries
BatchOperations	agentdb_batch	Bulk insert/update/delete operations for high-throughput memory management
ReasoningBank	agentdb_pattern-store/search	Pattern storage with BM25+semantic hybrid search

Intelligence:

Controller	MCP Tool	Description
SemanticRouter	agentdb_semantic-route	Route tasks to agents using vector similarity instead of manual rules
ContextSynthesizer	agentdb_context-synthesize	Auto-generate context summaries from memory entries
GNNService	—	Graph neural network for intent classification and skill recommendation
SonaTrajectoryService	—	Record and predict learning trajectories for agents
GraphTransformerService	—	Sublinear attention, causal attention, Granger causality extraction

Causal & Explainable:

Controller	MCP Tool	Description
CausalRecall	agentdb_causal-edge	Recall with causal re-ranking and utility scoring
ExplainableRecall	—	Certificates proving why a memory was recalled
CausalMemoryGraph	—	Directed causal relationships between memory entries
MMRDiversityRanker	—	Maximal Marginal Relevance for diverse search results

Security & Integrity:

Controller	MCP Tool	Description
GuardedVectorBackend	—	Cryptographic proof-of-work before vector insert/search
MutationGuard	—	Token-validated mutations with cryptographic proofs
AttestationLog	—	Immutable audit trail of all memory operations

Optimization:

Controller	MCP Tool	Description
RVFOptimizer	—	4-bit adaptive quantization and progressive compression

MCP Tool Examples:

bash
# Store to hierarchical memory
agentdb_hierarchical-store --key "auth-pattern" --value "JWT refresh" --tier "semantic"

# Recall from memory tiers
agentdb_hierarchical-recall --query "authentication" --topK 5

# Run memory consolidation
agentdb_consolidate

# Batch insert
agentdb_batch --operation insert --entries '[{"key":"k1","value":"v1"}]'

# Synthesize context
agentdb_context-synthesize --query "error handling patterns"

# Semantic routing
agentdb_semantic-route --input "fix auth bug in login"

Hierarchical Memory Tiers:

┌─────────────────────────────────────────────┐
│  Working Memory                             │  ← Active context, fast access
│  Size-based eviction (1MB limit)            │
├─────────────────────────────────────────────┤
│  Episodic Memory                            │  ← Recent patterns, moderate retention
│  Importance × retention score ranking       │
├─────────────────────────────────────────────┤
│  Semantic Memory                            │  ← Consolidated knowledge, persistent
│  Promoted from episodic via consolidation   │
└─────────────────────────────────────────────┘