portail 2.1.0

Unified proxy/gateway: AI Gateway + MCP Gateway + CDN cache
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

# Portail Documentation

## Table of Contents

- [Quick Start](../README.md#quick-start)
- [Configuration](../README.md#configuration)
- [API Reference](../README.md#api-endpoints)
- [Architecture](../DESIGN.md)

## Modules

| Module | Description | File |
|--------|-------------|------|
| proxy | HTTP routing, middleware | `src/proxy.rs` |
| gateway | AI upstream forwarding | `src/gateway/mod.rs` |
| cdn | Two-tier cache | `src/cdn/mod.rs` |
| events | Event log + SSE | `src/events/mod.rs` |
| hooks | Prompt injection | `src/hooks/mod.rs` |
| sentinel | Health watcher | `src/sentinel/mod.rs` |
| mcp | MCP sidecar | `src/mcp/mod.rs` |
| a2a | Agent-to-Agent protocol | `src/a2a/mod.rs` |
| a2c | Agent-to-Consumer chat | `src/a2c/mod.rs` |
| cli | TUI dashboard + CLI | `src/cli/` |

## Building

```bash
# Debug build
cargo build

# Release build (LTO + strip)
cargo build --release

# With UPX compression
upx --best --lzma target/release/portail
```

## Testing

```bash
# Run all tests
cargo test

# Run specific test
cargo test test_name

# Run with output
cargo test -- --nocapture
```

## Deployment

### NixOS

```nix
# flake.nix
inputs.portail.url = "github:peterlodri-sec/portail";

# configuration.nix
services.portail = {
  enable = true;
  package = inputs.portail.packages.${pkgs.system}.portail;
};
```

### Docker

```bash
docker build -t portail .
docker run -p 8787:8787 portail
```

### Systemd

```ini
[Unit]
Description=Portail proxy
After=network.target

[Service]
ExecStart=/usr/local/bin/portail serve
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```