desktop: local voice status API for companion apps #2

Merged
charles merged 1 commit from feature/local-status-api into main 2026-11-02 05:08:43 +00:00
Owner

Adds an opt-in, read-only local WebSocket feed of live voice status for companion apps on the same machine (Mirabox Stream Dock / stream deck plugins, overlays).

What's in it

  • Desktop (fluxer_desktop/src/main/StatusApi.ts): /status on the loopback RPC port (21863 stable, 21864 canary). WebSocket push + one-shot GET. Token required, website origins always refused, 15 s heartbeat, slow readers dropped, status reset to null when the renderer reloads or crashes.
  • App (DesktopVoiceStatusBridge.ts): pushes connection state, self mute/deaf/video/stream/presence and each participant's speaking / mute / deaf / camera / stream state as soon as it changes.
  • Settings: new Companion apps section on the desktop settings tab: toggle (applies live), copy URL, reveal/copy token, regenerate token. 7 new strings, translated for all 34 locales (written by hand, not native-reviewed).
  • Docs: fluxer_docs/docs/topics/local-status-api.md, the protocol reference for the Mirabox plugin.

Testing

  • Desktop and app typechecks, Biome, and lingui compile --strict pass.
  • Server integration tests (real RpcServer/StatusApi bundled with Electron stubs, Node WebSocket client): auth/origin rules, live push and dedupe, frames >64 KB, ping/pong, heartbeat, null reset, live toggle, token rotation disconnecting clients, config persistence.
  • Not yet verified in a running app on a live call.

🤖 Generated with Claude Code

Adds an opt-in, read-only local WebSocket feed of live voice status for companion apps on the same machine (Mirabox Stream Dock / stream deck plugins, overlays). ## What's in it - **Desktop** (`fluxer_desktop/src/main/StatusApi.ts`): `/status` on the loopback RPC port (21863 stable, 21864 canary). WebSocket push + one-shot `GET`. Token required, website origins always refused, 15 s heartbeat, slow readers dropped, status reset to `null` when the renderer reloads or crashes. - **App** (`DesktopVoiceStatusBridge.ts`): pushes connection state, self mute/deaf/video/stream/presence and each participant's speaking / mute / deaf / camera / stream state as soon as it changes. - **Settings**: new *Companion apps* section on the desktop settings tab: toggle (applies live), copy URL, reveal/copy token, regenerate token. 7 new strings, translated for all 34 locales (written by hand, not native-reviewed). - **Docs**: `fluxer_docs/docs/topics/local-status-api.md`, the protocol reference for the Mirabox plugin. ## Testing - Desktop and app typechecks, Biome, and `lingui compile --strict` pass. - Server integration tests (real RpcServer/StatusApi bundled with Electron stubs, Node WebSocket client): auth/origin rules, live push and dedupe, frames >64 KB, ping/pong, heartbeat, null reset, live toggle, token rotation disconnecting clients, config persistence. - Not yet verified in a running app on a live call. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Adds an opt-in, read-only WebSocket feed of live voice status so apps on
the same machine (stream deck / Mirabox Stream Dock plugins, overlays) can
show who is in the voice channel and who is talking.

- Desktop: /status on the existing loopback RPC port (21863 stable,
  21864 canary). WebSocket push plus one-shot GET. Token required,
  web origins always refused, 15 s heartbeat, slow-reader drop, status
  reset to null on renderer reload/crash.
- App: DesktopVoiceStatusBridge pushes connection state, self state and
  per-participant speaking/mute/deaf/camera/stream over IPC as it changes.
- Settings: "Companion apps" section in the desktop settings tab to
  toggle the API live, copy the URL/token and regenerate the token.
  Strings translated for all locales.
- Docs: fluxer_docs topics/local-status-api.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
charles deleted branch feature/local-status-api 2026-11-02 05:08:47 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer!2
No description provided.