@oh-my-pi/pi-tui 18.4.3 → 18.4.5

package/CHANGELOG.md

@@ -2,8 +2,57 @@
 
 ## [Unreleased]
 
+## [18.4.5] - 2026-09-30
+
+### Added
+
+- Added Factory Droid base-credit badges; models without a dollar-price reference no longer appear free ([#8577](https://github.com/can1357/oh-my-pi/pull/8577) by [@will-bogusz](https://github.com/will-bogusz), continued in [#13276](https://github.com/can1357/oh-my-pi/pull/13276) by [@DusKing1](https://github.com/DusKing1)).
+
+### Fixed
+
+- Fixed home directories next to shell redirections, control operators or Markdown emphasis (`<`, `>`, `&`, `|`, `*`, `_`) leaking the full path in display-only text ([#11210](https://github.com/can1357/oh-my-pi/pull/11210) by [@DarkPhilosophy](https://github.com/DarkPhilosophy)).
+- Fixed the subagent task card showing full home paths in tool intents and arguments, while keeping search patterns literal ([#11210](https://github.com/can1357/oh-my-pi/pull/11210) by [@DarkPhilosophy](https://github.com/DarkPhilosophy)).
+- Fixed Enter doing nothing on a fully typed slash-command argument while its completion popup was open (e.g. `/mcp list`): it now submits instead of re-accepting the identical completion; subcommands that still need a required argument (e.g. `/mcp test`) keep inserting the subcommand so you can type it ([#13885](https://github.com/can1357/oh-my-pi/pull/13885) by [@H4vC](https://github.com/H4vC)).
+
+## [18.4.4] - 2026-09-29
+
+### Added
+
+- Added Tern Surface Protocol (TSP) integration for native terminal rendering
+- Redesigned transcript, chat, dashboard, and picker UI components for native wire representation
+- `HookEditorComponent` accepts pasted images when constructed with `acceptImages`; the ask dialog returns them as `customInputImages` / `noteImages` ([#13774](https://github.com/can1357/oh-my-pi/pull/13774) by [@DrFaustus-vic](https://github.com/DrFaustus-vic))
+- Added `formatFileMatches` and `FileMatchSection` to `tools/grouped-file-output` for rendering per-file grep/ast-grep matches in grouped or flat mode.
+
+### Fixed
+
+- The model browser shows `varies`, `included`, or `pricing unknown` for models whose catalog declares that state, instead of labeling them `free` ([#11613](https://github.com/can1357/oh-my-pi/pull/11613) by [@will-bogusz](https://github.com/will-bogusz)).
+
 ## [18.4.3] - 2026-09-28
 
+### Added
+
+- Added the native composer and dock redesign for Tern: the composer carries its attachment chips, a `bash`/`python` mode chip (with an eye-off mark for `!!`/`$$`), a thinking-effort chip that cycles on click, and a send keycap that turns into Stop while a turn runs; the working row shows the intent, elapsed time and an `esc Stop` button (a countdown ring and Cancel while retrying, indeterminate progress while compacting); queued messages are pills with a count and an Edit button; todos and running subagents are HUD pills; the status strip draws context as a ring meter with the auto-compaction tick, splits the path into a dim parent and strong leaf, keeps model, context and git longest, and opens the model picker, `/context`, `/git`, `/usage` or the project folder on click; autocomplete items carry named icons, the matched prefix, the full description, live state as a value, and scroll the selection into view
+- Added the native transcript redesign for Tern: a failed request is one error frame (HTTP status chip, the message once, Retry / Copy error / Switch model), a recovered retry is a quiet disclosable row, user messages drop their header for a hover toolbar (time, Copy, Rewind), thinking streams under a live starburst, timer and rate and folds to "Thought for 12s" when done, status notices are toasts instead of transcript lines, compaction is a centred divider chip, TTSR rules are an inline notice (the rewound text dims with a `rewound` tag), served-model and cache-miss markers are inline notices, late LSP diagnostics join the edit/write frame they belong to, and clicking a recent session on the welcome card resumes it
+- Added native rendering in terminals that speak the Tern Surface Protocol (such as Tern): omp describes its UI as semantic components the terminal lays out, draws and animates in your omp theme (both light and dark variants, updated live when you switch or preview themes), so there is no resize replay or repaint flicker and past transcript entries (tool cards, reactions, collapse state) stay live even after they scroll away; `PI_TUI_NATIVE=0` keeps the classic renderer, `PI_TUI_TSP_RECORD=<file>` records the protocol, and the `OMP_TUI_DEBUG` socket gains `doc`/`tsp` ops
+- Added Tern Surface Protocol views for `/usage` and `/session`: quota windows are native progress meters on per-provider cards, the activity heatmap is a native table that drops its oldest weeks when narrow, the Details tab lists every account's meters, `/session` details are key/value sections, and per-turn token throughput is a native rate
+- Added Tern Surface Protocol views for the remaining tool cards (task, todo, wait, ask, web search, GitHub, goal, LSP, memory, debug, think, vibe, autoresearch, resolve and `xd://` devices): subagents are nested cards, todos are native lists that strike completed items without an animation timer, and job, tool and retry timers are terminal-clocked instead of repainted
+- Added Tern Surface Protocol views for the core tool cards (bash, eval, read, write, edit, AST edit/grep, grep, find, glob, process reads/writes, and the generic fallback card): command and file content, diffs, and search hits with their line numbers are sent as semantic nodes instead of rendered rows
+- Added Tern Surface Protocol views for `omp ps` monitor, the autoresearch dashboard, the live voice call panel and the `/cleanse` live board: processes are native selectable lists (click selects, double-click opens info), experiment runs are a native table, mic level and repair progress are native meters, and spinners/uptimes are terminal-clocked instead of repainted
+- Added Tern Surface Protocol views for the `/btw`, `/btw` history, `/omfg` and `/cleanse` panels, the `/move` dialog, the `/pause` screen, the pinned error banner, hook loaders, the Codex reset celebration and the composer/snapcompact shape previews: answers stream as native markdown, history and directory suggestions are native selectable lists (click selects, double-click follows up or confirms), the snapcompact sample is a native image, and the pause clock, celebration shimmer and cleanse spinners are terminal-clocked instead of repainted
+- Added Tern Surface Protocol views for the prompt editor, inputs, pickers and loaders: the composer is a native editor (caret, Vim selection and mode, ghost completion, placeholder, chip/mention/typo decorations, shimmering magic keywords) with autocomplete as a caret-anchored native list, select and settings lists are native lists where clicking an item does what Enter does, forms, the welcome card and composer attachment chips are semantic nodes, and loader spinners, working-message shimmer and dialog countdowns are terminal-clocked instead of repainted
+- Added Tern Surface Protocol views for the content primitives: text, boxes (cards toned by their background or border), disclosures and sections (collapsible sections that mirror terminal toggles), markdown (streamed append-only as native markdown), images (native blobs), key/value lists, metric rows (priority-dropping segments), tables (column priorities kept), trees, progress bars, tab bars (clicking a tab selects it), wizard steps, scroll views, row/stack/split layouts, output panes (streamed raw output), tool cards, code and markdown cells, file and tree lists, link spans and LaTeX; theme-styled text becomes theme-token spans instead of escape sequences
+- Added Tern Surface Protocol views for the selector and dialog overlays (model hub, model picker and browser, advisor config, settings, plugins, sessions, session tree, rewind, copy, ask, MCP add wizard, hook selector/input/editor, history search, login, OAuth, logout, reset usage, theme, thinking, queue mode, show images): the terminal draws the overlay frame and titles, lists, tabs, search fields, summaries and key hints are native nodes, clicking an item does what Enter does, and dialog countdowns and spinners are terminal-clocked instead of repainted
+- Added Tern Surface Protocol views for the live chrome: the session is described as a flowing transcript plus a docked editor, HUDs and status bar; the status bar is a native strip whose segments drop outer-edge-last from your configured left/right order, its turn spinner, timers, token rate and compaction pulse are terminal-clocked, and the `/context` grid, role-cycle track, key hints and collab QR code are semantic nodes
+- Added Tern Surface Protocol views for the chat transcript: user prompts are cards with reaction and live-steer badges that update in place on old messages, assistant replies stream as append-only native markdown, thinking blocks are collapsible sections with a terminal-clocked starburst and tok/s rate, tool calls are status cards with a live elapsed timer whose collapse (click or `Ctrl+O`) reaches every card in the transcript, `!`/`$` runs are cards with native terminal output, and compaction, branch, handoff, skill, advisor, custom, TTSR, todo-reminder, late-diagnostics and cache-miss/served-model entries are semantic cards, sections and rules
+- Added a native settings page for `/settings`, plugin settings and advisor configuration in Tern: tabs are pages in a side nav with a count of changed settings, each tab has a one-line lead and its groups as sections, settings are real controls (switches, segmented choices, popup menus that preview themes and status-line styles while you hover, steppers for numeric choices, text fields that show your draft and caret, chips and a drag-to-reorder list for multi-selects), changed settings show a dot with the default and a Reset button, risky ones their warning, search results group by page and section, and the status-line preview sits under its section; every pointer action runs the same code as its key
+- Added native picker sheets for rewind, `/tree` and `/copy` in Tern: rewind and copy are a timeline of turns (user prompts with their time, tool turns with the tool's icon) over the transcript; the rewind preview is the turn itself as the transcript draws it under an "everything below is dropped" warning with the count, with branch tabs at a fork and the `f` filter as the search field; `/tree` is an indented tree with the active path marked, labels as badges, filter-mode tabs and the entry's content beside it, and Label edits in the preview; `/copy` previews the turn's code blocks, quotes and links as sections you click to copy, with the focused block highlighted; every button and row click runs the same code as its key
+- Added native picker sheets for the agent hub and `/agents` in Tern: the hub's roster shows each agent's status, task, model and cost/time/request/tool/token/context columns (flat or by parent) with the selected agent's facts, context meter and recent activity beside it, the Activity tab filters the cross-agent log from a side column with a Follow toggle, and `/agents` lists agents by source with their model, prewalk and advisor overrides and previews the description and system prompt; every button runs the same action as its key
+- Added native sheets for omp's dialogs in Tern: plan review is a large sheet titled by the plan's own heading with the Contents as nav rows, annotations as margin notes, Copy / Edit in $EDITOR head buttons and a decision bar whose first option is the hero; the ask dialog is a bottom sheet over the composer with radio/check rows, a Recommended badge, question tabs plus Review, a countdown ring and Submit / Note / Skip buttons; login shows numbered steps (Open sign-in page and Copy link over a one-line URL, a large click-to-copy device code, a live wait, the paste field) with Cancel; `/hotkeys` opens a "Keyboard shortcuts" sheet whose keys are keycaps; the `/btw`, `/omfg`, `/cleanse`, `/btw` history, pause, plan-save, MCP wizard and Codex reset panels are role-styled sheets, and the pinned error banner is an error strip with Details; every button runs the same code as its key
+- Added native full-screen apps in Tern: `omp git`/`/git` is a native diff (File / Split / Inline / Hunks segmented control, change navigation, whitespace and wrap toggles, Stage file) beside a changes sheet with Path/Tree lists, tinted status pills and hover `Stage all`/`Unstage all`, and a docked commit composer (borderless summary with a counter while typing, body, Amend toggle, Commit button); `?` opens a keyboard shortcuts sheet in both renderers; `omp ps` is a page with a scope control, state-toned process rows and an Info / Logs / Restart / Stop / Kill action bar (a pointer Kill asks first); `/cleanse` shows repair lanes as live agent rows under a lane meter; the autoresearch dashboard charts the metric per run and opens as a sheet; the live call panel has a mic meter and Mute / End call buttons; and the `omp cleanse` and `omp setup` pickers are native picker sheets
+- Added native picker sheets for `/resume`, `omp --resume` and ⌃R history search in Tern: sessions are two-line cards (title, first prompt or project folder, age, size, status dot, pin, fork and current badges) grouped Pinned / Today / Yesterday / This week / Earlier and ranked flat while you search (prompt-history matches get a `history` badge), with This folder / All projects tabs, a preview of the selected session's facts and conversation, an inline delete confirmation and Resume / Delete / All projects / Close buttons; `omp --resume` fills the screen; history search is a compact sheet of past prompts with the matches marked, their age and folder, and an Insert button
+- Added native picker sheets for `/model` and the alt+p / `/switch` model picker in Tern: the model hub is a large sheet with Roles, All models and provider scopes (initials marks, live per-query counts, discovery-state dots, signed-out providers grouped under "Not signed in"), kind tabs with counts, right-aligned Int / t/s / context / $/M columns, a Recent group then one group per provider, role chips with thinking-level dots, a preview pane (copyable id, context, output, price, speed, intelligence, the roles the model can fill, description), the role-assignment strip, the Roles view with fallback chains, and loading/empty states; the quick picker is a compact sheet with the model summary and role chips below the list and a Task model toggle; every row, scope, tab, chip and button runs the same path as its key
+- Added Tern Surface Protocol views for the startup splash and setup wizard: the brand mark shimmers natively, every scene (sign-in, model, glyph, composer, theme) is sent as semantic text, spinners, links and inputs, and the splash and outro advance on their deadlines without per-frame repaints
+
 ### Changed
 
 - Reduced frame spikes and memory while long assistant replies retire into scrollback mid-stream: retiring rows no longer re-renders the whole published reply once per row, and the transcript no longer rescans the entire session history every frame ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
@@ -15,6 +64,9 @@
 
 - Fixed streaming bash previews showing fields that follow the `env` object (e.g. `command`) as environment assignments ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
 - Fixed model picker latency by avoiding unnecessary catalog rebuilds
+- Fixed search and filter fields in pickers and lists (model switcher, model and agent hubs, session, history, rewind, tree, hook, sign-in, extension and select lists, the log viewer) ignoring the editor's text keys: every field is now a full single-line input, so word jumps (ctrl/alt+←/→, alt+b/f), line start/end (ctrl+a/e), word and line deletion (ctrl+w/u/k, alt+d), yank, forward delete and undo work everywhere, follow your `tui.editor.*` keybindings, and in Tern the caret is drawn where it actually is in the picker and settings search
+- Fixed omp in Tern showing the classic renderer for the first seconds of startup before switching to the native view: with `TERM_PROGRAM=tern` (outside tmux/screen/zellij, unless `PI_TUI_NATIVE=0`) the very first frame is native, the `hello` handshake confirms it in the background, and a terminal that never confirms falls back to the classic renderer with a clean repaint after 1 s
+- Fixed the welcome card's logo in Tern not matching omp's terminal mark: the bar now overhangs both legs equally, the legs and gap have the terminal proportions, and the left leg ends in the same faded tail
 - Fixed the `@` completion popup showing a `Searching…` placeholder while a refreshed file search is pending; the popup now stays hidden until results arrive, and Escape is no longer swallowed by it
 - Fixed multi-line IME and dictation input (for example, voice input in Ghostty or cmux) being sent as one message per line; it now lands in the prompt as a single multi-line draft, while Enter typed during a UI freeze still submits ([#13378](https://github.com/can1357/oh-my-pi/pull/13378) by [@goransh-walia](https://github.com/goransh-walia))
 

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/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: "omp.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. 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 "@oh-my-pi/pi-ai";
 import { type Component, Container } from "../tui.js";
 import { type ImageBudget } from "../components/image.js";
 import type { AssistantThinkingRenderer } from "./extension-types.js";
+import type { 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,22 @@ export declare class AssistantMessageComponent extends Container {
     setExpanded(expanded: boolean): void;
     isTranscriptBlockFinalized(): boolean;
     render(width: number): readonly string[];
+    /**
+     * A `col` (role `omp.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 (collapsed per
+     * `hideThinkingBlock`): a muted "Thinking…" shimmer while live, then
+     * "Thought for 12s"; tokens and rate ride in the head's `title`.
+     */
+    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 "@oh-my-pi/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 `omp.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 "@oh-my-pi/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 `omp.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 "@oh-my-pi/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 `omp.diagnostics.late`) with one wrapped line
+     * per diagnostic, clamped by the terminal while collapsed.
+     */
+    describe(): NativeNode;
     invalidate(): void;
 }

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 `omp.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/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 `omp.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

package/dist/types/chat/stripped-tool-calls-placeholder.d.ts

@@ -1,4 +1,5 @@
 import { Text } from "../components/text.js";
+import type { NativeNode } from "../native/node.js";
 /**
  * Dim transcript marker for tool calls stripped from the resolved branch
  * (failed/retried turns, results on sibling branches). It is tool activity,
@@ -8,5 +9,7 @@ export declare class StrippedToolCallsPlaceholder extends Text {
     #private;
     constructor(strippedToolCalls: number, toolActivityVisible: boolean);
     setToolActivityVisible(visible: boolean): void;
+    /** A dim italic note, mounted but hidden while tool activity is hidden. */
+    describe(): NativeNode;
     render(width: number): readonly string[];
 }

package/dist/types/chat/todo-reminder.d.ts

@@ -1,5 +1,6 @@
 import { Container } from "../tui.js";
-import type { TodoItem } from "../tools/todo.js";
+import { type TodoItem } from "../tools/todo.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 /**
  * Component that renders a todo completion reminder notification, committed into
  * the transcript like a TTSR notification so it stays anchored in history rather
@@ -10,4 +11,6 @@ export declare class TodoReminderComponent extends Container {
     #private;
     constructor(todos: TodoItem[], attempt: number, maxAttempts: number);
     setToolActivityVisible(visible: boolean): void;
+    /** A `checklist` reminder of the open items where the terminal lists the kind (§7.5); else the notice card. */
+    describe(cx?: DescribeContext): NativeNode;
 }