or-recall 0.1.3

Short-term, long-term, and episodic memory stores for Orchustr agents.
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
101
102
103
104
105
106

//! Memory/context tests: multi-kind storage, overwrite, isolation.

use or_recall::{InMemoryRecallStore, MemoryKind, RecallEntry, RecallOrchestrator};

#[tokio::test]
async fn remember_multiple_kinds_are_isolated() {
    let store = InMemoryRecallStore::new();
    RecallOrchestrator
        .remember(
            &store,
            RecallEntry {
                id: "s1".to_owned(),
                kind: MemoryKind::ShortTerm,
                content: "short".to_owned(),
                metadata: serde_json::json!({}),
            },
        )
        .await
        .unwrap();
    RecallOrchestrator
        .remember(
            &store,
            RecallEntry {
                id: "l1".to_owned(),
                kind: MemoryKind::LongTerm,
                content: "long".to_owned(),
                metadata: serde_json::json!({}),
            },
        )
        .await
        .unwrap();

    let short = RecallOrchestrator
        .recall(&store, MemoryKind::ShortTerm)
        .await
        .unwrap();
    let long = RecallOrchestrator
        .recall(&store, MemoryKind::LongTerm)
        .await
        .unwrap();
    assert_eq!(short.len(), 1);
    assert_eq!(long.len(), 1);
    assert_eq!(short[0].content, "short");
    assert_eq!(long[0].content, "long");
}

#[tokio::test]
async fn remember_overwrites_with_same_id() {
    let store = InMemoryRecallStore::new();
    RecallOrchestrator
        .remember(
            &store,
            RecallEntry {
                id: "x".to_owned(),
                kind: MemoryKind::ShortTerm,
                content: "v1".to_owned(),
                metadata: serde_json::json!({}),
            },
        )
        .await
        .unwrap();
    RecallOrchestrator
        .remember(
            &store,
            RecallEntry {
                id: "x".to_owned(),
                kind: MemoryKind::ShortTerm,
                content: "v2".to_owned(),
                metadata: serde_json::json!({}),
            },
        )
        .await
        .unwrap();

    let entries = RecallOrchestrator
        .recall(&store, MemoryKind::ShortTerm)
        .await
        .unwrap();
    // Either 1 entry (overwrite) or 2 (append) — test documents behavior
    let latest = entries.iter().find(|e| e.id == "x").unwrap();
    assert!(latest.content == "v1" || latest.content == "v2");
}

#[tokio::test]
async fn recall_preserves_metadata() {
    let store = InMemoryRecallStore::new();
    RecallOrchestrator
        .remember(
            &store,
            RecallEntry {
                id: "m1".to_owned(),
                kind: MemoryKind::Episodic,
                content: "event".to_owned(),
                metadata: serde_json::json!({"source": "user", "turn": 3}),
            },
        )
        .await
        .unwrap();

    let entries = RecallOrchestrator
        .recall(&store, MemoryKind::Episodic)
        .await
        .unwrap();
    assert_eq!(entries[0].metadata["source"], "user");
    assert_eq!(entries[0].metadata["turn"], 3);
}