@riddledc/riddle-proof 0.8.61 → 0.8.62

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runRiddleProof
-} from "./chunk-XKNJ5OE4.js";
+} from "./chunk-HRY2IHXM.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.js

@@ -1,12 +1,12 @@
 import {
   runRiddleProof
-} from "./chunk-XKNJ5OE4.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
+} from "./chunk-HRY2IHXM.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,

package/dist/spec/index.cjs

@@ -73,6 +73,9 @@ __export(spec_exports, {
   setRunStatus: () => setRunStatus,
   shipControlStateFor: () => shipControlStateFor,
   statePathsForRunState: () => statePathsForRunState,
+  summarizeRiddleProofAgentSummarySurface: () => summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface: () => summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface: () => summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState: () => summarizeRiddleProofPublicState
 });
 module.exports = __toCommonJS(spec_exports);
@@ -237,6 +240,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) {
@@ -1868,5 +1933,8 @@ function applyPrLifecycleState(state, input, at = timestamp2()) {
   setRunStatus,
   shipControlStateFor,
   statePathsForRunState,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
 });

package/dist/spec/index.d.cts

@@ -3,4 +3,4 @@ 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';

package/dist/spec/index.d.ts

@@ -3,4 +3,4 @@ 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';

package/dist/spec/index.js

@@ -10,11 +10,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 {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
   RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION,
@@ -31,7 +31,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "../chunk-FX2CB4MG.js";
+} from "../chunk-ZB5XBHWD.js";
 import {
   applyShipControlState,
   applyTerminalMetadata,
@@ -46,13 +46,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 {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
@@ -98,5 +101,8 @@ export {
   setRunStatus,
   shipControlStateFor,
   statePathsForRunState,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
 };

package/dist/spec/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);
@@ -187,10 +190,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/spec/public-state.d.cts

@@ -1 +1 @@
-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';

package/dist/spec/public-state.d.ts

@@ -1 +1 @@
-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';