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

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 ## [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
+
+- Added cache-release hooks for TUI components and tool cards, allowing extensions to discard derived render data without rebuilding content ([#13632](https://github.com/can1357/oh-my-pi/pull/13632) by [@iliaal](https://github.com/iliaal)).
+
+### Changed
+
+- Subagent "Submit Result" cards now show the submitted result (its fields as a tree, or the report text), the section it fills, and why a submission was rejected, instead of only "Result submitted.".
+- Reduced memory held by retired transcript history in long sessions ([#13632](https://github.com/can1357/oh-my-pi/pull/13632) by [@iliaal](https://github.com/iliaal)).
+
+### Fixed
+
+- Reduced memory retained by discarded TSP images and previews ([#14336](https://github.com/can1357/oh-my-pi/pull/14336) by [@iliaal](https://github.com/iliaal)).
+- Fixed startup capability probes printing as text in the prompt (e.g. `25a1;stsp;q;{…}pppppp`) on terminals that cannot parse them, such as macOS Terminal.app.
+- Fixed the `/resume` picker flashing while a search runs over a large session history: background fuzzy matches now land in one update instead of reordering the list dozens of times per keystroke.
+
 ## [18.8.6] - 2026-10-08
 
 ### Changed
@@ -2960,82 +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
-
-## [0.42.5] - 2026-01-11
-
-### Fixed
-
-- Reduced flicker by only re-rendering changed lines ([#617](https://github.com/badlogic/pi-mono/pull/617) by [@ogulcancelik](https://github.com/ogulcancelik))
-- Cursor position tracking when content shrinks with unchanged remaining lines
-- TUI renders with wrong dimensions after suspend/resume if terminal was resized while suspended ([#599](https://github.com/badlogic/pi-mono/issues/599))
-- Pasted content containing Kitty key release patterns (e.g., `:3F` in MAC addresses) was incorrectly filtered out ([#623](https://github.com/badlogic/pi-mono/pull/623) by [@ogulcancelik](https://github.com/ogulcancelik))
-
-## [0.39.0] - 2026-01-08
-
-### Added
-
-- **Experimental:** Overlay compositing for `ctx.ui.custom()` with `{ overlay: true }` option ([#558](https://github.com/badlogic/pi-mono/pull/558) by [@nicobailon](https://github.com/nicobailon))
-
-Older entries are archived in [packages/tui/CHANGELOG.md@fa14205f838f](https://github.com/can1357/oh-my-pi/blob/fa14205f838f282fcea048c64fca74026789a492/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/README.md

@@ -66,14 +66,16 @@ interface Component {
 	render(width: number): readonly string[];
 	handleInput?(data: string): void;
 	invalidate?(): void;
+	releaseRenderCaches?(): void;
 }
 ```
 
-| Method               | Description                                                                                                                                                        |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `render(width)`      | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
-| `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                |
-| `invalidate?()`      | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                     |
+| Method                   | Description                                                                                                                                                        |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `render(width)`          | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
+| `handleInput?(data)`     | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                |
+| `invalidate?()`          | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                     |
+| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
 
 ## Built-in Components
 

package/dist/types/chat/assistant-message.d.ts

@@ -54,6 +54,7 @@ export declare class AssistantMessageComponent extends Container {
      */
     setServedModelMismatch(info: ServedModelMismatch | undefined): void;
     invalidate(): void;
+    releaseRenderCaches(): void;
     setHideThinkingBlock(hide: boolean): void;
     /**
      * Allow or withhold retiring finished lines into native scrollback while the

package/dist/types/chat/compaction-summary-message.d.ts

@@ -31,6 +31,7 @@ declare class SummaryMessageComponent implements Component {
     handleNativeEvent(event: NativeUiEvent): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     render(width: number): readonly string[];
 }

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/chat/user-message.d.ts

@@ -33,6 +33,7 @@ export declare function userBubbleColor(options?: UserBubbleOptions, tokenRegex?
 export declare class UserMessageComponent extends Container implements ReactionTarget {
     #private;
     constructor(text: string, options?: UserBubbleOptions);
+    releaseRenderCaches(): void;
     setReaction(emoji: string): void;
     /**
      * A head-less user-toned frame with the prompt as markdown under its
@@ -75,6 +76,7 @@ export declare class CollapsedSyntheticMessageComponent implements Component {
     handleNativeEvent(event: NativeUiEvent): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     render(width: number): readonly string[];
 }

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

@@ -30,6 +30,7 @@ export declare class Box implements Component {
     setBgFn(bgFn?: (text: string) => string): void;
     setBorder(border?: BoxBorder): void;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * A `card` when the box has a border or background: the background token
      * picks tone/role (user message, tool state, selection), a border colour

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

@@ -36,6 +36,7 @@ export declare class Disclosure implements Component {
     setExpanded(expanded: boolean): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     debugState(): Record<string, unknown>;
     get debugChildren(): readonly Component[];

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

@@ -227,6 +227,7 @@ export declare class Image implements Component {
     /** Return source metadata without exposing the encoded image buffer. */
     debugState(): Record<string, unknown>;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * A native `image` backed by a content-addressed blob; the terminal fits
      * it. Cell caps become `ch`/`lines` bounds. The inline-image budget and

package/dist/types/components/key-value-list.d.ts

@@ -21,6 +21,7 @@ export declare class KeyValueList implements Component {
     constructor(rows: readonly KeyValueRow[], options: KeyValueListOptions);
     setRows(rows: readonly KeyValueRow[]): boolean;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /** An aligned `kv` grid; label width and value wrapping are the terminal's. */
     describe(_cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];

package/dist/types/components/layout/row.d.ts

@@ -48,6 +48,7 @@ export declare class Row implements Component, MouseRoutable {
     setDecorations(prefix: LayoutDecoration | undefined, gap: LayoutDecoration | undefined, suffix: LayoutDecoration | undefined): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     /**
      * A flex `row`: each child sits in a slot carrying its width bounds

package/dist/types/components/layout/stack.d.ts

@@ -43,6 +43,7 @@ export declare class Stack implements Component, MouseRoutable {
     setHeight(height: number | undefined): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     /**
      * A `col` of slots carrying each child's height bounds (fixed → min = max

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

@@ -124,6 +124,7 @@ export declare class Markdown implements Component {
     debugState(): Record<string, unknown>;
     setText(text: string): boolean;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * The unrendered source as an `md` node, `stream` while the streaming
      * (transient) cache is on. Append-only growth yields a fresh node of the

package/dist/types/components/scroll-view.d.ts

@@ -92,6 +92,7 @@ export declare class ScrollView implements Component {
     /** Apply Arrow, Shift+Arrow, Page, Home, and End navigation keys. */
     handleScrollKey(data: string): boolean;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /** Permanently release a wrapped child's timers, subscriptions, and other resources. */
     dispose(): void;
     /**

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

@@ -15,6 +15,7 @@ export declare class Section implements Component {
     #private;
     constructor(options: SectionOptions);
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
     /** A `section` headed by the styled title; the rule is the terminal's. */
     describe(_cx: DescribeContext): NativeNode;

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

@@ -29,6 +29,7 @@ export declare class Table implements Component {
     constructor(rows: readonly (readonly TableCell[])[], columns: readonly TableColumn[], options?: TableOptions);
     setRows(rows: readonly (readonly TableCell[])[]): boolean;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * A native `table`. Column priorities carry over unchanged (lower gives
      * way first); truncating columns truncate at the end, the rest keep

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

@@ -26,6 +26,7 @@ export declare class Text implements Component {
      */
     setStyleFn(styleFn?: (text: string) => string): this;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * Wrapped text; styling re-derived from the styled source so a theme swap
      * re-resolves tokens. A background fill becomes the node's tone.

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

@@ -9,6 +9,7 @@ export declare class TruncatedText implements Component {
     /** Return bounded source text and the last-known truncation state. */
     debugState(): Record<string, unknown>;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /** First line only, clamped to one visual line with an end ellipsis. */
     describe(_cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];

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/native/blobs.d.ts

@@ -14,10 +14,12 @@ export interface NativeBlob {
     readonly mime: string;
     readonly bytes: Uint8Array;
 }
-/** Register `bytes` and return their content address (sha256 hex) for `image.p.blob`. */
+/** Register bytes for process-lifetime, id-only use. Prefer {@link nativeImageNode} for owned images. */
 export declare function registerNativeBlob(bytes: Uint8Array, mime: string): string;
 /** A registered blob by id. */
 export declare function getNativeBlob(id: string): NativeBlob | undefined;
+/** An image whose props own its bytes, including while hidden, unmounted, or awaiting upload. */
+export declare function nativeImageNode(bytes: Uint8Array, mime: string, p?: Omit<TspProps<"image">, "blob" | "builtin">, key?: string): NativeNode;
 /**
  * An `image` node for a base64 payload: the bytes are registered as a blob and
  * the pixel size probed from the header. Decoding and hashing cost real time,

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/session-selector.d.ts

@@ -71,7 +71,7 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     onExit: () => void;
     onToggleScope?: () => void;
     onDeleteRequest?: (session: T) => void;
-    /** Re-render hook for async list updates (fuzzy scan chunks, history merge). */
+    /** Re-render hook for async list updates (fuzzy scan completion, history merge). */
     onRequestRender?: () => void;
     constructor(sessions: T[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number, pinnedIds?: ReadonlySet<string>, currentSessionPath?: string | (() => string | undefined));
     /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */

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/render/output-pane.d.ts

@@ -92,6 +92,7 @@ export declare class OutputPane implements Component {
     describe(_cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];
     invalidate(): void;
+    releaseRenderCaches(): void;
 }
 /** Default styling for plain tool output while preserving existing ANSI. */
 export declare function styleToolOutputLine(line: string, theme: Theme): string;

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

@@ -298,6 +298,7 @@ export interface RenderedStringCache {
 export declare function createRenderedStringCache(): RenderedStringCache;
 /** Drop the memo so the next lookup re-renders (e.g. the render function identity changed). */
 export declare function invalidateRenderedStringCache(cache: RenderedStringCache): void;
+export declare function releaseRenderedStringCache(cache: RenderedStringCache): void;
 /** Reuse a rendered string while its theme, expansion, content, and salt match. */
 export declare function cachedRenderedString(cache: RenderedStringCache | undefined, theme: Theme, expanded: boolean, salt: string, content: string, render: () => string): string;
 /**

package/dist/types/render/tool-card.d.ts

@@ -46,6 +46,11 @@ export interface ToolCardOptions {
     paddingY?: number;
     ignoreTight?: boolean;
     onInvalidate?: () => void;
+    /**
+     * Drop builder-owned memos the next build recomputes. Called by
+     * {@link ToolCard.releaseRenderCaches}, which never calls `onInvalidate`.
+     */
+    onReleaseRenderCaches?: () => void;
     onDispose?: () => void;
 }
 /** Map transcript lifecycle terminology onto the output frame's visual states. */
@@ -71,6 +76,7 @@ export declare class ToolCard implements Component {
     handleInput(data: string): void;
     setIgnoreTight(ignore: boolean): void;
     invalidate(): void;
+    releaseRenderCaches(): void;
     dispose(): void;
 }
 /** Construct a lazy framed tool card. */

package/dist/types/render/width-aware-text.d.ts

@@ -20,6 +20,8 @@ export declare class WidthAwareText implements Component {
     setCustomBgFn(customBgFn?: (text: string) => string): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    /** The formatted text stays: the inner `Text` renders from it, so dropping it would free nothing. */
+    releaseRenderCaches(): void;
     /**
      * Re-run the formatter on the next render because its inputs changed.
      * Unlike {@link invalidate}, the inner `Text` keeps its wrap cache, so a

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/terminal.d.ts

@@ -128,13 +128,21 @@ export type TspHelloHandler = (hello: TspHello | null) => void;
 export type CursorShape = "default" | "block" | "underline" | "bar";
 export declare const CURSOR_SHAPE_CODES: Record<CursorShape, number>;
 export interface Terminal {
+    /**
+     * Start the terminal with input, resize, and host-disconnect handlers.
+     * Unless input is deferred, this sends capability probes; a terminal that
+     * cannot parse one may leave concealed bytes on the cursor row, so the
+     * caller repaints after starting.
+     */
     start(onInput: (data: string) => void, onResize: () => void, onDisconnect?: () => void, options?: TerminalStartOptions): void;
     /**
      * Take ownership of stdin after a `deferInput` start: enable raw mode,
      * attach input handlers, and run the capability probes start() skipped.
      * Bytes the user typed in cooked mode meanwhile are replayed through
-     * `onInput`. No-op when input was never deferred. Optional so custom
-     * Terminals built against older pi-tui versions keep working.
+     * `onInput`. No-op when input was never deferred. Like {@link start}, the
+     * probes may leave concealed bytes on the cursor row, so the caller
+     * repaints afterwards. Optional so custom Terminals built against older
+     * pi-tui versions keep working.
      */
     enableInput?(): void;
     stop(): void;