@oh-my-pi/pi-tui 18.2.9 → 18.2.10

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [18.2.10] - 2026-09-22
+
+### Changed
+
+- Added support for multiple concurrent TUI paint listeners to enable simultaneous session recording and streaming
+- Coalesced status event updates for progress-based operations to reduce TUI render overhead
+
 ## [18.2.9] - 2026-09-22
 
 ### Added

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

@@ -86,6 +86,8 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     setStreamStatus(status: {
         viewers: number;
     } | null): void;
+    /** Toggle the `● REC` badge shown while `/record` captures the screen. */
+    setRecording(recording: boolean): void;
     /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
     setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
     setHookStatus(key: string, text: string | undefined): void;

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

@@ -125,6 +125,8 @@ export interface SegmentContext {
     stream: {
         viewers: number;
     } | null;
+    /** A `/record` capture of this screen is running. */
+    recording: boolean;
     usageStats: {
         input: number;
         output: number;

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

@@ -54,10 +54,7 @@ interface EvalRenderCellArg {
     code?: string;
     title?: string;
 }
-interface EvalRenderArgs {
-    language?: string;
-    code?: string;
-    title?: string;
+interface EvalRenderArgs extends EvalRenderCellArg {
     cells?: EvalRenderCellArg[];
     __partialJson?: string;
 }
@@ -68,11 +65,20 @@ interface EvalRenderContext {
     timeout?: number;
 }
 /**
- * Append or replace a status event. `agent` and `judge_batch` events are
- * progress snapshots keyed by `id`, so they coalesce in place (preserving
- * first-seen order); every other op is a discrete action and simply appends.
- * Keeps the persisted event list bounded even when a subagent or batch emits
- * hundreds of throttled progress ticks.
+ * Coalescing key of a progress-snapshot event: `agent` and `judge_batch`
+ * events keyed by `id`, where only the newest snapshot matters. Discrete
+ * actions (everything else) have no key. Shared by {@link upsertStatusEvent}
+ * and the executors' display collectors so both coalesce identically.
+ */
+export declare function statusEventKey(event: {
+    op: string;
+    [key: string]: unknown;
+}): string | undefined;
+/**
+ * Append or replace a status event. Progress snapshots (see
+ * {@link statusEventKey}) coalesce in place, preserving first-seen order; every
+ * other op is a discrete action and simply appends. Keeps the persisted event
+ * list bounded even when a subagent or batch emits hundreds of progress ticks.
  */
 export declare function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void;
 /** Render eval code cells, structured display output, and progress events. */

package/dist/types/tui.d.ts

@@ -30,9 +30,11 @@ export interface TuiPaint {
     readonly columns: number;
     readonly rows: number;
 }
+/** Observer of completed terminal paints; see {@link TUI.addPaintListener}. */
+export type PaintListener = (paint: TuiPaint) => void;
 export interface TUIOptions {
     renderScheduler?: RenderScheduler;
-    onPaint?: (paint: TuiPaint) => void;
+    onPaint?: PaintListener;
 }
 /** Physical terminal dimensions supplied to a frame provider. */
 export interface ViewportSize {
@@ -290,8 +292,11 @@ export declare class TUI extends Container {
         hidden: boolean;
     }[];
     constructor(terminal: Terminal, showHardwareCursor?: boolean, options?: TUIOptions);
-    /** Install a listener for completed terminal paints. */
-    setPaintListener(listener: ((paint: TuiPaint) => void) | null): void;
+    /**
+     * Observe completed terminal paints; returns the unsubscribe. Independent
+     * observers (live stream publisher, session recorder) coexist.
+     */
+    addPaintListener(listener: PaintListener): () => void;
     /** Install the product-owned bounded frame provider. */
     setFrameProvider(provider: TerminalFrameProvider | undefined): void;
     get fullRedraws(): number;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.2.9",
+	"version": "18.2.10",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": "Stencil Labs, Inc.",
@@ -37,14 +37,14 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.2.9",
-		"@oh-my-pi/pi-agent-core": "18.2.9",
-		"@oh-my-pi/pi-ai": "18.2.9",
-		"@oh-my-pi/pi-catalog": "18.2.9",
-		"@oh-my-pi/pi-natives": "18.2.9",
-		"@oh-my-pi/pi-utils": "18.2.9",
-		"@oh-my-pi/pi-wire": "18.2.9",
-		"@oh-my-pi/snapcompact": "18.2.9"
+		"@oh-my-pi/omptype": "18.2.10",
+		"@oh-my-pi/pi-agent-core": "18.2.10",
+		"@oh-my-pi/pi-ai": "18.2.10",
+		"@oh-my-pi/pi-catalog": "18.2.10",
+		"@oh-my-pi/pi-natives": "18.2.10",
+		"@oh-my-pi/pi-utils": "18.2.10",
+		"@oh-my-pi/pi-wire": "18.2.10",
+		"@oh-my-pi/snapcompact": "18.2.10"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/status-line/component.ts

@@ -529,6 +529,7 @@ export class StatusLineComponent<TSession extends StatusLineSession = StatusLine
 	#vibeWorkerTokenRate: (() => number | null) | null = null;
 	#collabStatus: CollabStatus | null = null;
 	#streamStatus: { viewers: number } | null = null;
+	#recording = false;
 	#focusedAgentId: string | undefined;
 	#activeRepoCache: ActiveRepoCache | undefined;
 
@@ -930,6 +931,13 @@ export class StatusLineComponent<TSession extends StatusLineSession = StatusLine
 		this.#invalidateStatusLineRenderCache();
 	}
 
+	/** Toggle the `● REC` badge shown while `/record` captures the screen. */
+	setRecording(recording: boolean): void {
+		if (this.#recording === recording) return;
+		this.#recording = recording;
+		this.#invalidateStatusLineRenderCache();
+	}
+
 	/** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
 	setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void {
 		this.#onCodexResetFireworks = handler;
@@ -2174,6 +2182,7 @@ export class StatusLineComponent<TSession extends StatusLineSession = StatusLine
 			vim: this.#vimStatus,
 			collab: this.#collabStatus,
 			stream: this.#streamStatus,
+			recording: this.#recording,
 			usageStats,
 			contextPercent,
 			contextTokens,

package/src/status-line/segments.ts

@@ -758,9 +758,11 @@ const collabSegment: StatusLineSegment = {
 const streamSegment: StatusLineSegment = {
 	id: "stream",
 	render(ctx) {
-		if (!ctx.stream) return { content: "", visible: false };
-		const viewers = statusValue(ctx, `${ctx.stream.viewers}`);
-		return { content: theme.fg("thinkingHigh", `● LIVE ${viewers}`), visible: true };
+		const badges: string[] = [];
+		if (ctx.stream) badges.push(`● LIVE ${statusValue(ctx, `${ctx.stream.viewers}`)}`);
+		if (ctx.recording) badges.push("● REC");
+		if (badges.length === 0) return { content: "", visible: false };
+		return { content: theme.fg("thinkingHigh", badges.join(" ")), visible: true };
 	},
 };
 

package/src/status-line/types.ts

@@ -125,6 +125,8 @@ export interface SegmentContext {
 	} | null;
 	collab: CollabStatus | null;
 	stream: { viewers: number } | null;
+	/** A `/record` capture of this screen is running. */
+	recording: boolean;
 	// Cached values for performance (computed once per render)
 	usageStats: {
 		input: number;

package/src/tools/eval-format/index.ts

@@ -7,6 +7,7 @@ export * from "./python";
 
 /** Formats an arbitrary eval-code prefix for display without changing the executed source. */
 export function formatEvalCodeForDisplay(source: string, language: EvalLanguage): string {
+	if (/^\s*%/.test(source)) return source;
 	switch (language) {
 		case "js":
 			return formatJavaScriptForDisplay(source);

package/src/tools/eval.ts

@@ -93,10 +93,7 @@ interface EvalRenderCellArg {
 	title?: string;
 }
 
-interface EvalRenderArgs {
-	language?: string;
-	code?: string;
-	title?: string;
+interface EvalRenderArgs extends EvalRenderCellArg {
 	cells?: EvalRenderCellArg[];
 	__partialJson?: string;
 }
@@ -126,10 +123,9 @@ function getRenderCells(args: EvalRenderArgs | undefined): EvalRenderCell[] {
 	for (const cell of raw) {
 		if (!cell || typeof cell !== "object") continue;
 		const language = normalizeRenderLanguage(typeof cell.language === "string" ? cell.language : undefined);
-		const code = typeof cell.code === "string" ? cell.code : "";
 		out.push({
 			language,
-			code: formatEvalCodeForDisplay(code, language),
+			code: formatEvalCodeForDisplay(cell.code ?? "", language),
 			title: typeof cell.title === "string" ? cell.title : undefined,
 		});
 	}
@@ -139,16 +135,28 @@ function getRenderCells(args: EvalRenderArgs | undefined): EvalRenderCell[] {
 type AgentEventStatus = "pending" | "running" | "completed" | "failed" | "aborted";
 
 /**
- * Append or replace a status event. `agent` and `judge_batch` events are
- * progress snapshots keyed by `id`, so they coalesce in place (preserving
- * first-seen order); every other op is a discrete action and simply appends.
- * Keeps the persisted event list bounded even when a subagent or batch emits
- * hundreds of throttled progress ticks.
+ * Coalescing key of a progress-snapshot event: `agent` and `judge_batch`
+ * events keyed by `id`, where only the newest snapshot matters. Discrete
+ * actions (everything else) have no key. Shared by {@link upsertStatusEvent}
+ * and the executors' display collectors so both coalesce identically.
  */
-export function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void {
+export function statusEventKey(event: { op: string; [key: string]: unknown }): string | undefined {
 	if ((event.op === "agent" || event.op === "judge_batch") && typeof event.id === "string") {
-		const { op, id } = event;
-		const idx = events.findIndex(e => e.op === op && e.id === id);
+		return `${event.op}\0${event.id}`;
+	}
+	return undefined;
+}
+
+/**
+ * Append or replace a status event. Progress snapshots (see
+ * {@link statusEventKey}) coalesce in place, preserving first-seen order; every
+ * other op is a discrete action and simply appends. Keeps the persisted event
+ * list bounded even when a subagent or batch emits hundreds of progress ticks.
+ */
+export function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void {
+	const key = statusEventKey(event);
+	if (key !== undefined) {
+		const idx = events.findIndex(e => statusEventKey(e) === key);
 		if (idx >= 0) {
 			events[idx] = event;
 			return;

package/src/tui.ts

@@ -137,9 +137,12 @@ export interface TuiPaint {
 	readonly rows: number;
 }
 
+/** Observer of completed terminal paints; see {@link TUI.addPaintListener}. */
+export type PaintListener = (paint: TuiPaint) => void;
+
 export interface TUIOptions {
 	renderScheduler?: RenderScheduler;
-	onPaint?: (paint: TuiPaint) => void;
+	onPaint?: PaintListener;
 }
 /** Physical terminal dimensions supplied to a frame provider. */
 export interface ViewportSize {
@@ -789,7 +792,7 @@ export class TUI extends Container {
 	#debugNextWindowTop = 0;
 	#inputListeners = new Set<InputListener>();
 	#startListeners = new Set<StartListener>();
-	#paintListener: ((paint: TuiPaint) => void) | null;
+	#paintListeners = new Set<PaintListener>();
 
 	/** Global callback for debug key (Shift+Ctrl+D). Called before input is forwarded to focused component. */
 	onDebug?: () => void;
@@ -922,7 +925,7 @@ export class TUI extends Container {
 		super();
 		this.terminal = terminal;
 		this.#renderScheduler = options?.renderScheduler ?? DEFAULT_RENDER_SCHEDULER;
-		this.#paintListener = options?.onPaint ?? null;
+		if (options?.onPaint) this.#paintListeners.add(options.onPaint);
 		this.#showHardwareCursor = showHardwareCursor === undefined ? this.#showHardwareCursor : showHardwareCursor;
 		this.#watchdog = new LoopWatchdog();
 	}
@@ -931,9 +934,15 @@ export class TUI extends Container {
 		return mode === "append" || mode === "rebuild" || mode === "preserve" ? mode : "preserve";
 	}
 
-	/** Install a listener for completed terminal paints. */
-	setPaintListener(listener: ((paint: TuiPaint) => void) | null): void {
-		this.#paintListener = listener;
+	/**
+	 * Observe completed terminal paints; returns the unsubscribe. Independent
+	 * observers (live stream publisher, session recorder) coexist.
+	 */
+	addPaintListener(listener: PaintListener): () => void {
+		this.#paintListeners.add(listener);
+		return () => {
+			this.#paintListeners.delete(listener);
+		};
 	}
 
 	/** Install the product-owned bounded frame provider. */
@@ -2636,10 +2645,12 @@ export class TUI extends Container {
 	}
 
 	#notifyPaint(paint: TuiPaint): void {
-		try {
-			this.#paintListener?.(paint);
-		} catch (err) {
-			logger.error("TUI paint listener failed", { err });
+		for (const listener of this.#paintListeners) {
+			try {
+				listener(paint);
+			} catch (err) {
+				logger.error("TUI paint listener failed", { err });
+			}
 		}
 	}