Skip to content

Commit 94ff327

Browse files
committed
feat: add slim graph test
Signed-off-by: Mark Marton <mark.p.marton@gmail.com>
1 parent acb637e commit 94ff327

7 files changed

Lines changed: 2223 additions & 0 deletions

File tree

docs/slim-graph/README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
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

Comments
 (0)