feat(desktop): local voice status API for companion apps #3

Merged
charles merged 1 commit from feature/local-status-api-soundboard into soundboard 2026-11-02 05:32:16 +00:00
Owner

Ports the local voice status API (merged to main in #2) onto soundboard, which runs on a much newer Fluxer. It's a re-port, not a cherry-pick: the RPC server it used no longer exists, and the shared desktop types moved to packages/desktop_ipc.

Differences from #2

  • StatusApi now runs its own loopback server, and only while the API is enabled. Ports: 21863 stable, 21864 canary, 21865 development.
  • Shared types go in packages/desktop_ipc/src/DesktopBridgeTypes.ts.
  • Settings IPC handlers require a privileged renderer document (requirePrivilegedRendererDocumentSender), the same check upstream uses for other sensitive channels.
  • compareStructural (MobX 7) instead of comparer.structural.
  • Docs moved to the Astro site: fluxer_docs/src/content/docs/topics/local-status-api.md, added to the Topics sidebar.

Testing

  • Desktop tsc --noEmit is clean.
  • App tsc --noEmit is clean apart from the WASM modules a Rust build step generates, which can't run on this machine (rustc too old).
  • Biome and lingui compile --strict pass.
  • Integration tests (StatusApi bundled with Electron stubs): the port stays closed while disabled and opens/closes with the toggle; auth and origin rules; live push; token rotation disconnects clients; a port conflict is reported as unavailable and recovers on retry.
  • Not yet verified on a live call.

🤖 Generated with Claude Code

Ports the local voice status API (merged to `main` in #2) onto `soundboard`, which runs on a much newer Fluxer. It's a re-port, not a cherry-pick: the RPC server it used no longer exists, and the shared desktop types moved to `packages/desktop_ipc`. ## Differences from #2 - `StatusApi` now runs its **own loopback server**, and only while the API is enabled. Ports: 21863 stable, 21864 canary, 21865 development. - Shared types go in `packages/desktop_ipc/src/DesktopBridgeTypes.ts`. - Settings IPC handlers require a privileged renderer document (`requirePrivilegedRendererDocumentSender`), the same check upstream uses for other sensitive channels. - `compareStructural` (MobX 7) instead of `comparer.structural`. - Docs moved to the Astro site: `fluxer_docs/src/content/docs/topics/local-status-api.md`, added to the Topics sidebar. ## Testing - Desktop `tsc --noEmit` is clean. - App `tsc --noEmit` is clean apart from the WASM modules a Rust build step generates, which can't run on this machine (rustc too old). - Biome and `lingui compile --strict` pass. - Integration tests (StatusApi bundled with Electron stubs): the port stays closed while disabled and opens/closes with the toggle; auth and origin rules; live push; token rotation disconnects clients; a port conflict is reported as unavailable and recovers on retry. - Not yet verified on a live call. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Opt-in, read-only WebSocket feed of live voice status for apps on the same
machine (Mirabox Stream Dock / stream deck plugins, overlays): who is in
the voice channel, who is talking, mute/deaf/camera/stream state.

- Desktop: StatusApi runs its own loopback server on 127.0.0.1 (21863
  stable, 21864 canary, 21865 development) that only listens while the
  API is enabled. WebSocket push at /status plus one-shot GET. Token
  required, web origins refused, 15 s heartbeat, slow readers dropped,
  status reset on renderer reload/crash. Settings IPC is restricted to
  privileged renderer documents.
- App: DesktopVoiceStatusBridge pushes the voice status over IPC as it
  changes; "Companion apps" section in desktop settings to toggle the
  API live, copy URL/token and regenerate the token. 7 new strings,
  translated for all locales.
- Docs: topics/local-status-api.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
charles merged commit 6ca0c294c1 into soundboard 2026-11-02 05:32:16 +00:00
charles deleted branch feature/local-status-api-soundboard 2026-11-02 05:32:21 +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!3
No description provided.