mindcore 0.2.0

Pluggable, feature-gated memory engine for AI agent applications
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

use crate::error::Result;

/// Consumer-provided LLM access for all LLM-assisted operations.
///
/// MindCore never calls an LLM directly — the consumer controls model choice,
/// cost, and retry behavior by providing this trait implementation.
///
/// Used by: `LLMConsolidation`, `LlmIngest`, `EvolutionStrategy`, `reflect()`.
/// All LLM-dependent features work (degraded) when no callback is provided.
pub trait LlmCallback: Send + Sync {
    /// Given a prompt, return the LLM's response.
    ///
    /// The consumer is responsible for:
    /// - Model selection (Claude, GPT, local Llama, etc.)
    /// - Token budget management
    /// - Retry logic and error handling
    /// - Rate limiting
    fn complete(&self, prompt: &str) -> Result<String>;
}

#[cfg(test)]
mod tests {
    use super::*;

    struct MockLlm {
        response: String,
    }

    impl LlmCallback for MockLlm {
        fn complete(&self, _prompt: &str) -> Result<String> {
            Ok(self.response.clone())
        }
    }

    #[test]
    fn mock_llm_works() {
        let llm = MockLlm {
            response: "This is a test response".into(),
        };
        let result = llm.complete("test prompt").expect("complete");
        assert_eq!(result, "This is a test response");
    }

    #[test]
    fn trait_object_works() {
        let llm: Box<dyn LlmCallback> = Box::new(MockLlm {
            response: "trait object response".into(),
        });
        let result = llm.complete("test").expect("complete");
        assert_eq!(result, "trait object response");
    }
}