valve 0.1.0

token stream router
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

# valve

OpenAI-compatible proxy with adaptive token budgeting, per-session dashboards, and optional metrics exporters.

## Quick start

```bash
cargo install --path .
```

Create `config.toml` in `~/.config/valve/` (Linux/macOS) or `%APPDATA%\valve\` (Windows):

```toml
[server]
host = "127.0.0.1"
port = 7532

[proxy]
default_provider = "openai"

[proxy.providers.openai]
kind = "open_ai"
base_url = "https://api.openai.com/v1"
api_key = "sk-your-key"

[adapters]
observers = ["telemetry"]
```

Run the proxy:

```bash
valve
```

The terminal UI starts automatically. Use `Tab`, arrow keys, or `h`/`l` to move between tabs; `1-4` pick a history window; `+/-` cycle windows; `Up/Down` or `j/k` navigate sessions; `r` resets history; `q` quits. Append `--headless` for log-only mode.

## Telemetry exporters

Add an optional Prometheus scrape endpoint or OTLP exporter in `config.toml`:

```toml
[telemetry.prometheus]
enabled = true
listen = "127.0.0.1:9898"

[telemetry.otlp]
enabled = true
endpoint = "http://localhost:4317"
protocol = "grpc"
interval_secs = 60
```

## Examples

```bash
cargo run --example agent_dialogue
cargo run --example agent_dialogue -- --headless
```

## Benchmarks

```bash
cargo bench --bench throughput
```

## License

Dual-licensed under MIT or Apache-2.0. See `LICENSE-MIT` and `LICENSE-APACHE` for details.