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,137 +0,0 @@
1
- "use strict";
2
-
3
- const {
4
- buildDefaultTransactionCenter,
5
- buildDefaultTransactionTaskPackCatalog,
6
- buildDefaultTransactionGuidedLoopCatalog,
7
- summarizeDefaultTransactionCenter,
8
- summarizeDefaultTransactionTaskPacks,
9
- summarizeDefaultTransactionGuidedLoops
10
- } = require("./catalog_contract");
11
-
12
- function buildMcpLanePack() {
13
- const center = buildDefaultTransactionCenter();
14
- const centerSummary = summarizeDefaultTransactionCenter();
15
- const taskPackCatalog = buildDefaultTransactionTaskPackCatalog();
16
- const taskPackSummary = summarizeDefaultTransactionTaskPacks();
17
- const guidedLoopCatalog = buildDefaultTransactionGuidedLoopCatalog();
18
- const guidedLoopSummary = summarizeDefaultTransactionGuidedLoops();
19
- const taskPacks = Array.isArray(taskPackCatalog.packs) ? taskPackCatalog.packs : [];
20
- const guidedLoops = Array.isArray(guidedLoopCatalog.loops) ? guidedLoopCatalog.loops : [];
21
- const defaultTaskPack = taskPacks.find((entry) => entry.pack_ref === "default.mcp.tool.invoke") || null;
22
- const defaultLoop = guidedLoops.find((entry) => entry.loop_ref === "default.mcp.loop") || null;
23
-
24
- return {
25
- product: "xytara",
26
- category: "machine-commerce-mcp-lane-pack",
27
- pack_version: "xytara-mcp-lane-pack-v1",
28
- lane_state: "first_party_default_present",
29
- default_protocol: centerSummary.default_protocol,
30
- default_payment_protocol: centerSummary.default_payment_protocol,
31
- default_settlement_mode: centerSummary.default_settlement_mode,
32
- default_transaction_center: center,
33
- default_task_pack: defaultTaskPack,
34
- default_guided_loop: defaultLoop,
35
- task_pack_summary: taskPackSummary,
36
- guided_loop_summary: guidedLoopSummary,
37
- first_run_tools: [
38
- {
39
- tool_name: "summarize",
40
- lane: "default.mcp.tool.invoke",
41
- recommended_reason: "fastest low-friction example tool for first-run usage",
42
- example_surfaces: {
43
- preview_ref: "/v1/mcp/tools?tool_name=summarize",
44
- invoke_ref: "/v1/mcp/tools/invoke"
45
- }
46
- },
47
- {
48
- tool_name: "zones.lookup",
49
- lane: "default.mcp.loop",
50
- recommended_reason: "best first real infrastructure-shaped tool path",
51
- example_surfaces: {
52
- preview_ref: "/v1/mcp/tools?tool_name=zones.lookup",
53
- invoke_ref: "/v1/mcp/tools/invoke"
54
- }
55
- },
56
- {
57
- tool_name: "catalog",
58
- lane: "default.mcp.discovery",
59
- recommended_reason: "best first agent-facing catalog introspection tool for discovery-aware routing",
60
- example_surfaces: {
61
- preview_ref: "/v1/mcp/tools?tool_name=catalog",
62
- invoke_ref: "/v1/mcp/tools/invoke"
63
- }
64
- },
65
- {
66
- tool_name: "reply.draft",
67
- lane: "default.mcp.reply",
68
- recommended_reason: "compact agent-ready drafting helper for public workflows and responses",
69
- example_surfaces: {
70
- preview_ref: "/v1/mcp/tools?tool_name=reply.draft",
71
- invoke_ref: "/v1/mcp/tools/invoke"
72
- }
73
- },
74
- {
75
- tool_name: "json.validate",
76
- lane: "default.mcp.validate",
77
- recommended_reason: "deterministic JSON shape check for machine-to-machine payload hygiene",
78
- example_surfaces: {
79
- preview_ref: "/v1/mcp/tools?tool_name=json.validate",
80
- invoke_ref: "/v1/mcp/tools/invoke"
81
- }
82
- }
83
- ],
84
- supported_surfaces: {
85
- invoke_ref: "/v1/mcp/tools/invoke",
86
- paid_invoke_ref: "/x402/mcp/tools/invoke",
87
- auth_profile_ref: "/v1/auth-profiles",
88
- openapi_ref: "/openapi.json",
89
- asyncapi_ref: "/asyncapi.json",
90
- cloudevents_ref: "/cloudevents.json"
91
- },
92
- recommended_sequence: [
93
- "discover_default_mcp_lane",
94
- "preview_or_quote_default_tool_path",
95
- "choose_native_or_x402_payment_path",
96
- "invoke_tool",
97
- "inspect_transaction_and_handoff_posture"
98
- ]
99
- };
100
- }
101
-
102
- function summarizeMcpLanePack() {
103
- const pack = buildMcpLanePack();
104
- return {
105
- product: "xytara",
106
- category: "machine-commerce-mcp-lane-pack-summary",
107
- summary_version: "xytara-mcp-lane-pack-summary-v1",
108
- lane_state: pack.lane_state,
109
- default_payment_protocol: pack.default_payment_protocol,
110
- default_settlement_mode: pack.default_settlement_mode,
111
- first_run_tool_count: pack.first_run_tools.length,
112
- guided_loop_ref: pack.default_guided_loop ? pack.default_guided_loop.loop_ref : null,
113
- linked_surfaces: pack.supported_surfaces
114
- };
115
- }
116
-
117
- function listMcpTools() {
118
- return {
119
- ok: true,
120
- category: "machine-commerce-mcp-tools-list",
121
- list_version: "xytara-mcp-tools-list-v1",
122
- tools: buildMcpLanePack().first_run_tools
123
- };
124
- }
125
-
126
- function getMcpToolDetail(toolName) {
127
- const normalizedToolName = String(toolName || "").trim();
128
- const tools = buildMcpLanePack().first_run_tools;
129
- return tools.find((entry) => entry.tool_name === normalizedToolName) || null;
130
- }
131
-
132
- module.exports = {
133
- buildMcpLanePack,
134
- summarizeMcpLanePack,
135
- listMcpTools,
136
- getMcpToolDetail
137
- };
@@ -1,237 +0,0 @@
1
- "use strict";
2
-
3
- // Provider-agnostic MPP (per-call card/stablecoin payment) adapter.
4
- //
5
- // Makes the MPP/SPT lane real by verifying a Stripe PaymentIntent or Checkout
6
- // Session referenced in the authorization: it must be paid/succeeded and cover
7
- // at least the quoted amount. The provider reference is the proof; replay is
8
- // prevented by treating each reference as single-use. Engages only when env
9
- // configures Stripe; otherwise the caller preserves the existing token scheme.
10
- // Dependency-free (node https + an injectable fetcher for tests).
11
- //
12
- // Env:
13
- // XYTARA_MPP_PROVIDER = "stripe" (anything else => not configured)
14
- // XYTARA_MPP_STRIPE_SECRET_KEY | STRIPE_SECRET_KEY
15
- // XYTARA_MPP_ROOT_KEY | STRIPE_WEBHOOK_SECRET (HMAC key for the binding ref;
16
- // falls back to the secret key)
17
-
18
- // REQUEST BINDING (production-safe):
19
- // - The runtime CREATES the PaymentIntent server-side for a specific quote and
20
- // stamps metadata.naxytra_ref = HMAC(bindingSecret, quote). verifyMppPayment
21
- // requires the presented object to carry that exact ref (timing-safe), so a
22
- // paid Stripe object the caller controls for some OTHER purpose cannot be
23
- // replayed to authorize this call. Each reference is also single-use.
24
- // - Still a flat per-object check otherwise: it confirms paid + USD + covers the
25
- // quote amount. Processor minimums apply (Stripe will reject amounts below its
26
- // per-charge floor, ~$0.50 USD); price MPP calls at or above that floor.
27
-
28
- const https = require("https");
29
-
30
- function env(name) {
31
- const v = process.env[name];
32
- return typeof v === "string" && v.trim() ? v.trim() : "";
33
- }
34
-
35
- function loadMppConfig() {
36
- const provider = env("XYTARA_MPP_PROVIDER").toLowerCase();
37
- if (provider !== "stripe") return { provider: null };
38
- const secretKey = env("XYTARA_MPP_STRIPE_SECRET_KEY") || env("STRIPE_SECRET_KEY");
39
- return {
40
- provider: "stripe",
41
- secretKey,
42
- bindingSecret: env("XYTARA_MPP_ROOT_KEY") || env("STRIPE_WEBHOOK_SECRET") || secretKey
43
- };
44
- }
45
-
46
- function isConfigured(config) {
47
- return Boolean(config && config.provider);
48
- }
49
-
50
- const crypto = require("crypto");
51
-
52
- // Deterministic, server-only reference binding a payment to one quote. The caller
53
- // cannot forge it without bindingSecret, so only a payment created by the runtime
54
- // for THIS quote carries a matching metadata.naxytra_ref.
55
- function computeBindingRef(bindingSecret, quote) {
56
- const q = quote || {};
57
- const basis = `${q.quote_id || ""}:${q.amount_minor || ""}:${q.currency || ""}`;
58
- const mac = crypto.createHmac("sha256", String(bindingSecret || "")).update(basis).digest("hex");
59
- return "nx_" + mac.slice(0, 32);
60
- }
61
-
62
- function refEquals(a, b) {
63
- const x = Buffer.from(String(a || ""));
64
- const y = Buffer.from(String(b || ""));
65
- if (x.length === 0 || x.length !== y.length) return false;
66
- try {
67
- return crypto.timingSafeEqual(x, y);
68
- } catch (_) {
69
- return false;
70
- }
71
- }
72
-
73
- function stripeGet(path, secretKey, timeoutMs) {
74
- return new Promise((resolve, reject) => {
75
- const req = https.request(
76
- { method: "GET", hostname: "api.stripe.com", path, headers: { Authorization: "Bearer " + secretKey } },
77
- (res) => {
78
- let d = "";
79
- res.on("data", (c) => (d += c));
80
- res.on("end", () => {
81
- let j = null;
82
- try {
83
- j = d ? JSON.parse(d) : null;
84
- } catch (_) {
85
- j = null;
86
- }
87
- resolve({ status: res.statusCode, json: j });
88
- });
89
- }
90
- );
91
- req.on("error", reject);
92
- req.setTimeout(timeoutMs || 15000, () => req.destroy(new Error("stripe_get_timeout")));
93
- req.end();
94
- });
95
- }
96
-
97
- function stripePost(path, formParams, secretKey, timeoutMs) {
98
- const body = new URLSearchParams(formParams).toString();
99
- return new Promise((resolve, reject) => {
100
- const req = https.request(
101
- {
102
- method: "POST",
103
- hostname: "api.stripe.com",
104
- path,
105
- headers: {
106
- Authorization: "Bearer " + secretKey,
107
- "Content-Type": "application/x-www-form-urlencoded",
108
- "Content-Length": Buffer.byteLength(body)
109
- }
110
- },
111
- (res) => {
112
- let d = "";
113
- res.on("data", (c) => (d += c));
114
- res.on("end", () => {
115
- let j = null;
116
- try {
117
- j = d ? JSON.parse(d) : null;
118
- } catch (_) {
119
- j = null;
120
- }
121
- resolve({ status: res.statusCode, json: j });
122
- });
123
- }
124
- );
125
- req.on("error", reject);
126
- req.setTimeout(timeoutMs || 15000, () => req.destroy(new Error("stripe_post_timeout")));
127
- req.write(body);
128
- req.end();
129
- });
130
- }
131
-
132
- // Create a PaymentIntent for a quote, stamping the binding ref in metadata.
133
- // `intent` = { amountMinor, currency, ref, quoteId }. `postOverride` lets tests
134
- // inject a fetcher. Returns { ok, reference, client_secret } | { ok:false, reason, detail? }.
135
- async function createMppPaymentIntent(config, intent, postOverride) {
136
- if (!isConfigured(config)) return { ok: false, reason: "mpp_provider_not_configured" };
137
- if (config.provider !== "stripe") return { ok: false, reason: "unsupported_provider" };
138
- if (!config.secretKey) return { ok: false, reason: "stripe_secret_key_missing" };
139
- const amountMinor = Math.round(Number(intent && intent.amountMinor));
140
- if (!Number.isFinite(amountMinor) || amountMinor <= 0) return { ok: false, reason: "invalid_amount" };
141
- const currency = String((intent && intent.currency) || "usd").toLowerCase();
142
- const params = {
143
- amount: String(amountMinor),
144
- currency: currency === "usd_cents" ? "usd" : currency,
145
- "automatic_payment_methods[enabled]": "true",
146
- "metadata[naxytra_ref]": String((intent && intent.ref) || ""),
147
- "metadata[quote_id]": String((intent && intent.quoteId) || "")
148
- };
149
- const post = typeof postOverride === "function" ? postOverride : (p, f) => stripePost(p, f, config.secretKey, 15000);
150
- let res;
151
- try {
152
- res = await post("/v1/payment_intents", params);
153
- } catch (e) {
154
- return { ok: false, reason: "stripe_unreachable", detail: e && e.message ? e.message : "request_error" };
155
- }
156
- if (!res.json || res.status >= 400) {
157
- return { ok: false, reason: "stripe_payment_intent_create_failed", detail: (res.json && res.json.error && res.json.error.message) || `HTTP ${res.status}` };
158
- }
159
- return { ok: true, reference: res.json.id, client_secret: res.json.client_secret };
160
- }
161
-
162
- // Parse "SPT <stripe_reference>" (pi_... or cs_...). Returns { reference } | null.
163
- function parseMppHeader(authorization) {
164
- const m = String(authorization || "").match(/^SPT\s+((?:pi|cs)_[A-Za-z0-9_]+)\s*$/);
165
- return m ? { reference: m[1] } : null;
166
- }
167
-
168
- // Verify a Stripe reference is paid and covers requiredAmountMinor.
169
- // `getOverride` lets tests inject a fetcher. Returns
170
- // { ok, reference, amount_minor, currency, status } | { ok:false, reason, detail? }.
171
- async function verifyMppPayment(config, reference, requiredAmountMinor, getOverride, options) {
172
- if (!isConfigured(config)) return { ok: false, reason: "mpp_provider_not_configured" };
173
- if (config.provider === "stripe") {
174
- if (!config.secretKey) return { ok: false, reason: "stripe_secret_key_missing" };
175
- const ref = String(reference || "");
176
- const path = ref.startsWith("pi_") ? "/v1/payment_intents/" + ref : ref.startsWith("cs_") ? "/v1/checkout/sessions/" + ref : null;
177
- if (!path) return { ok: false, reason: "mpp_reference_invalid" };
178
- const get = typeof getOverride === "function" ? getOverride : (p) => stripeGet(p, config.secretKey, 15000);
179
- let res;
180
- try {
181
- res = await get(path);
182
- } catch (e) {
183
- return { ok: false, reason: "stripe_unreachable", detail: e && e.message ? e.message : "request_error" };
184
- }
185
- if (!res.json || res.status >= 400) {
186
- return { ok: false, reason: "stripe_reference_not_found", detail: (res.json && res.json.error && res.json.error.message) || `HTTP ${res.status}` };
187
- }
188
- const obj = res.json;
189
- const paid = ref.startsWith("pi_") ? obj.status === "succeeded" : obj.payment_status === "paid";
190
- if (!paid) return { ok: false, reason: "mpp_not_paid", detail: obj.status || obj.payment_status || "unknown" };
191
- const amount = Number(ref.startsWith("pi_") ? obj.amount_received || obj.amount : obj.amount_total);
192
- const required = Number(requiredAmountMinor);
193
- // Never authorize for free: a known, positive required amount is mandatory.
194
- if (!Number.isFinite(required) || required <= 0) {
195
- return { ok: false, reason: "mpp_required_amount_unknown" };
196
- }
197
- if (!Number.isFinite(amount) || amount < required) {
198
- return { ok: false, reason: "mpp_amount_insufficient", detail: `${amount}/${required}` };
199
- }
200
- // The runtime prices in USD minor units; reject a payment in another currency
201
- // (e.g. a high nominal amount in a zero-decimal currency) that would not match.
202
- const currency = String(obj.currency || "").toLowerCase();
203
- if (currency && currency !== "usd") {
204
- return { ok: false, reason: "mpp_currency_mismatch", detail: currency };
205
- }
206
- // Request binding: when the caller expects a server-issued ref (it always
207
- // does in production), the paid object must carry the matching
208
- // metadata.naxytra_ref, proving it was created for THIS quote.
209
- const expectedRef = options && options.expectedRef;
210
- if (expectedRef) {
211
- const presented = obj.metadata && obj.metadata.naxytra_ref;
212
- if (!presented) return { ok: false, reason: "mpp_binding_ref_missing" };
213
- if (!refEquals(presented, expectedRef)) return { ok: false, reason: "mpp_binding_ref_mismatch" };
214
- }
215
- return { ok: true, reference: ref, amount_minor: amount, currency: (obj.currency || "usd").toUpperCase(), status: "paid" };
216
- }
217
- return { ok: false, reason: "unsupported_provider" };
218
- }
219
-
220
- function buildMppChallenge(quote) {
221
- return {
222
- provider: "stripe",
223
- amount_minor: quote && quote.amount_minor,
224
- currency: quote && quote.currency,
225
- instructions: "Create a Stripe PaymentIntent (or Checkout Session) for the quoted amount, then retry with 'Authorization: SPT <pi_... | cs_...>'."
226
- };
227
- }
228
-
229
- module.exports = {
230
- loadMppConfig,
231
- isConfigured,
232
- parseMppHeader,
233
- verifyMppPayment,
234
- buildMppChallenge,
235
- createMppPaymentIntent,
236
- computeBindingRef
237
- };
@@ -1,110 +0,0 @@
1
- "use strict";
2
-
3
- const dns = require("dns");
4
- let Agent = null;
5
- try {
6
- ({ Agent } = require("undici"));
7
- } catch (_) {
8
- Agent = null;
9
- }
10
-
11
- const dispatcherCache = new Map();
12
- let configuredDnsResultOrder = null;
13
-
14
- function normalizeString(value, fallback = "") {
15
- const raw = typeof value === "string" ? value.trim() : "";
16
- return raw || fallback;
17
- }
18
-
19
- function normalizeFamily(value) {
20
- const normalized = normalizeString(value).toLowerCase();
21
- if (!normalized || normalized === "auto" || normalized === "any" || normalized === "0") return null;
22
- if (normalized === "4" || normalized === "ipv4") return 4;
23
- if (normalized === "6" || normalized === "ipv6") return 6;
24
- return null;
25
- }
26
-
27
- function normalizeDnsResultOrder(value) {
28
- const normalized = normalizeString(value).toLowerCase();
29
- if (!normalized) return "verbatim";
30
- if (normalized === "ipv4first" || normalized === "ipv6first" || normalized === "verbatim") return normalized;
31
- return "verbatim";
32
- }
33
-
34
- function loadNetworkTransportConfig() {
35
- const globalFamily = normalizeFamily(process.env.XYTARA_NETWORK_PREFERRED_IP_FAMILY);
36
- const dnsResultOrder = normalizeDnsResultOrder(process.env.XYTARA_NETWORK_DNS_RESULT_ORDER);
37
- return {
38
- dns_result_order: dnsResultOrder,
39
- global_family: globalFamily,
40
- external_execution_family: normalizeFamily(process.env.XYTARA_EXTERNAL_EXECUTION_IP_FAMILY) || globalFamily,
41
- callback_family: normalizeFamily(process.env.XYTARA_CALLBACK_IP_FAMILY) || globalFamily,
42
- settlement_family: normalizeFamily(process.env.XYTARA_SETTLEMENT_IP_FAMILY) || globalFamily
43
- };
44
- }
45
-
46
- function ensureDnsResultOrderConfigured(config) {
47
- const effective = config && config.dns_result_order ? config.dns_result_order : "verbatim";
48
- if (configuredDnsResultOrder === effective) return;
49
- dns.setDefaultResultOrder(effective);
50
- configuredDnsResultOrder = effective;
51
- }
52
-
53
- function getDispatcherForFamily(family) {
54
- if (!Agent) return null;
55
- if (!family) return null;
56
- const key = String(family);
57
- if (dispatcherCache.has(key)) return dispatcherCache.get(key);
58
- const dispatcher = new Agent({
59
- connect: {
60
- family
61
- }
62
- });
63
- dispatcherCache.set(key, dispatcher);
64
- return dispatcher;
65
- }
66
-
67
- function buildFetchOptionsForPurpose(purpose, baseOptions = {}) {
68
- const config = loadNetworkTransportConfig();
69
- ensureDnsResultOrderConfigured(config);
70
- const purposeKey = normalizeString(purpose, "external_execution");
71
- const family = purposeKey === "callback"
72
- ? config.callback_family
73
- : purposeKey === "settlement"
74
- ? config.settlement_family
75
- : config.external_execution_family;
76
- const dispatcher = getDispatcherForFamily(family);
77
- return dispatcher
78
- ? { ...baseOptions, dispatcher }
79
- : { ...baseOptions };
80
- }
81
-
82
- function buildNetworkTransportSummary() {
83
- const config = loadNetworkTransportConfig();
84
- ensureDnsResultOrderConfigured(config);
85
- const classify = (family) => family === 4 ? "ipv4" : family === 6 ? "ipv6" : "auto";
86
- return {
87
- ok: true,
88
- category: "machine-commerce-network-transport-summary",
89
- summary_version: "xytara-network-transport-summary-v1",
90
- dns_result_order: config.dns_result_order,
91
- preferred_families: {
92
- global: classify(config.global_family),
93
- external_execution: classify(config.external_execution_family),
94
- callback_delivery: classify(config.callback_family),
95
- settlement_transport: classify(config.settlement_family)
96
- },
97
- posture: "dual-stack_capable_with_operator-selectable_ip_family_preferences",
98
- linked_surfaces: {
99
- external_execution_ref: "/v1/capability-registry/execution-truth",
100
- callback_security_ref: "/v1/checkout/events/security",
101
- settlement_readiness_ref: "/v1/settlement/bsv-teranode/readiness"
102
- }
103
- };
104
- }
105
-
106
- module.exports = {
107
- buildFetchOptionsForPurpose,
108
- buildNetworkTransportSummary,
109
- loadNetworkTransportConfig
110
- };
@@ -1,155 +0,0 @@
1
- "use strict";
2
-
3
- const packageJson = require("../package.json");
4
-
5
- function buildOfflineVerifiabilityRecoveryContractPack() {
6
- return {
7
- ok: true,
8
- product: packageJson.name,
9
- category: "naxytra-offline-verifiability-recovery-contract",
10
- pack_version: "naxytra-offline-verifiability-recovery-contract-v1",
11
- doctrine: "xytara_keeps_verifiability_and_restore_posture_explicit_under_degraded_or_offline_conditions",
12
- model_state: "core_now",
13
- core_claim: "offline mode remains a bounded operational mode with explicit verification restore and evidence lineage rules",
14
- offline_states: [
15
- { state: "online", description: "normal live operation" },
16
- { state: "degraded", description: "limited live capability but still operational" },
17
- { state: "offline_verify_only", description: "local evidence verification without live provider dependence" },
18
- { state: "restore_pending", description: "durable data is being restored or validated" },
19
- { state: "restored", description: "state has been restored and revalidated" }
20
- ],
21
- verifiable_offline_inputs: [
22
- "operational_receipts",
23
- "proof_bundles",
24
- "registry_records",
25
- "identity_or_authority_bindings",
26
- "release_and_provenance_artifacts",
27
- "checksum_or_hash_manifests"
28
- ],
29
- recovery_inputs: [
30
- "receipts",
31
- "proof_bundles",
32
- "registry_snapshots",
33
- "operator_notes_where_required",
34
- "release_evidence",
35
- "backup_manifests"
36
- ],
37
- recovery_rules: [
38
- "backups_must_be_versioned",
39
- "restore_targets_must_be_explicit",
40
- "restore_actions_must_be_replayable_or_at_least_auditable",
41
- "restored_state_must_preserve_evidence_lineage",
42
- "restore_procedures_must_not_silently_rewrite_the_canonical_record"
43
- ],
44
- offline_verification_rules: [
45
- "local_verification_must_not_depend_on_live_provider_truth_for_the_base_evidence_record",
46
- "imported_evidence_must_keep_its_source_boundary_explicit",
47
- "cryptographic_checks_must_be_deterministic",
48
- "if_an_external_claim_cannot_be_verified_locally_that_limitation_must_be_recorded"
49
- ],
50
- canonical_objects: [
51
- {
52
- object_id: "offline_verification_record",
53
- role: "local_verification_or_restore_state_record",
54
- required_fields: [
55
- "version",
56
- "state",
57
- "record_id",
58
- "created_at_iso",
59
- "actor_id",
60
- "evidence_refs"
61
- ],
62
- recommended_fields: [
63
- "backup_ref",
64
- "restore_ref",
65
- "proof_ref",
66
- "registry_snapshot_ref",
67
- "hash_manifest_ref"
68
- ],
69
- optional_fields: [
70
- "limitation_notes",
71
- "metadata"
72
- ],
73
- primary_surfaces: [
74
- "/v1/security-reliability-drills",
75
- "/v1/security-reliability-drills/summary",
76
- "/v1/provenance",
77
- "/v1/provenance/summary",
78
- "/v1/telemetry"
79
- ]
80
- }
81
- ],
82
- lineage_model: [
83
- {
84
- layer_id: "offline_verification",
85
- order_index: 1,
86
- objects: ["offline_verification_record"],
87
- invariants: [
88
- "local_verification_can_run_without_live_provider_truth",
89
- "evidence_boundary_remains_explicit"
90
- ]
91
- },
92
- {
93
- layer_id: "restore_and_replay",
94
- order_index: 2,
95
- objects: ["offline_verification_record"],
96
- invariants: [
97
- "restores_preserve_lineage",
98
- "restore_state_is_auditable"
99
- ]
100
- },
101
- {
102
- layer_id: "post_restore_followthrough",
103
- order_index: 3,
104
- objects: ["offline_verification_record"],
105
- invariants: [
106
- "restored_state_can_rejoin_live_operation_after_revalidation",
107
- "offline_verification_does_not_redefine_core_truth"
108
- ]
109
- }
110
- ],
111
- invariants: [
112
- "offline_mode_is_bounded",
113
- "restore_events_are_evidence_events",
114
- "local_verification_does_not_require_live_provider_truth_for_base_evidence",
115
- "restore_procedures_preserve_lineage",
116
- "offline_verification_is_a_control_plane_mode_not_a_new_proof_standard"
117
- ],
118
- linked_surfaces: {
119
- drills_ref: "/v1/security-reliability-drills",
120
- drills_summary_ref: "/v1/security-reliability-drills/summary",
121
- provenance_ref: "/v1/provenance",
122
- telemetry_ref: "/v1/telemetry",
123
- release_verification_receipt_ref: "/v1/release-verification-receipt"
124
- },
125
- claim_boundary: "claim_the_offline_verification_and_recovery_posture_only_without_claiming_live_provider_truth_or_universal_availability"
126
- };
127
- }
128
-
129
- function summarizeOfflineVerifiabilityRecoveryContractPack() {
130
- const pack = buildOfflineVerifiabilityRecoveryContractPack();
131
- return {
132
- ok: true,
133
- product: pack.product,
134
- category: pack.category,
135
- summary_version: "naxytra-offline-verifiability-recovery-contract-summary-v1",
136
- pack_version: pack.pack_version,
137
- model_state: pack.model_state,
138
- offline_state_count: pack.offline_states.length,
139
- offline_input_count: pack.verifiable_offline_inputs.length,
140
- recovery_input_count: pack.recovery_inputs.length,
141
- rule_count: pack.recovery_rules.length,
142
- linked_surfaces: pack.linked_surfaces
143
- };
144
- }
145
-
146
- function getOfflineStateDetail(state) {
147
- const normalized = String(state || "").trim().toLowerCase();
148
- return (buildOfflineVerifiabilityRecoveryContractPack().offline_states || []).find((entry) => entry.state === normalized) || null;
149
- }
150
-
151
- module.exports = {
152
- buildOfflineVerifiabilityRecoveryContractPack,
153
- summarizeOfflineVerifiabilityRecoveryContractPack,
154
- getOfflineStateDetail
155
- };