@openclaw/diffs 2026.9.8 → 2026.10.1-beta.2

package/dist/.setup/{browser.runtime-v15gbeC0.mjs → browser.runtime-B8JeyUXz.mjs}

@@ -1,7 +1,7 @@
-import { a as getServedViewerAsset, i as getServedLanguagePackViewerAsset, n as VIEWER_ASSET_PREFIX, t as LANGUAGE_PACK_VIEWER_ASSET_PREFIX } from "./viewer-assets-Bg9efLih.mjs";
+import { a as getServedViewerAsset, i as getServedLanguagePackViewerAsset, n as VIEWER_ASSET_PREFIX, t as LANGUAGE_PACK_VIEWER_ASSET_PREFIX } from "./viewer-assets-C646cpoV.mjs";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { constants } from "node:fs";
 import path from "node:path";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs$1 from "node:fs/promises";
 import { writeExternalFileWithinRoot } from "openclaw/plugin-sdk/security-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
@@ -54,14 +54,8 @@ var PlaywrightDiffScreenshotter = class {
 						await route.continue();
 						return;
 					}
-					let parsed;
-					try {
-						parsed = new URL(requestUrl);
-					} catch {
-						await route.abort();
-						return;
-					}
-					if (parsed.protocol !== "http:" || parsed.hostname !== "127.0.0.1") {
+					const parsed = URL.parse(requestUrl);
+					if (!parsed || parsed.protocol !== "http:" || parsed.hostname !== "127.0.0.1") {
 						await route.abort();
 						return;
 					}
@@ -89,7 +83,7 @@ var PlaywrightDiffScreenshotter = class {
 					return [...document.querySelectorAll("[data-openclaw-diff-host]")].every((element) => {
 						return element instanceof HTMLElement && element.shadowRoot?.querySelector("[data-diffs]");
 					});
-				}, { timeout: 1e4 });
+				}, void 0, { timeout: 1e4 });
 				await page.evaluate(async () => {
 					await document.fonts.ready;
 				});

package/dist/.setup/{viewer-assets-Bg9efLih.mjs → viewer-assets-C646cpoV.mjs}

@@ -25,16 +25,25 @@ function createViewerAssetHandler(prefix, relativePaths, optional = false) {
 	const loaderPath = `${prefix}viewer.js`;
 	const runtimePath = `${prefix}viewer-runtime.js`;
 	let cache = null;
+	const loadRuntimeAssets = async (runtimeUrl) => {
+		const cached = cache;
+		const runtimeFilePath = fileURLToPath(runtimeUrl);
+		const runtimeStat = await fs.stat(runtimeFilePath);
+		if (cached && cached.mtimeMs === runtimeStat.mtimeMs) return cached;
+		const runtimeBody = await fs.readFile(runtimeFilePath);
+		const hash = crypto.createHash("sha1").update(runtimeBody).digest("hex").slice(0, 12);
+		cache = {
+			mtimeMs: runtimeStat.mtimeMs,
+			runtimeBody,
+			loaderBody: `import "${VIEWER_RUNTIME_RELATIVE_IMPORT_PATH}?v=${hash}";\n`
+		};
+		return cache;
+	};
 	return async (pathname) => {
 		if (pathname !== loaderPath && pathname !== runtimePath) return null;
 		try {
-			const assets = await loadRuntimeAssets({
-				runtimeUrl: await resolveRuntimeFileUrl(relativePaths),
-				cache,
-				updateCache: (updated) => {
-					cache = updated;
-				}
-			});
+			const runtimeUrl = await resolveRuntimeFileUrl(relativePaths);
+			const assets = await loadRuntimeAssets(runtimeUrl);
 			return {
 				body: pathname === loaderPath ? assets.loaderBody : assets.runtimeBody,
 				contentType: "text/javascript; charset=utf-8"
@@ -45,20 +54,6 @@ function createViewerAssetHandler(prefix, relativePaths, optional = false) {
 		}
 	};
 }
-async function loadRuntimeAssets(params) {
-	const runtimePath = fileURLToPath(params.runtimeUrl);
-	const runtimeStat = await fs.stat(runtimePath);
-	if (params.cache && params.cache.mtimeMs === runtimeStat.mtimeMs) return params.cache;
-	const runtimeBody = await fs.readFile(runtimePath);
-	const hash = crypto.createHash("sha1").update(runtimeBody).digest("hex").slice(0, 12);
-	const cache = {
-		mtimeMs: runtimeStat.mtimeMs,
-		runtimeBody,
-		loaderBody: `import "${VIEWER_RUNTIME_RELATIVE_IMPORT_PATH}?v=${hash}";\n`
-	};
-	params.updateCache(cache);
-	return cache;
-}
 async function resolveRuntimeFileUrl(relativePaths) {
 	let missingFileError = null;
 	for (const relativePath of relativePaths) {

package/dist/index.js

@@ -1,6 +1,8 @@
-import { a as getServedViewerAsset, r as VIEWER_RUNTIME_PATH } from "./.setup/viewer-assets-Bg9efLih.mjs";
+import { a as getServedViewerAsset, r as VIEWER_RUNTIME_PATH } from "./.setup/viewer-assets-C646cpoV.mjs";
 import { buildPluginConfigSchema, definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { mapPluginConfigIssues } from "openclaw/plugin-sdk/extension-shared";
+import { asFiniteNumber, asNonArrayRecord, asOptionalRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { clampInt, clampNumber, escapeHtml } from "openclaw/plugin-sdk/text-utility-runtime";
 import { z } from "zod";
 import { resolveGatewayPublicOrigin } from "openclaw/plugin-sdk/config-contracts";
 import fs from "node:fs";
@@ -8,7 +10,6 @@ import path from "node:path";
 import { resolveLivePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
 import { isLoopbackHost } from "openclaw/plugin-sdk/ssrf-runtime";
-import { asNonArrayRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createAuthRateLimiter, resolveRequestClientIp } from "openclaw/plugin-sdk/webhook-ingress";
 import crypto from "node:crypto";
 import fs$1 from "node:fs/promises";
@@ -21,10 +22,10 @@ import { optionalFiniteNumberSchema, stringEnum } from "openclaw/plugin-sdk/chan
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { readFiniteNumberParam } from "openclaw/plugin-sdk/param-readers";
+import { textResult } from "openclaw/plugin-sdk/tool-results";
 import { Type } from "typebox";
 import { parsePatchFiles, resolveLanguage } from "@pierre/diffs";
 import { preloadDiffHTML } from "@pierre/diffs/ssr";
-import { escapeHtml } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -224,12 +225,8 @@ function buildViewerUrl(params) {
 	return parsedBase.toString();
 }
 function normalizeViewerBaseUrl(raw, fieldName = "baseUrl") {
-	let parsed;
-	try {
-		parsed = new URL(raw);
-	} catch {
-		throw new Error(`Invalid ${fieldName}: ${raw}`);
-	}
+	const parsed = URL.parse(raw);
+	if (!parsed) throw new Error(`Invalid ${fieldName}: ${raw}`);
 	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") throw new Error(`${fieldName} must use http or https: ${raw}`);
 	if (parsed.search || parsed.hash) throw new Error(`${fieldName} must not include query/hash: ${raw}`);
 	parsed.search = "";
@@ -359,36 +356,32 @@ function resolveDiffsPluginDefaults(config) {
 	if (!config || typeof config !== "object" || Array.isArray(config)) return { ...DEFAULT_DIFFS_TOOL_DEFAULTS };
 	const defaults = config.defaults;
 	if (!defaults || typeof defaults !== "object" || Array.isArray(defaults)) return { ...DEFAULT_DIFFS_TOOL_DEFAULTS };
-	const fileQuality = normalizeFileQuality$1(defaults.fileQuality ?? defaults.imageQuality);
+	const fileQuality = normalizeFileQuality(defaults.fileQuality ?? defaults.imageQuality);
 	const profile = DEFAULT_IMAGE_QUALITY_PROFILES[fileQuality];
 	const fileFormat = defaults.fileFormat ?? (defaults.imageFormat !== void 0 ? defaults.imageFormat : defaults.format);
 	return {
 		fontFamily: normalizeFontFamily(defaults.fontFamily),
 		fontSize: normalizeDiffFontSize(defaults.fontSize),
 		lineSpacing: normalizeDiffLineSpacing(defaults.lineSpacing),
-		layout: normalizeLayout$1(defaults.layout),
+		layout: DIFF_LAYOUTS.find((value) => value === defaults.layout) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.layout,
 		showLineNumbers: defaults.showLineNumbers !== false,
-		diffIndicators: normalizeDiffIndicators(defaults.diffIndicators),
+		diffIndicators: DIFF_INDICATORS.find((value) => value === defaults.diffIndicators) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.diffIndicators,
 		wordWrap: defaults.wordWrap !== false,
 		background: defaults.background !== false,
-		theme: normalizeTheme$1(defaults.theme),
+		theme: DIFF_THEMES.find((value) => value === defaults.theme) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.theme,
 		fileFormat: normalizeFileFormat(fileFormat),
 		fileQuality,
 		fileScale: normalizeFileScale(defaults.fileScale ?? defaults.imageScale, profile.scale),
 		fileMaxWidth: normalizeFileMaxWidth(defaults.fileMaxWidth ?? defaults.imageMaxWidth, profile.maxWidth),
-		mode: normalizeMode$1(defaults.mode),
+		mode: DIFF_MODES.find((value) => value === defaults.mode) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.mode,
 		ttlSeconds: normalizeTtlSeconds(defaults.ttlSeconds)
 	};
 }
 function resolveDiffsPluginSecurity(config) {
-	if (!config || typeof config !== "object" || Array.isArray(config)) return { ...DEFAULT_DIFFS_PLUGIN_SECURITY };
-	const security = config.security;
-	if (!security || typeof security !== "object" || Array.isArray(security)) return { ...DEFAULT_DIFFS_PLUGIN_SECURITY };
-	return { allowRemoteViewer: security.allowRemoteViewer === true };
+	return { allowRemoteViewer: asOptionalRecord(asOptionalRecord(config)?.security)?.allowRemoteViewer === true };
 }
 function resolveDiffsPluginViewerBaseUrl(config) {
-	if (!config || typeof config !== "object" || Array.isArray(config)) return;
-	const viewerBaseUrl = config.viewerBaseUrl;
+	const viewerBaseUrl = asOptionalRecord(config)?.viewerBaseUrl;
 	if (typeof viewerBaseUrl !== "string") return;
 	const normalized = viewerBaseUrl.trim();
 	return normalized ? normalizeViewerBaseUrl(normalized) : void 0;
@@ -397,48 +390,32 @@ function normalizeFontFamily(fontFamily) {
 	return fontFamily?.trim() || DEFAULT_DIFFS_TOOL_DEFAULTS.fontFamily;
 }
 function normalizeDiffFontSize(fontSize) {
-	if (fontSize === void 0 || !Number.isFinite(fontSize)) return DEFAULT_DIFFS_TOOL_DEFAULTS.fontSize;
-	return Math.min(Math.max(Math.floor(fontSize), 10), 24);
+	return clampInt(asFiniteNumber(fontSize) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.fontSize, 10, 24);
 }
 function normalizeDiffLineSpacing(lineSpacing) {
-	if (lineSpacing === void 0 || !Number.isFinite(lineSpacing)) return DEFAULT_DIFFS_TOOL_DEFAULTS.lineSpacing;
-	return Math.min(Math.max(lineSpacing, 1), 3);
-}
-function normalizeLayout$1(layout) {
-	return layout && DIFF_LAYOUTS.includes(layout) ? layout : DEFAULT_DIFFS_TOOL_DEFAULTS.layout;
-}
-function normalizeDiffIndicators(diffIndicators) {
-	return diffIndicators && DIFF_INDICATORS.includes(diffIndicators) ? diffIndicators : DEFAULT_DIFFS_TOOL_DEFAULTS.diffIndicators;
-}
-function normalizeTheme$1(theme) {
-	return theme && DIFF_THEMES.includes(theme) ? theme : DEFAULT_DIFFS_TOOL_DEFAULTS.theme;
+	return clampNumber(asFiniteNumber(lineSpacing) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.lineSpacing, 1, 3);
 }
 function normalizeFileFormat(fileFormat) {
 	return fileFormat && DIFF_OUTPUT_FORMATS.includes(fileFormat) ? fileFormat : DEFAULT_DIFFS_TOOL_DEFAULTS.fileFormat;
 }
-function normalizeFileQuality$1(fileQuality) {
+function normalizeFileQuality(fileQuality) {
 	return fileQuality && DIFF_IMAGE_QUALITY_PRESETS.includes(fileQuality) ? fileQuality : DEFAULT_DIFFS_TOOL_DEFAULTS.fileQuality;
 }
 function normalizeFileScale(fileScale, fallback) {
-	if (fileScale === void 0 || !Number.isFinite(fileScale)) return fallback;
-	const rounded = Math.round(fileScale * 100) / 100;
-	return Math.min(Math.max(rounded, 1), 4);
+	const value = asFiniteNumber(fileScale);
+	return value === void 0 ? fallback : clampNumber(Math.round(value * 100) / 100, 1, 4);
 }
 function normalizeFileMaxWidth(fileMaxWidth, fallback) {
-	if (fileMaxWidth === void 0 || !Number.isFinite(fileMaxWidth)) return fallback;
-	return Math.min(Math.max(Math.round(fileMaxWidth), 640), 2400);
-}
-function normalizeMode$1(mode) {
-	return mode && DIFF_MODES.includes(mode) ? mode : DEFAULT_DIFFS_TOOL_DEFAULTS.mode;
+	const value = asFiniteNumber(fileMaxWidth);
+	return value === void 0 ? fallback : clampNumber(Math.round(value), 640, 2400);
 }
 function normalizeTtlSeconds(ttlSeconds) {
-	if (ttlSeconds === void 0 || !Number.isFinite(ttlSeconds)) return DEFAULT_DIFFS_TOOL_DEFAULTS.ttlSeconds;
-	return Math.min(Math.max(Math.floor(ttlSeconds), 1), 21600);
+	return clampInt(asFiniteNumber(ttlSeconds) ?? DEFAULT_DIFFS_TOOL_DEFAULTS.ttlSeconds, 1, 21600);
 }
 function resolveDiffImageRenderOptions(params) {
 	const format = normalizeFileFormat(params.fileFormat ?? params.defaults.fileFormat);
 	const qualityOverrideProvided = params.fileQuality !== void 0;
-	const qualityPreset = normalizeFileQuality$1(params.fileQuality ?? params.defaults.fileQuality);
+	const qualityPreset = normalizeFileQuality(params.fileQuality ?? params.defaults.fileQuality);
 	const profile = DEFAULT_IMAGE_QUALITY_PROFILES[qualityPreset];
 	return {
 		format,
@@ -477,7 +454,7 @@ function createDiffsHttpHandler(params) {
 		maxEntries: VIEWER_LIMITER_MAX_KEYS
 	});
 	return async (req, res) => {
-		const parsed = parseRequestUrl(req.url);
+		const parsed = req.url ? URL.parse(req.url, "http://127.0.0.1") : null;
 		if (!parsed) return false;
 		if (parsed.pathname.startsWith("/plugins/diffs/assets/")) return await serveAsset(req, res, parsed.pathname, params.logger);
 		if (!parsed.pathname.startsWith(VIEW_PREFIX)) return false;
@@ -537,14 +514,6 @@ function createDiffsHttpHandler(params) {
 		}
 	};
 }
-function parseRequestUrl(rawUrl) {
-	if (!rawUrl) return null;
-	try {
-		return new URL(rawUrl, "http://127.0.0.1");
-	} catch {
-		return null;
-	}
-}
 async function serveAsset(req, res, pathname, logger) {
 	if (req.method !== "GET" && req.method !== "HEAD") {
 		respondText(res, 405, "Method not allowed");
@@ -1188,12 +1157,6 @@ function buildDiffTitle(input) {
 	if (input.kind === "before_after") return input.path?.trim() || "Text diff";
 	return "Patch diff";
 }
-function resolveBeforeAfterFileName(params) {
-	const { input, lang } = params;
-	if (input.path?.trim()) return input.path.trim();
-	if (lang && lang !== "text") return `diff.${lang.replace(/^\.+/, "")}`;
-	return DEFAULT_FILE_NAME;
-}
 function resolveDiffTypography(presentation) {
 	const fontSize = normalizeDiffFontSize(presentation.fontSize);
 	const lineSpacing = normalizeDiffLineSpacing(presentation.lineSpacing);
@@ -1574,43 +1537,29 @@ async function renderSection(input, { viewerOptions, imageOptions, preloadOption
 		usesLanguagePack: payload.langs.some((lang) => !isBaseDiffViewerLanguage(lang))
 	};
 }
-function buildRenderedBodies(sections, leadingHtml) {
-	const lead = leadingHtml ? [leadingHtml] : [];
-	const viewerSections = sections.flatMap((section) => section.viewer ? [section.viewer] : []);
-	const imageSections = sections.flatMap((section) => section.image ? [section.image] : []);
-	return {
-		...viewerSections.length > 0 ? { viewerBodyHtml: [...lead, ...viewerSections].join("\n") } : {},
-		...imageSections.length > 0 ? { imageBodyHtml: [...lead, ...imageSections].join("\n") } : {}
-	};
-}
 async function renderBeforeAfterDiff(input, options, target) {
 	const languagePackAvailable = options.languagePackAvailable === true;
 	const lang = await normalizeSupportedLanguageHint(input.lang, { languagePackAvailable });
-	const fileName = resolveBeforeAfterFileName({
-		input,
-		lang
-	});
-	const section = await renderSection({
-		oldFile: {
-			name: fileName,
-			contents: input.before,
-			...lang ? { lang } : {}
-		},
-		newFile: {
-			name: fileName,
-			contents: input.after,
-			...lang ? { lang } : {}
-		}
-	}, buildRenderVariants(options, target), languagePackAvailable);
+	const fileName = input.path?.trim() || (lang && lang !== "text" ? `diff.${lang.replace(/^\.+/, "")}` : DEFAULT_FILE_NAME);
 	return {
-		...buildRenderedBodies([section]),
-		fileCount: 1,
-		usesLanguagePack: section.usesLanguagePack === true
+		sections: [await renderSection({
+			oldFile: {
+				name: fileName,
+				contents: input.before,
+				...lang ? { lang } : {}
+			},
+			newFile: {
+				name: fileName,
+				contents: input.after,
+				...lang ? { lang } : {}
+			}
+		}, buildRenderVariants(options, target), languagePackAvailable)],
+		leadingHtml: void 0
 	};
 }
 async function renderPatchDiff(input, options, target) {
 	const languagePackAvailable = options.languagePackAvailable === true;
-	const files = await Promise.all(parsePatchFiles(input.patch).flatMap((entry) => entry.files ?? []).map((fileDiff) => normalizePatchFileLanguage(fileDiff, { languagePackAvailable })));
+	const files = parsePatchFiles(input.patch).flatMap((entry) => entry.files ?? []);
 	if (files.length === 0) throw new DiffRenderInputError("Patch input did not contain any file diffs.");
 	if (files.length > MAX_PATCH_FILE_COUNT) throw new DiffRenderInputError(`Patch input contains too many files (max ${MAX_PATCH_FILE_COUNT}).`);
 	if (files.reduce((sum, fileDiff) => {
@@ -1624,39 +1573,34 @@ async function renderPatchDiff(input, options, target) {
 		fileDiff,
 		stats: computeFileDiffStats(fileDiff)
 	}));
-	const sections = await Promise.all(files.map((fileDiff, index) => renderSection({ fileDiff }, variants, languagePackAvailable, navEntries[index]?.anchorId)));
 	return {
-		...buildRenderedBodies(sections, files.length > 1 ? renderFileSummaryNav(navEntries) : void 0),
-		fileCount: files.length,
-		usesLanguagePack: sections.some((section) => section.usesLanguagePack === true)
-	};
-}
-async function normalizePatchFileLanguage(fileDiff, options) {
-	const lang = await normalizeSupportedLanguageHint(fileDiff.lang, options);
-	if (lang === fileDiff.lang) return fileDiff;
-	return {
-		...fileDiff,
-		...lang ? { lang } : { lang: "text" }
+		sections: await Promise.all(files.map((fileDiff, index) => renderSection({ fileDiff }, variants, languagePackAvailable, navEntries[index]?.anchorId))),
+		leadingHtml: files.length > 1 ? renderFileSummaryNav(navEntries) : void 0
 	};
 }
 async function renderDiffDocument(input, options, target = "both") {
 	const title = buildDiffTitle(input);
-	const rendered = input.kind === "before_after" ? await renderBeforeAfterDiff(input, options, target) : await renderPatchDiff(input, options, target);
-	const viewerRuntime = rendered.usesLanguagePack ? "language-pack" : "base";
+	const { sections, leadingHtml } = input.kind === "before_after" ? await renderBeforeAfterDiff(input, options, target) : await renderPatchDiff(input, options, target);
+	const lead = leadingHtml ? [leadingHtml] : [];
+	const viewerSections = sections.flatMap((section) => section.viewer ? [section.viewer] : []);
+	const imageSections = sections.flatMap((section) => section.image ? [section.image] : []);
+	const viewerBodyHtml = viewerSections.length ? [...lead, ...viewerSections].join("\n") : void 0;
+	const imageBodyHtml = imageSections.length ? [...lead, ...imageSections].join("\n") : void 0;
+	const viewerRuntime = sections.some((section) => section.usesLanguagePack) ? "language-pack" : "base";
 	const imageTypography = resolveDiffTypography(buildImageRenderOptions(options).presentation);
 	return {
-		...rendered.viewerBodyHtml ? { html: buildHtmlDocument({
+		...viewerBodyHtml ? { html: buildHtmlDocument({
 			title,
-			bodyHtml: rendered.viewerBodyHtml,
+			bodyHtml: viewerBodyHtml,
 			theme: options.presentation.theme,
 			imageMaxWidth: options.image.maxWidth,
 			imageTypography,
 			runtimeMode: "viewer",
 			viewerRuntime
 		}) } : {},
-		...rendered.imageBodyHtml ? { imageHtml: buildHtmlDocument({
+		...imageBodyHtml ? { imageHtml: buildHtmlDocument({
 			title,
-			bodyHtml: rendered.imageBodyHtml,
+			bodyHtml: imageBodyHtml,
 			theme: options.presentation.theme,
 			imageMaxWidth: options.image.maxWidth,
 			imageTypography,
@@ -1664,20 +1608,17 @@ async function renderDiffDocument(input, options, target = "both") {
 			viewerRuntime
 		}) } : {},
 		title,
-		fileCount: rendered.fileCount,
+		fileCount: sections.length,
 		inputKind: input.kind,
 		viewerRuntime
 	};
 }
-function shouldFallbackToClientHydration(error) {
-	return error instanceof TypeError && error.message.includes("needs an import attribute of \"type: json\"");
-}
 async function preloadDiffHTMLWithFallback(params) {
 	try {
 		return await preloadDiffHTML(params);
 	} catch (error) {
-		if (!shouldFallbackToClientHydration(error)) throw error;
-		return "";
+		if (error instanceof TypeError && error.message.includes("needs an import attribute of \"type: json\"")) return "";
+		throw error;
 	}
 }
 //#endregion
@@ -1688,7 +1629,7 @@ const MAX_TITLE_BYTES = 1024;
 const MAX_PATH_BYTES = 2048;
 const MAX_LANG_BYTES = 128;
 const MAX_DIFF_ARTIFACT_TTL_SECONDS = 21600;
-const loadDiffsBrowserRuntime = createLazyRuntimeModule(() => import("./.setup/browser.runtime-v15gbeC0.mjs"));
+const loadDiffsBrowserRuntime = createLazyRuntimeModule(() => import("./.setup/browser.runtime-B8JeyUXz.mjs"));
 const DiffsToolSchema = Type.Object({
 	before: Type.Optional(Type.String({ description: "Original text content." })),
 	after: Type.Optional(Type.String({ description: "Updated text content." })),
@@ -1732,7 +1673,6 @@ const DiffsToolSchema = Type.Object({
 	baseUrl: Type.Optional(Type.String({ description: "Optional gateway base URL override used when building the viewer URL. Overrides configured viewerBaseUrl, for example https://gateway.example.com." }))
 }, { additionalProperties: false });
 function createDiffsTool(params) {
-	const loadScreenshotter = async (config) => params.screenshotter ?? new (await (loadDiffsBrowserRuntime())).PlaywrightDiffScreenshotter({ config });
 	return {
 		name: "diffs",
 		label: "Diffs",
@@ -1744,19 +1684,13 @@ function createDiffsTool(params) {
 			const rawRecord = toolParams;
 			const artifactContext = buildArtifactContext(params.context);
 			const input = normalizeDiffInput(toolParams);
-			if (input.kind === "before_after" && input.before === input.after) return {
-				content: [{
-					type: "text",
-					text: "Before and after are identical — no changes to render."
-				}],
-				details: {
-					changed: false,
-					...artifactContext ? { context: artifactContext } : {}
-				}
-			};
-			const mode = normalizeMode(toolParams.mode, params.defaults.mode);
-			const theme = normalizeTheme(toolParams.theme, params.defaults.theme);
-			const layout = normalizeLayout(toolParams.layout, params.defaults.layout);
+			if (input.kind === "before_after" && input.before === input.after) return textResult("Before and after are identical — no changes to render.", {
+				changed: false,
+				...artifactContext ? { context: artifactContext } : {}
+			});
+			const mode = DIFF_MODES.find((value) => value === toolParams.mode) ?? params.defaults.mode;
+			const theme = DIFF_THEMES.find((value) => value === toolParams.theme) ?? params.defaults.theme;
+			const layout = DIFF_LAYOUTS.find((value) => value === toolParams.layout) ?? params.defaults.layout;
 			const expandUnchanged = toolParams.expandUnchanged === true;
 			const ttlSeconds = readFiniteNumberParam(rawRecord, "ttlSeconds") ?? params.defaults.ttlSeconds;
 			const fileScale = readFiniteNumberParam(rawRecord, "fileScale");
@@ -1764,8 +1698,8 @@ function createDiffsTool(params) {
 			const ttlMs = normalizeTtlMs(ttlSeconds);
 			const image = resolveDiffImageRenderOptions({
 				defaults: params.defaults,
-				fileFormat: normalizeOutputFormat(toolParams.fileFormat),
-				fileQuality: normalizeFileQuality(toolParams.fileQuality),
+				fileFormat: DIFF_OUTPUT_FORMATS.find((value) => value === toolParams.fileFormat),
+				fileQuality: DIFF_IMAGE_QUALITY_PRESETS.find((value) => value === toolParams.fileQuality),
 				fileScale,
 				fileMaxWidth
 			});
@@ -1809,72 +1743,65 @@ function createDiffsTool(params) {
 				mode,
 				...artifactContext ? { context: artifactContext } : {}
 			} : void 0;
-			if (mode === "view") return {
-				content: [{
-					type: "text",
-					text: `Diff viewer ready.\n${viewerUrl}`
-				}],
-				details: viewerDetails
-			};
+			if (mode === "view") return textResult(`Diff viewer ready.\n${viewerUrl}`, viewerDetails);
 			try {
-				const artifactFile = await renderDiffArtifactFile({
-					screenshotter: await loadScreenshotter(config),
-					store: params.store,
-					html: requireRenderedHtml(rendered.imageHtml, "image"),
-					theme,
-					image,
+				const screenshotter = params.screenshotter ?? new (await (loadDiffsBrowserRuntime())).PlaywrightDiffScreenshotter({ config });
+				const html = requireRenderedHtml(rendered.imageHtml, "image");
+				const artifactFile = await params.store.createStandaloneFileArtifact({
+					format: image.format,
 					ttlMs,
 					context: artifactContext
 				});
-				return {
-					content: [{
-						type: "text",
-						text: buildFileArtifactMessage({
-							format: image.format,
-							filePath: artifactFile.path,
-							viewerUrl
-						})
-					}],
-					details: buildArtifactDetails({
-						baseDetails: viewerDetails ?? {
-							changed: true,
-							...artifactFile.artifactId ? { artifactId: artifactFile.artifactId } : {},
-							...artifactFile.expiresAt ? { expiresAt: artifactFile.expiresAt } : {},
-							title: rendered.title,
-							inputKind: rendered.inputKind,
-							fileCount: rendered.fileCount,
-							mode,
-							...artifactContext ? { context: artifactContext } : {}
-						},
-						artifactFile,
+				let fileBytes;
+				try {
+					await screenshotter.screenshotHtml({
+						html,
+						outputPath: artifactFile.filePath,
+						theme,
 						image
-					})
-				};
+					});
+					fileBytes = (await fs$1.stat(artifactFile.filePath)).size;
+					await params.store.completeFileArtifact(artifactFile.id);
+				} catch (error) {
+					await params.store.deleteFileArtifact(artifactFile.id);
+					throw error;
+				}
+				return textResult([
+					...viewerUrl ? [`Diff viewer: ${viewerUrl}`] : [],
+					`Diff ${image.format.toUpperCase()} generated at: ${artifactFile.filePath}`,
+					"To send this file, use an available file-sending tool to send it as an attachment."
+				].join("\n"), {
+					...viewerDetails ?? {
+						changed: true,
+						artifactId: artifactFile.id,
+						expiresAt: artifactFile.expiresAt,
+						title: rendered.title,
+						inputKind: rendered.inputKind,
+						fileCount: rendered.fileCount,
+						mode,
+						...artifactContext ? { context: artifactContext } : {}
+					},
+					filePath: artifactFile.filePath,
+					path: artifactFile.filePath,
+					fileBytes,
+					fileFormat: image.format,
+					fileQuality: image.qualityPreset,
+					fileScale: image.scale,
+					fileMaxWidth: image.maxWidth
+				});
 			} catch (error) {
 				if (mode === "both") {
 					const errorMessage = formatErrorMessage(error);
-					return {
-						content: [{
-							type: "text",
-							text: `Diff viewer ready.\n${viewerUrl}\nFile rendering failed: ${errorMessage}`
-						}],
-						details: {
-							...viewerDetails,
-							fileError: errorMessage
-						}
-					};
+					return textResult(`Diff viewer ready.\n${viewerUrl}\nFile rendering failed: ${errorMessage}`, {
+						...viewerDetails,
+						fileError: errorMessage
+					});
 				}
 				throw error;
 			}
 		}
 	};
 }
-function normalizeFileQuality(fileQuality) {
-	return fileQuality && DIFF_IMAGE_QUALITY_PRESETS.includes(fileQuality) ? fileQuality : void 0;
-}
-function normalizeOutputFormat(format) {
-	return format && DIFF_OUTPUT_FORMATS.includes(format) ? format : void 0;
-}
 function isArtifactOnlyMode(mode) {
 	return mode === "image" || mode === "file";
 }
@@ -1887,62 +1814,18 @@ function requireRenderedHtml(html, target) {
 	if (html !== void 0) return html;
 	throw new Error(`Missing ${target} render output.`);
 }
-function buildArtifactDetails(params) {
-	return {
-		...params.baseDetails,
-		filePath: params.artifactFile.path,
-		path: params.artifactFile.path,
-		fileBytes: params.artifactFile.bytes,
-		fileFormat: params.image.format,
-		fileQuality: params.image.qualityPreset,
-		fileScale: params.image.scale,
-		fileMaxWidth: params.image.maxWidth
-	};
-}
-function buildFileArtifactMessage(params) {
-	const lines = params.viewerUrl ? [`Diff viewer: ${params.viewerUrl}`] : [];
-	lines.push(`Diff ${params.format.toUpperCase()} generated at: ${params.filePath}`);
-	lines.push("To send this file, use an available file-sending tool to send it as an attachment.");
-	return lines.join("\n");
-}
-async function renderDiffArtifactFile(params) {
-	const fileArtifact = await params.store.createStandaloneFileArtifact({
-		format: params.image.format,
-		ttlMs: params.ttlMs,
-		context: params.context
-	});
-	try {
-		await params.screenshotter.screenshotHtml({
-			html: params.html,
-			outputPath: fileArtifact.filePath,
-			theme: params.theme,
-			image: params.image
-		});
-		const stats = await fs$1.stat(fileArtifact.filePath);
-		await params.store.completeFileArtifact(fileArtifact.id);
-		return {
-			path: fileArtifact.filePath,
-			bytes: stats.size,
-			artifactId: fileArtifact.id,
-			expiresAt: fileArtifact.expiresAt
-		};
-	} catch (error) {
-		await params.store.deleteFileArtifact(fileArtifact.id);
-		throw error;
-	}
-}
 function buildArtifactContext(context) {
 	if (!context) return;
-	const agentId = normalizeOptionalString(context.agentId);
-	const sessionId = normalizeOptionalString(context.sessionId);
-	const messageChannel = normalizeOptionalString(context.messageChannel);
-	const agentAccountId = normalizeOptionalString(context.agentAccountId);
-	const artifactContext = {
-		...agentId ? { agentId } : {},
-		...sessionId ? { sessionId } : {},
-		...messageChannel ? { messageChannel } : {},
-		...agentAccountId ? { agentAccountId } : {}
-	};
+	const artifactContext = {};
+	for (const key of [
+		"agentId",
+		"sessionId",
+		"messageChannel",
+		"agentAccountId"
+	]) {
+		const value = normalizeOptionalString(context[key]);
+		if (value) artifactContext[key] = value;
+	}
 	return Object.keys(artifactContext).length > 0 ? artifactContext : void 0;
 }
 function normalizeDiffInput(params) {
@@ -1991,15 +1874,6 @@ function normalizeBaseUrl(baseUrl) {
 		throw new PluginToolInputError(`Invalid baseUrl: ${normalized}`);
 	}
 }
-function normalizeMode(mode, fallback) {
-	return mode && DIFF_MODES.includes(mode) ? mode : fallback;
-}
-function normalizeTheme(theme, fallback) {
-	return theme && DIFF_THEMES.includes(theme) ? theme : fallback;
-}
-function normalizeLayout(layout, fallback) {
-	return layout && DIFF_LAYOUTS.includes(layout) ? layout : fallback;
-}
 function normalizeTtlMs(ttlSeconds) {
 	if (!Number.isFinite(ttlSeconds) || ttlSeconds === void 0) return;
 	return Math.floor(Math.min(Math.max(ttlSeconds, 1), MAX_DIFF_ARTIFACT_TTL_SECONDS) * 1e3);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/diffs",
-  "version": "2026.9.8",
+  "version": "2026.10.1-beta.2",
   "description": "OpenClaw read-only diff viewer plugin and file renderer for agents.",
   "repository": {
     "type": "git",
@@ -25,14 +25,14 @@
       "minHostVersion": ">=2026.4.30"
     },
     "compat": {
-      "pluginApi": ">=2026.9.8"
+      "pluginApi": ">=2026.10.1-beta.2"
     },
     "assetScripts": {
       "build": "node --import tsx ../../scripts/build-diffs-viewer-runtime.mts curated"
     },
     "build": {
       "bundledDist": false,
-      "openclawVersion": "2026.9.8",
+      "openclawVersion": "2026.10.1-beta.2",
       "staticAssets": [
         {
           "source": "./assets/viewer-runtime.js",
@@ -57,7 +57,7 @@
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.9.8"
+    "openclaw": ">=2026.10.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {