@riddledc/riddle-proof 0.5.54 → 0.5.56

package/dist/riddle-client.cjs

@@ -40,7 +40,8 @@ __export(riddle_client_exports, {
   pollRiddleJob: () => pollRiddleJob,
   resolveRiddleApiKey: () => resolveRiddleApiKey,
   riddleRequestJson: () => riddleRequestJson,
-  runRiddleScript: () => runRiddleScript
+  runRiddleScript: () => runRiddleScript,
+  runRiddleServerPreview: () => runRiddleServerPreview
 });
 module.exports = __toCommonJS(riddle_client_exports);
 var import_node_child_process = require("child_process");
@@ -131,12 +132,94 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+function createTarball(directory, label, exclude = []) {
+  const scratch = (0, import_node_fs.mkdtempSync)(import_node_path.default.join((0, import_node_os.tmpdir)(), "riddle-upload-"));
+  const tarball = import_node_path.default.join(scratch, `${label}.tar.gz`);
+  const excludeArgs = exclude.flatMap((item) => ["--exclude", item]);
+  try {
+    (0, import_node_child_process.execFileSync)("tar", ["czf", tarball, ...excludeArgs, "-C", directory, "."], { stdio: "pipe" });
+    return { scratch, tarball };
+  } catch (error) {
+    (0, import_node_fs.rmSync)(scratch, { recursive: true, force: true });
+    throw error;
+  }
+}
 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]) };
 }
+function scriptErrorFrom(job) {
+  const nested = job?.proof_of_execution && typeof job.proof_of_execution === "object" && !Array.isArray(job.proof_of_execution) ? job.proof_of_execution : null;
+  return typeof job?.script_error === "string" && job.script_error.trim() ? job.script_error : typeof nested?.script_error === "string" && nested.script_error.trim() ? nested.script_error : null;
+}
+async function runRiddleServerPreview(config, input) {
+  if (!input.directory?.trim()) throw new Error("directory is required");
+  if (!input.script?.trim()) throw new Error("script is required");
+  const port = input.port || 3e3;
+  const routePath = input.path || "/";
+  const timeoutSec = input.timeoutSec || 180;
+  const created = await riddleRequestJson(config, "/v1/server-preview", {
+    method: "POST",
+    body: JSON.stringify({
+      image: input.image || "node:22-slim",
+      command: input.command || "node scripts/riddleSpaPreviewServer.mjs build 3000",
+      port,
+      path: routePath,
+      readiness_path: input.readinessPath || routePath,
+      readiness_timeout: input.readinessTimeoutSec || 90,
+      wait_until: input.waitUntil || "domcontentloaded",
+      wait_for_selector: input.waitForSelector || "body",
+      navigation_timeout: input.navigationTimeoutSec || 60,
+      viewport: input.viewport,
+      timeout: timeoutSec,
+      script: input.script
+    })
+  });
+  const jobId = String(created.job_id || "");
+  const uploadUrl = String(created.upload_url || "");
+  if (!jobId || !uploadUrl) {
+    throw new Error(`Riddle server preview create response was missing job_id or upload_url.`);
+  }
+  const { scratch, tarball } = createTarball(input.directory, jobId, [
+    ".git",
+    "node_modules",
+    "test-results",
+    ...input.exclude || []
+  ]);
+  try {
+    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 });
+  }
+  await riddleRequestJson(config, `/v1/server-preview/${jobId}/start`, {
+    method: "POST"
+  });
+  let job = null;
+  const attempts = input.pollAttempts || Math.ceil((timeoutSec + 90) / 2);
+  const intervalMs = input.pollIntervalMs || 2e3;
+  for (let index = 0; index < attempts; index += 1) {
+    job = await riddleRequestJson(config, `/v1/server-preview/${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;
+  const scriptError = scriptErrorFrom(job);
+  return {
+    ok: (status === "completed" || status === "complete") && !scriptError,
+    job_id: jobId,
+    status,
+    terminal: isTerminalRiddleJobStatus(status),
+    script_error: scriptError,
+    job
+  };
+}
 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");
@@ -188,6 +271,7 @@ function createRiddleApiClient(config = {}) {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
+    runServerPreview: (input) => runRiddleServerPreview(config, input),
     pollJob: (jobId, options) => pollRiddleJob(config, jobId, options)
   };
 }
@@ -203,5 +287,6 @@ function createRiddleApiClient(config = {}) {
   pollRiddleJob,
   resolveRiddleApiKey,
   riddleRequestJson,
-  runRiddleScript
+  runRiddleScript,
+  runRiddleServerPreview
 });

package/dist/riddle-client.d.cts

@@ -29,6 +29,27 @@ interface RiddleRunScriptInput {
     include?: string[];
     options?: Record<string, unknown>;
 }
+interface RiddleServerPreviewInput {
+    directory: string;
+    script: string;
+    image?: string;
+    command?: string;
+    port?: number;
+    path?: string;
+    readinessPath?: string;
+    readinessTimeoutSec?: number;
+    waitForSelector?: string;
+    waitUntil?: "commit" | "domcontentloaded" | "load" | "networkidle";
+    navigationTimeoutSec?: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeoutSec?: number;
+    pollAttempts?: number;
+    pollIntervalMs?: number;
+    exclude?: string[];
+}
 interface RiddlePollJobResult {
     ok: boolean;
     job_id: string;
@@ -37,6 +58,14 @@ interface RiddlePollJobResult {
     job: Record<string, unknown> | null;
     artifacts?: Record<string, unknown> | null;
 }
+interface RiddleServerPreviewResult {
+    ok: boolean;
+    job_id: string;
+    status: string | null;
+    terminal: boolean;
+    script_error: string | null;
+    job: Record<string, unknown> | null;
+}
 declare class RiddleApiError extends Error {
     readonly status: number;
     readonly body: string;
@@ -50,6 +79,7 @@ declare function parseRiddleViewport(value?: string): {
     width: number;
     height: number;
 } | undefined;
+declare function runRiddleServerPreview(config: RiddleClientConfig, input: RiddleServerPreviewInput): Promise<RiddleServerPreviewResult>;
 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?: {
@@ -61,6 +91,7 @@ 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>>;
+    runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: {
         wait?: boolean;
         attempts?: number;
@@ -68,4 +99,4 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     }) => 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 };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobResult, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.d.ts

@@ -29,6 +29,27 @@ interface RiddleRunScriptInput {
     include?: string[];
     options?: Record<string, unknown>;
 }
+interface RiddleServerPreviewInput {
+    directory: string;
+    script: string;
+    image?: string;
+    command?: string;
+    port?: number;
+    path?: string;
+    readinessPath?: string;
+    readinessTimeoutSec?: number;
+    waitForSelector?: string;
+    waitUntil?: "commit" | "domcontentloaded" | "load" | "networkidle";
+    navigationTimeoutSec?: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeoutSec?: number;
+    pollAttempts?: number;
+    pollIntervalMs?: number;
+    exclude?: string[];
+}
 interface RiddlePollJobResult {
     ok: boolean;
     job_id: string;
@@ -37,6 +58,14 @@ interface RiddlePollJobResult {
     job: Record<string, unknown> | null;
     artifacts?: Record<string, unknown> | null;
 }
+interface RiddleServerPreviewResult {
+    ok: boolean;
+    job_id: string;
+    status: string | null;
+    terminal: boolean;
+    script_error: string | null;
+    job: Record<string, unknown> | null;
+}
 declare class RiddleApiError extends Error {
     readonly status: number;
     readonly body: string;
@@ -50,6 +79,7 @@ declare function parseRiddleViewport(value?: string): {
     width: number;
     height: number;
 } | undefined;
+declare function runRiddleServerPreview(config: RiddleClientConfig, input: RiddleServerPreviewInput): Promise<RiddleServerPreviewResult>;
 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?: {
@@ -61,6 +91,7 @@ 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>>;
+    runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: {
         wait?: boolean;
         attempts?: number;
@@ -68,4 +99,4 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     }) => 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 };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobResult, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.js

@@ -9,8 +9,9 @@ import {
   pollRiddleJob,
   resolveRiddleApiKey,
   riddleRequestJson,
-  runRiddleScript
-} from "./chunk-UR6ADV4Y.js";
+  runRiddleScript,
+  runRiddleServerPreview
+} from "./chunk-3CVGVQTQ.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
@@ -22,5 +23,6 @@ export {
   pollRiddleJob,
   resolveRiddleApiKey,
   riddleRequestJson,
-  runRiddleScript
+  runRiddleScript,
+  runRiddleServerPreview
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.54",
+  "version": "0.5.56",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",
@@ -79,6 +79,11 @@
       "import": "./dist/playability.js",
       "require": "./dist/playability.cjs"
     },
+    "./basic-gameplay": {
+      "types": "./dist/basic-gameplay.d.ts",
+      "import": "./dist/basic-gameplay.js",
+      "require": "./dist/basic-gameplay.cjs"
+    },
     "./openclaw": {
       "types": "./dist/openclaw.d.ts",
       "import": "./dist/openclaw.js",
@@ -120,7 +125,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 src/riddle-client.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/basic-gameplay.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"

package/dist/{chunk-A2AWRZ5B.js → chunk-2FBF2UDZ.js}

@@ -1,8 +1,3 @@
-import {
-  visualDeltaForState,
-  visualDeltaRequiredForState,
-  visualDeltaShipGateReason
-} from "./chunk-RFJ5BQF6.js";
 import {
   appendRunEvent,
   appendStageHeartbeat,
@@ -11,6 +6,11 @@ import {
   normalizeRunParams,
   setRunStatus
 } from "./chunk-MO24D3PY.js";
+import {
+  visualDeltaForState,
+  visualDeltaRequiredForState,
+  visualDeltaShipGateReason
+} from "./chunk-RFJ5BQF6.js";
 import {
   createRiddleProofRunCard
 } from "./chunk-3UHWI3FO.js";