[teamleaderleo]

Summary

Leo, 2026-11-03, on a cmux NEXT agent pane: "this ui is pretty awkward looking".

One item from that screenshot: a turn whose model server could not be reached (a transport, network or API connection failure) showed an error card that led with a filled Switch model. That happened whenever the card had no Retry of its own: an earlier turn, or a turn that a retry had already gone on from. Switching model is not the fix for a server that can't be reached.

• TurnRows.tsx TurnFailure: an unreachable failure never makes Switch model the filled lead. If the chat has a Retry, Retry leads (filled). It runs acpmux's turn retry, the same path whose attempts Agent pane: a turn whose model can't be reached says so, not Thinking (acpmux turn_retrying) #34306's live line counts ("Can't reach the model · retrying (N of M)"). Retry stays disabled while the request is in flight, and Switch model follows it, outlined. If there is no Retry, Switch model stays on the card, outlined.
• Failures about the model or its route (a refused key, a proxy) keep Switch model as the filled lead with Retry after it. Capacity, sign-in, compact, access and CodeRouter cards are unchanged. No action is removed anywhere.
• No new strings. The button classes are unchanged, so each button's hover highlight still covers only that button.
• I left the open Agent pane: a failed turn's Retry says Retrying… and never settles as sent when nothing was sent #34443 (the "Retrying…" note under the card's actions) alone. This diff doesn't touch that state or its strings.

Gallery: agent-pane.turn-error-card, new variants

• server-unreachable: Retry first (filled), Switch model after it
• server-unreachable-retrying: the retried attempt's live line says "Can't reach the model · retrying (2 of 10) · 503 server error", and the earlier card keeps Switch model outlined
• model-error: a refused API key, with Switch model leading and Retry after it

Testing

webviews/test/turn-error-card.test.tsx gets four new tests that check which action leads for each error kind:

• unreachable with Retry: ["Retry", "Switch model"], Retry filled
• unreachable with no Retry: ["Switch model"], outlined. This one fails on base, where Switch model is filled.
• unreachable through acpmux's turn retry: Retry calls retryFailed with the row and prompt, and stays disabled until it settles
• invalid key: ["Switch model", "Retry"], Switch model filled

Ran on the fleet (cmux-ci test, Linux):

• vp fmt on the changed files, with its change applied
• bun test on turn-error-card, turn-error-continue, failureCopy, access-offer, signed-out-harness and cloud-signin-card: 87 pass, 0 fail
• bun run typecheck and bun run lint: the one error in each is Cannot find name 'after' in test/transcript-spacing-kinds.test.ts:247. That is a base red from Agent pane: the live Thinking line starts on the icon column and stays the last row #34370, not a file this PR touches. These files report no errors.

Observed / Not run

• Observed: the fleet results above.
• Not run: a DEV build against a real failing gateway, and gallery captures.

Risk: low. One condition in one component, and it only changes which button gets the filled style and the lead slot for unreachable cards that have no Retry.

Changelog

Fixed: An agent chat whose model server can't be reached no longer leads its error card with Switch model; Retry leads, and Switch model follows it.

Proof

No capture: webview UI. See gallery agent-pane.turn-error-card (server-unreachable, server-unreachable-retrying, model-error).

Agent session: agent session

🤖 Generated with Claude Code

---

^{Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Fixes the agent pane error card so an unreachable model server leads with Retry instead of Switch model. Previously, a connection failure without its own Retry showed a filled Switch model, which doesn't fix a server that can't be reached.

Bug Fixes

• Unreachable failures now lead with filled Retry when the chat has one; Switch model follows outlined, and stays outlined when there's no Retry.
• Failures about the model or its route (refused key, proxy) keep Switch model as the filled lead with Retry after it.
• Adds four tests per error kind and gallery variants, with no actions removed and no new strings.

^{Written for commit 9f3e8fa. Summary will update on new commits.}

[teamleaderleo]

Review (subagent claude-opus-5-5 medium, correctness): SHIP at 9f3e8fa

Checked the switchFirst change against every card kind. Only unreachable changes; capacity, sign-in, needs-credits, compact, CodeRouter, invalid-key and proxy-auth cards are unchanged. Each unreachable card has at most one filled button. The new tests and gallery fixtures check out, and a duplicate test helper flagged at 815469a was fixed in 6855c94. 9f3e8fa only adds the formatter's keyword wrap.
Visual verdict: no images; webview gallery variants server-unreachable, server-unreachable-retrying and model-error.
Follow-ups: an unreachable card on an earlier turn, with no Retry, now has no filled button; look at it in the gallery.

[teamleaderleo]

Owned by an agent session · session

[github-actions]

cmux status _{(one comment, edited in place; each line is updated by the job that owns it)}

Review 9f3e8fa: HQ feed card · gallery before/after runs · checks

App of this head (app.zip, kept 1 day)

gh workflow run reload-build.yml -R manaflow-ai/cmux --ref feat-cmux-next -f tag=pr34588 -f ref=lane/error-card-retry-first -f platform=macos -f backend_mode=local

Gallery before/after for 9f3e8fa: 16 states rendered, 6 images differ, 3 more touched states not rendered (picked by the Gallery: line in the PR body). Images are in the run's artifact, not on this public PR; the independent review of this head reads them on its own, so the PR needs no hand-made screenshots of these states.

gh run download 41757422286 -R manaflow-ai/cmux -n gallery-advisory-34588-9f3e8fa6d445fc9308e1b2027b24ca3a201af8fa (then read gallery-review.json)

States

State	Theme	Status	Diff	Picked by
agent-pane.turn-error-card/server-unreachable	Apple System Colors Light	new	0%	pr-body
agent-pane.turn-error-card/server-unreachable	Apple System Colors	new	0%	pr-body
agent-pane.turn-error-card/server-unreachable-retrying	Apple System Colors Light	new	0%	pr-body
agent-pane.turn-error-card/server-unreachable-retrying	Apple System Colors	new	0%	pr-body
agent-pane.turn-error-card/model-error	Apple System Colors Light	new	0%	pr-body
agent-pane.turn-error-card/model-error	Apple System Colors	new	0%	pr-body
agent-pane.turn-error-card/cloud-missing	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/cloud-missing	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/cloud-expired	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/cloud-expired	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/cloud-rejected	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/cloud-rejected	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/agent-closed	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/agent-closed	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/disk-full	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/disk-full	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/tailscale	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/tailscale	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/typed	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/typed	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/spawn-failed	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/spawn-failed	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/rate-limited	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/rate-limited	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/rate-limited-before-work	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/rate-limited-before-work	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/context-full	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/context-full	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/context-full-no-compact	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/context-full-no-compact	Apple System Colors	unchanged	0%	pr-body
agent-pane.turn-error-card/sign-in	Apple System Colors Light	unchanged	0%	pr-body
agent-pane.turn-error-card/sign-in	Apple System Colors	unchanged	0%	pr-body

_{Pick other states with a Gallery: entry.id, entry.id/variant line in the PR body.}

Unclear: web / react-apps-check failed: no known signature; failed step: Check webview test shards. This PR merged before its CI finished: fix forward on main.

CI failed on 9f3e8fa6d4 (run 41757396734 attempt 1): 1 code, 1 unknown.

Job	Verdict	Why
web / react-apps-base-check (2)	code	a web test failed
web / react-apps-check	unknown	no known signature; failed step: Check webview test shards

Failures:

• seen on other PRs agent-pane-changes-placement.test.tsx the in-page changes view sits right of the transcript at every pane width: failed (job)
• seen on other PRs agent-pane-changes-tab.test.ts the chat opens Changes as a tab for remote chats and non-repository turns, in the page only with no ...: failed (job)
• seen on other PRs composer-menu-dismiss.test.ts chromium: agent-pane.composer new-chat-reasoning at 760 px: with a menu open, one press on another c...: failed (job)
• seen on other PRs composer-menu-dismiss.test.ts chromium: agent-pane.new-tab reasoning-chip at 760 px: with a menu open, one press on another chip o...: failed (job)
• seen on other PRs composer-menu-dismiss.test.ts webkit: agent-pane.composer new-chat-reasoning at 760 px: with a menu open, one press on another chi...: failed (job)
• seen on other PRs composer-menu-dismiss.test.ts webkit: agent-pane.new-tab reasoning-chip at 760 px: with a menu open, one press on another chip ope...: failed (job)
• seen on other PRs composer-menu-dismiss.test.ts webkit: agent-pane.new-tab reasoning-chip at 300 px: Escape closes a menu and puts the keyboard back...: failed (job)
• seen on other PRs transcript-spacing-kinds.test.ts work-to-subagent finds both its marks (light): failed (job)

Matched log lines

web / react-apps-base-check (2): (fail) the in-page changes view sits right of the transcript at every pane width [0.49ms]

Not re-run automatically: web / react-apps-base-check (2), web / react-apps-check are not machine failures.

Written by scripts/ci/classify_failures.py (ci-failure-attribution.yml); signatures are its SIGNATURES table. A machine verdict is the runner's fault, not this PR's; yours means the failing file is one this PR changes, also red on main that main's latest full suite fails the same way, seen on other PRs that it failed on another pull request's run lately.

red: web / Web status; a job it gathers is red on this change (its line here); do not merge until green; see lane-rules
red: web / react-apps-base-check (2); it named no new red test (setup or base replay failed; see its log); do not merge until green; see lane-rules
red: web / react-apps-check; a job it gathers is red on this change (its line here); do not merge until green; see lane-rules

Shipped in:

• cmux NEXT nightly 1.0.0-nightly.4177134165301 (4a7517355a)
• cmux NEXT nightly 1.0.0-nightly.4177399658201 (443d56f95d)
• cmux NEXT nightly 1.0.0-nightly.4177479261801 (0df62819ad)

[teamleaderleo]

Review (codex gpt-6.1-sol xhigh, via router-review): SHIP at 9f3e8fa

Visual verdict: no images; Leo tries the build.
Checked the changed action ordering and the retry wiring; found no correctness regression.
Follow-ups: [P2] [follow-up] add gallery after screenshots for the new variants.