xytara 3.1.0 → 3.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +67 -58
- package/ADAPTER_START_HERE.md +56 -56
- package/CARRIED_HANDOFF_DEMO.md +60 -60
- package/EXAMPLE_PATHS.md +53 -53
- package/FINAL_CONTRACT.md +498 -498
- package/LICENSE +201 -201
- package/NOTICE +3 -3
- package/PARTNER_READY_PATH.md +71 -71
- package/PUBLIC_DEMO_SCRIPT.md +78 -78
- package/README.md +6 -1
- package/REAL_PAYMENT_SETUP.md +32 -3
- package/RELEASE_NOTES.md +14 -14
- package/SERVICE_CONTRACT.md +419 -419
- package/START_HERE.md +1 -1
- package/SUPABASE_RUNTIME_STATE_SETUP.md +61 -61
- package/TERMINOLOGY.md +50 -50
- package/WHY_XYTARA_XOONYA.md +63 -63
- package/XT1_EXECUTION_TRUTH_STANDARD.md +78 -78
- package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +75 -75
- package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +124 -124
- package/XYTARA_DEFAULT_PATH_MODEL.md +84 -84
- package/XYTARA_EXECUTION_TRUTH_MODEL.md +171 -171
- package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +68 -68
- package/adapters/AUTHORING_GUIDE.md +243 -243
- package/adapters/ONBOARDING_POSTURE.md +61 -61
- package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +84 -84
- package/adapters/adapter-manifest.schema.json +283 -283
- package/adapters/examples/example-execution-adapter.js +61 -61
- package/adapters/examples/example-execution-adapter.manifest.json +81 -81
- package/adapters/examples/example-settlement-adapter.js +55 -55
- package/adapters/examples/example-settlement-adapter.manifest.json +78 -78
- package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +124 -124
- package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +121 -121
- package/adapters/examples/example-third-party-identity-registration.certification-pack.json +22 -22
- package/adapters/examples/example-third-party-identity-registration.record.json +26 -26
- package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +126 -126
- package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +124 -124
- package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +120 -120
- package/adapters/examples/example-third-party-registration.certification-pack.json +22 -22
- package/adapters/examples/example-third-party-registration.record.json +28 -28
- package/adapters/examples/example-third-party-registration.submission-bundle.json +126 -126
- package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +22 -22
- package/adapters/examples/example-third-party-settlement-registration.record.json +26 -26
- package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +127 -127
- package/adapters/examples/langchain-reference-execution-adapter.js +81 -81
- package/adapters/examples/langchain-reference-execution-adapter.manifest.json +79 -79
- package/adapters/examples/langgraph-reference-execution-adapter.js +81 -81
- package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +79 -79
- package/adapters/examples/minimal-third-party-execution-adapter.js +61 -61
- package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +79 -79
- package/adapters/examples/minimal-third-party-execution-registration.record.json +26 -26
- package/adapters/examples/minimal-third-party-execution.certification-pack.json +22 -22
- package/adapters/examples/minimal-third-party-execution.submission-bundle.json +126 -126
- package/adapters/integration-certification-pack.schema.json +82 -82
- package/adapters/integration-registration-record.schema.json +114 -114
- package/adapters/integration-submission-bundle-set.schema.json +39 -39
- package/adapters/integration-submission-bundle.schema.json +34 -34
- package/adapters/interfaces.js +56 -56
- package/bin/xytara-first-run.js +244 -244
- package/bin/xytara-release.js +1429 -1429
- package/bin/xytara-run.js +186 -186
- package/bin/xytara.js +80 -80
- package/client.js +3 -3
- package/examples/_demo_env.js +40 -0
- package/examples/adapter_review_walkthrough.js +54 -53
- package/examples/export_carried_handoff.js +81 -80
- package/examples/funded_runtime_walkthrough.js +71 -70
- package/examples/generated.carried-handoff.json +30 -0
- package/examples/partner_launch_walkthrough.js +44 -43
- package/examples/quickstart.js +3256 -3255
- package/fixtures/catalog.js +1134 -1134
- package/index.js +395 -395
- package/integrations/dispatch.js +276 -276
- package/integrations/registry-snapshot.schema.json +36 -36
- package/integrations/registry.js +2261 -2261
- package/integrations/views.js +28 -28
- package/lib/a2a_lane_contract.js +104 -104
- package/lib/a2c_lane_contract.js +111 -111
- package/lib/account_auth.js +518 -518
- package/lib/acp_lane_contract.js +54 -54
- package/lib/activity_audit_contract.js +322 -322
- package/lib/adapter_certification_contract.js +130 -130
- package/lib/adapter_depth_contract.js +156 -156
- package/lib/adapter_pack.js +118 -118
- package/lib/adapter_partner_pack.js +89 -89
- package/lib/adapter_promotion_pack.js +89 -89
- package/lib/adapter_protocol_truth_contract.js +229 -229
- package/lib/announcement_pack.js +61 -61
- package/lib/artifact_distribution_lane_contract.js +54 -54
- package/lib/asyncapi_contract.js +150 -150
- package/lib/auth_interop_contract.js +80 -80
- package/lib/authority_binding_lifecycle_contract.js +182 -182
- package/lib/autonomous_entry_contract.js +409 -409
- package/lib/bolt_lane_contract.js +55 -55
- package/lib/bolt_payment_front.js +172 -172
- package/lib/business_cockpit.js +378 -378
- package/lib/capability_execution_truth.js +272 -272
- package/lib/capability_registry.js +633 -633
- package/lib/catalog_contract.js +966 -966
- package/lib/catalog_family_model.js +193 -193
- package/lib/catalog_views.js +55 -55
- package/lib/checkout_event_security.js +142 -142
- package/lib/cloudevents_contract.js +80 -80
- package/lib/command_flow.js +411 -406
- package/lib/commerce_artifacts.js +503 -503
- package/lib/commerce_authority.js +449 -449
- package/lib/commerce_cases.js +317 -317
- package/lib/commerce_checkout.js +509 -509
- package/lib/commerce_client.js +7687 -7676
- package/lib/commerce_coordination.js +346 -346
- package/lib/commerce_economics.js +4017 -4016
- package/lib/commerce_identity.js +578 -578
- package/lib/commerce_quotes.js +237 -237
- package/lib/commerce_reports.js +14461 -14461
- package/lib/commerce_runtime.js +315 -315
- package/lib/commerce_shell.js +257 -257
- package/lib/crypto_agility_matrix.js +125 -125
- package/lib/default_path_contract.js +412 -412
- package/lib/delivery_summary_contract.js +95 -95
- package/lib/ecosystem_entry.js +64 -64
- package/lib/erc8004_lane_contract.js +65 -65
- package/lib/event_system_lane_contract.js +75 -75
- package/lib/execution_truth_contract.js +234 -234
- package/lib/external_credit_bridge.js +142 -142
- package/lib/external_execution_runtime.js +132 -132
- package/lib/feature_control_lane_contract.js +54 -54
- package/lib/first_run_conversion_contract.js +290 -290
- package/lib/framework_lane_contract.js +89 -89
- package/lib/framework_provider_promotion.js +235 -235
- package/lib/full_catalog_contract.js +525 -525
- package/lib/go_live_operator_pack.js +391 -391
- package/lib/http_transport.js +73 -73
- package/lib/identity_auth.js +175 -175
- package/lib/identity_interop_contract.js +82 -82
- package/lib/integration_matrix_contract.js +102 -102
- package/lib/l402_lane_contract.js +55 -55
- package/lib/l402_payment_front.js +192 -192
- package/lib/launch_narrative.js +53 -53
- package/lib/lifecycle_continuity_contract.js +115 -115
- package/lib/machine_identity_registry_contract.js +199 -199
- package/lib/major_rails_lane_contract.js +150 -150
- package/lib/market_lane_contract.js +467 -467
- package/lib/market_lane_depth_contract.js +182 -182
- package/lib/market_lane_promotion_contract.js +210 -210
- package/lib/market_lane_trace_contract.js +278 -278
- package/lib/mcp_lane_contract.js +137 -137
- package/lib/network_transport.js +110 -110
- package/lib/offline_verifiability_recovery_contract.js +155 -155
- package/lib/openapi_contract.js +296 -296
- package/lib/operational_receipt_contract.js +165 -165
- package/lib/operator_intelligence.js +407 -407
- package/lib/outreach_copy_pack.js +51 -51
- package/lib/outreach_message_pack.js +71 -71
- package/lib/outreach_proof.js +71 -71
- package/lib/outreach_target_pack.js +60 -60
- package/lib/partner_intelligence.js +105 -105
- package/lib/payment_config.js +239 -191
- package/lib/payment_front_registry.js +53 -53
- package/lib/payment_protocol_contract.js +165 -165
- package/lib/payment_rail_truth_contract.js +324 -324
- package/lib/payment_verification.js +312 -264
- package/lib/phase_10_closeout_pack.js +45 -45
- package/lib/phase_10_completion_pack.js +76 -76
- package/lib/phase_10_decision_record_pack.js +54 -54
- package/lib/phase_10_decision_resolution_pack.js +53 -53
- package/lib/phase_10_demand_signal_adapters_runtime_pack.js +74 -74
- package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +74 -74
- package/lib/phase_10_freeze_baseline_pack.js +67 -67
- package/lib/phase_10_freeze_review_pack.js +64 -64
- package/lib/phase_10_gate_pack.js +57 -57
- package/lib/phase_10_long_tail_continuity_pack.js +80 -80
- package/lib/phase_10_long_tail_ecosystem_pack.js +66 -66
- package/lib/phase_10_niche_extension_registry_runtime_pack.js +74 -74
- package/lib/phase_1_claude_mcp_pack.js +60 -60
- package/lib/phase_1_claude_mcp_runtime_pack.js +52 -52
- package/lib/phase_1_ecosystem_pack.js +67 -67
- package/lib/phase_1_openai_codex_pack.js +60 -60
- package/lib/phase_1_openai_codex_runtime_pack.js +52 -52
- package/lib/phase_2_base_runtime_pack.js +71 -71
- package/lib/phase_2_base_usdc_runtime_pack.js +72 -72
- package/lib/phase_2_closeout_pack.js +65 -65
- package/lib/phase_2_completion_pack.js +113 -113
- package/lib/phase_2_decision_record_pack.js +66 -66
- package/lib/phase_2_decision_resolution_pack.js +69 -69
- package/lib/phase_2_eth_runtime_pack.js +70 -70
- package/lib/phase_2_evm_base_runtime_pack.js +73 -73
- package/lib/phase_2_evm_runtime_pack.js +71 -71
- package/lib/phase_2_flip_preview_pack.js +60 -60
- package/lib/phase_2_freeze_review_pack.js +99 -99
- package/lib/phase_2_gate_pack.js +77 -77
- package/lib/phase_2_payment_rails_pack.js +71 -71
- package/lib/phase_2_usdc_runtime_pack.js +71 -71
- package/lib/phase_3_brc_runtime_pack.js +81 -81
- package/lib/phase_3_bsv_teranode_runtime_pack.js +83 -83
- package/lib/phase_3_closeout_pack.js +62 -62
- package/lib/phase_3_completion_pack.js +94 -94
- package/lib/phase_3_decision_record_pack.js +64 -64
- package/lib/phase_3_decision_resolution_pack.js +69 -69
- package/lib/phase_3_freeze_baseline_pack.js +67 -67
- package/lib/phase_3_freeze_review_pack.js +80 -80
- package/lib/phase_3_gate_pack.js +76 -76
- package/lib/phase_3_metanet_runtime_pack.js +81 -81
- package/lib/phase_3_native_bsv_pack.js +91 -91
- package/lib/phase_3_native_continuity_pack.js +82 -82
- package/lib/phase_4_attestation_runtime_pack.js +75 -75
- package/lib/phase_4_closeout_pack.js +45 -45
- package/lib/phase_4_completion_pack.js +94 -94
- package/lib/phase_4_decision_record_pack.js +54 -54
- package/lib/phase_4_decision_resolution_pack.js +45 -45
- package/lib/phase_4_erc8004_runtime_pack.js +76 -76
- package/lib/phase_4_freeze_baseline_pack.js +67 -67
- package/lib/phase_4_freeze_review_pack.js +68 -68
- package/lib/phase_4_gate_pack.js +58 -58
- package/lib/phase_4_identity_registry_runtime_pack.js +75 -75
- package/lib/phase_4_identity_trust_pack.js +73 -73
- package/lib/phase_4_trust_continuity_pack.js +86 -86
- package/lib/phase_5_antelope_runtime_pack.js +76 -76
- package/lib/phase_5_closeout_pack.js +44 -44
- package/lib/phase_5_completion_pack.js +82 -82
- package/lib/phase_5_constellation_dag_runtime_pack.js +76 -76
- package/lib/phase_5_decision_record_pack.js +54 -54
- package/lib/phase_5_decision_resolution_pack.js +45 -45
- package/lib/phase_5_digibyte_dgb_runtime_pack.js +76 -76
- package/lib/phase_5_freeze_baseline_pack.js +67 -67
- package/lib/phase_5_freeze_review_pack.js +68 -68
- package/lib/phase_5_gate_pack.js +58 -58
- package/lib/phase_5_hedera_hbar_runtime_pack.js +76 -76
- package/lib/phase_5_kaspa_kas_runtime_pack.js +76 -76
- package/lib/phase_5_major_rails_continuity_pack.js +86 -86
- package/lib/phase_5_major_rails_pack.js +110 -110
- package/lib/phase_5_metal_runtime_pack.js +76 -76
- package/lib/phase_5_polkadot_dot_runtime_pack.js +76 -76
- package/lib/phase_5_proton_xpr_runtime_pack.js +76 -76
- package/lib/phase_5_solana_runtime_pack.js +76 -76
- package/lib/phase_6_autogen_runtime_pack.js +72 -72
- package/lib/phase_6_closeout_pack.js +46 -46
- package/lib/phase_6_completion_pack.js +77 -77
- package/lib/phase_6_decision_record_pack.js +54 -54
- package/lib/phase_6_decision_resolution_pack.js +53 -53
- package/lib/phase_6_framework_continuity_pack.js +81 -81
- package/lib/phase_6_framework_runtime_pack.js +68 -68
- package/lib/phase_6_freeze_baseline_pack.js +68 -68
- package/lib/phase_6_freeze_review_pack.js +65 -65
- package/lib/phase_6_gate_pack.js +59 -59
- package/lib/phase_6_langchain_runtime_pack.js +72 -72
- package/lib/phase_6_langgraph_runtime_pack.js +72 -72
- package/lib/phase_6_semantic_kernel_runtime_pack.js +72 -72
- package/lib/phase_7_closeout_pack.js +45 -45
- package/lib/phase_7_completion_pack.js +85 -85
- package/lib/phase_7_decision_record_pack.js +53 -53
- package/lib/phase_7_decision_resolution_pack.js +53 -53
- package/lib/phase_7_event_system_continuity_pack.js +89 -89
- package/lib/phase_7_event_system_pack.js +76 -76
- package/lib/phase_7_freeze_baseline_pack.js +74 -74
- package/lib/phase_7_freeze_review_pack.js +65 -65
- package/lib/phase_7_gate_pack.js +58 -58
- package/lib/phase_7_kafka_runtime_pack.js +74 -74
- package/lib/phase_7_mqtt_runtime_pack.js +74 -74
- package/lib/phase_7_nats_runtime_pack.js +74 -74
- package/lib/phase_7_webhook_event_bus_runtime_pack.js +74 -74
- package/lib/phase_8_closeout_pack.js +46 -46
- package/lib/phase_8_completion_pack.js +82 -82
- package/lib/phase_8_decision_record_pack.js +54 -54
- package/lib/phase_8_decision_resolution_pack.js +53 -53
- package/lib/phase_8_external_receipt_import_runtime_pack.js +74 -74
- package/lib/phase_8_external_result_import_runtime_pack.js +74 -74
- package/lib/phase_8_freeze_baseline_pack.js +71 -71
- package/lib/phase_8_freeze_review_pack.js +64 -64
- package/lib/phase_8_gate_pack.js +58 -58
- package/lib/phase_8_proof_bridge_continuity_pack.js +86 -86
- package/lib/phase_8_proof_bridges_pack.js +72 -72
- package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +74 -74
- package/lib/phase_9_closeout_pack.js +46 -46
- package/lib/phase_9_completion_pack.js +82 -82
- package/lib/phase_9_custody_refs_runtime_pack.js +74 -74
- package/lib/phase_9_decision_record_pack.js +54 -54
- package/lib/phase_9_decision_resolution_pack.js +53 -53
- package/lib/phase_9_freeze_baseline_pack.js +71 -71
- package/lib/phase_9_freeze_review_pack.js +64 -64
- package/lib/phase_9_gate_pack.js +58 -58
- package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +74 -74
- package/lib/phase_9_treasury_connectivity_pack.js +72 -72
- package/lib/phase_9_treasury_continuity_pack.js +86 -86
- package/lib/phase_9_treasury_destinations_runtime_pack.js +74 -74
- package/lib/phase_program_pack.js +120 -120
- package/lib/pricing_optimization_contract.js +775 -775
- package/lib/protocol_lane_contract.js +117 -117
- package/lib/provenance_lane_contract.js +54 -54
- package/lib/provider_lane_contract.js +240 -240
- package/lib/provider_runtime_journey_contract.js +183 -183
- package/lib/public_surface_policy_contract.js +111 -111
- package/lib/publish_plan.js +51 -51
- package/lib/record_queries.js +48 -48
- package/lib/release_candidate.js +50 -50
- package/lib/release_center.js +1093 -1093
- package/lib/release_history.js +205 -205
- package/lib/release_manifest.js +113 -113
- package/lib/release_pack.js +453 -453
- package/lib/request_rate_limit.js +144 -144
- package/lib/resource_views.js +31 -31
- package/lib/revenue_launch_path_contract.js +326 -326
- package/lib/route_matchers.js +34 -34
- package/lib/route_params.js +19 -19
- package/lib/runtime_bridge.js +124 -124
- package/lib/runtime_operations_worker.js +282 -282
- package/lib/runtime_state_store.js +354 -354
- package/lib/settlement_lane_contract.js +111 -111
- package/lib/shared_signals_lane_contract.js +54 -54
- package/lib/signed_audit_provenance_contract.js +83 -83
- package/lib/soft_launch_pack.js +78 -78
- package/lib/stablecoin_lane_contract.js +76 -76
- package/lib/stripe_mpp_lane_contract.js +96 -96
- package/lib/stripe_mpp_payment_front.js +158 -158
- package/lib/telemetry_lane_contract.js +54 -54
- package/lib/treasury_destinations_contract.js +764 -764
- package/lib/treasury_egress_policy_contract.js +91 -91
- package/lib/treasury_lane_contract.js +84 -84
- package/lib/trust_portability_boundary_contract.js +72 -72
- package/lib/x402_facilitator.js +155 -0
- package/lib/x402_lane_contract.js +118 -118
- package/package.json +106 -105
- package/scripts/registry_cli.js +275 -275
- package/scripts/verify_adapters.js +554 -554
- package/scripts/verify_all.js +4962 -4962
- package/scripts/verify_control_plane_contracts.js +34 -34
- package/scripts/verify_control_plane_routes.js +70 -70
- package/scripts/verify_delivery_summary.js +112 -112
- package/scripts/verify_examples.js +19 -19
- package/scripts/verify_first_run_conversions.js +81 -81
- package/scripts/verify_framework_provider_promotion.js +152 -152
- package/scripts/verify_full_catalog.js +174 -174
- package/scripts/verify_integrations.js +620 -620
- package/scripts/verify_lifecycle_continuity.js +96 -96
- package/scripts/verify_market_lane_depth.js +94 -94
- package/scripts/verify_market_lane_promotion.js +103 -103
- package/scripts/verify_market_lane_traces.js +98 -98
- package/scripts/verify_market_lanes.js +102 -102
- package/scripts/verify_operator_observability_boundary.js +83 -83
- package/scripts/verify_pricing_experiment_plan.js +124 -124
- package/scripts/verify_provider_runtime_breadth.js +109 -109
- package/scripts/verify_provider_runtime_journeys.js +111 -111
- package/scripts/verify_revenue_launch_paths.js +105 -105
- package/scripts/verify_runtime_durability.js +52 -52
- package/scripts/verify_service.js +15410 -15250
- package/scripts/verify_tooling.js +1412 -1412
- package/scripts/verify_treasury_public_boundary.js +97 -97
- package/scripts/verify_x402_facilitator.js +174 -0
- package/server.js +11117 -11006
- package/.env.production.checklist +0 -77
- package/.env.production.template +0 -54
- package/.github/workflows/publish-mcp-executor.yml +0 -43
- package/ADAPTER_PARTNER_PATH.md +0 -47
- package/ADAPTER_PROMOTION_START_HERE.md +0 -44
- package/BOLT_BINDINGS.production.worksheet.json +0 -31
- package/EXECUTION_TARGETS.production.worksheet.json +0 -73
- package/GO_LIVE_OPERATOR_PACK.md +0 -412
- package/L402_BINDINGS.production.worksheet.json +0 -30
- package/OPERATIONS_RUNBOOK.md +0 -115
- package/OPERATOR_START_HERE.md +0 -63
- package/OUTREACH_MESSAGES.md +0 -19
- package/OUTREACH_START_HERE.md +0 -36
- package/PRODUCTION_MANUAL_CLOSEOUT_SEQUENCE.md +0 -172
- package/PROGRAM_COMPLETE_RELEASE.md +0 -63
- package/PROGRAM_STATUS.md +0 -57
- package/PUBLISH_PLAN.md +0 -26
- package/RELEASE_CHECKLIST.md +0 -16
- package/SOFT_LAUNCH_KIT.md +0 -47
- package/services/mcp-execution-target/DISCOVERY_REGISTRY_PLAYBOOK.md +0 -141
- package/services/mcp-execution-target/README.md +0 -319
- package/services/mcp-execution-target/package.json +0 -14
- package/services/mcp-execution-target/server.js +0 -1031
- package/services/mcp-execution-target/server.json +0 -16
- package/services/mcp-execution-target/verify.js +0 -308
package/integrations/dispatch.js
CHANGED
|
@@ -1,276 +1,276 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const { findTask } = require("../fixtures/catalog");
|
|
4
|
-
const { getIntegration, listIntegrations } = require("./registry");
|
|
5
|
-
const { normalizeSettlementMode } = require("../lib/settlement_bsv_teranode");
|
|
6
|
-
|
|
7
|
-
function sortStrings(values) {
|
|
8
|
-
return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
function normalizeTaskRefs(payload) {
|
|
12
|
-
return Array.isArray(payload && payload.tasks) && payload.tasks.length > 0
|
|
13
|
-
? payload.tasks
|
|
14
|
-
.map((task) => String(task && task.task_ref ? task.task_ref : "").trim())
|
|
15
|
-
.filter(Boolean)
|
|
16
|
-
: [String(payload && payload.task_ref ? payload.task_ref : "").trim()].filter(Boolean);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
function normalizeRequestedIntegrationPreference(payload) {
|
|
20
|
-
const primary = String(payload && payload.integration_id ? payload.integration_id : "").trim();
|
|
21
|
-
const direct = Array.isArray(payload && payload.integration_ids) ? payload.integration_ids : [];
|
|
22
|
-
const nested = payload && payload.integration_context && Array.isArray(payload.integration_context.integration_ids)
|
|
23
|
-
? payload.integration_context.integration_ids
|
|
24
|
-
: [];
|
|
25
|
-
const orderedIds = []
|
|
26
|
-
.concat(primary ? [primary] : [])
|
|
27
|
-
.concat(direct)
|
|
28
|
-
.concat(nested)
|
|
29
|
-
.map((value) => String(value || "").trim())
|
|
30
|
-
.filter(Boolean);
|
|
31
|
-
|
|
32
|
-
return {
|
|
33
|
-
primary_id: primary || null,
|
|
34
|
-
requested_ids: sortStrings(orderedIds),
|
|
35
|
-
ordered_ids: orderedIds.filter((value, index) => orderedIds.indexOf(value) === index)
|
|
36
|
-
};
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
function resolveAdapterLanes(taskRefs) {
|
|
40
|
-
return sortStrings(taskRefs.flatMap((ref) => {
|
|
41
|
-
const task = findTask(ref);
|
|
42
|
-
return Array.isArray(task && task.adapters) ? task.adapters : [];
|
|
43
|
-
}));
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
function resolveSettlementMode(payload) {
|
|
47
|
-
return normalizeSettlementMode(String(
|
|
48
|
-
(payload && payload.settlement_mode) ||
|
|
49
|
-
(payload && payload.settlement && payload.settlement.mode) ||
|
|
50
|
-
"bsv_teranode"
|
|
51
|
-
).trim() || "bsv_teranode");
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
function resolveProtocols(payload, taskRefs) {
|
|
55
|
-
const protocols = [];
|
|
56
|
-
const explicitProtocol = String(
|
|
57
|
-
(payload && payload.protocol) ||
|
|
58
|
-
(payload && payload.integration_context && payload.integration_context.protocol) ||
|
|
59
|
-
""
|
|
60
|
-
).trim();
|
|
61
|
-
const paymentProtocol = String(
|
|
62
|
-
(payload && payload.payment_protocol) ||
|
|
63
|
-
(payload && payload.integration_context && payload.integration_context.payment_protocol) ||
|
|
64
|
-
""
|
|
65
|
-
).trim();
|
|
66
|
-
|
|
67
|
-
if (explicitProtocol) protocols.push(explicitProtocol);
|
|
68
|
-
if (paymentProtocol) protocols.push(paymentProtocol);
|
|
69
|
-
if (taskRefs.some((taskRef) => taskRef === "adapter.mcp.invoke" || taskRef.startsWith("adapter.mcp."))) {
|
|
70
|
-
protocols.push("mcp");
|
|
71
|
-
}
|
|
72
|
-
return sortStrings(protocols);
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
function chooseIntegration(options) {
|
|
76
|
-
const opts = options || {};
|
|
77
|
-
const requestedIds = Array.isArray(opts.requestedIds) ? opts.requestedIds : [];
|
|
78
|
-
const requestedIdsForClass = requestedIds.filter((integrationId) => {
|
|
79
|
-
const integration = getIntegration(integrationId);
|
|
80
|
-
return integration && integration.adapter_class === opts.adapterClass;
|
|
81
|
-
});
|
|
82
|
-
const candidates = listIntegrations({ class: opts.adapterClass }).filter((integration) => {
|
|
83
|
-
if (requestedIdsForClass.length > 0 && !requestedIdsForClass.includes(integration.integration_id)) return false;
|
|
84
|
-
if (
|
|
85
|
-
requestedIdsForClass.length === 0
|
|
86
|
-
&& opts.allowNonDefaultSelection !== true
|
|
87
|
-
&& integration.registration.default_selection_enabled !== true
|
|
88
|
-
) return false;
|
|
89
|
-
if (typeof opts.predicate === "function" && !opts.predicate(integration)) return false;
|
|
90
|
-
return true;
|
|
91
|
-
});
|
|
92
|
-
|
|
93
|
-
if (candidates.length === 0 && requestedIdsForClass.length > 0) {
|
|
94
|
-
return listIntegrations({ class: opts.adapterClass }).find((integration) =>
|
|
95
|
-
requestedIdsForClass.includes(integration.integration_id)
|
|
96
|
-
) || null;
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
return candidates.sort((left, right) => {
|
|
100
|
-
const leftPriority = Number(left && left.registration && left.registration.selection_priority);
|
|
101
|
-
const rightPriority = Number(right && right.registration && right.registration.selection_priority);
|
|
102
|
-
if (Number.isFinite(leftPriority) && Number.isFinite(rightPriority) && leftPriority !== rightPriority) {
|
|
103
|
-
return leftPriority - rightPriority;
|
|
104
|
-
}
|
|
105
|
-
if (Number.isFinite(leftPriority) && !Number.isFinite(rightPriority)) return -1;
|
|
106
|
-
if (!Number.isFinite(leftPriority) && Number.isFinite(rightPriority)) return 1;
|
|
107
|
-
if (left.source === "builtin" && right.source !== "builtin") return -1;
|
|
108
|
-
if (left.source !== "builtin" && right.source === "builtin") return 1;
|
|
109
|
-
if (left.registration.bundled === true && right.registration.bundled !== true) return -1;
|
|
110
|
-
if (left.registration.bundled !== true && right.registration.bundled === true) return 1;
|
|
111
|
-
return left.integration_id.localeCompare(right.integration_id);
|
|
112
|
-
})[0] || null;
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
function validateRequestedIntegrations(preference) {
|
|
116
|
-
const pref = preference || {};
|
|
117
|
-
const requestedIds = Array.isArray(pref.requested_ids) ? pref.requested_ids : [];
|
|
118
|
-
const unknownIntegrationIds = requestedIds.filter((integrationId) => !getIntegration(integrationId));
|
|
119
|
-
return {
|
|
120
|
-
ok: unknownIntegrationIds.length === 0,
|
|
121
|
-
unknown_integration_ids: unknownIntegrationIds
|
|
122
|
-
};
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
function resolveExecutionIntegrations(taskRefs, adapterLanes, requestedIds) {
|
|
126
|
-
return adapterLanes
|
|
127
|
-
.map((lane) => {
|
|
128
|
-
if (lane === "mcp") {
|
|
129
|
-
return chooseIntegration({
|
|
130
|
-
adapterClass: "agent_protocol_adapter",
|
|
131
|
-
requestedIds,
|
|
132
|
-
predicate: (integration) =>
|
|
133
|
-
integration.protocols.includes("mcp") &&
|
|
134
|
-
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
135
|
-
});
|
|
136
|
-
}
|
|
137
|
-
if (lane === "http") {
|
|
138
|
-
return chooseIntegration({
|
|
139
|
-
adapterClass: "execution_adapter",
|
|
140
|
-
requestedIds,
|
|
141
|
-
predicate: (integration) =>
|
|
142
|
-
integration.adapter_lanes.includes("http") &&
|
|
143
|
-
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
144
|
-
});
|
|
145
|
-
}
|
|
146
|
-
if (lane === "chain") {
|
|
147
|
-
return chooseIntegration({
|
|
148
|
-
adapterClass: "settlement_adapter",
|
|
149
|
-
requestedIds,
|
|
150
|
-
predicate: (integration) =>
|
|
151
|
-
integration.adapter_lanes.includes("chain") &&
|
|
152
|
-
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
153
|
-
});
|
|
154
|
-
}
|
|
155
|
-
return null;
|
|
156
|
-
})
|
|
157
|
-
.filter(Boolean);
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
function resolveIdentityIntegrations(taskRefs, requestedIds) {
|
|
161
|
-
const integration = chooseIntegration({
|
|
162
|
-
adapterClass: "identity_registry_adapter",
|
|
163
|
-
requestedIds,
|
|
164
|
-
predicate: (entry) => entry.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
165
|
-
});
|
|
166
|
-
return integration ? [integration] : [];
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
function resolveIntegrationSelection(payload) {
|
|
170
|
-
const taskRefs = normalizeTaskRefs(payload);
|
|
171
|
-
const preference = normalizeRequestedIntegrationPreference(payload);
|
|
172
|
-
const preferenceValidation = validateRequestedIntegrations(preference);
|
|
173
|
-
const adapterLanes = resolveAdapterLanes(taskRefs);
|
|
174
|
-
const settlementMode = resolveSettlementMode(payload);
|
|
175
|
-
const protocols = resolveProtocols(payload, taskRefs);
|
|
176
|
-
const explicitProtocol = String(
|
|
177
|
-
(payload && payload.protocol) ||
|
|
178
|
-
(payload && payload.integration_context && payload.integration_context.protocol) ||
|
|
179
|
-
""
|
|
180
|
-
).trim();
|
|
181
|
-
const explicitPaymentProtocol = String(
|
|
182
|
-
(payload && payload.payment_protocol) ||
|
|
183
|
-
(payload && payload.integration_context && payload.integration_context.payment_protocol) ||
|
|
184
|
-
""
|
|
185
|
-
).trim();
|
|
186
|
-
const requestedIds = preference.requested_ids;
|
|
187
|
-
const executionIntegrations = resolveExecutionIntegrations(taskRefs, adapterLanes, requestedIds);
|
|
188
|
-
const identityIntegrations = resolveIdentityIntegrations(taskRefs, requestedIds);
|
|
189
|
-
const protocolIntegrations = protocols.map((protocol) => chooseIntegration({
|
|
190
|
-
adapterClass: protocol === "x402" || protocol === "l402" || protocol === "bolt" || protocol === "mpp" ? "payment_rail_adapter" : "agent_protocol_adapter",
|
|
191
|
-
requestedIds,
|
|
192
|
-
allowNonDefaultSelection: explicitProtocol === protocol || explicitPaymentProtocol === protocol,
|
|
193
|
-
predicate: (integration) => integration.protocols.includes(protocol)
|
|
194
|
-
})).filter(Boolean);
|
|
195
|
-
const settlementIntegration = chooseIntegration({
|
|
196
|
-
adapterClass: "settlement_adapter",
|
|
197
|
-
requestedIds,
|
|
198
|
-
predicate: (integration) => integration.settlement_modes.includes(settlementMode)
|
|
199
|
-
});
|
|
200
|
-
const integrationIds = sortStrings(
|
|
201
|
-
executionIntegrations
|
|
202
|
-
.concat(identityIntegrations)
|
|
203
|
-
.concat(protocolIntegrations)
|
|
204
|
-
.concat(settlementIntegration ? [settlementIntegration] : [])
|
|
205
|
-
.map((integration) => integration.integration_id)
|
|
206
|
-
);
|
|
207
|
-
const unresolvedRequestedIds = requestedIds.filter((integrationId) => !integrationIds.includes(integrationId));
|
|
208
|
-
const errors = [];
|
|
209
|
-
|
|
210
|
-
if (!preferenceValidation.ok) {
|
|
211
|
-
errors.push(`unknown integration ids: ${preferenceValidation.unknown_integration_ids.join(", ")}`);
|
|
212
|
-
}
|
|
213
|
-
if (preference.primary_id && !integrationIds.includes(preference.primary_id)) {
|
|
214
|
-
errors.push(`requested integration_id is incompatible with this request: ${preference.primary_id}`);
|
|
215
|
-
}
|
|
216
|
-
if (unresolvedRequestedIds.length > 0) {
|
|
217
|
-
errors.push(`requested integration ids are incompatible with this request: ${unresolvedRequestedIds.join(", ")}`);
|
|
218
|
-
}
|
|
219
|
-
if (explicitProtocol && !protocols.includes(explicitProtocol)) {
|
|
220
|
-
errors.push(`requested protocol could not be resolved: ${explicitProtocol}`);
|
|
221
|
-
}
|
|
222
|
-
if (explicitProtocol && !protocolIntegrations.some((integration) => integration.protocols.includes(explicitProtocol))) {
|
|
223
|
-
errors.push(`requested protocol integration is unavailable: ${explicitProtocol}`);
|
|
224
|
-
}
|
|
225
|
-
if (explicitPaymentProtocol && !protocolIntegrations.some((integration) => integration.protocols.includes(explicitPaymentProtocol))) {
|
|
226
|
-
errors.push(`requested payment protocol integration is unavailable: ${explicitPaymentProtocol}`);
|
|
227
|
-
}
|
|
228
|
-
if (!settlementIntegration) {
|
|
229
|
-
errors.push(`requested settlement mode is unavailable: ${settlementMode}`);
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
return {
|
|
233
|
-
ok: errors.length === 0,
|
|
234
|
-
errors,
|
|
235
|
-
task_refs: taskRefs,
|
|
236
|
-
adapters: adapterLanes.length > 0 ? adapterLanes : ["http"],
|
|
237
|
-
protocols,
|
|
238
|
-
settlement_mode: settlementMode,
|
|
239
|
-
settlement_adapter: settlementMode,
|
|
240
|
-
settlement_integration_id: settlementIntegration ? settlementIntegration.integration_id : null,
|
|
241
|
-
execution_integration_ids: sortStrings(executionIntegrations.map((integration) => integration.integration_id)),
|
|
242
|
-
protocol_integration_ids: sortStrings(protocolIntegrations.map((integration) => integration.integration_id)),
|
|
243
|
-
identity_integration_ids: sortStrings(identityIntegrations.map((integration) => integration.integration_id)),
|
|
244
|
-
integration_ids: integrationIds,
|
|
245
|
-
requested_integration_ids: requestedIds,
|
|
246
|
-
integration_preference: {
|
|
247
|
-
primary_id: preference.primary_id,
|
|
248
|
-
requested_ids: requestedIds,
|
|
249
|
-
explicit_protocol: explicitProtocol || null,
|
|
250
|
-
explicit_payment_protocol: explicitPaymentProtocol || null,
|
|
251
|
-
settlement_mode: settlementMode
|
|
252
|
-
}
|
|
253
|
-
};
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
function validateIntegrationSelection(payload) {
|
|
257
|
-
const selection = resolveIntegrationSelection(payload);
|
|
258
|
-
if (selection.ok) {
|
|
259
|
-
return {
|
|
260
|
-
ok: true,
|
|
261
|
-
selection
|
|
262
|
-
};
|
|
263
|
-
}
|
|
264
|
-
return {
|
|
265
|
-
ok: false,
|
|
266
|
-
reason: "invalid_integration_selection",
|
|
267
|
-
errors: selection.errors,
|
|
268
|
-
selection
|
|
269
|
-
};
|
|
270
|
-
}
|
|
271
|
-
|
|
272
|
-
module.exports = {
|
|
273
|
-
normalizeTaskRefs,
|
|
274
|
-
resolveIntegrationSelection,
|
|
275
|
-
validateIntegrationSelection
|
|
276
|
-
};
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
const { findTask } = require("../fixtures/catalog");
|
|
4
|
+
const { getIntegration, listIntegrations } = require("./registry");
|
|
5
|
+
const { normalizeSettlementMode } = require("../lib/settlement_bsv_teranode");
|
|
6
|
+
|
|
7
|
+
function sortStrings(values) {
|
|
8
|
+
return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
function normalizeTaskRefs(payload) {
|
|
12
|
+
return Array.isArray(payload && payload.tasks) && payload.tasks.length > 0
|
|
13
|
+
? payload.tasks
|
|
14
|
+
.map((task) => String(task && task.task_ref ? task.task_ref : "").trim())
|
|
15
|
+
.filter(Boolean)
|
|
16
|
+
: [String(payload && payload.task_ref ? payload.task_ref : "").trim()].filter(Boolean);
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function normalizeRequestedIntegrationPreference(payload) {
|
|
20
|
+
const primary = String(payload && payload.integration_id ? payload.integration_id : "").trim();
|
|
21
|
+
const direct = Array.isArray(payload && payload.integration_ids) ? payload.integration_ids : [];
|
|
22
|
+
const nested = payload && payload.integration_context && Array.isArray(payload.integration_context.integration_ids)
|
|
23
|
+
? payload.integration_context.integration_ids
|
|
24
|
+
: [];
|
|
25
|
+
const orderedIds = []
|
|
26
|
+
.concat(primary ? [primary] : [])
|
|
27
|
+
.concat(direct)
|
|
28
|
+
.concat(nested)
|
|
29
|
+
.map((value) => String(value || "").trim())
|
|
30
|
+
.filter(Boolean);
|
|
31
|
+
|
|
32
|
+
return {
|
|
33
|
+
primary_id: primary || null,
|
|
34
|
+
requested_ids: sortStrings(orderedIds),
|
|
35
|
+
ordered_ids: orderedIds.filter((value, index) => orderedIds.indexOf(value) === index)
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function resolveAdapterLanes(taskRefs) {
|
|
40
|
+
return sortStrings(taskRefs.flatMap((ref) => {
|
|
41
|
+
const task = findTask(ref);
|
|
42
|
+
return Array.isArray(task && task.adapters) ? task.adapters : [];
|
|
43
|
+
}));
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function resolveSettlementMode(payload) {
|
|
47
|
+
return normalizeSettlementMode(String(
|
|
48
|
+
(payload && payload.settlement_mode) ||
|
|
49
|
+
(payload && payload.settlement && payload.settlement.mode) ||
|
|
50
|
+
"bsv_teranode"
|
|
51
|
+
).trim() || "bsv_teranode");
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function resolveProtocols(payload, taskRefs) {
|
|
55
|
+
const protocols = [];
|
|
56
|
+
const explicitProtocol = String(
|
|
57
|
+
(payload && payload.protocol) ||
|
|
58
|
+
(payload && payload.integration_context && payload.integration_context.protocol) ||
|
|
59
|
+
""
|
|
60
|
+
).trim();
|
|
61
|
+
const paymentProtocol = String(
|
|
62
|
+
(payload && payload.payment_protocol) ||
|
|
63
|
+
(payload && payload.integration_context && payload.integration_context.payment_protocol) ||
|
|
64
|
+
""
|
|
65
|
+
).trim();
|
|
66
|
+
|
|
67
|
+
if (explicitProtocol) protocols.push(explicitProtocol);
|
|
68
|
+
if (paymentProtocol) protocols.push(paymentProtocol);
|
|
69
|
+
if (taskRefs.some((taskRef) => taskRef === "adapter.mcp.invoke" || taskRef.startsWith("adapter.mcp."))) {
|
|
70
|
+
protocols.push("mcp");
|
|
71
|
+
}
|
|
72
|
+
return sortStrings(protocols);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function chooseIntegration(options) {
|
|
76
|
+
const opts = options || {};
|
|
77
|
+
const requestedIds = Array.isArray(opts.requestedIds) ? opts.requestedIds : [];
|
|
78
|
+
const requestedIdsForClass = requestedIds.filter((integrationId) => {
|
|
79
|
+
const integration = getIntegration(integrationId);
|
|
80
|
+
return integration && integration.adapter_class === opts.adapterClass;
|
|
81
|
+
});
|
|
82
|
+
const candidates = listIntegrations({ class: opts.adapterClass }).filter((integration) => {
|
|
83
|
+
if (requestedIdsForClass.length > 0 && !requestedIdsForClass.includes(integration.integration_id)) return false;
|
|
84
|
+
if (
|
|
85
|
+
requestedIdsForClass.length === 0
|
|
86
|
+
&& opts.allowNonDefaultSelection !== true
|
|
87
|
+
&& integration.registration.default_selection_enabled !== true
|
|
88
|
+
) return false;
|
|
89
|
+
if (typeof opts.predicate === "function" && !opts.predicate(integration)) return false;
|
|
90
|
+
return true;
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
if (candidates.length === 0 && requestedIdsForClass.length > 0) {
|
|
94
|
+
return listIntegrations({ class: opts.adapterClass }).find((integration) =>
|
|
95
|
+
requestedIdsForClass.includes(integration.integration_id)
|
|
96
|
+
) || null;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
return candidates.sort((left, right) => {
|
|
100
|
+
const leftPriority = Number(left && left.registration && left.registration.selection_priority);
|
|
101
|
+
const rightPriority = Number(right && right.registration && right.registration.selection_priority);
|
|
102
|
+
if (Number.isFinite(leftPriority) && Number.isFinite(rightPriority) && leftPriority !== rightPriority) {
|
|
103
|
+
return leftPriority - rightPriority;
|
|
104
|
+
}
|
|
105
|
+
if (Number.isFinite(leftPriority) && !Number.isFinite(rightPriority)) return -1;
|
|
106
|
+
if (!Number.isFinite(leftPriority) && Number.isFinite(rightPriority)) return 1;
|
|
107
|
+
if (left.source === "builtin" && right.source !== "builtin") return -1;
|
|
108
|
+
if (left.source !== "builtin" && right.source === "builtin") return 1;
|
|
109
|
+
if (left.registration.bundled === true && right.registration.bundled !== true) return -1;
|
|
110
|
+
if (left.registration.bundled !== true && right.registration.bundled === true) return 1;
|
|
111
|
+
return left.integration_id.localeCompare(right.integration_id);
|
|
112
|
+
})[0] || null;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function validateRequestedIntegrations(preference) {
|
|
116
|
+
const pref = preference || {};
|
|
117
|
+
const requestedIds = Array.isArray(pref.requested_ids) ? pref.requested_ids : [];
|
|
118
|
+
const unknownIntegrationIds = requestedIds.filter((integrationId) => !getIntegration(integrationId));
|
|
119
|
+
return {
|
|
120
|
+
ok: unknownIntegrationIds.length === 0,
|
|
121
|
+
unknown_integration_ids: unknownIntegrationIds
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function resolveExecutionIntegrations(taskRefs, adapterLanes, requestedIds) {
|
|
126
|
+
return adapterLanes
|
|
127
|
+
.map((lane) => {
|
|
128
|
+
if (lane === "mcp") {
|
|
129
|
+
return chooseIntegration({
|
|
130
|
+
adapterClass: "agent_protocol_adapter",
|
|
131
|
+
requestedIds,
|
|
132
|
+
predicate: (integration) =>
|
|
133
|
+
integration.protocols.includes("mcp") &&
|
|
134
|
+
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
if (lane === "http") {
|
|
138
|
+
return chooseIntegration({
|
|
139
|
+
adapterClass: "execution_adapter",
|
|
140
|
+
requestedIds,
|
|
141
|
+
predicate: (integration) =>
|
|
142
|
+
integration.adapter_lanes.includes("http") &&
|
|
143
|
+
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
if (lane === "chain") {
|
|
147
|
+
return chooseIntegration({
|
|
148
|
+
adapterClass: "settlement_adapter",
|
|
149
|
+
requestedIds,
|
|
150
|
+
predicate: (integration) =>
|
|
151
|
+
integration.adapter_lanes.includes("chain") &&
|
|
152
|
+
integration.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
return null;
|
|
156
|
+
})
|
|
157
|
+
.filter(Boolean);
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
function resolveIdentityIntegrations(taskRefs, requestedIds) {
|
|
161
|
+
const integration = chooseIntegration({
|
|
162
|
+
adapterClass: "identity_registry_adapter",
|
|
163
|
+
requestedIds,
|
|
164
|
+
predicate: (entry) => entry.task_refs.some((taskRef) => taskRefs.includes(taskRef))
|
|
165
|
+
});
|
|
166
|
+
return integration ? [integration] : [];
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function resolveIntegrationSelection(payload) {
|
|
170
|
+
const taskRefs = normalizeTaskRefs(payload);
|
|
171
|
+
const preference = normalizeRequestedIntegrationPreference(payload);
|
|
172
|
+
const preferenceValidation = validateRequestedIntegrations(preference);
|
|
173
|
+
const adapterLanes = resolveAdapterLanes(taskRefs);
|
|
174
|
+
const settlementMode = resolveSettlementMode(payload);
|
|
175
|
+
const protocols = resolveProtocols(payload, taskRefs);
|
|
176
|
+
const explicitProtocol = String(
|
|
177
|
+
(payload && payload.protocol) ||
|
|
178
|
+
(payload && payload.integration_context && payload.integration_context.protocol) ||
|
|
179
|
+
""
|
|
180
|
+
).trim();
|
|
181
|
+
const explicitPaymentProtocol = String(
|
|
182
|
+
(payload && payload.payment_protocol) ||
|
|
183
|
+
(payload && payload.integration_context && payload.integration_context.payment_protocol) ||
|
|
184
|
+
""
|
|
185
|
+
).trim();
|
|
186
|
+
const requestedIds = preference.requested_ids;
|
|
187
|
+
const executionIntegrations = resolveExecutionIntegrations(taskRefs, adapterLanes, requestedIds);
|
|
188
|
+
const identityIntegrations = resolveIdentityIntegrations(taskRefs, requestedIds);
|
|
189
|
+
const protocolIntegrations = protocols.map((protocol) => chooseIntegration({
|
|
190
|
+
adapterClass: protocol === "x402" || protocol === "l402" || protocol === "bolt" || protocol === "mpp" ? "payment_rail_adapter" : "agent_protocol_adapter",
|
|
191
|
+
requestedIds,
|
|
192
|
+
allowNonDefaultSelection: explicitProtocol === protocol || explicitPaymentProtocol === protocol,
|
|
193
|
+
predicate: (integration) => integration.protocols.includes(protocol)
|
|
194
|
+
})).filter(Boolean);
|
|
195
|
+
const settlementIntegration = chooseIntegration({
|
|
196
|
+
adapterClass: "settlement_adapter",
|
|
197
|
+
requestedIds,
|
|
198
|
+
predicate: (integration) => integration.settlement_modes.includes(settlementMode)
|
|
199
|
+
});
|
|
200
|
+
const integrationIds = sortStrings(
|
|
201
|
+
executionIntegrations
|
|
202
|
+
.concat(identityIntegrations)
|
|
203
|
+
.concat(protocolIntegrations)
|
|
204
|
+
.concat(settlementIntegration ? [settlementIntegration] : [])
|
|
205
|
+
.map((integration) => integration.integration_id)
|
|
206
|
+
);
|
|
207
|
+
const unresolvedRequestedIds = requestedIds.filter((integrationId) => !integrationIds.includes(integrationId));
|
|
208
|
+
const errors = [];
|
|
209
|
+
|
|
210
|
+
if (!preferenceValidation.ok) {
|
|
211
|
+
errors.push(`unknown integration ids: ${preferenceValidation.unknown_integration_ids.join(", ")}`);
|
|
212
|
+
}
|
|
213
|
+
if (preference.primary_id && !integrationIds.includes(preference.primary_id)) {
|
|
214
|
+
errors.push(`requested integration_id is incompatible with this request: ${preference.primary_id}`);
|
|
215
|
+
}
|
|
216
|
+
if (unresolvedRequestedIds.length > 0) {
|
|
217
|
+
errors.push(`requested integration ids are incompatible with this request: ${unresolvedRequestedIds.join(", ")}`);
|
|
218
|
+
}
|
|
219
|
+
if (explicitProtocol && !protocols.includes(explicitProtocol)) {
|
|
220
|
+
errors.push(`requested protocol could not be resolved: ${explicitProtocol}`);
|
|
221
|
+
}
|
|
222
|
+
if (explicitProtocol && !protocolIntegrations.some((integration) => integration.protocols.includes(explicitProtocol))) {
|
|
223
|
+
errors.push(`requested protocol integration is unavailable: ${explicitProtocol}`);
|
|
224
|
+
}
|
|
225
|
+
if (explicitPaymentProtocol && !protocolIntegrations.some((integration) => integration.protocols.includes(explicitPaymentProtocol))) {
|
|
226
|
+
errors.push(`requested payment protocol integration is unavailable: ${explicitPaymentProtocol}`);
|
|
227
|
+
}
|
|
228
|
+
if (!settlementIntegration) {
|
|
229
|
+
errors.push(`requested settlement mode is unavailable: ${settlementMode}`);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
return {
|
|
233
|
+
ok: errors.length === 0,
|
|
234
|
+
errors,
|
|
235
|
+
task_refs: taskRefs,
|
|
236
|
+
adapters: adapterLanes.length > 0 ? adapterLanes : ["http"],
|
|
237
|
+
protocols,
|
|
238
|
+
settlement_mode: settlementMode,
|
|
239
|
+
settlement_adapter: settlementMode,
|
|
240
|
+
settlement_integration_id: settlementIntegration ? settlementIntegration.integration_id : null,
|
|
241
|
+
execution_integration_ids: sortStrings(executionIntegrations.map((integration) => integration.integration_id)),
|
|
242
|
+
protocol_integration_ids: sortStrings(protocolIntegrations.map((integration) => integration.integration_id)),
|
|
243
|
+
identity_integration_ids: sortStrings(identityIntegrations.map((integration) => integration.integration_id)),
|
|
244
|
+
integration_ids: integrationIds,
|
|
245
|
+
requested_integration_ids: requestedIds,
|
|
246
|
+
integration_preference: {
|
|
247
|
+
primary_id: preference.primary_id,
|
|
248
|
+
requested_ids: requestedIds,
|
|
249
|
+
explicit_protocol: explicitProtocol || null,
|
|
250
|
+
explicit_payment_protocol: explicitPaymentProtocol || null,
|
|
251
|
+
settlement_mode: settlementMode
|
|
252
|
+
}
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
function validateIntegrationSelection(payload) {
|
|
257
|
+
const selection = resolveIntegrationSelection(payload);
|
|
258
|
+
if (selection.ok) {
|
|
259
|
+
return {
|
|
260
|
+
ok: true,
|
|
261
|
+
selection
|
|
262
|
+
};
|
|
263
|
+
}
|
|
264
|
+
return {
|
|
265
|
+
ok: false,
|
|
266
|
+
reason: "invalid_integration_selection",
|
|
267
|
+
errors: selection.errors,
|
|
268
|
+
selection
|
|
269
|
+
};
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
module.exports = {
|
|
273
|
+
normalizeTaskRefs,
|
|
274
|
+
resolveIntegrationSelection,
|
|
275
|
+
validateIntegrationSelection
|
|
276
|
+
};
|
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "xytara/registry-snapshot.schema.json",
|
|
4
|
-
"title": "xytara Integration Registry Snapshot",
|
|
5
|
-
"type": "object",
|
|
6
|
-
"additionalProperties": false,
|
|
7
|
-
"required": [
|
|
8
|
-
"snapshot_version",
|
|
9
|
-
"generated_at",
|
|
10
|
-
"integration_count",
|
|
11
|
-
"integrations"
|
|
12
|
-
],
|
|
13
|
-
"properties": {
|
|
14
|
-
"snapshot_version": {
|
|
15
|
-
"type": "string",
|
|
16
|
-
"minLength": 1
|
|
17
|
-
},
|
|
18
|
-
"generated_at": {
|
|
19
|
-
"type": "string",
|
|
20
|
-
"minLength": 1
|
|
21
|
-
},
|
|
22
|
-
"integration_count": {
|
|
23
|
-
"type": "integer",
|
|
24
|
-
"minimum": 0
|
|
25
|
-
},
|
|
26
|
-
"integrations": {
|
|
27
|
-
"type": "array",
|
|
28
|
-
"items": {
|
|
29
|
-
"type": "object"
|
|
30
|
-
}
|
|
31
|
-
},
|
|
32
|
-
"filters": {
|
|
33
|
-
"type": "object"
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "xytara/registry-snapshot.schema.json",
|
|
4
|
+
"title": "xytara Integration Registry Snapshot",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"additionalProperties": false,
|
|
7
|
+
"required": [
|
|
8
|
+
"snapshot_version",
|
|
9
|
+
"generated_at",
|
|
10
|
+
"integration_count",
|
|
11
|
+
"integrations"
|
|
12
|
+
],
|
|
13
|
+
"properties": {
|
|
14
|
+
"snapshot_version": {
|
|
15
|
+
"type": "string",
|
|
16
|
+
"minLength": 1
|
|
17
|
+
},
|
|
18
|
+
"generated_at": {
|
|
19
|
+
"type": "string",
|
|
20
|
+
"minLength": 1
|
|
21
|
+
},
|
|
22
|
+
"integration_count": {
|
|
23
|
+
"type": "integer",
|
|
24
|
+
"minimum": 0
|
|
25
|
+
},
|
|
26
|
+
"integrations": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"items": {
|
|
29
|
+
"type": "object"
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
"filters": {
|
|
33
|
+
"type": "object"
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|