@riddledc/openclaw-riddledc 0.9.4 → 0.9.6

package/CHECKSUMS.txt

@@ -1,9 +1,9 @@
-c320ef98658b4d0bbe03485cb28105e299b85d0fb240c3a1e45f337c7011464e  dist/chunk-SNGACMAL.js
-64cc01e78e10d5cc8855cb849431b8c4b9c9da5c8cb1d2030cc1857f8db2e4f1  dist/core.cjs
-9e6f2ccdbc993bea4445dbc20e131b442c01b298c19f87fe81846a22d6c92c48  dist/core.d.cts
-9e6f2ccdbc993bea4445dbc20e131b442c01b298c19f87fe81846a22d6c92c48  dist/core.d.ts
-b42375f824ecc6089e065b28268c828b29ccef979c9d8ae53ffff4abe138c0b4  dist/core.js
-2ecc1e44daec4535712881dd0fbc3af4afe98d58bf1a2336a1a377cb94e41eb5  dist/index.cjs
+c6ac3162f44cefd3bdf39030780ca7e90812d2f9f72064f6f6946c3d4592b4f3  dist/chunk-ZNO6NNKO.js
+e50d40eafee4081213bfe42ec6e77e9ef58c4f383c0c966df5512f28a8144a68  dist/core.cjs
+d6e158722c91097e647d712652cc6bd26792aecf2ff6f990b0a5bf4dfa323aa2  dist/core.d.cts
+d6e158722c91097e647d712652cc6bd26792aecf2ff6f990b0a5bf4dfa323aa2  dist/core.d.ts
+2ce75cbb7701f3a0cb1a0adcbe4c53e5062a540ef7cf7517b470908071c86d67  dist/core.js
+3d1abeb96c6539cf6e801b8632657a110a3f9767b4b6d51e1c8b419ef5fd94c2  dist/index.cjs
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.cts
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.ts
-4b4cdbf998c5d79fb14c43d0137846696c15c48676914ab243d8d3a78cdb242e  dist/index.js
+0effe0fdd362247d9186a419604b2696b6955f25b2ceda6ba3360742db46881f  dist/index.js

package/dist/{chunk-SNGACMAL.js → chunk-ZNO6NNKO.js}

@@ -151,6 +151,24 @@ function previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras = (
   if (lastStatusData?.error) result.server_error = lastStatusData.error;
   return result;
 }
+function isCompletedPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return value === "complete" || value === "completed";
+}
+function isTerminalPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return [
+    "complete",
+    "completed",
+    "failed",
+    "completed_error",
+    "completed_timeout",
+    "timeout",
+    "timed_out",
+    "cancelled",
+    "canceled"
+  ].includes(value);
+}
 async function writeArtifact(workspace, subdir, filename, content) {
   const dir = join(workspace, "riddle", subdir);
   await mkdir(dir, { recursive: true });
@@ -258,6 +276,7 @@ async function fetchArtifactsAndBuild(config, jobId, include) {
   const data = await res.json();
   const artifacts = data.artifacts || [];
   const result = {};
+  result.outputs = artifacts;
   if (data.status) result._artifactsStatus = data.status;
   if (data.timeout) result._timeout = data.timeout;
   if (data.error) result._error = data.error;
@@ -304,6 +323,20 @@ async function fetchArtifactsAndBuild(config, jobId, include) {
     } catch {
     }
   }
+  const visualDiffArtifact = artifacts.find((a) => a.name === "visual-diff.json");
+  if (include.includes("visual_diff") && visualDiffArtifact?.url) {
+    try {
+      const vRes = await fetch(visualDiffArtifact.url);
+      if (vRes.ok) {
+        result.visual_diff = await vRes.json();
+      }
+    } catch {
+    }
+  }
+  const visualDiffImages = artifacts.filter((a) => /^visual-diff.*\.(png|jpg|jpeg)$/i.test(a.name || ""));
+  if (visualDiffImages.length > 0) {
+    result.visual_diff_images = visualDiffImages;
+  }
   if (include.includes("har")) {
     const harArtifact = artifacts.find((a) => a.name === "network.har");
     if (harArtifact?.url) {
@@ -486,6 +519,62 @@ async function saveImageOutputs(workspace, jobId, outputs, label) {
     }
   }
 }
+async function previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras = () => ({})) {
+  const status = statusData?.status ?? "unknown";
+  const terminal = isTerminalPreviewStatus(status);
+  const completed = isCompletedPreviewStatus(status);
+  const label = pathPrefix.slice(1);
+  const result = {
+    ok: terminal ? completed : true,
+    terminal,
+    job_id: jobId,
+    status,
+    phase: statusData?.phase ?? status,
+    phase_updated_at: statusData?.phase_updated_at,
+    phase_details: statusData?.phase_details,
+    outputs: statusData?.outputs || [],
+    compute_seconds: statusData?.compute_seconds,
+    egress_bytes: statusData?.egress_bytes,
+    ...resultExtras(statusData ?? {})
+  };
+  if (!terminal) {
+    result.message = `Job is still ${status}. Call the status tool again later to recover artifacts when it completes.`;
+  }
+  if (statusData?.error) result.error = statusData.error;
+  if (statusData?.script_error) result.script_error = statusData.script_error;
+  if (terminal && !completed && !result.error && !result.script_error) {
+    result.error = `Job ended with status ${status}`;
+  }
+  await saveImageOutputs(config.workspace, jobId, result.outputs, label);
+  result.screenshots = result.outputs.filter((o) => /\.(png|jpg|jpeg)$/i.test(o.name));
+  return result;
+}
+async function getPreviewJobStatus(config, pathPrefix, jobId, resultExtras = () => ({})) {
+  let cfg;
+  try {
+    cfg = requireConfig(config);
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+  if (!jobId || typeof jobId !== "string") {
+    return { ok: false, error: "job_id must be a non-empty string" };
+  }
+  const endpoint = cfg.baseUrl.replace(/\/$/, "");
+  let statusRes;
+  try {
+    statusRes = await fetchWithRetry(`${endpoint}${pathPrefix}/${jobId}`, {
+      headers: { Authorization: `Bearer ${cfg.apiKey}` }
+    }, PREVIEW_REQUEST_TIMEOUT_MS, `${pathPrefix.slice(1)} status`, { attempts: 2 });
+  } catch (e) {
+    return { ok: false, job_id: jobId, error: `Status failed: ${describeError(e)}` };
+  }
+  if (!statusRes.ok) {
+    const err = await statusRes.text().catch(() => "");
+    return { ok: false, job_id: jobId, error: `Status failed: HTTP ${statusRes.status}${err ? ` ${err}` : ""}` };
+  }
+  const statusData = await statusRes.json();
+  return previewResultFromStatusData(cfg, pathPrefix, jobId, statusData, resultExtras);
+}
 async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras) {
   const endpoint = config.baseUrl.replace(/\/$/, "");
   const pollStart = Date.now();
@@ -505,24 +594,8 @@ async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras
     }
     const statusData = await statusRes.json();
     lastStatusData = statusData;
-    if (statusData.status === "complete" || statusData.status === "completed" || statusData.status === "failed") {
-      const result = {
-        ok: statusData.status === "complete" || statusData.status === "completed",
-        job_id: jobId,
-        status: statusData.status,
-        phase: statusData.phase ?? statusData.status,
-        phase_updated_at: statusData.phase_updated_at,
-        phase_details: statusData.phase_details,
-        outputs: statusData.outputs || [],
-        compute_seconds: statusData.compute_seconds,
-        egress_bytes: statusData.egress_bytes,
-        ...resultExtras(statusData)
-      };
-      if (statusData.error) result.error = statusData.error;
-      if (statusData.script_error) result.script_error = statusData.script_error;
-      await saveImageOutputs(config.workspace, jobId, result.outputs, pathPrefix.slice(1));
-      result.screenshots = result.outputs.filter((o) => /\.(png|jpg|jpeg)$/i.test(o.name));
-      return result;
+    if (isTerminalPreviewStatus(statusData.status)) {
+      return previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras);
     }
     await sleep(pollIntervalMs);
   }
@@ -735,6 +808,9 @@ async function createServerPreview(config, params) {
   }
   return pollPreviewJob(cfg, "/v1/server-preview", created.job_id, ((params.timeout || 120) + 60) * 1e3, () => ({}));
 }
+async function getServerPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/server-preview", jobId, () => ({}));
+}
 async function createBuildPreview(config, params) {
   let cfg;
   try {
@@ -837,6 +913,14 @@ async function createBuildPreview(config, params) {
     ...statusData.audit ? { audit: statusData.audit } : {}
   }));
 }
+async function getBuildPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/build-preview", jobId, (statusData) => ({
+    build_duration_ms: statusData.build_duration_ms,
+    ...statusData.build_log ? { build_log: statusData.build_log } : {},
+    ...statusData.container_log ? { container_log: statusData.container_log } : {},
+    ...statusData.audit ? { audit: statusData.audit } : {}
+  }));
+}
 
 export {
   configFromOpenClawApi,
@@ -854,5 +938,7 @@ export {
   createStaticPreview,
   deleteStaticPreview,
   createServerPreview,
-  createBuildPreview
+  getServerPreviewStatus,
+  createBuildPreview,
+  getBuildPreviewStatus
 };

package/dist/core.cjs

@@ -31,6 +31,8 @@ __export(core_exports, {
   fetchArtifactsAndBuild: () => fetchArtifactsAndBuild,
   fetchWithRetry: () => fetchWithRetry,
   fetchWithTimeout: () => fetchWithTimeout,
+  getBuildPreviewStatus: () => getBuildPreviewStatus,
+  getServerPreviewStatus: () => getServerPreviewStatus,
   isAlreadyStartedResponse: () => isAlreadyStartedResponse,
   pollJobStatus: () => pollJobStatus,
   riddleApiFetch: () => riddleApiFetch,
@@ -190,6 +192,24 @@ function previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras = (
   if (lastStatusData?.error) result.server_error = lastStatusData.error;
   return result;
 }
+function isCompletedPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return value === "complete" || value === "completed";
+}
+function isTerminalPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return [
+    "complete",
+    "completed",
+    "failed",
+    "completed_error",
+    "completed_timeout",
+    "timeout",
+    "timed_out",
+    "cancelled",
+    "canceled"
+  ].includes(value);
+}
 async function writeArtifact(workspace, subdir, filename, content) {
   const dir = (0, import_node_path.join)(workspace, "riddle", subdir);
   await (0, import_promises.mkdir)(dir, { recursive: true });
@@ -297,6 +317,7 @@ async function fetchArtifactsAndBuild(config, jobId, include) {
   const data = await res.json();
   const artifacts = data.artifacts || [];
   const result = {};
+  result.outputs = artifacts;
   if (data.status) result._artifactsStatus = data.status;
   if (data.timeout) result._timeout = data.timeout;
   if (data.error) result._error = data.error;
@@ -343,6 +364,20 @@ async function fetchArtifactsAndBuild(config, jobId, include) {
     } catch {
     }
   }
+  const visualDiffArtifact = artifacts.find((a) => a.name === "visual-diff.json");
+  if (include.includes("visual_diff") && visualDiffArtifact?.url) {
+    try {
+      const vRes = await fetch(visualDiffArtifact.url);
+      if (vRes.ok) {
+        result.visual_diff = await vRes.json();
+      }
+    } catch {
+    }
+  }
+  const visualDiffImages = artifacts.filter((a) => /^visual-diff.*\.(png|jpg|jpeg)$/i.test(a.name || ""));
+  if (visualDiffImages.length > 0) {
+    result.visual_diff_images = visualDiffImages;
+  }
   if (include.includes("har")) {
     const harArtifact = artifacts.find((a) => a.name === "network.har");
     if (harArtifact?.url) {
@@ -525,6 +560,62 @@ async function saveImageOutputs(workspace, jobId, outputs, label) {
     }
   }
 }
+async function previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras = () => ({})) {
+  const status = statusData?.status ?? "unknown";
+  const terminal = isTerminalPreviewStatus(status);
+  const completed = isCompletedPreviewStatus(status);
+  const label = pathPrefix.slice(1);
+  const result = {
+    ok: terminal ? completed : true,
+    terminal,
+    job_id: jobId,
+    status,
+    phase: statusData?.phase ?? status,
+    phase_updated_at: statusData?.phase_updated_at,
+    phase_details: statusData?.phase_details,
+    outputs: statusData?.outputs || [],
+    compute_seconds: statusData?.compute_seconds,
+    egress_bytes: statusData?.egress_bytes,
+    ...resultExtras(statusData ?? {})
+  };
+  if (!terminal) {
+    result.message = `Job is still ${status}. Call the status tool again later to recover artifacts when it completes.`;
+  }
+  if (statusData?.error) result.error = statusData.error;
+  if (statusData?.script_error) result.script_error = statusData.script_error;
+  if (terminal && !completed && !result.error && !result.script_error) {
+    result.error = `Job ended with status ${status}`;
+  }
+  await saveImageOutputs(config.workspace, jobId, result.outputs, label);
+  result.screenshots = result.outputs.filter((o) => /\.(png|jpg|jpeg)$/i.test(o.name));
+  return result;
+}
+async function getPreviewJobStatus(config, pathPrefix, jobId, resultExtras = () => ({})) {
+  let cfg;
+  try {
+    cfg = requireConfig(config);
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+  if (!jobId || typeof jobId !== "string") {
+    return { ok: false, error: "job_id must be a non-empty string" };
+  }
+  const endpoint = cfg.baseUrl.replace(/\/$/, "");
+  let statusRes;
+  try {
+    statusRes = await fetchWithRetry(`${endpoint}${pathPrefix}/${jobId}`, {
+      headers: { Authorization: `Bearer ${cfg.apiKey}` }
+    }, PREVIEW_REQUEST_TIMEOUT_MS, `${pathPrefix.slice(1)} status`, { attempts: 2 });
+  } catch (e) {
+    return { ok: false, job_id: jobId, error: `Status failed: ${describeError(e)}` };
+  }
+  if (!statusRes.ok) {
+    const err = await statusRes.text().catch(() => "");
+    return { ok: false, job_id: jobId, error: `Status failed: HTTP ${statusRes.status}${err ? ` ${err}` : ""}` };
+  }
+  const statusData = await statusRes.json();
+  return previewResultFromStatusData(cfg, pathPrefix, jobId, statusData, resultExtras);
+}
 async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras) {
   const endpoint = config.baseUrl.replace(/\/$/, "");
   const pollStart = Date.now();
@@ -544,24 +635,8 @@ async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras
     }
     const statusData = await statusRes.json();
     lastStatusData = statusData;
-    if (statusData.status === "complete" || statusData.status === "completed" || statusData.status === "failed") {
-      const result = {
-        ok: statusData.status === "complete" || statusData.status === "completed",
-        job_id: jobId,
-        status: statusData.status,
-        phase: statusData.phase ?? statusData.status,
-        phase_updated_at: statusData.phase_updated_at,
-        phase_details: statusData.phase_details,
-        outputs: statusData.outputs || [],
-        compute_seconds: statusData.compute_seconds,
-        egress_bytes: statusData.egress_bytes,
-        ...resultExtras(statusData)
-      };
-      if (statusData.error) result.error = statusData.error;
-      if (statusData.script_error) result.script_error = statusData.script_error;
-      await saveImageOutputs(config.workspace, jobId, result.outputs, pathPrefix.slice(1));
-      result.screenshots = result.outputs.filter((o) => /\.(png|jpg|jpeg)$/i.test(o.name));
-      return result;
+    if (isTerminalPreviewStatus(statusData.status)) {
+      return previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras);
     }
     await sleep(pollIntervalMs);
   }
@@ -774,6 +849,9 @@ async function createServerPreview(config, params) {
   }
   return pollPreviewJob(cfg, "/v1/server-preview", created.job_id, ((params.timeout || 120) + 60) * 1e3, () => ({}));
 }
+async function getServerPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/server-preview", jobId, () => ({}));
+}
 async function createBuildPreview(config, params) {
   let cfg;
   try {
@@ -876,6 +954,14 @@ async function createBuildPreview(config, params) {
     ...statusData.audit ? { audit: statusData.audit } : {}
   }));
 }
+async function getBuildPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/build-preview", jobId, (statusData) => ({
+    build_duration_ms: statusData.build_duration_ms,
+    ...statusData.build_log ? { build_log: statusData.build_log } : {},
+    ...statusData.container_log ? { container_log: statusData.container_log } : {},
+    ...statusData.audit ? { audit: statusData.audit } : {}
+  }));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   applySafetySpec,
@@ -889,6 +975,8 @@ async function createBuildPreview(config, params) {
   fetchArtifactsAndBuild,
   fetchWithRetry,
   fetchWithTimeout,
+  getBuildPreviewStatus,
+  getServerPreviewStatus,
   isAlreadyStartedResponse,
   pollJobStatus,
   riddleApiFetch,

package/dist/core.d.cts

@@ -52,6 +52,8 @@ declare function createStaticPreview(config: RiddleCoreConfig, params: {
 }): Promise<PreviewResult>;
 declare function deleteStaticPreview(config: RiddleCoreConfig, id: string): Promise<PreviewResult>;
 declare function createServerPreview(config: RiddleCoreConfig, params: Record<string, any>): Promise<PreviewResult>;
+declare function getServerPreviewStatus(config: RiddleCoreConfig, jobId: string): Promise<PreviewResult>;
 declare function createBuildPreview(config: RiddleCoreConfig, params: Record<string, any>): Promise<PreviewResult>;
+declare function getBuildPreviewStatus(config: RiddleCoreConfig, jobId: string): Promise<PreviewResult>;
 
-export { type PreviewResult, type RiddleCoreConfig, type RiddlePayload, type RunResult, applySafetySpec, assertAllowedBaseUrl, configFromOpenClawApi, createBuildPreview, createServerPreview, createStaticPreview, deleteStaticPreview, describeError, fetchArtifactsAndBuild, fetchWithRetry, fetchWithTimeout, isAlreadyStartedResponse, pollJobStatus, riddleApiFetch, runWithDefaults, writeArtifactBinary };
+export { type PreviewResult, type RiddleCoreConfig, type RiddlePayload, type RunResult, applySafetySpec, assertAllowedBaseUrl, configFromOpenClawApi, createBuildPreview, createServerPreview, createStaticPreview, deleteStaticPreview, describeError, fetchArtifactsAndBuild, fetchWithRetry, fetchWithTimeout, getBuildPreviewStatus, getServerPreviewStatus, isAlreadyStartedResponse, pollJobStatus, riddleApiFetch, runWithDefaults, writeArtifactBinary };

package/dist/core.d.ts

@@ -52,6 +52,8 @@ declare function createStaticPreview(config: RiddleCoreConfig, params: {
 }): Promise<PreviewResult>;
 declare function deleteStaticPreview(config: RiddleCoreConfig, id: string): Promise<PreviewResult>;
 declare function createServerPreview(config: RiddleCoreConfig, params: Record<string, any>): Promise<PreviewResult>;
+declare function getServerPreviewStatus(config: RiddleCoreConfig, jobId: string): Promise<PreviewResult>;
 declare function createBuildPreview(config: RiddleCoreConfig, params: Record<string, any>): Promise<PreviewResult>;
+declare function getBuildPreviewStatus(config: RiddleCoreConfig, jobId: string): Promise<PreviewResult>;
 
-export { type PreviewResult, type RiddleCoreConfig, type RiddlePayload, type RunResult, applySafetySpec, assertAllowedBaseUrl, configFromOpenClawApi, createBuildPreview, createServerPreview, createStaticPreview, deleteStaticPreview, describeError, fetchArtifactsAndBuild, fetchWithRetry, fetchWithTimeout, isAlreadyStartedResponse, pollJobStatus, riddleApiFetch, runWithDefaults, writeArtifactBinary };
+export { type PreviewResult, type RiddleCoreConfig, type RiddlePayload, type RunResult, applySafetySpec, assertAllowedBaseUrl, configFromOpenClawApi, createBuildPreview, createServerPreview, createStaticPreview, deleteStaticPreview, describeError, fetchArtifactsAndBuild, fetchWithRetry, fetchWithTimeout, getBuildPreviewStatus, getServerPreviewStatus, isAlreadyStartedResponse, pollJobStatus, riddleApiFetch, runWithDefaults, writeArtifactBinary };

package/dist/core.js

@@ -10,12 +10,14 @@ import {
   fetchArtifactsAndBuild,
   fetchWithRetry,
   fetchWithTimeout,
+  getBuildPreviewStatus,
+  getServerPreviewStatus,
   isAlreadyStartedResponse,
   pollJobStatus,
   riddleApiFetch,
   runWithDefaults,
   writeArtifactBinary
-} from "./chunk-SNGACMAL.js";
+} from "./chunk-ZNO6NNKO.js";
 export {
   applySafetySpec,
   assertAllowedBaseUrl,
@@ -28,6 +30,8 @@ export {
   fetchArtifactsAndBuild,
   fetchWithRetry,
   fetchWithTimeout,
+  getBuildPreviewStatus,
+  getServerPreviewStatus,
   isAlreadyStartedResponse,
   pollJobStatus,
   riddleApiFetch,

package/dist/index.cjs

@@ -38,6 +38,7 @@ var execFile = (0, import_node_util.promisify)(import_node_child_process.execFil
 var INLINE_CAP = 50 * 1024;
 var PREVIEW_REQUEST_TIMEOUT_MS = 3e4;
 var PREVIEW_UPLOAD_TIMEOUT_MS = 5 * 6e4;
+var PREVIEW_ARTIFACT_TIMEOUT_MS = 6e4;
 var PREVIEW_RETRY_ATTEMPTS = 3;
 var PREVIEW_RETRY_BASE_DELAY_MS = 750;
 function configFromOpenClawApi(api) {
@@ -132,6 +133,32 @@ async function fetchWithRetry(url, init, timeoutMs, label, opts = {}) {
   }
   throw new Error(`${label} failed after ${attempts} attempts: ${describeError(lastErr)}`);
 }
+function isCompletedPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return value === "complete" || value === "completed";
+}
+function isTerminalPreviewStatus(status) {
+  const value = String(status ?? "").toLowerCase();
+  return [
+    "complete",
+    "completed",
+    "failed",
+    "completed_error",
+    "completed_timeout",
+    "timeout",
+    "timed_out",
+    "cancelled",
+    "canceled"
+  ].includes(value);
+}
+async function writeArtifactBinary(workspace, subdir, filename, base64Content) {
+  const dir = (0, import_node_path.join)(workspace, "riddle", subdir);
+  await (0, import_promises.mkdir)(dir, { recursive: true });
+  const filePath = (0, import_node_path.join)(dir, filename);
+  const buf = Buffer.from(base64Content, "base64");
+  await (0, import_promises.writeFile)(filePath, buf);
+  return { path: filePath, sizeBytes: buf.byteLength };
+}
 async function assertDirectory(dir) {
   if (!dir || typeof dir !== "string") throw new Error("directory must be an absolute path");
   try {
@@ -147,6 +174,79 @@ async function tarDirectory(dir, tarball, excludes, timeout) {
   await execFile("tar", ["czf", tarball, ...excludeArgs, "-C", dir, "."], { timeout });
   return (0, import_promises.readFile)(tarball);
 }
+async function saveImageOutputs(workspace, jobId, outputs, label) {
+  for (const output of outputs) {
+    if (output.name && /\.(png|jpg|jpeg)$/i.test(output.name) && output.url) {
+      try {
+        const imgRes = await fetchWithTimeout(output.url, {}, PREVIEW_ARTIFACT_TIMEOUT_MS, `${label} artifact download`);
+        if (imgRes.ok) {
+          const buf = await imgRes.arrayBuffer();
+          const base64 = Buffer.from(buf).toString("base64");
+          const ref = await writeArtifactBinary(workspace, "screenshots", `${jobId}-${output.name}`, base64);
+          output.saved = ref.path;
+          output.sizeBytes = ref.sizeBytes;
+        }
+      } catch {
+      }
+    }
+  }
+}
+async function previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras = () => ({})) {
+  const status = statusData?.status ?? "unknown";
+  const terminal = isTerminalPreviewStatus(status);
+  const completed = isCompletedPreviewStatus(status);
+  const label = pathPrefix.slice(1);
+  const result = {
+    ok: terminal ? completed : true,
+    terminal,
+    job_id: jobId,
+    status,
+    phase: statusData?.phase ?? status,
+    phase_updated_at: statusData?.phase_updated_at,
+    phase_details: statusData?.phase_details,
+    outputs: statusData?.outputs || [],
+    compute_seconds: statusData?.compute_seconds,
+    egress_bytes: statusData?.egress_bytes,
+    ...resultExtras(statusData ?? {})
+  };
+  if (!terminal) {
+    result.message = `Job is still ${status}. Call the status tool again later to recover artifacts when it completes.`;
+  }
+  if (statusData?.error) result.error = statusData.error;
+  if (statusData?.script_error) result.script_error = statusData.script_error;
+  if (terminal && !completed && !result.error && !result.script_error) {
+    result.error = `Job ended with status ${status}`;
+  }
+  await saveImageOutputs(config.workspace, jobId, result.outputs, label);
+  result.screenshots = result.outputs.filter((o) => /\.(png|jpg|jpeg)$/i.test(o.name));
+  return result;
+}
+async function getPreviewJobStatus(config, pathPrefix, jobId, resultExtras = () => ({})) {
+  let cfg;
+  try {
+    cfg = requireConfig(config);
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+  if (!jobId || typeof jobId !== "string") {
+    return { ok: false, error: "job_id must be a non-empty string" };
+  }
+  const endpoint = cfg.baseUrl.replace(/\/$/, "");
+  let statusRes;
+  try {
+    statusRes = await fetchWithRetry(`${endpoint}${pathPrefix}/${jobId}`, {
+      headers: { Authorization: `Bearer ${cfg.apiKey}` }
+    }, PREVIEW_REQUEST_TIMEOUT_MS, `${pathPrefix.slice(1)} status`, { attempts: 2 });
+  } catch (e) {
+    return { ok: false, job_id: jobId, error: `Status failed: ${describeError(e)}` };
+  }
+  if (!statusRes.ok) {
+    const err = await statusRes.text().catch(() => "");
+    return { ok: false, job_id: jobId, error: `Status failed: HTTP ${statusRes.status}${err ? ` ${err}` : ""}` };
+  }
+  const statusData = await statusRes.json();
+  return previewResultFromStatusData(cfg, pathPrefix, jobId, statusData, resultExtras);
+}
 async function createStaticPreview(config, params) {
   let cfg;
   try {
@@ -240,13 +340,24 @@ async function deleteStaticPreview(config, id) {
   const data = await res.json();
   return { ok: true, deleted: true, files_removed: data.files_removed };
 }
+async function getServerPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/server-preview", jobId, () => ({}));
+}
+async function getBuildPreviewStatus(config, jobId) {
+  return getPreviewJobStatus(config, "/v1/build-preview", jobId, (statusData) => ({
+    build_duration_ms: statusData.build_duration_ms,
+    ...statusData.build_log ? { build_log: statusData.build_log } : {},
+    ...statusData.container_log ? { container_log: statusData.container_log } : {},
+    ...statusData.audit ? { audit: statusData.audit } : {}
+  }));
+}
 
 // src/index.ts
 var execFile2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
 var INLINE_CAP2 = 50 * 1024;
 var PREVIEW_REQUEST_TIMEOUT_MS2 = 3e4;
 var PREVIEW_UPLOAD_TIMEOUT_MS2 = 5 * 6e4;
-var PREVIEW_ARTIFACT_TIMEOUT_MS = 6e4;
+var PREVIEW_ARTIFACT_TIMEOUT_MS2 = 6e4;
 var PREVIEW_RETRY_ATTEMPTS2 = 3;
 var PREVIEW_RETRY_BASE_DELAY_MS2 = 750;
 function getCfg(api) {
@@ -387,7 +498,7 @@ async function writeArtifact(workspace, subdir, filename, content) {
   await (0, import_promises2.writeFile)(filePath, buf);
   return { path: filePath, sizeBytes: buf.byteLength };
 }
-async function writeArtifactBinary(workspace, subdir, filename, base64Content) {
+async function writeArtifactBinary2(workspace, subdir, filename, base64Content) {
   const dir = (0, import_node_path2.join)(workspace, "riddle", subdir);
   await (0, import_promises2.mkdir)(dir, { recursive: true });
   const filePath = (0, import_node_path2.join)(dir, filename);
@@ -405,7 +516,7 @@ async function applySafetySpec(result, opts) {
       base64Data = result.screenshot.data.replace(/^data:image\/\w+;base64,/, "");
     }
     if (base64Data) {
-      const ref = await writeArtifactBinary(opts.workspace, "screenshots", `${jobId}.png`, base64Data);
+      const ref = await writeArtifactBinary2(opts.workspace, "screenshots", `${jobId}.png`, base64Data);
       const cdnUrl = typeof result.screenshot === "object" ? result.screenshot.url : void 0;
       result.screenshot = { saved: ref.path, sizeBytes: ref.sizeBytes, ...cdnUrl ? { url: cdnUrl } : {} };
     }
@@ -422,14 +533,14 @@ async function applySafetySpec(result, opts) {
         base64Data = ss.data.replace(/^data:image\/\w+;base64,/, "");
       }
       if (base64Data) {
-        const ref = await writeArtifactBinary(opts.workspace, "screenshots", `${jobId}-${i}.png`, base64Data);
+        const ref = await writeArtifactBinary2(opts.workspace, "screenshots", `${jobId}-${i}.png`, base64Data);
         savedRefs.push({ saved: ref.path, sizeBytes: ref.sizeBytes, ...cdnUrl ? { url: cdnUrl } : {} });
       }
     }
     result.screenshots = savedRefs;
   }
   if (result.rawPngBase64 != null) {
-    const ref = await writeArtifactBinary(opts.workspace, "screenshots", `${jobId}.png`, result.rawPngBase64);
+    const ref = await writeArtifactBinary2(opts.workspace, "screenshots", `${jobId}.png`, result.rawPngBase64);
     result.screenshot = { saved: ref.path, sizeBytes: ref.sizeBytes };
     delete result.rawPngBase64;
   }
@@ -1304,11 +1415,11 @@ function register(api) {
             for (const output of result.outputs) {
               if (output.name && /\.(png|jpg|jpeg)$/i.test(output.name) && output.url) {
                 try {
-                  const imgRes = await fetchWithTimeout2(output.url, {}, PREVIEW_ARTIFACT_TIMEOUT_MS, "server preview artifact download");
+                  const imgRes = await fetchWithTimeout2(output.url, {}, PREVIEW_ARTIFACT_TIMEOUT_MS2, "server preview artifact download");
                   if (imgRes.ok) {
                     const buf = await imgRes.arrayBuffer();
                     const base64 = Buffer.from(buf).toString("base64");
-                    const ref = await writeArtifactBinary(workspace, "screenshots", `${created.job_id}-${output.name}`, base64);
+                    const ref = await writeArtifactBinary2(workspace, "screenshots", `${created.job_id}-${output.name}`, base64);
                     output.saved = ref.path;
                     output.sizeBytes = ref.sizeBytes;
                   }
@@ -1326,6 +1437,20 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_server_preview_status",
+      description: "Check/recover a server-preview job by ID (sp_...). Use when riddle_server_preview printed a job_id but the local watcher was interrupted or timed out before artifacts were returned. Downloads screenshot outputs into the workspace when available.",
+      parameters: import_typebox.Type.Object({
+        job_id: import_typebox.Type.String({ description: "Server-preview job ID, for example sp_abc123" })
+      }),
+      async execute(_id, params) {
+        const result = await getServerPreviewStatus(configFromOpenClawApi(api), params.job_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
   api.registerTool(
     {
       name: "riddle_build_preview",
@@ -1510,11 +1635,11 @@ function register(api) {
             for (const output of result.outputs) {
               if (output.name && /\.(png|jpg|jpeg)$/i.test(output.name) && output.url) {
                 try {
-                  const imgRes = await fetchWithTimeout2(output.url, {}, PREVIEW_ARTIFACT_TIMEOUT_MS, "build preview artifact download");
+                  const imgRes = await fetchWithTimeout2(output.url, {}, PREVIEW_ARTIFACT_TIMEOUT_MS2, "build preview artifact download");
                   if (imgRes.ok) {
                     const buf = await imgRes.arrayBuffer();
                     const base64 = Buffer.from(buf).toString("base64");
-                    const ref = await writeArtifactBinary(workspace, "screenshots", `${created.job_id}-${output.name}`, base64);
+                    const ref = await writeArtifactBinary2(workspace, "screenshots", `${created.job_id}-${output.name}`, base64);
                     output.saved = ref.path;
                     output.sizeBytes = ref.sizeBytes;
                   }
@@ -1537,6 +1662,20 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_build_preview_status",
+      description: "Check/recover a build-preview job by ID (bp_...). Use when riddle_build_preview printed a job_id but the local watcher was interrupted or timed out before artifacts were returned. Downloads screenshot outputs and returns build/container logs when available.",
+      parameters: import_typebox.Type.Object({
+        job_id: import_typebox.Type.String({ description: "Build-preview job ID, for example bp_abc123" })
+      }),
+      async execute(_id, params) {
+        const result = await getBuildPreviewStatus(configFromOpenClawApi(api), params.job_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
   async function riddleApiFetch(api2, method, path, body) {
     const { apiKey, baseUrl } = getCfg(api2);
     if (!apiKey) throw new Error("Missing Riddle API key. Set RIDDLE_API_KEY or configure in plugin settings.");
@@ -1657,7 +1796,7 @@ function register(api) {
                     if (imgRes.ok) {
                       const buf = await imgRes.arrayBuffer();
                       const base64 = Buffer.from(buf).toString("base64");
-                      const ref = await writeArtifactBinary(workspace, "screenshots", `${data.job_id}-${output.name}`, base64);
+                      const ref = await writeArtifactBinary2(workspace, "screenshots", `${data.job_id}-${output.name}`, base64);
                       output.saved = ref.path;
                       output.sizeBytes = ref.sizeBytes;
                     }

package/dist/index.js

@@ -1,8 +1,10 @@
 import {
   configFromOpenClawApi,
   createStaticPreview,
-  deleteStaticPreview
-} from "./chunk-SNGACMAL.js";
+  deleteStaticPreview,
+  getBuildPreviewStatus,
+  getServerPreviewStatus
+} from "./chunk-ZNO6NNKO.js";
 
 // src/index.ts
 import { Type } from "@sinclair/typebox";
@@ -1094,6 +1096,20 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_server_preview_status",
+      description: "Check/recover a server-preview job by ID (sp_...). Use when riddle_server_preview printed a job_id but the local watcher was interrupted or timed out before artifacts were returned. Downloads screenshot outputs into the workspace when available.",
+      parameters: Type.Object({
+        job_id: Type.String({ description: "Server-preview job ID, for example sp_abc123" })
+      }),
+      async execute(_id, params) {
+        const result = await getServerPreviewStatus(configFromOpenClawApi(api), params.job_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
   api.registerTool(
     {
       name: "riddle_build_preview",
@@ -1305,6 +1321,20 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_build_preview_status",
+      description: "Check/recover a build-preview job by ID (bp_...). Use when riddle_build_preview printed a job_id but the local watcher was interrupted or timed out before artifacts were returned. Downloads screenshot outputs and returns build/container logs when available.",
+      parameters: Type.Object({
+        job_id: Type.String({ description: "Build-preview job ID, for example bp_abc123" })
+      }),
+      async execute(_id, params) {
+        const result = await getBuildPreviewStatus(configFromOpenClawApi(api), params.job_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
   async function riddleApiFetch(api2, method, path, body) {
     const { apiKey, baseUrl } = getCfg(api2);
     if (!apiKey) throw new Error("Missing Riddle API key. Set RIDDLE_API_KEY or configure in plugin settings.");

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-riddledc",
   "name": "Riddle",
   "description": "Riddle (riddledc.com) hosted browser API tools for OpenClaw agents.",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "notes": "0.8.0: Added riddle_build_preview for Dockerfile-based builds with image caching.",
   "type": "plugin",
   "bundledSkills": [],
@@ -42,7 +42,9 @@
         "riddle_preview",
         "riddle_preview_delete",
         "riddle_server_preview",
+        "riddle_server_preview_status",
         "riddle_build_preview",
+        "riddle_build_preview_status",
         "riddle_session_create",
         "riddle_session_list",
         "riddle_session_run",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/openclaw-riddledc",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "OpenClaw integration package for RiddleDC (no secrets).",
   "license": "MIT",
   "author": "RiddleDC",