Reference
System Internals Reference
This is the exact field-by-field mechanics behind Platform Overview: the connect sequence, wire shapes, scaling internals, SDK module routing, and failure-mode tables. Read ARCHITECTURE.md first for the big picture. Consult these docs for an exact field, timeout, or module boundary. For a from-scratch reimplementation walkthrough, see Minimal Reimplementation Recipe. For the exhaustive socket-event-by-event capture, see Wire Protocol.
| Doc | Covers |
|---|---|
| System Internals Reference · Connection and Handshake | Endpoints & Credentials, Socket.IO Connection, Full Connect Sequence, the join payload |
| System Internals Reference · Audio & Video Wiring | ASR Channel: Microphone Uplink, STV Channel: Avatar Video Downlink |
| System Internals Reference · Conversation Flow | Conversation Phase (brain output, talking state, lifecycle events), Sending User Input, Complete Message Catalog |
| System Internals Reference · Scale and Sticky Sessions | Sticky routing, the capacity queue, connection vs. session recovery, externalized session state |
| System Internals Reference · Module Map and Data Flow | SDK module map, resolveCapabilities shape, the GenUI layer, DTO routing rules, known limits |
| System Internals Reference · Resilience and Failure Handling | Reconnection tiers, device permissions, the failure-mode matrix, the tool-call-spiral breaker, session-completion signal |