@riddledc/openclaw-riddledc 0.5.6 → 0.6.0

package/CHECKSUMS.txt

@@ -1,4 +1,4 @@
-041dfffc9dfaaa099cb6243c3512574254b91a80d19e64a68b078d3fc97bd4c8  dist/index.cjs
+876e2b78ca5f38ca4da27097761bcdb99882a5724f025d5befd5ba78710c5832  dist/index.cjs
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.cts
 94ce04f0e2d84bf64dd68f0500dfdd2f951287a3deccec87f197261961927f6f  dist/index.d.ts
-b4d87078938b29cd38097688ac435c4fe328a561963212b53c678a2525c8b86a  dist/index.js
+c481cef6e2fd6aca8d7aef042bc7b8cb5fc12274afe9c50ba10947e398c566ce  dist/index.js

package/dist/index.cjs

@@ -26,6 +26,9 @@ module.exports = __toCommonJS(index_exports);
 var import_typebox = require("@sinclair/typebox");
 var import_promises = require("fs/promises");
 var import_node_path = require("path");
+var import_node_child_process = require("child_process");
+var import_node_util = require("util");
+var execFile = (0, import_node_util.promisify)(import_node_child_process.execFile);
 var INLINE_CAP = 50 * 1024;
 function getCfg(api) {
   const cfg = api?.config ?? {};
@@ -753,4 +756,108 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_preview",
+      description: "Deploy a local build directory as an ephemeral preview site. Tars the directory, uploads to Riddle, and returns a live URL at preview.riddledc.com that can be screenshotted with other riddle_* tools. Previews auto-expire after 24 hours.",
+      parameters: import_typebox.Type.Object({
+        directory: import_typebox.Type.String({ description: "Absolute path to the build output directory (e.g. /path/to/build or /path/to/dist)" }),
+        framework: import_typebox.Type.Optional(import_typebox.Type.String({ description: "Framework hint: 'spa' (default) or 'static'" }))
+      }),
+      async execute(_id, params) {
+        const { apiKey, baseUrl } = getCfg(api);
+        if (!apiKey) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: "Missing Riddle API key." }, null, 2) }] };
+        }
+        assertAllowedBaseUrl(baseUrl);
+        const dir = params.directory;
+        if (!dir || typeof dir !== "string") throw new Error("directory must be an absolute path");
+        try {
+          const st = await (0, import_promises.stat)(dir);
+          if (!st.isDirectory()) throw new Error(`Not a directory: ${dir}`);
+        } catch (e) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Cannot access directory: ${e.message}` }, null, 2) }] };
+        }
+        const endpoint = baseUrl.replace(/\/$/, "");
+        const createRes = await fetch(`${endpoint}/v1/preview`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+          body: JSON.stringify({ framework: params.framework || "spa" })
+        });
+        if (!createRes.ok) {
+          const err = await createRes.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Create failed: HTTP ${createRes.status} ${err}` }, null, 2) }] };
+        }
+        const created = await createRes.json();
+        const tarball = `/tmp/riddle-preview-${created.id}.tar.gz`;
+        try {
+          await execFile("tar", ["czf", tarball, "-C", dir, "."], { timeout: 6e4 });
+          const tarData = await (0, import_promises.readFile)(tarball);
+          const uploadRes = await fetch(created.upload_url, {
+            method: "PUT",
+            headers: { "Content-Type": "application/gzip" },
+            body: tarData
+          });
+          if (!uploadRes.ok) {
+            return { content: [{ type: "text", text: JSON.stringify({ ok: false, id: created.id, error: `Upload failed: HTTP ${uploadRes.status}` }, null, 2) }] };
+          }
+        } finally {
+          try {
+            await (0, import_promises.rm)(tarball, { force: true });
+          } catch {
+          }
+        }
+        const publishRes = await fetch(`${endpoint}/v1/preview/${created.id}/publish`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${apiKey}` }
+        });
+        if (!publishRes.ok) {
+          const err = await publishRes.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, id: created.id, error: `Publish failed: HTTP ${publishRes.status} ${err}` }, null, 2) }] };
+        }
+        const published = await publishRes.json();
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              ok: true,
+              id: published.id,
+              preview_url: published.preview_url,
+              file_count: published.file_count,
+              total_bytes: published.total_bytes,
+              expires_at: created.expires_at
+            }, null, 2)
+          }]
+        };
+      }
+    },
+    { optional: true }
+  );
+  api.registerTool(
+    {
+      name: "riddle_preview_delete",
+      description: "Delete an ephemeral preview site created by riddle_preview. Removes all files and frees the preview ID immediately instead of waiting for auto-expiry.",
+      parameters: import_typebox.Type.Object({
+        id: import_typebox.Type.String({ description: "Preview ID (e.g. pv_a1b2c3d4)" })
+      }),
+      async execute(_id, params) {
+        const { apiKey, baseUrl } = getCfg(api);
+        if (!apiKey) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: "Missing Riddle API key." }, null, 2) }] };
+        }
+        assertAllowedBaseUrl(baseUrl);
+        const res = await fetch(`${baseUrl.replace(/\/$/, "")}/v1/preview/${params.id}`, {
+          method: "DELETE",
+          headers: { Authorization: `Bearer ${apiKey}` }
+        });
+        if (!res.ok) {
+          const err = await res.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Delete failed: HTTP ${res.status} ${err}` }, null, 2) }] };
+        }
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify({ ok: true, deleted: true, files_removed: data.files_removed }, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
 }

package/dist/index.js

@@ -1,7 +1,10 @@
 // src/index.ts
 import { Type } from "@sinclair/typebox";
-import { writeFile, mkdir } from "fs/promises";
+import { writeFile, mkdir, readFile, stat, rm } from "fs/promises";
 import { join } from "path";
+import { execFile as execFileCb } from "child_process";
+import { promisify } from "util";
+var execFile = promisify(execFileCb);
 var INLINE_CAP = 50 * 1024;
 function getCfg(api) {
   const cfg = api?.config ?? {};
@@ -729,6 +732,110 @@ function register(api) {
     },
     { optional: true }
   );
+  api.registerTool(
+    {
+      name: "riddle_preview",
+      description: "Deploy a local build directory as an ephemeral preview site. Tars the directory, uploads to Riddle, and returns a live URL at preview.riddledc.com that can be screenshotted with other riddle_* tools. Previews auto-expire after 24 hours.",
+      parameters: Type.Object({
+        directory: Type.String({ description: "Absolute path to the build output directory (e.g. /path/to/build or /path/to/dist)" }),
+        framework: Type.Optional(Type.String({ description: "Framework hint: 'spa' (default) or 'static'" }))
+      }),
+      async execute(_id, params) {
+        const { apiKey, baseUrl } = getCfg(api);
+        if (!apiKey) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: "Missing Riddle API key." }, null, 2) }] };
+        }
+        assertAllowedBaseUrl(baseUrl);
+        const dir = params.directory;
+        if (!dir || typeof dir !== "string") throw new Error("directory must be an absolute path");
+        try {
+          const st = await stat(dir);
+          if (!st.isDirectory()) throw new Error(`Not a directory: ${dir}`);
+        } catch (e) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Cannot access directory: ${e.message}` }, null, 2) }] };
+        }
+        const endpoint = baseUrl.replace(/\/$/, "");
+        const createRes = await fetch(`${endpoint}/v1/preview`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+          body: JSON.stringify({ framework: params.framework || "spa" })
+        });
+        if (!createRes.ok) {
+          const err = await createRes.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Create failed: HTTP ${createRes.status} ${err}` }, null, 2) }] };
+        }
+        const created = await createRes.json();
+        const tarball = `/tmp/riddle-preview-${created.id}.tar.gz`;
+        try {
+          await execFile("tar", ["czf", tarball, "-C", dir, "."], { timeout: 6e4 });
+          const tarData = await readFile(tarball);
+          const uploadRes = await fetch(created.upload_url, {
+            method: "PUT",
+            headers: { "Content-Type": "application/gzip" },
+            body: tarData
+          });
+          if (!uploadRes.ok) {
+            return { content: [{ type: "text", text: JSON.stringify({ ok: false, id: created.id, error: `Upload failed: HTTP ${uploadRes.status}` }, null, 2) }] };
+          }
+        } finally {
+          try {
+            await rm(tarball, { force: true });
+          } catch {
+          }
+        }
+        const publishRes = await fetch(`${endpoint}/v1/preview/${created.id}/publish`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${apiKey}` }
+        });
+        if (!publishRes.ok) {
+          const err = await publishRes.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, id: created.id, error: `Publish failed: HTTP ${publishRes.status} ${err}` }, null, 2) }] };
+        }
+        const published = await publishRes.json();
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              ok: true,
+              id: published.id,
+              preview_url: published.preview_url,
+              file_count: published.file_count,
+              total_bytes: published.total_bytes,
+              expires_at: created.expires_at
+            }, null, 2)
+          }]
+        };
+      }
+    },
+    { optional: true }
+  );
+  api.registerTool(
+    {
+      name: "riddle_preview_delete",
+      description: "Delete an ephemeral preview site created by riddle_preview. Removes all files and frees the preview ID immediately instead of waiting for auto-expiry.",
+      parameters: Type.Object({
+        id: Type.String({ description: "Preview ID (e.g. pv_a1b2c3d4)" })
+      }),
+      async execute(_id, params) {
+        const { apiKey, baseUrl } = getCfg(api);
+        if (!apiKey) {
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: "Missing Riddle API key." }, null, 2) }] };
+        }
+        assertAllowedBaseUrl(baseUrl);
+        const res = await fetch(`${baseUrl.replace(/\/$/, "")}/v1/preview/${params.id}`, {
+          method: "DELETE",
+          headers: { Authorization: `Bearer ${apiKey}` }
+        });
+        if (!res.ok) {
+          const err = await res.text();
+          return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: `Delete failed: HTTP ${res.status} ${err}` }, null, 2) }] };
+        }
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify({ ok: true, deleted: true, files_removed: data.files_removed }, null, 2) }] };
+      }
+    },
+    { optional: true }
+  );
 }
 export {
   register as default

package/openclaw.plugin.json

@@ -2,14 +2,15 @@
   "id": "openclaw-riddledc",
   "name": "Riddle",
   "description": "Riddle (riddledc.com) hosted browser API tools for OpenClaw agents.",
-  "version": "0.5.6",
-  "notes": "0.4.0: Added riddle_scrape, riddle_map, riddle_crawl convenience tools. Updated riddle_steps and riddle_script descriptions with data extraction capabilities.",
+  "version": "0.6.0",
+  "notes": "0.6.0: Added riddle_preview and riddle_preview_delete tools for ephemeral preview hosting at preview.riddledc.com.",
   "type": "plugin",
   "bundledSkills": [],
   "capabilities": {
     "network": {
       "egress": [
-        "api.riddledc.com"
+        "api.riddledc.com",
+        "preview.riddledc.com"
       ],
       "enforced": true,
       "note": "Hardcoded allowlist in assertAllowedBaseUrl() - cannot be overridden by config"
@@ -37,7 +38,9 @@
         "riddle_scrape",
         "riddle_map",
         "riddle_crawl",
-        "riddle_visual_diff"
+        "riddle_visual_diff",
+        "riddle_preview",
+        "riddle_preview_delete"
       ],
       "invokes": [],
       "note": "Provides tools for agent use; does not invoke other agent tools"

package/package.json

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