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

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 ## [Unreleased]
 
+## [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
+
+- Added a `maxRows` callback to `FigureMarkdown`, `SvgFigure` and `TableChartFigure` so surfaces shorter than the screen can fit their figures; zero hides a figure without delaying transcript completion ([#15661](https://github.com/can1357/oh-my-pi/issues/15661), [#15853](https://github.com/can1357/oh-my-pi/pull/15853) by [@KunoLu](https://github.com/KunoLu))
+
+### Fixed
+
+- Fixed IME composition text in the BTW history `Follow up:` input appearing at the left edge instead of at the caret when the hardware cursor is enabled ([#17427](https://github.com/can1357/oh-my-pi/issues/17427))
+- Fixed session tree rows overlapping when messages, tool arguments, or labels contain carriage returns or Unicode line/paragraph separators (`U+2028`, `U+2029`), while keeping multiline formatting in the selected entry preview ([#17430](https://github.com/can1357/oh-my-pi/pull/17430) by [@lincicomb](https://github.com/lincicomb)).
+- Fixed the Background jobs sheet dropping a finished job and its output while you were reading it; the selected job now stays until you select another ([#17506](https://github.com/can1357/oh-my-pi/pull/17506) by [@H4vC](https://github.com/H4vC))
+
 ## [18.14.0] - 2026-10-29
 
 ### Breaking Changes

package/README.md

@@ -521,6 +521,12 @@ SIXEL images encode off the JavaScript thread: the first render reserves the ima
 
 Supported formats: PNG, JPEG, GIF, WebP. Dimensions are parsed from the image headers automatically.
 
+### Figures
+
+`FigureMarkdown`, `SvgFigure`, and `TableChartFigure` size their images to a share of the terminal viewport. A surface shorter than the screen (an overlay, a pane) passes `maxRows: () => rows`, read on every render: the rows each figure may fill, a table chart's separator included. Zero hides a figure and keeps it from holding up transcript completion. Callers reserve room for prose and chrome themselves.
+
+Lowering the ceiling refits the drawn image at once and redraws it at the new size; a SIXEL reserves its rows while each re-encode runs off the JavaScript thread, as for a width change. Changing the ceiling of rows already committed to native scrollback forces a resync, so leave committed figures alone.
+
 ## Autocomplete
 
 ### CombinedAutocompleteProvider

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

@@ -8,6 +8,8 @@ export interface FigureMarkdownOptions {
     charts: boolean;
     /** Shared inline-image budget for the figures. */
     budget?: ImageBudget;
+    /** Rows each figure may fill, read on every render; callers reserve prose, chrome and separators themselves. Unset or `undefined` takes a share of the terminal viewport. */
+    maxRows?: () => number | undefined;
     /** A figure's rows changed outside a text update (raster landed, fell back to code). */
     onChange: () => void;
 }

package/dist/types/chat/svg-figure.d.ts

@@ -16,6 +16,11 @@ export interface SvgFigureOptions {
     markdown?: (text: string) => Markdown;
     /** Shared inline-image budget; superseded rasters are released from it. */
     budget?: ImageBudget;
+    /**
+     * Rows the figure may fill, fallback code included, read on every render;
+     * zero hides it. Unset or `undefined` takes a share of the terminal viewport.
+     */
+    maxRows?: () => number | undefined;
     /** The figure's rows changed outside a text update: a raster landed or rendering fell back to code. */
     onChange: () => void;
 }

package/dist/types/chat/table-chart.d.ts

@@ -64,6 +64,8 @@ export declare function chartFence(svg: string): string;
 export interface TableChartFigureOptions {
     /** Shared inline-image budget. */
     budget?: ImageBudget;
+    /** Rows the chart may fill, its separator included, read on every render; under two hides it. Unset or `undefined` takes a share of the terminal viewport. */
+    maxRows?: () => number | undefined;
     /** The chart's rows changed outside a text update: its pick or raster landed. */
     onChange: () => void;
 }

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

@@ -28,9 +28,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/components/image.d.ts

@@ -205,6 +205,12 @@ export declare class Image implements Component {
     /** Return source metadata without exposing the encoded image buffer. */
     debugState(): Record<string, unknown>;
     invalidate(): void;
+    /**
+     * Refit to a new row ceiling; a SIXEL reserves its rows until the off-thread
+     * encode lands. A demoted fallback keeps the height already drawn only
+     * within the new ceiling: the owner chose to shrink the block.
+     */
+    setMaxHeightCells(maxHeightCells: number): void;
     releaseRenderCaches(): void;
     /**
      * A native `image` backed by a content-addressed blob; the terminal fits

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/btw-history-panel.d.ts

@@ -33,6 +33,8 @@ export declare class BtwHistoryPanel implements Component, Focusable {
     constructor(options: BtwHistoryPanelOptions);
     get focused(): boolean;
     set focused(value: boolean);
+    /** Keep the follow-up input's cursor mode aligned so the hardware cursor (and IME preedit) lands on its caret. */
+    setUseTerminalCursor(useTerminalCursor: boolean): void;
     update(records: readonly BtwHistoryRecord[]): void;
     /** Visual confirmation that `c` copied this record's answer to the clipboard. */
     markCopied(recordId: string, text: string): void;

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 */

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";

package/dist/types/tools/grouped-file-output.d.ts

@@ -1,4 +1,5 @@
 import type { NativeNode } from "../native/node.js";
+import { type Theme, type ThemeColor } from "../theme/theme.js";
 /**
  * One file's contribution to a grouped file output. The header itself is generated
  * by `formatGroupedFiles` (one `#` per nesting level); use `headerSuffix` to tack
@@ -85,6 +86,15 @@ export declare function classifyGroupedLines(lines: readonly string[], headerBas
  * indices lets callers slice parallel arrays (raw lines, styled lines, contexts).
  */
 export declare function groupLineIndicesByBlank(rawLines: readonly string[]): number[][];
+/**
+ * Styled code-frame rows of grouped search output, highlighted in each owning
+ * file's language (`lang` overrides it when the highlighter knows it). A run of
+ * consecutive line numbers in one file highlights together on its first
+ * request; a gap row, a jump in line numbers or another file starts a new run.
+ * Rows without a numbered code frame (headers, gap rows, notes) return
+ * undefined, for the caller to style.
+ */
+export declare function createCodeFrameStyler(lines: readonly string[], contexts: readonly GroupedLineContext[], color: ThemeColor, theme: Theme, lang?: string): (index: number) => string | undefined;
 /** One event of {@link walkGroupedOutput}: a directory header, a file header, or a non-blank body line. */
 export type GroupedOutputEvent = {
     readonly kind: "dir";
@@ -102,31 +112,34 @@ export type GroupedOutputEvent = {
  * joined with the name) and dropping blank separator lines.
  */
 export declare function walkGroupedOutput(lines: readonly string[]): Generator<GroupedOutputEvent>;
-/** One source line for {@link numberedCode}: its number (`null` for an elision marker), text and match mark. */
+/** One source line for {@link numberedCode}: its number (`null` for an elision marker, which adds no line), text and match mark. */
 export interface NumberedLine {
     n: number | null;
     text: string;
     mark?: boolean;
 }
 /**
- * Numbered `code` for possibly non-contiguous source lines: one block per run
- * of consecutive line numbers (`start` = the run's first line, match lines
- * `mark`ed), with a `…` row wherever the numbers jump or an elision marker
- * (`n: null`) sits. `path` is the file the lines come from: Tern picks their
- * grammar from it and draws no header (the row or head above names the file).
- * `wrap` soft-wraps long lines instead of scrolling the block sideways.
+ * One numbered `code` block for possibly non-contiguous source lines (match
+ * lines `mark`ed by their line number): `start` when the numbers run on
+ * consecutively, else `nums` (each line's number), from whose jumps Tern draws
+ * the `…` gap rows in the gutter. Elision markers (`n: null`) add no line; the
+ * numbers jump around them. `path` is the file the lines come from: Tern picks
+ * their grammar from it and draws no header (the row or head above names the
+ * file). `wrap` soft-wraps long lines instead of scrolling the block sideways.
+ * `undefined` when no line is numbered.
  */
 export declare function numberedCode(lines: readonly NumberedLine[], opts?: {
     path?: string;
     wrap?: boolean;
-}): NativeNode[];
+}): NativeNode | undefined;
 /**
  * Describe grouped search output (grep / ast-grep / ast-edit display content)
  * by file (§7.3 grep): per file a 22px path row (dim dir, strong name, the
  * header's suffix or the match count as a chip), then its lines as
- * {@link numberedCode} with match lines marked and `…` between non-adjacent
- * runs. Unnumbered body lines stay plain `code`. `maxFiles` keeps only the
- * first files (the caller says how many were left out). `file` owns the lines
+ * one {@link numberedCode} block with match lines marked (gaps between
+ * non-adjacent runs drawn in its gutter). Unnumbered body lines stay plain
+ * `code`. `maxFiles` keeps only the first files (the caller says how many
+ * were left out). `file` owns the lines
  * before any header: a single-file search prints none, yet its lines get the
  * same file row as a directory search's.
  */

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

@@ -139,11 +139,11 @@ export declare function readSourceFsPath(details: unknown): string | undefined;
  */
 export declare function readResultIsMarkdown(details: ReadToolDetails | undefined, args: ReadRenderArgs | undefined): boolean;
 /**
- * Read content as numbered, wrapped `code` (no path header: the head names
- * the file), matching the ANSI preview's hanging wrap. Numbers come from
+ * Read content as one numbered, wrapped `code` block (no path header: the head
+ * names the file), matching the ANSI preview's hanging wrap. Numbers come from
  * `lineNumbers` (`displayContent`'s per-line numbers, `null` for an elided
- * block; runs split with `…` between) when they cover every line, else count
- * up from `start`.
+ * block, which Tern shows as a `…` gap row where the numbers jump) when they
+ * cover every line, else count up from `start`.
  */
 export declare function readContentCode(content: string, start: number, numbers: readonly (number | null)[] | undefined, path: string | undefined): NativeNode[];
 /** Render file, image, and URL reads in the transcript. */

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

@@ -104,7 +104,7 @@ export interface TaskItem {
     agent?: string;
     /** Historical source session selected by the bundled consult agent. */
     sourceSession?: string;
-    /** Optional model selector override for the historical source session. */
+    /** Bundled seance: override for the source session's saved model. Any other agent: one exact per-call model, gated by `task.perCallModel`. */
     model?: string | string[];
     /** Inline instructions; exactly one of task or taskFile is required. */
     task?: string;
@@ -135,7 +135,7 @@ export interface TaskParams {
     agent?: string;
     /** Historical source session selected by the bundled consult agent. */
     sourceSession?: string;
-    /** Optional model selector override for the historical source session. */
+    /** See {@link TaskItem.model}. */
     model?: string | string[];
     /** The work (flat form). */
     task?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.14.0",
+	"version": "18.14.2",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.14.0",
-		"@oh-my-pi/pi-agent-core": "18.14.0",
-		"@oh-my-pi/pi-ai": "18.14.0",
-		"@oh-my-pi/pi-catalog": "18.14.0",
-		"@oh-my-pi/pi-natives": "18.14.0",
-		"@oh-my-pi/pi-utils": "18.14.0",
-		"@oh-my-pi/pi-wire": "18.14.0",
-		"@oh-my-pi/snapcompact": "18.14.0"
+		"@oh-my-pi/omptype": "18.14.2",
+		"@oh-my-pi/pi-agent-core": "18.14.2",
+		"@oh-my-pi/pi-ai": "18.14.2",
+		"@oh-my-pi/pi-catalog": "18.14.2",
+		"@oh-my-pi/pi-natives": "18.14.2",
+		"@oh-my-pi/pi-utils": "18.14.2",
+		"@oh-my-pi/pi-wire": "18.14.2",
+		"@oh-my-pi/snapcompact": "18.14.2"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/apps/git/git-tui.ts

@@ -37,7 +37,7 @@ import { routeSgrMouseInput } from "../../mouse";
 import { col, compact, keyed, node, row, span, stableKey, text } from "../../native/describe";
 import { Memo } from "../../native/memo";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../../native/node";
-import { actionButton } from "../../native/overlay";
+import { actionButton, iconButton, segmentedTabs } from "../../native/overlay";
 import { type Component, type OverlayHandle, TUI } from "../../tui";
 import { truncateToWidth, visibleWidth } from "../../utils";
 import { theme, warmHighlighter } from "../../theme/theme";
@@ -1039,35 +1039,28 @@ class GitTuiComponent implements Component {
 		} else {
 			left.push(text([span(this.#model.branch ?? "detached", "muted")], { role: "omp.app.git.path" }));
 		}
-		const iconButton = (name: string, act: string, title: string, on?: boolean): NativeNode =>
-			node(
-				"icon",
-				{ name, title, aria: title, role: on ? "omp.app.ibtn.set" : "omp.app.ibtn", actions: { click: act } },
-				undefined,
-				act,
-			);
+		const tool = (name: string, act: string, title: string, on?: boolean): NativeNode =>
+			iconButton(name, act, title, { key: act, on });
 		const right: NativeNode[] = [
 			row(
 				[
-					iconButton("chev-up", "prev-hunk", `Previous change (${formatTooltipKey("alt+up")})`),
-					iconButton("chev", "next-hunk", `Next change (${formatTooltipKey("alt+down")})`),
+					tool("chev-up", "prev-hunk", `Previous change (${formatTooltipKey("alt+up")})`),
+					tool("chev", "next-hunk", `Next change (${formatTooltipKey("alt+down")})`),
 				],
 				{ gap: "none", align: "center" },
 			),
-			node(
-				"tabs",
+			segmentedTabs(
 				{
 					items: VIEW_TABS.map(tab => ({ id: tab.id, label: tab.label })),
 					active: this.#pane.mode,
 					role: "omp.app.seg",
 				},
-				undefined,
 				"views",
 			),
 		];
 		if (!narrow) {
 			right.push(
-				iconButton(
+				tool(
 					"type",
 					"whitespace",
 					this.#whitespace === "off"
@@ -1077,7 +1070,7 @@ class GitTuiComponent implements Component {
 							: `Ignoring formatting and imports; show all (${formatTooltipKey("b")})`,
 					this.#whitespace !== "off",
 				),
-				iconButton("corner-down-right", "wrap", `Wrap lines (${formatTooltipKey("w")})`, this.#pane.wrap),
+				tool("corner-down-right", "wrap", `Wrap lines (${formatTooltipKey("w")})`, this.#pane.wrap),
 			);
 		}
 		if (file?.area === "unstaged" || file?.area === "staged") {
@@ -1089,8 +1082,8 @@ class GitTuiComponent implements Component {
 			);
 		}
 		right.push(
-			iconButton("keyboard", "help", `Keyboard shortcuts (${formatTooltipKey("?")})`),
-			iconButton("x", "close", `Close (${formatTooltipKey("q")})`),
+			tool("keyboard", "help", `Keyboard shortcuts (${formatTooltipKey("?")})`),
+			tool("x", "close", `Close (${formatTooltipKey("q")})`),
 		);
 		return keyed(
 			row(