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

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 ## [Unreleased]
 
+## [18.13.2] - 2026-10-27
+
+### Added
+
+- Added a frame-write listener (`TUI.addFrameWriteListener`) for terminal integrations that need to react to emitted ANSI output, including resize paints ([#17145](https://github.com/can1357/oh-my-pi/issues/17145))
+- `HookInputComponent` (`showHookInput`) now accepts `{ secret: true }` to mask typed characters as bullets (`•`) in input overlays ([#17080](https://github.com/can1357/oh-my-pi/pull/17080) by [@GTanger](https://github.com/GTanger))
+- Added an ANSI and native `/context` viewer with category navigation, content inspection, token-usage and compaction estimates, and keyboard/mouse controls that adapt across Tern and other terminals ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+
+### Fixed
+
+- Fixed `AskDialogComponent`'s draft input guard holding the keyboard until the draft was cleared; Up/Down (or a pointer action) now release it so the question can be answered with the draft parked, and `syncPresentation` receives the effective blocked state ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed the prompt editor's autocomplete popup (e.g. emoji suggestions after `:D`) staying open and following the cursor after Shift/Ctrl/Alt+Enter inserted a newline, so the next Enter submitted past a stale list; newlines and cursor motion (arrows, Home/End, word jumps, character jumps) now close it ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed `run_watch` failed-job rows hiding why a job's logs are unavailable; multiline `gh` errors now stay on one row ([#17173](https://github.com/can1357/oh-my-pi/pull/17173) by [@alphastorm](https://github.com/alphastorm))
+
+### Removed
+
+- Removed the static context usage report (`ContextUsageView`, `renderContextUsage`, `describeContextUsage`), `contextUsageHead()`, and the `glyph` and `color` fields of `ContextBreakdown` categories; use `ContextViewer` ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+- Fixed Markdown tables inside list items disappearing from the terminal transcript ([#17165](https://github.com/can1357/oh-my-pi/issues/17165)).
+
+## [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`, `QuestionResult`, and single-question `AskToolDetails`: 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 +2488,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/chrome/context-map.d.ts

@@ -0,0 +1,15 @@
+/** Pure occupancy calculations for contiguous token segments, independent of themes and renderers. */
+export interface ContextMapSegment<T> {
+    readonly id: T;
+    readonly tokens: number;
+}
+export interface ContextMapCell<T> {
+    readonly id: T;
+    readonly full: boolean;
+}
+/**
+ * Lays `segments` out in order over a `columns` × `rows` grid representing `windowTokens`; each cell takes the
+ * segment covering most of it and is `full` at 70% coverage or more. Returns `[]` when the window or grid
+ * size is unusable, and omits cells no segment touches.
+ */
+export declare function planContextMap<T>(segments: readonly ContextMapSegment<T>[], windowTokens: number, columns: number, rows: number): ContextMapCell<T>[];

package/dist/types/chrome/context-presentation.d.ts

@@ -0,0 +1,48 @@
+import type { ContextCategoryId } from "./context-view-model.js";
+export declare const CONTEXT_PRESENTATION: {
+    readonly "system-prompt": {
+        readonly color: "accent";
+        readonly symbol: "context.content";
+    };
+    readonly skills: {
+        readonly color: "success";
+        readonly symbol: "context.content";
+    };
+    readonly "built-in-tools": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "custom-tools": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "user-messages": {
+        readonly color: "accent";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-messages": {
+        readonly color: "userMessageText";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-thinking": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-calls": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-output": {
+        readonly color: "muted";
+        readonly symbol: "context.messages";
+    };
+    readonly buffer: {
+        readonly color: "warning";
+        readonly symbol: "context.buffer";
+    };
+    readonly free: {
+        readonly color: "dim";
+        readonly symbol: "context.free";
+    };
+};
+export type ContextPresentationId = ContextCategoryId | "buffer" | "free";

package/dist/types/chrome/context-view-model.d.ts

@@ -0,0 +1,77 @@
+/** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+interface ContextCategoryDescriptor {
+    readonly id: string;
+    readonly label: string;
+    /** Overview row label when the Overview weight differs from the category's content. */
+    readonly overviewLabel?: string;
+    /** Listed with its weight but never opened. */
+    readonly openable?: false;
+}
+/** Context categories in display order. */
+export declare const CONTEXT_CATEGORIES: readonly [{
+    readonly id: "system-prompt";
+    readonly label: "System Prompt";
+    readonly overviewLabel: "System Prompt (excluding Skills)";
+}, {
+    readonly id: "skills";
+    readonly label: "Skills";
+    readonly openable: false;
+}, {
+    readonly id: "built-in-tools";
+    readonly label: "Built-in Tools";
+}, {
+    readonly id: "custom-tools";
+    readonly label: "Custom Tools";
+}, {
+    readonly id: "user-messages";
+    readonly label: "User / Developer Messages";
+}, {
+    readonly id: "assistant-messages";
+    readonly label: "Assistant Messages";
+}, {
+    readonly id: "assistant-thinking";
+    readonly label: "Assistant Thinking";
+}, {
+    readonly id: "tool-calls";
+    readonly label: "Tool Calls";
+}, {
+    readonly id: "tool-output";
+    readonly label: "Tool Output";
+}];
+export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
+/** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
+export declare function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor;
+export interface ContextThinkingGroup {
+    readonly id: string;
+    readonly label: string;
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+}
+export interface ContextViewEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly text: string;
+    /** Aggregation weight for the unscaled replay estimate; shared blocks contribute through their group. */
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+    readonly thinkingGroup?: ContextThinkingGroup;
+    readonly path?: string;
+    readonly info?: string;
+    readonly timestamp?: number;
+    readonly callId?: string;
+}
+export interface ContextViewCategory {
+    id: ContextCategoryId;
+    key?: string;
+    label: string;
+    /** Overview attribution weight, not reported usage; may differ from the entry sum (e.g. Skills subtraction). */
+    tokens: number;
+    entries: ContextViewEntry[];
+    children?: ContextViewCategory[];
+}
+export interface ContextViewData {
+    readonly breakdown: ContextBreakdown;
+    readonly categories: readonly ContextViewCategory[];
+}
+export {};

package/dist/types/overlays/advisor-config.d.ts

@@ -22,8 +22,10 @@ import { type ModelBrowserSource } from "./model-browser.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 export declare const ADVISOR_REVIEW_MODES: readonly ["turn", "agent-end"];
 export declare const ADVISOR_SYNC_BACKLOG_MODES: readonly ["off", "1", "3", "5", "strict"];
+export declare const ADVISOR_SESSION_SCOPES: readonly ["main", "subagent", "all"];
 export type AdvisorReviewMode = (typeof ADVISOR_REVIEW_MODES)[number];
 export type AdvisorSyncBacklog = (typeof ADVISOR_SYNC_BACKLOG_MODES)[number];
+export type AdvisorSessionScope = (typeof ADVISOR_SESSION_SCOPES)[number];
 /** One advisor declared in `WATCHDOG.yml`; its instructions specialize the shared baseline. */
 export interface AdvisorConfig {
     name: string;
@@ -39,6 +41,10 @@ export interface AdvisorConfig {
     reviewMode?: AdvisorReviewMode;
     reviewInterval?: number;
     syncBacklog?: AdvisorSyncBacklog;
+    /** Which session kinds this advisor attaches to (`main`, `subagent`, or `all`; defaults to `all`). */
+    scope?: AdvisorSessionScope;
+    /** Whether primary assistant thinking blocks are included in updates sent to this advisor (defaults to `true`). */
+    includeReasoning?: boolean;
 }
 /** Which level a `WATCHDOG.yml` lives at: the project root or the user agent dir. */
 export type AdvisorConfigScope = "project" | "user";

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. */
@@ -59,14 +61,21 @@ interface AskDialogCallbacks {
     /** Prompt that accepts pasted images; without it, prompts use `onPrompt`. */
     onImagePrompt?(prompt: AskDialogPrompt, prefill: AskDialogPromptValue | undefined): Promise<AskDialogPromptValue | undefined>;
 }
+/**
+ * Routes typing to a composer draft that was in progress when the dialog
+ * opened, so in-flight keystrokes never answer by accident. The up/down select
+ * keys are the explicit hand-off: they release the guard for the rest of the
+ * dialog's life and the draft stays parked (intact) beneath it.
+ */
 interface AskDialogInputGuard {
     isBlocked(): boolean;
     handleInput(keyData: string): void;
+    /** Shown after the release keys while the guard holds input. */
     hint: string;
     /** Mirror the guard's blocked state onto the proxied draft surface each
      *  render, so a draft that owns input shows a visible insertion cursor even
-     *  though this dialog holds TUI focus. */
-    syncPresentation?(): void;
+     *  though this dialog holds TUI focus, and drops it once the dialog takes over. */
+    syncPresentation?(blocked: boolean): void;
 }
 interface AskDialogOptions {
     timeout?: number;
@@ -116,7 +125,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/context-viewer-format.d.ts

@@ -0,0 +1,42 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextCategoryId, ContextThinkingGroup, ContextViewEntry } from "../chrome/context-view-model.js";
+/** Normalized newlines, control characters removed, tabs expanded. */
+export declare function safeContent(value: string): string;
+/** {@link safeContent} with embedded home paths shortened, for labels and metadata. */
+export declare function safeText(value: string): string;
+/** {@link safeText} collapsed to one row. */
+export declare function safeLine(value: string): string;
+/** Token label of an entry or group: `—` for a grouped entry, `N/A · Interrupted`, else `N token(s)` (unscaled estimate). */
+export declare function tokenEstimate(item: ContextViewEntry | ContextThinkingGroup): string;
+/** `[label] N tokens` as ANSI. */
+export declare function entryHeaderLine(entry: ContextViewEntry, category: ContextCategoryId): string;
+/** `[label] N tokens` as spans. */
+export declare function entryHeaderSpans(entry: ContextViewEntry, category: ContextCategoryId): TspSpan[];
+/** Heading for a shared thinking group: label plus its token estimate. */
+export declare function groupHeaderLine(group: ContextThinkingGroup, category: ContextCategoryId): string;
+/** Truncation marker under a preview; the selected preview also advertises the open key. */
+export declare function previewHint(selected: boolean): string;
+/**
+ * Metadata rows: info and path, call id, timestamp. The full-content view also
+ * lists the thinking group, which previews show as a shared heading instead.
+ */
+export declare function entryMetadata(entry: ContextViewEntry, options: {
+    hour12: boolean | undefined;
+    withGroup: boolean;
+}): string[];
+/** Preview row budget for a list of `height` rows: room for the entry heading, hint, and group heading. */
+export declare function previewRows(entry: ContextViewEntry, height: number): number;
+export interface EntryPreviewOptions {
+    /** Wrap width of preview rows. */
+    readonly width: number;
+    /** Maximum preview rows. */
+    readonly rows: number;
+    /** Viewport width; bounds the source read to `sourceWidth × rows × 2` characters before sanitizing and wrapping. */
+    readonly sourceWidth: number;
+    readonly hour12: boolean | undefined;
+}
+/** Dim metadata rows, then the indented body, cut to `rows`; `complete` is false when anything was omitted. */
+export declare function entryPreview(entry: ContextViewEntry, options: EntryPreviewOptions): {
+    lines: string[];
+    complete: boolean;
+};

package/dist/types/overlays/context-viewer-overview.d.ts

@@ -0,0 +1,70 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+import { type ContextMapCell } from "../chrome/context-map.js";
+import { type ContextPresentationId } from "../chrome/context-presentation.js";
+import type { NativeNode } from "../native/node.js";
+import type { ThemeColor } from "../theme/index.js";
+import { type ContextViewCategory, type ContextViewData } from "../chrome/context-view-model.js";
+/** Columns between the map and the legend. */
+export declare const MAP_LEGEND_GAP = 3;
+export interface OverviewRow {
+    readonly key: string;
+    readonly id: ContextPresentationId;
+    readonly label: string;
+    /** Attributed usage; undefined when the weights cannot scale current usage. */
+    readonly tokens: number | undefined;
+    /** Category opened on confirm; undefined rows are listed but not selectable. */
+    readonly category?: ContextViewCategory;
+    readonly child?: boolean;
+    /** Right-aligned token column. */
+    readonly tokenColumn: string;
+    /** Right-aligned share column, including its leading separator. */
+    readonly shareColumn: string;
+}
+export interface MapGeometry {
+    readonly columns: number;
+    readonly rows: number;
+    readonly cellWidth: number;
+    readonly gap: string;
+    readonly width: number;
+}
+/**
+ * Attribute current usage to categories by weight, then each category's share to its children.
+ * Attributed values are not entry sums: entries keep their unscaled content/replay estimates.
+ * Undefined when the top-level weights cannot scale; unscalable children stay unattributed.
+ */
+export declare function allocateUsage(categories: readonly ContextViewCategory[], usage: number): Map<ContextViewCategory, number> | undefined;
+/** Overview row label for a category: its Overview-specific label when the weight differs from its content. */
+export declare function overviewLabel(category: ContextViewCategory): string;
+/** Category and child rows, then buffer and free space, with aligned token and share columns. */
+export declare function buildOverviewRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number> | undefined): OverviewRow[];
+/** ANSI legend row: cursor, swatch, label padded to `width`, token and share columns. */
+export declare function legendLine(row: OverviewRow, selected: boolean, width: number): string;
+/** Native legend item; `meterGlyphs` swaps map glyphs for the meter's bar glyphs. */
+export declare function legendItem(row: OverviewRow, selected: boolean, meterGlyphs: boolean, window: number): NativeNode;
+/** Map size beside a legend in a `width` × `height` body; undefined when either would not fit. */
+export declare function mapGeometry(width: number, height: number): MapGeometry | undefined;
+/** Map cells per row, in window order: categories, free space, then buffer. */
+export declare function planMapRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number>, geometry: MapGeometry): ContextMapCell<ContextPresentationId>[][];
+/** ANSI map row; partially filled cells are dim. */
+export declare function mapRowLine(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): string;
+/** Native map row; partially filled cells are dim. */
+export declare function mapRowSpans(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): TspSpan[];
+/** Snapcompact savings lines of the Overview; empty when no snapcompact setting is on. */
+export declare function contextSnapcompactLines(breakdown: ContextBreakdown): string[];
+interface ContextMeterData extends Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "autoCompactBufferTokens" | "thresholdTokens"> {
+    categories: readonly {
+        label: string;
+        tokens: number;
+        color: ThemeColor;
+    }[];
+}
+/** Shared usage and compaction labels for ANSI and native context views. */
+export declare function contextUsageSummary(breakdown: Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "thresholdTokens">): {
+    used: string;
+    detail: string;
+    room: string;
+};
+/** Native usage summary and stacked bar; callers provide the category list. */
+export declare function describeContextMeter(breakdown: ContextMeterData): [NativeNode, NativeNode];
+export {};

package/dist/types/overlays/context-viewer.d.ts

@@ -0,0 +1,25 @@
+import type { ContextViewData } from "../chrome/context-view-model.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { Component } from "../tui.js";
+/**
+ * Read-only context snapshot with three states: Overview → category previews → full entry content.
+ * Navigation state is shared; `render` (ANSI) and `describe` (native) each draw every state,
+ * via `#render<State>` and `#describe<State>` respectively.
+ */
+export declare class ContextViewer implements Component {
+    #private;
+    constructor(data: ContextViewData, options: {
+        onClose: () => void;
+        requestRender: () => void;
+        getRows: () => number;
+    });
+    invalidate(): void;
+    dispose(): void;
+    get nativeOverlay(): NonNullable<Component["nativeOverlay"]>;
+    /** Capture only handled navigation keys; the focus path consumes other modal input. */
+    capturesInput(data: string): boolean;
+    handleInput(data: string): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    render(width: number): readonly string[];
+    describe(cx: DescribeContext): NativeNode;
+}

package/dist/types/overlays/hook-input.d.ts

@@ -8,6 +8,7 @@ export interface HookInputOptions {
     tui?: TUI;
     timeout?: number;
     onTimeout?: () => void;
+    secret?: boolean;
 }
 export declare class HookInputComponent extends OverlayPanel {
     #private;

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/overlays/running-subagent-badge.d.ts

@@ -1,6 +1,12 @@
-import type { AgentHubRegistry } from "./agent-hub-types.js";
+import { type AgentHubRegistry } from "./agent-hub-types.js";
 export interface RunningSubagentRegistrySource<T extends AgentHubRegistry = AgentHubRegistry> {
     agentRegistry: T;
 }
 export declare function getRunningSubagentBadgeRegistry<T extends AgentHubRegistry>(collabGuest: RunningSubagentRegistrySource<T> | undefined, localRegistry: T): T;
 export declare function getRunningSubagentBadgeAgentIds(registry: AgentHubRegistry): string[];
+/**
+ * Agents the Agent Hub roster can show (every registry ref but the main
+ * session), whatever their status: finished, parked and killed subagents
+ * stay inspectable after the last one stops running.
+ */
+export declare function getInspectableSubagentCount(registry: AgentHubRegistry): number;

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/status-line/context-usage.d.ts

@@ -1,10 +1,6 @@
 import type { AgentMessage, Tokenizer } from "@oh-my-pi/pi-agent-core";
 import type { CompactionSettings } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Tool as AiTool, Model } from "@oh-my-pi/pi-ai";
-import type { Theme } from "../theme/index.js";
-import { Container } from "../tui.js";
-import type { TspText } from "@oh-my-pi/pi-wire";
-import type { DescribeContext, NativeNode } from "../native/node.js";
 interface ContextSkill {
     readonly name: string;
     readonly description?: string;
@@ -63,8 +59,6 @@ interface CategoryInfo {
     id: CategoryId;
     label: string;
     tokens: number;
-    color: "accent" | "warning" | "success" | "userMessageText" | "customMessageLabel";
-    glyph: string;
 }
 export interface ContextBreakdown {
     model: Model | undefined;
@@ -128,6 +122,21 @@ export declare function getToolSchemaMetadataRevision(tools: ToolSchemaSource):
  * discovered-agent metadata changes).
  */
 export declare function invalidateToolSchemaMetadata(tools: ToolSchemaSource): void;
+/** Provider-visible text of one tool definition, in wire order. */
+export interface ToolSchemaFragments {
+    /** Name, description, wire schema JSON, then rendered examples; fields that cannot be serialized are omitted. */
+    readonly fragments: string[];
+    /** `fragments` with the schema JSON indented for reading; present only when a display indent was requested. */
+    readonly display?: string[];
+    /** Why serialization stopped; the schema or examples after that point are missing from `fragments`. */
+    readonly schemaError?: string;
+}
+/**
+ * Provider-visible text of one tool definition. `displayIndent` additionally
+ * returns `display`, the same fragments with the schema JSON indented, from
+ * the same schema conversion.
+ */
+export declare function toolSchemaFragments(tool: ContextTool, displayIndent?: number): ToolSchemaFragments;
 /**
  * Estimate provider-visible tool-schema tokens.
  *
@@ -158,28 +167,4 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
-/** The `/context` title: the model once one is selected (the body leads with its window). */
-export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
-/**
- * Native context-usage panel for terminals without `meter`: the cell grid as
- * unwrapped styled rows beside the legend. The terminal places the legend
- * beside the grid, or below it when narrow.
- */
-export declare function describeContextUsage(breakdown: ContextBreakdown): NativeNode;
-/**
- * The `/context` report body, without a frame or title of its own (the panel
- * showing it is titled {@link contextUsageHead}): ANSI renders the cell grid
- * beside the legend; natively it is drawn with `meter`s where the terminal has
- * them and as the glyph grid otherwise.
- */
-export declare class ContextUsageView extends Container {
-    #private;
-    constructor(breakdown: ContextBreakdown, theme: Theme);
-    describe(cx: DescribeContext): NativeNode;
-}
-/**
- * Render a colorful context-usage panel as ANSI text. Output is a series of
- * lines pairing the grid (left) with the legend (right).
- */
-export declare function renderContextUsage(breakdown: ContextBreakdown, theme: Theme): string;
 export {};

package/dist/types/theme/symbols.d.ts

@@ -2,7 +2,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "context.content" | "context.messages" | "context.buffer" | "context.free" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
 export type SymbolMap = Record<SymbolKey, string>;
 /**
  * Icon vocabulary for slash-command autocomplete type indicators. Each name

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;
 }
@@ -24,6 +26,8 @@ export interface AskToolDetails {
     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;
     /** Multi-part question mode */