xoonya 1.23.0 → 1.24.0

package/README.md

@@ -165,6 +165,9 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/operating-integration`
 - `POST /v1/proof-center/result-package-handoff/review/operating-integration-carry`
 - `POST /v1/proof-center/result-package-handoff/review/operating-integration-run`
+- `POST /v1/proof-center/result-package-handoff/review/operating-path`
+- `POST /v1/proof-center/result-package-handoff/review/operating-path-carry`
+- `POST /v1/proof-center/result-package-handoff/review/operating-path-run`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-run`
 - `POST /v1/proof-center/result-package-handoff/run`
 
@@ -234,6 +237,15 @@ The current `1.23.0` line starts turning that adapter-reliable operating interfa
 - clearer operating-integration ids across review, carry, and proof-native run posture
 
 This is intended to make the proof-side continuation path easier to plug into adapters directly as a durable public operating path instead of only a reliable interface shape.
+
+The current `1.24.0` line starts turning that adapter-integrable operating path into a clearer adapter-ready default path:
+
+- proof-side operating-path posture on top of the operating-integration path
+- compact operating-path carry for direct default proof-side path carry
+- proof-side operating-path run posture for direct default proof-native path posture
+- clearer operating-path ids across review, carry, and proof-native run posture
+
+This is intended to make the proof-side continuation path easier to use as the obvious first public adapter path instead of only a path that is integrable with a little extra coordination.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

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

package/proof_sdk.js

@@ -1870,6 +1870,45 @@ function summarizeReviewOperatingIntegrationRun(input) {
   };
 }
 
+function summarizeReviewOperatingPath(input) {
+  const operatingIntegration = summarizeReviewOperatingIntegrationRun(input);
+  return {
+    ok: operatingIntegration.ok === true,
+    operating_integration_ref: operatingIntegration.operating_integration_ref || null,
+    operating_path_ref: operatingIntegration.operating_integration_ref ? `path.${operatingIntegration.operating_integration_ref}` : null,
+    accepted_operating_path_ids: Array.isArray(operatingIntegration.accepted_operating_integration_ids) ? operatingIntegration.accepted_operating_integration_ids : [],
+    adapter_ready_by_default: operatingIntegration.operating_integration_integrable_by_default === true,
+    run_surface: operatingIntegration.run_surface || null,
+    run_path_ids: Array.isArray(operatingIntegration.default_run_path_ids) ? operatingIntegration.default_run_path_ids : []
+  };
+}
+
+function summarizeReviewOperatingPathCarry(input) {
+  const operatingPath = summarizeReviewOperatingPath(input);
+  return {
+    ok: operatingPath.ok === true,
+    operating_path_ref: operatingPath.operating_path_ref || null,
+    accepted_operating_path_ids: Array.isArray(operatingPath.accepted_operating_path_ids) ? operatingPath.accepted_operating_path_ids : [],
+    operating_path_carry: {
+      run_surface: operatingPath.run_surface || null,
+      run_path_ids: Array.isArray(operatingPath.run_path_ids) ? operatingPath.run_path_ids : []
+    },
+    adapter_ready_by_default: operatingPath.adapter_ready_by_default === true
+  };
+}
+
+function summarizeReviewOperatingPathRun(input) {
+  const operatingPath = summarizeReviewOperatingPath(input);
+  return {
+    ok: operatingPath.ok === true,
+    operating_path_ref: operatingPath.operating_path_ref || null,
+    accepted_operating_path_ids: Array.isArray(operatingPath.accepted_operating_path_ids) ? operatingPath.accepted_operating_path_ids : [],
+    operating_path_ready_by_default: operatingPath.adapter_ready_by_default === true,
+    run_surface: operatingPath.run_surface || null,
+    default_run_path_ids: Array.isArray(operatingPath.run_path_ids) ? operatingPath.run_path_ids : []
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1959,6 +1998,9 @@ module.exports = {
   summarizeReviewOperatingIntegration,
   summarizeReviewOperatingIntegrationCarry,
   summarizeReviewOperatingIntegrationRun,
+  summarizeReviewOperatingPath,
+  summarizeReviewOperatingPathCarry,
+  summarizeReviewOperatingPathRun,
   summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,

package/server.js

@@ -567,6 +567,39 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/operating-path') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewOperatingPath(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/operating-path-carry') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewOperatingPathCarry(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/operating-path-run') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewOperatingPathRun(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);