@oh-my-pi/pi-tui 18.4.12 → 18.5.1

package/CHANGELOG.md

@@ -2,6 +2,66 @@
 
 ## [Unreleased]
 
+## [18.5.1] - 2026-10-03
+
+### Added
+
+- Added native terminal support for submitting explicit composer prompts atomically, preserving displaced drafts and attachments for local recall.
+- Added progress percentages to subagent entries in the agent tree, task, and wait views.
+- Added a `Rebuilding…` indicator for lengthy tmux resize redraws without flashing it for quick updates.
+- Added `writeTerminalSequence()` for sending supported terminal escape sequences through the active terminal output stream, with stdout fallback when no terminal is active.
+
+### Changed
+
+- Clipboard payloads are now represented by their length in `PI_TUI_WRITE_LOG` rather than by their contents.
+
+### Fixed
+
+- Fixed pending clipboard-image attachments being bypassed when subsequent input or native prompts were submitted before loading completed.
+- Improved narrow `/models` layouts by retaining the scope sidebar while simplifying and truncating model rows as needed.
+- Fixed Markdown rendering with themes that do not define their own symbol set; the active theme's symbols are now used as a fallback.
+- Fixed model role assignment showing models that are unavailable for the selected provider.
+- Improved tmux resize, zoom, and rebuild behavior, including smoother coalesced redraws, reduced visual artifacts and extra output, correct transcript restoration after rapid size changes, and preservation of history when panes are resized.
+- Fixed multiline paste on Windows inserting escape-code fragments instead of line breaks, and prevented bracketed-paste markers from appearing in the composer.
+- Fixed terminal notifications occasionally corrupting the screen with stray escape-code fragments during streaming output.
+- Added rendering and notification compatibility for Monstar terminals, including Kitty graphics, hyperlinks, synchronized output, styled underlines, progress keepalives, and Monstar-focused desktop notifications.
+- Fixed Agent Hub transcripts crashing when assistant messages do not include usage or cost data.
+- Fixed idle terminal activity notifications while preserving bracketed-paste recovery during input and rendering.
+- Fixed diff blocks in ask questions losing their layout; additions and removals now retain separate diff highlighting.
+- Fixed duplicate ASCII Plan, Prewalk, and Goal labels in the status line.
+- Improved Markdown rendering for long and streamed messages, including display math, fenced code, reference links, lists, whitespace, emphasis, and line breaks, so completed content no longer shows raw markup, misplaced blank lines, or broken block layout.
+
+## [18.5.0] - 2026-10-03
+
+### Breaking Changes
+
+- `WelcomeComponent` no longer takes a model or provider: its constructor is `(version)`, and `setModel()`, `setRecentSessions()`, `setLspServers()`, `handleNativeEvent()`, `RecentSession`, `LspServerInfo`, `WELCOME_SESSION_SLOTS` and `WELCOME_LSP_SLOTS` are gone; `ComposerWelcomeUpdate` drops `modelName`/`providerName`/`recentSessions`/`lspServers`, and `ComposerCache` drops `writeWelcome()`, `writeRecentSessions()`, `writeLspServers()`, `ComposerWelcomeCache` and the `welcome`/`recentSessions`/`lspServers` fields of `ComposerStartupCache`.
+- `renderWelcomeTip()` returns its lines without an indent, `Tip:` and the body wrapped together, for the caller to place.
+
+### Added
+
+- Added `ReportPanel`, a read-only command report: a `/btw`-style titled box with an Esc hint in text mode (above the editor, or as a full-screen page whose body scrolls on the arrow/page/Home/End keys and the wheel), and natively a `/usage`-style sheet whose body the terminal scrolls once it is long, with a Close button ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `contextUsageHead()`, the `/context` title naming the model and its window ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `Composer.rowsBelow()`, the rows the chrome under a below-transcript root took in the last frame ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `Composer.pinInputToBottom()`, which keeps the input on the bottom row after chrome above the editor closes when rows it displaced went to scrollback ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added a repeatable native `reveal` (`{ at, n }`): a described node scrolls into view again whenever its `n` changes, without being re-added.
+
+### Changed
+
+- `ContextUsageView` is now a bare report body without its own title, rules or card; `setBreakdown()` was removed ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- The terminal welcome banner is the gradient logo beside the `omp` wordmark with the version under it and the tip, centered in the terminal; the logo stands alone when the lockup does not fit, and the tip drops below 50 columns. It no longer greets with "Welcome back!", natively either.
+
+### Fixed
+
+- Fixed tool previews on Windows showing a working directory on another drive as a raw absolute path instead of its home-shortened `~/…` form.
+- Fixed pasted drive-less `file:///…` URLs (forwarded from a macOS pasteboard or remote session) staying undecoded on Windows instead of loading as image paths.
+- Fixed an output artifact whose file cannot be opened (e.g. a directory in the way) being reported on Windows as a write failure and retried later, instead of a terminal open failure.
+- Fixed plan review's Contents in Tern: clicking an entry, or moving through them with the arrow keys, now scrolls the plan to that section.
+
+### Removed
+
+- Removed `JobsPanel`, the `/jobs` transcript block; `/jobs` now opens `JobsSheet` natively ([#14138](https://github.com/can1357/oh-my-pi/pull/14138) by [@H4vC](https://github.com/H4vC)).
+
 ## [18.4.12] - 2026-10-02
 
 ### Changed
@@ -2957,14 +3017,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 - Crash in `visibleWidth()` and grapheme iteration when encountering undefined code points ([#372](https://github.com/badlogic/pi-mono/pull/372) by [@HACKE-RC](https://github.com/HACKE-RC))
 - ZWJ emoji sequences (rainbow flag, family, etc.) now render with correct width instead of being split into multiple characters ([#369](https://github.com/badlogic/pi-mono/pull/369) by [@nathyong](https://github.com/nathyong))
 
-## [0.29.0] - 2025-12-25
-
-### Added
-
-- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) and the cursor is after a word character, a space is automatically prepended for better readability. Useful when dragging screenshots from macOS. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))
-- **Word navigation for Input component**: Added Ctrl+Left/Right and Alt+Left/Right support for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-- **Full Unicode input**: Input component now accepts Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-
-### Fixed
-
-- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
+Older entries are archived in [packages/tui/CHANGELOG.md@bac7e83b5b0e](https://github.com/can1357/oh-my-pi/blob/bac7e83b5b0eb86c909c17830a6666efc359578b/packages/tui/CHANGELOG.md).

package/dist/types/active-terminal.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ownership of stdout by a started {@link ProcessTerminal}, kept in a leaf
+ * module so writers that `terminal.ts` itself imports (terminal capabilities,
+ * notifications) can route through the active terminal without an import cycle.
+ */
+import type { ProcessTerminal } from "./terminal.js";
+/** The started terminal that owns stdout in this thread, if any. */
+export declare function getActiveTerminal(): ProcessTerminal | null;
+/** Record the terminal that owns stdout (`ProcessTerminal.start`), or release it with `null` (`stop`). */
+export declare function setActiveTerminal(terminal: ProcessTerminal | null): void;
+/** Observe stdout errors through the shared listener. Returns the unregister callback. */
+export declare function registerStdoutErrorHandler(handler: (err: Error) => void): () => void;
+/**
+ * Hand `data` to the active terminal's ordered output path. Returns false when
+ * no terminal in this thread has started. On the main thread that means the
+ * caller owns stdout; a worker thread never sees the main thread's terminal, so
+ * there `false` is not permission to write. Prefer {@link writeTerminalSequence}.
+ */
+export declare function writeThroughActiveTerminal(data: string): boolean;
+/**
+ * Write an out-of-band escape sequence (window title, OSC 52 clipboard,
+ * notification). While a TUI owns stdout, its frames go through an off-thread
+ * pump in chunks that ignore escape boundaries; a direct `process.stdout.write`
+ * can land between two chunks and split a frame's escape sequence, and the host
+ * terminal then prints its tail as text. So the sequence takes the active
+ * terminal's ordered output path, and goes straight to stdout, best-effort, only
+ * when no terminal owns it. A worker thread cannot reach the main thread's
+ * terminal and would write around its pump, so it writes nothing.
+ */
+export declare function writeTerminalSequence(data: string): void;

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

@@ -1,8 +1,10 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
-/** @internal exported for tests — the grown-line-start block-kind gate. */
+/** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
+/** @internal exported for tests — the windowed lexer's first-probe window size. */
+export declare const LEX_WINDOW_BYTES: number;
 /** A hyperlink as the renderer sees it: inline `[text](href)`, `<autolink>`, bare GFM URL, or reference link. */
 export interface MarkdownLink {
     /** Flattened visible label with whitespace collapsed to one row; falls back to `href` when empty. */
@@ -82,7 +84,12 @@ export interface MarkdownTheme {
      * Return null to fall back to fenced code rendering.
      */
     resolveMermaidAscii?: (source: string, maxWidth?: number) => string | null;
-    symbols: SymbolTheme;
+    /**
+     * Glyphs for quote borders, rules, tables and color swatches. Optional so themes
+     * built to the upstream pi-tui `MarkdownTheme` shape (which has no `symbols`)
+     * still render; omitted symbols fall back to the active theme's set.
+     */
+    symbols?: SymbolTheme;
 }
 export declare class Markdown implements Component {
     #private;
@@ -101,8 +108,10 @@ export declare class Markdown implements Component {
     describe(_cx: DescribeContext): NativeNode;
     /**
      * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary. Only meaningful while streaming (transient
-     * render cache on); grows monotonically under append-only `setText`.
+     * Markdown block boundary that no append can move: it stops in front of a
+     * display-math opener whose block an append could still close. Only
+     * meaningful while streaming (transient render cache on); grows
+     * monotonically under append-only `setText`.
      */
     getLastRenderStableText(): string;
     get transientRenderCache(): boolean;

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

@@ -29,6 +29,7 @@ export declare function encodeTspJson(verb: TspVerb, value: unknown, params?: Ts
  * tells the terminal that omp applies its `edit` events (TSP §8.5), so it may keep a
  * native selection in omp's editors; without it, every key stays omp's. `"undo"`
  * says omp applies `undo` events, so the terminal may turn ⌃Z in a field into one.
+ * `"send"` accepts an explicit prompt for a live composer without simulating keys.
  */
 export declare function encodeTspHelloQuery(version?: string): string;
 /** One decoded APC message: verb, parameters and raw body. */

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

@@ -28,10 +28,12 @@ export type NativeNode = {
          */
         readonly key?: string;
         /**
-         * Scroll the node into view, placed like the `reveal` op, when it is
-         * added. Key a node by what it points at to reveal it again on a move.
+         * Scroll the node into view, placed like the `reveal` op. A placement
+         * reveals it when it is added: key a node by what it points at to
+         * reveal it again on a move. A {@link NativeReveal} reveals it whenever
+         * its `n` differs from the previous description of the same node.
          */
-        readonly reveal?: "start" | "end" | "nearest";
+        readonly reveal?: NativeRevealAt | NativeReveal;
         /**
          * Keyboard scrolling forwarded to the terminal (PgUp/PgDn/End reach the
          * program): moves the scroller at or above the node by `by` whenever
@@ -42,6 +44,17 @@ export type NativeNode = {
         readonly scroll?: NativeScroll;
     };
 }[TspKind];
+/** Where a revealed node lands in its scroller. */
+export type NativeRevealAt = "start" | "end" | "nearest";
+/**
+ * A repeatable {@link NativeNode.reveal}: bump `n` to bring an existing node
+ * into view again (a Contents entry jumping to its section). A freshly added
+ * node is not revealed.
+ */
+export interface NativeReveal {
+    readonly at: NativeRevealAt;
+    readonly n: number;
+}
 /** A {@link NativeNode.scroll} request. */
 export interface NativeScroll {
     readonly by: TspScrollBy;
@@ -122,6 +135,12 @@ export type NativeUiEvent = {
  | {
     readonly type: "undo";
     readonly key: string;
+}
+/** Submit an explicit prompt through the composer's normal path, preserving the previous draft for recall. */
+ | {
+    readonly type: "send";
+    readonly key: string;
+    readonly text: string;
 };
 /**
  * A primitive edit the terminal made over its own text selection (cut,

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

@@ -61,7 +61,10 @@ export declare class HubFrame {
     constructor(title: string, sidebarBounds: {
         min: number;
         max: number;
-    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[]);
+    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[], options?: {
+        bodyMinWidth?: number;
+        preserveSidebar?: boolean;
+    });
     /** Invalidate the composed layout. */
     invalidate(): void;
     /** Measure labels and annotations within this hub's sidebar width bounds. */

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

@@ -1,4 +1,4 @@
-import { type Component, Container } from "../tui.js";
+import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
@@ -40,12 +40,6 @@ export interface JobsSheetSource {
     /** Dismiss the sheet. */
     close(): void;
 }
-/** The `/jobs` block: `ansi` renders in the terminal, the snapshot describes the native frame. */
-export declare class JobsPanel extends Container {
-    #private;
-    constructor(snapshot: JobsPanelSnapshot, nowMs: number, ansi: readonly Component[]);
-    describe(cx: DescribeContext): NativeNode;
-}
 /**
  * The jobs pill's sheet: a centred `lg` glass sheet titled Background jobs.
  * A selectable list of every job (running first) sits over the selected

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

@@ -0,0 +1,68 @@
+import type { TspText } from "@oh-my-pi/pi-wire";
+import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { Component } from "../tui.js";
+/** Options of a {@link ReportPanel}. */
+export interface ReportPanelOptions {
+    /** Plain title: the text-mode border title, and the native sheet head unless {@link head} is given. */
+    readonly title: string;
+    /** Styled native sheet head. */
+    readonly head?: TspText;
+    /** The read-only report; it draws no frame or title of its own. */
+    readonly body: Component;
+    /**
+     * Display form of the key that dismisses the report while it sits above the
+     * editor (the editor's interrupt key, which routes to it). Once the panel
+     * holds focus ({@link ReportPanel.holdFocus}) the hint shows the key its own
+     * input closes on instead.
+     */
+    readonly closeKey: string;
+    /** The focused panel (native sheet, text-mode full-screen page) closes on Esc / its Close button: this runs. */
+    readonly onClose: () => void;
+    /**
+     * Most rows the text-mode panel may take, borders included (the screen rows
+     * left above the editor); a taller report scrolls inside it. `undefined`
+     * leaves it uncapped.
+     */
+    readonly maxRows?: () => number | undefined;
+}
+/**
+ * A read-only command report (`/changelog`, `/context`, `/tools`, …).
+ *
+ * Text mode draws a titled box with the body and an Esc hint: above the editor
+ * like the `/btw` panel while it fits there (the editor keeps focus and its
+ * Esc takes it away), or as a full-screen page on the alternate screen when it
+ * is taller, whose body scrolls on the arrow/page/Home/End keys and the wheel.
+ * Natively it is a sheet like `/usage`: a centred `lg` glass sheet titled by
+ * the report whose body the terminal scrolls (wheel, and the same keys
+ * forwarded as scroll requests), then a Close button; Esc closes it.
+ */
+export declare class ReportPanel extends OverlayPanel {
+    #private;
+    readonly nativeOverlay: NonNullable<Component["nativeOverlay"]>;
+    constructor(options: ReportPanelOptions);
+    /**
+     * The panel is shown with focus (native sheet, text-mode full-screen page):
+     * its own {@link handleInput} closes it, so the hint names that key.
+     */
+    holdFocus(): void;
+    /**
+     * Text mode: cap the box to {@link ReportPanelOptions.maxRows}, scrolling a
+     * taller body. The cap is a hard limit: when a resize leaves fewer rows than
+     * the box's chrome needs, its bottom (the hint and closing border) is cut
+     * rather than spilling over the editor.
+     */
+    render(width: number): readonly string[];
+    /** Text mode: rows the whole box takes at `width` when nothing caps it. */
+    heightAt(width: number): number;
+    /** The sheet body (the overlay is the frame, and its body the scroller): the report, then Close (Esc). */
+    describe(): NativeNode;
+    invalidate(): void;
+    /**
+     * Focused (the native sheet, or the text-mode full-screen page): Esc closes;
+     * the arrow, page, Home and End keys and the wheel scroll the body.
+     */
+    handleInput(data: string): void;
+    /** Close runs what Esc runs. */
+    handleNativeEvent(event: NativeUiEvent): void;
+}

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

@@ -1,4 +1,4 @@
-import type { Effort } from "@oh-my-pi/pi-ai";
+import { type ConfiguredThinkingLevel } from "../thinking.js";
 import { SelectList, type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
@@ -7,7 +7,7 @@ import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.
  */
 export declare class ThinkingSelectorComponent extends OverlayPanel {
     #private;
-    constructor(currentLevel: Effort, availableLevels: Effort[], onSelect: (level: Effort) => void, onCancel: () => void);
+    constructor(currentLevel: ConfiguredThinkingLevel | undefined, availableLevels: ConfiguredThinkingLevel[], onSelect: (level: ConfiguredThinkingLevel) => void, onCancel: () => void);
     describe(cx: DescribeContext): NativeNode | null;
     /** Picker pointer events drive the list exactly as its keys do. */
     handleNativeEvent(event: NativeUiEvent): void;

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

@@ -1,4 +1,3 @@
-import type { LspServerInfo, RecentSession } from "./welcome.js";
 import type { ComposerPreferences, ComposerStatusCache } from "./composer.js";
 import type { SymbolPreset } from "../theme/theme.js";
 /** Theme inputs cached from the last resolved settings load for stable prepaint colors. */
@@ -8,19 +7,10 @@ export interface ComposerThemePreferences {
     readonly darkTheme?: string;
     readonly lightTheme?: string;
 }
-/** Last authoritative model labels shown in the welcome component. */
-export interface ComposerWelcomeCache {
-    readonly modelName: string;
-    readonly providerName: string;
-}
 /** Speculative composer state read before the settings/session graph is available. */
 export interface ComposerStartupCache {
     readonly preferences?: ComposerPreferences;
     readonly theme?: ComposerThemePreferences;
-    readonly welcome?: ComposerWelcomeCache;
-    readonly recentSessions: RecentSession[];
-    /** `null` when the last run had LSP disabled. */
-    readonly lspServers: LspServerInfo[] | null;
     readonly status?: ComposerStatusCache;
 }
 /**
@@ -43,12 +33,6 @@ export declare class ComposerCache {
     read(cwd: string): ComposerStartupCache;
     /** Resolved theme and composer settings for the next prepaint. */
     writeUi(cwd: string, preferences: ComposerPreferences, theme: ComposerThemePreferences): void;
-    /** Authoritative model/provider labels for the next welcome prepaint. */
-    writeWelcome(cwd: string, welcome: ComposerWelcomeCache): void;
-    /** The latest recent-session rows (first four). */
-    writeRecentSessions(cwd: string, sessions: readonly RecentSession[]): void;
-    /** The latest detected project LSP rows; `null` records that LSP is disabled. */
-    writeLspServers(cwd: string, servers: readonly LspServerInfo[] | null): void;
     /** Status-bar inputs for the next prepaint's startup status line. */
     writeStatus(cwd: string, status: ComposerStatusCache): void;
     close(): void;

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

@@ -6,7 +6,7 @@ import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type
 import type { NativeSurface, NativeSurfaceProvider } from "../native/node.js";
 import { CustomEditor } from "./custom-editor.js";
 import type { WordCompletionMethod } from "./word-completion.js";
-import { type LspServerInfo, type RecentSession, WelcomeComponent } from "./welcome.js";
+import { WelcomeComponent } from "./welcome.js";
 /** Live settings that affect the composer before and after session adoption. */
 export interface ComposerPreferences {
     readonly quiet: boolean;
@@ -25,11 +25,6 @@ export declare const COMPOSER_DEFAULTS: ComposerPreferences;
 /** Welcome data that can be supplied initially or patched as startup resolves it. */
 export interface ComposerWelcomeUpdate {
     readonly version?: string;
-    readonly modelName?: string;
-    readonly providerName?: string;
-    readonly recentSessions?: readonly RecentSession[];
-    /** Detected project servers; `null` means LSP is disabled and hides the welcome section. */
-    readonly lspServers?: readonly LspServerInfo[] | null;
 }
 /**
  * Status-bar inputs persisted by the last session. The first frame renders
@@ -122,6 +117,21 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     #private;
     readonly ui: TUI;
     constructor(options?: ComposerOptions);
+    /**
+     * Rows the below-transcript chrome under `root` (editor, status line, …)
+     * took in the last frame, so a root that grows upward can cap itself to
+     * the screen rows left above them; `undefined` before `root` was laid out.
+     */
+    rowsBelow(root: Component): number | undefined;
+    /**
+     * Keep the input on the bottom row while the live rows cannot fill the
+     * screen, as after an inline decision panel closes. A tall block that just
+     * left the chrome above the editor (a command report) may have scrolled
+     * rows into native history that cannot be pulled back; without the pin the
+     * editor would jump up to where the shorter frame now ends. The pin lifts
+     * once live rows fill the screen again.
+     */
+    pinInputToBottom(): void;
     /** Compose the bounded mutable viewport and the next ordered history append. */
     renderFrame(viewport: ViewportSize): TerminalFramePlan;
     /**
@@ -164,7 +174,7 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     enableInput(): void;
     /** Apply settings changes without replacing the editor or welcome component. */
     setPreferences(update: Partial<ComposerPreferences>): void;
-    /** Patch welcome data in place as model, session, and project discovery complete. */
+    /** Patch welcome data in place as version, session, and project discovery complete. */
     updateWelcome(update: ComposerWelcomeUpdate): void;
     /** Replace optional header content around the stable welcome scene. */
     setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;

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

@@ -237,7 +237,8 @@ export declare class CustomEditor extends Editor {
      * Clicks on the composer's controls take the same paths as their keys: ⇧⇥,
      * ⏎ and Esc; the viewing header's links (`focus:<id>`) go to the host,
      * the status facts' clicks (`status.*`) to their source. Selection edits
-     * go to the buffer.
+     * go to the buffer; `send` submits its own prompt after saving the old draft
+     * for recall and waiting for in-flight clipboard work.
      */
     handleNativeEvent(event: NativeUiEvent): void;
     onEscape?: () => void;

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

@@ -1,58 +1,36 @@
-import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
-/**
- * Fixed number of session rows in the welcome box so its height stays stable
- * across recent-session updates.
- */
-export declare const WELCOME_SESSION_SLOTS = 4;
-/**
- * Fixed number of LSP-server rows, for the same reason. Overflow is sliced so
- * the box height is constant regardless of how many servers a project has.
- */
-export declare const WELCOME_LSP_SLOTS = 4;
 /** Pick a tip from `tips`, biased toward "[NEW]" tips by {@link NEW_TIP_WEIGHT};
  *  `r` is a uniform sample in [0, 1). Returns "" when `tips` is empty.
  *  Exported for tests. */
 export declare function pickWeightedTip(tips: readonly string[], r: number): string;
-export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?: number): string[];
-export interface RecentSession {
-    name: string;
-    timeAgo: string;
-    /** Session file; a native click on the row resumes it. */
-    path?: string;
-}
-export interface LspServerInfo {
-    name: string;
-    status: "ready" | "error" | "connecting" | "available";
-    fileTypes: string[];
-}
 /**
- * Premium welcome screen with block-based OMP logo and two-column layout.
+ * The welcome tip as lines of at most `width` columns: `Tip:` and the body
+ * wrapped together, with no indent, so the banner can center each line.
+ * `[]` when `width` leaves no room for a useful line.
+ */
+export declare function renderWelcomeTip(tip: string, width: number, phase?: number): string[];
+/**
+ * The session's welcome banner. In a terminal: the gradient logo beside the
+ * `omp` wordmark with the version under it (the logo alone when the lockup does
+ * not fit) and the tip of the session (dropped below {@link TIP_MIN_COLUMNS}
+ * columns). Natively: a card with the same logo, wordmark, version and tip
+ * ({@link WelcomeComponent.describe}).
  */
 export declare class WelcomeComponent implements Component {
     #private;
     private version;
-    private modelName;
-    private providerName;
-    private recentSessions;
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    private lspServers;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], 
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    lspServers?: LspServerInfo[] | null);
+    constructor(version: string);
     get tip(): string | undefined;
     invalidate(): void;
     /**
-     * A `card` (`omp.welcome`) titled with the app version. The brand column
-     * (`omp.welcome.brand`: greeting and the terminal's builtin `omp` mark, which
-     * it animates) 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
+     * A `card` (`omp.welcome`) mirroring the terminal banner: the lockup
+     * (`omp.welcome.lockup`: the terminal's builtin `omp` mark, which it animates,
+     * beside the wordmark with the version under it) and the tip of the session.
+     * Roles carry the look (gradient logo, type scale); 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;
     /**
@@ -71,9 +49,6 @@ export declare class WelcomeComponent implements Component {
     stopIntro(): void;
     /** Update the version embedded in the welcome border title. */
     setVersion(version: string): void;
-    setModel(modelName: string, providerName: string): void;
-    setRecentSessions(sessions: RecentSession[]): void;
-    setLspServers(servers: LspServerInfo[] | null): void;
     render(termWidth: number): readonly string[];
 }
 /** Block-grid brand mark shared by the welcome and setup surfaces. */

package/dist/types/status-line/context-usage.d.ts

@@ -3,6 +3,7 @@ import type { CompactionSettings } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Tool as AiTool, Model } from "@oh-my-pi/pi-ai";
 import type { Theme } from "../theme/index.js";
 import { Container } from "../tui.js";
+import type { TspText } from "@oh-my-pi/pi-wire";
 import type { DescribeContext, NativeNode } from "../native/node.js";
 interface ContextSkill {
     readonly name: string;
@@ -154,6 +155,8 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
+/** The `/context` title: the model and its window once a model is selected. */
+export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
 /**
  * Native context-usage panel for terminals without `meter`: the cell grid as
  * unwrapped styled rows beside the legend. The terminal places the legend
@@ -161,15 +164,14 @@ export declare function computeContextBreakdown(session: ContextUsageSession, op
  */
 export declare function describeContextUsage(breakdown: ContextBreakdown): NativeNode;
 /**
- * The `/context` transcript block: ANSI renders the titled cell grid between
- * rules; natively it is one frame, drawn with `meter`s where the terminal
- * has them and as the glyph grid otherwise.
+ * The `/context` report body, without a frame or title of its own (the panel
+ * showing it is titled {@link contextUsageHead}): ANSI renders the cell grid
+ * beside the legend; natively it is drawn with `meter`s where the terminal has
+ * them and as the glyph grid otherwise.
  */
 export declare class ContextUsageView extends Container {
     #private;
     constructor(breakdown: ContextBreakdown, theme: Theme);
-    /** Replace the shown breakdown in place, refreshing both the ANSI and native views. */
-    setBreakdown(breakdown: ContextBreakdown): void;
     describe(cx: DescribeContext): NativeNode;
 }
 /**

package/dist/types/terminal-capabilities.d.ts

@@ -11,7 +11,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;

package/dist/types/terminal.d.ts

@@ -1,4 +1,5 @@
 import { type TspHello } from "./native/encode.js";
+export { writeTerminalSequence, writeThroughActiveTerminal } from "./active-terminal.js";
 /**
  * Split `data` into chunks whose encoded UTF-8 byte length is no greater than
  * `maxChunkBytes`, preferring a line boundary (`\n`) as the cut point so
@@ -69,16 +70,6 @@ export declare class StdoutStallWatchdog {
 }
 /** Record alternate-screen state (called by the TUI on `?1049h`/`?1049l` writes). */
 export declare function setAltScreenActive(active: boolean): void;
-/**
- * Route an out-of-band escape sequence (e.g. an OSC title update) through the
- * active terminal's output path. While a TUI owns stdout, frame paints go
- * through the off-thread write pump and can split across multiple write(2)
- * calls; a direct main-thread `process.stdout.write` can land between two of
- * them — mid escape sequence — and the host terminal then prints the payload
- * as literal text at the cursor position. Returns false when no terminal has
- * started, in which case the caller owns stdout and may write directly.
- */
-export declare function writeThroughActiveTerminal(data: string): boolean;
 /**
  * Emergency terminal restore - call this from signal/crash handlers
  * Resets terminal state without requiring access to the ProcessTerminal instance

package/dist/types/thinking.d.ts

@@ -4,7 +4,7 @@ import { ThinkingLevel } from "@oh-my-pi/pi-agent-core/thinking";
 import { Effort } from "@oh-my-pi/pi-catalog/effort";
 import type { Model } from "@oh-my-pi/pi-catalog/types";
 /** Thinking selectors accepted by CLI inputs, in display order. */
-export declare const CLI_THINKING_LEVELS: readonly string[];
+export declare const CLI_THINKING_LEVELS: readonly ConfiguredThinkingLevel[];
 /**
  * Metadata used to render thinking selector values in the coding-agent UI.
  */

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

@@ -4,8 +4,13 @@ import { type OutputMeta } from "./output-meta.js";
 import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** Default collapsed shell output preview height. */
 export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
-/** LLM-facing footer appended when a tool call becomes a background job. */
-export declare function formatBackgroundNotice(jobId: string): string;
+/**
+ * LLM-facing footer appended when a tool call becomes a background job. It states the job's kill
+ * deadline (`timeoutSec`, `undefined` when disabled) so the model knows the job will die at it before
+ * it waits on the result. The deadline counts the job's whole run time, not time left from now: an
+ * auto-backgrounded call has already spent its foreground wait.
+ */
+export declare function formatBackgroundNotice(jobId: string, timeoutSec: number | undefined): string;
 /** Shell execution metadata used by transcript rendering. */
 export interface BashToolDetails {
     meta?: OutputMeta;