@openclaw/diffs 2026.7.1 → 2026.7.2-beta.1

package/dist/index.js

@@ -18,7 +18,8 @@ import { readFiniteNumberParam } from "openclaw/plugin-sdk/param-readers";
 import { Type } from "typebox";
 import { chromium } from "playwright-core";
 import { parsePatchFiles, resolveLanguage } from "@pierre/diffs";
-import { preloadFileDiff, preloadMultiFileDiff } from "@pierre/diffs/ssr";
+import { preloadDiffHTML } from "@pierre/diffs/ssr";
+import { escapeHtml } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region extensions/diffs/src/types.ts
 const DIFF_LAYOUTS = ["unified", "split"];
 const DIFF_MODES = [
@@ -284,15 +285,15 @@ function normalizeTtlSeconds(ttlSeconds) {
 	return Math.min(Math.max(Math.floor(ttlSeconds), 1), 21600);
 }
 function resolveDiffImageRenderOptions(params) {
-	const format = normalizeFileFormat(params.fileFormat ?? params.imageFormat ?? params.format ?? params.defaults.fileFormat);
-	const qualityOverrideProvided = params.fileQuality !== void 0 || params.imageQuality !== void 0;
-	const qualityPreset = normalizeFileQuality$1(params.fileQuality ?? params.imageQuality ?? params.defaults.fileQuality);
+	const format = normalizeFileFormat(params.fileFormat ?? params.defaults.fileFormat);
+	const qualityOverrideProvided = params.fileQuality !== void 0;
+	const qualityPreset = normalizeFileQuality$1(params.fileQuality ?? params.defaults.fileQuality);
 	const profile = DEFAULT_IMAGE_QUALITY_PROFILES[qualityPreset];
 	return {
 		format,
 		qualityPreset,
-		scale: normalizeFileScale(params.fileScale ?? params.imageScale, qualityOverrideProvided ? profile.scale : params.defaults.fileScale),
-		maxWidth: normalizeFileMaxWidth(params.fileMaxWidth ?? params.imageMaxWidth, qualityOverrideProvided ? profile.maxWidth : params.defaults.fileMaxWidth),
+		scale: normalizeFileScale(params.fileScale, qualityOverrideProvided ? profile.scale : params.defaults.fileScale),
+		maxWidth: normalizeFileMaxWidth(params.fileMaxWidth, qualityOverrideProvided ? profile.maxWidth : params.defaults.fileMaxWidth),
 		maxPixels: profile.maxPixels
 	};
 }
@@ -1590,9 +1591,6 @@ var DiffRenderInputError = class extends Error {
 function escapeCssString(value) {
 	return value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"");
 }
-function escapeHtml(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
-}
 function escapeJsonScript(value) {
 	return JSON.stringify(value).replaceAll("<", "\\u003c");
 }
@@ -2008,19 +2006,18 @@ async function renderBeforeAfterDiff(input, options, target) {
 	});
 	const preloadOptions = viewerOptions ?? imageOptions;
 	if (!preloadOptions) throw new Error(`Unsupported diff render target: ${target}`);
-	const preloadResult = await preloadMultiFileDiffWithFallback({
+	const normalizedPayload = await normalizeDiffViewerPayloadLanguages({
+		prerenderedHTML: await preloadDiffHTMLWithFallback({
+			oldFile,
+			newFile,
+			options: preloadOptions
+		}),
 		oldFile,
 		newFile,
-		options: preloadOptions
-	});
-	const normalizedPayload = await normalizeDiffViewerPayloadLanguages({
-		prerenderedHTML: preloadResult.prerenderedHTML,
-		oldFile: preloadResult.oldFile,
-		newFile: preloadResult.newFile,
 		options: preloadOptions,
 		langs: collectDiffPayloadLanguageHints({
-			oldFile: preloadResult.oldFile,
-			newFile: preloadResult.newFile
+			oldFile,
+			newFile
 		})
 	}, { languagePackAvailable });
 	const viewerPayload = viewerOptions ? {
@@ -2063,15 +2060,14 @@ async function renderPatchDiff(input, options, target) {
 		stats: computeFileDiffStats(fileDiff)
 	}));
 	const sections = await Promise.all(files.map(async (fileDiff, index) => {
-		const preloadResult = await preloadFileDiffWithFallback({
-			fileDiff,
-			options: preloadOptions
-		});
 		const normalizedPayload = await normalizeDiffViewerPayloadLanguages({
-			prerenderedHTML: preloadResult.prerenderedHTML,
-			fileDiff: preloadResult.fileDiff,
+			prerenderedHTML: await preloadDiffHTMLWithFallback({
+				fileDiff,
+				options: preloadOptions
+			}),
+			fileDiff,
 			options: preloadOptions,
-			langs: collectDiffPayloadLanguageHints({ fileDiff: preloadResult.fileDiff })
+			langs: collectDiffPayloadLanguageHints({ fileDiff })
 		}, { languagePackAvailable });
 		const viewerPayload = viewerOptions ? {
 			...normalizedPayload,
@@ -2134,27 +2130,12 @@ async function renderDiffDocument(input, options, target = "both") {
 function shouldFallbackToClientHydration(error) {
 	return error instanceof TypeError && error.message.includes("needs an import attribute of \"type: json\"");
 }
-async function preloadFileDiffWithFallback(params) {
+async function preloadDiffHTMLWithFallback(params) {
 	try {
-		return await preloadFileDiff(params);
+		return await preloadDiffHTML(params);
 	} catch (error) {
 		if (!shouldFallbackToClientHydration(error)) throw error;
-		return {
-			fileDiff: params.fileDiff,
-			prerenderedHTML: ""
-		};
-	}
-}
-async function preloadMultiFileDiffWithFallback(params) {
-	try {
-		return await preloadMultiFileDiff(params);
-	} catch (error) {
-		if (!shouldFallbackToClientHydration(error)) throw error;
-		return {
-			oldFile: params.oldFile,
-			newFile: params.newFile,
-			prerenderedHTML: ""
-		};
+		return "";
 	}
 }
 //#endregion
@@ -2199,30 +2180,6 @@ const DiffsToolSchema = Type.Object({
 		minimum: 640,
 		maximum: 2400
 	}),
-	/** @deprecated Use fileQuality. */
-	imageQuality: Type.Optional(stringEnum(DIFF_IMAGE_QUALITY_PRESETS, {
-		description: "Deprecated alias for fileQuality.",
-		deprecated: true
-	})),
-	/** @deprecated Use fileFormat. */
-	imageFormat: Type.Optional(stringEnum(DIFF_OUTPUT_FORMATS, {
-		description: "Deprecated alias for fileFormat.",
-		deprecated: true
-	})),
-	/** @deprecated Use fileScale. */
-	imageScale: optionalFiniteNumberSchema({
-		description: "Deprecated alias for fileScale.",
-		deprecated: true,
-		minimum: 1,
-		maximum: 4
-	}),
-	/** @deprecated Use fileMaxWidth. */
-	imageMaxWidth: optionalFiniteNumberSchema({
-		description: "Deprecated alias for fileMaxWidth.",
-		deprecated: true,
-		minimum: 640,
-		maximum: 2400
-	}),
 	expandUnchanged: Type.Optional(Type.Boolean({ description: "Expand unchanged sections instead of collapsing them." })),
 	ttlSeconds: optionalFiniteNumberSchema({
 		description: "Artifact lifetime in seconds. Default: 1800. Maximum: 21600.",
@@ -2257,13 +2214,13 @@ function createDiffsTool(params) {
 			const layout = normalizeLayout(toolParams.layout, params.defaults.layout);
 			const expandUnchanged = toolParams.expandUnchanged === true;
 			const ttlSeconds = readFiniteNumberParam(rawRecord, "ttlSeconds") ?? params.defaults.ttlSeconds;
-			const fileScale = readFiniteNumberParam(rawRecord, "fileScale") ?? readFiniteNumberParam(rawRecord, "imageScale");
-			const fileMaxWidth = readFiniteNumberParam(rawRecord, "fileMaxWidth") ?? readFiniteNumberParam(rawRecord, "imageMaxWidth");
+			const fileScale = readFiniteNumberParam(rawRecord, "fileScale");
+			const fileMaxWidth = readFiniteNumberParam(rawRecord, "fileMaxWidth");
 			const ttlMs = normalizeTtlMs(ttlSeconds);
 			const image = resolveDiffImageRenderOptions({
 				defaults: params.defaults,
-				fileFormat: normalizeOutputFormat(toolParams.fileFormat ?? toolParams.imageFormat ?? toolParams.format),
-				fileQuality: normalizeFileQuality(toolParams.fileQuality ?? toolParams.imageQuality),
+				fileFormat: normalizeOutputFormat(toolParams.fileFormat),
+				fileQuality: normalizeFileQuality(toolParams.fileQuality),
 				fileScale,
 				fileMaxWidth
 			});
@@ -2383,8 +2340,7 @@ function createDiffsTool(params) {
 						}],
 						details: {
 							...baseDetails,
-							fileError: errorMessage,
-							imageError: errorMessage
+							fileError: errorMessage
 						}
 					};
 				}
@@ -2415,18 +2371,12 @@ function buildArtifactDetails(params) {
 	return {
 		...params.baseDetails,
 		filePath: params.artifactFile.path,
-		imagePath: params.artifactFile.path,
 		path: params.artifactFile.path,
 		fileBytes: params.artifactFile.bytes,
-		imageBytes: params.artifactFile.bytes,
-		format: params.image.format,
 		fileFormat: params.image.format,
 		fileQuality: params.image.qualityPreset,
-		imageQuality: params.image.qualityPreset,
 		fileScale: params.image.scale,
-		imageScale: params.image.scale,
-		fileMaxWidth: params.image.maxWidth,
-		imageMaxWidth: params.image.maxWidth
+		fileMaxWidth: params.image.maxWidth
 	};
 }
 function buildFileArtifactMessage(params) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/diffs",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/diffs",
-      "version": "2026.7.1",
+      "version": "2026.7.2-beta.1",
       "dependencies": {
         "@pierre/diffs": "1.2.12",
         "@shikijs/langs": "4.3.0",

package/openclaw.plugin.json

@@ -5,6 +5,7 @@
   },
   "name": "Diffs",
   "description": "OpenClaw read-only diff viewer plugin and file renderer for agents.",
+  "catalog": { "featured": true, "order": 40 },
   "contracts": {
     "tools": ["diffs"]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/diffs",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "description": "OpenClaw read-only diff viewer plugin and file renderer for agents.",
   "repository": {
     "type": "git",
@@ -25,13 +25,13 @@
       "minHostVersion": ">=2026.4.30"
     },
     "compat": {
-      "pluginApi": ">=2026.7.1"
+      "pluginApi": ">=2026.7.2-beta.1"
     },
     "assetScripts": {
       "build": "node ../../scripts/build-diffs-viewer-runtime.mjs curated"
     },
     "build": {
-      "openclawVersion": "2026.7.1",
+      "openclawVersion": "2026.7.2-beta.1",
       "staticAssets": [
         {
           "source": "./assets/viewer-runtime.js",
@@ -55,7 +55,7 @@
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.1"
+    "openclaw": ">=2026.7.2-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {