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

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

@@ -0,0 +1,124 @@
+/**
+ * Builders for the data-first `picker` kind (Stencil repo,
+ * `crates/tern/NATIVE_REDESIGN.md` §4): the model hub, session selector,
+ * rewind, tree, copy, history search and the small selectors send their data
+ * and Tern draws the sheet (head, scopes, tabs, fact columns, rows, preview,
+ * action bar).
+ *
+ * A picker is its own sheet: the component returns `nativeSheet(cx)` true
+ * (usually `cx.supports("picker")`) so the backend puts it directly in
+ * `layer`, and `describe()` returns {@link picker}. When the terminal lacks
+ * the kind, components keep describing their generic composition.
+ *
+ * Keys stay the program's: a search field is an {@link Input} (every editor
+ * text binding works), sent through {@link pickerQuery} with its caret.
+ * Pointer events arrive as `select`/`activate` with
+ * 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 { 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;
+/**
+ * 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
+ * too, or motion keys (word jumps, line start) never reach the screen.
+ */
+export declare function pickerQuery(input: Input | null): Pick<TspPickerProps, "query" | "cursor">;
+/** Key of the picker child a dock/editor-mounted selector describes; its events arrive at this keypath. */
+export declare const PICKER_KEY = "picker";
+/**
+ * The root a selector mounted in the editor slot describes: a column holding
+ * 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;
+/** 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. */
+export declare function bindingKeys(binding: Keybinding): string[];
+/** An action-bar button; `keys` is a key id (`"alt+enter"`), a keybinding's keycaps, or none. */
+export declare function pickerAction(id: string, label: string, keys?: KeyName | string | readonly string[], opts?: Omit<TspPickerAction, "id" | "label" | "keys">): TspPickerAction;
+/** The right-aligned `Close esc` every picker ends with; Tern's backdrop and head `esc` send it too. */
+export declare const CLOSE_ACTION: TspPickerAction;
+/** A `time` fact: the compact age of `at` (`now`, `5m`, `2h`, `3d`, `2w`, `6mo`, `1y`). */
+export declare function pickerAge(at: Date | number, now?: number): string;
+/**
+ * Search `hits` for a label: disjoint, ordered UTF-16 ranges of every
+ * case-insensitive occurrence of any of the (lowercase) `tokens`.
+ */
+export declare function pickerHits(label: string, tokens: readonly string[]): [number, number][];
+/** The absolute local time behind a `time` fact, for its tooltip (`28 Sep 2026, 18:02`). */
+export declare function pickerDate(at: Date | number): string;
+/** A picker pointer event, folded: which item, or which action with its value. */
+export type PickerEvent = {
+    readonly kind: "select" | "activate";
+    readonly item: string;
+} | {
+    readonly kind: "action";
+    readonly act: string;
+    readonly value: string | undefined;
+};
+/**
+ * The picker event `event` carries, or undefined when it is not for the
+ * picker at keypath `key`: `""` for a root picker, else the picker child's
+ * key (a hoisted child's keypath carries a `^` marker, ignored here).
+ */
+export declare function pickerEvent(event: NativeUiEvent, key?: string): PickerEvent | undefined;
+/**
+ * {@link pickerHits} for fuzzy-filtered lists: each whitespace token of
+ * `query` marks its first case-insensitive substring, else its characters as
+ * a greedy in-order subsequence (the fuzzy matcher's shape). Undefined when
+ * nothing matches.
+ */
+export declare function pickerFuzzyHits(label: string, query: string): [number, number][] | undefined;
+/** The `md` sheet a short {@link SelectList} selector becomes (thinking level, hook options, queue mode, …). */
+export interface SelectPickerOptions {
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly icon?: string;
+    readonly noun?: string;
+    /** Show omp's filter text as the search field (lists that filter as you type). */
+    readonly searchable?: boolean;
+    /** Per-item extras (a thinking-level dot, a swatch mark, a budget fact). */
+    readonly decorate?: (item: SelectItem) => Partial<Omit<TspPickerItem, "id">> | undefined;
+    readonly columns?: TspPickerProps["columns"];
+    /** Values in use now (the current theme, the current level). */
+    readonly current?: readonly string[];
+    /** The primary action's label (`Apply`, `Select`). */
+    readonly confirm?: string;
+}
+/**
+ * Picker props for a {@link SelectList}: its filtered items in order, the
+ * selection, the pending-confirmation strip, and `Select ⏎` / `Close esc`.
+ * Memoize on {@link SelectList.pickerView}'s parts: the builder allocates.
+ */
+export declare function selectListPicker(list: SelectList, o: SelectPickerOptions): TspPickerProps;
+/**
+ * Routes a picker event to a {@link SelectList}: a row click selects (and
+ * previews, through `onSelectionChange`), a second click or `confirm`
+ * activates, `close`/`cancel` cancels. Returns whether it handled the event.
+ */
+export declare function routeSelectListPicker(list: SelectList, event: NativeUiEvent, key?: string): boolean;
+/**
+ * A {@link SelectList} described as a picker, memoized: the node is rebuilt
+ * only when the list's filtered items, selection, pending confirmation or
+ * query change (or {@link invalidate} is called after `options` inputs move).
+ */
+export declare class SelectListSheet {
+    #private;
+    readonly list: SelectList;
+    constructor(list: SelectList, options: SelectPickerOptions | (() => SelectPickerOptions), { docked }?: {
+        docked?: boolean;
+    });
+    /** Drop the memo (decorations or options changed outside the list). */
+    invalidate(): void;
+    describe(): NativeNode;
+    /** Route a picker event onto the list; see {@link routeSelectListPicker}. */
+    handle(event: NativeUiEvent): boolean;
+}

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

@@ -0,0 +1,41 @@
+import { type TspOp } from "@oh-my-pi/pi-wire";
+import { type Component } from "../tui.js";
+import type { DescribeContext, NativeChild } from "./node.js";
+/** The regions a frame fills. */
+export interface NativeRegions {
+    readonly main: readonly NativeChild[];
+    readonly dock: readonly NativeChild[];
+    readonly layer: readonly NativeChild[];
+}
+/** Where a wire id came from, for event routing. */
+export interface NativeTarget {
+    readonly component: Component;
+    /** Keypath inside the component ("" for its root node). */
+    readonly keypath: string;
+}
+/** Stable base-36 wire id of a component instance (its root node's id). */
+export declare function nativeComponentId(component: Component): string;
+/** One surface's reconciler. */
+export declare class Reconciler {
+    #private;
+    readonly surface: string;
+    constructor(surface: string);
+    /** `rows` fallback nodes in the last reconciled frame. */
+    get fallbackCount(): number;
+    /** Diff the regions against the previous frame; the first call adds everything. */
+    reconcile(regions: NativeRegions, cx: DescribeContext): TspOp[];
+    /**
+     * The surface was closed (`keep:true`) and is being adopted: the terminal
+     * dropped `dock`, `layer` and focus but kept `main`. The next frame re-adds
+     * the live regions from scratch and keeps diffing `main`.
+     */
+    detachLive(): void;
+    /** The component and keypath that described wire node `id`. */
+    target(id: string): NativeTarget | null;
+    /** The key a list item node was described with (its key, else its child index). */
+    itemKey(id: string): string;
+    /** Wire id of the first `editor`/`input` `component` describes (for `focus`), or null. */
+    focusTarget(component: Component): string | null;
+    /** Stop referencing ids the terminal dropped (`gone`). */
+    forget(ids: readonly string[]): void;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Settling: the frame provider marks finalized transcript blocks so the
+ * native reconciler stops keeping their description (spec §12 "Settling and
+ * program memory"). A settled block stays editable: a later change is sent as
+ * targeted ops by id, followed by a fresh `settle` hint.
+ */
+import type { Component } from "../tui.js";
+/** Mark `component` (and everything it describes) as finalized. Idempotent; a no-op outside a TSP terminal. */
+export declare function settleNative(component: Component): void;
+/** Whether {@link settleNative} was called for `component`. */
+export declare function isNativeSettled(component: Component): boolean;

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

@@ -0,0 +1,21 @@
+import type { TspSpan, TspText } from "@oh-my-pi/pi-wire";
+import { type ThemeBg } from "../theme/theme.js";
+import type { NativeNode } from "./node.js";
+/**
+ * Convert ANSI-styled text into escape-free spans. SGR colours map back to
+ * the omp theme tokens that produced them; OSC 8 becomes `href`; every other
+ * escape (cursor moves, APC markers) is dropped.
+ */
+export declare function styledSpans(styled: string): TspSpan[];
+/** The visible characters of ANSI-styled text: every escape dropped, sanitized like {@link styledSpans}. */
+export declare function plainText(styled: string): string;
+/** {@link plainText} as a single-line label: line breaks and whitespace runs collapse to one space. */
+export declare function plainLine(styled: string): string;
+/** Spans for plain text passed through an optional ANSI styler. */
+export declare function styleSpans(content: string, style?: (text: string) => string): TspSpan[];
+/** Collapse unstyled single-span text to a plain string (smaller frames). */
+export declare function compactText(spans: readonly TspSpan[]): TspText;
+/** Pre-rendered ANSI rows as one unwrapped text block (rows already carry their line breaks). */
+export declare function rowsText(lines: readonly string[]): NativeNode;
+/** Theme background token of the first SGR background in ANSI-styled text. */
+export declare function styledBackground(styled: string): ThemeBg | undefined;

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

@@ -0,0 +1,6 @@
+/** Whether a TSP surface is live in this process. */
+export declare function isNativeRendering(): boolean;
+/** Called by the native backend on surface open and close. */
+export declare function setNativeRendering(on: boolean): void;
+/** Call `listener` whenever native rendering starts or stops; returns the unsubscribe. */
+export declare function onNativeRenderingChange(listener: (on: boolean) => void): () => void;

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

@@ -0,0 +1,24 @@
+/**
+ * omp theme colours → TSP tones. Components that only hold ANSI stylers
+ * (`(text) => string`) sample them with a probe string to recover the theme
+ * token behind the escape, then map the token to a card/text tone.
+ */
+import type { TspTone } from "@oh-my-pi/pi-wire";
+import { type ThemeBg, type ThemeColor } from "../theme/theme.js";
+/** Theme background token of an ANSI background styler, sampled with a probe string. */
+export declare function sampleBackground(bgFn: ((text: string) => string) | undefined): ThemeBg | undefined;
+/** Theme foreground token of an ANSI colour styler, sampled with a probe string. */
+export declare function sampleForeground(color: ((text: string) => string) | undefined): ThemeColor | undefined;
+/** Card chrome derived from a background fill. */
+export interface BackgroundChrome {
+    tone?: TspTone;
+    role?: string;
+    selected?: boolean;
+}
+/** Map an omp background token to card tone/role. */
+export declare function backgroundChrome(bg: ThemeBg | undefined): BackgroundChrome;
+/**
+ * Tone of an omp colour used as a severity or border colour; undefined for
+ * colours that carry no tone (callers pick their own fallback).
+ */
+export declare function colorTone(color: ThemeColor | undefined): TspTone | undefined;

package/dist/types/overlays/advisor-config.d.ts

@@ -19,6 +19,7 @@ import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import { type Model, type UsageLimit, type UsageReport } from "@oh-my-pi/pi-ai";
 import { type Component, type TUI } from "../index.js";
 import { type ModelBrowserSource } from "./model-browser.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** One advisor declared in `WATCHDOG.yml`; its instructions specialize the shared baseline. */
 export interface AdvisorConfig {
     name: string;
@@ -108,6 +109,25 @@ export declare class AdvisorConfigOverlayComponent implements Component {
     #private;
     constructor(tui: TUI, deps: AdvisorConfigDeps, scope: AdvisorConfigScope, doc: WatchdogConfigDoc, callbacks: AdvisorConfigCallbacks);
     render(width: number): readonly string[];
+    /** Docks as a side sheet beside the transcript, like `/settings`, when the terminal draws `prefs` with `aside`. */
+    nativeSheet(cx: DescribeContext): boolean;
+    /**
+     * The native settings page (`prefs`) when the terminal draws it: a page per
+     * advisor plus the shared instructions, the advisor's fields as typed rows,
+     * the file actions, and the model/tools/instructions editors over the page.
+     * Otherwise the root card `omp.overlay.advisor`: on the roster screen a
+     * sidebar (the active `SelectList`) beside the highlighted entry's preview;
+     * every other screen shows its editor component alone. Key hints close the
+     * card.
+     */
+    describe(cx: DescribeContext): NativeNode;
+    /**
+     * Native page events, each through the roster/detail selections the keys
+     * make: a page opens that advisor (or the shared instructions), a field
+     * change or button runs the field's detail action, and closing an editor
+     * or the page cancels like Esc.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     handleInput(data: string): void;
     /** Forward enhanced-paste transports into a multiline instructions editor. */
     pasteText(text: string): void;

package/dist/types/overlays/agent-hub-renderer.d.ts

@@ -1,5 +1,6 @@
+import type { TspSpan, TspTone } from "@oh-my-pi/pi-wire";
 import type { ThemeColor } from "../theme/theme.js";
-import { type AgentRecordLike } from "./agent-hub-types.js";
+import { type AgentRecordLike, type AgentStatus } from "./agent-hub-types.js";
 import type { ObservableSession } from "./session-observer-registry.js";
 import type { AgentMetrics } from "./agent-hub-projection.js";
 export interface RosterRender {
@@ -13,6 +14,14 @@ export declare function sanitizeLine(text: string, maxWidth?: number): string;
 export declare function clampHubLine(line: string, width: number): string;
 /** Status glyph, colored per theme status conventions. The title-line counts spell out the words. */
 export declare function statusGlyph(status: AgentRecordLike["status"]): string;
+/** Native tone for a roster status. */
+export declare function statusTone(status: AgentStatus): TspTone;
+/** Picker row dot for a roster status. */
+export declare function statusDot(status: AgentStatus): TspTone;
+/** One-line task summary: the subagent prompt's fixed assignment preamble is not part of the task. */
+export declare function taskSummary(task: string): string;
+/** Native span of {@link statusGlyph}. */
+export declare function statusGlyphSpan(status: AgentStatus): TspSpan;
 export declare function statusText(status: AgentRecordLike["status"], text: string): string;
 /** Host-resolved model-role label and color. */
 export interface AgentRoleDisplay {
@@ -22,20 +31,27 @@ export interface AgentRoleDisplay {
 }
 /** Textual model-role tag; color reinforces (but never replaces) the label. */
 export declare function formatRoleBadge(role: string, info: AgentRoleDisplay): string;
-/**
- * Resolved model + reasoning level for a hub row. Exact executor progress is
- * authoritative (and survives completion); direct live sessions are the
- * fallback for agents without an observer snapshot — the main session has no
- * snapshot at all, so its row is read straight off the live session.
- *
- * Every source reports the model that produced the row's work, never the one
- * the session merely points at: an armed fallback that has not served yet stays
- * attributed to whichever model last actually spoke.
- */
+/** Native span of {@link formatRoleBadge}. */
+export declare function roleBadgeSpan(role: string, info: AgentRoleDisplay): TspSpan;
 export declare function modelBadge(ref: AgentRecordLike, observed: ObservableSession | undefined): string | undefined;
+/** A picker chip for the model that produced a row's work: label plus thinking-level colour token. */
+export interface ModelChip {
+    text: string;
+    /** Thinking level shown next to the model (`low`), when the model reasons. */
+    level?: string;
+    /** Theme token of {@link level}. */
+    dot?: string;
+    fallback: boolean;
+}
+/** Structured {@link modelBadge} for picker chips. */
+export declare function modelChip(ref: AgentRecordLike, observed: ObservableSession | undefined): ModelChip | undefined;
+/** Native spans of {@link modelBadge}. */
+export declare function modelBadgeSpans(ref: AgentRecordLike, observed: ObservableSession | undefined): TspSpan[] | undefined;
 export declare function formatMetricDuration(metrics: AgentMetrics): string | undefined;
 export declare function formatCost(cost: number): string;
 export declare function formatMetrics(metrics: AgentMetrics): string;
+/** Plain-text {@link formatMetrics} for native spans. */
+export declare function metricsText(metrics: AgentMetrics): string;
 /** Row-grid variant of {@link formatMetrics}: fixed-width cells so every agent's metadata
  * line shares one column layout instead of flowing after wrapped text. Cost is left-aligned
  * so the line starts flush; the numeric cells are right-aligned so units line up. */

package/dist/types/overlays/agent-hub.d.ts

@@ -24,6 +24,7 @@ import { type AgentRecordLike, type AgentHubRegistry } from "./agent-hub-types.j
 import type { SessionObserverRegistry } from "./session-observer-registry.js";
 import { type AgentTranscriptSource } from "./agent-transcript-viewer.js";
 import type { AgentRoleDisplay } from "./agent-hub-renderer.js";
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 export type AgentHubSection = "agents" | "activity";
 /** Result of one host-backed transcript read for the Agent Hub viewer. */
 export interface AgentHubRemoteTranscript {
@@ -119,6 +120,15 @@ export declare class AgentHubOverlayComponent<TRecord extends AgentRecordLike =
      * restored when the viewer closes. No-op without a real TUI (render-only test stub).
      */
     openChat(id: string, entryId?: string): void;
+    /** A `picker` is its own sheet: the backend mounts it in `layer` without an `overlay` wrapper. */
+    nativeSheet(cx: DescribeContext): boolean;
+    describe(cx: DescribeContext): NativeNode;
+    /**
+     * Pointer actions on the described hub. `select` mirrors keyboard selection
+     * (roster row, activity row, section tab, projection tab); `activate` does
+     * what Enter does on that row. Picker actions run the key handlers' paths.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     handleWheel(delta: -1 | 1): void;
     hitTest(line: number): number | undefined;
     setHoverIndex(index: number | null): void;

package/dist/types/overlays/agent-transcript-viewer.d.ts

@@ -23,6 +23,7 @@ import type { AgentHubRegistry } from "./agent-hub-types.js";
 import type { SessionMessageEntryLike } from "../chat/transcript-entry.js";
 import type { SessionObserverRegistry } from "./session-observer-registry.js";
 import type { AgentHubRemote } from "./agent-hub.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 /** Parsed message and model metadata relevant to a transcript viewer. */
 export type AgentTranscriptEntry = SessionMessageEntryLike | {
     type: "model_change";
@@ -68,4 +69,10 @@ export declare class AgentTranscriptViewer implements Component {
     dispose(): void;
     handleInput(data: string): void;
     render(width: number): readonly string[];
+    /**
+     * Header, transcript body (the builder's container, which describes its own
+     * blocks), notice, message editor, stats and key hints. Scrolling is the
+     * terminal's, so the j/k/g/G scroll hints are omitted.
+     */
+    describe(_cx: DescribeContext): NativeNode;
 }

package/dist/types/overlays/agents-hub.d.ts

@@ -11,6 +11,7 @@
  */
 import type { Model } from "@oh-my-pi/pi-ai";
 import { type Component, type TUI } from "../index.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import type { AgentSource } from "../tools/task.js";
 import { type ModelBrowserSource } from "./model-browser.js";
 /** One agent with its per-agent settings overrides resolved for display. */
@@ -71,5 +72,12 @@ export declare class AgentsHubComponent implements Component {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
+    /**
+     * The agent list (and its chip strips) is a `picker` sheet. The pattern
+     * input, the model browser and the create wizard stay the generic overlay.
+     */
+    nativeSheet(cx: DescribeContext): boolean;
+    describe(cx: DescribeContext): NativeNode;
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }

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

@@ -2,6 +2,7 @@ import { type Component, 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 NativeNode, type NativeUiEvent } from "../native/node.js";
 export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
 export declare const PASTE_CODE_REVIEW_ACTION = "Paste annotations into prompt";
 export interface AnnotationOverlayCallbacks {
@@ -26,5 +27,7 @@ export declare class AnnotationOverlay implements Component {
     getAnnotations(): CodeReviewAnnotation[];
     getTextAnnotations(): TextReviewAnnotation[];
     handleInput(data: string): void;
+    describe(): NativeNode;
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }

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

@@ -1,3 +1,4 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { type Component, type TUI } from "../index.js";
 /** One selectable answer in an ask dialog. */
 export interface ExtensionAskDialogOption {
@@ -14,6 +15,11 @@ export interface ExtensionAskDialogQuestion {
     multi?: boolean;
     recommended?: number;
 }
+/** Prompt text and the images pasted into it (custom answers and notes). */
+export interface AskDialogPromptValue {
+    text: string;
+    images?: ImageContent[];
+}
 /** Submitted answer to one dialog question. */
 export interface ExtensionAskDialogResultItem {
     id: string;
@@ -22,7 +28,9 @@ export interface ExtensionAskDialogResultItem {
     multi: boolean;
     selectedOptions: string[];
     customInput?: string;
+    customInputImages?: ImageContent[];
     note?: string;
+    noteImages?: ImageContent[];
     timedOut?: boolean;
 }
 /** Answers submitted from the dialog. */
@@ -36,6 +44,7 @@ export interface ExtensionAskDialogChatResult {
 }
 /** Completed dialog action, distinct from cancellation. */
 export type ExtensionAskDialogResult = ExtensionAskDialogSubmitResult | ExtensionAskDialogChatResult;
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 /** Bound a prompt editor title to a fixed row/width budget so long or
  *  multi-line questions stay usable inside the small prompt overlay. */
 export declare function boundPromptTitle(prefix: string, question: string): string;
@@ -43,6 +52,8 @@ interface AskDialogCallbacks {
     onSubmit(result: ExtensionAskDialogSubmitResult): void;
     onCancel(): void;
     onPrompt(title: string, prefill?: string): Promise<string | undefined>;
+    /** Prompt that accepts pasted images; without it, prompts use `onPrompt`. */
+    onImagePrompt?(title: string, prefill: AskDialogPromptValue | undefined): Promise<AskDialogPromptValue | undefined>;
 }
 interface AskDialogInputGuard {
     isBlocked(): boolean;
@@ -84,5 +95,17 @@ export declare class AskDialogComponent implements Component {
     toggleQuestionExpansion(): boolean;
     handleInput(keyData: string): void;
     render(width: number): readonly string[];
+    /**
+     * A bottom-anchored glass sheet over the composer (the `overlay` hoists into
+     * the terminal's layer; the dialog's own slot in the dock stays empty).
+     */
+    describe(cx: DescribeContext): NativeNode;
+    /**
+     * Pointer actions: a tab click switches to it; a click on an answer row is
+     * Enter on it (Space for a multi-select option, so it toggles; its
+     * double-click `activate` is Enter); the action bar's Submit, Note and Skip
+     * run exactly what Enter, `n` and Esc run on the highlighted row.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
 }
 export {};

package/dist/types/overlays/bordered-loader.d.ts

@@ -1,11 +1,14 @@
 import { Container, type TUI } from "../index.js";
 import type { Theme } from "../theme/theme.js";
+import type { NativeNode } from "../native/node.js";
 /** Loader wrapped with borders for hook UI */
 export declare class BorderedLoader extends Container {
     #private;
     constructor(tui: TUI, theme: Theme, message: string);
     get signal(): AbortSignal;
     set onAbort(fn: (() => void) | undefined);
+    invalidate(): void;
+    describe(): NativeNode;
     handleInput(data: string): void;
     dispose(): void;
 }

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

@@ -1,6 +1,7 @@
 import { type Component, type Focusable, Input } from "../index.js";
 import { type BtwHistoryRecord } from "./btw-history.js";
 import type { SpaceHoldHandler } from "../space-hold.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
 interface BtwHistoryPanelOptions {
     records: readonly BtwHistoryRecord[];
     onClose: () => void;
@@ -27,6 +28,14 @@ export declare class BtwHistoryPanel implements Component, Focusable {
     /** Enhanced clipboard pastes belong only to the active composer. */
     pasteText(text: string): void;
     handleInput(data: string): void;
+    /** A large glass sheet titled "BTW history". */
+    readonly nativeOverlay: {
+        readonly role: "omp.overlay.btwHistory";
+        readonly size: "lg";
+        readonly head: "BTW history";
+    };
+    describe(): NativeNode;
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }
 export {};

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

@@ -1,5 +1,6 @@
 import { type TUI } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { NativeNode } from "../native/node.js";
 interface BtwPanelComponentOptions {
     question: string;
     tui: TUI;
@@ -22,5 +23,7 @@ export declare class BtwPanelComponent extends OverlayPanel {
     isCopyable(): boolean;
     getCopyText(): string | undefined;
     close(): void;
+    invalidate(): void;
+    describe(): NativeNode;
 }
 export {};

package/dist/types/overlays/cleanse-panel.d.ts

@@ -2,6 +2,7 @@
 import { type TUI } from "../index.js";
 import type { AgentProgress } from "../tools/task.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { CleanseBoardModel, CleanseCheckerDescriptor, CleanseCheckResult, CleanseAssignment, CleanseAgentOutcome } from "../apps/cleanse-board.js";
 export type CleansePanelRunStatus = "clean" | "unresolved" | "unsupported" | "cancelled";
 interface CleansePanelComponentOptions {
@@ -14,9 +15,9 @@ export declare class CleansePanelComponent extends OverlayPanel {
     #private;
     readonly interactive = true;
     constructor(options: CleansePanelComponentOptions);
-    log(text: string): void;
+    log(line: string): void;
     /** Permanent line styled as a failure (the core's stderr-equivalent). */
-    logError(text: string): void;
+    logError(line: string): void;
     phase(text: string | undefined): void;
     checkerStarted(checker: CleanseCheckerDescriptor): void;
     checkerFinished(check: CleanseCheckResult, durationMs: number): void;
@@ -32,5 +33,7 @@ export declare class CleansePanelComponent extends OverlayPanel {
     markError(message: string): void;
     /** Release the repaint timer during teardown. */
     dispose(): void;
+    invalidate(): void;
+    describe(cx: DescribeContext): NativeNode;
 }
 export {};

package/dist/types/overlays/composer-shape-preview.d.ts

@@ -8,7 +8,8 @@
  * (passed via `previewTitle`) when the session is unnamed.
  */
 import { type Component } from "../index.js";
-import type { ComposerShape } from "./composer-shape-registry.js";
+import { type ComposerShape } from "./composer-shape-registry.js";
+import type { NativeNode } from "../native/node.js";
 /**
  * Real status renderer the preview borrows rows from — structurally satisfied
  * by {@link StatusLineComponent}. Layout is parameterized so a preview can
@@ -43,5 +44,10 @@ export declare class ComposerShapePreview implements Component {
     #private;
     constructor(initialValue?: ComposerShape, options?: ComposerShapePreviewOptions);
     setValue(shape: ComposerShape): void;
+    /**
+     * A TSP terminal draws the composer itself, so the shape's glyph chrome has
+     * no native twin: the preview names the shape over a read-only prompt.
+     */
+    describe(): NativeNode;
     render(width: number): readonly string[];
 }

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

@@ -15,9 +15,36 @@
  * mouse selection nor cmd-click.
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
+import type { TspPickerColumn, TspPickerItem, TspText } from "@oh-my-pi/pi-wire";
 import { type Component, type TUI } from "../index.js";
 import type { MessageRenderer } from "../chat/extension-types.js";
 import { type TranscriptEntryLike as TranscriptEntry } from "../chat/transcript-entry.js";
+import { type OutlineTarget } from "../chat/transcript-outline.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+/** Key of the leading list item that replays the history older than the startup tail. */
+export declare const EARLIER_TURNS_KEY = "earlier";
+/** Leading item of a truncated transcript list; selecting it loads the older turns. */
+export declare const earlierTurnsItem: NativeNode;
+/**
+ * One list item per outline target, keyed by the turn's opening entry id:
+ * the plain turn summary as label, `detail` (or the entry time) on the right.
+ */
+export declare function turnItem(target: OutlineTarget, detail?: TspText): NativeNode;
+/** Preview of a turn's text: prose as markdown, command/tool output as a plain code block. */
+export declare function turnPreview(target: OutlineTarget, content: string): NativeNode;
+/** The timeline pickers' one fact column: a user turn's clock time. */
+export declare const TIMELINE_COLUMNS: readonly TspPickerColumn[];
+/**
+ * The `timeline` picker item of one outline target (rewind, copy), keyed by
+ * the turn's opening entry id: user turns carry their `HH:MM`, pure tool turns
+ * the tool's role and a `name target` label.
+ */
+export declare function timelineItem(target: OutlineTarget): TspPickerItem;
+/** Timeline picker items for `targets`, reused while `targets` is the same array. */
+export declare class TimelineItems {
+    #private;
+    of(targets: readonly OutlineTarget[]): TspPickerItem[];
+}
 export interface CopySelectorDeps {
     ui: TUI;
     getTool?: (name: string) => AgentTool | undefined;
@@ -72,5 +99,16 @@ export declare class CopySelectorComponent implements Component {
     invalidate(): void;
     dispose(): void;
     handleInput(data: string): void;
+    /** A `picker` is its own sheet: the backend mounts it in `layer` without a wrapper. */
+    nativeSheet(cx: DescribeContext): boolean;
+    handleNativeEvent(event: NativeUiEvent): void;
+    describe(cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];
 }
+/** Inner blocks of one turn: markdown code/quotes, commands, and tool output. */
+export declare function collectBlocks(entries: readonly TranscriptEntry[]): CopyBlock[];
+/** Clipboard payload for a whole turn, falling back to its blocks when the turn has no prose. */
+export declare function targetCopy(target: OutlineTarget, blocks: readonly CopyBlock[]): {
+    content: string;
+    label: string;
+};