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

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 ## [Unreleased]
 
+## [18.5.1] - 2026-10-03
+
+### Added
+
+- Added native terminal support for submitting explicit composer prompts atomically, preserving displaced drafts and attachments for local recall.
+- Added progress percentages to subagent entries in the agent tree, task, and wait views.
+- Added a `Rebuilding…` indicator for lengthy tmux resize redraws without flashing it for quick updates.
+- Added `writeTerminalSequence()` for sending supported terminal escape sequences through the active terminal output stream, with stdout fallback when no terminal is active.
+
+### Changed
+
+- Clipboard payloads are now represented by their length in `PI_TUI_WRITE_LOG` rather than by their contents.
+
+### Fixed
+
+- Fixed pending clipboard-image attachments being bypassed when subsequent input or native prompts were submitted before loading completed.
+- Improved narrow `/models` layouts by retaining the scope sidebar while simplifying and truncating model rows as needed.
+- Fixed Markdown rendering with themes that do not define their own symbol set; the active theme's symbols are now used as a fallback.
+- Fixed model role assignment showing models that are unavailable for the selected provider.
+- Improved tmux resize, zoom, and rebuild behavior, including smoother coalesced redraws, reduced visual artifacts and extra output, correct transcript restoration after rapid size changes, and preservation of history when panes are resized.
+- Fixed multiline paste on Windows inserting escape-code fragments instead of line breaks, and prevented bracketed-paste markers from appearing in the composer.
+- Fixed terminal notifications occasionally corrupting the screen with stray escape-code fragments during streaming output.
+- Added rendering and notification compatibility for Monstar terminals, including Kitty graphics, hyperlinks, synchronized output, styled underlines, progress keepalives, and Monstar-focused desktop notifications.
+- Fixed Agent Hub transcripts crashing when assistant messages do not include usage or cost data.
+- Fixed idle terminal activity notifications while preserving bracketed-paste recovery during input and rendering.
+- Fixed diff blocks in ask questions losing their layout; additions and removals now retain separate diff highlighting.
+- Fixed duplicate ASCII Plan, Prewalk, and Goal labels in the status line.
+- Improved Markdown rendering for long and streamed messages, including display math, fenced code, reference links, lists, whitespace, emphasis, and line breaks, so completed content no longer shows raw markup, misplaced blank lines, or broken block layout.
+
 ## [18.5.0] - 2026-10-03
 
 ### Breaking Changes
@@ -2988,14 +3017,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 - Crash in `visibleWidth()` and grapheme iteration when encountering undefined code points ([#372](https://github.com/badlogic/pi-mono/pull/372) by [@HACKE-RC](https://github.com/HACKE-RC))
 - ZWJ emoji sequences (rainbow flag, family, etc.) now render with correct width instead of being split into multiple characters ([#369](https://github.com/badlogic/pi-mono/pull/369) by [@nathyong](https://github.com/nathyong))
 
-## [0.29.0] - 2025-12-25
-
-### Added
-
-- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) and the cursor is after a word character, a space is automatically prepended for better readability. Useful when dragging screenshots from macOS. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))
-- **Word navigation for Input component**: Added Ctrl+Left/Right and Alt+Left/Right support for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-- **Full Unicode input**: Input component now accepts Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-
-### Fixed
-
-- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
+Older entries are archived in [packages/tui/CHANGELOG.md@bac7e83b5b0e](https://github.com/can1357/oh-my-pi/blob/bac7e83b5b0eb86c909c17830a6666efc359578b/packages/tui/CHANGELOG.md).

package/dist/types/active-terminal.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ownership of stdout by a started {@link ProcessTerminal}, kept in a leaf
+ * module so writers that `terminal.ts` itself imports (terminal capabilities,
+ * notifications) can route through the active terminal without an import cycle.
+ */
+import type { ProcessTerminal } from "./terminal.js";
+/** The started terminal that owns stdout in this thread, if any. */
+export declare function getActiveTerminal(): ProcessTerminal | null;
+/** Record the terminal that owns stdout (`ProcessTerminal.start`), or release it with `null` (`stop`). */
+export declare function setActiveTerminal(terminal: ProcessTerminal | null): void;
+/** Observe stdout errors through the shared listener. Returns the unregister callback. */
+export declare function registerStdoutErrorHandler(handler: (err: Error) => void): () => void;
+/**
+ * Hand `data` to the active terminal's ordered output path. Returns false when
+ * no terminal in this thread has started. On the main thread that means the
+ * caller owns stdout; a worker thread never sees the main thread's terminal, so
+ * there `false` is not permission to write. Prefer {@link writeTerminalSequence}.
+ */
+export declare function writeThroughActiveTerminal(data: string): boolean;
+/**
+ * Write an out-of-band escape sequence (window title, OSC 52 clipboard,
+ * notification). While a TUI owns stdout, its frames go through an off-thread
+ * pump in chunks that ignore escape boundaries; a direct `process.stdout.write`
+ * can land between two chunks and split a frame's escape sequence, and the host
+ * terminal then prints its tail as text. So the sequence takes the active
+ * terminal's ordered output path, and goes straight to stdout, best-effort, only
+ * when no terminal owns it. A worker thread cannot reach the main thread's
+ * terminal and would write around its pump, so it writes nothing.
+ */
+export declare function writeTerminalSequence(data: string): void;

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

@@ -1,8 +1,10 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
-/** @internal exported for tests — the grown-line-start block-kind gate. */
+/** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
+/** @internal exported for tests — the windowed lexer's first-probe window size. */
+export declare const LEX_WINDOW_BYTES: number;
 /** A hyperlink as the renderer sees it: inline `[text](href)`, `<autolink>`, bare GFM URL, or reference link. */
 export interface MarkdownLink {
     /** Flattened visible label with whitespace collapsed to one row; falls back to `href` when empty. */
@@ -82,7 +84,12 @@ export interface MarkdownTheme {
      * Return null to fall back to fenced code rendering.
      */
     resolveMermaidAscii?: (source: string, maxWidth?: number) => string | null;
-    symbols: SymbolTheme;
+    /**
+     * Glyphs for quote borders, rules, tables and color swatches. Optional so themes
+     * built to the upstream pi-tui `MarkdownTheme` shape (which has no `symbols`)
+     * still render; omitted symbols fall back to the active theme's set.
+     */
+    symbols?: SymbolTheme;
 }
 export declare class Markdown implements Component {
     #private;
@@ -101,8 +108,10 @@ export declare class Markdown implements Component {
     describe(_cx: DescribeContext): NativeNode;
     /**
      * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary. Only meaningful while streaming (transient
-     * render cache on); grows monotonically under append-only `setText`.
+     * Markdown block boundary that no append can move: it stops in front of a
+     * display-math opener whose block an append could still close. Only
+     * meaningful while streaming (transient render cache on); grows
+     * monotonically under append-only `setText`.
      */
     getLastRenderStableText(): string;
     get transientRenderCache(): boolean;

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

@@ -29,6 +29,7 @@ export declare function encodeTspJson(verb: TspVerb, value: unknown, params?: Ts
  * 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. `"undo"`
  * says omp applies `undo` events, so the terminal may turn ⌃Z in a field into one.
+ * `"send"` accepts an explicit prompt for a live composer without simulating keys.
  */
 export declare function encodeTspHelloQuery(version?: string): string;
 /** One decoded APC message: verb, parameters and raw body. */

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

@@ -135,6 +135,12 @@ export type NativeUiEvent = {
  | {
     readonly type: "undo";
     readonly key: string;
+}
+/** Submit an explicit prompt through the composer's normal path, preserving the previous draft for recall. */
+ | {
+    readonly type: "send";
+    readonly key: string;
+    readonly text: string;
 };
 /**
  * A primitive edit the terminal made over its own text selection (cut,

package/dist/types/overlays/hub-frame.d.ts

@@ -61,7 +61,10 @@ export declare class HubFrame {
     constructor(title: string, sidebarBounds: {
         min: number;
         max: number;
-    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[]);
+    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[], options?: {
+        bodyMinWidth?: number;
+        preserveSidebar?: boolean;
+    });
     /** Invalidate the composed layout. */
     invalidate(): void;
     /** Measure labels and annotations within this hub's sidebar width bounds. */

package/dist/types/prompt/custom-editor.d.ts

@@ -237,7 +237,8 @@ export declare class CustomEditor extends Editor {
      * Clicks on the composer's controls take the same paths as their keys: ⇧⇥,
      * ⏎ and Esc; the viewing header's links (`focus:<id>`) go to the host,
      * the status facts' clicks (`status.*`) to their source. Selection edits
-     * go to the buffer.
+     * go to the buffer; `send` submits its own prompt after saving the old draft
+     * for recall and waiting for in-flight clipboard work.
      */
     handleNativeEvent(event: NativeUiEvent): void;
     onEscape?: () => void;

package/dist/types/terminal-capabilities.d.ts

@@ -11,7 +11,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;

package/dist/types/terminal.d.ts

@@ -1,4 +1,5 @@
 import { type TspHello } from "./native/encode.js";
+export { writeTerminalSequence, writeThroughActiveTerminal } from "./active-terminal.js";
 /**
  * Split `data` into chunks whose encoded UTF-8 byte length is no greater than
  * `maxChunkBytes`, preferring a line boundary (`\n`) as the cut point so
@@ -69,16 +70,6 @@ export declare class StdoutStallWatchdog {
 }
 /** Record alternate-screen state (called by the TUI on `?1049h`/`?1049l` writes). */
 export declare function setAltScreenActive(active: boolean): void;
-/**
- * Route an out-of-band escape sequence (e.g. an OSC title update) through the
- * active terminal's output path. While a TUI owns stdout, frame paints go
- * through the off-thread write pump and can split across multiple write(2)
- * calls; a direct main-thread `process.stdout.write` can land between two of
- * them — mid escape sequence — and the host terminal then prints the payload
- * as literal text at the cursor position. Returns false when no terminal has
- * started, in which case the caller owns stdout and may write directly.
- */
-export declare function writeThroughActiveTerminal(data: string): boolean;
 /**
  * Emergency terminal restore - call this from signal/crash handlers
  * Resets terminal state without requiring access to the ProcessTerminal instance

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

@@ -4,8 +4,13 @@ import { type OutputMeta } from "./output-meta.js";
 import type { NativeToolView, RenderResultContextOptions, RenderResultOptions } from "./renderer.js";
 /** Default collapsed shell output preview height. */
 export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
-/** LLM-facing footer appended when a tool call becomes a background job. */
-export declare function formatBackgroundNotice(jobId: string): string;
+/**
+ * LLM-facing footer appended when a tool call becomes a background job. It states the job's kill
+ * deadline (`timeoutSec`, `undefined` when disabled) so the model knows the job will die at it before
+ * it waits on the result. The deadline counts the job's whole run time, not time left from now: an
+ * auto-backgrounded call has already spent its foreground wait.
+ */
+export declare function formatBackgroundNotice(jobId: string, timeoutSec: number | undefined): string;
 /** Shell execution metadata used by transcript rendering. */
 export interface BashToolDetails {
     meta?: OutputMeta;

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

@@ -35,3 +35,15 @@ export declare class Win32InputModeDecoder {
      */
     decodePaste(content: string): string;
 }
+/**
+ * Restores paste delimiters that a Windows console host emitted as individual
+ * win32-input-mode key records before StdinBuffer searches for the delimiters.
+ * Non-matching records remain untouched for normal key and paste decoding.
+ */
+export declare class Win32PasteMarkerNormalizer {
+    #private;
+    constructor(onInput: (data: string) => void);
+    process(data: string): void;
+    /** Release an incomplete marker as its original key records. */
+    flush(): void;
+}

package/package.json

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

package/src/active-terminal.ts

@@ -0,0 +1,80 @@
+/**
+ * Ownership of stdout by a started {@link ProcessTerminal}, kept in a leaf
+ * module so writers that `terminal.ts` itself imports (terminal capabilities,
+ * notifications) can route through the active terminal without an import cycle.
+ */
+import type { ProcessTerminal } from "./terminal";
+
+// The started terminal that owns stdout in this thread; also consulted by the
+// emergency restore on crash.
+let activeTerminal: ProcessTerminal | null = null;
+
+/** The started terminal that owns stdout in this thread, if any. */
+export function getActiveTerminal(): ProcessTerminal | null {
+	return activeTerminal;
+}
+
+/** Record the terminal that owns stdout (`ProcessTerminal.start`), or release it with `null` (`stop`). */
+export function setActiveTerminal(terminal: ProcessTerminal | null): void {
+	activeTerminal = terminal;
+}
+
+const stdoutErrorHandlers = new Set<(err: Error) => void>();
+let stdoutErrorListenerInstalled = false;
+
+function onStdoutError(err: Error): void {
+	for (const handler of stdoutErrorHandlers) handler(err);
+}
+
+/**
+ * Install the one shared `process.stdout` `error` listener. Its presence alone
+ * keeps a stdout error (EPIPE on a closed pipe, EIO on a revoked PTY) from
+ * crashing the process as an unhandled `error` event.
+ */
+function installStdoutErrorListener(): void {
+	if (stdoutErrorListenerInstalled) return;
+	process.stdout.on("error", onStdoutError);
+	stdoutErrorListenerInstalled = true;
+}
+
+/** Observe stdout errors through the shared listener. Returns the unregister callback. */
+export function registerStdoutErrorHandler(handler: (err: Error) => void): () => void {
+	stdoutErrorHandlers.add(handler);
+	installStdoutErrorListener();
+	return () => {
+		stdoutErrorHandlers.delete(handler);
+	};
+}
+
+/**
+ * Hand `data` to the active terminal's ordered output path. Returns false when
+ * no terminal in this thread has started. On the main thread that means the
+ * caller owns stdout; a worker thread never sees the main thread's terminal, so
+ * there `false` is not permission to write. Prefer {@link writeTerminalSequence}.
+ */
+export function writeThroughActiveTerminal(data: string): boolean {
+	if (!activeTerminal) return false;
+	activeTerminal.write(data);
+	return true;
+}
+
+/**
+ * Write an out-of-band escape sequence (window title, OSC 52 clipboard,
+ * notification). While a TUI owns stdout, its frames go through an off-thread
+ * pump in chunks that ignore escape boundaries; a direct `process.stdout.write`
+ * can land between two chunks and split a frame's escape sequence, and the host
+ * terminal then prints its tail as text. So the sequence takes the active
+ * terminal's ordered output path, and goes straight to stdout, best-effort, only
+ * when no terminal owns it. A worker thread cannot reach the main thread's
+ * terminal and would write around its pump, so it writes nothing.
+ */
+export function writeTerminalSequence(data: string): void {
+	if (!Bun.isMainThread) return;
+	if (writeThroughActiveTerminal(data)) return;
+	installStdoutErrorListener();
+	try {
+		process.stdout.write(data);
+	} catch {
+		// Best-effort: a closed stdout must not fail the caller.
+	}
+}

package/src/bracketed-paste.ts

@@ -85,10 +85,17 @@ export class BracketedPasteHandler {
 	 *          buffer); omitted when still buffering.
 	 */
 	process(data: string): PasteResult {
-		if (data.includes(PASTE_START)) {
+		const start = data.indexOf(PASTE_START);
+		const end = data.indexOf(PASTE_END);
+		if (start !== -1 && (end === -1 || start < end)) {
+			if (!this.#active) this.#buffer = "";
 			this.#active = true;
-			this.#buffer = "";
-			data = data.replace(PASTE_START, "");
+			// Only strip nested starts before this paste's first end. Later starts
+			// belong to the next paste in `remaining`.
+			data =
+				end === -1
+					? data.replaceAll(PASTE_START, "")
+					: data.slice(0, end).replaceAll(PASTE_START, "") + data.slice(end);
 		}
 
 		if (!this.#active) return { handled: false };