feat(web): fold plan mode and token-by-token output into Legacy features

[t3dotgg]

Plan mode and token-by-token streaming are features we want to keep available but stop advertising. Plan mode sat in Beta looking like a new feature, and token-by-token output actively hurts the experience: it is much slower than buffered output.

Now there is a collapsed Legacy features section at the bottom of Settings → General. You have to unfold it to see either toggle, and a settings-search jump auto-unfolds it.

• Plan mode (legacy) moved from the Beta panel (same planModeEnabled key, nobody's choice changes).
• Stream token by token (legacy) moved from the General section and put under a new key (enableAssistantStreaming → enableLegacyTokenStreaming), so everyone resets to buffered output, including previous opt-ins. The copy calls it out as not recommended, and turning it on requires a confirmation dialog.

Folded (default)	Unfolded

Verified: typecheck (contracts/web/server), settings + desktop + server ingestion tests, and clicked through both states in the running app.

---

Written by Claude Fable 5 running in Claude Code.

🤖 Generated with Claude Code

---

Note

Medium Risk
Renaming the server setting without migrating enableAssistantStreaming resets streaming behavior for all users; UI and search changes are low risk but touch primary settings paths.

Overview
Moves plan mode and token-by-token assistant output out of prominent settings into a collapsed Legacy features section at the bottom of Settings → General.

Plan mode (legacy) is removed from the Beta panel and lives under that fold with the same planModeEnabled client setting. Stream token by token (legacy) replaces the old General Assistant output toggle: the server/contracts setting is renamed from enableAssistantStreaming to enableLegacyTokenStreaming (including ingestion tests and ProviderRuntimeIngestion), and the new schema key intentionally does not migrate the old field—everyone defaults back to buffered output, including prior opt-ins. Enabling legacy streaming now requires a confirmation dialog; copy frames it as not recommended.

Settings search drops assistant-output and Beta restore-plan-mode, adds legacy-plan-mode and legacy-token-streaming, and auto-expands the legacy section when jumping to those targets.

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

Note

Move plan mode and token-by-token streaming toggles into a Legacy features section

• Renames enableAssistantStreaming to enableLegacyTokenStreaming in packages/contracts/src/settings.ts; the old key is no longer decoded, so all clients default to buffered output unless they opt in via the new key.
• Removes the plan mode toggle from BetaSettingsPanel and the "Assistant output" switch from GeneralSettingsPanel, consolidating both into a new collapsible "Legacy features" section in SettingsPanels.tsx.
• Enabling legacy token-by-token streaming now requires a confirmation dialog; the section auto-expands when targeted via settings search.
• Updates settings search entries to point to the new legacy-plan-mode and legacy-token-streaming items.
• Risk: existing clients with enableAssistantStreaming=true stored in settings will silently fall back to buffered output after this change.

^{Macroscope summarized d95757b.}

[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: f1e2bcfd-9164-41e6-836f-1ce5a21a1d02

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.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	11.3 KiB	11.3 KiB	−3 B (−0.0%)	15.1 KiB	✅
Codex	Thread snapshot wire	5.5 KiB	5.5 KiB	+6 B (+0.1%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	5.9 KiB	5.9 KiB	−9 B (−0.1%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	49.7 KiB	49.7 KiB	0 B (0.0%)	66.4 KiB	✅
Codex	Live turn messages	16	16	0 (0.0%)	21	✅
Claude	Total thread wire	11.3 KiB	11.4 KiB	+4 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	5.5 KiB	5.5 KiB	+12 B (+0.2%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	5.9 KiB	5.9 KiB	−8 B (−0.1%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	50.6 KiB	50.6 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	16	16	0 (0.0%)	21	✅

Baseline: 45d9aa9 · PR result: d95757b · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 94.6 KiB
• Claude decoded thread snapshot: 95.4 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR intentionally resets all users who had token streaming enabled back to the buffered default by using a fresh settings key. While a deliberate product decision to deprecate these features into a 'Legacy' section, the user preference reset represents a significant behavior change warranting review.

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