@oh-my-pi/pi-tui 18.13.0 → 18.13.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [18.13.1] - 2026-10-27
+
+### Added
+
+- ANSI and TSP `/pause` screens show unsettled turns and jobs, hide settled counters, and preserve counts and resume controls on short terminals ([#17073](https://github.com/can1357/oh-my-pi/pull/17073) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Added `noteOption` to `ExtensionAskDialogResultItem` and `QuestionResult`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+
+### Changed
+
+- `StatusLineComponent.setRunningSubagents()` and `setSubagentTreeCost()` now report whether their state changed, allowing callers to skip redundant redraws ([#17131](https://github.com/can1357/oh-my-pi/pull/17131) by [@iliaal](https://github.com/iliaal)).
+
+### Fixed
+
+- Fixed the ask dialog's Note (button or `n`) right after a pick moved to the next question annotating that question's highlighted row instead of the answer just picked ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+- Fixed the ask dialog's Next button reopening the custom-answer editor after Other was cancelled instead of moving on to the next question or Review tab
+
 ## [18.13.0] - 2026-10-26
 
 ### Breaking Changes
@@ -2453,35 +2469,4 @@
 
 - Fixed native Windows + Windows Terminal scrollback being yanked to the top when a streaming response triggered a TUI full redraw. Under ConPTY the `kernel32` `GetConsoleScreenBufferInfo` probe answers about the pseudo-console (always at the buffer tail) and not about WT's host scrollback, so `isNativeViewportAtBottom()` falsely returned `true` while the user was scrolled up and the shrink-across-viewport branch issued a destructive `historyRebuild` (`\x1b[2J\x1b[H\x1b[3J`). The probe now short-circuits to `undefined` whenever `WT_SESSION` is set, letting the existing deferred-rebuild path keep streaming-time mutations non-destructive and reconcile native history at the next prompt-submit checkpoint. ([#1635](https://github.com/can1357/oh-my-pi/issues/1635))
 
-## [15.7.3] - 2026-05-31
-
-### Added
-
-- Added `overflowSearch` to `SelectListLayoutOptions` to let consumers enable or disable type-to-filter search and search-status rendering per SelectList instance
-- Added fuzzy type-to-filter search to overflowing `SelectList` pickers, with search status and result counts.
-- Added `TUI.setEagerNativeScrollbackRebuild(enabled)` — while enabled, live render frames rebuild native scrollback on offscreen/structural changes even when the viewport position is unobservable (POSIX), instead of deferring to a non-destructive repaint. Trades the anti-yank guarantee for clean, duplicate-free history; intended for windows where output above the fold is actively re-laying out (e.g. a tool whose result is still streaming). A terminal that reports a known-scrolled viewport still defers.
-
-### Changed
-
-- Disabled interactive search filtering for editor autocomplete and slash-command `SelectList`s by passing `overflowSearch: false` in their layout options
-
-### Fixed
-
-- Preserved hidden tmux overlays in the live viewport by removing overlay content from view when an overlay was hidden while keeping pane history intact
-- Preserved native scrollback when forced TUI renders coalesce with content growth, and deferred pure tail appends while readers are scrolled into history.
-- Preserved existing terminal scrollback during forced and structural TUI renders so preexisting shell lines remained visible after component mutations
-- Rebuilt native scrollback for safe bottom-anchored offscreen edits and high-water preview collapses instead of repainting only the viewport, preventing stale or duplicated rows above the live viewport.
-- Stripped internal cursor marker sentinels from all rendered lines so offscreen focus markers no longer leak into terminal output
-- Truncated all painted lines to terminal width during viewport repaints and append-tail updates so long content no longer overflows or wraps unexpectedly
-- Fixed `tui.select.cancel` handling in `SelectList` so pressing Escape or Ctrl+C closes the list even when no matches are currently shown
-- Fixed native scrollback corruption when an offscreen row edit and repeated-tail append land in one render frame; ambiguous appended tails now rebuild history instead of splicing stale rows into the buffer.
-- Fixed scrolled-up readers being yanked back to the tail whenever streaming content arrived on POSIX terminals (macOS/Linux). Native viewport position is unobservable there (`isNativeViewportAtBottom()` returns `undefined`), and the planner optimistically treated "unknown" as "at bottom", so every offscreen streaming edit ran a destructive `historyRebuild` that cleared scrollback and snapped the view to the bottom. Live render frames now treat an unknown viewport as unsafe for a destructive rebuild — they defer to a non-destructive viewport repaint and reconcile native scrollback at the next explicit checkpoint (prompt submit). Resize and checkpoint replays keep the prior behavior.
-- Fixed native scrollback not rewrapping when the terminal widens on POSIX. A width increase reflows the transcript to fewer lines, which the shrink-across-boundary branch intercepted and (after the unknown-viewport deferral) repainted only the viewport — leaving committed history wrapped at the old width and duplicated above the live viewport. Width changes now rebuild native scrollback at the new geometry even when the viewport position is unknown (a yank is acceptable on an explicit resize); a terminal that can report a scrolled viewport still defers.
-
-## [15.7.0] - 2026-05-31
-
-### Fixed
-
-- Fixed slash-command autocomplete repainting when a Windows Terminal session cannot report native scrollback position; live input renders can now bypass the unknown-viewport deferral without weakening background scrollback protection. ([#1550](https://github.com/can1357/oh-my-pi/issues/1550))
-
-Older entries are archived in [packages/tui/CHANGELOG.md@539f05ae39f8](https://github.com/can1357/oh-my-pi/blob/539f05ae39f81319dc75d650757dad3c76482343/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@3d45d8557cd7](https://github.com/can1357/oh-my-pi/blob/3d45d8557cd7493221b69c7ed3c6b6a2307f46e7/packages/tui/CHANGELOG.md).

package/dist/types/overlays/ask-dialog.d.ts

@@ -31,6 +31,8 @@ export interface ExtensionAskDialogResultItem {
     customInputImages?: ImageContent[];
     note?: string;
     noteImages?: ImageContent[];
+    /** Label of the option the note is on; unset when it is on the custom answer. */
+    noteOption?: string;
     timedOut?: boolean;
 }
 /** Answers submitted from the dialog. */
@@ -116,7 +118,7 @@ export declare class AskDialogComponent implements Component {
      * Pointer actions: a tab click switches to it; a click on an answer row is
      * Enter on it (Space for a multi-select option, so it toggles; its
      * double-click `activate` is Enter); the action bar's Submit, Note and Skip
-     * run exactly what Enter, `n` and Esc run on the highlighted row; Hide/Show
+     * run what Enter (see {@link #pressEnter} for Other), `n` and Esc run on the highlighted row; Hide/Show
      * collapse and restore the dialog.
      */
     handleNativeEvent(event: NativeUiEvent): void;

package/dist/types/overlays/pause-screen.d.ts

@@ -1,5 +1,14 @@
 import { type Component, type OverlayFocusOwner, type OverlayHandle, type OverlayOptions } from "../index.js";
 import type { NativeNode, NativeUiEvent } from "../native/node.js";
+/** Outstanding turn and job counts supplied by the pause-screen host. */
+export interface PauseWorkStatus {
+    unsettledTurns: number;
+    unfinishedJobs: number;
+}
+/** Optional live work source for the pause overlay. */
+export interface PauseScreenOptions {
+    getWorkStatus?: () => PauseWorkStatus;
+}
 /**
  * Slice of `InteractiveModeContext` the pause screen drives. Narrow so tests
  * can exercise the full engage → hold → release lifecycle without a real TUI.
@@ -22,12 +31,13 @@ export interface PauseScreenHost {
  * Paint the pause scene as exactly `height` rows, vertically centered.
  * Exported for tests.
  */
-export declare function renderPauseScreen(width: number, height: number, elapsedMs: number, sessionName?: string): string[];
+export declare function renderPauseScreen(width: number, height: number, elapsedMs: number, sessionName?: string, workStatus?: PauseWorkStatus): string[];
 /** Fullscreen overlay component; resolves {@link run} when a resume key lands. */
 export declare class PauseScreenComponent implements Component, OverlayFocusOwner {
     #private;
     readonly host: PauseScreenHost;
-    constructor(host: PauseScreenHost);
+    readonly options: PauseScreenOptions;
+    constructor(host: PauseScreenHost, options?: PauseScreenOptions);
     /** Start the clock; resolves once the user asks to resume. */
     run(): Promise<void>;
     dispose(): void;
@@ -57,4 +67,4 @@ export declare class PauseScreenComponent implements Component, OverlayFocusOwne
  * gate on the way out (including teardown throws) — a leaked pause would
  * freeze every agent in the process with no UI left to release it.
  */
-export declare function runPauseScreen(host: PauseScreenHost): Promise<void>;
+export declare function runPauseScreen(host: PauseScreenHost, options?: PauseScreenOptions): Promise<void>;

package/dist/types/status-line/component.d.ts

@@ -30,9 +30,9 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     updateSettings(settings: StatusLineSettings): void;
     getEffectiveSettingsForTest(): EffectiveStatusLineSettings;
     setAutoCompactEnabled(enabled: boolean): void;
-    setRunningSubagents(agentIds: readonly string[]): void;
+    setRunningSubagents(agentIds: readonly string[]): boolean;
     /** Host-computed spend of the main session's whole subagent tree (Agent Hub projection). */
-    setSubagentTreeCost(cost: number): void;
+    setSubagentTreeCost(cost: number): boolean;
     /**
      * Compatibility shim for callers predating the simplified subagent badge.
      * The status line now intentionally shows only the active count.

package/dist/types/tools/ask.d.ts

@@ -12,6 +12,8 @@ export interface QuestionResult {
     customInput?: string;
     /** Optional note attached to the selected answer in the rich ask dialog. */
     note?: string;
+    /** Label of the option the note is on; unset when it is on the custom answer. */
+    noteOption?: string;
     /** True when the answer was auto-selected because the dialog timed out. */
     timedOut?: boolean;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.13.0",
+	"version": "18.13.1",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.13.0",
-		"@oh-my-pi/pi-agent-core": "18.13.0",
-		"@oh-my-pi/pi-ai": "18.13.0",
-		"@oh-my-pi/pi-catalog": "18.13.0",
-		"@oh-my-pi/pi-natives": "18.13.0",
-		"@oh-my-pi/pi-utils": "18.13.0",
-		"@oh-my-pi/pi-wire": "18.13.0",
-		"@oh-my-pi/snapcompact": "18.13.0"
+		"@oh-my-pi/omptype": "18.13.1",
+		"@oh-my-pi/pi-agent-core": "18.13.1",
+		"@oh-my-pi/pi-ai": "18.13.1",
+		"@oh-my-pi/pi-catalog": "18.13.1",
+		"@oh-my-pi/pi-natives": "18.13.1",
+		"@oh-my-pi/pi-utils": "18.13.1",
+		"@oh-my-pi/pi-wire": "18.13.1",
+		"@oh-my-pi/snapcompact": "18.13.1"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/overlays/ask-dialog.ts

@@ -51,6 +51,8 @@ export interface ExtensionAskDialogResultItem {
 	customInputImages?: ImageContent[];
 	note?: string;
 	noteImages?: ImageContent[];
+	/** Label of the option the note is on; unset when it is on the custom answer. */
+	noteOption?: string;
 	timedOut?: boolean;
 }
 
@@ -404,7 +406,7 @@ function describeAnswer(question: ExtensionAskDialogQuestion, state: QuestionSta
 			push(optionLabelSpans(question, index, labels[index] ?? option.label));
 	});
 	if (state.customInput !== undefined) push([span(`“${normalizedInlineInput(state.customInput)}”`)]);
-	const note = noteForSubmittedAnswer(question, state)?.trim();
+	const note = noteForSubmittedAnswer(question, state)?.text.trim();
 	if (note) spans.push(span("  ✎ ", "dim"), span(normalizedInlineInput(note), "em"));
 	return spans;
 }
@@ -448,13 +450,17 @@ function clearNoteUnlessRow(state: QuestionState, rowKey: string): void {
 	if (state.noteRowKey !== undefined && state.noteRowKey !== rowKey) clearNote(state);
 }
 
-function noteForSubmittedAnswer(question: ExtensionAskDialogQuestion, state: QuestionState): string | undefined {
+/** The note that goes out with the answer (its row is part of it), and the option it is on (unset for Other). */
+function noteForSubmittedAnswer(
+	question: ExtensionAskDialogQuestion,
+	state: QuestionState,
+): { text: string; option?: string } | undefined {
 	if (state.note === undefined || state.noteRowKey === undefined) return undefined;
-	if (state.noteRowKey === "other") return state.customInput !== undefined ? state.note : undefined;
+	if (state.noteRowKey === "other") return state.customInput !== undefined ? { text: state.note } : undefined;
 	const match = /^option:(\d+)$/.exec(state.noteRowKey);
 	const optionIndex = match?.[1] === undefined ? Number.NaN : Number.parseInt(match[1], 10);
 	const option = Number.isInteger(optionIndex) ? question.options[optionIndex] : undefined;
-	return option && state.selectedOptions.has(option.label) ? state.note : undefined;
+	return option && state.selectedOptions.has(option.label) ? { text: state.note, option: option.label } : undefined;
 }
 
 function renderRowLabel(
@@ -585,6 +591,12 @@ export class AskDialogComponent implements Component {
 	#countdownDeadline = 0;
 	/** Once-a-second re-describe while the native countdown ring is shown. */
 	#ringTick: NodeJS.Timeout | undefined;
+	/**
+	 * The answer whose pick just moved the dialog on to the next question. Note annotates it, not the
+	 * next question's highlighted row, until that question is answered or any other input arrives:
+	 * a Tern click commits a single-choice row, so picking then pressing Note is the mouse flow.
+	 */
+	#justAnswered: { questionIndex: number; rowKey: string } | undefined;
 	readonly #panel: OverlayPanel;
 	readonly #headerRegion: PanelRows;
 	readonly #bodyRegion: PanelRows;
@@ -682,6 +694,7 @@ export class AskDialogComponent implements Component {
 		// closed/prompt guards, matching HookSelector/HookInput semantics.
 		this.#countdown?.reset();
 		this.#native = undefined;
+		if (keyData !== "n" && keyData !== "N") this.#justAnswered = undefined;
 		if (matchesSelectCancel(keyData)) {
 			this.#finishCancel();
 			return;
@@ -1006,7 +1019,10 @@ export class AskDialogComponent implements Component {
 			tone: "accent",
 			title: question?.multi ? `${enterLabel}  enter · Toggle  space` : `${enterLabel}  enter`,
 		});
-		const note = actionButton("Note", "note", { keys: "n", title: "Add a note to the highlighted answer  n" });
+		const note = actionButton("Note", "note", {
+			keys: "n",
+			title: "Add a note to the highlighted answer, or to the one just picked  n",
+		});
 		return actionBar([...lead, null, note, skip, submit]);
 	}
 
@@ -1014,11 +1030,12 @@ export class AskDialogComponent implements Component {
 	 * Pointer actions: a tab click switches to it; a click on an answer row is
 	 * Enter on it (Space for a multi-select option, so it toggles; its
 	 * double-click `activate` is Enter); the action bar's Submit, Note and Skip
-	 * run exactly what Enter, `n` and Esc run on the highlighted row; Hide/Show
+	 * run what Enter (see {@link #pressEnter} for Other), `n` and Esc run on the highlighted row; Hide/Show
 	 * collapse and restore the dialog.
 	 */
 	handleNativeEvent(event: NativeUiEvent): void {
 		if (this.#closed || this.#promptActive) return;
+		if (event.type !== "action" || event.act !== "note") this.#justAnswered = undefined;
 		if (event.type === "action") {
 			if (event.act === "cancel") {
 				this.#finishCancel();
@@ -1062,7 +1079,13 @@ export class AskDialogComponent implements Component {
 		this.#requestRender();
 	}
 
-	/** Enter: submit on the Review tab, else commit the highlighted row. */
+	/**
+	 * The action bar's Submit/Next: submit on the Review tab, else commit the highlighted row —
+	 * except Other, whose row (click or Enter) already opens the editor. Reopening it here trapped a
+	 * cancelled Other: Next kept bringing the editor back instead of moving on. With a Review tab to
+	 * land on, Next keeps any custom answer and moves on; a lone single-select question has nowhere
+	 * to go but submitting nothing, so it still asks.
+	 */
 	#pressEnter(): void {
 		this.#countdown?.reset();
 		if (this.#isSubmitTab()) {
@@ -1072,18 +1095,38 @@ export class AskDialogComponent implements Component {
 		const active = this.#activeQuestionState();
 		const rowItem = active ? this.#questionRows(active.question)[active.state.cursorIndex] : undefined;
 		if (!active || !rowItem) return;
+		if (rowItem.kind === "other" && this.#hasSubmitTab()) {
+			this.#advanceAfterQuestion(active.state.customInput === undefined ? undefined : rowItem.key);
+			return;
+		}
 		this.#commitRow(active.question, active.state, rowItem, true);
 		this.#requestRender();
 	}
 
-	/** `n`: a note on the highlighted row (questions only). */
+	/** `n`: a note on the {@link #noteTarget} row (questions only). */
 	#pressNote(): void {
 		if (this.#isSubmitTab()) return;
 		this.#countdown?.reset();
+		const target = this.#noteTarget();
+		if (target) void this.#promptForNote(target.question, target.state, target.rowItem);
+	}
+
+	/**
+	 * The row a note goes to: the answer just picked while the question it moved on to is still
+	 * unanswered, else the highlighted row.
+	 */
+	#noteTarget(): { question: ExtensionAskDialogQuestion; state: QuestionState; rowItem: QuestionRow } | undefined {
 		const active = this.#activeQuestionState();
-		const rowItem = active ? this.#questionRows(active.question)[active.state.cursorIndex] : undefined;
-		if (!active || !rowItem) return;
-		void this.#promptForNote(active.question, active.state, rowItem);
+		if (!active) return undefined;
+		const last = this.#justAnswered;
+		if (last && last.questionIndex !== this.#currentQuestionIndex() && !isAnswered(active.state)) {
+			const question = this.#questions[last.questionIndex];
+			const state = this.#states[last.questionIndex];
+			const rowItem = question ? this.#questionRows(question).find(row => row.key === last.rowKey) : undefined;
+			if (question && state && rowItem) return { question, state, rowItem };
+		}
+		const rowItem = this.#questionRows(active.question)[active.state.cursorIndex];
+		return rowItem ? { question: active.question, state: active.state, rowItem } : undefined;
 	}
 
 	/** Re-describe once a second while a countdown ring is shown (the ring's value is data, not a terminal clock). */
@@ -1334,9 +1377,7 @@ export class AskDialogComponent implements Component {
 		const rowItem = rows[state.cursorIndex];
 		if (!rowItem) return;
 		if (keyData === "n" || keyData === "N") {
-			if (rowItem.kind === "option" || rowItem.kind === "other") {
-				void this.#promptForNote(question, state, rowItem);
-			}
+			this.#pressNote();
 			return;
 		}
 		const isEnter = matchesKey(keyData, "enter") || matchesKey(keyData, "return") || keyData === "\n";
@@ -1364,7 +1405,7 @@ export class AskDialogComponent implements Component {
 				// focused option; Space toggles. Advances to the next question
 				// (submitting only for a single-question dialog), matching
 				// single-select Enter (#8252).
-				this.#advanceAfterQuestion();
+				this.#advanceAfterQuestion(state.selectedOptions.has(option.label) ? rowItem.key : undefined);
 				return;
 			}
 			if (state.selectedOptions.has(option.label)) {
@@ -1380,7 +1421,7 @@ export class AskDialogComponent implements Component {
 		state.customInput = undefined;
 		state.customInputImages = undefined;
 		clearNoteUnlessRow(state, rowItem.key);
-		this.#advanceAfterQuestion();
+		this.#advanceAfterQuestion(rowItem.key);
 	}
 
 	#handleSubmitTabInput(keyData: string): void {
@@ -1405,8 +1446,13 @@ export class AskDialogComponent implements Component {
 		this.#submitScrollOffset = 0;
 	}
 
-	#advanceAfterQuestion(): void {
+	/** Move past the current question; `answeredRowKey` is the row whose pick did it, for {@link #noteTarget}. */
+	#advanceAfterQuestion(answeredRowKey?: string): void {
 		const current = this.#currentQuestionIndex();
+		this.#justAnswered =
+			answeredRowKey !== undefined && this.#questions.length > 1
+				? { questionIndex: current, rowKey: answeredRowKey }
+				: undefined;
 		if (this.#questions.length === 1) {
 			this.#finishSubmit();
 			return;
@@ -1458,7 +1504,7 @@ export class AskDialogComponent implements Component {
 				this.#activeTabIndex = this.#submitTabIndex();
 				this.#submitScrollOffset = 0;
 			} else {
-				this.#advanceAfterQuestion();
+				this.#advanceAfterQuestion(rowItem.key);
 			}
 		} finally {
 			this.#promptActive = false;
@@ -1590,7 +1636,7 @@ export class AskDialogComponent implements Component {
 			const label = questionTabLabel(question, index);
 			const answer = renderAnswerSummary(question, state);
 			allLines.push(`${theme.fg("dim", `${index + 1}. ${label}:`)} ${answer}`);
-			const submittedNote = noteForSubmittedAnswer(question, state);
+			const submittedNote = noteForSubmittedAnswer(question, state)?.text;
 			if (submittedNote?.trim()) {
 				const note = normalizedInlineInput(submittedNote);
 				allLines.push(
@@ -1724,8 +1770,9 @@ export class AskDialogComponent implements Component {
 				selectedOptions,
 				customInput: state.customInput,
 				customInputImages: state.customInputImages,
-				note,
+				note: note?.text,
 				noteImages: note === undefined ? undefined : state.noteImages,
+				noteOption: note?.option,
 				timedOut: state.timedOut || undefined,
 			});
 		}

package/src/overlays/pause-screen.ts

@@ -14,7 +14,7 @@
 import { agentPauseGate } from "@oh-my-pi/pi-agent-core";
 import { type Component, matchesKey, type OverlayFocusOwner, type OverlayHandle, type OverlayOptions } from "../index";
 import { formatCoarseDuration } from "../chrome/format";
-import { centerLine } from "../utils";
+import { centerLine, visibleWidth } from "../utils";
 import { theme } from "../theme/theme";
 import { matchesAppInterrupt } from "../keybinding-matchers";
 import { formatKeyHint, formatTooltipKey } from "../app-keybindings";
@@ -24,6 +24,17 @@ import { col, keyed, node, row, span, text } from "../native/describe";
 import { actionBar, actionButton } from "../native/overlay";
 import { isNativeRendering } from "../native/state";
 
+/** Outstanding turn and job counts supplied by the pause-screen host. */
+export interface PauseWorkStatus {
+	unsettledTurns: number;
+	unfinishedJobs: number;
+}
+
+/** Optional live work source for the pause overlay. */
+export interface PauseScreenOptions {
+	getWorkStatus?: () => PauseWorkStatus;
+}
+
 /**
  * Slice of `InteractiveModeContext` the pause screen drives. Narrow so tests
  * can exercise the full engage → hold → release lifecycle without a real TUI.
@@ -39,9 +50,10 @@ export interface PauseScreenHost {
 	readonly sessionName?: string;
 }
 
-/** Refresh cadence for the live "paused for" clock. */
-const TICK_MS = 1_000;
+const EMPTY_WORK_STATUS: PauseWorkStatus = { unsettledTurns: 0, unfinishedJobs: 0 };
 
+/** Refresh cadence for the live hold clock and work-status snapshot. */
+const TICK_MS = 1_000;
 /** Pause-bar glyph geometry (rows × columns of full blocks per bar). */
 const BAR_ROWS = 7;
 const BAR_WIDTH = 5;
@@ -49,7 +61,7 @@ const BAR_GAP = 4;
 
 /** Below either bound the full scene cannot breathe; drop to the compact card. */
 const MIN_FULL_WIDTH = 64;
-const MIN_FULL_HEIGHT = 18;
+const MIN_FULL_HEIGHT = 23;
 
 const TITLE = "P A U S E D";
 const BODY_LINES = [
@@ -79,51 +91,110 @@ function formatClock(ms: number): string {
  * Paint the pause scene as exactly `height` rows, vertically centered.
  * Exported for tests.
  */
-export function renderPauseScreen(width: number, height: number, elapsedMs: number, sessionName?: string): string[] {
-	const compact = width < MIN_FULL_WIDTH || height < MIN_FULL_HEIGHT;
+export function renderPauseScreen(
+	width: number,
+	height: number,
+	elapsedMs: number,
+	sessionName?: string,
+	workStatus: PauseWorkStatus = EMPTY_WORK_STATUS,
+): string[] {
+	const screenWidth = Math.max(1, Math.floor(width));
+	const screenHeight = Math.max(1, Math.floor(height));
+	const compact = screenWidth < MIN_FULL_WIDTH || screenHeight < MIN_FULL_HEIGHT;
+	const outstanding = workStatus.unsettledTurns > 0 || workStatus.unfinishedJobs > 0;
+	const status = outstanding ? "Pausing — waiting for work to settle" : "Paused — ready to suspend";
+	const workCounts = [
+		`Unsettled turns: ${workStatus.unsettledTurns}`,
+		`Unfinished jobs: ${workStatus.unfinishedJobs}`,
+	];
 	const content: string[] = [];
 	// Resume keys mirror PauseScreenComponent#handleInput: `app.interrupt` (raw Escape when unbound), Enter, Space.
 	const esc = interruptKey();
 
 	if (compact) {
-		if (sessionName) {
-			content.push(centerLine(theme.bold(sessionName), width).trimEnd());
-			content.push("");
+		const sessionLine = sessionName
+			? centerLine(theme.bold(sessionName.replace(/\s+/g, " ").trim()), screenWidth).trimEnd()
+			: undefined;
+		const titleLine = centerLine(theme.bold(theme.fg("accent", `▌▌ ${TITLE}`)), screenWidth).trimEnd();
+		const clockLine = centerLine(theme.fg("dim", `paused for ${formatClock(elapsedMs)}`), screenWidth).trimEnd();
+		const statusLine = centerLine(theme.fg(outstanding ? "warning" : "success", status), screenWidth).trimEnd();
+		const resumeLine = centerLine(theme.fg("dim", `${esc} to resume`), screenWidth).trimEnd();
+		const fullContent: string[] = [];
+		if (sessionLine) fullContent.push(sessionLine);
+		fullContent.push(titleLine, "", clockLine, statusLine);
+		if (outstanding)
+			fullContent.push(...workCounts.map(line => centerLine(theme.fg("muted", line), screenWidth).trimEnd()));
+		fullContent.push(resumeLine);
+
+		if (screenHeight >= fullContent.length) {
+			content.push(...fullContent);
+		} else {
+			// Keep the live state and a way out on screen before the decorative card details.
+			if (screenHeight === 1) {
+				const counts = `T:${workStatus.unsettledTurns} J:${workStatus.unfinishedJobs}`;
+				const summary = outstanding ? `${counts} · ${esc} to resume` : `Paused · ${esc} to resume`;
+				const abbreviatedSummary = outstanding
+					? `T${workStatus.unsettledTurns} J${workStatus.unfinishedJobs} ${esc} resume`
+					: `${esc} resume`;
+				const visibleSummary = visibleWidth(summary) > screenWidth ? abbreviatedSummary : summary;
+				content.push(
+					centerLine(theme.fg(outstanding ? "warning" : "success", visibleSummary), screenWidth).trimEnd(),
+				);
+			} else if (screenHeight === 2 && outstanding) {
+				const counts = `Pausing · T:${workStatus.unsettledTurns} J:${workStatus.unfinishedJobs}`;
+				content.push(centerLine(theme.fg("warning", counts), screenWidth).trimEnd(), resumeLine);
+			} else {
+				content.push(statusLine);
+				if (outstanding && screenHeight === 3) {
+					content.push(
+						centerLine(
+							theme.fg("muted", `Turns: ${workStatus.unsettledTurns} · Jobs: ${workStatus.unfinishedJobs}`),
+							screenWidth,
+						).trimEnd(),
+					);
+				} else if (outstanding) {
+					content.push(...workCounts.map(line => centerLine(theme.fg("muted", line), screenWidth).trimEnd()));
+				}
+				content.push(resumeLine);
+			}
+
+			if (content.length < screenHeight && sessionLine) content.push(sessionLine);
+			if (content.length < screenHeight) content.push(titleLine);
+			if (content.length < screenHeight) content.push(clockLine);
 		}
-		content.push(centerLine(theme.bold(theme.fg("accent", `▌▌ ${TITLE}`)), width).trimEnd());
-		content.push("");
-		content.push(centerLine(theme.fg("dim", `paused for ${formatClock(elapsedMs)}`), width).trimEnd());
-		content.push(centerLine(theme.fg("dim", `${esc} to resume`), width).trimEnd());
 	} else {
 		if (sessionName) {
-			content.push(centerLine(theme.bold(sessionName), width).trimEnd());
-			content.push("");
+			content.push(centerLine(theme.bold(sessionName.replace(/\s+/g, " ").trim()), screenWidth).trimEnd());
 			content.push("");
 		}
 		const bar = "█".repeat(BAR_WIDTH);
 		const glyphRow = `${bar}${" ".repeat(BAR_GAP)}${bar}`;
 		for (let i = 0; i < BAR_ROWS; i++) {
-			content.push(centerLine(theme.fg("accent", glyphRow), width).trimEnd());
+			content.push(centerLine(theme.fg("accent", glyphRow), screenWidth).trimEnd());
 		}
 		content.push("");
-		content.push(centerLine(theme.bold(theme.fg("accent", TITLE)), width).trimEnd());
+		content.push(centerLine(theme.bold(theme.fg("accent", TITLE)), screenWidth).trimEnd());
 		content.push("");
 		for (const line of BODY_LINES) {
-			content.push(centerLine(theme.fg("muted", line), width).trimEnd());
+			content.push(centerLine(theme.fg("muted", line), screenWidth).trimEnd());
 		}
-		content.push("");
-		content.push(centerLine(theme.fg("dim", `paused for ${formatClock(elapsedMs)}`), width).trimEnd());
+		content.push(centerLine(theme.fg(outstanding ? "warning" : "success", status), screenWidth).trimEnd());
+		if (outstanding) {
+			content.push(centerLine(theme.fg("muted", workCounts[0]!), screenWidth).trimEnd());
+			content.push(centerLine(theme.fg("muted", workCounts[1]!), screenWidth).trimEnd());
+		}
+		content.push(centerLine(theme.fg("dim", `paused for ${formatClock(elapsedMs)}`), screenWidth).trimEnd());
 		content.push("");
 		const resumeHint = `${esc} · ${formatKeyHint("enter")} · ${formatKeyHint("space")} — resume`;
-		content.push(centerLine(theme.fg("dim", resumeHint), width).trimEnd());
+		content.push(centerLine(theme.fg("dim", resumeHint), screenWidth).trimEnd());
 	}
 
-	const topPad = Math.max(0, Math.floor((height - content.length) / 2));
+	const topPad = Math.max(0, Math.floor((screenHeight - content.length) / 2));
 	// oxlint-disable-next-line unicorn/no-new-array -- length preallocation
 	const lines: string[] = new Array(topPad).fill("");
 	lines.push(...content);
-	while (lines.length < height) lines.push("");
-	return lines.slice(0, Math.max(1, height));
+	while (lines.length < screenHeight) lines.push("");
+	return lines.slice(0, screenHeight);
 }
 
 /** Fullscreen overlay component; resolves {@link run} when a resume key lands. */
@@ -133,19 +204,25 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 	#disposed = false;
 	#startedAt = Date.now();
 	#native: NativeNode | undefined;
+	#workSnapshot: PauseWorkStatus;
 
-	constructor(readonly host: PauseScreenHost) {}
+	constructor(
+		readonly host: PauseScreenHost,
+		readonly options: PauseScreenOptions = {},
+	) {
+		this.#workSnapshot = this.#readWorkSnapshot();
+	}
 
 	/** Start the clock; resolves once the user asks to resume. */
 	run(): Promise<void> {
 		this.#startedAt = agentPauseGate.pausedAt ?? Date.now();
 		this.#native = undefined;
-		// The tick only repaints the hold clock; natively the `elapsed` node counts on its own.
-		if (!isNativeRendering()) {
-			this.#timer ??= setInterval(() => {
-				if (!this.#disposed) this.host.ui.requestRender();
-			}, TICK_MS);
-		}
+		this.#refreshWorkSnapshot();
+		this.#timer ??= setInterval(() => {
+			if (this.#disposed) return;
+			const statusChanged = this.#refreshWorkSnapshot();
+			if (statusChanged || !isNativeRendering()) this.host.ui.requestRender();
+		}, TICK_MS);
 		this.host.ui.requestRender();
 		return this.#done.promise;
 	}
@@ -181,6 +258,25 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 		this.#native = undefined;
 	}
 
+	#readWorkSnapshot(): PauseWorkStatus {
+		const workStatus = this.options.getWorkStatus?.() ?? EMPTY_WORK_STATUS;
+		return {
+			unsettledTurns: workStatus.unsettledTurns,
+			unfinishedJobs: workStatus.unfinishedJobs,
+		};
+	}
+
+	#refreshWorkSnapshot(): boolean {
+		const next = this.#readWorkSnapshot();
+		const previous = this.#workSnapshot;
+		if (next.unsettledTurns === previous.unsettledTurns && next.unfinishedJobs === previous.unfinishedJobs) {
+			return false;
+		}
+		this.#workSnapshot = next;
+		this.#native = undefined;
+		return true;
+	}
+
 	/** A glass sheet titled "Paused" (not the whole pane: the transcript stays visible, frozen). */
 	readonly nativeOverlay = { role: "omp.overlay.pause", size: "md", anchor: "center", head: "Paused" } as const;
 
@@ -191,6 +287,41 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 	 */
 	describe(): NativeNode {
 		if (this.#native) return this.#native;
+		const snapshot = this.#workSnapshot;
+		const outstanding = snapshot.unsettledTurns > 0 || snapshot.unfinishedJobs > 0;
+		const status = col(
+			[
+				keyed(
+					text(
+						[
+							span(
+								outstanding ? "Pausing — waiting for work to settle" : "Paused — ready to suspend",
+								outstanding ? "warning" : "success",
+							),
+						],
+						{ role: "omp.pause.settlement" },
+					),
+					"settlement",
+				),
+				...(outstanding
+					? [
+							keyed(
+								text([span(`Unsettled turns: ${snapshot.unsettledTurns}`, "muted")], {
+									role: "omp.pause.unsettled-turn-count",
+								}),
+								"unsettled-turns",
+							),
+							keyed(
+								text([span(`Unfinished jobs: ${snapshot.unfinishedJobs}`, "muted")], {
+									role: "omp.pause.unfinished-job-count",
+								}),
+								"unfinished-jobs",
+							),
+						]
+					: []),
+			],
+			{ role: "omp.pause.settlement-status", gap: "sm" },
+		);
 		const resumeKey = boundKeys("app.interrupt", ["escape"])[0] ?? "escape";
 		const hero = row(
 			[
@@ -244,12 +375,9 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 		this.#native = col(
 			[
 				keyed(hero, "hero"),
+				keyed(status, "settlement-status"),
 				keyed(facts, "facts"),
 				actionBar([
-					keyed(
-						text([span("Each agent continues where it stopped.", "muted")], { role: "omp.pause.note" }),
-						"note",
-					),
 					null,
 					actionButton("Resume", "resume", {
 						keys: resumeKey,
@@ -276,6 +404,7 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 			Math.max(1, this.host.ui.terminal.rows),
 			elapsed,
 			this.host.sessionName,
+			this.#workSnapshot,
 		);
 	}
 }
@@ -286,9 +415,9 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
  * gate on the way out (including teardown throws) — a leaked pause would
  * freeze every agent in the process with no UI left to release it.
  */
-export async function runPauseScreen(host: PauseScreenHost): Promise<void> {
+export async function runPauseScreen(host: PauseScreenHost, options?: PauseScreenOptions): Promise<void> {
 	if (!agentPauseGate.pause()) return;
-	const component = new PauseScreenComponent(host);
+	const component = new PauseScreenComponent(host, options);
 	const overlay = host.ui.showOverlay(component, {
 		width: "100%",
 		maxHeight: "100%",

package/src/status-line/component.ts

@@ -990,24 +990,26 @@ export class StatusLineComponent<TSession extends StatusLineSession = StatusLine
 		this.#invalidateStatusLineRenderCache();
 	}
 
-	setRunningSubagents(agentIds: readonly string[]): void {
+	setRunningSubagents(agentIds: readonly string[]): boolean {
 		if (
 			agentIds.length === this.#runningSubagentIds.size &&
 			agentIds.every(agentId => this.#runningSubagentIds.has(agentId))
 		) {
-			return;
+			return false;
 		}
 		this.#subagentCount = agentIds.length;
 		this.#runningSubagentIds = new Set(agentIds);
 		this.#invalidateStatusLineRenderCache();
+		return true;
 	}
 
 	/** Host-computed spend of the main session's whole subagent tree (Agent Hub projection). */
-	setSubagentTreeCost(cost: number): void {
+	setSubagentTreeCost(cost: number): boolean {
 		const next = Number.isFinite(cost) && cost > 0 ? cost : 0;
-		if (next === this.#subagentTreeCost) return;
+		if (next === this.#subagentTreeCost) return false;
 		this.#subagentTreeCost = next;
 		this.#invalidateStatusLineRenderCache();
+		return true;
 	}
 
 	/**

package/src/tools/ask.ts

@@ -37,6 +37,8 @@ export interface QuestionResult {
 	customInput?: string;
 	/** Optional note attached to the selected answer in the rich ask dialog. */
 	note?: string;
+	/** Label of the option the note is on; unset when it is on the custom answer. */
+	noteOption?: string;
 	/** True when the answer was auto-selected because the dialog timed out. */
 	timedOut?: boolean;
 }