@oh-my-pi/pi-tui 18.11.0 → 18.11.2

package/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 ## [Unreleased]
 
+## [18.11.2] - 2026-10-16
+
+### Changed
+
+- Improved nested tool status line rendering: moved preview content into a dedicated collapsible code block when expanded and limited field widths on the one-line summary
+- Suppressed typo highlighting for the word currently being typed to avoid distracting inline markers while composing
+
+### Fixed
+
+- Fixed double-clicking an extension switched off in `/extensions` in Tern not switching it back on
+- Fixed the queued-messages badge in Tern showing a bare count that read as the first message's number; it now reads `N queued`
+- Fixed table charts on TSP terminals to use SVG fences and respect terminal palette
+- Fixed table charts in Tern's native view drawing in the other appearance's colors (light labels on a light page) when omp's light/dark detection disagreed with Tern; Tern now colors them in the theme it shows, like the prose around them
+- Fixed the /btw history answer being stuck at the bottom while a follow-up is being written: Up/Down and Page Up/Down now scroll the answer without leaving the draft ([#15902](https://github.com/can1357/oh-my-pi/pull/15902) by [@H4vC](https://github.com/H4vC))
+- Fixed macOS editor spelling assistance hanging silently when the spelling service stops responding; it now reports and disables itself instead ([#12084](https://github.com/can1357/oh-my-pi/issues/12084), [#14341](https://github.com/can1357/oh-my-pi/pull/14341) by [@F0Rextasy](https://github.com/F0Rextasy))
+- Fixed a chip toggled in a multi-select setting's open submenu leaving its row and its tab's changed badge showing the old selection until the submenu was closed ([#14444](https://github.com/can1357/oh-my-pi/pull/14444) by [@F0Rextasy](https://github.com/F0Rextasy))
+- Fixed `@` file autocomplete freezing when the project contains a symlink into a very large directory tree; the fuzzy walk now stops after 1.5 s and the popup falls back to the immediate-directory listing ([#12317](https://github.com/can1357/oh-my-pi/issues/12317), [#14330](https://github.com/can1357/oh-my-pi/pull/14330) by [@F0Rextasy](https://github.com/F0Rextasy))
+- Fixed omp in a Tern pane showing the classic CLI when a shell rc, dev shell or `.env` set `TERM` to a `screen*`/`tmux*` value with no multiplexer running; only a real tmux/screen/zellij/herdr/cmux/wmux session now keeps Tern's native view off
+- omp inside devenv 2.x's reloading `devenv shell` now starts on the classic renderer instead of opening Tern's native view and abandoning it: devenv's terminal layer drops Tern's protocol, so the native view needs `devenv shell --no-reload`. The debug log now records why a Tern pane stays on the classic renderer
+- Fixed large terminal paints on Windows being split mid-row, which let other output land inside a row; writes are now cut at row boundaries ([#14187](https://github.com/can1357/oh-my-pi/pull/14187) by [@mateusant13](https://github.com/mateusant13))
+- Fixed `TUI.addStartListener()` hooks added after `start()` never running until the next stop/start cycle; a hook added to a running TUI now runs at once ([#15369](https://github.com/can1357/oh-my-pi/pull/15369) by [@LoneExile](https://github.com/LoneExile))
+- Fixed the git viewer advertising stage, discard, select and commit keys while showing a clean tree's HEAD commit, where none of them do anything; the footer and sidebar now describe the commit view ([#14347](https://github.com/can1357/oh-my-pi/issues/14347), [#14480](https://github.com/can1357/oh-my-pi/pull/14480) by [@F0Rextasy](https://github.com/F0Rextasy))
+- Fixed the status line `pr` segment keeping the previous branch's PR after switching to the default branch, a detached HEAD, or a branch without a PR ([#15455](https://github.com/can1357/oh-my-pi/pull/15455) by [@ravshansbox](https://github.com/ravshansbox))
+- Fixed the status-line footer total leaving out task subagent spend; it now reads the session's cumulative usage, the same source the interactive status line uses ([#14393](https://github.com/can1357/oh-my-pi/pull/14393) by [@F0Rextasy](https://github.com/F0Rextasy))
+- Fixed transcript rows disappearing from scrollback or reappearing out of order when bottom chrome stays taller after a turn, self-clearing HUDs close, or the composer shape changes ([#15820](https://github.com/can1357/oh-my-pi/pull/15820) by [@emmahyde](https://github.com/emmahyde))
+
+## [18.11.1] - 2026-10-15
+
+### Added
+
+- Added a tree layout to the background jobs sheet: subagents' jobs nest under the task job that runs them, busiest branches first, and Cancel appears only on the viewing agent's own jobs ([#15854](https://github.com/can1357/oh-my-pi/pull/15854) by [@H4vC](https://github.com/H4vC))
+
+### Fixed
+
+- Fixed transcript images not opening their file: image placeholders and native image nodes now link to the source file or a stored copy ([#15872](https://github.com/can1357/oh-my-pi/pull/15872) by [@H4vC](https://github.com/H4vC))
+- A collapsing live block no longer leaves its slack as a band of blank rows between the retired history and the live rows: the slack falls below the transcript, so a streamed reply stays contiguous and the input keeps the bottom row ([#15499](https://github.com/can1357/oh-my-pi/pull/15499) by [@iacore](https://github.com/iacore))
+- Fixed width-aware text on native (TSP) terminals truncating content two columns early ([#15806](https://github.com/can1357/oh-my-pi/pull/15806) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed Tab/right-arrow completion silently dismissing a selected `@"quoted path"` file suggestion when the path contains spaces ([#15698](https://github.com/can1357/oh-my-pi/pull/15698) by [@drawde-nadroj](https://github.com/drawde-nadroj))
+- Bracketed pastes are now capped by their UTF-8 size, so a large multibyte paste no longer buffers past the byte limit ([#15803](https://github.com/can1357/oh-my-pi/pull/15803) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed OSC 66 text-sized spans bypassing truncation when their UTF-16 length was short enough to fit the fast-path guard ([#15802](https://github.com/can1357/oh-my-pi/pull/15802) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Updated the `ast_grep` result view's truncated-match note to suggest `skip` pagination instead of the schema's nonexistent `increase limit` flag ([#15532](https://github.com/can1357/oh-my-pi/issues/15532), [#15543](https://github.com/can1357/oh-my-pi/pull/15543) by [@peda-cos](https://github.com/peda-cos)).
+- Fixed a streaming Edit preview with long wrapped lines growing past its row cap, because its tail was budgeted without the diff gutter its continuation rows hang under ([#15679](https://github.com/can1357/oh-my-pi/pull/15679))
+- Fixed malformed base64 padding being accepted for chat image attachments before native image decoding ([#15765](https://github.com/can1357/oh-my-pi/pull/15765) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Fixed Shift+Enter submitting and Ctrl+Enter inserting a newline in Windows Terminal 1.25–1.27 after closing any fullscreen view such as `/settings`; the terminal dropped omp's keyboard mode on leaving the alternate screen ([microsoft/terminal#20763](https://github.com/microsoft/terminal/issues/20763)), so omp now re-applies it ([#15868](https://github.com/can1357/oh-my-pi/pull/15868) by [@H4vC](https://github.com/H4vC)).
+- Long lines in native (Tern) `read`, `write`, and code-cell source now wrap instead of scrolling each block sideways ([#15823](https://github.com/can1357/oh-my-pi/issues/15823)).
+- Fixed long text pastes taking seconds to land in terminals that deliver a paste one key at a time, such as JetBrains' terminal on Windows; omp no longer writes to the terminal for every pasted key ([#15757](https://github.com/can1357/oh-my-pi/issues/15757))
+- Fixed Shift+Enter submitting the prompt and Ctrl+Enter inserting a newline in WSL under Windows Terminal 1.24 and earlier, conhost, and other ConPTY hosts without kitty keyboard support; Shift+Enter now inserts a newline and Ctrl+Enter sends a follow-up, as on native Windows.
+- Fixed streamed Markdown tables jumping around as each row arrives: the terminal UI fills the row being written in under the existing column widths, and native (TSP) terminals receive each row once its line is complete ([#15856](https://github.com/can1357/oh-my-pi/pull/15856) by [@H4vC](https://github.com/H4vC)).
+- Fixed streamed links and inline math showing raw `[text](url` or LaTeX and then rewrapping the paragraph when they close, in the terminal UI and native (TSP) terminals: they now render in their closed form while they stream ([#15864](https://github.com/can1357/oh-my-pi/pull/15864) by [@H4vC](https://github.com/H4vC)).
+- Paint-only overlays no longer swallow typing intended for the focused input beneath them ([#15793](https://github.com/can1357/oh-my-pi/issues/15793)).
+
 ## [18.11.0] - 2026-10-14
 
 ### Added
@@ -2534,149 +2585,4 @@
 
 - Fixed viewport shift handling to prevent stale content when mixed updates remap screen rows
 
-## [13.5.0] - 2026-03-01
-
-### Breaking Changes
-
-- Removed `PI_TUI_RESIZE_CLEAR_STRATEGY`; resize behavior is no longer configurable between viewport/scrollback modes. The renderer now uses fixed semantics: width changes perform a hard reset (`3J` + full content rewrite), while height changes and diff fallbacks use viewport-scoped repainting.
-
-### Added
-
-- Added a new terminal regression suite in `packages/tui/test/render-regressions.test.ts` covering no-op render stability, targeted middle-line diffs, shrink cleanup, width-resize truncation without ghost rows, shrink/grow viewport tail anchoring, scrollback deduplication across forced redraws, overlay restore behavior, and rapid mutation convergence.
-- Expanded `packages/tui/test/overlay-scroll.test.ts` with stress coverage for overflow shrink/regrow cycles, resize oscillation, overlay toggle churn, no-op render loops, and hardware-cursor-only updates while bounding scrollback growth and blank-run artifacts.
-
-### Changed
-
-- Refactored render orchestration to explicit `hardReset` and `viewportRepaint` paths, with targeted fallbacks for offscreen diff ranges and unsafe row deltas.
-- Switched startup to `requestRender(true)` so the first frame always initializes renderer state with a forced full path.
-- Replaced legacy viewport bookkeeping (`previousViewportTop`) with `viewportTopRow` tracking and consistent screen-relative cursor calculations.
-- Updated stop-sequence cursor placement to target the visible working area and clamp to terminal bounds before final newline emission.
-- Documented the intentional performance policy of not forcing full repaint on every viewport-top shift, relying on narrower safety guards instead.
-
-### Fixed
-
-- Fixed stale/duplicated terminal cursor dedup state by synchronizing `#lastCursorSequence` in all render write paths (hard reset, viewport repaint, deleted-lines clear path, append fast path, and differential path).
-- Fixed scroll overshoot on `stop()` when content fills the viewport by clamping target row movement to valid screen rows.
-
-## [13.4.0] - 2026-03-01
-
-### Added
-
-- Added `PI_TUI_RESIZE_CLEAR_STRATEGY` environment variable to control terminal behavior on resize: `viewport` (default) clears/redraws the viewport while preserving scrollback, or `scrollback` clears all history
-
-### Changed
-
-- Changed resize redraw behavior to use configurable clear semantics (`viewport` vs `scrollback`) while keeping full content rendering for scrollback navigation
-
-### Fixed
-
-- Fixed loader component rendering lines wider than terminal width, preventing text overflow and display artifacts
-
-## [13.3.11] - 2026-02-28
-
-### Fixed
-
-- Restored terminal image protocol override and fallback detection for image rendering, including `PI_FORCE_IMAGE_PROTOCOL` support and Kitty fallback for screen/tmux/ghostty-style TERM environments.
-
-## [13.3.8] - 2026-02-28
-
-### Breaking Changes
-
-- Changed mermaid hash type from string to bigint in `getMermaidImage` callback and `extractMermaidBlocks` return type
-- Removed `mime-types` and `@types/mime-types` from dependencies
-- Removed `@xterm/xterm` from dependencies
-
-### Changed
-
-- Updated mermaid hash computation to use `Bun.hash.xxHash64()` instead of `Bun.hash().toString(16)`
-
-## [12.19.0] - 2026-02-22
-
-### Added
-
-- Added `getTopBorderAvailableWidth()` method to calculate available width for top border content accounting for border characters and padding
-
-### Fixed
-
-- Fixed stale viewport rows appearing when terminal height increases by triggering full re-render on height changes
-
-## [12.18.0] - 2026-02-21
-
-### Fixed
-
-- Fixed viewport synchronization issue by clearing scrollback when terminal state becomes desynced during full re-renders
-
-## [12.12.2] - 2026-02-19
-
-### Fixed
-
-- Fixed non-forced full re-renders clearing terminal scrollback history during streaming updates by limiting scrollback clears to explicit forced re-renders.
-
-## [12.12.0] - 2026-02-19
-
-### Added
-
-- Added PageUp/PageDown navigation for editor content and autocomplete selection to jump across long wrapped inputs faster.
-
-### Fixed
-
-- Fixed history-entry navigation anchoring (Up opens at top, Down opens at bottom) and preserved editor scroll context when max-height changes to keep cursor movement visible in long prompts ([#99](https://github.com/can1357/oh-my-pi/issues/99)).
-
-## [12.11.3] - 2026-02-19
-
-### Fixed
-
-- Fixed differential deleted-line rendering when content shrinks to empty so stale first-row content is cleared reliably.
-- Fixed incremental stale-row clearing to use erase-below semantics in synchronized output, reducing leftover-line artifacts after shrink operations.
-
-## [12.9.0] - 2026-02-17
-
-### Added
-
-- Exported `getTerminalId()` function to get a stable identifier for the current terminal, with support for TTY device paths and terminal multiplexers
-- Exported `getTtyPath()` function to resolve the TTY device path for stdin via POSIX `ttyname(3)`
-
-## [12.5.0] - 2026-02-15
-
-### Added
-
-- Added `cursorOverride` and `cursorOverrideWidth` properties to customize the end-of-text cursor glyph with ANSI-styled strings
-- Added `getUseTerminalCursor()` method to query the terminal cursor mode setting
-
-## [11.10.0] - 2026-02-10
-
-### Added
-
-- Added `hint` property to autocomplete items to display dim ghost text after cursor when item is selected
-- Added `getInlineHint()` method to `SlashCommand` interface for providing inline hint text based on argument state
-- Added `getInlineHint()` method to `AutocompleteProvider` interface for displaying dim ghost text after cursor
-- Added `hintStyle` theme option to customize styling of inline hint/ghost text in editor
-
-### Changed
-
-- Updated editor to render inline hint text as dim ghost text after cursor when autocomplete suggestions are active or provider supplies hints
-
-## [11.8.0] - 2026-02-10
-
-### Added
-
-- Added Alt+Y keybinding to cycle through kill ring entries (yank-pop)
-- Added undo support to Input component with Ctrl+Z keybinding
-- Added kill ring support to Input component for Emacs-style kill/yank operations
-- Added yank (Ctrl+Y) and yank-pop (Alt+Y) support to Input component
-
-### Changed
-
-- Changed Editor kill ring implementation to use dedicated KillRing class for better state management
-- Changed Editor undo stack to use generic UndoStack class with automatic state cloning
-- Changed kill/yank behavior to properly accumulate consecutive kill operations
-- Changed Input component deletion methods to record killed text in kill ring
-- Changed undo coalescing in Input component to group consecutive word typing into single undo units
-
-## [11.4.1] - 2026-02-06
-
-### Fixed
-
-- Fixed terminal scrolling when displaying overlays after rendering large content, preventing hundreds of blank lines from being output
-
-Older entries are archived in [packages/tui/CHANGELOG.md@a66558815743](https://github.com/can1357/oh-my-pi/blob/a66558815743a61164ceebceb2bb528989fb09b3/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@9748d65121ba](https://github.com/can1357/oh-my-pi/blob/9748d65121bac9589d3b136a6d839d76ec52dc2e/packages/tui/CHANGELOG.md).

package/dist/types/apps/git/git-tui.d.ts

@@ -7,7 +7,8 @@
  * scrollbar, right sidebar (file management + commit form while dirty, HEAD
  * commit details with author avatar when clean). Submitting an empty commit
  * form generates an llm-git-compatible message; submitting populated fields
- * commits them. A footer shows key hints.
+ * commits them. A footer shows key hints; the staging and discarding ones are
+ * omitted while the tree is clean, where they cannot fire.
  *
  * `tab` moves focus between the diff and the sidebar; both panes take
  * arrows/PgUp/PgDn, vim motions (`j`/`k`/`h`/`l`/`g`/`G`), and mouse
@@ -22,7 +23,8 @@
  * refreshes. In the sidebar tree `←`/`→` collapse/expand directories,
  * `enter` opens the selected file in the diff pane, `space` stages or
  * unstages the selected row, and `delete` discards it — on a directory,
- * every file underneath it.
+ * every file underneath it. All of the staging and discarding keys are inert
+ * on a clean tree, which shows the HEAD commit instead of a change list.
  */
 import { TUI } from "../../tui.js";
 import type { AvatarSource } from "./avatar.js";
@@ -58,6 +60,17 @@ export interface GitTuiHost {
         stagedAll: boolean;
     }>;
 }
+type Focus = "diff" | "sidebar";
+/**
+ * Footer key hints. A clean tree renders the HEAD commit view, where stage
+ * and discard cannot fire: `#patchTargetFor` returns null and
+ * `#discardCurrentFile` returns early for `area: "commit"` rows, and the
+ * sidebar only builds stage/discard actions for the unstaged/staged
+ * sections. `commit` needs the commit form (absent on a clean tree) and
+ * `select` feeds the line-level stage/discard actions (no-ops on commit
+ * rows), so the commit view drops those too and says what it is showing.
+ */
+export declare function gitFooterHints(clean: boolean, focus: Focus): string;
 /**
  * Mount the git TUI as a fullscreen overlay on an existing TUI (the `/git`
  * slash command). Resolves when the user closes it; the caller restores focus.
@@ -65,3 +78,4 @@ export interface GitTuiHost {
 export declare function showGitOverlay(ui: TUI, host: GitTuiHost): Promise<void>;
 /** Run the fullscreen git TUI standalone (`omp git`) until the user quits. */
 export declare function runGitTui(host: GitTuiHost): Promise<void>;
+export {};

package/dist/types/autocomplete.d.ts

@@ -6,6 +6,8 @@
  */
 export declare function findLeadingSlashCommandStart(text: string): number | null;
 export declare function findTrailingSlashCommandStart(text: string): number | null;
+/** Extract the live whitespace-delimited or double-quoted `@` file token ending at the cursor. */
+export declare function extractAtFilePrefix(text: string): string | null;
 /**
  * Whether an autocomplete value represents a directory: trailing slash or
  * backslash, optionally followed by a closing quote for quoted paths.

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

@@ -2,9 +2,11 @@
  * Draws a {@link ChartSpec} as a standalone SVG document colored only with
  * figure tokens — `var(--fg)`, `var(--muted)`, `var(--border)`,
  * `var(--accent)`, `var(--surface)`, `var(--c1)`…`var(--c6)` — on a
- * transparent background — the token vocabulary of assistant ```svg figures —
- * so the host resolves them against the live theme (`prepareSvg`) for both
- * the rasterized terminal image and the native TSP blob.
+ * transparent background — the token vocabulary of assistant ```svg figures:
+ * the host resolves them against the live theme (`prepareSvg`) for the
+ * rasterized terminal image, and a TSP terminal draws the chart as an ```svg
+ * figure in the palette it shows. The root carries {@link chartAlt} as its
+ * `aria-label`.
  *
  * Styled after Apple's charts and Tern's UI: a UI sans (Geist where Tern
  * provides it), muted labels, hairline gridlines that recede behind the
@@ -39,16 +41,8 @@
  */
 import { type ChartSpec } from "./chart-plan.js";
 import { type Dimension } from "./table-data.js";
-/** A drawn chart: the SVG document and its size in user units. */
-export interface ChartSvg {
-    readonly svg: string;
-    readonly width: number;
-    readonly height: number;
-}
-/** The SVG document for `spec`. */
-export declare function renderChartSvg(spec: ChartSpec): ChartSvg;
-/** One-line description of the chart, for screen readers and terminals that show the alt text. */
-export declare function chartAlt(spec: ChartSpec): string;
+/** The SVG document for `spec`, labeled for screen readers with {@link chartAlt}. */
+export declare function renderChartSvg(spec: ChartSpec): string;
 /**
  * A value in base units as an axis label: durations and sizes in the unit,
  * counts compacted under the suffix (`12k`, `3.4M`), that `magnitude` reads

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

@@ -2,7 +2,6 @@ import type { Tokens } from "@oh-my-pi/pi-utils/marked";
 import { type ChartPlan } from "../charts/chart-plan.js";
 import { type TableAnalysis } from "../charts/table-data.js";
 import type { ImageBudget } from "../components/image.js";
-import type { NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
 /**
  * `smart`: a model refines the local guess where meaning decides (kind,
@@ -24,17 +23,11 @@ export interface TableChartRequest {
  * for no chart. A rejection falls back to the local guess.
  */
 export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null>;
-/** A drawn chart, ready to resolve against the theme. */
-export interface TableChart {
-    /** SVG colored with figure tokens (`var(--accent)`, …). */
-    readonly svg: string;
-    readonly alt: string;
-    /** Size in SVG user units. */
-    readonly width: number;
-    readonly height: number;
-}
-/** The chart under a table: drawn, none, or a smart pick on its way (the promise settles once the cache holds it). */
-export type ChartLookup = TableChart | null | Promise<void>;
+/**
+ * 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).
+ */
+export type ChartLookup = string | null | Promise<void>;
 /** One run of a Markdown block: prose (ending at a charted table), or the chart drawn after that table. */
 export type ChartSegment = {
     readonly kind: "markdown";
@@ -60,10 +53,13 @@ export declare function splitTableCharts(markdown: string, streaming: boolean):
  */
 export declare function lookupTableChart(table: Tokens.Table): ChartLookup;
 /**
- * A native `image` node drawing `chart` from its SVG — no raster — resolved
- * against the active theme; rebuilt when the theme changes.
+ * Chart `svg` as a Markdown ```svg fence, for a TSP terminal's `md` node. Its
+ * figure tokens stay unresolved: the terminal draws the fence as a figure in
+ * the palette it shows the prose in, so the chart cannot fall out of step with
+ * the page when omp's own idea of the appearance does, and a theme switch
+ * recolors it without a resend.
  */
-export declare function describeTableChart(chart: TableChart, key: string): NativeNode;
+export declare function chartFence(svg: string): string;
 export interface TableChartFigureOptions {
     /** Shared inline-image budget. */
     budget?: ImageBudget;

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

@@ -100,6 +100,8 @@ export declare class TranscriptContainer extends Container {
     blockModes(): readonly TranscriptBlockMode[];
     /** Emitted stable semantic-row counts in transcript order. */
     emittedStableRows(): readonly number[];
+    /** Whether any block is still streaming or otherwise unfinalized. */
+    hasActiveBlock(): boolean;
     /** Whether visible active capacity and live-block memory permit another admission. */
     canAdmit(rows: number): boolean;
     /** Prepares one atomic replay of the committed ledger and an emitted active-head prefix. */

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

@@ -8,6 +8,8 @@ export interface ImageOptions {
     maxWidthCells?: number;
     maxHeightCells?: number;
     filename?: string;
+    /** File the image was read from; its link target. Images without one link to a blob copy of their bytes. */
+    sourcePath?: string;
     /** Shared budget that caps how many inline images render as live graphics. */
     budget?: ImageBudget;
     /**

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

@@ -10,6 +10,43 @@ import type { Component } from "../tui.js";
  * byte-identical to rendering `text`.
  */
 export declare function streamingMarkdownSource(text: string): string;
+/**
+ * Streaming `md` source for a native terminal, minus a still-growing table row:
+ * the unterminated last line when a GFM table (a run of pipe lines holding a
+ * header and its delimiter row, outer pipes optional) sits right above it,
+ * outside any open code fence. GFM continues a table on any non-blank line, so
+ * that line is a row whatever it holds so far. The terminal sizes columns by
+ * every row it gets, so a half-streamed row (an unclosed link shows its whole
+ * URL) would rewrap the table each frame, and TSP cannot ask it to skip one.
+ * The result keeps the newline before the held line, so it is a prefix of
+ * `text` and of the result for every append to it: streaming stays
+ * append-only. Pass untrimmed source: trimming first drops the newline that
+ * marks the last row finished, so that row would be held too.
+ */
+export declare function holdPartialTableRow(text: string): string;
+/**
+ * `text`, one inline run whose end is still streaming, with a trailing open
+ * link or math span closed the way the finished text most likely closes it,
+ * or `undefined` when nothing at its end is open. A link gains its missing
+ * `)` (one per open parenthesis in its destination), so it renders as the
+ * link it becomes instead of literal brackets and URL. A math body is cut back
+ * to its last valid form (a half-typed command, dangling `^`/`_`, or the first
+ * `$` of a `$$` closer dropped, open braces closed) and closed, so the
+ * rendered math grows in place instead of raw LaTeX turning into symbols at
+ * the closer. A `$` body needs a LaTeX character, so a price (`$5 per`) is
+ * never speculated. Only prose is: escaped openers and anything inside a code
+ * span, closed or still being written, stay literal.
+ */
+export declare function speculativeInlineClose(text: string): string | undefined;
+/**
+ * Streaming `md` source for a native terminal with the open link or math span
+ * at its end speculatively closed ({@link speculativeInlineClose}), as the TUI
+ * renders it. Only the last block is read (a span cannot cross a blank line),
+ * and source inside an open code fence is left as it is. Each frame rewrites
+ * only the guessed closers at the end, which the reconciler sends as a small
+ * `splice`.
+ */
+export declare function speculativeStreamingSource(text: string): string;
 /** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
 /**

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

@@ -1,12 +1,3 @@
-/**
- * Content-addressed binary blobs (images) for `image` nodes.
- *
- * `describe()` registers the bytes and puts the returned id in `image.p.blob`;
- * the native backend delivers each referenced blob once per terminal
- * connection (asking the terminal first which it holds, or through its blob
- * cache), else uploads it with verb `b` before the frame that first
- * references it.
- */
 import type { TspProps } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode } from "./node.js";
 export interface NativeBlob {
@@ -26,10 +17,19 @@ export declare function nativeImageNode(bytes: Uint8Array, mime: string, p?: Omi
  * so callers cache the node per payload ({@link NativeImageCache}).
  */
 export declare function base64ImageNode(data: string, mimeType: string, p?: Omit<TspProps<"image">, "blob" | "builtin" | "w" | "h">, key?: string): NativeNode;
-/** `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload changes. */
+/**
+ * Props that make an `image` node open the file at `filePath` (as a `file://` URL, the TSP
+ * open-target form): a click zooms the image in the terminal, and the file opens from its
+ * context menu. Empty without a file.
+ */
+export declare function openableImageProps(filePath: string | undefined): Pick<TspProps<"image">, "href" | "actions">;
+/**
+ * `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload
+ * or the link policy changes. Each opens its file (`sourcePath`, else a blob copy).
+ */
 export declare class NativeImageCache {
     #private;
-    get(key: string, data: string, mimeType: string): NativeNode;
+    get(key: string, data: string, mimeType: string, sourcePath?: string): NativeNode;
 }
 /** The disk file a tool result's image was read from (`read` details `mediaPath`), when it has one. */
 export declare function readMediaPath(details: unknown): string | undefined;

package/dist/types/overlays/agent-hub-projection.d.ts

@@ -1,6 +1,9 @@
 import type { AgentMetricsSummary, AgentRecordLike, AgentStatus } from "./agent-hub-types.js";
 import type { ObservableSession } from "./session-observer-registry.js";
 export type AgentMetrics = AgentMetricsSummary;
+export interface AgentCostSnapshot {
+    cost: number | undefined;
+}
 export interface AggregateMetrics extends AgentMetrics {
     reportedAgents: number;
     /** Rows whose duration is an observer-measured active runtime. */
@@ -17,14 +20,16 @@ export declare const STATUS_ORDER: Record<AgentStatus, number>;
 export declare function progressMetrics(observed: ObservableSession | undefined): AgentMetrics | undefined;
 /** Live session used to cache a row's direct assistant usage, including with observer progress. */
 export declare function hubFallbackStatsSession<TRecord extends AgentRecordLike>(ref: TRecord, observed: ObservableSession | undefined): NonNullable<TRecord["session"]> | undefined;
-/**
- * Preserve progress/history for non-cost metrics, overlaying cumulative direct-session cost.
- * Persisted `history.metrics.cost` is a leaf-scoped snapshot, so it never overrides live
- * progress; only the cumulative direct-cost sources do.
- */
+/** Full Agent Hub row metrics; see {@link projectRowMetrics} for source precedence. */
 export declare function hubRowMetrics<TRecord extends AgentRecordLike>(ref: TRecord, observed: ObservableSession | undefined, sessionMetrics: WeakMap<object, {
     metrics: AgentMetrics | undefined;
 }>): AgentMetrics | undefined;
+/** Cost-only projection for frequent status updates; full roster metrics keep their own cache. */
+export declare function aggregateCost<TRecord extends AgentRecordLike>(args: {
+    rows: readonly TRecord[];
+    observedById: ReadonlyMap<string, ObservableSession>;
+    sessionCosts: WeakMap<object, AgentCostSnapshot>;
+}): number;
 export declare function aggregateMetrics<TRecord extends AgentRecordLike>(args: {
     rows: readonly TRecord[];
     observedById: ReadonlyMap<string, ObservableSession>;

package/dist/types/overlays/job-tree.d.ts

@@ -0,0 +1,50 @@
+import type { Theme } from "../theme/theme.js";
+/** What the tree reads off a job. */
+export interface JobTreeJob {
+    readonly id: string;
+    readonly status: "running" | "completed" | "failed" | "cancelled";
+    readonly startTime: number;
+    /** Registry id of the agent that owns the job; absent or the root id: a top-level job. */
+    readonly ownerId?: string;
+    /** Registry id of the subagent a task job runs: the job heads that agent's subtree. */
+    readonly agentId?: string;
+}
+/** A subagent in the tree, by registry id: an owner of listed jobs, or an ancestor linking one to the root. */
+export interface JobTreeAgent {
+    readonly id: string;
+    readonly parentId?: string;
+}
+/** Where a row sits: its depth and the rails drawn left of it. */
+export interface JobTreePlace {
+    /** 0 for the top level. */
+    readonly depth: number;
+    /** Per enclosing level below the top, whether that level's rail continues past this row. */
+    readonly rails: readonly boolean[];
+    /** Whether this row is the last of its siblings. */
+    readonly last: boolean;
+    /** Whether rows nest under this one. */
+    readonly parent: boolean;
+}
+/** One tree row: a job (a task job also heads its subagent), or a header for a subagent with no listed task job. */
+export type JobTreeRow<J extends JobTreeJob> = (JobTreePlace & {
+    readonly kind: "job";
+    readonly job: J;
+    readonly agent?: JobTreeAgent;
+}) | (JobTreePlace & {
+    readonly kind: "agent";
+    readonly agent: JobTreeAgent;
+});
+/**
+ * `jobs` as tree rows in display order. `rootId` is the viewing agent: its
+ * jobs, ownerless jobs and jobs of owners outside `agents` sit at the top
+ * level, as do agents whose parent is the root or unknown.
+ */
+export declare function buildJobTree<J extends JobTreeJob>(jobs: readonly J[], agents: readonly JobTreeAgent[], rootId: string | undefined): JobTreeRow<J>[];
+/** The connector drawn before a row's head: nothing at the top level, else rails then a branch. */
+export declare function jobTreeGuide(row: JobTreePlace, theme: Theme): string;
+/**
+ * The prefix of lines under a row's head (its label, a wrapped command): the
+ * rails that continue past it, then the rail down to its children or blank,
+ * two columns wide so a top-level leaf's lines indent by two.
+ */
+export declare function jobTreeIndent(row: JobTreePlace, theme: Theme): string;

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

@@ -1,5 +1,6 @@
 import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import { type JobTreeAgent } from "./job-tree.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
     readonly id: string;
@@ -8,13 +9,19 @@ export interface JobsPanelJob {
     readonly label: string;
     readonly startTime: number;
     readonly endTime?: number;
+    /** Registry id of the agent that owns the job. */
+    readonly ownerId?: string;
     /** Registry id of the subagent a task job runs. */
     readonly agentId?: string;
 }
-/** Running and recently settled jobs. */
+/** Running and recently settled jobs of an agent and its subagents. */
 export interface JobsPanelSnapshot {
     readonly running: readonly JobsPanelJob[];
     readonly recent: readonly JobsPanelJob[];
+    /** The agent the sheet is for: its jobs sit at the top level, and only they can be cancelled. */
+    readonly rootId?: string;
+    /** Subagents owning listed jobs, with the ancestors linking them to the root. */
+    readonly agents?: readonly JobTreeAgent[];
 }
 /** What the sheet shows about the selected job beyond its row. */
 export interface JobsPanelDetail {
@@ -35,20 +42,26 @@ export interface JobsSheetSource {
     load(): JobsPanelSnapshot;
     /** The selected job's detail; runs once per frame, undefined once the job is gone. */
     inspect(id: string): JobsPanelDetail | undefined;
-    /** Cancel a running job. */
-    cancel(id: string): void;
+    /**
+     * Cancel a running job. Omitted by a read-only sheet (a focused subagent
+     * view, which only watches that agent): it lists the jobs and offers no way
+     * to stop them.
+     */
+    cancel?(id: string): void;
     /** Dismiss the sheet. */
     close(): void;
 }
 /**
  * The jobs pill's sheet: a centred `lg` glass sheet titled Background jobs.
- * A master–detail split (it stacks in a narrow pane): the selectable job list,
- * grouped Running / Recent, beside the selected job's detail — a status pill
- * with live elapsed and Cancel job, its command or task, facts (agent, cwd,
- * live pids, exit code, artifact) and a tail-following output pane. With no
- * jobs it shows an empty state. It re-reads the session every frame, so the
- * caller re-renders it on a timer while it is open. ↑/↓ select, X cancels the
- * selected running job, Esc or Close dismisses; nothing enters the transcript.
+ * A master–detail split (it stacks in a narrow pane): the selectable job tree
+ * beside the selected job's detail — a status pill with live elapsed and
+ * Cancel job, its command or task, facts (agent, cwd, live pids, exit code,
+ * artifact) and a tail-following output pane. With no jobs it shows an empty
+ * state. It re-reads the session every frame, so the caller re-renders it on
+ * a timer while it is open. ↑/↓ select, X cancels the selected running job,
+ * Esc or Close dismisses; nothing enters the transcript. A source without
+ * `cancel` renders read-only, and a subagent's job never offers Cancel: only
+ * the root's own jobs can be stopped here.
  */
 export declare class JobsSheet implements Component {
     #private;
@@ -60,7 +73,7 @@ export declare class JobsSheet implements Component {
     };
     constructor(source: JobsSheetSource);
     describe(_cx: DescribeContext): NativeNode;
-    /** Rows for a terminal without the native surface: one per job, then the selected job's facts and output tail. */
+    /** Rows for a terminal without the native surface: the job tree, then the selected job's facts and output tail. */
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput(data: string): void;

package/dist/types/prompt/composer.d.ts

@@ -59,6 +59,20 @@ export interface RuntimeChildrenOptions {
      * to the roots below the transcript in render order.
      */
     readonly nativeDock?: readonly Component[];
+    /**
+     * Below-transcript roots the user opens and closes (the editor surface that
+     * drafts and dialogs swap into, docked reports). Their rows never become
+     * part of the post-run chrome floor, so collapsing them refills the screen.
+     */
+    readonly transientChrome?: readonly Component[];
+    /**
+     * Transient roots that clear themselves (todo and subagent HUDs, progress).
+     * Their first paint can be their tallest, e.g. a restored todo list on a
+     * resumed session, so unlike {@link transientChrome} it is never treated as
+     * their resting height: all of their rows stay out of the floor. Roots listed
+     * here are transient and need not also appear in `transientChrome`.
+     */
+    readonly selfClearingChrome?: readonly Component[];
 }
 /** Controls the first terminal paint for a composer that does not already own the terminal. */
 export interface ComposerStartOptions {
@@ -157,6 +171,12 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     setPreferences(update: Partial<ComposerPreferences>): void;
     /** Patch welcome data in place as version, session, and project discovery complete. */
     updateWelcome(update: ComposerWelcomeUpdate): void;
+    /**
+     * Mark whether a host agent run is in flight. Mid-run gaps with no streaming
+     * block (tool arguments not yet parseable, between tool calls) then do not
+     * count as the run ending when the post-run chrome floor is decided.
+     */
+    setRunActive(active: boolean): void;
     /** Replace optional header content around the stable welcome scene. */
     setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;
     /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */