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,322 +0,0 @@
1
- "use strict";
2
-
3
- function toArrayFromMap(mapValue) {
4
- if (!(mapValue instanceof Map)) return [];
5
- return Array.from(mapValue.values());
6
- }
7
-
8
- function normalizeTimestamp(value) {
9
- if (typeof value !== "string" || !value.trim()) return null;
10
- const parsed = Date.parse(value);
11
- return Number.isFinite(parsed) ? new Date(parsed).toISOString() : null;
12
- }
13
-
14
- function firstTimestamp(record, fieldNames) {
15
- for (const fieldName of fieldNames) {
16
- const timestamp = normalizeTimestamp(record && record[fieldName]);
17
- if (timestamp) return timestamp;
18
- }
19
- return null;
20
- }
21
-
22
- function sortByTimestampDescending(items) {
23
- return [...items].sort((left, right) => {
24
- const leftTime = left && left.at_iso ? Date.parse(left.at_iso) : 0;
25
- const rightTime = right && right.at_iso ? Date.parse(right.at_iso) : 0;
26
- return rightTime - leftTime;
27
- });
28
- }
29
-
30
- function buildQuoteActivities(state, accountId) {
31
- return toArrayFromMap(state.quotes)
32
- .filter((quote) => !accountId || quote.account_id === accountId)
33
- .map((quote) => ({
34
- activity_id: `quote.${quote.quote_id}`,
35
- activity_kind: "quote",
36
- activity_family: "commercial_admission",
37
- at_iso: firstTimestamp(quote, ["executed_at_iso", "payment_recorded_at_iso", "created_at_iso"]),
38
- account_id: quote.account_id || null,
39
- actor_ref: quote.account_id || null,
40
- action: quote.status === "executed" ? "quoted_and_executed" : "quoted",
41
- status: quote.status || null,
42
- amount_minor: quote.amount_minor || null,
43
- currency: quote.currency || null,
44
- settlement_mode: quote.settlement_mode || null,
45
- payment_protocol: quote.payment_protocol || null,
46
- route_ref: "/v1/payment-quotes",
47
- linked_refs: {
48
- quote_ref: quote.quote_id ? `/v1/quotes/${encodeURIComponent(quote.quote_id)}` : null
49
- }
50
- }));
51
- }
52
-
53
- function buildTransactionActivities(state, accountId) {
54
- return toArrayFromMap(state.transactions)
55
- .map((entry) => entry && entry.transaction ? entry.transaction : null)
56
- .filter(Boolean)
57
- .filter((transaction) => !accountId || transaction.account_id === accountId)
58
- .map((transaction) => ({
59
- activity_id: `transaction.${transaction.transaction_id}`,
60
- activity_kind: "transaction",
61
- activity_family: "runtime_execution",
62
- at_iso: firstTimestamp(transaction, ["completed_at_iso", "created_at_iso"]),
63
- account_id: transaction.account_id || null,
64
- actor_ref: transaction.account_id || null,
65
- action: "executed_runtime_work",
66
- status: transaction.status || null,
67
- amount_minor: transaction.payment && transaction.payment.amount_minor ? transaction.payment.amount_minor : null,
68
- currency: transaction.payment && transaction.payment.currency ? transaction.payment.currency : null,
69
- settlement_mode: transaction.settlement && transaction.settlement.mode ? transaction.settlement.mode : null,
70
- payment_protocol: transaction.payment && transaction.payment.protocol ? transaction.payment.protocol : null,
71
- delivery_target_kind: transaction.callback_url ? "callback" : "direct",
72
- route_ref: "/v1/commands/execute",
73
- linked_refs: {
74
- transaction_ref: transaction.transaction_id ? `/v1/transactions/${encodeURIComponent(transaction.transaction_id)}` : null,
75
- proof_ref: transaction.proof_ref || null
76
- }
77
- }));
78
- }
79
-
80
- function buildReceiptActivities(state, accountId) {
81
- return toArrayFromMap(state.receipts)
82
- .map((entry) => entry && entry.receipt ? entry.receipt : null)
83
- .filter(Boolean)
84
- .filter((receipt) => !accountId || receipt.account_id === accountId)
85
- .map((receipt) => ({
86
- activity_id: `receipt.${receipt.receipt_id}`,
87
- activity_kind: "receipt",
88
- activity_family: "delivery_proof",
89
- at_iso: firstTimestamp(receipt, ["created_at_iso", "completed_at_iso"]),
90
- account_id: receipt.account_id || null,
91
- actor_ref: receipt.account_id || null,
92
- action: "receipt_issued",
93
- status: receipt.status || null,
94
- proof_ref: receipt.proof_ref || null,
95
- route_ref: receipt.receipt_id ? `/v1/receipts/${encodeURIComponent(receipt.receipt_id)}` : "/v1/receipts",
96
- linked_refs: {
97
- receipt_ref: receipt.receipt_id ? `/v1/receipts/${encodeURIComponent(receipt.receipt_id)}` : null
98
- }
99
- }));
100
- }
101
-
102
- function buildPaymentActivities(state, accountId) {
103
- const ledger = Array.isArray(state.paymentLedger) ? state.paymentLedger : [];
104
- return ledger
105
- .filter((payment) => !accountId || payment.account_id === accountId)
106
- .map((payment) => ({
107
- activity_id: `payment.${payment.payment_id}`,
108
- activity_kind: "payment",
109
- activity_family: "funds_in",
110
- at_iso: firstTimestamp(payment, ["recorded_at_iso"]),
111
- account_id: payment.account_id || null,
112
- actor_ref: payment.account_id || null,
113
- action: "payment_recorded",
114
- status: payment.payment && payment.payment.status ? payment.payment.status : null,
115
- amount_minor: payment.amount_minor || null,
116
- currency: payment.currency || null,
117
- settlement_mode: payment.settlement && payment.settlement.mode ? payment.settlement.mode : null,
118
- settlement_adapter: payment.settlement_adapter || null,
119
- settlement_integration_id: payment.settlement_integration_id || null,
120
- payment_protocol: payment.payment && payment.payment.protocol ? payment.payment.protocol : null,
121
- treasury_destination_id: payment.treasury && payment.treasury.destination_id ? payment.treasury.destination_id : null,
122
- treasury_external_ref: payment.treasury && payment.treasury.custody_external_ref ? payment.treasury.custody_external_ref : null,
123
- route_ref: payment.payment_id ? `/v1/payment-ledger/${encodeURIComponent(payment.payment_id)}` : "/v1/payment-ledger",
124
- linked_refs: {
125
- payment_ref: payment.payment_id ? `/v1/payment-ledger/${encodeURIComponent(payment.payment_id)}` : null,
126
- operator_pack_ref: payment.payment_id ? `/v1/payment-ledger/${encodeURIComponent(payment.payment_id)}/operator-pack` : null
127
- }
128
- }));
129
- }
130
-
131
- function buildDeliveryActivities(state, accountId) {
132
- return toArrayFromMap(state.deliveries)
133
- .filter((delivery) => !accountId || delivery.account_id === accountId)
134
- .map((delivery) => ({
135
- activity_id: `delivery.${delivery.delivery_id}`,
136
- activity_kind: "delivery",
137
- activity_family: "delivery_proof",
138
- at_iso: firstTimestamp(delivery, ["delivered_at_iso", "last_attempt_at_iso", "created_at_iso"]),
139
- account_id: delivery.account_id || null,
140
- actor_ref: delivery.account_id || null,
141
- action: delivery.status === "delivered" ? "delivered_result" : "delivery_pending",
142
- status: delivery.status || null,
143
- output_ref: delivery.output_ref || null,
144
- proof_ref: delivery.proof_ref || null,
145
- payment_id: delivery.payment_id || null,
146
- delivery_target_kind: delivery.delivery_target_kind || null,
147
- route_ref: delivery.transaction_id ? `/v1/transactions/${encodeURIComponent(delivery.transaction_id)}` : null,
148
- linked_refs: {
149
- transaction_ref: delivery.transaction_id ? `/v1/transactions/${encodeURIComponent(delivery.transaction_id)}` : null,
150
- receipt_ref: delivery.receipt_id ? `/v1/receipts/${encodeURIComponent(delivery.receipt_id)}` : null
151
- }
152
- }));
153
- }
154
-
155
- function buildHistoryActivities(records, accountId, config) {
156
- return records.flatMap((record) => {
157
- const history = Array.isArray(record && record.history) ? record.history : [];
158
- return history
159
- .filter((entry) => {
160
- const recordAccountId = record && record.account_id ? record.account_id : null;
161
- const transactionId = record && record.transaction_id ? record.transaction_id : null;
162
- if (!accountId) return true;
163
- return recordAccountId === accountId || transactionId === accountId || record && record.requested_by === accountId;
164
- })
165
- .map((entry, index) => ({
166
- activity_id: `${config.prefix}.${record[config.idField]}.${index}`,
167
- activity_kind: config.kind,
168
- activity_family: config.family,
169
- at_iso: firstTimestamp(entry, ["at_iso"]) || firstTimestamp(record, ["updated_at_iso", "created_at_iso"]),
170
- account_id: record && record.account_id ? record.account_id : null,
171
- actor_ref: entry && entry.actor ? `${entry.actor.type || "actor"}:${entry.actor.role || "unknown"}` : null,
172
- action: entry && entry.event ? entry.event : config.defaultAction,
173
- status: entry && entry.next_status ? entry.next_status : record.status || null,
174
- reason_code: entry && entry.reason_code ? entry.reason_code : record.reason_code || null,
175
- note: entry && entry.note ? entry.note : null,
176
- route_ref: config.routeTemplate(record[config.idField]),
177
- linked_refs: {
178
- transaction_ref: record && record.transaction_id ? `/v1/transactions/${encodeURIComponent(record.transaction_id)}` : null,
179
- receipt_ref: record && record.receipt_id ? `/v1/receipts/${encodeURIComponent(record.receipt_id)}` : null
180
- }
181
- }));
182
- });
183
- }
184
-
185
- function buildCreditGrantActivities(state, accountId) {
186
- return toArrayFromMap(state.externalCreditGrants)
187
- .filter((grant) => !accountId || grant.account_id === accountId)
188
- .map((grant) => ({
189
- activity_id: `credit_grant.${grant.grant_id || grant.credit_grant_id || grant.account_id || "unknown"}`,
190
- activity_kind: "credit_grant",
191
- activity_family: "funding",
192
- at_iso: firstTimestamp(grant, ["created_at_iso", "granted_at_iso", "recorded_at_iso"]),
193
- account_id: grant.account_id || null,
194
- actor_ref: grant.account_id || null,
195
- action: "credit_granted",
196
- status: grant.status || null,
197
- amount_minor: grant.amount_minor || grant.credit_amount_minor || null,
198
- currency: grant.currency || null,
199
- route_ref: "/v1/credit-bridge/grants",
200
- linked_refs: {}
201
- }));
202
- }
203
-
204
- function buildBridgeActivities(state, accountId) {
205
- return toArrayFromMap(state.runtimeBridgeDispatches)
206
- .filter((dispatch) => !accountId || dispatch.account_id === accountId)
207
- .map((dispatch) => ({
208
- activity_id: `bridge.${dispatch.dispatch_id || dispatch.bridge_dispatch_id || "unknown"}`,
209
- activity_kind: "bridge_dispatch",
210
- activity_family: "runtime_proof_handoff",
211
- at_iso: firstTimestamp(dispatch, ["created_at_iso", "dispatched_at_iso", "recorded_at_iso"]),
212
- account_id: dispatch.account_id || null,
213
- actor_ref: dispatch.account_id || null,
214
- action: "bridge_dispatched",
215
- status: dispatch.status || null,
216
- route_ref: "/v1/proof-bridge",
217
- linked_refs: {
218
- proof_ref: dispatch.proof_ref || null,
219
- receipt_ref: dispatch.receipt_id ? `/v1/receipts/${encodeURIComponent(dispatch.receipt_id)}` : null
220
- }
221
- }));
222
- }
223
-
224
- function buildParticipantActivities(records, kind, routeRef) {
225
- return records.map((participant) => ({
226
- activity_id: `${kind}.${participant.participant_id || participant.operator_id || participant.network_participant_id || "unknown"}`,
227
- activity_kind: kind,
228
- activity_family: "third_party_participation",
229
- at_iso: firstTimestamp(participant, ["created_at_iso", "updated_at_iso", "admitted_at_iso"]),
230
- account_id: participant.account_id || null,
231
- actor_ref: participant.account_id || null,
232
- action: `registered_${kind}`,
233
- status: participant.status || null,
234
- route_ref: routeRef,
235
- linked_refs: {}
236
- }));
237
- }
238
-
239
- function buildActivityLedger(state, options) {
240
- const accountId = options && options.account_id ? options.account_id : null;
241
- const activities = sortByTimestampDescending([
242
- ...buildQuoteActivities(state, accountId),
243
- ...buildTransactionActivities(state, accountId),
244
- ...buildReceiptActivities(state, accountId),
245
- ...buildPaymentActivities(state, accountId),
246
- ...buildDeliveryActivities(state, accountId),
247
- ...buildHistoryActivities(toArrayFromMap(state.refunds), accountId, {
248
- prefix: "refund",
249
- idField: "refund_id",
250
- kind: "refund",
251
- family: "remediation",
252
- defaultAction: "refund_review",
253
- routeTemplate: (id) => `/v1/refunds/${encodeURIComponent(id)}`
254
- }),
255
- ...buildHistoryActivities(toArrayFromMap(state.disputes), accountId, {
256
- prefix: "dispute",
257
- idField: "dispute_id",
258
- kind: "dispute",
259
- family: "remediation",
260
- defaultAction: "dispute_review",
261
- routeTemplate: (id) => `/v1/disputes/${encodeURIComponent(id)}`
262
- }),
263
- ...buildHistoryActivities(toArrayFromMap(state.remediationTickets), accountId, {
264
- prefix: "remediation_ticket",
265
- idField: "ticket_id",
266
- kind: "remediation_ticket",
267
- family: "remediation",
268
- defaultAction: "remediation_review",
269
- routeTemplate: (id) => `/v1/remediation-tickets/${encodeURIComponent(id)}`
270
- }),
271
- ...buildCreditGrantActivities(state, accountId),
272
- ...buildBridgeActivities(state, accountId),
273
- ...buildParticipantActivities(toArrayFromMap(state.operatorParticipants), "operator_participant", "/v1/multi-operator"),
274
- ...buildParticipantActivities(toArrayFromMap(state.networkParticipants), "network_participant", "/v1/network-participation")
275
- ]).slice(0, 300);
276
-
277
- return {
278
- product: "xytara",
279
- category: "machine-commerce-activity-ledger",
280
- pack_version: "xytara-activity-ledger-v1",
281
- posture: "operator_facing_runtime_and_funds_activity_visibility",
282
- audit_posture: "operator_visibility_first",
283
- account_scope: accountId || "all_accounts",
284
- counts: {
285
- activity_count: activities.length,
286
- payment_count: activities.filter((entry) => entry.activity_kind === "payment").length,
287
- transaction_count: activities.filter((entry) => entry.activity_kind === "transaction").length,
288
- delivery_count: activities.filter((entry) => entry.activity_kind === "delivery").length,
289
- remediation_count: activities.filter((entry) => entry.activity_family === "remediation").length,
290
- participation_count: activities.filter((entry) => entry.activity_family === "third_party_participation").length
291
- },
292
- activities,
293
- linked_surfaces: {
294
- payment_ledger_ref: "/v1/payment-ledger",
295
- reconciliation_report_ref: "/v1/reconciliation-report",
296
- integration_registry_ref: "/v1/integrations",
297
- treasury_summary_ref_template: "/v1/economics/accounts/:account_id/treasury-summary",
298
- rail_summary_ref_template: "/v1/economics/accounts/:account_id/rail-summary",
299
- proof_bridge_ref: "/v1/proof-bridge",
300
- activity_summary_ref: "/v1/activity-ledger/summary"
301
- },
302
- operator_note: "use this ledger to inspect who did what, what was paid, what was delivered, and how funds and consequence moved through the runtime"
303
- };
304
- }
305
-
306
- function summarizeActivityLedger(state, options) {
307
- const pack = buildActivityLedger(state, options);
308
- return {
309
- product: "xytara",
310
- category: "machine-commerce-activity-ledger-summary",
311
- summary_version: "xytara-activity-ledger-summary-v1",
312
- activity_count: pack.counts.activity_count,
313
- account_scope: pack.account_scope,
314
- counts: pack.counts,
315
- linked_surfaces: pack.linked_surfaces
316
- };
317
- }
318
-
319
- module.exports = {
320
- buildActivityLedger,
321
- summarizeActivityLedger
322
- };
@@ -1,130 +0,0 @@
1
- "use strict";
2
-
3
- const packageJson = require("../package.json");
4
-
5
- function buildAdapterCertificationContractPack() {
6
- return {
7
- ok: true,
8
- product: packageJson.name,
9
- category: "naxytra-adapter-certification-contract",
10
- pack_version: "naxytra-adapter-certification-contract-v1",
11
- doctrine: "xytara_certifies_adapters_by_front_specific_normalized_contracts_without_leaking_vendor_truth_into_core_logic",
12
- model_state: "core_now",
13
- core_claim: "adapter certification is the machine-readable gate for manifest, capability, health, idempotency, failure, proof, and front-specific compatibility claims",
14
- certification_states: [
15
- { state: "pass", description: "the adapter satisfies the declared front contract without material constraints" },
16
- { state: "pass_with_constraints", description: "the adapter is usable but only within declared constraints" },
17
- { state: "needs_retest", description: "the adapter needs a fresh run against updated vectors or interface versions" },
18
- { state: "blocked", description: "the adapter cannot be certified until a required dependency or vector exists" },
19
- { state: "fail", description: "the adapter does not satisfy the declared front contract" }
20
- ],
21
- certification_fronts: [
22
- {
23
- front_id: "protocol_front",
24
- required_tests: ["protocol negotiation", "surface discovery", "normalized request translation"],
25
- required_evidence: ["manifest", "protocol compatibility result", "failure mapping result"],
26
- claim_boundary: "only_claim_listed_protocol_front_compatibility"
27
- },
28
- {
29
- front_id: "execution_front",
30
- required_tests: ["task dispatch", "idempotency", "execution result normalization"],
31
- required_evidence: ["manifest", "task vector results", "proof-compatible output facts"],
32
- claim_boundary: "only_claim_listed_execution_front_compatibility"
33
- },
34
- {
35
- front_id: "payment_front",
36
- required_tests: ["quote to pay compatibility", "payment admission", "reversal or refund posture"],
37
- required_evidence: ["payment state result", "receipt compatibility result", "failure mapping result"],
38
- claim_boundary: "only_claim_listed_payment_front_compatibility"
39
- },
40
- {
41
- front_id: "settlement_front",
42
- required_tests: ["settlement target translation", "finality reference capture", "batch or direct settlement posture"],
43
- required_evidence: ["settlement reference", "finality state", "reconciliation evidence"],
44
- claim_boundary: "only_claim_listed_settlement_front_compatibility"
45
- },
46
- {
47
- front_id: "identity_trust_front",
48
- required_tests: ["identity schema compatibility", "registry linkage", "attestation or trust-state roundtrip"],
49
- required_evidence: ["identity record", "registry proof", "trust-state result"],
50
- claim_boundary: "only_claim_listed_identity_trust_front_compatibility"
51
- },
52
- {
53
- front_id: "proof_front",
54
- required_tests: ["receipt compatibility", "proof import or export compatibility", "verification hook compatibility"],
55
- required_evidence: ["proof contract result", "receipt result", "verification evidence"],
56
- claim_boundary: "only_claim_listed_proof_front_compatibility"
57
- },
58
- {
59
- front_id: "treasury_front",
60
- required_tests: ["destination routing", "balance model compatibility", "payout landing compatibility"],
61
- required_evidence: ["treasury route result", "account abstraction result", "operator review note"],
62
- claim_boundary: "only_claim_listed_treasury_front_compatibility"
63
- },
64
- {
65
- front_id: "operator_front",
66
- required_tests: ["review surface visibility", "promotion posture", "reporting export compatibility"],
67
- required_evidence: ["review summary", "promotion readiness result", "operator export"],
68
- claim_boundary: "only_claim_listed_operator_front_compatibility"
69
- }
70
- ],
71
- harness_requirements: {
72
- test_categories: [
73
- "manifest_validity",
74
- "interface_conformance",
75
- "capability_declaration",
76
- "health_reporting",
77
- "failure_mapping",
78
- "idempotency_behavior",
79
- "proof_compatibility",
80
- "front_specific_lifecycle_compatibility"
81
- ],
82
- required_result_fields: [
83
- "certification_state",
84
- "interface_version",
85
- "tested_fronts",
86
- "tested_capabilities",
87
- "failed_cases",
88
- "warnings",
89
- "evidence_refs"
90
- ]
91
- },
92
- linked_surfaces: {
93
- integrations_summary_ref: "/v1/integrations/summary",
94
- promotion_readiness_ref: "/v1/integrations/promotion-readiness",
95
- promotion_actions_ref: "/v1/integrations/promotion-actions",
96
- submission_bundle_review_ref: "/v1/integrations/review/submission-bundle",
97
- submission_bundle_set_review_ref: "/v1/integrations/review/submission-bundle-set",
98
- registry_snapshot_review_ref: "/v1/integrations/review/registry-snapshot"
99
- },
100
- claim_boundary: "claim_adapter_certification_as_front_specific_compatibility_and_review_gate_without_claiming_vendor_default_or_runtime_truth"
101
- };
102
- }
103
-
104
- function summarizeAdapterCertificationContractPack() {
105
- const pack = buildAdapterCertificationContractPack();
106
- return {
107
- ok: true,
108
- product: pack.product,
109
- category: pack.category,
110
- summary_version: "naxytra-adapter-certification-contract-summary-v1",
111
- pack_version: pack.pack_version,
112
- model_state: pack.model_state,
113
- certification_state_count: pack.certification_states.length,
114
- certification_front_count: pack.certification_fronts.length,
115
- required_test_category_count: pack.harness_requirements.test_categories.length,
116
- linked_surfaces: pack.linked_surfaces
117
- };
118
- }
119
-
120
- function getAdapterCertificationFrontDetail(frontId) {
121
- const normalized = String(frontId || "").trim().toLowerCase();
122
- return (buildAdapterCertificationContractPack().certification_fronts || []).find((entry) => entry.front_id === normalized) || null;
123
- }
124
-
125
- module.exports = {
126
- buildAdapterCertificationContractPack,
127
- summarizeAdapterCertificationContractPack,
128
- getAdapterCertificationFrontDetail
129
- };
130
-
@@ -1,218 +0,0 @@
1
- "use strict";
2
-
3
- const packageJson = require("../package.json");
4
- const { catalog } = require("../fixtures/catalog");
5
- const { loadExecutionTargetRegistry } = require("./external_execution_runtime");
6
- const { listProviders } = require("./provider_registry");
7
-
8
- function normalizeString(value, fallback = "") {
9
- const raw = typeof value === "string" ? value.trim() : "";
10
- return raw || fallback;
11
- }
12
-
13
- function listAdapterTasks() {
14
- return (Array.isArray(catalog.tasks) ? catalog.tasks : [])
15
- .filter((task) => normalizeString(task && task.public_category) === "adapter")
16
- .map((task) => ({
17
- task_ref: task.public_task_ref,
18
- internal_task_ref: task.task_ref,
19
- public_title: task.public_title,
20
- execution_mode: task.execution_mode,
21
- latency_class: task.latency_class
22
- }));
23
- }
24
-
25
- function listTargetsForTask(taskRef) {
26
- const normalizedTaskRef = normalizeString(taskRef);
27
- return loadExecutionTargetRegistry().filter((target) => {
28
- if (!target || target.enabled === false) return false;
29
- if (normalizeString(target.task_ref) === normalizedTaskRef) return true;
30
- if (normalizedTaskRef === "adapter.mcp.invoke" || normalizedTaskRef.startsWith("adapter.mcp.")) {
31
- return Boolean(normalizeString(target.tool_name) || normalizeString(target.integration_id));
32
- }
33
- return false;
34
- });
35
- }
36
-
37
- function summarizeTarget(target) {
38
- const provider = normalizeString(target && target.provider, "external_execution");
39
- const toolName = normalizeString(target && target.tool_name);
40
- return {
41
- target_id: target.target_id,
42
- provider,
43
- task_ref: target.task_ref || null,
44
- tool_name: toolName || null,
45
- integration_id: target.integration_id || null,
46
- enabled: target.enabled !== false,
47
- timeout_ms: target.timeout_ms,
48
- endpoint_configured: Boolean(normalizeString(target.endpoint_url)),
49
- auth_configured: Boolean(normalizeString(target.auth_token)),
50
- operational_coverage: {
51
- execute_endpoint: Boolean(normalizeString(target.endpoint_url)),
52
- bearer_auth: Boolean(normalizeString(target.auth_token)),
53
- bounded_timeout: Number(target.timeout_ms || 0) >= 500,
54
- proof_fact_compatible: provider === "xytara_mcp_executor" || toolName === "summarize" || toolName === "zones.lookup",
55
- deterministic_retry_surface: true,
56
- tool_level_binding: Boolean(toolName),
57
- operator_health_surface: provider === "xytara_mcp_executor" ? "/health" : null,
58
- operator_tool_catalog_surface: provider === "xytara_mcp_executor" ? "/tools" : null
59
- }
60
- };
61
- }
62
-
63
- // ACTIVE open-network providers that declared this task_ref. Env targets resolve before the
64
- // registry at call time, so a provider is shadowed (not routed) when an enabled env target pins
65
- // the WHOLE lane (task_ref with no tool/integration selector); it is then listed but not counted.
66
- function listRegistryProvidersForTask(state, taskRef, envTargets) {
67
- if (!state) return [];
68
- const normalizedTaskRef = normalizeString(taskRef);
69
- const wholeLanePinned = envTargets.some((target) =>
70
- target.enabled !== false
71
- && normalizeString(target.task_ref) === normalizedTaskRef
72
- && !normalizeString(target.tool_name)
73
- && !normalizeString(target.integration_id)
74
- );
75
- return listProviders(state, { status: "active" })
76
- .filter((provider) => Array.isArray(provider.task_refs) && provider.task_refs.includes(normalizedTaskRef))
77
- .map((provider) => {
78
- const health = (provider.health && provider.health.status) || "healthy";
79
- return {
80
- target_id: `registry:${provider.provider_id}`,
81
- provider: provider.provider_id,
82
- routing: "open_provider_registry",
83
- task_ref: normalizedTaskRef,
84
- tool_name: null,
85
- tool_names: Array.isArray(provider.tool_names) ? provider.tool_names.slice() : [],
86
- integration_id: null,
87
- enabled: !wholeLanePinned,
88
- shadowed_by_env_target: wholeLanePinned,
89
- health_status: health,
90
- timeout_ms: provider.timeout_ms,
91
- endpoint_configured: Boolean(normalizeString(provider.endpoint_url)),
92
- auth_configured: Boolean(normalizeString(provider.auth_token)),
93
- operational_coverage: {
94
- execute_endpoint: Boolean(normalizeString(provider.endpoint_url)),
95
- bearer_auth: Boolean(normalizeString(provider.auth_token)),
96
- bounded_timeout: Number(provider.timeout_ms || 0) >= 500,
97
- // The provider-network execution contract fixes the deliverable shape
98
- // (result.output / output_payload), and activation is operator-vetted against it.
99
- proof_fact_compatible: true,
100
- deterministic_retry_surface: true,
101
- tool_level_binding: Array.isArray(provider.tool_names) && provider.tool_names.length > 0,
102
- operator_health_surface: "runtime_tracked_provider_health",
103
- operator_tool_catalog_surface: null
104
- }
105
- };
106
- });
107
- }
108
-
109
- function summarizeAdapterTaskDepth(task, state) {
110
- const envTargets = listTargetsForTask(task.task_ref).map(summarizeTarget);
111
- const registryTargets = listRegistryProvidersForTask(state, task.task_ref, loadExecutionTargetRegistry());
112
- const targets = envTargets.concat(registryTargets);
113
- const enabledTargets = targets.filter((target) => target.enabled);
114
- const toolNames = Array.from(new Set(enabledTargets
115
- .flatMap((target) => [target.tool_name].concat(target.tool_names || []))
116
- .filter(Boolean))).sort();
117
- const allTargetsCovered = enabledTargets.length > 0 && enabledTargets.every((target) =>
118
- target.operational_coverage.execute_endpoint
119
- && target.operational_coverage.bounded_timeout
120
- && target.operational_coverage.proof_fact_compatible
121
- );
122
- const depthState = enabledTargets.length >= 2 && allTargetsCovered
123
- ? "provider_live_path_deepened"
124
- : enabledTargets.length > 0
125
- ? "initial_provider_live_path"
126
- : "provider_wiring_required";
127
-
128
- return {
129
- ...task,
130
- provider_depth_state: depthState,
131
- provider_live: enabledTargets.length > 0,
132
- configured_target_count: targets.length,
133
- enabled_target_count: enabledTargets.length,
134
- env_target_count: envTargets.length,
135
- registry_provider_count: registryTargets.filter((target) => target.enabled).length,
136
- configured_tool_count: toolNames.length,
137
- configured_tools: toolNames,
138
- execution_targets: targets,
139
- operator_claim_boundary: enabledTargets.length > 0
140
- ? "claim_only_the_listed_task_and_tool_bindings_as_provider_live"
141
- : "do_not_claim_provider_live_until_execution_targets_are_configured"
142
- };
143
- }
144
-
145
- // `state` (optional): the live runtime state. When given, ACTIVE open-network providers count as
146
- // provider-live paths alongside operator env targets (each labelled routing:open_provider_registry).
147
- // Without it the pack is env-target-only, exactly as before.
148
- function buildAdapterDepthPack(state) {
149
- const adapterTasks = listAdapterTasks().map((task) => summarizeAdapterTaskDepth(task, state));
150
- const providerLiveTasks = adapterTasks.filter((task) => task.provider_live);
151
- const deepenedTasks = adapterTasks.filter((task) => task.provider_depth_state === "provider_live_path_deepened");
152
- const configuredTargets = loadExecutionTargetRegistry().filter((target) => target && target.enabled !== false);
153
- const registryProviderIds = new Set(adapterTasks.flatMap((task) =>
154
- task.execution_targets.filter((target) => target.routing === "open_provider_registry" && target.enabled).map((target) => target.provider)
155
- ));
156
- return {
157
- ok: true,
158
- product: packageJson.name,
159
- category: "machine-commerce-adapter-depth-pack",
160
- pack_version: "xytara-adapter-depth-pack-v1",
161
- adapter_depth_state: deepenedTasks.length > 0
162
- ? "provider_live_path_deepened"
163
- : providerLiveTasks.length > 0
164
- ? "initial_provider_live_path"
165
- : "provider_wiring_required",
166
- counts: {
167
- adapter_task_count: adapterTasks.length,
168
- provider_live_task_count: providerLiveTasks.length,
169
- deepened_provider_live_task_count: deepenedTasks.length,
170
- configured_execution_target_count: configuredTargets.length,
171
- configured_provider_count: new Set(configuredTargets.map((target) => normalizeString(target.provider))).size,
172
- configured_tool_count: new Set(configuredTargets.map((target) => normalizeString(target.tool_name)).filter(Boolean)).size,
173
- registry_provider_count: registryProviderIds.size
174
- },
175
- depth_sources: state ? ["operator_env_targets", "open_provider_registry"] : ["operator_env_targets"],
176
- adapter_tasks: adapterTasks,
177
- production_depth_requirements: [
178
- "at_least_one_enabled_execution_target_for_provider_backed_task",
179
- "tool_or_integration_level_binding_for_claimed_provider_lane",
180
- "bounded_timeout_and_retry_observability",
181
- "proof_fact_compatible_result_shape",
182
- "operator_health_or_catalog_surface_for_target_service"
183
- ],
184
- public_claim_boundary: {
185
- live_provider_claim_allowed: providerLiveTasks.length > 0,
186
- deep_provider_claim_allowed: deepenedTasks.length > 0,
187
- live_task_refs: providerLiveTasks.map((task) => task.task_ref),
188
- deepened_task_refs: deepenedTasks.map((task) => task.task_ref),
189
- rule: "only_claim_provider_depth_for_task_refs_and_tool_bindings_listed_in_this_pack"
190
- },
191
- linked_surfaces: {
192
- execution_truth_ref: "/v1/capability-registry/execution-truth",
193
- adapter_depth_summary_ref: "/v1/adapter-depth/summary",
194
- integrations_ref: "/v1/integrations",
195
- runtime_bridge_ref: "/v1/runtime-bridge/dispatches"
196
- }
197
- };
198
- }
199
-
200
- function summarizeAdapterDepthPack(state) {
201
- const pack = buildAdapterDepthPack(state);
202
- return {
203
- ok: true,
204
- product: pack.product,
205
- category: "machine-commerce-adapter-depth-summary",
206
- summary_version: "xytara-adapter-depth-summary-v1",
207
- adapter_depth_state: pack.adapter_depth_state,
208
- counts: pack.counts,
209
- depth_sources: pack.depth_sources,
210
- public_claim_boundary: pack.public_claim_boundary,
211
- linked_surfaces: pack.linked_surfaces
212
- };
213
- }
214
-
215
- module.exports = {
216
- buildAdapterDepthPack,
217
- summarizeAdapterDepthPack
218
- };