@oh-my-pi/pi-tui 18.8.6 → 18.8.8

package/dist/types/theme/symbols.d.ts

@@ -2,7 +2,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
 export type SymbolMap = Record<SymbolKey, string>;
 /**
  * Icon vocabulary for slash-command autocomplete type indicators. Each name

package/dist/types/tools/eval.d.ts

@@ -95,7 +95,7 @@ export declare const evalToolRenderer: {
     }, options: RenderResultOptions & {
         renderContext?: EvalRenderContext;
     }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
-    describeCall(args: EvalRenderArgs, _options: RenderResultOptions): NativeToolView;
+    describeCall(args: EvalRenderArgs, options: RenderResultOptions): NativeToolView;
     describeResult(result: {
         content: Array<{
             type: string;

package/dist/types/tools/native-view.d.ts

@@ -72,6 +72,53 @@ export declare function truncationNotice(meta: OutputMeta | undefined): NativeNo
  * truncation / artifact-capture notice from `meta`; undefined when empty.
  */
 export declare function footnoteText(parts: readonly string[], meta?: OutputMeta): NativeNode | undefined;
+/** Drawn lines of a run's input (command, cell code) before its "N more lines" button. */
+export declare const RUN_INPUT_PREVIEW_LINES = 6;
+/**
+ * What a run's foot names: `running` (live clock), `background` (an async job
+ * outlives the call), and the settled outcomes. A failure with an exit code
+ * reads `exit N`; without one, `Failed`.
+ */
+export type RunState = "running" | "background" | "done" | "failed" | "cancelled" | "timed-out";
+/** Inputs of {@link runFoot}. */
+export interface RunFootInput {
+    readonly state: RunState;
+    /** Exit code of a `failed` run; a non-zero code names the state `exit N`. */
+    readonly exitCode?: number;
+    /** Milliseconds run so far (`running`) or in total; the time is omitted when undefined. */
+    readonly elapsedMs?: number;
+    /** Quiet facts (job id, service state, artifact), muted and ` · `-joined. */
+    readonly facts?: readonly string[];
+    /** Truncation / artifact-capture notices, appended to the facts in `warning`. */
+    readonly meta?: OutputMeta;
+}
+/**
+ * The foot line of a run box (`omp.run.foot`): the state word in its tone,
+ * the run time (a live clock while running, frozen once settled) and the
+ * quiet facts. Glyphs are the terminal's styling, never text.
+ */
+export declare function runFoot(input: RunFootInput): NativeNode;
+/** A run's input section: the command or cell source, clamped to {@link RUN_INPUT_PREVIEW_LINES}. */
+export declare function runInput(source: string, p: {
+    role: string;
+    lang: string;
+    wrap: boolean;
+}): NativeNode;
+/** A run's terminal output: follows its tail, clamped to the last `previewLines` lines while folded. */
+export declare function runOutput(output: string, p: {
+    role: string;
+    previewLines: number;
+    key?: string;
+}): NativeNode;
+/**
+ * One run as one box (`omp.run`): input, output, status lines and foot in
+ * order. `tone` tints the box: `error` for a failed run, `warning` for a
+ * timed-out one.
+ */
+export declare function runBox(children: readonly (NativeChild | undefined | false)[], p: {
+    key: string;
+    tone?: TspTone;
+}): NativeNode;
 /** A diagnostic's severity glyph: `x-circle` error, `warn` warning, `info`, `lightbulb` hint, in the severity tone. */
 export declare function diagnosticGlyph(severity: ParsedDiagnostic["severity"]): NativeNode;
 /**

package/dist/types/tools/renderer.d.ts

@@ -25,6 +25,14 @@ export interface RenderResultOptions {
      * Streamed `xd://` previews stay queued until this is set.
      */
     executionStarted?: boolean;
+    /**
+     * Milliseconds since this call began executing (`tool_execution_start`),
+     * or its total once settled; undefined before it starts. Native describe
+     * hooks only.
+     */
+    elapsedMs?: number;
+    /** The call was abandoned without a final result (turn aborted, sealed). Native describe hooks only. */
+    cancelled?: boolean;
 }
 /** Render options for a result, plus the tool-specific context the transcript threads through. */
 export type RenderResultContextOptions = RenderResultOptions & {
@@ -85,6 +93,8 @@ export interface NativeToolHead {
     readonly targetKind?: TspToolProps["targetKind"];
     /** Language for `command` targets. */
     readonly lang?: string;
+    /** The raw command line the head's Copy command button copies (set implicitly by a `command` target). */
+    readonly command?: string;
     /** `file://` link for path targets. */
     readonly href?: string;
     /** Short facts after the target (`+8 −1`, `5 matches · 2 files`). */
@@ -111,10 +121,13 @@ export interface NativeToolView {
     readonly body?: readonly NativeChild[];
     /** Tone override; the frame otherwise derives it from the call status. */
     readonly tone?: TspTone;
-    /** Body clamp while collapsed; `{tail}` keeps the end (terminal output). Defaults to the transcript's preview size. */
+    /**
+     * Body clamp while collapsed; `{tail}` keeps the end (terminal output). Defaults to the transcript's preview size.
+     * `children`: the body stays whole while collapsed and its own `ansi`/`code` previews clamp instead.
+     */
     readonly preview?: TspPreview | {
         readonly tail: number;
-    } | "none";
+    } | "none" | "children";
     /** Starts expanded whatever the transcript's expand state (the todo checklist); the user can still fold it. */
     readonly open?: boolean;
     /** Render frameless (`frame:"inline"`): a head line plus a disclosed body. */

package/dist/types/tools/write.d.ts

@@ -81,7 +81,7 @@ export declare const writeToolRenderer: {
     renderCall(args: WriteRenderArgs, options: RenderResultOptions & WriteStreamingPreviewStateCarrier & {
         renderContext?: WriteRenderContext;
     }, uiTheme: Theme): Component | undefined;
-    renderResult(result: WriteResult, options: RenderResultOptions & {
+    renderResult(result: WriteResult, options: RenderResultOptions & WriteStreamingPreviewStateCarrier & {
         renderContext?: WriteRenderContext;
     }, uiTheme: Theme, args?: WriteRenderArgs): Component;
     describeCall(args: WriteRenderArgs, options: RenderResultOptions & {

package/dist/types/tools/yield.d.ts

@@ -0,0 +1,22 @@
+import type { Theme } from "../theme/theme.js";
+import type { Component } from "../tui.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions, ToolRenderResult } from "./renderer.js";
+import type { YieldItem } from "./task.js";
+/** `yield` arguments as sent; strict-mode providers send omitted optionals as `null`. */
+interface YieldRenderArgs {
+    type?: string | string[] | null;
+    data?: unknown;
+    error?: string | null;
+    /** 1-based workpool item number. */
+    key?: number;
+}
+/** Shows a `yield` call's submitted data instead of its model-facing acknowledgement. */
+export declare const yieldToolRenderer: {
+    renderCall(args: YieldRenderArgs, options: RenderResultOptions, theme: Theme): Component;
+    renderResult(result: ToolRenderResult<YieldItem>, options: RenderResultContextOptions, theme: Theme, args?: YieldRenderArgs): Component;
+    describeCall(args: YieldRenderArgs, options: RenderResultOptions): NativeToolView;
+    describeResult(result: ToolRenderResult<YieldItem>, _options: RenderResultContextOptions, args?: YieldRenderArgs): NativeToolView;
+    mergeCallAndResult: true;
+    animatedPendingPreview: true;
+};
+export {};

package/dist/types/tui.d.ts

@@ -78,6 +78,10 @@ export interface TUIStartOptions {
      * Paint without owning stdin: the terminal stays in cooked mode (kernel
      * echo + line editing at the hardware cursor) until {@link TUI.enableInput}
      * switches to raw input and replays the kernel-buffered keystrokes.
+     *
+     * A terminal expected to speak TSP needs raw input from the start, so it
+     * gets it; its keystrokes are held instead (TSP events and the cell-size
+     * reply still apply) until {@link TUI.releaseHeldInput} replays them.
      */
     deferInput?: boolean;
 }
@@ -169,6 +173,16 @@ export interface Component {
      * Called when theme changes or when component needs to re-render from scratch.
      */
     invalidate?(): void;
+    /**
+     * Optional hook to drop memoized render output (rows, parse and wrap state)
+     * that the next `render()` can rebuild from state the component keeps.
+     * Unlike {@link invalidate}, it must not rebuild anything eagerly: no
+     * renderer or extension callbacks, no image conversions, and no child
+     * replacement or disposal. The next render must return the same rows it
+     * would have returned without the release. Components without it are
+     * simply not released.
+     */
+    releaseRenderCaches?(): void;
     /**
      * Optional hook to set whether this component ignores tight layout mode.
      */
@@ -308,6 +322,7 @@ export declare class Container implements Component {
     /** Dispose every child, then detach it from this container. */
     disposeChildren(): void;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * Propagate teardown to children. Call when the container's children are
      * being permanently discarded (not when they are detached for reuse — use
@@ -458,6 +473,22 @@ export declare class TUI extends Container {
      * path. Idempotent; no-op when input was never deferred.
      */
     enableInput(): void;
+    /**
+     * Replay the keystrokes held since a TSP `deferInput` start through the
+     * normal input path, then deliver input live. Call once the app's key
+     * handlers are installed so a hotkey pressed during startup still fires.
+     * Only keys typed while the start-time focus owner had focus are held. The
+     * hold survives a stop/start until released. Idempotent; no-op when nothing
+     * is held.
+     */
+    releaseHeldInput(): void;
+    /**
+     * Hand held-key ownership from `previous` to `next` when the app replaces
+     * the component focused at start (a swapped-in custom editor), so keys
+     * typed into the replacement stay queued behind the held ones instead of
+     * overtaking them. No-op unless `previous` owns the held keys.
+     */
+    replaceHeldFocus(previous: Component, next: Component): void;
     addStartListener(listener: StartListener): () => void;
     addInputListener(listener: InputListener): () => void;
     removeInputListener(listener: InputListener): void;

package/dist/types/vim.d.ts

@@ -8,8 +8,8 @@
  * This is a usable subset of Vim, not a reimplementation of it (see issue #3299): Normal and Visual
  * modes, the common motions, and operators built from those motions.
  */
-export type VimMode = "insert" | "normal" | "visual" | "visual-line";
-export type VimOperator = "d" | "y" | "c";
+export type VimMode = "insert" | "normal" | "visual" | "visual-line" | "replace";
+export type VimOperator = "d" | "y" | "c" | ">" | "<";
 export interface VimPosition {
     line: number;
     col: number;
@@ -50,6 +50,20 @@ export type VimCommand = {
     count: number;
 } | {
     kind: "undo";
+} | {
+    kind: "replace";
+    from: VimPosition;
+    to: VimPosition;
+    text: string;
+} | {
+    kind: "join";
+    fromLine: number;
+    lines: number;
+} | {
+    kind: "indent";
+    fromLine: number;
+    toLine: number;
+    out: boolean;
 };
 /** Start offset of the grapheme after `col`, clamped to `text.length`. */
 export declare function nextGraphemeStart(text: string, col: number): number;
@@ -62,11 +76,11 @@ export declare class VimState {
     mode: VimMode;
     /** Fixed end of a Visual selection; the cursor is the moving end. */
     anchor: VimPosition | null;
-    /** True while a count, operator, `g`, or text-object prefix is half-typed — Escape cancels it. */
+    /** True while a count, operator, `g`, text-object, find, or `r` prefix is half-typed — Escape cancels it. */
     get pending(): boolean;
     /**
-     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`) — empty when
-     * nothing is pending. Hosts render this next to the mode so a partially entered operator is
+     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`, `"df"`, `"r"`) — empty
+     * when nothing is pending. Hosts render this next to the mode so a partially entered operator is
      * visible instead of silently swallowing the next keystroke.
      */
     get pendingText(): string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.8.6",
+	"version": "18.8.8",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.8.6",
-		"@oh-my-pi/pi-agent-core": "18.8.6",
-		"@oh-my-pi/pi-ai": "18.8.6",
-		"@oh-my-pi/pi-catalog": "18.8.6",
-		"@oh-my-pi/pi-natives": "18.8.6",
-		"@oh-my-pi/pi-utils": "18.8.6",
-		"@oh-my-pi/pi-wire": "18.8.6",
-		"@oh-my-pi/snapcompact": "18.8.6"
+		"@oh-my-pi/omptype": "18.8.8",
+		"@oh-my-pi/pi-agent-core": "18.8.8",
+		"@oh-my-pi/pi-ai": "18.8.8",
+		"@oh-my-pi/pi-catalog": "18.8.8",
+		"@oh-my-pi/pi-natives": "18.8.8",
+		"@oh-my-pi/pi-utils": "18.8.8",
+		"@oh-my-pi/pi-wire": "18.8.8",
+		"@oh-my-pi/snapcompact": "18.8.8"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/chat/advisor-message.ts

@@ -52,6 +52,10 @@ class AdvisorHeader implements Component {
 		this.#uiTheme = uiTheme;
 	}
 
+	releaseRenderCaches(): void {
+		this.#cache = undefined;
+	}
+
 	invalidate(): void {
 		this.#cache = undefined;
 	}
@@ -82,6 +86,10 @@ class AdvisorNotes implements Component {
 		this.#uiTheme = uiTheme;
 	}
 
+	releaseRenderCaches(): void {
+		this.#cache = undefined;
+	}
+
 	invalidate(): void {
 		this.#cache = undefined;
 	}
@@ -236,6 +244,9 @@ export function createAdvisorMessageCard(
 		invalidate(): void {
 			disclosure.invalidate();
 		},
+		releaseRenderCaches(): void {
+			disclosure.releaseRenderCaches();
+		},
 		dispose(): void {
 			disclosure.dispose();
 		},

package/src/chat/assistant-message.ts

@@ -575,6 +575,12 @@ export class AssistantMessageComponent extends Container {
 		}
 	}
 
+	override releaseRenderCaches(): void {
+		super.releaseRenderCaches();
+		this.#dropStableRenders();
+		this.#emergencyText?.releaseRenderCaches();
+	}
+
 	setHideThinkingBlock(hide: boolean): void {
 		this.#hideThinkingBlock = hide;
 		this.#thinkingCollapsed.clear();

package/src/chat/compaction-summary-message.ts

@@ -53,6 +53,10 @@ class DividerSummary implements Component {
 		this.#cache = undefined;
 	}
 
+	releaseRenderCaches(): void {
+		this.#cache = undefined;
+	}
+
 	render(width: number): readonly string[] {
 		width = Math.max(1, width);
 		if (this.#cache?.width === width) return this.#cache.lines;
@@ -150,6 +154,10 @@ class SummaryMessageComponent implements Component {
 		if (this.#ignoreTight !== undefined) this.#disclosure.setIgnoreTight(this.#ignoreTight);
 	}
 
+	releaseRenderCaches(): void {
+		this.#disclosure.releaseRenderCaches();
+	}
+
 	dispose(): void {
 		if (this.#disposed) return;
 		this.#disposed = true;

package/src/chat/execution-shared.ts

@@ -20,6 +20,7 @@ import { DEFAULT_TERMINAL_PREVIEW_LINES, expandKeyHint } from "../render/render-
 import type { TspCardStatus, TspSpan, TspText, TspTone } from "@oh-my-pi/pi-wire";
 import { card, node, span, text } from "../native/describe";
 import type { NativeChild, NativeNode } from "../native/node";
+import { runBox, runFoot, runInput, runOutput, type RunState } from "../tools/native-view";
 
 /** Output rows shown while an execution is collapsed. */
 export const PREVIEW_LINES = 20;
@@ -190,7 +191,7 @@ export interface ExecutionToolInput {
 	/** Tool name for the head icon (`bash`, `eval`). */
 	readonly name: string;
 	readonly title: string;
-	/** The command / cell source, shown once in the head. */
+	/** The command / cell source: the run box's input and the head's Copy command. */
 	readonly command: string;
 	readonly lang: string;
 	/** Excluded from context (`!!`/`$$`). */
@@ -208,39 +209,55 @@ export interface ExecutionToolInput {
 	readonly artifactError?: OutputArtifactError;
 }
 
+const EXECUTION_RUN_STATE: Record<ExecutionStatus, RunState> = {
+	running: "running",
+	complete: "done",
+	cancelled: "cancelled",
+	error: "failed",
+};
+
 /**
- * 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.
+ * A user `!`/`$` run as the agent's `tool` frame (§6.6): a head with a `you`
+ * badge (plus `not sent` when excluded from context) and the command for Copy
+ * command; the body is one run box — the source, the output as an `ansi` mini
+ * terminal following its tail, and the foot (state, time, truncation) — with
+ * any images below it. Timer, exit chip and cancelled note stay head data.
  */
 export function describeExecutionTool(input: ExecutionToolInput): NativeNode {
 	const running = input.status === "running";
-	const body: NativeChild[] = [];
-	if (input.output) body.push(node("ansi", { text: input.output, follow: running }, undefined, "output"));
-	if (input.images) body.push(...input.images);
-	const notes: string[] = [];
-	if (input.truncation) notes.push(formatTruncationMetaNotice(input.truncation));
-	if (input.artifactError) notes.push(formatArtifactErrorNotice(input.artifactError));
-	if (notes.length > 0) {
-		body.push({
-			...text([span(notes.join(" · "), "muted")], { wrap: "word", role: "omp.tool.notice" }),
-			key: "foot",
-		});
-	}
+	const shell = input.name === "bash";
 	const ms = Math.max(0, Math.round((input.endedAt ?? performance.now()) - input.startedAt));
+	const state = EXECUTION_RUN_STATE[input.status];
+	const box = runBox(
+		[
+			runInput(input.command, {
+				role: shell ? "omp.tool.bash.command" : "omp.tool.eval.input",
+				lang: input.lang,
+				wrap: shell,
+			}),
+			input.output.length > 0 &&
+				runOutput(input.output, {
+					role: shell ? "omp.tool.bash.output" : "omp.tool.eval.output",
+					previewLines: DEFAULT_TERMINAL_PREVIEW_LINES,
+				}),
+			runFoot({
+				state,
+				exitCode: input.exitCode,
+				elapsedMs: ms,
+				meta: { truncation: input.truncation, artifactError: input.artifactError },
+			}),
+		],
+		{ key: "run", tone: state === "failed" ? "error" : undefined },
+	);
 	const badges: { text: string; tone?: TspTone; title?: string }[] = [{ text: "you", tone: "user" }];
 	if (input.excluded) badges.push({ text: "not sent", title: "Not sent to the model", tone: "muted" });
-	const hasBody = body.length > 0;
 	return node(
 		"tool",
 		{
 			role: input.role,
 			name: input.name,
 			title: input.title,
-			target: input.command,
-			targetKind: "command",
-			lang: input.lang,
+			command: input.command,
 			badges,
 			status: EXECUTION_CARD_STATUS[input.status],
 			age: running ? ms : undefined,
@@ -248,11 +265,11 @@ export function describeExecutionTool(input: ExecutionToolInput): NativeNode {
 			exit: input.status === "error" ? input.exitCode : undefined,
 			note: input.status === "cancelled" ? "cancelled" : undefined,
 			frame: "card",
-			collapsible: hasBody,
-			collapsed: hasBody ? !input.expanded : undefined,
-			preview: hasBody ? { tail: DEFAULT_TERMINAL_PREVIEW_LINES } : undefined,
+			collapsible: true,
+			collapsed: !input.expanded,
+			preview: "children",
 		},
-		body,
+		[box, ...(input.images ?? [])],
 	);
 }
 

package/src/chat/read-tool-group.ts

@@ -1143,6 +1143,10 @@ export class ReadToolGroupComponent extends Container implements ToolExecutionHa
 		const title = pathDisplay ? `Read ${pathDisplay}` : "Read";
 		let cachedWidth: number | undefined;
 		let cachedLines: string[] | undefined;
+		const dropCache = () => {
+			cachedWidth = undefined;
+			cachedLines = undefined;
+		};
 		const expanded = this.#expanded;
 		const component: Component = {
 			render: (width: number) => {
@@ -1164,10 +1168,8 @@ export class ReadToolGroupComponent extends Container implements ToolExecutionHa
 				cachedWidth = width;
 				return cachedLines;
 			},
-			invalidate: () => {
-				cachedWidth = undefined;
-				cachedLines = undefined;
-			},
+			invalidate: dropCache,
+			releaseRenderCaches: dropCache,
 		};
 		this.addChild(component);
 	}

package/src/chat/skill-message.ts

@@ -271,6 +271,12 @@ class SkillCallout implements Component {
 		this.#lines = undefined;
 	}
 
+	releaseRenderCaches(): void {
+		this.#source = undefined;
+		this.#lines = undefined;
+		this.#box.releaseRenderCaches();
+	}
+
 	render(width: number): readonly string[] {
 		const inner = this.#box.render(Math.max(1, width - 1));
 		if (this.#source === inner && this.#lines !== undefined) return this.#lines;

package/src/chat/table-chart.ts

@@ -16,8 +16,8 @@ import { chartAlt, renderChartSvg } from "../charts/chart-svg";
 import { analyzeTable, type TableAnalysis } from "../charts/table-data";
 import type { ImageBudget } from "../components/image";
 import { lexDocument } from "../components/markdown";
-import { node } from "../native/describe";
-import { registerNativeBlob } from "../native/blobs";
+import { keyed } from "../native/describe";
+import { nativeImageNode } from "../native/blobs";
 import type { NativeNode } from "../native/node";
 import { getThemeEpoch } from "../theme";
 import type { Component } from "../tui";
@@ -85,11 +85,11 @@ interface ChartEntry {
 let chartMode: TableChartMode = "off";
 let chartPlanner: TableChartPlanner | undefined;
 const charts = new Map<string, ChartEntry>();
-/** The theme-resolved native blob last registered for a chart. */
-const kNativeBlob = Symbol("tableChart.nativeBlob");
+/** The theme-resolved image node owning a chart's native bytes. */
+const kNativeImage = Symbol("tableChart.nativeImage");
 
 interface NativeTagged extends TableChart {
-	[kNativeBlob]?: { epoch: number; blob: string };
+	[kNativeImage]?: { epoch: number; image: NativeNode };
 }
 
 /** Set how tables become charts (the host's `tui.autoGraph`) and its `smart` planner; the host rebuilds the transcript after. */
@@ -205,24 +205,21 @@ function drawChart(analysis: TableAnalysis, plan: ChartPlan, guessed = false): T
 export function describeTableChart(chart: TableChart, key: string): NativeNode {
 	const epoch = getThemeEpoch();
 	const tagged: NativeTagged = chart;
-	let entry = tagged[kNativeBlob];
+	let entry = tagged[kNativeImage];
 	if (entry?.epoch !== epoch) {
 		const svg = prepareSvg(chart.svg, svgFigurePalette());
-		entry = { epoch, blob: registerNativeBlob(new TextEncoder().encode(svg), "image/svg+xml") };
-		tagged[kNativeBlob] = entry;
+		entry = {
+			epoch,
+			image: nativeImageNode(new TextEncoder().encode(svg), "image/svg+xml", {
+				alt: chart.alt,
+				w: chart.width,
+				h: chart.height,
+				max: { w: `${Math.round(chart.width / UNITS_PER_COLUMN)}ch` },
+			}),
+		};
+		tagged[kNativeImage] = entry;
 	}
-	return node(
-		"image",
-		{
-			blob: entry.blob,
-			alt: chart.alt,
-			w: chart.width,
-			h: chart.height,
-			max: { w: `${Math.round(chart.width / UNITS_PER_COLUMN)}ch` },
-		},
-		undefined,
-		key,
-	);
+	return keyed(entry.image, key);
 }
 
 export interface TableChartFigureOptions {

package/src/chat/tool-execution.ts

@@ -111,10 +111,13 @@ function resolveEditModeForTool(toolName: string, tool: AgentTool | undefined):
 
 type ToolRendererStage = "call" | "result";
 
-/** A renderer's preview as the fallback card's clamp (`tail` becomes a head clamp of the same size). */
+/**
+ * A renderer's preview as the fallback card's clamp (`tail` becomes a head
+ * clamp of the same size; `children` leaves the clamping to the body's own previews).
+ */
 function cardPreview(preview: NativeToolView["preview"]): TspPreview | undefined {
 	if (preview === undefined) return { lines: DEFAULT_TERMINAL_PREVIEW_LINES };
-	if (preview === "none") return undefined;
+	if (preview === "none" || preview === "children") return undefined;
 	if (preview !== "auto" && "tail" in preview) return { lines: preview.tail };
 	return preview;
 }
@@ -170,6 +173,24 @@ class SafeToolRendererComponent implements Component {
 		invalidate.call(this.#component);
 	}
 
+	releaseRenderCaches(): void {
+		const release = this.#component.releaseRenderCaches;
+		if (release === undefined) return;
+		try {
+			release.call(this.#component);
+		} catch (err) {
+			if (!this.#warned) {
+				this.#warned = true;
+				logger.warn("Tool renderer failed", {
+					tool: this.#toolName,
+					stage: this.#stage,
+					phase: "releaseRenderCaches",
+					error: String(err),
+				});
+			}
+		}
+	}
+
 	setIgnoreTight(ignore: boolean): void {
 		const setIgnoreTight = this.#component.setIgnoreTight;
 		if (setIgnoreTight === undefined) return;
@@ -1007,6 +1028,7 @@ export class ToolExecutionComponent extends Container {
 				target: head?.target,
 				targetKind: head?.targetKind,
 				lang: head?.lang,
+				command: head?.command,
 				href: head?.href,
 				meta: head?.meta,
 				badges: badges.length > 0 ? badges : undefined,
@@ -1106,11 +1128,14 @@ export class ToolExecutionComponent extends Container {
 	 * A renderer that throws falls back to the generic card.
 	 */
 	#nativeView(): NativeToolView {
+		const status = this.#nativeStatus();
 		const options: RenderResultContextOptions = {
 			expanded: this.#expanded,
 			isPartial: this.#isPartial,
 			argsComplete: this.#argsComplete,
 			executionStarted: this.#executionStarted,
+			elapsedMs: this.#elapsedMs(status),
+			cancelled: status === "cancelled",
 			renderContext: this.#buildRenderContext(),
 		};
 		// Custom tools (MCP, extensions) carry their own describe hooks, mirroring