cerebro 1.1.10

An AI memory layer and multi-agent swarm engine in async Rust: specialized agents share working, episodic and semantic memory.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use crate::swarm::agent::{ChatMessage, LlmProvider, Role};
use crate::swarm::llm::LlmClient;
use crate::traits::VectorStore;
use std::sync::Arc;
use tokio::time::{interval, Duration};

/// Experimental background worker that periodically scans the stored memories.
///
/// With [`with_holographic_compression`](Self::with_holographic_compression) set and
/// more than 10 memories stored, it asks the LLM to summarise up to 20 chunks into one
/// "axiom" and prints it. The axiom is not stored yet, and pruning and merging of
/// memory chunks are not implemented yet.
pub struct ConsolidationWorker {
    store: Arc<dyn VectorStore>,
    interval_seconds: u64,
    compressor_provider: Option<LlmProvider>,
}

impl ConsolidationWorker {
    pub fn new(store: Arc<dyn VectorStore>, interval_seconds: u64) -> Self {
        Self {
            store,
            interval_seconds,
            compressor_provider: None,
        }
    }

    /// Enable Holographic Memory Compression with an LLM provider.
    pub fn with_holographic_compression(mut self, provider: LlmProvider) -> Self {
        self.compressor_provider = Some(provider);
        self
    }

    /// Spawns the worker in a background Tokio task.
    pub fn start(self) {
        let store = self.store.clone();
        let interval_seconds = self.interval_seconds;
        let provider = self.compressor_provider.clone();

        tokio::spawn(async move {
            let mut ticker = interval(Duration::from_secs(interval_seconds));
            let llm = LlmClient::new();

            loop {
                ticker.tick().await;
                eprintln!("[Consolidation] Sleep cycle starting...");

                if let Ok(nodes) = store.get_all_nodes().await {
                    eprintln!("[Consolidation] Found {} memories.", nodes.len());

                    if let Some(ref p) = provider {
                        // Holographic Compression: If we have > 10 nodes, we compress them into an Axiom.
                        if nodes.len() > 10 {
                            eprintln!(
                                "[Consolidation] Holographic compression triggered for {} nodes...",
                                nodes.len()
                            );

                            let mut combined_text = String::new();
                            for node in nodes.iter().take(20) {
                                combined_text.push_str(&node.chunk.text);
                                combined_text.push('\n');
                            }

                            let system_prompt = "You are a Holographic Memory Compressor. \
                            Read the following episodic memories and output a SINGLE highly abstract, \
                            generalized axiom that summarizes the core truth or pattern within them. \
                            Output ONLY the axiom as plain text.";

                            let messages = vec![
                                ChatMessage::new(Role::System, system_prompt),
                                ChatMessage::new(Role::User, combined_text),
                            ];

                            if let Ok(response) = llm.chat(p, &messages).await {
                                let axiom = response.content.trim();
                                if !axiom.is_empty() {
                                    eprintln!(
                                        "🌌 Holographic Axiom generated (not stored yet): {}",
                                        axiom
                                    );

                                    // In a full implementation, we would embed this axiom, save it as a new Node,
                                    // give it a massive RRF weight, and delete the old uncompressed nodes.
                                    // For now, we only log it.
                                }
                            }
                        }
                    }

                    eprintln!(
                        "[Consolidation] Pruning and merging are not implemented yet; no memories were changed."
                    );
                } else {
                    eprintln!("[Consolidation Error] Could not fetch nodes.");
                }
            }
        });
    }
}