agent-message-window 0.1.0

Sliding window of recent LLM conversation turns with paired-protection: never drop a tool_use without its tool_result sibling. Zero deps (serde_json only).
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

# agent-message-window

Sliding window of recent LLM conversation turns with paired-protection: never drop a `tool_use` message without also dropping its `tool_result` sibling.

The Anthropic API rejects conversations where a `tool_result` block references a `tool_use` ID that is no longer in the message history. A naive "drop the oldest" window breaks the next request silently. This crate fixes that.

## Usage

```rust
use agent_message_window::MessageWindow;
use serde_json::json;

let mut win = MessageWindow::new(20, true);

win.add(json!({"role": "user", "content": "search for X"})).unwrap();
win.add(json!({
    "role": "assistant",
    "content": [
        {"type": "tool_use", "id": "u1", "name": "search", "input": {"q": "X"}}
    ]
})).unwrap();
win.add(json!({
    "role": "user",
    "content": [
        {"type": "tool_result", "tool_use_id": "u1", "content": "results..."}
    ]
})).unwrap();

// Pass win.messages_owned() to the next API call.
```

## Features

- `max_turns` cap with oldest-first eviction
- Paired protection: evicting a `tool_use` cascades to orphaned `tool_result` messages
- `paired_protect = false` for raw oldest-first eviction
- Zero dependencies beyond `serde_json`

## License

MIT OR Apache-2.0