@riddledc/riddle-proof 0.7.80 → 0.7.82

package/README.md

@@ -92,6 +92,20 @@ file/object before resuming the run.
 uses the local Codex CLI adapter underneath, but the loop contract and CLI
 surface are intentionally not Codex-specific.
 
+Visual/UI proof runs can pass `viewport_matrix` / `viewport_matrix_json` to the
+base loop. The runtime records the requested matrix, captures per-viewport
+screenshots with viewport-scoped labels, persists the executed/missing viewport
+metadata into run status and proof artifacts, and treats missing requested
+viewport evidence as incomplete capture evidence.
+
+Measured visual deltas still require numeric before/after evidence. For small
+targeted copy or UI changes, the visual gate can use a lower targeted threshold
+only when route/text semantics match the requested change. When before/after
+image artifacts can be compared directly, the runtime also records the changed
+region bounding box and refuses the targeted threshold if that exact region is
+too broad for a localized UI change. Missing or unmeasured visual deltas
+continue through evidence recovery instead of being treated as a passing proof.
+
 ## CI / Profile Mode
 
 Profile mode runs durable proof profiles against an existing site without an

package/dist/checkpoint.js

@@ -13,8 +13,8 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-33XO42CY.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-ABQQLRTS.js";
+import "./chunk-VY4Y5U57.js";
 export {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
   RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION,

package/dist/{chunk-EXF7V6TJ.js → chunk-7F5LNUGR.js}

@@ -1,6 +1,6 @@
 import {
   compactRecord
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/codex-exec-agent.ts
 import { execFileSync, spawnSync } from "child_process";

package/dist/{chunk-33XO42CY.js → chunk-ABQQLRTS.js}

@@ -2,7 +2,7 @@ import {
   compactRecord,
   nonEmptyString,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/checkpoint.ts
 import crypto from "crypto";

package/dist/{chunk-JRFKVTKY.js → chunk-ENWYM4L7.js}

@@ -3,13 +3,13 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-4DM3OTWH.js";
+} from "./chunk-UYB7ABWU.js";
 import {
   noImplementationModeFor
 } from "./chunk-SGXB5S4B.js";
 import {
   createRunResult
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/runner.ts
 function errorDetails(error) {

package/dist/{chunk-F7BNWDF6.js → chunk-MPPLZ35C.js}

@@ -5,10 +5,10 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-4DM3OTWH.js";
+} from "./chunk-UYB7ABWU.js";
 import {
   createRiddleProofRunCard
-} from "./chunk-3UHWI3FO.js";
+} from "./chunk-ZHEFYLII.js";
 import {
   noImplementationModeFor,
   visualDeltaForState,
@@ -24,7 +24,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-33XO42CY.js";
+} from "./chunk-ABQQLRTS.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -32,7 +32,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/engine-harness.ts
 import { execFileSync } from "child_process";

package/dist/{chunk-4DM3OTWH.js → chunk-UYB7ABWU.js}

@@ -1,12 +1,12 @@
 import {
   createRiddleProofRunCard
-} from "./chunk-3UHWI3FO.js";
+} from "./chunk-ZHEFYLII.js";
 import {
   compactRecord,
   isTerminalStatus,
   nonEmptyString,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/state.ts
 var RIDDLE_PROOF_RUN_STATE_VERSION = "riddle-proof.run-state.v1";
@@ -218,6 +218,7 @@ function createRunStatusSnapshot(state, at = timestamp()) {
     state_paths: state.state_paths,
     proof_contract: state.proof_contract,
     run_card: state.run_card || createRiddleProofRunCard(state, { at }),
+    viewport_matrix_status: state.viewport_matrix_status,
     latest_event: latestEvent
   });
 }

package/dist/{chunk-DUFDZJOF.js → chunk-VY4Y5U57.js}

@@ -208,6 +208,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });

package/dist/{chunk-3UHWI3FO.js → chunk-ZHEFYLII.js}

@@ -1,12 +1,12 @@
 import {
   statePathsForRunState
-} from "./chunk-33XO42CY.js";
+} from "./chunk-ABQQLRTS.js";
 import {
   compactRecord,
   isTerminalStatus,
   nonEmptyString,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/run-card.ts
 var RIDDLE_PROOF_RUN_CARD_VERSION = "riddle-proof.run-card.v1";
@@ -114,6 +114,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -156,6 +166,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -202,6 +213,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),

package/dist/cli.cjs

@@ -3116,6 +3116,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -3936,6 +3937,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord2(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord2(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord2(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -3978,6 +3989,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -4024,6 +4036,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),
@@ -4220,6 +4233,7 @@ function createRunStatusSnapshot(state, at = timestamp2()) {
     state_paths: state.state_paths,
     proof_contract: state.proof_contract,
     run_card: state.run_card || createRiddleProofRunCard(state, { at }),
+    viewport_matrix_status: state.viewport_matrix_status,
     latest_event: latestEvent
   });
 }

package/dist/cli.js

@@ -19,19 +19,19 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-F7BNWDF6.js";
-import "./chunk-4DM3OTWH.js";
-import "./chunk-3UHWI3FO.js";
+} from "./chunk-MPPLZ35C.js";
+import "./chunk-UYB7ABWU.js";
+import "./chunk-ZHEFYLII.js";
 import "./chunk-SGXB5S4B.js";
 import {
   createCheckpointResponseTemplate
-} from "./chunk-33XO42CY.js";
+} from "./chunk-ABQQLRTS.js";
 import "./chunk-JFQXAJH2.js";
 import {
   createCodexExecAgentAdapter,
   runCodexExecAgentDoctor
-} from "./chunk-EXF7V6TJ.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-7F5LNUGR.js";
+import "./chunk-VY4Y5U57.js";
 
 // src/cli.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/codex-exec-agent.js

@@ -2,8 +2,8 @@ import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-EXF7V6TJ.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-7F5LNUGR.js";
+import "./chunk-VY4Y5U57.js";
 export {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,

package/dist/engine-harness.cjs

@@ -3119,6 +3119,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -3865,6 +3866,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord2(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord2(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord2(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -3907,6 +3918,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -3953,6 +3965,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),
@@ -4149,6 +4162,7 @@ function createRunStatusSnapshot(state, at = timestamp2()) {
     state_paths: state.state_paths,
     proof_contract: state.proof_contract,
     run_card: state.run_card || createRiddleProofRunCard(state, { at }),
+    viewport_matrix_status: state.viewport_matrix_status,
     latest_event: latestEvent
   });
 }

package/dist/engine-harness.js

@@ -2,12 +2,12 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-F7BNWDF6.js";
-import "./chunk-4DM3OTWH.js";
-import "./chunk-3UHWI3FO.js";
+} from "./chunk-MPPLZ35C.js";
+import "./chunk-UYB7ABWU.js";
+import "./chunk-ZHEFYLII.js";
 import "./chunk-SGXB5S4B.js";
-import "./chunk-33XO42CY.js";
-import "./chunk-DUFDZJOF.js";
+import "./chunk-ABQQLRTS.js";
+import "./chunk-VY4Y5U57.js";
 export {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,

package/dist/index.cjs

@@ -3225,6 +3225,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -4045,6 +4046,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord2(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord2(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord2(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -4087,6 +4098,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -4133,6 +4145,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),
@@ -4359,6 +4372,7 @@ function createRunStatusSnapshot(state, at = timestamp2()) {
     state_paths: state.state_paths,
     proof_contract: state.proof_contract,
     run_card: state.run_card || createRiddleProofRunCard(state, { at }),
+    viewport_matrix_status: state.viewport_matrix_status,
     latest_event: latestEvent
   });
 }

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointSummary, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofProofContract, RiddleProofRunCard, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatePaths, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, 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, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointSummary, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofProofContract, RiddleProofRunCard, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatePaths, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofViewportCapture, RiddleProofViewportMatrixStatus, 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 { RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION, RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION, authorPacketPayloadFromCheckpointResponse, buildAuthorCheckpointPacket, buildCheckpointPacketForEngineResult, buildProofAssessmentCheckpointPacket, buildStageCheckpointPacket, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointSummary, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofProofContract, RiddleProofRunCard, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatePaths, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, 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, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointSummary, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofProofContract, RiddleProofRunCard, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatePaths, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofViewportCapture, RiddleProofViewportMatrixStatus, 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 { RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION, RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION, authorPacketPayloadFromCheckpointResponse, buildAuthorCheckpointPacket, buildCheckpointPacketForEngineResult, buildProofAssessmentCheckpointPacket, buildStageCheckpointPacket, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runRiddleProof
-} from "./chunk-JRFKVTKY.js";
+} from "./chunk-ENWYM4L7.js";
 import "./chunk-6F4PWJZI.js";
 import {
   RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION,
@@ -87,7 +87,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-F7BNWDF6.js";
+} from "./chunk-MPPLZ35C.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -99,11 +99,11 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-4DM3OTWH.js";
+} from "./chunk-UYB7ABWU.js";
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-3UHWI3FO.js";
+} from "./chunk-ZHEFYLII.js";
 import "./chunk-SGXB5S4B.js";
 import {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
@@ -120,13 +120,13 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-33XO42CY.js";
+} from "./chunk-ABQQLRTS.js";
 import "./chunk-JFQXAJH2.js";
 import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-EXF7V6TJ.js";
+} from "./chunk-7F5LNUGR.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -136,7 +136,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 export {
   BASIC_GAMEPLAY_ACTION_TYPES,
   BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES,

package/dist/local-agent.js

@@ -3,8 +3,8 @@ import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-EXF7V6TJ.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-7F5LNUGR.js";
+import "./chunk-VY4Y5U57.js";
 export {
   createCodexExecAgentAdapter as createLocalAgentAdapter,
   createCodexExecJsonRunner as createLocalAgentJsonRunner,

package/dist/openclaw.js

@@ -1,12 +1,12 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-4DM3OTWH.js";
-import "./chunk-3UHWI3FO.js";
-import "./chunk-33XO42CY.js";
+} from "./chunk-UYB7ABWU.js";
+import "./chunk-ZHEFYLII.js";
+import "./chunk-ABQQLRTS.js";
 import {
   compactRecord
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 
 // src/openclaw.ts
 function parseOpenClawAssertions(value) {

package/dist/result.cjs

@@ -239,6 +239,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });

package/dist/result.js

@@ -7,7 +7,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-DUFDZJOF.js";
+} from "./chunk-VY4Y5U57.js";
 export {
   applyTerminalMetadata,
   compactRecord,

package/dist/run-card.cjs

@@ -165,6 +165,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -207,6 +217,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -253,6 +264,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),

package/dist/run-card.js

@@ -1,9 +1,9 @@
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-3UHWI3FO.js";
-import "./chunk-33XO42CY.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-ZHEFYLII.js";
+import "./chunk-ABQQLRTS.js";
+import "./chunk-VY4Y5U57.js";
 export {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard

package/dist/runner.cjs

@@ -139,6 +139,7 @@ function createRunResult(input) {
     proof_contract: state.proof_contract,
     run_card: state.run_card,
     proof_session: state.proof_session,
+    viewport_matrix_status: state.viewport_matrix_status,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });

package/dist/runner.js

@@ -1,11 +1,11 @@
 import {
   runRiddleProof
-} from "./chunk-JRFKVTKY.js";
-import "./chunk-4DM3OTWH.js";
-import "./chunk-3UHWI3FO.js";
+} from "./chunk-ENWYM4L7.js";
+import "./chunk-UYB7ABWU.js";
+import "./chunk-ZHEFYLII.js";
 import "./chunk-SGXB5S4B.js";
-import "./chunk-33XO42CY.js";
-import "./chunk-DUFDZJOF.js";
+import "./chunk-ABQQLRTS.js";
+import "./chunk-VY4Y5U57.js";
 export {
   runRiddleProof
 };

package/dist/state.cjs

@@ -173,6 +173,16 @@ function artifactsFrom(input) {
   }
   return artifacts.length ? artifacts : void 0;
 }
+function viewportMatrixFrom(input) {
+  const fullState = input.fullRiddleState || {};
+  const bundle = recordValue(fullState.evidence_bundle);
+  const fromBundle = recordValue(bundle?.viewport_matrix);
+  if (fromBundle && Object.keys(fromBundle).length) return jsonCloneRecord(fromBundle);
+  const fromRequest = recordValue(recordValue(fullState.proof_assessment_request)?.viewport_matrix);
+  if (fromRequest && Object.keys(fromRequest).length) return jsonCloneRecord(fromRequest);
+  const fromState = recordValue(fullState.viewport_matrix_status) || recordValue(input.runState.viewport_matrix_status);
+  return fromState && Object.keys(fromState).length ? jsonCloneRecord(fromState) : void 0;
+}
 function ownerFor(state) {
   if (state.status === "awaiting_checkpoint") {
     const role = nonEmptyString(state.checkpoint_packet?.routing_hint?.suggested_role);
@@ -215,6 +225,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const statePaths = input.state_paths || state.state_paths || statePathsForRunState(state);
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
+  const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -261,6 +272,7 @@ function createRiddleProofRunCard(state, input = {}) {
       visual_delta: visualDelta || null,
       evidence_issue_code: evidenceIssueCode({ fullRiddleState: fullState, runState: state }) || null,
       proof_evidence_present: fullState.proof_evidence_present === true || Boolean(bundle?.proof_evidence || bundle?.proof_evidence_sample),
+      viewport_matrix: viewportMatrix,
       artifacts
     }),
     observability: observabilityFrom(state),
@@ -487,6 +499,7 @@ function createRunStatusSnapshot(state, at = timestamp()) {
     state_paths: state.state_paths,
     proof_contract: state.proof_contract,
     run_card: state.run_card || createRiddleProofRunCard(state, { at }),
+    viewport_matrix_status: state.viewport_matrix_status,
     latest_event: latestEvent
   });
 }

package/dist/state.js

@@ -9,10 +9,10 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-4DM3OTWH.js";
-import "./chunk-3UHWI3FO.js";
-import "./chunk-33XO42CY.js";
-import "./chunk-DUFDZJOF.js";
+} from "./chunk-UYB7ABWU.js";
+import "./chunk-ZHEFYLII.js";
+import "./chunk-ABQQLRTS.js";
+import "./chunk-VY4Y5U57.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,