@oh-my-pi/pi-tui 18.4.2 → 18.4.4

package/dist/types/status-line/context-usage.d.ts

@@ -2,6 +2,8 @@ import type { AgentMessage, Tokenizer } from "@oh-my-pi/pi-agent-core";
 import type { CompactionSettings } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Tool as AiTool, Model } from "@oh-my-pi/pi-ai";
 import type { Theme } from "../theme/index.js";
+import { Container } from "../tui.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 interface ContextSkill {
     readonly name: string;
     readonly description?: string;
@@ -70,6 +72,8 @@ export interface ContextBreakdown {
     usedTokens: number;
     autoCompactBufferTokens: number;
     freeTokens: number;
+    /** Where auto-compaction fires, in tokens; undefined when compaction is off. */
+    thresholdTokens?: number;
     /** Estimated snapcompact wire savings; set when requested and a snapcompact.* setting is enabled. */
     snapcompact?: ContextSavingsEstimate;
 }
@@ -150,6 +154,22 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
+/**
+ * Native context-usage panel for terminals without `meter`: the cell grid as
+ * unwrapped styled rows beside the legend. The terminal places the legend
+ * beside the grid, or below it when narrow.
+ */
+export declare function describeContextUsage(breakdown: ContextBreakdown): NativeNode;
+/**
+ * The `/context` transcript block: ANSI renders the titled cell grid between
+ * rules; natively it is one frame, drawn with `meter`s where the terminal
+ * has them and as the glyph grid otherwise.
+ */
+export declare class ContextUsageView extends Container {
+    #private;
+    constructor(breakdown: ContextBreakdown, theme: Theme);
+    describe(cx: DescribeContext): NativeNode;
+}
 /**
  * Render a colorful context-usage panel as ANSI text. Output is a series of
  * lines pairing the grid (left) with the legend (right).

package/dist/types/status-line/footer.d.ts

@@ -1,5 +1,6 @@
 import { type Component } from "../index.js";
 import type { FooterHost, FooterSession } from "./host.js";
+import type { NativeNode } from "../native/node.js";
 /**
  * Footer component that shows pwd, token stats, and context usage
  */
@@ -26,5 +27,12 @@ export declare class FooterComponent implements Component {
      */
     dispose(): void;
     invalidate(): void;
+    /**
+     * Native footer: a `status` bar (path and branch, usage counters, billing
+     * and context on the left, model on the right) plus the extension statuses.
+     * Rebuilt per call from cheap session reads; the node identity holds while
+     * the description is unchanged.
+     */
+    describe(): NativeNode;
     render(width: number): readonly string[];
 }

package/dist/types/status-line/metrics.d.ts

@@ -1,4 +1,5 @@
 import type { Theme } from "../theme/index.js";
+export { normalizePremiumRequests } from "@oh-my-pi/pi-utils";
 /** Inputs whose differences are intentionally preserved between current status segments and the legacy footer. */
 export interface BillingSummaryOptions {
     readonly cost: number;
@@ -11,8 +12,6 @@ export interface BillingSummaryOptions {
         readonly usingSubscription: boolean;
     };
 }
-/** Round premium-request counters without losing legitimate fractional requests. */
-export declare function normalizePremiumRequests(value: number): number;
 /**
  * Shared billing metric presentation. Callers select precision explicitly so
  * the legacy footer keeps three decimals while current status segments keep two.

package/dist/types/status-line/segments.d.ts

@@ -1,5 +1,14 @@
-import type { RenderedSegment, SegmentContext, StatusLineSegment, StatusLineSegmentId } from "./types.js";
+import type { StatusLineSession } from "./host.js";
+import type { RenderedSegment, SegmentContext, SegmentView, StatusLineSegment, StatusLineSegmentId } from "./types.js";
 export type { SegmentContext } from "./types.js";
+/**
+ * The thinking-effort word (`high`, `off`; `auto` until auto thinking resolves
+ * a level), or undefined when the model has no thinking. Drives the native
+ * model segment and the composer's effort chip.
+ */
+export declare function thinkingLevelWord(session: Pick<StatusLineSession, "state" | "isAutoThinking" | "autoResolvedThinkingLevel">): string | undefined;
 export declare const SEGMENTS: Record<StatusLineSegmentId, StatusLineSegment>;
 export declare function renderSegment(id: StatusLineSegmentId, ctx: SegmentContext): RenderedSegment;
+/** Native description of one segment; null when it is hidden or unknown. */
+export declare function describeSegment(id: StatusLineSegmentId, ctx: SegmentContext): SegmentView | null;
 export declare const ALL_SEGMENT_IDS: StatusLineSegmentId[];

package/dist/types/status-line/types.d.ts

@@ -1,5 +1,6 @@
 import type { Model } from "@oh-my-pi/pi-ai";
-import type { SessionState } from "@oh-my-pi/pi-wire";
+import type { SessionState, TspSpan, TspTone } from "@oh-my-pi/pi-wire";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
 import type { ContextLineMode, StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "./schema.js";
 import type { ActiveRepoContext, StatusLineSession } from "./host.js";
 import type { LoopConditionConfig, LoopLimitRuntime } from "./loop.js";
@@ -222,9 +223,47 @@ export interface RenderedSegment {
     content: string;
     visible: boolean;
 }
+/**
+ * A segment described for a TSP terminal: styled spans (theme/semantic
+ * tokens, no ANSI), a named icon, a tone, and terminal-clocked nodes
+ * (`spinner`, `elapsed`, `rate`) laid out after the spans.
+ */
+export interface SegmentView {
+    readonly spans: readonly TspSpan[];
+    readonly icon?: string;
+    readonly tone?: TspTone;
+    readonly motion?: readonly NativeNode[];
+    /** Tooltip on the segment. */
+    readonly title?: string;
+}
+/**
+ * The status line's facts for the native composer. A TSP terminal shows no
+ * status strip: the tab title carries the session, the pane header the path
+ * and branch, and the composer the rest.
+ */
+export interface ComposerFacts {
+    /** `meter` (role `omp.composer.context`): context usage along the composer's top edge. */
+    readonly context: NativeNode;
+    /** The model chip's label: name plus the advisor, fast-mode and slow-mode marks. */
+    readonly model: SegmentView;
+    /**
+     * `status` (role `omp.composer.extras`, `grow: 1`) of the other configured
+     * segments as `seg`s; the bar's flexible space, so present even when empty.
+     */
+    readonly extras: NativeNode;
+    /** `text` (role `omp.composer.usage`): the context share of the window and the session cost. */
+    readonly usage: NativeNode;
+}
+/** Supplies {@link ComposerFacts} and takes the clicks on them (`status.*` actions). */
+export interface ComposerFactsSource {
+    describeComposerFacts(): ComposerFacts;
+    handleNativeEvent(event: NativeUiEvent): void;
+}
 export interface StatusLineSegment {
     id: StatusLineSegmentId;
     render(ctx: SegmentContext): RenderedSegment;
+    /** Native description; null when the segment is hidden. */
+    describe(ctx: SegmentContext): SegmentView | null;
 }
 export interface SeparatorDef {
     left: string;

package/dist/types/stdin-buffer.d.ts

@@ -63,14 +63,17 @@ export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     constructor(options?: StdinBufferOptions);
     process(data: string | Buffer): void;
     /**
-     * Enable or disable unbracketed raw-paste classification. Terminal disables
-     * it once DECRQM confirms bracketed-paste (mode 2004) support: a genuine
-     * paste then always arrives wrapped, so the heuristic can only misfire on
-     * keystrokes an event-loop stall batched into one read (issue #12540).
-     * Disabling flushes any candidate already held by the classification window
-     * as ordinary key events so no buffered input is lost.
+     * Gate unbracketed raw-paste classification on event-loop responsiveness.
+     * Terminal installs a probe once DECRQM confirms bracketed-paste (mode
+     * 2004) support: a genuine paste then always arrives wrapped, so an
+     * unmarked multiline burst is either an input-method commit — IME,
+     * dictation, and emoji commits are typed input, never bracketed (#13344) —
+     * or keystrokes an event-loop stall batched into one read (#12540). A burst
+     * classified while `stalled()` reports a stall is replayed as the original
+     * keys so every Enter submits; otherwise it is delivered as one paste.
+     * `undefined` restores unconditional classification.
      */
-    setRawPasteClassification(enabled: boolean): void;
+    setRawPasteStallProbe(stalled: (() => boolean) | undefined): void;
     flush(): string[];
     clear(): void;
     getBuffer(): string;

package/dist/types/terminal-capabilities.d.ts

@@ -11,7 +11,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;

package/dist/types/terminal.d.ts

@@ -1,3 +1,4 @@
+import { type TspHello } from "./native/encode.js";
 /**
  * Split `data` into chunks whose encoded UTF-8 byte length is no greater than
  * `maxChunkBytes`, preferring a line boundary (`\n`) as the cut point so
@@ -96,6 +97,15 @@ export interface TerminalStartOptions {
      * echoes even while module loading blocks the event loop.
      */
     deferInput?: boolean;
+    /**
+     * Reports whether the event loop is stalled or just recovered from a
+     * stall. Once the terminal confirms bracketed paste, an unmarked multiline
+     * burst is an input-method commit (IME, dictation) delivered as one paste
+     * on a responsive loop, but keystrokes a stall batched into one read —
+     * replayed as keys so Enter submits — while this returns true. Without a
+     * probe every such burst is treated as an input-method commit.
+     */
+    isLoopStalled?: () => boolean;
 }
 /** Identity of an accepted explicit terminal appearance refresh request. */
 export type TerminalAppearanceRequestToken = number;
@@ -113,6 +123,12 @@ export type PrivateModeReportHandler = (mode: number, supported: boolean, confir
  * glossary, so a host can safely repaint — or switch to the nerd preset.
  */
 export type GlyphProtocolReportHandler = (supported: boolean) => void;
+/**
+ * Outcome of the Tern Surface Protocol `hello` probe: the terminal's reply,
+ * or null when it answered the DA1 sentinel first (no TSP) or the probe was
+ * skipped (`PI_TUI_NATIVE=0`, multiplexers).
+ */
+export type TspHelloHandler = (hello: TspHello | null) => void;
 /**
  * Cursor shapes addressable via DECSCUSR (`CSI <n> SP q`). `"default"` (0) hands the shape back to
  * the terminal's own configuration, which is what teardown restores rather than guessing a shape
@@ -223,6 +239,23 @@ export interface Terminal {
      * pi-tui versions keep working.
      */
     onGlyphProtocolReport?(callback: GlyphProtocolReportHandler): void;
+    /**
+     * Register a callback fired once the Tern Surface Protocol `hello` probe
+     * resolves (see {@link TspHelloHandler}); a resolved outcome is replayed to
+     * late subscribers. TSP events arriving afterwards are delivered through
+     * `onInput` as complete `ESC _ tsp;e;… ESC \` strings. Optional so custom
+     * Terminals built against older pi-tui versions keep working.
+     */
+    onTspHello?(callback: TspHelloHandler): void;
+    /** True while the `hello` probe awaits its reply or DA1 sentinel. */
+    readonly tspProbePending?: boolean;
+    /**
+     * The environment names a Tern Surface Protocol terminal
+     * (`TERM_PROGRAM=tern`) and the `hello` probe will run: the TUI takes input
+     * at start and opens its surface before the reply, which then confirms or
+     * revokes it.
+     */
+    readonly tspExpected?: boolean;
 }
 /**
  * True when stdout flows through a ConPTY pseudo-console (native win32, or
@@ -270,6 +303,9 @@ export declare class ProcessTerminal implements Terminal {
     refreshAppearance(requestToken?: TerminalAppearanceRequestToken): TerminalAppearanceRequestToken | void;
     onPrivateModeReport(callback: PrivateModeReportHandler): void;
     onGlyphProtocolReport(callback: GlyphProtocolReportHandler): void;
+    onTspHello(callback: TspHelloHandler): void;
+    get tspProbePending(): boolean;
+    get tspExpected(): boolean;
     start(onInput: (data: string) => void, onResize: () => void, onDisconnect?: () => void, options?: TerminalStartOptions): void;
     enableInput(): void;
     drainInput(maxMs?: number, idleMs?: number): Promise<void>;

package/dist/types/theme/defaults/index.d.ts

@@ -2596,6 +2596,106 @@ export declare const defaultThemes: {
             infoBg: string;
         };
     };
+    "dark-neon-noir": {
+        $schema: string;
+        name: string;
+        vars: {
+            magenta: string;
+            hotMagenta: string;
+            deepMagenta: string;
+            cyan: string;
+            paleCyan: string;
+            deepCyan: string;
+            violet: string;
+            amber: string;
+            ash: string;
+            smoke: string;
+            soot: string;
+            black: string;
+            panelBg: string;
+            selectedBg: string;
+            userMsgBg: string;
+            toolPendingBg: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            customMsgBg: string;
+        };
+        colors: {
+            accent: string;
+            border: string;
+            borderAccent: string;
+            borderMuted: string;
+            success: string;
+            error: string;
+            warning: string;
+            muted: string;
+            dim: string;
+            text: string;
+            thinkingText: string;
+            selectedBg: string;
+            userMessageBg: string;
+            userMessageText: string;
+            customMessageBg: string;
+            customMessageText: string;
+            customMessageLabel: string;
+            toolPendingBg: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            toolText: string;
+            toolTitle: string;
+            toolOutput: string;
+            mdHeading: string;
+            mdLink: string;
+            mdLinkUrl: string;
+            mdCode: string;
+            mdCodeBlock: string;
+            mdCodeBlockBorder: string;
+            mdQuote: string;
+            mdQuoteBorder: string;
+            mdHr: string;
+            mdListBullet: string;
+            toolDiffAdded: string;
+            toolDiffRemoved: string;
+            toolDiffContext: string;
+            link: string;
+            syntaxComment: string;
+            syntaxKeyword: string;
+            syntaxFunction: string;
+            syntaxVariable: string;
+            syntaxString: string;
+            syntaxNumber: string;
+            syntaxType: string;
+            syntaxOperator: string;
+            syntaxPunctuation: string;
+            thinkingOff: string;
+            thinkingMinimal: string;
+            thinkingLow: string;
+            thinkingMedium: string;
+            thinkingHigh: string;
+            thinkingXhigh: string;
+            bashMode: string;
+            statusLineBg: string;
+            statusLineSep: number;
+            statusLineModel: string;
+            statusLinePath: string;
+            statusLineGitClean: string;
+            statusLineGitDirty: string;
+            statusLineContext: string;
+            statusLineSpend: string;
+            statusLineStaged: string;
+            statusLineDirty: string;
+            statusLineUntracked: string;
+            statusLineOutput: string;
+            statusLineCost: string;
+            statusLineSubagents: string;
+            pythonMode: string;
+        };
+        export: {
+            pageBg: string;
+            cardBg: string;
+            infoBg: string;
+        };
+    };
     "dark-nord": {
         $schema: string;
         name: string;

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

@@ -22,4 +22,6 @@ export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" |
 /** Check if a string is a valid ThemeColor value */
 export declare function isValidThemeColor(color: string): color is ThemeColor;
 export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";
+/** Check if a string is a valid ThemeBg value */
+export declare function isValidThemeBg(color: string): color is ThemeBg;
 export type ColorMode = "truecolor" | "256color";

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

@@ -1,3 +1,4 @@
+import type { NativeNode } from "../native/node.js";
 import type { Theme, ThemeColor } from "./theme.js";
 type ShimmerTheme = Pick<Theme, "bold" | "fg" | "getFgAnsi">;
 /** Sweep style for animated shimmer text; `disabled` renders every tier as the mid color. */
@@ -26,6 +27,13 @@ export interface ShimmerSegment {
 export declare const DEFAULT_SHIMMER_PALETTE: ShimmerPalette;
 /** Whether shimmer animations are active (any mode other than `disabled`). */
 export declare function shimmerEnabled(): boolean;
+/**
+ * Describe shimmering segments for a TSP terminal, which clocks the sweep
+ * itself: a `shimmer` node in the active mode, or plain spans in the mid tier
+ * color when shimmer is disabled. Palette tiers given as theme colors travel as
+ * token names; raw-ANSI tiers are dropped (the terminal's theme decides).
+ */
+export declare function describeShimmer(segments: readonly ShimmerSegment[], key?: string): NativeNode;
 /**
  * Apply a shimmer sweep across one or more segments, treating them as a
  * single continuous string for band positioning. Each segment can supply

package/dist/types/theme/theme-class.d.ts

@@ -1,6 +1,8 @@
 import { type ColorMode, type ThemeBg, type ThemeColor } from "./schema.js";
 import type { SessionAccentTheme } from "./session-color.js";
 import { type SlashCommandIconName, type SpinnerType, type SymbolKey, type SymbolPreset } from "./symbols.js";
+/** Theme token of a thinking/effort level name (`off`…`max`); unknown levels (`auto`) map to `thinkingOff`. */
+export declare function thinkingLevelToken(level: string): ThemeColor;
 export declare class Theme {
     #private;
     private readonly mode;

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

@@ -1,5 +1,5 @@
 import type { Terminal } from "../terminal.js";
-import type { ThemeColor } from "./schema.js";
+import { type ThemeColor } from "./schema.js";
 import type { SymbolPreset } from "./symbols.js";
 import type { Theme } from "./theme-class.js";
 export { getAvailableThemes, getAvailableThemesWithPaths, getThemeByName, type ThemeInfo } from "./loader.js";
@@ -59,6 +59,15 @@ export declare function setSymbolPreset(preset: SymbolPreset): Promise<void>;
  * Get the current symbol preset override.
  */
 export declare function getSymbolPresetOverride(): SymbolPreset | undefined;
+/**
+ * Force `preset` while a Tern Surface Protocol surface is live (the terminal's
+ * font carries every Nerd Font glyph, so icons need no Glyph Protocol
+ * registration); `undefined` restores the user's preset. Process-local and
+ * never persisted. Rebuilds the active theme synchronously so the next frame
+ * already uses it, and notifies theme listeners like a preset change. Returns
+ * whether the active theme was rebuilt (callers invalidate render caches).
+ */
+export declare function setNativeSymbolPreset(preset: SymbolPreset | undefined): boolean;
 /**
  * Set color blind mode, recreating the theme with the new setting.
  * When enabled, uses blue instead of green for diff additions.
@@ -94,6 +103,29 @@ export declare function stopThemeWatcher(): void;
  * Used by HTML export to generate CSS custom properties.
  */
 export declare function getResolvedThemeColors(themeName?: string): Promise<Record<string, string>>;
+/** One appearance variant of {@link NativeThemePalette}: token name → `#rrggbb`. */
+export type NativeThemeVariant = Record<string, string>;
+/** omp's resolved theme for a Tern Surface Protocol terminal (the `t` verb body minus `sf`). */
+export interface NativeThemePalette {
+    dark?: NativeThemeVariant;
+    light?: NativeThemeVariant;
+    name: {
+        dark?: string;
+        light?: string;
+    };
+}
+/**
+ * Cheap identity of everything {@link getNativeThemePalette} depends on;
+ * recompute the palette only when it changes.
+ */
+export declare function getNativeThemePaletteKey(): string;
+/**
+ * omp's theme for a native surface: with auto theme, the configured dark and
+ * light themes; otherwise (or while the theme selector previews one) the
+ * active theme under its own appearance only. Themes without a loadable
+ * definition (in-memory instances) contribute nothing.
+ */
+export declare function getNativeThemePalette(): NativeThemePalette;
 /**
  * Check if a theme is a "light" theme by analyzing its status-line background
  * luminance. Loads theme JSON synchronously (built-in or custom file on disk)

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

@@ -1,3 +1,4 @@
+import type { NativeToolView, ToolRenderResult } from "./renderer.js";
 import { type Component } from "../index.js";
 import type { RenderResultOptions } from "./renderer.js";
 import { type Theme } from "../theme/theme.js";
@@ -54,6 +55,8 @@ interface AskRenderArgs {
 export declare function optionMarker(uiTheme: Theme, multi: boolean | undefined, selected: boolean): string;
 /** Render question forms and their recorded answers. */
 export declare const askToolRenderer: {
+    describeCall(args: AskRenderArgs): NativeToolView | undefined;
+    describeResult(result: ToolRenderResult<AskToolDetails>, _options?: RenderResultOptions, args?: AskRenderArgs): NativeToolView | undefined;
     mergeCallAndResult: true;
     renderCall(args: AskRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {

package/dist/types/tools/ast-edit.d.ts

@@ -1,7 +1,7 @@
 import type { Component } from "../tui.js";
 import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultOptions } from "./renderer.js";
 /** Display metadata returned by ast-edit. */
 export interface AstEditToolDetails {
     totalReplacements: number;
@@ -48,6 +48,15 @@ export declare const astEditToolRenderer: {
         details?: AstEditToolDetails;
         isError?: boolean;
     }, options: RenderResultOptions, uiTheme: Theme, args?: AstEditRenderArgs): Component;
+    describeCall(args: AstEditRenderArgs): NativeToolView;
+    describeResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: AstEditToolDetails;
+        isError?: boolean;
+    }, _options: RenderResultOptions, args?: AstEditRenderArgs): NativeToolView;
     mergeCallAndResult: true;
 };
 export {};

package/dist/types/tools/ast-grep.d.ts

@@ -1,7 +1,7 @@
 import type { Component } from "../tui.js";
 import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultOptions } from "./renderer.js";
 /** Display metadata returned by ast-grep. */
 export interface AstGrepToolDetails {
     matchCount: number;
@@ -47,6 +47,15 @@ export declare const astGrepToolRenderer: {
         details?: AstGrepToolDetails;
         isError?: boolean;
     }, options: RenderResultOptions, uiTheme: Theme, args?: AstGrepRenderArgs): Component;
+    describeCall(args: AstGrepRenderArgs): NativeToolView;
+    describeResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: AstGrepToolDetails;
+        isError?: boolean;
+    }, _options: RenderResultOptions, args?: AstGrepRenderArgs): NativeToolView;
     mergeCallAndResult: true;
 };
 export {};

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

@@ -1,5 +1,6 @@
 import { Text } from "../components/text.js";
 import type { Theme } from "../theme/theme.js";
+import type { NativeToolView, ToolRenderResult } from "./renderer.js";
 import type { TruncationResult } from "./streaming-output.js";
 /** Whether a lower or higher metric is better. */
 export type MetricDirection = "lower" | "higher";
@@ -127,7 +128,11 @@ export declare const initExperimentToolRenderer: {
     renderCall(args: {
         name: string;
     }, _options: import("./renderer.js").RenderResultOptions, theme: Theme): Text;
-    renderResult(result: import("./renderer.js").ToolRenderResult<InitExperimentDetails>): Text;
+    renderResult(result: ToolRenderResult<InitExperimentDetails>): Text;
+    describeCall(args: {
+        name: string;
+    }): NativeToolView;
+    describeResult(result: ToolRenderResult<InitExperimentDetails>): NativeToolView | undefined;
 };
 /** Render log-experiment tool calls and results. */
 export declare const logExperimentToolRenderer: {
@@ -135,12 +140,19 @@ export declare const logExperimentToolRenderer: {
         status: ExperimentStatus;
         description: string;
     }, _options: import("./renderer.js").RenderResultOptions, theme: Theme): Text;
-    renderResult(result: import("./renderer.js").ToolRenderResult<LogDetails>, _options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    renderResult(result: ToolRenderResult<LogDetails>, _options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    describeCall(args: {
+        status: ExperimentStatus;
+        description: string;
+    }): NativeToolView;
+    describeResult(result: ToolRenderResult<LogDetails>): NativeToolView | undefined;
 };
 /** Render run-experiment tool calls and results. */
 export declare const runExperimentToolRenderer: {
     renderCall(_args: unknown, _options: import("./renderer.js").RenderResultOptions, theme: Theme): Text;
-    renderResult(result: import("./renderer.js").ToolRenderResult<RunDetails | RunExperimentProgressDetails>, options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    renderResult(result: ToolRenderResult<RunDetails | RunExperimentProgressDetails>, options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    describeCall(): NativeToolView;
+    describeResult(result: ToolRenderResult<RunDetails | RunExperimentProgressDetails>): NativeToolView | undefined;
 };
 /** Persisted experiment notes after an update. */
 export interface UpdateNotesDetails {
@@ -152,5 +164,10 @@ export declare const updateNotesToolRenderer: {
         body: string;
         append_idea?: string;
     }, _options: import("./renderer.js").RenderResultOptions, theme: Theme): Text;
-    renderResult(result: import("./renderer.js").ToolRenderResult<UpdateNotesDetails>, _options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    renderResult(result: ToolRenderResult<UpdateNotesDetails>, _options: import("./renderer.js").RenderResultContextOptions, theme: Theme): Text;
+    describeCall(args: {
+        body: string;
+        append_idea?: string;
+    }): NativeToolView;
+    describeResult(result: ToolRenderResult<UpdateNotesDetails>): NativeToolView | undefined;
 };

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

@@ -1,7 +1,7 @@
 import type { Component } from "../tui.js";
 import { type Theme } from "../theme/theme.js";
 import { type OutputMeta } from "./output-meta.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** Default collapsed shell output preview height. */
 export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
 /** LLM-facing footer appended when a tool call becomes a background job. */
@@ -76,6 +76,11 @@ export declare function getBashEnvForDisplay(args: BashRenderArgs): Record<strin
  * `theme.fg("dim", ...)` form render only the first line as dim.
  */
 export declare function formatBashCommandLines(args: BashRenderArgs, uiTheme: Theme): string[];
+/**
+ * Plain (unstyled) command line for native views: `cd <dir> && NAME="…" <command>`,
+ * built from the same decoded display args (incl. streamed `__partialJson` env) as the ANSI path.
+ */
+export declare function formatBashCommandText(args: BashRenderArgs): string;
 /** Builds a shell transcript renderer with caller-supplied command labels. */
 export declare function createShellRenderer<TArgs>(config: ShellRendererConfig<TArgs>): {
     renderCall(args: TArgs, options: RenderResultOptions, uiTheme: Theme): Component;
@@ -89,6 +94,17 @@ export declare function createShellRenderer<TArgs>(config: ShellRendererConfig<T
     }, options: RenderResultOptions & {
         renderContext?: BashRenderContext;
     }, uiTheme: Theme, args?: TArgs): Component;
+    describeCall(args: TArgs, options: RenderResultOptions): NativeToolView;
+    describeResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: BashToolDetails;
+        isError?: boolean;
+    }, options: RenderResultContextOptions & {
+        renderContext?: BashRenderContext;
+    }, args?: TArgs): NativeToolView;
     mergeCallAndResult: true;
     inline: true;
 };
@@ -105,6 +121,19 @@ export declare const bashToolRenderer: {
     }, options: RenderResultOptions & {
         renderContext?: BashRenderContext;
     }, uiTheme: Theme, args?: BashRenderArgs | undefined): Component;
+    describeCall(args: BashRenderArgs, options: RenderResultOptions): NativeToolView;
+    describeResult(result: {
+        content: {
+            type: string;
+            text?: string;
+        }[];
+        details?: BashToolDetails;
+        isError?: boolean;
+    }, options: RenderResultOptions & {
+        renderContext?: Record<string, unknown>;
+    } & {
+        renderContext?: BashRenderContext;
+    }, args?: BashRenderArgs | undefined): NativeToolView;
     mergeCallAndResult: true;
     inline: true;
 };

package/dist/types/tools/cfg-render.d.ts

@@ -7,7 +7,7 @@
  */
 import type { Component } from "../tui.js";
 import { type Theme } from "../theme/theme.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultOptions } from "./renderer.js";
 import { type CardToolResult } from "./result-card.js";
 /** Summary of a `cfg://` read, attached to read tool details. */
 export interface CfgReadDetails {
@@ -33,5 +33,9 @@ export interface CfgWriteDetails {
 }
 /** Render `read cfg://…`: pending header, or the highlighted listing with counts. */
 export declare function renderCfgRead(url: string, result: CardToolResult | undefined, details: CfgReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+/** TSP view of `read cfg://…`: path and counts in the head, the listing as YAML. */
+export declare function describeCfgRead(url: string, result: CardToolResult | undefined, details: CfgReadDetails | undefined): NativeToolView;
+/** TSP view of `write cfg://…[/save]`: scope/outcome in the head, then `previous → value`. */
+export declare function describeCfgWrite(url: string, content: string | undefined, result: CardToolResult | undefined, details: CfgWriteDetails | undefined): NativeToolView;
 /** Render `write cfg://…[/save]`: the proposed value while pending, then the approved/declined change. */
 export declare function renderCfgWrite(url: string, content: string | undefined, result: CardToolResult | undefined, details: CfgWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;