@oh-my-pi/pi-tui 18.14.1 → 18.15.0

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 ## [Unreleased]
 
+## [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
+
+- Added `assertModelSupportsEffortCeiling()`, which throws when a model has no supported thinking effort at or below a `task.maxEffort` ceiling ([#12229](https://github.com/can1357/oh-my-pi/pull/12229) by [@Xytronix](https://github.com/Xytronix))
+- Added `iconButton()`, `quietButton()` and `segmentedTabs()` to `native/overlay`, and `disabled`, `busy` and `icon` options to `actionButton()`
+- Added `nativeTail` to `Composer.setRuntimeChildren` options: containers whose children continue the native surface's `main` after the transcript instead of riding in the dock
+- Added `isHighlightLanguage` and `createCodeFrameStyler` for renderers that highlight source lines in their file's language ([#17550](https://github.com/can1357/oh-my-pi/pull/17550) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Changed
+
+- Grep and read results with gaps between line runs now render in Tern as one code block that scrolls sideways as a whole, with `…` gap rows aligned in the line-number gutter
+- Tern builds that draw the `button` kind get omp's buttons as real buttons (pointer cursor, accessible pressed/disabled state, a disabled button's tooltip says why) and segmented controls as `tabs` `variant: "segmented"`; older Tern builds keep the role-styled rows
+- Source lines in Grep, AST Grep and Find results and LSP symbol names are syntax-highlighted in their file's language instead of drawn in one color; consecutive lines highlight together, so multi-line strings and comments keep their colors ([#17550](https://github.com/can1357/oh-my-pi/pull/17550) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+
+### Fixed
+
+- Fixed table charts plotting a ratio column against the timings it divides (`ratio` 0.997 beside `C++ (ms)` drew as "719× less"): `analyzeTable` reads a column equal to the quotient of two others as restating them, written bare or as `×`
+- Fixed IRC coordination cards remaining visible when Hide Tool Activity is enabled, including incoming messages, automatic replies, relays, and workpool messages in live and replayed transcripts ([#17498](https://github.com/can1357/oh-my-pi/pull/17498) by [@dannyboy-ai](https://github.com/dannyboy-ai)).
+- Fixed text after a nested color losing the outer color, such as the rest of the `/mcp` and `/ssh` hints after the highlighted command (`Run /mcp list to see all configured servers.`) falling back to the default text color instead of staying muted ([#17521](https://github.com/can1357/oh-my-pi/pull/17521) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed LSP definition, type definition and implementation results showing the raw `Found 1 definition(s):` text; the response now counts them (`1 definition`) and shows each location over its source lines, its own line marked like a grep match ([#17549](https://github.com/can1357/oh-my-pi/pull/17549) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed an LSP definition, type definition or implementation location whose path starts with whitespace being dropped, with its source lines shown under the previous location
+- Fixed session tree user and assistant turns looking identical in themes whose `accent` and `success` colors match or nearly match (`dark-terminal`, `dark-poimandres`, `light-poimandres`): user rows are now bold, the `assistant:` label switches to the path color, and custom and advisor messages are muted ([#17520](https://github.com/can1357/oh-my-pi/pull/17520) by [@wolfiesch](https://github.com/wolfiesch))
+
 ## [18.14.1] - 2026-10-31
 
 ### Added
@@ -2454,36 +2506,4 @@
 
 - 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@6b354a56a890](https://github.com/can1357/oh-my-pi/blob/6b354a56a890b69b6bc9503c16c510be33675b5a/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/charts/table-data.d.ts

@@ -101,8 +101,10 @@ export interface TableColumn {
     /**
      * Index of the measure column this one restates, read from the values: a
      * proportional copy (`pass` 33/38 beside `pass%` 87%, `Samples` beside `% of
-     * Total`, `Leverage vs $200` beside the cost) or a running total of it
-     * (`Offset` summing `Verts`). Such a column is never a measure of its own.
+     * Total`, `Leverage vs $200` beside the cost), a running total of it
+     * (`Offset` summing `Verts`), or its ratio to another column of its unit
+     * (`ratio` 0.997 for `Python (ms)` ÷ `C++ (ms)`, `Speedup` 4.1×: the
+     * numerator's index). Such a column is never a measure of its own.
      */
     readonly restates?: number;
 }

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
@@ -28,9 +36,9 @@ export declare function buildAsyncResultBlock(message: CustomOrHookMessage): Too
  */
 export declare function buildLaunchCompletionBlock(message: CustomOrHookMessage): ToolActivityContainer;
 /**
- * Render a live IRC traffic custom message (`irc:incoming` / `irc:autoreply` /
- * `irc:relay`) as a transcript card. `getExpanded` supplies the live
- * expanded-state getter for the cached card.
+ * Render an IRC coordination custom message (`irc:incoming` / `irc:autoreply` /
+ * `irc:relay` / `irc:workpool`) as a tool-activity card. `getExpanded` supplies
+ * the live expanded-state getter for the cached card.
  */
 export declare function buildIrcMessageCard(message: CustomOrHookMessage, getExpanded: () => boolean): Component;
 /**

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

@@ -56,7 +56,9 @@ export declare function list(items: readonly NativeChild[], p?: TspProps<"list">
 /** Terminal-clocked elapsed counter: `age` ms already elapsed; `stopped` freezes it there. */
 export declare function elapsed(age: number, stopped?: boolean): NativeNode;
 /**
- * Keycap for one key id (`"ctrl+o"` → keys `["ctrl", "o"]`); the terminal
- * draws platform glyphs. A literal `+` key survives (`"+"`, `"ctrl++"`).
+ * The key names of one key id (`"ctrl+o"` → `["ctrl", "o"]`), as `kbd` and
+ * `button` `keys` take them. A literal `+` key survives (`"+"`, `"ctrl++"`).
  */
+export declare function keyNames(key: string): string[];
+/** Keycap for one key id ({@link keyNames}); the terminal draws platform glyphs. */
 export declare function kbd(key: string, nodeKey?: string): NativeNode;

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

@@ -1,6 +1,6 @@
 /**
- * Overlay chrome for `describe()`: root cards, key-hint footers, selectable
- * lists and annotation callouts.
+ * Overlay chrome for `describe()`: root cards, key-hint footers, buttons and
+ * segmented controls, selectable lists and annotation callouts.
  *
  * The overlay frame itself (glass, ring, placement) is the terminal's: the
  * engine wraps every overlay-stack component in an `overlay` node. An overlay
@@ -53,11 +53,23 @@ export interface ActionButtonOptions {
     readonly title?: string;
     /** Target of an `open` action (URL or `file://` path). */
     readonly href?: string;
+    /** Why the action can't run now: the button dims and a click sends nothing. */
+    readonly disabled?: string;
+    /** The button's work is running: a spinner leads the label. */
+    readonly busy?: boolean;
+    /** Icon beside the label (before it on a `button` node, after it on a row). */
+    readonly icon?: string;
 }
 /**
  * A native button (role `omp.btn`): a label plus an optional keycap. A click
  * sends `act` back as an `action` event (or runs a terminal-local `open`/`copy`),
  * which the component routes to the same code path as the key.
+ *
+ * A terminal that draws the `button` kind ({@link nativeButtons}) gets one
+ * (tone `accent` → variant `primary`, `error` → `danger`, `disabled` with its
+ * reason as the tooltip); older ones get the row their stylesheets draw by
+ * role. Both keep the role and tone the omp sheets' context rules key on; a
+ * disabled button's tone is `muted`.
  */
 export declare function actionButton(label: string, act: string, options?: ActionButtonOptions): NativeNode;
 /**
@@ -65,6 +77,34 @@ export declare function actionButton(label: string, act: string, options?: Actio
  * `act` (default `close`), which the component routes to its Esc path.
  */
 export declare function escCloseButton(act?: string, key?: string): NativeNode;
+/** Options of an {@link iconButton}. */
+export interface IconButtonOptions {
+    /** Sibling identity key; unkeyed buttons take their position. */
+    readonly key?: string;
+    /** Accessible name; defaults to the title. */
+    readonly aria?: string;
+    /** A toggle that is on (role `omp.app.ibtn.set`). */
+    readonly on?: boolean;
+}
+/**
+ * A quiet icon-only button (role `omp.app.ibtn`, the kit's icon button) for an
+ * app head or toolbar: a `button` node where the terminal draws one
+ * ({@link nativeButtons}), else an `icon` with a click action.
+ */
+export declare function iconButton(name: string, act: string, title: string, options?: IconButtonOptions): NativeNode;
+/**
+ * A quiet text button (role `omp.app.qbtn`, the kit's quiet button) for a
+ * section head or toolbar, keyed by its action: a small quiet `button` where
+ * the terminal draws one ({@link nativeButtons}), else a row.
+ */
+export declare function quietButton(label: string, act: string, title: string): NativeNode;
+/**
+ * A segmented control: `tabs` drawn as a well with a raised thumb on the
+ * active tab. A terminal that draws the `button` kind ({@link nativeButtons})
+ * draws `variant: "segmented"` too; older ones restyle the tabs by role
+ * (`omp.app.seg`) or parent.
+ */
+export declare function segmentedTabs(p: TspProps<"tabs">, key: string): NativeNode;
 /** A row of {@link actionButton}s (role `omp.actions`); `null` entries become the spacer that end-aligns what follows. */
 export declare function actionBar(buttons: readonly (NativeNode | null)[], key?: string): NativeNode;
 /** Spans of an annotation callout: a dim `label:` then the note. */

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

@@ -2,5 +2,9 @@
 export declare function isNativeRendering(): boolean;
 /** Called by the native backend on surface open and close. */
 export declare function setNativeRendering(on: boolean): void;
+/** Whether omp's buttons go out as `button` nodes (see {@link setNativeButtons}). */
+export declare function nativeButtons(): boolean;
+/** Called by the native backend when it adopts a `hello` reply and when it stops. */
+export declare function setNativeButtons(on: boolean): void;
 /** Call `listener` whenever native rendering starts or stops; returns the unsubscribe. */
 export declare function onNativeRenderingChange(listener: (on: boolean) => void): () => 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/prompt/composer.d.ts

@@ -2,7 +2,7 @@ import type { StatusLineComponent } from "../status-line/component.js";
 import type { StatusLineSession } from "../status-line/host.js";
 import { type StatusLineStartupData } from "../status-line/startup.js";
 import { type Terminal } from "../terminal.js";
-import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
+import { type Component, Container, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
 import type { NativeSurface, NativeSurfaceProvider } from "../native/node.js";
 import { CustomEditor } from "./custom-editor.js";
 import type { WordCompletionMethod } from "./word-completion.js";
@@ -61,6 +61,13 @@ export interface RuntimeChildrenOptions {
      * to the roots below the transcript in render order.
      */
     readonly nativeDock?: readonly Component[];
+    /**
+     * Below-transcript containers whose children continue `main` on a TSP
+     * terminal, one block each after the transcript's, instead of riding in the
+     * dock: output on its way into the transcript (shell runs deferred until the
+     * next prompt) reads as its tail, and keeps its block when it moves in.
+     */
+    readonly nativeTail?: readonly Container[];
     /**
      * Below-transcript roots the user opens and closes (the editor surface that
      * drafts and dialogs swap into, docked reports). Their rows never become
@@ -141,10 +148,11 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     /**
      * Describe the whole surface for a TSP terminal. `main` is the flowing
      * document: the header (welcome, extras) and every transcript block as its
-     * own component child. `dock` is the live chrome below the transcript in
-     * render order: pending messages, HUDs, the working row, the editor and the
-     * status line. There is no history/viewport split: retirement, resize
-     * replay and hover bands are ANSI concerns.
+     * own component child, then the children of the
+     * {@link RuntimeChildrenOptions.nativeTail} roots. `dock` is the live chrome
+     * below the transcript in render order: pending messages, HUDs, the working
+     * row, the editor and the status line. There is no history/viewport split:
+     * retirement, resize replay and hover bands are ANSI concerns.
      */
     describeSurface(): NativeSurface;
     /**

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

@@ -49,6 +49,8 @@ export declare const PREVIEW_LIMITS: {
     readonly EXPANDED_LINES: 12;
     /** Items (files, results) shown in collapsed view */
     readonly COLLAPSED_ITEMS: 8;
+    /** Definition, type-definition and implementation locations shown in collapsed view */
+    readonly LOCATIONS_COLLAPSED: 2;
     /** Output preview lines in collapsed view */
     readonly OUTPUT_COLLAPSED: 3;
     /** Output preview lines in expanded view */
@@ -188,6 +190,23 @@ 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. */

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

@@ -18,7 +18,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "rex" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;

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

@@ -6,7 +6,7 @@ export { getAvailableThemes, getAvailableThemesWithPaths, getThemeByName, type T
 export { isValidThemeColor, type ThemeBg, type ThemeColor } from "./schema.js";
 export { getAvailableSymbolPresets, isValidSymbolPreset, type SpinnerType, type SymbolKey, type SymbolPreset, } from "./symbols.js";
 export { Theme } from "./theme-class.js";
-export { createHighlightStream, getEditorTheme, getMarkdownTheme, getMarkdownThemeWithLinkTargets, getSelectListTheme, getSettingsListTheme, getSymbolTheme, highlightCode, setMarkdownMermaidRendering, warmHighlighter, } from "./tui-adapters.js";
+export { createHighlightStream, getEditorTheme, getMarkdownTheme, getMarkdownThemeWithLinkTargets, getSelectListTheme, getSettingsListTheme, getSymbolTheme, highlightCode, isHighlightLanguage, setMarkdownMermaidRendering, warmHighlighter, } from "./tui-adapters.js";
 /**
  * Subscribe to native fallback appearance changes independently of theme changes.
  * Consumers must re-check the effective background: COLORFGBG can override it.

package/dist/types/theme/tui-adapters.d.ts

@@ -6,6 +6,8 @@ import type { SettingsListTheme } from "../components/settings-list.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { SlashCommandIconName } from "./symbols.js";
 import type { Theme } from "./theme-class.js";
+/** Whether {@link highlightCode} colors `lang`; text in any other language comes back unstyled. */
+export declare function isHighlightLanguage(lang: string | undefined): lang is string;
 /**
  * Highlight code with syntax coloring based on file extension or language.
  * Returns array of highlighted lines.

package/dist/types/thinking.d.ts

@@ -137,12 +137,12 @@ export type TaskEffort = (typeof TASK_EFFORTS)[number];
 export declare function resolveTaskEffortLevel(model: Model | undefined, effort: TaskEffort, maxEffort?: Effort): Effort | undefined;
 /**
  * Clamps a concrete thinking selector to a per-session effort ceiling (e.g. a
- * task spawn's `task.maxEffort`-capped effort hint). `off`/`inherit`/
- * `undefined` pass through, as do levels already at or below the ceiling.
- * Levels above it snap to the highest model-supported effort at or below the
- * ceiling. A model whose floor exceeds the ceiling has nothing valid to snap
- * to; the requested level is returned unchanged and the caller is responsible
- * for rejecting or skipping such models (see {@link modelSupportsEffortCeiling}).
+ * task spawn's `task.maxEffort`). Unset/`inherit`/`off` retain their existing
+ * meaning, as do levels already at or below the ceiling. Levels above it snap
+ * to the highest model-supported effort at or below the ceiling. A model whose
+ * floor exceeds the ceiling has nothing valid to snap to; the requested level
+ * is returned unchanged and the caller must reject or skip such models (see
+ * {@link modelSupportsEffortCeiling}).
  */
 export declare function clampThinkingLevelToCeiling(model: Model | undefined, level: Effort | undefined, ceiling: Effort | undefined): Effort | undefined;
 export declare function clampThinkingLevelToCeiling(model: Model | undefined, level: ThinkingLevel | undefined, ceiling: Effort | undefined): ThinkingLevel | undefined;
@@ -153,6 +153,8 @@ export declare function clampThinkingLevelToCeiling(model: Model | undefined, le
  * skip models whose floor would force the session above the ceiling.
  */
 export declare function modelSupportsEffortCeiling(model: Model, ceiling: Effort): boolean;
+/** Throws when `model` has no supported effort at or below `task.maxEffort`, so a capped spawn fails instead of running at its floor. */
+export declare function assertModelSupportsEffortCeiling(model: Model, maxEffort: Effort): void;
 /**
  * The provisional concrete level shown while `auto` is configured but before a
  * turn has been classified, and the fallback when classification fails. Prefers

package/dist/types/tools/ast-grep.d.ts

@@ -34,6 +34,8 @@ interface AstGrepRenderArgs {
     /** Legacy pre-`path` argument name; kept so historical transcripts still render a scope. */
     paths?: string[];
     skip?: number;
+    /** Language the search parsed the files as; highlighting follows it over the file extension. */
+    lang?: string;
 }
 /** Render AST grep calls and results. */
 export declare const astGrepToolRenderer: {

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

@@ -71,6 +71,8 @@ export interface EvalToolDetails {
     statusEvents?: EvalStatusEvent[];
     /** Evictable events dropped from the front of `statusEvents` (see {@link recordStatusEvent}). */
     statusEventsElided?: number;
+    /** Text the cell's tool calls sent to `out://`, oldest first; transcripts draw each as a reply after the call. */
+    replies?: string[];
     isError?: boolean;
     meta?: OutputMeta;
     /** First backend that produced cells. Kept for transcript compatibility. */

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

@@ -1,4 +1,4 @@
-import type { Theme } from "../theme/theme.js";
+import { type Theme } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";