@riddledc/riddle-proof 0.5.53 → 0.5.54

package/dist/riddle-client.cjs

@@ -0,0 +1,207 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/riddle-client.ts
+var riddle_client_exports = {};
+__export(riddle_client_exports, {
+  DEFAULT_RIDDLE_API_BASE_URL: () => DEFAULT_RIDDLE_API_BASE_URL,
+  DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
+  RiddleApiError: () => RiddleApiError,
+  createRiddleApiClient: () => createRiddleApiClient,
+  deployRiddleStaticPreview: () => deployRiddleStaticPreview,
+  isTerminalRiddleJobStatus: () => isTerminalRiddleJobStatus,
+  parseRiddleViewport: () => parseRiddleViewport,
+  pollRiddleJob: () => pollRiddleJob,
+  resolveRiddleApiKey: () => resolveRiddleApiKey,
+  riddleRequestJson: () => riddleRequestJson,
+  runRiddleScript: () => runRiddleScript
+});
+module.exports = __toCommonJS(riddle_client_exports);
+var import_node_child_process = require("child_process");
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = __toESM(require("path"), 1);
+var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
+var DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+var RiddleApiError = class extends Error {
+  constructor(pathname, status, body) {
+    super(`Riddle API ${pathname} failed HTTP ${status}: ${body}`);
+    this.name = "RiddleApiError";
+    this.status = status;
+    this.body = body;
+    this.path = pathname;
+  }
+};
+function normalizeBaseUrl(value) {
+  return (value || DEFAULT_RIDDLE_API_BASE_URL).replace(/\/$/, "");
+}
+function fetchFor(config = {}) {
+  return config.fetchImpl || fetch;
+}
+function resolveRiddleApiKey(config = {}) {
+  if (config.apiKey?.trim()) return config.apiKey.trim();
+  if (process.env.RIDDLE_API_KEY?.trim()) return process.env.RIDDLE_API_KEY.trim();
+  const keyFile = config.apiKeyFile || process.env.RIDDLE_API_KEY_FILE || DEFAULT_RIDDLE_API_KEY_FILE;
+  if ((0, import_node_fs.existsSync)(keyFile)) {
+    const key = (0, import_node_fs.readFileSync)(keyFile, "utf8").trim();
+    if (key) return key;
+  }
+  throw new Error(`Riddle API key missing. Set RIDDLE_API_KEY or write ${DEFAULT_RIDDLE_API_KEY_FILE}.`);
+}
+async function riddleRequestJson(config, pathname, init = {}) {
+  const response = await fetchFor(config)(`${normalizeBaseUrl(config.apiBaseUrl)}${pathname}`, {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${resolveRiddleApiKey(config)}`,
+      "Content-Type": "application/json",
+      ...init.headers || {}
+    }
+  });
+  const text = await response.text();
+  let json = null;
+  try {
+    json = JSON.parse(text);
+  } catch {
+  }
+  if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
+  return json ?? text;
+}
+async function deployRiddleStaticPreview(config, directory, label) {
+  if (!directory?.trim()) throw new Error("directory is required");
+  if (!label?.trim()) throw new Error("label is required");
+  const created = await riddleRequestJson(config, "/v1/preview", {
+    method: "POST",
+    body: JSON.stringify({ framework: "spa", label })
+  });
+  const id = String(created.id || "");
+  const uploadUrl = String(created.upload_url || "");
+  if (!id || !uploadUrl) throw new Error("Riddle preview create response was missing id or upload_url.");
+  const scratch = (0, import_node_fs.mkdtempSync)(import_node_path.default.join((0, import_node_os.tmpdir)(), "riddle-preview-upload-"));
+  const tarball = import_node_path.default.join(scratch, `${id}.tar.gz`);
+  try {
+    (0, import_node_child_process.execFileSync)("tar", ["czf", tarball, "-C", directory, "."], { stdio: "pipe" });
+    const upload = await fetchFor(config)(uploadUrl, {
+      method: "PUT",
+      headers: { "Content-Type": "application/gzip" },
+      body: (0, import_node_fs.readFileSync)(tarball)
+    });
+    if (!upload.ok) {
+      throw new RiddleApiError(uploadUrl, upload.status, await upload.text());
+    }
+  } finally {
+    (0, import_node_fs.rmSync)(scratch, { recursive: true, force: true });
+  }
+  const published = await riddleRequestJson(config, `/v1/preview/${id}/publish`, {
+    method: "POST"
+  });
+  return {
+    ok: true,
+    id: String(published.id || id),
+    label,
+    preview_url: String(published.preview_url || ""),
+    file_count: typeof published.file_count === "number" ? published.file_count : void 0,
+    total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
+    expires_at: typeof created.expires_at === "string" ? created.expires_at : void 0,
+    raw: published
+  };
+}
+function parseRiddleViewport(value) {
+  if (!value) return void 0;
+  const match = /^(\d+)x(\d+)$/.exec(value.trim());
+  if (!match) throw new Error("viewport must look like 1280x720");
+  return { width: Number(match[1]), height: Number(match[2]) };
+}
+async function runRiddleScript(config, input) {
+  if (!input.url?.trim()) throw new Error("url is required");
+  if (!input.script?.trim()) throw new Error("script is required");
+  const payload = {
+    url: input.url,
+    script: input.script,
+    sync: input.sync ?? false,
+    timeout_sec: input.timeoutSec || 120
+  };
+  if (input.viewport) payload.viewport = input.viewport;
+  if (input.include) payload.include = input.include;
+  if (input.options) payload.options = input.options;
+  return riddleRequestJson(config, "/v1/run", {
+    method: "POST",
+    body: JSON.stringify(payload)
+  });
+}
+function isTerminalRiddleJobStatus(status) {
+  return ["completed", "complete", "completed_error", "completed_timeout", "failed"].includes(String(status || ""));
+}
+async function pollRiddleJob(config, jobId, options = {}) {
+  if (!jobId?.trim()) throw new Error("jobId is required");
+  const attempts = options.attempts || (options.wait ? 60 : 1);
+  const intervalMs = options.intervalMs || 2e3;
+  let job = null;
+  for (let index = 0; index < attempts; index += 1) {
+    job = await riddleRequestJson(config, `/v1/jobs/${jobId}`);
+    if (isTerminalRiddleJobStatus(job.status)) break;
+    if (index + 1 < attempts) {
+      await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+  }
+  const status = job?.status ? String(job.status) : null;
+  if (!isTerminalRiddleJobStatus(status)) {
+    return { ok: true, job_id: jobId, status, terminal: false, job };
+  }
+  const artifacts = await riddleRequestJson(config, `/v1/jobs/${jobId}/artifacts`);
+  return {
+    ok: status === "completed" || status === "complete",
+    job_id: jobId,
+    status,
+    terminal: true,
+    job,
+    artifacts
+  };
+}
+function createRiddleApiClient(config = {}) {
+  return {
+    requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
+    runScript: (input) => runRiddleScript(config, input),
+    pollJob: (jobId, options) => pollRiddleJob(config, jobId, options)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_RIDDLE_API_BASE_URL,
+  DEFAULT_RIDDLE_API_KEY_FILE,
+  RiddleApiError,
+  createRiddleApiClient,
+  deployRiddleStaticPreview,
+  isTerminalRiddleJobStatus,
+  parseRiddleViewport,
+  pollRiddleJob,
+  resolveRiddleApiKey,
+  riddleRequestJson,
+  runRiddleScript
+});

package/dist/riddle-client.d.cts

@@ -0,0 +1,71 @@
+declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
+declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+type RiddleFetch = typeof fetch;
+interface RiddleClientConfig {
+    apiKey?: string;
+    apiKeyFile?: string;
+    apiBaseUrl?: string;
+    fetchImpl?: RiddleFetch;
+}
+interface RiddlePreviewDeployResult {
+    ok: true;
+    id: string;
+    label: string;
+    preview_url: string;
+    file_count?: number;
+    total_bytes?: number;
+    expires_at?: string;
+    raw?: Record<string, unknown>;
+}
+interface RiddleRunScriptInput {
+    url: string;
+    script: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeoutSec?: number;
+    sync?: boolean;
+    include?: string[];
+    options?: Record<string, unknown>;
+}
+interface RiddlePollJobResult {
+    ok: boolean;
+    job_id: string;
+    status: string | null;
+    terminal: boolean;
+    job: Record<string, unknown> | null;
+    artifacts?: Record<string, unknown> | null;
+}
+declare class RiddleApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    readonly path: string;
+    constructor(pathname: string, status: number, body: string);
+}
+declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
+declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
+declare function parseRiddleViewport(value?: string): {
+    width: number;
+    height: number;
+} | undefined;
+declare function runRiddleScript(config: RiddleClientConfig, input: RiddleRunScriptInput): Promise<Record<string, unknown>>;
+declare function isTerminalRiddleJobStatus(status: unknown): boolean;
+declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: {
+    wait?: boolean;
+    attempts?: number;
+    intervalMs?: number;
+}): Promise<RiddlePollJobResult>;
+declare function createRiddleApiClient(config?: RiddleClientConfig): {
+    requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
+    runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
+    pollJob: (jobId: string, options?: {
+        wait?: boolean;
+        attempts?: number;
+        intervalMs?: number;
+    }) => Promise<RiddlePollJobResult>;
+};
+
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobResult, type RiddlePreviewDeployResult, type RiddleRunScriptInput, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript };

package/dist/riddle-client.d.ts

@@ -0,0 +1,71 @@
+declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
+declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+type RiddleFetch = typeof fetch;
+interface RiddleClientConfig {
+    apiKey?: string;
+    apiKeyFile?: string;
+    apiBaseUrl?: string;
+    fetchImpl?: RiddleFetch;
+}
+interface RiddlePreviewDeployResult {
+    ok: true;
+    id: string;
+    label: string;
+    preview_url: string;
+    file_count?: number;
+    total_bytes?: number;
+    expires_at?: string;
+    raw?: Record<string, unknown>;
+}
+interface RiddleRunScriptInput {
+    url: string;
+    script: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeoutSec?: number;
+    sync?: boolean;
+    include?: string[];
+    options?: Record<string, unknown>;
+}
+interface RiddlePollJobResult {
+    ok: boolean;
+    job_id: string;
+    status: string | null;
+    terminal: boolean;
+    job: Record<string, unknown> | null;
+    artifacts?: Record<string, unknown> | null;
+}
+declare class RiddleApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    readonly path: string;
+    constructor(pathname: string, status: number, body: string);
+}
+declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
+declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
+declare function parseRiddleViewport(value?: string): {
+    width: number;
+    height: number;
+} | undefined;
+declare function runRiddleScript(config: RiddleClientConfig, input: RiddleRunScriptInput): Promise<Record<string, unknown>>;
+declare function isTerminalRiddleJobStatus(status: unknown): boolean;
+declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: {
+    wait?: boolean;
+    attempts?: number;
+    intervalMs?: number;
+}): Promise<RiddlePollJobResult>;
+declare function createRiddleApiClient(config?: RiddleClientConfig): {
+    requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
+    runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
+    pollJob: (jobId: string, options?: {
+        wait?: boolean;
+        attempts?: number;
+        intervalMs?: number;
+    }) => Promise<RiddlePollJobResult>;
+};
+
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobResult, type RiddlePreviewDeployResult, type RiddleRunScriptInput, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript };

package/dist/riddle-client.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_RIDDLE_API_BASE_URL,
+  DEFAULT_RIDDLE_API_KEY_FILE,
+  RiddleApiError,
+  createRiddleApiClient,
+  deployRiddleStaticPreview,
+  isTerminalRiddleJobStatus,
+  parseRiddleViewport,
+  pollRiddleJob,
+  resolveRiddleApiKey,
+  riddleRequestJson,
+  runRiddleScript
+} from "./chunk-UR6ADV4Y.js";
+export {
+  DEFAULT_RIDDLE_API_BASE_URL,
+  DEFAULT_RIDDLE_API_KEY_FILE,
+  RiddleApiError,
+  createRiddleApiClient,
+  deployRiddleStaticPreview,
+  isTerminalRiddleJobStatus,
+  parseRiddleViewport,
+  pollRiddleJob,
+  resolveRiddleApiKey,
+  riddleRequestJson,
+  runRiddleScript
+};

package/dist/run-card.js

@@ -1,8 +1,8 @@
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-53UPEUVU.js";
-import "./chunk-T5RHGGQ2.js";
+} from "./chunk-3UHWI3FO.js";
+import "./chunk-33XO42CY.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_RUN_CARD_VERSION,

package/dist/runner.cjs

@@ -204,6 +204,7 @@ function normalizeRunParams(input) {
     leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
+    riddle_engine_module_url: input.riddle_engine_module_url,
     max_iterations: input.max_iterations,
     auto_approve: input.auto_approve,
     dry_run: input.dry_run,

package/dist/runner.js

@@ -1,9 +1,9 @@
 import {
   runRiddleProof
-} from "./chunk-QBOKV3ES.js";
-import "./chunk-PVUZZ2P6.js";
-import "./chunk-53UPEUVU.js";
-import "./chunk-T5RHGGQ2.js";
+} from "./chunk-RXFKKYWA.js";
+import "./chunk-MO24D3PY.js";
+import "./chunk-3UHWI3FO.js";
+import "./chunk-33XO42CY.js";
 import "./chunk-DUFDZJOF.js";
 export {
   runRiddleProof

package/dist/state.cjs

@@ -377,6 +377,7 @@ function normalizeRunParams(input) {
     leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
+    riddle_engine_module_url: input.riddle_engine_module_url,
     max_iterations: input.max_iterations,
     auto_approve: input.auto_approve,
     dry_run: input.dry_run,

package/dist/state.js

@@ -9,9 +9,9 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-PVUZZ2P6.js";
-import "./chunk-53UPEUVU.js";
-import "./chunk-T5RHGGQ2.js";
+} from "./chunk-MO24D3PY.js";
+import "./chunk-3UHWI3FO.js";
+import "./chunk-33XO42CY.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

package/dist/types.d.cts

@@ -47,6 +47,7 @@ interface RiddleProofRunParams {
     leave_draft?: boolean;
     engine_state_path?: string;
     harness_state_path?: string;
+    riddle_engine_module_url?: string;
     max_iterations?: number;
     auto_approve?: boolean;
     dry_run?: boolean;

package/dist/types.d.ts

@@ -47,6 +47,7 @@ interface RiddleProofRunParams {
     leave_draft?: boolean;
     engine_state_path?: string;
     harness_state_path?: string;
+    riddle_engine_module_url?: string;
     max_iterations?: number;
     auto_approve?: boolean;
     dry_run?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.53",
+  "version": "0.5.54",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",
@@ -93,6 +93,11 @@
       "types": "./dist/proof-run-engine.d.ts",
       "import": "./dist/proof-run-engine.js",
       "require": "./dist/proof-run-engine.cjs"
+    },
+    "./riddle-client": {
+      "types": "./dist/riddle-client.d.ts",
+      "import": "./dist/riddle-client.js",
+      "require": "./dist/riddle-client.cjs"
     }
   },
   "bin": {
@@ -115,7 +120,7 @@
     "typescript": "^5.4.5"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/types.ts src/result.ts src/state.ts src/checkpoint.ts src/run-card.ts src/runner.ts src/engine-harness.ts src/codex-exec-agent.ts src/local-agent.ts src/cli.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts --format cjs,esm --dts --out-dir dist --clean",
+    "build": "tsup src/index.ts src/types.ts src/result.ts src/state.ts src/checkpoint.ts src/run-card.ts src/runner.ts src/engine-harness.ts src/codex-exec-agent.ts src/local-agent.ts src/cli.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts src/riddle-client.ts --format cjs,esm --dts --out-dir dist --clean",
     "clean": "rm -rf dist",
     "lint": "echo 'lint: (not configured)'",
     "test": "npm run build && node test.js && node proof-run.test.js"