Add federation proposal for cross-server agent communication

Closed
KH
6mo ago
+4469-2

Comprehensive design document for extending agent-relay to support
federated multi-server deployments while preserving the core
differentiator: automatic message injection via tmux.

Key design decisions:

  • Separation of concerns: routing (network) vs injection (local)
  • Hybrid topology: optional hub for discovery, direct peer connections
  • Progressive enhancement: single-server unchanged, federation opt-in
  • WebSocket + TLS for peer-to-peer daemon communication
  • Message queuing for resilience during disconnects

Includes:

  • Full protocol specification (PEER_HELLO, PEER_ROUTE, etc.)
  • Agent discovery and registry design
  • Security model (TLS, pre-shared tokens)
  • Configuration schema
  • CLI interface design
  • 5-phase implementation plan (~4-5 weeks)

bd-TBD