@oh-my-pi/pi-tui 18.4.2 → 18.4.4

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

@@ -1,11 +1,26 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
-import { Editor, type EditorTextDecorationContext } from "../components/editor.js";
+import { Editor, type EditorTextDecorationContext, type NativeEditorLayout } from "../components/editor.js";
 import { type KeyId } from "../keys.js";
 import { SpaceHoldGesture } from "../space-hold.js";
-import { TUI } from "../tui.js";
+import { type Component, TUI } from "../tui.js";
 import type { AppKeybinding } from "../app-keybindings.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { ComposerFactsSource } from "../status-line/types.js";
 import { type MacOSSpellingFeatures } from "./macos-spelling.js";
+import type { TspEditorDecoration } from "@oh-my-pi/pi-wire";
 import { type WordCompletionMethod } from "./word-completion.js";
+/** Live composer state the TSP layout shows; the interactive host wires {@link CustomEditor.composerState}. */
+export interface ComposerNativeState {
+    /** The draft runs as a shell command (`!`, `!!`) or Python (`$`, `$$`); `excluded` keeps it from the model. */
+    readonly shell?: {
+        readonly kind: "bash" | "python";
+        readonly excluded: boolean;
+    };
+    /** Thinking effort word (`high`, `off`, `auto`); undefined when the model has no thinking. */
+    readonly thinking?: string;
+    /** A turn is running: the send keycap becomes a Stop button. */
+    readonly running: boolean;
+}
 /** Independently switchable prose-assistance features of the composer. */
 export interface SpellingFeatures extends MacOSSpellingFeatures {
     /** Word-completion engine; `off` disables ghost text. */
@@ -172,6 +187,14 @@ export declare class CustomEditor extends Editor {
      *  Queue shorthand reserves its first logical line as a dim `Queueing` label; sequential
      *  item markers use the accent color so separate follow-ups remain visible while composing. */
     decorateText: (text: string, context: EditorTextDecorationContext) => string;
+    /**
+     * TSP decorations: magic keywords shimmer (terminal-clocked) in the accent
+     * color, chips and markers take their token colors, misspellings are marked,
+     * and queue-composer markers are dimmed/accented, all as ranges over the raw
+     * buffer instead of painted text. A shell-mode draft is code: only its sigil
+     * is decorated, hidden behind the mode chip.
+     */
+    describeDecorations: (lines: readonly string[]) => readonly TspEditorDecoration[];
     /** Optional test override for the magic-keyword shimmer gate. */
     magicKeywordsEnabledOverride: boolean | undefined;
     /**
@@ -188,6 +211,29 @@ export declare class CustomEditor extends Editor {
      *  once after construction (and again after `setEditorComponent` swaps the
      *  editor). Passing `undefined` clears any pending frame. */
     setShimmerRepaintHandler(handler: (() => void) | undefined): void;
+    nativePlaceholder: string | undefined;
+    /** A shell-mode draft highlights as its language. */
+    describeLanguage: () => string | undefined;
+    /** Host-owned live state for the TSP composer (shell mode, effort chip, send/stop). */
+    composerState: () => ComposerNativeState;
+    /** The attachment band, described inside the composer on a TSP terminal (ANSI renders it above). */
+    attachmentChips: Component | undefined;
+    /** The status line's facts the TSP composer carries (context, model, usage, the other segments). */
+    composerFacts: ComposerFactsSource | undefined;
+    /**
+     * The TSP composer: role `omp.editor[.bash|.python]` (tone `pending` while
+     * a turn runs) over the context hairline, the attachment chips, a `line`
+     * row of the shell-mode chip and the input, and the `bar`: model chip,
+     * effort chip, the other status facts, usage, then send (Stop while a turn
+     * runs). Clicks come back as `status.model`, `thinking.cycle`, `submit`
+     * and `interrupt` actions.
+     */
+    describeLayout: (input: NativeNode, _cx: DescribeContext) => NativeEditorLayout;
+    /**
+     * Clicks on the composer's controls take the same paths as their keys: ⇧⇥,
+     * ⏎ and Esc; the status facts' clicks (`status.*`) go to their source.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     onEscape?: () => void;
     onClear?: () => void;
     onExit?: () => void;

package/dist/types/prompt/editor-top-gap.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../index.js";
+import type { NativeNode } from "../native/node.js";
 /** Set the process-wide editor gap layout. */
 export declare function setEditorGapComposerShape(shape: string): void;
 /**
@@ -15,4 +16,5 @@ export declare class EditorTopGap implements Component {
     /** @param statusRowOccupied Whether the status/working row directly above rendered lines this frame. */
     constructor(statusRowOccupied: () => boolean);
     render(_width: number): readonly string[];
+    describe(): NativeNode;
 }

package/dist/types/prompt/macos-spelling.d.ts

@@ -28,6 +28,12 @@ export declare class MacOSSpellingProvider implements EditorTextAssistProvider {
     setFeatures(features: MacOSSpellingFeatures): void;
     /** Add red undercurls to misspellings while preserving visible text width. */
     decorateTypos(text: string, context: SpellingDecorationContext, decorate?: (span: string) => string): string;
+    /**
+     * Misspelled prose ranges in `text` (offsets into it), in order and
+     * non-overlapping. Schedules the verification check for uncached text; its
+     * result arrives through {@link onUpdate}.
+     */
+    typoRanges(text: string, context: SpellingDecorationContext): readonly native.SpellingRange[];
     /** Return the confident macOS correction after a completed prose word. */
     tryAutocorrect(lines: string[], cursorLine: number, cursorCol: number): Promise<EditorInlineReplacement | null>;
     /** Return macOS replacement guesses for the misspelled word at the cursor. */

package/dist/types/prompt/magic-keywords.d.ts

@@ -44,6 +44,15 @@ export declare function containsMagicKeyword(text: string, word: string): boolea
  * to keep the static gradient.
  */
 export declare function highlightMagicKeywords(text: string, resetTo?: string, phase?: number): string;
+/**
+ * UTF-16 ranges of every registered keyword standing as prose in `text`
+ * (never inside code or XML/HTML sections), for decorating the keywords
+ * without painting them: a TSP terminal draws the gradient sweep itself.
+ */
+export declare function magicKeywordRanges(text: string): {
+    from: number;
+    to: number;
+}[];
 /**
  * Cheap test for "does this text contain any registered keyword as standalone
  * prose?". Short-circuits on a substring probe before paying for the

package/dist/types/prompt/queued-messages.d.ts

@@ -0,0 +1,23 @@
+import { Container } from "../tui.js";
+import type { KeyId } from "../keys.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
+/** Queued messages under one heading ("Steering", "After yield"). */
+export interface QueuedMessageGroup {
+    readonly label: string;
+    readonly messages: readonly string[];
+}
+/**
+ * Messages queued while the agent works, above the editor. ANSI: a heading
+ * per group, numbered dim rows and the dequeue hint. Natively (§8.1): a
+ * stack of pills, each `corner-down-right` · the text · `⌥↑ Edit`, the total
+ * count in the first pill when more than one waits; the edit control sends
+ * `queue.edit`, answered like the dequeue key.
+ */
+export declare class QueuedMessagesBand extends Container {
+    #private;
+    private readonly onEdit;
+    constructor(groups: readonly QueuedMessageGroup[], dequeueKey: KeyId, onEdit: () => void);
+    describe(): NativeNode;
+    /** The pills' Edit control: the dequeue key's path (queued messages back into the editor). */
+    handleNativeEvent(event: NativeUiEvent): void;
+}

package/dist/types/prompt/skill-tokens.d.ts

@@ -1,7 +1,9 @@
 /**
  * One `/skill:<name>` token delimited by whitespace or line edges. Group 1 is
- * the leading delimiter (empty at line start), group 2 the bare skill name.
- * Global so callers can walk every token; reset `lastIndex` before reuse.
+ * the leading delimiter (empty at line start), group 2 the skill name: a bare
+ * name or a collision-namespaced `<namespace>/<name>` (exactly one `/`; deeper
+ * paths never match). Global so callers can walk every token; reset
+ * `lastIndex` before reuse.
  */
 export declare const SKILL_TOKEN_RE: RegExp;
 /**

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

@@ -1,3 +1,4 @@
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import type { Component } from "../tui.js";
 /**
  * Fixed number of session rows in the welcome box so its height stays stable
@@ -17,6 +18,8 @@ export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?:
 export interface RecentSession {
     name: string;
     timeAgo: string;
+    /** Session file; a native click on the row resumes it. */
+    path?: string;
 }
 export interface LspServerInfo {
     name: string;
@@ -39,6 +42,17 @@ export declare class WelcomeComponent implements Component {
     lspServers?: LspServerInfo[] | null);
     get tip(): string | undefined;
     invalidate(): void;
+    /**
+     * A `card` (`omp.welcome`) titled with the app version. The brand column
+     * (`omp.welcome.brand`: greeting, the animated SVG mark, model, provider) sits
+     * beside the info column (`omp.welcome.info`: prompt-sigil keycaps, LSP
+     * servers, recent sessions); the tip of the session closes the card. Roles
+     * carry the look (gradient logo, type scale, column hairline); a "[NEW]" tip
+     * carries a terminal-clocked shimmering tag.
+     */
+    describe(_cx: DescribeContext): NativeNode;
+    /** A click on a recent session resumes it. */
+    handleNativeEvent(event: NativeUiEvent): void;
     /** The intro keeps the welcome block mutable; settling lets it retire to history. */
     isTranscriptBlockFinalized(): boolean;
     /**
@@ -64,6 +78,8 @@ export declare class WelcomeComponent implements Component {
 }
 /** 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/code-cell.d.ts

@@ -1,3 +1,4 @@
+import type { NativeNode } from "../native/node.js";
 import { type Theme } from "../theme/theme.js";
 /** Content and display limits for a code preview with optional output. */
 export interface CodeCellOptions {
@@ -32,6 +33,15 @@ export interface CodeCellOptions {
 }
 /** Render a syntax-highlighted code preview and its optional output block. */
 export declare function renderCodeCell(options: CodeCellOptions, theme: Theme): string[];
+/**
+ * The native form of {@link renderCodeCell}: a collapsible `card` holding a
+ * `code` node (numbered from `codeStartLine`, or the first explicit line
+ * number) and an `ansi` output section. The collapsed code clamp is the
+ * card preview; highlighting and gutters are the terminal's.
+ */
+export declare function describeCodeCell(options: Omit<CodeCellOptions, "width">, theme: Theme): NativeNode;
+/** The native form of {@link renderMarkdownCell}: a collapsible `card` holding `md` source and optional output. */
+export declare function describeMarkdownCell(options: Omit<MarkdownCellOptions, "width">, theme: Theme): NativeNode;
 /** Content and display limits for a Markdown preview with optional output. */
 export interface MarkdownCellOptions {
     content: string;

package/dist/types/render/file-list.d.ts

@@ -1,3 +1,4 @@
+import type { NativeNode } from "../native/node.js";
 import type { Theme } from "../theme/theme.js";
 /** A file-list item with optional display metadata. */
 export interface FileEntry {
@@ -18,5 +19,12 @@ export interface FileListOptions {
      * optionally wrap the path in an OSC 8 hyperlink. Only invoked when {@link FileEntry.absPath} is set. */
     hyperlinkFn?: (absPath: string, displayText: string) => string;
 }
+/**
+ * The native form of {@link renderFileList}: a `list` of path `item`s keyed
+ * by path, linked to their absolute path, with language/folder icons and the
+ * meta as detail. Collapsed, the list is clamped to `maxCollapsed` lines and
+ * the terminal scrolls the rest.
+ */
+export declare function describeFileList(options: Omit<FileListOptions, "hyperlinkFn">): NativeNode;
 /** Render file entries as a themed tree listing. */
 export declare function renderFileList(options: FileListOptions, theme: Theme): string[];

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

@@ -1,3 +1,4 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type TerminalId } from "../terminal-capabilities.js";
 /**
  * Build the OSC 8 target for a file path on `terminalId`.
@@ -62,6 +63,19 @@ export declare function urlHyperlink(url: string, displayText: string): string;
  * out by pushing the `"off"` policy.
  */
 export declare function urlHyperlinkAlways(url: string, displayText: string): string;
+/**
+ * A native link span to an HTTP(S) URL (`www.` inputs become `https://`).
+ * Unlike the OSC 8 wrappers this ignores terminal capability detection — a
+ * TSP terminal always handles `href` — but honours an explicit `off` policy.
+ * Non-HTTP(S) or unparsable URLs yield a plain span.
+ */
+export declare function urlLinkSpan(target: string, displayText: string, s?: string): TspSpan;
+/**
+ * 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.
+ */
+export declare function fileLinkSpan(filePath: string, displayText: string, s?: string): TspSpan;
 /**
  * Wrap `displayText` in an OSC 8 hyperlink pointing at a filesystem path.
  *

package/dist/types/render/output-block.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Bordered output container with optional header and sections.
+ */
+import type { TspCardStatus, TspPreview, TspText, TspTone } from "@oh-my-pi/pi-wire";
+import type { NativeChild, NativeNode } from "../native/node.js";
 import type { Theme, ThemeColor } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 import type { State } from "./types.js";
@@ -37,6 +42,44 @@ export declare function isFramedBlockComponent(component: Component): boolean;
 export declare function outputBlockContentWidth(width: number, contentPaddingLeft?: number, contentPaddingRight?: number): number;
 /** Render a bordered output block with optional header and sections. */
 export declare function renderOutputBlock(options: OutputBlockOptions, theme: Theme): string[];
+/** Card tone for an output state. */
+export declare function outputStateTone(state: State | undefined): TspTone;
+/** Card status chip for an output state. */
+export declare function outputStateStatus(state: State | undefined): TspCardStatus | undefined;
+/** One body section of a native output block. */
+export interface NativeOutputBlockSection {
+    /** Titled sub-section (the ANSI path's labelled separator bar). */
+    label?: TspText;
+    body: readonly NativeChild[];
+    /** Divide from the previous section with a rule. */
+    separator?: boolean;
+    /** Stable identity when sections come and go. */
+    key?: string;
+}
+/** Semantic inputs for {@link describeOutputBlock}. */
+export interface NativeOutputBlockOptions {
+    head?: TspText;
+    meta?: TspText;
+    state?: State;
+    /** Card role (`omp.tool.bash`, `omp.eval.cell`, …). Defaults to `omp.output`. */
+    role?: string;
+    /** Override the state-derived tone (the ANSI path's `borderColor`). */
+    tone?: TspTone;
+    sections?: readonly NativeOutputBlockSection[];
+    collapsible?: boolean;
+    collapsed?: boolean;
+    preview?: TspPreview;
+    /** Flat card without a ring (inline/plain variants). */
+    inset?: boolean;
+    key?: string;
+}
+/**
+ * The native form of {@link renderOutputBlock}: a `card` whose tone and
+ * status chip come from the state, head from the header plus meta, and body
+ * from the sections (labelled ones as `section`s, separators as `rule`s).
+ * Borders, background fills and wrapping are the terminal's.
+ */
+export declare function describeOutputBlock(options: NativeOutputBlockOptions): NativeNode;
 /**
  * Cached wrapper around `renderOutputBlock`.
  *

package/dist/types/render/output-pane.d.ts

@@ -1,3 +1,4 @@
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Theme } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 /** Which side of an output stream remains visible when the pane is capped. */
@@ -39,6 +40,20 @@ export declare function splitTerminalOutputLines(text: string): string[];
  * payload is retained so terminal image protocols remain valid.
  */
 export declare function formatOutputPaneLines(options: OutputPaneFormatOptions, theme: Theme): OutputPaneFormatResult;
+/** Display policy for {@link describeOutputLines}. */
+export interface NativeOutputOptions {
+    expanded: boolean;
+    collapsedMaxLines: number;
+    expandedMaxLines?: number;
+    edge?: OutputPaneEdge;
+    key?: string;
+}
+/**
+ * Raw output rows as a native `ansi` mini-terminal: the terminal wraps and
+ * styles them. The row cap becomes a `preview` clamp (with its own "N more"
+ * affordance); a tail edge follows the stream.
+ */
+export declare function describeOutputLines(lines: readonly string[], options: NativeOutputOptions): NativeNode;
 /** Mutable options for a live {@link OutputPane}. */
 export interface OutputPaneOptions extends Omit<OutputPaneFormatOptions, "lines"> {
     paddingX?: number;
@@ -73,6 +88,8 @@ export declare class OutputPane implements Component {
     get lineCount(): number;
     get hasSixel(): boolean;
     getText(): string;
+    /** The retained rows as an `ansi` node; streamed appends grow its text, so the reconciler sends `text append`. */
+    describe(_cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];
     invalidate(): void;
 }

package/dist/types/render/tool-card.d.ts

@@ -1,3 +1,4 @@
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Theme, ThemeColor } from "../theme/theme.js";
 import type { Component } from "../tui.js";
 import { type StatusLineOptions } from "./status-line.js";
@@ -58,6 +59,13 @@ export declare class ToolCard implements Component {
     #private;
     constructor(theme: Theme, options: ToolCardOptions, build: (context: ToolCardBuildContext) => ToolCardSnapshot);
     render(width: number): readonly string[];
+    /**
+     * A `card` (flat `inset` for plain cards) with the state's tone and status
+     * chip, head from the header/status line, and body slots: components as
+     * children, pre-rendered rows as unwrapped text, labelled sections as
+     * `section`s. The builder gets the surface width as its only width.
+     */
+    describe(cx: DescribeContext): NativeNode;
     get debugChildren(): readonly Component[];
     get wantsKeyRelease(): boolean;
     handleInput(data: string): void;

package/dist/types/render/tree-list.d.ts

@@ -1,6 +1,7 @@
 /**
  * Hierarchical tree list rendering helper.
  */
+import type { NativeNode } from "../native/node.js";
 import type { Theme } from "../theme/theme.js";
 import type { TreeContext } from "./types.js";
 /** Tree items and callbacks controlling their presentation. */
@@ -27,3 +28,10 @@ export interface TreeListOptions<T> {
 }
 /** Render tree items with themed branches and optional expansion. */
 export declare function renderTreeList<T>(options: TreeListOptions<T>, theme: Theme): string[];
+/**
+ * The native form of {@link renderTreeList}: a flat `tree` whose branch
+ * gutters are the terminal's. The collapsed item cap (and the caller's
+ * trailing summary) are kept as a muted "… N more" node; the visual line
+ * budget (`maxCollapsedLines`) is layout and is left to the terminal.
+ */
+export declare function describeTreeList<T>(options: TreeListOptions<T>, theme: Theme): NativeNode;

package/dist/types/render/width-aware-text.d.ts

@@ -1,3 +1,4 @@
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
 /**
  * Text whose content is (re)formatted against the actual render width.
@@ -25,5 +26,11 @@ export declare class WidthAwareText implements Component {
      * reformat that yields the same string skips re-wrapping and re-tinting.
      */
     reformat(): void;
+    /**
+     * The inner `Text` as the only child, fed the formatter's output. The
+     * formatter is width-bound by contract, so it runs once per surface width
+     * (the only width a describer knows) and again on `reformat()`.
+     */
+    describe(cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];
 }

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

@@ -1,2 +1,9 @@
+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.
+ */
+export declare function describeSetupOutro(): NativeNode;
 export declare function renderSetupOutro(width: number, height: number, elapsedMs: number): string[];

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

@@ -1,21 +1,28 @@
 import { type SgrMouseEvent } from "../../mouse.js";
-import type { SetupSceneHost, SetupTab } from "./types.js";
+import type { NativeNode } from "../../native/node.js";
+import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
 /**
- * "Sign in" panel: lets the user authenticate one or more model providers via
- * OAuth. Unlike a standalone scene it never auto-advances the wizard — the user
- * may sign in to several providers and then continue with Esc.
+ * "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.
  */
-export declare class SignInTab implements SetupTab {
+export declare class SignInScene implements SetupSceneController {
     #private;
-    readonly id = "sign-in";
-    readonly label = "Sign in";
+    readonly title = "Sign in to your providers";
+    get subtitle(): string;
     constructor(host: SetupSceneHost);
-    /** Modal while an OAuth flow is running so the scene won't switch tabs or finish. */
-    get modal(): boolean;
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
     /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
     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.
+     */
+    describe(): NativeNode;
 }
+/** Onboarding scene for provider sign-in. */
+export declare const providersSetupScene: SetupScene;

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

@@ -1,3 +1,4 @@
+import type { NativeNode } from "../../native/node.js";
 export declare const SETUP_SPLASH_MS = 2600;
 export declare const SETUP_TICK_MS = 33;
 export declare function renderStarfield(width: number, height: number, frame: number): string[];
@@ -9,3 +10,10 @@ export declare function renderStarfield(width: number, height: number, frame: nu
  * whole scene; the water surface drifts each frame.
  */
 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.
+ */
+export declare function describeSetupSplash(): NativeNode;

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

@@ -4,9 +4,13 @@ import type { SgrMouseEvent } from "../../mouse.js";
 import type { ComposerPreviewStatusSource } from "../../overlays/composer-shape-preview.js";
 import type { ComposerShape } from "../../overlays/composer-shape-registry.js";
 import type { ModelBrowserSource } from "../../overlays/model-browser.js";
-import type { SymbolPreset } from "../../theme/theme.js";
-import type { SearchProviderId } from "../../tools/web-search.js";
+import type { SymbolPreset, ThemeColor } from "../../theme/theme.js";
 import type { Component, TUI } from "../../tui.js";
+/** One line of status copy kept as raw text plus its theme colour, never as pre-styled ANSI. */
+export interface StyledLine {
+    readonly text: string;
+    readonly color: ThemeColor;
+}
 /** Terminal capabilities used by setup overlays and the startup splash. */
 export interface SetupUiHost {
     readonly ui: Pick<TUI, "showOverlay" | "setFocus" | "requestRender" | "invalidate"> & {
@@ -21,7 +25,6 @@ export interface SetupHost extends SetupUiHost {
     readonly composerShape: ComposerShape;
     readonly symbolPreset: SymbolPreset;
     readonly colorBlindMode: boolean;
-    readonly webSearchOrder: readonly string[];
     readonly disabledProviders: readonly string[];
     readonly authStorage: AuthStorage;
     readonly modelSource: ModelBrowserSource;
@@ -37,8 +40,6 @@ export interface SetupHost extends SetupUiHost {
     saveSymbolPreset(preset: SymbolPreset): void;
     saveColorBlindMode(enabled: boolean): void;
     saveTheme(mode: "dark" | "light", name: string): void;
-    isSearchProviderAvailable(id: SearchProviderId): Promise<boolean>;
-    saveSearchProvider(id: SearchProviderId | "auto"): void;
     captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
     copyToClipboard(text: string): Promise<void>;
     openInBrowser(url: string): void;
@@ -78,28 +79,6 @@ export interface SetupSceneController extends Component {
      */
     routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
-/**
- * A single panel inside a tabbed setup scene. The host scene owns the tab bar
- * and forwards rendering/input to the active tab.
- */
-export interface SetupTab {
-    readonly id: string;
-    readonly label: string;
-    /**
-     * While `true` the tab owns all keyboard input (e.g. an in-progress OAuth
-     * login). The parent scene MUST NOT switch tabs or finish while modal.
-     */
-    readonly modal: boolean;
-    /** See {@link SetupSceneController.render}: `maxLines` is the tab-local row budget. */
-    render(width: number, maxLines?: number): readonly string[];
-    handleInput(data: string): void;
-    invalidate(): void;
-    /** Called when the tab becomes active (including initial mount). */
-    onActivate?(): void;
-    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
-    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
-    dispose(): void;
-}
 /** Versioned onboarding scene definition. */
 export interface SetupScene {
     id: string;

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

@@ -1,4 +1,5 @@
 import { type Component, type OverlayFocusOwner } from "../tui.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
 import type { SetupHost } from "./scenes/types.js";
 import type { SetupScene } from "./scenes/types.js";
 /** Fullscreen onboarding presentation with scene focus and mouse routing. */
@@ -13,4 +14,12 @@ export declare class SetupWizardComponent implements Component, OverlayFocusOwne
     ownsOverlayFocusTarget(component: Component): boolean;
     handleInput(data: string): void;
     render(width: number): readonly string[];
+    /**
+     * 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.
+     */
+    describe(): NativeNode;
+    handleNativeEvent(event: NativeUiEvent): void;
 }

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

@@ -3,8 +3,21 @@ import type { StatusLineHost, StatusLineSession } from "./host.js";
 import type { Editor } from "../components/editor.js";
 import { type CodexResetFireworksEvent } from "../overlays/codex-reset-fireworks.js";
 import { type SegmentContext } from "./segments.js";
-import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types.js";
-export declare class StatusLineComponent<TSession extends StatusLineSession = StatusLineSession> implements Component {
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { CollabStatus, ComposerFacts, ComposerFactsSource, EffectiveStatusLineSettings, StatusLineSettings } from "./types.js";
+/** What a click on a native status segment asks omp to open. */
+export type StatusLineNativeAction = "status.model" | "status.context" | "status.git" | "status.cost" | "status.path";
+/** Pull request the native tab title carries. */
+export interface StatusLinePullRequest {
+    readonly number: number;
+    readonly url: string;
+}
+/**
+ * Drop priority of a configured segment: the outer edges matter most, so the
+ * leftmost left segment and the rightmost right segment stay longest.
+ */
+export declare function statusSegmentPriority(side: "left" | "right", index: number, count: number): number;
+export declare class StatusLineComponent<TSession extends StatusLineSession = StatusLineSession> implements Component, ComposerFactsSource {
     #private;
     private session;
     private readonly host;
@@ -25,6 +38,12 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     setSubagentHubHint(_hint: string | undefined): void;
     /** Active subagent count as currently displayed (collab state mirroring). */
     get subagentCount(): number;
+    /**
+     * Running background jobs outside the subagent badge. Task jobs count only
+     * until their AgentRegistry ref appears; once it is running, the subagent
+     * badge represents that same agent. Bash and eval jobs always count.
+     */
+    runningBackgroundJobCount(): number;
     /**
      * Reset the currently-attached session's active-time accumulators so
      * the `time_spent` segment starts from zero. Called from `/clear`,
@@ -141,10 +160,13 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     };
     /**
      * Wire this bar into `editor` for a composer layout: the matching top-border
-     * provider, the autocomplete probe, and the standalone bottom-bar placement.
-     * Callers re-run it whenever the composer shape changes.
+     * provider, the autocomplete probe, the standalone bottom-bar placement, and
+     * the native composer's facts. Callers re-run it whenever the composer shape
+     * changes.
      */
-    attachToEditor(editor: Pick<Editor, "isAutocompleteActive" | "setTopBorderProvider" | "setTopBorder">, style: Pick<ComposerStyle, "statusAttachment" | "bottomBar" | "bottomBarGap">): void;
+    attachToEditor(editor: Pick<Editor, "isAutocompleteActive" | "setTopBorderProvider" | "setTopBorder"> & {
+        composerFacts: ComposerFactsSource | undefined;
+    }, style: Pick<ComposerStyle, "statusAttachment" | "bottomBar" | "bottomBarGap">): void;
     getTopBorder(width: number, previewTitle?: string): {
         content: string;
         width: number;
@@ -189,5 +211,27 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
      * render.
      */
     getPreviewLines(width: number, style?: Pick<ComposerStyle, "statusAttachment" | "bottomBar">): string[];
+    /**
+     * The composer's facts on a TSP terminal, which draws no status strip: the
+     * context hairline, the model chip label, the usage text, and every other
+     * configured segment as a `seg` in configured order with its drop priority.
+     * Returns the same object while nothing changed.
+     */
+    describeComposerFacts(): ComposerFacts;
+    /**
+     * Native status bar for the /settings appearance preview: a `status` of
+     * `seg`s in configured order, each with its side and a drop priority from
+     * that order, plus hook-status rows.
+     */
+    describePreview(): NativeNode;
+    /**
+     * Called with the branch's pull request (undefined when there is none) each
+     * time it changes while the composer facts are described; the native tab
+     * title carries it. Looked up only when the `pr` segment is configured.
+     */
+    onNativePullRequest: ((pr: StatusLinePullRequest | undefined) => void) | undefined;
+    /** The host's handler for clicks on native segments ({@link NATIVE_SEGMENT_ACTIONS}). */
+    onNativeAction: ((action: StatusLineNativeAction) => void) | undefined;
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }