@oh-my-pi/pi-tui 18.11.2 → 18.12.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 ## [Unreleased]
 
+## [18.12.0] - 2026-10-17
+
+### Breaking Changes
+
+- `FindStats.errors` is replaced by `failed` (judge requests that failed) and `unanswered` (unusable answers), and `FindToolDetails` requires a `coverage` status; the find renderer shows `N/M requests failed` ([#15744](https://github.com/can1357/oh-my-pi/issues/15744))
+
+### Added
+
+- Added `pi.showProfile` to `StatusLineSegmentOptions`: `false` keeps the `pi` segment's bare glyph under a named profile, in the rendered bar and in `describe` ([#16063](https://github.com/can1357/oh-my-pi/pull/16063) by [@shgew](https://github.com/shgew))
+
+### Fixed
+
+- Fixed sessions run inside tmux silently falling back to the terminal's true-color profile when the client terminal-type probe answered slowly on a loaded machine ([#16020](https://github.com/can1357/oh-my-pi/pull/16020) by [@CharleoYang](https://github.com/CharleoYang))
+- Fixed the `read` result notice printing the absolute resolved path, so a file under the home directory reads `Resolved path: ~/notes.txt` instead of `/home/you/notes.txt` ([#16055](https://github.com/can1357/oh-my-pi/pull/16055) by [@adi-IL](https://github.com/adi-IL)).
+- Fixed grep/read previews and other tool cards passing raw escape sequences from file contents to the terminal, which could switch it to the alternate screen with mouse reporting on, live and again on every resume ([#15963](https://github.com/can1357/oh-my-pi/issues/15963))
+- Fixed a final status-line render after shutdown scheduling another usage refresh ([#15845](https://github.com/can1357/oh-my-pi/issues/15845)).
+- Fixed Ctrl+O on LSP status and other plain LSP responses still clipping every row at 80 columns; expanded rows now wrap to show the full text ([#15824](https://github.com/can1357/oh-my-pi/issues/15824))
+- Fixed Ctrl+O leaving long rows clipped in expanded LSP, debug, MCP, web search fallback, yield, task and custom-tool results; expanded rows now wrap to show the full text, expanded LSP references list every location, and the LSP expand hint no longer appears when nothing is hidden ([#15824](https://github.com/can1357/oh-my-pi/issues/15824))
+- Fixed jagged text and disappearing translucent details in SIXEL images, including re-encoding when the terminal reports a changed background color ([#15891](https://github.com/can1357/oh-my-pi/pull/15891) by [@Bouska](https://github.com/Bouska)).
+- Fixed stale SIXEL backgrounds after terminal restarts, native appearance changes, and failed TSP handshakes, including background changes during the handshake, fixed themes, missing or invalid startup themes, or identical light/dark mappings ([#15891](https://github.com/can1357/oh-my-pi/pull/15891) by [@Bouska](https://github.com/Bouska)).
+
+## [18.11.3] - 2026-10-16
+
+### Added
+
+- Added selection-only session and model picker actions for `/seance`, so choosing a source or model leaves the active session and model unchanged ([#15036](https://github.com/can1357/oh-my-pi/pull/15036) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy))
+
+### Changed
+
+- `ApprovalDialogComponent` shows a choice list (Approve, an optional `session` row, Deny): the arrow keys move between them and Enter (armed after `APPROVE_ARM_MS`) takes the highlighted one; while a composer draft holds Enter the highlight sits on Deny, relabeled "Deny and send message"; Tern clicks on a choice take it; Page Up/Down scroll the details
+
+### Fixed
+
+- Fixed a streamed Markdown list keeping every item out of native scrollback until the turn ended, so rows that scrolled off screen were unreachable mid-stream; items in front of the newest one now retire as soon as it begins ([#13676](https://github.com/can1357/oh-my-pi/issues/13676), [#15993](https://github.com/can1357/oh-my-pi/pull/15993) by [@shgew](https://github.com/shgew))
+- Fixed SIXEL charts and SVG figures being resampled before display, which softened their text, on terminals whose cell height is not a multiple of 6 such as Windows Terminal ([#16007](https://github.com/can1357/oh-my-pi/issues/16007))
+
 ## [18.11.2] - 2026-10-16
 
 ### Changed
@@ -2486,103 +2522,4 @@
 - Added `getIndentationNoescape` wrapper that uses `process.cwd()` as the project root for relative file paths
 - Re-export `getDefaultTabWidth`, `getIndentation`, and `setDefaultTabWidth` from `@oh-my-pi/pi-utils`; native text helpers still receive tab width via wrappers that read the JS default
 
-## [13.16.1] - 2026-03-27
-
-### Added
-
-- Support for optional SearchDb parameter in CombinedAutocompleteProvider constructor for improved fuzzy search performance
-- Fuzzy matching filter for autocomplete suggestions to improve relevance of results
-
-### Changed
-
-- Fuzzy discovery now applies fuzzy matching filter to results for improved relevance of autocomplete suggestions
-- Autocomplete fuzzy discovery now accepts optional SearchDb instance for faster searches
-
-## [13.16.0] - 2026-03-27
-
-### Changed
-
-- Updated tab replacement in editor text sanitization to respect configured tab width setting
-
-## [13.15.0] - 2026-03-23
-
-### Added
-
-- Added `renderInlineMarkdown()` function to render inline markdown (bold, italic, code, links, strikethrough) to styled strings
-
-### Fixed
-
-- Fixed editor consuming user-rebound copy keys, preventing custom keybindings from working in the editor
-
-## [13.14.1] - 2026-03-21
-
-### Added
-
-- Added Ctrl+_ as an additional default shortcut for undo
-
-### Fixed
-
-- Ensured undo functionality respects user-configured keybindings
-
-## [13.12.0] - 2026-03-14
-
-### Added
-
-- Added `moveToMessageStart()` and `moveToMessageEnd()` methods to move cursor to the beginning and end of the entire message
-
-### Fixed
-
-- Fixed autocomplete to preserve `./` prefix when completing relative file and directory paths
-- Fixed paste marker expansion to handle special regex replacement tokens ($1, $2, $&, $$, $`, $') literally in pasted content
-
-## [13.11.0] - 2026-03-12
-
-### Fixed
-
-- Fixed OSC 11 background color detection to correctly handle partial escape sequences that arrive mid-buffer, preventing user input from being swallowed
-- Fixed race condition where overlapping OSC 11 queries would be incorrectly cancelled by DA1 sentinels from previous queries
-
-## [13.7.5] - 2026-03-04
-
-### Changed
-
-- Extracted word navigation logic into reusable `moveWordLeft` and `moveWordRight` utility functions for consistent cursor movement across components
-
-## [13.6.2] - 2026-03-03
-
-### Fixed
-
-- Fixed cursor positioning when content shrinks to empty without clearOnShrink enabled
-
-## [13.5.4] - 2026-03-01
-
-### Fixed
-
-- Fixed viewport repaint scrollback accounting during resize oscillation to avoid double-scrolling on height shrink and added exact-row scrollback assertions in overlay regression coverage ([#228](https://github.com/can1357/oh-my-pi/issues/228), [#234](https://github.com/can1357/oh-my-pi/issues/234))
-
-## [13.5.3] - 2026-03-01
-
-### Fixed
-
-- Fixed append rendering logic to correctly handle offscreen header changes during content overflow growth, preserving scroll history integrity
-- Fixed visible tail line updates when appending new content during viewport overflow conditions
-- Fixed cursor positioning instability when appending content under external cursor relocation by using absolute screen addressing instead of relative cursor movement
-
-## [13.5.2] - 2026-03-01
-
-### Breaking Changes
-
-- Removed `getMermaidImage` callback from MarkdownTheme; replaced with `getMermaidAscii` that accepts ASCII string instead of image data
-- Removed mermaid module exports (`renderMermaidToPng`, `extractMermaidBlocks`, `prerenderMermaidBlocks`, `MermaidImage` interface)
-
-### Changed
-
-- Mermaid diagrams now render as ASCII text instead of terminal graphics protocol images
-
-## [13.5.1] - 2026-03-01
-
-### Fixed
-
-- Fixed viewport shift handling to prevent stale content when mixed updates remap screen rows
-
-Older entries are archived in [packages/tui/CHANGELOG.md@9748d65121ba](https://github.com/can1357/oh-my-pi/blob/9748d65121bac9589d3b136a6d839d76ec52dc2e/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@691b3d448f3d](https://github.com/can1357/oh-my-pi/blob/691b3d448f3da1f99010854dea4a562395fd190d/packages/tui/CHANGELOG.md).

package/README.md

@@ -38,6 +38,42 @@ tui.addChild(editor);
 tui.start();
 ```
 
+## SIXEL transparency and terminal backgrounds
+
+SIXEL has binary transparency, not fractional alpha. omp blends partially
+transparent image pixels against the terminal's reported OSC 11 background
+before quantization, preserving antialiased text and translucent details.
+Images with alpha are resized in premultiplied form before background compositing
+to prevent dark fringes and hidden-color bleed along scaled transparent edges.
+Fully transparent pixels stay transparent. Kitty and iTerm2 retain their
+existing image paths.
+
+When a new OSC 11 report changes the background RGB, SIXEL images are
+re-encoded even if the terminal stays dark or stays light. Terminals supporting
+Mode 2031 trigger this automatically. Otherwise, press Ctrl+L to refresh the
+background after changing it. This introduces no periodic polling.
+Direct terminals replay transcript history using the existing theme-change
+repaint policy; multiplexers repaint the viewport without clearing their native
+scrollback.
+
+Cached RGB is cleared when terminal ownership starts or ends, so a restarted
+session without an OSC 11 response cannot inherit the previous terminal's RGB.
+If the terminal cannot report its RGB, or an active multiplexer marks background
+queries as unreliable on the current platform, omp approximates the background
+with black for detected dark appearance or white for light. Untrusted reports
+do not override the existing appearance fallback. Exact edge-color matching is
+not guaranteed with that fallback, transparent terminal windows, or graphics
+overlapping a differently colored background.
+
+On known-broken background-query paths, such as macOS inside Zellij, native
+appearance changes also repaint SIXEL images when using a fixed theme or
+identical light/dark theme mappings. `COLORFGBG` still takes precedence over the
+native fallback; reports that leave the effective background unchanged do not
+trigger a repaint.
+
+If native TSP negotiation fails, the row renderer resumes these SIXEL refreshes.
+Expecting native support alone does not disable repainting after the failure.
+
 ## Core API
 
 ### TUI

package/dist/types/components/markdown.d.ts

@@ -185,9 +185,10 @@ export declare class Markdown implements Component {
      */
     describe(_cx: DescribeContext): NativeNode;
     /**
-     * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary that no append can move: it stops in front of a
-     * display-math opener whose block an append could still close. Only
+     * Width-independent source prefix of the last render that no append can
+     * change: up to a frozen Markdown block boundary, stopping in front of a
+     * display-math opener whose block an append could still close, or, while a
+     * list streams as the last block, up to its newest top-level item. Only
      * meaningful while streaming (transient render cache on); grows
      * monotonically under append-only `setText`.
      */

package/dist/types/overlays/approval-dialog.d.ts

@@ -1,19 +1,23 @@
 /**
  * Tool-approval prompt in the composer's place, presented like the ask
- * dialog: the approval title and its details over an action bar. Approving
- * takes a deliberate chord (`app.approval.approve`, Ctrl+Enter by default),
- * so an Enter typed for the composer as the prompt appears never approves a
- * call, and the chord itself only arms {@link APPROVE_ARM_MS} after mount: it
- * is also the follow-up key, pressed mid-run exactly when prompts appear.
- * Esc denies. With an {@link ApprovalDialogDraft}, every other key edits the
- * composer mounted beneath the dialog, so a message can steer the turn while
- * the call waits; an empty composer ignores Enter and arrows scroll the details.
- * The prompt stays a few rows so the composer keeps its room; with a full
- * prompt, the expand key (`app.tools.expand`) swaps it in, wrapped.
+ * dialog: the approval title and its details over a list of choices —
+ * Approve, an optional "approve for this session", and Deny — and an action
+ * bar. The arrows move between the choices and Enter takes the highlighted
+ * one; `app.approval.approve` (Ctrl+Enter by default) approves this call
+ * outright and Esc denies. Enter and the approve chord only arm
+ * {@link APPROVE_ARM_MS} after mount, so a key meant for the composer (Enter,
+ * or the follow-up chord pressed mid-run) as the prompt appears never answers
+ * it. With an {@link ApprovalDialogDraft}, every other key edits the composer
+ * mounted beneath the dialog, so a message can deny the call and steer the
+ * turn instead: while the composer holds a draft, the arrows and Enter edit and
+ * send it, and the highlight sits on Deny, relabeled to say Enter sends.
+ * The prompt stays a few rows so the composer keeps its room; Page Up/Down
+ * scroll the details, and with a full prompt the expand key
+ * (`app.tools.expand`) swaps it in, wrapped.
  */
 import { type Component, type TUI } from "../index.js";
-import type { NativeNode, NativeUiEvent } from "../native/node.js";
-/** The approve key is ignored this long after mount, so a follow-up sent as the prompt appears cannot approve it. */
+import { type NativeNode, type NativeUiEvent } from "../native/node.js";
+/** Enter and the approve key are ignored this long after mount, so a key sent as the prompt appears cannot answer it. */
 export declare const APPROVE_ARM_MS = 500;
 interface ApprovalDialogCallbacks {
     onApprove(): void;
@@ -39,6 +43,11 @@ interface ApprovalDialogOptions {
     onTimeoutReset?: () => void;
     /** Route typing to the composer instead of dropping it. */
     draft?: ApprovalDialogDraft;
+    /** Offer to approve this and later like calls for the rest of the session, as the row between Approve and Deny. */
+    session?: {
+        label: string;
+        onApprove(): void;
+    };
 }
 export declare class ApprovalDialogComponent implements Component {
     #private;
@@ -59,11 +68,12 @@ export declare class ApprovalDialogComponent implements Component {
     /**
      * In the dock, in the composer's place and framed as the composer is (an
      * `omp.editor.*` root role), like the ask dialog, rather than a card over
-     * the transcript: the title, the details, then Details (with a full prompt),
-     * Deny, and the primary Approve, whose keys show in their tooltips.
+     * the transcript: the title, the details, the choices with the keyboard's
+     * highlight (a click takes one), then Details (with a full prompt), Deny,
+     * and the primary Approve, whose keys show in their tooltips.
      */
     describe(): NativeNode;
-    /** Deny, Approve, and Details run exactly what Esc, the approve key, and the expand key run. */
+    /** Deny, Approve, and Details run exactly what Esc, the approve key, and the expand key run; a click on a choice takes it. */
     handleNativeEvent(event: NativeUiEvent): void;
 }
 export {};

package/dist/types/overlays/model-picker.d.ts

@@ -57,6 +57,8 @@ export interface ModelPickerOptions {
     taskModeKeys?: readonly KeyId[];
     /** `provider/id` highlighted and preselected in task mode (current Task subagent model). */
     taskSelector?: string;
+    /** Present selection-only chrome; consumers handle the chosen selector without mutating a session. */
+    selectOnly?: boolean;
 }
 /** Rows the browser renders around its list window (search + blank, blank + two detail rows). */
 export declare const BROWSER_FRAME_ROWS = 5;

package/dist/types/overlays/session-selector.d.ts

@@ -127,6 +127,8 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
     allSessions?: T[];
     /** Picker heading; defaults to "Resume Session". */
     title?: string;
+    /** Primary action label; defaults to "Resume" (ANSI footer defaults to "select"). */
+    actionLabel?: string;
     /** Fixed scope label, or false to omit the scope suffix. */
     scopeLabel?: string | false;
     /**

package/dist/types/prompt/internal-url-autocomplete.d.ts

@@ -31,6 +31,7 @@ export interface InternalUrlCallerContext {
     cwd?: string;
     sessionFile?: string;
     sessionId?: string;
+    seanceSourceArtifactsDir?: string;
 }
 /**
  * Suggestions for the internal-url token ending at the cursor, or `null` when

package/dist/types/render/hanging-wrap.d.ts

@@ -3,3 +3,5 @@ import type { Theme } from "../theme/theme.js";
 export declare function wrapPrefixedLine(prefix: string, continuationPrefix: string, content: string, width: number): string[];
 /** Preserve a tree connector's ancestor guides while hanging a long node beneath its label. */
 export declare function wrapTreeLine(line: string, width: number, theme: Theme): string[] | undefined;
+/** Hang a tree row beneath its connector, or a connector-less detail row beneath its guide rails. */
+export declare function wrapGuidedLine(line: string, width: number, theme: Theme): string[];

package/dist/types/render/render-utils.d.ts

@@ -105,14 +105,22 @@ export declare function cappedHeadLines(lines: readonly string[], max: number):
 };
 /** Get the first nonblank preview lines, trimmed and width-capped. */
 export declare function getPreviewLines(text: string, maxLines: number, maxLineLen: number, ellipsis?: Ellipsis): string[];
+/** Collapse a possibly multi-line string into one line; whitespace runs (tabs included) become one space. */
+export declare function flattenLine(text: string): string;
 /**
  * Collapse a possibly multi-line string into a single line, then truncate it to
  * `maxWidth` display cells. {@link truncateToWidth} alone caps width but
  * newlines are zero-width, so multi-line content (markdown briefs, tool args,
  * provider errors) would otherwise spill a single status row across several
- * visual lines. Whitespace runs collapse to one space, so tabs are handled too.
+ * visual lines.
  */
 export declare function previewLine(text: string, maxWidth: number, ellipsis?: Ellipsis): string;
+/**
+ * Clip a result row to `maxWidth` only while collapsed. Expanded rows stay whole
+ * so the frame wraps them: the expand key ({@link formatExpandHint}) must reveal
+ * text, not re-clip it.
+ */
+export declare function clipCollapsed(text: string, maxWidth: number, expanded: boolean | undefined): string;
 /**
  * Extract domain from URL, stripping www. prefix.
  */

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/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=",
@@ -393,7 +400,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

@@ -101,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/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/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 { NativeToolView, RenderResultOptions } 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/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/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/read.d.ts

@@ -1,6 +1,6 @@
 import type { SummaryResult } from "@oh-my-pi/pi-natives";
 import type { Component } from "../tui.js";
-import type { NativeToolView, RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
+import type { RenderResultContextOptions, NativeToolView, RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
 import type { NativeNode } from "../native/node.js";
 import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
@@ -40,6 +40,11 @@ export interface ReadToolDetails {
     fileSize?: number;
     /** Full source line count when the read reached EOF and the count is exact. */
     totalLines?: number;
+    /**
+     * Whether the text's rows carry line-number prefixes (`N:` hashline, `N|` line numbers). Set where a
+     * file read is formatted; a raw read sets `false`. Snapcompact reads it to tell a `12:` prefix from content.
+     */
+    rowPrefixes?: boolean;
     /** Raw text + start line for user-visible TUI rendering, set when content is text-like.
      * Mirrors the same lines the model receives but without hashline/line-number prefixes,
      * so the TUI can render the file content with its own gutter without re-parsing the formatted text. */
@@ -55,7 +60,10 @@ export interface ReadToolDetails {
     };
     /** Number of unresolved git conflicts surfaced by this read (TUI uses for inline `⚠ N` badge). */
     conflictCount?: number;
-    /** Paths recovered from a delimited read argument; used only by the TUI to render one call as multiple read rows. */
+    /**
+     * Paths recovered from a delimited read argument. The TUI renders one call as multiple read rows; snapcompact
+     * keeps such a composite result as text.
+     */
     displayReadTargets?: string[];
     /**
      * Resolved filesystem link target for each {@link displayReadTargets} entry, aligned by index; `null` when a
@@ -113,7 +121,7 @@ export declare function pendingFileLinkPath(inputPath: string): string;
  * target when the structured `resolvedPath` isn't set (the common plain-file and
  * image reads only record the path in `meta.source`). URL/internal sources are
  * not fs paths, so only `type: "path"` qualifies. */
-export declare function readSourceFsPath(details: ReadToolDetails | undefined): string | undefined;
+export declare function readSourceFsPath(details: unknown): string | undefined;
 /**
  * Whether a read result renders as a Markdown preview rather than numbered source:
  * the read tool tagged it `text/markdown` (`read.renderMarkdown`, or a protocol
@@ -140,7 +148,7 @@ export declare const readToolRenderer: {
         }>;
         details?: ReadToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: ReadRenderArgs): Component;
+    }, options: RenderResultContextOptions, uiTheme: Theme, args?: ReadRenderArgs): Component;
     describeCall(args: ReadRenderArgs): NativeToolView;
     /**
      * Inline (§7.3 read): the head names the file and range; the content
@@ -154,7 +162,7 @@ export declare const readToolRenderer: {
         }>;
         details?: ReadToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, args?: ReadRenderArgs): NativeToolView;
+    }, options: RenderResultContextOptions, args?: ReadRenderArgs): NativeToolView;
     mergeCallAndResult: true;
 };
 /** Inclusive line range describing one elided span in a structural summary. */