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/agent_identity.js
DELETED
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
// Cryptographic agent identity for delegated-spend credentials.
|
|
4
|
-
//
|
|
5
|
-
// A spend credential may be bound to an agent's ed25519 public key (the same
|
|
6
|
-
// SPKI scheme xoonya's proof engine uses). When it is, presenting the bearer
|
|
7
|
-
// token is no longer sufficient: the caller must also prove control of the
|
|
8
|
-
// private key by signing a fresh challenge. This turns the credential from a
|
|
9
|
-
// pure bearer secret into a key-bound, verifiable delegated authority.
|
|
10
|
-
//
|
|
11
|
-
// Backward-compatible: a credential with no bound key keeps the existing
|
|
12
|
-
// bearer-only behavior. Dependency-free (node crypto; ed25519 verify is native).
|
|
13
|
-
|
|
14
|
-
const crypto = require("crypto");
|
|
15
|
-
|
|
16
|
-
// Accept an ed25519 public key as SPKI PEM or base64-encoded SPKI DER.
|
|
17
|
-
// Returns { key: KeyObject, spki_der_b64, key_ref } or null.
|
|
18
|
-
function normalizeAgentPublicKey(input) {
|
|
19
|
-
if (typeof input !== "string" || !input.trim()) return null;
|
|
20
|
-
const s = input.trim();
|
|
21
|
-
let key = null;
|
|
22
|
-
try {
|
|
23
|
-
if (s.includes("BEGIN PUBLIC KEY")) {
|
|
24
|
-
key = crypto.createPublicKey({ key: s, format: "pem" });
|
|
25
|
-
} else {
|
|
26
|
-
const der = Buffer.from(s.replace(/\s+/g, ""), "base64");
|
|
27
|
-
if (der.length === 0) return null;
|
|
28
|
-
key = crypto.createPublicKey({ key: der, format: "der", type: "spki" });
|
|
29
|
-
}
|
|
30
|
-
} catch (_) {
|
|
31
|
-
return null;
|
|
32
|
-
}
|
|
33
|
-
if (!key || key.asymmetricKeyType !== "ed25519") return null;
|
|
34
|
-
const spki = key.export({ type: "spki", format: "der" });
|
|
35
|
-
const keyRef = "ed25519-spki-sha256:" + crypto.createHash("sha256").update(spki).digest("hex");
|
|
36
|
-
return { key, spki_der_b64: spki.toString("base64"), key_ref: keyRef };
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
// The stable, public fingerprint of an agent key (matches xoonya's ref format).
|
|
40
|
-
function deriveAgentKeyRef(input) {
|
|
41
|
-
const m = normalizeAgentPublicKey(input);
|
|
42
|
-
return m ? m.key_ref : null;
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
// A deterministic digest committing a spend proof to the specific request it authorizes
|
|
46
|
-
// (account + units + task). A signature over a message carrying this digest can only be
|
|
47
|
-
// used for that exact account/amount/task — closing the "fresh signature repurposed for a
|
|
48
|
-
// different (within-cap) action" gap. Returns null when there is nothing to bind.
|
|
49
|
-
function buildSpendBindingDigest(binding) {
|
|
50
|
-
if (!binding || typeof binding !== "object") return null;
|
|
51
|
-
const toStr = (v) => (v === undefined || v === null ? "" : String(v).trim());
|
|
52
|
-
const account = toStr(binding.account_id);
|
|
53
|
-
const units = toStr(binding.units);
|
|
54
|
-
const task = toStr(binding.task_ref);
|
|
55
|
-
if (!account && !units && !task) return null;
|
|
56
|
-
// JSON array of fixed-order fields: unambiguous / injection-free (JSON escapes the field
|
|
57
|
-
// values), unlike a delimiter-joined string where a value containing the delimiter could
|
|
58
|
-
// collide two different (account, units, task) tuples onto the same digest.
|
|
59
|
-
const canonical = JSON.stringify(["naxytra-spend-binding/v1", account, units, task]);
|
|
60
|
-
return crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
// The canonical challenge an agent signs to prove key control for a spend action. When a
|
|
64
|
-
// bindingDigest is supplied the message additionally commits to the request (account/amount/
|
|
65
|
-
// task); without it, the legacy unbound message (credential id + timestamp) is produced.
|
|
66
|
-
function buildSpendAuthMessage(credentialId, timestamp, bindingDigest) {
|
|
67
|
-
const base = `naxytra-spend-auth:${credentialId}:${timestamp}`;
|
|
68
|
-
return bindingDigest ? `${base}:${bindingDigest}` : base;
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
// Verify an ed25519 signature (base64) over `message` against the bound key.
|
|
72
|
-
function verifyAgentSignature(publicKeyInput, message, signatureB64) {
|
|
73
|
-
const m = normalizeAgentPublicKey(publicKeyInput);
|
|
74
|
-
if (!m) return false;
|
|
75
|
-
let sig;
|
|
76
|
-
try {
|
|
77
|
-
sig = Buffer.from(String(signatureB64 || ""), "base64");
|
|
78
|
-
} catch (_) {
|
|
79
|
-
return false;
|
|
80
|
-
}
|
|
81
|
-
if (sig.length === 0) return false;
|
|
82
|
-
try {
|
|
83
|
-
return crypto.verify(null, Buffer.from(String(message), "utf8"), m.key, sig);
|
|
84
|
-
} catch (_) {
|
|
85
|
-
return false;
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
// Verify a spend-auth proof for a credential that is key-bound.
|
|
90
|
-
// proof = { signature, timestamp(ms) }. Returns
|
|
91
|
-
// { ok:true, canonical, message } | { ok:false, reason }.
|
|
92
|
-
// Freshness is bounded in BOTH directions (too old, or too far in the future).
|
|
93
|
-
// `canonical` is the decoded-signature fingerprint callers MUST use as the
|
|
94
|
-
// single-use replay key (so a re-encoded base64 of the same bytes cannot slip
|
|
95
|
-
// past the guard).
|
|
96
|
-
//
|
|
97
|
-
// options = { maxPastSeconds=120, maxFutureSeconds=30, requestBinding, requireBinding }.
|
|
98
|
-
// Freshness is bounded in BOTH directions. When options.requestBinding is supplied, a proof
|
|
99
|
-
// that signed the BOUND message (credential + timestamp + request digest) verifies and is
|
|
100
|
-
// reported as bound:true — that signature is usable ONLY for this exact account/amount/task,
|
|
101
|
-
// so a captured fresh signature cannot be repurposed for a different (even within-cap)
|
|
102
|
-
// request. An unbound signature still verifies (back-compat) UNLESS options.requireBinding is
|
|
103
|
-
// set (strict mode), which refuses anything not request-bound. `canonical` is the decoded-
|
|
104
|
-
// signature fingerprint callers MUST use as the single-use replay key.
|
|
105
|
-
function verifySpendAuthProof(agentPublicKey, credentialId, proof, options = {}) {
|
|
106
|
-
const opts = options && typeof options === "object" ? options : {};
|
|
107
|
-
const maxPastSeconds = Number.isFinite(opts.maxPastSeconds) ? opts.maxPastSeconds : 120;
|
|
108
|
-
const maxFutureSeconds = Number.isFinite(opts.maxFutureSeconds) ? opts.maxFutureSeconds : 30;
|
|
109
|
-
const requireBinding = Boolean(opts.requireBinding);
|
|
110
|
-
const bindingDigest = buildSpendBindingDigest(opts.requestBinding);
|
|
111
|
-
|
|
112
|
-
const signature = proof && typeof proof.signature === "string" ? proof.signature.trim() : "";
|
|
113
|
-
const timestampRaw = proof && (proof.timestamp !== undefined && proof.timestamp !== null) ? String(proof.timestamp).trim() : "";
|
|
114
|
-
if (!signature || !timestampRaw) return { ok: false, reason: "agent_signature_required" };
|
|
115
|
-
const timestamp = Number(timestampRaw);
|
|
116
|
-
if (!Number.isFinite(timestamp)) return { ok: false, reason: "agent_signature_timestamp_invalid" };
|
|
117
|
-
// Timestamp is milliseconds since epoch. Positive age = in the past.
|
|
118
|
-
const ageSeconds = (Date.now() - timestamp) / 1000;
|
|
119
|
-
if (ageSeconds > Math.max(1, maxPastSeconds)) return { ok: false, reason: "agent_signature_expired" };
|
|
120
|
-
if (ageSeconds < -Math.max(0, maxFutureSeconds)) return { ok: false, reason: "agent_signature_future" };
|
|
121
|
-
if (requireBinding && !bindingDigest) return { ok: false, reason: "spend_binding_required" };
|
|
122
|
-
|
|
123
|
-
// Prefer the request-bound message; fall back to the unbound message only when binding is
|
|
124
|
-
// not strictly required. A bound signature whose digest mismatches the actual request
|
|
125
|
-
// verifies against neither message -> rejected.
|
|
126
|
-
let message = null;
|
|
127
|
-
let bound = false;
|
|
128
|
-
if (bindingDigest) {
|
|
129
|
-
const boundMessage = buildSpendAuthMessage(credentialId, timestampRaw, bindingDigest);
|
|
130
|
-
if (verifyAgentSignature(agentPublicKey, boundMessage, signature)) {
|
|
131
|
-
message = boundMessage;
|
|
132
|
-
bound = true;
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
if (!message && !requireBinding) {
|
|
136
|
-
const unboundMessage = buildSpendAuthMessage(credentialId, timestampRaw);
|
|
137
|
-
if (verifyAgentSignature(agentPublicKey, unboundMessage, signature)) {
|
|
138
|
-
message = unboundMessage;
|
|
139
|
-
bound = false;
|
|
140
|
-
}
|
|
141
|
-
}
|
|
142
|
-
if (!message) {
|
|
143
|
-
return { ok: false, reason: requireBinding ? "agent_signature_binding_required_or_invalid" : "agent_signature_invalid" };
|
|
144
|
-
}
|
|
145
|
-
// Canonical replay key = hex of the decoded signature bytes (encoding-agnostic).
|
|
146
|
-
let canonical;
|
|
147
|
-
try {
|
|
148
|
-
canonical = Buffer.from(signature, "base64").toString("hex");
|
|
149
|
-
} catch (_) {
|
|
150
|
-
return { ok: false, reason: "agent_signature_invalid" };
|
|
151
|
-
}
|
|
152
|
-
return { ok: true, canonical, message, bound, expires_at_ms: timestamp + Math.max(1, maxPastSeconds) * 1000 };
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
module.exports = {
|
|
156
|
-
normalizeAgentPublicKey,
|
|
157
|
-
deriveAgentKeyRef,
|
|
158
|
-
buildSpendAuthMessage,
|
|
159
|
-
buildSpendBindingDigest,
|
|
160
|
-
verifyAgentSignature,
|
|
161
|
-
verifySpendAuthProof
|
|
162
|
-
};
|
package/lib/announcement_pack.js
DELETED
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const packageJson = require("../package.json");
|
|
4
|
-
|
|
5
|
-
function buildAnnouncementPack() {
|
|
6
|
-
return {
|
|
7
|
-
ok: true,
|
|
8
|
-
product: packageJson.name,
|
|
9
|
-
category: "machine-commerce-announcement-pack",
|
|
10
|
-
public_quickstart: {
|
|
11
|
-
install: "npm install xytara",
|
|
12
|
-
first_cli: "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
|
|
13
|
-
first_release_view: "xytara-release --center --summary",
|
|
14
|
-
first_http: "/v1/release-center/summary"
|
|
15
|
-
},
|
|
16
|
-
release_candidate: {
|
|
17
|
-
checks: [
|
|
18
|
-
"install the package on a clean machine",
|
|
19
|
-
"run xytara-release --center --summary",
|
|
20
|
-
"run npm run verify:all",
|
|
21
|
-
"verify /v1/release-center/summary on the deployed service",
|
|
22
|
-
"verify /v1/outreach-proof/summary on the deployed service"
|
|
23
|
-
]
|
|
24
|
-
},
|
|
25
|
-
publish_day: {
|
|
26
|
-
sequence: [
|
|
27
|
-
"publish the npm package",
|
|
28
|
-
"redeploy the service and docs surfaces",
|
|
29
|
-
"verify release-center, launch-narrative, and outreach-proof summaries live",
|
|
30
|
-
"run the first public proof path",
|
|
31
|
-
"share the announcement artifact with the target ecosystem audience"
|
|
32
|
-
]
|
|
33
|
-
},
|
|
34
|
-
public_message: {
|
|
35
|
-
headline: "governed machine commerce with direct paid execution, reusable credits, and proof-aware followthrough",
|
|
36
|
-
who_should_try_first: [
|
|
37
|
-
"agent builders",
|
|
38
|
-
"tool and marketplace authors",
|
|
39
|
-
"repeat-use runtime operators"
|
|
40
|
-
]
|
|
41
|
-
}
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
function summarizeAnnouncementPack() {
|
|
46
|
-
const pack = buildAnnouncementPack();
|
|
47
|
-
return {
|
|
48
|
-
ok: true,
|
|
49
|
-
product: pack.product,
|
|
50
|
-
category: pack.category,
|
|
51
|
-
rc_check_count: pack.release_candidate.checks.length,
|
|
52
|
-
publish_step_count: pack.publish_day.sequence.length,
|
|
53
|
-
first_cli: pack.public_quickstart.first_cli,
|
|
54
|
-
audience_count: pack.public_message.who_should_try_first.length
|
|
55
|
-
};
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
module.exports = {
|
|
59
|
-
buildAnnouncementPack,
|
|
60
|
-
summarizeAnnouncementPack
|
|
61
|
-
};
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
function buildArtifactDistributionLanePack() {
|
|
4
|
-
return {
|
|
5
|
-
product: "xytara",
|
|
6
|
-
category: "machine-commerce-artifact-distribution-lane-pack",
|
|
7
|
-
pack_version: "xytara-artifact-distribution-lane-pack-v1",
|
|
8
|
-
lane_state: "first_party_artifact_distribution_lane_present",
|
|
9
|
-
posture: "oci_style_distribution_and_export_lane",
|
|
10
|
-
standards: ["oci_artifacts", "oras_style_distribution"],
|
|
11
|
-
artifact_families: ["adapter_packs", "submission_bundles", "registry_snapshots", "release_artifacts"],
|
|
12
|
-
supported_surfaces: {
|
|
13
|
-
integrations_ref: "/v1/integrations",
|
|
14
|
-
integration_snapshot_ref: "/v1/integrations/review/registry-snapshot",
|
|
15
|
-
adapter_pack_ref: "/v1/adapter-pack",
|
|
16
|
-
release_center_ref: "/v1/release-center",
|
|
17
|
-
release_pack_ref: "/v1/release-pack"
|
|
18
|
-
},
|
|
19
|
-
first_run_flows: [
|
|
20
|
-
{
|
|
21
|
-
flow_ref: "artifact_distribution_alignment",
|
|
22
|
-
recommended_reason: "best path for teams that want portable adapter, registry, and release artifacts instead of ad hoc zip-and-doc distribution",
|
|
23
|
-
sequence: [
|
|
24
|
-
"inspect_artifact_distribution_lane_summary",
|
|
25
|
-
"inspect_adapter_and_registry_export_surfaces",
|
|
26
|
-
"treat_release_and_submission bundles as distribution-ready artifacts",
|
|
27
|
-
"publish_or_transfer_artifacts through standard registries later without changing canonical shapes"
|
|
28
|
-
]
|
|
29
|
-
}
|
|
30
|
-
],
|
|
31
|
-
guardrails: [
|
|
32
|
-
"artifact portability should preserve canonical bundle shapes instead of inventing a second artifact model",
|
|
33
|
-
"distribution posture should remain subordinate to runtime, proof, and integration truth"
|
|
34
|
-
]
|
|
35
|
-
};
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
function summarizeArtifactDistributionLanePack() {
|
|
39
|
-
const pack = buildArtifactDistributionLanePack();
|
|
40
|
-
return {
|
|
41
|
-
product: "xytara",
|
|
42
|
-
category: "machine-commerce-artifact-distribution-lane-pack-summary",
|
|
43
|
-
summary_version: "xytara-artifact-distribution-lane-pack-summary-v1",
|
|
44
|
-
lane_state: pack.lane_state,
|
|
45
|
-
standard_count: pack.standards.length,
|
|
46
|
-
artifact_family_count: pack.artifact_families.length,
|
|
47
|
-
linked_surfaces: pack.supported_surfaces
|
|
48
|
-
};
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
module.exports = {
|
|
52
|
-
buildArtifactDistributionLanePack,
|
|
53
|
-
summarizeArtifactDistributionLanePack
|
|
54
|
-
};
|
package/lib/asyncapi_contract.js
DELETED
|
@@ -1,150 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const pkg = require("../package.json");
|
|
4
|
-
|
|
5
|
-
function buildAsyncApiDocument() {
|
|
6
|
-
return {
|
|
7
|
-
asyncapi: "3.0.0",
|
|
8
|
-
info: {
|
|
9
|
-
title: "xytara Event Contract",
|
|
10
|
-
version: pkg.version,
|
|
11
|
-
summary: "Machine-commerce runtime event and handoff contract.",
|
|
12
|
-
description: "This AsyncAPI document describes the stable runtime event and handoff surfaces that outside builders and partners should rely on first."
|
|
13
|
-
},
|
|
14
|
-
servers: {
|
|
15
|
-
httpRuntime: {
|
|
16
|
-
host: String(process.env.XYTARA_PUBLIC_BASE_URL || "https://xytara.onrender.com").trim().replace(/^https?:\/\//, "").replace(/\/+$/, ""),
|
|
17
|
-
protocol: "https",
|
|
18
|
-
description: "Hosted xytara HTTP event and handoff entrypoint"
|
|
19
|
-
}
|
|
20
|
-
},
|
|
21
|
-
channels: {
|
|
22
|
-
"runtime/events/emit": {
|
|
23
|
-
address: "/v1/runtime/emit",
|
|
24
|
-
messages: {
|
|
25
|
-
runtimeEmitRequest: {
|
|
26
|
-
name: "runtimeEmitRequest",
|
|
27
|
-
title: "Runtime emit request",
|
|
28
|
-
summary: "Append a runtime event record."
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
},
|
|
32
|
-
"runtime/events/anchor": {
|
|
33
|
-
address: "/v1/runtime/anchor",
|
|
34
|
-
messages: {
|
|
35
|
-
runtimeAnchorRequest: {
|
|
36
|
-
name: "runtimeAnchorRequest",
|
|
37
|
-
title: "Runtime anchor request",
|
|
38
|
-
summary: "Anchor a runtime event into registry/anchor posture."
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
},
|
|
42
|
-
"runtime/events/emit-anchor": {
|
|
43
|
-
address: "/v1/runtime/emit-anchor",
|
|
44
|
-
messages: {
|
|
45
|
-
runtimeEmitAnchorRequest: {
|
|
46
|
-
name: "runtimeEmitAnchorRequest",
|
|
47
|
-
title: "Runtime emit-anchor request",
|
|
48
|
-
summary: "Emit and anchor a runtime event in one call."
|
|
49
|
-
}
|
|
50
|
-
}
|
|
51
|
-
},
|
|
52
|
-
"handoffs/trust/emit": {
|
|
53
|
-
address: "/v1/trust/handoffs/emit",
|
|
54
|
-
messages: {
|
|
55
|
-
trustHandoffEmitRequest: {
|
|
56
|
-
name: "trustHandoffEmitRequest",
|
|
57
|
-
title: "Trust handoff emit request",
|
|
58
|
-
summary: "Emit a trust-compatible handoff bundle."
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
},
|
|
62
|
-
"handoffs/execution-receipts/emit": {
|
|
63
|
-
address: "/v1/execution-receipts/handoffs/emit",
|
|
64
|
-
messages: {
|
|
65
|
-
executionReceiptHandoffEmitRequest: {
|
|
66
|
-
name: "executionReceiptHandoffEmitRequest",
|
|
67
|
-
title: "Execution receipt handoff emit request",
|
|
68
|
-
summary: "Emit an execution receipt handoff bundle."
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
},
|
|
72
|
-
"handoffs/receipt-ledger/emit": {
|
|
73
|
-
address: "/v1/receipt-ledger/handoffs/emit",
|
|
74
|
-
messages: {
|
|
75
|
-
receiptLedgerHandoffEmitRequest: {
|
|
76
|
-
name: "receiptLedgerHandoffEmitRequest",
|
|
77
|
-
title: "Receipt ledger handoff emit request",
|
|
78
|
-
summary: "Emit a receipt-ledger handoff bundle."
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
},
|
|
83
|
-
operations: {
|
|
84
|
-
publishRuntimeEvent: {
|
|
85
|
-
action: "send",
|
|
86
|
-
channel: { $ref: "#/channels/runtime/events/emit" },
|
|
87
|
-
summary: "Publish runtime event data through the stable emit surface."
|
|
88
|
-
},
|
|
89
|
-
publishRuntimeAnchor: {
|
|
90
|
-
action: "send",
|
|
91
|
-
channel: { $ref: "#/channels/runtime/events/anchor" },
|
|
92
|
-
summary: "Publish anchoring data through the stable anchor surface."
|
|
93
|
-
},
|
|
94
|
-
publishRuntimeEmitAnchor: {
|
|
95
|
-
action: "send",
|
|
96
|
-
channel: { $ref: "#/channels/runtime/events/emit-anchor" },
|
|
97
|
-
summary: "Publish combined emit-anchor data through the stable combined surface."
|
|
98
|
-
},
|
|
99
|
-
publishTrustHandoff: {
|
|
100
|
-
action: "send",
|
|
101
|
-
channel: { $ref: "#/channels/handoffs/trust/emit" },
|
|
102
|
-
summary: "Publish trust handoff data for proof followthrough."
|
|
103
|
-
},
|
|
104
|
-
publishExecutionReceiptHandoff: {
|
|
105
|
-
action: "send",
|
|
106
|
-
channel: { $ref: "#/channels/handoffs/execution-receipts/emit" },
|
|
107
|
-
summary: "Publish execution receipt handoff data."
|
|
108
|
-
},
|
|
109
|
-
publishReceiptLedgerHandoff: {
|
|
110
|
-
action: "send",
|
|
111
|
-
channel: { $ref: "#/channels/handoffs/receipt-ledger/emit" },
|
|
112
|
-
summary: "Publish receipt-ledger handoff data."
|
|
113
|
-
}
|
|
114
|
-
},
|
|
115
|
-
"x-naxytra-contract": {
|
|
116
|
-
product: "xytara",
|
|
117
|
-
stability: "stable_public_event_layer",
|
|
118
|
-
channel_count: 6,
|
|
119
|
-
linked_docs: [
|
|
120
|
-
"SERVICE_CONTRACT.md",
|
|
121
|
-
"FINAL_CONTRACT.md",
|
|
122
|
-
"START_HERE.md"
|
|
123
|
-
]
|
|
124
|
-
}
|
|
125
|
-
};
|
|
126
|
-
}
|
|
127
|
-
|
|
128
|
-
function summarizeAsyncApiDocument() {
|
|
129
|
-
const document = buildAsyncApiDocument();
|
|
130
|
-
return {
|
|
131
|
-
product: "xytara",
|
|
132
|
-
category: "machine-commerce-asyncapi-contract-summary",
|
|
133
|
-
summary_version: "xytara-asyncapi-contract-summary-v1",
|
|
134
|
-
asyncapi_version: document.asyncapi,
|
|
135
|
-
info_version: document.info.version,
|
|
136
|
-
channel_count: Object.keys(document.channels).length,
|
|
137
|
-
operation_count: Object.keys(document.operations).length,
|
|
138
|
-
primary_event_lanes: ["runtime", "handoff"],
|
|
139
|
-
linked_surfaces: {
|
|
140
|
-
asyncapi_ref: "/asyncapi.json",
|
|
141
|
-
service_contract_ref: "SERVICE_CONTRACT.md",
|
|
142
|
-
openapi_ref: "/openapi.json"
|
|
143
|
-
}
|
|
144
|
-
};
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
module.exports = {
|
|
148
|
-
buildAsyncApiDocument,
|
|
149
|
-
summarizeAsyncApiDocument
|
|
150
|
-
};
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const pkg = require("../package.json");
|
|
4
|
-
|
|
5
|
-
function buildAuthInteropContract() {
|
|
6
|
-
return {
|
|
7
|
-
product: "xytara",
|
|
8
|
-
category: "machine-commerce-auth-interop-contract",
|
|
9
|
-
contract_version: "xytara-auth-interop-contract-v1",
|
|
10
|
-
service_version: pkg.version,
|
|
11
|
-
primary_posture: "native_authority_with_oauth_oidc_token_exchange_interop",
|
|
12
|
-
supported_interop_profiles: [
|
|
13
|
-
{
|
|
14
|
-
profile_id: "oauth_client_credentials_runtime",
|
|
15
|
-
standards: ["oauth_2_0", "oidc_optional"],
|
|
16
|
-
intended_use: "machine-to-machine runtime invocation",
|
|
17
|
-
primary_routes: ["/v1/commands/execute", "/v1/mcp/tools/invoke"]
|
|
18
|
-
},
|
|
19
|
-
{
|
|
20
|
-
profile_id: "bounded_delegation_token_exchange",
|
|
21
|
-
standards: ["oauth_2_0_token_exchange", "jwt_bearer_optional"],
|
|
22
|
-
intended_use: "map upstream bearer posture into bounded delegated authority",
|
|
23
|
-
primary_routes: [
|
|
24
|
-
"/v1/account-auth/spend-credentials",
|
|
25
|
-
"/v1/account-auth/authority-bindings",
|
|
26
|
-
"/v1/commands/execute"
|
|
27
|
-
]
|
|
28
|
-
},
|
|
29
|
-
{
|
|
30
|
-
profile_id: "mcp_a2a_a2c_interop_auth",
|
|
31
|
-
standards: ["oauth_2_0", "oidc", "token_exchange_optional"],
|
|
32
|
-
intended_use: "protocol-lane authentication for MCP, A2A, and A2C usage",
|
|
33
|
-
primary_routes: ["/v1/mcp/tools/invoke", "/x402/mcp/tools/invoke", "/v1/commands/execute"]
|
|
34
|
-
},
|
|
35
|
-
{
|
|
36
|
-
profile_id: "x402_payment_plus_bounded_auth",
|
|
37
|
-
standards: ["oauth_2_0_optional", "x402"],
|
|
38
|
-
intended_use: "combine payment challenge posture with bounded authenticated execution",
|
|
39
|
-
primary_routes: ["/x402/mcp/tools/invoke", "/x402/commands/execute"]
|
|
40
|
-
}
|
|
41
|
-
],
|
|
42
|
-
native_authority_mapping: {
|
|
43
|
-
authority_bindings: "/v1/account-auth/authority-bindings",
|
|
44
|
-
spend_credentials: "/v1/account-auth/spend-credentials",
|
|
45
|
-
execution_entry: "/v1/commands/execute",
|
|
46
|
-
mcp_entry: "/v1/mcp/tools/invoke"
|
|
47
|
-
},
|
|
48
|
-
guardrails: [
|
|
49
|
-
"native authority bindings remain canonical for bounded execution",
|
|
50
|
-
"oauth or oidc interop must not replace native consequence bounds",
|
|
51
|
-
"token exchange may map into delegation but must not bypass authority contracts",
|
|
52
|
-
"payment verification and auth posture remain separate concerns even when combined in one flow"
|
|
53
|
-
],
|
|
54
|
-
linked_surfaces: {
|
|
55
|
-
openapi_ref: "/openapi.json",
|
|
56
|
-
asyncapi_ref: "/asyncapi.json",
|
|
57
|
-
cloudevents_ref: "/cloudevents.json",
|
|
58
|
-
service_contract_ref: "SERVICE_CONTRACT.md"
|
|
59
|
-
}
|
|
60
|
-
};
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
function summarizeAuthInteropContract() {
|
|
64
|
-
const contract = buildAuthInteropContract();
|
|
65
|
-
return {
|
|
66
|
-
product: "xytara",
|
|
67
|
-
category: "machine-commerce-auth-interop-contract-summary",
|
|
68
|
-
summary_version: "xytara-auth-interop-contract-summary-v1",
|
|
69
|
-
contract_version: contract.contract_version,
|
|
70
|
-
profile_count: contract.supported_interop_profiles.length,
|
|
71
|
-
primary_posture: contract.primary_posture,
|
|
72
|
-
primary_protocol_lanes: ["mcp", "a2a", "a2c", "x402"],
|
|
73
|
-
linked_surfaces: contract.linked_surfaces
|
|
74
|
-
};
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
module.exports = {
|
|
78
|
-
buildAuthInteropContract,
|
|
79
|
-
summarizeAuthInteropContract
|
|
80
|
-
};
|