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

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [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

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

@@ -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;

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

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

@@ -1,5 +1,6 @@
 import type * as XtermModule from "@oh-my-pi/pi-utils/vterm";
 import type { Component } from "../tui.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import type { Theme } from "../theme/theme.js";
 /** Resize-only backend exposed by an interactive PTY controller. */
 export interface BashInteractiveTerminalBackend {
@@ -8,6 +9,12 @@ export interface BashInteractiveTerminalBackend {
 /** Interactive terminal overlay driven by an external PTY controller. */
 export declare class BashInteractiveOverlayComponent implements Component {
     #private;
+    /** Native sheet: a full-pane glass overlay titled Console. */
+    readonly nativeOverlay: {
+        readonly role: "omp.overlay.console";
+        readonly size: "full";
+        readonly head: "Console";
+    };
     constructor(command: string, uiTheme: Theme, getTerminalRows: () => number, terminalCtor: typeof XtermModule.Terminal, backend: BashInteractiveTerminalBackend);
     /** Connects normalized keyboard input and overlay lifecycle events to the controller. */
     setHandlers(onInput: (data: string) => void, onDismiss: () => void, onDispose: () => void): void;
@@ -22,6 +29,14 @@ export declare class BashInteractiveOverlayComponent implements Component {
         timedOut: boolean;
     }): void;
     handleInput(data: string): void;
+    /** The Force kill button runs the Esc path. */
+    handleNativeEvent(event: NativeUiEvent): void;
+    /**
+     * Native view: the command with its state badge, the PTY screen as an
+     * `ansi` node (SGR kept, fixed to the PTY grid), and a footer with the
+     * Force kill action while running.
+     */
+    describe(cx: DescribeContext): NativeNode;
     render(width: number): readonly string[];
     invalidate(): void;
     dispose(): void;

package/dist/types/tools/output-meta.d.ts

@@ -31,6 +31,8 @@ export interface TruncationMeta {
     elidedLines?: number;
     /** Artifact ID if full output was saved */
     artifactId?: string;
+    /** Bytes the artifact cap dropped from the saved file's middle; the artifact is then a head/tail sample. */
+    artifactElidedBytes?: number;
     /** Next offset for pagination (head truncation only) */
     nextOffset?: number;
     /**
@@ -87,6 +89,7 @@ export interface LimitsMeta {
         maxColumn: number;
         unit?: "bytes" | "chars";
         artifactId?: string;
+        artifactElidedBytes?: number;
     };
 }
 /**
@@ -111,8 +114,11 @@ export interface OutputMeta {
  * Messages that don't match the expected format are appended ungrouped at the end.
  */
 export declare function formatGroupedDiagnosticMessages(messages: string[]): string;
-/** Format a recoverable output artifact link. */
-export declare function formatFullOutputReference(artifactId: string): string;
+/**
+ * Format a recoverable output artifact link. An artifact the size cap cut
+ * (`artifactElidedBytes > 0`) is labeled as the head/tail sample it holds.
+ */
+export declare function formatFullOutputReference(artifactId: string, artifactElidedBytes?: number): string;
 /** Strip the last literal notice or a matching final line; optionally preserve surrounding whitespace. */
 export declare function stripTrailingNotice(text: string, notice: string | ((line: string) => boolean), trimResult?: boolean): string;
 /** Remove the trailing bash raw-output artifact footer while preserving its artifact id. */

package/dist/types/tools/streaming-output.d.ts

@@ -6,12 +6,11 @@ export declare const DEFAULT_MAX_BYTES: number;
 /** Default UTF-8 byte budget per match line. */
 export declare const DEFAULT_MAX_COLUMN = 512;
 /**
- * Default artifact-on-disk cap for {@link OutputSink}.
- *
- * `0` means unbounded: by default, `artifact://<id>` references preserve the
- * complete raw stream instead of a capped head/tail sample.
+ * Default artifact-on-disk cap for {@link OutputSink}: 16 MiB, split into a
+ * {@link ARTIFACT_DEFAULT_HEAD_BYTES} head and a rolling tail. `0` means
+ * unbounded (the complete raw stream is preserved).
  */
-export declare const ARTIFACT_DEFAULT_MAX_BYTES = 0;
+export declare const ARTIFACT_DEFAULT_MAX_BYTES: number;
 /** Default head budget; the remainder becomes the rolling tail window. */
 export declare const ARTIFACT_DEFAULT_HEAD_BYTES: number;
 /** First failed artifact I/O operation; safe to persist without exposing filesystem errors. */
@@ -36,6 +35,11 @@ export interface OutputSummary {
     columnMax?: number;
     /** Artifact ID for internal URL access (artifact://<id>) when truncated */
     artifactId?: string;
+    /**
+     * Bytes the artifact cap dropped from the middle of the saved file. When
+     * set, `artifact://<id>` holds a head/tail sample, not the full output.
+     */
+    artifactElidedBytes?: number;
     /** Full raw output was not completely saved; artifactId is unavailable. */
     artifactError?: OutputArtifactError;
 }
@@ -67,17 +71,18 @@ export interface OutputSinkOptions {
     /** Minimum ms between onChunk calls. 0 = every chunk (default). */
     chunkThrottleMs?: number;
     /**
-     * Optional cap on bytes written to the artifact-on-disk file. When the cap
-     * is hit, the head window is preserved verbatim and subsequent output feeds
-     * a rolling tail window; on close, the sink writes a single
+     * Cap on bytes written to the artifact-on-disk file. When the cap is hit,
+     * the head window is preserved verbatim and subsequent output feeds a
+     * rolling tail window; on close, the sink writes a single
      * `[ARTIFACT TRUNCATED: …]` notice between them. Default
-     * {@link ARTIFACT_DEFAULT_MAX_BYTES} (unbounded).
+     * {@link ARTIFACT_DEFAULT_MAX_BYTES} (16 MiB); `0` = unbounded.
      */
     artifactMaxBytes?: number;
     /**
      * Bytes reserved for the head window of the capped artifact file. The
      * tail window receives `artifactMaxBytes - artifactHeadBytes`. Default
-     * {@link ARTIFACT_DEFAULT_HEAD_BYTES}; clamped to `[0, artifactMaxBytes]`.
+     * {@link ARTIFACT_DEFAULT_HEAD_BYTES}, but at most half of
+     * `artifactMaxBytes`; clamped to `[0, artifactMaxBytes]`.
      */
     artifactHeadBytes?: number;
 }

package/dist/types/tui.d.ts

@@ -330,6 +330,11 @@ export declare class TUI extends Container {
         options?: OverlayOptions;
         preFocus: Component | null;
         hidden: boolean;
+        /**
+         * A sheet the user clicked away from (see {@link TUI.#focusFromPointer}):
+         * it stays up but no longer holds the keys, until focus moves back into it.
+         */
+        released: boolean;
     }[];
     constructor(terminal: Terminal, showHardwareCursor?: boolean, options?: TUIOptions);
     /**

package/dist/types/windows-input-mode.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Decode Windows console win32-input-mode key records into the key sequences
+ * the rest of the TUI already understands.
+ *
+ * Hosts without the kitty keyboard protocol (Windows Terminal before 1.25)
+ * deliver Shift+Enter as a bare `\r` (indistinguishable from Enter) and
+ * Ctrl+Enter as `\n`. Enabling `CSI ? 9001 h` makes the console host serving
+ * this process report every key as `CSI Vk ; Sc ; Uc ; Kd ; Cs ; Rc _`, which
+ * carries the full modifier state. Paste text, mouse reports and terminal
+ * replies keep arriving as plain VT, so only key records need translating.
+ *
+ * Unmodified and legacy-expressible keys translate to the bytes a legacy
+ * terminal sends; chords legacy encoding loses (modified Enter/Tab/Escape,
+ * Ctrl+Shift+letter, …) translate to kitty CSI-u, which key matching already
+ * parses.
+ */
+/** Stateful decoder: joins UTF-16 surrogate halves that arrive as separate records. */
+export declare class Win32InputModeDecoder {
+    #private;
+    /**
+     * Translate one stdin sequence. Returns `undefined` when `data` is not a
+     * win32-input-mode record (pass it through unchanged), otherwise the key
+     * events it produces — empty for key releases and bare modifier presses.
+     */
+    decode(data: string): string[] | undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.4.8",
+	"version": "18.4.9",
 	"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.8",
-		"@oh-my-pi/pi-agent-core": "18.4.8",
-		"@oh-my-pi/pi-ai": "18.4.8",
-		"@oh-my-pi/pi-catalog": "18.4.8",
-		"@oh-my-pi/pi-natives": "18.4.8",
-		"@oh-my-pi/pi-utils": "18.4.8",
-		"@oh-my-pi/pi-wire": "18.4.8",
-		"@oh-my-pi/snapcompact": "18.4.8"
+		"@oh-my-pi/omptype": "18.4.9",
+		"@oh-my-pi/pi-agent-core": "18.4.9",
+		"@oh-my-pi/pi-ai": "18.4.9",
+		"@oh-my-pi/pi-catalog": "18.4.9",
+		"@oh-my-pi/pi-natives": "18.4.9",
+		"@oh-my-pi/pi-utils": "18.4.9",
+		"@oh-my-pi/pi-wire": "18.4.9",
+		"@oh-my-pi/snapcompact": "18.4.9"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"