xoonya 1.9.0 → 1.10.0

package/README.md

@@ -130,6 +130,7 @@ Primary proof-model routes:
 - `POST /v1/proof-center/transaction-handoff/run`
 - `GET /v1/proof-center/result-package-handoff`
 - `GET /v1/proof-center/result-package-handoff/summary`
+- `POST /v1/proof-center/result-package-handoff/review`
 - `POST /v1/proof-center/result-package-handoff/run`
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xoonya",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Deterministic proof SDK for canonical events, receipts, proof bundles, and verification.",
   "main": "index.js",
   "type": "commonjs",

package/proof_sdk.js

@@ -1299,6 +1299,28 @@ function summarizeInteractionResultPackageHandoff(bundle) {
   };
 }
 
+function reviewInteractionResultPackageHandoff(input) {
+  const handoff = canonicalizeInteractionResultPackageHandoff(input);
+  return {
+    ok: true,
+    handoff_kind: "interaction_result_package",
+    handoff,
+    accepted: true,
+    required_field_count: 5,
+    optional_present_count: [
+      handoff.committed_ref,
+      handoff.precommit_pack_ref,
+      handoff.payment_protocol,
+      handoff.settlement_mode,
+      handoff.treasury_destination_id,
+      ...(Array.isArray(handoff.task_refs) ? handoff.task_refs : []),
+      ...(Array.isArray(handoff.seam_layers) ? handoff.seam_layers : [])
+    ].filter(Boolean).length,
+    recommended_loop: "default.proof.bundle.loop",
+    next_surface: "/v1/proof-center/result-package-handoff/run"
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1353,6 +1375,7 @@ module.exports = {
   getDefaultProofLoop,
   canonicalizeTransactionProofHandoff,
   runDefaultProofLoop,
+  reviewInteractionResultPackageHandoff,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,
   runTransactionProofHandoff,

package/server.js

@@ -182,6 +182,17 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.reviewInteractionResultPackageHandoff(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
   if (req.method === 'POST' && url.pathname === '/v1/receipts/verify') {
     try {
       const body = await readJsonBody(req);