Skip to content

Agent: a running task's title shimmers instead of showing a coral ring - #1521

Draft
matthewrball wants to merge 5 commits into
masterfrom
ux/task-status-indicators
Draft

matthewrball wants to merge 5 commits into
masterfrom
ux/task-status-indicators

Conversation

@matthewrball

@matthewrball matthewrball commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

A running task showed a coral ring with a breathing dot beside its title, and a task waiting on a question showed a coral dot. The two differed only by shape, and the ring read like a radio button. The sidebar now uses the transcript's own vocabulary for status:

  • Running: the title shimmers. A running task's title gets the "Maple is thinking" shine from Agent: Fold a turn's steps under one line that times the work #1587, turned up so it reads at a glance. The words rest in muted ink on every row, selected or not, while a band in activity_shine sweeps across them every 1.2 s. activity_shine is a new token: white on dark, black on light. Before this, the band was heading ink every 1.9 s, and on a selected row the words rested in secondary ink, almost the band's colour, so a selected running row looked idle. It's morph_text's shine, not a second implementation. A running row shows no glyph and keeps its indicator slot empty, so the title's width doesn't change when the task moves to its next state.
  • Needs you: a coral dot in an edged, gently breathing halo. This is the only coral mark. It uses accent_ink, the coral Agent: Fold a turn's steps under one line that times the work #1587's line rests in while Maple waits on you. It holds about 3:1 on a selected light-mode row, where the brighter coral faded to 2.2:1. The edge separates it from the green dot by shape, not colour alone. The halo breathes over 2.4 s on the shared loop clock while the centre dot stays solid.
  • Failed while unseen (red alert) and finished while unseen (green dot) are unchanged.
  • Screen readers hear the status. A task row's description now leads with Running, Waiting for your answer, Last run failed, or Finished, not opened yet, followed by its project details. This covers this computer's rows and a paired computer's rows, in English, Spanish, German and Korean. The description is cached per status and details, so the shimmer's repaints don't rebuild it.

The shine's letters no longer move

The shine coloured its line with a text run per letter, and gpui shapes a line again wherever the colour changes. Each letter inside the band was shaped on its own and lost its kerning, while the letters outside it kept theirs, so letters shifted by up to 5 px as the band crossed. The shine now paints the resting line's single layout glyph by glyph, each in its own tint. Measured on rendered frames, letters went from shifting in 55 of 57 frames to staying put (under 0.2 px of drift, which is the brightness change). #1587 carries the same commit, so the two copies of morph_text.rs stay identical and the PRs merge cleanly in either order.

Light mode

  • Row buttons (pin, rename, menu): hover and press now use the shared overlay_hover and a new overlay_press instead of solid fills. Before, on a selected row under the pointer, the hover chip came out lighter than the row, a press flashed near white, and on a hovered row a press didn't show at all.
  • Open task menu: while it's open, the row keeps its hover fill (HoverBackground::highlighted) and the action strip keeps covering the title, as project headers already do.

Screenshots

Sidebar rows rendered through gpui's offscreen Metal renderer from the real row code, at the app's 15 fps loop rate. Dark theme is above light, and each row is labelled with its state.

Before (master) After
Task states, before Task states, after
One task through its states

Running → asks you something → you answer → finishes while you're elsewhere → you open it. Dark is on the left, light on the right.

Task status flow

Validation

  • cargo test -p maple-agent-app --bin maple-agent at 18862857: 1,509 passed, 0 failed, 3 ignored. This includes the i18n catalog and translation-review tests for all four locales.
  • cargo clippy -p maple-agent-app --all-targets --locked -- -D warnings passes, for default features and for --no-default-features --features acp,proxy. cargo fmt --all -- --check passes.
  • The de, es and ko revision records were rewritten by record_reviewed_translations, which is what just translations-reviewed <locale> runs.
  • Letter positions under the shine were measured frame by frame on the rendered output, as described above.
  • Ran on rustc 1.98 through the shared Agent cache. This Mac has no Nix, so just ci didn't run on the pinned toolchain.

Notes

  • UI only. No stored values, protocol strings or element ids change.
  • New strings: chat-task-running, chat-task-needs-you, chat-task-failed, chat-task-finished-unseen, and chat-task-status-details. The German and Korean wording would benefit from a native speaker's look.
  • Under Reduce Motion, or with the window in the background, the shine and the halo hold still. A running row then reads as a dimmer title.
  • A selected running row's resting words are muted ink on the selected fill: 4.2:1 on dark and 3.5:1 on light, under the 4.5:1 body-text target. The band crosses them every 1.2 s, and the task itself is open beside the sidebar.
  • Not in this PR: a status summary on collapsed folders, and keyboard focus revealing row actions.

Merge order

Independent of the #1587 stack. Both PRs carry the same morph_text.rs (shine plus the letter fix), so either can merge first. I simulated #1587 landing on master first and then merged this branch: it's clean.

A running task showed a coral ring with a breathing dot beside its title,
and a task waiting on a question showed a coral dot. The two differed
only by shape, and the ring read as a radio button. A running task now
shows what the transcript shows while Maple thinks: a brighter band sweeps
across its title, and the words rest a step dimmer under it, in the row's
secondary ink when selected and muted ink otherwise. Coral is left to the
task that needs you. The indicator box stays, empty, on a running row, so
the title's width holds as the task moves on to its next state.

The band is morph_text's shine, carried here as the "Maple is thinking"
line's change adds it (#1587), so the two merge cleanly in either order.
It runs on the shared loop clock like the ring did, and holds still under
reduced motion and in a background window.
A row's buttons eased to the selected-row colour on hover and pressed to
the hairline colour. On a selected row under the pointer the hover chip
came out lighter than the row, a press flashed near white, and on a
hovered row a press matched the row and showed nothing. Hover and press
now ease to the shared hover overlay and a new, stronger overlay_press
over whatever the row is, so they read one and two steps past it in
either theme. The pin and overflow buttons use the same pair, and an open
overflow button holds its press fill under the pointer.

With a task's menu open, the pointer leaves the row for the menu, so the
row eased back to rest while the action strip kept its fill. The row now
holds its hover fill while its menu is open, as a project header does,
and the strip keeps covering the title behind the open button.
A task waiting on the user and a task that finished unseen both showed an
8 px dot, told apart only by colour. The waiting mark is now a small coral
dot in a soft coral halo with a solid edge; the finished mark stays a
plain green dot, so the two differ by shape too. The coral is accent_ink,
the ink the transcript's line rests in while Maple waits on you, which
holds about 3:1 on a selected light row where the brighter coral faded.

The indicator and the title's shine had no accessible name, so screen
readers heard only a row's title and project. A task row's description
now leads with its status (Running, Waiting for your answer, Last run
failed, Finished, not opened yet), then its project details, on this
computer's rows and a paired computer's alike. The description is cached
per status and details, so the shine's repaints allocate nothing for it.
English, Spanish, German and Korean.
The shine coloured its line with a text run per letter. gpui shapes a
line anew wherever the colour changes, so each letter inside the band was
shaped alone and lost its kerning against its neighbours, while letters
outside it, all one colour, kept theirs. As the band crossed, letters
moved by up to five pixels and back. The shine now paints the resting
line's single layout glyph by glyph, each in its own tint, so the words
stay where they rest and only their colour moves.
@matthewrball
matthewrball force-pushed the ux/task-status-indicators branch from ea85e9f to 1886285 Compare November 18, 2026 03:48
@matthewrball matthewrball changed the title Agent: a running task traces its row instead of showing a coral ring Agent: a running task's title shimmers instead of showing a coral ring Nov 18, 2026
A running task's title shone too softly to catch: the band was heading
ink, close to the words it crossed, and on a selected row the words rested
in secondary ink, nearly the band's colour, so a selected running row
looked idle. The band is now activity_shine, the brightest ink each
theme has (white on dark, black on light), over words that rest in muted
ink on every row, selected or not, and it passes every 1.2 s instead of
1.9 s. The band against the words goes from 1.5:1 to 2.7:1 on a selected
dark row; the band against a selected row's fill reaches 11:1 dark and
14:1 light.

The resting words of a selected running row sit below 4.5:1 (4.2:1 dark,
3.5:1 light); the band crosses them every 1.2 s, and the task itself is
open beside the sidebar.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant