@riddledc/openclaw-riddledc 0.9.3 → 0.9.5

package/CHECKSUMS.txt

@@ -1,9 +1,9 @@
-eb37fd02bb17201162234ea8fdd351ab85fe9d96a99c0c8247ec83d3001c7e77  dist/chunk-LJCZ53PU.js
-548b6419feb09a22f2134a12ce378687eb60cfb0c5eb8f2a47eda6c52c89c5ee  dist/core.cjs
-9e6f2ccdbc993bea4445dbc20e131b442c01b298c19f87fe81846a22d6c92c48  dist/core.d.cts
-9e6f2ccdbc993bea4445dbc20e131b442c01b298c19f87fe81846a22d6c92c48  dist/core.d.ts
-ba8c0a86594c1586b130a787a721ebb3fde4fce481ff924e195bed31a4e6f9b2  dist/core.js
-ae60b6124c90f7aa4028120b87856221a2531b262702c82d54da9161f6ed6368  dist/index.cjs
+0756013923a5d79711ea1b22571589cce1dfc49d85b37de79eb2f9194b11c01e  dist/chunk-UTJTPSHW.js
+628d17715e71385c1c21752d1c90dd956a0552b549444100cc62990ee0ca519d  dist/core.cjs
+d6e158722c91097e647d712652cc6bd26792aecf2ff6f990b0a5bf4dfa323aa2  dist/core.d.cts
+d6e158722c91097e647d712652cc6bd26792aecf2ff6f990b0a5bf4dfa323aa2  dist/core.d.ts
+7d719fd0ea00019cb51bd4b2a02bf2e4104cae2350c91abe6d4cafb8702b4eb2  dist/core.js
+3d1abeb96c6539cf6e801b8632657a110a3f9767b4b6d51e1c8b419ef5fd94c2  dist/index.cjs
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.cts
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.ts
-b92db4977e965d1a9f4d996df1347114046bbcf93ed9ac740e4de40d937bc5eb  dist/index.js
+a3554f1a5ef8b62cb94c1c2bfdff682bbe64e935af412afccb06b3075c22b52e  dist/index.js

package/dist/{chunk-LJCZ53PU.js → chunk-UTJTPSHW.js}

@@ -132,6 +132,43 @@ async function fetchWithRetry(url, init, timeoutMs, label, opts = {}) {
 function isAlreadyStartedResponse(status, body) {
   return status === 409 && /already in status:\s*(queued|running|complete|completed)/i.test(body);
 }
+function previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras = () => ({})) {
+  const lastStatus = lastStatusData?.status ?? "unknown";
+  const lastPhase = lastStatusData?.phase ?? lastStatus;
+  const result = {
+    ok: false,
+    job_id: jobId,
+    status: lastStatus,
+    phase: lastPhase,
+    phase_updated_at: lastStatusData?.phase_updated_at,
+    phase_details: lastStatusData?.phase_details,
+    outputs: lastStatusData?.outputs || [],
+    compute_seconds: lastStatusData?.compute_seconds,
+    egress_bytes: lastStatusData?.egress_bytes,
+    error: `Job did not complete within ${timeoutMs / 1e3}s; last status was ${lastStatus}, phase was ${lastPhase}`,
+    ...resultExtras(lastStatusData ?? {})
+  };
+  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 });
@@ -467,10 +504,67 @@ 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();
   const pollIntervalMs = 3e3;
+  let lastStatusData = null;
   while (Date.now() - pollStart < timeoutMs) {
     let statusRes;
     try {
@@ -484,24 +578,13 @@ async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras
       return { ok: false, job_id: jobId, error: `Poll failed: HTTP ${statusRes.status}` };
     }
     const statusData = await statusRes.json();
-    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,
-        outputs: statusData.outputs || [],
-        compute_seconds: statusData.compute_seconds,
-        egress_bytes: statusData.egress_bytes,
-        ...resultExtras(statusData)
-      };
-      if (statusData.error) result.error = statusData.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;
+    lastStatusData = statusData;
+    if (isTerminalPreviewStatus(statusData.status)) {
+      return previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras);
     }
     await sleep(pollIntervalMs);
   }
-  return { ok: false, job_id: jobId, error: `Job did not complete within ${timeoutMs / 1e3}s` };
+  return previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras);
 }
 async function createStaticPreview(config, params) {
   let cfg;
@@ -710,6 +793,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 {
@@ -812,6 +898,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,
@@ -829,5 +923,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,
@@ -171,6 +173,43 @@ async function fetchWithRetry(url, init, timeoutMs, label, opts = {}) {
 function isAlreadyStartedResponse(status, body) {
   return status === 409 && /already in status:\s*(queued|running|complete|completed)/i.test(body);
 }
+function previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras = () => ({})) {
+  const lastStatus = lastStatusData?.status ?? "unknown";
+  const lastPhase = lastStatusData?.phase ?? lastStatus;
+  const result = {
+    ok: false,
+    job_id: jobId,
+    status: lastStatus,
+    phase: lastPhase,
+    phase_updated_at: lastStatusData?.phase_updated_at,
+    phase_details: lastStatusData?.phase_details,
+    outputs: lastStatusData?.outputs || [],
+    compute_seconds: lastStatusData?.compute_seconds,
+    egress_bytes: lastStatusData?.egress_bytes,
+    error: `Job did not complete within ${timeoutMs / 1e3}s; last status was ${lastStatus}, phase was ${lastPhase}`,
+    ...resultExtras(lastStatusData ?? {})
+  };
+  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 });
@@ -506,10 +545,67 @@ 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();
   const pollIntervalMs = 3e3;
+  let lastStatusData = null;
   while (Date.now() - pollStart < timeoutMs) {
     let statusRes;
     try {
@@ -523,24 +619,13 @@ async function pollPreviewJob(config, pathPrefix, jobId, timeoutMs, resultExtras
       return { ok: false, job_id: jobId, error: `Poll failed: HTTP ${statusRes.status}` };
     }
     const statusData = await statusRes.json();
-    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,
-        outputs: statusData.outputs || [],
-        compute_seconds: statusData.compute_seconds,
-        egress_bytes: statusData.egress_bytes,
-        ...resultExtras(statusData)
-      };
-      if (statusData.error) result.error = statusData.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;
+    lastStatusData = statusData;
+    if (isTerminalPreviewStatus(statusData.status)) {
+      return previewResultFromStatusData(config, pathPrefix, jobId, statusData, resultExtras);
     }
     await sleep(pollIntervalMs);
   }
-  return { ok: false, job_id: jobId, error: `Job did not complete within ${timeoutMs / 1e3}s` };
+  return previewTimeoutResult(jobId, timeoutMs, lastStatusData, resultExtras);
 }
 async function createStaticPreview(config, params) {
   let cfg;
@@ -749,6 +834,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 {
@@ -851,6 +939,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,
@@ -864,6 +960,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-LJCZ53PU.js";
+} from "./chunk-UTJTPSHW.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) {
@@ -364,6 +475,21 @@ async function fetchWithRetry2(url, init, timeoutMs, label, opts = {}) {
 function isAlreadyStartedResponse(status, body) {
   return status === 409 && /already in status:\s*(queued|running|complete|completed)/i.test(body);
 }
+function previewTimeoutToolResult(jobId, timeoutMs, lastStatusData, extras = {}) {
+  const lastStatus = lastStatusData?.status ?? "unknown";
+  const result = {
+    ok: false,
+    job_id: jobId,
+    status: lastStatus,
+    outputs: lastStatusData?.outputs || [],
+    compute_seconds: lastStatusData?.compute_seconds,
+    egress_bytes: lastStatusData?.egress_bytes,
+    error: `Job did not complete within ${timeoutMs / 1e3}s; last status was ${lastStatus}`,
+    ...extras
+  };
+  if (lastStatusData?.error) result.server_error = lastStatusData.error;
+  return result;
+}
 async function writeArtifact(workspace, subdir, filename, content) {
   const dir = (0, import_node_path2.join)(workspace, "riddle", subdir);
   await (0, import_promises2.mkdir)(dir, { recursive: true });
@@ -372,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);
@@ -390,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 } : {} };
     }
@@ -407,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;
   }
@@ -1260,6 +1386,7 @@ function register(api) {
         const timeoutMs = ((params.timeout || 120) + 60) * 1e3;
         const pollStart = Date.now();
         const POLL_INTERVAL = 3e3;
+        let lastStatusData = null;
         while (Date.now() - pollStart < timeoutMs) {
           let statusRes;
           try {
@@ -1273,6 +1400,7 @@ function register(api) {
             return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Poll failed: HTTP ${statusRes.status}` }, null, 2) }] };
           }
           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",
@@ -1287,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;
                   }
@@ -1304,7 +1432,21 @@ function register(api) {
           }
           await new Promise((r) => setTimeout(r, POLL_INTERVAL));
         }
-        return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Job did not complete within ${timeoutMs / 1e3}s` }, null, 2) }] };
+        return { content: [{ type: "text", text: JSON.stringify(previewTimeoutToolResult(created.job_id, timeoutMs, lastStatusData), null, 2) }] };
+      }
+    },
+    { 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 }
@@ -1460,6 +1602,7 @@ function register(api) {
         const timeoutMs = ((params.timeout || 180) + 120) * 1e3;
         const pollStart = Date.now();
         const POLL_INTERVAL = 3e3;
+        let lastStatusData = null;
         while (Date.now() - pollStart < timeoutMs) {
           let statusRes;
           try {
@@ -1473,6 +1616,7 @@ function register(api) {
             return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Poll failed: HTTP ${statusRes.status}` }, null, 2) }] };
           }
           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",
@@ -1491,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;
                   }
@@ -1508,7 +1652,26 @@ function register(api) {
           }
           await new Promise((r) => setTimeout(r, POLL_INTERVAL));
         }
-        return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Job did not complete within ${timeoutMs / 1e3}s` }, null, 2) }] };
+        return { content: [{ type: "text", text: JSON.stringify(previewTimeoutToolResult(created.job_id, timeoutMs, lastStatusData, {
+          build_duration_ms: lastStatusData?.build_duration_ms,
+          ...lastStatusData?.build_log ? { build_log: lastStatusData.build_log } : {},
+          ...lastStatusData?.container_log ? { container_log: lastStatusData.container_log } : {},
+          ...lastStatusData?.audit ? { audit: lastStatusData.audit } : {}
+        }), null, 2) }] };
+      }
+    },
+    { 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 }
@@ -1633,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-LJCZ53PU.js";
+  deleteStaticPreview,
+  getBuildPreviewStatus,
+  getServerPreviewStatus
+} from "./chunk-UTJTPSHW.js";
 
 // src/index.ts
 import { Type } from "@sinclair/typebox";
@@ -132,6 +134,21 @@ async function fetchWithRetry(url, init, timeoutMs, label, opts = {}) {
 function isAlreadyStartedResponse(status, body) {
   return status === 409 && /already in status:\s*(queued|running|complete|completed)/i.test(body);
 }
+function previewTimeoutToolResult(jobId, timeoutMs, lastStatusData, extras = {}) {
+  const lastStatus = lastStatusData?.status ?? "unknown";
+  const result = {
+    ok: false,
+    job_id: jobId,
+    status: lastStatus,
+    outputs: lastStatusData?.outputs || [],
+    compute_seconds: lastStatusData?.compute_seconds,
+    egress_bytes: lastStatusData?.egress_bytes,
+    error: `Job did not complete within ${timeoutMs / 1e3}s; last status was ${lastStatus}`,
+    ...extras
+  };
+  if (lastStatusData?.error) result.server_error = lastStatusData.error;
+  return result;
+}
 async function writeArtifact(workspace, subdir, filename, content) {
   const dir = join(workspace, "riddle", subdir);
   await mkdir(dir, { recursive: true });
@@ -1028,6 +1045,7 @@ function register(api) {
         const timeoutMs = ((params.timeout || 120) + 60) * 1e3;
         const pollStart = Date.now();
         const POLL_INTERVAL = 3e3;
+        let lastStatusData = null;
         while (Date.now() - pollStart < timeoutMs) {
           let statusRes;
           try {
@@ -1041,6 +1059,7 @@ function register(api) {
             return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Poll failed: HTTP ${statusRes.status}` }, null, 2) }] };
           }
           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",
@@ -1072,7 +1091,21 @@ function register(api) {
           }
           await new Promise((r) => setTimeout(r, POLL_INTERVAL));
         }
-        return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Job did not complete within ${timeoutMs / 1e3}s` }, null, 2) }] };
+        return { content: [{ type: "text", text: JSON.stringify(previewTimeoutToolResult(created.job_id, timeoutMs, lastStatusData), null, 2) }] };
+      }
+    },
+    { 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 }
@@ -1228,6 +1261,7 @@ function register(api) {
         const timeoutMs = ((params.timeout || 180) + 120) * 1e3;
         const pollStart = Date.now();
         const POLL_INTERVAL = 3e3;
+        let lastStatusData = null;
         while (Date.now() - pollStart < timeoutMs) {
           let statusRes;
           try {
@@ -1241,6 +1275,7 @@ function register(api) {
             return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Poll failed: HTTP ${statusRes.status}` }, null, 2) }] };
           }
           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",
@@ -1276,7 +1311,26 @@ function register(api) {
           }
           await new Promise((r) => setTimeout(r, POLL_INTERVAL));
         }
-        return { content: [{ type: "text", text: JSON.stringify({ ok: false, job_id: created.job_id, error: `Job did not complete within ${timeoutMs / 1e3}s` }, null, 2) }] };
+        return { content: [{ type: "text", text: JSON.stringify(previewTimeoutToolResult(created.job_id, timeoutMs, lastStatusData, {
+          build_duration_ms: lastStatusData?.build_duration_ms,
+          ...lastStatusData?.build_log ? { build_log: lastStatusData.build_log } : {},
+          ...lastStatusData?.container_log ? { container_log: lastStatusData.container_log } : {},
+          ...lastStatusData?.audit ? { audit: lastStatusData.audit } : {}
+        }), null, 2) }] };
+      }
+    },
+    { 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 }

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.3",
+  "version": "0.9.5",
   "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.3",
+  "version": "0.9.5",
   "description": "OpenClaw integration package for RiddleDC (no secrets).",
   "license": "MIT",
   "author": "RiddleDC",