@oh-my-pi/pi-tui 18.13.0 → 18.13.2

package/src/theme/symbols.ts

@@ -38,6 +38,10 @@ export type SymbolKey =
 	// Context gauge boundaries
 	| "context.speculation"
 	| "context.compaction"
+	| "context.content"
+	| "context.messages"
+	| "context.buffer"
+	| "context.free"
 	// Box Drawing - Rounded
 	| "boxRound.topLeft"
 	| "boxRound.topRight"
@@ -419,6 +423,10 @@ const UNICODE_SYMBOLS: SymbolMap = {
 	// Context gauge boundaries
 	"context.speculation": "╎",
 	"context.compaction": "┃",
+	"context.content": "⛁",
+	"context.messages": "⛃",
+	"context.buffer": "⛝",
+	"context.free": "⛶",
 	// Box (rounded)
 	"boxRound.topLeft": "╭",
 	"boxRound.topRight": "╮",
@@ -745,6 +753,10 @@ const NERD_SYMBOLS: SymbolMap = {
 	// Context gauge boundaries — vector intersection starts async speculation; auto-fix applies compaction.
 	"context.speculation": "\u{f055d}",
 	"context.compaction": "\u{f0068}",
+	"context.content": "⛁",
+	"context.messages": "⛃",
+	"context.buffer": "⛝",
+	"context.free": "⛶",
 	// Box Drawing - Rounded (same as unicode)
 	// pick: ╭ | alt: ┌ ┏ ╔
 	"boxRound.topLeft": "╭",
@@ -1203,6 +1215,10 @@ const ASCII_SYMBOLS: SymbolMap = {
 	// Context gauge boundaries
 	"context.speculation": ":",
 	"context.compaction": "|",
+	"context.content": "#",
+	"context.messages": "@",
+	"context.buffer": "x",
+	"context.free": ".",
 	// Box Drawing - Rounded (ASCII fallback)
 	"boxRound.topLeft": "+",
 	"boxRound.topRight": "+",

package/src/tools/ask.ts

@@ -37,6 +37,8 @@ export interface QuestionResult {
 	customInput?: string;
 	/** Optional note attached to the selected answer in the rich ask dialog. */
 	note?: string;
+	/** Label of the option the note is on; unset when it is on the custom answer. */
+	noteOption?: string;
 	/** True when the answer was auto-selected because the dialog timed out. */
 	timedOut?: boolean;
 }
@@ -50,6 +52,8 @@ export interface AskToolDetails {
 	customInput?: string;
 	/** Optional note attached to the selected answer in the rich ask dialog. */
 	note?: string;
+	/** Label of the option the note is on; unset when it is on the custom answer. */
+	noteOption?: string;
 	/** True when the answer was auto-selected because the dialog timed out. */
 	timedOut?: boolean;
 	/** Multi-part question mode */

package/src/tools/bash.ts

@@ -1,5 +1,5 @@
 import type { Component } from "../tui";
-import { getProjectDir } from "@oh-my-pi/pi-utils";
+import { getProjectDir, jsonContainerEnd } from "@oh-my-pi/pi-utils";
 import { highlightCode, type Theme } from "../theme/theme";
 import { renderStatusLine } from "../render/status-line";
 import { framedToolCard, type ToolCardSnapshot } from "../render/tool-card";
@@ -174,28 +174,10 @@ function extractPartialBashEnv(partialJson: string | undefined): Readonly<Record
 	const objectStart = envStart === -1 ? -1 : partialJson.indexOf("{", envStart);
 	if (objectStart !== -1) {
 		// Scan only the env object: stop at its closing brace (outside strings)
-		// so the keys that follow it are not read as env assignments.
-		let objectEnd = partialJson.length;
-		let depth = 0;
-		for (let i = objectStart + 1; i < partialJson.length; i++) {
-			const ch = partialJson.charCodeAt(i);
-			if (ch === 0x22) {
-				// Skip the string body, honoring escapes; an unterminated string runs to the end.
-				for (i++; i < partialJson.length; i++) {
-					const inner = partialJson.charCodeAt(i);
-					if (inner === 0x5c) i++;
-					else if (inner === 0x22) break;
-				}
-			} else if (ch === 0x7b || ch === 0x5b) {
-				depth++;
-			} else if (ch === 0x7d || ch === 0x5d) {
-				if (depth === 0) {
-					objectEnd = i;
-					break;
-				}
-				depth--;
-			}
-		}
+		// so the keys that follow it are not read as env assignments. An
+		// unclosed object (still streaming) runs to the end.
+		const end = jsonContainerEnd(partialJson, objectStart);
+		const objectEnd = end === -1 ? partialJson.length : end - 1;
 		const envBody = partialJson.slice(objectStart + 1, objectEnd);
 		const matcher = /"([A-Za-z_][A-Za-z0-9_]*)"\s*:\s*"((?:\\.|[^"\\])*)(?:"|$)/gu;
 		for (const match of envBody.matchAll(matcher)) {

package/src/tools/fetch.ts

@@ -28,6 +28,7 @@ export interface ReadUrlToolDetails {
 	finalUrl: string;
 	contentType: string;
 	method: string;
+	raw?: boolean;
 	truncated: boolean;
 	notes: string[];
 	meta?: OutputMeta;

package/src/tools/github.ts

@@ -21,6 +21,7 @@ import {
 	type ToolUIColor,
 	type ToolUIStatus,
 	TRUNCATE_LENGTHS,
+	sanitizeDisplayWarning,
 	truncateToWidth as truncateVisualWidth,
 } from "../render/render-utils";
 
@@ -236,6 +237,11 @@ function renderRunBlock(run: GhRunWatchRunDetails, width: number, theme: Theme):
 	return lines;
 }
 
+function formatUnavailableLog(entry: GhRunWatchFailedLogDetails): string {
+	const reason = entry.unavailableReason ? sanitizeDisplayWarning(entry.unavailableReason) : "";
+	return `log tail unavailable${reason ? `: ${reason}` : ""}`;
+}
+
 function renderFailedLogs(
 	failedLogs: GhRunWatchFailedLogDetails[],
 	width: number,
@@ -254,7 +260,7 @@ function renderFailedLogs(
 		);
 
 		if (!entry.available || !entry.tail) {
-			lines.push(theme.fg("dim", "  log tail unavailable"));
+			lines.push(theme.fg("dim", truncateVisualWidth(`  ${formatUnavailableLog(entry)}`, Math.max(8, width))));
 			continue;
 		}
 
@@ -463,7 +469,9 @@ function describeWatch(watch: GhRunWatchViewDetails, isError: boolean): NativeTo
 	const failed = (watch.failedLogs ?? []).flatMap((entry): NativeChild[] => {
 		const context = entry.workflowName ? `${entry.workflowName}  #${entry.runId}` : `run #${entry.runId}`;
 		const title = text([span(plainText(entry.jobName), "error"), span(`  ${plainText(context)}`, "muted")]);
-		if (!entry.available || !entry.tail) return [title, noteText("log tail unavailable")];
+		if (!entry.available || !entry.tail) {
+			return [title, noteText(formatUnavailableLog(entry))];
+		}
 		return [title, ansi(entry.tail, { follow: true, preview: { lines: PREVIEW_LIMITS.OUTPUT_COLLAPSED } })];
 	});
 	return {
@@ -659,6 +667,7 @@ export interface GhRunWatchFailedLogDetails {
 	conclusion?: string;
 	tail?: string;
 	available: boolean;
+	unavailableReason?: string;
 }
 
 /** Live workflow watcher display snapshot. */
@@ -708,6 +717,8 @@ export interface GhFailedJobLog {
 	full?: string;
 	tail?: string;
 	available: boolean;
+	unavailableReason?: string;
+	truncated?: boolean;
 }
 
 /** Choose the terminal conclusion or current job state. */
@@ -764,12 +775,21 @@ export function renderFailedJobLogs(
 		lines.push("");
 		const logText = options.mode === "full" ? entry.full : entry.tail;
 		if (entry.available && logText) {
-			lines.push(options.mode === "full" ? "Full log:" : `Last ${options.tail} log lines:`);
+			lines.push(
+				options.mode === "full"
+					? entry.truncated
+						? "Partial log (capture truncated):"
+						: "Full log:"
+					: entry.truncated
+						? `Last ${options.tail} captured log lines (log capture truncated):`
+						: `Last ${options.tail} log lines:`,
+			);
 			lines.push("```text");
 			lines.push(logText);
 			lines.push("```");
 		} else {
 			lines.push(options.mode === "full" ? "Full log unavailable." : "Log tail unavailable.");
+			if (entry.unavailableReason) pushLine(lines, "Reason", entry.unavailableReason);
 		}
 		lines.push("");
 	}

package/src/tools/read.ts

@@ -62,7 +62,9 @@ export interface ReadToolDetails {
 	 * screenshots, URL reads and other images not backed by a file. Display-only.
 	 */
 	mediaPath?: string;
-	suffixResolution?: { from: string; to: string };
+	suffixResolution?: { from: string; to: string; raw?: boolean };
+	/** Raw source output keeps descriptive diagnostics in details, not in the body. */
+	raw?: boolean;
 	url?: string;
 	finalUrl?: string;
 	contentType?: string;

package/src/tools/wait.ts

@@ -89,6 +89,12 @@ export interface JobSnapshot {
 	 * on collision, else the job id itself. See {@link AsyncJob.agentId}.
 	 */
 	agentUrlId?: string;
+	/**
+	 * Whether this job's turn published `<agentUrlId>.md`. False where the job
+	 * body reported that it wrote none, so `agent://` still holds an earlier
+	 * turn's output; undefined where the body does not report it.
+	 */
+	agentOutputPublished?: boolean;
 }
 
 /** Outcome of cancelling one background job. */

package/src/tui.ts

@@ -926,6 +926,7 @@ export class TUI extends Container {
 	/** True from the end of start() until stop(): the terminal modes start listeners enable are live. */
 	#started = false;
 	#paintListeners = new Set<PaintListener>();
+	#frameWriteListeners = new Set<(data: string) => void>();
 
 	/** Global callback for debug key (Shift+Ctrl+D). Called before input is forwarded to focused component. */
 	onDebug?: () => void;
@@ -1142,6 +1143,14 @@ export class TUI extends Container {
 		};
 	}
 
+	/** Observe actual ANSI frame writes, including transient resize paints; returns the unsubscribe. */
+	addFrameWriteListener(listener: (data: string) => void): () => void {
+		this.#frameWriteListeners.add(listener);
+		return () => {
+			this.#frameWriteListeners.delete(listener);
+		};
+	}
+
 	/** Install the product-owned bounded frame provider. */
 	setFrameProvider(provider: TerminalFrameProvider | undefined): void {
 		this.#frameProvider = provider;
@@ -3414,6 +3423,16 @@ export class TUI extends Container {
 		}
 	}
 
+	#notifyFrameWrite(data: string): void {
+		for (const listener of this.#frameWriteListeners) {
+			try {
+				listener(data);
+			} catch (err) {
+				logger.error("TUI frame write listener failed", { err });
+			}
+		}
+	}
+
 	#renderProviderFrame(width: number, height: number): void {
 		const provider = this.#frameProvider;
 		if (!provider || width <= 0 || height <= 0) return;
@@ -3777,6 +3796,7 @@ export class TUI extends Container {
 			this.terminal.write(this.#rebuildNoticeSequence(width, height));
 		}
 		this.terminal.write(buffer);
+		this.#notifyFrameWrite(buffer);
 		this.#debugPaint = {
 			lines: prepared.lines,
 			windowTop: this.#debugNextWindowTop,
@@ -4580,9 +4600,9 @@ export class TUI extends Container {
 		} else if (hideCursor) {
 			cursorBuffer = "\x1b[?25l";
 		}
-		this.terminal.write(
-			`${this.#paintBeginSequence}${prelude}${full ? "\x1b[H" : ""}${rowsBuffer}${cursorBuffer}${this.#paintEndSequence}`,
-		);
+		const frame = `${this.#paintBeginSequence}${prelude}${full ? "\x1b[H" : ""}${rowsBuffer}${cursorBuffer}${this.#paintEndSequence}`;
+		this.terminal.write(frame);
+		this.#notifyFrameWrite(frame);
 		this.#debugPaint = {
 			lines: prepared.lines,
 			windowTop: 0,