@oh-my-pi/pi-tui 18.10.3 → 18.11.0

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 ## [Unreleased]
 
+## [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
+
+- Added `ApprovalDialogComponent` and the `app.approval.approve` keybinding (default `Ctrl+Enter`, `Ctrl+Q`) ([#15548](https://github.com/can1357/oh-my-pi/pull/15548) by [@H4vC](https://github.com/H4vC))
+- Plan review overlay can take a remote answer: it shows the remotely chosen execution tier and locks further input like a terminal approval ([#15552](https://github.com/can1357/oh-my-pi/pull/15552) by [@Shadorain](https://github.com/Shadorain))
+
+### Fixed
+
+- The model browser shows the price a model is billed at now, not the one current when its row was loaded: DeepSeek V4 Pro shows its $0.30 / $1.20 card in effect since 2026-09-14 instead of $1.32 / $3.96, and Gemini 4 Argon switches to $4 / $20 on 2026-12-01 ([#15620](https://github.com/can1357/oh-my-pi/pull/15620) by [@eggpeat](https://github.com/eggpeat))
+- Clicking Copy answer in the `/btw` history (and Copy raw in the raw SSE viewer) on native terminals copies the answer instead of the button's label ([#15547](https://github.com/can1357/oh-my-pi/pull/15547) by [@H4vC](https://github.com/H4vC))
+- Fixed image previews inside tmux showing as `SIXEL IMAGE (WxH)` placeholder text when the outer terminal lacks SIXEL; SIXEL is now enabled from tmux's DA1 reply only when tmux's terminal description for the attached client has `Sxl` ([#15513](https://github.com/can1357/oh-my-pi/issues/15513))
+
+### Removed
+
+- Removed `tools/eval-format/code-mode-declarations` (`generateCodeModeDeclarations`), which only served Codex Code Mode.
+
 ## [18.10.3] - 2026-10-12
 
 ### Changed
@@ -2641,145 +2679,4 @@
 
 - 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
-
-## [9.6.2] - 2026-02-01
-
-### Changed
-
-- Renamed `EllipsisKind` enum to `Ellipsis` for clearer API naming
-- Changed hardcoded ellipsis character from theme-configurable to literal "…" in editor truncation
-- Refactored `visibleWidth` function to use caching wrapper around new `visibleWidthRaw` implementation for improved performance
-
-### Removed
-
-- Removed `truncateToWidth`, `sliceWithWidth`, and `extractSegments` functions from public API (now re-exported directly from @oh-my-pi/pi-natives)
-- Removed `ellipsis` property from `SymbolTheme` interface
-- Removed `extractAnsiCode` function from public API
-
-## [9.6.1] - 2026-02-01
-
-### Changed
-
-- Improved performance of key ID parsing with optimized cache lookup strategy
-- Simplified `visibleWidth` calculation to use consistent Bun.stringWidth approach for all string lengths
-
-### Removed
-
-- Removed `visibleWidth` benchmark file in favor of Kitty sequence benchmarking
-
-## [9.5.0] - 2026-02-01
-
-### Changed
-
-- Improved fuzzy file search performance by using native implementation instead of spawning external process
-- Replaced external `fd` binary with native fuzzy path search for `@`-prefixed autocomplete
-
-## [9.4.0] - 2026-01-31
-
-### Added
-
-- Exported `padding` utility function for creating space-padded strings efficiently
-
-### Changed
-
-- Optimized padding operations across all components to use pre-allocated space buffer for better performance
-
-Older entries are archived in [packages/tui/CHANGELOG.md@e19bb3cb2344](https://github.com/can1357/oh-my-pi/blob/e19bb3cb2344a8953dc04aa398b810230f0e24c3/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@a66558815743](https://github.com/can1357/oh-my-pi/blob/a66558815743a61164ceebceb2bb528989fb09b3/packages/tui/CHANGELOG.md).

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

@@ -18,6 +18,7 @@ interface AppKeybindings {
     "app.tools.expand": true;
     "app.tools.toggleVisibility": true;
     "app.ask.hide": true;
+    "app.approval.approve": true;
     "app.editor.external": true;
     "app.message.followUp": true;
     "app.retry": true;
@@ -243,6 +244,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "alt+h";
         readonly description: "Hide or show a pending ask dialog";
     };
+    readonly "app.approval.approve": {
+        readonly defaultKeys: ["ctrl+enter", "ctrl+q"];
+        readonly description: "Approve a pending tool call";
+    };
     readonly "app.editor.external": {
         readonly defaultKeys: "ctrl+g";
         readonly description: "Open external editor";

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/chat/read-tool-group.d.ts

@@ -74,8 +74,8 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
      * The read run as one inline `tool` on terminals that list the kind, else
      * the fallback: a bare `card` (role `omp.tool.read`) with `Read <path>` or
      * `Read (N)` in the head, a `list` of path items (status tone, link,
-     * correction and conflict detail, nested usage) and, with content previews
-     * on, a `code` block per read clamped by the card's preview while collapsed.
+     * correction and conflict detail, nested usage) and a clamped preview per
+     * read when content previews are on.
      */
     describe(cx?: DescribeContext): NativeNode;
 }

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

@@ -2,6 +2,14 @@ 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;
 /** @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. */
@@ -36,3 +38,7 @@ export declare function matchesAppExternalEditor(data: string): boolean;
  * effective follow-up binding.
  */
 export declare function matchesAppFollowUp(data: string): boolean;
+/** Effective tool-approval keys: the `app.approval.approve` bindings, or Ctrl+Enter/Ctrl+Q when unbound. */
+export declare function appApproveKeys(): readonly KeyId[];
+/** Match the tool-approval key, recognizing modifier-tagged LF as Ctrl+Enter like {@link matchesAppFollowUp}. */
+export declare function matchesAppApprove(data: string): boolean;

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/overlays/approval-dialog.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Tool-approval prompt in the composer's place, presented like the ask
+ * dialog: the approval title and its details over an action bar. Approving
+ * takes a deliberate chord (`app.approval.approve`, Ctrl+Enter by default),
+ * 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. 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";
+/** The approve key is ignored this long after mount, so a follow-up sent as the prompt appears cannot approve it. */
+export declare const APPROVE_ARM_MS = 500;
+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;
+    /** 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. */
+    onTimeout?: () => void;
+    /** Called when the countdown starts, as the dialog mounts. */
+    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;
+    private readonly callbacks;
+    private readonly options;
+    /** `prompt`: the approval title on its first line, the details after it. */
+    constructor(prompt: string, callbacks: ApprovalDialogCallbacks, options?: ApprovalDialogOptions);
+    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 Details (with a full prompt),
+     * Deny, and the primary Approve, whose keys show in their tooltips.
+     */
+    describe(): NativeNode;
+    /** 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/plan-review-overlay.d.ts

@@ -86,6 +86,10 @@ export declare class PlanReviewOverlay implements Component {
      *  reset scroll/focus so the operator starts at the top. Does not emit
      *  `onPlanEdited` (the editor round-trip already persisted the file). */
     setPlanContent(planContent: string): void;
+    /** Synchronize an external tier pick with the displayed slider before committing. */
+    setSliderIndex(index: number): void;
+    /** Commit an external answer through the same input-locking path as Enter; false when nothing was committed. */
+    selectOption(label: string): boolean;
     handleInput(keyData: string): void;
     /** The native sheet: large glass, titled by the plan's own title heading (the body never repeats it). */
     get nativeOverlay(): NonNullable<Component["nativeOverlay"]>;

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;
 }

package/dist/types/render/hanging-wrap.d.ts

@@ -0,0 +1,5 @@
+import type { Theme } from "../theme/theme.js";
+/** Wrap content under a distinct first-row prefix, preserving its column on continuation rows. */
+export declare function wrapPrefixedLine(prefix: string, continuationPrefix: string, content: string, width: number): string[];
+/** Preserve a tree connector's ancestor guides while hanging a long node beneath its label. */
+export declare function wrapTreeLine(line: string, width: number, theme: Theme): string[] | undefined;

package/dist/types/terminal-capabilities.d.ts

@@ -327,6 +327,14 @@ export interface ParsedKittyPlacementLine {
  * callers fall back to writing the line verbatim.
  */
 export declare function parseKittyDirectPlacementLine(line: string): ParsedKittyPlacementLine | null;
+/**
+ * Rows above its own line that an {@link Image} direct-placement line paints
+ * over: the `CUU(rows-1)` of its lead-in, or 0 for any other line. The renderer
+ * erases those rows before a SIXEL/iTerm2 block is written again, because
+ * those protocols have no delete command and the block's reserved rows are
+ * byte-identical between frames, so the diff never rewrites them.
+ */
+export declare function directPlacementLift(line: string): number;
 /**
  * Rebuild an {@link Image} direct-placement line for the viewport row it is
  * written at. The component-rendered line encodes `CUU(rows-1)`, which clamps

package/dist/types/terminal-multiplexer.d.ts

@@ -38,6 +38,7 @@ declare const registry: readonly [{
         readonly passthrough: typeof import("./tmux.js").wrapTmuxPassthrough;
         readonly settleMs: 100;
     };
+    readonly gatesBracketedPaste: true;
     readonly expandsRepPadding: true;
     readonly expiresSynchronizedOutput: true;
     readonly altRestoreEndsSynchronizedOutput: true;

package/dist/types/tmux.d.ts

@@ -1,6 +1,14 @@
 export { wrapTmuxPassthrough } from "./multiplexers/tmux.js";
 /** Pass a control sequence through tmux, leaving direct-terminal output unchanged. */
 export declare function wrapTmuxPassthroughIfNeeded(payload: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * Emulator name candidates from a `#{client_termtype}<TAB>#{client_termname}`
+ * line, best first: the terminal-type reply (tmux 3.4+, XTVERSION), then the
+ * emulator the client's `TERM` names when it ships its own terminfo entry. Both
+ * are kept because the reply can name an unrecognized program (a nested tmux
+ * answers `tmux 3.4`) while `TERM` still identifies the emulator.
+ */
+export declare function tmuxClientProgramsFromReport(report: string): string[];
 /**
  * Whether the terminal hosting this tmux session draws TSP programs natively:
  * it sets the session user option `@tern-tsp` while it watches the session.
@@ -12,10 +20,28 @@ export declare function tmuxSessionSpeaksTsp(env?: NodeJS.ProcessEnv): boolean;
  */
 export declare function setTmuxPaneApcTitles(on: boolean, env?: NodeJS.ProcessEnv): void;
 /**
- * Resolve the terminal emulator name recorded for this tmux client.
+ * Resolve the terminal emulator names recorded for this tmux client, best first.
  *
  * tmux overwrites pane identity variables with its own values, but retains the
- * attached client's terminal-type reply in `#{client_termtype}`. The local IPC
- * query runs once per process and degrades to `null` when unavailable.
+ * attached client's terminal-type reply in `#{client_termtype}` and its `TERM`
+ * in `#{client_termname}` (see {@link tmuxClientProgramsFromReport}). The local
+ * IPC query runs once per process and degrades to `[]` when unavailable.
+ */
+export declare function resolveTmuxClientTerminalNames(env?: NodeJS.ProcessEnv): readonly string[];
+/**
+ * Whether tmux draws SIXEL to the client attached to this session: its
+ * effective terminal description for that client carries `Sxl`.
+ *
+ * A tmux built with SIXEL answers every pane's DA1 with attribute 4 and draws a
+ * `SIXEL IMAGE (WxH)` text placeholder for clients without SIXEL, so the pane's
+ * DA1 says nothing about the outer terminal. tmux itself renders SIXEL only
+ * when the client's terminal has `Sxl`, whether from terminfo,
+ * `terminal-overrides`, or the `sixel` feature (DA1 or `terminal-features`),
+ * and `show-messages -T` reports that merged description. The TUI consults
+ * this before trusting the pane's DA1 attribute. Queried once per tmux
+ * session; `false` outside tmux, with no attached client, or when the query
+ * fails. Nested tmux usually reports no `Sxl`: the inner client's terminal is
+ * the outer tmux, whose DA1 starts with level 1, which tmux does not parse
+ * for features.
  */
-export declare function resolveTmuxClientTerminalName(env?: NodeJS.ProcessEnv): string | null;
+export declare function tmuxClientRendersSixel(env?: NodeJS.ProcessEnv): boolean;

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

@@ -114,6 +114,13 @@ export declare function pendingFileLinkPath(inputPath: string): string;
  * image reads only record the path in `meta.source`). URL/internal sources are
  * not fs paths, so only `type: "path"` qualifies. */
 export declare function readSourceFsPath(details: ReadToolDetails | undefined): string | undefined;
+/**
+ * Whether a read result renders as a Markdown preview rather than numbered source:
+ * the read tool tagged it `text/markdown` (`read.renderMarkdown`, or a protocol
+ * resource) and the call did not ask for `:raw` source. Shared by the standalone
+ * read card and the read group's content previews so both honor the setting.
+ */
+export declare function readResultIsMarkdown(details: ReadToolDetails | undefined, args: ReadRenderArgs | undefined): boolean;
 /**
  * Read content as numbered `code` (no path header: the head names the file).
  * Numbers come from `lineNumbers` (`displayContent`'s per-line numbers,

package/package.json

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

package/src/app-keybindings.ts

@@ -38,6 +38,7 @@ interface AppKeybindings {
 	"app.tools.expand": true;
 	"app.tools.toggleVisibility": true;
 	"app.ask.hide": true;
+	"app.approval.approve": true;
 	"app.editor.external": true;
 	"app.message.followUp": true;
 	"app.retry": true;
@@ -143,6 +144,12 @@ export const KEYBINDINGS = {
 		defaultKeys: "alt+h",
 		description: "Hide or show a pending ask dialog",
 	},
+	"app.approval.approve": {
+		// A chord, not Enter: an Enter typed for the composer as the prompt appears must not approve.
+		// Ctrl+Q backs up Ctrl+Enter, which Windows Terminal cannot deliver (#1903).
+		defaultKeys: ["ctrl+enter", "ctrl+q"],
+		description: "Approve a pending tool call",
+	},
 	"app.editor.external": {
 		defaultKeys: "ctrl+g",
 		description: "Open external editor",

package/src/apps/debug/raw-sse.ts

@@ -245,7 +245,7 @@ export class RawSseViewerComponent implements Component {
 	/** The action bar's buttons run the same code as their keys. */
 	handleNativeEvent(event: NativeUiEvent): void {
 		if (event.type !== "action") return;
-		if (event.act === "copy") this.#copyAll();
+		if (event.act === "copy-raw") this.#copyAll();
 		else if (event.act === "close") this.#close();
 	}
 
@@ -305,7 +305,7 @@ export class RawSseViewerComponent implements Component {
 							"status",
 						),
 					actionBar([
-						actionButton("Copy raw", "copy", { keys: "ctrl+c", tone: "accent" }),
+						actionButton("Copy raw", "copy-raw", { keys: "ctrl+c", tone: "accent" }),
 						null,
 						actionButton("Close", "close", { keys: "escape" }),
 					]),