@oh-my-pi/pi-tui 18.4.6 → 18.4.9

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 ## [Unreleased]
 
+## [18.4.9] - 2026-10-01
+
+### Added
+
+- Exported `wordCompletionQuery()` so hosts outside the editor can apply the same prose eligibility rules used by ghost-text word completion.
+- Added a full-featured Background jobs view with selectable jobs, live status and elapsed time, working directory, process IDs, exit code, command, tailing output, and cancellation for running jobs.
+
+### Changed
+
+- `OutputSink` now limits artifact files to 16 MiB by default while preserving the beginning and end of oversized output and marking the omitted bytes. Set `artifactMaxBytes: 0` to keep artifacts unbounded; `dump()` reports omitted bytes and full-output references identify sampled artifacts.
+
+### Fixed
+
+- Reduced unnecessary composer startup-cache writes and ensured the cache database is released when it closes on Windows.
+- Fixed Shift+Enter and Ctrl+Enter prompt behavior in Windows Terminal 1.24 and earlier; Shift+Enter now inserts a newline and Ctrl+Enter sends a follow-up, matching other platforms.
+- Improved the Tern native terminal experience across background jobs, settings, debugging, logs, extension management, interactive shell, and provider streams: views remain usable and navigable, preserve output and selection behavior, support keyboard scrolling, and keep key actions accessible.
+- Fixed multi-line labels in Background jobs and multi-line titles in native-terminal prompts so their formatting remains readable.
+
+## [18.4.8] - 2026-10-01
+
+### Fixed
+
+- Fixed native-terminal (TSP) frames held back by unacknowledged credits waiting for an unrelated render after the 5-second stall fallback expired; a credit-blocked change now renders as soon as the oldest frame counts as stalled.
+
+## [18.4.7] - 2026-10-01
+
+### Added
+
+- Added an optional `terminal` section to theme JSON (`background`, `foreground`, `chrome`, `widget`, 16 `ansi` colors) naming the terminal a theme was made for, for hosts that paint the terminal themselves; the built-in themes ported from known schemes (GitHub, Nord, Dracula, Catppuccin, Solarized, Gruvbox, Tokyo Night, One, Monokai, Rosé Pine, Poimandres, Celestial) carry their scheme's.
+
 ## [18.4.6] - 2026-10-01
 
 ### Added

package/dist/types/apps/debug/log-viewer.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../../tui.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../../native/node.js";
 /** Host capabilities for copying and fetching earlier log entries. */
 export interface LogViewerDeps {
     copyToClipboard(text: string): void;
@@ -76,6 +77,22 @@ export declare class DebugLogViewerComponent implements Component {
     handleInput(keyData: string): void;
     invalidate(): void;
     dispose(): void;
+    /** A `picker` sheet floats over the transcript instead of taking the screen. */
+    nativeSheet(cx: DescribeContext): boolean;
+    /**
+     * The logs as a picker sheet: the filter as its query, one row per entry
+     * (message, fields, time, pid, level dot) with the session boundary as a
+     * group head, the range selection checked, the entry under the cursor
+     * pretty-printed below, and the keys' actions in the bar. Without the
+     * `picker` kind it falls back to rows.
+     */
+    describe(cx: DescribeContext): NativeNode | null;
+    /**
+     * Pointer actions run the keys' code: a row click moves the cursor there,
+     * a second click copies it (or loads older entries from that row), and the
+     * bar's buttons mirror their keys.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];
 }
 export {};

package/dist/types/apps/debug/raw-sse.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../../tui.js";
+import type { NativeNode, NativeScreen, NativeUiEvent } from "../../native/node.js";
 import { type RawSseDebugBuffer } from "./raw-sse-buffer.js";
 /** @internal Exported for tests. */
 export declare function expandPrettyDataLines(raw: readonly string[]): string[];
@@ -23,4 +24,17 @@ export declare class RawSseViewerComponent implements Component {
     handleInput(keyData: string): void;
     invalidate(): void;
     render(width: number): readonly string[];
+    /** The action bar's buttons run the same code as their keys. */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * The stream as a page of its own: the capture counters over the wire
+     * text, one `ansi` block that fills the page, scrolls itself and follows
+     * its tail until the user scrolls away (Tern-local, so no follow state
+     * here; the scroll keys reach it as `scroll` requests). The copy status
+     * and the buttons are this component's own node, docked under the page
+     * so they never scroll away.
+     */
+    describeScreen(): NativeScreen;
+    /** The docked bar under the stream page: the copy status and the buttons. */
+    describe(): NativeNode;
 }

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

@@ -1,6 +1,6 @@
 import { type TspFrame, type TspNode } from "@oh-my-pi/pi-wire";
 import type { Terminal } from "../terminal.js";
-import type { Component, OverlayOptions } from "../tui.js";
+import type { Component, OverlayOptions, RenderScheduler } from "../tui.js";
 import { type TspHello } from "./encode.js";
 import type { DescribeContext, NativeSurface } from "./node.js";
 /** A visible TUI overlay, bottom to top. */
@@ -19,6 +19,14 @@ export interface NativeHost {
     overlays(): readonly NativeOverlay[];
     /** Component receiving keyboard input. */
     focused(): Component | null;
+    /**
+     * The user clicked into a node described by `owners[0]` (then the
+     * components containing it, innermost first): move keyboard focus there.
+     * `field` is the outermost owner that takes keys and whose focus target is
+     * the clicked `editor`/`input`, if any; `sheet` tells the overlays that
+     * don't hold the keys while the user works beside them.
+     */
+    focusFromPointer(owners: readonly Component[], field: Component | null, sheet: (overlay: Component) => boolean): void;
     requestRender(): void;
     /** The terminal switched appearance. */
     appearanceChanged(dark: boolean): void;
@@ -34,7 +42,8 @@ export interface NativeBackendOptions {
     readonly recordPath?: string;
     /** Log the `rows` fallback count per frame. Defaults to `PI_TUI_NATIVE_STATS=1`. */
     readonly stats?: boolean;
-    readonly now?: () => number;
+    /** Clock and timers (stall wake-up); defaults to `Date.now` and unref'd `setTimeout`. */
+    readonly scheduler?: RenderScheduler;
 }
 /**
  * The reply a v1 terminal is assumed to give before its real `hello` arrives

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

@@ -24,7 +24,11 @@ export declare function splitUtf8(body: string, limit: number): string[];
 export declare function encodeTspMessage(verb: TspVerb, body: string, params?: TspParams, limit?: number): string;
 /** Encode a JSON message body. */
 export declare function encodeTspJson(verb: TspVerb, value: unknown, params?: TspParams, limit?: number): string;
-/** The `hello` query; callers follow it with a DA1 sentinel. */
+/**
+ * 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.
+ */
 export declare function encodeTspHelloQuery(version?: string): string;
 /** One decoded APC message: verb, parameters and raw body. */
 export interface TspRawMessage {

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

@@ -13,7 +13,7 @@
  * See `packages/wire/src/tsp.ts` for the wire vocabulary and
  * `crates/tern/SURFACE_PROTOCOL.md` (Stencil repository) for the spec.
  */
-import type { TspEvent, TspKind, TspProps, TspSpan } from "@oh-my-pi/pi-wire";
+import type { TspEvent, TspKind, TspProps, TspScrollBy, TspSpan } from "@oh-my-pi/pi-wire";
 import type { Component } from "../tui.js";
 /** A described node: a wire node minus its id, with components allowed as children. */
 export type NativeNode = {
@@ -32,8 +32,21 @@ export type NativeNode = {
          * added. Key a node by what it points at to reveal it again on a move.
          */
         readonly reveal?: "start" | "end" | "nearest";
+        /**
+         * Keyboard scrolling forwarded to the terminal (PgUp/PgDn/End reach the
+         * program): moves the scroller at or above the node by `by` whenever
+         * `n` differs from the previous description of the same node. Bump `n`
+         * per key press; presses between two frames repeat the latest `by` once
+         * each (`start`/`end` once). A freshly added node never scrolls.
+         */
+        readonly scroll?: NativeScroll;
     };
 }[TspKind];
+/** A {@link NativeNode.scroll} request. */
+export interface NativeScroll {
+    readonly by: TspScrollBy;
+    readonly n: number;
+}
 /** A child slot: a described node, or a component that describes itself. */
 export type NativeChild = NativeNode | Component;
 /** What a component may consult while describing itself. Never a clock: motion is terminal-clocked. */

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

@@ -32,6 +32,11 @@ export declare class Reconciler {
     detachLive(): void;
     /** The component and keypath that described wire node `id`. */
     target(id: string): NativeTarget | null;
+    /**
+     * The component that described wire node `id`, then each component whose
+     * node contains it, innermost first (empty for an unknown id).
+     */
+    owners(id: string): Component[];
     /** 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. */

package/dist/types/overlays/extensions/extension-dashboard.d.ts

@@ -12,8 +12,15 @@
  * - Space/Enter or click: toggle selected item (or provider master switch)
  * - Wheel over the inspector, or PageUp/PageDown when the inspector overflows: scroll the detail pane
  * - Esc: clear search (if active) then close
+ *
+ * Natively (Tern) it is a `picker` sheet: provider scopes, the inventory as
+ * rows grouped by kind, the inspector as the side preview, and Toggle /
+ * Expand / Close actions; without `picker` it describes a page with the same
+ * parts. Pointer events run the key paths above.
  */
+import type { TspPickerScope } from "@oh-my-pi/pi-wire";
 import type { Component } from "../../tui.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../../native/node.js";
 import { type Tab } from "../../components/tab-bar.js";
 import { type ToolRuntimeSource } from "./inspector-panel.js";
 import type { ExtensionInspectorSource } from "./inspector-model.js";
@@ -45,6 +52,13 @@ export interface ExtensionDashboardOptions {
  * re-enabled from the list. The "all" tab is never muted or marked.
  */
 export declare function buildTabBarTabs(tabs: ProviderTab[]): Tab[];
+/**
+ * Picker scopes from the provider tabs: "all" first, then each provider with
+ * its mark and count. Empty enabled providers are disabled (muted in the
+ * {@link TabBar}); switched-off providers keep a muted dot and stay
+ * selectable so their master switch can be turned back on.
+ */
+export declare function buildPickerScopes(tabs: ProviderTab[]): TspPickerScope[];
 export declare class ExtensionDashboard implements Component {
     #private;
     onClose?: () => void;
@@ -59,5 +73,22 @@ export declare class ExtensionDashboard implements Component {
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput(data: string): void;
+    /** The dashboard is a `picker` sheet (scopes = providers, preview = inspector) wherever Tern draws pickers. */
+    nativeSheet(cx: DescribeContext): boolean;
+    /**
+     * The picker sheet, or without `picker` a page: head, provider tabs,
+     * search, the inventory list beside the inspector, and an action bar.
+     * Rebuilt when state moves or the live tool set changes (MCP health
+     * changes arrive as render requests, which bump the version).
+     */
+    describe(cx: DescribeContext): NativeNode;
+    /**
+     * Pointer input, each on the path of the key it stands for: a row click
+     * selects (click on the selected row or double click toggles, like
+     * Space/Enter), a scope switches provider (←/→), `toggle`/`expand` run
+     * Space and the expand key, `clear` empties the search (first Esc) and
+     * `close` closes. Provider tabs in the page route to the {@link TabBar}.
+     */
+    handleNativeEvent(event: NativeUiEvent): void;
     dispose(): void;
 }

package/dist/types/overlays/extensions/extension-list.d.ts

@@ -5,7 +5,9 @@
  * that toggles the entire provider. All items below are dimmed when the
  * master switch is off.
  */
+import type { TspPickerGroup, TspPickerItem, TspProps } from "@oh-my-pi/pi-wire";
 import type { Component } from "../../tui.js";
+import type { NativeNode } from "../../native/node.js";
 import { type ToolRuntimeSource } from "./inspector-model.js";
 import { type MCPRuntimeSource } from "./mcp-runtime.js";
 import { type Extension, type ExtensionKind, type ExtensionProvider } from "./types.js";
@@ -19,6 +21,22 @@ export interface ExtensionListCallbacks {
     mcpSource?: MCPRuntimeSource;
     toolSource?: ToolRuntimeSource;
 }
+/** The inventory as `picker` data: rows, display order with kind groups, the selection and search hits. */
+export interface ExtensionListPickerView {
+    readonly items: TspPickerItem[];
+    /** Item ids in display order; kind headers become group entries. */
+    readonly order: (string | TspPickerGroup)[];
+    /** Selected item id; null when nothing or a kind header is selected. */
+    readonly selected: string | null;
+    readonly hits: Record<string, [number, number][]>;
+    /** Whether kind headers group the rows (the unfiltered ALL view). */
+    readonly grouped: boolean;
+}
+/** The selected row's switch: its state, and why it cannot flip when it can't. */
+export interface ExtensionListSwitch {
+    readonly on: boolean;
+    readonly blocked?: string;
+}
 export declare class ExtensionList implements Component {
     #private;
     constructor(extensions: Extension[], callbacks?: ExtensionListCallbacks, maxVisible?: number);
@@ -29,6 +47,8 @@ export declare class ExtensionList implements Component {
     setMcpSource(source: MCPRuntimeSource | undefined): void;
     setToolSource(source: ToolRuntimeSource | undefined): void;
     getSearchQuery(): string;
+    /** The search field's text and caret for a native `picker` head. */
+    nativeQuery(): Pick<TspProps<"picker">, "query" | "cursor">;
     resetSelection(): void;
     getSelectedExtension(): Extension | null;
     /** Get the currently selected kind header (for preview purposes) */
@@ -38,6 +58,23 @@ export declare class ExtensionList implements Component {
     clearSearch(): void;
     invalidate(): void;
     render(width: number): readonly string[];
+    /** The visible rows as `picker` data, joined with live MCP health and tool runtime like {@link render}. */
+    pickerView(): ExtensionListPickerView;
+    /**
+     * The visible rows as a native `list` (kind headers included, so the
+     * selection matches the keyboard's), for terminals without `picker`.
+     */
+    describeList(key: string): NativeNode;
+    /**
+     * A pointer pick of the row with native id `id`: select it, then toggle it
+     * when `activate` (the click-on-selected / double-click path). Returns
+     * whether the id named a visible row.
+     */
+    pickNative(id: string, activate: boolean): boolean;
+    /** The selected row's switch, or undefined on a kind header or an empty list. */
+    selectedSwitch(): ExtensionListSwitch | undefined;
+    /** Toggle the selected item, or flip the provider master switch when on it (Space/Enter). */
+    activateSelected(): void;
     /** Highlight the row under the pointer (null clears). */
     setHoverIndex(index: number | null): void;
     /**

package/dist/types/overlays/extensions/inspector-panel.d.ts

@@ -1,4 +1,5 @@
 import type { Component } from "../../tui.js";
+import type { NativeNode } from "../../native/node.js";
 import { type ExtensionInspectorSource, type ToolRuntimeSource } from "./inspector-model.js";
 import { type MCPRuntimeSource } from "./mcp-runtime.js";
 import { type Extension } from "./types.js";
@@ -14,4 +15,11 @@ export declare class InspectorPanel implements Component {
     toggleExpanded(): boolean;
     invalidate(): void;
     render(width: number): readonly string[];
+    /**
+     * The selected extension as native preview nodes, in the same order as
+     * {@link render}: identity, runtime/enablement and origin facts,
+     * description, guidance, kind sections, content preview, config. The
+     * collapsed budgets follow {@link toggleExpanded} like the ANSI view.
+     */
+    describePreview(): NativeNode[];
 }

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

@@ -16,6 +16,30 @@ export interface JobsPanelSnapshot {
     readonly running: readonly JobsPanelJob[];
     readonly recent: readonly JobsPanelJob[];
 }
+/** What the sheet shows about the selected job beyond its row. */
+export interface JobsPanelDetail {
+    /** Full command line of a job that runs a process (rows show the cut label). */
+    readonly command?: string;
+    readonly cwd?: string;
+    /** Live pids the job's command spawned. */
+    readonly pids: readonly number[];
+    readonly exitCode?: number;
+    /** Output tail while running; the final text once settled. */
+    readonly output?: string;
+    /** Artifact holding the full output when `output` is cut. */
+    readonly artifactId?: string;
+}
+/** The session behind a {@link JobsSheet}. */
+export interface JobsSheetSource {
+    /** Current jobs; runs once per frame. */
+    load(): JobsPanelSnapshot;
+    /** The selected job's detail; runs once per frame, undefined once the job is gone. */
+    inspect(id: string): JobsPanelDetail | undefined;
+    /** Cancel a running job. */
+    cancel(id: string): void;
+    /** 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;
@@ -23,26 +47,28 @@ export declare class JobsPanel extends Container {
     describe(cx: DescribeContext): NativeNode;
 }
 /**
- * The jobs pill's sheet: a centred `md` glass sheet titled Background jobs
- * that re-reads the session's jobs on every frame, so rows start, settle and
- * move to Recent while it is open. Esc or Close dismisses it; nothing enters
- * the transcript.
+ * 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
+ * job's detail: status and live elapsed (a task job's `agent` node), cwd,
+ * live pids, exit code, the full command and a tail-following output pane.
+ * It re-reads the session every frame, so the caller re-renders it on a
+ * timer while it is open. ↑/↓ select, X cancels the selected running job,
+ * Esc or Close dismisses; nothing enters the transcript.
  */
 export declare class JobsSheet implements Component {
     #private;
     readonly nativeOverlay: {
         readonly role: "omp.overlay.jobs";
-        readonly size: "md";
+        readonly size: "lg";
         readonly anchor: "center";
         readonly head: "Background jobs";
     };
-    /** `load` returns the current jobs; it runs once per frame. */
-    constructor(load: () => JobsPanelSnapshot, onClose: () => void);
+    constructor(source: JobsSheetSource);
     describe(cx: DescribeContext): NativeNode;
-    /** Rows for a terminal without the native surface: status, label, type and age per job. */
+    /** Rows for a terminal without the native surface: one per job, then the selected job's facts and output tail. */
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput(data: string): void;
-    /** Close runs what Esc runs. */
+    /** Clicks select a row; Close and Cancel job run what Esc and X run. */
     handleNativeEvent(event: NativeUiEvent): void;
 }

package/dist/types/prompt/word-completion.d.ts

@@ -1,4 +1,5 @@
 import type { EditorTextAssistProvider } from "../components/editor.js";
+import { ProseSource } from "./prose-gate.js";
 /** Values of the `spelling.autocomplete` setting. */
 export declare const WORD_COMPLETION_METHODS: readonly ["off", "auto", "ngram", "smollm", "apple"];
 /** Configured word-completion engine; `off` disables ghost text. */
@@ -21,6 +22,17 @@ export type WordPredictionBackendResolver = (method: WordCompletionEngine) => Wo
  * before the host finished starting. Pass `undefined` to detach.
  */
 export declare function setWordPredictionHost(resolver: WordPredictionBackendResolver | undefined): void;
+/** The prose word ending at the cursor and the editor text before it: what an engine is asked to complete. */
+export interface WordCompletionQuery {
+    before: string;
+    prefix: string;
+}
+/**
+ * The query for the prose word ending at the cursor, or `undefined` where no
+ * ghost text applies (mid-word, no word, code, paths, commands). `prose`
+ * memoizes the whole-buffer mask; pass one instance across keystrokes.
+ */
+export declare function wordCompletionQuery(lines: readonly string[], cursorLine: number, cursorCol: number, prose?: ProseSource): WordCompletionQuery | undefined;
 /**
  * Ghost-text word completion for the prose word ending at the cursor, served
  * by an injected asynchronous {@link WordPredictionBackend}.

package/dist/types/terminal.d.ts

@@ -276,6 +276,13 @@ export interface ProcessTerminalOptions {
      * `WSL_INTEROP`) — the suite must behave identically on WSL and on CI.
      */
     conpty?: boolean;
+    /**
+     * Whether stdin is a native Windows console handle (win32, not WSL), whose
+     * console host answers `CSI ? 9001 h` with win32-input-mode key records.
+     * Defaults to `process.platform === "win32"`; only consulted when `conpty`
+     * is also true.
+     */
+    nativeWindowsConsole?: boolean;
 }
 /**
  * Real terminal using process.stdin/stdout