Skip to content

Commit 16f2398

Browse files
committed
Update ARCHITECTURE.md to include transport layer information
1 parent ded9985 commit 16f2398

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

docs/ARCHITECTURE.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,26 @@ The Zig HTTP adapter spawns worker threads that call into the Zig FFI concurrent
142142

143143
The panic-attack security scanner validated the thread-safety model across all 9 modules. Results: 1 expected weak point (QUIC crypto — inherent to the protocol's 0-RTT replay window, mitigated at the application layer), 0 critical vulnerabilities.
144144

145+
## Transport Layer
146+
147+
BoJ supports multiple transport protocols:
148+
149+
- **stdio** (default): JSON-RPC 2.0 over stdin/stdout (Claude Code, Glama, etc.)
150+
- **REST** (port 7700): HTTP/1.1 JSON API
151+
- **gRPC** (port 7701): Binary protocol for high-performance clients
152+
- **GraphQL** (port 7702): Flexible querying for UI/integration layers
153+
- **SSE** (port 7703): Server-Sent Events for real-time updates
154+
155+
Each cartridge declares its supported protocols in its manifest. The MCP bridge routes calls to the appropriate transport.
156+
157+
### Auto-Reconnect
158+
159+
The transport layer includes an exponential backoff with jitter mechanism for improved resilience. This ensures that the system can recover from connection issues and continue to operate smoothly.
160+
161+
### Health Monitoring
162+
163+
The transport layer provides detailed health information, including cartridge connection status. This makes it easy to monitor the system's health and identify any issues.
164+
145165
## Unified-Zig-API Stack
146166

147167
The estate standard for all Zig-edge service boundaries is the **unified-zig-api

0 commit comments

Comments
 (0)