@oh-my-pi/pi-tui 18.13.2 → 18.14.0

package/dist/types/chrome/transcript-status.d.ts

@@ -1,24 +1,36 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
 import type { NativeNode } from "../native/node.js";
 import { type ThemeColor } from "../theme/index.js";
 import { TranscriptBlock } from "./transcript-container.js";
-/** One themed run of a status row. */
+import { type NoticeTone } from "./transcript-notice.js";
+/** One themed run of a status row's terminal line. */
 export interface TranscriptStatusPart {
     readonly text: string;
     readonly color: ThemeColor;
-    /** Glyph art (tree connectors) drawn only in rows; native terminals draw their own structure. */
-    readonly rowsOnly?: boolean;
 }
-/** One compact transcript status row assembled from themed parts, joined by single spaces. */
+/** A status row in a native terminal: its {@link noticeRow}'s tone, icon and message. */
+export interface TranscriptStatusNative {
+    readonly tone: NoticeTone;
+    /** Icon name in place of the tone's own. */
+    readonly icon?: string;
+    readonly message: readonly TspSpan[];
+}
+/**
+ * One compact transcript status row: the terminal line's themed parts (joined
+ * by single spaces, glyphs and brackets included) and the same row natively.
+ */
 export interface TranscriptStatusRow {
     readonly parts: readonly (TranscriptStatusPart | undefined)[];
     readonly indent?: number;
+    readonly native: TranscriptStatusNative;
 }
-/** Shared compact status-pill block used by notices and background activity. */
+/**
+ * Shared compact status block for background activity and prompt file reads:
+ * one themed line per row in a text terminal, one notice row per row natively
+ * (`omp.status-block`).
+ */
 export declare class TranscriptStatusBlock extends TranscriptBlock {
     #private;
     constructor(rows: readonly TranscriptStatusRow[]);
-    /** Append a supplemental line such as an artifact warning. */
-    addLine(parts: readonly (TranscriptStatusPart | undefined)[], indent?: number): void;
-    /** One wrapped text line per status row. */
     describe(): NativeNode;
 }

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

@@ -98,6 +98,14 @@ export declare class Editor implements Component, Focusable {
     describeDecorations: ((lines: readonly string[]) => readonly TspEditorDecoration[]) | undefined;
     /** TSP code language of the buffer (`python`, `bash`): the terminal highlights it in the mono face. */
     describeLanguage: (() => string | undefined) | undefined;
+    /** Label the TSP field to disable host-side editing while another input owner handles raw keys. */
+    nativeKeyPassthrough: boolean;
+    /**
+     * Ask the TSP terminal to keep what is typed into this field and draw it at
+     * the caret until this clears, then send it: set while startup cannot read
+     * input yet (the prompt composer's deferred-input start).
+     */
+    nativeTypeahead: boolean;
     /**
      * TSP chrome around the `editor` node (the prompt composer's chips, mode
      * chip, send/stop): the root role, the children with `input` placed where

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

@@ -10,6 +10,13 @@ import type { Component } from "../tui.js";
  * byte-identical to rendering `text`.
  */
 export declare function streamingMarkdownSource(text: string): string;
+/**
+ * Whether `text` ends inside a code fence the source never closed. The
+ * renderer still draws such a fence's closing border, so a caller publishing a
+ * settled source prefix must drop that fabricated row: it is not a prefix of
+ * the live block, which reaches the border only once the closer arrives.
+ */
+export declare function endsInsideOpenFence(text: string): boolean;
 /**
  * Streaming `md` source for a native terminal, minus a still-growing table row:
  * the unterminated last line when a GFM table (a run of pipe lines holding a

package/dist/types/native/blobs.d.ts

@@ -29,7 +29,8 @@ export declare function base64ImageNode(data: string, mimeType: string, p?: Omit
 /**
  * Props that make an `image` node open the file at `filePath` (as a `file://` URL, the TSP
  * open-target form): a click zooms the image in the terminal, and the file opens from its
- * context menu. Empty without a file.
+ * context menu. Always uses a local file URL because the open action runs locally,
+ * even when remote file handlers are configured. Empty without a file.
  */
 export declare function openableImageProps(filePath: string | undefined): Pick<TspProps<"image">, "href" | "actions">;
 /**

package/dist/types/native/picker.d.ts

@@ -16,14 +16,14 @@
  * the item id and `action` with an action id (plus `value` for
  * `scope`/`tab`/`strip`). {@link pickerEvent} folds them into one shape.
  */
-import type { TspPickerAction, TspPickerItem, TspPickerProps } from "@oh-my-pi/pi-wire";
+import type { TspPickerAction, TspPickerItem, TspPickerProps, TspProps } from "@oh-my-pi/pi-wire";
 import type { KeyName } from "../key-hint-format.js";
 import { type Keybinding } from "../keybindings.js";
 import type { Input } from "../components/input.js";
 import type { SelectItem, SelectList } from "../components/select-list.js";
 import type { NativeChild, NativeNode, NativeUiEvent } from "./node.js";
 /** The picker sheet; `preview` children fill its preview pane. */
-export declare function picker(p: TspPickerProps, preview?: readonly NativeChild[]): NativeNode;
+export declare function picker(p: TspProps<"picker">, preview?: readonly NativeChild[]): NativeNode;
 /**
  * A picker's search field from the {@link Input} that edits it: the text and
  * its caret. `null` hides the field. Memoized pickers MUST key on the caret
@@ -37,7 +37,7 @@ export declare const PICKER_KEY = "picker";
  * the picker as child {@link PICKER_KEY}, which the reconciler hoists into
  * `layer`. Route its events with `pickerEvent(event, PICKER_KEY)`.
  */
-export declare function dockedPicker(p: TspPickerProps, preview?: readonly NativeChild[]): NativeNode;
+export declare function dockedPicker(p: TspProps<"picker">, preview?: readonly NativeChild[]): NativeNode;
 /** Keycap names for one key id (`"alt+enter"` → `["alt", "enter"]`, `"escape"` → `["esc"]`). */
 export declare function pickerKeys(key: KeyName | string): string[];
 /** The keycaps of a keybinding's primary key, empty when unbound. */

package/dist/types/overlays/annotation-overlay.d.ts

@@ -1,7 +1,7 @@
 import { type Focusable, type TUI } from "../index.js";
 import { type KeybindingsManager } from "../app-keybindings.js";
 import { type Theme } from "../theme/theme.js";
-import type { CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
+import type { AnnotationOverlayDraft, CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
 import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type NativeNode, type NativeUiEvent } from "../native/node.js";
 export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
@@ -20,6 +20,8 @@ export interface CodeReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
 export interface TextReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
     onComplete(result: TextReviewOverlayResult | undefined): void;
 }
+/** Clears every note and closes; the host then has nothing to keep. Needs a second confirm. */
+export declare const DISCARD_ANNOTATIONS_ACTION = "Discard notes and close";
 /** Splits a text source into the overlay's 1-based annotatable lines. */
 export declare function splitTextLines(text: string): string[];
 /** The native sheet: full-pane glass, titled by the review kind with what is under review after it. */
@@ -38,6 +40,10 @@ export declare class AnnotationOverlay implements Focusable {
     setUseTerminalCursor(useTerminalCursor: boolean): void;
     invalidate(): void;
     dispose(): void;
+    /** Notes, the unfinished note, and any source edit, in the form {@link restoreDraft} replays. */
+    getDraft(): AnnotationOverlayDraft;
+    /** Replay a draft taken from this same source; anything anchored outside it is dropped. */
+    restoreDraft(draft: AnnotationOverlayDraft): void;
     getAnnotations(): CodeReviewAnnotation[];
     getTextAnnotations(): TextReviewAnnotation[];
     /** Repo-relative path of the diff file under the cursor, if this is a code review. */

package/dist/types/overlays/annotation-types.d.ts

@@ -84,3 +84,31 @@ export interface TextReviewOverlayResult {
     /** Source text after an external-editor edit; absent when the source was not edited. */
     editedText?: string;
 }
+export type AnnotationOverlayDraft = {
+    kind: "diff";
+    annotations: {
+        fileIndex: number;
+        sourceIndex: number;
+        annotation: CodeReviewAnnotation;
+    }[];
+    editor?: {
+        fileIndex: number;
+        sourceIndex: number;
+        scope: "file" | "line";
+        editingAnnotationIndex?: number;
+        text: string;
+    };
+} | {
+    kind: "text";
+    annotations: {
+        sourceIndex: number;
+        annotation: TextReviewAnnotation;
+    }[];
+    editedText?: string;
+    editor?: {
+        sourceIndex: number;
+        scope: "text" | "line";
+        editingAnnotationIndex?: number;
+        text: string;
+    };
+};

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

@@ -7,7 +7,11 @@ import type { NativeNode, NativeUiEvent } from "../native/node.js";
  */
 export declare class LoginDialogComponent extends OverlayPanel {
     #private;
-    constructor(tui: TUI, providerId: string, onComplete: (success: boolean, message?: string) => void, openUrl: (url: string) => void);
+    constructor(tui: Pick<TUI, "requestRender">, providerId: string, onComplete: (success: boolean, message?: string) => void, openUrl: (url: string) => void);
+    /** Focus reaches the live field: it draws the caret (the hardware cursor when the terminal's is on). */
+    get focused(): boolean;
+    set focused(value: boolean);
+    setUseTerminalCursor(useTerminalCursor: boolean): void;
     get signal(): AbortSignal;
     /**
      * Called by the OAuth `onAuth` callback. Renders the full authorization URL

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

@@ -4,7 +4,7 @@ import type { Component } from "../tui.js";
 import type { SgrMouseEvent } from "../mouse.js";
 import { type ConfiguredThinkingLevel } from "../thinking.js";
 import { type ThemeColor } from "../theme/theme.js";
-import type { TspPickerColumn, TspPickerGroup, TspPickerItem, TspPickerMark } from "@oh-my-pi/pi-wire";
+import type { TspPickerColumn, TspPickerGroup, TspPickerItem, TspPickerMark, TspPickerProps } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Canonical display ordering of built-in model roles. */
 export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "commit" | "tiny" | "memory" | "task" | "advisor" | "widget" | "image" | "web" | "speech" | "dictation" | "judge";
@@ -232,6 +232,8 @@ export interface ModelPickerCatalogue {
     readonly itemsAdd?: readonly TspPickerItem[];
     readonly itemsDel?: readonly string[];
 }
+/** The search, fact-column and row props every model `picker` sheet sends ({@link ModelBrowser.pickerRows}). */
+export type ModelPickerRows = Pick<TspPickerProps, "query" | "cursor" | "columns" | "items" | "itemsAdd" | "itemsDel" | "order" | "hits" | "selected" | "current" | "total">;
 /** How {@link ModelBrowser.pickerOrder} heads its rows. */
 export interface ModelPickerGrouping {
     /** One group per provider after the Recent block (the unfiltered All models view). */
@@ -329,6 +331,13 @@ export declare class ModelBrowser implements Component {
     get baseCount(): number;
     /** The selected row's selector, null when nothing selectable is selected. */
     get pickerSelected(): string | null;
+    /**
+     * A model picker's search field, fact columns and rows: `catalogue` (from
+     * {@link pickerItems}) in `view` order (from {@link pickerOrder}), the
+     * selection, and `current` checked. Memoize hosts on its inputs plus
+     * {@link query}, {@link cursor} and {@link pickerSelected}.
+     */
+    pickerRows(catalogue: ModelPickerCatalogue, view: ModelPickerOrder, current: string | undefined): ModelPickerRows;
     /**
      * Picker rows for `catalogue`: the same object while the catalogue, roles
      * and row inputs are unchanged, so typing and scope hops never resend it.

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

@@ -1,12 +1,30 @@
 import type { CredentialsApi, KeysApi } from "@oh-my-pi/pi-ai";
 import { type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { TspText } from "@oh-my-pi/pi-wire";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Credential presence and provenance needed by the provider picker. */
 export interface OAuthSelectorAuthSource {
     readonly credentials: Pick<CredentialsApi, "has">;
     readonly keys: Pick<KeysApi, "source">;
 }
+/**
+ * How a host other than `/login` presents the native provider sheet (the
+ * setup wizard): its heading, `role` and size, a status line docked above the
+ * action bar, and the Esc action that leaves in place of Close (the action's
+ * `id` cancels like Esc).
+ */
+export interface OAuthSelectorSheet {
+    readonly title: string;
+    readonly subtitle: TspText;
+    readonly role: string;
+    readonly size: "md" | "lg";
+    readonly status?: TspText;
+    readonly leave: {
+        readonly id: string;
+        readonly label: string;
+    };
+}
 /**
  * Component that renders an OAuth provider selector.
  */
@@ -16,8 +34,13 @@ export declare class OAuthSelectorComponent extends OverlayPanel {
         disabledProviders?: readonly string[];
         validateAuth?: (providerId: string) => Promise<boolean>;
         requestRender?: () => void;
+        sheet?: OAuthSelectorSheet;
     });
     stopValidation(): void;
+    /** Replace the native sheet's presentation (a new outcome line, a relabelled leave action). */
+    setSheet(sheet: OAuthSelectorSheet): void;
+    /** Re-read credential state after a sign-in stored one, keeping the query and selection. */
+    refreshAuth(): void;
     /**
      * Fit the selector into `lines` rendered rows by shrinking the visible list
      * window (the window is centered on the selection, so the selected row is

package/dist/types/overlays/plan-review-overlay.d.ts

@@ -74,6 +74,8 @@ export interface PlanReviewOverlayOptions {
     slider?: HookSelectorSlider;
     /** Display label for the external-editor key, surfaced in the footer help. */
     externalEditorLabel?: string;
+    /** The external editor's name ("Notepad", "nvim") for the native Edit button; `$EDITOR` when unset. */
+    externalEditorName?: string;
     /** Serializable annotations restored into this overlay instance. */
     annotationState?: PlanReviewAnnotationState;
 }

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

@@ -74,7 +74,7 @@ export declare class RewindSelectorComponent implements Component {
      * of branch columns, the current path first. The bar is this component's
      * own node, docked under the page, so the filter field keeps the caret.
      */
-    describeScreen(_cx: DescribeContext): NativeScreen;
+    describeScreen(cx: DescribeContext): NativeScreen;
     /** The bar docked under the page: position, key hints, Cancel and Rewind; the filter field while filtering. */
     describe(_cx: DescribeContext): NativeNode;
     /** The bar's buttons run their keys' paths; everything else belongs to the blocks. */

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

@@ -71,6 +71,8 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     onExit: () => void;
     onToggleScope?: () => void;
     onDeleteRequest?: (session: T) => void;
+    onRenameRequest?: (session: T) => void;
+    onPinRequest?: (session: T, pinned: boolean) => void;
     /** Re-render hook for async list updates (fuzzy scan completion, history merge). */
     onRequestRender?: () => void;
     constructor(sessions: T[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number, pinnedIds?: ReadonlySet<string>, currentSessionPath?: string | (() => string | undefined));
@@ -79,6 +81,8 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     /** Cancel pending async search work; idempotent, called on every picker exit path. */
     dispose(): void;
     removeSession(sessionPath: string): void;
+    /** Update a session's title in place and refresh the visible list, keeping the selection. */
+    renameSessionTitle(sessionPath: string, title: string): void;
     /** Resolve a list-local rendered-line index to a filtered-session index. */
     hitTestSession(line: number): number | undefined;
     /** Wheel notch: move the selection one step (clamped, no wrap). */
@@ -93,6 +97,14 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     resumeSelected(): void;
     /** Delete / Backspace on an empty query: ask the parent to confirm deleting the selected session. */
     requestDelete(): void;
+    /** F2: ask the parent to rename the selected session. */
+    requestRename(): void;
+    /** Pin keys: ask the parent to pin or unpin the selected session (default: flip it); no-op when already there. */
+    requestPin(pinned?: boolean): void;
+    /** Apply a persisted pin change; the list re-partitions and the cursor follows the session. */
+    setPinned(sessionId: string, pinned: boolean): void;
+    /** Whether the selected session is pinned (picks the pin action's direction). */
+    get selectedPinned(): boolean;
     /** Empty the search query (the empty state's "Clear search"). */
     clearSearch(): void;
     get selectedSession(): T | undefined;
@@ -120,6 +132,14 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
 }
 export interface SessionSelectorOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
     onDelete?: (session: T) => Promise<boolean>;
+    /**
+     * Rename the selected session to a user-supplied title; resolve with the
+     * title as stored (the session canonicalizes it) or null when the rename
+     * did not happen.
+     */
+    onRename?: (session: T, title: string) => Promise<string | null>;
+    /** Persist the selected session's pin state (pin keys / the picker's Pin action). */
+    onSetPinned?: (session: T, pinned: boolean) => Promise<void>;
     historyMatcher?: SessionHistoryMatcher;
     /** Loads sessions across all projects for the all-projects scope toggle (Tab). */
     loadAllSessions?: () => Promise<T[]>;
@@ -188,8 +208,8 @@ export declare class SessionSelectorComponent<T extends SessionSelectorEntry = S
     /**
      * With the `picker` kind: the data-first session picker (§4.7). Otherwise
      * scope `tabs`, loading/error message, then the search `input` and session
-     * `list` — or the delete-confirmation dialog in their place, as on the ANSI
-     * path — and the key-hint footer.
+     * `list` — or the delete-confirmation / rename dialog in their place, as on
+     * the ANSI path — and the key-hint footer.
      */
     describe(cx: DescribeContext): NativeNode;
     /** Picker events (root keypath); fallback: scope tab → toggle scope, click on a session → resume it, exactly like a mouse click. */

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

@@ -108,12 +108,19 @@ export interface ViewportClickRowTarget {
  * decides focusability and recency.
  */
 export declare function routeViewportClick(spans: readonly ViewportClickSpan[], index: number): string[];
+/** An extension link label drawn on a mutable-viewport line: what a click or hint tag lands on. */
+export interface ViewportLink {
+    readonly url: string;
+    /** Mutable-viewport line the label is drawn on. */
+    readonly row: number;
+    /** First cell of the label's part on that line. */
+    readonly start: number;
+}
 /**
- * Reserved click-candidate id for the pinned HUD expander row. Checked before
- * any registry lookup: its `@…:…` charset cannot collide with generated agent
- * ids (word names, numeric and `-N` suffixes, dotted nesting).
+ * Called once when link-hint mode ends; `reason` is `"crowded"` when a row held more links than
+ * their tags could fit side by side, so no tags were drawn.
  */
-export declare const PINNED_HUD_TOGGLE_ID = "@omp:toggle-pinned-hud";
+export type LinkHintsEnd = (reason?: "crowded") => void;
 /**
  * Canonical interactive composer, usable before session/settings exist and updatable in place.
  * It owns the terminal, welcome header, and editor; InteractiveMode later supplies authoritative
@@ -146,11 +153,35 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
      * are never in the viewport). Callers intersect with the live registry.
      */
     viewportClickCandidates(index: number): string[];
+    /**
+     * The extension-owned link label drawn at cell `col` of a mutable-viewport line, or `undefined`.
+     * Only links whose scheme an extension registered match; see `extensionLinkLabels`.
+     */
+    viewportLinkAt(index: number, col: number): ViewportLink | undefined;
     /**
      * Point the hover band at a click-candidate id (or clear it). Takes effect
      * on the next frame; callers repaint only when the target actually changes.
      */
     setHoveredClickId(id: string | undefined): void;
+    /** How many extension link labels the last frame drew; a label wrapped across rows counts once. */
+    viewportLinkCount(): number;
+    /**
+     * Enter keyboard link-hint mode: the next frame draws a tag over each extension link label it
+     * shows. `onEnd` runs once when the mode ends: a pick, a cancel, a key no tag starts with, a
+     * repaint that no longer draws the tagged labels where they were, or (`"crowded"`) a row with
+     * too many links for their tags to fit side by side.
+     */
+    startLinkHints(onEnd: LinkHintsEnd): void;
+    /** Whether link-hint mode is on. */
+    get linkHintsActive(): boolean;
+    /**
+     * Type one letter of a tag. Returns the link whose whole tag is now typed, `true` while the
+     * letters still lead to several tags, and `false` when none starts with them. The mode ends on
+     * a pick or a miss.
+     */
+    typeLinkHint(letter: string): ViewportLink | boolean;
+    /** Leave link-hint mode without picking a link. */
+    cancelLinkHints(): void;
     /** Acknowledges one accepted header, replay, or transcript batch. */
     acknowledgeHistory(id: number): void;
     /** Render the semantic transcript tail while the terminal borrows its resize buffer. */
@@ -183,6 +214,12 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;
     /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */
     setEditor(editor: CustomEditor): void;
+    /**
+     * End the startup input hold once the app's handlers are wired: the TSP
+     * terminal sends the typing it kept, and the keys the TUI held replay
+     * ({@link TUI.releaseHeldInput}). Idempotent.
+     */
+    releaseHeldInput(): void;
     /**
      * Mount the session-aware status component into the slot below the editor,
      * retiring the startup status line; the caller installs the real top-border

package/dist/types/prompt/interactive-context-helpers.d.ts

@@ -1,13 +1,16 @@
 /** Shared assistant transcript construction and model-authored link caching. */
 import type { AssistantMessage, Model } from "@oh-my-pi/pi-ai";
 import type { ImageBudget } from "../components/image.js";
-import type { AssistantThinkingRenderer } from "../chat/extension-types.js";
+import type { AssistantTextRenderer, AssistantThinkingRenderer } from "../chat/extension-types.js";
 import { AssistantMessageComponent } from "../chat/assistant-message.js";
+import { ReplyWriteComponent } from "../chat/reply-write.js";
 /** Session display capabilities supplied unchanged by the interactive host. */
 export interface AssistantMessageSession {
     readonly model?: Model;
     readonly extensionRunner?: {
         getAssistantThinkingRenderers(): readonly AssistantThinkingRenderer[];
+        /** Empty while the setting that enables them is off; hosts predating it may omit it. */
+        getAssistantTextRenderers?(): readonly AssistantTextRenderer[];
     };
 }
 /** Host state required to construct and refresh assistant transcript segments. */
@@ -42,6 +45,10 @@ export declare function assistantMessageLinkTargets(message: AssistantMessage, t
 /**
  * Construct an {@link AssistantMessageComponent} wired to the live context's
  * thinking/image settings. `message` is omitted for the streaming placeholder
- * component and supplied when rendering a persisted turn.
+ * component and supplied when rendering a persisted turn. `contentOffset` is
+ * the index in the full reply of the first block of a segment drawn after a
+ * tool call, so extension text renderers see the reply's own block indexes.
  */
-export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>): AssistantMessageComponent;
+export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>, contentOffset?: number): AssistantMessageComponent;
+/** Construct a {@link ReplyWriteComponent} (an `out://` write) drawn like the context's assistant prose. */
+export declare function createReplyWriteComponent(ctx: AssistantMessageHost): ReplyWriteComponent;

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

@@ -51,10 +51,14 @@ export declare class WelcomeComponent implements Component {
     setVersion(version: string): void;
     render(termWidth: number): readonly string[];
 }
+/**
+ * omp's native lockup (`omp.welcome.lockup`, keyed `lockup`): the terminal's
+ * builtin `omp` mark, which it draws on, beside the `omp` wordmark with
+ * `v<version>` under it. The welcome card and the setup splash show it.
+ */
+export declare function lockupNode(version: string): NativeNode;
 /** Block-grid brand mark shared by the welcome and setup surfaces. */
 export declare const PI_LOGO: string[];
-/** The block-grid brand mark as accent lines; `shimmer` declares the terminal-clocked shine sweep. */
-export declare function logoNode(lines: readonly string[], shimmer: boolean): NativeNode;
 export interface ShineConfig {
     /** Overall opacity of the shine overlay, in [0, 1]. */
     strength: number;

package/dist/types/render/extension-links.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Set the registered schemes (lowercase, without `:`). Bumps {@link extensionLinksVersion} on any
+ * change so cached markdown renders are redrawn.
+ */
+export declare function setExtensionLinks(next: Iterable<string>): void;
+/** Changes whenever the scheme set changes; part of the markdown render cache key. */
+export declare function extensionLinksVersion(): number;
+/**
+ * Whether activating a registered-scheme link (a click or a hint tag) reaches its extension: a
+ * scheme is registered and the terminal is plain.
+ */
+export declare function extensionLinksRouted(): boolean;
+/**
+ * Set by the interactive product: whether the user has a way to pick a link drawn now (a bound
+ * hint key, mouse clicks). `undefined` when nothing in this process can pick one.
+ */
+export declare function setExtensionLinkPicking(provider: (() => boolean) | undefined): void;
+/**
+ * Whether a registered-scheme link drawn now can be activated: links are routed and the product
+ * offers a way to pick them. Process-wide, so a UI-less extension runner (a subagent's, whose
+ * transcript the user may focus) answers like the interactive one.
+ */
+export declare function extensionLinkClicksAvailable(): boolean;
+/** The registered scheme `href` uses, or `undefined` for every other link. */
+export declare function extensionLinkScheme(href: string): string | undefined;
+/**
+ * Draw an extension link's label: dotted-underlined (plain underline where the terminal has no
+ * styled underlines, re-applied after any style reset inside it) and wrapped in the OSC 8 marker
+ * {@link extensionLinkLabels} reads back in a plain terminal; as given in Tern's native view. Never
+ * followed by a ` (url)` suffix. `key` tells apart links of one URL drawn near each other; it must
+ * not change between renders of the same text, or rows rendered twice stop matching.
+ */
+export declare function formatExtensionLink(label: string, href: string, key: string): string;
+/**
+ * Tags for `count` links in keyboard link-hint mode: single letters while they suffice, otherwise
+ * two letters each, so no tag is a prefix of another. At most the alphabet squared (676) are made;
+ * links past that stay untagged.
+ */
+export declare function linkHintTags(count: number): string[];
+/**
+ * `line` without omp's extension-link markers (the OSC 8 open and close around each label), for
+ * terminal output. Every other hyperlink is kept as is.
+ */
+export declare function stripExtensionLinkMarkers(line: string): string;
+/** One extension link label drawn on a rendered row (before {@link stripExtensionLinkMarkers}). */
+export interface ExtensionLinkLabel {
+    readonly url: string;
+    /**
+     * The marker's params, unique to each drawn link and repeated on every row a wrapped label
+     * spans, so a row's parts of one label can be told from an adjacent label of the same URL.
+     */
+    readonly id: string;
+    /** First 0-based cell the label covers. */
+    readonly start: number;
+    /** Cell just past the label. */
+    readonly end: number;
+    /** Whether only blank cells follow the label on its row, so a wrapped label may go on below. */
+    readonly endsRow: boolean;
+}
+/**
+ * The extension link labels drawn on a rendered row, left to right. Only omp's own markers with a
+ * registered scheme match, so ordinary hyperlinks (even of a registered scheme) and rows drawn for
+ * a scheme that is no longer registered never do.
+ */
+export declare function extensionLinkLabels(line: string): ExtensionLinkLabel[];

package/dist/types/render/hyperlink.d.ts

@@ -1,14 +1,31 @@
 import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type TerminalId } from "../terminal-capabilities.js";
+export interface FileLinkConfig {
+    scheme?: string;
+    host?: string;
+}
+interface FileUriOptions {
+    line?: number;
+    col?: number;
+    /** Native image open actions need a local file URL rather than a desktop handler. */
+    local?: boolean;
+}
+/**
+ * Resolve the remote file-link configuration once at host startup. Passing an
+ * explicit object lets SDK hosts and tests configure links without changing the
+ * process environment; an empty object restores ordinary file links. An invalid
+ * scheme or host logs a warning and keeps ordinary links.
+ */
+export declare function applyFileLinkSetting(config?: FileLinkConfig): void;
 /**
- * A `file:` URL for `filePath`, or `undefined` when Node cannot encode it.
+ * A file-link target for `filePath`, or `undefined` when Node cannot encode it.
  *
  * Node rejects a malformed UNC target (a UNC path escaped twice by its author,
  * e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
  * A stored session keeps whatever a tool call recorded, so a transcript must
  * render such a path without a link rather than throw while it rebuilds.
  */
-export declare function tryFileUri(filePath: string): string | undefined;
+export declare function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined;
 /**
  * Build the OSC 8 target for a file path on `terminalId`.
  *
@@ -23,7 +40,8 @@ export declare function tryFileUri(filePath: string): string | undefined;
  * The VS Code family instead navigates the documented
  * `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
  * URI is right, with the location left in the visible text — terminals that
- * parse a `path:line:col` suffix resolve that on their own.
+ * parse a `path:line:col` suffix resolve that on their own. A configured custom
+ * handler takes precedence and receives optional `line`/`col` query parameters.
  *
  * Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
  * target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
@@ -85,9 +103,8 @@ export declare function urlLinkSpan(target: string, displayText: string, s?: str
 /** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
 export declare function isNativeLinkEnabled(): boolean;
 /**
- * A native link span to a filesystem path as a plain `file://` URI (the
- * terminal opens it through the system; the location stays in the visible
- * text). Honours an explicit `off` policy.
+ * A native link span to a filesystem path using the configured file-link
+ * target. Honours an explicit `off` policy.
  */
 export declare function fileLinkSpan(filePath: string, displayText: string, s?: string): TspSpan;
 /**
@@ -101,9 +118,10 @@ export declare function fileLinkSpan(filePath: string, displayText: string, s?:
  *
  * @param filePath - Filesystem path
  * @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
- * @param opts - Optional line/col position appended as `?line=N&col=M` query params
+ * @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
  */
 export declare function fileHyperlink(filePath: string, displayText: string, opts?: {
     line?: number;
     col?: number;
 }): string;
+export {};

package/dist/types/render/index.d.ts

@@ -2,6 +2,7 @@
  * Public exports for shared TUI components.
  */
 export * from "./code-cell.js";
+export * from "./extension-links.js";
 export * from "./file-list.js";
 export * from "./hyperlink.js";
 export * from "./output-block.js";

package/dist/types/setup/scenes/model.d.ts

@@ -1,3 +1,3 @@
-import type { SetupScene } from "./types.js";
+import { type SetupScene } from "./types.js";
 /** Setup step that assigns one available model to the persisted default role. */
 export declare const modelSetupScene: SetupScene;

package/dist/types/setup/scenes/outro.d.ts

@@ -1,9 +1,10 @@
 import type { NativeNode } from "../../native/node.js";
 export declare const SETUP_OUTRO_MS = 1200;
 /**
- * Native outro: the shimmering mark, the saved confirmation, and an
- * indeterminate progress bar standing in for the timed sweep. A click sends
- * the `continue` action.
+ * Native outro, centered: the builtin `omp` mark, "You're all set", the
+ * default model now in effect (`model`, its display name, when there is
+ * one), and an indeterminate progress bar standing in for the timed sweep.
+ * A click sends the `continue` action.
  */
-export declare function describeSetupOutro(): NativeNode;
+export declare function describeSetupOutro(model: string | undefined): NativeNode;
 export declare function renderSetupOutro(width: number, height: number, elapsedMs: number): string[];