@oh-my-pi/pi-tui 18.10.4 → 18.11.1

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 ## [Unreleased]
 
+## [18.11.1] - 2026-10-15
+
+### Added
+
+- Added a tree layout to the background jobs sheet: subagents' jobs nest under the task job that runs them, busiest branches first, and Cancel appears only on the viewing agent's own jobs ([#15854](https://github.com/can1357/oh-my-pi/pull/15854) by [@H4vC](https://github.com/H4vC))
+
+### Fixed
+
+- Fixed transcript images not opening their file: image placeholders and native image nodes now link to the source file or a stored copy ([#15872](https://github.com/can1357/oh-my-pi/pull/15872) by [@H4vC](https://github.com/H4vC))
+- A collapsing live block no longer leaves its slack as a band of blank rows between the retired history and the live rows: the slack falls below the transcript, so a streamed reply stays contiguous and the input keeps the bottom row ([#15499](https://github.com/can1357/oh-my-pi/pull/15499) by [@iacore](https://github.com/iacore))
+- Fixed width-aware text on native (TSP) terminals truncating content two columns early ([#15806](https://github.com/can1357/oh-my-pi/pull/15806) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed Tab/right-arrow completion silently dismissing a selected `@"quoted path"` file suggestion when the path contains spaces ([#15698](https://github.com/can1357/oh-my-pi/pull/15698) by [@drawde-nadroj](https://github.com/drawde-nadroj))
+- Bracketed pastes are now capped by their UTF-8 size, so a large multibyte paste no longer buffers past the byte limit ([#15803](https://github.com/can1357/oh-my-pi/pull/15803) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed OSC 66 text-sized spans bypassing truncation when their UTF-16 length was short enough to fit the fast-path guard ([#15802](https://github.com/can1357/oh-my-pi/pull/15802) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Updated the `ast_grep` result view's truncated-match note to suggest `skip` pagination instead of the schema's nonexistent `increase limit` flag ([#15532](https://github.com/can1357/oh-my-pi/issues/15532), [#15543](https://github.com/can1357/oh-my-pi/pull/15543) by [@peda-cos](https://github.com/peda-cos)).
+- Fixed a streaming Edit preview with long wrapped lines growing past its row cap, because its tail was budgeted without the diff gutter its continuation rows hang under ([#15679](https://github.com/can1357/oh-my-pi/pull/15679))
+- Fixed malformed base64 padding being accepted for chat image attachments before native image decoding ([#15765](https://github.com/can1357/oh-my-pi/pull/15765) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Fixed Shift+Enter submitting and Ctrl+Enter inserting a newline in Windows Terminal 1.25–1.27 after closing any fullscreen view such as `/settings`; the terminal dropped omp's keyboard mode on leaving the alternate screen ([microsoft/terminal#20763](https://github.com/microsoft/terminal/issues/20763)), so omp now re-applies it ([#15868](https://github.com/can1357/oh-my-pi/pull/15868) by [@H4vC](https://github.com/H4vC)).
+- Long lines in native (Tern) `read`, `write`, and code-cell source now wrap instead of scrolling each block sideways ([#15823](https://github.com/can1357/oh-my-pi/issues/15823)).
+- Fixed long text pastes taking seconds to land in terminals that deliver a paste one key at a time, such as JetBrains' terminal on Windows; omp no longer writes to the terminal for every pasted key ([#15757](https://github.com/can1357/oh-my-pi/issues/15757))
+- Fixed Shift+Enter submitting the prompt and Ctrl+Enter inserting a newline in WSL under Windows Terminal 1.24 and earlier, conhost, and other ConPTY hosts without kitty keyboard support; Shift+Enter now inserts a newline and Ctrl+Enter sends a follow-up, as on native Windows.
+- Fixed streamed Markdown tables jumping around as each row arrives: the terminal UI fills the row being written in under the existing column widths, and native (TSP) terminals receive each row once its line is complete ([#15856](https://github.com/can1357/oh-my-pi/pull/15856) by [@H4vC](https://github.com/H4vC)).
+- Fixed streamed links and inline math showing raw `[text](url` or LaTeX and then rewrapping the paragraph when they close, in the terminal UI and native (TSP) terminals: they now render in their closed form while they stream ([#15864](https://github.com/can1357/oh-my-pi/pull/15864) by [@H4vC](https://github.com/H4vC)).
+- Paint-only overlays no longer swallow typing intended for the focused input beneath them ([#15793](https://github.com/can1357/oh-my-pi/issues/15793)).
+
+## [18.11.0] - 2026-10-14
+
+### Added
+
+- Added native composer microphone controls with visible starting, recording and transcription states; a start still loading its model can be cancelled, and Enter and Send wait while dictation is recording or transcribing into the draft ([#15759](https://github.com/can1357/oh-my-pi/pull/15759) by [@daaximus](https://github.com/daaximus)).
+- `ApprovalDialogComponent` takes a `draft` option that routes typing to the composer beneath it, so a message can be written while a tool call waits ([#15642](https://github.com/can1357/oh-my-pi/pull/15642) by [@H4vC](https://github.com/H4vC))
+- `ApprovalDialogComponent` takes a `fullPrompt` option that the expand key (`app.tools.expand`) or a Details button swaps in for the summarized prompt; it replaces `wrapDetails` ([#15642](https://github.com/can1357/oh-my-pi/pull/15642) by [@H4vC](https://github.com/H4vC))
+
+### Fixed
+
+- SVG fences in CRLF or CR-only assistant Markdown now render as figures instead of source code ([#15663](https://github.com/can1357/oh-my-pi/issues/15663)).
+- Fixed clipboard-image and image-path pastes being dropped while the composer draft is edited beneath an ask or approval dialog ([#15642](https://github.com/can1357/oh-my-pi/pull/15642) by [@H4vC](https://github.com/H4vC))
+- Fixed inline images inside tmux assuming Kitty graphics from the pane's `TERM`; the attached client is identified from tmux's terminal-type reply or its `TERM` (e.g. `xterm-kitty`), and unrecognized clients go to the SIXEL probe ([#15524](https://github.com/can1357/oh-my-pi/issues/15524)).
+- Fixed ```svg fences rendering as their source code instead of a drawing when no theme was installed yet, e.g. in an extension rendering a message that opens with the fence ([#15660](https://github.com/can1357/oh-my-pi/issues/15660))
+- Fixed pastes inside tmux 3.5a and older submitting line by line after another program turned bracketed paste off on the pane; omp now re-enables it on the next render or keypress ([#15596](https://github.com/can1357/oh-my-pi/issues/15596))
+- Fixed assistant replies containing a table (on image-capable terminals with table charts on) publishing still-streaming rows to native scrollback, which froze the block's append-only retirement and could leave overwritten reply rows in scrollback ([#15693](https://github.com/can1357/oh-my-pi/issues/15693))
+- Fixed streamed thinking publishing a line to native scrollback just before a code fence or `<!-- -->` sentinel split across deltas rewrote it with the prose-fold ellipsis ([#15693](https://github.com/can1357/oh-my-pi/issues/15693))
+- Fixed streamed assistant text or thinking containing a tab stopping all later rows of the reply from retiring into native scrollback until the turn ended ([#15693](https://github.com/can1357/oh-my-pi/issues/15693))
+- Fixed wrapped lines in Write, Read, Edit, Todo, Ask and LSP tool cards losing their alignment under line numbers, tree connectors, and option or code rails ([#15677](https://github.com/can1357/oh-my-pi/issues/15677))
+- Fixed SIXEL images leaving their previous raster on screen, drawn again over itself, when the transcript moves them within the viewport ([#15657](https://github.com/can1357/oh-my-pi/issues/15657))
+
 ## [18.10.4] - 2026-10-13
 
 ### Added
@@ -2622,139 +2668,4 @@
 - Added `cursorOverride` and `cursorOverrideWidth` properties to customize the end-of-text cursor glyph with ANSI-styled strings
 - Added `getUseTerminalCursor()` method to query the terminal cursor mode setting
 
-## [11.10.0] - 2026-02-10
-
-### Added
-
-- Added `hint` property to autocomplete items to display dim ghost text after cursor when item is selected
-- Added `getInlineHint()` method to `SlashCommand` interface for providing inline hint text based on argument state
-- Added `getInlineHint()` method to `AutocompleteProvider` interface for displaying dim ghost text after cursor
-- Added `hintStyle` theme option to customize styling of inline hint/ghost text in editor
-
-### Changed
-
-- Updated editor to render inline hint text as dim ghost text after cursor when autocomplete suggestions are active or provider supplies hints
-
-## [11.8.0] - 2026-02-10
-
-### Added
-
-- Added Alt+Y keybinding to cycle through kill ring entries (yank-pop)
-- Added undo support to Input component with Ctrl+Z keybinding
-- Added kill ring support to Input component for Emacs-style kill/yank operations
-- Added yank (Ctrl+Y) and yank-pop (Alt+Y) support to Input component
-
-### Changed
-
-- Changed Editor kill ring implementation to use dedicated KillRing class for better state management
-- Changed Editor undo stack to use generic UndoStack class with automatic state cloning
-- Changed kill/yank behavior to properly accumulate consecutive kill operations
-- Changed Input component deletion methods to record killed text in kill ring
-- Changed undo coalescing in Input component to group consecutive word typing into single undo units
-
-## [11.4.1] - 2026-02-06
-
-### Fixed
-
-- Fixed terminal scrolling when displaying overlays after rendering large content, preventing hundreds of blank lines from being output
-
-## [11.3.0] - 2026-02-06
-
-### Breaking Changes
-
-- Removed `getCursorPosition()` method from Component interface and implementations, eliminating hardware cursor positioning support
-
-### Added
-
-- Added sticky column behavior for vertical cursor movement, preserving target column when navigating through lines of varying lengths
-- Added `drainInput()` method to Terminal interface to prevent Kitty key release events from leaking to parent shell over slow SSH connections
-- Added `setClearOnShrink()` method to control whether full re-render occurs when content shrinks below working area
-- Added support for hidden paths (e.g., `.pi`, `.github`) in autocomplete while excluding `.git` directories
-
-### Changed
-
-- Changed default value of `PI_HARDWARE_CURSOR` environment variable from implicit true to explicit `"1"` for clarity
-- Changed default value of `PI_CLEAR_ON_SHRINK` environment variable from implicit false to explicit `"0"` for clarity
-- Changed TUI to clear screen on startup to prevent shell prompts and status messages from bleeding into the first rendered frame
-- Refactored full-render logic into reusable helper function to reduce code duplication across multiple render paths
-- Changed autocomplete to include hidden paths but filter out `.git` and its contents
-- Changed Input component to properly handle surrogate pairs in Unicode text, preventing cursor display corruption with emoji and multi-byte characters
-- Changed Editor to use `setCursorCol()` for all cursor column updates, enabling sticky column tracking
-- Changed Editor's vertical navigation to implement sticky column logic via `moveToVisualLine()` and `computeVerticalMoveColumn()`
-- Changed Editor's Enter key handling to extract submit logic into `submitValue()` method for better code organization
-- Changed SettingsList to truncate long lines to viewport width, preventing text overflow
-- Changed Terminal's `stop()` method to drain stdin before restoring raw mode, fixing race condition where Ctrl+D could close parent shell over SSH
-- Changed TUI rendering to add `clearOnShrink` option (controlled by `PI_CLEAR_ON_SHRINK` env var) for reducing redraws on slower terminals
-- Changed TUI rendering to detect when extra lines exceed viewport height and trigger full re-render instead of incremental updates
-
-### Fixed
-
-- Fixed rendering of extra blank lines when content shrinks by improving cursor positioning logic during line deletion
-- Fixed cursor display position in Input component when scrolling horizontally through long text
-- Fixed Kitty keyboard protocol disable sequence to use safe write method, preventing potential output buffering issues
-- Fixed unnecessary full-screen redraws when changes occur in out-of-view components (e.g., spinners), reducing terminal scroll events and improving performance on slower connections
-- Fixed scrollback clearing behavior to only clear screen instead of scrollback when resizing or shrinking content, preventing loss of terminal history
-- Fixed `.git` directory appearing in autocomplete suggestions when filtering by prefix
-- Fixed cursor position corruption in Input component when displaying text with emoji and combining characters
-- Fixed `.git` directory appearing in autocomplete suggestions
-- Fixed race condition where Kitty key release events could leak to parent shell after TUI exit over slow SSH connections
-- Fixed Editor's word movement (Ctrl+Left/Right) to properly reset sticky column for subsequent vertical navigation
-- Fixed Editor's undo operation to reset sticky column state when restoring cursor position
-- Fixed Editor's right arrow key at end of last line to set sticky column for subsequent up/down navigation
-- Fixed TUI rendering to correctly detect viewport changes and avoid false full-redraws after content shrinks
-- Fixed Kitty protocol key parsing to prefer codepoint over base layout for Latin letters and symbols, fixing keyboard layout issues (e.g., Dvorak)
-
-## [11.0.0] - 2026-02-05
-
-### Added
-
-- Introduced `terminal-capabilities.ts` module consolidating terminal detection and image protocol support
-- Added `TerminalInfo` class with methods for detecting image lines and formatting notifications
-- Added `NotifyProtocol` enum supporting Bell, OSC 99, and OSC 9 notification protocols
-- Added `isNotificationSuppressed()` function to check `OMP_NOTIFICATIONS` environment variable
-- Added `TERMINAL` constant providing detected terminal capabilities at runtime
-
-### Changed
-
-- Changed notification suppression environment variable from `OMP_NOTIFICATIONS` to `PI_NOTIFICATIONS`
-- Changed TUI write log environment variable from `OMP_TUI_WRITE_LOG` to `PI_TUI_WRITE_LOG`
-- Changed hardware cursor environment variable from `OMP_HARDWARE_CURSOR` to `PI_HARDWARE_CURSOR`
-- Updated environment variable access to use `getEnv()` utility function from `@oh-my-pi/pi-utils` for consistent handling
-- Renamed `TERMINAL_INFO` export to `TERMINAL` for clearer API semantics
-- Reorganized terminal image exports from `terminal-image` to `terminal-capabilities` module
-- Updated all internal references to use `TERMINAL` instead of `TERMINAL_INFO`
-
-### Removed
-
-- Removed `terminal-image` module exports from public API (functionality migrated to `terminal-capabilities`)
-
-## [10.5.0] - 2026-02-04
-
-### Fixed
-
-- Treated inline image lines with cursor-move prefixes as image sequences to prevent width overflow crashes
-
-## [9.8.0] - 2026-02-01
-
-### Changed
-
-- Moved `wrapTextWithAnsi` export to `@oh-my-pi/pi-natives` package
-
-### Fixed
-
-- Improved Kitty terminal key sequence parsing to correctly handle text field codepoints in CSI-u sequences
-- Fixed handling of private use Unicode codepoints (U+E000 to U+F8FF) in Kitty key decoding to prevent invalid character interpretation
-
-## [9.7.0] - 2026-02-01
-
-### Breaking Changes
-
-- Removed `Key` helper object from public API; use string literals like `"ctrl+c"` instead of `Key.ctrl("c")`
-- Removed `KeyEventType` export from public API
-
-### Changed
-
-- Migrated key parsing and matching logic to native implementation for improved performance
-- Simplified `isKeyRelease()` and `isKeyRepeat()` to use regex pattern matching instead of string inclusion checks
-
-Older entries are archived in [packages/tui/CHANGELOG.md@e6b8074bbe4b](https://github.com/can1357/oh-my-pi/blob/e6b8074bbe4b0d459aa812948822c2a634c8e62d/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@090e359aa972](https://github.com/can1357/oh-my-pi/blob/090e359aa97267de88bd365054685c8234843cd7/packages/tui/CHANGELOG.md).

package/dist/types/autocomplete.d.ts

@@ -6,6 +6,8 @@
  */
 export declare function findLeadingSlashCommandStart(text: string): number | null;
 export declare function findTrailingSlashCommandStart(text: string): number | null;
+/** Extract the live whitespace-delimited or double-quoted `@` file token ending at the cursor. */
+export declare function extractAtFilePrefix(text: string): string | null;
 /**
  * Whether an autocomplete value represents a directory: trailing slash or
  * backslash, optionally followed by a closing quote for quoted paths.

package/dist/types/chat/figure-markdown.d.ts

@@ -1,5 +1,5 @@
 import type { ImageBudget } from "../components/image.js";
-import type { Markdown } from "../components/markdown.js";
+import { type Markdown } from "../components/markdown.js";
 import { Container } from "../tui.js";
 export interface FigureMarkdownOptions {
     /** Markdown for one prose run (and a failed figure's code fallback); FigureMarkdown drives its transience. */
@@ -32,7 +32,12 @@ export declare class FigureMarkdown extends Container {
     /**
      * The trimmed prose ahead of the first figure, or "" when the block opens
      * with one. These are the only rows plain Markdown reproduces byte for
-     * byte, so they are all a transcript may publish ahead of the figure.
+     * byte, so they are all a transcript may publish ahead of the figure. While
+     * that prose is still the streaming tail (no figure follows it yet), only
+     * its settled prefix ({@link Markdown.getLastRenderStableText}) qualifies:
+     * the rest is still being written. Both forms are in
+     * {@link streamingMarkdownSource} form, so the settled prefix stays a byte
+     * prefix of the whole run once a figure splits it off.
      */
     get leadingProse(): string;
     /** Whether a figure's final source still waits for its raster, or a chart for its pick or raster. */

package/dist/types/components/image.d.ts

@@ -8,6 +8,8 @@ export interface ImageOptions {
     maxWidthCells?: number;
     maxHeightCells?: number;
     filename?: string;
+    /** File the image was read from; its link target. Images without one link to a blob copy of their bytes. */
+    sourcePath?: string;
     /** Shared budget that caps how many inline images render as live graphics. */
     budget?: ImageBudget;
     /**

package/dist/types/components/markdown.d.ts

@@ -2,6 +2,51 @@ import { type TokensList } from "@oh-my-pi/pi-utils/marked";
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
+/**
+ * `text` as the streaming renderer lexes it: OSC 8 terminators unified and
+ * tabs expanded. {@link Markdown.getLastRenderStableText} is a prefix of this
+ * form, not of the raw source, so append-only publishers that mix settled
+ * prefixes with whole blocks must compare both in this form. Rendering it is
+ * byte-identical to rendering `text`.
+ */
+export declare function streamingMarkdownSource(text: string): string;
+/**
+ * Streaming `md` source for a native terminal, minus a still-growing table row:
+ * the unterminated last line when a GFM table (a run of pipe lines holding a
+ * header and its delimiter row, outer pipes optional) sits right above it,
+ * outside any open code fence. GFM continues a table on any non-blank line, so
+ * that line is a row whatever it holds so far. The terminal sizes columns by
+ * every row it gets, so a half-streamed row (an unclosed link shows its whole
+ * URL) would rewrap the table each frame, and TSP cannot ask it to skip one.
+ * The result keeps the newline before the held line, so it is a prefix of
+ * `text` and of the result for every append to it: streaming stays
+ * append-only. Pass untrimmed source: trimming first drops the newline that
+ * marks the last row finished, so that row would be held too.
+ */
+export declare function holdPartialTableRow(text: string): string;
+/**
+ * `text`, one inline run whose end is still streaming, with a trailing open
+ * link or math span closed the way the finished text most likely closes it,
+ * or `undefined` when nothing at its end is open. A link gains its missing
+ * `)` (one per open parenthesis in its destination), so it renders as the
+ * link it becomes instead of literal brackets and URL. A math body is cut back
+ * to its last valid form (a half-typed command, dangling `^`/`_`, or the first
+ * `$` of a `$$` closer dropped, open braces closed) and closed, so the
+ * rendered math grows in place instead of raw LaTeX turning into symbols at
+ * the closer. A `$` body needs a LaTeX character, so a price (`$5 per`) is
+ * never speculated. Only prose is: escaped openers and anything inside a code
+ * span, closed or still being written, stay literal.
+ */
+export declare function speculativeInlineClose(text: string): string | undefined;
+/**
+ * Streaming `md` source for a native terminal with the open link or math span
+ * at its end speculatively closed ({@link speculativeInlineClose}), as the TUI
+ * renders it. Only the last block is read (a span cannot cross a blank line),
+ * and source inside an open code fence is left as it is. Each frame rewrites
+ * only the guessed closers at the end, which the reconciler sends as a small
+ * `splice`.
+ */
+export declare function speculativeStreamingSource(text: string): string;
 /** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
 /**

package/dist/types/components/text.d.ts

@@ -12,6 +12,8 @@ import type { Component } from "../tui.js";
 export declare class Text implements Component {
     #private;
     setIgnoreTight(ignore: boolean): this;
+    /** Override row wrapping when the source carries structural prefixes. */
+    setWrapLine(wrapLine: (line: string, width: number) => string[]): this;
     constructor(text?: string, paddingX?: number, paddingY?: number, customBgFn?: (text: string) => string);
     /** Return bounded text and layout state for debug inspection. */
     debugState(): Record<string, unknown>;

package/dist/types/keybinding-matchers.d.ts

@@ -9,6 +9,8 @@ import type { KeyId } from "./app-keybindings.js";
 export declare function matchesAppInterrupt(data: string): boolean;
 /** Match `app.tools.expand`, falling back to Ctrl+O when the action is unbound. */
 export declare function matchesAppToolsExpand(data: string): boolean;
+/** Effective tools-expand key: the first bound key, or Ctrl+O when unbound. */
+export declare function appToolsExpandKey(): KeyId;
 /** Match the generic selector cancel keybinding. */
 export declare function matchesSelectCancel(data: string): boolean;
 /** Match the generic selector up-navigation keybinding. */

package/dist/types/multiplexers/tmux.d.ts

@@ -22,6 +22,7 @@ export declare const tmuxMultiplexer: {
         readonly passthrough: typeof wrapTmuxPassthrough;
         readonly settleMs: 100;
     };
+    readonly gatesBracketedPaste: true;
     readonly expandsRepPadding: true;
     readonly expiresSynchronizedOutput: true;
     readonly altRestoreEndsSynchronizedOutput: true;

package/dist/types/multiplexers/types.d.ts

@@ -73,6 +73,12 @@ export interface TerminalMultiplexerModule<Id extends string = string> {
      * session, and an unrecognized report does not turn it off.
      */
     readonly honorsSynchronizedOutput?: boolean;
+    /**
+     * Tracks DEC 2004 per pane and forwards paste markers only while it is set,
+     * yet may leave DECRQM 2004 unanswered, so bracketed paste is reasserted
+     * without waiting for a DECRPM confirmation.
+     */
+    readonly gatesBracketedPaste?: boolean;
     /**
      * The session does not reveal whether its client renders graphics while
      * outer-terminal identity variables leak in, so images and Kitty

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

@@ -1,12 +1,3 @@
-/**
- * Content-addressed binary blobs (images) for `image` nodes.
- *
- * `describe()` registers the bytes and puts the returned id in `image.p.blob`;
- * the native backend delivers each referenced blob once per terminal
- * connection (asking the terminal first which it holds, or through its blob
- * cache), else uploads it with verb `b` before the frame that first
- * references it.
- */
 import type { TspProps } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode } from "./node.js";
 export interface NativeBlob {
@@ -26,10 +17,19 @@ export declare function nativeImageNode(bytes: Uint8Array, mime: string, p?: Omi
  * so callers cache the node per payload ({@link NativeImageCache}).
  */
 export declare function base64ImageNode(data: string, mimeType: string, p?: Omit<TspProps<"image">, "blob" | "builtin" | "w" | "h">, key?: string): NativeNode;
-/** `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload changes. */
+/**
+ * Props that make an `image` node open the file at `filePath` (as a `file://` URL, the TSP
+ * open-target form): a click zooms the image in the terminal, and the file opens from its
+ * context menu. Empty without a file.
+ */
+export declare function openableImageProps(filePath: string | undefined): Pick<TspProps<"image">, "href" | "actions">;
+/**
+ * `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload
+ * or the link policy changes. Each opens its file (`sourcePath`, else a blob copy).
+ */
 export declare class NativeImageCache {
     #private;
-    get(key: string, data: string, mimeType: string): NativeNode;
+    get(key: string, data: string, mimeType: string, sourcePath?: 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;

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

@@ -5,7 +5,11 @@
  * so an Enter typed for the composer as the prompt appears never approves a
  * call, and the chord itself only arms {@link APPROVE_ARM_MS} after mount: it
  * is also the follow-up key, pressed mid-run exactly when prompts appear.
- * Esc denies.
+ * Esc denies. With an {@link ApprovalDialogDraft}, every other key edits the
+ * composer mounted beneath the dialog, so a message can steer the turn while
+ * the call waits; an empty composer ignores Enter and arrows scroll the details.
+ * The prompt stays a few rows so the composer keeps its room; with a full
+ * prompt, the expand key (`app.tools.expand`) swaps it in, wrapped.
  */
 import { type Component, type TUI } from "../index.js";
 import type { NativeNode, NativeUiEvent } from "../native/node.js";
@@ -15,10 +19,16 @@ interface ApprovalDialogCallbacks {
     onApprove(): void;
     onDeny(): void;
 }
+/** The composer mounted beneath the dialog: it receives every key the dialog does not own. */
+export interface ApprovalDialogDraft {
+    /** True while the composer holds a draft — text, attachments, or a paste still landing: keys then edit and send it. */
+    hasDraft(): boolean;
+    handleInput(keyData: string): void;
+}
 interface ApprovalDialogOptions {
     tui?: TUI;
-    /** Wrap long details instead of clipping them to a row: set when the dialog is the only place they show. */
-    wrapDetails?: boolean;
+    /** The prompt with every detail in full, which the expand key swaps in (wrapped) for the summarized one. */
+    fullPrompt?: string;
     /** Deny once this many ms pass without input (any key restarts the countdown). */
     timeout?: number;
     /** Called when {@link timeout} expires, before the dialog denies. */
@@ -27,6 +37,8 @@ interface ApprovalDialogOptions {
     onTimeoutStart?: () => void;
     /** Called each time a key restarts the countdown. */
     onTimeoutReset?: () => void;
+    /** Route typing to the composer instead of dropping it. */
+    draft?: ApprovalDialogDraft;
 }
 export declare class ApprovalDialogComponent implements Component {
     #private;
@@ -37,15 +49,21 @@ export declare class ApprovalDialogComponent implements Component {
     invalidate(): void;
     dispose(): void;
     handleInput(keyData: string): void;
+    /**
+     * Swap the summarized prompt for every detail, wrapped, or back, as the expand key does here;
+     * for hosts that intercept that key first. Restarts the countdown like any key. False (nothing
+     * changes) without a full prompt, so the host's own expand handling (tool previews) can run.
+     */
+    toggleDetails(): boolean;
     render(width: number): readonly string[];
     /**
      * In the dock, in the composer's place and framed as the composer is (an
      * `omp.editor.*` root role), like the ask dialog, rather than a card over
-     * the transcript: the title, the details, then Deny and the primary
-     * Approve, whose keys show in their tooltips.
+     * the transcript: the title, the details, then Details (with a full prompt),
+     * Deny, and the primary Approve, whose keys show in their tooltips.
      */
     describe(): NativeNode;
-    /** Deny and Approve run exactly what Esc and the approve key run. */
+    /** Deny, Approve, and Details run exactly what Esc, the approve key, and the expand key run. */
     handleNativeEvent(event: NativeUiEvent): void;
 }
 export {};

package/dist/types/overlays/job-tree.d.ts

@@ -0,0 +1,50 @@
+import type { Theme } from "../theme/theme.js";
+/** What the tree reads off a job. */
+export interface JobTreeJob {
+    readonly id: string;
+    readonly status: "running" | "completed" | "failed" | "cancelled";
+    readonly startTime: number;
+    /** Registry id of the agent that owns the job; absent or the root id: a top-level job. */
+    readonly ownerId?: string;
+    /** Registry id of the subagent a task job runs: the job heads that agent's subtree. */
+    readonly agentId?: string;
+}
+/** A subagent in the tree, by registry id: an owner of listed jobs, or an ancestor linking one to the root. */
+export interface JobTreeAgent {
+    readonly id: string;
+    readonly parentId?: string;
+}
+/** Where a row sits: its depth and the rails drawn left of it. */
+export interface JobTreePlace {
+    /** 0 for the top level. */
+    readonly depth: number;
+    /** Per enclosing level below the top, whether that level's rail continues past this row. */
+    readonly rails: readonly boolean[];
+    /** Whether this row is the last of its siblings. */
+    readonly last: boolean;
+    /** Whether rows nest under this one. */
+    readonly parent: boolean;
+}
+/** One tree row: a job (a task job also heads its subagent), or a header for a subagent with no listed task job. */
+export type JobTreeRow<J extends JobTreeJob> = (JobTreePlace & {
+    readonly kind: "job";
+    readonly job: J;
+    readonly agent?: JobTreeAgent;
+}) | (JobTreePlace & {
+    readonly kind: "agent";
+    readonly agent: JobTreeAgent;
+});
+/**
+ * `jobs` as tree rows in display order. `rootId` is the viewing agent: its
+ * jobs, ownerless jobs and jobs of owners outside `agents` sit at the top
+ * level, as do agents whose parent is the root or unknown.
+ */
+export declare function buildJobTree<J extends JobTreeJob>(jobs: readonly J[], agents: readonly JobTreeAgent[], rootId: string | undefined): JobTreeRow<J>[];
+/** The connector drawn before a row's head: nothing at the top level, else rails then a branch. */
+export declare function jobTreeGuide(row: JobTreePlace, theme: Theme): string;
+/**
+ * The prefix of lines under a row's head (its label, a wrapped command): the
+ * rails that continue past it, then the rail down to its children or blank,
+ * two columns wide so a top-level leaf's lines indent by two.
+ */
+export declare function jobTreeIndent(row: JobTreePlace, theme: Theme): string;

package/dist/types/overlays/jobs-panel.d.ts

@@ -1,5 +1,6 @@
 import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import { type JobTreeAgent } from "./job-tree.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
     readonly id: string;
@@ -8,13 +9,19 @@ export interface JobsPanelJob {
     readonly label: string;
     readonly startTime: number;
     readonly endTime?: number;
+    /** Registry id of the agent that owns the job. */
+    readonly ownerId?: string;
     /** Registry id of the subagent a task job runs. */
     readonly agentId?: string;
 }
-/** Running and recently settled jobs. */
+/** Running and recently settled jobs of an agent and its subagents. */
 export interface JobsPanelSnapshot {
     readonly running: readonly JobsPanelJob[];
     readonly recent: readonly JobsPanelJob[];
+    /** The agent the sheet is for: its jobs sit at the top level, and only they can be cancelled. */
+    readonly rootId?: string;
+    /** Subagents owning listed jobs, with the ancestors linking them to the root. */
+    readonly agents?: readonly JobTreeAgent[];
 }
 /** What the sheet shows about the selected job beyond its row. */
 export interface JobsPanelDetail {
@@ -35,20 +42,26 @@ export interface JobsSheetSource {
     load(): JobsPanelSnapshot;
     /** The selected job's detail; runs once per frame, undefined once the job is gone. */
     inspect(id: string): JobsPanelDetail | undefined;
-    /** Cancel a running job. */
-    cancel(id: string): void;
+    /**
+     * Cancel a running job. Omitted by a read-only sheet (a focused subagent
+     * view, which only watches that agent): it lists the jobs and offers no way
+     * to stop them.
+     */
+    cancel?(id: string): void;
     /** Dismiss the sheet. */
     close(): void;
 }
 /**
  * The jobs pill's sheet: a centred `lg` glass sheet titled Background jobs.
- * A master–detail split (it stacks in a narrow pane): the selectable job list,
- * grouped Running / Recent, beside the selected job's detail — a status pill
- * with live elapsed and Cancel job, its command or task, facts (agent, cwd,
- * live pids, exit code, artifact) and a tail-following output pane. With no
- * jobs it shows an empty state. It re-reads the session every frame, so the
- * caller re-renders it on a timer while it is open. ↑/↓ select, X cancels the
- * selected running job, Esc or Close dismisses; nothing enters the transcript.
+ * A master–detail split (it stacks in a narrow pane): the selectable job tree
+ * beside the selected job's detail — a status pill with live elapsed and
+ * Cancel job, its command or task, facts (agent, cwd, live pids, exit code,
+ * artifact) and a tail-following output pane. With no jobs it shows an empty
+ * state. It re-reads the session every frame, so the caller re-renders it on
+ * a timer while it is open. ↑/↓ select, X cancels the selected running job,
+ * Esc or Close dismisses; nothing enters the transcript. A source without
+ * `cancel` renders read-only, and a subagent's job never offers Cancel: only
+ * the root's own jobs can be stopped here.
  */
 export declare class JobsSheet implements Component {
     #private;
@@ -60,7 +73,7 @@ export declare class JobsSheet implements Component {
     };
     constructor(source: JobsSheetSource);
     describe(_cx: DescribeContext): NativeNode;
-    /** Rows for a terminal without the native surface: one per job, then the selected job's facts and output tail. */
+    /** Rows for a terminal without the native surface: the job tree, then the selected job's facts and output tail. */
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput(data: string): void;

package/dist/types/prompt/custom-editor.d.ts

@@ -24,6 +24,8 @@ export interface ComposerNativeState {
     readonly rate?: number;
     /** A turn is running: the send keycap becomes a Stop button. */
     readonly running: boolean;
+    /** Native dictation control; undefined hides it for hosts without speech-to-text. */
+    readonly dictation?: "idle" | "starting" | "recording" | "transcribing";
     /** The viewed subagent's lineage, outermost first and the viewed agent last; undefined on the main session. */
     readonly viewing?: readonly string[];
     /** The session's title, quoted in italics as the TSP placeholder; undefined until it has one. */
@@ -220,7 +222,8 @@ export declare class CustomEditor extends Editor {
      *  once after construction (and again after `setEditorComponent` swaps the
      *  editor). Passing `undefined` clears any pending frame. */
     setShimmerRepaintHandler(handler: (() => void) | undefined): void;
-    /** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled. */
+    /** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled
+     *  and no dictation is still writing into the draft. */
     protected get nativeSendable(): boolean;
     /** Viewing a subagent, the draft goes to it: the placeholder names it; else the session's title, quoted in italics. */
     describePlaceholder: () => TspText;
@@ -238,17 +241,17 @@ export declare class CustomEditor extends Editor {
      * subagent is focused, the attachment chips, a `line` row of the
      * shell-mode chip and the input, and the `bar`: model chip, effort chip
      * (or the effort glyph as the model chip's icon), the generation rate,
-     * the other status facts, usage, then send (Stop while a turn runs).
-     * Clicks come back as `status.model`, `thinking.cycle`, `submit`,
-     * `interrupt` and `focus:<id>` actions.
+     * the other status facts, usage, dictation, then send (Stop while a turn runs).
+     * Clicks come back as `status.model`, `thinking.cycle`, `dictation.toggle`,
+     * `submit`, `interrupt` and `focus:<id>` actions.
      */
     describeLayout: (input: NativeNode, cx: DescribeContext) => NativeEditorLayout;
     /**
-     * Clicks on the composer's controls take the same paths as their keys: ⇧⇥,
-     * ⏎ and Esc; the viewing header's links (`focus:<id>`) go to the host,
-     * the status facts' clicks (`status.*`) to their source. Selection edits
-     * go to the buffer; `send` submits its own prompt after saving the old draft
-     * for recall and waiting for in-flight clipboard work.
+     * Dictation clicks go directly to the host, independent of keybindings.
+     * Other controls take the same paths as their keys; the viewing header's
+     * links (`focus:<id>`) go to the host, the status facts' clicks to their source.
+     * Selection edits go to the buffer; `send` submits its own prompt after
+     * saving the old draft for recall and waiting for in-flight clipboard work.
      */
     handleNativeEvent(event: NativeUiEvent): void;
     onEscape?: () => void;
@@ -275,6 +278,8 @@ export declare class CustomEditor extends Editor {
     onRetry?: () => void;
     /** Called when Caps Lock is pressed. */
     onCapsLock?: () => void;
+    /** Called directly by the native microphone/stop control, without synthesizing a keypress. */
+    onToggleDictation?: () => void;
     /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
     onLeftAtStart?: () => void;
     /** Called when the viewing header asks to view agent `id` ({@link MAIN_AGENT_ID}: the main session). */
@@ -296,6 +301,8 @@ export declare class CustomEditor extends Editor {
      * Clear all custom key handlers.
      */
     clearCustomKeyHandlers(): void;
+    /** True while a clipboard-image or image-path paste is still landing; later keys queue behind it. */
+    get pasteInFlight(): boolean;
     capturesInput(data: string): boolean;
     handleInput(data: string): void;
     /**
@@ -305,7 +312,8 @@ export declare class CustomEditor extends Editor {
      * an Ask dialog opened over a non-empty prompt — so finishing or submitting
      * the draft cannot fire an editor-slot shortcut that clears
      * `editorContainer` and orphans the overlay. Only text editing, cursor
-     * movement, submission, and the clear action reach the buffer.
+     * movement, submission, the clear action, and pastes (clipboard images and
+     * image paths attach as on the composer) reach the buffer.
      */
     handleDraftEdit(data: string): void;
 }