feat(desktop): mute a browser tab

[chrisdeeming]

What Changed

Preview tabs can now be muted, modelled on Chromium's behaviour.

• Mute tab / Unmute tab in the tab's right-click menu.
• A speaker icon appears in the tab while it's playing sound, and shows as
  crossed-out when muted.
• Clicking the icon toggles mute.

Why

There was no way to silence a preview tab, or to tell which of several open
tabs was making noise.

UI Changes

CleanShot.2026-08-16.at.20.31.49-small.mp4

Checklist

• This PR is small and focused
• I explained what changed and why
• Video included
• I included a video for animation/interaction changes

---

Note

Medium Risk
Touches preview tab lifecycle and state emission (race-sensitive); contract adds required audioMuted/audible fields on DesktopPreviewTabState for all consumers.

Overview
Adds Chromium-style mute for desktop preview tabs: users can silence a tab, see which tabs are playing audio, and toggle mute from the tab strip or context menu.

Desktop / contracts: DesktopPreviewTabState gains audioMuted (user intent, survives navigation and webview swaps) and audible (observed from Chromium). PreviewManager implements setAudioMuted, listens for audio-state-changed, reconciles audibility after attach, and uses emitIfCurrent in a few places so stale snapshots do not roll back live audio state. New IPC desktop:preview-set-audio-muted is wired through preload and DesktopPreviewBridge.

Web UI: RightPanelTabs shows a speaker control only while a tab is audible (muted tabs use a crossed-out icon). Mute/unmute in the tab context menu is always available for preview tabs. Desktop calls use previewRuntimeTabId (thread + server epoch + session tab id), not the raw server session id.

Tests: Extensive PreviewManager coverage for mute re-apply, audibility races, stale guests, and navigation; component tests for indicator visibility and runtime id routing.

^{Reviewed by Cursor Bugbot for commit d347f6f. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add mute control for browser tabs in the desktop preview panel

• Adds setAudioMuted(tabId, audioMuted) across the IPC bridge, PreviewManager, and preload layer to mute/unmute individual preview tabs.
• Extends PreviewTabState and DesktopPreviewOverlay with audioMuted and audible fields; mute intent persists across webview swaps and navigation.
• Adds an audio indicator button and context menu "toggle mute" action to RightPanelTabs, visible when a tab is producing sound, using a runtime tab ID resolver passed from ChatView.
• Chromium audio-state-changed events are tracked per-tab with deduplication and reconciliation on webview attach.

^{Macroscope summarized d347f6f.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: b4d0f06e-aac2-46d3-bf45-04d38b751a57

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Needs human review

...

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit a44b7c9. Configure here.}

[t3-code]

reviewed at d347f6f. the desktop mute lifecycle, audibility reconciliation, runtime tab routing, ipc contract, and ui interactions look sound. targeted, desktop, and web test suites pass, all required checks pass, and i found no remaining blockers.