xytara 3.1.0 → 3.1.2

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 (373) hide show
  1. package/.env.example +67 -58
  2. package/ADAPTER_START_HERE.md +56 -56
  3. package/CARRIED_HANDOFF_DEMO.md +60 -60
  4. package/EXAMPLE_PATHS.md +53 -53
  5. package/FINAL_CONTRACT.md +498 -498
  6. package/LICENSE +201 -201
  7. package/NOTICE +3 -3
  8. package/PARTNER_READY_PATH.md +71 -71
  9. package/PUBLIC_DEMO_SCRIPT.md +78 -78
  10. package/README.md +6 -1
  11. package/REAL_PAYMENT_SETUP.md +32 -3
  12. package/RELEASE_NOTES.md +14 -14
  13. package/SERVICE_CONTRACT.md +419 -419
  14. package/START_HERE.md +1 -1
  15. package/SUPABASE_RUNTIME_STATE_SETUP.md +61 -61
  16. package/TERMINOLOGY.md +50 -50
  17. package/WHY_XYTARA_XOONYA.md +63 -63
  18. package/XT1_EXECUTION_TRUTH_STANDARD.md +78 -78
  19. package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +75 -75
  20. package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +124 -124
  21. package/XYTARA_DEFAULT_PATH_MODEL.md +84 -84
  22. package/XYTARA_EXECUTION_TRUTH_MODEL.md +171 -171
  23. package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +68 -68
  24. package/adapters/AUTHORING_GUIDE.md +243 -243
  25. package/adapters/ONBOARDING_POSTURE.md +61 -61
  26. package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +84 -84
  27. package/adapters/adapter-manifest.schema.json +283 -283
  28. package/adapters/examples/example-execution-adapter.js +61 -61
  29. package/adapters/examples/example-execution-adapter.manifest.json +81 -81
  30. package/adapters/examples/example-settlement-adapter.js +55 -55
  31. package/adapters/examples/example-settlement-adapter.manifest.json +78 -78
  32. package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +124 -124
  33. package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +121 -121
  34. package/adapters/examples/example-third-party-identity-registration.certification-pack.json +22 -22
  35. package/adapters/examples/example-third-party-identity-registration.record.json +26 -26
  36. package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +126 -126
  37. package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +124 -124
  38. package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +120 -120
  39. package/adapters/examples/example-third-party-registration.certification-pack.json +22 -22
  40. package/adapters/examples/example-third-party-registration.record.json +28 -28
  41. package/adapters/examples/example-third-party-registration.submission-bundle.json +126 -126
  42. package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +22 -22
  43. package/adapters/examples/example-third-party-settlement-registration.record.json +26 -26
  44. package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +127 -127
  45. package/adapters/examples/langchain-reference-execution-adapter.js +81 -81
  46. package/adapters/examples/langchain-reference-execution-adapter.manifest.json +79 -79
  47. package/adapters/examples/langgraph-reference-execution-adapter.js +81 -81
  48. package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +79 -79
  49. package/adapters/examples/minimal-third-party-execution-adapter.js +61 -61
  50. package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +79 -79
  51. package/adapters/examples/minimal-third-party-execution-registration.record.json +26 -26
  52. package/adapters/examples/minimal-third-party-execution.certification-pack.json +22 -22
  53. package/adapters/examples/minimal-third-party-execution.submission-bundle.json +126 -126
  54. package/adapters/integration-certification-pack.schema.json +82 -82
  55. package/adapters/integration-registration-record.schema.json +114 -114
  56. package/adapters/integration-submission-bundle-set.schema.json +39 -39
  57. package/adapters/integration-submission-bundle.schema.json +34 -34
  58. package/adapters/interfaces.js +56 -56
  59. package/bin/xytara-first-run.js +244 -244
  60. package/bin/xytara-release.js +1429 -1429
  61. package/bin/xytara-run.js +186 -186
  62. package/bin/xytara.js +80 -80
  63. package/client.js +3 -3
  64. package/examples/_demo_env.js +40 -0
  65. package/examples/adapter_review_walkthrough.js +54 -53
  66. package/examples/export_carried_handoff.js +81 -80
  67. package/examples/funded_runtime_walkthrough.js +71 -70
  68. package/examples/generated.carried-handoff.json +30 -0
  69. package/examples/partner_launch_walkthrough.js +44 -43
  70. package/examples/quickstart.js +3256 -3255
  71. package/fixtures/catalog.js +1134 -1134
  72. package/index.js +395 -395
  73. package/integrations/dispatch.js +276 -276
  74. package/integrations/registry-snapshot.schema.json +36 -36
  75. package/integrations/registry.js +2261 -2261
  76. package/integrations/views.js +28 -28
  77. package/lib/a2a_lane_contract.js +104 -104
  78. package/lib/a2c_lane_contract.js +111 -111
  79. package/lib/account_auth.js +518 -518
  80. package/lib/acp_lane_contract.js +54 -54
  81. package/lib/activity_audit_contract.js +322 -322
  82. package/lib/adapter_certification_contract.js +130 -130
  83. package/lib/adapter_depth_contract.js +156 -156
  84. package/lib/adapter_pack.js +118 -118
  85. package/lib/adapter_partner_pack.js +89 -89
  86. package/lib/adapter_promotion_pack.js +89 -89
  87. package/lib/adapter_protocol_truth_contract.js +229 -229
  88. package/lib/announcement_pack.js +61 -61
  89. package/lib/artifact_distribution_lane_contract.js +54 -54
  90. package/lib/asyncapi_contract.js +150 -150
  91. package/lib/auth_interop_contract.js +80 -80
  92. package/lib/authority_binding_lifecycle_contract.js +182 -182
  93. package/lib/autonomous_entry_contract.js +409 -409
  94. package/lib/bolt_lane_contract.js +55 -55
  95. package/lib/bolt_payment_front.js +172 -172
  96. package/lib/business_cockpit.js +378 -378
  97. package/lib/capability_execution_truth.js +272 -272
  98. package/lib/capability_registry.js +633 -633
  99. package/lib/catalog_contract.js +966 -966
  100. package/lib/catalog_family_model.js +193 -193
  101. package/lib/catalog_views.js +55 -55
  102. package/lib/checkout_event_security.js +142 -142
  103. package/lib/cloudevents_contract.js +80 -80
  104. package/lib/command_flow.js +411 -406
  105. package/lib/commerce_artifacts.js +503 -503
  106. package/lib/commerce_authority.js +449 -449
  107. package/lib/commerce_cases.js +317 -317
  108. package/lib/commerce_checkout.js +509 -509
  109. package/lib/commerce_client.js +7687 -7676
  110. package/lib/commerce_coordination.js +346 -346
  111. package/lib/commerce_economics.js +4017 -4016
  112. package/lib/commerce_identity.js +578 -578
  113. package/lib/commerce_quotes.js +237 -237
  114. package/lib/commerce_reports.js +14461 -14461
  115. package/lib/commerce_runtime.js +315 -315
  116. package/lib/commerce_shell.js +257 -257
  117. package/lib/crypto_agility_matrix.js +125 -125
  118. package/lib/default_path_contract.js +412 -412
  119. package/lib/delivery_summary_contract.js +95 -95
  120. package/lib/ecosystem_entry.js +64 -64
  121. package/lib/erc8004_lane_contract.js +65 -65
  122. package/lib/event_system_lane_contract.js +75 -75
  123. package/lib/execution_truth_contract.js +234 -234
  124. package/lib/external_credit_bridge.js +142 -142
  125. package/lib/external_execution_runtime.js +132 -132
  126. package/lib/feature_control_lane_contract.js +54 -54
  127. package/lib/first_run_conversion_contract.js +290 -290
  128. package/lib/framework_lane_contract.js +89 -89
  129. package/lib/framework_provider_promotion.js +235 -235
  130. package/lib/full_catalog_contract.js +525 -525
  131. package/lib/go_live_operator_pack.js +391 -391
  132. package/lib/http_transport.js +73 -73
  133. package/lib/identity_auth.js +175 -175
  134. package/lib/identity_interop_contract.js +82 -82
  135. package/lib/integration_matrix_contract.js +102 -102
  136. package/lib/l402_lane_contract.js +55 -55
  137. package/lib/l402_payment_front.js +192 -192
  138. package/lib/launch_narrative.js +53 -53
  139. package/lib/lifecycle_continuity_contract.js +115 -115
  140. package/lib/machine_identity_registry_contract.js +199 -199
  141. package/lib/major_rails_lane_contract.js +150 -150
  142. package/lib/market_lane_contract.js +467 -467
  143. package/lib/market_lane_depth_contract.js +182 -182
  144. package/lib/market_lane_promotion_contract.js +210 -210
  145. package/lib/market_lane_trace_contract.js +278 -278
  146. package/lib/mcp_lane_contract.js +137 -137
  147. package/lib/network_transport.js +110 -110
  148. package/lib/offline_verifiability_recovery_contract.js +155 -155
  149. package/lib/openapi_contract.js +296 -296
  150. package/lib/operational_receipt_contract.js +165 -165
  151. package/lib/operator_intelligence.js +407 -407
  152. package/lib/outreach_copy_pack.js +51 -51
  153. package/lib/outreach_message_pack.js +71 -71
  154. package/lib/outreach_proof.js +71 -71
  155. package/lib/outreach_target_pack.js +60 -60
  156. package/lib/partner_intelligence.js +105 -105
  157. package/lib/payment_config.js +239 -191
  158. package/lib/payment_front_registry.js +53 -53
  159. package/lib/payment_protocol_contract.js +165 -165
  160. package/lib/payment_rail_truth_contract.js +324 -324
  161. package/lib/payment_verification.js +312 -264
  162. package/lib/phase_10_closeout_pack.js +45 -45
  163. package/lib/phase_10_completion_pack.js +76 -76
  164. package/lib/phase_10_decision_record_pack.js +54 -54
  165. package/lib/phase_10_decision_resolution_pack.js +53 -53
  166. package/lib/phase_10_demand_signal_adapters_runtime_pack.js +74 -74
  167. package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +74 -74
  168. package/lib/phase_10_freeze_baseline_pack.js +67 -67
  169. package/lib/phase_10_freeze_review_pack.js +64 -64
  170. package/lib/phase_10_gate_pack.js +57 -57
  171. package/lib/phase_10_long_tail_continuity_pack.js +80 -80
  172. package/lib/phase_10_long_tail_ecosystem_pack.js +66 -66
  173. package/lib/phase_10_niche_extension_registry_runtime_pack.js +74 -74
  174. package/lib/phase_1_claude_mcp_pack.js +60 -60
  175. package/lib/phase_1_claude_mcp_runtime_pack.js +52 -52
  176. package/lib/phase_1_ecosystem_pack.js +67 -67
  177. package/lib/phase_1_openai_codex_pack.js +60 -60
  178. package/lib/phase_1_openai_codex_runtime_pack.js +52 -52
  179. package/lib/phase_2_base_runtime_pack.js +71 -71
  180. package/lib/phase_2_base_usdc_runtime_pack.js +72 -72
  181. package/lib/phase_2_closeout_pack.js +65 -65
  182. package/lib/phase_2_completion_pack.js +113 -113
  183. package/lib/phase_2_decision_record_pack.js +66 -66
  184. package/lib/phase_2_decision_resolution_pack.js +69 -69
  185. package/lib/phase_2_eth_runtime_pack.js +70 -70
  186. package/lib/phase_2_evm_base_runtime_pack.js +73 -73
  187. package/lib/phase_2_evm_runtime_pack.js +71 -71
  188. package/lib/phase_2_flip_preview_pack.js +60 -60
  189. package/lib/phase_2_freeze_review_pack.js +99 -99
  190. package/lib/phase_2_gate_pack.js +77 -77
  191. package/lib/phase_2_payment_rails_pack.js +71 -71
  192. package/lib/phase_2_usdc_runtime_pack.js +71 -71
  193. package/lib/phase_3_brc_runtime_pack.js +81 -81
  194. package/lib/phase_3_bsv_teranode_runtime_pack.js +83 -83
  195. package/lib/phase_3_closeout_pack.js +62 -62
  196. package/lib/phase_3_completion_pack.js +94 -94
  197. package/lib/phase_3_decision_record_pack.js +64 -64
  198. package/lib/phase_3_decision_resolution_pack.js +69 -69
  199. package/lib/phase_3_freeze_baseline_pack.js +67 -67
  200. package/lib/phase_3_freeze_review_pack.js +80 -80
  201. package/lib/phase_3_gate_pack.js +76 -76
  202. package/lib/phase_3_metanet_runtime_pack.js +81 -81
  203. package/lib/phase_3_native_bsv_pack.js +91 -91
  204. package/lib/phase_3_native_continuity_pack.js +82 -82
  205. package/lib/phase_4_attestation_runtime_pack.js +75 -75
  206. package/lib/phase_4_closeout_pack.js +45 -45
  207. package/lib/phase_4_completion_pack.js +94 -94
  208. package/lib/phase_4_decision_record_pack.js +54 -54
  209. package/lib/phase_4_decision_resolution_pack.js +45 -45
  210. package/lib/phase_4_erc8004_runtime_pack.js +76 -76
  211. package/lib/phase_4_freeze_baseline_pack.js +67 -67
  212. package/lib/phase_4_freeze_review_pack.js +68 -68
  213. package/lib/phase_4_gate_pack.js +58 -58
  214. package/lib/phase_4_identity_registry_runtime_pack.js +75 -75
  215. package/lib/phase_4_identity_trust_pack.js +73 -73
  216. package/lib/phase_4_trust_continuity_pack.js +86 -86
  217. package/lib/phase_5_antelope_runtime_pack.js +76 -76
  218. package/lib/phase_5_closeout_pack.js +44 -44
  219. package/lib/phase_5_completion_pack.js +82 -82
  220. package/lib/phase_5_constellation_dag_runtime_pack.js +76 -76
  221. package/lib/phase_5_decision_record_pack.js +54 -54
  222. package/lib/phase_5_decision_resolution_pack.js +45 -45
  223. package/lib/phase_5_digibyte_dgb_runtime_pack.js +76 -76
  224. package/lib/phase_5_freeze_baseline_pack.js +67 -67
  225. package/lib/phase_5_freeze_review_pack.js +68 -68
  226. package/lib/phase_5_gate_pack.js +58 -58
  227. package/lib/phase_5_hedera_hbar_runtime_pack.js +76 -76
  228. package/lib/phase_5_kaspa_kas_runtime_pack.js +76 -76
  229. package/lib/phase_5_major_rails_continuity_pack.js +86 -86
  230. package/lib/phase_5_major_rails_pack.js +110 -110
  231. package/lib/phase_5_metal_runtime_pack.js +76 -76
  232. package/lib/phase_5_polkadot_dot_runtime_pack.js +76 -76
  233. package/lib/phase_5_proton_xpr_runtime_pack.js +76 -76
  234. package/lib/phase_5_solana_runtime_pack.js +76 -76
  235. package/lib/phase_6_autogen_runtime_pack.js +72 -72
  236. package/lib/phase_6_closeout_pack.js +46 -46
  237. package/lib/phase_6_completion_pack.js +77 -77
  238. package/lib/phase_6_decision_record_pack.js +54 -54
  239. package/lib/phase_6_decision_resolution_pack.js +53 -53
  240. package/lib/phase_6_framework_continuity_pack.js +81 -81
  241. package/lib/phase_6_framework_runtime_pack.js +68 -68
  242. package/lib/phase_6_freeze_baseline_pack.js +68 -68
  243. package/lib/phase_6_freeze_review_pack.js +65 -65
  244. package/lib/phase_6_gate_pack.js +59 -59
  245. package/lib/phase_6_langchain_runtime_pack.js +72 -72
  246. package/lib/phase_6_langgraph_runtime_pack.js +72 -72
  247. package/lib/phase_6_semantic_kernel_runtime_pack.js +72 -72
  248. package/lib/phase_7_closeout_pack.js +45 -45
  249. package/lib/phase_7_completion_pack.js +85 -85
  250. package/lib/phase_7_decision_record_pack.js +53 -53
  251. package/lib/phase_7_decision_resolution_pack.js +53 -53
  252. package/lib/phase_7_event_system_continuity_pack.js +89 -89
  253. package/lib/phase_7_event_system_pack.js +76 -76
  254. package/lib/phase_7_freeze_baseline_pack.js +74 -74
  255. package/lib/phase_7_freeze_review_pack.js +65 -65
  256. package/lib/phase_7_gate_pack.js +58 -58
  257. package/lib/phase_7_kafka_runtime_pack.js +74 -74
  258. package/lib/phase_7_mqtt_runtime_pack.js +74 -74
  259. package/lib/phase_7_nats_runtime_pack.js +74 -74
  260. package/lib/phase_7_webhook_event_bus_runtime_pack.js +74 -74
  261. package/lib/phase_8_closeout_pack.js +46 -46
  262. package/lib/phase_8_completion_pack.js +82 -82
  263. package/lib/phase_8_decision_record_pack.js +54 -54
  264. package/lib/phase_8_decision_resolution_pack.js +53 -53
  265. package/lib/phase_8_external_receipt_import_runtime_pack.js +74 -74
  266. package/lib/phase_8_external_result_import_runtime_pack.js +74 -74
  267. package/lib/phase_8_freeze_baseline_pack.js +71 -71
  268. package/lib/phase_8_freeze_review_pack.js +64 -64
  269. package/lib/phase_8_gate_pack.js +58 -58
  270. package/lib/phase_8_proof_bridge_continuity_pack.js +86 -86
  271. package/lib/phase_8_proof_bridges_pack.js +72 -72
  272. package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +74 -74
  273. package/lib/phase_9_closeout_pack.js +46 -46
  274. package/lib/phase_9_completion_pack.js +82 -82
  275. package/lib/phase_9_custody_refs_runtime_pack.js +74 -74
  276. package/lib/phase_9_decision_record_pack.js +54 -54
  277. package/lib/phase_9_decision_resolution_pack.js +53 -53
  278. package/lib/phase_9_freeze_baseline_pack.js +71 -71
  279. package/lib/phase_9_freeze_review_pack.js +64 -64
  280. package/lib/phase_9_gate_pack.js +58 -58
  281. package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +74 -74
  282. package/lib/phase_9_treasury_connectivity_pack.js +72 -72
  283. package/lib/phase_9_treasury_continuity_pack.js +86 -86
  284. package/lib/phase_9_treasury_destinations_runtime_pack.js +74 -74
  285. package/lib/phase_program_pack.js +120 -120
  286. package/lib/pricing_optimization_contract.js +775 -775
  287. package/lib/protocol_lane_contract.js +117 -117
  288. package/lib/provenance_lane_contract.js +54 -54
  289. package/lib/provider_lane_contract.js +240 -240
  290. package/lib/provider_runtime_journey_contract.js +183 -183
  291. package/lib/public_surface_policy_contract.js +111 -111
  292. package/lib/publish_plan.js +51 -51
  293. package/lib/record_queries.js +48 -48
  294. package/lib/release_candidate.js +50 -50
  295. package/lib/release_center.js +1093 -1093
  296. package/lib/release_history.js +205 -205
  297. package/lib/release_manifest.js +113 -113
  298. package/lib/release_pack.js +453 -453
  299. package/lib/request_rate_limit.js +144 -144
  300. package/lib/resource_views.js +31 -31
  301. package/lib/revenue_launch_path_contract.js +326 -326
  302. package/lib/route_matchers.js +34 -34
  303. package/lib/route_params.js +19 -19
  304. package/lib/runtime_bridge.js +124 -124
  305. package/lib/runtime_operations_worker.js +282 -282
  306. package/lib/runtime_state_store.js +354 -354
  307. package/lib/settlement_lane_contract.js +111 -111
  308. package/lib/shared_signals_lane_contract.js +54 -54
  309. package/lib/signed_audit_provenance_contract.js +83 -83
  310. package/lib/soft_launch_pack.js +78 -78
  311. package/lib/stablecoin_lane_contract.js +76 -76
  312. package/lib/stripe_mpp_lane_contract.js +96 -96
  313. package/lib/stripe_mpp_payment_front.js +158 -158
  314. package/lib/telemetry_lane_contract.js +54 -54
  315. package/lib/treasury_destinations_contract.js +764 -764
  316. package/lib/treasury_egress_policy_contract.js +91 -91
  317. package/lib/treasury_lane_contract.js +84 -84
  318. package/lib/trust_portability_boundary_contract.js +72 -72
  319. package/lib/x402_facilitator.js +155 -0
  320. package/lib/x402_lane_contract.js +118 -118
  321. package/package.json +106 -105
  322. package/scripts/registry_cli.js +275 -275
  323. package/scripts/verify_adapters.js +554 -554
  324. package/scripts/verify_all.js +4962 -4962
  325. package/scripts/verify_control_plane_contracts.js +34 -34
  326. package/scripts/verify_control_plane_routes.js +70 -70
  327. package/scripts/verify_delivery_summary.js +112 -112
  328. package/scripts/verify_examples.js +19 -19
  329. package/scripts/verify_first_run_conversions.js +81 -81
  330. package/scripts/verify_framework_provider_promotion.js +152 -152
  331. package/scripts/verify_full_catalog.js +174 -174
  332. package/scripts/verify_integrations.js +620 -620
  333. package/scripts/verify_lifecycle_continuity.js +96 -96
  334. package/scripts/verify_market_lane_depth.js +94 -94
  335. package/scripts/verify_market_lane_promotion.js +103 -103
  336. package/scripts/verify_market_lane_traces.js +98 -98
  337. package/scripts/verify_market_lanes.js +102 -102
  338. package/scripts/verify_operator_observability_boundary.js +83 -83
  339. package/scripts/verify_pricing_experiment_plan.js +124 -124
  340. package/scripts/verify_provider_runtime_breadth.js +109 -109
  341. package/scripts/verify_provider_runtime_journeys.js +111 -111
  342. package/scripts/verify_revenue_launch_paths.js +105 -105
  343. package/scripts/verify_runtime_durability.js +52 -52
  344. package/scripts/verify_service.js +15410 -15250
  345. package/scripts/verify_tooling.js +1412 -1412
  346. package/scripts/verify_treasury_public_boundary.js +97 -97
  347. package/scripts/verify_x402_facilitator.js +174 -0
  348. package/server.js +11117 -11006
  349. package/.env.production.checklist +0 -77
  350. package/.env.production.template +0 -54
  351. package/.github/workflows/publish-mcp-executor.yml +0 -43
  352. package/ADAPTER_PARTNER_PATH.md +0 -47
  353. package/ADAPTER_PROMOTION_START_HERE.md +0 -44
  354. package/BOLT_BINDINGS.production.worksheet.json +0 -31
  355. package/EXECUTION_TARGETS.production.worksheet.json +0 -73
  356. package/GO_LIVE_OPERATOR_PACK.md +0 -412
  357. package/L402_BINDINGS.production.worksheet.json +0 -30
  358. package/OPERATIONS_RUNBOOK.md +0 -115
  359. package/OPERATOR_START_HERE.md +0 -63
  360. package/OUTREACH_MESSAGES.md +0 -19
  361. package/OUTREACH_START_HERE.md +0 -36
  362. package/PRODUCTION_MANUAL_CLOSEOUT_SEQUENCE.md +0 -172
  363. package/PROGRAM_COMPLETE_RELEASE.md +0 -63
  364. package/PROGRAM_STATUS.md +0 -57
  365. package/PUBLISH_PLAN.md +0 -26
  366. package/RELEASE_CHECKLIST.md +0 -16
  367. package/SOFT_LAUNCH_KIT.md +0 -47
  368. package/services/mcp-execution-target/DISCOVERY_REGISTRY_PLAYBOOK.md +0 -141
  369. package/services/mcp-execution-target/README.md +0 -319
  370. package/services/mcp-execution-target/package.json +0 -14
  371. package/services/mcp-execution-target/server.js +0 -1031
  372. package/services/mcp-execution-target/server.json +0 -16
  373. package/services/mcp-execution-target/verify.js +0 -308
@@ -1,407 +1,407 @@
1
- "use strict";
2
-
3
- const { summarizeActivityLedger } = require("./activity_audit_contract");
4
- const { buildEconomicsIntelligenceSummary } = require("./commerce_economics");
5
- const { buildPartnerIntelligencePack } = require("./partner_intelligence");
6
- const { buildRevenueSignalSummary } = require("./pricing_optimization_contract");
7
-
8
- const OPERATOR_OBSERVABILITY_REJECTION_CODES = [
9
- "boundary_missing",
10
- "missing_linked_surface",
11
- "mutation_surface_linked",
12
- "settlement_submission_surface_linked",
13
- "fund_movement_surface_linked",
14
- "unsafe_attention_action",
15
- "secret_material_forbidden",
16
- "count_not_number"
17
- ];
18
-
19
- const OPERATOR_OBSERVABILITY_REQUIRED_SURFACES = [
20
- "activity_ledger_ref",
21
- "payment_ledger_ref",
22
- "reconciliation_report_ref",
23
- "deliveries_ref",
24
- "settlement_ref",
25
- "adapter_depth_ref",
26
- "pricing_revenue_signal_ref",
27
- "operator_intelligence_ref"
28
- ];
29
-
30
- function valuesFromCollection(collection) {
31
- if (!collection) return [];
32
- if (collection instanceof Map) return Array.from(collection.values());
33
- return Array.isArray(collection) ? collection : [];
34
- }
35
-
36
- function containsSecretMaterial(value) {
37
- if (!value || typeof value !== "object") return false;
38
- const secretishKey = /(secret|token|credential|password|private[_-]?key|authorization|api[_-]?key)/i;
39
- const secretishValue = /(bearer\s+[a-z0-9._-]{8,}|sk_live_|npm_[a-z0-9]|ghp_[a-z0-9]|xox[baprs]-)/i;
40
- const stack = [value];
41
- while (stack.length > 0) {
42
- const current = stack.pop();
43
- if (!current || typeof current !== "object") continue;
44
- for (const [key, entry] of Object.entries(current)) {
45
- if (secretishKey.test(String(key))) return true;
46
- if (typeof entry === "string" && secretishValue.test(entry)) return true;
47
- if (entry && typeof entry === "object") stack.push(entry);
48
- }
49
- }
50
- return false;
51
- }
52
-
53
- function isUnsafeLinkedSurface(value) {
54
- const normalized = String(value || "").toLowerCase();
55
- return /\/(submit|refund|grant|release|rotate|delete|mutate|write|webhook|checkout)(\/|$)|submission|fund-movement|fund_movement/.test(normalized);
56
- }
57
-
58
- function isSettlementSubmissionSurface(value) {
59
- const normalized = String(value || "").toLowerCase();
60
- return /settlement.*(submit|submission|broadcast|raw_tx)|\/submit(\/|$)/.test(normalized);
61
- }
62
-
63
- function isFundMovementSurface(value) {
64
- const normalized = String(value || "").toLowerCase();
65
- return /(fund|treasury|credit).*(release|transfer|withdraw|grant|refund|disburse)|external-credit-grants/.test(normalized);
66
- }
67
-
68
- function isUnsafeAttentionAction(action) {
69
- const normalized = String(action || "").toLowerCase();
70
- return /^(submit|grant|refund|release|rotate|delete|write|mutate|broadcast|withdraw|transfer|disburse)_/.test(normalized);
71
- }
72
-
73
- function unwrapTransaction(entry) {
74
- if (entry && entry.transaction) return entry.transaction;
75
- return entry || null;
76
- }
77
-
78
- function countBy(values, selector) {
79
- return values.reduce((acc, value) => {
80
- const key = selector(value) || "unknown";
81
- acc[key] = (acc[key] || 0) + 1;
82
- return acc;
83
- }, {});
84
- }
85
-
86
- function countAdapterFailures(transactions) {
87
- return transactions.filter((transaction) => {
88
- const execution = transaction && transaction.execution;
89
- const results = execution && execution.results_by_task_id && typeof execution.results_by_task_id === "object"
90
- ? Object.values(execution.results_by_task_id)
91
- : [];
92
- return transaction && transaction.status === "failed"
93
- || execution && execution.status === "failed"
94
- || results.some((result) => result && (
95
- result.status === "failed"
96
- || result.invocation_status === "provider_failed"
97
- || result.provider_status === "failed"
98
- ));
99
- }).length;
100
- }
101
-
102
- function latestIso(values, fieldNames) {
103
- const timestamps = values
104
- .flatMap((value) => fieldNames.map((fieldName) => value && value[fieldName]).filter(Boolean))
105
- .map((value) => Date.parse(value))
106
- .filter((value) => Number.isFinite(value))
107
- .sort((left, right) => right - left);
108
- return timestamps.length ? new Date(timestamps[0]).toISOString() : null;
109
- }
110
-
111
- function buildAttentionQueue({ counts, revenueSignals }) {
112
- const queue = [];
113
- if (counts.adapter_failure_count > 0) {
114
- queue.push({
115
- lane: "adapter_execution",
116
- priority: "high",
117
- action: "inspect_adapter_failures",
118
- surface_ref: "/v1/runtime-bridge/dispatches",
119
- reason: "provider-backed execution reported failed adapter outcomes"
120
- });
121
- }
122
- if (counts.failed_settlement_count > 0 || counts.pending_settlement_count > 0) {
123
- queue.push({
124
- lane: "settlement",
125
- priority: counts.failed_settlement_count > 0 ? "high" : "medium",
126
- action: "inspect_native_settlement_records",
127
- surface_ref: "/v1/settlement/bsv-teranode",
128
- reason: "settlement records are failed or waiting for submission/finality"
129
- });
130
- }
131
- if (counts.payment_count > counts.delivery_count) {
132
- queue.push({
133
- lane: "delivery",
134
- priority: "medium",
135
- action: "compare_payment_ledger_to_deliveries",
136
- surface_ref: "/v1/deliveries",
137
- reason: "payment count is higher than delivery count"
138
- });
139
- }
140
- if (revenueSignals.sample_maturity === "sparse_live_signals") {
141
- queue.push({
142
- lane: "pricing_telemetry",
143
- priority: "low",
144
- action: "continue_collecting_live_quote_and_execution_metrics",
145
- surface_ref: "/v1/pricing-optimization/revenue-signal-summary",
146
- reason: "pricing recommendations should stay conservative while live samples are sparse"
147
- });
148
- }
149
- if (queue.length === 0) {
150
- queue.push({
151
- lane: "operator_posture",
152
- priority: "low",
153
- action: "continue_current_observability_cadence",
154
- surface_ref: "/v1/operator-observability/summary",
155
- reason: "no immediate operator attention item crossed the current thresholds"
156
- });
157
- }
158
- return queue;
159
- }
160
-
161
- function buildOperatorIntelligencePack(state, input) {
162
- const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
163
- const accountId = String(payload.account_id || "acct_demo").trim() || "acct_demo";
164
- const economicsIntelligence = buildEconomicsIntelligenceSummary(state, accountId);
165
- const partnerIntelligence = buildPartnerIntelligencePack();
166
-
167
- const actionQueue = [];
168
-
169
- if (economicsIntelligence.next_best_action && economicsIntelligence.next_best_action !== "continue_current_posture") {
170
- actionQueue.push({
171
- lane: "runtime_economics",
172
- priority: economicsIntelligence.replenishment_risk_state === "high" ? "high" : "medium",
173
- action: economicsIntelligence.next_best_action,
174
- reason: `funding posture is ${economicsIntelligence.recommended_funding_posture} with ${economicsIntelligence.replenishment_risk_state} replenishment risk`
175
- });
176
- }
177
-
178
- if (partnerIntelligence.next_best_action) {
179
- actionQueue.push({
180
- lane: "partner_adoption",
181
- priority: partnerIntelligence.onboarding_friction_state === "low" ? "medium" : "high",
182
- action: partnerIntelligence.next_best_action,
183
- reason: `partner readiness is ${partnerIntelligence.partner_readiness_state} and onboarding friction is ${partnerIntelligence.onboarding_friction_state}`
184
- });
185
- }
186
-
187
- if (actionQueue.length === 0) {
188
- actionQueue.push({
189
- lane: "operator_posture",
190
- priority: "low",
191
- action: "continue_current_posture",
192
- reason: "runtime economics and partner posture are both stable enough to continue current operation"
193
- });
194
- }
195
-
196
- return {
197
- ok: true,
198
- account_id: accountId,
199
- category: "machine-commerce-operator-intelligence-pack",
200
- overall_operator_state: {
201
- runtime_economics_state: economicsIntelligence.treasury_health_state,
202
- partner_adoption_state: partnerIntelligence.partner_readiness_state,
203
- top_priority: actionQueue[0].priority
204
- },
205
- recommended_operator_motion: actionQueue[0].action,
206
- next_action_queue: actionQueue,
207
- intelligence_refs: {
208
- economics_intelligence_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/intelligence-summary`,
209
- partner_intelligence_ref: "/v1/partner-intelligence",
210
- operator_dashboard_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`
211
- },
212
- explanation_signals: {
213
- runtime_next_best_action: economicsIntelligence.next_best_action,
214
- runtime_funding_posture: economicsIntelligence.recommended_funding_posture,
215
- runtime_replenishment_risk_state: economicsIntelligence.replenishment_risk_state,
216
- runtime_treasury_health_state: economicsIntelligence.treasury_health_state,
217
- partner_next_best_action: partnerIntelligence.next_best_action,
218
- partner_readiness_state: partnerIntelligence.partner_readiness_state,
219
- partner_onboarding_friction_state: partnerIntelligence.onboarding_friction_state,
220
- partner_promotion_readiness_state: partnerIntelligence.promotion_readiness_state
221
- },
222
- generated_from: {
223
- economics_category: economicsIntelligence.category,
224
- partner_category: partnerIntelligence.category
225
- }
226
- };
227
- }
228
-
229
- function summarizeOperatorIntelligencePack(state, input) {
230
- const pack = buildOperatorIntelligencePack(state, input);
231
- return {
232
- ok: true,
233
- account_id: pack.account_id,
234
- category: pack.category,
235
- recommended_operator_motion: pack.recommended_operator_motion,
236
- queue_length: pack.next_action_queue.length,
237
- runtime_economics_state: pack.overall_operator_state.runtime_economics_state,
238
- partner_adoption_state: pack.overall_operator_state.partner_adoption_state
239
- };
240
- }
241
-
242
- function buildOperatorObservabilityPack(state, input) {
243
- const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
244
- const accountId = String(payload.account_id || "").trim() || null;
245
- const quotes = valuesFromCollection(state && state.quotes).filter((quote) => !accountId || quote.account_id === accountId);
246
- const transactions = valuesFromCollection(state && state.transactions)
247
- .map(unwrapTransaction)
248
- .filter(Boolean)
249
- .filter((transaction) => !accountId || transaction.account_id === accountId);
250
- const receipts = valuesFromCollection(state && state.receipts)
251
- .map((entry) => entry && entry.receipt ? entry.receipt : entry)
252
- .filter(Boolean)
253
- .filter((receipt) => !accountId || receipt.account_id === accountId);
254
- const deliveries = valuesFromCollection(state && state.deliveries).filter((delivery) => !accountId || delivery.account_id === accountId);
255
- const payments = (Array.isArray(state && state.paymentLedger) ? state.paymentLedger : [])
256
- .filter((payment) => !accountId || payment.account_id === accountId);
257
- const externalCreditGrants = valuesFromCollection(state && state.externalCreditGrants)
258
- .filter((grant) => !accountId || grant.account_id === accountId);
259
- const settlements = valuesFromCollection(state && state.bsvSettlementRecords)
260
- .filter((settlement) => !accountId || settlement.account_id === accountId);
261
- const activitySummary = summarizeActivityLedger(state, { account_id: accountId });
262
- const revenueSignals = buildRevenueSignalSummary(state);
263
- const failedSettlementCount = settlements.filter((settlement) => settlement && settlement.status === "failed").length;
264
- const pendingSettlementCount = settlements.filter((settlement) => settlement && (
265
- settlement.status === "ready_for_submission"
266
- || settlement.finality_status === "pending_submission"
267
- || settlement.finality_status === "pending_confirmation"
268
- )).length;
269
- const counts = {
270
- quote_count: quotes.length,
271
- transaction_count: transactions.length,
272
- receipt_count: receipts.length,
273
- payment_count: payments.length,
274
- delivery_count: deliveries.length,
275
- external_credit_grant_count: externalCreditGrants.length,
276
- settlement_count: settlements.length,
277
- finalized_settlement_count: settlements.filter((settlement) => settlement && settlement.finality_status === "finalized").length,
278
- pending_settlement_count: pendingSettlementCount,
279
- failed_settlement_count: failedSettlementCount,
280
- adapter_failure_count: countAdapterFailures(transactions)
281
- };
282
- const attentionQueue = buildAttentionQueue({ counts, revenueSignals });
283
- return {
284
- ok: true,
285
- product: "xytara",
286
- category: "machine-commerce-operator-observability-pack",
287
- pack_version: "xytara-operator-observability-pack-v1",
288
- posture: "read_only_operator_visibility_across_money_execution_delivery_settlement_and_pricing",
289
- account_scope: accountId || "all_accounts",
290
- operator_state: attentionQueue.some((entry) => entry.priority === "high")
291
- ? "attention_required"
292
- : attentionQueue.some((entry) => entry.priority === "medium")
293
- ? "watch"
294
- : "steady",
295
- counts,
296
- status_counts: {
297
- quotes: countBy(quotes, (quote) => quote && quote.status),
298
- transactions: countBy(transactions, (transaction) => transaction && transaction.status),
299
- deliveries: countBy(deliveries, (delivery) => delivery && delivery.status),
300
- payments: countBy(payments, (payment) => payment && payment.status || payment && payment.payment && payment.payment.status),
301
- settlements: countBy(settlements, (settlement) => settlement && settlement.status),
302
- settlement_finality: countBy(settlements, (settlement) => settlement && settlement.finality_status)
303
- },
304
- latest_activity: {
305
- quote_at_iso: latestIso(quotes, ["created_at_iso", "executed_at_iso", "payment_recorded_at_iso"]),
306
- transaction_at_iso: latestIso(transactions, ["completed_at_iso", "created_at_iso"]),
307
- payment_at_iso: latestIso(payments, ["recorded_at_iso"]),
308
- delivery_at_iso: latestIso(deliveries, ["delivered_at_iso", "created_at_iso"]),
309
- grant_at_iso: latestIso(externalCreditGrants, ["created_at_iso", "granted_at_iso", "recorded_at_iso"]),
310
- settlement_at_iso: latestIso(settlements, ["finalized_at_iso", "confirmed_at_iso", "submitted_at_iso", "created_at_iso"])
311
- },
312
- activity_summary: activitySummary,
313
- pricing_telemetry_summary: {
314
- sample_maturity: revenueSignals.sample_maturity,
315
- pricing_change_posture: revenueSignals.pricing_change_posture,
316
- quote_conversion_rate: revenueSignals.rates.quote_conversion_rate,
317
- quote_abandonment_rate: revenueSignals.rates.quote_abandonment_rate,
318
- revenue_capture_rate: revenueSignals.rates.revenue_capture_rate
319
- },
320
- attention_queue: attentionQueue,
321
- linked_surfaces: {
322
- activity_ledger_ref: "/v1/activity-ledger",
323
- payment_ledger_ref: "/v1/payment-ledger",
324
- reconciliation_report_ref: "/v1/reconciliation-report",
325
- deliveries_ref: "/v1/deliveries",
326
- settlement_ref: "/v1/settlement/bsv-teranode",
327
- adapter_depth_ref: "/v1/adapter-depth/summary",
328
- pricing_revenue_signal_ref: "/v1/pricing-optimization/revenue-signal-summary",
329
- operator_intelligence_ref: "/v1/operator-intelligence"
330
- },
331
- deterministic_rejection_codes: OPERATOR_OBSERVABILITY_REJECTION_CODES.slice(),
332
- boundary: "read_only_operator_visibility_no_fund_movement_no_settlement_submission_no_secret_material"
333
- };
334
- }
335
-
336
- function validateOperatorObservabilityBoundary(packInput) {
337
- const pack = packInput || {};
338
- const rejectionCodes = [];
339
- const linkedSurfaces = pack.linked_surfaces || {};
340
- const counts = pack.counts || {};
341
- if (pack.boundary !== "read_only_operator_visibility_no_fund_movement_no_settlement_submission_no_secret_material") {
342
- rejectionCodes.push("boundary_missing");
343
- }
344
- for (const surfaceName of OPERATOR_OBSERVABILITY_REQUIRED_SURFACES) {
345
- if (!linkedSurfaces[surfaceName]) {
346
- rejectionCodes.push("missing_linked_surface");
347
- }
348
- }
349
- for (const surfaceRef of Object.values(linkedSurfaces)) {
350
- if (isUnsafeLinkedSurface(surfaceRef)) rejectionCodes.push("mutation_surface_linked");
351
- if (isSettlementSubmissionSurface(surfaceRef)) rejectionCodes.push("settlement_submission_surface_linked");
352
- if (isFundMovementSurface(surfaceRef)) rejectionCodes.push("fund_movement_surface_linked");
353
- }
354
- const attentionQueue = Array.isArray(pack.attention_queue) ? pack.attention_queue : [];
355
- for (const item of attentionQueue) {
356
- if (item && isUnsafeAttentionAction(item.action)) {
357
- rejectionCodes.push("unsafe_attention_action");
358
- }
359
- }
360
- for (const [key, value] of Object.entries(counts)) {
361
- if (key.endsWith("_count") && typeof value !== "number") {
362
- rejectionCodes.push("count_not_number");
363
- }
364
- }
365
- if (containsSecretMaterial(pack)) {
366
- rejectionCodes.push("secret_material_forbidden");
367
- }
368
- return {
369
- validation_version: "xytara-operator-observability-boundary-validation-v1",
370
- observability_boundary_valid: rejectionCodes.length === 0,
371
- rejection_codes: Array.from(new Set(rejectionCodes)),
372
- deterministic_rejection_codes: OPERATOR_OBSERVABILITY_REJECTION_CODES.slice(),
373
- boundary: "operator_observability_must_remain_read_only_without_secret_material_mutation_links_or_fund_movement_actions"
374
- };
375
- }
376
-
377
- function summarizeOperatorObservabilityPack(state, input) {
378
- const pack = buildOperatorObservabilityPack(state, input);
379
- return {
380
- ok: true,
381
- product: pack.product,
382
- category: "machine-commerce-operator-observability-pack-summary",
383
- summary_version: "xytara-operator-observability-pack-summary-v1",
384
- account_scope: pack.account_scope,
385
- operator_state: pack.operator_state,
386
- quote_count: pack.counts.quote_count,
387
- payment_count: pack.counts.payment_count,
388
- transaction_count: pack.counts.transaction_count,
389
- delivery_count: pack.counts.delivery_count,
390
- external_credit_grant_count: pack.counts.external_credit_grant_count,
391
- settlement_count: pack.counts.settlement_count,
392
- pending_settlement_count: pack.counts.pending_settlement_count,
393
- adapter_failure_count: pack.counts.adapter_failure_count,
394
- pricing_sample_maturity: pack.pricing_telemetry_summary.sample_maturity,
395
- attention_item_count: pack.attention_queue.length,
396
- deterministic_rejection_code_count: pack.deterministic_rejection_codes.length,
397
- linked_surfaces: pack.linked_surfaces
398
- };
399
- }
400
-
401
- module.exports = {
402
- buildOperatorIntelligencePack,
403
- summarizeOperatorIntelligencePack,
404
- buildOperatorObservabilityPack,
405
- summarizeOperatorObservabilityPack,
406
- validateOperatorObservabilityBoundary
407
- };
1
+ "use strict";
2
+
3
+ const { summarizeActivityLedger } = require("./activity_audit_contract");
4
+ const { buildEconomicsIntelligenceSummary } = require("./commerce_economics");
5
+ const { buildPartnerIntelligencePack } = require("./partner_intelligence");
6
+ const { buildRevenueSignalSummary } = require("./pricing_optimization_contract");
7
+
8
+ const OPERATOR_OBSERVABILITY_REJECTION_CODES = [
9
+ "boundary_missing",
10
+ "missing_linked_surface",
11
+ "mutation_surface_linked",
12
+ "settlement_submission_surface_linked",
13
+ "fund_movement_surface_linked",
14
+ "unsafe_attention_action",
15
+ "secret_material_forbidden",
16
+ "count_not_number"
17
+ ];
18
+
19
+ const OPERATOR_OBSERVABILITY_REQUIRED_SURFACES = [
20
+ "activity_ledger_ref",
21
+ "payment_ledger_ref",
22
+ "reconciliation_report_ref",
23
+ "deliveries_ref",
24
+ "settlement_ref",
25
+ "adapter_depth_ref",
26
+ "pricing_revenue_signal_ref",
27
+ "operator_intelligence_ref"
28
+ ];
29
+
30
+ function valuesFromCollection(collection) {
31
+ if (!collection) return [];
32
+ if (collection instanceof Map) return Array.from(collection.values());
33
+ return Array.isArray(collection) ? collection : [];
34
+ }
35
+
36
+ function containsSecretMaterial(value) {
37
+ if (!value || typeof value !== "object") return false;
38
+ const secretishKey = /(secret|token|credential|password|private[_-]?key|authorization|api[_-]?key)/i;
39
+ const secretishValue = /(bearer\s+[a-z0-9._-]{8,}|sk_live_|npm_[a-z0-9]|ghp_[a-z0-9]|xox[baprs]-)/i;
40
+ const stack = [value];
41
+ while (stack.length > 0) {
42
+ const current = stack.pop();
43
+ if (!current || typeof current !== "object") continue;
44
+ for (const [key, entry] of Object.entries(current)) {
45
+ if (secretishKey.test(String(key))) return true;
46
+ if (typeof entry === "string" && secretishValue.test(entry)) return true;
47
+ if (entry && typeof entry === "object") stack.push(entry);
48
+ }
49
+ }
50
+ return false;
51
+ }
52
+
53
+ function isUnsafeLinkedSurface(value) {
54
+ const normalized = String(value || "").toLowerCase();
55
+ return /\/(submit|refund|grant|release|rotate|delete|mutate|write|webhook|checkout)(\/|$)|submission|fund-movement|fund_movement/.test(normalized);
56
+ }
57
+
58
+ function isSettlementSubmissionSurface(value) {
59
+ const normalized = String(value || "").toLowerCase();
60
+ return /settlement.*(submit|submission|broadcast|raw_tx)|\/submit(\/|$)/.test(normalized);
61
+ }
62
+
63
+ function isFundMovementSurface(value) {
64
+ const normalized = String(value || "").toLowerCase();
65
+ return /(fund|treasury|credit).*(release|transfer|withdraw|grant|refund|disburse)|external-credit-grants/.test(normalized);
66
+ }
67
+
68
+ function isUnsafeAttentionAction(action) {
69
+ const normalized = String(action || "").toLowerCase();
70
+ return /^(submit|grant|refund|release|rotate|delete|write|mutate|broadcast|withdraw|transfer|disburse)_/.test(normalized);
71
+ }
72
+
73
+ function unwrapTransaction(entry) {
74
+ if (entry && entry.transaction) return entry.transaction;
75
+ return entry || null;
76
+ }
77
+
78
+ function countBy(values, selector) {
79
+ return values.reduce((acc, value) => {
80
+ const key = selector(value) || "unknown";
81
+ acc[key] = (acc[key] || 0) + 1;
82
+ return acc;
83
+ }, {});
84
+ }
85
+
86
+ function countAdapterFailures(transactions) {
87
+ return transactions.filter((transaction) => {
88
+ const execution = transaction && transaction.execution;
89
+ const results = execution && execution.results_by_task_id && typeof execution.results_by_task_id === "object"
90
+ ? Object.values(execution.results_by_task_id)
91
+ : [];
92
+ return transaction && transaction.status === "failed"
93
+ || execution && execution.status === "failed"
94
+ || results.some((result) => result && (
95
+ result.status === "failed"
96
+ || result.invocation_status === "provider_failed"
97
+ || result.provider_status === "failed"
98
+ ));
99
+ }).length;
100
+ }
101
+
102
+ function latestIso(values, fieldNames) {
103
+ const timestamps = values
104
+ .flatMap((value) => fieldNames.map((fieldName) => value && value[fieldName]).filter(Boolean))
105
+ .map((value) => Date.parse(value))
106
+ .filter((value) => Number.isFinite(value))
107
+ .sort((left, right) => right - left);
108
+ return timestamps.length ? new Date(timestamps[0]).toISOString() : null;
109
+ }
110
+
111
+ function buildAttentionQueue({ counts, revenueSignals }) {
112
+ const queue = [];
113
+ if (counts.adapter_failure_count > 0) {
114
+ queue.push({
115
+ lane: "adapter_execution",
116
+ priority: "high",
117
+ action: "inspect_adapter_failures",
118
+ surface_ref: "/v1/runtime-bridge/dispatches",
119
+ reason: "provider-backed execution reported failed adapter outcomes"
120
+ });
121
+ }
122
+ if (counts.failed_settlement_count > 0 || counts.pending_settlement_count > 0) {
123
+ queue.push({
124
+ lane: "settlement",
125
+ priority: counts.failed_settlement_count > 0 ? "high" : "medium",
126
+ action: "inspect_native_settlement_records",
127
+ surface_ref: "/v1/settlement/bsv-teranode",
128
+ reason: "settlement records are failed or waiting for submission/finality"
129
+ });
130
+ }
131
+ if (counts.payment_count > counts.delivery_count) {
132
+ queue.push({
133
+ lane: "delivery",
134
+ priority: "medium",
135
+ action: "compare_payment_ledger_to_deliveries",
136
+ surface_ref: "/v1/deliveries",
137
+ reason: "payment count is higher than delivery count"
138
+ });
139
+ }
140
+ if (revenueSignals.sample_maturity === "sparse_live_signals") {
141
+ queue.push({
142
+ lane: "pricing_telemetry",
143
+ priority: "low",
144
+ action: "continue_collecting_live_quote_and_execution_metrics",
145
+ surface_ref: "/v1/pricing-optimization/revenue-signal-summary",
146
+ reason: "pricing recommendations should stay conservative while live samples are sparse"
147
+ });
148
+ }
149
+ if (queue.length === 0) {
150
+ queue.push({
151
+ lane: "operator_posture",
152
+ priority: "low",
153
+ action: "continue_current_observability_cadence",
154
+ surface_ref: "/v1/operator-observability/summary",
155
+ reason: "no immediate operator attention item crossed the current thresholds"
156
+ });
157
+ }
158
+ return queue;
159
+ }
160
+
161
+ function buildOperatorIntelligencePack(state, input) {
162
+ const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
163
+ const accountId = String(payload.account_id || "acct_demo").trim() || "acct_demo";
164
+ const economicsIntelligence = buildEconomicsIntelligenceSummary(state, accountId);
165
+ const partnerIntelligence = buildPartnerIntelligencePack();
166
+
167
+ const actionQueue = [];
168
+
169
+ if (economicsIntelligence.next_best_action && economicsIntelligence.next_best_action !== "continue_current_posture") {
170
+ actionQueue.push({
171
+ lane: "runtime_economics",
172
+ priority: economicsIntelligence.replenishment_risk_state === "high" ? "high" : "medium",
173
+ action: economicsIntelligence.next_best_action,
174
+ reason: `funding posture is ${economicsIntelligence.recommended_funding_posture} with ${economicsIntelligence.replenishment_risk_state} replenishment risk`
175
+ });
176
+ }
177
+
178
+ if (partnerIntelligence.next_best_action) {
179
+ actionQueue.push({
180
+ lane: "partner_adoption",
181
+ priority: partnerIntelligence.onboarding_friction_state === "low" ? "medium" : "high",
182
+ action: partnerIntelligence.next_best_action,
183
+ reason: `partner readiness is ${partnerIntelligence.partner_readiness_state} and onboarding friction is ${partnerIntelligence.onboarding_friction_state}`
184
+ });
185
+ }
186
+
187
+ if (actionQueue.length === 0) {
188
+ actionQueue.push({
189
+ lane: "operator_posture",
190
+ priority: "low",
191
+ action: "continue_current_posture",
192
+ reason: "runtime economics and partner posture are both stable enough to continue current operation"
193
+ });
194
+ }
195
+
196
+ return {
197
+ ok: true,
198
+ account_id: accountId,
199
+ category: "machine-commerce-operator-intelligence-pack",
200
+ overall_operator_state: {
201
+ runtime_economics_state: economicsIntelligence.treasury_health_state,
202
+ partner_adoption_state: partnerIntelligence.partner_readiness_state,
203
+ top_priority: actionQueue[0].priority
204
+ },
205
+ recommended_operator_motion: actionQueue[0].action,
206
+ next_action_queue: actionQueue,
207
+ intelligence_refs: {
208
+ economics_intelligence_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/intelligence-summary`,
209
+ partner_intelligence_ref: "/v1/partner-intelligence",
210
+ operator_dashboard_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`
211
+ },
212
+ explanation_signals: {
213
+ runtime_next_best_action: economicsIntelligence.next_best_action,
214
+ runtime_funding_posture: economicsIntelligence.recommended_funding_posture,
215
+ runtime_replenishment_risk_state: economicsIntelligence.replenishment_risk_state,
216
+ runtime_treasury_health_state: economicsIntelligence.treasury_health_state,
217
+ partner_next_best_action: partnerIntelligence.next_best_action,
218
+ partner_readiness_state: partnerIntelligence.partner_readiness_state,
219
+ partner_onboarding_friction_state: partnerIntelligence.onboarding_friction_state,
220
+ partner_promotion_readiness_state: partnerIntelligence.promotion_readiness_state
221
+ },
222
+ generated_from: {
223
+ economics_category: economicsIntelligence.category,
224
+ partner_category: partnerIntelligence.category
225
+ }
226
+ };
227
+ }
228
+
229
+ function summarizeOperatorIntelligencePack(state, input) {
230
+ const pack = buildOperatorIntelligencePack(state, input);
231
+ return {
232
+ ok: true,
233
+ account_id: pack.account_id,
234
+ category: pack.category,
235
+ recommended_operator_motion: pack.recommended_operator_motion,
236
+ queue_length: pack.next_action_queue.length,
237
+ runtime_economics_state: pack.overall_operator_state.runtime_economics_state,
238
+ partner_adoption_state: pack.overall_operator_state.partner_adoption_state
239
+ };
240
+ }
241
+
242
+ function buildOperatorObservabilityPack(state, input) {
243
+ const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
244
+ const accountId = String(payload.account_id || "").trim() || null;
245
+ const quotes = valuesFromCollection(state && state.quotes).filter((quote) => !accountId || quote.account_id === accountId);
246
+ const transactions = valuesFromCollection(state && state.transactions)
247
+ .map(unwrapTransaction)
248
+ .filter(Boolean)
249
+ .filter((transaction) => !accountId || transaction.account_id === accountId);
250
+ const receipts = valuesFromCollection(state && state.receipts)
251
+ .map((entry) => entry && entry.receipt ? entry.receipt : entry)
252
+ .filter(Boolean)
253
+ .filter((receipt) => !accountId || receipt.account_id === accountId);
254
+ const deliveries = valuesFromCollection(state && state.deliveries).filter((delivery) => !accountId || delivery.account_id === accountId);
255
+ const payments = (Array.isArray(state && state.paymentLedger) ? state.paymentLedger : [])
256
+ .filter((payment) => !accountId || payment.account_id === accountId);
257
+ const externalCreditGrants = valuesFromCollection(state && state.externalCreditGrants)
258
+ .filter((grant) => !accountId || grant.account_id === accountId);
259
+ const settlements = valuesFromCollection(state && state.bsvSettlementRecords)
260
+ .filter((settlement) => !accountId || settlement.account_id === accountId);
261
+ const activitySummary = summarizeActivityLedger(state, { account_id: accountId });
262
+ const revenueSignals = buildRevenueSignalSummary(state);
263
+ const failedSettlementCount = settlements.filter((settlement) => settlement && settlement.status === "failed").length;
264
+ const pendingSettlementCount = settlements.filter((settlement) => settlement && (
265
+ settlement.status === "ready_for_submission"
266
+ || settlement.finality_status === "pending_submission"
267
+ || settlement.finality_status === "pending_confirmation"
268
+ )).length;
269
+ const counts = {
270
+ quote_count: quotes.length,
271
+ transaction_count: transactions.length,
272
+ receipt_count: receipts.length,
273
+ payment_count: payments.length,
274
+ delivery_count: deliveries.length,
275
+ external_credit_grant_count: externalCreditGrants.length,
276
+ settlement_count: settlements.length,
277
+ finalized_settlement_count: settlements.filter((settlement) => settlement && settlement.finality_status === "finalized").length,
278
+ pending_settlement_count: pendingSettlementCount,
279
+ failed_settlement_count: failedSettlementCount,
280
+ adapter_failure_count: countAdapterFailures(transactions)
281
+ };
282
+ const attentionQueue = buildAttentionQueue({ counts, revenueSignals });
283
+ return {
284
+ ok: true,
285
+ product: "xytara",
286
+ category: "machine-commerce-operator-observability-pack",
287
+ pack_version: "xytara-operator-observability-pack-v1",
288
+ posture: "read_only_operator_visibility_across_money_execution_delivery_settlement_and_pricing",
289
+ account_scope: accountId || "all_accounts",
290
+ operator_state: attentionQueue.some((entry) => entry.priority === "high")
291
+ ? "attention_required"
292
+ : attentionQueue.some((entry) => entry.priority === "medium")
293
+ ? "watch"
294
+ : "steady",
295
+ counts,
296
+ status_counts: {
297
+ quotes: countBy(quotes, (quote) => quote && quote.status),
298
+ transactions: countBy(transactions, (transaction) => transaction && transaction.status),
299
+ deliveries: countBy(deliveries, (delivery) => delivery && delivery.status),
300
+ payments: countBy(payments, (payment) => payment && payment.status || payment && payment.payment && payment.payment.status),
301
+ settlements: countBy(settlements, (settlement) => settlement && settlement.status),
302
+ settlement_finality: countBy(settlements, (settlement) => settlement && settlement.finality_status)
303
+ },
304
+ latest_activity: {
305
+ quote_at_iso: latestIso(quotes, ["created_at_iso", "executed_at_iso", "payment_recorded_at_iso"]),
306
+ transaction_at_iso: latestIso(transactions, ["completed_at_iso", "created_at_iso"]),
307
+ payment_at_iso: latestIso(payments, ["recorded_at_iso"]),
308
+ delivery_at_iso: latestIso(deliveries, ["delivered_at_iso", "created_at_iso"]),
309
+ grant_at_iso: latestIso(externalCreditGrants, ["created_at_iso", "granted_at_iso", "recorded_at_iso"]),
310
+ settlement_at_iso: latestIso(settlements, ["finalized_at_iso", "confirmed_at_iso", "submitted_at_iso", "created_at_iso"])
311
+ },
312
+ activity_summary: activitySummary,
313
+ pricing_telemetry_summary: {
314
+ sample_maturity: revenueSignals.sample_maturity,
315
+ pricing_change_posture: revenueSignals.pricing_change_posture,
316
+ quote_conversion_rate: revenueSignals.rates.quote_conversion_rate,
317
+ quote_abandonment_rate: revenueSignals.rates.quote_abandonment_rate,
318
+ revenue_capture_rate: revenueSignals.rates.revenue_capture_rate
319
+ },
320
+ attention_queue: attentionQueue,
321
+ linked_surfaces: {
322
+ activity_ledger_ref: "/v1/activity-ledger",
323
+ payment_ledger_ref: "/v1/payment-ledger",
324
+ reconciliation_report_ref: "/v1/reconciliation-report",
325
+ deliveries_ref: "/v1/deliveries",
326
+ settlement_ref: "/v1/settlement/bsv-teranode",
327
+ adapter_depth_ref: "/v1/adapter-depth/summary",
328
+ pricing_revenue_signal_ref: "/v1/pricing-optimization/revenue-signal-summary",
329
+ operator_intelligence_ref: "/v1/operator-intelligence"
330
+ },
331
+ deterministic_rejection_codes: OPERATOR_OBSERVABILITY_REJECTION_CODES.slice(),
332
+ boundary: "read_only_operator_visibility_no_fund_movement_no_settlement_submission_no_secret_material"
333
+ };
334
+ }
335
+
336
+ function validateOperatorObservabilityBoundary(packInput) {
337
+ const pack = packInput || {};
338
+ const rejectionCodes = [];
339
+ const linkedSurfaces = pack.linked_surfaces || {};
340
+ const counts = pack.counts || {};
341
+ if (pack.boundary !== "read_only_operator_visibility_no_fund_movement_no_settlement_submission_no_secret_material") {
342
+ rejectionCodes.push("boundary_missing");
343
+ }
344
+ for (const surfaceName of OPERATOR_OBSERVABILITY_REQUIRED_SURFACES) {
345
+ if (!linkedSurfaces[surfaceName]) {
346
+ rejectionCodes.push("missing_linked_surface");
347
+ }
348
+ }
349
+ for (const surfaceRef of Object.values(linkedSurfaces)) {
350
+ if (isUnsafeLinkedSurface(surfaceRef)) rejectionCodes.push("mutation_surface_linked");
351
+ if (isSettlementSubmissionSurface(surfaceRef)) rejectionCodes.push("settlement_submission_surface_linked");
352
+ if (isFundMovementSurface(surfaceRef)) rejectionCodes.push("fund_movement_surface_linked");
353
+ }
354
+ const attentionQueue = Array.isArray(pack.attention_queue) ? pack.attention_queue : [];
355
+ for (const item of attentionQueue) {
356
+ if (item && isUnsafeAttentionAction(item.action)) {
357
+ rejectionCodes.push("unsafe_attention_action");
358
+ }
359
+ }
360
+ for (const [key, value] of Object.entries(counts)) {
361
+ if (key.endsWith("_count") && typeof value !== "number") {
362
+ rejectionCodes.push("count_not_number");
363
+ }
364
+ }
365
+ if (containsSecretMaterial(pack)) {
366
+ rejectionCodes.push("secret_material_forbidden");
367
+ }
368
+ return {
369
+ validation_version: "xytara-operator-observability-boundary-validation-v1",
370
+ observability_boundary_valid: rejectionCodes.length === 0,
371
+ rejection_codes: Array.from(new Set(rejectionCodes)),
372
+ deterministic_rejection_codes: OPERATOR_OBSERVABILITY_REJECTION_CODES.slice(),
373
+ boundary: "operator_observability_must_remain_read_only_without_secret_material_mutation_links_or_fund_movement_actions"
374
+ };
375
+ }
376
+
377
+ function summarizeOperatorObservabilityPack(state, input) {
378
+ const pack = buildOperatorObservabilityPack(state, input);
379
+ return {
380
+ ok: true,
381
+ product: pack.product,
382
+ category: "machine-commerce-operator-observability-pack-summary",
383
+ summary_version: "xytara-operator-observability-pack-summary-v1",
384
+ account_scope: pack.account_scope,
385
+ operator_state: pack.operator_state,
386
+ quote_count: pack.counts.quote_count,
387
+ payment_count: pack.counts.payment_count,
388
+ transaction_count: pack.counts.transaction_count,
389
+ delivery_count: pack.counts.delivery_count,
390
+ external_credit_grant_count: pack.counts.external_credit_grant_count,
391
+ settlement_count: pack.counts.settlement_count,
392
+ pending_settlement_count: pack.counts.pending_settlement_count,
393
+ adapter_failure_count: pack.counts.adapter_failure_count,
394
+ pricing_sample_maturity: pack.pricing_telemetry_summary.sample_maturity,
395
+ attention_item_count: pack.attention_queue.length,
396
+ deterministic_rejection_code_count: pack.deterministic_rejection_codes.length,
397
+ linked_surfaces: pack.linked_surfaces
398
+ };
399
+ }
400
+
401
+ module.exports = {
402
+ buildOperatorIntelligencePack,
403
+ summarizeOperatorIntelligencePack,
404
+ buildOperatorObservabilityPack,
405
+ summarizeOperatorObservabilityPack,
406
+ validateOperatorObservabilityBoundary
407
+ };