@oh-my-pi/pi-tui 18.14.2 → 18.16.0

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

@@ -1,18 +1,3 @@
-/**
- * Status line for the speculative first frame, before any session exists.
- *
- * 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
- * const statusLine = createStartupStatusLine(cached.statusLine);
- * statusLine.attachToEditor(editor, getComposerStyle(shape));
- * ```
- */
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Model } from "@oh-my-pi/pi-catalog/types";
 import { StatusLineComponent } from "./component.js";

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

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

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

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

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

@@ -129,6 +129,7 @@ export declare class Theme {
         running: string;
         shadowed: string;
         aborted: string;
+        /** @deprecated Alias of `success`. */
         done: string;
     };
     get nav(): {

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

@@ -52,22 +52,35 @@ export interface FileMatchSection {
  * Files with no model lines are omitted.
  */
 export declare function formatFileMatches(files: string[], grouped: boolean, renderFile: (filePath: string) => FileMatchSection): GroupedFilesOutput;
-/** Per-line classification of grouped output, used by renderers for hyperlinks. */
+/** Whether a row of grouped output is a code-frame row the search matched (`*12│…`). */
+export declare function isMatchRow(line: string): boolean;
+/** Per-line classification of grouped output, used by renderers for file rows and hyperlinks. */
 export interface GroupedLineContext {
     /** Directory header, file header, or any non-header body/content line. */
     kind: "dir" | "file" | "content";
     /** Number of leading `#` for headers; 0 for content lines. */
     depth: number;
-    /** Resolved absolute path of the dir/file a header points at (when resolvable). */
+    /** Resolved absolute path of the file a header points at (when resolvable). */
     headerPath?: string;
+    /**
+     * For file headers, the full display path: the folded directory chain joined
+     * with the name, without `#` markers or the hashline tag.
+     */
+    displayPath?: string;
+    /** For file headers, a trailing parenthesized note such as `(2 replacements)`. */
+    suffix?: string;
     /** For content lines, the absolute path of the owning file (line hyperlinks). */
     filePath?: string;
-    /** Header is an internal/url-like target the caller resolves itself. */
-    isUrl?: boolean;
+    /**
+     * The internal or url-like target, as written, that a header names or a
+     * content line belongs to; the caller resolves it (no filesystem path).
+     */
+    url?: string;
 }
 /**
  * Walk grouped output lines, tracking a directory stack keyed by header depth, so
- * each header and body line can be linked back to its absolute filesystem path.
+ * each header and body line can be linked back to its absolute filesystem path
+ * and each file header to its full display path.
  * Reconstruction is stack-based (not per-blank-group) so nested directory headers
  * resolve correctly across the whole output.
  *
@@ -76,9 +89,64 @@ export interface GroupedLineContext {
  * formatted relative to cwd regardless of the (sub)directory the search was
  * scoped to. `fileScope` is the initial owning file for body lines that appear
  * before any header (single-file scopes have no `#` headers); it defaults to
- * `headerBase` and should be passed the scoped file's absolute path.
+ * `headerBase` and should be passed the scoped file's absolute path. A URL base
+ * or scope (`local://…`) is no filesystem path: headerless lines belong to the
+ * URL, and headers under a URL base get no path.
  */
 export declare function classifyGroupedLines(lines: readonly string[], headerBase: string | undefined, fileScope?: string | undefined): GroupedLineContext[];
+/**
+ * Line groups with one file per group, for terminal tree lists: `# dir/`
+ * header rows are dropped (each file row carries its full path), and every
+ * file row starts a group of its own, so each file gets its own branch instead
+ * of hanging under the previous file of its directory. Rows before a group's
+ * first file row (notes, a single-file scope's matches) keep their group.
+ */
+export declare function groupsByFile(groups: readonly (readonly number[])[], contexts: readonly GroupedLineContext[]): number[][];
+/** Details fields a grouped-output tool records for links: the display base paths and resolved URL targets. */
+export interface GroupedLinkDetails {
+    cwd?: string;
+    searchPath?: string;
+    displayTargets?: Record<string, string>;
+}
+/**
+ * Link targets for the rows of sanitized grouped output: a file row's file, a
+ * body row's owning file, and for an internal URL the file `displayTargets`
+ * resolves it to. Destinations keep the original path bytes: while the raw
+ * `displayContent` still aligns line-for-line with the sanitized `displayText`,
+ * a row takes its raw classification's target. Raw text never links a row the
+ * sanitized output leaves unlinked.
+ */
+export declare function groupedLinkTargets(contexts: readonly GroupedLineContext[], displayText: string, details: GroupedLinkDetails | undefined, rawDetails: unknown): (index: number) => string | undefined;
+/**
+ * A memoized styler for the rows of grouped output, so a collapsed preview
+ * styles only the rows it shows. A file row is its full path (dim directory,
+ * name in {@link FILE_NAME_COLOR}; a URL whole in that color) and any dim
+ * suffix, linked to `linkTarget`'s file or, for an unresolved URL, the URL.
+ * Body rows come from `styleBody`, tabs expanded; with `linkLines` a numbered
+ * code-frame row links to its line in the owning file.
+ */
+export declare function createGroupedRowStyler(lines: readonly string[], contexts: readonly GroupedLineContext[], theme: Theme, options: {
+    linkTarget: (index: number) => string | undefined;
+    styleBody: (index: number) => string;
+    linkLines?: boolean;
+}): (index: number) => string;
+/**
+ * Fit line groups (one file each) into `budget` rows, the `… N more` summary row
+ * included: whole groups first, then the next group cut short when it can still
+ * show a row under its file row (the first group always shows its head). The
+ * summary counts the `unit`s left out, the rows `isUnit` accepts, out of `total`
+ * when the caller knows it; with none left out it counts hidden lines. `gap`
+ * rows separate shown groups (framed lists put a blank line between files).
+ */
+export declare function fitGroupsToBudget(groups: readonly (readonly number[])[], budget: number, options: {
+    isUnit: (index: number) => boolean;
+    unit: string;
+    total?: number;
+    gap?: number;
+}): {
+    shown: (readonly number[])[];
+    summary: string;
+};
 /**
  * Split line indices into blank-line-separated groups, mirroring
  * `splitGroupsByBlankLine`: when any blank line is present, break on runs of
@@ -108,8 +176,8 @@ export type GroupedOutputEvent = {
 };
 /**
  * Walk grouped output (`# dir/`, `## file.ts (suffix)`, body lines), resolving
- * each file header to its full display path (the folded directory chain
- * joined with the name) and dropping blank separator lines.
+ * each file header to its full display path (see {@link classifyGroupedLines})
+ * and dropping blank separator lines.
  */
 export declare function walkGroupedOutput(lines: readonly string[]): Generator<GroupedOutputEvent>;
 /** One source line for {@link numberedCode}: its number (`null` for an elision marker, which adds no line), text and match mark. */

package/dist/types/tools/hashline-format.d.ts

@@ -6,6 +6,11 @@ export declare const HL_FILE_SUFFIX = "]";
 export declare const HL_FILE_HASH_SEP = "#";
 /** Number of characters in a displayed file hash. */
 export declare const HL_FILE_HASH_LENGTH = 4;
+/**
+ * A trailing `#TAG` file hash exactly as the hashline store writes it (uppercase
+ * hex), so a name's own `#dead` or `#v2` ending survives stripping.
+ */
+export declare const HASHLINE_TAG_SUFFIX_RE: RegExp;
 /** Keyword identifying a file move operation. */
 export declare const HL_MOVE_KEYWORD = "MV";
 /** Keyword identifying a file removal operation. */

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

@@ -8,6 +8,8 @@ import type { NativeToolHead, NativeToolView, ToolRenderResult } from "./rendere
 export declare function displayPath(filePath: string): string;
 /** Configured file link for a head's path target, when the path is absolute. */
 export declare function fileHref(filePath: string | undefined): string | undefined;
+/** Link for a head target that is a web URL (`www.` gains `https://`), else undefined. */
+export declare function urlHref(target: string | undefined): string | undefined;
 /** Diff stats as one head `meta` string, `+8 −1` (U+2212 minus), or undefined when nothing changed. */
 export declare function diffStatsMeta(added: number, removed: number): string | undefined;
 /**

package/dist/types/tools/output-meta.d.ts

@@ -100,8 +100,21 @@ export interface LimitsMeta {
             last: number;
         };
         selectorBase?: string;
+        /** The first cut line exceeds what one `:raw` read returns; that read stops at this many bytes. */
+        rawByteCap?: number;
     };
 }
+/**
+ * The bash minimizer rewrote this output: `filter` is the native filter label
+ * (`chain` for a minimized `&&`/`;` chain), the byte counts are the raw capture
+ * and the minimized text, and `artifactId` holds the raw capture.
+ */
+export interface MinimizedMeta {
+    filter: string;
+    inputBytes: number;
+    outputBytes: number;
+    artifactId: string;
+}
 /**
  * Structured metadata for tool outputs.
  */
@@ -114,6 +127,7 @@ export interface OutputMeta {
     pagedSource?: true;
     diagnostics?: DiagnosticMeta;
     limits?: LimitsMeta;
+    minimized?: MinimizedMeta;
 }
 /**
  * Reformat pre-formatted diagnostic messages into a multi-level, prefix-folded
@@ -136,6 +150,13 @@ export declare function stripRawOutputArtifactNotice(text: string): {
     text: string;
     artifactId?: string;
 };
+/** Whether `line` is the column-cap notice {@link formatOutputNotice} emits (`[Some lines truncated to 768 chars…]`). */
+export declare function isColumnTruncationNotice(line: string): boolean;
+/**
+ * Whether the bracketed notice `line` carries the column-cap clause: alone, or after the parts
+ * {@link formatOutputNotice} joins before it (`[Showing lines 1-4 of 5. … Some lines truncated to 768 chars…]`).
+ */
+export declare function hasColumnTruncationClause(line: string): boolean;
 /** Remove a trailing generated output notice when metadata is unavailable. */
 export declare function stripGeneratedOutputNotice(text: string): string;
 /** Format truncation ranges and recovery hints. */
@@ -147,6 +168,12 @@ export declare function formatTruncationMetaNotice(truncation: TruncationMeta, s
 export declare function formatStyledArtifactReference(artifactId: string, theme: Theme): string;
 /** Describe an incomplete artifact capture. */
 export declare function formatArtifactErrorNotice(error: OutputArtifactError): string;
+/**
+ * `git 120.4KB → 3.2KB`: the minimizer filter that ran and the bytes it took the output from and to.
+ * Native labels are short words; a rehydrated session or extension may carry any text, so the label
+ * is sanitized to one plain line, its home paths shortened to `~`, and width-bounded.
+ */
+export declare function formatMinimizedMeta(minimized: MinimizedMeta): string;
 /**
  * Format notices from OutputMeta for LLM consumption.
  * Returns empty string if no notices needed.

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

@@ -111,6 +111,16 @@ export declare function splitInternalUrlSel(rawPath: string, specOf?: (scheme: s
     path: string;
     sel?: string;
 };
+/**
+ * Split a filesystem read target from its query (`data.json?q=.items` →
+ * `data.json`, `?q=.items`), the display twin of the read tool's JSON, SQLite
+ * and image-question parsers. URLs own their query string and stay whole, as
+ * does a `?` inside a file name.
+ */
+export declare function splitReadQuery(readPath: string): {
+    path: string;
+    query?: string;
+};
 /** Recognize HTTP URLs and www-prefixed external read targets. */
 export declare function isReadableUrlPath(value: string): boolean;
 /** Return the first selected line when every range has valid one-based bounds. */

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

@@ -17,6 +17,8 @@ export interface JobSnapshot {
     type: "bash" | "task" | "eval";
     status: "running" | "completed" | "failed" | "cancelled";
     label: string;
+    /** What the job is for, in the model's words (a process job's `label` is its command line). */
+    intent?: string;
     durationMs: number;
     /** Process exit status when the job reports one. */
     exitCode?: number;

package/dist/types/utils.d.ts

@@ -36,6 +36,10 @@ export declare function truncateToWidth(text: string, maxWidth: number, ellipsis
 export declare function wrapTextWithAnsi(text: string, width: number): string[];
 export declare function extractSegments(line: string, beforeEnd: number, afterStart: number, afterLen: number, strictAfter: boolean): ExtractSegmentsResult;
 export declare function replaceTabs(text: string): string;
+/** Tabs expanded and line breaks collapsed to spaces, for text confined to one rendered row. */
+export declare function singleLine(text: string): string;
+/** A non-negative integer cell width; non-finite input becomes `fallback`. */
+export declare function finiteWidth(width: number, fallback?: number): number;
 /**
  * Returns a string of n spaces. Uses a pre-allocated buffer for efficiency.
  */

package/package.json

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

package/src/app-keybindings.ts

@@ -44,6 +44,7 @@ interface AppKeybindings {
 	"app.message.followUp": true;
 	"app.retry": true;
 	"app.message.dequeue": true;
+	"app.btw.inject": true;
 	"app.clipboard.pasteImage": true;
 	"app.clipboard.pasteTextRaw": true;
 	"app.clipboard.copyLine": true;
@@ -182,6 +183,10 @@ export const KEYBINDINGS = {
 		defaultKeys: ["alt+up", "shift+up"],
 		description: "Dequeue message",
 	},
+	"app.btw.inject": {
+		defaultKeys: "alt+i",
+		description: "Send a /btw answer's steering prompt to the main session",
+	},
 	"app.clipboard.pasteImage": {
 		defaultKeys: getDefaultPasteImageKeys(),
 		description: "Paste image or text from clipboard",

package/src/apps/session-picker.ts

@@ -1,8 +1,9 @@
 import { logger } from "@oh-my-pi/pi-utils";
 import {
 	SessionSelectorComponent,
-	type SessionSelectorEntry,
 	type SessionHistoryMatcher,
+	type SessionListing,
+	type SessionSelectorEntry,
 } from "../overlays/session-selector";
 import { runStandaloneTui } from "./standalone-picker";
 
@@ -14,12 +15,14 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
 	/** Rename the session and resolve with the title as stored, or null when it did not happen. */
 	renameSession?(session: T, title: string): Promise<string | null>;
 	setSessionPinned?(session: T, pinned: boolean): Promise<void>;
-	loadAllSessions?(): Promise<T[]>;
+	loadAllSessions?(): Promise<SessionListing<T>>;
 }
 
 /** Presentation and capability controls for the standalone session picker. */
 export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
-	allSessions?: T[];
+	/** Complete listing replacing the preliminary `sessions` once it settles. */
+	completeSessions?: Promise<T[]>;
+	allSessions?: SessionListing<T>;
 	title?: string;
 	scopeLabel?: string | false;
 	showCwd?: boolean;
@@ -71,6 +74,7 @@ export async function selectSession<T extends SessionSelectorEntry>(
 					onRename: options.onRename ?? host.renameSession,
 					onSetPinned: host.setSessionPinned,
 					historyMatcher,
+					completeSessions: options.completeSessions,
 					loadAllSessions: options.allowGlobalScope === false ? undefined : host.loadAllSessions,
 					allSessions: options.allSessions,
 					getTerminalRows: () => ui.terminal.rows,

package/src/chat/bash-execution.ts

@@ -12,7 +12,7 @@ import { sanitizeText } from "@oh-my-pi/pi-utils";
 import type { Terminal as XtermTerminalType } from "@oh-my-pi/pi-utils/vterm";
 import { theme } from "../theme/theme";
 import type { OutputArtifactError } from "../tools/streaming-output";
-import type { TruncationMeta } from "../tools/output-meta";
+import type { MinimizedMeta, TruncationMeta } from "../tools/output-meta";
 import { resolveImageOptions } from "../render/render-utils";
 import { OutputPane } from "../render/output-pane";
 import { loadXtermTerminal, readTerminalRows, styleTerminalRow } from "../tools/terminal-output";
@@ -26,6 +26,7 @@ import {
 	describeExecutionTool,
 	type ExecutionColorKey,
 	type ExecutionStatus,
+	executionStatusLabel,
 	PREVIEW_LINES,
 	resolveExecutionStatus,
 } from "./execution-shared";
@@ -34,6 +35,7 @@ import { type DescribeContext, type NativeNode, type NativeUiEvent, rootToggleEx
 import { NativeImageCache } from "../native/blobs";
 import { imageLinksEnabled, linkedImageSpan, linkedImageText } from "../prompt/image-references";
 import { Memo } from "../native/memo";
+import type { DynamicBorder } from "../chrome/dynamic-border";
 
 const STREAMING_LINE_CAP = PREVIEW_LINES * 5;
 // Minimum interval between processing incoming chunks for display (ms).
@@ -59,8 +61,10 @@ export class BashExecutionComponent extends Container {
 	#status: ExecutionStatus = "running";
 	#exitCode: number | undefined = undefined;
 	#loader: Loader;
+	readonly #bottomBorder: DynamicBorder;
 	#truncation?: TruncationMeta;
 	#artifactError?: OutputArtifactError;
+	#minimized?: MinimizedMeta;
 	#expanded = false;
 	// Post-finalize mutation counter (FinalizableBlock.getTranscriptBlockVersion):
 	// a completed command's block still mutates on expansion toggles, and the
@@ -103,9 +107,10 @@ export class BashExecutionComponent extends Container {
 		// Use dim border for excluded-from-context commands (!! prefix)
 		const colorKey = excludeFromContext ? "dim" : "bashMode";
 		this.#colorKey = colorKey;
-		const { contentContainer, loader } = buildExecutionFrame(this, ui, colorKey);
+		const { contentContainer, loader, bottomBorder } = buildExecutionFrame(this, ui, colorKey);
 		this.#contentContainer = contentContainer;
 		this.#loader = loader;
+		this.#bottomBorder = bottomBorder;
 		this.#outputPane = new OutputPane(theme, {
 			expanded: false,
 			collapsedMaxLines: PREVIEW_LINES,
@@ -121,7 +126,6 @@ export class BashExecutionComponent extends Container {
 		// Command header
 		this.#headerText = new Text(theme.fg(colorKey, theme.bold(`$ ${command}`)), 1, 0);
 		this.#contentContainer.addChild(this.#headerText);
-		this.#contentContainer.addChild(this.#loader);
 	}
 
 	/**
@@ -200,6 +204,7 @@ export class BashExecutionComponent extends Container {
 				exitCode: this.#exitCode,
 				truncation: this.#truncation,
 				artifactError: this.#artifactError,
+				minimized: this.#minimized,
 			};
 			return dataFirst
 				? describeExecutionTool({
@@ -358,6 +363,7 @@ export class BashExecutionComponent extends Container {
 			output?: string;
 			truncation?: TruncationMeta;
 			artifactError?: OutputArtifactError;
+			minimized?: MinimizedMeta;
 			images?: readonly ImageContent[];
 			showImages?: boolean;
 		},
@@ -367,6 +373,7 @@ export class BashExecutionComponent extends Container {
 		this.#endedAt ??= performance.now();
 		this.#truncation = options?.truncation;
 		this.#artifactError = options?.artifactError;
+		this.#minimized = options?.minimized;
 		this.#images = options?.images ?? [];
 		this.#showImages = options?.showImages ?? true;
 		if (options?.output !== undefined && !this.#ptyMode) {
@@ -383,6 +390,12 @@ export class BashExecutionComponent extends Container {
 		this.#updateDisplay();
 	}
 
+	/** The loader animates the bottom border from outside the child tree, so teardown stops it here. */
+	override dispose(): void {
+		this.#loader.dispose();
+		super.dispose();
+	}
+
 	override render(width: number): readonly string[] {
 		if (this.#displayDirty) {
 			this.#displayDirty = false;
@@ -440,15 +453,13 @@ export class BashExecutionComponent extends Container {
 			}
 		}
 
-		// Loader or status
-		if (this.#status === "running") {
-			this.#contentContainer.addChild(this.#loader);
-		} else {
+		// The bottom border keeps the live loader until the run settles, then its exit/cancel marker.
+		if (this.#status !== "running") {
+			this.#bottomBorder.setLabel(executionStatusLabel(this.#status, this.#exitCode));
 			const footer = buildStatusFooter({
-				status: this.#status,
-				exitCode: this.#exitCode,
 				truncation: this.#truncation,
 				artifactError: this.#artifactError,
+				minimized: this.#minimized,
 				hiddenLineCount,
 				suppressHiddenCount: hasSixelOutput,
 			});

package/src/chat/chat-transcript-builder.ts

@@ -37,7 +37,7 @@ import { theme } from "../theme";
 import {
 	assistantHasVisibleContent,
 	assistantUsageIsBilled,
-	buildAsyncResultBlock,
+	buildAsyncResultComponent,
 	buildFileMentionBlock,
 	buildIrcMessageCard,
 	buildLaunchCompletionBlock,
@@ -356,6 +356,7 @@ export class ChatTranscriptBuilder {
 				component.setComplete(message.exitCode, message.cancelled, {
 					truncation: message.meta?.truncation,
 					artifactError: message.meta?.artifactError,
+					minimized: message.meta?.minimized,
 					images: message.images,
 					showImages: displayPreferences.showImages,
 				});
@@ -599,7 +600,9 @@ export class ChatTranscriptBuilder {
 	#appendCustomMessage(message: Extract<AgentMessage, { role: "custom" | "hookMessage" }>): void {
 		if (!message.display) return;
 		if (message.customType === "async-result") {
-			const component = buildAsyncResultBlock(message);
+			const renderer = this.#deps.getMessageRenderer?.(message.customType);
+			const component = buildAsyncResultComponent(message, renderer);
+			this.#trackExpandable(component);
 			this.container.addChild(component);
 			return;
 		}

package/src/chat/eval-execution.ts

@@ -19,12 +19,14 @@ import {
 	describeExecutionTool,
 	type ExecutionColorKey,
 	type ExecutionStatus,
+	executionStatusLabel,
 	PREVIEW_LINES,
 	resolveExecutionStatus,
 } from "./execution-shared";
 import { code, span } from "../native/describe";
 import { type DescribeContext, type NativeNode, type NativeUiEvent, rootToggleExpanded } from "../native/node";
 import { Memo } from "../native/memo";
+import type { DynamicBorder } from "../chrome/dynamic-border";
 
 export type EvalExecutionLanguage = "python" | "js";
 
@@ -32,6 +34,7 @@ export class EvalExecutionComponent extends Container {
 	#status: ExecutionStatus = "running";
 	#exitCode: number | undefined = undefined;
 	#loader: Loader;
+	readonly #bottomBorder: DynamicBorder;
 	#truncation?: TruncationMeta;
 	#artifactError?: OutputArtifactError;
 	#expanded = false;
@@ -72,9 +75,10 @@ export class EvalExecutionComponent extends Container {
 		this.#language = language;
 
 		const colorKey: ExecutionColorKey = this.#excludeFromContext ? "dim" : "pythonMode";
-		const { contentContainer, loader } = buildExecutionFrame(this, ui, colorKey);
+		const { contentContainer, loader, bottomBorder } = buildExecutionFrame(this, ui, colorKey);
 		this.#contentContainer = contentContainer;
 		this.#loader = loader;
+		this.#bottomBorder = bottomBorder;
 		this.#outputPane = new OutputPane(theme, {
 			expanded: false,
 			collapsedMaxLines: PREVIEW_LINES,
@@ -89,7 +93,6 @@ export class EvalExecutionComponent extends Container {
 		});
 
 		this.#contentContainer.addChild(this.#formatHeader(colorKey));
-		this.#contentContainer.addChild(this.#loader);
 	}
 
 	/**
@@ -188,6 +191,12 @@ export class EvalExecutionComponent extends Container {
 		this.#updateDisplay();
 	}
 
+	/** The loader animates the bottom border from outside the child tree, so teardown stops it here. */
+	override dispose(): void {
+		this.#loader.dispose();
+		super.dispose();
+	}
+
 	#updateDisplay(): void {
 		// Only the collapsed preview hides lines; when expanded the footer must
 		// not keep advertising hidden lines / ctrl+o.
@@ -200,12 +209,10 @@ export class EvalExecutionComponent extends Container {
 
 		if (this.#outputPane.lineCount > 0) this.#contentContainer.addChild(this.#outputPane);
 
-		if (this.#status === "running") {
-			this.#contentContainer.addChild(this.#loader);
-		} else {
+		// The bottom border keeps the live loader until the run settles, then its exit/cancel marker.
+		if (this.#status !== "running") {
+			this.#bottomBorder.setLabel(executionStatusLabel(this.#status, this.#exitCode));
 			const footer = buildStatusFooter({
-				status: this.#status,
-				exitCode: this.#exitCode,
 				truncation: this.#truncation,
 				artifactError: this.#artifactError,
 				hiddenLineCount,