@oh-my-pi/pi-tui 18.10.0 → 18.10.2

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 ## [Unreleased]
 
+## [18.10.2] - 2026-10-12
+
+### Added
+
+- Added opt-in `/tree` branch navigation across visible branches and nested fork depths; bind `app.tree.previousBranch` / `app.tree.nextBranch` (e.g. to `Shift+Left` / `Shift+Right`) in `keybindings.yml` ([#12623](https://github.com/can1357/oh-my-pi/pull/12623) by [@azain47](https://github.com/azain47)).
+
+### Changed
+
+- The `wait` tool's native job rows (`omp.wait.job`) are a single `row`: badge, id and label, progress and clock, without the output preview or capture notice beneath
+- The native bash run foot reads In background with a live clock (`omp.run.time` without `stopped`) while a parked job's frames stream (`details.async.state === "running"`, partial), instead of Running
+- Native model pickers (/model, the quick switch and the advisor's) mark providers with their logo (`mark.icon: "provider:<id>"`, initials where the terminal has none), and every model row leads with its provider's mark
+
+### Removed
+
+- Removed the unused `app.tree.foldOrUp` / `app.tree.unfoldOrDown` keybinding ids, which no longer did anything.
+- Added `parksAsBackground(toolName, details)`, `asyncJobState(details)`, `isSettledJobFrame(details)` and `settleWithJobFrame(component, frame, toolCallId)` (`chat/tool-execution`): whether a returned call's card stays live for its background job's frames (`task` always; `bash` and `eval` under native rendering), the job state a frame reports, and settling the card with the job's last frame (a cancelled job keeps its output and seals as cancelled)
+- `BashToolDetails.async.state` and `EvalToolDetails.async.state` gain `cancelled` for a job killed before it finished
+
+## [18.10.1] - 2026-10-12
+
+### Added
+
+- `AssistantMessageComponent`'s native turn footer leads with a Copy icon (`omp.turn.copy`) and a dot instead of the clock icon; it copies the answer's text and shows when the host handles transcript actions
+
+### Changed
+
+- `UserMessageComponent`'s native hover toolbar (`omp.user.tools`) leads with Copy and Rewind icon buttons (`copy`, `rewind`) instead of text labels, then a dot and the time, like the turn usage footer
+- `ContextUsageView`'s native body (on terminals with `meter`) leads with the tokens used and the room left before auto-compaction, then one stacked bar ticked at the threshold, the breakdown as rows (`omp.context.cat`, `.cat.free`, `.cat.buffer`: swatch, name, tokens, share; the exact count in the row's `title`) and the snapcompact estimate as labelled rows (`omp.context.snap`); the blocks meter and legend `kv` are gone, and `contextUsageHead` no longer repeats the window size
+- `AskDialogComponent`'s native root is `omp.editor.ask` (collapsed: `omp.editor.ask.hidden`, the countdown, the question as `omp.ask.summary`, Skip and Show): a chosen answer is the `accent`-toned row (a check also carries the check icon) instead of the highlighted one; multi-select Other… is `omp.ask.other.check`; the question tabs check answered questions and say their keys in the strip's `title`; the countdown moves from the head to the action bar beside Hide; the preview is `omp.ask.preview`; the Review tab leads with `omp.ask.notice` and lists answers (`omp.ask.answers`) by question name with inline code mono and no `(Recommended)` suffix; option descriptions run inline code mono, notes ride the row's detail as `em`; Submit/Next's tooltip names only Enter (and Space on a multi-select)
+- `MCPAddWizard`'s native sheet asks one question per step: a phase strip (`omp.mcpAdd.progress` of `omp.mcpAdd.phase`, toned done/current/upcoming and `neutral` when no auth was needed), the question and its lead (`omp.mcpAdd.title`, `omp.mcpAdd.tag` for optional fields, `omp.mcpAdd.lead`), then a mono field with a placeholder and its rule or refusal (`omp.mcpAdd.field`, `tone: "error"`; `omp.mcpAdd.note`), choice rows with icons and mono tags (`omp.mcpAdd.choices`), status lines (`omp.mcpAdd.status`, `omp.mcpAdd.checks`, `omp.mcpAdd.error`) or the review rows (`omp.mcpAdd.summary`). Cancel, Back and Continue / Save server buttons run Ctrl+C, Esc and Enter instead of a key-hint strip. The connection test shows its own busy step, the OAuth client secret field is masked, and the review saves on Enter (no Yes/No choice)
+- `ReportPanel`'s native body carries the role `omp.report.body`
+- `HookInputComponent` describes a dock sheet (`omp.overlay.hook-input` col) like `HookEditorComponent`'s: the title's first line (`omp.hook-input.title`, the countdown as `omp.hook-input.timer`) over its further lines (`omp.hook-input.detail`), the field (`omp.hook-input.field`, `tone: "error"` while a submit was refused) with its placeholder, and Cancel / Submit buttons that run Esc / Enter; the key legend under the field is terminal-only
+- `JobsSheet`'s native body is a master–detail split (`omp.jobs.split`: `omp.jobs.master` | `omp.jobs.detail`): the job list grouped Running / Recent (`omp.jobs.group` labels), each row a type icon tinted by status with its duration, beside the selected job's status pill, live elapsed and Cancel job (`omp.jobs.status`), its task title or command (`omp.jobs.title` / `omp.jobs.command`), facts (`omp.jobs.facts`: agent, directory, pids, exit code, artifact) and output (`omp.jobs.out`, `omp.jobs.nooutput`); the footer counts running and recent jobs (`omp.jobs.summary`), and no jobs shows an empty state (`omp.jobs.empty`). Task jobs no longer draw an `agent` node here
+- `BtwHistoryPanel`'s native sheet is centered and reads like a mail reader: the questions as two-line rows (`omp.btw.history`, list `omp.btw.list` / `omp.btw.list.idle` while the answer has the keys) beside the selected thread (`omp.btw.reader` › `omp.btw.thread` › `omp.btw.turn`: `omp.btw.question` / `omp.btw.followup`, `omp.btw.meta`, `omp.btw.answer`, `omp.btw.error`), the follow-up field under the last answer (`omp.btw.composer`), and footer buttons Stop answer, Copy answer, Close and Follow up (Cancel and Send while composing) in place of the focus labels and key-hint strip; an empty history is an `md` sheet (`omp.btw.empty`)
+
+### Fixed
+
+- `CountdownTimer`'s native `elapsed` no longer sends `stopped: 0`, which froze every native countdown (extension input, selector and editor prompts) at zero from the start
+- The native backend's focus now reaches a field inside an `overlay`/`picker` sheet hoisted into the layer from a dock component (the MCP add wizard, login), so that field shows the live caret and focus ring
+- `MCPAddWizard` keeps a refused name or URL in its field, clears a stale refusal on Back, ignores a connection test that settles after the user stepped back, and Edit OAuth settings after a failed sign-in opens the settings again instead of doing nothing
+
 ## [18.10.0] - 2026-10-12
 
 ### Breaking Changes
@@ -2731,157 +2772,4 @@
 
 - Optimized padding operations across all components to use pre-allocated space buffer for better performance
 
-## [9.2.2] - 2026-01-31
-
-### Added
-
-- Added setAutocompleteMaxVisible() configuration (3-20 items)
-- Added image detection to terminal capabilities (containsImage method)
-- Added stdin monitoring to detect stalled input events and log warnings
-
-### Changed
-
-- Improved blockquote rendering with text wrapping in Markdown component
-- Restructured terminal capabilities from interface-based to class-based model
-- Improved table column width calculation with word-aware wrapping
-- Refactored text utilities to use native WASM implementations for strings >256 chars with JS fast path
-
-### Fixed
-
-- Simplified terminal write error handling to mark terminal as dead on any write failure
-- Fixed multi-line strings in renderOutputBlock causing width overflow
-- Fixed slash command autocomplete applying stale completion when typing quickly
-
-### Removed
-
-- Removed TUI layout engine exports from public API (BoxNode, ColumnNode, LayoutNode, etc.)
-
-## [8.12.7] - 2026-01-29
-
-### Fixed
-
-- Fixed slash command autocomplete applying stale completion when typing quickly
-
-## [8.4.1] - 2026-01-25
-
-### Added
-
-- Added fuzzy match function for autocomplete suggestions
-
-## [8.4.0] - 2026-01-25
-
-### Changed
-
-- Added Ctrl+Backspace as a delete-word-backward keybinding and improved modified backspace matching
-
-### Fixed
-
-- Terminal gracefully handles write failures by marking dead instead of exiting the process
-- Reserved cursor space for zero padding and corrected end-of-line cursor rendering to prevent wrap glitches
-- Corrected editor end-of-line cursor rendering assertion to use includes() instead of endsWith()
-
-## [8.2.0] - 2026-01-24
-
-### Added
-
-- Added mermaid diagram rendering engine (renderMermaidToPng) with mmdc CLI integration
-- Added terminal graphics encoding (iTerm2/Kitty) for mermaid diagrams with automatic width scaling
-- Added mermaid block extraction and deduplication utilities (extractMermaidBlocks)
-
-### Changed
-
-- Updated TypeScript configuration for better publish-time configuration handling with tsconfig.publish.json
-- Migrated file system operations from synchronous to asynchronous APIs in autocomplete provider for non-blocking I/O
-- Migrated node module imports from named to namespace imports across all packages for consistency with project guidelines
-
-### Fixed
-
-- Fixed crash when terminal becomes unavailable (EIO errors) by exiting gracefully instead of throwing
-- Fixed potential errors during emergency terminal restore when terminal is already dead
-- Fixed autocomplete race condition by tracking request ID to prevent stale suggestion results
-
-## [6.8.3] - 2026-01-21
-
-### Added
-
-- Added undo support in the editor via `Ctrl+-`
-- Added `Alt+Delete` as a delete-word-forward shortcut
-- Added configurable code block indentation for Markdown rendering
-- Added undo support in the editor via `Ctrl+-`.
-- Added configurable code block indentation for Markdown rendering.
-- Added `Alt+Delete` as a delete-word-forward shortcut.
-
-### Changed
-
-- Improved fuzzy matching to handle alphanumeric swaps
-- Normalized keybinding definitions to lowercase internally
-- Improved fuzzy matching to handle alphanumeric swaps.
-- Normalized keybinding definitions to lowercase internally.
-
-### Fixed
-
-- Added legacy terminal support for `Ctrl+` symbol key combinations
-- Added legacy terminal support for `Ctrl+` symbol key combinations.
-
-## [6.8.1] - 2026-01-20
-
-### Fixed
-
-- Fixed viewport tracking after partial renders to prevent autocomplete list artifacts
-
-## [5.6.7] - 2026-01-18
-
-### Added
-
-- Added configurable editor padding via `editorPaddingX` theme option
-- Added `setMaxHeight()` method to limit editor height with scrolling
-- Added Emacs-style kill ring for text deletion operations
-- Added `Alt+D` keybinding to delete words forward
-- Added `Ctrl+Y` keybinding to yank from kill ring
-- Added `waitForRender()` method to await pending renders
-- Added Focusable interface and hardware cursor marker support for IME positioning
-- Added support for shifted symbol keys in keybindings
-
-### Changed
-
-- Updated tab bar rendering to wrap text across multiple lines when content exceeds available width
-- Expanded Kitty keyboard protocol coverage for non-Latin layouts and legacy Alt sequences
-- Improved cursor positioning with safer bounds checking
-- Updated editor layout to respect configurable padding
-- Refactored scrolling logic for better viewport management
-
-### Fixed
-
-- Fixed key detection for shifted symbol characters
-- Fixed backspace handling with additional codepoint support
-- Fixed Alt+letter key combinations for better recognition
-
-## [5.3.1] - 2026-01-15
-
-### Fixed
-
-- Fixed rendering issues on Windows by preventing re-entrant renders
-
-## [5.1.0] - 2026-01-14
-
-### Added
-
-- Added `pageUp` and `pageDown` key support with `selectPageUp`/`selectPageDown` editor actions
-- Added `isPageUp()` and `isPageDown()` helper functions
-- Added `SizeValue` type for CSS-like overlay sizing (absolute or percentage strings like `"50%"`)
-- Added `OverlayHandle` interface with `hide()`, `setHidden()`, `isHidden()` methods for overlay visibility control
-- Added `visible` callback to `OverlayOptions` for dynamic visibility based on terminal dimensions
-- Added `pad` parameter to `truncateToWidth()` for padding result with spaces to exact width
-
-### Changed
-
-- Changed `OverlayOptions` to use `SizeValue` type for `width`, `maxHeight`, `row`, and `col` properties
-- Changed `showOverlay()` to return `OverlayHandle` for controlling overlay visibility
-- Removed `widthPercent`, `maxHeightPercent`, `rowPercent`, `colPercent` from `OverlayOptions` (use percentage strings instead)
-
-### Fixed
-
-- Fixed numbered list items showing "1." for all items when code blocks break list continuity
-- Fixed width overflow protection in overlay compositing to prevent TUI crashes
-
-Older entries are archived in [packages/tui/CHANGELOG.md@60347ef0f214](https://github.com/can1357/oh-my-pi/blob/60347ef0f214fa63df596d143477268da3f0c904/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@e19bb3cb2344](https://github.com/can1357/oh-my-pi/blob/e19bb3cb2344a8953dc04aa398b810230f0e24c3/packages/tui/CHANGELOG.md).

package/THIRD-PARTY-NOTICES.txt

@@ -79,9 +79,9 @@ uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
 b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
-cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
-printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
-truncate, uname, uniq, wc, whoami, yes.
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nl, nproc,
+paste, printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee,
+touch, tr, truncate, uname, uniq, wc, whoami, yes.
 
   Copyright (c) uutils developers
 

package/dist/types/app-keybindings.d.ts

@@ -37,8 +37,8 @@ interface AppKeybindings {
     "app.session.rename": true;
     "app.session.delete": true;
     "app.session.deleteNoninvasive": true;
-    "app.tree.foldOrUp": true;
-    "app.tree.unfoldOrDown": true;
+    "app.tree.previousBranch": true;
+    "app.tree.nextBranch": true;
     "app.plan.toggle": true;
     "app.history.search": true;
     "app.stt.pushToTalk": true;
@@ -319,13 +319,13 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+backspace";
         readonly description: "Delete session (non-invasive)";
     };
-    readonly "app.tree.foldOrUp": {
-        readonly defaultKeys: ["ctrl+left", "alt+left"];
-        readonly description: "Fold or move up";
+    readonly "app.tree.previousBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the previous branch in /tree";
     };
-    readonly "app.tree.unfoldOrDown": {
-        readonly defaultKeys: ["ctrl+right", "alt+right"];
-        readonly description: "Unfold or move down";
+    readonly "app.tree.nextBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the next branch in /tree";
     };
     readonly "app.plan.toggle": {
         readonly defaultKeys: "alt+shift+p";

package/dist/types/apps/git/diff-pane.d.ts

@@ -118,6 +118,11 @@ export type PaneClick = {
 } | {
     type: "handled";
 } | null;
+/**
+ * The heading of one side of a media/binary change (`Before · PNG · Git LFS`):
+ * `label` plus the side's kind, shared by the ANSI pane and the native compare.
+ */
+export declare function assetTitle(label: string, side: FileAssetSide): string;
 /**
  * Scrollable diff viewport. The root component feeds it key/mouse input and
  * composes its rendered lines into the frame.

package/dist/types/apps/git/state.d.ts

@@ -73,11 +73,22 @@ export interface TextFileContents {
     readonly newText: string;
     readonly streamResult: DiffStreamResult;
 }
+/** Where one side of a change lives, so a host viewer (Tern's TSP `media` node) can load it by path. */
+export interface MediaRef {
+    /** Absolute path of the file (repository root joined with its repository path). */
+    readonly path: string;
+    /** Git revision holding this side (`HEAD`, a sha, `:0` for the index); absent for the worktree file. */
+    readonly rev?: string;
+}
 /** Non-text sides rendered as previews or explicit placeholders. */
 export interface AssetFileContents {
     readonly kind: "asset";
     readonly old: FileAssetSide;
     readonly new: FileAssetSide;
+    /** Source of {@link old}; absent when that side is empty. */
+    readonly oldRef?: MediaRef;
+    /** Source of {@link new}; absent when that side is empty. */
+    readonly newRef?: MediaRef;
 }
 /** Loaded file content selected for text diffing or asset preview. */
 export type FileContents = TextFileContents | AssetFileContents;

package/dist/types/chat/assistant-message.d.ts

@@ -2,7 +2,7 @@ import type { AssistantMessage, ImageContent } from "@oh-my-pi/pi-ai";
 import { type Component, Container } from "../tui.js";
 import { type ImageBudget } from "../components/image.js";
 import type { AssistantThinkingRenderer } from "./extension-types.js";
-import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import { type CacheInvalidation } from "./cache-invalidation-marker.js";
 import { type ServedModelMismatch } from "./served-model-marker.js";
 import { type TranscriptStableRow } from "../chrome/transcript-container.js";
@@ -99,13 +99,13 @@ export declare class AssistantMessageComponent extends Container {
      * head's `title`. With `hideThinkingBlock` only the live head shows (collapsed)
      * and a finished thought emits nothing.
      */
-    describe(): NativeNode;
+    describe(cx?: DescribeContext): NativeNode;
     /**
      * A TTSR rule rewound this partial answer: a native terminal dims it and
      * tags it `↺ rewound` (the ANSI render leaves it as it stopped).
      */
     markRewound(): void;
-    /** Mirrors a thinking section collapsed or expanded in the terminal. */
+    /** Mirrors a thinking section collapsed or expanded in the terminal; runs its controls' clicks. */
     handleNativeEvent(event: NativeUiEvent): void;
     /** Width-independent stable identities for the streamed leading thinking run. */
     getTranscriptStableRows(): readonly TranscriptStableRow[];
@@ -130,7 +130,12 @@ export declare class AssistantMessageComponent extends Container {
     setTableChartsVisible(visible: boolean): void;
     /** Toggle only images produced by tool results; assistant-native images remain governed by setImagesVisible. */
     setToolResultImagesVisible(visible: boolean): void;
-    setToolResultImages(toolCallId: string, images: ImageContent[]): void;
+    /**
+     * A grouped read's result images, and `mediaPath`: the file it read that Tern's media viewer
+     * shows (read details), which a native host supporting `media` shows by path instead of the
+     * images. A media-only result (a model, a PDF) passes no images.
+     */
+    setToolResultImages(toolCallId: string, images: ImageContent[], mediaPath?: string): void;
     updateContent(message: AssistantMessage, opts?: {
         transient?: boolean;
     }): void;

package/dist/types/chat/tool-execution.d.ts

@@ -17,19 +17,21 @@ export interface ToolExecutionOptions {
     /** Allow the name-keyed renderer registry only when the active tool is the built-in implementation. */
     useBuiltInRenderer?: boolean;
 }
+/** A tool result or progress frame as a card shows it. */
+export interface ToolResultFrame {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+}
 export interface ToolExecutionHandle extends Component {
     updateArgs(args: unknown, toolCallId?: string): void;
     updateStreamPreview?(update: unknown): void;
-    updateResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-            data?: string;
-            mimeType?: string;
-        }>;
-        details?: unknown;
-        isError?: boolean;
-    }, isPartial?: boolean, toolCallId?: string): void;
+    updateResult(result: ToolResultFrame, isPartial?: boolean, toolCallId?: string): void;
     setArgsComplete(toolCallId?: string): void;
     setExecutionStarted(toolCallId?: string): void;
     setExpanded(expanded: boolean): void;
@@ -39,6 +41,25 @@ export interface ToolExecutionHandle extends Component {
     /** Seal the block as final history and stop its animations. */
     seal(): void;
 }
+/**
+ * Whether a call that returned with `details.async.state === "running"` stays
+ * parked ({@link ToolExecutionHandle.parkAsBackground}) so its job's later
+ * frames keep filling the card until a `completed`/`failed` frame settles it.
+ * Detached `task` spawns always do; backgrounded `bash`/`eval` jobs only under
+ * native rendering, where the terminal transcript keeps them frozen instead.
+ * Shared by the live event controller and the transcript rebuild.
+ */
+export declare function parksAsBackground(toolName: string, details: unknown): boolean;
+/** The background job state a tool result reports (`details.async.state`: running, completed, failed, cancelled). */
+export declare function asyncJobState(details: unknown): string | undefined;
+/** Whether a frame is a background job's last one: it completed, failed or was cancelled. */
+export declare function isSettledJobFrame(details: unknown): boolean;
+/**
+ * Settle a parked card ({@link parksAsBackground}) with its job's last frame
+ * ({@link isSettledJobFrame}): a completed or failed job is the call's result;
+ * a cancelled one keeps the output it got to and seals the card as cancelled.
+ */
+export declare function settleWithJobFrame(component: ToolExecutionHandle, frame: ToolResultFrame, toolCallId: string): void;
 /** Phase-locked spinner glyph index shared by every live tool block so parallel
  * spinners advance in lockstep instead of each tracking its own start time. */
 export declare function sharedSpinnerFrame(frameCount: number, now?: number): number;
@@ -74,16 +95,7 @@ export declare class ToolExecutionComponent extends Container {
      */
     whenPreviewSettled(timeoutMs?: number): Promise<void>;
     updateStreamPreview(update: unknown): void;
-    updateResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-            data?: string;
-            mimeType?: string;
-        }>;
-        details?: unknown;
-        isError?: boolean;
-    }, isPartial?: boolean, _toolCallId?: string): void;
+    updateResult(result: ToolResultFrame, isPartial?: boolean, _toolCallId?: string): void;
     /**
      * Advance to the shared spinner glyph and repaint just this block. Driven by
      * the single shared spinner ticker (see `registerSpinnerBlock`); the tick is

package/dist/types/chat/user-message.d.ts

@@ -39,8 +39,9 @@ export declare class UserMessageComponent extends Container implements ReactionT
     /**
      * A head-less user-toned frame with the prompt as markdown under its
      * attached images (titled `#N` like their chips, opening the materialized
-     * file on click): the fill says "you". A quiet toolbar (time, Copy, Rewind) fades in on hover when the
-     * host handles transcript actions. The live-steering marker and the
+     * file on click): the fill says "you". A quiet footer like a turn's usage line
+     * (`⧉ ⏪ · 09:45`: Copy, Rewind, the time sent) fades in at its bottom-left on hover when
+     * the host handles transcript actions. The live-steering marker and the
      * agent's reaction are chips at the bottom-right, so a reaction landing
      * later updates the frame in place, even deep in scrollback.
      */

package/dist/types/chrome/countdown-timer.d.ts

@@ -8,8 +8,9 @@ export declare class CountdownTimer {
     constructor(timeoutMs: number, tui: TUI | undefined, onTick: (seconds: number) => void, onExpire: () => void);
     /**
      * The remaining time as a terminal-clocked `elapsed` node: its age is the
-     * negative remaining time (the start lies in the future), so it counts up
-     * toward zero and freezes there at expiry. The age is taken on the first
+     * negative remaining time (the start lies in the future), so it counts down
+     * to zero and holds there at expiry (no `stopped`: that would freeze it at
+     * zero from the start). The age is taken on the first
      * call after a (re)start, when the node is first written, and the node is
      * reused until {@link reset}.
      */

package/dist/types/native/backend.d.ts

@@ -47,10 +47,11 @@ export interface NativeBackendOptions {
 }
 /**
  * The reply a v1 terminal is assumed to give before its real `hello` arrives
- * (the `TERM_PROGRAM=tern` optimistic start): the whole vocabulary, the
- * default APC limit and credits, the terminal's width, the appearance omp
- * already detected, full motion, and `blobs`, so a resumed session's images
- * are asked about rather than resent before the reply comes.
+ * (the `TERM_PROGRAM=tern` optimistic start): the whole vocabulary except
+ * {@link UNASSUMED_KINDS}, the default APC limit and credits, the terminal's
+ * width, the appearance omp already detected, full motion, and `blobs`, so a
+ * resumed session's images are asked about rather than resent before the
+ * reply comes.
  */
 export declare function assumedTspHello(terminal: Terminal): TspHello;
 export declare class NativeBackend {

package/dist/types/native/blobs.d.ts

@@ -8,7 +8,7 @@
  * references it.
  */
 import type { TspProps } from "@oh-my-pi/pi-wire";
-import type { NativeNode } from "./node.js";
+import type { NativeChild, NativeNode } from "./node.js";
 export interface NativeBlob {
     readonly id: string;
     readonly mime: string;
@@ -31,3 +31,15 @@ export declare class NativeImageCache {
     #private;
     get(key: string, data: string, mimeType: string): NativeNode;
 }
+/** The disk file a tool result's image was read from (`read` details `mediaPath`), when it has one. */
+export declare function readMediaPath(details: unknown): string | undefined;
+/**
+ * A `media` node the host loads by path, capped at the inline image preview
+ * height. Callers check `cx.supports("media")` first.
+ */
+export declare function nativeMediaNode(path: string, key: string): NativeNode;
+/** Blob ids of the `image` nodes and paths of the `media` nodes under `children` (described nodes only). */
+export declare function shownMedia(children: readonly NativeChild[] | undefined): {
+    blobs: Set<string>;
+    paths: Set<string>;
+};

package/dist/types/overlays/annotation-overlay.d.ts

@@ -2,6 +2,7 @@ import { type Focusable, type TUI } from "../index.js";
 import { type KeybindingsManager } from "../app-keybindings.js";
 import { type Theme } from "../theme/theme.js";
 import type { CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
+import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type NativeNode, type NativeUiEvent } from "../native/node.js";
 export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
 export declare const PASTE_CODE_REVIEW_ACTION = "Paste annotations into prompt";
@@ -21,6 +22,12 @@ export interface TextReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
 }
 /** Splits a text source into the overlay's 1-based annotatable lines. */
 export declare function splitTextLines(text: string): string[];
+/** The native sheet: full-pane glass, titled by the review kind with what is under review after it. */
+interface NativeSheet {
+    readonly role: "omp.overlay.codeReview" | "omp.overlay.annotateText";
+    readonly size: "full";
+    readonly head: TspSpan[];
+}
 /** A fullscreen, annotated diff picker that only relies on public OMP APIs. */
 export declare class AnnotationOverlay implements Focusable {
     #private;
@@ -44,7 +51,19 @@ export declare class AnnotationOverlay implements Focusable {
      */
     replaceTextSource(text: string): number;
     handleInput(data: string): void;
+    /**
+     * The terminal draws the frame: a full-pane glass sheet titled `Code review`
+     * (or `Annotate text`), then what is under review as a quieter subtitle.
+     */
+    get nativeOverlay(): NativeSheet;
+    /**
+     * The sheet's body: the file rail (totals over the changed files) beside
+     * the current file's diff (text: its numbered lines), the note composer
+     * docked under the lines while a note is open, and a footer of key hints
+     * and the actions.
+     */
     describe(): NativeNode;
     handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }
+export {};

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

@@ -101,10 +101,15 @@ export declare class AskDialogComponent implements Component {
     render(width: number): readonly string[];
     /**
      * In the dock, in the composer's place and framed as the composer is: a
-     * `col` with the prompt editor's root role (`omp.editor`), so the terminal
-     * gives it the composer's insets and spacing. Not a modal `overlay` sheet:
-     * one anchored at the bottom covered the transcript rows that explain the
-     * question and blocked scrolling until the question was answered.
+     * `col` with an `omp.editor.*` root role (`omp.editor.ask`, collapsed
+     * `omp.editor.ask.hidden`), so the terminal draws the composer's shell
+     * around it. Not a modal `overlay` sheet: one anchored at the bottom
+     * covered the transcript rows that explain the question and blocked
+     * scrolling until the question was answered.
+     *
+     * Anatomy: the question tabs (several questions), the question, its
+     * answers as radio/check rows, and the action bar as the footer (the
+     * countdown, Hide, then Note, Skip and the primary Submit/Next).
      */
     describe(cx: DescribeContext): NativeNode;
     /**

package/dist/types/overlays/btw-history-panel.d.ts

@@ -40,12 +40,8 @@ export declare class BtwHistoryPanel implements Component, Focusable {
     /** Enhanced clipboard pastes belong only to the active composer. */
     pasteText(text: string): void;
     handleInput(data: string): void;
-    /** A large glass sheet titled "BTW history". */
-    readonly nativeOverlay: {
-        readonly role: "omp.overlay.btwHistory";
-        readonly size: "lg";
-        readonly head: "BTW history";
-    };
+    /** A large glass sheet (the list beside the reader), palette-sized while there is nothing to list. */
+    get nativeOverlay(): NonNullable<Component["nativeOverlay"]>;
     describe(): NativeNode;
     handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];

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

@@ -10,7 +10,7 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { type Focusable, type TUI } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
-import type { DescribeContext, NativeNode } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /**
  * `prefix` and `question` flattened onto one line, wrapped to the terminal's width and cut to
  * {@link MAX_PROMPT_TITLE_ROWS} rows (the last ends in `…` when cut). For terminal rendering only:
@@ -58,8 +58,13 @@ export declare class HookEditorComponent extends OverlayPanel implements Focusab
     /** Focus state mirrored to the nested editor during rendering. */
     focused: boolean;
     constructor(tui: TUI, title: string, prefill: string | undefined, onSubmit: (value: string, images?: ImageContent[]) => void, onCancel: () => void, options?: HookEditorOptions);
-    /** The editor (which describes itself) under the title and detail lines, with the key hints below. */
+    /**
+     * A sheet in the composer's place: the title (or, answering a question, the question under the
+     * prompt's name) over a hairline, the editor, and Open in editor · Cancel · Submit.
+     */
     describe(_cx: DescribeContext): NativeNode;
+    /** The action bar's buttons run what their keys run. */
+    handleNativeEvent(event: NativeUiEvent): void;
     /** Keep the nested editor's software/hardware cursor mode aligned with the dialog focus target. */
     setUseTerminalCursor(useTerminalCursor: boolean): void;
     /** Render the dialog after forwarding its focus state to the nested editor. */

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

@@ -1,9 +1,9 @@
 /**
- * Simple text input component for hooks.
+ * One-line text prompt an extension (hook) asks the user.
  */
 import { type TUI } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
-import type { DescribeContext, NativeNode } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 export interface HookInputOptions {
     tui?: TUI;
     timeout?: number;
@@ -11,13 +11,21 @@ export interface HookInputOptions {
 }
 export declare class HookInputComponent extends OverlayPanel {
     #private;
-    constructor(title: string, _placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: HookInputOptions);
+    constructor(title: string, placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: HookInputOptions);
     handleInput(keyData: string): void;
     /** Route non-bracketed paste transports (e.g. kitty's OSC 5522 enhanced clipboard)
      *  into the inner field, mirroring bracketed-paste semantics. Pasting counts as
      *  interaction, so the timeout countdown resets like any keystroke. */
     pasteText(text: string): void;
+    /** Submit and Cancel run what Enter and the interrupt key run. */
+    handleNativeEvent(event: NativeUiEvent): void;
     dispose(): void;
-    /** A card over the form, headed by the title plus the countdown `elapsed` while a timeout runs. */
+    /**
+     * A sheet in the composer's place, built like the extension editor's: the
+     * title's first line (the countdown at its end while a timeout runs) over
+     * any further lines as detail, the field written on the sheet (tinted, the
+     * reason under it, while a submit was refused), and Cancel · Submit, whose
+     * keys live in their tooltips.
+     */
     describe(_cx: DescribeContext): NativeNode;
 }