rig-memory 0.38.1

Conversation memory policies (sliding window, token budget, ...) for the Rig agent framework.
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

# rig-memory

Conversation memory policies for the [Rig](https://github.com/0xPlaygrounds/rig)
agent framework.

`rig-core` ships the `ConversationMemory` trait and an in-process
`InMemoryConversationMemory` backend. This crate provides reusable named
policies for shaping loaded history before it is sent to the model:

- [`NoopMemoryPolicy`] — identity policy, useful as a default.
- [`SlidingWindowMemory`] — keep the most recent `N` messages, dropping any
  leading orphan tool result.
- [`TokenWindowMemory`] — keep the most recent messages that fit within a token
  budget supplied by a [`TokenCounter`].

## Usage

```rust,no_run
use rig_memory::{InMemoryConversationMemory, SlidingWindowMemory, IntoFilter};

let memory = InMemoryConversationMemory::new()
    .with_filter(SlidingWindowMemory::last_messages(20).into_filter());
```

For backends other than `InMemoryConversationMemory`, apply a policy directly:

```rust,ignore
use rig_memory::{MemoryPolicy, SlidingWindowMemory};

let policy = SlidingWindowMemory::last_messages(20);
let trimmed = policy.apply(loaded_messages)?;
```

To wrap any backend with a policy and propagate policy errors to the caller
(rather than silently degrading to identity on failure), use `PolicyMemory`:

```rust,no_run
use rig_memory::{InMemoryConversationMemory, PolicyMemory, SlidingWindowMemory};

let memory = PolicyMemory::new(
    InMemoryConversationMemory::new(),
    SlidingWindowMemory::last_messages(20),
);
```