@oh-my-pi/pi-tui 18.8.7 → 18.8.8

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 ## [Unreleased]
 
+## [18.8.8] - 2026-10-10
+
+### Breaking Changes
+
+- `ModelHubCallbacks.onCompactionPointChange` now receives a `confirmed` flag and returns a `CompactionPointChangeResult` (`{ kind: "error" }` or `{ kind: "confirm" }`) instead of an error string; a `confirm` result shows a warning that a second Enter on the same input accepts ([#15048](https://github.com/can1357/oh-my-pi/pull/15048) by [@H4vC](https://github.com/H4vC))
+- `ModelCompactionPoint.percent` is replaced by `basis`, a short explanation of why the model compacts there (`fixed`, `85% of 400K base`, `80% of window`) that the model hub preview shows next to the trigger ([#15065](https://github.com/can1357/oh-my-pi/pull/15065) by [@H4vC](https://github.com/H4vC))
+
+### Added
+
+- Added an `inline` option to `HookSelectorComponent` that keeps a selector in the composer slot in Tern instead of opening it as a sheet over the screen ([#15058](https://github.com/can1357/oh-my-pi/pull/15058) by [@H4vC](https://github.com/H4vC))
+- Added `ModelHubCallbacks.previewCompactionPoint`, whose line the compaction limit field shows while you type instead of the input syntax ([#15065](https://github.com/can1357/oh-my-pi/pull/15065) by [@H4vC](https://github.com/H4vC))
+- Added Vim find and till motions (`f`, `F`, `t`, `T`) in the prompt editor, with `;` and `,` to repeat them ([#15100](https://github.com/can1357/oh-my-pi/pull/15100) by [@Shadorain](https://github.com/Shadorain))
+- Added Vim replace (`r`, `R`) in the prompt editor ([#15100](https://github.com/can1357/oh-my-pi/pull/15100) by [@Shadorain](https://github.com/Shadorain))
+- Added Vim bracket and quote matching (`%`), paragraph motions (`{`, `}`), line join (`J`), and indent (`>>`, `<<`) in the prompt editor ([#15100](https://github.com/can1357/oh-my-pi/pull/15100) by [@Shadorain](https://github.com/Shadorain))
+- Added an external-editor key (Ctrl+G by default) to the annotation overlay for the note draft and, when the host provides `onExternalEditor`, the source being annotated; an edited text source is returned as `editedText` on the paste result ([#15151](https://github.com/can1357/oh-my-pi/pull/15151) by [@Shadorain](https://github.com/Shadorain))
+- Added `TUI.releaseHeldInput()`: on a terminal expected to speak TSP, a `deferInput` start now holds keystrokes (TSP events and the cell-size reply still apply; Ctrl+C/Ctrl+D release early) until the app calls it once its session is wired; such terminals also skip the sixel probe ([#15120](https://github.com/can1357/oh-my-pi/pull/15120) by [@H4vC](https://github.com/H4vC))
+- Added `TUI.replaceHeldFocus(previous, next)`, which `Composer.setEditor()` calls so a swapped-in editor inherits held startup keys; only keys for the start-time focus owner are now held, and a dialog that takes focus gets its input live ([#15122](https://github.com/can1357/oh-my-pi/pull/15122) by [@H4vC](https://github.com/H4vC))
+- Added `RenderResultOptions.elapsedMs` and `cancelled`, `NativeToolHead.command` and `NativeToolView.preview: "children"` for native describe hooks
+
+### Changed
+
+- Tern draws each bash run, eval cell and `!`/`$` run as one box: the command or code, its output, status lines and a foot with state, time and facts; images sit below the box and the bash head shows the intent instead of the command
+
+### Fixed
+
+- Fixed the Agents hub Time column rewinding and freezing for running subagents between progress updates ([#15140](https://github.com/can1357/oh-my-pi/pull/15140) by [@H4vC](https://github.com/H4vC))
+
 ## [18.8.7] - 2026-10-09
 
 ### Added
@@ -2977,67 +3004,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - Decode Kitty CSI-u printable sequences in the editor so shifted symbol keys (e.g., `@`, `?`) work in terminals that enable Kitty keyboard protocol ([#779](https://github.com/badlogic/pi-mono/pull/779) by [@iamd3vil](https://github.com/iamd3vil))
 
-## [0.47.0] - 2026-01-16
-
-### Breaking Changes
-
-- `Editor` constructor now requires `TUI` as first parameter: `new Editor(tui, theme)`. This enables automatic vertical scrolling when content exceeds terminal height. ([#732](https://github.com/badlogic/pi-mono/issues/732))
-
-### Added
-
-- Hardware cursor positioning for IME support in `Editor` and `Input` components. The terminal cursor now follows the text cursor position, enabling proper IME candidate window placement for CJK input. ([#719](https://github.com/badlogic/pi-mono/pull/719))
-- `Focusable` interface for components that need hardware cursor positioning. Implement `focused: boolean` and emit `CURSOR_MARKER` in render output when focused.
-- `CURSOR_MARKER` constant and `isFocusable()` type guard exported from the package
-- Editor now supports Page Up/Down keys (Fn+Up/Down on MacBook) for scrolling through large content ([#732](https://github.com/badlogic/pi-mono/issues/732))
-- Expanded keymap coverage for terminal compatibility: added support for Home/End keys in tmux, additional modifier combinations, and improved key sequence parsing ([#752](https://github.com/badlogic/pi-mono/pull/752) by [@richardgill](https://github.com/richardgill))
-
-### Fixed
-
-- Editor no longer corrupts terminal display when text exceeds screen height. Content now scrolls vertically with indicators showing lines above/below the viewport. Max height is 30% of terminal (minimum 5 lines). ([#732](https://github.com/badlogic/pi-mono/issues/732))
-- `visibleWidth()` and `extractAnsiCode()` now handle APC escape sequences (`ESC _ ... BEL`), fixing width calculation and string slicing for strings containing cursor markers
-- SelectList now handles multi-line descriptions by replacing newlines with spaces ([#728](https://github.com/badlogic/pi-mono/pull/728) by [@richardgill](https://github.com/richardgill))
-
-## [0.46.0] - 2026-01-15
-
-### Fixed
-
-- Keyboard shortcuts (Ctrl+C, Ctrl+D, etc.) now work on non-Latin keyboard layouts (Russian, Ukrainian, Bulgarian, etc.) in terminals supporting Kitty keyboard protocol with alternate key reporting ([#718](https://github.com/badlogic/pi-mono/pull/718) by [@dannote](https://github.com/dannote))
-
-## [0.45.6] - 2026-01-13
-
-### Added
-
-- `OverlayOptions` API for overlay positioning and sizing with CSS-like values: `width`, `maxHeight`, `row`, `col` accept numbers (absolute) or percentage strings (e.g., `"50%"`). Also supports `minWidth`, `anchor`, `offsetX`, `offsetY`, `margin`. ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-- `OverlayOptions.visible` callback for responsive overlays - receives terminal dimensions, return false to hide ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-- `showOverlay()` now returns `OverlayHandle` with `hide()`, `setHidden(boolean)`, `isHidden()` for programmatic visibility control ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-- New exported types: `OverlayAnchor`, `OverlayHandle`, `OverlayMargin`, `OverlayOptions`, `SizeValue` ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-- `truncateToWidth()` now accepts optional `pad` parameter to pad result with spaces to exactly `maxWidth` ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-
-### Fixed
-
-- Overlay compositing crash when rendered lines exceed terminal width due to complex ANSI/OSC sequences (e.g., hyperlinks in subagent output) ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
-
-## [0.44.0] - 2026-01-12
-
-### Added
-
-- `SettingsListOptions` with `enableSearch` for fuzzy filtering in `SettingsList` ([#643](https://github.com/badlogic/pi-mono/pull/643) by [@ninlds](https://github.com/ninlds))
-- `pageUp` and `pageDown` key support with `selectPageUp`/`selectPageDown` editor actions ([#662](https://github.com/badlogic/pi-mono/pull/662) by [@aliou](https://github.com/aliou))
-
-### Fixed
-
-- Numbered list items showing "1." for all items when code blocks break list continuity ([#660](https://github.com/badlogic/pi-mono/pull/660) by [@ogulcancelik](https://github.com/ogulcancelik))
-
-## [0.43.0] - 2026-01-11
-
-### Added
-
-- `fuzzyFilter()` and `fuzzyMatch()` utilities for fuzzy text matching
-- Slash command autocomplete now uses fuzzy matching instead of prefix matching
-
-### Fixed
-
-- Cursor now moves to end of content on exit, preventing status line from being overwritten ([#629](https://github.com/badlogic/pi-mono/pull/629) by [@tallshort](https://github.com/tallshort))
-- Reset ANSI styles after each rendered line to prevent style leakage
-
-Older entries are archived in [packages/tui/CHANGELOG.md@4787659281ba](https://github.com/can1357/oh-my-pi/blob/4787659281ba47f5a3707bbf5ee61742e9373c42/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@01e0b5c26e26](https://github.com/can1357/oh-my-pi/blob/01e0b5c26e267dff08c305f51d1ab56ec5a2f05d/packages/tui/CHANGELOG.md).

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

@@ -78,7 +78,7 @@ export interface ExecutionToolInput {
     /** Tool name for the head icon (`bash`, `eval`). */
     readonly name: string;
     readonly title: string;
-    /** The command / cell source, shown once in the head. */
+    /** The command / cell source: the run box's input and the head's Copy command. */
     readonly command: string;
     readonly lang: string;
     /** Excluded from context (`!!`/`$$`). */
@@ -96,10 +96,11 @@ export interface ExecutionToolInput {
     readonly artifactError?: OutputArtifactError;
 }
 /**
- * A user `!`/`$` run as the agent's `tool` frame (§6.6): the command in the
- * head with a `you` badge (plus `not sent` when excluded from context), the
- * timer, exit chip and cancelled note; the body is the output as an `ansi`
- * mini terminal following its tail, then one quiet truncation line.
+ * A user `!`/`$` run as the agent's `tool` frame (§6.6): a head with a `you`
+ * badge (plus `not sent` when excluded from context) and the command for Copy
+ * command; the body is one run box — the source, the output as an `ansi` mini
+ * terminal following its tail, and the foot (state, time, truncation) — with
+ * any images below it. Timer, exit chip and cancelled note stay head data.
  */
 export declare function describeExecutionTool(input: ExecutionToolInput): NativeNode;
 /**

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

@@ -1,3 +1,4 @@
+import type { KeyId } from "./app-keybindings.js";
 /**
  * Match the coding-agent interrupt key.
  *
@@ -18,6 +19,8 @@ export declare function matchesSelectDown(data: string): boolean;
 export declare function matchesSelectPageUp(data: string): boolean;
 /** Match the generic selector page-down keybinding. */
 export declare function matchesSelectPageDown(data: string): boolean;
+/** Effective external-editor key: the first bound key, or Ctrl+G when unbound. */
+export declare function appExternalEditorKey(): KeyId;
 /** Match the external-editor keybinding, falling back to Ctrl+G when unbound. */
 export declare function matchesAppExternalEditor(data: string): boolean;
 /**

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

@@ -10,6 +10,8 @@ export interface AnnotationOverlayCallbacks {
     onWarning?(message: string): void;
     /** Open the draft in the host's editor and invoke `commit` with its result. */
     onAnnotationExternalEditor?(draft: string, commit: (text: string | null) => void): void | Promise<void>;
+    /** Open the current source in the host's editor. The overlay stays open. */
+    onExternalEditor?(): void | Promise<void>;
 }
 export interface CodeReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
     onComplete(result: CodeReviewOverlayResult | undefined): void;
@@ -29,6 +31,16 @@ export declare class AnnotationOverlay implements Focusable {
     dispose(): void;
     getAnnotations(): CodeReviewAnnotation[];
     getTextAnnotations(): TextReviewAnnotation[];
+    /** Repo-relative path of the diff file under the cursor, if this is a code review. */
+    reviewFilePath(): string | undefined;
+    /** Current text-source bytes, including edits applied by {@link replaceTextSource}. */
+    textSourceText(): string | undefined;
+    /**
+     * Replace the text under review. Line notes whose quote still sits on the
+     * same row stay; a quote that moved to exactly one row is retargeted;
+     * every other line note is dropped. Returns how many were dropped.
+     */
+    replaceTextSource(text: string): number;
     handleInput(data: string): void;
     describe(): NativeNode;
     handleNativeEvent(event: NativeUiEvent): void;

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

@@ -81,4 +81,6 @@ export type TextReviewAnnotation = {
 export interface TextReviewOverlayResult {
     action: "paste";
     annotations: TextReviewAnnotation[];
+    /** Source text after an external-editor edit; absent when the source was not edited. */
+    editedText?: string;
 }

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

@@ -57,6 +57,10 @@ export interface HookSelectorOptions {
     /** Number of leading options (original order) that receive a selection
      *  marker. Defaults to every option when {@link selectionMarker} is set. */
     markableCount?: number;
+    /** Describe as a card in the dock (the composer slot) instead of a picker
+     *  sheet, so dock content above it (e.g. a `/omfg` candidate rule) stays
+     *  visible and the transcript stays scrollable on native surfaces. */
+    inline?: boolean;
 }
 export interface HookSelectorOption {
     label: string;
@@ -70,10 +74,11 @@ export declare class HookSelectorComponent extends OverlayPanel {
     render(width: number): readonly string[];
     dispose(): void;
     /**
-     * A plain option list is a picker sheet. Otherwise a card headed by the
-     * title (plus the countdown `elapsed` when a timeout runs), the extra title
-     * lines, the slider as `tabs`, the options as a `list` keyed by original
-     * option index, the search query while typing, and the key hints.
+     * A plain option list is a picker sheet. Otherwise (inline, slider, or
+     * countdown) a card headed by the title (plus the countdown `elapsed` when a
+     * timeout runs), the extra title lines, the slider as `tabs`, the options as
+     * a `list` keyed by original option index, the search query while typing,
+     * and the key hints.
      */
     describe(cx: DescribeContext): NativeNode;
     /** Pointer pick of an option does what highlighting it and pressing Enter does; a tab pick moves the slider. */

package/dist/types/overlays/model-browser.d.ts

@@ -41,8 +41,8 @@ export interface ResolvedModelRoleValue {
 export interface ModelCompactionPoint {
     /** Context tokens that trigger auto-compaction; undefined when auto-compaction is off or the window is unknown. */
     tokens: number | undefined;
-    /** The configured percentage of the window, when the trigger is percent-based. */
-    percent?: number;
+    /** Why it triggers there, in a few words: `fixed`, `85% of 400K base`, `80% of window`. */
+    basis?: string;
     /** What sets it: the matching `compaction.modelThresholds` key, `global`, or `default`. */
     source: string;
     /** The model's own exact entry as editable text (`90k`, `80%`); absent when it has none. */

package/dist/types/overlays/model-hub.d.ts

@@ -65,13 +65,30 @@ export interface ModelHubCallbacks {
     /** Persist a new quick-switch cycle order (the ctrl+p role cycle). */
     onCycleOrderChange?: (order: string[]) => void;
     /**
-     * Persist typed text as `model`'s own compaction point: a token count (`90000`,
-     * `90k`, `1M`), a percentage (`80%`), or empty to reset. Returns an error
-     * message for input it rejects, which keeps the field open.
+     * Persist typed text as `model`'s own compaction limit: a token base the
+     * policy scales (`400k`), a fixed trigger (`f400k`), a percentage (`80%`), or
+     * empty to reset. Rejected input returns `{ kind: "error" }`; input that
+     * needs acknowledgement (one that opens the extended window) returns
+     * `{ kind: "confirm" }` until called again with the same text and
+     * `confirmed`. Either keeps the field open.
      */
-    onCompactionPointChange?: (model: Model, input: string) => string | undefined;
+    onCompactionPointChange?: (model: Model, input: string, confirmed: boolean) => CompactionPointChangeResult | undefined;
+    /**
+     * One short line on where `model` would compact with the typed limit
+     * (`compacts at 340K · 85% of 400K base`), shown beside the field while
+     * typing; undefined for input that does not parse or fit.
+     */
+    previewCompactionPoint?: (model: Model, input: string) => string | undefined;
     onCancel: () => void;
 }
+/** Why {@link ModelHubCallbacks.onCompactionPointChange} kept the field open. */
+export type CompactionPointChangeResult = {
+    kind: "error";
+    message: string;
+} | {
+    kind: "confirm";
+    message: string;
+};
 export interface ModelHubOptions {
     /** Preselect this provider's sidebar entry (e.g. when reopening after /login). */
     initialProviderId?: string;

package/dist/types/overlays/session-observer-registry.d.ts

@@ -58,6 +58,8 @@ export interface ObservableSession {
     lastUpdate: number;
     /** Latest progress snapshot from the subagent executor */
     progress?: AgentProgress;
+    /** `Date.now()` when {@link progress} arrived; its `durationMs` was current then. */
+    progressAt?: number;
 }
 /** Coarse source of an observer change; callers use it to separate lifecycle work from high-frequency progress. */
 export type SessionObserverChangeKind = "main" | "reset" | "lifecycle" | "progress";

package/dist/types/overlays/usage-dashboard.d.ts

@@ -35,8 +35,10 @@ export interface ProviderCard {
     unavailableAccounts: string[];
     /** Window rows in provider-declared order (e.g. 5h → weekly → monthly); the fullest CARD_MAX_WINDOWS lead. */
     windows: CardWindowRow[];
-    /** True when every account reports no limits (e.g. enterprise plans). */
+    /** True when every account reports no limits (e.g. enterprise plans, providers without a quota API). */
     unlimited: boolean;
+    /** Distinct report notes across accounts (e.g. why a provider exposes no quota windows). */
+    notes: string[];
     /** True when nothing is used anywhere (or there are no limits): collapses to a tick. */
     idle: boolean;
     resetCredits?: {

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

@@ -112,7 +112,7 @@ export interface SegmentContext {
     } | null;
     /** Modal editing state, or null when `tui.vimMode` is off. */
     vim: {
-        mode: "insert" | "normal" | "visual" | "visual-line";
+        mode: "insert" | "normal" | "visual" | "visual-line" | "replace";
         /** Half-typed operator/count (`"2d"`), empty when nothing is pending. */
         pending: string;
         /** Lines spanned by the active Visual selection; 0 outside Visual modes. */

package/dist/types/theme/symbols.d.ts

@@ -2,7 +2,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
 export type SymbolMap = Record<SymbolKey, string>;
 /**
  * Icon vocabulary for slash-command autocomplete type indicators. Each name

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

@@ -95,7 +95,7 @@ export declare const evalToolRenderer: {
     }, options: RenderResultOptions & {
         renderContext?: EvalRenderContext;
     }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
-    describeCall(args: EvalRenderArgs, _options: RenderResultOptions): NativeToolView;
+    describeCall(args: EvalRenderArgs, options: RenderResultOptions): NativeToolView;
     describeResult(result: {
         content: Array<{
             type: string;

package/dist/types/tools/native-view.d.ts

@@ -72,6 +72,53 @@ export declare function truncationNotice(meta: OutputMeta | undefined): NativeNo
  * truncation / artifact-capture notice from `meta`; undefined when empty.
  */
 export declare function footnoteText(parts: readonly string[], meta?: OutputMeta): NativeNode | undefined;
+/** Drawn lines of a run's input (command, cell code) before its "N more lines" button. */
+export declare const RUN_INPUT_PREVIEW_LINES = 6;
+/**
+ * What a run's foot names: `running` (live clock), `background` (an async job
+ * outlives the call), and the settled outcomes. A failure with an exit code
+ * reads `exit N`; without one, `Failed`.
+ */
+export type RunState = "running" | "background" | "done" | "failed" | "cancelled" | "timed-out";
+/** Inputs of {@link runFoot}. */
+export interface RunFootInput {
+    readonly state: RunState;
+    /** Exit code of a `failed` run; a non-zero code names the state `exit N`. */
+    readonly exitCode?: number;
+    /** Milliseconds run so far (`running`) or in total; the time is omitted when undefined. */
+    readonly elapsedMs?: number;
+    /** Quiet facts (job id, service state, artifact), muted and ` · `-joined. */
+    readonly facts?: readonly string[];
+    /** Truncation / artifact-capture notices, appended to the facts in `warning`. */
+    readonly meta?: OutputMeta;
+}
+/**
+ * The foot line of a run box (`omp.run.foot`): the state word in its tone,
+ * the run time (a live clock while running, frozen once settled) and the
+ * quiet facts. Glyphs are the terminal's styling, never text.
+ */
+export declare function runFoot(input: RunFootInput): NativeNode;
+/** A run's input section: the command or cell source, clamped to {@link RUN_INPUT_PREVIEW_LINES}. */
+export declare function runInput(source: string, p: {
+    role: string;
+    lang: string;
+    wrap: boolean;
+}): NativeNode;
+/** A run's terminal output: follows its tail, clamped to the last `previewLines` lines while folded. */
+export declare function runOutput(output: string, p: {
+    role: string;
+    previewLines: number;
+    key?: string;
+}): NativeNode;
+/**
+ * One run as one box (`omp.run`): input, output, status lines and foot in
+ * order. `tone` tints the box: `error` for a failed run, `warning` for a
+ * timed-out one.
+ */
+export declare function runBox(children: readonly (NativeChild | undefined | false)[], p: {
+    key: string;
+    tone?: TspTone;
+}): NativeNode;
 /** A diagnostic's severity glyph: `x-circle` error, `warn` warning, `info`, `lightbulb` hint, in the severity tone. */
 export declare function diagnosticGlyph(severity: ParsedDiagnostic["severity"]): NativeNode;
 /**

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

@@ -25,6 +25,14 @@ export interface RenderResultOptions {
      * Streamed `xd://` previews stay queued until this is set.
      */
     executionStarted?: boolean;
+    /**
+     * Milliseconds since this call began executing (`tool_execution_start`),
+     * or its total once settled; undefined before it starts. Native describe
+     * hooks only.
+     */
+    elapsedMs?: number;
+    /** The call was abandoned without a final result (turn aborted, sealed). Native describe hooks only. */
+    cancelled?: boolean;
 }
 /** Render options for a result, plus the tool-specific context the transcript threads through. */
 export type RenderResultContextOptions = RenderResultOptions & {
@@ -85,6 +93,8 @@ export interface NativeToolHead {
     readonly targetKind?: TspToolProps["targetKind"];
     /** Language for `command` targets. */
     readonly lang?: string;
+    /** The raw command line the head's Copy command button copies (set implicitly by a `command` target). */
+    readonly command?: string;
     /** `file://` link for path targets. */
     readonly href?: string;
     /** Short facts after the target (`+8 −1`, `5 matches · 2 files`). */
@@ -111,10 +121,13 @@ export interface NativeToolView {
     readonly body?: readonly NativeChild[];
     /** Tone override; the frame otherwise derives it from the call status. */
     readonly tone?: TspTone;
-    /** Body clamp while collapsed; `{tail}` keeps the end (terminal output). Defaults to the transcript's preview size. */
+    /**
+     * Body clamp while collapsed; `{tail}` keeps the end (terminal output). Defaults to the transcript's preview size.
+     * `children`: the body stays whole while collapsed and its own `ansi`/`code` previews clamp instead.
+     */
     readonly preview?: TspPreview | {
         readonly tail: number;
-    } | "none";
+    } | "none" | "children";
     /** Starts expanded whatever the transcript's expand state (the todo checklist); the user can still fold it. */
     readonly open?: boolean;
     /** Render frameless (`frame:"inline"`): a head line plus a disclosed body. */

package/dist/types/tui.d.ts

@@ -78,6 +78,10 @@ export interface TUIStartOptions {
      * Paint without owning stdin: the terminal stays in cooked mode (kernel
      * echo + line editing at the hardware cursor) until {@link TUI.enableInput}
      * switches to raw input and replays the kernel-buffered keystrokes.
+     *
+     * A terminal expected to speak TSP needs raw input from the start, so it
+     * gets it; its keystrokes are held instead (TSP events and the cell-size
+     * reply still apply) until {@link TUI.releaseHeldInput} replays them.
      */
     deferInput?: boolean;
 }
@@ -469,6 +473,22 @@ export declare class TUI extends Container {
      * path. Idempotent; no-op when input was never deferred.
      */
     enableInput(): void;
+    /**
+     * Replay the keystrokes held since a TSP `deferInput` start through the
+     * normal input path, then deliver input live. Call once the app's key
+     * handlers are installed so a hotkey pressed during startup still fires.
+     * Only keys typed while the start-time focus owner had focus are held. The
+     * hold survives a stop/start until released. Idempotent; no-op when nothing
+     * is held.
+     */
+    releaseHeldInput(): void;
+    /**
+     * Hand held-key ownership from `previous` to `next` when the app replaces
+     * the component focused at start (a swapped-in custom editor), so keys
+     * typed into the replacement stay queued behind the held ones instead of
+     * overtaking them. No-op unless `previous` owns the held keys.
+     */
+    replaceHeldFocus(previous: Component, next: Component): void;
     addStartListener(listener: StartListener): () => void;
     addInputListener(listener: InputListener): () => void;
     removeInputListener(listener: InputListener): void;

package/dist/types/vim.d.ts

@@ -8,8 +8,8 @@
  * This is a usable subset of Vim, not a reimplementation of it (see issue #3299): Normal and Visual
  * modes, the common motions, and operators built from those motions.
  */
-export type VimMode = "insert" | "normal" | "visual" | "visual-line";
-export type VimOperator = "d" | "y" | "c";
+export type VimMode = "insert" | "normal" | "visual" | "visual-line" | "replace";
+export type VimOperator = "d" | "y" | "c" | ">" | "<";
 export interface VimPosition {
     line: number;
     col: number;
@@ -50,6 +50,20 @@ export type VimCommand = {
     count: number;
 } | {
     kind: "undo";
+} | {
+    kind: "replace";
+    from: VimPosition;
+    to: VimPosition;
+    text: string;
+} | {
+    kind: "join";
+    fromLine: number;
+    lines: number;
+} | {
+    kind: "indent";
+    fromLine: number;
+    toLine: number;
+    out: boolean;
 };
 /** Start offset of the grapheme after `col`, clamped to `text.length`. */
 export declare function nextGraphemeStart(text: string, col: number): number;
@@ -62,11 +76,11 @@ export declare class VimState {
     mode: VimMode;
     /** Fixed end of a Visual selection; the cursor is the moving end. */
     anchor: VimPosition | null;
-    /** True while a count, operator, `g`, or text-object prefix is half-typed — Escape cancels it. */
+    /** True while a count, operator, `g`, text-object, find, or `r` prefix is half-typed — Escape cancels it. */
     get pending(): boolean;
     /**
-     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`) — empty when
-     * nothing is pending. Hosts render this next to the mode so a partially entered operator is
+     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`, `"df"`, `"r"`) — empty
+     * when nothing is pending. Hosts render this next to the mode so a partially entered operator is
      * visible instead of silently swallowing the next keystroke.
      */
     get pendingText(): string;

package/package.json

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