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

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/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/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

@@ -72,6 +72,7 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     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));
@@ -98,6 +99,12 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     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;
@@ -131,6 +138,8 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
      * 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[]>;

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[];

package/dist/types/setup/scenes/sign-in.d.ts

@@ -1,10 +1,15 @@
 import { type SgrMouseEvent } from "../../mouse.js";
-import type { NativeNode } from "../../native/node.js";
-import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
+import type { DescribeContext, NativeNode } from "../../native/node.js";
+import { type SetupScene, type SetupSceneController, type SetupSceneHost } from "./types.js";
 /**
  * "Sign in" scene: lets the user authenticate one or more model providers via
  * OAuth. It never auto-advances the wizard — the user may sign in to several
- * providers and then continue with Esc.
+ * providers and then leave the step with Esc.
+ *
+ * Picking is the provider selector (natively a setup sheet: Skip/Continue on
+ * Esc, Sign in on Enter); signing in is the app's {@link LoginDialogComponent},
+ * driven like `/login` drives it: natively its own sheet over the setup page,
+ * in the cell grid drawn in the wizard body in place of the selector.
  */
 export declare class SignInScene implements SetupSceneController {
     #private;
@@ -14,15 +19,15 @@ export declare class SignInScene implements SetupSceneController {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
+    /** Forward mouse to the provider selector; the login dialog takes keys only. */
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
     render(width: number, maxLines?: number): readonly string[];
     /**
-     * Picking: intro, the provider selector (describes itself) and the last
-     * outcome. Signing in: a spinner heading, the login link (with the full
-     * URL once, char-wrapped), any code prompt and the flow's progress lines.
+     * Signing in: the login dialog (its own sheet). Picking: the provider
+     * selector, which presents the setup sheet where the terminal draws
+     * pickers; elsewhere it is an inline card under the lead and the outcome.
      */
-    describe(): NativeNode;
+    describe(cx: DescribeContext): NativeNode;
 }
 /** Onboarding scene for provider sign-in. */
 export declare const providersSetupScene: SetupScene;

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

@@ -11,9 +11,9 @@ export declare function renderStarfield(width: number, height: number, frame: nu
  */
 export declare function renderSetupSplash(width: number, height: number, elapsedMs: number): string[];
 /**
- * Native splash: the 2x brand mark with a terminal-clocked shimmer, the
- * wordmark, and the skip hint pinned to the bottom. The water and starfield
- * are cell paintings with no semantic counterpart. A click on the splash
- * sends the `skip` action.
+ * Native splash: omp's lockup as the welcome draws it (the builtin mark
+ * drawing on beside the wordmark and version), centered, and a quiet Enter
+ * hint pinned to the bottom. The water and starfield are cell paintings with
+ * no semantic counterpart. A click anywhere sends `skip`.
  */
 export declare function describeSetupSplash(): NativeNode;

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

@@ -42,7 +42,6 @@ export interface SetupHost extends SetupUiHost {
     saveColorBlindMode(enabled: boolean): void;
     saveTheme(mode: "dark" | "light", name: string): void;
     captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
-    copyToClipboard(text: string): Promise<void>;
     openInBrowser(url: string): void;
     markComplete(version: number): Promise<void>;
     playWelcomeIntro(): void;
@@ -80,11 +79,27 @@ export interface SetupSceneController extends Component {
      */
     routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
+/**
+ * Role of the sheet (`picker` or `overlay`) an interactive scene presents in a
+ * TSP terminal. The terminal's setup stylesheet seats it under the wizard's
+ * brand and stepper instead of floating it over a dimmed page.
+ */
+export declare const SETUP_SHEET_ROLE = "omp.setup.sheet";
+/** Surface role of the setup page (wizard and startup splash) in a TSP terminal. */
+export declare const SETUP_SURFACE_ROLE = "omp.app.setup";
 /** Versioned onboarding scene definition. */
 export interface SetupScene {
     id: string;
     title: string;
+    /** Short label for the wizard's stepper (`Sign in`, `Model`). */
+    step: string;
     minVersion: number;
+    /**
+     * Configures something only the cell-grid renderer draws (glyphs, composer
+     * shape, theme). A TSP terminal draws those itself, so the wizard skips the
+     * scene while a native surface is live.
+     */
+    ansiOnly?: boolean;
     shouldRun?(ctx: SetupHost): boolean | Promise<boolean>;
     mount(host: SetupSceneHost): SetupSceneController;
 }

package/dist/types/setup/startup-splash.d.ts

@@ -1,4 +1,4 @@
-import type { SetupUiHost } from "./scenes/types.js";
+import { type SetupUiHost } from "./scenes/types.js";
 /** Timing controls for the standalone startup animation. */
 export interface RunStartupSplashOptions {
     readonly durationMs?: number;

package/dist/types/setup/wizard-overlay.d.ts

@@ -1,7 +1,9 @@
 import { type Component, type OverlayFocusOwner } from "../tui.js";
-import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeScreen, NativeUiEvent } from "../native/node.js";
 import type { SetupHost } from "./scenes/types.js";
-import type { SetupScene } from "./scenes/types.js";
+import { type SetupScene } from "./scenes/types.js";
+/** Whether `scene` is asked under the current renderer: a TSP surface draws `ansiOnly` settings itself. */
+export declare function setupSceneApplies(scene: SetupScene): boolean;
 /** Fullscreen onboarding presentation with scene focus and mouse routing. */
 export declare class SetupWizardComponent implements Component, OverlayFocusOwner {
     #private;
@@ -14,12 +16,14 @@ export declare class SetupWizardComponent implements Component, OverlayFocusOwne
     ownsOverlayFocusTarget(component: Component): boolean;
     handleInput(data: string): void;
     render(width: number): readonly string[];
+    /** The wizard is a page of its own: a screen surface styled by {@link SETUP_SURFACE_ROLE}. */
+    describeScreen(_cx: DescribeContext): NativeScreen;
     /**
-     * Fullscreen description: splash, the active scene inside the wizard
-     * frame (brand header, step counter, title, footer hints), or the outro.
-     * The splash→scene dissolve is a row effect with no native counterpart, so
-     * a transition describes as the scene.
+     * Fullscreen description: splash, the active scene under the setup
+     * header (brand, stepper, Exit setup), or the outro. The splash→scene
+     * dissolve is a row effect with no native counterpart, so a transition
+     * describes as the scene.
      */
-    describe(): NativeNode;
+    describe(cx: DescribeContext): NativeNode;
     handleNativeEvent(event: NativeUiEvent): void;
 }

package/dist/types/setup/wizard.d.ts

@@ -21,5 +21,9 @@ export interface RunSetupWizardOptions {
     markComplete?: boolean;
     playWelcomeIntro?: boolean;
 }
-/** Own the fullscreen setup overlay until its scenes and outro finish. */
+/**
+ * Own the fullscreen setup overlay until its scenes and outro finish. When
+ * none of `scenes` applies to the current renderer (a TSP surface skips
+ * `ansiOnly` ones) nothing is shown, but completion is still persisted.
+ */
 export declare function runSetupWizard(ctx: SetupHost, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;

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

@@ -111,7 +111,7 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     setRecording(recording: boolean): void;
     /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
     setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
-    /** Set the callback that presents the first pool-wide saved-reset expiry warning, or clear it with `undefined`. */
+    /** Set the callback that presents pool-wide saved-reset expiry warnings, or clear it with `undefined`. */
     setResetExpiryNoticeHandler(handler: ((notice: string) => void) | undefined): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;