@riddledc/riddle-proof 0.5.33 → 0.5.35

package/dist/index.js

@@ -1,3 +1,6 @@
+import {
+  runRiddleProof
+} from "./chunk-MQ2BHHLX.js";
 import "./chunk-6F4PWJZI.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
@@ -13,11 +16,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-CHKYSZLU.js";
-import "./chunk-A5AWVY5A.js";
-import {
-  runRiddleProof
-} from "./chunk-F6VFKS7K.js";
+} from "./chunk-7R6ZQE3X.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -29,7 +28,17 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-7ZJAUEUN.js";
+} from "./chunk-OASB3CYU.js";
+import "./chunk-4YCWZVBN.js";
+import {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession,
+  compareVisualProofSessionFingerprint,
+  parseVisualProofSession,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
+} from "./chunk-ODORKNSO.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -39,19 +48,23 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-TMMKRKY5.js";
+} from "./chunk-J2MERROF.js";
 export {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
   DEFAULT_DIAGNOSTIC_STRING_LIMIT,
   RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION,
   RIDDLE_PROOF_RUN_STATE_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
   appendCaptureDiagnostic,
   appendRunEvent,
   appendStageHeartbeat,
   applyPrLifecycleState,
   applyTerminalMetadata,
+  buildVisualProofSession,
   compactRecord,
+  compareVisualProofSessionFingerprint,
   createCaptureDiagnostic,
   createDisabledRiddleProofAgentAdapter,
   createRunResult,
@@ -64,11 +77,14 @@ export {
   normalizePrLifecycleState,
   normalizeRunParams,
   normalizeTerminalMetadata,
+  parseVisualProofSession,
   readRiddleProofRunStatus,
   recordValue,
   redactForProofDiagnostics,
   runRiddleProof,
   runRiddleProofEngineHarness,
   setRunStatus,
-  summarizeCaptureArtifacts
+  summarizeCaptureArtifacts,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
 };

package/dist/openclaw.cjs

@@ -22,6 +22,7 @@ var openclaw_exports = {};
 __export(openclaw_exports, {
   openClawIntegrationContext: () => openClawIntegrationContext,
   parseOpenClawAssertions: () => parseOpenClawAssertions,
+  parseOpenClawJsonObjectOrArray: () => parseOpenClawJsonObjectOrArray,
   toRiddleProofRunParams: () => toRiddleProofRunParams
 });
 module.exports = __toCommonJS(openclaw_exports);
@@ -64,6 +65,11 @@ function normalizeRunParams(input) {
     success_criteria: input.success_criteria,
     assertions: input.assertions,
     verification_mode: input.verification_mode,
+    resume_session: input.resume_session,
+    target_image_url: input.target_image_url,
+    target_image_hash: input.target_image_hash,
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
     reference: input.reference,
     base_branch: input.base_branch,
     before_ref: input.before_ref,
@@ -106,6 +112,23 @@ function parseOpenClawAssertions(value) {
     return trimmed;
   }
 }
+function parseOpenClawJsonObjectOrArray(value, name) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`${name} is not valid JSON: ${message}`);
+  }
+  if (parsed === null || typeof parsed !== "object" && !Array.isArray(parsed)) {
+    throw new Error(`${name} must decode to a JSON object or array.`);
+  }
+  return parsed;
+}
 function normalizeOpenClawReference(value) {
   if (value !== "prod" && value !== "before" && value !== "both") return void 0;
   return value;
@@ -140,6 +163,11 @@ function toRiddleProofRunParams(params) {
     success_criteria: params.success_criteria,
     assertions: parseOpenClawAssertions(params.assertions_json),
     verification_mode: params.verification_mode,
+    resume_session: params.resume_session,
+    target_image_url: params.target_image_url,
+    target_image_hash: params.target_image_hash,
+    viewport_matrix: parseOpenClawJsonObjectOrArray(params.viewport_matrix_json, "viewport_matrix_json"),
+    deterministic_setup: parseOpenClawJsonObjectOrArray(params.deterministic_setup_json, "deterministic_setup_json"),
     reference: normalizeOpenClawReference(params.reference),
     base_branch: params.base_branch,
     before_ref: params.before_ref,
@@ -173,5 +201,6 @@ function toRiddleProofRunParams(params) {
 0 && (module.exports = {
   openClawIntegrationContext,
   parseOpenClawAssertions,
+  parseOpenClawJsonObjectOrArray,
   toRiddleProofRunParams
 });

package/dist/openclaw.d.cts

@@ -10,6 +10,11 @@ interface OpenClawProofedChangeParams {
     success_criteria?: string;
     assertions_json?: string;
     verification_mode?: string;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix_json?: string;
+    deterministic_setup_json?: string;
     reference?: "prod" | "before" | "both" | (string & {});
     base_branch?: string;
     before_ref?: string;
@@ -43,7 +48,8 @@ interface OpenClawProofedChangeParams {
     discord_source_url?: string;
 }
 declare function parseOpenClawAssertions(value: unknown): JsonValue | undefined;
+declare function parseOpenClawJsonObjectOrArray(value: unknown, name: string): JsonValue | undefined;
 declare function openClawIntegrationContext(params: OpenClawProofedChangeParams): IntegrationContext;
 declare function toRiddleProofRunParams(params: OpenClawProofedChangeParams): RiddleProofRunParams;
 
-export { type OpenClawProofedChangeParams, openClawIntegrationContext, parseOpenClawAssertions, toRiddleProofRunParams };
+export { type OpenClawProofedChangeParams, openClawIntegrationContext, parseOpenClawAssertions, parseOpenClawJsonObjectOrArray, toRiddleProofRunParams };

package/dist/openclaw.d.ts

@@ -10,6 +10,11 @@ interface OpenClawProofedChangeParams {
     success_criteria?: string;
     assertions_json?: string;
     verification_mode?: string;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix_json?: string;
+    deterministic_setup_json?: string;
     reference?: "prod" | "before" | "both" | (string & {});
     base_branch?: string;
     before_ref?: string;
@@ -43,7 +48,8 @@ interface OpenClawProofedChangeParams {
     discord_source_url?: string;
 }
 declare function parseOpenClawAssertions(value: unknown): JsonValue | undefined;
+declare function parseOpenClawJsonObjectOrArray(value: unknown, name: string): JsonValue | undefined;
 declare function openClawIntegrationContext(params: OpenClawProofedChangeParams): IntegrationContext;
 declare function toRiddleProofRunParams(params: OpenClawProofedChangeParams): RiddleProofRunParams;
 
-export { type OpenClawProofedChangeParams, openClawIntegrationContext, parseOpenClawAssertions, toRiddleProofRunParams };
+export { type OpenClawProofedChangeParams, openClawIntegrationContext, parseOpenClawAssertions, parseOpenClawJsonObjectOrArray, toRiddleProofRunParams };

package/dist/openclaw.js

@@ -1,10 +1,10 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-7ZJAUEUN.js";
+} from "./chunk-OASB3CYU.js";
 import {
   compactRecord
-} from "./chunk-TMMKRKY5.js";
+} from "./chunk-J2MERROF.js";
 
 // src/openclaw.ts
 function parseOpenClawAssertions(value) {
@@ -18,6 +18,23 @@ function parseOpenClawAssertions(value) {
     return trimmed;
   }
 }
+function parseOpenClawJsonObjectOrArray(value, name) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`${name} is not valid JSON: ${message}`);
+  }
+  if (parsed === null || typeof parsed !== "object" && !Array.isArray(parsed)) {
+    throw new Error(`${name} must decode to a JSON object or array.`);
+  }
+  return parsed;
+}
 function normalizeOpenClawReference(value) {
   if (value !== "prod" && value !== "before" && value !== "both") return void 0;
   return value;
@@ -52,6 +69,11 @@ function toRiddleProofRunParams(params) {
     success_criteria: params.success_criteria,
     assertions: parseOpenClawAssertions(params.assertions_json),
     verification_mode: params.verification_mode,
+    resume_session: params.resume_session,
+    target_image_url: params.target_image_url,
+    target_image_hash: params.target_image_hash,
+    viewport_matrix: parseOpenClawJsonObjectOrArray(params.viewport_matrix_json, "viewport_matrix_json"),
+    deterministic_setup: parseOpenClawJsonObjectOrArray(params.deterministic_setup_json, "deterministic_setup_json"),
     reference: normalizeOpenClawReference(params.reference),
     base_branch: params.base_branch,
     before_ref: params.before_ref,
@@ -84,5 +106,6 @@ function toRiddleProofRunParams(params) {
 export {
   openClawIntegrationContext,
   parseOpenClawAssertions,
+  parseOpenClawJsonObjectOrArray,
   toRiddleProofRunParams
 };

package/dist/proof-run-core.cjs

@@ -122,6 +122,11 @@ function ensureAction(action) {
 function workflowFile(riddleProofDir, action) {
   return import_node_path.default.join(riddleProofDir, "pipelines", `riddle-proof-${action}.lobster`);
 }
+function asJsonString(value) {
+  if (value === void 0 || value === null || value === "") return "";
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
 function buildSetupArgs(params, config) {
   if (!params.repo) throw new Error("repo is required for setup/run");
   if (!params.change_request) throw new Error("change_request is required for setup/run");
@@ -137,8 +142,13 @@ function buildSetupArgs(params, config) {
     prod_url: params.prod_url || "",
     capture_script: captureScript,
     success_criteria: params.success_criteria || "",
-    assertions_json: params.assertions_json || "",
+    assertions_json: params.assertions_json || asJsonString(params.assertions),
     verification_mode: params.verification_mode || "proof",
+    resume_session: params.resume_session || "",
+    target_image_url: params.target_image_url || "",
+    target_image_hash: params.target_image_hash || "",
+    viewport_matrix_json: params.viewport_matrix_json || asJsonString(params.viewport_matrix),
+    deterministic_setup_json: params.deterministic_setup_json || asJsonString(params.deterministic_setup),
     reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
@@ -708,6 +718,11 @@ function mergeStateFromParams(statePath, params) {
     "success_criteria",
     "assertions_json",
     "verification_mode",
+    "resume_session",
+    "target_image_url",
+    "target_image_hash",
+    "viewport_matrix_json",
+    "deterministic_setup_json",
     "base_branch",
     "before_ref",
     "context",
@@ -939,7 +954,10 @@ function summarizeState(state) {
     explicit_stage_gate: Boolean(state.explicit_stage_gate),
     last_requested_advance_stage: state.last_requested_advance_stage || null,
     recon_results: state.recon_results || null,
-    verify_results: state.verify_results || null
+    verify_results: state.verify_results || null,
+    proof_session: state.proof_session || null,
+    parent_proof_session: state.parent_proof_session || null,
+    proof_session_artifact_url: state.proof_session_artifact_url || null
   };
   const parts = [
     state.workspace_ready ? "workspace ready" : "workspace not ready",

package/dist/proof-run-core.d.cts

@@ -10,8 +10,16 @@ interface WorkflowParams {
     prod_url?: string;
     capture_script?: string;
     success_criteria?: string;
+    assertions?: unknown;
     assertions_json?: string;
     verification_mode?: string;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: unknown;
+    viewport_matrix_json?: string;
+    deterministic_setup?: unknown;
+    deterministic_setup_json?: string;
     reference?: "prod" | "before" | "both";
     base_branch?: string;
     before_ref?: string;
@@ -102,6 +110,11 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     success_criteria: string;
     assertions_json: string;
     verification_mode: string;
+    resume_session: string;
+    target_image_url: string;
+    target_image_hash: string;
+    viewport_matrix_json: string;
+    deterministic_setup_json: string;
     reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
@@ -287,6 +300,9 @@ declare function summarizeState(state: any): {
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     };
 };
 

package/dist/proof-run-core.d.ts

@@ -10,8 +10,16 @@ interface WorkflowParams {
     prod_url?: string;
     capture_script?: string;
     success_criteria?: string;
+    assertions?: unknown;
     assertions_json?: string;
     verification_mode?: string;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: unknown;
+    viewport_matrix_json?: string;
+    deterministic_setup?: unknown;
+    deterministic_setup_json?: string;
     reference?: "prod" | "before" | "both";
     base_branch?: string;
     before_ref?: string;
@@ -102,6 +110,11 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     success_criteria: string;
     assertions_json: string;
     verification_mode: string;
+    resume_session: string;
+    target_image_url: string;
+    target_image_hash: string;
+    viewport_matrix_json: string;
+    deterministic_setup_json: string;
     reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
@@ -287,6 +300,9 @@ declare function summarizeState(state: any): {
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     };
 };
 

package/dist/proof-run-core.js

@@ -24,7 +24,7 @@ import {
   visualDeltaShipGateReason,
   workflowFile,
   writeState
-} from "./chunk-A5AWVY5A.js";
+} from "./chunk-4YCWZVBN.js";
 export {
   BUNDLED_RIDDLE_PROOF_DIR,
   CHECKPOINT_CONTRACT_VERSION,

package/dist/proof-run-engine.cjs

@@ -104,6 +104,11 @@ function ensureAction(action) {
 function workflowFile(riddleProofDir, action) {
   return import_node_path.default.join(riddleProofDir, "pipelines", `riddle-proof-${action}.lobster`);
 }
+function asJsonString(value) {
+  if (value === void 0 || value === null || value === "") return "";
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
 function buildSetupArgs(params, config) {
   if (!params.repo) throw new Error("repo is required for setup/run");
   if (!params.change_request) throw new Error("change_request is required for setup/run");
@@ -119,8 +124,13 @@ function buildSetupArgs(params, config) {
     prod_url: params.prod_url || "",
     capture_script: captureScript,
     success_criteria: params.success_criteria || "",
-    assertions_json: params.assertions_json || "",
+    assertions_json: params.assertions_json || asJsonString(params.assertions),
     verification_mode: params.verification_mode || "proof",
+    resume_session: params.resume_session || "",
+    target_image_url: params.target_image_url || "",
+    target_image_hash: params.target_image_hash || "",
+    viewport_matrix_json: params.viewport_matrix_json || asJsonString(params.viewport_matrix),
+    deterministic_setup_json: params.deterministic_setup_json || asJsonString(params.deterministic_setup),
     reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
@@ -690,6 +700,11 @@ function mergeStateFromParams(statePath, params) {
     "success_criteria",
     "assertions_json",
     "verification_mode",
+    "resume_session",
+    "target_image_url",
+    "target_image_hash",
+    "viewport_matrix_json",
+    "deterministic_setup_json",
     "base_branch",
     "before_ref",
     "context",
@@ -921,7 +936,10 @@ function summarizeState(state) {
     explicit_stage_gate: Boolean(state.explicit_stage_gate),
     last_requested_advance_stage: state.last_requested_advance_stage || null,
     recon_results: state.recon_results || null,
-    verify_results: state.verify_results || null
+    verify_results: state.verify_results || null,
+    proof_session: state.proof_session || null,
+    parent_proof_session: state.parent_proof_session || null,
+    proof_session_artifact_url: state.proof_session_artifact_url || null
   };
   const parts = [
     state.workspace_ready ? "workspace ready" : "workspace not ready",

package/dist/proof-run-engine.d.cts

@@ -83,6 +83,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -172,6 +175,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -259,6 +265,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: any;
     cleanup: Record<string, unknown> | null;
@@ -339,6 +348,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: any;
     error: any;
@@ -422,6 +434,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     decisionRequest: any;
     checkpointContract: any;
@@ -509,6 +524,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     };
     state_path: string;
     ok?: undefined;
@@ -594,6 +612,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     shipReport: any;
     checkpointContract: Record<string, unknown>;
@@ -674,6 +695,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: null;
     autoApproved: any;

package/dist/proof-run-engine.d.ts

@@ -83,6 +83,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -172,6 +175,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -259,6 +265,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: any;
     cleanup: Record<string, unknown> | null;
@@ -339,6 +348,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: any;
     error: any;
@@ -422,6 +434,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     decisionRequest: any;
     checkpointContract: any;
@@ -509,6 +524,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     };
     state_path: string;
     ok?: undefined;
@@ -594,6 +612,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     shipReport: any;
     checkpointContract: Record<string, unknown>;
@@ -674,6 +695,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: null;
     autoApproved: any;

package/dist/proof-run-engine.js

@@ -14,7 +14,7 @@ import {
   validateShipGate,
   workflowFile,
   writeState
-} from "./chunk-A5AWVY5A.js";
+} from "./chunk-4YCWZVBN.js";
 
 // src/proof-run-engine.ts
 import { execFileSync } from "child_process";