@oar-sh/oar 0.9.25 → 0.9.26

package/CHANGELOG.md

@@ -3,6 +3,148 @@
 All notable changes to OAR are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow semver.
 
+## [0.9.26] — 2026-11-11
+
+Highlights: formulas from their delimiters only, and Settings sorted by
+where they live. Replies render a formula only when it is written as
+`$…$`, `\(…\)`, `$$…$$`, `\[…\]` or a fenced `math` block, so an id in
+parentheses, a Windows path, a price or a shell variable stays text, a
+formula KaTeX cannot read is shown as written instead of in red, and
+the agent is told the notation that renders, except in Claude Cloud
+chats and on the Copilot Extension engine. KaTeX moves to 0.19.1.
+Theme, text scaling and the live-turn settings get an Appearance tab of
+their own, and the relay name and the two restart settings move to
+Relays, where an empty name shows the host name the relay goes by and a
+rename made on another device shows at once. In Claude, Claude API and
+DeepSeek chats a plan card comes only from a plan the agent hands over,
+and a plan card shows up to 200,000 characters of the plan instead of
+12,000. Archive and delete no longer fail on Linux and macOS for a
+worker that has already ended, a session an agent on a paired relay
+started can always report back to it, and the tmux console draws a real
+terminal.
+
+### Added
+
+- **Fenced `math` blocks.** A code block with the language `math` is a
+  displayed formula once it is closed.
+- **Agents are told how to write formulas.** Once per session, the agent
+  of a Claude, Claude API, DeepSeek, Cursor or Grok chat, and of a
+  Copilot or OpenAI chat on the SDK engine, learns that `$…$` in a
+  sentence and `$$…$$` on lines of their own render (`\(…\)` and `\[…\]`
+  too), that TeX in bare parentheses or brackets does not, and that a
+  dollar amount stays text. Claude Cloud chats and the Copilot Extension
+  engine do not get the note. The prompt a transcript shows leaves the
+  note out.
+
+### Changed
+
+- **Settings: an Appearance tab, and the relay's own settings on
+  Relays.** Theme, Text scaling, Expand thoughts while an agent works,
+  Tool lines shown while an agent works, Stream view and Show Suspend
+  host action move from General to the new Appearance tab right after
+  it, under one line that says they are kept in this browser; Jump to
+  the end when I send a message and Messages kept per conversation stay
+  in General's Reading block. Relay name moves to the top of Relays,
+  above Public address, and After a relay restart, tell interrupted
+  sessions to carry on and Ask after a queued relay restart has waited
+  follow right below Public address; what stays of General's "This
+  relay" block (Default CWD, Autostart, the Windows helper) is headed
+  "This computer". Every setting keeps its value and default, and a
+  remembered tab or a link to General still opens General.
+- **Formulas are read from their delimiters only.** `$…$` and `\(…\)`
+  inside a sentence, `$$…$$` and `\[…\]` as a display, and a fenced
+  `math` block; nothing is guessed from TeX in bare parentheses or
+  brackets any more. On one line `\[ … \]` needs a space inside both
+  ends, so `\[1\]` and `\[x\]` are escaped brackets. A `$` opens a
+  formula only where maths is written that way, so prices (`$5 and $9`,
+  `$5/$10`), shell variables (`$HOME/$PATH`) and Windows paths stay
+  text, and `\$` is always a dollar sign. Code spans and code blocks
+  never hold a formula. A formula KaTeX cannot parse is shown as
+  written, in the normal text colour, and a percent sign in a one-line
+  formula is shown. A message over 100,000 characters renders no
+  formulas. The rules are in
+  [Formulas in replies](docs/web-ui.md#formulas-in-replies).
+- **KaTeX 0.19.1.** The page loads KaTeX 0.19.1 (was 0.16.22) and its
+  chemistry extension from jsDelivr, as before, now with integrity hashes;
+  its auto-render script is no longer loaded. KaTeX is not in the npm
+  package: a browser that cannot reach jsDelivr shows every formula as
+  written.
+- **A plan card comes from a plan hand-over only** in Claude, Claude API
+  and DeepSeek chats. A plan-mode reply with two or more list lines no
+  longer gets a "Plan ready for review" card, so a session that stays in
+  plan mode no longer puts the buttons under every status reply. When the
+  plan of a hand-over cannot be read, the reply stands in for it. Cursor,
+  Grok, Copilot and OpenAI (BYOK) chats keep the card for such replies.
+
+### Fixed
+
+- **The whole plan on the plan card.** The card cut every plan at 12,000
+  characters, without a mark. It now keeps up to 200,000; a longer plan
+  is cut, at a line break where it can, and ends with a line that says
+  how much is missing and, where the agent named it, the file that holds
+  the whole plan. A cut inside a code block closes the block first, also
+  in a plan file with Windows line ends.
+- **Archive and delete no longer fail for a worker that has ended**
+  (Linux and macOS). Archiving or deleting an idle conversation could
+  answer "Couldn't stop this conversation's session" again and again:
+  the relay counted the old process id of a worker that had ended, by
+  then another program's, and processes that were ending by themselves.
+  Those no longer count, and a process the relay may not signal no longer
+  keeps it from stopping the others. A worker that really survives the
+  stop still leaves the conversation as it was.
+- **A session an agent on a paired relay started can always report
+  back.** Its send to the session that started it was refused with
+  `REMOTE_RELAY_HOP_LIMIT` when its turn also acted on a prompt from a
+  session on its own relay. Another session on that relay, a third relay
+  and `create_session` are still held to the limit.
+- **The relay name in Settings.** An empty Relay name showed "OAR" as its
+  placeholder; it now shows the host name, the name paired relays know
+  the relay by then. A rename made on another device shows in an open
+  Settings without reopening it.
+- **The tmux console draws a terminal.** 🖥️ Inspect tmux console asked
+  jsDelivr and unpkg for xterm.js versions that were never published, so
+  it always fell back to plain text. It now loads `@xterm/xterm` 5.5.0
+  and `@xterm/addon-fit` 0.10.0 from jsDelivr, with integrity hashes,
+  and only the two scripts from unpkg when jsDelivr fails; a browser
+  that reaches neither still gets the plain text.
+- **A long line in a code block no longer runs under its Copy button**,
+  which has a strip of its own above the first line.
+
+### Upgrade notes
+
+- **No migration.** As before, the relay copies its database to the
+  backups folder before the first start of a new version; nothing else
+  waits.
+- **Sessions still on 0.9.25's worker wait one worker start.** A session
+  whose worker still runs the old code is given a new worker between
+  turns, as in 0.9.25: a Claude, Claude API, DeepSeek or Cursor session
+  outside a git checkout before its next message, any other once its
+  agent has been idle for about 10 minutes. Its agent learns the formula
+  notation with the new worker, and Claude, Claude API and DeepSeek
+  chats get the new plan-card rule with it.
+- **Your settings stay as they were.** The Appearance settings are kept
+  in the browser under the same keys, and the relay's own settings in its
+  database; only their place in Settings changes.
+- **Older replies follow the new formula rules** when they are shown
+  again: a parenthesis 0.9.25 drew as a formula is text now, TeX
+  written in bare parentheses shows as written, and a one-line
+  `\[x^2\]` without a space inside its ends is read as escaped brackets.
+- **KaTeX and xterm.js load in the browser,** not from the relay: from
+  jsDelivr, and the two xterm.js scripts, not its stylesheet, also from
+  unpkg; neither is in the npm package. A browser without access to them
+  shows formulas as written and the tmux console as plain text, whatever
+  the relay host can reach.
+- **Mixed versions work together.** The report-back rule is checked by
+  the relay the started session runs on: that one needs 0.9.26, the relay
+  of the session that started it may run 0.9.25.
+- **Going back to 0.9.25** needs no database step. Install it with
+  `oar update --to 0.9.25` or `npm install -g @oar-sh/oar@0.9.25` (in a
+  git checkout: `git checkout v0.9.25`, then a relay restart). The
+  settings go back to their old places with their values; a browser that
+  last had Appearance open opens General. Formulas follow 0.9.25's rules
+  again, Claude plan-mode replies with list lines get cards again, and
+  plan cards made on 0.9.26 keep their whole plan.
+
 ## [0.9.25] — 2026-11-09
 
 Highlights: a media gallery, and agents that make images. Every picture,

package/README.md

@@ -45,29 +45,29 @@ flowchart LR
 <table>
 <tr>
 <td width="42%" rowspan="4" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-mobile.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.25" alt="OAR on a phone: a finished agent turn in a conversation, with the composer below"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-mobile.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.26" alt="OAR on a phone: a finished agent turn in a conversation, with the composer below"></picture></a>
 <br><sub>On a phone: the same conversations, installable as an app.</sub>
 </td>
 <td width="58%" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-agents.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.25" alt="Background subagents running in parallel in the task panel, each with live token counts, elapsed time, and its own Stop button"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-agents.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.26" alt="Background subagents running in parallel in the task panel, each with live token counts, elapsed time, and its own Stop button"></picture></a>
 <br><sub>Agents working in parallel, each with live token counts and its own Stop.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-question.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.25" alt="A question card in the middle of a turn: the agent offers several choices and a free-text reply"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-question.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.26" alt="A question card in the middle of a turn: the agent offers several choices and a free-text reply"></picture></a>
 <br><sub>When the agent needs a decision, it asks, and waits for your answer.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pingcf-thoughts.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.25" alt="An expanded Thoughts block showing the agent's reasoning above its reply"></picture></a>
+<a href="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pingcf-thoughts.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.26" alt="An expanded Thoughts block showing the agent's reasoning above its reply"></picture></a>
 <br><sub>Read the reasoning, not just the answer.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-watching.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.25" alt="A session watching two other sessions: a finished reply arrives as a compact relay-event row, the watching 2 sessions list is open with Unsubscribe, and a request to also watch a session on a paired relay waits on an Allow / Deny card"></picture></a>
+<a href="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-watching.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.26" alt="A session watching two other sessions: a finished reply arrives as a compact relay-event row, the watching 2 sessions list is open with Unsubscribe, and a request to also watch a session on a paired relay waits on an Allow / Deny card"></picture></a>
 <br><sub>Agents that watch agents: woken by events, approving nothing.</sub>
 </td>
 </tr>
@@ -118,11 +118,11 @@ API keys are entered in **⚙️ Settings** and stay on the relay host. The Clau
 <table>
 <tr>
 <td width="62%" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-steering.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.25" alt="A running Claude turn with a message steered into it mid-turn, the reply streaming with its tool calls, and the Steer button in the composer"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-steering.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.26" alt="A running Claude turn with a message steered into it mid-turn, the reply streaming with its tool calls, and the Steer button in the composer"></picture></a>
 <br><sub>Send a message while the agent works, and it steers the running turn.</sub>
 </td>
 <td width="38%" valign="top">
-<a href="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/usage-copilot-compact.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.25" alt="The GitHub Copilot card in Check Usage: premium requests and plan quota with reset dates, and the cost of the last turn"></picture></a>
+<a href="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/usage-copilot-compact.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.26" alt="The GitHub Copilot card in Check Usage: premium requests and plan quota with reset dates, and the cost of the last turn"></picture></a>
 <br><sub>What each plan has left, in one place.</sub>
 </td>
 </tr>
@@ -140,7 +140,7 @@ API keys are entered in **⚙️ Settings** and stay on the relay host. The Clau
 - **Share** a conversation as a read-only link, hide single messages and the host's paths from it, and see when it was opened ([Sharing](docs/web-ui.md#sharing)).
 - **On your phone**: install OAR as an app and get push notifications; back walks through the conversations you opened, a pinch zooms the whole app, and held sideways it keeps a phone's layout ([Notifications and the app](docs/web-ui.md#notifications-and-the-app), [back and forward](docs/web-ui.md#back-and-forward), [zoom](docs/web-ui.md#zoom), [a phone held sideways](docs/web-ui.md#a-phone-held-sideways)).
 
-The full tour is in [Using the web UI](docs/web-ui.md); every setting and config key is in [Settings and configuration](docs/configuration.md). What changed in each release is in the [changelog](CHANGELOG.md), with [0.9.25](CHANGELOG.md#0925--2026-11-09) as the latest.
+The full tour is in [Using the web UI](docs/web-ui.md); every setting and config key is in [Settings and configuration](docs/configuration.md). What changed in each release is in the [changelog](CHANGELOG.md), with [0.9.26](CHANGELOG.md#0926--2026-11-11) as the latest.
 
 ## Remote access
 
@@ -191,7 +191,7 @@ flowchart LR
 
 You stay in charge: per paired relay you decide whether agents may only read, also prompt, or do everything, and in the `ask` and `plan` modes every write asks you first. A subscription only notifies; it approves nothing.
 
-<p><a href="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.25"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-cross-relay.light.png?v=0.9.25"><img src="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.25" alt="A session watching two sessions on a paired relay: a reply arrives as a relay-event row, and after a short outage the events the other relay kept arrive as one replayed row" width="720"></picture></a></p>
+<p><a href="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.26"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-cross-relay.light.png?v=0.9.26"><img src="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.26" alt="A session watching two sessions on a paired relay: a reply arrives as a relay-event row, and after a short outage the events the other relay kept arrive as one replayed row" width="720"></picture></a></p>
 
 How pairing, permissions and limits work is in [Agents working together](docs/agents-together.md).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oar-sh/oar",
-  "version": "0.9.25",
+  "version": "0.9.26",
   "type": "module",
   "description": "OAR — Open Agent Relay: drive your local coding agents from any browser",
   "license": "MIT",
@@ -74,7 +74,9 @@
     "@modelcontextprotocol/sdk": "1.32.2",
     "@playwright/test": "^1.60.0",
     "jsdom": "^30.0.1",
+    "katex": "0.19.1",
     "koffi": "3.3.4",
+    "marked": "15.0.12",
     "zod": "4.6.7"
   },
   "overrides": {

package/server/claude-worker/claude-sdk-adapter.mjs

@@ -3,6 +3,7 @@ import { loadAgentSdk } from '../agent-sdk-loader.mjs';
 import { formatClaudeBackgroundCommandLimitLabel } from '../../shared/claude-background-command-limit.mjs';
 import { parseThinkingDisplay } from '../../shared/claude-thinking.mjs';
 import { PERSON_ONLY_QUESTION_SOURCE } from '../../shared/relay-asks.mjs';
+import { MATH_INSTRUCTION_TEXT } from '../../shared/math-instructions.mjs';
 import { MEDIA_EMBED_INSTRUCTION_TEXT } from '../../shared/media-embed-instructions.mjs';
 import { REMOTE_RELAY_TOOL_CALL_TIMEOUT_MS } from '../../shared/remote-relay-tool-core.mjs';
 import { createPreviewToolDefinition } from './claude-preview-tool.mjs';
@@ -205,10 +206,12 @@ export function longCommandInstructionText(backgroundCommandLimitMs = null) {
 export function systemPromptForRelayMode(relayMode, { backgroundCommandLimitMs = null } = {}) {
   const mode = String(relayMode || 'agent').trim().toLowerCase();
   // The media-embed capability rides every session — unlike the mode nudges it
-  // is renderer knowledge the model cannot discover any other way. The long
-  // command note rides every session too: the limit is the relay's setting.
+  // is renderer knowledge the model cannot discover any other way; so is the
+  // notation the web app renders formulas from. The long command note rides
+  // every session too: the limit is the relay's setting.
   const append = [
     MEDIA_EMBED_INSTRUCTION_TEXT,
+    MATH_INSTRUCTION_TEXT,
     longCommandInstructionText(backgroundCommandLimitMs),
     MODE_SYSTEM_PROMPT_APPEND[mode],
   ]
@@ -792,8 +795,9 @@ const EXIT_PLAN_DENY_MESSAGE = 'Plan received — it is shown to the user in the
   + 'End the turn now with a short closing message and do not start implementing; '
   + 'the user\'s decision will arrive as a new message.';
 // When the handler could not surface a board (no plan text reached it), the
-// model must restate the plan as its final message: plan-shaped final text
-// triggers the runner's fallback board, so the user still gets the review UI.
+// model must restate the plan as its final message: after a hand-over without
+// a card, the turn's reply is posted as the plan (publishCompletedTurn), so
+// the user still gets the review UI.
 const EXIT_PLAN_DENY_NO_BOARD_MESSAGE = 'Plan received, but it could not be shown for review. '
   + 'Restate the complete plan as your final message, then end the turn without implementing; '
   + 'the user\'s decision will arrive as a new message.';

package/server/claude-worker/claude-session-process.mjs

@@ -876,6 +876,8 @@ export function createClaudeSessionRunner({
         modelUsage: null,
       },
       planBoardPosted: false,
+      // The CLI handed a plan over (ExitPlanMode), whether or not a card came of it.
+      planBoardRequested: false,
       // The CLI process the turn ran in, as its usage report names it: taken
       // from the process here and again when the context is made active, and
       // read from the context at finalize — a late continuation flush
@@ -1569,6 +1571,7 @@ export function createClaudeSessionRunner({
         state: ctx.state,
         responseModel,
         planBoardPosted: ctx.planBoardPosted,
+        planBoardRequested: ctx.planBoardRequested,
         consumedSteerIds,
       });
     }
@@ -3789,6 +3792,7 @@ export function createClaudeSessionRunner({
       onExitPlanMode: async (input) => {
         const ctx = processRef.activeCtx || processRef.pendingDelivered[0]?.ctx || null;
         if (!ctx?.message?.id) return false;
+        ctx.planBoardRequested = true;
         const posted = await publisher.publishPlanBoard(ctx.message, input);
         if (posted) ctx.planBoardPosted = true;
         return posted;

package/server/claude-worker/claude-turn-publisher.mjs

@@ -6,7 +6,6 @@ import {
   classifyClaudeResultFailure,
   claudeFailureGuidance,
 } from './claude-turn-failure.mjs';
-import { countPlanLikeLines } from '../../shared/plan-lines.mjs';
 import { PLAN_BOARD_ACTIONS } from '../../shared/plan-board-actions.mjs';
 import { EMPTY_TURN_COMPLETION_NOTE } from '../../shared/empty-turn-completion.mjs';
 import { buildSteerSettleFailure, steerSettleFailureText } from '../../shared/steer-settle-failure.mjs';
@@ -34,9 +33,10 @@ export function isStaleAttemptError(error) {
 export { buildSteerSettleFailure, steerSettleFailureText };
 export const STEER_SETTLE_FAILED_TEXT = steerSettleFailureText('folded');
 
-export function buildClaudePlanReadyBoardPayload({ message, planText = '' } = {}) {
+export function buildClaudePlanReadyBoardPayload({ message, planText = '', planFilePath = '' } = {}) {
   const summary = String(planText || '').trim();
   if (!summary) return null;
+  const filePath = String(planFilePath || '').trim();
   return {
     queueId: message?.id,
     messageId: message?.id,
@@ -52,6 +52,8 @@ export function buildClaudePlanReadyBoardPayload({ message, planText = '' } = {}
       queueMessageId: message?.id || null,
       conversationId: message?.conversationId || null,
       relayMode: message?.relayMode || 'agent',
+      // Named on the card when the relay has to cut a very long plan.
+      ...(filePath ? { planFilePath: filePath } : {}),
     },
   };
 }
@@ -797,13 +799,13 @@ export function createClaudeTurnPublisher({
    * Post the plan-ready review board for an ExitPlanMode interception. The CLI
    * sends both `plan` and `planFilePath`; the inline plan is authoritative, the
    * plan file covers CLI versions that stop inlining it. Returns false when no
-   * plan text could be recovered so the caller's plan-shaped-final-text
-   * fallback still gets a chance to post the board.
+   * plan text could be recovered, so the turn's reply can stand in for it
+   * (see publishCompletedTurn).
    */
   async function publishPlanBoard(message, input) {
     let planText = String(input?.plan || input?.summary || '').trim();
+    const planFilePath = String(input?.planFilePath || '').trim();
     if (!planText) {
-      const planFilePath = String(input?.planFilePath || '').trim();
       if (planFilePath) {
         try {
           planText = String(fs.readFileSync(planFilePath, 'utf8') || '').trim();
@@ -812,7 +814,7 @@ export function createClaudeTurnPublisher({
         }
       }
     }
-    const boardPayload = buildClaudePlanReadyBoardPayload({ message, planText });
+    const boardPayload = buildClaudePlanReadyBoardPayload({ message, planText, planFilePath });
     if (!boardPayload) return false;
     await api('POST', '/api/relay-board', boardPayload).catch((error) => {
       dbg('plan board publish failed', error?.message || String(error));
@@ -822,18 +824,30 @@ export function createClaudeTurnPublisher({
 
   /**
    * Publish a completed (non-error, non-aborted) turn: final stream snapshot,
-   * plan-mode fallback board, response row. Mirrors the pre-session-process
-   * turn runner's tail exactly.
+   * plan-mode fallback board, response row.
+   *
+   * A plan card comes only from a plan hand-over (ExitPlanMode). The fallback
+   * covers one case: the CLI handed a plan over but its text could not be
+   * read, so the reply is the plan. A reply is never taken for a plan because
+   * of its list lines: in a session that stays in plan mode, every status
+   * reply with two bullets got a card.
    */
-  async function publishCompletedTurn({ message, state, responseModel, planBoardPosted, consumedSteerIds = null }) {
+  async function publishCompletedTurn({
+    message,
+    state,
+    responseModel,
+    planBoardPosted,
+    planBoardRequested = false,
+    consumedSteerIds = null,
+  }) {
     const result = state.result;
     const finalText = String(
       state.resultTexts.join('\n\n') || result?.text || state.lastStreamedText || '',
     ).trim();
     if (
-      !planBoardPosted
+      planBoardRequested
+      && !planBoardPosted
       && String(message.relayMode || '').trim().toLowerCase() === 'plan'
-      && countPlanLikeLines(finalText) >= 2
     ) {
       const boardPayload = buildClaudePlanReadyBoardPayload({ message, planText: finalText });
       if (boardPayload) {

package/server/copilot-worker/copilot-prompt-context.mjs

@@ -25,6 +25,7 @@ import {
   applyPreviewInstructions,
   createPreviewInstructionsProvider,
 } from '../../shared/preview-instructions.mjs';
+import { applyMathInstructions } from '../../shared/math-instructions.mjs';
 import { applyMediaEmbedInstructions } from '../../shared/media-embed-instructions.mjs';
 import { buildModePrompt } from '../../shared/worker-runtime/prompt-context.mjs';
 import { loadRelayInstructionsFromFile } from '../../shared/worker-runtime/config-loader.mjs';
@@ -84,7 +85,7 @@ export function createCopilotPromptContextBuilder({
           .then(() => getPreviewInstructions({ conversationId: String(message?.conversationId || '') }))
           .catch(() => '')
         : '';
-      instructions = applyMediaEmbedInstructions(applyPreviewInstructions(toolInstructions, previewBlock));
+      instructions = applyMathInstructions(applyMediaEmbedInstructions(applyPreviewInstructions(toolInstructions, previewBlock)));
     }
     const prefix = buildModePrompt(relayMode, instructions, { includeInstructions });
     return {

package/server/cursor-worker/cursor-turn-runner.mjs

@@ -20,6 +20,7 @@ import {
   cursorSubagentRosterFingerprint,
 } from './cursor-subagent-roster.mjs';
 import { createAskUserBridge } from '../../shared/ask-user-bridge.mjs';
+import { renderMathInstructionBlock } from '../../shared/math-instructions.mjs';
 import { renderMediaEmbedInstructionBlock } from '../../shared/media-embed-instructions.mjs';
 import { EMPTY_TURN_COMPLETION_NOTE } from '../../shared/empty-turn-completion.mjs';
 import { resolveFallbackContextLimitTokens } from '../../shared/context-window-fallbacks.mjs';
@@ -586,7 +587,8 @@ export function createCursorTurnRunner({
       await ensureAgentHandle(message, model);
       const userMessage = buildUserMessageImpl(message);
       const modeNudge = cursorModeNudge(message.relayMode, lastNudgedRelayMode);
-      const mediaGuidance = mediaGuidanceSent ? '' : renderMediaEmbedInstructionBlock();
+      // The formula notation rides with it, for the same reason.
+      const mediaGuidance = mediaGuidanceSent ? '' : `${renderMediaEmbedInstructionBlock()}\n\n${renderMathInstructionBlock()}`;
       if (modeNudge || mediaGuidance) {
         userMessage.text = [mediaGuidance, modeNudge, userMessage.text].filter(Boolean).join('\n\n');
       }

package/server/grok-worker/grok-turn-runner.mjs

@@ -10,6 +10,7 @@ import { extractGrokUsageFromPromptResult, normalizeGrokTurnUsage } from '../ser
 import { OAR_MCP_SERVER_NAME, buildOarMcpServerLaunch, isOarMcpServerDisabled } from '../mcp/oar-mcp-server.mjs';
 import { createPreviewInstructionsProvider } from '../../shared/preview-instructions.mjs';
 import { fetchRemoteRelayInflight } from '../../shared/remote-relay-tool-core.mjs';
+import { renderMathInstructionBlock } from '../../shared/math-instructions.mjs';
 import { renderMediaEmbedInstructionBlock } from '../../shared/media-embed-instructions.mjs';
 import { countPlanLikeLines } from '../../shared/plan-lines.mjs';
 import { PLAN_BOARD_ACTIONS } from '../../shared/plan-board-actions.mjs';
@@ -476,7 +477,8 @@ export function createGrokTurnRunner({
       : await Promise.resolve()
         .then(() => getPreviewInstructions?.({ conversationId: message.conversationId || sdkSessionId || '' }))
         .catch(() => '');
-    const mediaBlock = mediaInstructionsSent ? '' : renderMediaEmbedInstructionBlock();
+    // The formula notation rides with the media block, once per worker.
+    const mediaBlock = mediaInstructionsSent ? '' : `${renderMediaEmbedInstructionBlock()}\n\n${renderMathInstructionBlock()}`;
     const promptText = [previewBlock, mediaBlock, modeNudge, userText].filter(Boolean).join('\n\n');
     const pendingNudgedRelayMode = String(message.relayMode || 'agent').trim().toLowerCase();
 

package/server/public/app/context-usage-view.mjs

@@ -356,7 +356,7 @@ const THOUGHTS_EXPANDED_CHOICES = Object.freeze([
 ]);
 
 /**
- * The mirror of Settings › General "Expand thoughts while an agent works", for
+ * The mirror of Settings › Appearance "Expand thoughts while an agent works", for
  * every provider. A setting of this browser, so nothing goes to the relay:
  * the buttons write thoughts-preference.mjs and both places follow it.
  *
@@ -390,7 +390,7 @@ const STREAM_VIEW_CHOICES = Object.freeze([
 ]);
 
 /**
- * The mirror of Settings › General "Stream view", for every provider. A
+ * The mirror of Settings › Appearance "Stream view", for every provider. A
  * setting of this browser (stream-view-preference.mjs); nothing goes to the
  * relay.
  *

package/server/public/app/live-activity-cap.mjs

@@ -1,6 +1,6 @@
-// "Tool lines shown while an agent works" (Settings › General ›
-// Appearance): how many of its newest tool lines each agent of a running
-// turn keeps in the live bubble, the main agent and every sub-agent apart.
+// "Tool lines shown while an agent works" (Settings › Appearance): how many
+// of its newest tool lines each agent of a running turn keeps in the live
+// bubble, the main agent and every sub-agent apart.
 // A setting of this browser, kept in localStorage like the scroll-on-send
 // one. The slider runs from 10 to 500 by 10 and has one more step at the far
 // end, no limit (stored as '0'). The document and the storage are passed in