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

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## [Unreleased]
 
+## [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
@@ -2450,37 +2484,4 @@
 
 - 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@539f05ae39f8](https://github.com/can1357/oh-my-pi/blob/539f05ae39f81319dc75d650757dad3c76482343/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/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/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/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/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.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.12.6",
+	"version": "18.13.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.12.6",
-		"@oh-my-pi/pi-agent-core": "18.12.6",
-		"@oh-my-pi/pi-ai": "18.12.6",
-		"@oh-my-pi/pi-catalog": "18.12.6",
-		"@oh-my-pi/pi-natives": "18.12.6",
-		"@oh-my-pi/pi-utils": "18.12.6",
-		"@oh-my-pi/pi-wire": "18.12.6",
-		"@oh-my-pi/snapcompact": "18.12.6"
+		"@oh-my-pi/omptype": "18.13.0",
+		"@oh-my-pi/pi-agent-core": "18.13.0",
+		"@oh-my-pi/pi-ai": "18.13.0",
+		"@oh-my-pi/pi-catalog": "18.13.0",
+		"@oh-my-pi/pi-natives": "18.13.0",
+		"@oh-my-pi/pi-utils": "18.13.0",
+		"@oh-my-pi/pi-wire": "18.13.0",
+		"@oh-my-pi/snapcompact": "18.13.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/app-keybindings.ts

@@ -40,6 +40,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;
@@ -154,6 +155,10 @@ export const KEYBINDINGS = {
 		defaultKeys: "ctrl+g",
 		description: "Open external editor",
 	},
+	"app.local.open": {
+		defaultKeys: "alt+g",
+		description: "Open a local:// file in external editor",
+	},
 	"app.message.followUp": {
 		// Ctrl+Enter is preserved for terminals that deliver it (Kitty/iTerm2/WezTerm/Ghostty),
 		// but Windows Terminal does not emit a distinct event for Ctrl+Enter — Ctrl+Q is listed

package/src/chat/bash-execution.ts

@@ -253,7 +253,13 @@ export class BashExecutionComponent extends Container {
 	/** Switch to PTY rendering and feed raw terminal bytes through the vterm replay. */
 	appendPtyChunk(chunk: string): void {
 		if (this.#status !== "running" && !this.#ptyWriting && this.#ptyQueue.length === 0) return;
-		this.#ptyMode = true;
+		if (!this.#ptyMode) {
+			this.#ptyMode = true;
+			// The pane's `styleLine` reads `#ptyMode`, so its styled rows change
+			// the moment this flips — with the rows themselves unchanged. The pane
+			// memoizes its styled output, so it has to be told.
+			this.#outputPane.invalidate();
+		}
 		this.#ptyReplayFinalized = false;
 		this.#ptyQueue.push(chunk);
 		if (this.#ptyQueue.length > MAX_PTY_QUEUE_CHUNKS) {

package/src/chat/read-tool-group.ts

@@ -1,5 +1,4 @@
 import * as path from "node:path";
-import { pathToFileURL } from "node:url";
 import type { AssistantMessage, Usage } from "@oh-my-pi/pi-ai";
 import { type Component } from "../tui";
 import { Container } from "../tui";
@@ -876,7 +875,7 @@ export class ReadToolGroupComponent extends Container implements ToolExecutionHa
 		const linkPath = linkPathForTargets(row.targets);
 		const spans: TspSpan[] = [];
 		if (filePath) {
-			const href = linkPath && path.isAbsolute(linkPath) ? pathToFileURL(linkPath).href : undefined;
+			const href = linkPath ? fileHref(linkPath) : undefined;
 			spans.push(span(filePath, "path", href ? { href } : undefined));
 		} else {
 			spans.push(span("…", "toolOutput"));

package/src/chat/skill-message.ts

@@ -1,4 +1,3 @@
-import { pathToFileURL } from "node:url";
 import type { TextContent } from "@oh-my-pi/pi-ai";
 import { type Component } from "../tui";
 import { Box } from "../components/box";
@@ -10,6 +9,7 @@ import { Text } from "../components/text";
 import { getMarkdownTheme, theme } from "../theme";
 import type { CustomMessage, SkillPromptDetails } from "./messages";
 import { fileHyperlink } from "../render";
+import { tryFileUri } from "../render/hyperlink";
 import { collapseSkillTokens, skillChipLabel, skillChipStyle, skillToken } from "../prompt/composer-attachments";
 import { type UserBubbleOptions, UserMessageComponent, userBubbleColor } from "./user-message";
 import type { TspSpan } from "@oh-my-pi/pi-wire";
@@ -86,11 +86,7 @@ export class SkillMessageComponent extends Container {
 			const leading = display.startsWith(label) && /^\s*$/.test(display.charAt(label.length));
 			const draft = leading ? display.slice(label.length).trim() : display;
 			const head: TspSpan[] = [
-				span(
-					label,
-					"customMessageLabel strong",
-					details?.path ? { href: pathToFileURL(details.path).href } : undefined,
-				),
+				span(label, "customMessageLabel strong", details?.path ? { href: tryFileUri(details.path) } : undefined),
 			];
 			if (typeof details?.lineCount === "number") {
 				head.push(span(`  ${details.lineCount} ${details.lineCount === 1 ? "line" : "lines"}`, "muted"));