pi-cc-extensions 0.8.56 → 0.8.58

package/extensions/config/config.ts

@@ -1,16 +1,40 @@
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
-import {
-	DEFAULT_TOOL_DISPLAY_CONFIG,
-	type DiffIndicatorMode,
-	type DiffViewMode,
-	type ToolDisplayConfig,
-} from "../renderer/tool/diff/index.ts";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
 export type CompactStyleMode = "on" | "compact" | "off";
 
+// ── diff 显示配置：作为配置 schema 的一部分由 config 层拥有 ──
+// renderer（diff）从 config 导入并 re-export，避免 config → renderer 的反向依赖。
+
+export type DiffViewMode = "auto" | "split" | "unified";
+export type DiffIndicatorMode = "bars" | "classic" | "none";
+
+export interface ToolDisplayConfig {
+	diffViewMode: DiffViewMode;
+	diffIndicatorMode: DiffIndicatorMode;
+	diffSplitMinWidth: number;
+	diffCollapsedLines: number;
+	diffWordWrap: boolean;
+	expandedPreviewMaxLines: number;
+}
+
+export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
+	diffViewMode: "auto",
+	diffIndicatorMode: "bars",
+	diffSplitMinWidth: 120,
+	/** Collapsed tool/diff body: ~half a typical terminal after chrome. */
+	diffCollapsedLines: 24,
+	diffWordWrap: true,
+	/**
+	 * Expanded tool/diff body cap. 40 ≈ one screen of content after title,
+	 * Input section, editor, and status — keeps the TUI compact.
+	 * Raise via /ccstyle → Diff → Expanded max lines when reviewing large dumps.
+	 */
+	expandedPreviewMaxLines: 40,
+};
+
 export type Config = {
 	mode: CompactStyleMode;
 	excludeRenderers: string[];
@@ -216,7 +240,8 @@ export function formatConfigStatus(source: Config = config): string {
 	].join(" · ");
 }
 
-export let config: Config = loadConfig();
+/** 进程内唯一的活动配置对象。读取直接用 `config.xxx`；写入必须走 `updateConfig`。 */
+export const config: Config = loadConfig();
 
 function loadConfig(): Config {
 	try {
@@ -247,7 +272,13 @@ export function saveConfig() {
 	writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
 }
 
-/** 整体替换配置（default export 的 configOverride 注入路径；导入绑定不可重新赋值）。 */
+/** 运行时配置写入的唯一入口：合并 + 规范化 + 持久化。 */
+export function updateConfig(partial: Partial<Config>): void {
+	Object.assign(config, normalizeConfig({ ...config, ...partial }));
+	saveConfig();
+}
+
+/** 整体替换配置（default export 的 configOverride 注入路径；就地覆盖，不持久化）。 */
 export function setConfig(next: Config): void {
-	config = next;
+	Object.assign(config, next);
 }

package/extensions/config/panel.ts

@@ -9,7 +9,6 @@ import { Input, SettingsList, matchesKey, truncateToWidth } from "@earendil-work
 import type { CompactThinkingController } from "../feature/compact-thinking.ts";
 import { applyStartupHeader } from "../feature/shell/startup-header.ts";
 import type { ToolGroupingHooks } from "../renderer/tool/grouping.ts";
-import type { DiffIndicatorMode, DiffViewMode } from "../renderer/tool/diff/index.ts";
 import {
 	config,
 	DEFAULT_CONFIG,
@@ -23,11 +22,14 @@ import {
 	getCompactThinkingConfig,
 	pickPositiveInt,
 	pickPositiveNumber,
-	saveConfig,
 	SCROLL_STEP_LINES_VALUES,
 	THINKING_ANIMATION_INTERVAL_VALUES,
 	THINKING_PREVIEW_LINES_VALUES,
+	updateConfig,
 	type CompactStyleMode,
+	type Config,
+	type DiffIndicatorMode,
+	type DiffViewMode,
 } from "./config.ts";
 
 /** renderer 注入的渲染副作用，面板自身不触碰渲染状态。 */
@@ -117,8 +119,7 @@ function buildExcludeRenderersSubmenu(
 			const excluded = new Set(config.excludeRenderers);
 			if (value === "exclude") excluded.add(id);
 			else excluded.delete(id);
-			config.excludeRenderers = [...excluded].sort((a, b) => a.localeCompare(b));
-			saveConfig();
+			updateConfig({ excludeRenderers: [...excluded].sort((a, b) => a.localeCompare(b)) });
 			onLiveChange();
 		},
 		() => onClose(),
@@ -414,9 +415,8 @@ export async function showCcstylePanel(
 			// 额外功能开关：字段名与配置布尔字段一一对应，切换后重启生效。
 			const featureToggle = featureToggles[id];
 			if (featureToggle) {
-				(config as unknown as Record<string, boolean>)[id] = value === "on";
+				updateConfig({ [id]: value === "on" } as Partial<Config>);
 				featureToggle.apply(value === "on");
-				saveConfig();
 				ctx.ui.notify(`Updated ${id}: ${value} (next restart)`, "info");
 				return;
 			}
@@ -434,62 +434,57 @@ export async function showCcstylePanel(
 					excludeSetting.description = excludeRenderersDescription(config.excludeRenderers);
 					return;
 				case "diffViewMode":
-					config.diffViewMode = value as DiffViewMode;
+					updateConfig({ diffViewMode: value as DiffViewMode });
 					diffViewSetting.description = diffViewModeDescription(config.diffViewMode);
 					break;
 				case "diffIndicatorMode":
-					config.diffIndicatorMode = value as DiffIndicatorMode;
+					updateConfig({ diffIndicatorMode: value as DiffIndicatorMode });
 					diffIndicatorSetting.description = diffIndicatorDescription(config.diffIndicatorMode);
 					break;
 				case "diffSplitMinWidth":
-					config.diffSplitMinWidth = pickPositiveInt(
-						value,
-						DEFAULT_CONFIG.diffSplitMinWidth,
-						40,
-						300,
-					);
+					updateConfig({
+						diffSplitMinWidth: pickPositiveInt(value, DEFAULT_CONFIG.diffSplitMinWidth, 40, 300),
+					});
 					diffSplitSetting.currentValue = String(config.diffSplitMinWidth);
 					break;
 				case "diffCollapsedLines":
-					config.diffCollapsedLines = pickPositiveInt(
-						value,
-						DEFAULT_CONFIG.diffCollapsedLines,
-						1,
-						500,
-					);
+					updateConfig({
+						diffCollapsedLines: pickPositiveInt(value, DEFAULT_CONFIG.diffCollapsedLines, 1, 500),
+					});
 					diffCollapsedSetting.currentValue = String(config.diffCollapsedLines);
 					break;
 				case "diffWordWrap":
-					config.diffWordWrap = value === "on";
+					updateConfig({ diffWordWrap: value === "on" });
 					diffWordWrapSetting.description = config.diffWordWrap
 						? "Long diff lines wrap within the panel width."
 						: "Long diff lines are truncated to the panel width.";
 					break;
 				case "expandedPreviewMaxLines":
-					config.expandedPreviewMaxLines = pickPositiveInt(
-						value,
-						DEFAULT_CONFIG.expandedPreviewMaxLines,
-						10,
-						50_000,
-					);
+					updateConfig({
+						expandedPreviewMaxLines: pickPositiveInt(
+							value,
+							DEFAULT_CONFIG.expandedPreviewMaxLines,
+							10,
+							50_000,
+						),
+					});
 					expandedMaxSetting.currentValue = String(config.expandedPreviewMaxLines);
 					break;
 				case "useSummaryTitlesAsThinkingTitle":
-					config.useSummaryTitlesAsThinkingTitle = value === "on";
+					updateConfig({ useSummaryTitlesAsThinkingTitle: value === "on" });
 					break;
 				case "previewLines":
-					config.previewLines = pickPositiveInt(value, DEFAULT_CONFIG.previewLines, 0);
+					updateConfig({ previewLines: pickPositiveInt(value, DEFAULT_CONFIG.previewLines, 0) });
 					thinkingPreviewSetting.currentValue = String(config.previewLines);
 					break;
 				case "animationIntervalMs":
-					config.animationIntervalMs = pickPositiveNumber(
-						value,
-						DEFAULT_CONFIG.animationIntervalMs,
-					);
+					updateConfig({
+						animationIntervalMs: pickPositiveNumber(value, DEFAULT_CONFIG.animationIntervalMs),
+					});
 					thinkingAnimationSetting.currentValue = String(config.animationIntervalMs);
 					break;
 				case "showStartupHeader":
-					config.showStartupHeader = value === "on";
+					updateConfig({ showStartupHeader: value === "on" });
 					startupHeaderSetting.description = config.showStartupHeader
 						? "Show the custom startup header (logo + tips) on new sessions."
 						: "Use Pi's native startup header instead.";
@@ -497,13 +492,14 @@ export async function showCcstylePanel(
 					applyStartupHeader(ctx);
 					break;
 				case "scrollStepLines":
-					config.scrollStepLines = pickPositiveInt(value, DEFAULT_CONFIG.scrollStepLines, 1, 50);
+					updateConfig({
+						scrollStepLines: pickPositiveInt(value, DEFAULT_CONFIG.scrollStepLines, 1, 50),
+					});
 					scrollStepSetting.currentValue = String(config.scrollStepLines);
 					break;
 				default:
 					return;
 			}
-			saveConfig();
 			compactThinking?.updateConfig(getCompactThinkingConfig());
 			hooks.refreshCurrentTranscript(ctx);
 			ctx.ui.notify(`Updated ${id}: ${value}`, "info");

package/extensions/feature/compact-thinking.ts

@@ -19,6 +19,12 @@ import {
 	styleCompactThinkingText,
 } from "../renderer/compact-mode.ts";
 import { refreshMountedTranscript } from "../renderer/transcript-refresh.ts";
+import {
+	COMPACT_THINKING_OWNER,
+	COMPACT_THINKING_PATCH_KEY,
+	patchRegistry,
+	PROTOTYPE_ORIGINAL_KEY,
+} from "../utils/patch-keys.ts";
 // 保持导出兼容：渲染函数已并入 renderer/compact-mode.ts，这里 re-export。
 export { animateCompactThinkingText, formatThoughtDuration, styleCompactThinkingText };
 
@@ -106,8 +112,6 @@ const config: CompactThinkingConfig = {
 };
 
 const DURATION_ENTRY_TYPE = "compact-thinking-duration";
-const COMPACT_THINKING_PATCH_KEY = Symbol.for("pi.ccstyle.compact-thinking-update");
-const PROTOTYPE_ORIGINAL_KEY = Symbol.for("pi.ccstyle.prototype-original");
 
 /** 当前激活 session 的只读查询委托（compact 渲染层使用）。 */
 type ThinkingDurationQuery = (messageTimestamp: number) => number | undefined;
@@ -747,8 +751,6 @@ type CompactThinkingOwner = {
 	stop(event?: any, ctx?: any): void;
 };
 
-const COMPACT_THINKING_OWNER = Symbol.for("pi.ccstyle.compact-thinking-owner");
-
 type UpstreamHandler = (event: any, ctx: any) => void;
 
 export function installCompactThinking(
@@ -756,10 +758,6 @@ export function installCompactThinking(
 	initialConfig: CompactThinkingConfig,
 ): CompactThinkingController {
 	const owner = {};
-	const host = globalThis as typeof globalThis & {
-		[COMPACT_THINKING_OWNER]?: CompactThinkingOwner;
-	};
-
 	let session: { event: any; ctx: any } | undefined;
 	let active = false;
 	// Stable pi.on wrappers delegate here so activate/reload never double-binds.
@@ -795,7 +793,8 @@ export function installCompactThinking(
 		const shutdown = delegates.get("session_shutdown");
 		delegates.clear();
 		shutdown?.(event ?? session?.event ?? {}, ctx ?? session?.ctx ?? { mode: "rpc", ui: {} });
-		if (host[COMPACT_THINKING_OWNER]?.owner === owner) delete host[COMPACT_THINKING_OWNER];
+		if (patchRegistry.get<CompactThinkingOwner>(COMPACT_THINKING_OWNER)?.owner === owner)
+			patchRegistry.delete(COMPACT_THINKING_OWNER);
 	};
 
 	const activate = (event: any, ctx: any) => {
@@ -803,7 +802,7 @@ export function installCompactThinking(
 		// TUI prototype patch or kill its thinking ticker.
 		if (ctx?.mode !== "tui") return;
 
-		host[COMPACT_THINKING_OWNER]?.stop(event, ctx);
+		patchRegistry.get<CompactThinkingOwner>(COMPACT_THINKING_OWNER)?.stop(event, ctx);
 		session = { event, ctx };
 
 		// 配置统一由 claude-code-style 管控，加载时覆盖库默认值。
@@ -828,7 +827,7 @@ export function installCompactThinking(
 		} as unknown as ExtensionAPI);
 
 		active = true;
-		host[COMPACT_THINKING_OWNER] = { owner, stop };
+		patchRegistry.install(COMPACT_THINKING_OWNER, { owner, stop });
 	};
 
 	pi.on("session_start", (event, ctx) => {
@@ -836,7 +835,8 @@ export function installCompactThinking(
 		activate(event, ctx);
 	});
 	pi.on("session_shutdown", (event, ctx) => {
-		if (host[COMPACT_THINKING_OWNER]?.owner === owner) stop(event, ctx);
+		if (patchRegistry.get<CompactThinkingOwner>(COMPACT_THINKING_OWNER)?.owner === owner)
+			stop(event, ctx);
 		session = undefined;
 	});
 

package/extensions/feature/context.ts

@@ -1,10 +1,14 @@
 import {
+	type BuildSystemPromptOptions,
 	type ExtensionAPI,
 	type ExtensionCommandContext,
+	type ToolInfo,
 	estimateTokens,
 	getMarkdownTheme,
 } from "@earendil-works/pi-coding-agent";
-import { Key, Markdown, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { Key, Markdown, matchesKey, visibleWidth } from "@earendil-works/pi-tui";
+import { mouseBaseButton, parseSgrMousePacket } from "../utils/sgr-mouse.ts";
+import { padLine } from "../utils/format.ts";
 
 export type ContextPart = {
 	label: string;
@@ -189,10 +193,6 @@ export async function showTextPreview(
 						escHitbox = escCloseHitbox({ left: overlayLeft, top: overlayTop, width });
 						const visible = wrapped.slice(scrollOffset, scrollOffset + pageSize);
 						const border = (text: string) => theme.fg("border", text);
-						const padLine = (text: string, lineWidth = inner): string => {
-							const truncated = truncateToWidth(text, lineWidth, "…");
-							return truncated + " ".repeat(Math.max(0, lineWidth - visibleWidth(truncated)));
-						};
 						const scrollable = totalLines > pageSize;
 						const thumbSize = scrollable
 							? Math.max(1, Math.floor((pageSize * pageSize) / totalLines))
@@ -231,7 +231,7 @@ export async function showTextPreview(
 							`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
 							...bodyRows,
 							`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
-							`${border("│")}${padLine(theme.fg("dim", ` ${status}`))}${border("│")}`,
+							`${border("│")}${padLine(theme.fg("dim", ` ${status}`), inner)}${border("│")}`,
 							border(`╰${"─".repeat(inner)}╯`),
 						];
 					},
@@ -253,40 +253,12 @@ export async function showTextPreview(
 	}
 }
 
-type SgrMousePacket = {
-	code: number;
-	col: number;
-	row: number;
-	final: "M" | "m";
-};
-
-function parseSgrMousePacket(data: string): SgrMousePacket | null {
-	const match = data.match(/^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/);
-	if (!match) return null;
-	return {
-		code: Number(match[1]),
-		col: Number(match[2]),
-		row: Number(match[3]),
-		final: match[4] as "M" | "m",
-	};
-}
-
-function mouseBaseButton(code: number): number {
-	return code & ~(4 | 8 | 16 | 32);
-}
-
 const tokenEstimate = (value: unknown): number => {
 	if (!value) return 0;
 	const text = typeof value === "string" ? value : JSON.stringify(value);
 	return Math.max(0, Math.ceil(text.length / 4));
 };
 
-type ToolPreviewInfo = {
-	name: string;
-	description?: string;
-	promptGuidelines?: string[];
-};
-
 export function scaleParts(parts: ContextPart[], target: number): ContextPart[] {
 	const estimated = parts.reduce((sum, part) => sum + part.tokens, 0);
 	if (estimated === 0 || target <= 0) return parts;
@@ -309,22 +281,9 @@ export function formatTokens(tokens: number): string {
 	return `${Math.round(tokens / 1_000)}k`;
 }
 
-type SystemPromptOptions = {
-	contextFiles?: Array<{ path: string; content: string }>;
-	skills?: Array<{
-		name: string;
-		description?: string;
-		filePath?: string;
-		disableModelInvocation?: boolean;
-	}>;
-	selectedTools?: string[];
-	toolSnippets?: Record<string, string>;
-	promptGuidelines?: string[];
-};
-
 type ContextBreakdown = {
 	parts: ContextPart[];
-	options: SystemPromptOptions;
+	options: BuildSystemPromptOptions;
 	systemPrompt: string;
 };
 
@@ -333,7 +292,7 @@ type ContextBreakdown = {
  * so the /context UI does not re-fetch or re-stringify the same sources.
  */
 function collectContextBreakdown(ctx: ExtensionCommandContext): ContextBreakdown {
-	const options = (ctx.getSystemPromptOptions?.() ?? {}) as SystemPromptOptions;
+	const options = (ctx.getSystemPromptOptions?.() ?? {}) as BuildSystemPromptOptions;
 	const systemPrompt = typeof ctx.getSystemPrompt === "function" ? ctx.getSystemPrompt() : "";
 
 	const contextFileTokens = (options.contextFiles ?? []).reduce(
@@ -410,8 +369,8 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 			}
 
 			const options = breakdown.options;
-			const toolByName = new Map<string, ToolPreviewInfo>(
-				(pi.getAllTools() as ToolPreviewInfo[]).map((tool) => [tool.name, tool] as const),
+			const toolByName = new Map<string, ToolInfo>(
+				pi.getAllTools().map((tool) => [tool.name, tool] as const),
 			);
 			const toolContent = (options.selectedTools ?? []).map((name) => {
 				const tool = toolByName.get(name);
@@ -490,11 +449,6 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 						}> = [];
 						let escHitbox: { row: number; startCol: number; endCol: number } | undefined;
 
-						const padLine = (text: string, width: number): string => {
-							const truncated = truncateToWidth(text, width, "…");
-							return truncated + " ".repeat(Math.max(0, width - visibleWidth(truncated)));
-						};
-
 						return {
 							invalidate() {},
 							handleInput(data: string) {

package/extensions/feature/reference/index.ts

@@ -109,7 +109,7 @@ function trackSubagentFromEvent(data: unknown): void {
 	// Started event — create new record
 	const agent = typeof event.agent === "string" ? event.agent : "";
 	const cwd = typeof event.cwd === "string" ? event.cwd : "";
-	const startedAt = typeof event.startedAt === "number" ? (event.startedAt as number) : Date.now();
+	const startedAt = typeof event.startedAt === "number" ? event.startedAt : Date.now();
 	liveSubagentRecords.set(runId, {
 		runId,
 		sessionId,
@@ -122,7 +122,9 @@ function trackSubagentFromEvent(data: unknown): void {
 
 function getSubagentManager(): SubagentManager | undefined {
 	// Try the global manager first (future-proof), fall back to local records.
-	const manager = (globalThis as any)[SUBAGENT_MANAGER_KEY] as SubagentManager | undefined;
+	const manager = (globalThis as Record<PropertyKey, unknown>)[SUBAGENT_MANAGER_KEY] as
+		| SubagentManager
+		| undefined;
 	if (manager && typeof manager.getRecord === "function") return manager;
 	// If no global manager, use our local tracking.
 	if (liveSubagentRecords.size === 0) return undefined;

package/extensions/feature/shell/startup-header.ts

@@ -295,7 +295,7 @@ export function applyStartupHeader(ctx: any): void {
 		ctx.ui.setHeader(undefined);
 		return;
 	}
-	ctx.ui.setHeader((_tui, theme) => ({
+	ctx.ui.setHeader((_tui: unknown, theme: any) => ({
 		render(width: number): string[] {
 			return renderHeaderLines(width, theme);
 		},

package/extensions/feature/shell/working-message.ts

@@ -9,21 +9,24 @@ function formatCount(value: number): string {
 	return new Intl.NumberFormat("en-US").format(value);
 }
 
-function estimateTextLength(message: any): number {
-	if (!Array.isArray(message?.content)) return 0;
-	return message.content.reduce((sum: number, block: any) => {
-		if (block?.type === "text" && typeof block.text === "string") return sum + block.text.length;
-		if (block?.type === "thinking" && block.thinkingSignature?.body)
-			return sum + (block.thinkingSignature.body as string).length;
-		return sum;
-	}, 0);
-}
-
-function textBlockLengths(message: any): number[] {
-	if (!Array.isArray(message?.content)) return [];
+type ContentBlock = {
+	type?: unknown;
+	text?: unknown;
+	thinkingSignature?: { body?: unknown };
+};
+
+type StreamMessage = {
+	content?: unknown;
+	usage?: { output?: unknown };
+};
+
+/** 每个 content index 的可见文本/思考长度；无对应块的 index 保持稀疏洞。 */
+function textBlockLengths(message: StreamMessage): number[] {
+	const content = message.content;
+	if (!Array.isArray(content)) return [];
 	const lengths: number[] = [];
-	for (let index = 0; index < message.content.length; index++) {
-		const block = message.content[index];
+	for (let index = 0; index < content.length; index++) {
+		const block = content[index] as ContentBlock;
 		if (block?.type === "text" && typeof block.text === "string") {
 			lengths[index] = block.text.length;
 		} else if (block?.type === "thinking" && block.thinkingSignature?.body) {
@@ -33,11 +36,15 @@ function textBlockLengths(message: any): number[] {
 	return lengths;
 }
 
-function outputUsage(message: any): number {
+function outputUsage(message: StreamMessage): number {
 	const value = Number(message?.usage?.output);
 	return Number.isFinite(value) && value > 0 ? Math.round(value) : 0;
 }
 
+type WorkingUi = {
+	setWorkingMessage(message?: string): void;
+};
+
 /**
  * Extend Pi's footer working row while preserving its spinner and "Working...":
  * `⠋ Working... (↓ 1,234 tokens · 12s)`
@@ -54,7 +61,7 @@ export default function (pi: ExtensionAPI): void {
 	let providerOutputTokens = 0;
 	let refreshTimer: ReturnType<typeof setTimeout> | null = null;
 	let lastMessage: string | null = null;
-	let activeCtx: { ui: any; hasUI: boolean } | null = null;
+	let activeCtx: { ui: WorkingUi | undefined; hasUI: boolean } | null = null;
 
 	function tokenCount(): number {
 		return providerOutputTokens || Math.max(0, Math.round(responseLength / 4));
@@ -66,13 +73,13 @@ export default function (pi: ExtensionAPI): void {
 		responseLength = Math.max(0, responseLength + responseTextBlockLengths[index] - previous);
 	}
 
-	function resetResponseTracking(message?: any): void {
+	function resetResponseTracking(message?: StreamMessage): void {
 		responseTextBlockLengths = message ? textBlockLengths(message) : [];
-		responseLength = message ? estimateTextLength(message) : 0;
+		responseLength = responseTextBlockLengths.reduce((sum, length) => sum + length, 0);
 		providerOutputTokens = message ? outputUsage(message) : 0;
 	}
 
-	function updateProviderUsage(message: any): void {
+	function updateProviderUsage(message: StreamMessage): void {
 		const output = outputUsage(message);
 		if (output > 0) providerOutputTokens = output;
 	}
@@ -93,7 +100,7 @@ export default function (pi: ExtensionAPI): void {
 		lastMessage = null;
 		if (!activeCtx?.hasUI) return;
 		try {
-			activeCtx.ui.setWorkingMessage();
+			activeCtx.ui?.setWorkingMessage();
 		} catch {
 			// Noop when the TUI is unavailable.
 		}
@@ -109,7 +116,7 @@ export default function (pi: ExtensionAPI): void {
 		if (!force && next === lastMessage) return;
 		lastMessage = next;
 		try {
-			activeCtx.ui.setWorkingMessage(next);
+			activeCtx.ui?.setWorkingMessage(next);
 		} catch {
 			// Noop when the TUI is unavailable.
 		}