@oh-my-pi/pi-tui 18.14.2 → 18.16.0

package/CHANGELOG.md

@@ -2,6 +2,69 @@
 
 ## [Unreleased]
 
+## [18.16.0] - 2026-11-02
+
+### Breaking Changes
+
+- `buildExecutionFrame` sets its loader into the new `bottomBorder` itself, so callers no longer add it as a row and must dispose it; `buildStatusFooter` no longer takes `status` or `exitCode`, and `executionStatusLabel` returns a settled run's `exit N` / `cancelled` marker for that border ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- `SessionSelectorOptions.loadAllSessions` and `SessionPickerHost.loadAllSessions` resolve to a `SessionListing`, and `allSessions` takes one, so the all-projects scope can show preliminary rows before its complete listing
+- `Editor.prediction` is replaced by `Editor.predictions`, which returns every prediction for the next prompt, most likely first, and `Editor.onPredictionAccepted` receives the inserted prediction's index in that list ([#17796](https://github.com/can1357/oh-my-pi/pull/17796) by [@wolfiesch](https://github.com/wolfiesch))
+
+### Added
+
+- `SessionSelectorOptions.completeSessions` (and `SessionPickerOptions.completeSessions`) replaces the picker's preliminary rows with the complete listing once it settles, keeping the query, the selected session, and deletes/renames made meanwhile
+- `/btw` answers can show a steering prompt as a block behind a pink rail (a toned card in Tern) that `Alt+I` (`app.btw.inject`, remappable) sends to the main session; once sent it turns green with `➤` on each line, without moving ([#17618](https://github.com/can1357/oh-my-pi/pull/17618) by [@apullin](https://github.com/apullin))
+- Added `singleLine` and `finiteWidth` to `utils` for row-confined text and cell widths
+- `Loader.inlineText()` returns the current spinner frame and message as one styled line, and `DynamicBorder.setLabel()` sets a label (or a function re-read every render) into the rule ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Changed
+
+- The ASCII symbol preset's status glyphs are all three columns wide: success is `[+]`, error `[-]`, aborted `[#]` and pending `[ ]` (alongside `[~]` running, `[!]` warning and `[i]` info), and status spinners animate as `[|] [/] [-] [\]` ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Built-in renderers no longer use `status.done`, `theme.status.done` or the `done` value of `ToolUIStatus`; they remain as aliases of `status.success` / `success` (an explicit `symbols.overrides["status.done"]` still applies to `theme.status.done`) ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Every finished state shows the success glyph (`✔`, ASCII `[+]`). Task rows, verdicts and headers, background-job, launch and supervised-process rows, Eval cells, Vibe, Wait and process job rows, Yield and the generic tool card showed a separate `•` done dot, and a finished Read showed `●` (ASCII `[x]`). Live Task agent rows show the pending or running glyph, and a Task whose merge failed shows the warning glyph ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Edit and Write animate their streaming spinner in the card header, as Eval does, and show their `preview` / `streaming` label in the card's bottom border instead of on a row below the content; `streaming` ends once the content has fully arrived ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- `!` shell and `$` Python runs show their spinner, and then `exit N` or `cancelled`, in the frame's bottom border instead of on rows of their own; the spinner is the status spinner tool headers use ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- GitHub run-watch job rows use the shared status glyphs: a running job shows the running glyph instead of a warning-colored dot, a queued job the pending glyph instead of a hollow circle (a job in a state omp does not recognize keeps the circle), and a passed job's glyph is green like other success glyphs. Ask's multi-line custom answer lines up under its first line in every symbol preset ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Fixed
+
+- An LSP result other than diagnostics, such as a raw `request` response, that contains the error glyph (`✘`, ASCII `[-]`) is shown as a response instead of as diagnostics reading "No issues" with the rest of its lines dropped ([#17732](https://github.com/can1357/oh-my-pi/pull/17732) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- `Editor.onPredictionAccepted` and `Editor.onPredictionShown` report when Tab or Right inserts the rest of the composer prediction and when a frame paints it (at least one cell in the terminal, or the ghost on a native editor node) ([#17739](https://github.com/can1357/oh-my-pi/pull/17739) by [@wolfiesch](https://github.com/wolfiesch))
+- Added `OutputMeta.minimized` (bash minimizer filter, raw and minimized byte counts, raw-output artifact), shown as a `Minimized` fact on bash result cards ([#16586](https://github.com/can1357/oh-my-pi/pull/16586) by [@will-bogusz](https://github.com/will-bogusz))
+- Added `isColumnTruncationNotice` and `hasColumnTruncationClause` to `tools/output-meta`, matching the `[Some lines truncated to …]` clause that `formatOutputNotice` emits alone or inside a longer notice, and `LimitsMeta.columnTruncated.rawByteCap`, which makes that notice name the byte cap a `:raw` read of the first cut line stops at ([#16595](https://github.com/can1357/oh-my-pi/pull/16595) by [@will-bogusz](https://github.com/will-bogusz))
+- Fixed the model browser showing Factory Droid's undiscounted credit rate during a Factory promotion (2× instead of 1.6× for GPT-5.6 Sol); rows now show the rate in force and the model details show the next rate and its date ([#16309](https://github.com/can1357/oh-my-pi/pull/16309) by [@will-bogusz](https://github.com/will-bogusz))
+- With two or more `Editor.predictions`, the ghost text follows the first one the draft is a prefix of; a typed draft that equals a shorter one keeps the ghost of a longer one. Once the buffer equals one of them with no ghost (always right after Tab, Right, or the list inserts one), a dim `⇥ N more` hint appears; press Tab to list them all, then Enter, Tab or Right to swap the whole line (never submitting) or Esc to keep it ([#17796](https://github.com/can1357/oh-my-pi/pull/17796) by [@wolfiesch](https://github.com/wolfiesch))
+- F2 now opens the rename dialog in the resume picker in Ghostty, kitty and other terminals using the kitty keyboard protocol; F1 and F4 shortcuts work there too ([#17812](https://github.com/can1357/oh-my-pi/issues/17812)).
+- Added `Component.nativeTrailers()`, which lets a transcript block add native blocks of its own directly after it. Trailing blocks stay visible while the block is collapsed.
+
+## [18.15.0] - 2026-11-01
+
+### Breaking Changes
+
+- `GroupedLineContext.isUrl` is replaced by `url`, the internal URL a header names or a body row belongs to ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Added
+
+- Added `FILE_NAME_COLOR`, `formatStyledPath` and `pathNameStart` to `render/render-utils` for paths in tool bodies and Tern file rows; `createGroupedRowStyler`, `groupedLinkTargets`, `fitGroupsToBudget`, `groupsByFile` and `isMatchRow` to `tools/grouped-file-output`; `splitReadQuery` to `tools/read`; and `HASHLINE_TAG_SUFFIX_RE` to `tools/hashline-format`. `classifyGroupedLines` reports each file header's full `displayPath` and `suffix`, and a `TranscriptStatusPart` without `color` keeps its already-styled text ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- `JobsPanelJob.caption`: the jobs sheet's detail pane shows it, muted, between the job's purpose and its command (`omp.jobs.caption`) ([#17649](https://github.com/can1357/oh-my-pi/pull/17649) by [@wolfiesch](https://github.com/wolfiesch))
+
+### Changed
+
+- The Background jobs sheet names each job by what it is for when the model said so, shows that above the full command in the detail pane, and no longer repeats the command in an empty widget box for jobs that print nothing ([#17649](https://github.com/can1357/oh-my-pi/pull/17649) by [@wolfiesch](https://github.com/wolfiesch))
+- File paths in tool output share one style: a dim directory and the file name in the custom-message label color (bronze in titanium), with line locations and selectors (`:1-175`, `:42:14`, `?q=`) muted. This covers Grep, AST Grep, AST Edit, Glob, Find, LSP, diagnostics, grouped Reads and file mentions; Glob's folder icon is muted like the file-type icons, and paths in tool headers keep their color ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Grep, AST Grep and AST Edit results label each file with its full path instead of the model-facing `# dir/` and `## file#tag` headers, and each file gets its own tree branch. Their collapsed previews fit the same row budget the same way, cutting the last file short rather than overflowing, and end with `… N more matches` (`… N more files` for AST Edit) ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- AST Grep match rows link to their line, as Grep's do ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- LSP diagnostics carry their severity color on the `[error]`/`[warning]` tag instead of the location, and collapsed diagnostic rows now show that tag ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Fixed
+
+- Rex sessions now render Kitty graphics without forcing the protocol, including when only `TERM=xterm-rex` identifies the client ([#17651](https://github.com/can1357/oh-my-pi/issues/17651)).
+- Fixed collapsed AST Grep showing no matches when its first file or folder was taller than the preview, and its `… N more` row counting hidden folders instead of hidden matches ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed collapsed AST Edit overflowing its preview when the first file's diff was long ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed search and diagnostic file paths in Tern dropping the leading `/` of absolute paths and a folder's own `(…)` ending, and AST Edit diffs in Tern losing highlighting to the file's `#tag`; a file name ending in lowercase or other-length `#…` text keeps it ([#17608](https://github.com/can1357/oh-my-pi/pull/17608) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed a read of a URL drawing as dead text in the folded read row: its target is not a file path, so no link was built for it, and clicking the URL did nothing. The row (and each row of a grouped read) now links to the URL itself, gaining an `https://` scheme for a bare `www.` host ([#17598](https://github.com/can1357/oh-my-pi/pull/17598) by [@iacore](https://github.com/iacore))
+- Fixed replayed transcripts ignoring a registered `async-result` message renderer, so a replayed conversation rendered differently from the live one ([#17372](https://github.com/can1357/oh-my-pi/pull/17372) by [@AlexBrd999](https://github.com/AlexBrd999), from [#14484](https://github.com/can1357/oh-my-pi/pull/14484) by [@F0Rextasy](https://github.com/F0Rextasy); [#14131](https://github.com/can1357/oh-my-pi/issues/14131))
+
 ## [18.14.2] - 2026-10-31
 
 ### Added
@@ -2461,53 +2524,4 @@
 - Fixed hiding overlays during ED3-risk foreground streaming on unknown-viewport terminals leaving the overlay's transient rows in native scrollback. Overlay visibility reductions now bypass the streaming deferral path and rebuild once, so hidden dialog/notification sentinels are scrubbed immediately.
 - Fixed ED3-risk / unknown-viewport terminals (including WSL fronted by Windows Terminal) keeping the foreground-stream eager-rebuild mode active after the stream had already settled. A later scrolled content shrink or resize-with-append could then bypass the anti-yank deferral and repaint from stale geometry, jumping the viewport or replaying the wrong rows. The eager opt-in now drops immediately when no teardown render is pending, and the one-frame post-checkpoint suffix-suppression path no longer overrides geometry reflow handling.
 
-## [15.9.2] - 2026-06-05
-
-### Changed
-
-- Changed foreground-stream rendering on ED3-risk terminals (Ghostty/kitty/Alacritty/VTE/iTerm2 on POSIX) to defer native-scrollback commits for unpinned transient frames: while a turn streams, generic frames repaint only the viewport and suppress `\r\n` scroll growth, so transient output (spinner ticks, partial lines, status rows) never pollutes terminal history. Components that report a `NativeScrollbackLiveRegion` still commit newly sealed prefix rows while keeping the active suffix dirty for checkpoint replay. Native scrollback is reconciled in a single ED3 (`CSI 3 J`) + re-emit at the next checkpoint (prompt submit) or on an explicit user-input/IME opt-in; an erase is never emitted mid-stream under a possibly-scrolled reader. Non-ED3-risk terminals keep their eager live rebuild. ([#1895](https://github.com/can1357/oh-my-pi/pull/1895))
-
-### Fixed
-
-- Fixed ED3-risk foreground streaming dropping sealed transcript rows above the live block until the next prompt-submit checkpoint, which made scrollback beyond the viewport appear duplicated or out of order. The renderer restores native-scrollback live-region pinning so newly sealed rows are appended once while active live rows remain deferred.
-- Fixed inline images (added in 15.9) rendering as a wall of empty PUA box glyphs and producing laggy scrolling on Kitty-protocol terminals that do not implement Unicode placeholders — most notably WezTerm (per upstream wezterm/wezterm#986, placeholder support is still unchecked) and the tmux/screen `getFallbackImageProtocol` path that forces Kitty mode even on non-supporting outer terminals (Terminal.app, etc.). `unicodePlaceholders` now defaults on only for `kitty` and `ghostty`; everything else falls back to direct `a=p,i=…,p=…` placement, which those paths already render correctly. `PI_NO_KITTY_PLACEHOLDERS=1` is still honored as a hard opt-out, and a new `PI_KITTY_PLACEHOLDERS=1` opts in on otherwise-unsupported terminals (e.g. a wezterm nightly that has merged placeholder support) ([#1877](https://github.com/can1357/oh-my-pi/issues/1877)).
-
-## [15.9.1] - 2026-06-04
-
-### Fixed
-
-- Fixed the OSC 11 appearance poll re-querying every 2s forever on terminals that support Mode 2031 but never change theme, whose repeated OSC 11/DA1 writes cleared the user's active text selection (breaking copy every 2 seconds). The poll now stops as soon as DECRQM confirms Mode 2031 support, since push notifications make polling redundant.
-
-## [15.9.0] - 2026-06-04
-
-### Added
-
-- Added Kitty `CSI 22 J` screen-to-scrollback clears for non-destructive full paints, while keeping ED3 for destructive history/session rebuilds.
-- Added Kitty OSC 99 rich notification formatting and startup capability probing.
-- Added Kitty OSC 66 text-sized Markdown H1 headings (2x scale) plus native text-width support for OSC 66 spans. Off by default and gated to Kitty (the only terminal implementing OSC 66) via the `TERMINAL.textSizing` capability; hosts enable it through `setTextSizing`.
-- Added Kitty Unicode placeholder image rendering (`U=1` + U+10EEEE with explicit row/column diacritics): inline images are drawn as real text cells that carry the image id in their foreground color, so they survive horizontal slicing, reflow, and overlapping draws instead of relying on cursor-positioned `a=p` placements. Enabled by default on Kitty-family terminals; opt out with `PI_NO_KITTY_PLACEHOLDERS=1`, and falls back to direct placement when a grid exceeds the diacritic table's addressable range.
-- Added Kitty temp-file image transmission (`t=t`): on local sessions, decoded PNG bytes are written to a `tty-graphics-protocol` temp file and the path is sent instead of in-band base64, gated behind a startup `a=q,t=t` support probe. Controlled by `PI_KITTY_IMAGE_TRANSMISSION=direct|temp-file|auto`; disabled over SSH unless explicitly forced.
-- Added DECRQM capability detection for DEC private modes 2026 (synchronized output) and 2048 (in-band resize). Synchronized-output paint wrappers are dropped when the terminal reports 2026 unsupported (preserving the `PI_NO_SYNC_OUTPUT` override), and DEC 2048 in-band resize is enabled when supported — reported geometry and cell pixel size are updated from `CSI 48 ; rows ; cols ; yPx ; xPx t` reports, with SIGWINCH and `CSI 16 t` kept as fallbacks.
-- Added an injectable render scheduler for TUI tests, allowing deterministic render drains without patching global clocks or event-loop timing.
-- Added `ImageBudget`, an inline-image cap that keeps only the most recent N images as live terminal graphics and demotes older ones to their text fallback. Once a new image pushes the count past the cap, the renderer hides the oldest via a full redraw plus an explicit Kitty graphics purge (`a=d,d=I`) — text-clear escapes (`CSI 2 J`/`CSI 3 J`) do not remove Kitty images. Configure the cap via `TUI#setMaxInlineImages` (`0` disables it).
-- Changed Kitty inline images to a transmit-once + placement scheme: the base64 data is sent a single time (`a=t`) keyed by a stable image id, then every repaint emits only the tiny placement (`a=p,i=…,p=…`). Repaints — including full redraws — no longer re-send image data or stack duplicate placements, and the diff/line buffers and render caches hold short placement strings instead of multi-KB base64. The `ImageBudget` doubles as the transmit store (it tracks which ids are loaded and re-transmits after a purge frees the data). iTerm2/Sixel, which have no addressable image store, keep sending inline data as before.
-- Added a renderer-level DECCARA rectangular-SGR optimizer that paints solid background panels/rows (Box/Text/Markdown fills, status bars, any full-width `theme.bg` row) as a single coalesced rectangle escape (`CSI 2*x` / `CSI Pt;Pl;Pb;Pr;<sgr>$r` / `CSI *x`) instead of emitting a full-width run of background-styled spaces on every visible row. It operates at emit time on the final ANSI strings — components are unchanged — and strips only trailing padding it can prove sits under a single non-default background span, coalescing vertically adjacent identical fills into one rectangle and falling back to the original bytes whenever the rectangle would not save bytes. Enabled only on Kitty, which implements the SGR-background extension (`docs/deccara.rst`); **Ghostty is intentionally excluded** because its `CSI $r` is unimplemented (ghostty-org/ghostty#632) and would drop the background entirely. Scrollback-bound rows and the append/scroll paths always keep the padded representation so native history preserves colored cells, and the `PI_NO_DECCARA` kill switch (plus tmux/screen/zellij detection) forces the fallback.
-- Added `CMUX_SURFACE_ID` environment variable support to `getTerminalId()`, so cmux terminal surfaces get a stable identifier alongside kitty, tmux, macOS Terminal.app, and Windows Terminal — enabling per-surface session breadcrumbs for `omp -c` in cmux.
-
-### Changed
-
-- Changed TUI tests to use Ghostty's VT engine (`ghostty-web`) instead of `@xterm/headless`.
-- Changed the default inline-image live graphics budget from 3 to 8 images.
-
-### Fixed
-
-- Fixed the DECCARA background-fill optimizer rejecting or repainting the wrong cells when a trailing fill crossed from default-background spaces into colored spaces.
-- Fixed DEC private-mode reports with DECRPM status 3/4 being treated as unsupported, so permanent 2026/2048 reports stay recognized.
-- Fixed OSC 66 text-sizing width and slicing edge cases, including ZWJ emoji payloads and partial slices through scaled spans.
-- Fixed focused `Input` components following `TUI#setShowHardwareCursor`, so single-line prompts render either the terminal cursor or software cursor consistently with the editor.
-- Fixed the DECCARA background-fill optimizer painting fills on the wrong rows ("split into unaligned halves") in the differential repaint path. When a diff grew the transcript past the viewport, writing the rewritten rows scrolled the terminal, but the absolute DECCARA rectangle coordinates were derived from the pre-scroll viewport top, so every fill landed `scrollAmount` rows too low while the relatively-positioned text settled correctly; rows scrolled into history were also shortened, dropping their background padding from native scrollback. Rectangles now target the post-scroll rows and only rows remaining in the final viewport are optimized.
-- Fixed native scrollback desynchronization after terminal width or height changes reflowed overflowing content while the viewport was not at the bottom
-- Fixed a notification chip (or any injected block) rendering on top of an actively streaming tool render on ED3-risk terminals (Ghostty/kitty/Alacritty/iTerm2). While a foreground tool streams, its header's elapsed-time counter ticks every frame; once output scrolls the header above the viewport top, each tick is an offscreen edit that — because the eager scrollback-rebuild opt-in is gated off on these terminals — repaints the viewport in place and advances the rendered line count without committing the new overflow to native history. `#scrollbackHighWater` then lagged the logical viewport top, so a later content shrink whose changes landed in the visible region slipped past the shrink-across-boundary guard and reached the differential emitter, which is anchored to `#maxLinesRendered - height`: it rewrote only the suffix, dropped the newly exposed top row, and left a blank at the bottom, drifting every row below the edit one line up so it painted over the rows above. Such shrinks now re-anchor the bottom of the viewport with a non-destructive repaint, and the foreground-streaming shrink-across-boundary case repaints the live tail instead of padding and pinning the pre-shrink viewport.
-- Fixed a terminal resize during foreground-tool streaming on an unknown-viewport / ED3-risk host (Ghostty/kitty/Alacritty/iTerm2/WSL) leaving native scrollback permanently out of sync, so scrolling back after the turn showed missing rows. A pure geometry resize (no content change) takes the in-place viewport-repaint path, which — unlike a content-bearing resize that rebuilds via the geometry branch — never flagged native history. Because the prompt-submit checkpoint (`refreshNativeScrollbackIfDirty`) only rebuilds when scrollback is marked dirty on these hosts, the discrepancy was never reconciled. Overflowing geometry repaints whose viewport is not known to be at the bottom now mark scrollback dirty so the next checkpoint rebuilds an exact copy of the transcript.
-
-Older entries are archived in [packages/tui/CHANGELOG.md@6693ddbfd58c](https://github.com/can1357/oh-my-pi/blob/6693ddbfd58ce9edcdc0dc3fe98a8882c9bae834/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@9f40fb535f35](https://github.com/can1357/oh-my-pi/blob/9f40fb535f35f2b38336a4e694ff4c0dc91d4868/packages/tui/CHANGELOG.md).

package/README.md

@@ -493,7 +493,7 @@ const spacer = new Spacer(2); // 2 empty lines (default: 1)
 
 ### Image
 
-Renders images inline for terminals that support the Kitty graphics protocol (Kitty, Ghostty, WezTerm, and Warp on macOS/Linux), iTerm2 inline images or SIXEL. Falls back to a text placeholder on unsupported terminals.
+Renders images inline for terminals that support the Kitty graphics protocol (including Kitty, Ghostty, WezTerm, Rex, and Warp on macOS/Linux), iTerm2 inline images or SIXEL. Falls back to a text placeholder on unsupported terminals.
 
 ```typescript
 interface ImageTheme {

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

@@ -24,6 +24,7 @@ interface AppKeybindings {
     "app.message.followUp": true;
     "app.retry": true;
     "app.message.dequeue": true;
+    "app.btw.inject": true;
     "app.clipboard.pasteImage": true;
     "app.clipboard.pasteTextRaw": true;
     "app.clipboard.copyLine": true;
@@ -272,6 +273,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: ["alt+up", "shift+up"];
         readonly description: "Dequeue message";
     };
+    readonly "app.btw.inject": {
+        readonly defaultKeys: "alt+i";
+        readonly description: "Send a /btw answer's steering prompt to the main session";
+    };
     readonly "app.clipboard.pasteImage": {
         readonly defaultKeys: KeyId[];
         readonly description: "Paste image or text from clipboard";

package/dist/types/apps/session-picker.d.ts

@@ -1,4 +1,4 @@
-import { type SessionSelectorEntry, type SessionHistoryMatcher } from "../overlays/session-selector.js";
+import { type SessionHistoryMatcher, type SessionListing, type SessionSelectorEntry } from "../overlays/session-selector.js";
 /** Persistence and history capabilities supplied by the session-owning host. */
 export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelectorEntry> {
     loadPinnedIds?(): Promise<ReadonlySet<string>>;
@@ -7,11 +7,13 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
     /** Rename the session and resolve with the title as stored, or null when it did not happen. */
     renameSession?(session: T, title: string): Promise<string | null>;
     setSessionPinned?(session: T, pinned: boolean): Promise<void>;
-    loadAllSessions?(): Promise<T[]>;
+    loadAllSessions?(): Promise<SessionListing<T>>;
 }
 /** Presentation and capability controls for the standalone session picker. */
 export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
-    allSessions?: T[];
+    /** Complete listing replacing the preliminary `sessions` once it settles. */
+    completeSessions?: Promise<T[]>;
+    allSessions?: SessionListing<T>;
     title?: string;
     scopeLabel?: string | false;
     showCwd?: boolean;

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

@@ -4,7 +4,7 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { Container, type TUI } from "../tui.js";
 import type { OutputArtifactError } from "../tools/streaming-output.js";
-import type { TruncationMeta } from "../tools/output-meta.js";
+import type { MinimizedMeta, TruncationMeta } from "../tools/output-meta.js";
 import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 /** PTY size for `!` commands: the execution frame's inner content area. */
 export declare function bashPtyViewport(ui: TUI): {
@@ -43,9 +43,12 @@ export declare class BashExecutionComponent extends Container {
         output?: string;
         truncation?: TruncationMeta;
         artifactError?: OutputArtifactError;
+        minimized?: MinimizedMeta;
         images?: readonly ImageContent[];
         showImages?: boolean;
     }): void;
+    /** The loader animates the bottom border from outside the child tree, so teardown stops it here. */
+    dispose(): void;
     render(width: number): readonly string[];
     /**
      * Get the raw output for creating BashExecutionMessage.

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

@@ -32,6 +32,8 @@ export declare class EvalExecutionComponent extends Container {
         truncation?: TruncationMeta;
         artifactError?: OutputArtifactError;
     }): void;
+    /** The loader animates the bottom border from outside the child tree, so teardown stops it here. */
+    dispose(): void;
     getOutput(): string;
     getCode(): string;
 }

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

@@ -10,7 +10,8 @@ import { Loader } from "../components/loader.js";
 import { Text } from "../components/text.js";
 import { Container, type TUI } from "../tui.js";
 import type { OutputArtifactError } from "../tools/streaming-output.js";
-import { type TruncationMeta } from "../tools/output-meta.js";
+import { type MinimizedMeta, type TruncationMeta } from "../tools/output-meta.js";
+import { DynamicBorder } from "../chrome/dynamic-border.js";
 import type { TspText } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode } from "../native/node.js";
 /** Output rows shown while an execution is collapsed. */
@@ -25,23 +26,26 @@ export type ExecutionColorKey = "dim" | "bashMode" | "pythonMode";
 /**
  * Build the spacer + top border + content container + bottom border scaffold
  * that bash and eval execution components share. The caller appends the
- * header (command vs `>>>` prompt) and the returned loader to
- * `contentContainer` so per-mode order is preserved.
+ * header (command vs `>>>` prompt) to `contentContainer` and keeps the run's
+ * state in `bottomBorder` ({@link executionStatusLabel}); the returned loader
+ * animates that label rather than taking a row of its own.
  */
 export declare function buildExecutionFrame(parent: Container, ui: TUI, colorKey: ExecutionColorKey): {
     contentContainer: Container;
     loader: Loader;
+    bottomBorder: DynamicBorder;
 };
+/** The bottom-border marker of a settled run: `exit N` for a failure, `cancelled` for a cancel. */
+export declare function executionStatusLabel(status: Exclude<ExecutionStatus, "running">, exitCode: number | undefined): string | undefined;
 /**
- * Build the post-run status block (hidden-line hint, exit/cancel marker,
- * truncation notice). Returns undefined when there is nothing to display so
- * callers can skip appending a stray Text child.
+ * Build the post-run status block (hidden-line hint, truncation notice).
+ * Returns undefined when there is nothing to display so callers can skip
+ * appending a stray Text child.
  */
 export declare function buildStatusFooter(opts: {
-    status: ExecutionStatus;
-    exitCode: number | undefined;
     truncation: TruncationMeta | undefined;
     artifactError?: OutputArtifactError;
+    minimized?: MinimizedMeta;
     hiddenLineCount: number;
     /** Suppress the "… N more lines" hint (used when sixel passthrough renders the full output). */
     suppressHiddenCount?: boolean;
@@ -64,6 +68,7 @@ export interface ExecutionCardInput {
     readonly exitCode: number | undefined;
     readonly truncation: TruncationMeta | undefined;
     readonly artifactError?: OutputArtifactError;
+    readonly minimized?: MinimizedMeta;
 }
 /**
  * Native card shared by user bash/eval runs: the head with a live `elapsed`
@@ -94,6 +99,7 @@ export interface ExecutionToolInput {
     readonly exitCode: number | undefined;
     readonly truncation: TruncationMeta | undefined;
     readonly artifactError?: OutputArtifactError;
+    readonly minimized?: MinimizedMeta;
 }
 /**
  * A user `!`/`$` run as the agent's `tool` frame (§6.6): a head with a `you`

package/dist/types/chat/transcript-render-helpers.d.ts

@@ -8,6 +8,7 @@ import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import { type Component } from "../tui.js";
 import { type FileMentionMessage } from "./messages.js";
 import { ToolActivityContainer } from "../chrome/tool-activity.js";
+import type { MessageRenderer } from "./extension-types.js";
 import { type TranscriptBlock } from "../chrome/transcript-container.js";
 type CustomOrHookMessage = Extract<AgentMessage, {
     role: "custom" | "hookMessage";
@@ -21,6 +22,13 @@ type AssistantAgentMessage = Extract<AgentMessage, {
  * row per job.
  */
 export declare function buildAsyncResultBlock(message: CustomOrHookMessage): ToolActivityContainer;
+/**
+ * The `async-result` card for both transcript surfaces: a registered renderer owns it (#14131);
+ * the built-in block covers no renderer, a declining renderer, and a throwing one.
+ */
+export declare function buildAsyncResultComponent(message: CustomOrHookMessage, renderer: MessageRenderer | undefined): Component & {
+    setExpanded(expanded: boolean): void;
+};
 /**
  * Render a `launch-completion` custom message (terminal supervised-process
  * exits from the launch broker) as a transcript block of one compact

package/dist/types/chrome/dynamic-border.d.ts

@@ -13,6 +13,12 @@ export declare class DynamicBorder implements Component {
     #private;
     constructor(color?: (str: string) => string);
     invalidate(): void;
+    /**
+     * Pre-styled text set into the rule after a short lead (`─── label ────`);
+     * undefined draws a plain rule. A function label is re-read every render,
+     * for live text such as a spinner.
+     */
+    setLabel(label: string | (() => string) | undefined): void;
     /** Native terminals draw their own chrome; a border rule describes nothing. */
     describe(): NativeNode;
     render(width: number): readonly string[];

package/dist/types/chrome/transcript-status.d.ts

@@ -3,10 +3,10 @@ import type { NativeNode } from "../native/node.js";
 import { type ThemeColor } from "../theme/index.js";
 import { TranscriptBlock } from "./transcript-container.js";
 import { type NoticeTone } from "./transcript-notice.js";
-/** One themed run of a status row's terminal line. */
+/** One run of a status row's terminal line, in `color` unless the text is already styled. */
 export interface TranscriptStatusPart {
     readonly text: string;
-    readonly color: ThemeColor;
+    readonly color?: ThemeColor;
 }
 /** A status row in a native terminal: its {@link noticeRow}'s tone, icon and message. */
 export interface TranscriptStatusNative {

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

@@ -157,12 +157,21 @@ export declare class Editor implements Component, Focusable {
      *  cursor. The host styles it (ANSI allowed). Re-evaluated on every render, so hosts can derive
      *  it from live state. */
     placeholder?: () => string | undefined;
-    /** Whole-message prediction for the next prompt, painted as ghost text after the cursor while
-     *  the single-line buffer is a strict prefix of it, the cursor sits at its end, and no
-     *  autocomplete is open. A shown prediction replaces the {@link placeholder}; Tab or Right inserts
-     *  the rest without submitting. Must be a single line. Re-evaluated on every render, so hosts can
-     *  derive it from live state. */
-    prediction?: () => string | undefined;
+    /** Whole-message predictions for the next prompt, most likely first. The first one the single-line
+     *  buffer is a strict prefix of is painted as ghost text after the cursor while the cursor sits at
+     *  its end and no autocomplete is open. A shown prediction replaces the {@link placeholder}; Tab or
+     *  Right inserts the rest without submitting. A buffer the user typed keeps the ghost even when it
+     *  equals a shorter prediction; once Tab, Right, or the list has inserted one of two or more
+     *  predictions, no ghost extends it to a longer one, and Tab instead opens a list of all of them
+     *  that swaps the whole line, also without submitting. Each must be a single line. Re-evaluated on
+     *  every render, so hosts can derive them from live state. */
+    predictions?: () => readonly string[] | undefined;
+    /** Called with the prediction's index in {@link predictions} after Tab or Right inserts the rest of
+     *  a shown prediction, or the alternatives list swaps a different one into the buffer. */
+    onPredictionAccepted?: (index: number) => void;
+    /** Called for each frame that paints a prediction as ghost text: a terminal frame that draws at
+     *  least one cell of it, or a native frame that carries it as the editor's ghost. */
+    onPredictionShown?: () => void;
     constructor(theme: EditorTheme);
     /** Return bounded editor content, cursor, and transient child state for debug inspection. */
     debugState(): Record<string, unknown>;

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

@@ -71,6 +71,8 @@ export declare class Loader extends Text {
     stop(): void;
     /** Lifecycle teardown: stop the animation timer. Idempotent. */
     dispose(): void;
+    /** The current spinner frame and message as one styled line, for hosts that set it into their own chrome. */
+    inlineText(): string;
     /** Install a lazy right-docked suffix for the spinner row (e.g. a styled
      * session title). Re-evaluated every paint; dropped when the row leaves
      * less than a two-cell gap. */

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

@@ -42,3 +42,10 @@ export declare function matchesAppFollowUp(data: string): boolean;
 export declare function appApproveKeys(): readonly KeyId[];
 /** Match the tool-approval key, recognizing modifier-tagged LF as Ctrl+Enter like {@link matchesAppFollowUp}. */
 export declare function matchesAppApprove(data: string): boolean;
+/**
+ * Effective /btw inject key (Alt+I by default). No fallback: it sends text into the main
+ * session, so a user who unbinds it gets no key at all.
+ */
+export declare function appBtwInjectKey(): KeyId | undefined;
+/** Match the key that sends a /btw answer's steering prompt to the main session. */
+export declare function matchesAppBtwInject(data: string): boolean;

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

@@ -1,6 +1,7 @@
 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 BtwInjectState } from "./btw-inject.js";
 import type { SpaceHoldHandler } from "../space-hold.js";
 import { type KeyId } from "../app-keybindings.js";
 import type { NativeNode, NativeUiEvent } from "../native/node.js";
@@ -26,6 +27,18 @@ interface BtwHistoryPanelOptions {
      * first. For a host with no inline panel to fall back to (Tern).
      */
     escapeHides?: boolean;
+    /** `btw.inject` hooks, given only while it is on for this view. */
+    inject?: BtwHistoryInject;
+}
+interface BtwHistoryInject {
+    /**
+     * How a finished turn's closed `<inject>` block shows: apart from its prose while pending or
+     * sent, plain text when `undefined`. A streaming turn always shows its block.
+     */
+    state: (record: BtwHistoryRecord, turnIndex: number) => BtwInjectState | undefined;
+    /** Whether the inject key may send the record's latest block now. */
+    canSend: (record: BtwHistoryRecord) => boolean;
+    send: (record: BtwHistoryRecord) => void;
 }
 /** Session-local side questions. Selecting or copying never promotes them into chat. */
 export declare class BtwHistoryPanel implements Component, Focusable {

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

@@ -20,5 +20,29 @@ export interface BtwHistoryRecord extends BtwHistoryTurn {
 export declare function getBtwTopicLabel(record: BtwHistoryRecord): string;
 export declare function getBtwLatestTurn(record: BtwHistoryRecord): BtwHistoryTurn;
 export declare function getBtwTurns(record: BtwHistoryRecord): readonly BtwHistoryTurn[];
+/** Identifies one turn of a topic, its latest by default: a follow-up gets a new key, so per-answer marks reset. */
+export declare function getBtwTurnKey(record: BtwHistoryRecord, turnIndex?: number): string;
 /** Copy the most recent nonblank answer, preserving its original whitespace. */
 export declare function getBtwCopyText(record: BtwHistoryRecord): string | undefined;
+/** An answer around its `<inject>` block: the steering prompt a side answer drafted for the main session. */
+export interface BtwInjectParts {
+    before: string;
+    inject: string;
+    after: string;
+    /** False while no opener has a close: the block may still be streaming, so it runs to the end. */
+    closed: boolean;
+}
+/**
+ * Split an answer at its last closed `<inject>` block: the last opener that has a close
+ * after it, paired with the first close after it. A tag merely mentioned in prose,
+ * before or after the block, cannot capture it. Without a closed block, the last opener
+ * runs to the end (`closed: false`); display it only while the answer still streams.
+ * Linear: the last opener before the last close is the last one with any close after it.
+ */
+export declare function splitBtwInject(answer: string): BtwInjectParts | undefined;
+/** A block's text as shown and as sent: control sequences stripped, tabs expanded, trimmed. */
+export declare function formatBtwInjectText(inject: string): string;
+/** The steering prompt to send, exactly as the block shows it; undefined while unclosed or blank. */
+export declare function getBtwInject(answer: string): string | undefined;
+/** A topic's steering prompt: only its latest turn's, once that turn completed. */
+export declare function getBtwRecordInject(record: BtwHistoryRecord): string | undefined;

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

@@ -0,0 +1,22 @@
+import { type Component } from "../index.js";
+import type { NativeNode } from "../native/node.js";
+import { type BtwInjectParts } from "./btw-history.js";
+/** Labels a steering prompt that has not been sent yet. */
+export declare const BTW_INJECT_LABEL = "Inject into main session";
+/** Labels a sent steering prompt. */
+export declare const BTW_INJECTED_LABEL = "Injected into main session";
+/** A displayed `<inject>` block: still sendable, or sent. Blocks in neither state render as plain text. */
+export type BtwInjectState = "pending" | "sent";
+/** Text-mode answer split around its `<inject>` block: prose, the railed block, prose, a blank row apart. */
+export declare class BtwInjectAnswer implements Component {
+    #private;
+    constructor(parts: BtwInjectParts, sent: boolean);
+    render(width: number): string[];
+    invalidate(): void;
+}
+/**
+ * The same answer for native surfaces. They wrap text themselves, so a per-row gutter cannot
+ * follow wrapped lines: a card toned like the rail (`user` pending, `success` sent) marks the
+ * whole block instead, with the label as its last row.
+ */
+export declare function describeBtwInjectAnswer(parts: BtwInjectParts, sent: boolean, stream: boolean): NativeNode;

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

@@ -8,6 +8,11 @@ interface BtwPanelComponentOptions {
     tui: TUI;
     canBranch?: () => boolean;
     canFollowUp?: () => boolean;
+    /**
+     * Given only while `btw.inject` is on: the answer's `<inject>` block shows apart from its
+     * prose, and the inject key (`app.btw.inject`) is offered while this returns true.
+     */
+    canInject?: () => boolean;
 }
 export declare class BtwPanelComponent extends OverlayPanel {
     #private;
@@ -17,6 +22,8 @@ export declare class BtwPanelComponent extends OverlayPanel {
     markComplete(): void;
     /** Visual confirmation that `c` copied the answer to the clipboard. */
     markCopied(): void;
+    /** Shows the answer's steering prompt as sent (send arrows, green), or back to pending when a send failed. */
+    setInjected(injected: boolean): void;
     /** Shows that the completed answer is being promoted into the chat session. */
     markBranching(): void;
     markAborted(): void;

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

@@ -85,4 +85,6 @@ export declare class HookEditorComponent extends OverlayPanel implements Focusab
      *  enhanced-paste routing falls back to the main prompt editor hidden behind the
      *  dialog (#2127 routing contract). */
     pasteText(text: string): void;
+    /** Replace the draft, as Ctrl+R history search does for the main composer. */
+    setText(text: string): void;
 }

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

@@ -8,6 +8,10 @@ export interface JobsPanelJob {
     readonly type: string;
     readonly status: "running" | "completed" | "failed" | "cancelled";
     readonly label: string;
+    /** What the job is for, in the model's words; rows and the detail lead with it over a command `label`. */
+    readonly intent?: string;
+    /** One line on what a command does and when it ends, from the cheap model; the detail shows it under the intent. */
+    readonly caption?: string;
     readonly startTime: number;
     readonly endTime?: number;
     /** Registry id of the agent that owns the job. */

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

@@ -18,6 +18,16 @@ export interface SessionSelectorEntry {
     /** Path to the parent session when this one was forked. */
     parentSessionPath?: string;
 }
+/**
+ * One picker scope's rows, possibly in two passes: `sessions` show at once
+ * (e.g. rows built from a title index), and `complete` settles with the full
+ * listing that replaces them, keeping the query, the selected session, and
+ * deletes/renames made meanwhile.
+ */
+export interface SessionListing<T extends SessionSelectorEntry = SessionSelectorEntry> {
+    sessions: T[];
+    complete?: Promise<T[]>;
+}
 import { OverlayPanel } from "../chrome/overlay-box.js";
 /** The session list's part of the picker props, plus the memo keys it was built from. */
 interface SessionPickerView {
@@ -76,6 +86,12 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     /** 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));
+    /**
+     * Swap in the complete listing of the shown scope (a scan that finished
+     * after the picker opened), keeping the query and the selected session:
+     * rows arriving above the cursor never move it onto another session.
+     */
+    refreshSessions(sessions: T[], showCwd: boolean): void;
     /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */
     setSessions(sessions: T[], showCwd: boolean, pinnedIds?: ReadonlySet<string>): void;
     /** Cancel pending async search work; idempotent, called on every picker exit path. */
@@ -141,10 +157,15 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
     /** Persist the selected session's pin state (pin keys / the picker's Pin action). */
     onSetPinned?: (session: T, pinned: boolean) => Promise<void>;
     historyMatcher?: SessionHistoryMatcher;
+    /**
+     * Complete folder listing when the constructor's `sessions` are a
+     * preliminary subset; replaces them once it settles (see {@link SessionListing}).
+     */
+    completeSessions?: Promise<T[]>;
     /** Loads sessions across all projects for the all-projects scope toggle (Tab). */
-    loadAllSessions?: () => Promise<T[]>;
-    /** Preloaded all-projects list; cached so the first Tab toggle is instant. */
-    allSessions?: T[];
+    loadAllSessions?: () => Promise<SessionListing<T>>;
+    /** Preloaded all-projects listing; cached so the first Tab toggle is instant. */
+    allSessions?: SessionListing<T>;
     /** Picker heading; defaults to "Resume Session". */
     title?: string;
     /** Primary action label; defaults to "Resume" (ANSI footer defaults to "select"). */

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

@@ -190,11 +190,31 @@ export declare function formatErrorMessage(message: string | undefined, theme: T
 export declare function formatErrorDetail(message: string | undefined, theme: Theme): string;
 /** Render a muted empty-state message with a warning icon. */
 export declare function formatEmptyMessage(message: string, theme: Theme): string;
+/**
+ * Color of a file's name, or a whole URL, in tool bodies: it keeps paths apart
+ * from the tool titles above them (bronze in titanium).
+ */
+export declare const FILE_NAME_COLOR = "customMessageLabel";
+/**
+ * Where a display path's final segment (file or folder name) starts, past its
+ * last `/` or `\` separator; a trailing-slash directory keeps its slash on the
+ * name. Shared by the terminal ({@link formatStyledPath}) and Tern file rows.
+ */
+export declare function pathNameStart(filePath: string): number;
+/**
+ * A file path in a tool body: the directory (with its trailing separator) dim,
+ * the final segment in {@link FILE_NAME_COLOR}. Tool headers keep paths in
+ * their plain subject color instead.
+ */
+export declare function formatStyledPath(filePath: string, theme: Theme): string;
 /** Marker displayed in the gutter of a code frame. */
 export type CodeFrameMarker = "" | " " | "*" | "+" | "-" | ">";
 /** Format a code-frame row with a padded line-number gutter. */
 export declare function formatCodeFrameLine(marker: CodeFrameMarker, lineNumber: string | number, content: string, lineNumberWidth: number): string;
-/** Status states supported by shared tool renderer icons. */
+/**
+ * Status states supported by shared tool renderer icons. `done` is a deprecated
+ * alias of `success`, kept for extension renderers.
+ */
 export type ToolUIStatus = "success" | "done" | "error" | "warning" | "info" | "pending" | "running" | "aborted";
 /** Semantic foreground colors used by tool renderer labels. */
 export type ToolUIColor = "success" | "error" | "warning" | "accent" | "muted";