@linxiraos/pi-tui 1.1.23 → 1.1.24

package/CHANGELOG.md

@@ -2,12 +2,9 @@
 
 ## [Unreleased]
 
-## [1.1.23] - 2026-10-01
+## [1.1.24] - 2026-10-03
 
-## [1.1.22] - 2026-09-30
-
-- CLI bin 命名(zeta-c)相关键位提示文案对齐;组件 API 无破坏。
-- header 支持 `setHeader` 扩展挂点(产品常驻入口圆角按钮),`theme.boxRound` 制表符绘制。
+- 语义角色清扫补全（omp.*→zeta.*，106 文件）；agent-hub 空态提示还原 `omp-dev`；notifications OSC 99 对齐 zeta app id。
 
 ## [14.9.8] - 2026-05-12
 

package/THIRD-PARTY-NOTICES.txt

@@ -1,7 +1,7 @@
-OMP THIRD-PARTY NOTICES
+ZETA THIRD-PARTY NOTICES
 =======================
 
-This generated, self-contained aggregate accompanies OMP release artifacts.
+This generated, self-contained aggregate accompanies Zeta release artifacts.
 It does not replace package-level license files. First-party licensing grants
 no rights in third-party code, fonts, data, or marks identified below.
 
@@ -1046,7 +1046,7 @@ These packages participate only in generation/web build tooling and are not ship
 
 SCOPED NON-PERMISSIVE PACKAGES
 ------------------------------
-The exact @img/sharp-libvips-* 1.2.4 all-target family is LGPL-3.0-or-later. It is not distributed in OMP npm bundles or standalone assets: @huggingface/transformers is always external, installed into a user-side versioned runtime on demand, and sharp is stubbed for speech/text. The dynamically loaded native library remains replaceable. Corresponding source is available from https://github.com/lovell/sharp-libvips.git and upstream libvips sources.
+The exact @img/sharp-libvips-* 1.2.4 all-target family is LGPL-3.0-or-later. It is not distributed in Zeta npm bundles or standalone assets: @huggingface/transformers is always external, installed into a user-side versioned runtime on demand, and sharp is stubbed for speech/text. The dynamically loaded native library remains replaceable. Corresponding source is available from https://github.com/lovell/sharp-libvips.git and upstream libvips sources.
 
 lightningcss 1.32.0 and its exact target leaves are MPL-2.0 build-only dependencies. MPL is not globally allowed and these packages are absent from runtime artifacts.
 

package/dist/types/apps/cleanse-board.d.ts

@@ -1,5 +1,6 @@
 import { type LiveBoardOutput } from "../chrome/live-board.js";
 import type { AgentProgress } from "../tools/task.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 /** Checker identity shown in live rows and verdicts. */
 export interface CleanseCheckerDescriptor {
     id: string;
@@ -59,6 +60,22 @@ export declare class CleanseBoardModel {
     agentProgress(name: string, progress: AgentProgress): void;
     /** Drop the agent's live row, advance the repair bar, and build its permanent outcome line. */
     agentFinished(outcome: CleanseAgentOutcome, assignment: CleanseAssignment): string;
+    /**
+     * Semantic twin of the permanent line the most recent
+     * {@link checkerFinished}/{@link agentFinished} call returned, for native
+     * surfaces that log settled work as nodes.
+     */
+    get lastSettled(): NativeNode | undefined;
+    /**
+     * Native live rows (NATIVE_REDESIGN §10): phase and checker spinners, the
+     * repair head with a `meter` of fixed lanes, and the running repair agents
+     * as a grid of lanes, one `agent` row each (status, current tool with its
+     * intent, tools, tokens, cost, timer). Terminals without `agent`/`meter`
+     * get the plain rows and a `progress` bar. Spinners and timers are
+     * terminal-clocked, so the node only changes when the board state does.
+     * `undefined` while nothing is live.
+     */
+    describeLive(cx: DescribeContext): NativeNode | undefined;
     /** Render the transient live rows for the current spinner frame. */
     renderLive(spinner: string): string[];
 }

package/dist/types/apps/debug/log-viewer.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../../tui.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../../native/node.js";
 /** Host capabilities for copying and fetching earlier log entries. */
 export interface LogViewerDeps {
     copyToClipboard(text: string): void;
@@ -76,6 +77,22 @@ export declare class DebugLogViewerComponent implements Component {
     handleInput(keyData: string): void;
     invalidate(): void;
     dispose(): void;
+    /** A `picker` sheet floats over the transcript instead of taking the screen. */
+    nativeSheet(cx: DescribeContext): boolean;
+    /**
+     * The logs as a picker sheet: the filter as its query, one row per entry
+     * (message, fields, time, pid, level dot) with the session boundary as a
+     * group head, the range selection checked, the entry under the cursor
+     * pretty-printed below, and the keys' actions in the bar. Without the
+     * `picker` kind it falls back to rows.
+     */
+    describe(cx: DescribeContext): NativeNode | null;
+    /**
+     * Pointer actions run the keys' code: a row click moves the cursor there,
+     * a second click copies it (or loads older entries from that row), and the
+     * bar's buttons mirror their keys.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }
 export {};

package/dist/types/apps/debug/raw-sse.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../../tui.js";
+import type { NativeNode, NativeScreen, NativeUiEvent } from "../../native/node.js";
 import { type RawSseDebugBuffer } from "./raw-sse-buffer.js";
 /** @internal Exported for tests. */
 export declare function expandPrettyDataLines(raw: readonly string[]): string[];
@@ -23,4 +24,17 @@ export declare class RawSseViewerComponent implements Component {
     handleInput(keyData: string): void;
     invalidate(): void;
     render(width: number): readonly string[];
+    /** The action bar's buttons run the same code as their keys. */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * The stream as a page of its own: the capture counters over the wire
+     * text, one `ansi` block that fills the page, scrolls itself and follows
+     * its tail until the user scrolls away (Tern-local, so no follow state
+     * here; the scroll keys reach it as `scroll` requests). The copy status
+     * and the buttons are this component's own node, docked under the page
+     * so they never scroll away.
+     */
+    describeScreen(): NativeScreen;
+    /** The docked bar under the stream page: the copy status and the buttons. */
+    describe(): NativeNode;
 }

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

@@ -13,9 +13,9 @@
  * the visible viewport brightened; clicking it seeks. Long lines either pan
  * horizontally (`←`/`→`) or soft-wrap when word wrap is enabled.
  */
-import type { DiffStreamResult } from "@linxiraos/pi-natives";
 import { type ImageBudget } from "../../components/image.js";
 import { type FileAssetSide, type FileStreamUpdate } from "./state.js";
+import { type DiffStreamResult } from "@linxiraos/pi-natives";
 /** Column ranges (inclusive start, exclusive end) carrying intraline emphasis. */
 type MarkRanges = readonly (readonly [number, number])[];
 type RowKind = "context" | "change" | "add" | "del";

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

@@ -0,0 +1,16 @@
+import type { NativeNode } from "../../native/node.js";
+import type { Component } from "../../tui.js";
+/** The shortcuts overlay; any of `?`, escape or `q` closes it. */
+export declare class GitHelpSheet implements Component {
+    #private;
+    readonly nativeOverlay: {
+        readonly role: "zeta.overlay.hotkeys";
+        readonly head: "Keyboard shortcuts";
+        readonly size: "lg";
+    };
+    constructor(close: () => void);
+    handleInput(data: string): void;
+    describe(): NativeNode;
+    render(width: number): readonly string[];
+    invalidate(): void;
+}

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

@@ -13,6 +13,7 @@
 import { Editor } from "../../components/editor.js";
 import { TextFormField } from "../../components/form.js";
 import { type ImageBudget } from "../../components/image.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../../native/node.js";
 import { type AvatarSource } from "./avatar.js";
 import type { ChangedFile, GitViewState } from "./state.js";
 /** Generated conventional commit fields shown in the commit form. */
@@ -138,6 +139,23 @@ export declare class Sidebar {
     /** Select the commit summary input (the `c` shortcut). False on a clean tree. */
     focusCommitForm(): boolean;
     handleInput(data: string): void;
+    /**
+     * The changes sheet (NATIVE_REDESIGN §10): a head with the change count,
+     * the branch and a Path/Tree segmented control; one list per section under
+     * a quiet head whose `Stage all`/`Unstage all` show on hover; the commit
+     * composer docked below. A clean tree shows the HEAD commit instead. Text
+     * fields are live `input`/`editor` nodes only while they own the keys, so
+     * the terminal's caret follows the keyboard.
+     */
+    describe(cx: DescribeContext): NativeNode;
+    /**
+     * Pointer actions on the changes sheet: list clicks select (a folder also
+     * folds, a second click on the selected file stages it, as the ANSI click
+     * does), double clicks activate, the segmented control switches Path/Tree,
+     * and the quiet buttons run their row's action; selection edits go to the
+     * text field being edited. False when not the sidebar's event.
+     */
+    handleNativeEvent(event: NativeUiEvent): boolean;
     /** Wheel scroll over the sidebar. */
     handleWheel(delta: number): void;
     /** Left click at sidebar-local coordinates. */

package/dist/types/apps/live-visualizer.d.ts

@@ -1,5 +1,6 @@
 import type { Component } from "../tui.js";
 import { type KeyId } from "../keys.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Distinct states of a realtime call connection. */
 export type LivePhase = "connecting" | "listening" | "working" | "speaking" | "muted" | "error";
 /** Configuration callbacks for user interactions in the visualizer. */
@@ -28,6 +29,15 @@ export declare class LiveVisualizer implements Component {
     handleInput(data: string): void;
     /** Clears the render cache. */
     invalidate(): void;
+    /** The call panel's buttons run the same code as their keys. */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * Native call panel: phase status (a spinner while working), the mic level
+     * as a `meter` (a `progress` bar on terminals without it), the streaming
+     * transcript and the Mute/End buttons. The spectrum animation is
+     * ANSI-only; frame ticks leave this node unchanged.
+     */
+    describe(cx: DescribeContext): NativeNode;
     /** Renders the microphone spectrum into a compact fixed-height panel. */
     render(width: number): readonly string[];
 }

package/dist/types/apps/ps-top.d.ts

@@ -1,4 +1,5 @@
 import { type Component, TUI } from "../tui.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
 import type { DaemonSnapshot, DaemonSpec } from "../tools/daemon.js";
 import { type PsScope, type PsScopeReport, type PsTarget } from "./ps-data.js";
 /** Options accepted by the interactive monitor: scope selection from the list flags. */
@@ -27,6 +28,20 @@ export declare class PsTopComponent implements Component {
     run(): Promise<void>;
     dispose(): void;
     handleInput(data: string): void;
+    /**
+     * Pointer actions: a click selects a process, a double click opens its info
+     * (Enter); the scope control switches between the current and all scopes;
+     * the action bar runs the same code as the keys, except that a pointer
+     * `Kill` asks first (the `x` key stays immediate).
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * The process monitor as a native page: a head (title, counts, the scope
+     * control, freshness, close), one section per broker scope with a
+     * selectable process list, the transient status, and an action bar that
+     * mirrors the keys. Info and logs replace the list.
+     */
+    describe(): NativeNode;
     render(width: number): readonly string[];
 }
 /** Run the fullscreen interactive process monitor until the user quits. */

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

@@ -8,6 +8,7 @@
  * global theme.
  */
 import type { SelectItem } from "../components/select-list.js";
+import { type SelectPickerOptions } from "../native/picker.js";
 import { TUI, type Component, type OverlayOptions } from "../tui.js";
 /** Build context for a standalone prompt: the owned UI plus its resolver. */
 export interface StandaloneTuiContext<T> {
@@ -29,6 +30,8 @@ export declare function runStandaloneTui<T>(build: (context: StandaloneTuiContex
 export interface StandaloneSelectOptions {
     currentValue?: string;
     maxVisible?: number;
+    /** How the native picker sheet names and marks its items (`noun`, `icon`). */
+    picker?: Pick<SelectPickerOptions, "noun" | "icon" | "subtitle" | "confirm">;
 }
 /**
  * Show a single-column item picker and resolve with the chosen item's value,

package/dist/types/autocomplete.d.ts

@@ -29,6 +29,12 @@ export interface AutocompleteItem {
     description?: string;
     /** Optional type-indicator glyph rendered in an aligned column before the label */
     icon?: string;
+    /** Named icon for TSP terminals (`folder`, `file`, a slash-command icon name). */
+    iconName?: string;
+    /** Native detail when it differs from {@link description} (static text, parent dir). */
+    nativeDetail?: string;
+    /** Live state drawn right-aligned natively ("demo/demo", "off"). */
+    state?: string;
     /** Dim hint text shown inline after cursor when this item is selected */
     hint?: string;
 }
@@ -39,6 +45,8 @@ export interface SlashCommand {
     description?: string;
     /** Optional type-indicator glyph shown before the command name in autocomplete */
     icon?: string;
+    /** Named icon for TSP terminals, drawn instead of the {@link icon} glyph. */
+    iconName?: string;
     argumentHint?: string;
     /** Whether the command consumes argument text after the command name. False means the full input stays normal prompt text once args are present. */
     allowArgs?: boolean;

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

@@ -1,11 +1,21 @@
 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 {
+    /** Transcript-wide expansion (`Ctrl+O`); clears a toggle made in the terminal. */
+    setExpanded(expanded: boolean): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+}
 /**
  * Display-only transcript card for advisor notes injected into the primary
  * session. Styled as a distinct voice so notes never blend into thinking
  * 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.
+ *
+ * `getExpanded` owns expansion; a native toggle overrides it for this card
+ * until the next transcript-wide change.
  */
-export declare function createAdvisorMessageCard(details: AdvisorMessageDetails | undefined, getExpanded: () => boolean, uiTheme: Theme): Component;
+export declare function createAdvisorMessageCard(details: AdvisorMessageDetails | undefined, getExpanded: () => boolean, uiTheme: Theme): AdvisorMessageCard;

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

@@ -2,9 +2,11 @@ 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 CacheInvalidation } from "./cache-invalidation-marker.js";
 import { type ServedModelMismatch } from "./served-model-marker.js";
 import { type TranscriptStableRow } from "../chrome/transcript-container.js";
+import { type TurnUsageSummary } from "../overlays/usage-row.js";
 /** Test-only: clear the shared gauge so observations don't leak across cases. */
 export declare function resetThinkingSpeedTracker(): void;
 /**
@@ -43,6 +45,8 @@ export declare class AssistantMessageComponent extends Container {
      * against the previous turn's cache footprint.
      */
     setCacheInvalidation(info: CacheInvalidation | undefined): void;
+    /** Mark this answer as the end of a turn with the turn's totals (native only: ANSI keeps them in the status line). */
+    setTurnUsage(summary: TurnUsageSummary | undefined): void;
     /**
      * Show or clear the trailing served-model divider. Set once the turn's
      * signed thinking block (or router report) has named the model that actually
@@ -78,6 +82,23 @@ export declare class AssistantMessageComponent extends Container {
     setExpanded(expanded: boolean): void;
     isTranscriptBlockFinalized(): boolean;
     render(width: number): readonly string[];
+    /**
+     * A `col` (role `zeta.assistant`) of `md` nodes keyed by content index, so
+     * streamed deltas reach the terminal as `text append` on the same node;
+     * the tail block carries `stream: true` until the message finalizes.
+     * Thinking blocks are quiet collapsible `section`s: a muted "Thinking…"
+     * shimmer while live, then "Thought for 12s"; tokens and rate ride in the
+     * head's `title`. With `hideThinkingBlock` only the live head shows (collapsed)
+     * and a finished thought emits nothing.
+     */
+    describe(): 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. */
+    handleNativeEvent(event: NativeUiEvent): void;
     /** Width-independent stable identities for the streamed leading thinking run. */
     getTranscriptStableRows(): readonly TranscriptStableRow[];
     /**

package/dist/types/chat/bash-execution.d.ts

@@ -5,6 +5,7 @@ import type { ImageContent } from "@linxiraos/pi-ai";
 import { Container, type TUI } from "../tui.js";
 import type { OutputArtifactError } from "../tools/streaming-output.js";
 import type { TruncationMeta } from "../tools/output-meta.js";
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 /** PTY size for `!` commands: the execution frame's inner content area. */
 export declare function bashPtyViewport(ui: TUI): {
     cols: number;
@@ -25,6 +26,14 @@ export declare class BashExecutionComponent extends Container {
      */
     setExpanded(expanded: boolean): void;
     invalidate(): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * The agent's bash `tool` frame (role `zeta.bash`) with a `you` badge: the
+     * command in the head, the output as an `ansi` mini terminal following its
+     * tail. Terminals without the `tool` kind get a `card` headed by the
+     * command.
+     */
+    describe(cx?: DescribeContext): NativeNode;
     appendOutput(chunk: string): void;
     /** Switch to PTY rendering and feed raw terminal bytes through the vterm replay. */
     appendPtyChunk(chunk: string): void;

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

@@ -39,7 +39,12 @@ export declare class ChatTranscriptBuilder {
     rebuild(entries: TranscriptEntry[]): void;
     /** Append newly persisted entries without rebuilding already rendered rows. */
     append(entries: TranscriptEntry[]): void;
-    /** Toggle tool-output expansion across every expandable component. */
+    /**
+     * Toggle tool-output expansion across every expandable component. Cards a
+     * TSP terminal collapsed or expanded locally mirror that into their own
+     * state, so this re-applies the transcript-wide state to every one of them
+     * even when it equals the previous value.
+     */
     setExpanded(expanded: boolean): void;
     get expanded(): boolean;
     /** Rendered row where a persisted entry begins, after the container has painted once. */

package/dist/types/chat/collab-prompt-message.d.ts

@@ -1,10 +1,14 @@
 import { Container } from "../tui.js";
 import type { CollabPromptDetails } from "./messages.js";
 import type { CustomMessage } from "./messages.js";
+import type { NativeNode } from "../native/node.js";
 /**
  * Renders a collab guest prompt on every participant's transcript: a
  * user-message-styled bubble prefixed with the author's name.
  */
 export declare class CollabPromptMessageComponent extends Container {
+    #private;
     constructor(message: CustomMessage<CollabPromptDetails>);
+    /** A user-toned card headed by the guest's name, with the prompt as markdown. */
+    describe(): NativeNode;
 }

package/dist/types/chat/compaction-summary-message.d.ts

@@ -1,8 +1,16 @@
 import { type Component } from "../tui.js";
 import type { BranchSummaryMessage, CompactionSummaryMessage, CustomMessage } from "./messages.js";
+import type { TspSpan } from "@linxiraos/pi-wire";
+import { type NativeChild, type NativeNode, type NativeUiEvent } from "../native/node.js";
 interface SummaryDividerOptions {
     label: () => string;
+    /** Themed spans of the label for native terminals. */
+    nativeLabel: () => TspSpan[];
     detailMarkdown: () => string;
+    /** Native body when it differs from the markdown detail. */
+    nativeDetail?: () => NativeChild[];
+    /** Semantic role of the native section. */
+    role: string;
 }
 /**
  * Common summary/detail delegate behind the compaction, handoff, and branch
@@ -14,6 +22,13 @@ declare class SummaryMessageComponent implements Component {
     #private;
     constructor(options: SummaryDividerOptions);
     setExpanded(expanded: boolean): void;
+    /**
+     * A collapsible `section` headed by the divider label, with the summary
+     * markdown as its body; expanding is terminal-local and mirrored back
+     * through {@link handleNativeEvent}.
+     */
+    describe(): NativeNode;
+    handleNativeEvent(event: NativeUiEvent): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
     dispose(): void;

package/dist/types/chat/eval-execution.d.ts

@@ -5,6 +5,7 @@
 import { Container, type TUI } from "../tui.js";
 import type { OutputArtifactError } from "../tools/streaming-output.js";
 import type { TruncationMeta } from "../tools/output-meta.js";
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 export type EvalExecutionLanguage = "python" | "js";
 export declare class EvalExecutionComponent extends Container {
     #private;
@@ -18,6 +19,13 @@ export declare class EvalExecutionComponent extends Container {
     getTranscriptBlockVersion(): number;
     setExpanded(expanded: boolean): void;
     invalidate(): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * The agent's eval `tool` frame (role `zeta.eval`) with a `you` badge: the
+     * cell source in the head, its output as an `ansi` mini terminal. Terminals
+     * without the `tool` kind get a `card` with the cell as `code` over the output.
+     */
+    describe(cx?: DescribeContext): NativeNode;
     appendOutput(chunk: string): void;
     setComplete(exitCode: number | undefined, cancelled: boolean, options?: {
         output?: string;

package/dist/types/chat/execution-shared.d.ts

@@ -11,6 +11,8 @@ import { Text } from "../components/text.js";
 import { Container, type TUI } from "../tui.js";
 import type { OutputArtifactError } from "../tools/streaming-output.js";
 import { type TruncationMeta } from "../tools/output-meta.js";
+import type { TspText } from "@linxiraos/pi-wire";
+import type { NativeChild, NativeNode } from "../native/node.js";
 /** Output rows shown while an execution is collapsed. */
 export declare const PREVIEW_LINES = 20;
 /** Maximum visible columns retained from an execution output line. */
@@ -44,6 +46,62 @@ export declare function buildStatusFooter(opts: {
     /** Suppress the "… N more lines" hint (used when sixel passthrough renders the full output). */
     suppressHiddenCount?: boolean;
 }): Text | undefined;
+/** Inputs for {@link describeExecutionCard}. */
+export interface ExecutionCardInput {
+    readonly role: string;
+    readonly head: TspText;
+    /** Excluded from context (`!!`/`$$`): a muted card. */
+    readonly muted: boolean;
+    readonly status: ExecutionStatus;
+    /** `performance.now()` when the run started; drives the live elapsed timer. */
+    readonly startedAt: number;
+    readonly expanded: boolean;
+    /** Body nodes before the output (the eval cell's code). */
+    readonly lead?: readonly NativeChild[];
+    /** Raw terminal output. */
+    readonly output: string;
+    readonly images?: readonly NativeChild[];
+    readonly exitCode: number | undefined;
+    readonly truncation: TruncationMeta | undefined;
+    readonly artifactError?: OutputArtifactError;
+}
+/**
+ * Native card shared by user bash/eval runs: the head with a live `elapsed`
+ * while running, the output as an `ansi` mini terminal that follows its tail
+ * while running, a cancel hint spinner, then exit/truncation notes. The
+ * terminal clamps the collapsed body and owns the "N more lines" affordance.
+ */
+export declare function describeExecutionCard(input: ExecutionCardInput): NativeNode;
+/** Inputs for {@link describeExecutionTool}. */
+export interface ExecutionToolInput {
+    readonly role: string;
+    /** Tool name for the head icon (`bash`, `eval`). */
+    readonly name: string;
+    readonly title: string;
+    /** The command / cell source, shown once in the head. */
+    readonly command: string;
+    readonly lang: string;
+    /** Excluded from context (`!!`/`$$`). */
+    readonly excluded: boolean;
+    readonly status: ExecutionStatus;
+    /** `performance.now()` when the run started / ended. */
+    readonly startedAt: number;
+    readonly endedAt: number | undefined;
+    readonly expanded: boolean;
+    /** Raw terminal output. */
+    readonly output: string;
+    readonly images?: readonly NativeChild[];
+    readonly exitCode: number | undefined;
+    readonly truncation: TruncationMeta | undefined;
+    readonly artifactError?: OutputArtifactError;
+}
+/**
+ * A user `!`/`$` run as the agent's `tool` frame (§6.6): the command in the
+ * head with a `you` badge (plus `not sent` when excluded from context), the
+ * timer, exit chip and cancelled note; the body is the output as an `ansi`
+ * mini terminal following its tail, then one quiet truncation line.
+ */
+export declare function describeExecutionTool(input: ExecutionToolInput): NativeNode;
 /**
  * Derive the post-run status from an exit code + cancellation flag using the
  * same precedence both execution components apply.

package/dist/types/chat/late-diagnostics-message.d.ts

@@ -1,4 +1,5 @@
-import { Container } from "../tui.js";
+import { type Component, Container } from "../tui.js";
+import { type NativeNode, type NativeUiEvent } from "../native/node.js";
 /** One file's worth of late LSP diagnostics, as carried on the transcript message. */
 export interface LateDiagnosticsFile {
     path?: string;
@@ -6,6 +7,13 @@ export interface LateDiagnosticsFile {
     errored?: boolean;
     messages?: string[];
 }
+/**
+ * Native terminals append late diagnostics into the edit/write frame they
+ * belong to: each file goes to the most recent tool component in `blocks`
+ * that accepts it. Returns the files no frame took (all of them on the ANSI
+ * path), for the standalone {@link LateDiagnosticsMessageComponent}.
+ */
+export declare function routeLateDiagnostics(blocks: readonly Component[], files: readonly LateDiagnosticsFile[]): LateDiagnosticsFile[];
 /**
  * Renders late LSP diagnostics (arrived after edit/write returned) in the
  * transcript, reusing the same tree renderer the edit/write tools use so the
@@ -17,5 +25,11 @@ export declare class LateDiagnosticsMessageComponent extends Container {
     setExpanded(expanded: boolean): void;
     setToolActivityVisible(visible: boolean): void;
     render(width: number): readonly string[];
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * A severity-toned card (role `zeta.diagnostics.late`) with one wrapped line
+     * per diagnostic, clamped by the terminal while collapsed.
+     */
+    describe(): NativeNode;
     invalidate(): void;
 }

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

@@ -180,6 +180,10 @@ export interface AdvisorNote {
     severity?: AdvisorSeverity;
     /** Which configured advisor produced this note (omitted for the default advisor). */
     advisor?: string;
+    /** Primary turns completed when note was emitted. */
+    turn?: number;
+    /** Primary turns elapsed before merged-batch delivery. */
+    turnsAgo?: number;
 }
 /** Details payload on the batched `advisor` custom message rendered in the transcript. */
 export interface AdvisorMessageDetails {

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

@@ -3,6 +3,7 @@ import { type Component } from "../tui.js";
 import { Container } from "../tui.js";
 import { type ReadRenderArgs } from "../tools/read.js";
 import type { ToolExecutionHandle } from "./tool-execution.js";
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 export declare function readArgsHaveTarget(args: unknown): boolean;
 /**
  * Whether a read collapses into the compact {@link ReadToolGroupComponent}
@@ -63,5 +64,19 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
     setExpanded(expanded: boolean): void;
     setToolActivityVisible(visible: boolean): void;
     getComponent(): Component;
+    /**
+     * Mirrors the terminal's toggles: the `tool` head (the group's root) is
+     * `Ctrl+O`'s expansion; a fallback preview card collapses on its own
+     * (`setExpanded` resets those).
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * 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.
+     */
+    describe(cx?: DescribeContext): NativeNode;
 }
 export {};

package/dist/types/chat/recap-notice.d.ts

@@ -0,0 +1,13 @@
+import type { NativeNode } from "../native/node.js";
+import { Container } from "../tui.js";
+/**
+ * The idle recap (`recap.*`): where the session stands, written while the user
+ * was away. Stays in the transcript like a thought: a dim italic `※ recap:`
+ * line in ANSI, a history icon beside the italic thought-coloured text in a
+ * native terminal (`zeta.recap`).
+ */
+export declare class RecapNotice extends Container {
+    #private;
+    constructor(recap: string);
+    describe(): NativeNode;
+}

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

@@ -1,5 +1,6 @@
 import { Container } from "../tui.js";
 import type { CustomMessage, SkillPromptDetails } from "./messages.js";
+import { type NativeNode, type NativeUiEvent } from "../native/node.js";
 /**
  * Transcript row for a user-invoked skill. Two layouts, chosen by where the
  * `/skill:<name>` token sat in the submitted draft:
@@ -17,6 +18,14 @@ export declare class SkillMessageComponent extends Container {
     #private;
     constructor(message: CustomMessage<SkillPromptDetails>, imageLinks?: readonly (string | undefined)[]);
     setExpanded(expanded: boolean): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * A user-toned card (role `zeta.skill`): the skill chip (linked to its
+     * SKILL.md) and prompt size in the head, the user's draft as markdown, and
+     * the loaded skill prompt, described only while expanded because it can
+     * be large.
+     */
+    describe(): NativeNode;
     /**
      * Transcript finalization contract (see `FinalizableBlock`): an optimistic
      * `/skill:` row reports `false` so the container keeps it live and removable