xoonya 1.17.0 → 1.18.0

package/README.md

@@ -147,6 +147,9 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/handoff-intake`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-intake-boundary`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-intake-carry`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-package-intake`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-package-carry`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-package-run`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-run`
 - `POST /v1/proof-center/result-package-handoff/run`
 
@@ -162,6 +165,15 @@ It now also exposes a handoff-continuity summary so the proof-side bridge can be
 It now also exposes a handoff-intake summary and handoff-intake-boundary summary so that same handoff contract can be consumed more directly as a stable proof-native intake surface for future adapters without widening proof scope.
 It now also exposes a handoff-intake-carry summary so the same proof-side intake surface can be reused more directly as compact consumable carry instead of only summary or boundary posture.
 It now also exposes a handoff-run summary so that same handoff contract can be read directly as the final proof-native run posture instead of only as continuity guidance.
+
+The current `1.18.0` line starts turning that adapter-consumable handoff surface into a clearer adapter-usable handoff package:
+
+- proof-side handoff-package intake summaries on top of the intake surface
+- proof-side handoff-package carry for compact usable package carry
+- proof-side handoff-package run summaries for direct default run posture
+- clearer handoff-package ids across intake, carry, and proof-native run posture
+
+This is intended to make the proof-side continuation path easier to use directly as a stable public handoff package instead of only a proof-native intake surface.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

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

package/proof_sdk.js

@@ -1636,6 +1636,45 @@ function summarizeReviewHandoffIntakeCarry(input) {
   };
 }
 
+function summarizeReviewHandoffPackageIntake(input) {
+  const intake = summarizeReviewHandoffIntake(input);
+  return {
+    ok: intake.ok === true,
+    handoff_surface_ref: intake.handoff_surface_ref || null,
+    handoff_package_ref: intake.handoff_surface_ref ? `package.${intake.handoff_surface_ref}` : null,
+    stable_handoff_package_ids: Array.isArray(intake.stable_handoff_surface_ids) ? intake.stable_handoff_surface_ids : [],
+    adapter_usable: intake.adapter_consumable === true,
+    run_surface: intake.run_surface || null,
+    intake_path_ids: Array.isArray(intake.intake_path_ids) ? intake.intake_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffPackageCarry(input) {
+  const handoffPackage = summarizeReviewHandoffPackageIntake(input);
+  return {
+    ok: handoffPackage.ok === true,
+    handoff_package_ref: handoffPackage.handoff_package_ref || null,
+    stable_handoff_package_ids: Array.isArray(handoffPackage.stable_handoff_package_ids) ? handoffPackage.stable_handoff_package_ids : [],
+    usable_handoff_package_carry: {
+      run_surface: handoffPackage.run_surface || null,
+      intake_path_ids: Array.isArray(handoffPackage.intake_path_ids) ? handoffPackage.intake_path_ids : []
+    },
+    adapter_usable: handoffPackage.adapter_usable === true
+  };
+}
+
+function summarizeReviewHandoffPackageRun(input) {
+  const handoffPackage = summarizeReviewHandoffPackageIntake(input);
+  return {
+    ok: handoffPackage.ok === true,
+    handoff_package_ref: handoffPackage.handoff_package_ref || null,
+    accepted_handoff_package_ids: Array.isArray(handoffPackage.stable_handoff_package_ids) ? handoffPackage.stable_handoff_package_ids : [],
+    adapter_usable: handoffPackage.adapter_usable === true,
+    run_surface: handoffPackage.run_surface || null,
+    run_path_ids: Array.isArray(handoffPackage.intake_path_ids) ? handoffPackage.intake_path_ids : []
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1707,6 +1746,9 @@ module.exports = {
   summarizeReviewHandoffIntake,
   summarizeReviewHandoffIntakeBoundary,
   summarizeReviewHandoffIntakeCarry,
+  summarizeReviewHandoffPackageIntake,
+  summarizeReviewHandoffPackageCarry,
+  summarizeReviewHandoffPackageRun,
   summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,

package/server.js

@@ -369,6 +369,39 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-package-intake') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffPackageIntake(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-package-carry') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffPackageCarry(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-package-run') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffPackageRun(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
   if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-run') {
     try {
       const body = await readJsonBody(req);