xoonya 1.20.0 → 1.21.0

package/README.md

@@ -156,6 +156,9 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/execution-contract`
 - `POST /v1/proof-center/result-package-handoff/review/execution-contract-carry`
 - `POST /v1/proof-center/result-package-handoff/review/execution-contract-run`
+- `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/handoff-run`
 - `POST /v1/proof-center/result-package-handoff/run`
 
@@ -198,6 +201,15 @@ The current `1.20.0` line starts turning that adapter-ready execution package in
 - clearer execution-contract ids across review, carry, and proof-native run posture
 
 This is intended to make the proof-side continuation path easier to operate against repeatedly as a stable public contract instead of only a package that is execution-ready by posture.
+
+The current `1.21.0` line starts turning that adapter-operable execution contract into a clearer adapter-stable operating contract:
+
+- proof-side operating-contract posture on top of the execution-contract path
+- compact operating-contract carry for direct stable proof-side operating carry
+- proof-side operating-contract run posture for direct default proof-native operating posture
+- 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.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

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

package/proof_sdk.js

@@ -1753,6 +1753,45 @@ function summarizeReviewExecutionContractRun(input) {
   };
 }
 
+function summarizeReviewOperatingContract(input) {
+  const executionContract = summarizeReviewExecutionContractRun(input);
+  return {
+    ok: executionContract.ok === true,
+    execution_contract_ref: executionContract.execution_contract_ref || null,
+    operating_contract_ref: executionContract.execution_contract_ref ? `operating.${executionContract.execution_contract_ref}` : null,
+    accepted_operating_contract_ids: Array.isArray(executionContract.accepted_execution_contract_ids) ? executionContract.accepted_execution_contract_ids : [],
+    adapter_stable: executionContract.execution_operable_by_default === true,
+    run_surface: executionContract.run_surface || null,
+    run_path_ids: Array.isArray(executionContract.default_run_path_ids) ? executionContract.default_run_path_ids : []
+  };
+}
+
+function summarizeReviewOperatingContractCarry(input) {
+  const operatingContract = summarizeReviewOperatingContract(input);
+  return {
+    ok: operatingContract.ok === true,
+    operating_contract_ref: operatingContract.operating_contract_ref || null,
+    accepted_operating_contract_ids: Array.isArray(operatingContract.accepted_operating_contract_ids) ? operatingContract.accepted_operating_contract_ids : [],
+    operating_contract_carry: {
+      run_surface: operatingContract.run_surface || null,
+      run_path_ids: Array.isArray(operatingContract.run_path_ids) ? operatingContract.run_path_ids : []
+    },
+    adapter_stable: operatingContract.adapter_stable === true
+  };
+}
+
+function summarizeReviewOperatingContractRun(input) {
+  const operatingContract = summarizeReviewOperatingContract(input);
+  return {
+    ok: operatingContract.ok === true,
+    operating_contract_ref: operatingContract.operating_contract_ref || null,
+    accepted_operating_contract_ids: Array.isArray(operatingContract.accepted_operating_contract_ids) ? operatingContract.accepted_operating_contract_ids : [],
+    operating_stable_by_default: operatingContract.adapter_stable === true,
+    run_surface: operatingContract.run_surface || null,
+    default_run_path_ids: Array.isArray(operatingContract.run_path_ids) ? operatingContract.run_path_ids : []
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1833,6 +1872,9 @@ module.exports = {
   summarizeReviewExecutionContract,
   summarizeReviewExecutionContractCarry,
   summarizeReviewExecutionContractRun,
+  summarizeReviewOperatingContract,
+  summarizeReviewOperatingContractCarry,
+  summarizeReviewOperatingContractRun,
   summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,

package/server.js

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