@riddledc/riddle-proof 0.8.61 → 0.8.63

package/dist/index.cjs

@@ -3538,8 +3538,11 @@ __export(index_exports, {
   slugifyRiddleProofProfileName: () => slugifyRiddleProofProfileName,
   statePathsForRunState: () => statePathsForRunState,
   summarizeCaptureArtifacts: () => summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface: () => summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface: () => summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment: () => summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult: () => summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface: () => summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState: () => summarizeRiddleProofPublicState,
   visualSessionFingerprint: () => visualSessionFingerprint,
   visualSessionFingerprintBasis: () => visualSessionFingerprintBasis
@@ -3706,6 +3709,68 @@ function summarizeRiddleProofPublicState(input) {
     prohibited_claims: uniqueStrings(prohibitedClaims)
   };
 }
+function summarizeRiddleProofPublicConsumerSurface(input, options = {}) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const publicState = summarizeRiddleProofPublicState(input);
+  const checkpointAudit = publicState.checkpoint_summary;
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue(
+      options.merge_recommendation,
+      record.merge_recommendation,
+      stopCondition.merge_recommendation,
+      raw.merge_recommendation
+    )
+  );
+  const checkpointAuditRequired = publicState.required_disclosures.includes("checkpoint_audit_counters");
+  return {
+    kind: options.kind || "run_result",
+    status: publicState.status,
+    result_label: publicState.result_label,
+    policy_state: publicState.policy_state,
+    proof_complete: publicState.proof_complete,
+    claims: {
+      proof_passed: publicState.proof_passed,
+      ship_authorized: publicState.ship_authorized,
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      all_checkpoint_responses_accepted: checkpointAudit ? !checkpointAudit.audit_disclosure_required : false
+    },
+    ship_control: {
+      ship_held: publicState.ship_held,
+      shipping_disabled: publicState.shipping_disabled,
+      ship_authorized: publicState.ship_authorized
+    },
+    handoff: {
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      merge_recommendation: mergeRecommendation
+    },
+    checkpoint_audit: checkpointAudit,
+    disclosures: {
+      ship_control: true,
+      checkpoint_audit: !checkpointAuditRequired || Boolean(checkpointAudit),
+      required: [...publicState.required_disclosures],
+      prohibited_claims: [...publicState.prohibited_claims]
+    },
+    public_state: publicState
+  };
+}
+function summarizeRiddleProofHostedProofViewSurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "hosted_proof_view"
+  });
+}
+function summarizeRiddleProofAgentSummarySurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "agent_summary"
+  });
+}
 
 // src/result.ts
 function isTerminalStatus(status) {
@@ -5337,6 +5402,9 @@ function shouldIterate(assessment) {
   const nextStage = assessment.continue_with_stage || assessment.recommended_stage;
   return nextStage === "implement" || nextStage === "author";
 }
+function hasTrustedReadySource(assessment) {
+  return assessment.source === "supervising_agent" || assessment.source === "supervisor";
+}
 async function notifyIfConfigured(input) {
   if (!input.notification) return input.result;
   try {
@@ -5672,6 +5740,7 @@ async function runRiddleProof(input) {
           decision: assessment.decision,
           recommended_stage: assessment.recommended_stage,
           continue_with_stage: assessment.continue_with_stage,
+          source: assessment.source,
           reasons: assessment.reasons
         }
       });
@@ -5683,7 +5752,27 @@ async function runRiddleProof(input) {
         evidence_bundle: evidenceBundle
       });
     }
-    if (assessment.decision === "ready_to_ship") break;
+    if (assessment.decision === "ready_to_ship") {
+      if (!hasTrustedReadySource(assessment)) {
+        return blockRun({
+          state,
+          stage: "verify",
+          blocker: adapterBlocker(
+            "proof_assessment_untrusted_source",
+            "A ready_to_ship proof assessment must come from a supervising source.",
+            "judge_completed",
+            {
+              decision: assessment.decision,
+              source: assessment.source || null,
+              trusted_sources: ["supervising_agent", "supervisor"]
+            }
+          ),
+          evidence_bundle: evidenceBundle,
+          raw: { assessment }
+        });
+      }
+      break;
+    }
     if (attempt + 1 < maxIterations && shouldIterate(assessment)) {
       evidenceContext = evidenceBundle;
       appendRunEvent(state, {
@@ -20621,8 +20710,11 @@ function buildRiddleProofPrCommentMarkdown(input) {
   slugifyRiddleProofProfileName,
   statePathsForRunState,
   summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState,
   visualSessionFingerprint,
   visualSessionFingerprintBasis

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { RiddleProofShipControlState, TerminalMetadataInput, applyShipControlSta
 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, checkpointPacketIdentity, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.cjs';
 export { RIDDLE_PROOF_RUN_CARD_VERSION, createRiddleProofRunCard } from './run-card.cjs';
-export { RiddleProofPublicCheckpointSummary, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState } from './public-state.cjs';
+export { RiddleProofPublicCheckpointSummary, RiddleProofPublicConsumerSurface, RiddleProofPublicConsumerSurfaceKind, RiddleProofPublicConsumerSurfaceOptions, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState } from './public-state.cjs';
 export { R as RiddleProofRunnerAdapters, a as RunRiddleProofInput, r as runRiddleProof } from './runner-4LJ5z0D-.cjs';
 export { R as RiddleProofAgentAdapter, a as RiddleProofAgentPayload, b as RiddleProofCheckpointMode, c as RiddleProofEngine, d as RiddleProofEngineHarnessConfig, e as RiddleProofEngineHarnessContext, f as RiddleProofEngineResult, g as RiddleProofShipMode, h as RiddleProofWorkflowParams, i as RunRiddleProofEngineHarnessInput, j as createDisabledRiddleProofAgentAdapter, r as readRiddleProofRunStatus, k as runRiddleProofEngineHarness } from './engine-harness-LBfqbFSe.cjs';
 export { CodexExecAgentConfig, CodexJsonRequest, CodexJsonResult, CodexJsonRunner, CodexExecAgentConfig as LocalAgentConfig, CodexJsonRequest as LocalAgentJsonRequest, CodexJsonResult as LocalAgentJsonResult, CodexJsonRunner as LocalAgentJsonRunner, createCodexExecAgentAdapter, createCodexExecJsonRunner, createCodexExecAgentAdapter as createLocalAgentAdapter, createCodexExecJsonRunner as createLocalAgentJsonRunner, runCodexExecAgentDoctor, runCodexExecAgentDoctor as runLocalAgentDoctor } from './codex-exec-agent.cjs';

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { RiddleProofShipControlState, TerminalMetadataInput, applyShipControlSta
 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, checkpointPacketIdentity, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.js';
 export { RIDDLE_PROOF_RUN_CARD_VERSION, createRiddleProofRunCard } from './run-card.js';
-export { RiddleProofPublicCheckpointSummary, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState } from './public-state.js';
+export { RiddleProofPublicCheckpointSummary, RiddleProofPublicConsumerSurface, RiddleProofPublicConsumerSurfaceKind, RiddleProofPublicConsumerSurfaceOptions, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState } from './public-state.js';
 export { R as RiddleProofRunnerAdapters, a as RunRiddleProofInput, r as runRiddleProof } from './runner-BdQpOkZD.js';
 export { R as RiddleProofAgentAdapter, a as RiddleProofAgentPayload, b as RiddleProofCheckpointMode, c as RiddleProofEngine, d as RiddleProofEngineHarnessConfig, e as RiddleProofEngineHarnessContext, f as RiddleProofEngineResult, g as RiddleProofShipMode, h as RiddleProofWorkflowParams, i as RunRiddleProofEngineHarnessInput, j as createDisabledRiddleProofAgentAdapter, r as readRiddleProofRunStatus, k as runRiddleProofEngineHarness } from './engine-harness-CMACHP6A.js';
 export { CodexExecAgentConfig, CodexJsonRequest, CodexJsonResult, CodexJsonRunner, CodexExecAgentConfig as LocalAgentConfig, CodexJsonRequest as LocalAgentJsonRequest, CodexJsonResult as LocalAgentJsonResult, CodexJsonRunner as LocalAgentJsonRunner, createCodexExecAgentAdapter, createCodexExecJsonRunner, createCodexExecAgentAdapter as createLocalAgentAdapter, createCodexExecJsonRunner as createLocalAgentJsonRunner, runCodexExecAgentDoctor, runCodexExecAgentDoctor as runLocalAgentDoctor } from './codex-exec-agent.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runRiddleProof
-} from "./chunk-XKNJ5OE4.js";
+} from "./chunk-LD2YTPD7.js";
 import "./chunk-6F4PWJZI.js";
 import {
   RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION,
@@ -59,7 +59,7 @@ import {
   RIDDLE_PROOF_PR_COMMENT_MARKER,
   buildRiddleProofPrCommentMarkdown,
   summarizeRiddleProofPrComment
-} from "./chunk-K6VYKOIM.js";
+} from "./chunk-RZ3GXSXQ.js";
 import {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
@@ -102,7 +102,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-HD46EEUV.js";
+} from "./chunk-P4BHU5NM.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -114,11 +114,11 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-UEY5SJG5.js";
+} from "./chunk-NMQIWBSB.js";
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-NXEAFQYZ.js";
+} from "./chunk-2OTPBHSM.js";
 import "./chunk-EKZXU6MU.js";
 import {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
@@ -136,13 +136,13 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-FX2CB4MG.js";
+} from "./chunk-ZB5XBHWD.js";
 import "./chunk-JFQXAJH2.js";
 import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-QPKY767W.js";
+} from "./chunk-OD6OKXL2.js";
 import {
   applyShipControlState,
   applyTerminalMetadata,
@@ -157,13 +157,16 @@ import {
   publicStateForRunState,
   recordValue,
   shipControlStateFor
-} from "./chunk-QGMSN34W.js";
+} from "./chunk-UK7G4RKA.js";
 import {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
-} from "./chunk-WKIIJX3O.js";
+} from "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   BASIC_GAMEPLAY_ACTION_TYPES,
@@ -297,8 +300,11 @@ export {
   slugifyRiddleProofProfileName,
   statePathsForRunState,
   summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState,
   visualSessionFingerprint,
   visualSessionFingerprintBasis

package/dist/local-agent.js

@@ -3,9 +3,9 @@ import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-QPKY767W.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-OD6OKXL2.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   createCodexExecAgentAdapter as createLocalAgentAdapter,

package/dist/openclaw.js

@@ -3,12 +3,12 @@ import {
   parseOpenClawAssertions,
   parseOpenClawJsonObjectOrArray,
   toRiddleProofRunParams
-} from "./chunk-3FK5HZHK.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
-import "./chunk-FX2CB4MG.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-WKNWMRDF.js";
+import "./chunk-NMQIWBSB.js";
+import "./chunk-2OTPBHSM.js";
+import "./chunk-ZB5XBHWD.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   openClawIntegrationContext,

package/dist/pr-comment.js

@@ -2,8 +2,8 @@ import {
   RIDDLE_PROOF_PR_COMMENT_MARKER,
   buildRiddleProofPrCommentMarkdown,
   summarizeRiddleProofPrComment
-} from "./chunk-K6VYKOIM.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-RZ3GXSXQ.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_PR_COMMENT_MARKER,

package/dist/public-state.cjs

@@ -23,6 +23,9 @@ __export(public_state_exports, {
   riddleProofPublicStateAllowsClaim: () => riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation: () => riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation: () => riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface: () => summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface: () => summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface: () => summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState: () => summarizeRiddleProofPublicState
 });
 module.exports = __toCommonJS(public_state_exports);
@@ -185,10 +188,75 @@ function summarizeRiddleProofPublicState(input) {
     prohibited_claims: uniqueStrings(prohibitedClaims)
   };
 }
+function summarizeRiddleProofPublicConsumerSurface(input, options = {}) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const publicState = summarizeRiddleProofPublicState(input);
+  const checkpointAudit = publicState.checkpoint_summary;
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue(
+      options.merge_recommendation,
+      record.merge_recommendation,
+      stopCondition.merge_recommendation,
+      raw.merge_recommendation
+    )
+  );
+  const checkpointAuditRequired = publicState.required_disclosures.includes("checkpoint_audit_counters");
+  return {
+    kind: options.kind || "run_result",
+    status: publicState.status,
+    result_label: publicState.result_label,
+    policy_state: publicState.policy_state,
+    proof_complete: publicState.proof_complete,
+    claims: {
+      proof_passed: publicState.proof_passed,
+      ship_authorized: publicState.ship_authorized,
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      all_checkpoint_responses_accepted: checkpointAudit ? !checkpointAudit.audit_disclosure_required : false
+    },
+    ship_control: {
+      ship_held: publicState.ship_held,
+      shipping_disabled: publicState.shipping_disabled,
+      ship_authorized: publicState.ship_authorized
+    },
+    handoff: {
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      merge_recommendation: mergeRecommendation
+    },
+    checkpoint_audit: checkpointAudit,
+    disclosures: {
+      ship_control: true,
+      checkpoint_audit: !checkpointAuditRequired || Boolean(checkpointAudit),
+      required: [...publicState.required_disclosures],
+      prohibited_claims: [...publicState.prohibited_claims]
+    },
+    public_state: publicState
+  };
+}
+function summarizeRiddleProofHostedProofViewSurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "hosted_proof_view"
+  });
+}
+function summarizeRiddleProofAgentSummarySurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "agent_summary"
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
 });

package/dist/public-state.d.cts

@@ -24,9 +24,49 @@ interface RiddleProofPublicStateSummary {
     required_disclosures: string[];
     prohibited_claims: string[];
 }
+type RiddleProofPublicConsumerSurfaceKind = "run_status" | "run_result" | "run_card" | "pr_comment" | "hosted_proof_view" | "agent_summary" | (string & {});
+interface RiddleProofPublicConsumerSurface {
+    kind: RiddleProofPublicConsumerSurfaceKind;
+    status?: string;
+    result_label: string;
+    policy_state: RiddleProofPublicPolicyState;
+    proof_complete: boolean;
+    claims: {
+        proof_passed: boolean;
+        ship_authorized: boolean;
+        merge_ready: boolean;
+        sync_allowed: boolean;
+        all_checkpoint_responses_accepted: boolean;
+    };
+    ship_control: {
+        ship_held: boolean;
+        shipping_disabled: boolean;
+        ship_authorized: boolean;
+    };
+    handoff: {
+        merge_ready: boolean;
+        sync_allowed: boolean;
+        merge_recommendation?: string;
+    };
+    checkpoint_audit?: RiddleProofPublicCheckpointSummary;
+    disclosures: {
+        ship_control: boolean;
+        checkpoint_audit: boolean;
+        required: string[];
+        prohibited_claims: string[];
+    };
+    public_state: RiddleProofPublicStateSummary;
+}
+interface RiddleProofPublicConsumerSurfaceOptions {
+    kind?: RiddleProofPublicConsumerSurfaceKind;
+    merge_recommendation?: string;
+}
 declare function riddleProofPublicStateAllowsClaim(summary: RiddleProofPublicStateSummary | undefined, claim: string): boolean;
 declare function riddleProofPublicStateAllowsMergeRecommendation(summary: RiddleProofPublicStateSummary | undefined): boolean;
 declare function riddleProofPublicStateMergeRecommendation(summary: RiddleProofPublicStateSummary | undefined, recommendation: string | undefined): string | undefined;
 declare function summarizeRiddleProofPublicState(input: unknown): RiddleProofPublicStateSummary;
+declare function summarizeRiddleProofPublicConsumerSurface(input: unknown, options?: RiddleProofPublicConsumerSurfaceOptions): RiddleProofPublicConsumerSurface;
+declare function summarizeRiddleProofHostedProofViewSurface(input: unknown, options?: Omit<RiddleProofPublicConsumerSurfaceOptions, "kind">): RiddleProofPublicConsumerSurface;
+declare function summarizeRiddleProofAgentSummarySurface(input: unknown, options?: Omit<RiddleProofPublicConsumerSurfaceOptions, "kind">): RiddleProofPublicConsumerSurface;
 
-export { type RiddleProofPublicCheckpointSummary, type RiddleProofPublicPolicyState, type RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState };
+export { type RiddleProofPublicCheckpointSummary, type RiddleProofPublicConsumerSurface, type RiddleProofPublicConsumerSurfaceKind, type RiddleProofPublicConsumerSurfaceOptions, type RiddleProofPublicPolicyState, type RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState };

package/dist/public-state.d.ts

@@ -24,9 +24,49 @@ interface RiddleProofPublicStateSummary {
     required_disclosures: string[];
     prohibited_claims: string[];
 }
+type RiddleProofPublicConsumerSurfaceKind = "run_status" | "run_result" | "run_card" | "pr_comment" | "hosted_proof_view" | "agent_summary" | (string & {});
+interface RiddleProofPublicConsumerSurface {
+    kind: RiddleProofPublicConsumerSurfaceKind;
+    status?: string;
+    result_label: string;
+    policy_state: RiddleProofPublicPolicyState;
+    proof_complete: boolean;
+    claims: {
+        proof_passed: boolean;
+        ship_authorized: boolean;
+        merge_ready: boolean;
+        sync_allowed: boolean;
+        all_checkpoint_responses_accepted: boolean;
+    };
+    ship_control: {
+        ship_held: boolean;
+        shipping_disabled: boolean;
+        ship_authorized: boolean;
+    };
+    handoff: {
+        merge_ready: boolean;
+        sync_allowed: boolean;
+        merge_recommendation?: string;
+    };
+    checkpoint_audit?: RiddleProofPublicCheckpointSummary;
+    disclosures: {
+        ship_control: boolean;
+        checkpoint_audit: boolean;
+        required: string[];
+        prohibited_claims: string[];
+    };
+    public_state: RiddleProofPublicStateSummary;
+}
+interface RiddleProofPublicConsumerSurfaceOptions {
+    kind?: RiddleProofPublicConsumerSurfaceKind;
+    merge_recommendation?: string;
+}
 declare function riddleProofPublicStateAllowsClaim(summary: RiddleProofPublicStateSummary | undefined, claim: string): boolean;
 declare function riddleProofPublicStateAllowsMergeRecommendation(summary: RiddleProofPublicStateSummary | undefined): boolean;
 declare function riddleProofPublicStateMergeRecommendation(summary: RiddleProofPublicStateSummary | undefined, recommendation: string | undefined): string | undefined;
 declare function summarizeRiddleProofPublicState(input: unknown): RiddleProofPublicStateSummary;
+declare function summarizeRiddleProofPublicConsumerSurface(input: unknown, options?: RiddleProofPublicConsumerSurfaceOptions): RiddleProofPublicConsumerSurface;
+declare function summarizeRiddleProofHostedProofViewSurface(input: unknown, options?: Omit<RiddleProofPublicConsumerSurfaceOptions, "kind">): RiddleProofPublicConsumerSurface;
+declare function summarizeRiddleProofAgentSummarySurface(input: unknown, options?: Omit<RiddleProofPublicConsumerSurfaceOptions, "kind">): RiddleProofPublicConsumerSurface;
 
-export { type RiddleProofPublicCheckpointSummary, type RiddleProofPublicPolicyState, type RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState };
+export { type RiddleProofPublicCheckpointSummary, type RiddleProofPublicConsumerSurface, type RiddleProofPublicConsumerSurfaceKind, type RiddleProofPublicConsumerSurfaceOptions, type RiddleProofPublicPolicyState, type RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState };

package/dist/public-state.js

@@ -2,12 +2,18 @@ import {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
-} from "./chunk-WKIIJX3O.js";
+} from "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
 };

package/dist/result.js

@@ -12,8 +12,8 @@ import {
   publicStateForRunState,
   recordValue,
   shipControlStateFor
-} from "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   applyShipControlState,

package/dist/run-card.js

@@ -1,10 +1,10 @@
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-NXEAFQYZ.js";
-import "./chunk-FX2CB4MG.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-2OTPBHSM.js";
+import "./chunk-ZB5XBHWD.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_RUN_CARD_VERSION,

package/dist/runner.cjs

@@ -633,6 +633,9 @@ function shouldIterate(assessment) {
   const nextStage = assessment.continue_with_stage || assessment.recommended_stage;
   return nextStage === "implement" || nextStage === "author";
 }
+function hasTrustedReadySource(assessment) {
+  return assessment.source === "supervising_agent" || assessment.source === "supervisor";
+}
 async function notifyIfConfigured(input) {
   if (!input.notification) return input.result;
   try {
@@ -968,6 +971,7 @@ async function runRiddleProof(input) {
           decision: assessment.decision,
           recommended_stage: assessment.recommended_stage,
           continue_with_stage: assessment.continue_with_stage,
+          source: assessment.source,
           reasons: assessment.reasons
         }
       });
@@ -979,7 +983,27 @@ async function runRiddleProof(input) {
         evidence_bundle: evidenceBundle
       });
     }
-    if (assessment.decision === "ready_to_ship") break;
+    if (assessment.decision === "ready_to_ship") {
+      if (!hasTrustedReadySource(assessment)) {
+        return blockRun({
+          state,
+          stage: "verify",
+          blocker: adapterBlocker(
+            "proof_assessment_untrusted_source",
+            "A ready_to_ship proof assessment must come from a supervising source.",
+            "judge_completed",
+            {
+              decision: assessment.decision,
+              source: assessment.source || null,
+              trusted_sources: ["supervising_agent", "supervisor"]
+            }
+          ),
+          evidence_bundle: evidenceBundle,
+          raw: { assessment }
+        });
+      }
+      break;
+    }
     if (attempt + 1 < maxIterations && shouldIterate(assessment)) {
       evidenceContext = evidenceBundle;
       appendRunEvent(state, {

package/dist/runner.js

@@ -1,12 +1,12 @@
 import {
   runRiddleProof
-} from "./chunk-XKNJ5OE4.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
+} from "./chunk-LD2YTPD7.js";
+import "./chunk-NMQIWBSB.js";
+import "./chunk-2OTPBHSM.js";
 import "./chunk-EKZXU6MU.js";
-import "./chunk-FX2CB4MG.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+import "./chunk-ZB5XBHWD.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   runRiddleProof

package/dist/spec/checkpoint.js

@@ -14,9 +14,9 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "../chunk-FX2CB4MG.js";
-import "../chunk-QGMSN34W.js";
-import "../chunk-WKIIJX3O.js";
+} from "../chunk-ZB5XBHWD.js";
+import "../chunk-UK7G4RKA.js";
+import "../chunk-6PSM6KB2.js";
 import "../chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,