xoonya 1.21.0 → 1.22.0

package/README.md

@@ -159,6 +159,9 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/operating-contract`
 - `POST /v1/proof-center/result-package-handoff/review/operating-contract-carry`
 - `POST /v1/proof-center/result-package-handoff/review/operating-contract-run`
+- `POST /v1/proof-center/result-package-handoff/review/operating-interface`
+- `POST /v1/proof-center/result-package-handoff/review/operating-interface-carry`
+- `POST /v1/proof-center/result-package-handoff/review/operating-interface-run`
 - `POST /v1/proof-center/result-package-handoff/review/handoff-run`
 - `POST /v1/proof-center/result-package-handoff/run`
 
@@ -210,6 +213,15 @@ The current `1.21.0` line starts turning that adapter-operable execution contrac
 - clearer operating-contract ids across review, carry, and proof-native run posture
 
 This is intended to make the proof-side continuation path easier to depend on repeatedly as a durable public operating contract instead of only a contract that is operable in the moment.
+
+The current `1.22.0` line starts turning that adapter-stable operating contract into a clearer adapter-reliable operating interface:
+
+- proof-side operating-interface posture on top of the operating-contract path
+- compact operating-interface carry for direct reliable proof-side interface carry
+- proof-side operating-interface run posture for direct default proof-native reliable posture
+- clearer operating-interface ids across review, carry, and proof-native run posture
+
+This is intended to make the proof-side continuation path easier to rely on operationally as a durable public interface instead of only a stable operating contract shape.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

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

package/proof_sdk.js

@@ -1792,6 +1792,45 @@ function summarizeReviewOperatingContractRun(input) {
   };
 }
 
+function summarizeReviewOperatingInterface(input) {
+  const operatingContract = summarizeReviewOperatingContractRun(input);
+  return {
+    ok: operatingContract.ok === true,
+    operating_contract_ref: operatingContract.operating_contract_ref || null,
+    operating_interface_ref: operatingContract.operating_contract_ref ? `interface.${operatingContract.operating_contract_ref}` : null,
+    accepted_operating_interface_ids: Array.isArray(operatingContract.accepted_operating_contract_ids) ? operatingContract.accepted_operating_contract_ids : [],
+    adapter_reliable: operatingContract.operating_stable_by_default === true,
+    run_surface: operatingContract.run_surface || null,
+    run_path_ids: Array.isArray(operatingContract.default_run_path_ids) ? operatingContract.default_run_path_ids : []
+  };
+}
+
+function summarizeReviewOperatingInterfaceCarry(input) {
+  const operatingInterface = summarizeReviewOperatingInterface(input);
+  return {
+    ok: operatingInterface.ok === true,
+    operating_interface_ref: operatingInterface.operating_interface_ref || null,
+    accepted_operating_interface_ids: Array.isArray(operatingInterface.accepted_operating_interface_ids) ? operatingInterface.accepted_operating_interface_ids : [],
+    operating_interface_carry: {
+      run_surface: operatingInterface.run_surface || null,
+      run_path_ids: Array.isArray(operatingInterface.run_path_ids) ? operatingInterface.run_path_ids : []
+    },
+    adapter_reliable: operatingInterface.adapter_reliable === true
+  };
+}
+
+function summarizeReviewOperatingInterfaceRun(input) {
+  const operatingInterface = summarizeReviewOperatingInterface(input);
+  return {
+    ok: operatingInterface.ok === true,
+    operating_interface_ref: operatingInterface.operating_interface_ref || null,
+    accepted_operating_interface_ids: Array.isArray(operatingInterface.accepted_operating_interface_ids) ? operatingInterface.accepted_operating_interface_ids : [],
+    operating_interface_reliable_by_default: operatingInterface.adapter_reliable === true,
+    run_surface: operatingInterface.run_surface || null,
+    default_run_path_ids: Array.isArray(operatingInterface.run_path_ids) ? operatingInterface.run_path_ids : []
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1875,6 +1914,9 @@ module.exports = {
   summarizeReviewOperatingContract,
   summarizeReviewOperatingContractCarry,
   summarizeReviewOperatingContractRun,
+  summarizeReviewOperatingInterface,
+  summarizeReviewOperatingInterfaceCarry,
+  summarizeReviewOperatingInterfaceRun,
   summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,

package/server.js

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