Adds a module-level JSDoc block explaining:
- The Hermes gateway's role as the single entry point for all AI
provider responses (Claude → Gemini → Perplexity → fallback)
- The full connection lifecycle (connect → onopen → onmessage →
onclose → _scheduleReconnect)
- The exponential backoff schedule (1s, 2s, 4s … capped at 30s,
up to 10 attempts, then ws-failed)
- The message queue that buffers outbound messages while disconnected
- A reference table of all dispatched CustomEvent names and payloads
Also adds @param/@returns JSDoc to each method for IDE discoverability.
Fixes#287
