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.
- package/README.md +120 -92
- package/RELEASE_NOTES.md +7 -3
- package/START_HERE.md +56 -224
- package/bin/xytara.js +21 -8
- package/client.js +79 -1
- package/lib/{delivery_receipt.js → delivery_receipt_verify.js} +14 -100
- package/package.json +25 -35
- package/scripts/verify_client.js +418 -0
- package/scripts/verify_release_candidate.js +146 -45
- package/.env.example +0 -173
- package/ADAPTER_START_HERE.md +0 -56
- package/BSV_TERANODE_PLATFORM_DISCONTINUITY_RUNBOOK.md +0 -126
- package/CARRIED_HANDOFF_DEMO.md +0 -60
- package/EXAMPLE_PATHS.md +0 -53
- package/FINAL_CONTRACT.md +0 -498
- package/PARTNER_READY_PATH.md +0 -71
- package/PUBLIC_DEMO_SCRIPT.md +0 -78
- package/REAL_PAYMENT_SETUP.md +0 -320
- package/SERVICE_CONTRACT.md +0 -419
- package/SUPABASE_RUNTIME_STATE_SETUP.md +0 -61
- package/TERMINOLOGY.md +0 -50
- package/WHY_XYTARA_XOONYA.md +0 -63
- package/XT1_EXECUTION_TRUTH_STANDARD.md +0 -78
- package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +0 -75
- package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +0 -124
- package/XYTARA_DEFAULT_PATH_MODEL.md +0 -84
- package/XYTARA_EXECUTION_TRUTH_MODEL.md +0 -171
- package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +0 -68
- package/adapters/AUTHORING_GUIDE.md +0 -244
- package/adapters/ONBOARDING_POSTURE.md +0 -61
- package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +0 -84
- package/adapters/adapter-manifest.schema.json +0 -283
- package/adapters/examples/example-execution-adapter.js +0 -61
- package/adapters/examples/example-execution-adapter.manifest.json +0 -81
- package/adapters/examples/example-settlement-adapter.js +0 -55
- package/adapters/examples/example-settlement-adapter.manifest.json +0 -78
- package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +0 -121
- package/adapters/examples/example-third-party-identity-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-identity-registration.record.json +0 -26
- package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +0 -120
- package/adapters/examples/example-third-party-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-registration.record.json +0 -28
- package/adapters/examples/example-third-party-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-settlement-registration.record.json +0 -26
- package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +0 -127
- package/adapters/examples/langchain-reference-execution-adapter.js +0 -81
- package/adapters/examples/langchain-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/langgraph-reference-execution-adapter.js +0 -81
- package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-adapter.js +0 -61
- package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-registration.record.json +0 -26
- package/adapters/examples/minimal-third-party-execution.certification-pack.json +0 -22
- package/adapters/examples/minimal-third-party-execution.submission-bundle.json +0 -126
- package/adapters/integration-certification-pack.schema.json +0 -82
- package/adapters/integration-registration-record.schema.json +0 -114
- package/adapters/integration-submission-bundle-set.schema.json +0 -39
- package/adapters/integration-submission-bundle.schema.json +0 -34
- package/adapters/interfaces.js +0 -56
- package/bin/xytara-release.js +0 -1429
- package/examples/_demo_env.js +0 -40
- package/examples/adapter_review_walkthrough.js +0 -54
- package/examples/export_carried_handoff.js +0 -81
- package/examples/funded_runtime_walkthrough.js +0 -71
- package/examples/partner_launch_walkthrough.js +0 -44
- package/examples/quickstart.js +0 -3256
- package/fixtures/catalog.js +0 -1156
- package/index.js +0 -395
- package/integrations/dispatch.js +0 -276
- package/integrations/registry-snapshot.schema.json +0 -36
- package/integrations/registry.js +0 -2261
- package/integrations/views.js +0 -28
- package/lib/a2a_lane_contract.js +0 -104
- package/lib/a2a_rpc.js +0 -287
- package/lib/a2c_lane_contract.js +0 -111
- package/lib/account_auth.js +0 -585
- package/lib/acp_lane_contract.js +0 -54
- package/lib/activity_audit_contract.js +0 -322
- package/lib/adapter_certification_contract.js +0 -130
- package/lib/adapter_depth_contract.js +0 -218
- package/lib/adapter_pack.js +0 -118
- package/lib/adapter_partner_pack.js +0 -89
- package/lib/adapter_promotion_pack.js +0 -89
- package/lib/adapter_protocol_truth_contract.js +0 -229
- package/lib/agent_identity.js +0 -162
- package/lib/announcement_pack.js +0 -61
- package/lib/artifact_distribution_lane_contract.js +0 -54
- package/lib/asyncapi_contract.js +0 -150
- package/lib/auth_interop_contract.js +0 -80
- package/lib/authority_binding_lifecycle_contract.js +0 -182
- package/lib/autonomous_entry_contract.js +0 -409
- package/lib/bolt_adapter.js +0 -187
- package/lib/bolt_lane_contract.js +0 -55
- package/lib/bolt_payment_front.js +0 -224
- package/lib/business_cockpit.js +0 -378
- package/lib/buyer_event_log.js +0 -230
- package/lib/buyer_safety_policy.js +0 -132
- package/lib/capability_execution_truth.js +0 -276
- package/lib/capability_registry.js +0 -633
- package/lib/catalog_contract.js +0 -966
- package/lib/catalog_family_model.js +0 -193
- package/lib/catalog_views.js +0 -55
- package/lib/cdp_jwt.js +0 -57
- package/lib/checkout_event_security.js +0 -142
- package/lib/checkout_processor_adapter.js +0 -217
- package/lib/cloudevents_contract.js +0 -80
- package/lib/command_flow.js +0 -911
- package/lib/commerce_artifacts.js +0 -591
- package/lib/commerce_authority.js +0 -449
- package/lib/commerce_bridge.js +0 -274
- package/lib/commerce_cases.js +0 -399
- package/lib/commerce_checkout.js +0 -509
- package/lib/commerce_coordination.js +0 -346
- package/lib/commerce_economics.js +0 -4017
- package/lib/commerce_identity.js +0 -578
- package/lib/commerce_quotes.js +0 -266
- package/lib/commerce_reports.js +0 -14461
- package/lib/commerce_runtime.js +0 -322
- package/lib/commerce_shell.js +0 -257
- package/lib/crypto_agility_matrix.js +0 -125
- package/lib/default_path_contract.js +0 -412
- package/lib/delivery_summary_contract.js +0 -95
- package/lib/ecosystem_entry.js +0 -64
- package/lib/erc8004_lane_contract.js +0 -65
- package/lib/event_system_lane_contract.js +0 -75
- package/lib/execution_dedupe.js +0 -86
- package/lib/execution_truth_contract.js +0 -234
- package/lib/external_credit_bridge.js +0 -142
- package/lib/external_execution_policy.js +0 -143
- package/lib/external_execution_runtime.js +0 -238
- package/lib/feature_control_lane_contract.js +0 -54
- package/lib/first_run_conversion_contract.js +0 -290
- package/lib/framework_lane_contract.js +0 -89
- package/lib/framework_provider_promotion.js +0 -235
- package/lib/full_catalog_contract.js +0 -525
- package/lib/go_live_operator_pack.js +0 -391
- package/lib/http_transport.js +0 -99
- package/lib/identity_auth.js +0 -175
- package/lib/identity_interop_contract.js +0 -82
- package/lib/integration_matrix_contract.js +0 -102
- package/lib/l402_adapter.js +0 -241
- package/lib/l402_lane_contract.js +0 -55
- package/lib/l402_payment_front.js +0 -265
- package/lib/launch_narrative.js +0 -53
- package/lib/lifecycle_continuity_contract.js +0 -115
- package/lib/machine_identity_registry_contract.js +0 -199
- package/lib/major_rails_lane_contract.js +0 -150
- package/lib/market_lane_contract.js +0 -467
- package/lib/market_lane_depth_contract.js +0 -182
- package/lib/market_lane_promotion_contract.js +0 -210
- package/lib/market_lane_trace_contract.js +0 -278
- package/lib/mcp_lane_contract.js +0 -137
- package/lib/mpp_adapter.js +0 -237
- package/lib/network_transport.js +0 -110
- package/lib/offline_verifiability_recovery_contract.js +0 -155
- package/lib/openapi_contract.js +0 -300
- package/lib/operational_receipt_contract.js +0 -165
- package/lib/operator_intelligence.js +0 -407
- package/lib/outreach_copy_pack.js +0 -51
- package/lib/outreach_message_pack.js +0 -71
- package/lib/outreach_proof.js +0 -71
- package/lib/outreach_target_pack.js +0 -60
- package/lib/partner_intelligence.js +0 -105
- package/lib/payment_config.js +0 -257
- package/lib/payment_front_registry.js +0 -53
- package/lib/payment_protocol_contract.js +0 -165
- package/lib/payment_rail_truth_contract.js +0 -324
- package/lib/payment_verification.js +0 -357
- package/lib/phase_10_closeout_pack.js +0 -45
- package/lib/phase_10_completion_pack.js +0 -76
- package/lib/phase_10_decision_record_pack.js +0 -54
- package/lib/phase_10_decision_resolution_pack.js +0 -53
- package/lib/phase_10_demand_signal_adapters_runtime_pack.js +0 -74
- package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +0 -74
- package/lib/phase_10_freeze_baseline_pack.js +0 -67
- package/lib/phase_10_freeze_review_pack.js +0 -64
- package/lib/phase_10_gate_pack.js +0 -57
- package/lib/phase_10_long_tail_continuity_pack.js +0 -80
- package/lib/phase_10_long_tail_ecosystem_pack.js +0 -66
- package/lib/phase_10_niche_extension_registry_runtime_pack.js +0 -74
- package/lib/phase_1_claude_mcp_pack.js +0 -60
- package/lib/phase_1_claude_mcp_runtime_pack.js +0 -52
- package/lib/phase_1_ecosystem_pack.js +0 -67
- package/lib/phase_1_openai_codex_pack.js +0 -60
- package/lib/phase_1_openai_codex_runtime_pack.js +0 -52
- package/lib/phase_2_base_runtime_pack.js +0 -71
- package/lib/phase_2_base_usdc_runtime_pack.js +0 -72
- package/lib/phase_2_closeout_pack.js +0 -65
- package/lib/phase_2_completion_pack.js +0 -113
- package/lib/phase_2_decision_record_pack.js +0 -66
- package/lib/phase_2_decision_resolution_pack.js +0 -69
- package/lib/phase_2_eth_runtime_pack.js +0 -70
- package/lib/phase_2_evm_base_runtime_pack.js +0 -73
- package/lib/phase_2_evm_runtime_pack.js +0 -71
- package/lib/phase_2_flip_preview_pack.js +0 -60
- package/lib/phase_2_freeze_review_pack.js +0 -99
- package/lib/phase_2_gate_pack.js +0 -77
- package/lib/phase_2_payment_rails_pack.js +0 -71
- package/lib/phase_2_usdc_runtime_pack.js +0 -71
- package/lib/phase_3_brc_runtime_pack.js +0 -81
- package/lib/phase_3_bsv_teranode_runtime_pack.js +0 -83
- package/lib/phase_3_closeout_pack.js +0 -62
- package/lib/phase_3_completion_pack.js +0 -94
- package/lib/phase_3_decision_record_pack.js +0 -64
- package/lib/phase_3_decision_resolution_pack.js +0 -69
- package/lib/phase_3_freeze_baseline_pack.js +0 -67
- package/lib/phase_3_freeze_review_pack.js +0 -80
- package/lib/phase_3_gate_pack.js +0 -76
- package/lib/phase_3_metanet_runtime_pack.js +0 -81
- package/lib/phase_3_native_bsv_pack.js +0 -91
- package/lib/phase_3_native_continuity_pack.js +0 -82
- package/lib/phase_4_attestation_runtime_pack.js +0 -75
- package/lib/phase_4_closeout_pack.js +0 -45
- package/lib/phase_4_completion_pack.js +0 -94
- package/lib/phase_4_decision_record_pack.js +0 -54
- package/lib/phase_4_decision_resolution_pack.js +0 -45
- package/lib/phase_4_erc8004_runtime_pack.js +0 -76
- package/lib/phase_4_freeze_baseline_pack.js +0 -67
- package/lib/phase_4_freeze_review_pack.js +0 -68
- package/lib/phase_4_gate_pack.js +0 -58
- package/lib/phase_4_identity_registry_runtime_pack.js +0 -75
- package/lib/phase_4_identity_trust_pack.js +0 -73
- package/lib/phase_4_trust_continuity_pack.js +0 -86
- package/lib/phase_5_antelope_runtime_pack.js +0 -76
- package/lib/phase_5_closeout_pack.js +0 -44
- package/lib/phase_5_completion_pack.js +0 -82
- package/lib/phase_5_constellation_dag_runtime_pack.js +0 -76
- package/lib/phase_5_decision_record_pack.js +0 -54
- package/lib/phase_5_decision_resolution_pack.js +0 -45
- package/lib/phase_5_digibyte_dgb_runtime_pack.js +0 -76
- package/lib/phase_5_freeze_baseline_pack.js +0 -67
- package/lib/phase_5_freeze_review_pack.js +0 -68
- package/lib/phase_5_gate_pack.js +0 -58
- package/lib/phase_5_hedera_hbar_runtime_pack.js +0 -76
- package/lib/phase_5_kaspa_kas_runtime_pack.js +0 -76
- package/lib/phase_5_major_rails_continuity_pack.js +0 -86
- package/lib/phase_5_major_rails_pack.js +0 -110
- package/lib/phase_5_metal_runtime_pack.js +0 -76
- package/lib/phase_5_polkadot_dot_runtime_pack.js +0 -76
- package/lib/phase_5_proton_xpr_runtime_pack.js +0 -76
- package/lib/phase_5_solana_runtime_pack.js +0 -76
- package/lib/phase_6_autogen_runtime_pack.js +0 -72
- package/lib/phase_6_closeout_pack.js +0 -46
- package/lib/phase_6_completion_pack.js +0 -77
- package/lib/phase_6_decision_record_pack.js +0 -54
- package/lib/phase_6_decision_resolution_pack.js +0 -53
- package/lib/phase_6_framework_continuity_pack.js +0 -81
- package/lib/phase_6_framework_runtime_pack.js +0 -68
- package/lib/phase_6_freeze_baseline_pack.js +0 -68
- package/lib/phase_6_freeze_review_pack.js +0 -65
- package/lib/phase_6_gate_pack.js +0 -59
- package/lib/phase_6_langchain_runtime_pack.js +0 -72
- package/lib/phase_6_langgraph_runtime_pack.js +0 -72
- package/lib/phase_6_semantic_kernel_runtime_pack.js +0 -72
- package/lib/phase_7_closeout_pack.js +0 -45
- package/lib/phase_7_completion_pack.js +0 -85
- package/lib/phase_7_decision_record_pack.js +0 -53
- package/lib/phase_7_decision_resolution_pack.js +0 -53
- package/lib/phase_7_event_system_continuity_pack.js +0 -89
- package/lib/phase_7_event_system_pack.js +0 -76
- package/lib/phase_7_freeze_baseline_pack.js +0 -74
- package/lib/phase_7_freeze_review_pack.js +0 -65
- package/lib/phase_7_gate_pack.js +0 -58
- package/lib/phase_7_kafka_runtime_pack.js +0 -74
- package/lib/phase_7_mqtt_runtime_pack.js +0 -74
- package/lib/phase_7_nats_runtime_pack.js +0 -74
- package/lib/phase_7_webhook_event_bus_runtime_pack.js +0 -74
- package/lib/phase_8_closeout_pack.js +0 -46
- package/lib/phase_8_completion_pack.js +0 -82
- package/lib/phase_8_decision_record_pack.js +0 -54
- package/lib/phase_8_decision_resolution_pack.js +0 -53
- package/lib/phase_8_external_receipt_import_runtime_pack.js +0 -74
- package/lib/phase_8_external_result_import_runtime_pack.js +0 -74
- package/lib/phase_8_freeze_baseline_pack.js +0 -71
- package/lib/phase_8_freeze_review_pack.js +0 -64
- package/lib/phase_8_gate_pack.js +0 -58
- package/lib/phase_8_proof_bridge_continuity_pack.js +0 -86
- package/lib/phase_8_proof_bridges_pack.js +0 -72
- package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +0 -74
- package/lib/phase_9_closeout_pack.js +0 -46
- package/lib/phase_9_completion_pack.js +0 -82
- package/lib/phase_9_custody_refs_runtime_pack.js +0 -74
- package/lib/phase_9_decision_record_pack.js +0 -54
- package/lib/phase_9_decision_resolution_pack.js +0 -53
- package/lib/phase_9_freeze_baseline_pack.js +0 -71
- package/lib/phase_9_freeze_review_pack.js +0 -64
- package/lib/phase_9_gate_pack.js +0 -58
- package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +0 -74
- package/lib/phase_9_treasury_connectivity_pack.js +0 -72
- package/lib/phase_9_treasury_continuity_pack.js +0 -86
- package/lib/phase_9_treasury_destinations_runtime_pack.js +0 -74
- package/lib/phase_program_pack.js +0 -120
- package/lib/pricing_optimization_contract.js +0 -775
- package/lib/protocol_lane_contract.js +0 -117
- package/lib/provenance_lane_contract.js +0 -54
- package/lib/provider_lane_contract.js +0 -240
- package/lib/provider_network_contract.js +0 -149
- package/lib/provider_payout_execution.js +0 -155
- package/lib/provider_registry.js +0 -852
- package/lib/provider_runtime_journey_contract.js +0 -183
- package/lib/public_surface_policy_contract.js +0 -111
- package/lib/publish_plan.js +0 -51
- package/lib/rate_limiter.js +0 -81
- package/lib/record_queries.js +0 -48
- package/lib/release_candidate.js +0 -50
- package/lib/release_center.js +0 -1093
- package/lib/release_history.js +0 -205
- package/lib/release_manifest.js +0 -113
- package/lib/release_pack.js +0 -453
- package/lib/request_rate_limit.js +0 -144
- package/lib/resource_views.js +0 -31
- package/lib/revenue_launch_path_contract.js +0 -326
- package/lib/route_matchers.js +0 -34
- package/lib/route_params.js +0 -19
- package/lib/runtime_bridge.js +0 -124
- package/lib/runtime_operations_worker.js +0 -282
- package/lib/runtime_state_store.js +0 -495
- package/lib/settlement_bsv_live.js +0 -600
- package/lib/settlement_bsv_teranode.js +0 -117
- package/lib/settlement_lane_contract.js +0 -111
- package/lib/shared_signals_lane_contract.js +0 -54
- package/lib/signed_audit_provenance_contract.js +0 -83
- package/lib/soft_launch_pack.js +0 -78
- package/lib/stablecoin_lane_contract.js +0 -76
- package/lib/stripe_mpp_lane_contract.js +0 -96
- package/lib/stripe_mpp_payment_front.js +0 -258
- package/lib/telemetry_lane_contract.js +0 -54
- package/lib/treasury_destinations_contract.js +0 -764
- package/lib/treasury_egress_policy_contract.js +0 -91
- package/lib/treasury_lane_contract.js +0 -84
- package/lib/trust_portability_boundary_contract.js +0 -72
- package/lib/x402_facilitator.js +0 -198
- package/lib/x402_lane_contract.js +0 -136
- package/lib/x402_settlement_recovery.js +0 -175
- package/scripts/buyer_events_daily_report.js +0 -79
- package/scripts/registry_cli.js +0 -275
- package/scripts/state_backup_offsite.js +0 -196
- package/scripts/verify_a2a_rpc.js +0 -131
- package/scripts/verify_adapters.js +0 -554
- package/scripts/verify_agent_identity.js +0 -153
- package/scripts/verify_all.js +0 -4963
- package/scripts/verify_bolt_adapter.js +0 -128
- package/scripts/verify_buyer_event_log.js +0 -128
- package/scripts/verify_buyer_safety.js +0 -141
- package/scripts/verify_cdp_facilitator.js +0 -110
- package/scripts/verify_checkout_processor.js +0 -109
- package/scripts/verify_commerce_bridge.js +0 -177
- package/scripts/verify_control_plane_contracts.js +0 -34
- package/scripts/verify_control_plane_routes.js +0 -70
- package/scripts/verify_delivery_summary.js +0 -112
- package/scripts/verify_examples.js +0 -19
- package/scripts/verify_execution_dedupe.js +0 -189
- package/scripts/verify_execution_surfacing.js +0 -76
- package/scripts/verify_external_execution_retry.js +0 -140
- package/scripts/verify_final_activation.js +0 -191
- package/scripts/verify_first_run_conversions.js +0 -81
- package/scripts/verify_framework_provider_promotion.js +0 -152
- package/scripts/verify_full_catalog.js +0 -174
- package/scripts/verify_integrations.js +0 -620
- package/scripts/verify_l402_adapter.js +0 -86
- package/scripts/verify_lifecycle_continuity.js +0 -96
- package/scripts/verify_lifecycle_spend_binding.js +0 -88
- package/scripts/verify_market_lane_depth.js +0 -94
- package/scripts/verify_market_lane_promotion.js +0 -103
- package/scripts/verify_market_lane_traces.js +0 -98
- package/scripts/verify_market_lanes.js +0 -102
- package/scripts/verify_mpp_adapter.js +0 -128
- package/scripts/verify_operator_observability_boundary.js +0 -83
- package/scripts/verify_pricing_experiment_plan.js +0 -124
- package/scripts/verify_production_readiness.js +0 -268
- package/scripts/verify_provider_network.js +0 -819
- package/scripts/verify_provider_runtime_breadth.js +0 -109
- package/scripts/verify_provider_runtime_journeys.js +0 -111
- package/scripts/verify_rate_limiter.js +0 -52
- package/scripts/verify_refund_credit.js +0 -106
- package/scripts/verify_revenue_launch_paths.js +0 -105
- package/scripts/verify_runtime_durability.js +0 -52
- package/scripts/verify_runtime_state_guard.js +0 -117
- package/scripts/verify_service.js +0 -15421
- package/scripts/verify_settlement.js +0 -116
- package/scripts/verify_tooling.js +0 -1412
- package/scripts/verify_treasury_public_boundary.js +0 -97
- package/scripts/verify_verify_execute_settle.js +0 -209
- package/scripts/verify_x402_facilitator.js +0 -307
- package/scripts/verify_x402_settlement_recovery.js +0 -153
- package/server.js +0 -12245
package/lib/mcp_lane_contract.js
DELETED
|
@@ -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
|
-
};
|
package/lib/mpp_adapter.js
DELETED
|
@@ -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
|
-
};
|
package/lib/network_transport.js
DELETED
|
@@ -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
|
-
};
|