xytara 3.1.0 → 3.1.2

package/lib/payment_front_registry.js

@@ -1,53 +1,53 @@
-"use strict";
-
-const { summarizeX402LanePack } = require("./x402_lane_contract");
-const { summarizeStripeMppLanePack } = require("./stripe_mpp_lane_contract");
-const { summarizeL402LanePack } = require("./l402_lane_contract");
-const { summarizeBoltLanePack } = require("./bolt_lane_contract");
-
-function buildPaymentFrontRegistryPack() {
-  return {
-    product: "xytara",
-    category: "machine-commerce-payment-front-registry-pack",
-    pack_version: "xytara-payment-front-registry-pack-v1",
-    posture: "multiple_payment_fronts_one_runtime_core",
-    fronts: {
-      x402: summarizeX402LanePack(),
-      hosted_checkout: summarizeStripeMppLanePack(),
-      l402: summarizeL402LanePack(),
-      bolt_utxo_spv: summarizeBoltLanePack(),
-      account_credits: {
-        product: "xytara",
-        category: "machine-commerce-account-credits-front",
-        summary_version: "xytara-account-credits-front-summary-v1",
-        posture: "repeat_use_spend_surface"
-      }
-    },
-    operator_rule: "add payment fronts where they improve adoption or economics, but keep execution/governance/proof semantics centralized",
-    linked_surfaces: {
-      payment_protocols_ref: "/v1/payment-protocols",
-      payment_protocol_strategy_ref: "/v1/payment-protocols/strategy",
-      x402_ref: "/v1/x402",
-      stripe_mpp_ref: "/v1/stripe-mpp",
-      l402_ref: "/v1/l402",
-      bolt_ref: "/v1/bolt"
-    }
-  };
-}
-
-function summarizePaymentFrontRegistryPack() {
-  const pack = buildPaymentFrontRegistryPack();
-  return {
-    product: pack.product,
-    category: pack.category,
-    summary_version: "xytara-payment-front-registry-pack-summary-v1",
-    posture: pack.posture,
-    front_count: Object.keys(pack.fronts).length,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-module.exports = {
-  buildPaymentFrontRegistryPack,
-  summarizePaymentFrontRegistryPack
-};
+"use strict";
+
+const { summarizeX402LanePack } = require("./x402_lane_contract");
+const { summarizeStripeMppLanePack } = require("./stripe_mpp_lane_contract");
+const { summarizeL402LanePack } = require("./l402_lane_contract");
+const { summarizeBoltLanePack } = require("./bolt_lane_contract");
+
+function buildPaymentFrontRegistryPack() {
+  return {
+    product: "xytara",
+    category: "machine-commerce-payment-front-registry-pack",
+    pack_version: "xytara-payment-front-registry-pack-v1",
+    posture: "multiple_payment_fronts_one_runtime_core",
+    fronts: {
+      x402: summarizeX402LanePack(),
+      hosted_checkout: summarizeStripeMppLanePack(),
+      l402: summarizeL402LanePack(),
+      bolt_utxo_spv: summarizeBoltLanePack(),
+      account_credits: {
+        product: "xytara",
+        category: "machine-commerce-account-credits-front",
+        summary_version: "xytara-account-credits-front-summary-v1",
+        posture: "repeat_use_spend_surface"
+      }
+    },
+    operator_rule: "add payment fronts where they improve adoption or economics, but keep execution/governance/proof semantics centralized",
+    linked_surfaces: {
+      payment_protocols_ref: "/v1/payment-protocols",
+      payment_protocol_strategy_ref: "/v1/payment-protocols/strategy",
+      x402_ref: "/v1/x402",
+      stripe_mpp_ref: "/v1/stripe-mpp",
+      l402_ref: "/v1/l402",
+      bolt_ref: "/v1/bolt"
+    }
+  };
+}
+
+function summarizePaymentFrontRegistryPack() {
+  const pack = buildPaymentFrontRegistryPack();
+  return {
+    product: pack.product,
+    category: pack.category,
+    summary_version: "xytara-payment-front-registry-pack-summary-v1",
+    posture: pack.posture,
+    front_count: Object.keys(pack.fronts).length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+module.exports = {
+  buildPaymentFrontRegistryPack,
+  summarizePaymentFrontRegistryPack
+};

package/lib/payment_protocol_contract.js

@@ -1,165 +1,165 @@
-"use strict";
-
-function buildPaymentProtocolPack() {
-  return {
-    product: "xytara",
-    category: "machine-commerce-payment-protocol-pack",
-    pack_version: "xytara-payment-protocol-pack-v1",
-    lane_state: "default_machine_payment_plus_credit_and_adapter_expansion",
-    default_protocol: "x402",
-    current_native_payment_paths: [
-      {
-        protocol_id: "x402",
-        state: "first_party_default",
-        why_it_exists: "default machine-native quote -> challenge -> pay -> execute handshake"
-      },
-      {
-        protocol_id: "account_credits",
-        state: "first_party_repeat_use",
-        why_it_exists: "best repeat-use path for agents and operators that should not re-negotiate every call"
-      },
-      {
-        protocol_id: "stripe_mpp",
-        state: "first_party_human_checkout_lane",
-        why_it_exists: "human checkout, top-up, and hosted payment entry without making human checkout the center of the stack"
-      }
-    ],
-    adapter_ready_external_fronts: [
-      {
-        protocol_id: "l402",
-        state: "adapter_ready_current",
-        why_it_matters: "lightning-native service payment can matter for agents that want highly permissionless micropayment access"
-      },
-      {
-        protocol_id: "utxo_spv_payment_fronts",
-        state: "adapter_ready_current",
-        why_it_matters: "native UTXO verification and SPV-style settlement proofs can matter where facilitator dependence is undesirable"
-      },
-      {
-        protocol_id: "circle_nanopayments",
-        state: "adapter_ready_next",
-        why_it_matters: "high-frequency stable-value collection can complement machine-native pricing and credit replenishment"
-      },
-      {
-        protocol_id: "circle_cctp",
-        state: "adapter_ready_next",
-        why_it_matters: "stable-value treasury mobility can expand settlement reach without redefining runtime execution"
-      },
-      {
-        protocol_id: "future_payment_front_protocols",
-        state: "adapter_front_only",
-        why_it_matters: "similar future negotiation and payment protocols should be absorbed by the payment front instead of hardwiring brand-specific ideology into the runtime"
-      }
-    ],
-    charging_boundary: {
-      keep_free: [
-        "auth",
-        "discovery",
-        "docs",
-        "catalog_inspection",
-        "contract_views",
-        "release_and_start_paths",
-        "lightweight_preview_and_readiness_surfaces"
-      ],
-      keep_paid: [
-        "execution",
-        "quoted_runtime_work",
-        "credit_consumption",
-        "settlement_bearing_operations",
-        "resource_consuming_runtime_consequence",
-        "high_consequence_or_governed_machine_actions"
-      ],
-      principle: "do_not_charge_before_value_is_felt_but_do_not_give_runtime_consequence_away_for_free"
-    },
-    supported_surfaces: {
-      x402_lane_ref: "/v1/x402",
-      stripe_mpp_lane_ref: "/v1/stripe-mpp",
-      l402_lane_ref: "/v1/l402",
-      bolt_lane_ref: "/v1/bolt",
-      payment_front_registry_ref: "/v1/payment-fronts",
-      stablecoin_lane_ref: "/v1/stablecoins",
-      pricing_optimization_ref: "/v1/pricing-optimization",
-      treasury_destinations_ref: "/v1/treasury-destinations"
-    }
-  };
-}
-
-function buildPaymentProtocolStrategyPack() {
-  const pack = buildPaymentProtocolPack();
-  return {
-    product: "xytara",
-    category: "machine-commerce-payment-protocol-strategy-pack",
-    pack_version: "xytara-payment-protocol-strategy-pack-v1",
-    primary_protocol_thesis: {
-      machine_native_default: "x402",
-      repeat_use_default: "account_credits",
-      human_procurement_default: "hosted_checkout",
-      strategy_rule: "keep the commerce core protocol-agnostic while using the least-friction lane that fits the actor and operating constraint"
-    },
-    protocol_roles: [
-      {
-        protocol_id: "x402",
-        role: "machine_native_http_payment",
-        why_now: "strong fit for agent-call monetization, quote-to-pay flows, and interoperable HTTP-native machine commerce"
-      },
-      {
-        protocol_id: "account_credits",
-        role: "repeat_use_and_metered_runtime_spend",
-        why_now: "best fit for repeated agent use where renegotiating payment every call adds friction"
-      },
-      {
-        protocol_id: "hosted_checkout",
-        role: "human_checkout_and_procurement_entry",
-        why_now: "best fit for public SaaS sales, enterprise procurement, and external fiat money-in lanes"
-      },
-      {
-        protocol_id: "l402_or_other_permissionless_fronts",
-        role: "permissionless_adapter_payment_front",
-        why_now: "worth supporting through adapter fronts now when customers strongly value lower dependency or Lightning-native / UTXO-native settlement"
-      }
-    ],
-    commercialization_rules: [
-      "Use x402 as the primary self-serve machine paywall.",
-      "Use credits as the primary repeat-use spend posture after first conversion.",
-      "Use hosted checkout for humans and enterprise buyers, then convert that funding into internal authorization or credits.",
-      "Treat future permissionless fronts as adapter lanes into the same execution, proof, and governance core rather than as a fork of the product."
-    ],
-    operator_decisions: {
-      launch_primary_machine_lane: "x402",
-      launch_primary_human_lane: "hosted_checkout",
-      launch_repeat_use_lane: "account_credits",
-      current_optional_permissionless_lanes: ["l402", "utxo_spv_payment_fronts"]
-    },
-    linked_surfaces: {
-      payment_protocols_ref: "/v1/payment-protocols",
-      x402_lane_ref: "/v1/x402",
-      hosted_checkout_lane_ref: "/v1/stripe-mpp",
-      l402_lane_ref: "/v1/l402",
-      bolt_lane_ref: "/v1/bolt",
-      payment_front_registry_ref: "/v1/payment-fronts",
-      commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
-      execution_truth_ref: "/v1/capability-registry/execution-truth"
-    }
-  };
-}
-
-function summarizePaymentProtocolPack() {
-  const pack = buildPaymentProtocolPack();
-  return {
-    product: "xytara",
-    category: "machine-commerce-payment-protocol-pack-summary",
-    summary_version: "xytara-payment-protocol-pack-summary-v1",
-    default_protocol: pack.default_protocol,
-    current_path_count: pack.current_native_payment_paths.length,
-    adapter_ready_external_front_count: pack.adapter_ready_external_fronts.length,
-    free_boundary_count: pack.charging_boundary.keep_free.length,
-    paid_boundary_count: pack.charging_boundary.keep_paid.length,
-    linked_surfaces: pack.supported_surfaces
-  };
-}
-
-module.exports = {
-  buildPaymentProtocolPack,
-  buildPaymentProtocolStrategyPack,
-  summarizePaymentProtocolPack
-};
+"use strict";
+
+function buildPaymentProtocolPack() {
+  return {
+    product: "xytara",
+    category: "machine-commerce-payment-protocol-pack",
+    pack_version: "xytara-payment-protocol-pack-v1",
+    lane_state: "default_machine_payment_plus_credit_and_adapter_expansion",
+    default_protocol: "x402",
+    current_native_payment_paths: [
+      {
+        protocol_id: "x402",
+        state: "first_party_default",
+        why_it_exists: "default machine-native quote -> challenge -> pay -> execute handshake"
+      },
+      {
+        protocol_id: "account_credits",
+        state: "first_party_repeat_use",
+        why_it_exists: "best repeat-use path for agents and operators that should not re-negotiate every call"
+      },
+      {
+        protocol_id: "stripe_mpp",
+        state: "first_party_human_checkout_lane",
+        why_it_exists: "human checkout, top-up, and hosted payment entry without making human checkout the center of the stack"
+      }
+    ],
+    adapter_ready_external_fronts: [
+      {
+        protocol_id: "l402",
+        state: "adapter_ready_current",
+        why_it_matters: "lightning-native service payment can matter for agents that want highly permissionless micropayment access"
+      },
+      {
+        protocol_id: "utxo_spv_payment_fronts",
+        state: "adapter_ready_current",
+        why_it_matters: "native UTXO verification and SPV-style settlement proofs can matter where facilitator dependence is undesirable"
+      },
+      {
+        protocol_id: "circle_nanopayments",
+        state: "adapter_ready_next",
+        why_it_matters: "high-frequency stable-value collection can complement machine-native pricing and credit replenishment"
+      },
+      {
+        protocol_id: "circle_cctp",
+        state: "adapter_ready_next",
+        why_it_matters: "stable-value treasury mobility can expand settlement reach without redefining runtime execution"
+      },
+      {
+        protocol_id: "future_payment_front_protocols",
+        state: "adapter_front_only",
+        why_it_matters: "similar future negotiation and payment protocols should be absorbed by the payment front instead of hardwiring brand-specific ideology into the runtime"
+      }
+    ],
+    charging_boundary: {
+      keep_free: [
+        "auth",
+        "discovery",
+        "docs",
+        "catalog_inspection",
+        "contract_views",
+        "release_and_start_paths",
+        "lightweight_preview_and_readiness_surfaces"
+      ],
+      keep_paid: [
+        "execution",
+        "quoted_runtime_work",
+        "credit_consumption",
+        "settlement_bearing_operations",
+        "resource_consuming_runtime_consequence",
+        "high_consequence_or_governed_machine_actions"
+      ],
+      principle: "do_not_charge_before_value_is_felt_but_do_not_give_runtime_consequence_away_for_free"
+    },
+    supported_surfaces: {
+      x402_lane_ref: "/v1/x402",
+      stripe_mpp_lane_ref: "/v1/stripe-mpp",
+      l402_lane_ref: "/v1/l402",
+      bolt_lane_ref: "/v1/bolt",
+      payment_front_registry_ref: "/v1/payment-fronts",
+      stablecoin_lane_ref: "/v1/stablecoins",
+      pricing_optimization_ref: "/v1/pricing-optimization",
+      treasury_destinations_ref: "/v1/treasury-destinations"
+    }
+  };
+}
+
+function buildPaymentProtocolStrategyPack() {
+  const pack = buildPaymentProtocolPack();
+  return {
+    product: "xytara",
+    category: "machine-commerce-payment-protocol-strategy-pack",
+    pack_version: "xytara-payment-protocol-strategy-pack-v1",
+    primary_protocol_thesis: {
+      machine_native_default: "x402",
+      repeat_use_default: "account_credits",
+      human_procurement_default: "hosted_checkout",
+      strategy_rule: "keep the commerce core protocol-agnostic while using the least-friction lane that fits the actor and operating constraint"
+    },
+    protocol_roles: [
+      {
+        protocol_id: "x402",
+        role: "machine_native_http_payment",
+        why_now: "strong fit for agent-call monetization, quote-to-pay flows, and interoperable HTTP-native machine commerce"
+      },
+      {
+        protocol_id: "account_credits",
+        role: "repeat_use_and_metered_runtime_spend",
+        why_now: "best fit for repeated agent use where renegotiating payment every call adds friction"
+      },
+      {
+        protocol_id: "hosted_checkout",
+        role: "human_checkout_and_procurement_entry",
+        why_now: "best fit for public SaaS sales, enterprise procurement, and external fiat money-in lanes"
+      },
+      {
+        protocol_id: "l402_or_other_permissionless_fronts",
+        role: "permissionless_adapter_payment_front",
+        why_now: "worth supporting through adapter fronts now when customers strongly value lower dependency or Lightning-native / UTXO-native settlement"
+      }
+    ],
+    commercialization_rules: [
+      "Use x402 as the primary self-serve machine paywall.",
+      "Use credits as the primary repeat-use spend posture after first conversion.",
+      "Use hosted checkout for humans and enterprise buyers, then convert that funding into internal authorization or credits.",
+      "Treat future permissionless fronts as adapter lanes into the same execution, proof, and governance core rather than as a fork of the product."
+    ],
+    operator_decisions: {
+      launch_primary_machine_lane: "x402",
+      launch_primary_human_lane: "hosted_checkout",
+      launch_repeat_use_lane: "account_credits",
+      current_optional_permissionless_lanes: ["l402", "utxo_spv_payment_fronts"]
+    },
+    linked_surfaces: {
+      payment_protocols_ref: "/v1/payment-protocols",
+      x402_lane_ref: "/v1/x402",
+      hosted_checkout_lane_ref: "/v1/stripe-mpp",
+      l402_lane_ref: "/v1/l402",
+      bolt_lane_ref: "/v1/bolt",
+      payment_front_registry_ref: "/v1/payment-fronts",
+      commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
+      execution_truth_ref: "/v1/capability-registry/execution-truth"
+    }
+  };
+}
+
+function summarizePaymentProtocolPack() {
+  const pack = buildPaymentProtocolPack();
+  return {
+    product: "xytara",
+    category: "machine-commerce-payment-protocol-pack-summary",
+    summary_version: "xytara-payment-protocol-pack-summary-v1",
+    default_protocol: pack.default_protocol,
+    current_path_count: pack.current_native_payment_paths.length,
+    adapter_ready_external_front_count: pack.adapter_ready_external_fronts.length,
+    free_boundary_count: pack.charging_boundary.keep_free.length,
+    paid_boundary_count: pack.charging_boundary.keep_paid.length,
+    linked_surfaces: pack.supported_surfaces
+  };
+}
+
+module.exports = {
+  buildPaymentProtocolPack,
+  buildPaymentProtocolStrategyPack,
+  summarizePaymentProtocolPack
+};