Context
Technical specification building on terminal multiplexer survey (#231), proposing @miadi/upterm-agent-bridge to extend Upterm's secure sharing with RMUX-style automation, Hermes plugin compatibility, and Indigenous-aligned session persistence for multi-agent coordination.
Gap Analysis
Upterm provides connectivity (NAT traversal, access control) for human pair programming. Miadi/Hermes needs:
- Typed SDK for agents (not just SSH client)
- Structured pane snapshots (not raw TTY streams)
- Locator-style automation (wait-for-text primitives)
- Session resurrection across disconnects
- Hermes plugin ecosystem integration
- Relational/ceremonial design alignment
Proposed Solution
Integration Layer Architecture:
- Upterm Relay Extension โ WebSocket event streams
- Agent Protocol Shim โ RMUX SDK patterns over Upterm
- Hermes Hook Adapter โ semantic event publishers
- Tide Runtime Integration โ cross-agent session routing
Capabilities: Multi-agent role-based access, structured state snapshots, locator-based automation, session resurrection, Indigenous context frames.
Deliverable
Academic survey (10 fields), field relationships mapping, technical spec with Python/TypeScript bindings for Tide runtime + Upterm protocol.
Related
Builds on #231 (terminal multiplexer survey).