@riddledc/riddle-proof 0.5.33 → 0.5.35

package/dist/{chunk-A5AWVY5A.js → chunk-4YCWZVBN.js}

@@ -63,6 +63,11 @@ function ensureAction(action) {
 function workflowFile(riddleProofDir, action) {
   return path.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");
@@ -78,8 +83,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 || "",
@@ -649,6 +659,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",
@@ -880,7 +895,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/{chunk-CHKYSZLU.js → chunk-7R6ZQE3X.js}

@@ -1,6 +1,3 @@
-import {
-  visualDeltaShipGateReason
-} from "./chunk-A5AWVY5A.js";
 import {
   appendRunEvent,
   appendStageHeartbeat,
@@ -8,7 +5,10 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-7ZJAUEUN.js";
+} from "./chunk-OASB3CYU.js";
+import {
+  visualDeltaShipGateReason
+} from "./chunk-4YCWZVBN.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -16,7 +16,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-TMMKRKY5.js";
+} from "./chunk-J2MERROF.js";
 
 // src/engine-harness.ts
 import { execFileSync } from "child_process";

package/dist/{chunk-TMMKRKY5.js → chunk-J2MERROF.js}

@@ -202,6 +202,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });

package/dist/{chunk-F6VFKS7K.js → chunk-MQ2BHHLX.js}

@@ -3,10 +3,10 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-7ZJAUEUN.js";
+} from "./chunk-OASB3CYU.js";
 import {
   createRunResult
-} from "./chunk-TMMKRKY5.js";
+} from "./chunk-J2MERROF.js";
 
 // src/runner.ts
 function errorDetails(error) {

package/dist/{chunk-7ZJAUEUN.js → chunk-OASB3CYU.js}

@@ -3,7 +3,7 @@ import {
   isTerminalStatus,
   nonEmptyString,
   recordValue
-} from "./chunk-TMMKRKY5.js";
+} from "./chunk-J2MERROF.js";
 
 // src/state.ts
 var RIDDLE_PROOF_RUN_STATE_VERSION = "riddle-proof.run-state.v1";
@@ -77,6 +77,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,

package/dist/chunk-ODORKNSO.js

@@ -0,0 +1,121 @@
+// src/proof-session.ts
+import { createHash, randomUUID } from "crypto";
+var RIDDLE_PROOF_VISUAL_SESSION_VERSION = "riddle-proof.visual-session.v1";
+var RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION = "riddle-proof.visual-session.fingerprint.v1";
+function trim(value) {
+  const text = String(value ?? "").trim();
+  return text || void 0;
+}
+function hashString(value) {
+  const text = trim(value);
+  if (!text) return void 0;
+  return createHash("sha256").update(text).digest("hex");
+}
+function stableJson(value) {
+  if (value === void 0) return "null";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) return `[${value.map((item) => stableJson(item)).join(",")}]`;
+  const record = value;
+  return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+}
+function withoutUndefined(record) {
+  for (const key of Object.keys(record)) {
+    if (record[key] === void 0) delete record[key];
+  }
+  return record;
+}
+function visualSessionFingerprintBasis(input) {
+  return withoutUndefined({
+    version: RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+    repo: trim(input.repo),
+    route: trim(input.route),
+    wait_for_selector: trim(input.wait_for_selector),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode)?.toLowerCase(),
+    target_image_url: trim(input.target_image_url),
+    target_image_hash: trim(input.target_image_hash),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    assertions: input.assertions,
+    capture_script_hash: hashString(input.capture_script)
+  });
+}
+function visualSessionFingerprint(input) {
+  const basis = input.version === RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION ? input : visualSessionFingerprintBasis(input);
+  return createHash("sha256").update(stableJson(basis)).digest("hex");
+}
+function buildVisualProofSession(input) {
+  const basis = visualSessionFingerprintBasis(input);
+  const fingerprint = visualSessionFingerprint(basis);
+  const session = {
+    version: RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+    session_id: `rps_${(/* @__PURE__ */ new Date()).toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}_${randomUUID().slice(0, 8)}`,
+    run_id: trim(input.run_id),
+    parent_session_id: input.parent?.session_id || null,
+    parent_fingerprint: input.parent?.fingerprint || null,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    fingerprint,
+    fingerprint_basis: basis,
+    repo: trim(input.repo),
+    branch: trim(input.branch),
+    route: withoutUndefined({
+      path: trim(input.route),
+      observed_after_path: trim(input.observed_after_path)
+    }),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode),
+    target_image: withoutUndefined({
+      url: trim(input.target_image_url),
+      hash: trim(input.target_image_hash)
+    }),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    capture: withoutUndefined({
+      proof_plan: trim(input.proof_plan),
+      capture_script: trim(input.capture_script),
+      wait_for_selector: trim(input.wait_for_selector)
+    }),
+    assertions: input.assertions,
+    artifacts: input.artifacts,
+    evidence: input.evidence,
+    status: trim(input.status)
+  };
+  return JSON.parse(JSON.stringify(session));
+}
+function parseVisualProofSession(value) {
+  const parsed = typeof value === "string" ? JSON.parse(value) : value;
+  if (!parsed || typeof parsed !== "object") throw new Error("proof session must be a JSON object");
+  const session = parsed;
+  if (session.version !== RIDDLE_PROOF_VISUAL_SESSION_VERSION) {
+    throw new Error(`unsupported proof session version: ${String(session.version || "")}`);
+  }
+  if (!session.session_id) throw new Error("proof session missing session_id");
+  if (!session.fingerprint) throw new Error("proof session missing fingerprint");
+  return session;
+}
+function compareVisualProofSessionFingerprint(parent, input) {
+  const actual = visualSessionFingerprintBasis(input);
+  const expected = parent.fingerprint_basis || {};
+  const keys = /* @__PURE__ */ new Set([...Object.keys(expected), ...Object.keys(actual)]);
+  const expectedRecord = expected;
+  const actualRecord = actual;
+  const mismatches = [];
+  for (const key of keys) {
+    const expectedValue = expectedRecord[key];
+    const actualValue = actualRecord[key];
+    if (stableJson(expectedValue) !== stableJson(actualValue)) {
+      mismatches.push({ key, expected: expectedValue, actual: actualValue });
+    }
+  }
+  return mismatches;
+}
+
+export {
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  visualSessionFingerprintBasis,
+  visualSessionFingerprint,
+  buildVisualProofSession,
+  parseVisualProofSession,
+  compareVisualProofSessionFingerprint
+};

package/dist/engine-harness.cjs

@@ -81,6 +81,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");
@@ -96,8 +101,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 || "",
@@ -489,6 +499,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",
@@ -720,7 +735,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",
@@ -2927,6 +2945,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -2974,6 +2993,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,

package/dist/engine-harness.js

@@ -2,10 +2,10 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-CHKYSZLU.js";
-import "./chunk-A5AWVY5A.js";
-import "./chunk-7ZJAUEUN.js";
-import "./chunk-TMMKRKY5.js";
+} from "./chunk-7R6ZQE3X.js";
+import "./chunk-OASB3CYU.js";
+import "./chunk-4YCWZVBN.js";
+import "./chunk-J2MERROF.js";
 export {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,

package/dist/index.cjs

@@ -81,6 +81,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");
@@ -96,8 +101,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 || "",
@@ -489,6 +499,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",
@@ -720,7 +735,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",
@@ -2718,12 +2736,16 @@ __export(index_exports, {
   DEFAULT_DIAGNOSTIC_STRING_LIMIT: () => DEFAULT_DIAGNOSTIC_STRING_LIMIT,
   RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION: () => RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION,
   RIDDLE_PROOF_RUN_STATE_VERSION: () => RIDDLE_PROOF_RUN_STATE_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION: () => RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION: () => RIDDLE_PROOF_VISUAL_SESSION_VERSION,
   appendCaptureDiagnostic: () => appendCaptureDiagnostic,
   appendRunEvent: () => appendRunEvent,
   appendStageHeartbeat: () => appendStageHeartbeat,
   applyPrLifecycleState: () => applyPrLifecycleState,
   applyTerminalMetadata: () => applyTerminalMetadata,
+  buildVisualProofSession: () => buildVisualProofSession,
   compactRecord: () => compactRecord,
+  compareVisualProofSessionFingerprint: () => compareVisualProofSessionFingerprint,
   createCaptureDiagnostic: () => createCaptureDiagnostic,
   createDisabledRiddleProofAgentAdapter: () => createDisabledRiddleProofAgentAdapter,
   createRunResult: () => createRunResult,
@@ -2736,13 +2758,16 @@ __export(index_exports, {
   normalizePrLifecycleState: () => normalizePrLifecycleState,
   normalizeRunParams: () => normalizeRunParams,
   normalizeTerminalMetadata: () => normalizeTerminalMetadata,
+  parseVisualProofSession: () => parseVisualProofSession,
   readRiddleProofRunStatus: () => readRiddleProofRunStatus,
   recordValue: () => recordValue,
   redactForProofDiagnostics: () => redactForProofDiagnostics,
   runRiddleProof: () => runRiddleProof,
   runRiddleProofEngineHarness: () => runRiddleProofEngineHarness,
   setRunStatus: () => setRunStatus,
-  summarizeCaptureArtifacts: () => summarizeCaptureArtifacts
+  summarizeCaptureArtifacts: () => summarizeCaptureArtifacts,
+  visualSessionFingerprint: () => visualSessionFingerprint,
+  visualSessionFingerprintBasis: () => visualSessionFingerprintBasis
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -2950,6 +2975,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -3027,6 +3053,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,
@@ -4683,6 +4714,118 @@ function appendCaptureDiagnostic(state, input, historyLimit = DEFAULT_DIAGNOSTIC
   state.capture_diagnostics = [...existing, diagnostic].slice(-Math.max(1, historyLimit));
   return diagnostic;
 }
+
+// src/proof-session.ts
+var import_node_crypto3 = require("crypto");
+var RIDDLE_PROOF_VISUAL_SESSION_VERSION = "riddle-proof.visual-session.v1";
+var RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION = "riddle-proof.visual-session.fingerprint.v1";
+function trim(value) {
+  const text = String(value ?? "").trim();
+  return text || void 0;
+}
+function hashString(value) {
+  const text = trim(value);
+  if (!text) return void 0;
+  return (0, import_node_crypto3.createHash)("sha256").update(text).digest("hex");
+}
+function stableJson(value) {
+  if (value === void 0) return "null";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) return `[${value.map((item) => stableJson(item)).join(",")}]`;
+  const record = value;
+  return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+}
+function withoutUndefined(record) {
+  for (const key of Object.keys(record)) {
+    if (record[key] === void 0) delete record[key];
+  }
+  return record;
+}
+function visualSessionFingerprintBasis(input) {
+  return withoutUndefined({
+    version: RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+    repo: trim(input.repo),
+    route: trim(input.route),
+    wait_for_selector: trim(input.wait_for_selector),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode)?.toLowerCase(),
+    target_image_url: trim(input.target_image_url),
+    target_image_hash: trim(input.target_image_hash),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    assertions: input.assertions,
+    capture_script_hash: hashString(input.capture_script)
+  });
+}
+function visualSessionFingerprint(input) {
+  const basis = input.version === RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION ? input : visualSessionFingerprintBasis(input);
+  return (0, import_node_crypto3.createHash)("sha256").update(stableJson(basis)).digest("hex");
+}
+function buildVisualProofSession(input) {
+  const basis = visualSessionFingerprintBasis(input);
+  const fingerprint = visualSessionFingerprint(basis);
+  const session = {
+    version: RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+    session_id: `rps_${(/* @__PURE__ */ new Date()).toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}_${(0, import_node_crypto3.randomUUID)().slice(0, 8)}`,
+    run_id: trim(input.run_id),
+    parent_session_id: input.parent?.session_id || null,
+    parent_fingerprint: input.parent?.fingerprint || null,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    fingerprint,
+    fingerprint_basis: basis,
+    repo: trim(input.repo),
+    branch: trim(input.branch),
+    route: withoutUndefined({
+      path: trim(input.route),
+      observed_after_path: trim(input.observed_after_path)
+    }),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode),
+    target_image: withoutUndefined({
+      url: trim(input.target_image_url),
+      hash: trim(input.target_image_hash)
+    }),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    capture: withoutUndefined({
+      proof_plan: trim(input.proof_plan),
+      capture_script: trim(input.capture_script),
+      wait_for_selector: trim(input.wait_for_selector)
+    }),
+    assertions: input.assertions,
+    artifacts: input.artifacts,
+    evidence: input.evidence,
+    status: trim(input.status)
+  };
+  return JSON.parse(JSON.stringify(session));
+}
+function parseVisualProofSession(value) {
+  const parsed = typeof value === "string" ? JSON.parse(value) : value;
+  if (!parsed || typeof parsed !== "object") throw new Error("proof session must be a JSON object");
+  const session = parsed;
+  if (session.version !== RIDDLE_PROOF_VISUAL_SESSION_VERSION) {
+    throw new Error(`unsupported proof session version: ${String(session.version || "")}`);
+  }
+  if (!session.session_id) throw new Error("proof session missing session_id");
+  if (!session.fingerprint) throw new Error("proof session missing fingerprint");
+  return session;
+}
+function compareVisualProofSessionFingerprint(parent, input) {
+  const actual = visualSessionFingerprintBasis(input);
+  const expected = parent.fingerprint_basis || {};
+  const keys = /* @__PURE__ */ new Set([...Object.keys(expected), ...Object.keys(actual)]);
+  const expectedRecord = expected;
+  const actualRecord = actual;
+  const mismatches = [];
+  for (const key of keys) {
+    const expectedValue = expectedRecord[key];
+    const actualValue = actualRecord[key];
+    if (stableJson(expectedValue) !== stableJson(actualValue)) {
+      mismatches.push({ key, expected: expectedValue, actual: actualValue });
+    }
+  }
+  return mismatches;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
@@ -4690,12 +4833,16 @@ function appendCaptureDiagnostic(state, input, historyLimit = DEFAULT_DIAGNOSTIC
   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,
@@ -4708,11 +4855,14 @@ function appendCaptureDiagnostic(state, input, historyLimit = DEFAULT_DIAGNOSTIC
   normalizePrLifecycleState,
   normalizeRunParams,
   normalizeTerminalMetadata,
+  parseVisualProofSession,
   readRiddleProofRunStatus,
   recordValue,
   redactForProofDiagnostics,
   runRiddleProof,
   runRiddleProofEngineHarness,
   setRunStatus,
-  summarizeCaptureArtifacts
+  summarizeCaptureArtifacts,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
 });

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter } from './types.cjs';
+export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter } from './types.cjs';
 export { TerminalMetadataInput, applyTerminalMetadata, compactRecord, createRunResult, isSuccessfulStatus, isTerminalStatus, nonEmptyString, normalizeTerminalMetadata, recordValue } from './result.cjs';
 export { CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus } from './state.cjs';
 export { RiddleProofRunnerAdapters, RunRiddleProofInput, runRiddleProof } from './runner.cjs';
 export { RiddleProofAgentAdapter, RiddleProofAgentPayload, RiddleProofEngine, RiddleProofEngineHarnessConfig, RiddleProofEngineHarnessContext, RiddleProofEngineResult, RiddleProofShipMode, RiddleProofWorkflowParams, RunRiddleProofEngineHarnessInput, createDisabledRiddleProofAgentAdapter, readRiddleProofRunStatus, runRiddleProofEngineHarness } from './engine-harness.cjs';
 export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_DIAGNOSTIC_HISTORY_LIMIT, DEFAULT_DIAGNOSTIC_STRING_LIMIT, RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION, RiddleProofArtifactSummary, RiddleProofCaptureArtifactSummary, RiddleProofCaptureDiagnostic, RiddleProofDiagnosticRedactionOptions, appendCaptureDiagnostic, createCaptureDiagnostic, redactForProofDiagnostics, summarizeCaptureArtifacts } from './diagnostics.cjs';
+export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.cjs';

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter } from './types.js';
+export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter } from './types.js';
 export { TerminalMetadataInput, applyTerminalMetadata, compactRecord, createRunResult, isSuccessfulStatus, isTerminalStatus, nonEmptyString, normalizeTerminalMetadata, recordValue } from './result.js';
 export { CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus } from './state.js';
 export { RiddleProofRunnerAdapters, RunRiddleProofInput, runRiddleProof } from './runner.js';
 export { RiddleProofAgentAdapter, RiddleProofAgentPayload, RiddleProofEngine, RiddleProofEngineHarnessConfig, RiddleProofEngineHarnessContext, RiddleProofEngineResult, RiddleProofShipMode, RiddleProofWorkflowParams, RunRiddleProofEngineHarnessInput, createDisabledRiddleProofAgentAdapter, readRiddleProofRunStatus, runRiddleProofEngineHarness } from './engine-harness.js';
 export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_DIAGNOSTIC_HISTORY_LIMIT, DEFAULT_DIAGNOSTIC_STRING_LIMIT, RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION, RiddleProofArtifactSummary, RiddleProofCaptureArtifactSummary, RiddleProofCaptureDiagnostic, RiddleProofDiagnosticRedactionOptions, appendCaptureDiagnostic, createCaptureDiagnostic, redactForProofDiagnostics, summarizeCaptureArtifacts } from './diagnostics.js';
+export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.js';