@openclaw/diffs 2026.5.9-beta.1 → 2026.5.10-beta.1

package/README.md

@@ -106,6 +106,7 @@ Set plugin-wide defaults in `~/.openclaw/openclaw.json`:
             fileScale: 2,
             fileMaxWidth: 960,
             mode: "both",
+            ttlSeconds: 21600,
           },
         },
       },
@@ -120,6 +121,7 @@ Security options:
 
 - `security.allowRemoteViewer` (default `false`): allows non-loopback access to `/plugins/diffs/view/...` token URLs
 - `viewerBaseUrl` (optional): persistent viewer-link origin/path fallback for shareable URLs
+- `defaults.ttlSeconds` (default `1800`, max `21600`): default artifact lifetime for viewer and standalone file outputs
 
 Example:
 

package/dist/index.js

@@ -107,7 +107,8 @@ const DEFAULT_DIFFS_TOOL_DEFAULTS = {
 	fileQuality: "standard",
 	fileScale: DEFAULT_IMAGE_QUALITY_PROFILES.standard.scale,
 	fileMaxWidth: DEFAULT_IMAGE_QUALITY_PROFILES.standard.maxWidth,
-	mode: "both"
+	mode: "both",
+	ttlSeconds: 1800
 };
 const DEFAULT_DIFFS_PLUGIN_SECURITY = { allowRemoteViewer: false };
 const VIEWER_BASE_URL_JSON_SCHEMA = {
@@ -146,7 +147,8 @@ const DiffsPluginJsonSchemaSource = z.strictObject({
 		imageQuality: z.enum(DIFF_IMAGE_QUALITY_PRESETS).optional().describe("Deprecated alias for fileQuality."),
 		imageScale: z.number().min(1).max(4).optional().describe("Deprecated alias for fileScale."),
 		imageMaxWidth: z.number().min(640).max(2400).optional().describe("Deprecated alias for fileMaxWidth."),
-		mode: z.enum(DIFF_MODES).default(DEFAULT_DIFFS_TOOL_DEFAULTS.mode).optional()
+		mode: z.enum(DIFF_MODES).default(DEFAULT_DIFFS_TOOL_DEFAULTS.mode).optional(),
+		ttlSeconds: z.number().min(1).max(21600).default(DEFAULT_DIFFS_TOOL_DEFAULTS.ttlSeconds).optional()
 	}).optional(),
 	security: z.strictObject({ allowRemoteViewer: z.boolean().default(DEFAULT_DIFFS_PLUGIN_SECURITY.allowRemoteViewer).optional() }).optional()
 });
@@ -225,7 +227,8 @@ function resolveDiffsPluginDefaults(config) {
 		fileQuality,
 		fileScale: normalizeFileScale(fileScale, profile.scale),
 		fileMaxWidth: normalizeFileMaxWidth(fileMaxWidth, profile.maxWidth),
-		mode: normalizeMode$1(defaults.mode)
+		mode: normalizeMode$1(defaults.mode),
+		ttlSeconds: normalizeTtlSeconds(defaults.ttlSeconds)
 	};
 }
 function resolveDiffsPluginSecurity(config) {
@@ -279,6 +282,10 @@ function normalizeFileMaxWidth(fileMaxWidth, fallback) {
 function normalizeMode$1(mode) {
 	return mode && DIFF_MODES.includes(mode) ? mode : DEFAULT_DIFFS_TOOL_DEFAULTS.mode;
 }
+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);
+}
 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;
@@ -1777,7 +1784,7 @@ function createDiffsTool(params) {
 			const theme = normalizeTheme(toolParams.theme, params.defaults.theme);
 			const layout = normalizeLayout(toolParams.layout, params.defaults.layout);
 			const expandUnchanged = toolParams.expandUnchanged === true;
-			const ttlMs = normalizeTtlMs(toolParams.ttlSeconds);
+			const ttlMs = normalizeTtlMs(toolParams.ttlSeconds ?? params.defaults.ttlSeconds);
 			const image = resolveDiffImageRenderOptions({
 				defaults: params.defaults,
 				fileFormat: normalizeOutputFormat(toolParams.fileFormat ?? toolParams.imageFormat ?? toolParams.format),

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "diffs",
   "activation": {
-    "onStartup": false
+    "onStartup": true
   },
   "name": "Diffs",
   "description": "Read-only diff viewer and file renderer for agents.",
@@ -75,6 +75,10 @@
       "label": "Default Output Mode",
       "help": "Tool default when mode is omitted. Use view for canvas/gateway viewer, file for PNG/PDF, or both."
     },
+    "defaults.ttlSeconds": {
+      "label": "Default Artifact TTL",
+      "help": "Default lifetime in seconds for diff viewer and file artifacts. Maximum: 21600."
+    },
     "security.allowRemoteViewer": {
       "label": "Allow Remote Viewer",
       "help": "Allow non-loopback access to diff viewer URLs when the token path is known."
@@ -190,6 +194,12 @@
             "type": "string",
             "enum": ["view", "image", "file", "both"],
             "default": "both"
+          },
+          "ttlSeconds": {
+            "type": "number",
+            "minimum": 1,
+            "maximum": 21600,
+            "default": 1800
           }
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/diffs",
-  "version": "2026.5.9-beta.1",
+  "version": "2026.5.10-beta.1",
   "description": "OpenClaw diff viewer plugin",
   "repository": {
     "type": "git",
@@ -11,7 +11,7 @@
     "build:viewer": "bun build src/viewer-client.ts --target browser --format esm --minify --outfile assets/viewer-runtime.js"
   },
   "dependencies": {
-    "@pierre/diffs": "1.1.20",
+    "@pierre/diffs": "1.1.21",
     "@pierre/theme": "0.0.29",
     "playwright-core": "1.59.1",
     "typebox": "1.1.38"
@@ -30,10 +30,10 @@
       "minHostVersion": ">=2026.4.30"
     },
     "compat": {
-      "pluginApi": ">=2026.5.9-beta.1"
+      "pluginApi": ">=2026.5.10-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.9-beta.1",
+      "openclawVersion": "2026.5.10-beta.1",
       "staticAssets": [
         {
           "source": "./assets/viewer-runtime.js",
@@ -56,7 +56,7 @@
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.9-beta.1"
+    "openclaw": ">=2026.5.10-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {