@oh-my-pi/pi-tui 18.4.11 → 18.5.0

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 ## [Unreleased]
 
+## [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
+
+- Changed Ctrl+Z in Tern's native composer to undo the last edit (TSP `undo` event) instead of suspending
+
 ## [18.4.11] - 2026-10-02
 
 ### Added

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

@@ -296,7 +296,7 @@ export declare class Editor implements Component, Focusable {
     submit(): void;
     /** Insert text at the current cursor position */
     insertText(text: string): void;
-    /** Terminal-side selection edits on the `editor` node (see {@link applyHostEdit}). */
+    /** Terminal-side selection edits and undo on the `editor` node (see {@link applyHostEdit}). */
     handleNativeEvent(event: NativeUiEvent): void;
     /**
      * Apply an edit the terminal made over its own selection (TSP `edit`):

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

@@ -39,7 +39,7 @@ export declare class Input implements Component, Focusable {
     /** Apply terminal paste semantics to text from non-bracketed paste transports
      *  (e.g. kitty's OSC 5522 enhanced clipboard read). Mirrors `Editor.pasteText`. */
     pasteText(text: string): void;
-    /** Terminal-side selection edits on the `input` node (see {@link applyHostEdit}). */
+    /** Terminal-side selection edits and undo on the `input` node (see {@link applyHostEdit}). */
     handleNativeEvent(event: NativeUiEvent): void;
     /**
      * Apply an edit the terminal made over its own selection (TSP `edit`):

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

@@ -27,7 +27,8 @@ export declare function encodeTspJson(verb: TspVerb, value: unknown, params?: Ts
 /**
  * The `hello` query; callers follow it with a DA1 sentinel. `features: ["edit"]`
  * 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.
+ * 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.
  */
 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;
@@ -117,7 +130,12 @@ export type NativeUiEvent = {
  | ({
     readonly type: "edit";
     readonly key: string;
-} & NativeTextEdit);
+} & NativeTextEdit)
+/** Undo the last change to an `editor`/`input` node's text (the terminal's ⌃Z); a no-op with no history. */
+ | {
+    readonly type: "undo";
+    readonly key: string;
+};
 /**
  * A primitive edit the terminal made over its own text selection (cut,
  * typing, Backspace/Delete or paste over it, or collapsing it). Offsets are

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/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/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/task.d.ts

@@ -108,6 +108,8 @@ export interface TaskItem {
     solutionSpace?: string;
     /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
     effort?: "lo" | "med" | "hi";
+    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
+    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -134,6 +136,8 @@ export interface TaskParams {
     solutionSpace?: string;
     /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
     effort?: "lo" | "med" | "hi";
+    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
+    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -255,7 +259,7 @@ export interface AgentProgress {
     resolvedModelRoute?: string;
     /** True when a live advisor was attached to this run's session, not merely enabled in settings. */
     advisor?: boolean;
-    /** The agent's latest self-estimate of task completion (0–100), from the periodic `task.completionProbeMs` side request. */
+    /** The agent's latest self-estimate of task completion (0–100), from the periodic `task.completionProbe` side request. */
     completionPercent?: number;
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
     extractedToolData?: Record<string, unknown[]>;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.4.11",
+	"version": "18.5.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.4.11",
-		"@oh-my-pi/pi-agent-core": "18.4.11",
-		"@oh-my-pi/pi-ai": "18.4.11",
-		"@oh-my-pi/pi-catalog": "18.4.11",
-		"@oh-my-pi/pi-natives": "18.4.11",
-		"@oh-my-pi/pi-utils": "18.4.11",
-		"@oh-my-pi/pi-wire": "18.4.11",
-		"@oh-my-pi/snapcompact": "18.4.11"
+		"@oh-my-pi/omptype": "18.5.0",
+		"@oh-my-pi/pi-agent-core": "18.5.0",
+		"@oh-my-pi/pi-ai": "18.5.0",
+		"@oh-my-pi/pi-catalog": "18.5.0",
+		"@oh-my-pi/pi-natives": "18.5.0",
+		"@oh-my-pi/pi-utils": "18.5.0",
+		"@oh-my-pi/pi-wire": "18.5.0",
+		"@oh-my-pi/snapcompact": "18.5.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/apps/git/sidebar.ts

@@ -1007,7 +1007,7 @@ export class Sidebar {
 	 * text field being edited. False when not the sidebar's event.
 	 */
 	handleNativeEvent(event: NativeUiEvent): boolean {
-		if (event.type === "edit") {
+		if (event.type === "edit" || event.type === "undo") {
 			const editing = this.editing ? this.selected?.kind : undefined;
 			const field =
 				editing === "summary"
@@ -1017,7 +1017,7 @@ export class Sidebar {
 						: editing === "description"
 							? this.description
 							: undefined;
-			field?.applyHostEdit(event);
+			field?.handleNativeEvent(event);
 			return field !== undefined;
 		}
 		if (event.type === "select" || event.type === "activate") {

package/src/components/editor.ts

@@ -2862,9 +2862,10 @@ export class Editor implements Component, Focusable {
 		this.#insertTextAtCursor(text);
 	}
 
-	/** Terminal-side selection edits on the `editor` node (see {@link applyHostEdit}). */
+	/** Terminal-side selection edits and undo on the `editor` node (see {@link applyHostEdit}). */
 	handleNativeEvent(event: NativeUiEvent): void {
 		if (event.type === "edit") this.applyHostEdit(event);
+		else if (event.type === "undo") this.#applyUndo();
 	}
 
 	/**

package/src/components/input.ts

@@ -284,9 +284,10 @@ export class Input implements Component, Focusable {
 		this.#handlePaste(text);
 	}
 
-	/** Terminal-side selection edits on the `input` node (see {@link applyHostEdit}). */
+	/** Terminal-side selection edits and undo on the `input` node (see {@link applyHostEdit}). */
 	handleNativeEvent(event: NativeUiEvent): void {
 		if (event.type === "edit") this.applyHostEdit(event);
+		else if (event.type === "undo") this.#undo();
 	}
 
 	/**

package/src/desktop-notify.ts

@@ -50,7 +50,8 @@ export function hasLinuxDesktopSession(
 	if (platform !== "linux") return false;
 	if (env.DBUS_SESSION_BUS_ADDRESS) return true;
 	const runtimeDir = env.XDG_RUNTIME_DIR;
-	return Boolean(runtimeDir && fileExists(path.join(runtimeDir, "bus")));
+	// Only reached for Linux, so join with POSIX separators regardless of the host.
+	return Boolean(runtimeDir && fileExists(path.posix.join(runtimeDir, "bus")));
 }
 
 /**

package/src/native/backend.ts

@@ -671,6 +671,7 @@ export class NativeBackend {
 			case "action":
 			case "change":
 			case "edit":
+			case "undo":
 				this.#routeUiEvent(event);
 				return;
 			case "focus": {
@@ -687,7 +688,7 @@ export class NativeBackend {
 	}
 
 	#routeUiEvent(
-		event: Extract<TspEvent, { ev: "toggle" | "select" | "activate" | "action" | "change" | "edit" }>,
+		event: Extract<TspEvent, { ev: "toggle" | "select" | "activate" | "action" | "change" | "edit" | "undo" }>,
 	): void {
 		const reconciler = this.#surfaceFor(event.sf)?.reconciler;
 		const target = reconciler?.target(event.id);
@@ -721,6 +722,9 @@ export class NativeBackend {
 				ui = { type: "edit", key: target.keypath, from, to, text, cursor, len };
 				break;
 			}
+			case "undo":
+				ui = { type: "undo", key: target.keypath };
+				break;
 		}
 		target.component.handleNativeEvent(ui);
 		this.#host.requestRender();

package/src/native/encode.ts

@@ -109,10 +109,11 @@ export function encodeTspJson(verb: TspVerb, value: unknown, params?: TspParams,
 /**
  * The `hello` query; callers follow it with a DA1 sentinel. `features: ["edit"]`
  * 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.
+ * 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.
  */
 export function encodeTspHelloQuery(version?: string): string {
-	return encodeTspJson("q", { q: "hello", v: [TSP_VERSION], app: "omp", features: ["edit"], ver: version });
+	return encodeTspJson("q", { q: "hello", v: [TSP_VERSION], app: "omp", features: ["edit", "undo"], ver: version });
 }
 
 /** One decoded APC message: verb, parameters and raw body. */
@@ -172,6 +173,7 @@ const EVENT_REQUIRED: Readonly<Record<string, Readonly<Record<string, "string" |
 	// `value` varies by control (boolean, number, string, string[], null): the handler checks it.
 	change: { id: "string", item: "string" },
 	edit: { id: "string", from: "number", to: "number", text: "string", cursor: "number", len: "number" },
+	undo: { id: "string" },
 	focus: { id: "string" },
 	error: { msg: "string" },
 	gone: { ids: "array" },