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

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 ## [Unreleased]
 
+## [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
+
+- Moved `PINNED_HUD_TOGGLE_ID` to the coding agent's task output manager so reserving subagent IDs no longer loads the interactive editor.
+- Updated `StatusLineHost.resetExpiryNotice` to receive the session and manage warning deduplication; custom status-line components must use the new signature.
+- Removed `ToolExecutionHandle.setToolActivityVisible`; tool-activity visibility is now controlled by transcript components, while reply blocks remain visible by default.
+- Removed the `@oh-my-pi/pi-tui/theme/defaults` export. Bundled palettes are now available through `getBuiltinThemes()` from `theme/defaults.json`.
+
+### Fixed
+
+- Fixed table-chart direction detection so measures are not incorrectly marked as better based on header words; single-measure tables are now sent for judging when local charting is appropriate.
+- Fixed LSP diagnostics that incorrectly showed “No issues” before a language server had reported; such files are now shown as unverified. ([#17293](https://github.com/can1357/oh-my-pi/pull/17293) by [@JustasMasiulis](https://github.com/JustasMasiulis))
+- Fixed Esc-Esc rewind in Tern selecting interrupted turns with no visible output instead of the last displayed turn.
+- Fixed streamed code blocks losing lines that scrolled off screen before the closing fence arrived; completed lines now remain available in scrollback. ([#17333](https://github.com/can1357/oh-my-pi/pull/17333) by [@gzkGit777](https://github.com/gzkGit777))
+
 ## [18.13.3] - 2026-10-28
 
 ### Added
@@ -2458,44 +2486,4 @@
 - 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.
 
-## [15.8.2] - 2026-06-03
-
-### Added
-
-- Added `PI_NO_SYNC_OUTPUT=1` to disable DEC 2026 synchronized-output wrappers for terminals whose implementation is buggy or visually worse, while keeping the renderer's autowrap guards active during paints ([#1765](https://github.com/can1357/oh-my-pi/issues/1765)).
-
-### Fixed
-
-- Fixed terminal resizes that land in the same render frame as streamed output splicing a phantom blank row into native scrollback and offsetting every later row by one. A height shrink (or width change carrying an append) with content overflowing the viewport fell through to the differential emitter, whose scroll math is anchored to the pre-resize viewport top and hardware-cursor row — both invalidated by the terminal's own resize reflow. Geometry-changed frames now rebuild native history when the viewport is at (or possibly at) the bottom, and defer non-destructively for a reader confirmed scrolled into history.
-- Fixed Ghostty/kitty/Alacritty-style ED3-risk terminals freezing the prompt after a deferred shrink; focused keyboard input now uses the same explicit user-input viewport opt-in as autocomplete and can repaint immediately instead of waiting for a resize.
-- Deferred eager live scrollback rebuilds under WSL fronted by Windows Terminal (`WT_SESSION` present in a Linux environment) so foreground streaming no longer emits ED3 (`CSI 3 J`) and yanks a reader scrolled into Windows Terminal's host scrollback; deferred rewrites still reconcile at the next prompt-submit checkpoint ([#1610](https://github.com/can1357/oh-my-pi/issues/1610)).
-- Fixed tmux (and screen/zellij) pane history gaining a complete duplicate copy of the transcript every time a deferred offscreen edit was followed by another render. Multiplexer panes never receive a destructive scrollback clear, so the dirty-scrollback rebuild path only appended the full transcript on top of preserved pane history — repeatedly. Live frames inside multiplexers now keep repainting the viewport and leave history reconciliation to explicit checkpoints, which also removes the O(transcript) write amplification per frame.
-- Fixed tmux pane viewports corrupting and pane history duplicating when a resize coincides with rendering: a resize racing a streamed append reached the stale-anchor diff emitters (phantom rows in the pane), a forced render racing a resize replayed the whole transcript into preserved pane history, and the prompt-submit checkpoint did the same after any deferred offscreen edit. Geometry-changed frames inside multiplexers now repaint the viewport in place, and forced-render geometry replays plus checkpoint replays are disabled there — tmux reflows its own pane grid and its history cannot be cleared, only duplicated.
-- Fixed terminal resize events whose dimensions net out unchanged by render time (rapid SIGWINCH round trips during a window drag, coalesced into one 16ms frame) being invisible to the renderer. The terminal reflows its buffer on every resize event — rows move between the viewport and scrollback and can be evicted at the scrollback cap — so diffing against the pre-resize screen splices blank phantom rows into the viewport. The renderer now tracks the resize event itself, not just the dimension delta, and routes such frames through the geometry-change repaint/rebuild paths.
-- Fixed Termux terminal resizes (screen rotation or software-keyboard toggles) displacing or hiding output after the viewport height changed. Content-bearing resizes were routed to the differential emitter, whose scroll math is anchored to the pre-resize viewport, so appended rows landed too low; pure height changes were treated as no-ops, exposing blank rows that later appends could fill without growing native scrollback. Termux resizes now repaint or rebuild at the new geometry like every other non-multiplexer terminal.
-- Fixed the turn-end teardown frame freezing on ED3-risk terminals (Ghostty/kitty/Alacritty/iTerm2): disabling eager scrollback rebuild now takes effect only after the in-flight frame is classified, so the loader/status removal still paints instead of deferring and leaving a stale spinner until the next keystroke.
-- Fixed non-WT ConPTY terminals on Windows (Tabby, Hyper, VS Code, conhost) clearing scrollback and yanking the viewport to the top whenever streaming output or a prompt-submit rebuild arrived while the user was scrolled up. The kernel32 viewport probe describes the ConPTY pseudo-console buffer — which is pinned to the visible grid, invisible to host-UI scrollback — so it reported "at bottom" no matter where the user had scrolled, and the [#1635](https://github.com/can1357/oh-my-pi/issues/1635) fix only distrusted it under `WT_SESSION`, which Tabby and other ConPTY hosts never set. The probe is now removed entirely: every Windows host is treated as viewport-unobservable, live mutations defer destructive rebuilds (no `\x1b[3J`, no viewport movement), and native scrollback reconciles at the prompt-submit checkpoint where the Enter keystroke has already pinned the host viewport to the bottom ([#1746](https://github.com/can1357/oh-my-pi/issues/1746)).
-- Fixed emoji-presentation symbols (a default-text symbol followed by variation-selector-16 `U+FE0F`, e.g. `⚠️`, `ℹ️`, `❤️`, keycaps) measuring as 1 cell instead of 2 in the native width engine on macOS. The native scanner now keeps `UnicodeWidthStr` as the source of truth for multi-codepoint graphemes and applies only the local macOS Hangul Compatibility Jamo character-width delta, preserving VS16/keycap sequence widths without reintroducing jamo cursor drift.
-- Deferred eager live scrollback rebuilds on macOS Terminal.app and iTerm2 so assistant/tool streaming no longer emits ED3 (`CSI 3 J`) while their native viewport position is unobservable, preserving readers scrolled into terminal history ([#1300](https://github.com/can1357/oh-my-pi/issues/1300)).
-- Fixed width-shrink reflow leaving old-width rows in native history so later appends no longer undercount scrollback growth or duplicate wrapped content.
-- Fixed hiding overlays after terminal reflow so stale dialog rows are scrubbed from native scrollback on non-multiplexer terminals.
-
-### Removed
-
-- Removed `shouldTrustNativeViewportProbe` and `ProcessTerminal`'s kernel32 `GetConsoleScreenBufferInfo` viewport probe. No Windows environment can answer "is the user's viewport at the bottom" truthfully — under ConPTY (every modern host) the pseudo-console buffer is pinned to the visible grid so the probe always read "at bottom", and under legacy conhost the window tracks the output cursor rather than the buffer tail so it always read "scrolled up" — so the probe and its trust gate are gone; `ProcessTerminal` no longer implements the optional `Terminal.isNativeViewportAtBottom`.
-
-## [15.8.1] - 2026-06-02
-
-### Fixed
-
-- Deferred eager live scrollback rebuilds on VTE terminals so GNOME-style Linux terminals do not flash or erase readable scrollback during streaming ([#1719](https://github.com/can1357/oh-my-pi/issues/1719)).
-
-## [15.8.0] - 2026-06-02
-
-### Fixed
-
-- Deferred eager live scrollback rebuilds on POSIX terminals where xterm ED3 (`CSI 3 J`, erase saved lines) can disturb scrolled-up readers during streaming, while keeping direct user-input and checkpoint rebuilds explicit ([#1682](https://github.com/can1357/oh-my-pi/issues/1682)).
-- Fixed TUI shutdown placing the parent shell prompt one row below short rendered content instead of directly on the next line ([#1620](https://github.com/can1357/oh-my-pi/issues/1620)).
-- Stopped painting inline color swatches for 4-digit hex runs in Markdown rendering. The `#RGBA` CSS form collides with hashline `#TAG` snapshot tags (4 hex digits, e.g. `#6C5E`), which were sprouting spurious RGB swatches in prose and codespans. Only `#RGB`, `#RRGGBB`, and `#RRGGBBAA` qualify now.
-
-Older entries are archived in [packages/tui/CHANGELOG.md@3deb6751027b](https://github.com/can1357/oh-my-pi/blob/3deb6751027b11b10ac14b2a5c07303817276505/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@6693ddbfd58c](https://github.com/can1357/oh-my-pi/blob/6693ddbfd58ce9edcdc0dc3fe98a8882c9bae834/packages/tui/CHANGELOG.md).

package/README.md

@@ -28,7 +28,7 @@ const tui = new TUI(terminal);
 tui.addChild(new Text("Welcome to my app!"));
 
 const editor = new Editor(editorTheme);
-editor.onSubmit = (text) => {
+editor.onSubmit = text => {
 	console.log("Submitted:", text);
 	tui.addChild(new Text(`You said: ${text}`));
 };
@@ -106,12 +106,12 @@ interface Component {
 }
 ```
 
-| Method                   | Description                                                                                                                                                        |
-| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Method                   | Description                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `render(width)`          | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
-| `handleInput?(data)`     | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                |
-| `invalidate?()`          | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                     |
-| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
+| `handleInput?(data)`     | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                                                                                                                                                                                            |
+| `invalidate?()`          | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                                                                                                                                                                                                 |
+| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement.                                                                                                                                                                           |
 
 ## Built-in Components
 
@@ -119,20 +119,20 @@ interface Component {
 
 Build screens from persistent components and update their data, selection, expansion, or size through setters. Layouts own child bounds and mouse-coordinate translation; controllers retain domain workflows and asynchronous operations. Propagate `invalidate()` after theme changes and `dispose()` when removing an owned component tree.
 
-| Family | Components | Import |
-| --- | --- | --- |
-| Layout | `Stack`, `Row`, `SplitPane` | package root |
-| Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
-| Menus | `SelectList`, `MenuSelection` | package root |
-| Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
-| Wizard steps | `WizardStep` | package root |
-| Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
-| Trees | `TreeView` | package root |
-| Disclosure | `Disclosure`, with lazy summary/detail children | package root |
-| Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
-| Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
-| Transcripts | `TranscriptBrowser` | package root |
-| Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
+| Family       | Components                                                                      | Import       |
+| ------------ | ------------------------------------------------------------------------------- | ------------ |
+| Layout       | `Stack`, `Row`, `SplitPane`                                                     | package root |
+| Panels       | `OverlayPanel`, `PanelRows`, `PanelDivider`                                     | `/chrome`    |
+| Menus        | `SelectList`, `MenuSelection`                                                   | package root |
+| Forms        | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField`    | package root |
+| Wizard steps | `WizardStep`                                                                    | package root |
+| Viewports    | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
+| Trees        | `TreeView`                                                                      | package root |
+| Disclosure   | `Disclosure`, with lazy summary/detail children                                 | package root |
+| Messages     | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent`   | `/chrome`    |
+| Tool output  | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane`                     | `/render`    |
+| Transcripts  | `TranscriptBrowser`                                                             | package root |
+| Data         | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section`                  | package root |
 
 ```typescript
 import { Disclosure, SplitPane, Text } from "@oh-my-pi/pi-tui";
@@ -176,10 +176,10 @@ Container that applies padding and background color to all children.
 const box = new Box(
 	1, // paddingX (default: 1)
 	1, // paddingY (default: 1)
-	(text) => chalk.bgGray(text), // optional background function
+	text => chalk.bgGray(text), // optional background function
 );
 box.addChild(new Text("Content"));
-box.setBgFn((text) => chalk.bgBlue(text)); // Change background dynamically
+box.setBgFn(text => chalk.bgBlue(text)); // Change background dynamically
 ```
 
 ### Text
@@ -191,10 +191,10 @@ const text = new Text(
 	"Hello World", // text content
 	1, // paddingX (default: 1)
 	1, // paddingY (default: 1)
-	(text) => chalk.bgGray(text), // optional background function
+	text => chalk.bgGray(text), // optional background function
 );
 text.setText("Updated text");
-text.setCustomBgFn((text) => chalk.bgBlue(text));
+text.setCustomBgFn(text => chalk.bgBlue(text));
 ```
 
 ### TruncatedText
@@ -215,7 +215,7 @@ Single-line text input with horizontal scrolling.
 
 ```typescript
 const input = new Input();
-input.onSubmit = (value) => console.log(value);
+input.onSubmit = value => console.log(value);
 input.setValue("initial");
 input.getValue();
 ```
@@ -285,11 +285,11 @@ interface EditorTheme {
 }
 
 const editor = new Editor(theme);
-editor.onSubmit = (text) => console.log(text);
-editor.onChange = (text) => console.log("Changed:", text);
+editor.onSubmit = text => console.log(text);
+editor.onChange = text => console.log("Changed:", text);
 editor.disableSubmit = true; // Disable submit temporarily
 editor.setAutocompleteProvider(provider);
-editor.borderColor = (s) => chalk.blue(s); // Change border dynamically
+editor.borderColor = s => chalk.blue(s); // Change border dynamically
 ```
 
 **Features:**
@@ -371,8 +371,8 @@ Animated loading spinner.
 ```typescript
 const loader = new Loader(
 	tui, // TUI instance for render updates
-	(s) => chalk.cyan(s), // spinner color function
-	(s) => chalk.gray(s), // message color function
+	s => chalk.cyan(s), // spinner color function
+	s => chalk.gray(s), // message color function
 	"Loading...", // message (default: "Loading...")
 );
 loader.start();
@@ -387,8 +387,8 @@ Extends Loader with Escape key handling and an AbortSignal for cancelling async
 ```typescript
 const loader = new CancellableLoader(
 	tui, // TUI instance for render updates
-	(s) => chalk.cyan(s), // spinner color function
-	(s) => chalk.gray(s), // message color function
+	s => chalk.cyan(s), // spinner color function
+	s => chalk.gray(s), // message color function
 	"Working...", // message
 );
 loader.onAbort = () => done(null); // Called when user presses Escape
@@ -430,9 +430,9 @@ const list = new SelectList(
 	theme, // SelectListTheme
 );
 
-list.onSelect = (item) => console.log("Selected:", item);
+list.onSelect = item => console.log("Selected:", item);
 list.onCancel = () => console.log("Cancelled");
-list.onSelectionChange = (item) => console.log("Highlighted:", item);
+list.onSelectionChange = item => console.log("Highlighted:", item);
 list.setFilter("opt"); // Filter items
 ```
 
@@ -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/app-keybindings.d.ts

@@ -39,10 +39,13 @@ interface AppKeybindings {
     "app.session.rename": true;
     "app.session.delete": true;
     "app.session.deleteNoninvasive": true;
+    "app.session.pin": true;
+    "app.session.unpin": true;
     "app.tree.previousBranch": true;
     "app.tree.nextBranch": true;
     "app.plan.toggle": true;
     "app.history.search": true;
+    "app.links.hint": true;
     "app.stt.pushToTalk": true;
     "app.stt.toggle": true;
     "app.live.toggle": true;
@@ -329,6 +332,14 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+backspace";
         readonly description: "Delete session (non-invasive)";
     };
+    readonly "app.session.pin": {
+        readonly defaultKeys: "alt+k";
+        readonly description: "Pin the selected session in the resume picker";
+    };
+    readonly "app.session.unpin": {
+        readonly defaultKeys: "alt+shift+k";
+        readonly description: "Unpin the selected session in the resume picker";
+    };
     readonly "app.tree.previousBranch": {
         readonly defaultKeys: [];
         readonly description: "Jump to the previous branch in /tree";
@@ -345,6 +356,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+r";
         readonly description: "Search history";
     };
+    readonly "app.links.hint": {
+        readonly defaultKeys: "alt+o";
+        readonly description: "Pick an extension link on screen by its hint tag";
+    };
     readonly "app.stt.pushToTalk": {
         readonly defaultKeys: "space";
         readonly description: "Hold to record speech-to-text";

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

@@ -6,6 +6,7 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
     deleteSession?(session: T): Promise<boolean>;
     /** 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[]>;
 }
 /** Presentation and capability controls for the standalone session picker. */

package/dist/types/charts/chart-plan.d.ts

@@ -419,9 +419,10 @@ export type ChartAnnotation = {
 export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
 /**
  * Whether a model should pick `table`'s chart (`tui.autoGraph: smart`):
- * multi-series tables, and tables whose rows may be named by a number the
- * `guess` plots (`Thread | State`, `Finding | Current`), where only meaning
- * tells a name from a measure.
+ * multi-series tables, tables whose rows may be named by a number the
+ * `guess` plots (`Thread | State`, `Finding | Current`), and any other chart
+ * the guess would draw — only meaning tells a measure from page references,
+ * step numbers or figures quoted in prose, which the judge charts as none.
  */
 export declare function shouldJudge(table: TableAnalysis, guess: ChartPlan | undefined): boolean;
 /** Measure columns before `guess`'s text label column: numbers that may only name their rows. */
@@ -446,10 +447,11 @@ export declare function tableTakeaways(table: TableAnalysis, plan: ChartPlan, co
  */
 export declare function drawnNames(spec: ChartSpec): Set<string>;
 /**
- * The local guess at what `plan`'s rows and measures mean: header keywords
- * for each measure's {@link Polarity} (resources like tokens or memory only
- * beside a baseline), rivals from the label's header, focus from bolded or
- * `(current)` row names, and a status column whose cells vary.
+ * The local guess at what `plan`'s rows and measures mean: each measure's
+ * {@link Polarity} as far as its unit says ({@link dimPolarity}; what a name
+ * means — `Memory` as a capacity or a cost — is the judge's call), rivals from
+ * the label's header, focus from bolded or `(current)` row names, and a status
+ * column whose cells vary.
  */
 export declare function guessMeaning(table: TableAnalysis, plan: ChartPlan): Pick<ChartPlan, "polarity" | "rowPolarity" | "rivals" | "focus" | "status">;
 /** Whether `plan`'s rows may each be a metric of their own: a `change`, a transposed table, or mixed-unit columns. */

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

@@ -1,7 +1,7 @@
 import type { AssistantMessage, ImageContent } from "@oh-my-pi/pi-ai";
 import { type Component, Container } from "../tui.js";
 import { type ImageBudget } from "../components/image.js";
-import type { AssistantThinkingRenderer } from "./extension-types.js";
+import type { AssistantTextRenderer, AssistantTextRendering, AssistantThinkingRenderer } from "./extension-types.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import { type CacheInvalidation } from "./cache-invalidation-marker.js";
 import { type ServedModelMismatch } from "./served-model-marker.js";
@@ -38,7 +38,7 @@ export declare class AssistantMessageComponent extends Container {
      * for lack of a target is re-rendered with its reaction stripped.
      */
     pickReactionTarget(transcript: readonly Component[]): void;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean);
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean, textRendering?: AssistantTextRendering);
     /**
      * Show or clear the trailing cache-invalidation divider. Set at `message_end`
      * (live) or during rebuild, once the turn's usage is known and compared
@@ -122,7 +122,19 @@ export declare class AssistantMessageComponent extends Container {
     renderTranscriptBlockEmergencyRow(width: number): string | undefined;
     getTranscriptBlockVersion(): number;
     markTranscriptBlockFinalized(): void;
+    /**
+     * Swap the extension text renderers (the setting enabling them changed) and redraw with them.
+     * Enabling them also drops rows already published as stable, since a renderer may rewrite them;
+     * callers MUST pair this with a scrollback-clearing display reset, as for
+     * {@link resetTranscriptStableRows}.
+     */
+    setTextRenderers(renderers: readonly AssistantTextRenderer[]): void;
     applyRetryRecovery(retryRecovery: AssistantMessage["retryRecovery"]): void;
+    /**
+     * Draw the current message again when it is the reply sent at `timestamp`, re-running the
+     * extension text renderers; returns whether it was. The caller schedules the frame.
+     */
+    rerenderMessage(timestamp: number): boolean;
     messagePersistenceKey(): string | undefined;
     /** Toggle rendering for assistant-native and tool-result images. */
     setImagesVisible(visible: boolean): void;

package/dist/types/chat/extension-types.d.ts

@@ -1,3 +1,4 @@
+import type { AssistantMessage } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "../tui.js";
 import type { Theme } from "../theme/theme.js";
 import type { CustomMessage, HookMessage } from "./messages.js";
@@ -17,6 +18,36 @@ export interface AssistantThinkingRenderContext {
     requestRender(): void;
 }
 export type AssistantThinkingRenderer = (context: AssistantThinkingRenderContext, theme: Theme) => Component | undefined;
+export interface AssistantTextRenderContext {
+    /**
+     * The message being drawn; `message.timestamp` identifies the reply for `ctx.ui.rerenderMessage()`.
+     * After a tool call this is only the segment drawn there, so its `content` does not hold the whole reply.
+     * A deep copy: editing it, at any depth, cannot change the stored reply.
+     */
+    message: AssistantMessage;
+    /**
+     * The text block's index in the full reply's `content`, also when the reply is drawn in segments
+     * around tool calls; not an index into `message.content` for a segment. It counts the content as
+     * currently stored: a transcript rebuild that drops tool calls left without a result shifts later
+     * blocks down, so do not persist it as a permanent key.
+     */
+    contentIndex: number;
+    /** The block's markdown as drawn so far, after any earlier renderer. */
+    text: string;
+    /** True while the block may still grow; false for its final render, a block sealed at a tool call, and later redraws. */
+    streaming: boolean;
+}
+/**
+ * Display-only transform of one assistant text block: returns the markdown to draw, or `undefined`
+ * to draw `context.text` unchanged. The session, exports and model context keep the original text.
+ */
+export type AssistantTextRenderer = (context: AssistantTextRenderContext) => string | undefined;
+/** Extension text renderers for one assistant component, and where its content starts in the full reply. */
+export interface AssistantTextRendering {
+    renderers: readonly AssistantTextRenderer[];
+    /** Index in the full reply's `content` of this component's first block; a segment after a tool call starts past it. */
+    contentOffset: number;
+}
 export interface HookMessageRenderOptions {
     /** Whether the view is expanded */
     expanded: boolean;

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

@@ -0,0 +1,48 @@
+/**
+ * Replies: text the agent sends to a scheme whose writes are `reply`-scoped (`out://`)
+ * is its mid-turn message to the user, drawn as assistant prose so it can answer
+ * without ending its turn.
+ * - A `write` call to a reply URL draws as {@link ReplyWriteComponent}, streaming as the
+ *   call's arguments arrive, instead of a tool card.
+ * - Text a tool's commands write there (`printf … > out://` in bash) arrives in the
+ *   tool's result `details.replies` ({@link toolResultReplies}); transcripts draw each
+ *   one as a prose block after the call ({@link replyDisplayMessage}).
+ */
+import type { AssistantMessage } from "@oh-my-pi/pi-ai";
+import type { ImageBudget } from "../components/image.js";
+import { AssistantMessageComponent } from "./assistant-message.js";
+import type { ToolExecutionHandle, ToolResultFrame } from "./tool-execution.js";
+/**
+ * Whether a `toolName` call writes to a reply URL. `undefined` while streamed args cannot tell yet:
+ * no path so far, or a path that could still grow into a reply URL (`ou`, `out:/`). Callers holding
+ * final args treat `undefined` as `false`.
+ */
+export declare function isReplyWrite(toolName: string, args: unknown): boolean | undefined;
+/** Display options of a reply block; the rest of its presentation follows the assistant prose defaults. */
+export interface ReplyWriteOptions {
+    /** Repaint request for figures and images that finish loading after a render. */
+    readonly requestRender?: () => void;
+    readonly imageBudget?: ImageBudget;
+    /** Resolved local destinations of Markdown links, as for assistant text. */
+    readonly linkTargets?: ReadonlyMap<string, string>;
+}
+/** Replies a tool result carries in `details.replies` (text its commands wrote to a reply URL), oldest first. */
+export declare function toolResultReplies(details: unknown): readonly string[];
+/** Assistant message drawing reply text. No provider turn backs it, so its identity fields stay empty. */
+export declare function replyDisplayMessage(text: string, errorMessage?: string): AssistantMessage;
+/**
+ * A reply write ({@link isReplyWrite}) drawn as assistant prose. The call's lifecycle arrives
+ * through {@link ToolExecutionHandle}: streamed args grow the text, final args settle it, and
+ * the result seals the block, a failure showing its error under the text. It is a reply, not
+ * tool activity, so hiding tool activity leaves it on screen.
+ */
+export declare class ReplyWriteComponent extends AssistantMessageComponent implements ToolExecutionHandle {
+    #private;
+    constructor(options?: ReplyWriteOptions);
+    updateArgs(args: unknown): void;
+    setArgsComplete(): void;
+    setExecutionStarted(): void;
+    updateResult(result: ToolResultFrame, isPartial?: boolean): void;
+    parkAsBackground(): void;
+    seal(): 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

@@ -19,10 +19,11 @@ export interface TableChartRequest {
     readonly guess: ChartPlan;
 }
 /**
- * Picks the chart for a multi-series table under `smart`: a plan, or `null`
- * for no chart. A rejection falls back to the local guess.
+ * Picks the chart for a table under `smart`: a plan, or `null` for no chart.
+ * A rejection falls back to the local guess; `undefined` (no judge to ask
+ * right now) keeps the guess at once, exactly as `always` would draw it.
  */
-export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null>;
+export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null> | undefined;
 /**
  * The chart under a table: its SVG, colored with figure tokens (`var(--accent)`, …)
  * still to resolve; none; or a smart pick on its way (the promise settles once the cache holds it).
@@ -63,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/tool-execution.d.ts

@@ -35,7 +35,6 @@ export interface ToolExecutionHandle extends Component {
     setArgsComplete(toolCallId?: string): void;
     setExecutionStarted(toolCallId?: string): void;
     setExpanded(expanded: boolean): void;
-    setToolActivityVisible(visible: boolean): void;
     /** Mark the call parked: it returned, but stays tracked for async job frames. */
     parkAsBackground(): void;
     /** Seal the block as final history and stop its animations. */

package/dist/types/chat/transcript-outline.d.ts

@@ -9,6 +9,7 @@ import { type TranscriptEntryLike as TranscriptEntry } from "./transcript-entry.
 import type { SessionMessageEntryLike as SessionMessageEntry } from "./transcript-entry.js";
 import { type ThemeColor } from "../theme/index.js";
 import type { ChatTranscriptBuilder } from "./chat-transcript-builder.js";
+import type { DescribeContext } from "../native/node.js";
 /** One selectable transcript item: a message entry plus its rendered block range. */
 export interface OutlineTarget {
     /** Entry the selection resolves to; extended over trailing componentless tool results. */
@@ -63,6 +64,12 @@ export declare class OutlineRowCache {
 export declare function appendOutlineEntries(builder: ChatTranscriptBuilder, entries: TranscriptEntry[]): OutlineTarget[];
 /** Per-target "renders at least one non-blank row" flags at the given rows. */
 export declare function outlineVisibility(childRows: readonly (readonly string[])[], targets: readonly OutlineTarget[]): boolean[];
+/**
+ * Per-target "describes something that shows" flags: {@link outlineVisibility}
+ * for a TSP page, where blocks describe nodes instead of rendering rows. An
+ * empty `col`/`row` (an interrupted turn with no output) shows nothing.
+ */
+export declare function describedVisibility(blocks: readonly Component[], targets: readonly OutlineTarget[], cx: DescribeContext): boolean[];
 /** Dotted horizontal rule with rounded corners, spanning the outline width. */
 export declare function outlineRule(left: string, right: string, innerWidth: number, color?: ThemeColor, caption?: string): string;
 /** Wrap pre-rendered rows in the dotted outline (rules above/below, `┆` sides). */

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

@@ -55,6 +55,8 @@ export declare function assistantHasVisibleContent(message: AssistantAgentMessag
 export declare function splitAssistantMessageToolTimeline(message: AssistantAgentMessage): {
     beforeTools: AssistantAgentMessage;
     afterToolCalls: ReadonlyMap<string, AssistantAgentMessage>;
+    /** Index in `message.content` of each after-tool segment's first block, by tool-call id. */
+    contentOffsets: ReadonlyMap<string, number>;
     hasToolCalls: boolean;
     lastToolCallId?: string;
 };

package/dist/types/chrome/index.d.ts

@@ -16,5 +16,6 @@ export * from "./shared.js";
 export * from "./streaming-panel.js";
 export * from "./tool-activity.js";
 export * from "./transcript-container.js";
+export * from "./transcript-notice.js";
 export * from "./transcript-status.js";
 export * from "./visual-truncate.js";

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

@@ -0,0 +1,35 @@
+import type { TspText } from "@oh-my-pi/pi-wire";
+import type { NativeNode } from "../native/node.js";
+import type { Component } from "../tui.js";
+import { TranscriptBlock } from "./transcript-container.js";
+/** How loud an inline transcript notice is; a native terminal styles it as `omp.notice.<tone>`. */
+export type NoticeTone = "info" | "success" | "warning" | "error";
+/** Optional parts of a {@link noticeRow}. */
+export interface NoticeRowOptions {
+    /** Icon name in place of the tone's own (`read` for a file read, `download` for an update). */
+    readonly icon?: string;
+    readonly key?: string;
+}
+/**
+ * One inline transcript notice for a native terminal (`omp.notice.<tone>`): a
+ * leading icon beside the wrapped message. Warnings, errors, background-job
+ * completions and prompt file reads all draw as this row, so they read alike.
+ * The tone colors the icon (an info notice keeps it quiet); the message spans
+ * carry emphasis only (`path`, `mono`, `dim`), never the tone itself.
+ */
+export declare function noticeRow(tone: NoticeTone, message: TspText, options?: NoticeRowOptions): NativeNode;
+/**
+ * A transcript block that a native terminal draws as one {@link noticeRow}
+ * while a text terminal draws `ansi`.
+ */
+export declare class TranscriptNotice extends TranscriptBlock {
+    #private;
+    constructor(native: NativeNode, ansi: readonly Component[]);
+    /**
+     * `showWarning` / `showError`: a blank row and the `Warning: …` / `Error: …`
+     * line in its color in a text terminal; natively the tone's icon and the
+     * message, the label left to the icon.
+     */
+    static line(tone: "warning" | "error", message: string): TranscriptNotice;
+    describe(): NativeNode;
+}