|
| 1 | +# AGNTCY SLIM Architecture Visualizer (2D) |
| 2 | + |
| 3 | +An interactive 2D SVG-based visualizer explaining the **Secure Low-Latency Interactive Messaging (SLIM)** architecture and protocols. It demonstrates a multi-node distributed routing network in a clean, lightweight pipeline: |
| 4 | + |
| 5 | +- **Local & Cloud Data Planes (SLIM Nodes 1 & 2)**: Visualizes a multi-hop topology. Agent A connects locally to **SLIM Node 1 (Local)**, which bridges and peers with **SLIM Node 2 (Cloud)**. Destinations (Agents B, C, D) are connected directly to the cloud node. |
| 6 | +- **Control Plane Orchestration**: Highlights the separation of control and data planes. Shows how the out-of-band **SLIM Controller** pushes table configurations and pings telemetry heartbeats to both SLIM Node 1 and SLIM Node 2. |
| 7 | +- **MLS End-to-End Encryption**: Exchanging key commits/welcomes across multiple hops, establishing secure group states (Epoch 1). Demonstrates that intermediate nodes 1 & 2 forward packets based only on envelope headers, and cannot decrypt payload ciphertexts. |
| 8 | +- **Multicast Capability**: Replicating and distributing a single message payload from a sender (Agent A) to multiple destinations (Agents B, C, D) through the multi-node mesh. |
| 9 | +- **Google Agent2Agent (A2A) RPC integration**: Serialization and execution of protobuf request/response frames over SLIMRPC. |
| 10 | + |
| 11 | +--- |
| 12 | + |
| 13 | +## How to Run the Visualizer |
| 14 | + |
| 15 | +### Option 1: Direct File Open |
| 16 | +You can open the [index.html](file:///Users/mamarton/Documents/notes/slim-doc/index.html) file directly in any modern web browser: |
| 17 | +- Double-click `index.html` in your file explorer. |
| 18 | +- Or drag and drop it into a browser tab. |
| 19 | + |
| 20 | +### Option 2: Live Local Server |
| 21 | +The project is currently hosted on your local system. Open: |
| 22 | +👉 **[http://localhost:8099](http://localhost:8099)** |
| 23 | + |
| 24 | +--- |
| 25 | + |
| 26 | +## Interactive Features |
| 27 | +1. **Interactive Journeys**: Click the tabs in the sidebar to switch between the 4 main architectural scenarios. |
| 28 | +2. **Step Controller**: Pause/resume the flow or click "Next Step" to advance through the steps manually. |
| 29 | +3. **Protocol Log Terminal**: View real-time, authentic Rust `tracing` logs (color-coded by component tag) as transmission particles flow across connection lines. |
| 30 | +4. **Dynamic Node Badges**: Check active states (like current encryption epoch and routing maps) rendered directly inside the nodes. |
| 31 | +5. **Interactive Tooltips**: Hover your cursor over any node in the SVG window (Agent A, SLIM Nodes 1 & 2, Agents B, C, D, or Controller) to view details about its structural role. |
0 commit comments