xytara 1.21.0 → 1.23.0

package/README.md

@@ -217,6 +217,24 @@ The current `1.21.0` line starts turning that adapter-operable execution contrac
 
 This is intended to make the transaction-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:
+
+- operating-interface summaries on top of the default operating-contract path
+- compact operating-interface bundles for direct adapter-facing reliable interface posture
+- default operating-interface summaries for the next proof-side operating-interface run posture
+- clearer operating-interface ids and stable reliable interface carry
+
+This is intended to make the transaction-side continuation path easier to rely on operationally as a durable public interface instead of only a stable operating contract shape.
+
+The current `1.23.0` line starts turning that adapter-reliable operating interface into a clearer adapter-integrable operating path:
+
+- operating-integration summaries on top of the default operating-interface path
+- compact operating-integration bundles for direct adapter-facing integration posture
+- default operating-integration summaries for the next proof-side operating-integration run posture
+- clearer operating-integration ids and stable integrable carry
+
+This is intended to make the transaction-side continuation path easier to plug into adapters directly as a durable public operating path instead of only a reliable interface shape.
+
 ## Package Surface
 
 The SDK is broad, but it stays organized into a few repeatable families instead of one-off surfaces.

package/index.js

@@ -40,7 +40,7 @@ const {
 } = require("./integrations/registry");
 
 const COMMERCE_SDK_NAME = "xytara";
-const COMMERCE_SDK_VERSION = "1.21.0";
+const COMMERCE_SDK_VERSION = "1.23.0";
 const COMMERCE_API_VERSION = "v1";
 
 function createClient(options) {

package/lib/commerce_client.js

@@ -4824,6 +4824,102 @@ class CommerceClient {
     });
   }
 
+  async prepareInteractionResultPackageOperatingInterfaceSummary(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-interface-summary", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.interface.summary",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
+  async prepareInteractionResultPackageOperatingInterfaceBundle(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-interface-bundle", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.interface.bundle",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
+  async prepareInteractionResultPackageOperatingInterfaceDefaultSummary(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-interface-default-summary", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.interface.default.summary",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
+  async prepareInteractionResultPackageOperatingIntegrationSummary(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-integration-summary", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.integration.summary",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
+  async prepareInteractionResultPackageOperatingIntegrationBundle(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-integration-bundle", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.integration.bundle",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
+  async prepareInteractionResultPackageOperatingIntegrationDefaultSummary(continuationRef, body, options) {
+    const opts = options || {};
+    return this.runNamedTaskRoute("/v1/transaction-center/result-package-continuations/prepare/operating-integration-default-summary", {
+      command: opts.command || String(continuationRef || "").trim() || "result.package.continuation.operating.integration.default.summary",
+      continuation_ref: String(continuationRef || "").trim(),
+      body: body || {},
+      callback_url: opts.callbackUrl || null,
+      settlement_mode: opts.settlementMode || null,
+      payment_protocol: opts.paymentProtocol || null,
+      protocol: opts.protocol || null,
+      integration_id: opts.integrationId || null,
+      integration_ids: Array.isArray(opts.integrationIds) ? opts.integrationIds : [],
+      integration_context: opts.integrationContext || null
+    });
+  }
+
   async runNamedTaskRoute(path, payload) {
     if (!this.apiKey || !this.walletId || !this.walletSecret) {
       throw new Error("named task routes require apiKey, walletId, and walletSecret");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xytara",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "Machine commerce SDK for discovery, quoting, execution, lifecycle inspection, and adapters.",
   "main": "index.js",
   "type": "commonjs",

package/server.js

@@ -1724,6 +1724,110 @@ function buildPreparedContinuationDefaultOperatingContractSummary(portableHandof
   };
 }
 
+function buildPreparedContinuationAdapterReliableOperatingInterfaceSummary(portableHandoff, continuation) {
+  const operatingContract = buildPreparedContinuationDefaultOperatingContractSummary(portableHandoff, continuation);
+  return {
+    ok: operatingContract.ok === true,
+    default_operating_contract_ref: operatingContract.default_operating_contract_ref || null,
+    operating_interface_ref: operatingContract.default_operating_contract_ref
+      ? `interface.${operatingContract.default_operating_contract_ref}`
+      : null,
+    reliable_operating_interface_ids: Array.isArray(operatingContract.stable_default_operating_contract_ids)
+      ? operatingContract.stable_default_operating_contract_ids
+      : [],
+    operating_interface_carry: operatingContract.default_operating_contract_carry || {},
+    adapter_reliable: operatingContract.operating_stable_by_default === true,
+    next_surface: "/v1/proof-center/result-package-handoff/review/operating-interface"
+  };
+}
+
+function buildPreparedContinuationAdapterReliableOperatingInterfaceBundle(portableHandoff, continuation) {
+  const handoff = portableHandoff && typeof portableHandoff === "object" ? portableHandoff : {};
+  const summary = buildPreparedContinuationAdapterReliableOperatingInterfaceSummary(portableHandoff, continuation);
+  return {
+    ok: true,
+    operating_interface_summary: summary,
+    operating_interface_template: {
+      ok: true,
+      operating_interface_ref: summary.operating_interface_ref || null,
+      target_surface: "/v1/proof-center/result-package-handoff/review/operating-interface",
+      request_template: {
+        handoff_bundle: handoff
+      },
+      stable_boundary_ids: Array.isArray(summary.reliable_operating_interface_ids) ? summary.reliable_operating_interface_ids : []
+    }
+  };
+}
+
+function buildPreparedContinuationDefaultOperatingInterfaceSummary(portableHandoff, continuation) {
+  const operatingInterface = buildPreparedContinuationAdapterReliableOperatingInterfaceSummary(portableHandoff, continuation);
+  return {
+    ok: operatingInterface.ok === true,
+    operating_interface_ref: operatingInterface.operating_interface_ref || null,
+    default_operating_interface_ref: operatingInterface.operating_interface_ref
+      ? `default.${operatingInterface.operating_interface_ref}`
+      : null,
+    stable_default_operating_interface_ids: Array.isArray(operatingInterface.reliable_operating_interface_ids)
+      ? operatingInterface.reliable_operating_interface_ids
+      : [],
+    default_operating_interface_carry: operatingInterface.operating_interface_carry || {},
+    operating_interface_reliable_by_default: operatingInterface.adapter_reliable === true,
+    next_surface: "/v1/proof-center/result-package-handoff/review/operating-interface-run"
+  };
+}
+
+function buildPreparedContinuationAdapterIntegrableOperatingIntegrationSummary(portableHandoff, continuation) {
+  const operatingInterface = buildPreparedContinuationDefaultOperatingInterfaceSummary(portableHandoff, continuation);
+  return {
+    ok: operatingInterface.ok === true,
+    default_operating_interface_ref: operatingInterface.default_operating_interface_ref || null,
+    operating_integration_ref: operatingInterface.default_operating_interface_ref
+      ? `integration.${operatingInterface.default_operating_interface_ref}`
+      : null,
+    integrable_operating_ids: Array.isArray(operatingInterface.stable_default_operating_interface_ids)
+      ? operatingInterface.stable_default_operating_interface_ids
+      : [],
+    operating_integration_carry: operatingInterface.default_operating_interface_carry || {},
+    adapter_integrable: operatingInterface.operating_interface_reliable_by_default === true,
+    next_surface: "/v1/proof-center/result-package-handoff/review/operating-integration"
+  };
+}
+
+function buildPreparedContinuationAdapterIntegrableOperatingIntegrationBundle(portableHandoff, continuation) {
+  const handoff = portableHandoff && typeof portableHandoff === "object" ? portableHandoff : {};
+  const summary = buildPreparedContinuationAdapterIntegrableOperatingIntegrationSummary(portableHandoff, continuation);
+  return {
+    ok: true,
+    operating_integration_summary: summary,
+    operating_integration_template: {
+      ok: true,
+      operating_integration_ref: summary.operating_integration_ref || null,
+      target_surface: "/v1/proof-center/result-package-handoff/review/operating-integration",
+      request_template: {
+        handoff_bundle: handoff
+      },
+      stable_boundary_ids: Array.isArray(summary.integrable_operating_ids) ? summary.integrable_operating_ids : []
+    }
+  };
+}
+
+function buildPreparedContinuationDefaultOperatingIntegrationSummary(portableHandoff, continuation) {
+  const operatingIntegration = buildPreparedContinuationAdapterIntegrableOperatingIntegrationSummary(portableHandoff, continuation);
+  return {
+    ok: operatingIntegration.ok === true,
+    operating_integration_ref: operatingIntegration.operating_integration_ref || null,
+    default_operating_integration_ref: operatingIntegration.operating_integration_ref
+      ? `default.${operatingIntegration.operating_integration_ref}`
+      : null,
+    stable_default_operating_integration_ids: Array.isArray(operatingIntegration.integrable_operating_ids)
+      ? operatingIntegration.integrable_operating_ids
+      : [],
+    default_operating_integration_carry: operatingIntegration.operating_integration_carry || {},
+    operating_integration_integrable_by_default: operatingIntegration.adapter_integrable === true,
+    next_surface: "/v1/proof-center/result-package-handoff/review/operating-integration-run"
+  };
+}
+
 function buildInteractionResultPackageContinuationRequestTemplate(portableHandoff, continuation) {
   const handoff = portableHandoff && typeof portableHandoff === "object" ? portableHandoff : {};
   return {
@@ -3535,6 +3639,192 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-interface-summary") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationAdapterReliableOperatingInterfaceSummary(portableHandoff, continuation));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-interface-bundle") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationAdapterReliableOperatingInterfaceBundle(portableHandoff, continuation));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-interface-default-summary") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationDefaultOperatingInterfaceSummary(portableHandoff, continuation));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-integration-summary") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationAdapterIntegrableOperatingIntegrationSummary(portableHandoff, continuation));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-integration-bundle") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationAdapterIntegrableOperatingIntegrationBundle(portableHandoff, continuation));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/operating-integration-default-summary") {
+    const body = await readJsonBody(req);
+    const continuationRef = String(body && body.continuation_ref || "").trim();
+    const continuation = getInteractionResultPackageContinuation(continuationRef);
+    if (!continuation) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const resultPackage = getInteractionResultPackage(continuation.result_package_ref);
+    if (!resultPackage) {
+      sendJson(res, 404, { ok: false, error: "result_package_not_found" });
+      return;
+    }
+    const payload = buildInteractionSpinePathRunPayload({
+      ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}),
+      spine_path_ref: resultPackage.source_ref
+    });
+    if (!payload) {
+      sendJson(res, 404, { ok: false, error: "result_package_continuation_not_found" });
+      return;
+    }
+    const result = executeCommandRequest(state, payload, req.headers);
+    if (result.status !== 200) {
+      sendJson(res, result.status, result.payload);
+      return;
+    }
+    const portableHandoff = buildInteractionResultPackagePortableHandoff(result.payload, resultPackage);
+    sendJson(res, 200, buildPreparedContinuationDefaultOperatingIntegrationSummary(portableHandoff, continuation));
+    return;
+  }
+
   if (req.method === "POST" && url.pathname === "/v1/transaction-center/result-package-continuations/prepare/contract-template") {
     const body = await readJsonBody(req);
     const continuationRef = String(body && body.continuation_ref || "").trim();