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

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 ## [Unreleased]
 
+## [18.4.10] - 2026-10-02
+
+### Added
+
+- Added ContextUsageView.setBreakdown to refresh usage card without recreating it
+- Added support for change events with flexible values in native TUI
+
+### Fixed
+
+- Keep settled responses reachable in scrollback while an ask panel is open, and keep the editor at the bottom after answering ([#12398](https://github.com/can1357/oh-my-pi/issues/12398), [#13993](https://github.com/can1357/oh-my-pi/pull/13993) by [@Dante-dan](https://github.com/Dante-dan)).
+- Fixed a finished `wait` whose jobs were all still running going blank, and the next `wait` removing it while its turn's usage row stayed; the card now keeps its job snapshot ([#12248](https://github.com/can1357/oh-my-pi/issues/12248), [#13978](https://github.com/can1357/oh-my-pi/pull/13978) by [@Dante-dan](https://github.com/Dante-dan)).
+- Hidden thinking blocks no longer leave a faint "Thought for Ns" row in Tern's native transcript; only the live "Thinking…" indicator shows while the model reasons.
+- Fixed long Markdown paragraphs, such as a read preview of a file with no blank line, stalling rendering: a 44 KB paragraph now renders in about 8 ms instead of 95 ms ([#13961](https://github.com/can1357/oh-my-pi/pull/13961) by [@sjawhar](https://github.com/sjawhar)).
+- Fixed Markdown paragraphs with many unclosed `[`, `*` or `_`, or with a long address-like word, stalling rendering for seconds ([#13961](https://github.com/can1357/oh-my-pi/pull/13961) by [@sjawhar](https://github.com/sjawhar)).
+- Fixed Markdown paragraphs with many unclosed `~~`, `$`, `\(` or `\[`, nested brackets or emphasis, or unclosed HTML, stalling rendering for seconds: 40 KB of unclosed `~~` took 85 s. Emphasis or links nested a thousand levels deep still render slowly, for seconds per few KB: each level restyles the text inside it ([#13961](https://github.com/can1357/oh-my-pi/pull/13961) by [@sjawhar](https://github.com/sjawhar)).
+- Fixed arrow keys acting as Escape and terminal query replies appearing as typed text when running omp on Windows over SSH ([#14034](https://github.com/can1357/oh-my-pi/issues/14034)).
+- Fixed `/model` under an `enabledModels`/`--models` scope hiding every judge, search, image, and speech model and dropping their configured role assignments (JUDGE, WEB, IMAGE, …) ([#14016](https://github.com/can1357/oh-my-pi/issues/14016))
+
+### Removed
+
+- Removed the internal `urlTokenPossible` export ([#13961](https://github.com/can1357/oh-my-pi/pull/13961) by [@sjawhar](https://github.com/sjawhar)).
+- Removed the internal `autolinkSchemeScanIndex` export ([#13961](https://github.com/can1357/oh-my-pi/pull/13961) by [@sjawhar](https://github.com/sjawhar)).
+
+## [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/chat/assistant-message.d.ts

@@ -86,9 +86,10 @@ export declare class AssistantMessageComponent extends Container {
      * A `col` (role `omp.assistant`) of `md` nodes keyed by content index, so
      * streamed deltas reach the terminal as `text append` on the same node;
      * the tail block carries `stream: true` until the message finalizes.
-     * Thinking blocks are quiet collapsible `section`s (collapsed per
-     * `hideThinkingBlock`): a muted "Thinking…" shimmer while live, then
-     * "Thought for 12s"; tokens and rate ride in the head's `title`.
+     * Thinking blocks are quiet collapsible `section`s: a muted "Thinking…"
+     * shimmer while live, then "Thought for 12s"; tokens and rate ride in the
+     * head's `title`. With `hideThinkingBlock` only the live head shows (collapsed)
+     * and a finished thought emits nothing.
      */
     describe(): NativeNode;
     /**

package/dist/types/chat/messages.d.ts

@@ -180,6 +180,10 @@ export interface AdvisorNote {
     severity?: AdvisorSeverity;
     /** Which configured advisor produced this note (omitted for the default advisor). */
     advisor?: string;
+    /** Primary turns completed when note was emitted. */
+    turn?: number;
+    /** Primary turns elapsed before merged-batch delivery. */
+    turnsAgo?: number;
 }
 /** Details payload on the batched `advisor` custom message rendered in the transcript. */
 export interface AdvisorMessageDetails {

package/dist/types/chrome/transcript-container.d.ts

@@ -81,6 +81,13 @@ export declare class TranscriptContainer extends Container {
     resetStableEmission(): void;
     /** Whether a transient block may be discarded without leaving tape history. */
     canRemoveBlock(component: Component): boolean;
+    /**
+     * Whether a superseded snapshot block (a repeated `wait` poll) may be
+     * replaced by its successor. Beyond {@link canRemoveBlock}, a block directly
+     * above a usage row stays: that row describes the turn the block belongs to,
+     * and removing the block would leave a usage-only turn (#12248).
+     */
+    canDisplaceBlock(component: Component): boolean;
     /** Lifecycle state per block in transcript order (diagnostics and tests). */
     blockStates(): readonly BlockState[];
     /** Permanently captured presentation mode per block (diagnostics and tests). */

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

@@ -1,10 +1,6 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
-/** @internal exported for tests — must stay index-identical to the old regex scan. */
-export declare function autolinkSchemeScanIndex(src: string): number | undefined;
-/** @internal exported for tests — must never return false for a src the built-in url regex matches. */
-export declare function urlTokenPossible(src: string): boolean;
 /** @internal exported for tests — the grown-line-start block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
 /** A hyperlink as the renderer sees it: inline `[text](href)`, `<autolink>`, bare GFM URL, or reference link. */

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

@@ -20,6 +20,10 @@ import { type Model, type UsageLimit, type UsageReport } from "@oh-my-pi/pi-ai";
 import { type Component, type TUI } from "../index.js";
 import { type ModelBrowserSource } from "./model-browser.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+export declare const ADVISOR_REVIEW_MODES: readonly ["turn", "agent-end"];
+export declare const ADVISOR_SYNC_BACKLOG_MODES: readonly ["off", "1", "3", "5", "strict"];
+export type AdvisorReviewMode = (typeof ADVISOR_REVIEW_MODES)[number];
+export type AdvisorSyncBacklog = (typeof ADVISOR_SYNC_BACKLOG_MODES)[number];
 /** One advisor declared in `WATCHDOG.yml`; its instructions specialize the shared baseline. */
 export interface AdvisorConfig {
     name: string;
@@ -32,6 +36,9 @@ export interface AdvisorConfig {
     enabled?: boolean;
     /** Maximum non-blocker notes per advisor prompt update (default 4); blockers are exempt. */
     maxNotesPerUpdate?: number;
+    reviewMode?: AdvisorReviewMode;
+    reviewInterval?: number;
+    syncBacklog?: AdvisorSyncBacklog;
 }
 /** Which level a `WATCHDOG.yml` lives at: the project root or the user agent dir. */
 export type AdvisorConfigScope = "project" | "user";
@@ -92,6 +99,7 @@ export interface AdvisorConfigDeps {
         thinkingLevel?: ThinkingLevel;
     }>;
     availableToolNames: string[];
+    syncBacklog?: AdvisorSyncBacklog;
     /** Formatted advisor-role model shown on the seeded default row (e.g. "anthropic/claude-..."). */
     defaultModelLabel?: string;
 }

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

@@ -88,6 +88,7 @@ export declare class AskDialogComponent implements Component {
     #private;
     private readonly callbacks;
     private readonly options;
+    readonly retireDisplacedTranscript = true;
     constructor(questions: ExtensionAskDialogQuestion[], callbacks: AskDialogCallbacks, options?: AskDialogOptions);
     invalidate(): void;
     dispose(): void;

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

@@ -62,7 +62,9 @@ export interface RuntimeChildrenOptions {
      * multi-line editor). They are billed at their smallest height so expansion
      * clips the live tail instead of retiring rows a later shrink could not
      * reclaim (#11007). Every other root is billed at its current height, so
-     * settled rows it displaces retire to native scrollback.
+     * settled rows it displaces retire to native scrollback. Decision panels
+     * declaring `retireDisplacedTranscript` opt out of this floor even when
+     * mounted as a child of a transient editor container.
      */
     readonly transient?: readonly Component[];
     /**

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/status-line/context-usage.d.ts

@@ -168,6 +168,8 @@ export declare function describeContextUsage(breakdown: ContextBreakdown): Nativ
 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

@@ -61,6 +61,11 @@ export declare class TerminalInfo {
  * is observed and tests can toggle `Bun.env.ZELLIJ` per case.
  */
 export declare function isInsideZellij(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Whether the agent process runs in an SSH session, so the terminal emulator
+ * is remote and host-local input/keyboard modes cannot be assumed.
+ */
+export declare function isSshSession(env?: NodeJS.ProcessEnv): boolean;
 export declare function isNotificationSuppressed(): boolean;
 /**
  * Whether `PI_FORCE_IMAGE_PROTOCOL` pins the image protocol, including its

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. */