xoonya 1.16.0 → 1.18.0

package/README.md

@@ -144,6 +144,12 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/bridge-carry`
 - `POST /v1/proof-center/result-package-handoff/review/bridge-run`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-continuity`
+- `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`
 
@@ -156,7 +162,18 @@ It now also exposes compact contract-carry summaries so the stable proof-side co
 It now also exposes bridge summaries, bridge-boundary summaries, and bridge-carry summaries so the proof-side review seam is easier to treat as an adapter-ready bridge without widening proof scope.
 It now also exposes a bridge-run summary so that same proof-side bridge can be read directly as the final run posture instead of only as review-stage carry.
 It now also exposes a handoff-continuity summary so the proof-side bridge can be treated more clearly as a stable handoff contract into proof-native execution.
+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.16.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

@@ -1597,6 +1597,84 @@ function summarizeReviewHandoffRun(input) {
   };
 }
 
+function summarizeReviewHandoffIntake(input) {
+  const continuity = summarizeReviewHandoffContinuity(input);
+  return {
+    ok: continuity.ok === true,
+    handoff_contract_ref: continuity.handoff_contract_ref || null,
+    handoff_surface_ref: continuity.handoff_contract_ref ? `surface.${continuity.handoff_contract_ref}` : null,
+    stable_handoff_surface_ids: Array.isArray(continuity.stable_handoff_ids) ? continuity.stable_handoff_ids : [],
+    adapter_consumable: continuity.handoff_ready === true,
+    run_surface: continuity.run_surface || null,
+    intake_path_ids: Array.isArray(continuity.continuity_path_ids) ? continuity.continuity_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffIntakeBoundary(input) {
+  const intake = summarizeReviewHandoffIntake(input);
+  return {
+    ok: intake.ok === true,
+    handoff_surface_ref: intake.handoff_surface_ref || null,
+    stable_boundary_ids: Array.isArray(intake.stable_handoff_surface_ids) ? intake.stable_handoff_surface_ids : [],
+    adapter_consumable: intake.adapter_consumable === true,
+    run_surface: intake.run_surface || null,
+    intake_path_ids: Array.isArray(intake.intake_path_ids) ? intake.intake_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffIntakeCarry(input) {
+  const intake = summarizeReviewHandoffIntake(input);
+  return {
+    ok: intake.ok === true,
+    handoff_surface_ref: intake.handoff_surface_ref || null,
+    stable_handoff_surface_ids: Array.isArray(intake.stable_handoff_surface_ids) ? intake.stable_handoff_surface_ids : [],
+    consumable_handoff_carry: {
+      run_surface: intake.run_surface || null,
+      intake_path_ids: Array.isArray(intake.intake_path_ids) ? intake.intake_path_ids : []
+    },
+    adapter_consumable: intake.adapter_consumable === true
+  };
+}
+
+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) {
@@ -1665,6 +1743,12 @@ module.exports = {
   summarizeReviewBridgeCarry,
   summarizeReviewBridgeRun,
   summarizeReviewHandoffContinuity,
+  summarizeReviewHandoffIntake,
+  summarizeReviewHandoffIntakeBoundary,
+  summarizeReviewHandoffIntakeCarry,
+  summarizeReviewHandoffPackageIntake,
+  summarizeReviewHandoffPackageCarry,
+  summarizeReviewHandoffPackageRun,
   summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,

package/server.js

@@ -336,6 +336,72 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-intake') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntake(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-intake-boundary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntakeBoundary(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-intake-carry') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntakeCarry(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-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);