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,378 +0,0 @@
1
- "use strict";
2
-
3
- function normalizeString(value) {
4
- return typeof value === "string" && value.trim() ? value.trim() : null;
5
- }
6
-
7
- function escapeHtml(value) {
8
- return String(value == null ? "" : value)
9
- .replace(/&/g, "&")
10
- .replace(/</g, "&lt;")
11
- .replace(/>/g, "&gt;")
12
- .replace(/"/g, "&quot;")
13
- .replace(/'/g, "&#39;");
14
- }
15
-
16
- function parseWalletRegistryAccountId() {
17
- try {
18
- const raw = process.env.XYTARA_WALLET_REGISTRY_JSON;
19
- if (!raw) return null;
20
- const parsed = JSON.parse(raw);
21
- if (!Array.isArray(parsed)) return null;
22
- for (const entry of parsed) {
23
- const accountId = normalizeString(entry && entry.account_id);
24
- if (accountId) return accountId;
25
- }
26
- } catch (_) {
27
- return null;
28
- }
29
- return null;
30
- }
31
-
32
- function resolveBusinessCockpitAccountId(inputAccountId) {
33
- return normalizeString(inputAccountId)
34
- || normalizeString(process.env.XYTARA_VERIFY_ACCOUNT_ID)
35
- || normalizeString(process.env.XYTARA_TREASURY_ACCOUNT_ID)
36
- || parseWalletRegistryAccountId()
37
- || "acct_demo";
38
- }
39
-
40
- function buildBusinessCockpitPack(input) {
41
- const body = input && typeof input === "object" && !Array.isArray(input) ? input : {};
42
- const accountId = resolveBusinessCockpitAccountId(body.account_id);
43
- const releaseSummary = body.release_summary || {};
44
- const treasurySummary = body.treasury_summary || {};
45
- const paymentTruthSummary = body.payment_truth_summary || {};
46
- const autonomousEntrySummary = body.autonomous_entry_summary || {};
47
- const deliverySummary = body.delivery_summary || {};
48
- const operatorShellCenter = body.operator_shell_center || {};
49
- const operatorShellSummary = body.operator_shell_summary || {};
50
- const operatorObservabilitySummary = body.operator_observability_summary || {};
51
- const operatorIntelligenceSummary = body.operator_intelligence_summary || {};
52
- const runtimeDurabilitySummary = body.runtime_durability_summary || {};
53
- const nativeSettlementReadinessSummary = body.native_settlement_readiness_summary || {};
54
- const externalMonitoring = body.external_monitoring || {};
55
-
56
- return {
57
- ok: true,
58
- product: "xytara",
59
- category: "machine-commerce-business-cockpit-pack",
60
- cockpit_version: "xytara-business-cockpit-v1",
61
- generated_at_iso: new Date().toISOString(),
62
- account_id: accountId,
63
- auth_mode: body.auth_mode || "bearer",
64
- posture: "private_operator_business_analytics",
65
- release: {
66
- version: releaseSummary.version || null,
67
- category: releaseSummary.category || null,
68
- install_command: releaseSummary.install_command || null,
69
- verify_command: releaseSummary.verify_command || null,
70
- release_cli: releaseSummary.release_cli || null,
71
- summary: releaseSummary
72
- },
73
- operations: {
74
- autonomous_entry_summary: autonomousEntrySummary,
75
- delivery_summary: deliverySummary,
76
- operator_shell_center: operatorShellCenter,
77
- operator_shell_summary: operatorShellSummary,
78
- operator_observability_summary: operatorObservabilitySummary,
79
- operator_intelligence_summary: operatorIntelligenceSummary
80
- },
81
- treasury: {
82
- treasury_summary: treasurySummary,
83
- payment_truth_summary: paymentTruthSummary,
84
- runtime_durability_summary: runtimeDurabilitySummary,
85
- native_settlement_readiness_summary: nativeSettlementReadinessSummary
86
- },
87
- external_monitoring: externalMonitoring,
88
- linked_surfaces: {
89
- self_ref: `/v1/business-cockpit?account_id=${encodeURIComponent(accountId)}`,
90
- summary_ref: `/v1/business-cockpit/summary?account_id=${encodeURIComponent(accountId)}`,
91
- html_ref: `/business-cockpit?account_id=${encodeURIComponent(accountId)}`,
92
- operator_shell_ref: `/v1/operator-shell/summary?account_id=${encodeURIComponent(accountId)}`,
93
- operator_observability_ref: `/v1/operator-observability/summary?account_id=${encodeURIComponent(accountId)}`,
94
- deliveries_ref: "/v1/deliveries/summary",
95
- treasury_ref: "/v1/treasury-destinations/summary",
96
- payment_truth_ref: "/v1/payment-rail-truth/summary",
97
- autonomous_entry_ref: "/v1/autonomous-entry/summary",
98
- runtime_durability_ref: "/v1/runtime/durability/summary",
99
- native_settlement_readiness_ref: "/v1/settlement/bsv-teranode/readiness"
100
- }
101
- };
102
- }
103
-
104
- function summarizeBusinessCockpitPack(packInput) {
105
- const pack = packInput && packInput.category === "machine-commerce-business-cockpit-pack"
106
- ? packInput
107
- : buildBusinessCockpitPack(packInput);
108
- const treasurySummary = pack.treasury.treasury_summary || {};
109
- const paymentTruthSummary = pack.treasury.payment_truth_summary || {};
110
- const deliverySummary = pack.operations.delivery_summary || {};
111
- const operatorObservabilitySummary = pack.operations.operator_observability_summary || {};
112
- const operatorIntelligenceSummary = pack.operations.operator_intelligence_summary || {};
113
- const runtimeDurabilitySummary = pack.treasury.runtime_durability_summary || {};
114
- const nativeSettlementReadinessSummary = pack.treasury.native_settlement_readiness_summary || {};
115
- const externalMonitoring = pack.external_monitoring || {};
116
- const externalHealth = Object.values(externalMonitoring).filter(Boolean);
117
- const degradedExternal = externalHealth.filter((entry) => entry.ok === false).length;
118
-
119
- return {
120
- ok: true,
121
- product: "xytara",
122
- category: "machine-commerce-business-cockpit-pack-summary",
123
- summary_version: "xytara-business-cockpit-pack-summary-v1",
124
- account_id: pack.account_id,
125
- release_version: pack.release.version || null,
126
- public_live_landing_rail_count: paymentTruthSummary.public_live_landing_rail_count || 0,
127
- claimable_treasury_profile_count: treasurySummary.public_claimable_profile_count || 0,
128
- configured_treasury_profile_count: treasurySummary.configured_profile_count || 0,
129
- delivery_count: deliverySummary.delivery_count || 0,
130
- payment_count: operatorObservabilitySummary.payment_count || 0,
131
- transaction_count: operatorObservabilitySummary.transaction_count || 0,
132
- settlement_count: operatorObservabilitySummary.settlement_count || 0,
133
- attention_item_count: operatorObservabilitySummary.attention_item_count || 0,
134
- operator_state: operatorObservabilitySummary.operator_state || null,
135
- intelligence_state: operatorIntelligenceSummary.operator_state || null,
136
- runtime_snapshot_enabled: runtimeDurabilitySummary.enabled === true,
137
- native_settlement_ready: nativeSettlementReadinessSummary.ready === true,
138
- degraded_external_source_count: degradedExternal,
139
- linked_surfaces: pack.linked_surfaces
140
- };
141
- }
142
-
143
- function renderKeyValueRows(entry) {
144
- return Object.entries(entry || {})
145
- .map(([key, value]) => {
146
- const rendered = Array.isArray(value)
147
- ? value.join(", ")
148
- : value && typeof value === "object"
149
- ? JSON.stringify(value)
150
- : String(value);
151
- return `<tr><th>${escapeHtml(key)}</th><td>${escapeHtml(rendered)}</td></tr>`;
152
- })
153
- .join("");
154
- }
155
-
156
- function renderSummaryCards(summary) {
157
- const cards = [
158
- ["Release", summary.release_version || "unknown"],
159
- ["Live Rails", summary.public_live_landing_rail_count || 0],
160
- ["Treasury Profiles", summary.claimable_treasury_profile_count || 0],
161
- ["Payments", summary.payment_count || 0],
162
- ["Transactions", summary.transaction_count || 0],
163
- ["Deliveries", summary.delivery_count || 0],
164
- ["Settlements", summary.settlement_count || 0],
165
- ["Attention", summary.attention_item_count || 0],
166
- ["BSV Ready", summary.native_settlement_ready ? "yes" : "no"],
167
- ["External Degraded", summary.degraded_external_source_count || 0]
168
- ];
169
- return cards.map(([label, value]) => `
170
- <section class="card">
171
- <div class="card-label">${escapeHtml(label)}</div>
172
- <div class="card-value">${escapeHtml(value)}</div>
173
- </section>
174
- `).join("");
175
- }
176
-
177
- function buildBusinessCockpitHtml(packInput) {
178
- const pack = packInput && packInput.category === "machine-commerce-business-cockpit-pack"
179
- ? packInput
180
- : buildBusinessCockpitPack(packInput);
181
- const summary = summarizeBusinessCockpitPack(pack);
182
- const externalRows = Object.entries(pack.external_monitoring || {}).map(([key, value]) => ({
183
- source: key,
184
- ok: value && value.ok === true ? "ok" : "degraded",
185
- ref: value && value.ref ? value.ref : null,
186
- status: value && value.status != null ? value.status : null,
187
- reason: value && value.reason ? value.reason : null
188
- }));
189
-
190
- return `<!doctype html>
191
- <html lang="en">
192
- <head>
193
- <meta charset="utf-8">
194
- <meta name="viewport" content="width=device-width, initial-scale=1">
195
- <title>xytara Business Cockpit</title>
196
- <style>
197
- :root {
198
- color-scheme: light;
199
- --bg: #f4f1ea;
200
- --panel: #fffaf2;
201
- --ink: #1c1b18;
202
- --muted: #6e6759;
203
- --line: #d9cfbf;
204
- --accent: #0f766e;
205
- --accent-2: #a16207;
206
- }
207
- * { box-sizing: border-box; }
208
- body {
209
- margin: 0;
210
- font-family: Georgia, "Times New Roman", serif;
211
- color: var(--ink);
212
- background: radial-gradient(circle at top left, #fffdf7 0%, var(--bg) 60%);
213
- }
214
- .wrap {
215
- max-width: 1180px;
216
- margin: 0 auto;
217
- padding: 28px 20px 48px;
218
- }
219
- .hero {
220
- background: linear-gradient(135deg, #fffef9, #f4ede0);
221
- border: 1px solid var(--line);
222
- border-radius: 22px;
223
- padding: 28px;
224
- box-shadow: 0 20px 50px rgba(28, 27, 24, 0.06);
225
- }
226
- h1, h2 { margin: 0 0 10px; }
227
- h1 { font-size: 2.3rem; }
228
- h2 { font-size: 1.25rem; margin-top: 24px; }
229
- p, li, td, th, code { line-height: 1.45; }
230
- .muted { color: var(--muted); }
231
- .grid {
232
- display: grid;
233
- grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
234
- gap: 14px;
235
- margin-top: 20px;
236
- }
237
- .card, .panel {
238
- background: var(--panel);
239
- border: 1px solid var(--line);
240
- border-radius: 18px;
241
- padding: 16px;
242
- }
243
- .card-label {
244
- font-size: 0.85rem;
245
- text-transform: uppercase;
246
- letter-spacing: 0.08em;
247
- color: var(--muted);
248
- }
249
- .card-value {
250
- margin-top: 8px;
251
- font-size: 1.8rem;
252
- font-weight: 700;
253
- }
254
- .section-grid {
255
- display: grid;
256
- grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
257
- gap: 18px;
258
- margin-top: 20px;
259
- }
260
- table {
261
- width: 100%;
262
- border-collapse: collapse;
263
- }
264
- th, td {
265
- text-align: left;
266
- padding: 9px 0;
267
- border-bottom: 1px solid var(--line);
268
- vertical-align: top;
269
- }
270
- th {
271
- width: 42%;
272
- color: var(--muted);
273
- font-weight: 600;
274
- }
275
- a { color: var(--accent); text-decoration: none; }
276
- a:hover { text-decoration: underline; }
277
- .token-note {
278
- margin-top: 14px;
279
- font-size: 0.95rem;
280
- color: var(--accent-2);
281
- }
282
- .inline-list {
283
- display: flex;
284
- flex-wrap: wrap;
285
- gap: 10px;
286
- padding: 0;
287
- margin: 12px 0 0;
288
- list-style: none;
289
- }
290
- .inline-list li {
291
- border: 1px solid var(--line);
292
- border-radius: 999px;
293
- padding: 8px 12px;
294
- background: #fff;
295
- }
296
- .external-table th { width: 24%; }
297
- </style>
298
- </head>
299
- <body>
300
- <main class="wrap">
301
- <section class="hero">
302
- <h1>xytara Business Cockpit</h1>
303
- <p class="muted">Private operator analytics across runtime operations, treasury landing, release posture, settlement readiness, and linked proof-facing health.</p>
304
- <p><strong>Account scope:</strong> <code>${escapeHtml(pack.account_id)}</code> <span class="muted">| auth: ${escapeHtml(pack.auth_mode)}</span></p>
305
- <div class="grid">${renderSummaryCards(summary)}</div>
306
- <p class="token-note">This page is private. Open it with <code>Authorization: Bearer &lt;token&gt;</code> or a tokenized cockpit URL you keep private.</p>
307
- </section>
308
- <section class="section-grid">
309
- <article class="panel">
310
- <h2>Release</h2>
311
- <table>${renderKeyValueRows({
312
- version: pack.release.version,
313
- category: pack.release.category,
314
- install_command: pack.release.install_command,
315
- verify_command: pack.release.verify_command,
316
- release_cli: pack.release.release_cli
317
- })}</table>
318
- </article>
319
- <article class="panel">
320
- <h2>Treasury</h2>
321
- <table>${renderKeyValueRows({
322
- configured_profile_count: pack.treasury.treasury_summary.configured_profile_count,
323
- public_claimable_profile_count: pack.treasury.treasury_summary.public_claimable_profile_count,
324
- readiness_only_profile_count: pack.treasury.treasury_summary.readiness_only_profile_count,
325
- public_live_landing_rail_count: pack.treasury.payment_truth_summary.public_live_landing_rail_count,
326
- native_settlement_ready: pack.treasury.native_settlement_readiness_summary.ready,
327
- runtime_snapshot_enabled: pack.treasury.runtime_durability_summary.enabled
328
- })}</table>
329
- </article>
330
- <article class="panel">
331
- <h2>Operations</h2>
332
- <table>${renderKeyValueRows({
333
- payment_count: pack.operations.operator_observability_summary.payment_count,
334
- transaction_count: pack.operations.operator_observability_summary.transaction_count,
335
- delivery_count: pack.operations.delivery_summary.delivery_count,
336
- settlement_count: pack.operations.operator_observability_summary.settlement_count,
337
- attention_item_count: pack.operations.operator_observability_summary.attention_item_count,
338
- operator_state: pack.operations.operator_observability_summary.operator_state
339
- })}</table>
340
- </article>
341
- <article class="panel">
342
- <h2>External Health</h2>
343
- <table class="external-table">
344
- <thead>
345
- <tr><th>Source</th><th>Status</th><th>HTTP</th><th>Ref</th></tr>
346
- </thead>
347
- <tbody>
348
- ${externalRows.map((entry) => `
349
- <tr>
350
- <th>${escapeHtml(entry.source)}</th>
351
- <td>${escapeHtml(entry.ok)}</td>
352
- <td>${escapeHtml(entry.status == null ? "-" : entry.status)}</td>
353
- <td>${entry.ref ? `<a href="${escapeHtml(entry.ref)}">${escapeHtml(entry.ref)}</a>` : escapeHtml(entry.reason || "-")}</td>
354
- </tr>
355
- `).join("")}
356
- </tbody>
357
- </table>
358
- </article>
359
- </section>
360
- <section class="panel" style="margin-top: 18px;">
361
- <h2>Quick Links</h2>
362
- <ul class="inline-list">
363
- ${Object.entries(pack.linked_surfaces).map(([key, value]) => `
364
- <li><strong>${escapeHtml(key)}</strong>: <a href="${escapeHtml(value)}">${escapeHtml(value)}</a></li>
365
- `).join("")}
366
- </ul>
367
- </section>
368
- </main>
369
- </body>
370
- </html>`;
371
- }
372
-
373
- module.exports = {
374
- resolveBusinessCockpitAccountId,
375
- buildBusinessCockpitPack,
376
- summarizeBusinessCockpitPack,
377
- buildBusinessCockpitHtml
378
- };
@@ -1,230 +0,0 @@
1
- "use strict";
2
-
3
- const crypto = require("crypto");
4
-
5
- // Buyer-journey event log: every failed buyer attempt (ours, upstream, or the buyer's) is recorded
6
- // so the operator can see who tried to use the system and why it did not work — plus counters for
7
- // the normal steps (402 challenges issued, paid calls served) as denominators.
8
- //
9
- // Privacy: events never carry payment signatures/headers, request bodies, tokens, IP addresses or
10
- // full wallet addresses. Payer addresses are reduced to a salted hash prefix; detail text is
11
- // truncated and stripped of long hex/base64 runs.
12
- //
13
- // Storage: state.buyerEventLog (bounded ring, newest last) and state.buyerEventDaily (per-day
14
- // counters, 30 days) are ordinary runtime state, so they persist with the Supabase snapshot and the
15
- // daily off-site backup. The MCP executor forwards its own events to POST /v1/operator/buyer-events/ingest.
16
-
17
- const DAILY_RETENTION_DAYS = 30;
18
-
19
- // Stages that are normal steps, not failures (the MCP executor sends these with no fault).
20
- const STEP_STAGES = new Set(["challenge_issued", "paid_ok", "success", "free_ok", "replay_served"]);
21
-
22
- function isStepEvent(event) {
23
- const fault = event && event.fault;
24
- return STEP_STAGES.has(String((event && event.stage) || "")) || fault === null || fault === undefined || fault === "" || fault === "none";
25
- }
26
-
27
- function maxEvents() {
28
- const value = Number(process.env.XYTARA_BUYER_EVENT_LOG_MAX || 500);
29
- return Number.isFinite(value) && value >= 10 ? Math.min(5000, Math.floor(value)) : 500;
30
- }
31
-
32
- function ensureBuyerEventCollections(state) {
33
- if (!Array.isArray(state.buyerEventLog)) state.buyerEventLog = [];
34
- if (!(state.buyerEventDaily instanceof Map)) state.buyerEventDaily = new Map();
35
- }
36
-
37
- function cleanText(value, max) {
38
- if (value === null || value === undefined) return null;
39
- const text = String(value)
40
- .replace(/0x[0-9a-fA-F]{40,}/g, "0x…")
41
- .replace(/[A-Za-z0-9+/=_-]{40,}/g, "…")
42
- .replace(/\s+/g, " ")
43
- .trim();
44
- return text ? text.slice(0, max) : null;
45
- }
46
-
47
- function payerHash(address) {
48
- const value = String(address || "").trim().toLowerCase();
49
- if (!value) return null;
50
- const salt = String(process.env.XYTARA_BUYER_EVENT_SALT || "naxytra-buyer-events");
51
- return crypto.createHash("sha256").update(`${salt}:${value}`).digest("hex").slice(0, 12);
52
- }
53
-
54
- // Path template without ids: segments that look like identifiers become ":id".
55
- function routeTemplate(pathname) {
56
- return String(pathname || "/")
57
- .split("/")
58
- .map((segment) => (/(^0x[0-9a-f]{6,})|([0-9a-f]{12,})|(_[0-9a-z]{6,}$)|(^\d{3,}$)/i.test(segment) ? ":id" : segment))
59
- .join("/")
60
- .slice(0, 120);
61
- }
62
-
63
- // reason -> [stage, fault]. fault: "ours" (our bug/infra), "upstream" (facilitator, RPC, provider),
64
- // "buyer" (bad input / bad payment), "none" (expected protocol step).
65
- const REASON_RULES = [
66
- [/^(capability_not_executable|task_ref_required|task_not_found|unknown_tool)/, "route", "buyer"],
67
- [/^(body_must_be_valid_json|invalid_json|request_body_too_large)/, "parse", "buyer"],
68
- [/^payment_(signature_invalid|requirements_mismatch|header)/, "payment_match", "buyer"],
69
- [/^payment_authorization_in_progress/, "payment_verify", "buyer"],
70
- [/^payment_verification_failed|^invalid_exact/, "payment_verify", "buyer"],
71
- [/^facilitator_|_unreachable$/, "payment_verify", "upstream"],
72
- [/^(payment_settlement_failed|settlement_failed|settle_)/, "payment_settle", "upstream"],
73
- [/^(external_execution|no_healthy_provider|provider_)/, "provider", "upstream"],
74
- [/^(insufficient_credits|credit_spend_|delegated_)/, "credit", "buyer"],
75
- [/^agent_signature|^spend_credential|_bearer|^unauthorized|^forbidden/, "auth", "buyer"],
76
- [/^rate_limit/, "rate_limit", "buyer"],
77
- [/^(state_restore_pending|runtime_state)/, "state", "ours"],
78
- [/^quote_(expired|already_used)/, "quote", "buyer"]
79
- ];
80
-
81
- function classify(reason, httpStatus) {
82
- const text = String(reason || "");
83
- for (const [pattern, stage, fault] of REASON_RULES) {
84
- if (pattern.test(text)) return { stage, fault };
85
- }
86
- if (httpStatus >= 500) return { stage: "internal", fault: "ours" };
87
- if (httpStatus === 404) return { stage: "route", fault: "buyer" };
88
- return { stage: "other", fault: httpStatus >= 400 && httpStatus < 500 ? "buyer" : "ours" };
89
- }
90
-
91
- function dayKey(iso) {
92
- return String(iso).slice(0, 10);
93
- }
94
-
95
- function bumpDaily(state, iso, service, key) {
96
- const day = dayKey(iso);
97
- let bucket = state.buyerEventDaily.get(day);
98
- if (!bucket) {
99
- bucket = {};
100
- state.buyerEventDaily.set(day, bucket);
101
- // Drop days beyond retention (keys are ISO dates, so lexical order is chronological).
102
- const days = Array.from(state.buyerEventDaily.keys()).sort();
103
- while (days.length > DAILY_RETENTION_DAYS) state.buyerEventDaily.delete(days.shift());
104
- }
105
- const counterKey = `${service}|${key}`;
106
- bucket[counterKey] = (Number(bucket[counterKey]) || 0) + 1;
107
- }
108
-
109
- // Count a normal step without logging an event (challenge issued, paid call served, ...).
110
- function countBuyerStep(state, step, options = {}) {
111
- try {
112
- ensureBuyerEventCollections(state);
113
- bumpDaily(state, new Date().toISOString(), options.service || "runtime", `step:${step}|${routeTemplate(options.route)}`);
114
- } catch (_) { /* observability must never break a buyer response */ }
115
- }
116
-
117
- function recordBuyerEvent(state, input) {
118
- try {
119
- ensureBuyerEventCollections(state);
120
- const at = typeof input.at_iso === "string" && !Number.isNaN(Date.parse(input.at_iso)) ? new Date(input.at_iso).toISOString() : new Date().toISOString();
121
- const httpStatus = Number.isFinite(Number(input.http_status)) ? Number(input.http_status) : null;
122
- const reason = cleanText(input.reason, 80) || (httpStatus ? `http_${httpStatus}` : "unknown");
123
- const classified = classify(reason, httpStatus || 0);
124
- const event = {
125
- id: `bev_${crypto.randomBytes(6).toString("hex")}`,
126
- at_iso: at,
127
- service: cleanText(input.service, 40) || "runtime",
128
- request_id: cleanText(input.request_id, 40),
129
- stage: cleanText(input.stage, 30) || classified.stage,
130
- reason,
131
- fault: cleanText(input.fault, 10) || classified.fault,
132
- http_status: httpStatus,
133
- route: input.route ? routeTemplate(input.route) : null,
134
- method: cleanText(input.method, 8),
135
- task_or_tool: cleanText(input.task_or_tool, 80),
136
- rail: cleanText(input.rail, 20),
137
- network: cleanText(input.network, 30),
138
- amount_atomic: /^\d{1,30}$/.test(String(input.amount_atomic || "")) ? String(input.amount_atomic) : null,
139
- payer_hash: input.payer_hash ? cleanText(input.payer_hash, 16) : payerHash(input.payer),
140
- money_moved: input.money_moved === true,
141
- latency_ms: Number.isFinite(Number(input.latency_ms)) ? Math.round(Number(input.latency_ms)) : null,
142
- detail: cleanText(input.detail, 160),
143
- ua: cleanText(String(input.ua || "").split(/[\s/]/)[0], 32)
144
- };
145
- state.buyerEventLog.push(event);
146
- const cap = maxEvents();
147
- if (state.buyerEventLog.length > cap) state.buyerEventLog.splice(0, state.buyerEventLog.length - cap);
148
- bumpDaily(state, at, event.service, `fail:${event.stage}:${event.reason}:${event.fault}`);
149
- if (event.money_moved) bumpDaily(state, at, event.service, "money_moved");
150
- return event;
151
- } catch (_) {
152
- return null;
153
- }
154
- }
155
-
156
- function listBuyerEvents(state, query = {}) {
157
- ensureBuyerEventCollections(state);
158
- // (Older entries could be steps mis-filed as failures; never surface them as failures.)
159
- const since = query.since && !Number.isNaN(Date.parse(query.since)) ? Date.parse(query.since) : null;
160
- const limit = Math.max(1, Math.min(500, Number(query.limit) || 100));
161
- const matches = state.buyerEventLog.filter((event) => {
162
- if (STEP_STAGES.has(String(event.stage || ""))) return false;
163
- if (since !== null && Date.parse(event.at_iso) < since) return false;
164
- if (query.service && event.service !== query.service) return false;
165
- if (query.stage && event.stage !== query.stage) return false;
166
- if (query.fault && event.fault !== query.fault) return false;
167
- if (query.money_moved === "true" && !event.money_moved) return false;
168
- return true;
169
- });
170
- return { count: matches.length, events: matches.slice(-limit).reverse() };
171
- }
172
-
173
- function summarizeBuyerEvents(state, days = 7) {
174
- ensureBuyerEventCollections(state);
175
- const window = Math.max(1, Math.min(DAILY_RETENTION_DAYS, Number(days) || 7));
176
- // Calendar window covering at least the last `window` x 24 h: from the UTC day `window` days
177
- // ago through today (so a report run early in the day still includes yesterday).
178
- const cutoffDay = new Date(Date.now() - window * 86400000).toISOString().slice(0, 10);
179
- const keys = Array.from(state.buyerEventDaily.keys()).sort().filter((day) => day >= cutoffDay);
180
- const totals = { failures: 0, ours: 0, upstream: 0, buyer: 0, money_moved: 0, challenges_issued: 0, paid_ok: 0 };
181
- const byReason = {};
182
- const perDay = keys.map((day) => {
183
- const bucket = state.buyerEventDaily.get(day) || {};
184
- const dayTotals = { day, failures: 0, ours: 0, upstream: 0, money_moved: 0, challenges_issued: 0, paid_ok: 0 };
185
- for (const [key, count] of Object.entries(bucket)) {
186
- const [service, rest] = [key.slice(0, key.indexOf("|")), key.slice(key.indexOf("|") + 1)];
187
- if (rest === "money_moved") { dayTotals.money_moved += count; totals.money_moved += count; continue; }
188
- if (rest.startsWith("step:challenge_issued")) { dayTotals.challenges_issued += count; totals.challenges_issued += count; continue; }
189
- if (rest.startsWith("step:paid_ok")) { dayTotals.paid_ok += count; totals.paid_ok += count; continue; }
190
- if (!rest.startsWith("fail:")) continue;
191
- const [, stage, reason, fault] = rest.split(":");
192
- if (STEP_STAGES.has(stage)) continue;
193
- dayTotals.failures += count;
194
- totals.failures += count;
195
- if (fault === "ours") { dayTotals.ours += count; totals.ours += count; }
196
- if (fault === "upstream") { dayTotals.upstream += count; totals.upstream += count; }
197
- if (fault === "buyer") totals.buyer += count;
198
- const reasonKey = `${service}:${stage}:${reason}:${fault}`;
199
- byReason[reasonKey] = (byReason[reasonKey] || 0) + count;
200
- }
201
- return dayTotals;
202
- });
203
- const topReasons = Object.entries(byReason)
204
- .sort((a, b) => b[1] - a[1])
205
- .slice(0, 25)
206
- .map(([key, count]) => {
207
- const [service, stage, reason, fault] = key.split(":");
208
- return { service, stage, reason, fault, count };
209
- });
210
- return {
211
- window_days: window,
212
- totals,
213
- // Needs attention: money moved without a delivered result, or failures that are our fault.
214
- attention: totals.money_moved > 0 || totals.ours > 0,
215
- per_day: perDay,
216
- top_reasons: topReasons,
217
- generated_at_iso: new Date().toISOString()
218
- };
219
- }
220
-
221
- module.exports = {
222
- countBuyerStep,
223
- isStepEvent,
224
- ensureBuyerEventCollections,
225
- listBuyerEvents,
226
- payerHash,
227
- recordBuyerEvent,
228
- routeTemplate,
229
- summarizeBuyerEvents
230
- };