@oh-my-pi/pi-tui 18.11.0 → 18.11.1

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 ## [Unreleased]
 
+## [18.11.1] - 2026-10-15
+
+### Added
+
+- Added a tree layout to the background jobs sheet: subagents' jobs nest under the task job that runs them, busiest branches first, and Cancel appears only on the viewing agent's own jobs ([#15854](https://github.com/can1357/oh-my-pi/pull/15854) by [@H4vC](https://github.com/H4vC))
+
+### Fixed
+
+- Fixed transcript images not opening their file: image placeholders and native image nodes now link to the source file or a stored copy ([#15872](https://github.com/can1357/oh-my-pi/pull/15872) by [@H4vC](https://github.com/H4vC))
+- A collapsing live block no longer leaves its slack as a band of blank rows between the retired history and the live rows: the slack falls below the transcript, so a streamed reply stays contiguous and the input keeps the bottom row ([#15499](https://github.com/can1357/oh-my-pi/pull/15499) by [@iacore](https://github.com/iacore))
+- Fixed width-aware text on native (TSP) terminals truncating content two columns early ([#15806](https://github.com/can1357/oh-my-pi/pull/15806) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed Tab/right-arrow completion silently dismissing a selected `@"quoted path"` file suggestion when the path contains spaces ([#15698](https://github.com/can1357/oh-my-pi/pull/15698) by [@drawde-nadroj](https://github.com/drawde-nadroj))
+- Bracketed pastes are now capped by their UTF-8 size, so a large multibyte paste no longer buffers past the byte limit ([#15803](https://github.com/can1357/oh-my-pi/pull/15803) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Fixed OSC 66 text-sized spans bypassing truncation when their UTF-16 length was short enough to fit the fast-path guard ([#15802](https://github.com/can1357/oh-my-pi/pull/15802) by [@yuzu-octopus](https://github.com/yuzu-octopus))
+- Updated the `ast_grep` result view's truncated-match note to suggest `skip` pagination instead of the schema's nonexistent `increase limit` flag ([#15532](https://github.com/can1357/oh-my-pi/issues/15532), [#15543](https://github.com/can1357/oh-my-pi/pull/15543) by [@peda-cos](https://github.com/peda-cos)).
+- Fixed a streaming Edit preview with long wrapped lines growing past its row cap, because its tail was budgeted without the diff gutter its continuation rows hang under ([#15679](https://github.com/can1357/oh-my-pi/pull/15679))
+- Fixed malformed base64 padding being accepted for chat image attachments before native image decoding ([#15765](https://github.com/can1357/oh-my-pi/pull/15765) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Fixed Shift+Enter submitting and Ctrl+Enter inserting a newline in Windows Terminal 1.25–1.27 after closing any fullscreen view such as `/settings`; the terminal dropped omp's keyboard mode on leaving the alternate screen ([microsoft/terminal#20763](https://github.com/microsoft/terminal/issues/20763)), so omp now re-applies it ([#15868](https://github.com/can1357/oh-my-pi/pull/15868) by [@H4vC](https://github.com/H4vC)).
+- Long lines in native (Tern) `read`, `write`, and code-cell source now wrap instead of scrolling each block sideways ([#15823](https://github.com/can1357/oh-my-pi/issues/15823)).
+- Fixed long text pastes taking seconds to land in terminals that deliver a paste one key at a time, such as JetBrains' terminal on Windows; omp no longer writes to the terminal for every pasted key ([#15757](https://github.com/can1357/oh-my-pi/issues/15757))
+- Fixed Shift+Enter submitting the prompt and Ctrl+Enter inserting a newline in WSL under Windows Terminal 1.24 and earlier, conhost, and other ConPTY hosts without kitty keyboard support; Shift+Enter now inserts a newline and Ctrl+Enter sends a follow-up, as on native Windows.
+- Fixed streamed Markdown tables jumping around as each row arrives: the terminal UI fills the row being written in under the existing column widths, and native (TSP) terminals receive each row once its line is complete ([#15856](https://github.com/can1357/oh-my-pi/pull/15856) by [@H4vC](https://github.com/H4vC)).
+- Fixed streamed links and inline math showing raw `[text](url` or LaTeX and then rewrapping the paragraph when they close, in the terminal UI and native (TSP) terminals: they now render in their closed form while they stream ([#15864](https://github.com/can1357/oh-my-pi/pull/15864) by [@H4vC](https://github.com/H4vC)).
+- Paint-only overlays no longer swallow typing intended for the focused input beneath them ([#15793](https://github.com/can1357/oh-my-pi/issues/15793)).
+
 ## [18.11.0] - 2026-10-14
 
 ### Added
@@ -2643,40 +2668,4 @@
 - Added `cursorOverride` and `cursorOverrideWidth` properties to customize the end-of-text cursor glyph with ANSI-styled strings
 - Added `getUseTerminalCursor()` method to query the terminal cursor mode setting
 
-## [11.10.0] - 2026-02-10
-
-### Added
-
-- Added `hint` property to autocomplete items to display dim ghost text after cursor when item is selected
-- Added `getInlineHint()` method to `SlashCommand` interface for providing inline hint text based on argument state
-- Added `getInlineHint()` method to `AutocompleteProvider` interface for displaying dim ghost text after cursor
-- Added `hintStyle` theme option to customize styling of inline hint/ghost text in editor
-
-### Changed
-
-- Updated editor to render inline hint text as dim ghost text after cursor when autocomplete suggestions are active or provider supplies hints
-
-## [11.8.0] - 2026-02-10
-
-### Added
-
-- Added Alt+Y keybinding to cycle through kill ring entries (yank-pop)
-- Added undo support to Input component with Ctrl+Z keybinding
-- Added kill ring support to Input component for Emacs-style kill/yank operations
-- Added yank (Ctrl+Y) and yank-pop (Alt+Y) support to Input component
-
-### Changed
-
-- Changed Editor kill ring implementation to use dedicated KillRing class for better state management
-- Changed Editor undo stack to use generic UndoStack class with automatic state cloning
-- Changed kill/yank behavior to properly accumulate consecutive kill operations
-- Changed Input component deletion methods to record killed text in kill ring
-- Changed undo coalescing in Input component to group consecutive word typing into single undo units
-
-## [11.4.1] - 2026-02-06
-
-### Fixed
-
-- Fixed terminal scrolling when displaying overlays after rendering large content, preventing hundreds of blank lines from being output
-
-Older entries are archived in [packages/tui/CHANGELOG.md@a66558815743](https://github.com/can1357/oh-my-pi/blob/a66558815743a61164ceebceb2bb528989fb09b3/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@090e359aa972](https://github.com/can1357/oh-my-pi/blob/090e359aa97267de88bd365054685c8234843cd7/packages/tui/CHANGELOG.md).

package/dist/types/autocomplete.d.ts

@@ -6,6 +6,8 @@
  */
 export declare function findLeadingSlashCommandStart(text: string): number | null;
 export declare function findTrailingSlashCommandStart(text: string): number | null;
+/** Extract the live whitespace-delimited or double-quoted `@` file token ending at the cursor. */
+export declare function extractAtFilePrefix(text: string): string | null;
 /**
  * Whether an autocomplete value represents a directory: trailing slash or
  * backslash, optionally followed by a closing quote for quoted paths.

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

@@ -8,6 +8,8 @@ export interface ImageOptions {
     maxWidthCells?: number;
     maxHeightCells?: number;
     filename?: string;
+    /** File the image was read from; its link target. Images without one link to a blob copy of their bytes. */
+    sourcePath?: string;
     /** Shared budget that caps how many inline images render as live graphics. */
     budget?: ImageBudget;
     /**

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

@@ -10,6 +10,43 @@ import type { Component } from "../tui.js";
  * byte-identical to rendering `text`.
  */
 export declare function streamingMarkdownSource(text: string): string;
+/**
+ * Streaming `md` source for a native terminal, minus a still-growing table row:
+ * the unterminated last line when a GFM table (a run of pipe lines holding a
+ * header and its delimiter row, outer pipes optional) sits right above it,
+ * outside any open code fence. GFM continues a table on any non-blank line, so
+ * that line is a row whatever it holds so far. The terminal sizes columns by
+ * every row it gets, so a half-streamed row (an unclosed link shows its whole
+ * URL) would rewrap the table each frame, and TSP cannot ask it to skip one.
+ * The result keeps the newline before the held line, so it is a prefix of
+ * `text` and of the result for every append to it: streaming stays
+ * append-only. Pass untrimmed source: trimming first drops the newline that
+ * marks the last row finished, so that row would be held too.
+ */
+export declare function holdPartialTableRow(text: string): string;
+/**
+ * `text`, one inline run whose end is still streaming, with a trailing open
+ * link or math span closed the way the finished text most likely closes it,
+ * or `undefined` when nothing at its end is open. A link gains its missing
+ * `)` (one per open parenthesis in its destination), so it renders as the
+ * link it becomes instead of literal brackets and URL. A math body is cut back
+ * to its last valid form (a half-typed command, dangling `^`/`_`, or the first
+ * `$` of a `$$` closer dropped, open braces closed) and closed, so the
+ * rendered math grows in place instead of raw LaTeX turning into symbols at
+ * the closer. A `$` body needs a LaTeX character, so a price (`$5 per`) is
+ * never speculated. Only prose is: escaped openers and anything inside a code
+ * span, closed or still being written, stay literal.
+ */
+export declare function speculativeInlineClose(text: string): string | undefined;
+/**
+ * Streaming `md` source for a native terminal with the open link or math span
+ * at its end speculatively closed ({@link speculativeInlineClose}), as the TUI
+ * renders it. Only the last block is read (a span cannot cross a blank line),
+ * and source inside an open code fence is left as it is. Each frame rewrites
+ * only the guessed closers at the end, which the reconciler sends as a small
+ * `splice`.
+ */
+export declare function speculativeStreamingSource(text: string): string;
 /** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
 /**

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

@@ -1,12 +1,3 @@
-/**
- * Content-addressed binary blobs (images) for `image` nodes.
- *
- * `describe()` registers the bytes and puts the returned id in `image.p.blob`;
- * the native backend delivers each referenced blob once per terminal
- * connection (asking the terminal first which it holds, or through its blob
- * cache), else uploads it with verb `b` before the frame that first
- * references it.
- */
 import type { TspProps } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode } from "./node.js";
 export interface NativeBlob {
@@ -26,10 +17,19 @@ export declare function nativeImageNode(bytes: Uint8Array, mime: string, p?: Omi
  * so callers cache the node per payload ({@link NativeImageCache}).
  */
 export declare function base64ImageNode(data: string, mimeType: string, p?: Omit<TspProps<"image">, "blob" | "builtin" | "w" | "h">, key?: string): NativeNode;
-/** `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload changes. */
+/**
+ * Props that make an `image` node open the file at `filePath` (as a `file://` URL, the TSP
+ * open-target form): a click zooms the image in the terminal, and the file opens from its
+ * context menu. Empty without a file.
+ */
+export declare function openableImageProps(filePath: string | undefined): Pick<TspProps<"image">, "href" | "actions">;
+/**
+ * `image` nodes for base64 payloads, one per slot key, rebuilt only when the slot's payload
+ * or the link policy changes. Each opens its file (`sourcePath`, else a blob copy).
+ */
 export declare class NativeImageCache {
     #private;
-    get(key: string, data: string, mimeType: string): NativeNode;
+    get(key: string, data: string, mimeType: string, sourcePath?: string): NativeNode;
 }
 /** The disk file a tool result's image was read from (`read` details `mediaPath`), when it has one. */
 export declare function readMediaPath(details: unknown): string | undefined;

package/dist/types/overlays/job-tree.d.ts

@@ -0,0 +1,50 @@
+import type { Theme } from "../theme/theme.js";
+/** What the tree reads off a job. */
+export interface JobTreeJob {
+    readonly id: string;
+    readonly status: "running" | "completed" | "failed" | "cancelled";
+    readonly startTime: number;
+    /** Registry id of the agent that owns the job; absent or the root id: a top-level job. */
+    readonly ownerId?: string;
+    /** Registry id of the subagent a task job runs: the job heads that agent's subtree. */
+    readonly agentId?: string;
+}
+/** A subagent in the tree, by registry id: an owner of listed jobs, or an ancestor linking one to the root. */
+export interface JobTreeAgent {
+    readonly id: string;
+    readonly parentId?: string;
+}
+/** Where a row sits: its depth and the rails drawn left of it. */
+export interface JobTreePlace {
+    /** 0 for the top level. */
+    readonly depth: number;
+    /** Per enclosing level below the top, whether that level's rail continues past this row. */
+    readonly rails: readonly boolean[];
+    /** Whether this row is the last of its siblings. */
+    readonly last: boolean;
+    /** Whether rows nest under this one. */
+    readonly parent: boolean;
+}
+/** One tree row: a job (a task job also heads its subagent), or a header for a subagent with no listed task job. */
+export type JobTreeRow<J extends JobTreeJob> = (JobTreePlace & {
+    readonly kind: "job";
+    readonly job: J;
+    readonly agent?: JobTreeAgent;
+}) | (JobTreePlace & {
+    readonly kind: "agent";
+    readonly agent: JobTreeAgent;
+});
+/**
+ * `jobs` as tree rows in display order. `rootId` is the viewing agent: its
+ * jobs, ownerless jobs and jobs of owners outside `agents` sit at the top
+ * level, as do agents whose parent is the root or unknown.
+ */
+export declare function buildJobTree<J extends JobTreeJob>(jobs: readonly J[], agents: readonly JobTreeAgent[], rootId: string | undefined): JobTreeRow<J>[];
+/** The connector drawn before a row's head: nothing at the top level, else rails then a branch. */
+export declare function jobTreeGuide(row: JobTreePlace, theme: Theme): string;
+/**
+ * The prefix of lines under a row's head (its label, a wrapped command): the
+ * rails that continue past it, then the rail down to its children or blank,
+ * two columns wide so a top-level leaf's lines indent by two.
+ */
+export declare function jobTreeIndent(row: JobTreePlace, theme: Theme): string;

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

@@ -1,5 +1,6 @@
 import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import { type JobTreeAgent } from "./job-tree.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
     readonly id: string;
@@ -8,13 +9,19 @@ export interface JobsPanelJob {
     readonly label: string;
     readonly startTime: number;
     readonly endTime?: number;
+    /** Registry id of the agent that owns the job. */
+    readonly ownerId?: string;
     /** Registry id of the subagent a task job runs. */
     readonly agentId?: string;
 }
-/** Running and recently settled jobs. */
+/** Running and recently settled jobs of an agent and its subagents. */
 export interface JobsPanelSnapshot {
     readonly running: readonly JobsPanelJob[];
     readonly recent: readonly JobsPanelJob[];
+    /** The agent the sheet is for: its jobs sit at the top level, and only they can be cancelled. */
+    readonly rootId?: string;
+    /** Subagents owning listed jobs, with the ancestors linking them to the root. */
+    readonly agents?: readonly JobTreeAgent[];
 }
 /** What the sheet shows about the selected job beyond its row. */
 export interface JobsPanelDetail {
@@ -35,20 +42,26 @@ export interface JobsSheetSource {
     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;
+    /**
+     * Cancel a running job. Omitted by a read-only sheet (a focused subagent
+     * view, which only watches that agent): it lists the jobs and offers no way
+     * to stop them.
+     */
+    cancel?(id: string): void;
     /** Dismiss the sheet. */
     close(): void;
 }
 /**
  * The jobs pill's sheet: a centred `lg` glass sheet titled Background jobs.
- * A master–detail split (it stacks in a narrow pane): the selectable job list,
- * grouped Running / Recent, beside the selected job's detail — a status pill
- * with live elapsed and Cancel job, its command or task, facts (agent, cwd,
- * live pids, exit code, artifact) and a tail-following output pane. With no
- * jobs it shows an empty state. 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.
+ * A master–detail split (it stacks in a narrow pane): the selectable job tree
+ * beside the selected job's detail — a status pill with live elapsed and
+ * Cancel job, its command or task, facts (agent, cwd, live pids, exit code,
+ * artifact) and a tail-following output pane. With no jobs it shows an empty
+ * state. 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. A source without
+ * `cancel` renders read-only, and a subagent's job never offers Cancel: only
+ * the root's own jobs can be stopped here.
  */
 export declare class JobsSheet implements Component {
     #private;
@@ -60,7 +73,7 @@ export declare class JobsSheet implements Component {
     };
     constructor(source: JobsSheetSource);
     describe(_cx: DescribeContext): NativeNode;
-    /** Rows for a terminal without the native surface: one per job, then the selected job's facts and output tail. */
+    /** Rows for a terminal without the native surface: the job tree, then the selected job's facts and output tail. */
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput(data: string): void;

package/dist/types/prompt/image-references.d.ts

@@ -1,4 +1,5 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
+import type { TspSpan } from "@oh-my-pi/pi-wire";
 /** Materialized image destination returned by the host blob writer. */
 interface ImageBlobResult {
     displayPath: string;
@@ -23,4 +24,25 @@ type ImageBlobWriterSync = (data: Buffer, options?: {
 export declare function imageReferenceHyperlink(label: string, index: number, imageLinks: readonly (string | undefined)[] | undefined, renderLabel: (text: string) => string): string;
 export declare function materializeImageReferenceLinks(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriter): Promise<(string | undefined)[] | undefined>;
 export declare function materializeImageReferenceLinksSync(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriterSync): (string | undefined)[] | undefined;
+/**
+ * Register the host's blob writer that backs links for images without a file of their
+ * own. Returns a disposer that unregisters it unless another writer replaced it since.
+ */
+export declare function setImageBlobWriter(next: ImageBlobWriterSync): () => void;
+/**
+ * Whether transcript images carry links under the current `tui.hyperlinks` policy: a
+ * native surface honours only an explicit `off`, text mode the resolved OSC 8 support.
+ * Renderers caching a linked image key their cache on it.
+ */
+export declare function imageLinksEnabled(): boolean;
+/**
+ * The file a transcript image opens: `sourcePath` when it was read from one, else a
+ * blob copy of its bytes written through the host. Undefined when links are disabled
+ * or no file exists, so a disabled policy never writes blobs.
+ */
+export declare function transcriptImageLink(image: Pick<ImageContent, "data" | "mimeType">, sourcePath?: string): string | undefined;
+/** `text` (an image's placeholder) as an OSC 8 link to the image's file; plain when hyperlinks are off or no file exists. */
+export declare function linkedImageText(text: string, image: Pick<ImageContent, "data" | "mimeType">, sourcePath?: string): string;
+/** Native counterpart of {@link linkedImageText}: a span linking to the image's file when one exists. */
+export declare function linkedImageSpan(text: string, image: Pick<ImageContent, "data" | "mimeType">, sourcePath: string | undefined, s?: string): TspSpan;
 export {};

package/dist/types/render/hyperlink.d.ts

@@ -70,6 +70,8 @@ export declare function urlHyperlinkAlways(url: string, displayText: string): st
  * Non-HTTP(S) or unparsable URLs yield a plain span.
  */
 export declare function urlLinkSpan(target: string, displayText: string, s?: string): TspSpan;
+/** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
+export declare function isNativeLinkEnabled(): boolean;
 /**
  * A native link span to a filesystem path as a plain `file://` URI (the
  * terminal opens it through the system; the location stays in the visible

package/dist/types/render/utils.d.ts

@@ -32,7 +32,7 @@ export interface RenderCache {
     lines: string[];
 }
 /** Build indentation and continuing branches for ancestor levels. */
-export declare function buildTreePrefix(ancestors: boolean[], theme: Theme): string;
+export declare function buildTreePrefix(ancestors: readonly boolean[], theme: Theme): string;
 /** Return the branch glyph for a final or continuing tree item. */
 export declare function getTreeBranch(isLast: boolean, theme: Theme): string;
 /** Return the continuation prefix for subsequent lines of a tree item. */

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

@@ -98,6 +98,7 @@ export interface CompactionBoundaries {
 export declare function computeCompactionBoundaries(compactionSettings: CompactionSettings, contextWindow: number, speculationLeadTokens?: number): CompactionBoundaries | null;
 /** Stable inputs used to cache non-message token estimates. */
 export interface NonMessageTokenSource {
+    readonly model?: Model;
     readonly systemPrompt?: readonly string[];
     readonly agent?: {
         readonly state?: {
@@ -137,6 +138,8 @@ export declare function invalidateToolSchemaMetadata(tools: ToolSchemaSource): v
  * {@link invalidateToolSchemaMetadata} when those inputs change.
  */
 export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, sourceRevision?: number): number;
+/** Count schemas carried on every request, excluding server-side deferred catalogs. */
+export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, sourceRevision?: number): number;
 export declare function computeNonMessageTokens(session: NonMessageTokenSource, tokenizer: Tokenizer, sourceRevision?: number): number;
 /**
  * Shared helper for the four non-message token totals used by

package/dist/types/status-line/startup.d.ts

@@ -1,11 +1,11 @@
 /**
  * Status line for the speculative first frame, before any session exists.
  *
- * InteractiveMode persists {@link StatusLineStartupData} (settings plus the last
- * session's model and thinking state); the next launch renders it through the
- * real {@link StatusLineComponent} as a fresh, unnamed session at the live
- * terminal width. Path and git branch are read live; context usage is reported
- * unknown so the gauge shows the window without a percent.
+ * InteractiveMode persists {@link StatusLineStartupData} (settings plus the
+ * resolved default role model and status inputs); the next launch renders it
+ * through the real {@link StatusLineComponent} as a fresh, unnamed session at
+ * the live terminal width. Path and git branch are read live; context usage is
+ * reported unknown so the gauge shows the window without a percent.
  *
  * @example
  * ```ts ignore
@@ -22,7 +22,7 @@ import type { StatusLineSettings } from "./types.js";
 export interface StatusLineStartupData {
     readonly settings: StatusLineSettings;
     readonly gitEnabled: boolean;
-    /** Model of the last session; the next fresh session usually starts on it too. */
+    /** Model resolved for the next fresh session's default role. */
     readonly model?: Model;
     readonly thinkingLevel?: ThinkingLevel;
     readonly autoThinking: boolean;

package/dist/types/stdin-buffer.d.ts

@@ -61,6 +61,13 @@ export type StdinBufferEventMap = {
 export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     #private;
     constructor(options?: StdinBufferOptions);
+    /**
+     * Whether a bracketed paste has started and its end marker has not arrived.
+     * Terminal skips its per-read DEC 2004 reassertion meanwhile: the host is
+     * evidently in bracketed-paste mode, and a paste delivered one key record
+     * per read would otherwise cost one terminal write per pasted key (#15757).
+     */
+    get pasting(): boolean;
     process(data: string | Buffer): void;
     /**
      * Gate unbracketed raw-paste classification on event-loop responsiveness.

package/dist/types/terminal.d.ts

@@ -181,6 +181,7 @@ export interface Terminal {
     get kittyEnableSequence(): string | null;
     readonly keyboardEnhancementEnterSequence?: string | null;
     readonly keyboardEnhancementExitSequence?: string | null;
+    readonly keyboardEnhancementRestoreSequence?: string | null;
     moveBy(lines: number): void;
     hideCursor(force?: boolean): void;
     showCursor(force?: boolean): void;
@@ -283,9 +284,11 @@ export interface ProcessTerminalOptions {
     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.
+     * console host is certain to answer `CSI ? 9001 h` with win32-input-mode key
+     * records. When false (WSL), the keyboard fallback requests modifyOtherKeys
+     * alongside win32-input-mode, since a WSL pty may not be relayed by a console
+     * host. Defaults to `process.platform === "win32"`; only consulted when
+     * `conpty` is also true.
      */
     nativeWindowsConsole?: boolean;
 }
@@ -298,6 +301,7 @@ export declare class ProcessTerminal implements Terminal {
     get kittyProtocolActive(): boolean;
     get kittyEnableSequence(): string | null;
     get keyboardEnhancementEnterSequence(): string | null;
+    get keyboardEnhancementRestoreSequence(): string | null;
     get keyboardEnhancementExitSequence(): string | null;
     get appearance(): TerminalAppearance | undefined;
     onAppearanceChange(callback: (appearance: TerminalAppearance, requestToken?: TerminalAppearanceRequestToken) => void): void;

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

@@ -20,6 +20,11 @@ export interface EvalCellResult {
     code: string;
     language?: EvalLanguage;
     output: string;
+    /**
+     * `output` without its `display[N]:` JSON sections, which renderers show
+     * from `jsonOutputs` instead. Absent when the cell displayed no JSON.
+     */
+    textOutput?: string;
     status: "pending" | "running" | "complete" | "error";
     durationMs?: number;
     exitCode?: number;

package/dist/types/tools/grouped-file-output.d.ts

@@ -111,9 +111,11 @@ export interface NumberedLine {
  * of consecutive line numbers (`start` = the run's first line, match lines
  * `mark`ed), with a `…` row wherever the numbers jump or an elision marker
  * (`n: null`) sits. No path header: the row or head above names the file.
+ * `wrap` soft-wraps long lines instead of scrolling the block sideways.
  */
 export declare function numberedCode(lines: readonly NumberedLine[], opts?: {
     lang?: string;
+    wrap?: boolean;
 }): NativeNode[];
 /**
  * Describe grouped search output (grep / ast-grep / ast-edit display content)

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

@@ -122,10 +122,11 @@ export declare function readSourceFsPath(details: ReadToolDetails | undefined):
  */
 export declare function readResultIsMarkdown(details: ReadToolDetails | undefined, args: ReadRenderArgs | undefined): boolean;
 /**
- * Read content as numbered `code` (no path header: the head names the file).
- * Numbers come from `lineNumbers` (`displayContent`'s per-line numbers,
- * `null` for an elided block; runs split with `…` between) when they cover
- * every line, else count up from `start`.
+ * Read content as numbered, wrapped `code` (no path header: the head names
+ * the file), matching the ANSI preview's hanging wrap. Numbers come from
+ * `lineNumbers` (`displayContent`'s per-line numbers, `null` for an elided
+ * block; runs split with `…` between) when they cover every line, else count
+ * up from `start`.
  */
 export declare function readContentCode(content: string, start: number, numbers: readonly (number | null)[] | undefined, lang: string | undefined): NativeNode[];
 /** Render file, image, and URL reads in the transcript. */

package/dist/types/tui.d.ts

@@ -348,6 +348,7 @@ export declare class TUI extends Container {
     overlayStack: {
         component: Component;
         options?: OverlayOptions;
+        /** Focus restored after closing; tracks live focus changes beneath an input-less key holder. */
         preFocus: Component | null;
         hidden: boolean;
         /**

package/package.json

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

package/src/autocomplete.ts

@@ -106,6 +106,18 @@ function extractQuotedPrefix(text: string): string | null {
 	return text.slice(quoteStart);
 }
 
+/** Extract the live whitespace-delimited or double-quoted `@` file token ending at the cursor. */
+export function extractAtFilePrefix(text: string): string | null {
+	const quotedPrefix = extractQuotedPrefix(text);
+	if (quotedPrefix?.startsWith('@"')) {
+		return quotedPrefix;
+	}
+
+	const lastDelimiterIndex = findLastDelimiter(text);
+	const tokenStart = lastDelimiterIndex === -1 ? 0 : lastDelimiterIndex + 1;
+	return text[tokenStart] === "@" ? text.slice(tokenStart) : null;
+}
+
 function parsePathPrefix(prefix: string): { rawPrefix: string; isAtPrefix: boolean; isQuotedPrefix: boolean } {
 	if (prefix.startsWith('@"')) {
 		return { rawPrefix: prefix.slice(2), isAtPrefix: true, isQuotedPrefix: true };
@@ -719,7 +731,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		}
 
 		// Check for @ file reference (fuzzy search) - must be after a delimiter or at start
-		const atPrefix = this.#extractAtPrefix(textBeforeCursor);
+		const atPrefix = extractAtFilePrefix(textBeforeCursor);
 		if (atPrefix) {
 			const { rawPrefix, isQuotedPrefix } = parsePathPrefix(atPrefix);
 			// Recursive fuzzy walks rooted outside the project (e.g. `@../`,
@@ -862,7 +874,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 
 		// Check if we're completing a file attachment (prefix starts with "@")
 		if (prefix.startsWith("@")) {
-			const liveAtPrefix = this.#extractAtPrefix(textBeforeCursor);
+			const liveAtPrefix = extractAtFilePrefix(textBeforeCursor);
 			if (liveAtPrefix) {
 				beforePrefix = currentLine.slice(0, cursorCol - liveAtPrefix.length);
 			}
@@ -896,23 +908,6 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		};
 	}
 
-	// Extract @ prefix for fuzzy file suggestions
-	#extractAtPrefix(text: string): string | null {
-		const quotedPrefix = extractQuotedPrefix(text);
-		if (quotedPrefix?.startsWith('@"')) {
-			return quotedPrefix;
-		}
-
-		const lastDelimiterIndex = findLastDelimiter(text);
-		const tokenStart = lastDelimiterIndex === -1 ? 0 : lastDelimiterIndex + 1;
-
-		if (text[tokenStart] === "@") {
-			return text.slice(tokenStart);
-		}
-
-		return null;
-	}
-
 	// Extract a path-like prefix from the text before cursor
 	#extractPathPrefix(text: string, forceExtract: boolean = false): string | null {
 		const quotedPrefix = extractQuotedPrefix(text);

package/src/bracketed-paste.ts

@@ -68,6 +68,7 @@ const DEFAULT_BYTE_LIMIT = 64 * 1024 * 1024;
  */
 export class BracketedPasteHandler {
 	#buffer = "";
+	#bufferBytes = 0;
 	#active = false;
 	readonly #byteLimit: number;
 
@@ -88,7 +89,10 @@ export class BracketedPasteHandler {
 		const start = data.indexOf(PASTE_START);
 		const end = data.indexOf(PASTE_END);
 		if (start !== -1 && (end === -1 || start < end)) {
-			if (!this.#active) this.#buffer = "";
+			if (!this.#active) {
+				this.#buffer = "";
+				this.#bufferBytes = 0;
+			}
 			this.#active = true;
 			// Only strip nested starts before this paste's first end. Later starts
 			// belong to the next paste in `remaining`.
@@ -100,6 +104,7 @@ export class BracketedPasteHandler {
 
 		if (!this.#active) return { handled: false };
 
+		this.#bufferBytes += Buffer.byteLength(data, "utf8");
 		this.#buffer += data;
 
 		const endIndex = this.#buffer.indexOf(PASTE_END);
@@ -108,6 +113,7 @@ export class BracketedPasteHandler {
 			const remaining = this.#buffer.substring(endIndex + PASTE_END.length);
 
 			this.#buffer = "";
+			this.#bufferBytes = 0;
 			this.#active = false;
 
 			return { handled: true, pasteContent, remaining };
@@ -118,9 +124,10 @@ export class BracketedPasteHandler {
 		// neither lost nor held forever, and reset paste mode so subsequent
 		// input recovers. See `StdinBuffer#abortPaste` for the sibling recovery
 		// semantics inside `StdinBuffer`.
-		if (this.#buffer.length > this.#byteLimit) {
+		if (this.#bufferBytes > this.#byteLimit) {
 			const pasteContent = this.#buffer;
 			this.#buffer = "";
+			this.#bufferBytes = 0;
 			this.#active = false;
 			return { handled: true, pasteContent, remaining: "" };
 		}