@oh-my-pi/pi-tui 18.3.0 → 18.3.2

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## [Unreleased]
 
+## [18.3.1] - 2026-09-25
+
+### Breaking Changes
+
+- Replaced the `CustomEditor` space-hold callbacks and `sttHoldEnabled` option with the `spaceHold.handler` API.
+- Removed `Editor.cursorOverrideWidth`; widths for `cursorOverride` glyphs are now measured automatically.
+
+### Added
+
+- Added push-to-talk dictation to `Input`, with live transcription and `cursorOverride` support.
+- Added visual indicators for live-steered user messages and paginated content in read-tool results.
+- Added transcript support for `cfg://` configuration read and write tool calls.
+- Added an Anthropic slow-mode badge to the status-line model segment, showing the priority state, end time, and remaining request percentage when available.
+
+### Changed
+
+- Updated the settings selector so clearing an input field fully unsets the corresponding setting.
+
+### Fixed
+
+- Fixed dimmed blockquote styling after inline code spans.
+- Fixed rendering of tool calls and results for top-level extension and MCP tools invoked through `xd://` links.
+- Fixed file links in pending Read and Write cards so they open the correct local targets, including paths in the home directory, archives, and databases.
+
 ## [18.3.0] - 2026-09-24
 
 ### Added

package/THIRD-PARTY-NOTICES.txt

@@ -78,8 +78,8 @@ below.
 uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
-b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cut,
-date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
+b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
 printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
 truncate, uname, uniq, wc, whoami, yes.
 

package/dist/types/chat/read-tool-group.d.ts

@@ -7,9 +7,9 @@ export declare function readArgsHaveTarget(args: unknown): boolean;
 /**
  * Whether a read collapses into the compact {@link ReadToolGroupComponent}
  * rather than a full tool execution. Filesystem/external targets always
- * collapse; other internal URLs (`skill://`, `agent://`, …) render full so
- * their resolved content is visible. `xd://` device reads are the exception —
- * they list devices/docs and read better in the compact grouped view.
+ * collapse; registered internal-URL schemes render full so their resolved
+ * content is visible, unless their spec declares `compactTranscript`
+ * (device listings/docs read better in the compact grouped view).
  */
 export declare function readArgsCollapseIntoGroup(args: unknown): boolean;
 /**

package/dist/types/chat/user-message.d.ts

@@ -6,6 +6,8 @@ export interface UserBubbleOptions {
     imageLinks?: readonly (string | undefined)[];
     /** Agent-attributed input: dim, flat prose. */
     synthetic?: boolean;
+    /** Delivered into the response that was streaming; marked `*` at the bubble's top-left. */
+    liveSteered?: boolean;
     /** SKILL.md path for a skill chip by name; `undefined` leaves the chip unlinked. */
     skillPath?: (name: string) => string | undefined;
 }
@@ -19,7 +21,8 @@ export interface UserBubbleOptions {
 export declare function userBubbleColor(options?: UserBubbleOptions, tokenRegex?: RegExp): (value: string) => string;
 /**
  * Component that renders a user message. Accepts an agent reaction badge
- * (see {@link ReactionTarget}) drawn right-aligned in the bubble's top padding row.
+ * (see {@link ReactionTarget}) drawn right-aligned in the bubble's top padding row;
+ * a live-steered message carries a `*` marker left-aligned in the same row.
  */
 export declare class UserMessageComponent extends Container implements ReactionTarget {
     #private;

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

@@ -69,8 +69,6 @@ export declare class Editor implements Component, Focusable {
     focused: boolean;
     /** When set, replaces the normal cursor glyph at end-of-text with this ANSI-styled string. */
     cursorOverride: string | undefined;
-    /** Display width of the cursorOverride glyph (needed because override may contain ANSI escapes). */
-    cursorOverrideWidth: number | undefined;
     /** Optional hook that decorates displayed user text after source-text layout.
      *  Width-changing output is allowed on lines without the cursor; it is truncated
      *  to the content width rather than reflowed. Cursor glyphs and inline hints are excluded. */

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

@@ -1,3 +1,4 @@
+import { SpaceHoldGesture } from "../space-hold.js";
 import { type Component, type Focusable } from "../tui.js";
 /**
  * Input component - single-line text input with horizontal scrolling
@@ -10,6 +11,10 @@ export declare class Input implements Component, Focusable {
     mask: boolean;
     onSubmit?: (value: string) => void;
     onEscape?: () => void;
+    /** Space-bar push-to-talk; set its `handler` to enable it. */
+    readonly spaceHold: SpaceHoldGesture;
+    /** When set, replaces the cursor glyph at end-of-text with this ANSI-styled string. */
+    cursorOverride: string | undefined;
     /** Focusable interface - set by TUI when focus changes */
     focused: boolean;
     getValue(): string;
@@ -22,6 +27,17 @@ export declare class Input implements Component, Focusable {
     /** Apply terminal paste semantics to text from non-bracketed paste transports
      *  (e.g. kitty's OSC 5522 enhanced clipboard read). Mirrors `Editor.pasteText`. */
     pasteText(text: string): void;
+    /** Programmatically trigger submission (e.g. for voice submit). */
+    submit(): void;
+    /** Delete up to `count` characters immediately before the cursor. */
+    deleteBeforeCursor(count: number): void;
+    /** Show or replace a volatile speech-to-text preview at the cursor, outside undo history.
+     *  Finalize it with {@link commitVolatileText} or drop it with {@link clearVolatileText}. */
+    setVolatileText(text: string): void;
+    /** Remove the current volatile preview without committing it. */
+    clearVolatileText(): void;
+    /** Drop any volatile preview, then insert `text` as a single undoable edit. */
+    commitVolatileText(text: string): void;
     invalidate(): void;
     render(width: number): readonly string[];
 }

package/dist/types/overlays/btw-history-panel.d.ts

@@ -1,5 +1,6 @@
-import { type Component, type Focusable } from "../index.js";
+import { type Component, type Focusable, Input } from "../index.js";
 import { type BtwHistoryRecord } from "./btw-history.js";
+import type { SpaceHoldHandler } from "../space-hold.js";
 interface BtwHistoryPanelOptions {
     records: readonly BtwHistoryRecord[];
     onClose: () => void;
@@ -7,6 +8,8 @@ interface BtwHistoryPanelOptions {
     onCancel: (record: BtwHistoryRecord) => void;
     canFollowUp?: (record: BtwHistoryRecord) => boolean;
     onFollowUp?: (record: BtwHistoryRecord, question: string, signal: AbortSignal) => Promise<boolean>;
+    /** Space-bar push-to-talk for a follow-up composer: dictates into `input` while Space is held. */
+    spaceHold?: (input: Input) => SpaceHoldHandler;
     requestRender: () => void;
     getHeight: () => number;
 }

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

@@ -19,8 +19,10 @@
  *
  * Keys: Up/Down step through rendered items in transcript order (within the
  * active column when a strip is open), Left/Right slide between branch
- * variants at a fork and jump between user turns elsewhere, Enter rewinds to
- * the outlined item, Esc cancels.
+ * variants at a fork and jump between user turns elsewhere, `f` opens a
+ * filter (typing narrows the current path to matching items; Esc leaves the
+ * filter with the selection kept), Enter rewinds to the outlined item, Esc
+ * cancels.
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import { type Component, type TUI } from "../index.js";

package/dist/types/overlays/settings-defs.d.ts

@@ -57,6 +57,11 @@ export interface SettingsHost {
     entries: readonly SettingsDisplayEntry[];
     get(path: string): unknown;
     set(path: string, value: unknown): void;
+    /**
+     * Removes the value from the global config: a project or other layer, or an environment
+     * variable, that configures the setting still applies; otherwise the default does.
+     */
+    unset(path: string): void;
     normalizeProviderLimits(value: unknown): Record<string, number>;
     validateProviderLimits(value: unknown): Record<string, number>;
 }

package/dist/types/prompt/composer.d.ts

@@ -56,6 +56,17 @@ export interface ComposerOptions {
     readonly exit?: (code: number) => void;
     readonly now?: () => number;
 }
+/** How {@link Composer.setRuntimeChildren} bills below-transcript roots against transcript retirement. */
+export interface RuntimeChildrenOptions {
+    /**
+     * Below-transcript roots whose growth is momentary (inline dialogs, a tall
+     * multi-line editor). They are billed at their smallest height so expansion
+     * clips the live tail instead of retiring rows a later shrink could not
+     * reclaim (#11007). Every other root is billed at its current height, so
+     * settled rows it displaces retire to native scrollback.
+     */
+    readonly transient?: readonly Component[];
+}
 /** Controls the first terminal paint for a composer that does not already own the terminal. */
 export interface ComposerStartOptions {
     readonly clearScrollback?: boolean;
@@ -149,7 +160,7 @@ export declare class Composer implements TerminalFrameProvider {
      */
     setStatusComponent(component: Component): void;
     /** Mount or replace session-aware root children while preserving the header and status hosts. */
-    setRuntimeChildren(children: readonly Component[]): void;
+    setRuntimeChildren(children: readonly Component[], options?: RuntimeChildrenOptions): void;
     /** Play or replay the welcome intro against the stable header render target. */
     playWelcomeIntro(): void;
     /** Transfer terminal ownership to InteractiveMode without stopping the composer. */

package/dist/types/prompt/custom-editor.d.ts

@@ -1,27 +1,11 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { Editor, type EditorTextDecorationContext } from "../components/editor.js";
 import { type KeyId } from "../keys.js";
+import { SpaceHoldGesture } from "../space-hold.js";
 import { TUI } from "../tui.js";
 import type { AppKeybinding } from "../app-keybindings.js";
 import { type SpellingFeatures } from "./macos-spelling.js";
 type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
-/** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
- *  deliberate press. OS auto-repeat is fast; a deliberate tap (even a fast one) is slower. */
-export declare const SPACE_REPEAT_MAX_GAP_MS = 120;
-/** Two consecutive inter-space gaps are "mechanical" (machine-driven auto-repeat) when both are
- *  within {@link SPACE_REPEAT_MAX_GAP_MS} and differ by no more than this — an absolute jitter floor
- *  or, for slower repeat rates, {@link SPACE_REPEAT_JITTER_RATIO} of the smaller gap. OS key-repeat
- *  is metronomic; a human smashing the bar is fast but irregular, so its deltas never stay this
- *  steady. */
-export declare const SPACE_REPEAT_JITTER_MS = 18;
-export declare const SPACE_REPEAT_JITTER_RATIO = 0.35;
-/** Consecutive mechanical (fast + steady) deltas that confirm the space bar is held and start
- *  recording. Needs a sustained metronomic cadence, so jittery smashing and deliberate taps never
- *  reach it. */
-export declare const SPACE_HOLD_MECHANICAL_RUN = 2;
-/** Idle gap (ms) after the last repeated space that counts as the space bar being released, ending
- *  the push-to-talk recording. Must comfortably exceed the OS key-repeat interval. */
-export declare const SPACE_HOLD_RELEASE_MS = 250;
 /**
  * Extract image-or-other file paths from plain (un-bracketed) clipboard text.
  * Mirrors {@link extractBracketedPastePaths} for terminals/handlers that
@@ -224,15 +208,10 @@ export declare class CustomEditor extends Editor {
     onCapsLock?: () => void;
     /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
     onLeftAtStart?: () => void;
-    /** Fired when a sustained space-bar hold is recognized — the push-to-talk STT start. The
-     *  optimistically-typed spaces have already been deleted by the time this runs. */
-    onSpaceHoldStart?: () => void;
-    /** Fired when the held space bar is released (detected as an idle gap with no further repeated
-     *  spaces) — the push-to-talk STT stop. */
-    onSpaceHoldEnd?: () => void;
-    /** Gate for the space-hold gesture. Returns false to keep the space bar inserting spaces
-     *  normally; wired to `stt.enabled` so disabling STT restores plain space behavior. */
-    sttHoldEnabled?: () => boolean;
+    /** Space-bar push-to-talk; set its `handler` to enable it. It is a text-composition gesture, so it
+     *  stays out of Vim's Normal/Visual modes (where the space bar is the `l` motion) and away from an
+     *  open autocomplete menu. */
+    readonly spaceHold: SpaceHoldGesture;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.

package/dist/types/space-hold.d.ts

@@ -0,0 +1,45 @@
+/** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
+ *  deliberate press. OS auto-repeat is fast; a deliberate tap (even a fast one) is slower. */
+export declare const SPACE_REPEAT_MAX_GAP_MS = 120;
+/** Two consecutive inter-space gaps are "mechanical" (machine-driven auto-repeat) when both are
+ *  within {@link SPACE_REPEAT_MAX_GAP_MS} and differ by no more than this — an absolute jitter floor
+ *  or, for slower repeat rates, {@link SPACE_REPEAT_JITTER_RATIO} of the smaller gap. OS key-repeat
+ *  is metronomic; a human smashing the bar is fast but irregular, so its deltas never stay this
+ *  steady. */
+export declare const SPACE_REPEAT_JITTER_MS = 18;
+export declare const SPACE_REPEAT_JITTER_RATIO = 0.35;
+/** Consecutive mechanical (fast + steady) deltas that confirm the space bar is held and start
+ *  recording. Needs a sustained metronomic cadence, so jittery smashing and deliberate taps never
+ *  reach it. */
+export declare const SPACE_HOLD_MECHANICAL_RUN = 2;
+/** Idle gap (ms) after the last repeated space that counts as the space bar being released, ending
+ *  the push-to-talk recording. Must comfortably exceed the OS key-repeat interval. */
+export declare const SPACE_HOLD_RELEASE_MS = 250;
+/** What a recognized space-bar hold drives — the push-to-talk start and stop. */
+export interface SpaceHoldHandler {
+    /** Gate for the gesture. Returns false to keep the space bar inserting spaces normally, so
+     *  disabling push-to-talk restores plain space behavior. */
+    enabled(): boolean;
+    /** A sustained hold was recognized. The optimistically-typed spaces have already been deleted. */
+    onStart(): void;
+    /** The held space bar was released (an idle gap with no further repeated spaces, or any other key). */
+    onEnd(): void;
+}
+/** What the host must do with a keypress after {@link SpaceHoldGesture.process} has seen it:
+ *  `"pass"` — handle it normally; `"type"` — insert the space now (it is tracked back out if the run
+ *  turns into a hold); `"swallow"` — drop it, the gesture consumed it. */
+export type SpaceHoldStep = "pass" | "type" | "swallow";
+/** Space-hold push-to-talk state machine. A held space bar emits OS auto-repeat: a *steady* stream
+ *  of spaces at a fixed fast interval. We watch the inter-space deltas and only recognize a hold once
+ *  {@link SPACE_HOLD_MECHANICAL_RUN} consecutive deltas are "mechanical" — both auto-repeat-fast and
+ *  near-identical (see {@link gapsAreMechanical}). Smashing the bar is fast but jittery and deliberate
+ *  taps are too slow, so neither escalates and both keep typing real spaces; the few spaces typed
+ *  before a real hold is recognized are tracked back out of the host input. */
+export declare class SpaceHoldGesture {
+    #private;
+    /** Unset (the default) keeps the space bar typing spaces. */
+    handler: SpaceHoldHandler | undefined;
+    constructor(deleteTyped: (count: number) => void, allowed?: () => boolean);
+    /** Feed one keypress, `isSpace` when it is a plain space bar press. */
+    process(isSpace: boolean): SpaceHoldStep;
+}

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

@@ -63,6 +63,8 @@ export interface StatusLineSession {
     } | undefined;
     autoResolvedThinkingLevel(): string | undefined;
     isFastModeActive(): boolean;
+    /** Anthropic usage-limit label (`limit reached · wrapping up · resets 14:30`, `low priority until 14:30 · 62% left`). */
+    getAnthropicSlowModeLabel?(): string | undefined;
     getPrewalkState?(): unknown;
     getAsyncJobSnapshot(): {
         running: readonly {

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

@@ -0,0 +1,37 @@
+/**
+ * Transcript renderers for `cfg://` settings reads and writes.
+ *
+ * Reads show the YAML-ish settings listing the model received, highlighted as
+ * YAML. Writes show the `previous → value` change, its scope (session or
+ * saved), and whether the user approved it.
+ */
+import type { Component } from "../tui.js";
+import { type Theme } from "../theme/theme.js";
+import type { RenderResultOptions } from "./renderer.js";
+import { type CardToolResult } from "./result-card.js";
+/** Summary of a `cfg://` read, attached to read tool details. */
+export interface CfgReadDetails {
+    /** Dotted setting path or namespace that was read; empty for the whole tree. */
+    path: string;
+    /** Settings in the listing. */
+    count: number;
+    /** Listed settings whose effective value differs from the schema default. */
+    modified: number;
+}
+/** How a `cfg://` write ended. */
+export type CfgWriteOutcome = "applied" | "declined" | "unchanged";
+/** A `cfg://` write, attached to write tool details. Values are display-formatted (credentials redacted). */
+export interface CfgWriteDetails {
+    path: string;
+    /** Persisted to config.yml rather than scoped to the session. */
+    save: boolean;
+    previous: string;
+    value: string;
+    outcome: CfgWriteOutcome;
+    /** Effective value after saving when a higher-precedence layer still shadows the saved one. */
+    effective?: string;
+}
+/** Render `read cfg://…`: pending header, or the highlighted listing with counts. */
+export declare function renderCfgRead(url: string, result: CardToolResult | undefined, details: CfgReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+/** Render `write cfg://…[/save]`: the proposed value while pending, then the approved/declined change. */
+export declare function renderCfgWrite(url: string, content: string | undefined, result: CardToolResult | undefined, details: CfgWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;

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

@@ -0,0 +1,16 @@
+/** Canonical prefix for settings URLs. */
+export declare const CFG_URL_PREFIX = "cfg://";
+/** Trailing write segment that persists a `cfg://` change instead of scoping it to the session. */
+export declare const CFG_SAVE_SEGMENT = "save";
+/** Setting addressed by a `cfg://` URL. */
+export interface CfgTarget {
+    /** Setting path segments; empty for the root. `/` and `.` both separate segments. */
+    segments: string[];
+    /** Whether the URL ends in the `/save` suffix, which is removed from {@link segments}. */
+    save: boolean;
+}
+/**
+ * Parse a `cfg://` URL (`cfg://advisor/enabled`, `cfg://advisor.enabled/save`).
+ * Returns `null` for other schemes; query and fragment are ignored.
+ */
+export declare function parseCfgUrl(input: string): CfgTarget | null;

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

@@ -11,7 +11,7 @@ export interface FindRange {
 }
 /** A file whose verified passages cleared the threshold; `ranges` are merged positive spans, strongest first. */
 export interface FindHit {
-    /** Display path relative to {@link FindToolDetails.cwd}, or an `omp://` doc URL for docs scopes. */
+    /** Display path relative to {@link FindToolDetails.cwd}, or an internal URL under URL scopes. */
     rel: string;
     /** Filename judgment, when the name batch answered. */
     nameScore?: number;
@@ -55,7 +55,7 @@ export interface FindToolDetails {
     elapsedMs: number;
     /** Session cwd; hit paths are relative to it. */
     cwd: string;
-    /** Display form of the searched directory when narrower than cwd. */
+    /** Display form of the searched directory or file when narrower than cwd. */
     scopePath?: string;
     meta?: OutputMeta;
 }

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

@@ -96,6 +96,8 @@ export interface OutputMeta {
     /** Capture failure of this output itself; aggregate reports keep source failures on their entries. */
     artifactError?: OutputArtifactError;
     source?: SourceMeta;
+    /** The output is a bounded page of session artifact storage its `source` re-reads with line selectors; spill-to-artifact skips it. */
+    pagedSource?: true;
     diagnostics?: DiagnosticMeta;
     limits?: LimitsMeta;
 }

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

@@ -3,6 +3,7 @@ import type { Theme } from "../theme/theme.js";
 import type { RenderResultOptions } from "./renderer.js";
 import type { AgentActivitySnapshot, CoordinationDetails, JobSnapshot } from "./wait.js";
 import type { DaemonSnapshot } from "./daemon.js";
+import { type CardToolResult as ToolResult } from "./result-card.js";
 export interface ProcReadDetails {
     jobs?: JobSnapshot[];
     agents?: AgentActivitySnapshot[];
@@ -20,15 +21,7 @@ export type ProcWriteDetails = CoordinationDetails | {
 };
 /** Process operation selected by a write URL, independent of its content. */
 export type ProcWriteAction = "stdin" | "mode" | "kill";
-interface ToolResult {
-    content: Array<{
-        type: string;
-        text?: string;
-    }>;
-    isError?: boolean;
-}
 export declare function renderAgentWrite(to: string, body: string, result: ToolResult | undefined, details: CoordinationDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
 /** Render live and completed process writes with the URL-selected operation. */
 export declare function renderProcWrite(id: string, action: ProcWriteAction, content: string | undefined, result: ToolResult | undefined, details: ProcWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
 export declare function renderProcRead(id: string, result: ToolResult | undefined, details: ProcReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
-export {};

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

@@ -5,12 +5,15 @@ import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { TruncationResult } from "./streaming-output.js";
 import { type ProcReadDetails } from "./proc-render.js";
+import { type CfgReadDetails } from "./cfg-render.js";
+import { type InternalUrlSchemeSpec } from "./url-scheme-host.js";
 /** Read result metadata retains truncation statistics, not a second copy of the body. */
 export type ReadTruncationStats = Omit<TruncationResult, "content">;
 /** Display metadata for file and URL reads. */
 export interface ReadToolDetails {
     kind?: "file" | "url";
     proc?: ProcReadDetails;
+    cfg?: CfgReadDetails;
     /** Filesystem hyperlink target resolved by the executing tool. */
     displayTarget?: string;
     truncation?: ReadTruncationStats;
@@ -71,12 +74,16 @@ export declare function splitPathAndSel(rawPath: string): {
  * This function iteratively peels selector-shaped chunks (well-formed plus
  * common malformed shapes like `:-N-M`) so the rest of the read tool can pass a
  * clean URL to the protocol handler and surface selector errors via parseSel
- * instead of as misleading "host invalid" errors from the handler. Schemes
- * whose resource URIs may legitimately contain colons (`mcp://`) are skipped.
+ * instead of as misleading "host invalid" errors from the handler.
+ *
+ * Only schemes whose spec declares `lines` selectors peel; server-defined URIs
+ * (`opaque`), selector-free schemes, and unregistered schemes pass through
+ * verbatim. `specOf` defaults to the installed scheme host, so nothing peels
+ * before a host is installed.
  *
  * Falls back to the input unchanged when nothing matches.
  */
-export declare function splitInternalUrlSel(rawPath: string): {
+export declare function splitInternalUrlSel(rawPath: string, specOf?: (scheme: string) => InternalUrlSchemeSpec | undefined): {
     path: string;
     sel?: string;
 };
@@ -91,6 +98,10 @@ export interface ReadRenderArgs {
     limit?: number;
     raw?: boolean;
 }
+/** Local file a pending read/write input points at, before the tool resolves it:
+ * expands `~` and drops archive-member / SQLite-row selectors so the link opens
+ * the containing file. */
+export declare function pendingFileLinkPath(inputPath: string): string;
 /** Absolute fs path the read result actually resolved to, used as the OSC 8 link
  * 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

package/dist/types/tools/result-card.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Line-based status cards shared by the internal-URL renderers (`proc://`,
+ * `agent://`, `cfg://`): a header plus sanitized, width-truncated body lines.
+ */
+import type { Component } from "../tui.js";
+import type { RenderResultOptions } from "./renderer.js";
+/** Tool result fields the card renderers read. */
+export interface CardToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+}
+/** First text block of a tool result, or `""`. */
+export declare function firstText(result: CardToolResult): string;
+/** Sanitize one display line: tabs become spaces, carriage returns are dropped. */
+export declare function safe(value: string): string;
+/** Padded card whose lines are sanitized and truncated, re-rendered when the expanded state flips. */
+export declare function card(lines: (width: number, expanded: boolean) => string[], options: RenderResultOptions): Component;

package/dist/types/tools/url-scheme-host.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Scheme facts supplied by the internal URL host. pi-tui cannot import the
+ * coding-agent router, so the router installs this bridge when it loads;
+ * selector peeling and transcript renderers consult it instead of hardcoding
+ * scheme names.
+ */
+/** Renderer-relevant subset of a registered scheme's declared spec. */
+export interface InternalUrlSchemeSpec {
+    /** `lines`: a trailing `:<selector>` chain is a read selector; `none`/`opaque`: never peel. */
+    readonly selectors: "lines" | "none" | "opaque";
+    /** A trailing `:N` with no path after the authority is a port, not a selector (ssh://host:2222). */
+    readonly portAuthority?: boolean;
+    /** Read cards collapse into the compact read group like plain files instead of expanding. */
+    readonly compactTranscript?: boolean;
+}
+/** Scheme registry capabilities installed by the internal URL host. */
+export interface InternalUrlSchemeHost {
+    /** Declared spec of a registered scheme (case-insensitive); undefined when unregistered. */
+    spec(scheme: string): InternalUrlSchemeSpec | undefined;
+}
+/** Install the scheme registry. Until one is installed, no URL counts as an internal scheme. */
+export declare function setInternalUrlSchemeHost(host: InternalUrlSchemeHost): void;
+/** Declared spec of `scheme`; undefined when it is unregistered or no host is installed. */
+export declare function internalUrlSchemeSpec(scheme: string): InternalUrlSchemeSpec | undefined;
+/** Split a hierarchical `scheme://rest` URL into its lowercased scheme and the text after `://`. */
+export declare function splitUrlScheme(input: string): {
+    scheme: string;
+    rest: string;
+} | undefined;

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

@@ -3,6 +3,7 @@ import type { Component } from "../tui.js";
 import { type Theme } from "../theme/theme.js";
 import type { CoordinationDetails } from "./wait.js";
 import { type ProcWriteDetails } from "./proc-render.js";
+import { type CfgWriteDetails } from "./cfg-render.js";
 import type { FileDiagnosticsResult } from "./lsp.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
@@ -20,6 +21,7 @@ export interface WriteToolDetails {
     xdev?: XdevRenderDispatch;
     message?: CoordinationDetails;
     proc?: ProcWriteDetails;
+    cfg?: CfgWriteDetails;
 }
 interface WriteRenderArgs {
     path?: unknown;

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

@@ -9,10 +9,18 @@ export interface XdevMountedRenderer {
     renderResult?(...args: Parameters<ToolRenderer["renderResult"]>): unknown;
     mergeCallAndResult?: boolean;
 }
-/** Mounted tool presentation state supplied by the host's canonical tool map. */
+/** Tool presentation state supplied by the host's canonical tool map. */
 export interface XdevMountedState {
     readonly mountedNames: ReadonlySet<string>;
     readonly tools: ReadonlyMap<string, XdevMountedRenderer>;
+    /**
+     * Canonical renderer for a device name, supplied by the host with the same
+     * predicate as dispatch (`resolveXdevTool`: mounted devices plus active
+     * top-level tools, which the `write` transport also accepts). The TUI keeps
+     * no predicate copy of its own — a second copy is what dropped a top-level
+     * dispatch to the generic card.
+     */
+    readonly resolve?: (name: string) => XdevMountedRenderer | undefined;
 }
 /** Result metadata consumed by delegated device rendering. */
 export interface XdevRenderDispatch {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.3.0",
+	"version": "18.3.2",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -40,14 +40,14 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.3.0",
-		"@oh-my-pi/pi-agent-core": "18.3.0",
-		"@oh-my-pi/pi-ai": "18.3.0",
-		"@oh-my-pi/pi-catalog": "18.3.0",
-		"@oh-my-pi/pi-natives": "18.3.0",
-		"@oh-my-pi/pi-utils": "18.3.0",
-		"@oh-my-pi/pi-wire": "18.3.0",
-		"@oh-my-pi/snapcompact": "18.3.0"
+		"@oh-my-pi/omptype": "18.3.2",
+		"@oh-my-pi/pi-agent-core": "18.3.2",
+		"@oh-my-pi/pi-ai": "18.3.2",
+		"@oh-my-pi/pi-catalog": "18.3.2",
+		"@oh-my-pi/pi-natives": "18.3.2",
+		"@oh-my-pi/pi-utils": "18.3.2",
+		"@oh-my-pi/pi-wire": "18.3.2",
+		"@oh-my-pi/snapcompact": "18.3.2"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

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

@@ -310,7 +310,11 @@ export class ChatTranscriptBuilder {
 						this.#trackExpandable(collapsed);
 						this.container.addChild(collapsed);
 					} else {
-						this.container.addChild(new UserMessageComponent(userText));
+						this.container.addChild(
+							new UserMessageComponent(userText, {
+								liveSteered: message.role === "user" && message.liveSteered === true,
+							}),
+						);
 					}
 				}
 				break;