@linxiraos/pi-tui 1.2.1 → 1.3.1

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

@@ -1,11 +1,11 @@
 /**
  * Status line for the speculative first frame, before any session exists.
  *
- * InteractiveMode persists {@link StatusLineStartupData} (settings plus the last
- * session's model and thinking state); the next launch renders it through the
- * real {@link StatusLineComponent} as a fresh, unnamed session at the live
- * terminal width. Path and git branch are read live; context usage is reported
- * unknown so the gauge shows the window without a percent.
+ * InteractiveMode persists {@link StatusLineStartupData} (settings plus the
+ * resolved default role model and status inputs); the next launch renders it
+ * through the real {@link StatusLineComponent} as a fresh, unnamed session at
+ * the live terminal width. Path and git branch are read live; context usage is
+ * reported unknown so the gauge shows the window without a percent.
  *
  * @example
  * ```ts ignore
@@ -22,7 +22,7 @@ import type { StatusLineSettings } from "./types.js";
 export interface StatusLineStartupData {
     readonly settings: StatusLineSettings;
     readonly gitEnabled: boolean;
-    /** Model of the last session; the next fresh session usually starts on it too. */
+    /** Model resolved for the next fresh session's default role. */
     readonly model?: Model;
     readonly thinkingLevel?: ThinkingLevel;
     readonly autoThinking: boolean;

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

@@ -31,6 +31,9 @@ export interface CollabStatus {
     stateOverride?: CollabSessionState | null;
 }
 export interface StatusLineSegmentOptions {
+    pi?: {
+        showProfile?: boolean;
+    };
     model?: {
         showThinkingLevel?: boolean;
     };

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

@@ -61,6 +61,13 @@ export type StdinBufferEventMap = {
 export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     #private;
     constructor(options?: StdinBufferOptions);
+    /**
+     * Whether a bracketed paste has started and its end marker has not arrived.
+     * Terminal skips its per-read DEC 2004 reassertion meanwhile: the host is
+     * evidently in bracketed-paste mode, and a paste delivered one key record
+     * per read would otherwise cost one terminal write per pasted key (#15757).
+     */
+    get pasting(): boolean;
     process(data: string | Buffer): void;
     /**
      * Gate unbracketed raw-paste classification on event-loop responsiveness.

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

@@ -1,6 +1,13 @@
 import type { HangulCompatibilityJamoWidth } from "./utils.js";
 export * from "./terminal-multiplexer.js";
 export { wrapTmuxPassthrough } from "./tmux.js";
+/**
+ * Trusted terminal background when reported; otherwise black for detected dark
+ * appearance or white for detected light appearance, using theme auto-detection.
+ */
+export declare function getTerminalBackgroundColor(): number;
+/** Store an OSC 11 background, or reset to appearance detection (also for tests). */
+export declare function setTerminalBackgroundColor(color: number | undefined): void;
 export declare enum ImageProtocol {
     Kitty = "\u001B_G",
     Iterm2 = "\u001B]1337;File=",
@@ -339,6 +346,14 @@ export interface ParsedKittyPlacementLine {
  * callers fall back to writing the line verbatim.
  */
 export declare function parseKittyDirectPlacementLine(line: string): ParsedKittyPlacementLine | null;
+/**
+ * Rows above its own line that an {@link Image} direct-placement line paints
+ * over: the `CUU(rows-1)` of its lead-in, or 0 for any other line. The renderer
+ * erases those rows before a SIXEL/iTerm2 block is written again, because
+ * those protocols have no delete command and the block's reserved rows are
+ * byte-identical between frames, so the diff never rewrites them.
+ */
+export declare function directPlacementLift(line: string): number;
 /**
  * Rebuild an {@link Image} direct-placement line for the viewport row it is
  * written at. The component-rendered line encodes `CUU(rows-1)`, which clamps
@@ -397,7 +412,7 @@ export declare function getImageDimensions(base64Data: string, mimeType: string)
  * thread; `null` when the encode fails. For output that cannot wait for an
  * off-thread encode.
  */
-export declare function encodeSixelNow(base64Data: string, widthPx: number, heightPx: number): string | null;
+export declare function encodeSixelNow(base64Data: string, widthPx: number, heightPx: number, backgroundRgb?: number): string | null;
 export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): {
     sequence?: string;
     lines?: string[];

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

@@ -38,6 +38,7 @@ declare const registry: readonly [{
         readonly passthrough: typeof import("./tmux.js").wrapTmuxPassthrough;
         readonly settleMs: 100;
     };
+    readonly gatesBracketedPaste: true;
     readonly expandsRepPadding: true;
     readonly expiresSynchronizedOutput: true;
     readonly altRestoreEndsSynchronizedOutput: true;
@@ -100,6 +101,12 @@ export declare function hasTerminalMultiplexerSession(multiplexer: TerminalMulti
  * order. Nested sessions all appear; TERM is not consulted.
  */
 export declare function terminalMultiplexerSessions(env?: NodeJS.ProcessEnv): TerminalMultiplexerModule<TerminalMultiplexer>[];
+/**
+ * Whether OSC 11 background replies are trusted on this platform. Any active
+ * session with `backgroundQueryBrokenOn` matching the platform makes the entire
+ * path untrusted; TERM-only classification does not identify an active session.
+ */
+export declare function isTerminalBackgroundQueryTrusted(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
 /**
  * The multiplexer TERM names, whether or not its session markers survived.
  * This is classification's TERM fallback; session markers are not consulted.

package/dist/types/terminal.d.ts

@@ -117,7 +117,7 @@ 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).
+ * skipped (`PI_TUI_NATIVE=0`, multiplexers, devenv's reloading shell).
  */
 export type TspHelloHandler = (hello: TspHello | null) => void;
 /**
@@ -181,6 +181,7 @@ export interface Terminal {
     get kittyEnableSequence(): string | null;
     readonly keyboardEnhancementEnterSequence?: string | null;
     readonly keyboardEnhancementExitSequence?: string | null;
+    readonly keyboardEnhancementRestoreSequence?: string | null;
     moveBy(lines: number): void;
     hideCursor(force?: boolean): void;
     showCursor(force?: boolean): void;
@@ -283,9 +284,11 @@ export interface ProcessTerminalOptions {
     conpty?: boolean;
     /**
      * Whether stdin is a native Windows console handle (win32, not WSL), whose
-     * console host answers `CSI ? 9001 h` with win32-input-mode key records.
-     * Defaults to `process.platform === "win32"`; only consulted when `conpty`
-     * is also true.
+     * console host is certain to answer `CSI ? 9001 h` with win32-input-mode key
+     * records. When false (WSL), the keyboard fallback requests modifyOtherKeys
+     * alongside win32-input-mode, since a WSL pty may not be relayed by a console
+     * host. Defaults to `process.platform === "win32"`; only consulted when
+     * `conpty` is also true.
      */
     nativeWindowsConsole?: boolean;
 }
@@ -298,6 +301,7 @@ export declare class ProcessTerminal implements Terminal {
     get kittyProtocolActive(): boolean;
     get kittyEnableSequence(): string | null;
     get keyboardEnhancementEnterSequence(): string | null;
+    get keyboardEnhancementRestoreSequence(): string | null;
     get keyboardEnhancementExitSequence(): string | null;
     get appearance(): TerminalAppearance | undefined;
     onAppearanceChange(callback: (appearance: TerminalAppearance, requestToken?: TerminalAppearanceRequestToken) => void): void;

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

@@ -9,7 +9,7 @@ export type SymbolMap = Record<SymbolKey, string>;
  * resolves through `Theme.cmd` to either a dedicated `cmd.*` symbol or an
  * existing `icon.*` symbol shared with the rest of the UI.
  */
-export type SlashCommandIconName = "action" | "prompt" | "extension" | "settings" | "gear" | "shield" | "wave" | "compass" | "inbox" | "swap" | "expand" | "computer" | "eye" | "todo" | "stats" | "news" | "keyboard" | "export" | "clipboard" | "share" | "broadcast" | "globe" | "copy" | "plus" | "restart" | "eraser" | "trash" | "compress" | "vibrate" | "handoff" | "history" | "question" | "rocket" | "stethoscope" | "redo" | "bug" | "memory" | "pencil" | "folderMove" | "folderPlus" | "folderMinus" | "hammer" | "power" | "cart" | "model" | "plan" | "prewalk" | "goal" | "pause" | "loop" | "session" | "jobs" | "gauge" | "context" | "agents" | "branch" | "tree" | "signIn" | "signOut" | "advisor" | "host" | "package" | "fast" | "voice" | "tools" | "rule" | "skill" | "mcp" | "pin";
+export type SlashCommandIconName = "action" | "prompt" | "extension" | "settings" | "gear" | "shield" | "wave" | "compass" | "inbox" | "swap" | "expand" | "computer" | "eye" | "todo" | "stats" | "news" | "keyboard" | "export" | "clipboard" | "share" | "broadcast" | "globe" | "copy" | "plus" | "restart" | "eraser" | "trash" | "compress" | "vibrate" | "handoff" | "history" | "question" | "rocket" | "stethoscope" | "redo" | "bug" | "memory" | "pencil" | "folderMove" | "folderPlus" | "folderMinus" | "hammer" | "power" | "cart" | "model" | "plan" | "prewalk" | "goal" | "pause" | "loop" | "session" | "jobs" | "gauge" | "context" | "ghost" | "agents" | "branch" | "tree" | "signIn" | "signOut" | "advisor" | "host" | "package" | "fast" | "voice" | "tools" | "rule" | "skill" | "mcp" | "pin";
 export declare const SYMBOL_PRESETS: Record<SymbolPreset, SymbolMap>;
 export type SpinnerType = "status" | "activity";
 export declare const SPINNER_FRAMES: Record<SymbolPreset, Record<SpinnerType, string[]>>;

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

@@ -7,6 +7,17 @@ export { isValidThemeColor, type ThemeBg, type ThemeColor } from "./schema.js";
 export { getAvailableSymbolPresets, isValidSymbolPreset, type SpinnerType, type SymbolKey, type SymbolPreset, } from "./symbols.js";
 export { Theme } from "./theme-class.js";
 export { createHighlightStream, getEditorTheme, getMarkdownTheme, getMarkdownThemeWithLinkTargets, getSelectListTheme, getSettingsListTheme, getSymbolTheme, highlightCode, setMarkdownMermaidRendering, warmHighlighter, } from "./tui-adapters.js";
+/**
+ * Subscribe to native fallback appearance changes independently of theme changes.
+ * Consumers must re-check the effective background: COLORFGBG can override it.
+ */
+export declare function onTerminalBackgroundFallbackChange(callback: () => void): () => void;
+/**
+ * Detect appearance from trusted OSC 11 reports, then COLORFGBG, then native
+ * macOS appearance only on known-broken multiplexer background-query paths.
+ * Defaults to dark when none of those signals is available.
+ */
+export declare function detectTerminalBackground(): "dark" | "light";
 /** Active theme; imports remain live across initialization, previews, and theme switches. */
 export declare var theme: Theme;
 type ThemeBinding = (value: Theme) => void;

package/dist/types/thinking.d.ts

@@ -37,6 +37,11 @@ export declare function shouldDisableReasoning(level: ThinkingLevel | undefined)
  * Resolves a selector against the current model while preserving explicit "off".
  */
 export declare function resolveThinkingLevelForModel(model: Model | undefined, level: ThinkingLevel | undefined): ResolvedThinkingLevel | undefined;
+/**
+ * Level applied to `model` when the user has not picked one for it (carried,
+ * global default, auto). Unverified thinking stays unset until the user picks.
+ */
+export declare function automaticThinkingLevel<T>(model: Model | undefined, fallback: T): T | undefined;
 /**
  * Sentinel selector for the coding-agent "auto" thinking mode. Kept entirely
  * inside the coding-agent layer: it is never an {@link Effort} or

package/dist/types/tmux.d.ts

@@ -1,6 +1,14 @@
 export { wrapTmuxPassthrough } from "./multiplexers/tmux.js";
 /** Pass a control sequence through tmux, leaving direct-terminal output unchanged. */
 export declare function wrapTmuxPassthroughIfNeeded(payload: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * Emulator name candidates from a `#{client_termtype}<TAB>#{client_termname}`
+ * line, best first: the terminal-type reply (tmux 3.4+, XTVERSION), then the
+ * emulator the client's `TERM` names when it ships its own terminfo entry. Both
+ * are kept because the reply can name an unrecognized program (a nested tmux
+ * answers `tmux 3.4`) while `TERM` still identifies the emulator.
+ */
+export declare function tmuxClientProgramsFromReport(report: string): string[];
 /**
  * Whether the terminal hosting this tmux session draws TSP programs natively:
  * it sets the session user option `@tern-tsp` while it watches the session.
@@ -12,10 +20,37 @@ export declare function tmuxSessionSpeaksTsp(env?: NodeJS.ProcessEnv): boolean;
  */
 export declare function setTmuxPaneApcTitles(on: boolean, env?: NodeJS.ProcessEnv): void;
 /**
- * Resolve the terminal emulator name recorded for this tmux client.
+ * Resolve the terminal emulator names recorded for this tmux client, best first.
  *
  * tmux overwrites pane identity variables with its own values, but retains the
- * attached client's terminal-type reply in `#{client_termtype}`. The local IPC
- * query runs once per process and degrades to `null` when unavailable.
+ * attached client's terminal-type reply in `#{client_termtype}` and its `TERM`
+ * in `#{client_termname}` (see {@link tmuxClientProgramsFromReport}). The local
+ * IPC query runs once per process and degrades to `[]` when unavailable.
+ */
+export declare function resolveTmuxClientTerminalNames(env?: NodeJS.ProcessEnv): readonly string[];
+/**
+ * Whether tmux draws SIXEL to the client attached to this session: its
+ * effective terminal description for that client carries `Sxl`.
+ *
+ * A tmux built with SIXEL answers every pane's DA1 with attribute 4 and draws a
+ * `SIXEL IMAGE (WxH)` text placeholder for clients without SIXEL, so the pane's
+ * DA1 says nothing about the outer terminal. tmux itself renders SIXEL only
+ * when the client's terminal has `Sxl`, whether from terminfo,
+ * `terminal-overrides`, or the `sixel` feature (DA1 or `terminal-features`),
+ * and `show-messages -T` reports that merged description. The TUI consults
+ * this before trusting the pane's DA1 attribute. Queried once per tmux
+ * session; `false` outside tmux, with no attached client, or when the query
+ * fails. Nested tmux usually reports no `Sxl`: the inner client's terminal is
+ * the outer tmux, whose DA1 starts with level 1, which tmux does not parse
+ * for features.
+ */
+export declare function tmuxClientRendersSixel(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Whether tmux forwards this pane's `\x1bPtmux;…\x1b\\` passthrough envelopes
+ * to the attached client. tmux 3.3+ defaults `allow-passthrough` to `off` and
+ * then silently drops every wrapped sequence, so Kitty graphics sent through
+ * the envelope never reach a Kitty-capable outer terminal. Resolves the
+ * effective pane value (pane → window → global). Queried once per pane;
+ * `false` outside tmux or when the query fails.
  */
-export declare function resolveTmuxClientTerminalName(env?: NodeJS.ProcessEnv): string | null;
+export declare function tmuxPaneAllowsPassthrough(env?: NodeJS.ProcessEnv): boolean;

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 { NativeToolView, RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** Display metadata returned by ast-edit. */
 export interface AstEditToolDetails {
     totalReplacements: number;
@@ -47,7 +47,7 @@ export declare const astEditToolRenderer: {
         }>;
         details?: AstEditToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: AstEditRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: AstEditRenderArgs): Component;
     describeCall(args: AstEditRenderArgs): NativeToolView;
     describeResult(result: {
         content: Array<{

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, NativeToolView } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** Display metadata returned by ast-grep. */
 export interface AstGrepToolDetails {
     matchCount: number;
@@ -46,7 +46,7 @@ export declare const astGrepToolRenderer: {
         }>;
         details?: AstGrepToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: AstGrepRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: AstGrepRenderArgs): Component;
     describeCall(args: AstGrepRenderArgs): NativeToolView;
     describeResult(result: {
         content: Array<{

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

@@ -18,6 +18,8 @@ export interface BashToolDetails {
     requestedTimeoutSeconds?: number;
     timeoutDisabled?: boolean;
     wallTimeMs?: number;
+    /** False when no wall-time footer was emitted; absent on older results. */
+    wallTimeNoticeEmitted?: boolean;
     /** Exit code of a command that ran to completion but failed (non-zero). */
     exitCode?: number;
     /** True when the command was killed by its timeout deadline (not a failure). */
@@ -31,12 +33,15 @@ export interface BashToolDetails {
         timedOut: boolean;
         pid?: number;
     };
+    /** Background job behind the call; `cancelled`: killed (`proc://<id>/kill`) before it finished. */
     async?: {
-        state: "running" | "completed" | "failed";
+        state: "running" | "completed" | "failed" | "cancelled";
         jobId: string;
         type: "bash";
     };
 }
+/** Minimum duration for a model-facing wall-time notice; shorter runs keep timing only in details. */
+export declare const WALL_TIME_NOTICE_MIN_MS = 1000;
 /** Formats the model-facing command duration notice. */
 export declare function formatWallTimeNotice(wallTimeMs: number): string;
 /** Formats the model-facing command exit status notice. */

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

@@ -133,6 +133,8 @@ export interface EditRenderContext {
     renderDiff?: (diffText: string, options?: {
         filePath?: string;
     }) => string;
+    /** Unsanitized result metadata, used only for filesystem link targets. */
+    rawDetails?: unknown;
 }
 /** Render replacement text until a computed diff preview is available. */
 export declare function renderStreamingFallback(editMode: EditMode, args: unknown, theme: Theme): string;

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

@@ -13,25 +13,60 @@ export interface EvalStatusEvent {
     resolvedThinkingLevel?: ConfiguredThinkingLevel;
     [key: string]: unknown;
 }
+/** One column of a table view. */
+export interface EvalTableColumn {
+    head: string;
+    /** Numeric values: renderers right-align the column. */
+    numeric?: boolean;
+}
+/**
+ * A pretty rendering of something a cell printed, shown to the user in place
+ * of its text; the model only ever sees the text.
+ * - `table`: a data frame or `console.table`; leading index columns are plain
+ *   columns, and a truncated frame's elided rows/columns are `…` cells.
+ * - `json`: a structured value (dict/list, object/array) as a collapsible tree.
+ * - `markdown`: an object's Markdown representation.
+ */
+export type EvalView = {
+    kind: "table";
+    columns: EvalTableColumn[];
+    rows: string[][];
+} | {
+    kind: "json";
+    value: unknown;
+} | {
+    kind: "markdown";
+    text: string;
+};
+/**
+ * A view and the exact printed text it stands for. Renderers locate `text` in
+ * the cell's `output` (entries in print order) and show the view there; an
+ * entry whose text is no longer in the output (truncated) is skipped.
+ */
+export interface EvalViewEntry {
+    text: string;
+    view: EvalView;
+}
 /** Per-cell execution result for transcript rendering. */
 export interface EvalCellResult {
     index: number;
     title?: string;
     code: string;
     language?: EvalLanguage;
+    /** What the model saw: the cell's printed text plus image notes. */
     output: string;
+    /** Pretty views of spans of `output`, in print order. */
+    views?: EvalViewEntry[];
     status: "pending" | "running" | "complete" | "error";
     durationMs?: number;
     exitCode?: number;
     statusEvents?: EvalStatusEvent[];
     /** Discrete events dropped from the front of `statusEvents` (see {@link recordStatusEvent}). */
     statusEventsElided?: number;
-    hasMarkdown?: boolean;
 }
 /** Tool result detail object surfaced to the UI/transcript. */
 export interface EvalToolDetails {
     cells?: EvalCellResult[];
-    jsonOutputs?: unknown[];
     images?: ImageContent[];
     statusEvents?: EvalStatusEvent[];
     /** Discrete events dropped from the front of `statusEvents` (see {@link recordStatusEvent}). */
@@ -44,9 +79,9 @@ export interface EvalToolDetails {
     languages?: EvalLanguage[];
     /** Optional human-readable notice (e.g. fallback explanation). */
     notice?: string;
-    /** Present when the cell was auto-backgrounded as an async job. */
+    /** Present when the cell was auto-backgrounded as an async job; `cancelled`: killed before it finished. */
     async?: {
-        state: "running" | "completed" | "failed";
+        state: "running" | "completed" | "failed" | "cancelled";
         jobId: string;
         type: "eval";
     };
@@ -100,6 +135,20 @@ export declare function upsertStatusEvent(events: EvalStatusEvent[], event: Eval
  * events behind an "… N earlier" row.
  */
 export declare function recordStatusEvent(log: StatusEventLog, event: EvalStatusEvent): void;
+/** One ordered piece of a cell's output: printed text, or a view shown in place of the text it matched. */
+export type EvalOutputPart = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "view";
+    view: EvalView;
+};
+/**
+ * Split `output` around its views, in order: each view's `text` is searched
+ * from the end of the previous match, unmatched entries are skipped, and
+ * blank text between views is dropped (newlines bordering a view trimmed).
+ */
+export declare function splitEvalOutput(output: string, views: readonly EvalViewEntry[] | undefined): EvalOutputPart[];
 /** Render eval code cells, structured display output, and progress events. */
 export declare const evalToolRenderer: {
     animatedPendingPreview: true;

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

@@ -1,7 +1,7 @@
 import type { Theme } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 import type { OutputMeta } from "./output-meta.js";
-import type { NativeToolView, RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** A verified line range with its yes-probability and a one-line preview. */
 export interface FindRange {
     start: number;
@@ -22,12 +22,21 @@ export interface FindHit {
     linesSeen: number;
     truncated: boolean;
 }
+/**
+ * How much of a search the judge actually covered. `unavailable`: every judge
+ * request failed, so an empty result is not evidence of absence. `partial`:
+ * some requests failed. `complete`: none failed (or none were needed).
+ */
+export type FindCoverage = "complete" | "partial" | "unavailable";
 /** Search accounting reported alongside the hits. */
 export interface FindStats {
     /** Eligible files under the root. */
     listed: number;
     requests: number;
-    errors: number;
+    /** Judge requests that failed outright; decides {@link FindCoverage}. */
+    failed: number;
+    /** Questions a successful response left without a usable answer. */
+    unanswered: number;
     /** Entries judged by name. */
     judged: number;
     /** Files whose content was read and sent. */
@@ -51,6 +60,7 @@ export interface FindToolDetails {
     /** Verified-passage probability at or above which a file is a hit. */
     threshold: number;
     hits: FindHit[];
+    coverage: FindCoverage;
     stats: FindStats;
     elapsedMs: number;
     /** Session cwd; hit paths are relative to it. */
@@ -74,7 +84,7 @@ export declare const findToolRenderer: {
         }>;
         details?: FindToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: FindRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: FindRenderArgs): Component;
     describeCall(args: FindRenderArgs): NativeToolView;
     /**
      * Inline (§7.3 find): `Find “query”  2 hits · 8 files`, then per hit its
@@ -88,7 +98,7 @@ export declare const findToolRenderer: {
         }>;
         details?: FindToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, args?: FindRenderArgs): NativeToolView;
+    }, options: RenderResultContextOptions, args?: FindRenderArgs): NativeToolView;
     mergeCallAndResult: true;
     animatedPendingPreview: true;
     animatedPartialResult: true;

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

@@ -1,5 +1,5 @@
 import type { Component } from "../tui.js";
-import type { NativeToolView, RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 import { type Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { TruncationResult } from "./streaming-output.js";
@@ -42,7 +42,7 @@ export declare const globToolRenderer: {
         }>;
         details?: GlobToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: GlobRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: GlobRenderArgs): Component;
     describeCall(args: GlobRenderArgs): NativeToolView;
     /**
      * Inline (§7.3 glob): `Glob “pattern”  5 files`, then the files as rows
@@ -55,7 +55,7 @@ export declare const globToolRenderer: {
         }>;
         details?: GlobToolDetails;
         isError?: boolean;
-    }, _options: RenderResultOptions, args?: GlobRenderArgs): NativeToolView;
+    }, options: RenderResultContextOptions, args?: GlobRenderArgs): NativeToolView;
     mergeCallAndResult: true;
 };
 export {};

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

@@ -1,5 +1,5 @@
 import type { Component } from "../tui.js";
-import type { NativeToolView, RenderResultOptions } from "./renderer.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 import { type Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { TruncationResult } from "./streaming-output.js";
@@ -58,7 +58,7 @@ export declare const grepToolRenderer: {
         }>;
         details?: GrepToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: GrepRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: GrepRenderArgs): Component;
     describeCall(args: GrepRenderArgs): NativeToolView;
     /**
      * Inline (§7.3 grep): `Grep “pattern”  5 matches · 2 files  in src`, then

package/dist/types/tools/grouped-file-output.d.ts

@@ -110,10 +110,13 @@ export interface NumberedLine {
  * Numbered `code` for possibly non-contiguous source lines: one block per run
  * of consecutive line numbers (`start` = the run's first line, match lines
  * `mark`ed), with a `…` row wherever the numbers jump or an elision marker
- * (`n: null`) sits. No path header: the row or head above names the file.
+ * (`n: null`) sits. `path` is the file the lines come from: Tern picks their
+ * grammar from it and draws no header (the row or head above names the file).
+ * `wrap` soft-wraps long lines instead of scrolling the block sideways.
  */
 export declare function numberedCode(lines: readonly NumberedLine[], opts?: {
-    lang?: string;
+    path?: string;
+    wrap?: boolean;
 }): NativeNode[];
 /**
  * Describe grouped search output (grep / ast-grep / ast-edit display content)
@@ -121,9 +124,11 @@ export declare function numberedCode(lines: readonly NumberedLine[], opts?: {
  * header's suffix or the match count as a chip), then its lines as
  * {@link numberedCode} with match lines marked and `…` between non-adjacent
  * runs. Unnumbered body lines stay plain `code`. `maxFiles` keeps only the
- * first files (the caller says how many were left out).
+ * first files (the caller says how many were left out). `file` owns the lines
+ * before any header: a single-file search prints none, yet its lines get the
+ * same file row as a directory search's.
  */
 export declare function describeGroupedOutput(lines: readonly string[], options?: {
-    lang?: (path: string) => string | undefined;
     maxFiles?: number;
+    file?: string;
 }): NativeNode[];

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

@@ -85,7 +85,7 @@ 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. */
+    /** Milliseconds run so far (`running`, a live `background` job) or in total; omitted when undefined. */
     readonly elapsedMs?: number;
     /** Quiet facts (job id, service state, artifact), muted and ` · `-joined. */
     readonly facts?: readonly string[];