fix(coding-agent): show a preparing turn's prompt in the TUI queued-messages area

[snimu]

Fixes the user report that queued messages don't show up in the interactive TUI while a compaction is running.

Linear: https://linear.app/primeintellect/issue/RES-1306/queued-messages-dont-show-up-while-compaction-is-running

LOC

+194/-5 total: src +20/-5 (one file, interactive-mode.ts), tests +173 (two existing files), +1 changelog fragment. No new files besides the fragment.

Root cause

Reproduced with a failing test before fixing. The session-side queue lanes are correct in both reported scenarios: a message submitted during compaction takes the queueForBusy branch and queues visibly, and messages queued during streaming stay in their lanes while the pump is blocked by compaction (both now pinned). The invisible case is the queued message whose OWN turn triggers the compaction: at the run boundary the pump selects the queued action, and the turn's pre-turn threshold-compaction check (preTurnCompaction: "beforeModelSelection" for queued turns) starts the compaction while the action sits in lifecycle preparing. Preparing turns are deliberately out of the queued lanes (three existing pins: preparing inputs are pump-owned "activity", not editable queue members) and are reported through the snapshot's active field instead — which the interactive TUI never rendered. Result: for the entire compaction (which can run minutes on big transcripts), the user's queued message is nowhere on screen.

Fix

Render the daemon-provided state instead of re-deriving it: updatePendingMessagesDisplay now shows sessionActions.active when it is a turn in phase preparing, as a Starting: … line at the top of the queued-messages area. Running/committing turns keep rendering through the transcript (no double-render), the browse/edit hint still appears only when editable lane items exist, and the feature-hint suppression covers the populated area. The styleQueuedMessagePreview label union widens by "Starting"; no wire or session-core changes.

An alternative fix (returning preparing turns to the snapshot lanes) was implemented and discarded: it contradicts three deliberate design pins (removes preparing inputs from literal queue projections, keeps steering stop pending while a steering handoff is still preparing, coalesced-duplicate ownership) and would desync lane indexes used by queued-message mutation.

Tests

• agent-session-compaction.test.ts +2: (1) a message submitted during a gated manual compaction stays in the snapshot lanes AND in the emitted session_action_update (the event the TUI renders from); (2) the reproduced interleave — queued follow-up, run ends, context growth lands at the boundary, its own pre-turn compaction runs — pins the contract that active carries {kind: "turn", phase: "preparing", label} for the whole window.
• interactive-mode-compaction.test.ts +1 (fail-unfixed verified: renders nothing before the fix): the real updatePendingMessagesDisplay renders Starting: queued before compaction from that snapshot, and a running turn renders nothing there.

Validation: 433 tests green across the affected local set (compaction, queue, queue-mutation, concurrent, in-process connection, session-list, queue-edit, feature-hints, hint-placement, status); sandbox full test:ci shows only the documented environmental failing set (config, extensions-*, resource-loader, tools EACCES-as-root; the one extra tools.test.ts bash-persistence failure is the documented concurrent-tmpdir flake and passes in isolation); npm run check green.

---

Note

Low Risk
UI and optional snapshot field only; queue mutation semantics and lane ownership are unchanged, with backward-compatible fallback for older daemons.

Overview
Fixes queued prompts vanishing from the interactive queued-messages preview while compaction runs—especially when a follow-up turn’s own pre-turn compaction holds it in preparing after it leaves the editable lanes.

Session snapshot: getSessionActionSnapshot now projects pump-owned turns in selected or preparing into an optional preparing list (same preview strings the lanes used), so an all-mode batch can stay visible for the whole compaction window. The existing active turn/phase payload is unchanged for running/committing work.

TUI: updatePendingMessagesDisplay renders those previews as Starting: lines above steering/follow-ups, with a fallback to legacy daemons that only expose active.label in phase preparing. Browse/edit hints still require real lane queue items; feature-hint suppression treats the whole queue area as populated when only Starting lines show.

Tests lock the snapshot/event contract during gated compaction and the interactive render path (including that running turns do not duplicate in this area). Changelog fragment for RES-1306.

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

Note

Show preparing turn prompts in TUI queued-messages area during compaction

• Extends AgentSession.getSessionActionSnapshot to project preparing/selected turn actions and expose their prompt previews via a new optional preparing field on SessionActionSnapshot
• Updates InteractiveMode.updatePendingMessagesDisplay to render preparing previews with a Starting label in the queued-messages area, ahead of steering and follow-up messages
• Falls back to the legacy single active.label for older daemons; suppresses feature hints and browse/edit hints when only a preparing turn is shown
• Risk: SessionActionSnapshot.preparing is optional and ignored by older consumers, but any out-of-tree reader that snapshots the full interface must handle the new field

^{Macroscope summarized 0691720.}

[cursor]

Cursor Bugbot has reviewed your changes 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 0691720. Configure here.}