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/openapi_contract.js
DELETED
|
@@ -1,300 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const pkg = require("../package.json");
|
|
4
|
-
|
|
5
|
-
function buildOpenApiDocument() {
|
|
6
|
-
return {
|
|
7
|
-
openapi: "3.1.0",
|
|
8
|
-
info: {
|
|
9
|
-
title: "xytara Public HTTP Contract",
|
|
10
|
-
version: pkg.version,
|
|
11
|
-
summary: "Machine-commerce runtime contract for the stable public HTTP layer.",
|
|
12
|
-
description: "This OpenAPI document exposes the stable builder-facing HTTP surfaces we want outside builders and partners to stand on first.",
|
|
13
|
-
contact: {
|
|
14
|
-
name: "naxytra"
|
|
15
|
-
}
|
|
16
|
-
},
|
|
17
|
-
jsonSchemaDialect: "https://spec.openapis.org/oas/3.1/dialect/base",
|
|
18
|
-
servers: [
|
|
19
|
-
{
|
|
20
|
-
url: String(process.env.XYTARA_PUBLIC_BASE_URL || "https://xytara.onrender.com").trim().replace(/\/+$/, ""),
|
|
21
|
-
description: "Hosted xytara runtime"
|
|
22
|
-
},
|
|
23
|
-
{
|
|
24
|
-
url: "http://127.0.0.1:4320",
|
|
25
|
-
description: "Local xytara service"
|
|
26
|
-
}
|
|
27
|
-
],
|
|
28
|
-
tags: [
|
|
29
|
-
{ name: "health", description: "Service health and readiness." },
|
|
30
|
-
{ name: "catalog", description: "Capability discovery surfaces." },
|
|
31
|
-
{ name: "payments", description: "Quote and payment execution surfaces." },
|
|
32
|
-
{ name: "mcp", description: "Machine invocation surfaces." },
|
|
33
|
-
{ name: "authority", description: "Authority and delegation surfaces." },
|
|
34
|
-
{ name: "economics", description: "Wallet, trust, and participation surfaces." },
|
|
35
|
-
{ name: "registry", description: "Capability registry surfaces." }
|
|
36
|
-
],
|
|
37
|
-
paths: {
|
|
38
|
-
"/health": {
|
|
39
|
-
get: {
|
|
40
|
-
tags: ["health"],
|
|
41
|
-
summary: "Health check",
|
|
42
|
-
operationId: "getHealth",
|
|
43
|
-
responses: {
|
|
44
|
-
"200": {
|
|
45
|
-
description: "Service health response"
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
},
|
|
50
|
-
"/v1/catalog": {
|
|
51
|
-
get: {
|
|
52
|
-
tags: ["catalog"],
|
|
53
|
-
summary: "Get capability catalog",
|
|
54
|
-
operationId: "getCatalog",
|
|
55
|
-
responses: {
|
|
56
|
-
"200": { description: "Catalog bundle" }
|
|
57
|
-
}
|
|
58
|
-
}
|
|
59
|
-
},
|
|
60
|
-
"/v1/catalog/summary": {
|
|
61
|
-
get: {
|
|
62
|
-
tags: ["catalog"],
|
|
63
|
-
summary: "Get capability catalog summary",
|
|
64
|
-
operationId: "getCatalogSummary",
|
|
65
|
-
responses: {
|
|
66
|
-
"200": { description: "Catalog summary" }
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
},
|
|
70
|
-
"/v1/account-auth/spend-credentials": {
|
|
71
|
-
get: {
|
|
72
|
-
tags: ["authority"],
|
|
73
|
-
summary: "List spend credentials",
|
|
74
|
-
operationId: "listSpendCredentials",
|
|
75
|
-
responses: {
|
|
76
|
-
"200": { description: "Spend credential list" }
|
|
77
|
-
}
|
|
78
|
-
},
|
|
79
|
-
post: {
|
|
80
|
-
tags: ["authority"],
|
|
81
|
-
summary: "Create spend credential",
|
|
82
|
-
operationId: "createSpendCredential",
|
|
83
|
-
responses: {
|
|
84
|
-
"200": { description: "Spend credential created" }
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
},
|
|
88
|
-
"/v1/payment-quotes": {
|
|
89
|
-
post: {
|
|
90
|
-
tags: ["payments"],
|
|
91
|
-
summary: "Create payment quote",
|
|
92
|
-
operationId: "createPaymentQuote",
|
|
93
|
-
responses: {
|
|
94
|
-
"200": { description: "Quote created" },
|
|
95
|
-
"400": { description: "Invalid quote request" }
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
},
|
|
99
|
-
"/v1/commands/execute": {
|
|
100
|
-
post: {
|
|
101
|
-
tags: ["payments"],
|
|
102
|
-
summary: "Execute command through the default commerce path",
|
|
103
|
-
operationId: "executeCommand",
|
|
104
|
-
responses: {
|
|
105
|
-
"200": { description: "Execution accepted" },
|
|
106
|
-
"402": { description: "Payment required or payment challenge" }
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
},
|
|
110
|
-
"/x402/commands/execute": {
|
|
111
|
-
post: {
|
|
112
|
-
tags: ["payments"],
|
|
113
|
-
summary: "Execute command through the x402 payment path",
|
|
114
|
-
operationId: "executeCommandViaX402",
|
|
115
|
-
responses: {
|
|
116
|
-
"200": { description: "Execution accepted" },
|
|
117
|
-
"402": { description: "x402 payment required" }
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
},
|
|
121
|
-
"/v1/mcp/tools/invoke": {
|
|
122
|
-
post: {
|
|
123
|
-
tags: ["mcp"],
|
|
124
|
-
summary: "Invoke an MCP-facing runtime tool",
|
|
125
|
-
operationId: "invokeMcpTool",
|
|
126
|
-
responses: {
|
|
127
|
-
"200": { description: "Tool invocation result" },
|
|
128
|
-
"400": { description: "Invalid invocation request" }
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
},
|
|
132
|
-
"/x402/mcp/tools/invoke": {
|
|
133
|
-
post: {
|
|
134
|
-
tags: ["mcp"],
|
|
135
|
-
summary: "Invoke an MCP-facing runtime tool with x402 payment",
|
|
136
|
-
operationId: "invokeMcpToolViaX402",
|
|
137
|
-
responses: {
|
|
138
|
-
"200": { description: "Tool invocation result" },
|
|
139
|
-
"402": { description: "x402 payment required" }
|
|
140
|
-
}
|
|
141
|
-
}
|
|
142
|
-
},
|
|
143
|
-
"/v1/economics/accounts/{account_id}/wallet-ledger-bundle": {
|
|
144
|
-
get: {
|
|
145
|
-
tags: ["economics"],
|
|
146
|
-
summary: "Inspect the canonical wallet-ledger bundle",
|
|
147
|
-
operationId: "getWalletLedgerBundle",
|
|
148
|
-
parameters: [
|
|
149
|
-
{
|
|
150
|
-
name: "account_id",
|
|
151
|
-
in: "path",
|
|
152
|
-
required: true,
|
|
153
|
-
schema: {
|
|
154
|
-
type: "string"
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
],
|
|
158
|
-
responses: {
|
|
159
|
-
"200": { description: "Wallet-ledger bundle" }
|
|
160
|
-
}
|
|
161
|
-
}
|
|
162
|
-
},
|
|
163
|
-
"/v1/economics/accounts/{account_id}/authority-bundle": {
|
|
164
|
-
get: {
|
|
165
|
-
tags: ["authority"],
|
|
166
|
-
summary: "Inspect canonical account authority posture",
|
|
167
|
-
operationId: "getAuthorityBundle",
|
|
168
|
-
parameters: [
|
|
169
|
-
{
|
|
170
|
-
name: "account_id",
|
|
171
|
-
in: "path",
|
|
172
|
-
required: true,
|
|
173
|
-
schema: {
|
|
174
|
-
type: "string"
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
],
|
|
178
|
-
responses: {
|
|
179
|
-
"200": { description: "Authority bundle" }
|
|
180
|
-
}
|
|
181
|
-
}
|
|
182
|
-
},
|
|
183
|
-
"/v1/economics/accounts/{account_id}/machine-identity-operator-bundle": {
|
|
184
|
-
get: {
|
|
185
|
-
tags: ["economics"],
|
|
186
|
-
summary: "Inspect canonical machine identity posture",
|
|
187
|
-
operationId: "getMachineIdentityOperatorBundle",
|
|
188
|
-
parameters: [
|
|
189
|
-
{
|
|
190
|
-
name: "account_id",
|
|
191
|
-
in: "path",
|
|
192
|
-
required: true,
|
|
193
|
-
schema: {
|
|
194
|
-
type: "string"
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
],
|
|
198
|
-
responses: {
|
|
199
|
-
"200": { description: "Machine identity operator bundle" }
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
},
|
|
203
|
-
"/v1/capability-registry/package": {
|
|
204
|
-
get: {
|
|
205
|
-
tags: ["registry"],
|
|
206
|
-
summary: "Inspect canonical capability registry package",
|
|
207
|
-
operationId: "getCapabilityRegistryPackage",
|
|
208
|
-
parameters: [
|
|
209
|
-
{
|
|
210
|
-
name: "account_id",
|
|
211
|
-
in: "query",
|
|
212
|
-
required: false,
|
|
213
|
-
schema: {
|
|
214
|
-
type: "string"
|
|
215
|
-
}
|
|
216
|
-
}
|
|
217
|
-
],
|
|
218
|
-
responses: {
|
|
219
|
-
"200": { description: "Capability registry package" }
|
|
220
|
-
}
|
|
221
|
-
}
|
|
222
|
-
},
|
|
223
|
-
"/v1/economics/accounts/{account_id}/trust-layer-package": {
|
|
224
|
-
get: {
|
|
225
|
-
tags: ["economics"],
|
|
226
|
-
summary: "Inspect canonical trust-layer package",
|
|
227
|
-
operationId: "getTrustLayerPackage",
|
|
228
|
-
parameters: [
|
|
229
|
-
{
|
|
230
|
-
name: "account_id",
|
|
231
|
-
in: "path",
|
|
232
|
-
required: true,
|
|
233
|
-
schema: {
|
|
234
|
-
type: "string"
|
|
235
|
-
}
|
|
236
|
-
}
|
|
237
|
-
],
|
|
238
|
-
responses: {
|
|
239
|
-
"200": { description: "Trust-layer package" }
|
|
240
|
-
}
|
|
241
|
-
}
|
|
242
|
-
},
|
|
243
|
-
"/v1/economics/accounts/{account_id}/network-participation-package": {
|
|
244
|
-
get: {
|
|
245
|
-
tags: ["economics"],
|
|
246
|
-
summary: "Inspect external network participation package",
|
|
247
|
-
operationId: "getNetworkParticipationPackage",
|
|
248
|
-
parameters: [
|
|
249
|
-
{
|
|
250
|
-
name: "account_id",
|
|
251
|
-
in: "path",
|
|
252
|
-
required: true,
|
|
253
|
-
schema: {
|
|
254
|
-
type: "string"
|
|
255
|
-
}
|
|
256
|
-
}
|
|
257
|
-
],
|
|
258
|
-
responses: {
|
|
259
|
-
"200": { description: "Network participation package" }
|
|
260
|
-
}
|
|
261
|
-
}
|
|
262
|
-
}
|
|
263
|
-
},
|
|
264
|
-
"x-naxytra-contract": {
|
|
265
|
-
product: "xytara",
|
|
266
|
-
stability: "stable_public_http_layer",
|
|
267
|
-
route_count: 14,
|
|
268
|
-
target_audience: ["builders", "partners", "operators"],
|
|
269
|
-
linked_docs: [
|
|
270
|
-
"SERVICE_CONTRACT.md",
|
|
271
|
-
"FINAL_CONTRACT.md",
|
|
272
|
-
"START_HERE.md"
|
|
273
|
-
]
|
|
274
|
-
}
|
|
275
|
-
};
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
function summarizeOpenApiDocument() {
|
|
279
|
-
const document = buildOpenApiDocument();
|
|
280
|
-
return {
|
|
281
|
-
product: "xytara",
|
|
282
|
-
category: "machine-commerce-openapi-contract-summary",
|
|
283
|
-
summary_version: "xytara-openapi-contract-summary-v1",
|
|
284
|
-
openapi_version: document.openapi,
|
|
285
|
-
info_version: document.info.version,
|
|
286
|
-
path_count: Object.keys(document.paths).length,
|
|
287
|
-
server_count: document.servers.length,
|
|
288
|
-
primary_protocol_lanes: ["http", "mcp", "x402"],
|
|
289
|
-
linked_surfaces: {
|
|
290
|
-
openapi_ref: "/openapi.json",
|
|
291
|
-
service_contract_ref: "SERVICE_CONTRACT.md",
|
|
292
|
-
final_contract_ref: "FINAL_CONTRACT.md"
|
|
293
|
-
}
|
|
294
|
-
};
|
|
295
|
-
}
|
|
296
|
-
|
|
297
|
-
module.exports = {
|
|
298
|
-
buildOpenApiDocument,
|
|
299
|
-
summarizeOpenApiDocument
|
|
300
|
-
};
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const packageJson = require("../package.json");
|
|
4
|
-
|
|
5
|
-
function buildOperationalReceiptContractPack() {
|
|
6
|
-
return {
|
|
7
|
-
ok: true,
|
|
8
|
-
product: packageJson.name,
|
|
9
|
-
category: "naxytra-operational-receipt-contract",
|
|
10
|
-
pack_version: "naxytra-operational-receipt-contract-v1",
|
|
11
|
-
doctrine: "xytara_emits_shared_operational_receipts_for_runtime_and_economic_actions_without_collapsing_into_proof_semantics",
|
|
12
|
-
model_state: "core_now",
|
|
13
|
-
core_claim: "operational receipts are the shared runtime evidence record for important machine actions across the naxytra stack",
|
|
14
|
-
canonical_objects: [
|
|
15
|
-
{
|
|
16
|
-
object_id: "operational_receipt",
|
|
17
|
-
role: "signed_minimal_evidence_record_for_one_important_action",
|
|
18
|
-
required_fields: [
|
|
19
|
-
"version",
|
|
20
|
-
"receipt_id",
|
|
21
|
-
"timestamp_ns",
|
|
22
|
-
"actor_id",
|
|
23
|
-
"action_type",
|
|
24
|
-
"payload_hash",
|
|
25
|
-
"signature"
|
|
26
|
-
],
|
|
27
|
-
recommended_fields: [
|
|
28
|
-
"signature_suite",
|
|
29
|
-
"source_system",
|
|
30
|
-
"correlation_id",
|
|
31
|
-
"parent_receipt_id",
|
|
32
|
-
"reference_kind",
|
|
33
|
-
"reference_id"
|
|
34
|
-
],
|
|
35
|
-
optional_fields: [
|
|
36
|
-
"proof_ref",
|
|
37
|
-
"anchor_ref",
|
|
38
|
-
"settlement_ref",
|
|
39
|
-
"ledger_ref",
|
|
40
|
-
"payload_uri",
|
|
41
|
-
"payload_hash_alg",
|
|
42
|
-
"actor_role",
|
|
43
|
-
"metadata"
|
|
44
|
-
],
|
|
45
|
-
primary_surfaces: [
|
|
46
|
-
"/v1/receipts",
|
|
47
|
-
"/v1/receipts/:receipt_id",
|
|
48
|
-
"/v1/economics/receipts",
|
|
49
|
-
"/v1/economics/receipts/:receipt_id/lifecycle",
|
|
50
|
-
"/v1/economics/receipts/:receipt_id/operator-action"
|
|
51
|
-
]
|
|
52
|
-
}
|
|
53
|
-
],
|
|
54
|
-
receipt_kinds: [
|
|
55
|
-
{
|
|
56
|
-
receipt_kind: "document_published",
|
|
57
|
-
description: "binds a published document or release artifact to a signed evidence record"
|
|
58
|
-
},
|
|
59
|
-
{
|
|
60
|
-
receipt_kind: "api_request_completed",
|
|
61
|
-
description: "binds a completed machine request or API call to a signed evidence record"
|
|
62
|
-
},
|
|
63
|
-
{
|
|
64
|
-
receipt_kind: "payment_received",
|
|
65
|
-
description: "binds an incoming payment or credited admission event to a signed evidence record"
|
|
66
|
-
},
|
|
67
|
-
{
|
|
68
|
-
receipt_kind: "file_generated",
|
|
69
|
-
description: "binds a generated file or artifact to a signed evidence record"
|
|
70
|
-
},
|
|
71
|
-
{
|
|
72
|
-
receipt_kind: "agent_task_executed",
|
|
73
|
-
description: "binds an executed agent task or workflow step to a signed evidence record"
|
|
74
|
-
},
|
|
75
|
-
{
|
|
76
|
-
receipt_kind: "repo_release_created",
|
|
77
|
-
description: "binds a release tag or package release event to a signed evidence record"
|
|
78
|
-
},
|
|
79
|
-
{
|
|
80
|
-
receipt_kind: "proposal_sent",
|
|
81
|
-
description: "binds a proposal or offer dispatch to a signed evidence record"
|
|
82
|
-
},
|
|
83
|
-
{
|
|
84
|
-
receipt_kind: "invoice_issued",
|
|
85
|
-
description: "binds an issued invoice or billable statement to a signed evidence record"
|
|
86
|
-
},
|
|
87
|
-
{
|
|
88
|
-
receipt_kind: "partner_handoff_completed",
|
|
89
|
-
description: "binds a partner handoff or transfer completion to a signed evidence record"
|
|
90
|
-
}
|
|
91
|
-
],
|
|
92
|
-
lineage_model: [
|
|
93
|
-
{
|
|
94
|
-
layer_id: "runtime_action",
|
|
95
|
-
order_index: 1,
|
|
96
|
-
objects: ["operational_receipt"],
|
|
97
|
-
invariants: [
|
|
98
|
-
"the_receipt_records_one_action_in_one_versioned_shape",
|
|
99
|
-
"the_receipt_is_minimal_and_replay_safe"
|
|
100
|
-
]
|
|
101
|
-
},
|
|
102
|
-
{
|
|
103
|
-
layer_id: "evidence_portability",
|
|
104
|
-
order_index: 2,
|
|
105
|
-
objects: ["operational_receipt"],
|
|
106
|
-
invariants: [
|
|
107
|
-
"the_receipt_can_be_exported_or_bundled_without_runtime_lock_in",
|
|
108
|
-
"the_receipt_can_be_verified_offline_when_the_canonical_inputs_are_available"
|
|
109
|
-
]
|
|
110
|
-
},
|
|
111
|
-
{
|
|
112
|
-
layer_id: "proof_followthrough",
|
|
113
|
-
order_index: 3,
|
|
114
|
-
objects: ["operational_receipt"],
|
|
115
|
-
invariants: [
|
|
116
|
-
"proof_layers_may_wrap_receipts_without_redefining_the_base_receipt_meaning",
|
|
117
|
-
"settlement_and_anchor_refs_are_followthrough_layers_not_core_validity_requirements"
|
|
118
|
-
]
|
|
119
|
-
}
|
|
120
|
-
],
|
|
121
|
-
invariants: [
|
|
122
|
-
"payload_hash_is_bound_to_the_canonical_payload_or_source_artifact",
|
|
123
|
-
"signature_covers_the_canonical_receipt_body_without_the_signature_field",
|
|
124
|
-
"timestamp_ns_is_capture_time_not_authoritative_ordering",
|
|
125
|
-
"optional_reference_fields_do_not_change_base_receipt_validity",
|
|
126
|
-
"operational_receipts_are_the_shared_evidence_surface_for_xytara_and_xoonya"
|
|
127
|
-
],
|
|
128
|
-
linked_surfaces: {
|
|
129
|
-
receipts_ref: "/v1/receipts",
|
|
130
|
-
receipt_detail_ref: "/v1/receipts/:receipt_id",
|
|
131
|
-
economics_receipts_ref: "/v1/economics/receipts",
|
|
132
|
-
economics_receipt_lifecycle_ref: "/v1/economics/receipts/:receipt_id/lifecycle",
|
|
133
|
-
economics_receipt_operator_action_ref: "/v1/economics/receipts/:receipt_id/operator-action"
|
|
134
|
-
},
|
|
135
|
-
claim_boundary: "claim_the_runtime_side_shared_operational_receipt_contract_only_without_claiming_proof_validity_settlement_finality_or_universal_identity_truth"
|
|
136
|
-
};
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
function summarizeOperationalReceiptContractPack() {
|
|
140
|
-
const pack = buildOperationalReceiptContractPack();
|
|
141
|
-
return {
|
|
142
|
-
ok: true,
|
|
143
|
-
product: pack.product,
|
|
144
|
-
category: pack.category,
|
|
145
|
-
summary_version: "naxytra-operational-receipt-contract-summary-v1",
|
|
146
|
-
pack_version: pack.pack_version,
|
|
147
|
-
model_state: pack.model_state,
|
|
148
|
-
receipt_kind_count: pack.receipt_kinds.length,
|
|
149
|
-
canonical_object_count: pack.canonical_objects.length,
|
|
150
|
-
layer_count: pack.lineage_model.length,
|
|
151
|
-
invariant_count: pack.invariants.length,
|
|
152
|
-
linked_surfaces: pack.linked_surfaces
|
|
153
|
-
};
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
function getOperationalReceiptKindDetail(receiptKind) {
|
|
157
|
-
const normalized = String(receiptKind || "").trim().toLowerCase();
|
|
158
|
-
return (buildOperationalReceiptContractPack().receipt_kinds || []).find((entry) => entry.receipt_kind === normalized) || null;
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
module.exports = {
|
|
162
|
-
buildOperationalReceiptContractPack,
|
|
163
|
-
summarizeOperationalReceiptContractPack,
|
|
164
|
-
getOperationalReceiptKindDetail
|
|
165
|
-
};
|