@linxiraos/pi-tui 1.2.1 → 1.3.0

package/THIRD-PARTY-NOTICES.txt

@@ -8,8 +8,8 @@ no rights in third-party code, fonts, data, or marks identified below.
 PYTHON DEPENDENCY DISTRIBUTION ROLE
 ===================================
 
-omp-rpc has no third-party runtime dependencies. robomp declares FastAPI,
-Uvicorn, HTTPX, Pydantic, pydantic-settings, python-dotenv, Click, and omp-rpc
+zeta-rpc has no third-party runtime dependencies. robomp declares FastAPI,
+Uvicorn, HTTPX, Pydantic, pydantic-settings, python-dotenv, Click, and zeta-rpc
 as ordinary installer-resolved dependencies. The Python wheels do not vendor
 those projects; each dependency remains a separately installed distribution
 carrying its own license metadata and files. Container/system assemblers must
@@ -79,9 +79,9 @@ uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
 b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
-cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
-printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
-truncate, uname, uniq, wc, whoami, yes.
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nl, nproc,
+paste, printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee,
+touch, tr, truncate, uname, uniq, wc, whoami, yes.
 
   Copyright (c) uutils developers
 
@@ -824,6 +824,56 @@ public licenses.
 
 Creative Commons may be contacted at creativecommons.org.
 
+-------------------------------------------------------------------------------
+scripts/brand/fonts/ANSI Shadow.flf, scripts/brand/fonts/mini.flf
+
+Two FIGlet font files from the standard FIGlet font distribution — the
+figlet.org font set shipped by figlet.js
+(https://github.com/patorjk/figlet.js/tree/master/fonts), fetched from
+figlet.js 1.8.0 — vendored so the welcome/splash brand art
+(`packages/tui/src/prompt/welcome.ts`) is generated reproducibly and offline
+by `bun scripts/brand/generate-logo-art.ts`. Both files are unmodified and
+retain their original FIGlet headers. They are build-time inputs only: no font
+file or font data is compiled into, or shipped with, a Zeta release artifact.
+The fonts' own headers carry their terms:
+
+- `ANSI Shadow.flf` — "ANSI Shadow". Author unknown ("Font Author: ?" in the
+  header); a TheDraw-archive font converted with the FIGlet font editor
+  (http://patorjk.com/figfont-editor). Distributed under the FIGlet font
+  license as carried by the standard FIGlet font set: free to use and
+  redistribute with the header intact.
+- `mini.flf` — "mini" by Glenn Chappell (4/93), from figlet release 2.1
+  (12 Aug 1994), "Includes ISO Latin-1"; modified by Paul Burton
+  <solution@earthlink.net> 12/96. Header grant: "Permission is hereby given to
+  modify this font, as long as the modifier's name is placed on a comment
+  line."
+
+FIGlet renderer — `figlet` 1.8.0 (https://github.com/patorjk/figlet.js), a
+root devDependency used only to generate the art at build time; it is not
+imported by any runtime bundle or shipped artifact.
+
+  MIT License
+
+  Copyright (C) 2014-present Patrick Gillespie and other contributors
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+
 BUN / NPM DEPENDENCY INVENTORY
 ==============================
 This inventory is traversed from bun.lock, not from the host node_modules tree.

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

@@ -17,6 +17,8 @@ interface AppKeybindings {
     "app.model.selectTemporary": true;
     "app.tools.expand": true;
     "app.tools.toggleVisibility": true;
+    "app.ask.hide": true;
+    "app.approval.approve": true;
     "app.editor.external": true;
     "app.message.followUp": true;
     "app.retry": true;
@@ -36,8 +38,8 @@ interface AppKeybindings {
     "app.session.rename": true;
     "app.session.delete": true;
     "app.session.deleteNoninvasive": true;
-    "app.tree.foldOrUp": true;
-    "app.tree.unfoldOrDown": true;
+    "app.tree.previousBranch": true;
+    "app.tree.nextBranch": true;
     "app.plan.toggle": true;
     "app.history.search": true;
     "app.stt.pushToTalk": true;
@@ -238,6 +240,14 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+shift+o";
         readonly description: "Show or hide tool activity";
     };
+    readonly "app.ask.hide": {
+        readonly defaultKeys: "alt+h";
+        readonly description: "Hide or show a pending ask dialog";
+    };
+    readonly "app.approval.approve": {
+        readonly defaultKeys: ["ctrl+enter", "ctrl+q"];
+        readonly description: "Approve a pending tool call";
+    };
     readonly "app.editor.external": {
         readonly defaultKeys: "ctrl+g";
         readonly description: "Open external editor";
@@ -314,13 +324,13 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+backspace";
         readonly description: "Delete session (non-invasive)";
     };
-    readonly "app.tree.foldOrUp": {
-        readonly defaultKeys: ["ctrl+left", "alt+left"];
-        readonly description: "Fold or move up";
+    readonly "app.tree.previousBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the previous branch in /tree";
     };
-    readonly "app.tree.unfoldOrDown": {
-        readonly defaultKeys: ["ctrl+right", "alt+right"];
-        readonly description: "Unfold or move down";
+    readonly "app.tree.nextBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the next branch in /tree";
     };
     readonly "app.plan.toggle": {
         readonly defaultKeys: "alt+shift+p";

package/dist/types/apps/git/diff-pane.d.ts

@@ -118,6 +118,11 @@ export type PaneClick = {
 } | {
     type: "handled";
 } | null;
+/**
+ * The heading of one side of a media/binary change (`Before · PNG · Git LFS`):
+ * `label` plus the side's kind, shared by the ANSI pane and the native compare.
+ */
+export declare function assetTitle(label: string, side: FileAssetSide): string;
 /**
  * Scrollable diff viewport. The root component feeds it key/mouse input and
  * composes its rendered lines into the frame.

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 (`zetacode git`) until the user quits. */
 export declare function runGitTui(host: GitTuiHost): Promise<void>;
+export {};

package/dist/types/apps/git/state.d.ts

@@ -73,11 +73,22 @@ export interface TextFileContents {
     readonly newText: string;
     readonly streamResult: DiffStreamResult;
 }
+/** Where one side of a change lives, so a host viewer (Tern's TSP `media` node) can load it by path. */
+export interface MediaRef {
+    /** Absolute path of the file (repository root joined with its repository path). */
+    readonly path: string;
+    /** Git revision holding this side (`HEAD`, a sha, `:0` for the index); absent for the worktree file. */
+    readonly rev?: string;
+}
 /** Non-text sides rendered as previews or explicit placeholders. */
 export interface AssetFileContents {
     readonly kind: "asset";
     readonly old: FileAssetSide;
     readonly new: FileAssetSide;
+    /** Source of {@link old}; absent when that side is empty. */
+    readonly oldRef?: MediaRef;
+    /** Source of {@link new}; absent when that side is empty. */
+    readonly newRef?: MediaRef;
 }
 /** Loaded file content selected for text diffing or asset preview. */
 export type FileContents = TextFileContents | AssetFileContents;

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/advisor-message.d.ts

@@ -1,6 +1,6 @@
 import { type Component } from "../tui.js";
 import type { AdvisorMessageDetails } from "./messages.js";
-import { type Theme } from "../theme/index.js";
+import type { Theme } from "../theme/index.js";
 import { type NativeUiEvent } from "../native/node.js";
 /** The advisor card: shared by the controlled expansion getter and native toggles. */
 export interface AdvisorMessageCard extends Component {
@@ -14,6 +14,9 @@ export interface AdvisorMessageCard extends Component {
  * output (whose `thinkingText` color equals `toolOutput` in most themes):
  * a bold `customMessageLabel` header tag (skill-card convention), a heavy
  * rail tinted per-note severity, and the note body on the default text color.
+ * Natively it is a callout tinted by its worst note: that severity's icon and
+ * the tally head it, the advisor's name ends the head, and with several notes
+ * each leads with its own severity icon.
  *
  * `getExpanded` owns expansion; a native toggle overrides it for this card
  * until the next transcript-wide change.

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

@@ -2,7 +2,7 @@ import type { AssistantMessage, ImageContent } from "@linxiraos/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 { NativeNode, NativeUiEvent } from "../native/node.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";
 import { type TranscriptStableRow } from "../chrome/transcript-container.js";
@@ -99,13 +99,13 @@ export declare class AssistantMessageComponent extends Container {
      * head's `title`. With `hideThinkingBlock` only the live head shows (collapsed)
      * and a finished thought emits nothing.
      */
-    describe(): NativeNode;
+    describe(cx?: DescribeContext): NativeNode;
     /**
      * A TTSR rule rewound this partial answer: a native terminal dims it and
      * tags it `↺ rewound` (the ANSI render leaves it as it stopped).
      */
     markRewound(): void;
-    /** Mirrors a thinking section collapsed or expanded in the terminal. */
+    /** Mirrors a thinking section collapsed or expanded in the terminal; runs its controls' clicks. */
     handleNativeEvent(event: NativeUiEvent): void;
     /** Width-independent stable identities for the streamed leading thinking run. */
     getTranscriptStableRows(): readonly TranscriptStableRow[];
@@ -130,7 +130,12 @@ export declare class AssistantMessageComponent extends Container {
     setTableChartsVisible(visible: boolean): void;
     /** Toggle only images produced by tool results; assistant-native images remain governed by setImagesVisible. */
     setToolResultImagesVisible(visible: boolean): void;
-    setToolResultImages(toolCallId: string, images: ImageContent[]): void;
+    /**
+     * A grouped read's result images, and `mediaPath`: the file it read that Tern's media viewer
+     * shows (read details), which a native host supporting `media` shows by path instead of the
+     * images. A media-only result (a model, a PDF) passes no images.
+     */
+    setToolResultImages(toolCallId: string, images: ImageContent[], mediaPath?: string): void;
     updateContent(message: AssistantMessage, opts?: {
         transient?: boolean;
     }): void;

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

@@ -1,5 +1,5 @@
 import type { ImageBudget } from "../components/image.js";
-import type { Markdown } from "../components/markdown.js";
+import { type Markdown } from "../components/markdown.js";
 import { Container } from "../tui.js";
 export interface FigureMarkdownOptions {
     /** Markdown for one prose run (and a failed figure's code fallback); FigureMarkdown drives its transience. */
@@ -32,7 +32,12 @@ export declare class FigureMarkdown extends Container {
     /**
      * The trimmed prose ahead of the first figure, or "" when the block opens
      * with one. These are the only rows plain Markdown reproduces byte for
-     * byte, so they are all a transcript may publish ahead of the figure.
+     * byte, so they are all a transcript may publish ahead of the figure. While
+     * that prose is still the streaming tail (no figure follows it yet), only
+     * its settled prefix ({@link Markdown.getLastRenderStableText}) qualifies:
+     * the rest is still being written. Both forms are in
+     * {@link streamingMarkdownSource} form, so the settled prefix stays a byte
+     * prefix of the whole run once a figure splits it off.
      */
     get leadingProse(): string;
     /** Whether a figure's final source still waits for its raster, or a chart for its pick or raster. */

package/dist/types/chat/messages.d.ts

@@ -173,7 +173,9 @@ export declare function isUserInvokedSkillPrompt(message: CustomMessage): boolea
  * reminders, and auto-continues are not turn starts.
  */
 export declare function isUserTurnInitiator(message: CustomMessage): boolean;
-export type AdvisorSeverity = "nit" | "concern" | "blocker";
+/** Advisor note severities, weakest first; ranks severity thresholds such as `advisor.continueSeverity`. */
+export declare const ADVISOR_SEVERITIES: readonly ["nit", "concern", "blocker"];
+export type AdvisorSeverity = (typeof ADVISOR_SEVERITIES)[number];
 /** One queued advice note. */
 export interface AdvisorNote {
     note: string;

package/dist/types/chat/read-tool-group.d.ts

@@ -74,8 +74,8 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
      * The read run as one inline `tool` on terminals that list the kind, else
      * the fallback: a bare `card` (role `zeta.tool.read`) with `Read <path>` or
      * `Read (N)` in the head, a `list` of path items (status tone, link,
-     * correction and conflict detail, nested usage) and, with content previews
-     * on, a `code` block per read clamped by the card's preview while collapsed.
+     * correction and conflict detail, nested usage) and a clamped preview per
+     * read when content previews are on.
      */
     describe(cx?: DescribeContext): NativeNode;
 }

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

@@ -2,7 +2,6 @@ import type { Tokens } from "@linxiraos/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/chat/tool-execution.d.ts

@@ -17,19 +17,21 @@ export interface ToolExecutionOptions {
     /** Allow the name-keyed renderer registry only when the active tool is the built-in implementation. */
     useBuiltInRenderer?: boolean;
 }
+/** A tool result or progress frame as a card shows it. */
+export interface ToolResultFrame {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+}
 export interface ToolExecutionHandle extends Component {
     updateArgs(args: unknown, toolCallId?: string): void;
     updateStreamPreview?(update: unknown): void;
-    updateResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-            data?: string;
-            mimeType?: string;
-        }>;
-        details?: unknown;
-        isError?: boolean;
-    }, isPartial?: boolean, toolCallId?: string): void;
+    updateResult(result: ToolResultFrame, isPartial?: boolean, toolCallId?: string): void;
     setArgsComplete(toolCallId?: string): void;
     setExecutionStarted(toolCallId?: string): void;
     setExpanded(expanded: boolean): void;
@@ -39,6 +41,25 @@ export interface ToolExecutionHandle extends Component {
     /** Seal the block as final history and stop its animations. */
     seal(): void;
 }
+/**
+ * Whether a call that returned with `details.async.state === "running"` stays
+ * parked ({@link ToolExecutionHandle.parkAsBackground}) so its job's later
+ * frames keep filling the card until a `completed`/`failed` frame settles it.
+ * Detached `task` spawns always do; backgrounded `bash`/`eval` jobs only under
+ * native rendering, where the terminal transcript keeps them frozen instead.
+ * Shared by the live event controller and the transcript rebuild.
+ */
+export declare function parksAsBackground(toolName: string, details: unknown): boolean;
+/** The background job state a tool result reports (`details.async.state`: running, completed, failed, cancelled). */
+export declare function asyncJobState(details: unknown): string | undefined;
+/** Whether a frame is a background job's last one: it completed, failed or was cancelled. */
+export declare function isSettledJobFrame(details: unknown): boolean;
+/**
+ * Settle a parked card ({@link parksAsBackground}) with its job's last frame
+ * ({@link isSettledJobFrame}): a completed or failed job is the call's result;
+ * a cancelled one keeps the output it got to and seals the card as cancelled.
+ */
+export declare function settleWithJobFrame(component: ToolExecutionHandle, frame: ToolResultFrame, toolCallId: string): void;
 /** Phase-locked spinner glyph index shared by every live tool block so parallel
  * spinners advance in lockstep instead of each tracking its own start time. */
 export declare function sharedSpinnerFrame(frameCount: number, now?: number): number;
@@ -74,16 +95,7 @@ export declare class ToolExecutionComponent extends Container {
      */
     whenPreviewSettled(timeoutMs?: number): Promise<void>;
     updateStreamPreview(update: unknown): void;
-    updateResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-            data?: string;
-            mimeType?: string;
-        }>;
-        details?: unknown;
-        isError?: boolean;
-    }, isPartial?: boolean, _toolCallId?: string): void;
+    updateResult(result: ToolResultFrame, isPartial?: boolean, _toolCallId?: string): void;
     /**
      * Advance to the shared spinner glyph and repaint just this block. Driven by
      * the single shared spinner ticker (see `registerSpinnerBlock`); the tick is

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

@@ -39,8 +39,9 @@ export declare class UserMessageComponent extends Container implements ReactionT
     /**
      * A head-less user-toned frame with the prompt as markdown under its
      * attached images (titled `#N` like their chips, opening the materialized
-     * file on click): the fill says "you". A quiet toolbar (time, Copy, Rewind) fades in on hover when the
-     * host handles transcript actions. The live-steering marker and the
+     * file on click): the fill says "you". A quiet footer like a turn's usage line
+     * (`⧉ ⏪ · 09:45`: Copy, Rewind, the time sent) fades in at its bottom-left on hover when
+     * the host handles transcript actions. The live-steering marker and the
      * agent's reaction are chips at the bottom-right, so a reaction landing
      * later updates the frame in place, even deep in scrollback.
      */

package/dist/types/chrome/countdown-timer.d.ts

@@ -8,8 +8,9 @@ export declare class CountdownTimer {
     constructor(timeoutMs: number, tui: TUI | undefined, onTick: (seconds: number) => void, onExpire: () => void);
     /**
      * The remaining time as a terminal-clocked `elapsed` node: its age is the
-     * negative remaining time (the start lies in the future), so it counts up
-     * toward zero and freezes there at expiry. The age is taken on the first
+     * negative remaining time (the start lies in the future), so it counts down
+     * to zero and holds there at expiry (no `stopped`: that would freeze it at
+     * zero from the start). The age is taken on the first
      * call after a (re)start, when the node is first written, and the node is
      * reused until {@link reset}.
      */

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

@@ -7,10 +7,9 @@ import type { NativeNode } from "../native/node.js";
  * becomes one hunk; the terminal draws gutters, word emphasis and highlighting.
  * Removed rows carry old line numbers, added rows new ones and context rows
  * old ones, so the other side is derived from the running line delta.
+ * Tern picks the grammar from `path`.
  */
-export declare function nativeDiff(diffText: string, options?: {
-    filePath?: string;
-} & TspProps<"diff">): NativeNode;
+export declare function nativeDiff(diffText: string, props?: TspProps<"diff">): NativeNode;
 export interface RenderDiffOptions {
     /** File path used to resolve indentation (.editorconfig + defaults) */
     filePath?: string;

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

@@ -2,6 +2,51 @@ import { type TokensList } from "@linxiraos/pi-utils/marked";
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
+/**
+ * `text` as the streaming renderer lexes it: OSC 8 terminators unified and
+ * tabs expanded. {@link Markdown.getLastRenderStableText} is a prefix of this
+ * form, not of the raw source, so append-only publishers that mix settled
+ * prefixes with whole blocks must compare both in this form. Rendering it is
+ * 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;
 /**
@@ -140,9 +185,10 @@ export declare class Markdown implements Component {
      */
     describe(_cx: DescribeContext): NativeNode;
     /**
-     * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary that no append can move: it stops in front of a
-     * display-math opener whose block an append could still close. Only
+     * Width-independent source prefix of the last render that no append can
+     * change: up to a frozen Markdown block boundary, stopping in front of a
+     * display-math opener whose block an append could still close, or, while a
+     * list streams as the last block, up to its newest top-level item. Only
      * meaningful while streaming (transient render cache on); grows
      * monotonically under append-only `setText`.
      */

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

@@ -12,6 +12,8 @@ import type { Component } from "../tui.js";
 export declare class Text implements Component {
     #private;
     setIgnoreTight(ignore: boolean): this;
+    /** Override row wrapping when the source carries structural prefixes. */
+    setWrapLine(wrapLine: (line: string, width: number) => string[]): this;
     constructor(text?: string, paddingX?: number, paddingY?: number, customBgFn?: (text: string) => string);
     /** Return bounded text and layout state for debug inspection. */
     debugState(): Record<string, unknown>;

package/dist/types/debug-server.d.ts

@@ -22,6 +22,8 @@ export interface TuiDebugTree {
 export declare class TuiDebugServer {
     #private;
     constructor(tui: TUI, path: string);
+    /** Resolves true once the socket accepts connections, false if listen failed or the server stopped first. */
+    get ready(): Promise<boolean>;
     start(): void;
     stop(): void;
 }