xytara 3.1.16 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/README.md +120 -92
  2. package/RELEASE_NOTES.md +7 -3
  3. package/START_HERE.md +56 -224
  4. package/bin/xytara.js +21 -8
  5. package/client.js +79 -1
  6. package/lib/{delivery_receipt.js → delivery_receipt_verify.js} +14 -100
  7. package/package.json +25 -35
  8. package/scripts/verify_client.js +418 -0
  9. package/scripts/verify_release_candidate.js +146 -45
  10. package/.env.example +0 -173
  11. package/ADAPTER_START_HERE.md +0 -56
  12. package/BSV_TERANODE_PLATFORM_DISCONTINUITY_RUNBOOK.md +0 -126
  13. package/CARRIED_HANDOFF_DEMO.md +0 -60
  14. package/EXAMPLE_PATHS.md +0 -53
  15. package/FINAL_CONTRACT.md +0 -498
  16. package/PARTNER_READY_PATH.md +0 -71
  17. package/PUBLIC_DEMO_SCRIPT.md +0 -78
  18. package/REAL_PAYMENT_SETUP.md +0 -320
  19. package/SERVICE_CONTRACT.md +0 -419
  20. package/SUPABASE_RUNTIME_STATE_SETUP.md +0 -61
  21. package/TERMINOLOGY.md +0 -50
  22. package/WHY_XYTARA_XOONYA.md +0 -63
  23. package/XT1_EXECUTION_TRUTH_STANDARD.md +0 -78
  24. package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +0 -75
  25. package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +0 -124
  26. package/XYTARA_DEFAULT_PATH_MODEL.md +0 -84
  27. package/XYTARA_EXECUTION_TRUTH_MODEL.md +0 -171
  28. package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +0 -68
  29. package/adapters/AUTHORING_GUIDE.md +0 -244
  30. package/adapters/ONBOARDING_POSTURE.md +0 -61
  31. package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +0 -84
  32. package/adapters/adapter-manifest.schema.json +0 -283
  33. package/adapters/examples/example-execution-adapter.js +0 -61
  34. package/adapters/examples/example-execution-adapter.manifest.json +0 -81
  35. package/adapters/examples/example-settlement-adapter.js +0 -55
  36. package/adapters/examples/example-settlement-adapter.manifest.json +0 -78
  37. package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +0 -124
  38. package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +0 -121
  39. package/adapters/examples/example-third-party-identity-registration.certification-pack.json +0 -22
  40. package/adapters/examples/example-third-party-identity-registration.record.json +0 -26
  41. package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +0 -126
  42. package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +0 -124
  43. package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +0 -120
  44. package/adapters/examples/example-third-party-registration.certification-pack.json +0 -22
  45. package/adapters/examples/example-third-party-registration.record.json +0 -28
  46. package/adapters/examples/example-third-party-registration.submission-bundle.json +0 -126
  47. package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +0 -22
  48. package/adapters/examples/example-third-party-settlement-registration.record.json +0 -26
  49. package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +0 -127
  50. package/adapters/examples/langchain-reference-execution-adapter.js +0 -81
  51. package/adapters/examples/langchain-reference-execution-adapter.manifest.json +0 -79
  52. package/adapters/examples/langgraph-reference-execution-adapter.js +0 -81
  53. package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +0 -79
  54. package/adapters/examples/minimal-third-party-execution-adapter.js +0 -61
  55. package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +0 -79
  56. package/adapters/examples/minimal-third-party-execution-registration.record.json +0 -26
  57. package/adapters/examples/minimal-third-party-execution.certification-pack.json +0 -22
  58. package/adapters/examples/minimal-third-party-execution.submission-bundle.json +0 -126
  59. package/adapters/integration-certification-pack.schema.json +0 -82
  60. package/adapters/integration-registration-record.schema.json +0 -114
  61. package/adapters/integration-submission-bundle-set.schema.json +0 -39
  62. package/adapters/integration-submission-bundle.schema.json +0 -34
  63. package/adapters/interfaces.js +0 -56
  64. package/bin/xytara-release.js +0 -1429
  65. package/examples/_demo_env.js +0 -40
  66. package/examples/adapter_review_walkthrough.js +0 -54
  67. package/examples/export_carried_handoff.js +0 -81
  68. package/examples/funded_runtime_walkthrough.js +0 -71
  69. package/examples/partner_launch_walkthrough.js +0 -44
  70. package/examples/quickstart.js +0 -3256
  71. package/fixtures/catalog.js +0 -1156
  72. package/index.js +0 -395
  73. package/integrations/dispatch.js +0 -276
  74. package/integrations/registry-snapshot.schema.json +0 -36
  75. package/integrations/registry.js +0 -2261
  76. package/integrations/views.js +0 -28
  77. package/lib/a2a_lane_contract.js +0 -104
  78. package/lib/a2a_rpc.js +0 -287
  79. package/lib/a2c_lane_contract.js +0 -111
  80. package/lib/account_auth.js +0 -585
  81. package/lib/acp_lane_contract.js +0 -54
  82. package/lib/activity_audit_contract.js +0 -322
  83. package/lib/adapter_certification_contract.js +0 -130
  84. package/lib/adapter_depth_contract.js +0 -218
  85. package/lib/adapter_pack.js +0 -118
  86. package/lib/adapter_partner_pack.js +0 -89
  87. package/lib/adapter_promotion_pack.js +0 -89
  88. package/lib/adapter_protocol_truth_contract.js +0 -229
  89. package/lib/agent_identity.js +0 -162
  90. package/lib/announcement_pack.js +0 -61
  91. package/lib/artifact_distribution_lane_contract.js +0 -54
  92. package/lib/asyncapi_contract.js +0 -150
  93. package/lib/auth_interop_contract.js +0 -80
  94. package/lib/authority_binding_lifecycle_contract.js +0 -182
  95. package/lib/autonomous_entry_contract.js +0 -409
  96. package/lib/bolt_adapter.js +0 -187
  97. package/lib/bolt_lane_contract.js +0 -55
  98. package/lib/bolt_payment_front.js +0 -224
  99. package/lib/business_cockpit.js +0 -378
  100. package/lib/buyer_event_log.js +0 -230
  101. package/lib/buyer_safety_policy.js +0 -132
  102. package/lib/capability_execution_truth.js +0 -276
  103. package/lib/capability_registry.js +0 -633
  104. package/lib/catalog_contract.js +0 -966
  105. package/lib/catalog_family_model.js +0 -193
  106. package/lib/catalog_views.js +0 -55
  107. package/lib/cdp_jwt.js +0 -57
  108. package/lib/checkout_event_security.js +0 -142
  109. package/lib/checkout_processor_adapter.js +0 -217
  110. package/lib/cloudevents_contract.js +0 -80
  111. package/lib/command_flow.js +0 -911
  112. package/lib/commerce_artifacts.js +0 -591
  113. package/lib/commerce_authority.js +0 -449
  114. package/lib/commerce_bridge.js +0 -274
  115. package/lib/commerce_cases.js +0 -399
  116. package/lib/commerce_checkout.js +0 -509
  117. package/lib/commerce_coordination.js +0 -346
  118. package/lib/commerce_economics.js +0 -4017
  119. package/lib/commerce_identity.js +0 -578
  120. package/lib/commerce_quotes.js +0 -266
  121. package/lib/commerce_reports.js +0 -14461
  122. package/lib/commerce_runtime.js +0 -322
  123. package/lib/commerce_shell.js +0 -257
  124. package/lib/crypto_agility_matrix.js +0 -125
  125. package/lib/default_path_contract.js +0 -412
  126. package/lib/delivery_summary_contract.js +0 -95
  127. package/lib/ecosystem_entry.js +0 -64
  128. package/lib/erc8004_lane_contract.js +0 -65
  129. package/lib/event_system_lane_contract.js +0 -75
  130. package/lib/execution_dedupe.js +0 -86
  131. package/lib/execution_truth_contract.js +0 -234
  132. package/lib/external_credit_bridge.js +0 -142
  133. package/lib/external_execution_policy.js +0 -143
  134. package/lib/external_execution_runtime.js +0 -238
  135. package/lib/feature_control_lane_contract.js +0 -54
  136. package/lib/first_run_conversion_contract.js +0 -290
  137. package/lib/framework_lane_contract.js +0 -89
  138. package/lib/framework_provider_promotion.js +0 -235
  139. package/lib/full_catalog_contract.js +0 -525
  140. package/lib/go_live_operator_pack.js +0 -391
  141. package/lib/http_transport.js +0 -99
  142. package/lib/identity_auth.js +0 -175
  143. package/lib/identity_interop_contract.js +0 -82
  144. package/lib/integration_matrix_contract.js +0 -102
  145. package/lib/l402_adapter.js +0 -241
  146. package/lib/l402_lane_contract.js +0 -55
  147. package/lib/l402_payment_front.js +0 -265
  148. package/lib/launch_narrative.js +0 -53
  149. package/lib/lifecycle_continuity_contract.js +0 -115
  150. package/lib/machine_identity_registry_contract.js +0 -199
  151. package/lib/major_rails_lane_contract.js +0 -150
  152. package/lib/market_lane_contract.js +0 -467
  153. package/lib/market_lane_depth_contract.js +0 -182
  154. package/lib/market_lane_promotion_contract.js +0 -210
  155. package/lib/market_lane_trace_contract.js +0 -278
  156. package/lib/mcp_lane_contract.js +0 -137
  157. package/lib/mpp_adapter.js +0 -237
  158. package/lib/network_transport.js +0 -110
  159. package/lib/offline_verifiability_recovery_contract.js +0 -155
  160. package/lib/openapi_contract.js +0 -300
  161. package/lib/operational_receipt_contract.js +0 -165
  162. package/lib/operator_intelligence.js +0 -407
  163. package/lib/outreach_copy_pack.js +0 -51
  164. package/lib/outreach_message_pack.js +0 -71
  165. package/lib/outreach_proof.js +0 -71
  166. package/lib/outreach_target_pack.js +0 -60
  167. package/lib/partner_intelligence.js +0 -105
  168. package/lib/payment_config.js +0 -257
  169. package/lib/payment_front_registry.js +0 -53
  170. package/lib/payment_protocol_contract.js +0 -165
  171. package/lib/payment_rail_truth_contract.js +0 -324
  172. package/lib/payment_verification.js +0 -357
  173. package/lib/phase_10_closeout_pack.js +0 -45
  174. package/lib/phase_10_completion_pack.js +0 -76
  175. package/lib/phase_10_decision_record_pack.js +0 -54
  176. package/lib/phase_10_decision_resolution_pack.js +0 -53
  177. package/lib/phase_10_demand_signal_adapters_runtime_pack.js +0 -74
  178. package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +0 -74
  179. package/lib/phase_10_freeze_baseline_pack.js +0 -67
  180. package/lib/phase_10_freeze_review_pack.js +0 -64
  181. package/lib/phase_10_gate_pack.js +0 -57
  182. package/lib/phase_10_long_tail_continuity_pack.js +0 -80
  183. package/lib/phase_10_long_tail_ecosystem_pack.js +0 -66
  184. package/lib/phase_10_niche_extension_registry_runtime_pack.js +0 -74
  185. package/lib/phase_1_claude_mcp_pack.js +0 -60
  186. package/lib/phase_1_claude_mcp_runtime_pack.js +0 -52
  187. package/lib/phase_1_ecosystem_pack.js +0 -67
  188. package/lib/phase_1_openai_codex_pack.js +0 -60
  189. package/lib/phase_1_openai_codex_runtime_pack.js +0 -52
  190. package/lib/phase_2_base_runtime_pack.js +0 -71
  191. package/lib/phase_2_base_usdc_runtime_pack.js +0 -72
  192. package/lib/phase_2_closeout_pack.js +0 -65
  193. package/lib/phase_2_completion_pack.js +0 -113
  194. package/lib/phase_2_decision_record_pack.js +0 -66
  195. package/lib/phase_2_decision_resolution_pack.js +0 -69
  196. package/lib/phase_2_eth_runtime_pack.js +0 -70
  197. package/lib/phase_2_evm_base_runtime_pack.js +0 -73
  198. package/lib/phase_2_evm_runtime_pack.js +0 -71
  199. package/lib/phase_2_flip_preview_pack.js +0 -60
  200. package/lib/phase_2_freeze_review_pack.js +0 -99
  201. package/lib/phase_2_gate_pack.js +0 -77
  202. package/lib/phase_2_payment_rails_pack.js +0 -71
  203. package/lib/phase_2_usdc_runtime_pack.js +0 -71
  204. package/lib/phase_3_brc_runtime_pack.js +0 -81
  205. package/lib/phase_3_bsv_teranode_runtime_pack.js +0 -83
  206. package/lib/phase_3_closeout_pack.js +0 -62
  207. package/lib/phase_3_completion_pack.js +0 -94
  208. package/lib/phase_3_decision_record_pack.js +0 -64
  209. package/lib/phase_3_decision_resolution_pack.js +0 -69
  210. package/lib/phase_3_freeze_baseline_pack.js +0 -67
  211. package/lib/phase_3_freeze_review_pack.js +0 -80
  212. package/lib/phase_3_gate_pack.js +0 -76
  213. package/lib/phase_3_metanet_runtime_pack.js +0 -81
  214. package/lib/phase_3_native_bsv_pack.js +0 -91
  215. package/lib/phase_3_native_continuity_pack.js +0 -82
  216. package/lib/phase_4_attestation_runtime_pack.js +0 -75
  217. package/lib/phase_4_closeout_pack.js +0 -45
  218. package/lib/phase_4_completion_pack.js +0 -94
  219. package/lib/phase_4_decision_record_pack.js +0 -54
  220. package/lib/phase_4_decision_resolution_pack.js +0 -45
  221. package/lib/phase_4_erc8004_runtime_pack.js +0 -76
  222. package/lib/phase_4_freeze_baseline_pack.js +0 -67
  223. package/lib/phase_4_freeze_review_pack.js +0 -68
  224. package/lib/phase_4_gate_pack.js +0 -58
  225. package/lib/phase_4_identity_registry_runtime_pack.js +0 -75
  226. package/lib/phase_4_identity_trust_pack.js +0 -73
  227. package/lib/phase_4_trust_continuity_pack.js +0 -86
  228. package/lib/phase_5_antelope_runtime_pack.js +0 -76
  229. package/lib/phase_5_closeout_pack.js +0 -44
  230. package/lib/phase_5_completion_pack.js +0 -82
  231. package/lib/phase_5_constellation_dag_runtime_pack.js +0 -76
  232. package/lib/phase_5_decision_record_pack.js +0 -54
  233. package/lib/phase_5_decision_resolution_pack.js +0 -45
  234. package/lib/phase_5_digibyte_dgb_runtime_pack.js +0 -76
  235. package/lib/phase_5_freeze_baseline_pack.js +0 -67
  236. package/lib/phase_5_freeze_review_pack.js +0 -68
  237. package/lib/phase_5_gate_pack.js +0 -58
  238. package/lib/phase_5_hedera_hbar_runtime_pack.js +0 -76
  239. package/lib/phase_5_kaspa_kas_runtime_pack.js +0 -76
  240. package/lib/phase_5_major_rails_continuity_pack.js +0 -86
  241. package/lib/phase_5_major_rails_pack.js +0 -110
  242. package/lib/phase_5_metal_runtime_pack.js +0 -76
  243. package/lib/phase_5_polkadot_dot_runtime_pack.js +0 -76
  244. package/lib/phase_5_proton_xpr_runtime_pack.js +0 -76
  245. package/lib/phase_5_solana_runtime_pack.js +0 -76
  246. package/lib/phase_6_autogen_runtime_pack.js +0 -72
  247. package/lib/phase_6_closeout_pack.js +0 -46
  248. package/lib/phase_6_completion_pack.js +0 -77
  249. package/lib/phase_6_decision_record_pack.js +0 -54
  250. package/lib/phase_6_decision_resolution_pack.js +0 -53
  251. package/lib/phase_6_framework_continuity_pack.js +0 -81
  252. package/lib/phase_6_framework_runtime_pack.js +0 -68
  253. package/lib/phase_6_freeze_baseline_pack.js +0 -68
  254. package/lib/phase_6_freeze_review_pack.js +0 -65
  255. package/lib/phase_6_gate_pack.js +0 -59
  256. package/lib/phase_6_langchain_runtime_pack.js +0 -72
  257. package/lib/phase_6_langgraph_runtime_pack.js +0 -72
  258. package/lib/phase_6_semantic_kernel_runtime_pack.js +0 -72
  259. package/lib/phase_7_closeout_pack.js +0 -45
  260. package/lib/phase_7_completion_pack.js +0 -85
  261. package/lib/phase_7_decision_record_pack.js +0 -53
  262. package/lib/phase_7_decision_resolution_pack.js +0 -53
  263. package/lib/phase_7_event_system_continuity_pack.js +0 -89
  264. package/lib/phase_7_event_system_pack.js +0 -76
  265. package/lib/phase_7_freeze_baseline_pack.js +0 -74
  266. package/lib/phase_7_freeze_review_pack.js +0 -65
  267. package/lib/phase_7_gate_pack.js +0 -58
  268. package/lib/phase_7_kafka_runtime_pack.js +0 -74
  269. package/lib/phase_7_mqtt_runtime_pack.js +0 -74
  270. package/lib/phase_7_nats_runtime_pack.js +0 -74
  271. package/lib/phase_7_webhook_event_bus_runtime_pack.js +0 -74
  272. package/lib/phase_8_closeout_pack.js +0 -46
  273. package/lib/phase_8_completion_pack.js +0 -82
  274. package/lib/phase_8_decision_record_pack.js +0 -54
  275. package/lib/phase_8_decision_resolution_pack.js +0 -53
  276. package/lib/phase_8_external_receipt_import_runtime_pack.js +0 -74
  277. package/lib/phase_8_external_result_import_runtime_pack.js +0 -74
  278. package/lib/phase_8_freeze_baseline_pack.js +0 -71
  279. package/lib/phase_8_freeze_review_pack.js +0 -64
  280. package/lib/phase_8_gate_pack.js +0 -58
  281. package/lib/phase_8_proof_bridge_continuity_pack.js +0 -86
  282. package/lib/phase_8_proof_bridges_pack.js +0 -72
  283. package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +0 -74
  284. package/lib/phase_9_closeout_pack.js +0 -46
  285. package/lib/phase_9_completion_pack.js +0 -82
  286. package/lib/phase_9_custody_refs_runtime_pack.js +0 -74
  287. package/lib/phase_9_decision_record_pack.js +0 -54
  288. package/lib/phase_9_decision_resolution_pack.js +0 -53
  289. package/lib/phase_9_freeze_baseline_pack.js +0 -71
  290. package/lib/phase_9_freeze_review_pack.js +0 -64
  291. package/lib/phase_9_gate_pack.js +0 -58
  292. package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +0 -74
  293. package/lib/phase_9_treasury_connectivity_pack.js +0 -72
  294. package/lib/phase_9_treasury_continuity_pack.js +0 -86
  295. package/lib/phase_9_treasury_destinations_runtime_pack.js +0 -74
  296. package/lib/phase_program_pack.js +0 -120
  297. package/lib/pricing_optimization_contract.js +0 -775
  298. package/lib/protocol_lane_contract.js +0 -117
  299. package/lib/provenance_lane_contract.js +0 -54
  300. package/lib/provider_lane_contract.js +0 -240
  301. package/lib/provider_network_contract.js +0 -149
  302. package/lib/provider_payout_execution.js +0 -155
  303. package/lib/provider_registry.js +0 -852
  304. package/lib/provider_runtime_journey_contract.js +0 -183
  305. package/lib/public_surface_policy_contract.js +0 -111
  306. package/lib/publish_plan.js +0 -51
  307. package/lib/rate_limiter.js +0 -81
  308. package/lib/record_queries.js +0 -48
  309. package/lib/release_candidate.js +0 -50
  310. package/lib/release_center.js +0 -1093
  311. package/lib/release_history.js +0 -205
  312. package/lib/release_manifest.js +0 -113
  313. package/lib/release_pack.js +0 -453
  314. package/lib/request_rate_limit.js +0 -144
  315. package/lib/resource_views.js +0 -31
  316. package/lib/revenue_launch_path_contract.js +0 -326
  317. package/lib/route_matchers.js +0 -34
  318. package/lib/route_params.js +0 -19
  319. package/lib/runtime_bridge.js +0 -124
  320. package/lib/runtime_operations_worker.js +0 -282
  321. package/lib/runtime_state_store.js +0 -495
  322. package/lib/settlement_bsv_live.js +0 -600
  323. package/lib/settlement_bsv_teranode.js +0 -117
  324. package/lib/settlement_lane_contract.js +0 -111
  325. package/lib/shared_signals_lane_contract.js +0 -54
  326. package/lib/signed_audit_provenance_contract.js +0 -83
  327. package/lib/soft_launch_pack.js +0 -78
  328. package/lib/stablecoin_lane_contract.js +0 -76
  329. package/lib/stripe_mpp_lane_contract.js +0 -96
  330. package/lib/stripe_mpp_payment_front.js +0 -258
  331. package/lib/telemetry_lane_contract.js +0 -54
  332. package/lib/treasury_destinations_contract.js +0 -764
  333. package/lib/treasury_egress_policy_contract.js +0 -91
  334. package/lib/treasury_lane_contract.js +0 -84
  335. package/lib/trust_portability_boundary_contract.js +0 -72
  336. package/lib/x402_facilitator.js +0 -198
  337. package/lib/x402_lane_contract.js +0 -136
  338. package/lib/x402_settlement_recovery.js +0 -175
  339. package/scripts/buyer_events_daily_report.js +0 -79
  340. package/scripts/registry_cli.js +0 -275
  341. package/scripts/state_backup_offsite.js +0 -196
  342. package/scripts/verify_a2a_rpc.js +0 -131
  343. package/scripts/verify_adapters.js +0 -554
  344. package/scripts/verify_agent_identity.js +0 -153
  345. package/scripts/verify_all.js +0 -4963
  346. package/scripts/verify_bolt_adapter.js +0 -128
  347. package/scripts/verify_buyer_event_log.js +0 -128
  348. package/scripts/verify_buyer_safety.js +0 -141
  349. package/scripts/verify_cdp_facilitator.js +0 -110
  350. package/scripts/verify_checkout_processor.js +0 -109
  351. package/scripts/verify_commerce_bridge.js +0 -177
  352. package/scripts/verify_control_plane_contracts.js +0 -34
  353. package/scripts/verify_control_plane_routes.js +0 -70
  354. package/scripts/verify_delivery_summary.js +0 -112
  355. package/scripts/verify_examples.js +0 -19
  356. package/scripts/verify_execution_dedupe.js +0 -189
  357. package/scripts/verify_execution_surfacing.js +0 -76
  358. package/scripts/verify_external_execution_retry.js +0 -140
  359. package/scripts/verify_final_activation.js +0 -191
  360. package/scripts/verify_first_run_conversions.js +0 -81
  361. package/scripts/verify_framework_provider_promotion.js +0 -152
  362. package/scripts/verify_full_catalog.js +0 -174
  363. package/scripts/verify_integrations.js +0 -620
  364. package/scripts/verify_l402_adapter.js +0 -86
  365. package/scripts/verify_lifecycle_continuity.js +0 -96
  366. package/scripts/verify_lifecycle_spend_binding.js +0 -88
  367. package/scripts/verify_market_lane_depth.js +0 -94
  368. package/scripts/verify_market_lane_promotion.js +0 -103
  369. package/scripts/verify_market_lane_traces.js +0 -98
  370. package/scripts/verify_market_lanes.js +0 -102
  371. package/scripts/verify_mpp_adapter.js +0 -128
  372. package/scripts/verify_operator_observability_boundary.js +0 -83
  373. package/scripts/verify_pricing_experiment_plan.js +0 -124
  374. package/scripts/verify_production_readiness.js +0 -268
  375. package/scripts/verify_provider_network.js +0 -819
  376. package/scripts/verify_provider_runtime_breadth.js +0 -109
  377. package/scripts/verify_provider_runtime_journeys.js +0 -111
  378. package/scripts/verify_rate_limiter.js +0 -52
  379. package/scripts/verify_refund_credit.js +0 -106
  380. package/scripts/verify_revenue_launch_paths.js +0 -105
  381. package/scripts/verify_runtime_durability.js +0 -52
  382. package/scripts/verify_runtime_state_guard.js +0 -117
  383. package/scripts/verify_service.js +0 -15421
  384. package/scripts/verify_settlement.js +0 -116
  385. package/scripts/verify_tooling.js +0 -1412
  386. package/scripts/verify_treasury_public_boundary.js +0 -97
  387. package/scripts/verify_verify_execute_settle.js +0 -209
  388. package/scripts/verify_x402_facilitator.js +0 -307
  389. package/scripts/verify_x402_settlement_recovery.js +0 -153
  390. package/server.js +0 -12245
@@ -1,105 +0,0 @@
1
- "use strict";
2
-
3
- const packageJson = require("../package.json");
4
- const { buildAdoptionPack } = require("./release_pack");
5
- const { buildAdapterPartnerPack } = require("./adapter_partner_pack");
6
-
7
- function classifyPartnerReadinessState(adoptionPack, adapterPartnerPack) {
8
- const targetCount = adoptionPack.initial_adoption_targets.length;
9
- const firstSuccessPathCount = adoptionPack.first_success_paths.length;
10
- const partnerValueCount = adapterPartnerPack.partner_value.length;
11
- const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
12
-
13
- if (targetCount >= 4 && firstSuccessPathCount >= 3 && partnerValueCount >= 4 && maturityStepCount >= 5) {
14
- return "strong";
15
- }
16
- if (targetCount >= 2 && firstSuccessPathCount >= 2 && partnerValueCount >= 2) {
17
- return "working";
18
- }
19
- return "early";
20
- }
21
-
22
- function classifyOnboardingFrictionState(adapterPartnerPack) {
23
- const docCount = adapterPartnerPack.start_path.first_docs.length;
24
- const commandCount = adapterPartnerPack.start_path.first_commands.length;
25
- const exampleCount = adapterPartnerPack.start_path.first_examples.length;
26
-
27
- if (docCount >= 2 && commandCount >= 4 && exampleCount >= 2) return "low";
28
- if (docCount >= 1 && commandCount >= 2) return "manageable";
29
- return "high";
30
- }
31
-
32
- function classifyPromotionReadinessState(adapterPartnerPack) {
33
- const publicSurfaceCount = Object.keys(adapterPartnerPack.public_surfaces).length;
34
- const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
35
- if (publicSurfaceCount >= 5 && maturityStepCount >= 5) return "strong";
36
- if (publicSurfaceCount >= 3 && maturityStepCount >= 3) return "working";
37
- return "early";
38
- }
39
-
40
- function buildPartnerIntelligencePack() {
41
- const adoptionPack = buildAdoptionPack();
42
- const adapterPartnerPack = buildAdapterPartnerPack();
43
- const partnerReadinessState = classifyPartnerReadinessState(adoptionPack, adapterPartnerPack);
44
- const onboardingFrictionState = classifyOnboardingFrictionState(adapterPartnerPack);
45
- const promotionReadinessState = classifyPromotionReadinessState(adapterPartnerPack);
46
-
47
- let nextBestAction = "promote_partner_start_path";
48
- if (onboardingFrictionState !== "low") {
49
- nextBestAction = "tighten_partner_onboarding";
50
- } else if (promotionReadinessState !== "strong") {
51
- nextBestAction = "strengthen_promotion_trust_path";
52
- }
53
-
54
- return {
55
- ok: true,
56
- product: packageJson.name,
57
- category: "machine-commerce-partner-intelligence-pack",
58
- partner_readiness_state: partnerReadinessState,
59
- onboarding_friction_state: onboardingFrictionState,
60
- promotion_readiness_state: promotionReadinessState,
61
- first_partner_segment: adapterPartnerPack.adoption_message.first_partner_type,
62
- recommended_partner_motion: "lead_with_adapter_authors_and_agent_builders",
63
- next_best_action: nextBestAction,
64
- explanation_signals: {
65
- adoption_target_count: adoptionPack.initial_adoption_targets.length,
66
- target_ecosystem_count: adoptionPack.target_ecosystems.length,
67
- first_success_path_count: adoptionPack.first_success_paths.length,
68
- partner_value_count: adapterPartnerPack.partner_value.length,
69
- onboarding_doc_count: adapterPartnerPack.start_path.first_docs.length,
70
- onboarding_command_count: adapterPartnerPack.start_path.first_commands.length,
71
- onboarding_example_count: adapterPartnerPack.start_path.first_examples.length,
72
- maturity_step_count: adapterPartnerPack.trust_path.maturity_path.length,
73
- public_surface_count: Object.keys(adapterPartnerPack.public_surfaces).length
74
- },
75
- linked_surfaces: {
76
- adoption_summary_ref: "/v1/release-pack/adoption/summary",
77
- adapter_partner_summary_ref: "/v1/adapter-partners/summary",
78
- release_center_summary_ref: "/v1/release-center/summary"
79
- },
80
- generated_from: {
81
- adoption_pack_category: adoptionPack.category,
82
- adapter_partner_pack_category: adapterPartnerPack.category
83
- }
84
- };
85
- }
86
-
87
- function summarizePartnerIntelligencePack() {
88
- const pack = buildPartnerIntelligencePack();
89
- return {
90
- ok: true,
91
- product: pack.product,
92
- category: pack.category,
93
- partner_readiness_state: pack.partner_readiness_state,
94
- onboarding_friction_state: pack.onboarding_friction_state,
95
- promotion_readiness_state: pack.promotion_readiness_state,
96
- first_partner_segment: pack.first_partner_segment,
97
- next_best_action: pack.next_best_action,
98
- signal_count: Object.keys(pack.explanation_signals).length
99
- };
100
- }
101
-
102
- module.exports = {
103
- buildPartnerIntelligencePack,
104
- summarizePartnerIntelligencePack
105
- };
@@ -1,257 +0,0 @@
1
- "use strict";
2
-
3
- const fs = require("fs");
4
- const {
5
- buildBsvTeranodeTreasuryDestination,
6
- normalizeSettlementMode
7
- } = require("./settlement_bsv_teranode");
8
-
9
- function safeParseJson(text, fallback) {
10
- try {
11
- return JSON.parse(text);
12
- } catch (_) {
13
- return fallback;
14
- }
15
- }
16
-
17
- function readJsonFromEnvOrPath(jsonValue, pathValue, fallback) {
18
- if (typeof jsonValue === "string" && jsonValue.trim()) {
19
- return safeParseJson(jsonValue, fallback);
20
- }
21
- if (typeof pathValue === "string" && pathValue.trim()) {
22
- try {
23
- return safeParseJson(fs.readFileSync(pathValue, "utf8"), fallback);
24
- } catch (_) {
25
- return fallback;
26
- }
27
- }
28
- return fallback;
29
- }
30
-
31
- function loadWalletRegistry() {
32
- const raw = readJsonFromEnvOrPath(
33
- process.env.XYTARA_WALLET_REGISTRY_JSON,
34
- process.env.XYTARA_WALLET_REGISTRY_PATH,
35
- []
36
- );
37
- const entries = Array.isArray(raw)
38
- ? raw
39
- : Array.isArray(raw && raw.wallets) ? raw.wallets : [];
40
- const byWalletId = new Map();
41
- for (const entry of entries) {
42
- if (!entry || typeof entry !== "object") continue;
43
- const walletId = typeof entry.wallet_id === "string" ? entry.wallet_id.trim() : "";
44
- const secret = typeof entry.secret === "string" ? entry.secret : "";
45
- if (!walletId || !secret) continue;
46
- byWalletId.set(walletId, {
47
- wallet_id: walletId,
48
- secret,
49
- account_id: typeof entry.account_id === "string" && entry.account_id.trim() ? entry.account_id.trim() : null,
50
- enabled: entry.enabled !== false
51
- });
52
- }
53
- return byWalletId;
54
- }
55
-
56
- function loadTreasuryDestinationMap() {
57
- const raw = readJsonFromEnvOrPath(
58
- process.env.XYTARA_TREASURY_DESTINATIONS_JSON,
59
- process.env.XYTARA_TREASURY_DESTINATIONS_PATH,
60
- {}
61
- );
62
- const input = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
63
- const normalized = {};
64
- for (const [settlementMode, entry] of Object.entries(input)) {
65
- if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
66
- normalized[normalizeSettlementMode(settlementMode)] = {
67
- destination_id: typeof entry.destination_id === "string" && entry.destination_id.trim()
68
- ? entry.destination_id.trim()
69
- : null,
70
- destination_kind: typeof entry.destination_kind === "string" && entry.destination_kind.trim()
71
- ? entry.destination_kind.trim()
72
- : null,
73
- account_id: typeof entry.account_id === "string" && entry.account_id.trim()
74
- ? entry.account_id.trim()
75
- : null,
76
- external_ref: typeof entry.external_ref === "string" && entry.external_ref.trim()
77
- ? entry.external_ref.trim()
78
- : null,
79
- custody_ref: typeof entry.custody_ref === "string" && entry.custody_ref.trim()
80
- ? entry.custody_ref.trim()
81
- : null,
82
- reporting_ref: typeof entry.reporting_ref === "string" && entry.reporting_ref.trim()
83
- ? entry.reporting_ref.trim()
84
- : null,
85
- wallet_ref: typeof entry.wallet_ref === "string" && entry.wallet_ref.trim()
86
- ? entry.wallet_ref.trim()
87
- : null,
88
- provider_ref: typeof entry.provider_ref === "string" && entry.provider_ref.trim()
89
- ? entry.provider_ref.trim()
90
- : null,
91
- network: typeof entry.network === "string" && entry.network.trim()
92
- ? entry.network.trim()
93
- : null,
94
- chain_id: typeof entry.chain_id === "string" && entry.chain_id.trim()
95
- ? entry.chain_id.trim()
96
- : null,
97
- asset_symbol: typeof entry.asset_symbol === "string" && entry.asset_symbol.trim()
98
- ? entry.asset_symbol.trim()
99
- : null,
100
- policy_scope: typeof entry.policy_scope === "string" && entry.policy_scope.trim()
101
- ? entry.policy_scope.trim()
102
- : null,
103
- storage_class: typeof entry.storage_class === "string" && entry.storage_class.trim()
104
- ? entry.storage_class.trim()
105
- : null,
106
- enabled: entry.enabled !== false,
107
- accept_inbound: entry.accept_inbound !== false
108
- };
109
- }
110
- return normalized;
111
- }
112
-
113
- function loadPaymentConfig() {
114
- // Default is fail-closed: signed payment acceptance. "presence" (accept any non-empty payment header)
115
- // must now be opted into explicitly and is only appropriate for local development.
116
- const verificationModeInput = String(process.env.XYTARA_PAYMENT_VERIFICATION_MODE || "local_signed").trim() || "local_signed";
117
- const verificationMode = verificationModeInput === "signed" ? "local_signed" : verificationModeInput;
118
- const maxAgeSeconds = Number(process.env.XYTARA_PAYMENT_MAX_AGE_SECONDS || 300);
119
- return {
120
- verification_mode: verificationMode,
121
- verification_mode_input: verificationModeInput,
122
- payment_max_age_seconds: Number.isFinite(maxAgeSeconds) && maxAgeSeconds > 0 ? maxAgeSeconds : 300,
123
- wallet_registry: loadWalletRegistry(),
124
- x402: loadX402FacilitatorConfig(),
125
- treasury_destination_id: String(process.env.XYTARA_TREASURY_DESTINATION_ID || "").trim() || null,
126
- treasury_destination_kind: String(process.env.XYTARA_TREASURY_DESTINATION_KIND || "").trim() || null,
127
- treasury_account_id: String(process.env.XYTARA_TREASURY_ACCOUNT_ID || "").trim() || null,
128
- treasury_external_ref: String(process.env.XYTARA_TREASURY_EXTERNAL_REF || "").trim() || null,
129
- treasury_destinations_by_settlement_mode: loadTreasuryDestinationMap()
130
- };
131
- }
132
-
133
- // Configuration for the x402_facilitator verification mode: the on-chain, trustless
134
- // pay-per-call path. The advertised accepts tell a buyer how to pay; the facilitator
135
- // verifies and settles the signed payment before any work runs.
136
- function loadX402FacilitatorConfig() {
137
- // A buyer signs validBefore = now + maxTimeoutSeconds. It must outlive verify + execution (up to
138
- // the 50 s budget, plus a provider cold start) + settle, or a slow-but-successful call can't
139
- // settle. Configured values below the floor are raised to it.
140
- const minTimeoutSeconds = Math.max(60, Number(process.env.XYTARA_X402_MIN_TIMEOUT_SECONDS || 300) || 300);
141
- let accepts = [];
142
- const rawAccepts = String(process.env.XYTARA_X402_ACCEPTS_JSON || "").trim();
143
- if (rawAccepts) {
144
- try {
145
- const parsed = JSON.parse(rawAccepts);
146
- if (Array.isArray(parsed)) {
147
- accepts = parsed
148
- .map((entry) => ({
149
- scheme: String((entry && entry.scheme) || "exact").trim(),
150
- network: String((entry && entry.network) || "").trim(),
151
- asset: String((entry && entry.asset) || "").trim(),
152
- amount: String((entry && entry.amount) || "").trim(),
153
- payTo: String((entry && entry.payTo) || "").trim(),
154
- ...(entry && entry.extra && typeof entry.extra === "object" ? { extra: entry.extra } : {}),
155
- maxTimeoutSeconds: Math.max(minTimeoutSeconds, Number(entry && entry.maxTimeoutSeconds) || 0)
156
- }))
157
- .filter((entry) => entry.network && entry.asset && entry.amount && entry.payTo);
158
- }
159
- } catch (_) {
160
- accepts = [];
161
- }
162
- }
163
- let headers = {};
164
- const rawHeaders = String(process.env.XYTARA_X402_FACILITATOR_HEADERS_JSON || "").trim();
165
- if (rawHeaders) {
166
- try {
167
- const parsed = JSON.parse(rawHeaders);
168
- if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) headers = parsed;
169
- } catch (_) {
170
- headers = {};
171
- }
172
- }
173
- return {
174
- accepts,
175
- facilitator_url: String(process.env.XYTARA_X402_FACILITATOR_URL || "https://x402.org/facilitator").trim().replace(/\/$/, ""),
176
- facilitator_headers: headers,
177
- facilitator_timeout_ms: Math.max(1000, Number(process.env.XYTARA_X402_FACILITATOR_TIMEOUT_MS || 15000) || 15000),
178
- settle: String(process.env.XYTARA_X402_SETTLE || "true").trim().toLowerCase() !== "false",
179
- // Credit units a single self-serve x402 top-up grants, unless the matched accepts
180
- // entry carries its own `extra.credits`.
181
- topup_units_default: Math.max(0, Number(process.env.XYTARA_X402_TOPUP_UNITS || 1000) || 0),
182
- // Optional Coinbase CDP auth for the CDP-hosted facilitator (Base mainnet). When both a
183
- // key id and secret are present, the facilitator client mints a fresh EdDSA Bearer JWT
184
- // per request. Accepts the CDP-standard env names or XYTARA_X402_CDP_* overrides.
185
- cdp: loadCdpFacilitatorAuth()
186
- };
187
- }
188
-
189
- function loadCdpFacilitatorAuth() {
190
- const keyId = String(process.env.XYTARA_X402_CDP_KEY_ID || process.env.CDP_API_KEY_ID || "").trim();
191
- const keySecret = String(process.env.XYTARA_X402_CDP_KEY_SECRET || process.env.CDP_API_KEY_SECRET || "").trim();
192
- if (!keyId || !keySecret) return null;
193
- return { key_id: keyId, key_secret: keySecret };
194
- }
195
-
196
- function buildConfiguredTreasuryDestination(accountId, settlementMode) {
197
- const config = loadPaymentConfig();
198
- const normalizedSettlementMode = normalizeSettlementMode(settlementMode);
199
- const mapEntry = normalizedSettlementMode && config.treasury_destinations_by_settlement_mode[normalizedSettlementMode]
200
- ? config.treasury_destinations_by_settlement_mode[normalizedSettlementMode]
201
- : null;
202
- const destinationId = mapEntry && typeof mapEntry.destination_id === "string" && mapEntry.destination_id.trim()
203
- ? mapEntry.destination_id.trim()
204
- : config.treasury_destination_id;
205
- if (!destinationId) {
206
- return buildBsvTeranodeTreasuryDestination(accountId, normalizedSettlementMode);
207
- }
208
- return {
209
- destination_id: destinationId,
210
- destination_kind:
211
- (mapEntry && typeof mapEntry.destination_kind === "string" && mapEntry.destination_kind.trim())
212
- || config.treasury_destination_kind
213
- || "merchant_treasury",
214
- account_id:
215
- (mapEntry && typeof mapEntry.account_id === "string" && mapEntry.account_id.trim())
216
- || config.treasury_account_id
217
- || accountId
218
- || null,
219
- settlement_mode: normalizedSettlementMode || null,
220
- external_ref:
221
- (mapEntry && typeof mapEntry.external_ref === "string" && mapEntry.external_ref.trim())
222
- || config.treasury_external_ref
223
- || null,
224
- custody_ref: mapEntry && typeof mapEntry.custody_ref === "string" && mapEntry.custody_ref.trim()
225
- ? mapEntry.custody_ref.trim()
226
- : null,
227
- reporting_ref: mapEntry && typeof mapEntry.reporting_ref === "string" && mapEntry.reporting_ref.trim()
228
- ? mapEntry.reporting_ref.trim()
229
- : null,
230
- wallet_ref: mapEntry && typeof mapEntry.wallet_ref === "string" && mapEntry.wallet_ref.trim()
231
- ? mapEntry.wallet_ref.trim()
232
- : null,
233
- provider_ref: mapEntry && typeof mapEntry.provider_ref === "string" && mapEntry.provider_ref.trim()
234
- ? mapEntry.provider_ref.trim()
235
- : null,
236
- network: mapEntry && typeof mapEntry.network === "string" && mapEntry.network.trim()
237
- ? mapEntry.network.trim()
238
- : null,
239
- chain_id: mapEntry && typeof mapEntry.chain_id === "string" && mapEntry.chain_id.trim()
240
- ? mapEntry.chain_id.trim()
241
- : null,
242
- asset_symbol: mapEntry && typeof mapEntry.asset_symbol === "string" && mapEntry.asset_symbol.trim()
243
- ? mapEntry.asset_symbol.trim()
244
- : null,
245
- policy_scope: mapEntry && typeof mapEntry.policy_scope === "string" && mapEntry.policy_scope.trim()
246
- ? mapEntry.policy_scope.trim()
247
- : null,
248
- storage_class: mapEntry && typeof mapEntry.storage_class === "string" && mapEntry.storage_class.trim()
249
- ? mapEntry.storage_class.trim()
250
- : null
251
- };
252
- }
253
-
254
- module.exports = {
255
- buildConfiguredTreasuryDestination,
256
- loadPaymentConfig
257
- };
@@ -1,53 +0,0 @@
1
- "use strict";
2
-
3
- const { summarizeX402LanePack } = require("./x402_lane_contract");
4
- const { summarizeStripeMppLanePack } = require("./stripe_mpp_lane_contract");
5
- const { summarizeL402LanePack } = require("./l402_lane_contract");
6
- const { summarizeBoltLanePack } = require("./bolt_lane_contract");
7
-
8
- function buildPaymentFrontRegistryPack() {
9
- return {
10
- product: "xytara",
11
- category: "machine-commerce-payment-front-registry-pack",
12
- pack_version: "xytara-payment-front-registry-pack-v1",
13
- posture: "multiple_payment_fronts_one_runtime_core",
14
- fronts: {
15
- x402: summarizeX402LanePack(),
16
- hosted_checkout: summarizeStripeMppLanePack(),
17
- l402: summarizeL402LanePack(),
18
- bolt_utxo_spv: summarizeBoltLanePack(),
19
- account_credits: {
20
- product: "xytara",
21
- category: "machine-commerce-account-credits-front",
22
- summary_version: "xytara-account-credits-front-summary-v1",
23
- posture: "repeat_use_spend_surface"
24
- }
25
- },
26
- operator_rule: "add payment fronts where they improve adoption or economics, but keep execution/governance/proof semantics centralized",
27
- linked_surfaces: {
28
- payment_protocols_ref: "/v1/payment-protocols",
29
- payment_protocol_strategy_ref: "/v1/payment-protocols/strategy",
30
- x402_ref: "/v1/x402",
31
- stripe_mpp_ref: "/v1/stripe-mpp",
32
- l402_ref: "/v1/l402",
33
- bolt_ref: "/v1/bolt"
34
- }
35
- };
36
- }
37
-
38
- function summarizePaymentFrontRegistryPack() {
39
- const pack = buildPaymentFrontRegistryPack();
40
- return {
41
- product: pack.product,
42
- category: pack.category,
43
- summary_version: "xytara-payment-front-registry-pack-summary-v1",
44
- posture: pack.posture,
45
- front_count: Object.keys(pack.fronts).length,
46
- linked_surfaces: pack.linked_surfaces
47
- };
48
- }
49
-
50
- module.exports = {
51
- buildPaymentFrontRegistryPack,
52
- summarizePaymentFrontRegistryPack
53
- };
@@ -1,165 +0,0 @@
1
- "use strict";
2
-
3
- function buildPaymentProtocolPack() {
4
- return {
5
- product: "xytara",
6
- category: "machine-commerce-payment-protocol-pack",
7
- pack_version: "xytara-payment-protocol-pack-v1",
8
- lane_state: "default_machine_payment_plus_credit_and_adapter_expansion",
9
- default_protocol: "x402",
10
- current_native_payment_paths: [
11
- {
12
- protocol_id: "x402",
13
- state: "first_party_default",
14
- why_it_exists: "default machine-native quote -> challenge -> pay -> execute handshake"
15
- },
16
- {
17
- protocol_id: "account_credits",
18
- state: "first_party_repeat_use",
19
- why_it_exists: "best repeat-use path for agents and operators that should not re-negotiate every call"
20
- },
21
- {
22
- protocol_id: "stripe_mpp",
23
- state: "first_party_human_checkout_lane",
24
- why_it_exists: "human checkout, top-up, and hosted payment entry without making human checkout the center of the stack"
25
- }
26
- ],
27
- adapter_ready_external_fronts: [
28
- {
29
- protocol_id: "l402",
30
- state: "adapter_ready_current",
31
- why_it_matters: "lightning-native service payment can matter for agents that want highly permissionless micropayment access"
32
- },
33
- {
34
- protocol_id: "utxo_spv_payment_fronts",
35
- state: "adapter_ready_current",
36
- why_it_matters: "native UTXO verification and SPV-style settlement proofs can matter where facilitator dependence is undesirable"
37
- },
38
- {
39
- protocol_id: "circle_nanopayments",
40
- state: "adapter_ready_next",
41
- why_it_matters: "high-frequency stable-value collection can complement machine-native pricing and credit replenishment"
42
- },
43
- {
44
- protocol_id: "circle_cctp",
45
- state: "adapter_ready_next",
46
- why_it_matters: "stable-value treasury mobility can expand settlement reach without redefining runtime execution"
47
- },
48
- {
49
- protocol_id: "future_payment_front_protocols",
50
- state: "adapter_front_only",
51
- 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"
52
- }
53
- ],
54
- charging_boundary: {
55
- keep_free: [
56
- "auth",
57
- "discovery",
58
- "docs",
59
- "catalog_inspection",
60
- "contract_views",
61
- "release_and_start_paths",
62
- "lightweight_preview_and_readiness_surfaces"
63
- ],
64
- keep_paid: [
65
- "execution",
66
- "quoted_runtime_work",
67
- "credit_consumption",
68
- "settlement_bearing_operations",
69
- "resource_consuming_runtime_consequence",
70
- "high_consequence_or_governed_machine_actions"
71
- ],
72
- principle: "do_not_charge_before_value_is_felt_but_do_not_give_runtime_consequence_away_for_free"
73
- },
74
- supported_surfaces: {
75
- x402_lane_ref: "/v1/x402",
76
- stripe_mpp_lane_ref: "/v1/stripe-mpp",
77
- l402_lane_ref: "/v1/l402",
78
- bolt_lane_ref: "/v1/bolt",
79
- payment_front_registry_ref: "/v1/payment-fronts",
80
- stablecoin_lane_ref: "/v1/stablecoins",
81
- pricing_optimization_ref: "/v1/pricing-optimization",
82
- treasury_destinations_ref: "/v1/treasury-destinations"
83
- }
84
- };
85
- }
86
-
87
- function buildPaymentProtocolStrategyPack() {
88
- const pack = buildPaymentProtocolPack();
89
- return {
90
- product: "xytara",
91
- category: "machine-commerce-payment-protocol-strategy-pack",
92
- pack_version: "xytara-payment-protocol-strategy-pack-v1",
93
- primary_protocol_thesis: {
94
- machine_native_default: "x402",
95
- repeat_use_default: "account_credits",
96
- human_procurement_default: "hosted_checkout",
97
- strategy_rule: "keep the commerce core protocol-agnostic while using the least-friction lane that fits the actor and operating constraint"
98
- },
99
- protocol_roles: [
100
- {
101
- protocol_id: "x402",
102
- role: "machine_native_http_payment",
103
- why_now: "strong fit for agent-call monetization, quote-to-pay flows, and interoperable HTTP-native machine commerce"
104
- },
105
- {
106
- protocol_id: "account_credits",
107
- role: "repeat_use_and_metered_runtime_spend",
108
- why_now: "best fit for repeated agent use where renegotiating payment every call adds friction"
109
- },
110
- {
111
- protocol_id: "hosted_checkout",
112
- role: "human_checkout_and_procurement_entry",
113
- why_now: "best fit for public SaaS sales, enterprise procurement, and external fiat money-in lanes"
114
- },
115
- {
116
- protocol_id: "l402_or_other_permissionless_fronts",
117
- role: "permissionless_adapter_payment_front",
118
- why_now: "worth supporting through adapter fronts now when customers strongly value lower dependency or Lightning-native / UTXO-native settlement"
119
- }
120
- ],
121
- commercialization_rules: [
122
- "Use x402 as the primary self-serve machine paywall.",
123
- "Use credits as the primary repeat-use spend posture after first conversion.",
124
- "Use hosted checkout for humans and enterprise buyers, then convert that funding into internal authorization or credits.",
125
- "Treat future permissionless fronts as adapter lanes into the same execution, proof, and governance core rather than as a fork of the product."
126
- ],
127
- operator_decisions: {
128
- launch_primary_machine_lane: "x402",
129
- launch_primary_human_lane: "hosted_checkout",
130
- launch_repeat_use_lane: "account_credits",
131
- current_optional_permissionless_lanes: ["l402", "utxo_spv_payment_fronts"]
132
- },
133
- linked_surfaces: {
134
- payment_protocols_ref: "/v1/payment-protocols",
135
- x402_lane_ref: "/v1/x402",
136
- hosted_checkout_lane_ref: "/v1/stripe-mpp",
137
- l402_lane_ref: "/v1/l402",
138
- bolt_lane_ref: "/v1/bolt",
139
- payment_front_registry_ref: "/v1/payment-fronts",
140
- commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
141
- execution_truth_ref: "/v1/capability-registry/execution-truth"
142
- }
143
- };
144
- }
145
-
146
- function summarizePaymentProtocolPack() {
147
- const pack = buildPaymentProtocolPack();
148
- return {
149
- product: "xytara",
150
- category: "machine-commerce-payment-protocol-pack-summary",
151
- summary_version: "xytara-payment-protocol-pack-summary-v1",
152
- default_protocol: pack.default_protocol,
153
- current_path_count: pack.current_native_payment_paths.length,
154
- adapter_ready_external_front_count: pack.adapter_ready_external_fronts.length,
155
- free_boundary_count: pack.charging_boundary.keep_free.length,
156
- paid_boundary_count: pack.charging_boundary.keep_paid.length,
157
- linked_surfaces: pack.supported_surfaces
158
- };
159
- }
160
-
161
- module.exports = {
162
- buildPaymentProtocolPack,
163
- buildPaymentProtocolStrategyPack,
164
- summarizePaymentProtocolPack
165
- };