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

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 ## [Unreleased]
 
+## [18.13.1] - 2026-10-27
+
+### Added
+
+- ANSI and TSP `/pause` screens show unsettled turns and jobs, hide settled counters, and preserve counts and resume controls on short terminals ([#17073](https://github.com/can1357/oh-my-pi/pull/17073) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Added `noteOption` to `ExtensionAskDialogResultItem` and `QuestionResult`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+
+### Changed
+
+- `StatusLineComponent.setRunningSubagents()` and `setSubagentTreeCost()` now report whether their state changed, allowing callers to skip redundant redraws ([#17131](https://github.com/can1357/oh-my-pi/pull/17131) by [@iliaal](https://github.com/iliaal)).
+
+### Fixed
+
+- Fixed the ask dialog's Note (button or `n`) right after a pick moved to the next question annotating that question's highlighted row instead of the answer just picked ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+- Fixed the ask dialog's Next button reopening the custom-answer editor after Other was cancelled instead of moving on to the next question or Review tab
+
+## [18.13.0] - 2026-10-26
+
+### Breaking Changes
+
+- `CoordinationOp` no longer includes `"jobs"`, which no tool has produced since `wait` and `proc://` replaced the `hub` tool ([#16763](https://github.com/can1357/oh-my-pi/pull/16763) by [@will-bogusz](https://github.com/will-bogusz))
+- Fixed a table's last rows (such as its bottom border) going blank in scrollback when its SIXEL chart was drawn while the reply kept streaming, with the chart painted over them ([#16870](https://github.com/can1357/oh-my-pi/issues/16870))
+- Fixed Tern MCP tool cards showing only a clipped one-line summary of the arguments; the call and result cards now include a folded `Args` section with the full arguments ([#16765](https://github.com/can1357/oh-my-pi/issues/16765))
+- Fixed pasting an API key or redirect URL into the setup wizard's provider sign-in prompt silently doing nothing ([#16898](https://github.com/can1357/oh-my-pi/pull/16898) by [@camiloeferrera](https://github.com/camiloeferrera))
+- Fixed the usage dashboard averaging distinct quota buckets that share a label and window (Google Antigravity's Gemini and Gemini 4 Argon weeklies) into one row, which masked a drained bucket as "50% left"; buckets now group by quota identity, and shared Claude/GPT copies still merge ([#16790](https://github.com/can1357/oh-my-pi/issues/16790))
+
+### Added
+
+- Added `modelEnds` to `GroupedFileSection`: per file, the model-line index just past its last line, so a caller cutting the output can tell which files it shows whole ([#16594](https://github.com/can1357/oh-my-pi/pull/16594) by [@will-bogusz](https://github.com/will-bogusz))
+- Added an optional `title` to `BtwHistoryRecord` and a `title` option to `BtwPanelComponent`: the `/btw` panel, history list and thread show it as the topic heading in place of the question, so a side command reads as `/sitrep` instead of its expanded template ([#16815](https://github.com/can1357/oh-my-pi/pull/16815) by [@wolfiesch](https://github.com/wolfiesch))
+- Vim mode now supports `.` to repeat the last change, including the text typed in Insert or Replace mode, with Vim's count rules; `u` undoes a whole Insert session or `.` in one step ([#16872](https://github.com/can1357/oh-my-pi/pull/16872) by [@Shadorain](https://github.com/Shadorain))
+- Added the `app.local.open` keybinding (default `Alt+G`) and its keyboard shortcuts row ([#16873](https://github.com/can1357/oh-my-pi/pull/16873) by [@Shadorain](https://github.com/Shadorain))
+- Added `errorKind` to `EditToolDetails`, set on a failed edit ([#16608](https://github.com/can1357/oh-my-pi/pull/16608) by [@will-bogusz](https://github.com/will-bogusz))
+
+### Changed
+
+- Command and eval output panes no longer re-style and re-join their whole output on every frame, so a long command's output stops costing frame time while it sits in the transcript ([#16779](https://github.com/can1357/oh-my-pi/pull/16779) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+
+### Fixed
+
+- Fixed typo underlines changing when the cursor or selection splits a word ([#16821](https://github.com/can1357/oh-my-pi/issues/16821))
+- Fixed completed `vibe_wait` and `vibe_list` worker cards repeatedly entering scrollback as elapsed time advanced after partial retirement; completed walls now retain a static snapshot while in-flight waits continue updating.
+- Fixed resuming a session with a recorded tool-call path that cannot be turned into a link, which crashed the TUI while it rebuilt the context ([#16806](https://github.com/can1357/oh-my-pi/pull/16806) by [@laviRZ](https://github.com/laviRZ))
+- Fixed the Agent Hub reordering its rows on every heartbeat while the session's saved subagents loaded, so no row could be selected until the load ended: a row's place is now fixed when the hub first shows it, an agent the load finds takes its place in the status/recency ranking, and every other new generation goes on top ([#10524](https://github.com/can1357/oh-my-pi/issues/10524), [#16952](https://github.com/can1357/oh-my-pi/pull/16952) by [@lemonleks](https://github.com/lemonleks))
+- Fixed the BTW history follow-up composer refusing pasted images; it now attaches them as `[Image #N]` markers and sends the ones whose marker stays in the draft ([#16805](https://github.com/can1357/oh-my-pi/pull/16805) by [@lemonleks](https://github.com/lemonleks))
+- Fixed long URLs in fenced code blocks opening only their first visual line on ctrl/cmd-click; each wrapped fragment now carries the full OSC 8 hyperlink when the terminal supports it ([#16740](https://github.com/can1357/oh-my-pi/pull/16740) by [@OriginalByteMe](https://github.com/OriginalByteMe))
+- Fixed the newest inline charts and images at the bottom of the screen showing as text placeholders while older ones stayed rendered once a session (or a resumed one) holds more than `tui.maxInlineImages` images ([#16660](https://github.com/can1357/oh-my-pi/issues/16660))
+- Fixed Markdown tables in the terminal ignoring their column alignment, so right-aligned and centered columns rendered flush left ([#16658](https://github.com/can1357/oh-my-pi/pull/16658) by [@adi-IL](https://github.com/adi-IL))
+- Grep, Glob, Find, and AST Grep result headers wrap a long pattern instead of cutting it off, so the match/file counts and `truncated` warning stay visible ([#16635](https://github.com/can1357/oh-my-pi/issues/16635))
+
 ## [18.12.6] - 2026-10-21
 
 ### Changed
@@ -2419,68 +2469,4 @@
 
 - Fixed native Windows + Windows Terminal scrollback being yanked to the top when a streaming response triggered a TUI full redraw. Under ConPTY the `kernel32` `GetConsoleScreenBufferInfo` probe answers about the pseudo-console (always at the buffer tail) and not about WT's host scrollback, so `isNativeViewportAtBottom()` falsely returned `true` while the user was scrolled up and the shrink-across-viewport branch issued a destructive `historyRebuild` (`\x1b[2J\x1b[H\x1b[3J`). The probe now short-circuits to `undefined` whenever `WT_SESSION` is set, letting the existing deferred-rebuild path keep streaming-time mutations non-destructive and reconcile native history at the next prompt-submit checkpoint. ([#1635](https://github.com/can1357/oh-my-pi/issues/1635))
 
-## [15.7.3] - 2026-05-31
-
-### Added
-
-- Added `overflowSearch` to `SelectListLayoutOptions` to let consumers enable or disable type-to-filter search and search-status rendering per SelectList instance
-- Added fuzzy type-to-filter search to overflowing `SelectList` pickers, with search status and result counts.
-- Added `TUI.setEagerNativeScrollbackRebuild(enabled)` — while enabled, live render frames rebuild native scrollback on offscreen/structural changes even when the viewport position is unobservable (POSIX), instead of deferring to a non-destructive repaint. Trades the anti-yank guarantee for clean, duplicate-free history; intended for windows where output above the fold is actively re-laying out (e.g. a tool whose result is still streaming). A terminal that reports a known-scrolled viewport still defers.
-
-### Changed
-
-- Disabled interactive search filtering for editor autocomplete and slash-command `SelectList`s by passing `overflowSearch: false` in their layout options
-
-### Fixed
-
-- Preserved hidden tmux overlays in the live viewport by removing overlay content from view when an overlay was hidden while keeping pane history intact
-- Preserved native scrollback when forced TUI renders coalesce with content growth, and deferred pure tail appends while readers are scrolled into history.
-- Preserved existing terminal scrollback during forced and structural TUI renders so preexisting shell lines remained visible after component mutations
-- Rebuilt native scrollback for safe bottom-anchored offscreen edits and high-water preview collapses instead of repainting only the viewport, preventing stale or duplicated rows above the live viewport.
-- Stripped internal cursor marker sentinels from all rendered lines so offscreen focus markers no longer leak into terminal output
-- Truncated all painted lines to terminal width during viewport repaints and append-tail updates so long content no longer overflows or wraps unexpectedly
-- Fixed `tui.select.cancel` handling in `SelectList` so pressing Escape or Ctrl+C closes the list even when no matches are currently shown
-- Fixed native scrollback corruption when an offscreen row edit and repeated-tail append land in one render frame; ambiguous appended tails now rebuild history instead of splicing stale rows into the buffer.
-- Fixed scrolled-up readers being yanked back to the tail whenever streaming content arrived on POSIX terminals (macOS/Linux). Native viewport position is unobservable there (`isNativeViewportAtBottom()` returns `undefined`), and the planner optimistically treated "unknown" as "at bottom", so every offscreen streaming edit ran a destructive `historyRebuild` that cleared scrollback and snapped the view to the bottom. Live render frames now treat an unknown viewport as unsafe for a destructive rebuild — they defer to a non-destructive viewport repaint and reconcile native scrollback at the next explicit checkpoint (prompt submit). Resize and checkpoint replays keep the prior behavior.
-- Fixed native scrollback not rewrapping when the terminal widens on POSIX. A width increase reflows the transcript to fewer lines, which the shrink-across-boundary branch intercepted and (after the unknown-viewport deferral) repainted only the viewport — leaving committed history wrapped at the old width and duplicated above the live viewport. Width changes now rebuild native scrollback at the new geometry even when the viewport position is unknown (a yank is acceptable on an explicit resize); a terminal that can report a scrolled viewport still defers.
-
-## [15.7.0] - 2026-05-31
-
-### Fixed
-
-- Fixed slash-command autocomplete repainting when a Windows Terminal session cannot report native scrollback position; live input renders can now bypass the unknown-viewport deferral without weakening background scrollback protection. ([#1550](https://github.com/can1357/oh-my-pi/issues/1550))
-
-## [15.6.0] - 2026-05-30
-
-### Added
-
-- Added autocomplete triggering for internal URL scheme tokens such as `local://` and `skill://` while typing in the editor
-
-### Fixed
-
-- Fixed streaming output staying invisible in Windows Terminal + WSL2 until the window was minimized + restored. The 15.5.14 WSL branch of `requiresNativeViewportProofForReplay` treated an unknown native viewport state as "scrolled into history" — but `ProcessTerminal.isNativeViewportAtBottom` can only return a real answer through `kernel32.dll` FFI, which a Linux user-space process inside WSL cannot load, so the probe was permanently `undefined`. Every row-inserting structural mutation (each new streaming token row above the bottom-anchored prompt) was therefore classified as `deferredMutation` and emitted zero bytes. Any geometry change (resize/minimize/restore) bypassed the gate via a different render intent, which is why the output became visible only on window resize. The WSL clause is removed; on platforms where the probe cannot answer, unknown is treated as at-bottom (the pre-15.5.14 behaviour) so the live render path runs again. Native Win32 keeps the conservative "assume scrolled when unknown" heuristic since `kernel32` FFI does succeed there and unknown means the probe transiently failed. ([#1534](https://github.com/can1357/oh-my-pi/issues/1534))
-
-## [15.5.14] - 2026-05-29
-
-### Added
-
-- `Markdown` now renders a small color-chip swatch, painted with the referenced color, in front of CSS hex colors mentioned in prose, thinking traces, lists, tables, and blockquotes (e.g. `#C5FFD6` or `` `#C5FFD6` ``). The chip glyph comes from the theme's symbol set so it degrades across tiers (Nerd Font / Unicode `■` → ASCII `[]`) and is overridable via the `md.colorSwatch` symbol. Truecolor terminals get an exact 24-bit chip; others fall back to the nearest 256-color cell. Bare prose requires a hex letter for 3/4-digit forms so short issue/PR references (`#123`, `#1011`) don't sprout swatches; backticked codes are always treated as colors.
-
-### Fixed
-
-- Fixed the terminal hardware cursor disappearing in Ghostty. `resolveHardwareCursorPreference` force-hid the hardware cursor whenever it detected a Ghostty session (to fight bar-cursor afterimage "trails"), but the editor was simultaneously kept in terminal-cursor (marker-only) mode via `getUseTerminalCursorMarker()`, which renders no glyph and relies on the now-hidden hardware cursor — so Ghostty users had no visible caret at all, regardless of `PI_HARDWARE_CURSOR`. The Ghostty/`PI_FORCE_HARDWARE_CURSOR` override and the redundant `useTerminalCursorMarker` state are removed: `showHardwareCursor` is honored as-requested again (hardware cursor on by default), and disabling it cleanly falls back to the steady software-cursor glyph. The per-paint anti-trail mitigations (hide-cursor + autowrap-off inside the synchronized-output block) are retained, which is the actual trail fix.
-
-## [15.5.12] - 2026-05-29
-
-### Fixed
-
-- Fixed terminal resizes corrupting native scrollback with duplicated rows. The 15.4.0 change that defers a destructive scrollback clear+replay (so a user scrolled into history is not yanked while a streaming tail cell mutates) also caught genuine width/height resizes: a resize reflows the terminal's own committed scrollback at the new geometry, but repainting only the viewport left the stale old-size rows in history, so every overflowed row showed up twice (old-size wrap + new-size copy) when scrolling back, until the next prompt submit cleaned it up. `#planRender` now rebuilds history synchronously when the frame's geometry actually changed (`widthChanged || heightChanged`) via the restored `historyRebuild` intent, and defers the rebuild only for pure content mutations where the user may be reading scrollback mid-stream.
-
-## [15.5.0] - 2026-05-26
-
-### Fixed
-
-- Fixed `@` file mention autocomplete stalling for seconds when the query references something outside the project root (e.g. `@../`, `@~/`, `@/abs/`). `CombinedAutocompleteProvider` now short-circuits to plain immediate-directory prefix listing in those cases instead of dispatching a recursive `fuzzyFind` walk over a sibling directory full of unrelated projects. Inside-cwd queries keep the existing fuzzy-then-prefix behavior. ([#1395](https://github.com/can1357/oh-my-pi/issues/1395))
-- Gated the Hangul Compatibility Jamo width correction (U+3131..U+318E → 1 cell, originally landed in 15.0.1 for the IME / hardware-cursor displacement bug) behind `process.platform === "darwin"` in the TS path and `cfg!(target_os = "macos")` in the `pi-natives` Rust path. macOS terminals (Ghostty / Terminal.app / iTerm2) render jamo as 1 cell despite UAX#11 classifying them as Wide, but WezTerm and most Linux terminals honor UAX#11 and render them as 2 cells. The unconditional correction therefore desynced the TUI's column bookkeeping from the terminal's actual rendering off-darwin, producing corrupted layout and broken Korean input on Linux. On non-darwin the helpers now defer entirely to `Bun.stringWidth` / `UnicodeWidthStr` (also a small perf win on the multi-char-grapheme path). ([#1410](https://github.com/can1357/oh-my-pi/issues/1410))
-
-Older entries are archived in [packages/tui/CHANGELOG.md@ec051608a87a](https://github.com/can1357/oh-my-pi/blob/ec051608a87ad78d4930a46af7f5582192005ada/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@3d45d8557cd7](https://github.com/can1357/oh-my-pi/blob/3d45d8557cd7493221b69c7ed3c6b6a2307f46e7/packages/tui/CHANGELOG.md).

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

@@ -20,6 +20,7 @@ interface AppKeybindings {
     "app.ask.hide": true;
     "app.approval.approve": true;
     "app.editor.external": true;
+    "app.local.open": true;
     "app.message.followUp": true;
     "app.retry": true;
     "app.message.dequeue": true;
@@ -252,6 +253,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+g";
         readonly description: "Open external editor";
     };
+    readonly "app.local.open": {
+        readonly defaultKeys: "alt+g";
+        readonly description: "Open a local:// file in external editor";
+    };
     readonly "app.message.followUp": {
         readonly defaultKeys: ["ctrl+q", "ctrl+enter"];
         readonly description: "Send follow-up message";

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

@@ -31,6 +31,19 @@ export interface ImageOptions {
  * synchronously instead of committing its reserved blank rows.
  */
 export declare function renderForScrollback<T>(render: () => T): T;
+/**
+ * Run `render` to measure rows outside display order — a newest-first height
+ * walk, say. {@link ImageBudget} derives demotion from the order images are
+ * observed in, so a budgeted {@link Image} inside this scope claims no display
+ * slot: it replays the decision its slot in the surface's last full pass
+ * implies. `images` reports whether any budgeted image was observed; the caller
+ * MUST render every such block it lays out again, outside this scope and in
+ * display order, or its images keep no slot in the pass.
+ */
+export declare function measureRender<T>(render: () => T): {
+    value: T;
+    images: boolean;
+};
 /** Widest an {@link Image} rendered at `width` columns draws; callers sizing a raster for it (`SvgFigure`) match it. */
 export declare function imageMaxColumns(width: number): number;
 /** Default count of inline images kept as live graphics before older ones fall back to text. */
@@ -118,6 +131,11 @@ export declare class ImageBudget {
      * During a `stable` pass ({@link beginPass}) the call order and visible subset
      * are not authoritative, so the decision is the surface's committed
      * on-terminal split, keyed by id — order- and partiality-independent.
+     *
+     * Inside {@link measureRender} the call claims no slot: it answers what the
+     * image's slot in the last full pass implies under the planned threshold,
+     * which is what the display-order render that follows will decide once the
+     * split has converged.
      */
     observe(imageId: number): boolean;
     /**

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

@@ -75,6 +75,6 @@ export declare class Loader extends Text {
      * session title). Re-evaluated every paint; dropped when the row leaves
      * less than a two-cell gap. */
     setTrailer(trailer: (() => string | undefined) | undefined): void;
-    setMessage(message: string): void;
+    setMessage(message: string | (() => string)): void;
 }
 export {};

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

@@ -1,3 +1,12 @@
+/**
+ * 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 {

package/dist/types/overlays/agent-hub-projection.d.ts

@@ -44,5 +44,7 @@ export declare function aggregateMetrics<TRecord extends AgentRecordLike>(args:
     hasFallbackLiveSessions: boolean;
 };
 /** Parent-before-child projection preserving initial subtree rank and prepending new siblings. */
-export declare function projectAgentTree<TRecord extends AgentRecordLike>(refs: readonly TRecord[], rosterRank: ReadonlyMap<TRecord, number> | undefined): AgentTreeProjection<TRecord>;
+export declare function projectAgentTree<TRecord extends AgentRecordLike>(refs: readonly TRecord[], 
+/** Rows spawned while the hub is open; such a child never lifts its parent's group. */
+spawnedWhileOpen?: (ref: TRecord) => boolean): AgentTreeProjection<TRecord>;
 export {};

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

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

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

@@ -1,3 +1,4 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { type Component, type Focusable, Input } from "../index.js";
 import { type BtwHistoryRecord } from "./btw-history.js";
 import type { SpaceHoldHandler } from "../space-hold.js";
@@ -9,7 +10,11 @@ interface BtwHistoryPanelOptions {
     onCopy: (record: BtwHistoryRecord) => void;
     onCancel: (record: BtwHistoryRecord) => void;
     canFollowUp?: (record: BtwHistoryRecord) => boolean;
-    onFollowUp?: (record: BtwHistoryRecord, question: string, signal: AbortSignal) => Promise<boolean>;
+    onFollowUp?: (record: BtwHistoryRecord, question: string, signal: AbortSignal, images?: ImageContent[]) => Promise<boolean>;
+    /** Read a clipboard image into the follow-up (an empty paste, as terminals send for one). */
+    onPasteImage?: () => Promise<unknown>;
+    /** Attach an image file whose path was pasted or dropped into the follow-up. */
+    onPasteImagePath?: (path: string) => Promise<void>;
     /** Configured push-to-talk keys for a follow-up composer. */
     spaceHoldKeys?: readonly KeyId[];
     spaceHold?: (input: Input) => SpaceHoldHandler;
@@ -37,7 +42,16 @@ export declare class BtwHistoryPanel implements Component, Focusable {
     showRecord(recordId: string): void;
     /** Only an active follow-up composer can claim its configured push-to-talk keys. */
     capturesInput(data: string): boolean;
-    /** Enhanced clipboard pastes belong only to the active composer. */
+    /** False while a follow-up is sent: it already took its images, and the composer clears after. */
+    get acceptsImages(): boolean;
+    /** Attach an image to the follow-up; returns its `[Image #N, WxH]` marker to paste. */
+    attachImage(image: ImageContent, dims?: {
+        width: number;
+        height: number;
+    }): string | undefined;
+    /** Reserve ordered delivery for an image paste. Completion delivers its marker once, or releases on undefined. */
+    beginPaste(): (text: string | undefined) => boolean;
+    /** Enhanced clipboard pastes belong only to the active composer, behind any image still loading. */
     pasteText(text: string): void;
     handleInput(data: string): void;
     /** A large glass sheet (the list beside the reader), palette-sized while there is nothing to list. */

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

@@ -1,5 +1,8 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
 export interface BtwHistoryTurn {
     question: string;
+    /** Images attached to the question, sent again with it on later follow-ups. */
+    images?: readonly ImageContent[];
     answer: string;
     status: "running" | "complete" | "cancelled" | "error" | "interrupted";
     createdAt: number;
@@ -9,8 +12,12 @@ export interface BtwHistoryTurn {
 export interface BtwHistoryRecord extends BtwHistoryTurn {
     id: string;
     leafId: string | null;
+    /** Display heading for the topic, e.g. `/sitrep`; `question` keeps the full text sent to the model. */
+    title?: string;
     followUps?: readonly BtwHistoryTurn[];
 }
+/** The topic's display heading: its title, else the opening question. */
+export declare function getBtwTopicLabel(record: BtwHistoryRecord): string;
 export declare function getBtwLatestTurn(record: BtwHistoryRecord): BtwHistoryTurn;
 export declare function getBtwTurns(record: BtwHistoryRecord): readonly BtwHistoryTurn[];
 /** Copy the most recent nonblank answer, preserving its original whitespace. */

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

@@ -3,6 +3,8 @@ import { OverlayPanel } from "../chrome/overlay-box.js";
 import type { NativeNode } from "../native/node.js";
 interface BtwPanelComponentOptions {
     question: string;
+    /** Heading shown instead of `/btw <question>`, e.g. `/sitrep the migration` for a side command. */
+    title?: string;
     tui: TUI;
     canBranch?: () => boolean;
     canFollowUp?: () => boolean;

package/dist/types/overlays/mcp-add-wizard.d.ts

@@ -94,6 +94,8 @@ export declare class MCPAddWizard extends OverlayPanel {
      * arrows and pressing Enter; the footer's buttons run what their keys run.
      */
     handleNativeEvent(event: NativeUiEvent): void;
+    /** Route enhanced clipboard text into the active wizard field, never the hidden chat editor. */
+    pasteText(text: string): void;
     handleInput(keyData: string): void;
 }
 export {};

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

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

package/dist/types/prompt/macos-spelling.d.ts

@@ -31,8 +31,8 @@ export declare class MacOSSpellingProvider implements EditorTextAssistProvider {
     /**
      * Misspelled prose ranges in `text` (offsets into it), in order and
      * non-overlapping, except ones touching `context.typing` (the word still
-     * being typed). Schedules the verification check for uncached text; its
-     * result arrives through {@link onUpdate}.
+     * being typed). Checks the full logical line so rendering cuts cannot
+     * change spelling or prose boundaries. Uncached lines arrive through {@link onUpdate}.
      */
     typoRanges(text: string, context: SpellingDecorationContext): readonly native.SpellingRange[];
     /** Return the confident macOS correction after a completed prose word. */

package/dist/types/render/hyperlink.d.ts

@@ -1,5 +1,14 @@
 import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type TerminalId } from "../terminal-capabilities.js";
+/**
+ * A `file:` URL for `filePath`, or `undefined` when Node cannot encode it.
+ *
+ * Node rejects a malformed UNC target (a UNC path escaped twice by its author,
+ * e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
+ * A stored session keeps whatever a tool call recorded, so a transcript must
+ * render such a path without a link rather than throw while it rebuilds.
+ */
+export declare function tryFileUri(filePath: string): string | undefined;
 /**
  * Build the OSC 8 target for a file path on `terminalId`.
  *
@@ -15,11 +24,14 @@ import { type TerminalId } from "../terminal-capabilities.js";
  * `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
  * URI is right, with the location left in the visible text — terminals that
  * parse a `path:line:col` suffix resolve that on their own.
+ *
+ * Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
+ * target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
  */
 export declare function fileUriForTerminal(filePath: string, opts: {
     line?: number;
     col?: number;
-} | undefined, terminalId: TerminalId): string;
+} | undefined, terminalId: TerminalId): string | undefined;
 /**
  * Returns true when OSC 8 hyperlinks should be emitted.
  *
@@ -84,7 +96,8 @@ export declare function fileLinkSpan(filePath: string, displayText: string, s?:
  * Returns `displayText` unchanged when hyperlinks are disabled or when
  * the text already contains an OSC 8 sequence (prevents double-wrapping).
  * Relative paths resolve against the current working directory before URI
- * encoding so the OSC 8 target is always a valid `file://` URL.
+ * encoding so the OSC 8 target is always a valid `file://` URL. A path Node
+ * cannot encode renders as `displayText` with no link.
  *
  * @param filePath - Filesystem path
  * @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)

package/dist/types/render/output-pane.d.ts

@@ -1,5 +1,5 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
-import type { Theme } from "../theme/theme.js";
+import { type Theme } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 /** Which side of an output stream remains visible when the pane is capped. */
 export type OutputPaneEdge = "head" | "tail";

package/dist/types/render/render-utils.d.ts

@@ -5,7 +5,7 @@
  * tool renderers to ensure a unified TUI experience.
  */
 import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Ellipsis } from "@oh-my-pi/pi-natives";
+import { Ellipsis } from "@oh-my-pi/pi-natives";
 import type { Theme } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 export { Ellipsis } from "@oh-my-pi/pi-natives";
@@ -284,6 +284,12 @@ export declare function capParseErrors(errors: string[] | undefined, limit?: num
 export declare function createCachedComponent(getExpanded: () => boolean, compute: (width: number, expanded: boolean) => string[], options?: {
     paddingX?: number;
 }): Component;
+/**
+ * Fit a status header plus body rows to `width` for search-style results. The
+ * header soft-wraps so its trailing summary meta (counts, `truncated`) stays
+ * visible behind a long pattern; body rows keep single-row truncation.
+ */
+export declare function fitHeaderedRows(header: string, rows: readonly string[], width: number): string[];
 /**
  * Single-slot memo for an expensive rendered string (syntax highlighting, diff
  * coloring) keyed by the exact inputs that shape the bytes: theme instance,

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

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

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

@@ -342,6 +342,13 @@ export declare function parseKittyDirectPlacementLine(line: string): ParsedKitty
  * byte-identical between frames, so the diff never rewrites them.
  */
 export declare function directPlacementLift(line: string): number;
+/**
+ * Re-anchor an {@link Image} direct-placement line `lift` rows above its own
+ * row instead of its encoded `CUU(rows-1)`. The renderer lowers the lift when
+ * the block's top is clipped by the frame: the cursor-up would otherwise climb
+ * past the frame's first row into whatever the terminal shows above it.
+ */
+export declare function withDirectPlacementLift(line: string, lift: number): string;
 /**
  * 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/tools/ask.d.ts

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

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

@@ -51,8 +51,10 @@ export interface EditToolPerFileResult {
 }
 /** Diff, diagnostics, and snapshots returned by an edit. */
 export interface EditToolDetails {
-    /** Unified diff of the changes made */
+    /** Unified diff of the changes made; empty when the edit failed */
     diff: string;
+    /** Why the edit failed, as the engine classed it (`unseen_lines`, `stale_tag`, `parse`, …) */
+    errorKind?: string;
     /** Line number of the first change in the new file (for editor navigation) */
     firstChangedLine?: number;
     /** Diagnostic result (if available) */

package/dist/types/tools/grouped-file-output.d.ts

@@ -18,6 +18,8 @@ export interface GroupedFileSection {
 export interface GroupedFilesOutput {
     model: string[];
     display: string[];
+    /** Per file, the `model` index just past its last line: a head cut keeping `n` lines shows it whole when this is <= n. */
+    modelEnds: Map<string, number>;
 }
 /**
  * Render a list of files as a multi-level, prefix-folded directory tree shared by

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

@@ -22,12 +22,12 @@ export declare function renderMCPResult(result: {
     details?: MCPToolDetails;
     isError?: boolean;
 }, options: RenderResultOptions, theme: Theme, args?: Record<string, unknown>): Component;
-/** Native MCP call view: the head only, inline while pending. */
+/** Native MCP call view: the head plus the folded args, inline while pending. */
 export declare function describeMCPCall(args: Record<string, unknown>, label: string): NativeToolView;
 /**
  * Native MCP result view: JSON output as a JSON tree, Markdown when the
- * preference is on, otherwise the raw text as tool output. The head's args
- * summary stands in for the ANSI card's Args tree.
+ * preference is on, otherwise the raw text as tool output; the folded Args
+ * section follows, so the collapsed preview still leads with the output.
  */
 export declare function describeMCPResult(result: {
     content: Array<{

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

@@ -10,8 +10,8 @@ import type { NativeToolView, ToolRenderResult } from "./renderer.js";
 /** Whether a wait snapshot contains only running jobs and no cancellations. */
 export declare function isWaitingPollDetails(details: unknown): boolean;
 /** Coordination details retained by wait and background job operations. */
-export type CoordinationOp = "send" | "wait" | "jobs" | "cancel";
-/** Background-job row surfaced by `wait`/`cancel`/`jobs` results. */
+export type CoordinationOp = "send" | "wait" | "cancel";
+/** Background-job row surfaced by `wait`/`cancel` results and `proc://` listings. */
 export interface JobSnapshot {
     id: string;
     type: "bash" | "task" | "eval";
@@ -32,6 +32,14 @@ export interface JobSnapshot {
     completionPercent?: number;
     /** The task agent's latest stage in its own words; see `AgentProgress.stage`. */
     stage?: string;
+    /** Running task only: assistant requests so far; see `AgentProgress.requests`. */
+    requests?: number;
+    /** Running task only: cumulative cost in USD; see `AgentProgress.cost`. */
+    cost?: number;
+    /** Running task only: latest per-turn context size; see `AgentProgress.contextTokens`. */
+    contextTokens?: number;
+    /** Running task only: the model's context window; see `AgentProgress.contextWindow`. */
+    contextWindow?: number;
     /** The job's live widget, while one is being drawn; frozen at its last state once the job settles. */
     widget?: JobWidgetView;
     resultText?: string;

package/dist/types/vim.d.ts

@@ -64,13 +64,43 @@ export type VimCommand = {
     fromLine: number;
     toLine: number;
     out: boolean;
+} | {
+    kind: "retype";
+    record: VimInsertRecord;
+    times: number;
+    newline: boolean;
+    overwrite: boolean;
 };
+/** What an Insert/Replace session typed, relative to where it started; `.` replays it. */
+export interface VimInsertRecord {
+    /** Graphemes removed before the session's start cursor (Backspace past the insert point). */
+    deleteBefore: number;
+    /** Graphemes removed after it (forward delete). */
+    deleteAfter: number;
+    text: string;
+}
 /** Start offset of the grapheme after `col`, clamped to `text.length`. */
 export declare function nextGraphemeStart(text: string, col: number): number;
 /** Start offset of the grapheme before `col`, clamped to 0. */
 export declare function prevGraphemeStart(text: string, col: number): number;
 /** Offset of the final grapheme — where a Normal-mode cursor rests on a non-empty line. */
 export declare function lastGraphemeStart(text: string): number;
+export declare function countGraphemes(text: string): number;
+/** Offset `count` graphemes forward or backward from `offset`, clamped to the text. */
+export declare function stepGraphemes(text: string, offset: number, count: number, forward: boolean): number;
+/**
+ * What a session turned `before` into, anchored at its start `cursor`: the prefix match stops at the
+ * cursor and the suffix match never crosses it, so typing `aa` before an existing `a` records `aa`
+ * at the cursor rather than after the old one. Comparisons are whole graphemes, so a shared high
+ * surrogate cannot split an emoji into the replayed text.
+ */
+export declare function diffInsertSession(before: string, cursor: number, after: string): VimInsertRecord;
+/** Buffer flattened to one string plus the cursor's offset in it, so scans can cross lines. */
+export declare function flatten(buf: VimBuffer): {
+    text: string;
+    cursor: number;
+};
+export declare function offsetToPos(lines: readonly string[], offset: number): VimPosition;
 export declare class VimState {
     #private;
     mode: VimMode;
@@ -94,6 +124,15 @@ export declare class VimState {
      * through to its regular handling (and, for Escape in Normal mode, to the app's interrupt).
      */
     handleKey(key: string, buf: VimBuffer): VimCommand[] | null;
+    /**
+     * Attach what an Insert/Replace session typed to the change that opened it. After an arrow key
+     * split the session, Vim's redo becomes a plain insert of the text typed since.
+     */
+    recordInsert(record: VimInsertRecord, afterArrow: boolean): void;
+    /** Commit a staged change when the editor confirms text changed. */
+    commitChange(): void;
+    /** Discard a staged change when the command was a no-op (e.g. `J` on the last line). */
+    discardChange(): void;
 }
 /**
  * Normalized, end-exclusive span covered by a Visual selection.