xytara 3.1.0 → 3.1.2

package/lib/default_path_contract.js

@@ -1,412 +1,412 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { summarizeExecutionTruthModelPack } = require("./execution_truth_contract");
-const { summarizeFirstRunConversionPack } = require("./first_run_conversion_contract");
-const { summarizeRevenueLaunchPathPack } = require("./revenue_launch_path_contract");
-const { summarizeProviderRuntimeJourneyPack } = require("./provider_runtime_journey_contract");
-const { summarizeProtocolLanePack } = require("./protocol_lane_contract");
-const { buildCheckoutEventSecuritySummary } = require("./checkout_event_security");
-
-function uniqueSorted(values) {
-  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
-}
-
-function buildStages(stageEntries) {
-  return (Array.isArray(stageEntries) ? stageEntries : []).map((entry, index) => ({
-    stage_index: index + 1,
-    ...entry
-  }));
-}
-
-function buildSurface(entry) {
-  const stages = buildStages(entry.stages);
-  return {
-    surface_id: entry.surface_id,
-    surface_label: entry.surface_label,
-    surface_kind: entry.surface_kind,
-    interaction_modes: uniqueSorted(entry.interaction_modes),
-    actor_classes: uniqueSorted(entry.actor_classes),
-    real_time_ready: true,
-    quote_ready: stages.some((stage) => stage.stage_id === "quote"),
-    funded_execution_ready: stages.some((stage) => stage.stage_id === "fund" || stage.stage_id === "execute"),
-    deliverable_ready: stages.some((stage) => stage.stage_id === "deliver" || stage.stage_id === "execute"),
-    proof_followthrough_ready: stages.some((stage) => stage.stage_id === "prove"),
-    stage_count: stages.length,
-    default_payment_posture: entry.default_payment_posture,
-    primary_entrypoints: uniqueSorted(entry.primary_entrypoints),
-    primary_deliverable_posture: entry.primary_deliverable_posture,
-    default_handoff_ref: entry.default_handoff_ref,
-    stages,
-    supporting_surfaces: uniqueSorted(entry.supporting_surfaces),
-    claim_boundary: entry.claim_boundary
-  };
-}
-
-function buildDefaultPathPack() {
-  const executionTruthSummary = summarizeExecutionTruthModelPack();
-  const firstRunSummary = summarizeFirstRunConversionPack();
-  const revenueSummary = summarizeRevenueLaunchPathPack();
-  const providerJourneySummary = summarizeProviderRuntimeJourneyPack();
-  const protocolSummary = summarizeProtocolLanePack();
-  const checkoutSecurity = buildCheckoutEventSecuritySummary();
-
-  const surfaces = [
-    buildSurface({
-      surface_id: "cli_terminal",
-      surface_label: "CLI and terminal",
-      surface_kind: "human_or_operator_shell_surface",
-      interaction_modes: ["cli", "terminal"],
-      actor_classes: ["human", "operator", "developer", "agent"],
-      default_payment_posture: "quote_first_then_credits_first_or_direct_x402",
-      primary_entrypoints: [
-        "xytara start-here",
-        "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
-        "xytara first-run --execute-with-credits --account ACCOUNT_REF --pretty",
-        "xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json \"{\\\"tool_name\\\":\\\"summarize\\\",\\\"arguments\\\":{\\\"text\\\":\\\"Summarize the naxytra first-run path in one sentence.\\\"}}\" --quote-only --pretty"
-      ],
-      primary_deliverable_posture: "stdout_json_and_runtime_result_ref_with_optional_proof_handoff",
-      default_handoff_ref: "xoonya first-run --verify-native --pretty",
-      stages: [
-        {
-          stage_id: "discover",
-          surface_ref: "xytara start-here",
-          expected_outcome: "outside builder or operator can discover the package-native default path immediately after install"
-        },
-        {
-          stage_id: "quote",
-          surface_ref: "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
-          expected_outcome: "quote-only path produces a safe payment-required challenge without spending funds or requiring wallet secrets"
-        },
-        {
-          stage_id: "fund",
-          surface_ref: "/v1/credit-packs/summary",
-          expected_outcome: "caller chooses reusable credits-first spend or prepares direct machine payment after quote inspection"
-        },
-        {
-          stage_id: "execute",
-          surface_ref: "xytara first-run --execute-with-credits --account ACCOUNT_REF --pretty",
-          expected_outcome: "runtime work executes from the shell without leaving the caller's current surface"
-        },
-        {
-          stage_id: "prove",
-          surface_ref: "xoonya first-run --verify-native --pretty",
-          expected_outcome: "shell caller continues from runtime completion into proof review and verification"
-        },
-        {
-          stage_id: "inspect",
-          surface_ref: "/v1/payment-ledger",
-          expected_outcome: "operator or builder can inspect transaction, payment, and reconciliation state after execution"
-        }
-      ],
-      supporting_surfaces: [
-        "https://www.naxytra.com/v1/first-run-path",
-        "https://www.naxytra.com/v1/first-run-kit",
-        "/v1/first-run/conversions/summary",
-        "/v1/revenue-launch/paths/summary"
-      ],
-      claim_boundary: "claim_cli_terminal_default_path_only_for_the_listed_install_quote_fund_execute_prove_and_inspection_surfaces_not_as_unbounded_local_wallet_or_provider_control"
-    }),
-    buildSurface({
-      surface_id: "direct_api",
-      surface_label: "Direct API",
-      surface_kind: "http_api_surface",
-      interaction_modes: ["api", "http"],
-      actor_classes: ["agent", "machine", "developer", "human", "enterprise"],
-      default_payment_posture: "credits_first_on_governed_execute_or_direct_x402_for_machine_paywall",
-      primary_entrypoints: [
-        "/v1/providers",
-        "/v1/commands/execute",
-        "/x402/commands/execute"
-      ],
-      primary_deliverable_posture: "json_response_plus_result_package_export_and_delivery_state",
-      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run",
-      stages: [
-        {
-          stage_id: "discover",
-          surface_ref: "/v1/providers",
-          expected_outcome: "caller discovers supported provider and runtime posture through machine-readable HTTP surfaces"
-        },
-        {
-          stage_id: "quote",
-          surface_ref: "/v1/payment-quotes",
-          expected_outcome: "machine or application requests a bounded quote before execution"
-        },
-        {
-          stage_id: "fund",
-          surface_ref: "/v1/credit-packs/summary",
-          expected_outcome: "caller selects credits-first spend or prepares x402 payment replay without changing execution semantics"
-        },
-        {
-          stage_id: "execute",
-          surface_ref: "/v1/commands/execute",
-          expected_outcome: "governed runtime execution returns runtime truth, delivery state, and proof-compatible facts"
-        },
-        {
-          stage_id: "deliver",
-          surface_ref: "/v1/transaction-center/result-packages/export-template",
-          expected_outcome: "application can export a portable result package directly from the API path"
-        },
-        {
-          stage_id: "prove",
-          surface_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run",
-          expected_outcome: "API consumer continues into proof-native review and verification without translation gaps"
-        }
-      ],
-      supporting_surfaces: [
-        "/v1/execution-truth",
-        "/v1/lifecycle-continuity/summary",
-        "/v1/transaction-center/result-packages/summary",
-        "/openapi.json"
-      ],
-      claim_boundary: "claim_direct_api_default_path_only_for_the_listed_http_quote_fund_execute_delivery_and_proof_handoff_surfaces_not_as_generic_transport_or_unbounded_external_settlement_ownership"
-    }),
-    buildSurface({
-      surface_id: "browser_checkout",
-      surface_label: "Browser and hosted checkout",
-      surface_kind: "browser_checkout_surface",
-      interaction_modes: ["browser", "checkout"],
-      actor_classes: ["human", "enterprise", "operator"],
-      default_payment_posture: "hosted_checkout_money_in_then_internal_credits_or_runtime_authorization",
-      primary_entrypoints: [
-        "/v1/checkout/purchase-intents",
-        "/v1/checkout/purchase-intents/:purchase_intent_id/session",
-        "/v1/runtime-bridge/dispatch"
-      ],
-      primary_deliverable_posture: "hosted_checkout_to_runtime_dispatch_then_same_runtime_and_proof_spine",
-      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/summary",
-      stages: [
-        {
-          stage_id: "discover",
-          surface_ref: "/v1/revenue-launch/paths/hosted_checkout_credits_execution_proof",
-          expected_outcome: "buyer can inspect the hosted checkout launch path before entering payment"
-        },
-        {
-          stage_id: "quote",
-          surface_ref: "/v1/checkout/purchase-intents",
-          expected_outcome: "browser flow creates a bounded purchase intent tied to a real sellable runtime path"
-        },
-        {
-          stage_id: "fund",
-          surface_ref: "/v1/checkout/purchase-intents/:purchase_intent_id/session",
-          expected_outcome: "caller pays using the hosted front they are most comfortable in while xytara keeps one runtime truth spine"
-        },
-        {
-          stage_id: "execute",
-          surface_ref: "/v1/runtime-bridge/dispatch",
-          expected_outcome: "paid browser-side purchase converges back into the same runtime execution engine"
-        },
-        {
-          stage_id: "deliver",
-          surface_ref: "/v1/operator-export-pack",
-          expected_outcome: "delivery, operator review, and reconciliation remain inspectable after checkout-driven execution"
-        },
-        {
-          stage_id: "prove",
-          surface_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/summary",
-          expected_outcome: "browser-paid work continues into the same proof followthrough posture as other surfaces"
-        }
-      ],
-      supporting_surfaces: [
-        "/v1/checkout/events/security",
-        "/v1/checkout/events/normalize",
-        "/v1/reconciliation-report",
-        "/v1/economics/accounts/:account_id/credit-balance"
-      ],
-      claim_boundary: "claim_browser_checkout_default_path_only_for_the_listed_purchase_intent_checkout_dispatch_reconciliation_and_proof_handoff_surfaces_not_as_public_checkout_processor_or_custody_control"
-    }),
-    buildSurface({
-      surface_id: "chat_agent",
-      surface_label: "Chat window and agent runtime",
-      surface_kind: "agent_protocol_surface",
-      interaction_modes: ["chat", "agent", "mcp", "a2a", "a2c"],
-      actor_classes: ["agent", "machine", "human", "enterprise"],
-      default_payment_posture: "quote_first_then_credits_first_or_x402_inside_named_protocol_lanes",
-      primary_entrypoints: [
-        "/v1/mcp",
-        "/v1/a2a",
-        "/v1/a2c",
-        "/v1/mcp/tools/invoke"
-      ],
-      primary_deliverable_posture: "protocol-native runtime output with portable result-package followthrough",
-      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
-      stages: [
-        {
-          stage_id: "discover",
-          surface_ref: "/v1/protocols",
-          expected_outcome: "agent caller discovers the canonical protocol lanes without private interpretation"
-        },
-        {
-          stage_id: "quote",
-          surface_ref: "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
-          expected_outcome: "agent-side first contact can still begin with the same safe quote-first posture"
-        },
-        {
-          stage_id: "fund",
-          surface_ref: "/v1/x402/summary",
-          expected_outcome: "chat or agent runtime chooses machine paywall or funded credits-first posture before invocation"
-        },
-        {
-          stage_id: "execute",
-          surface_ref: "/v1/mcp/tools/invoke",
-          expected_outcome: "agent runtime invokes the default tool lane from inside the surface it already inhabits"
-        },
-        {
-          stage_id: "deliver",
-          surface_ref: "/v1/a2c/flows/tooling",
-          expected_outcome: "session-backed tooling exchange and result carry stay inside agent-native protocol posture"
-        },
-        {
-          stage_id: "prove",
-          surface_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
-          expected_outcome: "agent-visible verification surfaces can confirm the runtime handoff outcome"
-        }
-      ],
-      supporting_surfaces: [
-        "/v1/providers/journeys/summary",
-        "/v1/full-catalog/market-lanes/traces/summary",
-        "/v1/full-catalog/market-lanes/promotion/summary"
-      ],
-      claim_boundary: "claim_chat_agent_default_path_only_for_the_listed_mcp_a2a_a2c_quote_fund_execute_delivery_and_verification_surfaces_not_as_unbounded_protocol_ecosystem_ownership"
-    }),
-    buildSurface({
-      surface_id: "service_to_service",
-      surface_label: "Service-to-service and automation",
-      surface_kind: "backend_automation_surface",
-      interaction_modes: ["service_to_service", "automation", "webhook", "dispatch"],
-      actor_classes: ["machine", "enterprise", "operator", "agent"],
-      default_payment_posture: "credits_first_or_pre-authorized_runtime_dispatch_with_checkout_and_callback_guardrails",
-      primary_entrypoints: [
-        "/v1/runtime-bridge/dispatch",
-        "/v1/runtime-bridge/dispatches",
-        "/v1/commands/execute"
-      ],
-      primary_deliverable_posture: "callback_or_polled_runtime_delivery_with_same_execution_truth_and_result_package_spine",
-      default_handoff_ref: "/v1/transaction-center/result-packages/export",
-      stages: [
-        {
-          stage_id: "discover",
-          surface_ref: "/v1/runtime-bridge/dispatches",
-          expected_outcome: "backend caller can inspect dispatch posture and prior requests before wiring real automation"
-        },
-        {
-          stage_id: "quote",
-          surface_ref: "/v1/payment-quotes",
-          expected_outcome: "service can quote work before attempting autonomous dispatch or callback-bound execution"
-        },
-        {
-          stage_id: "fund",
-          surface_ref: "/v1/economics/accounts/:account_id/credit-balance",
-          expected_outcome: "automation lane confirms funded posture or prepares payment admission before execution"
-        },
-        {
-          stage_id: "execute",
-          surface_ref: "/v1/runtime-bridge/dispatch",
-          expected_outcome: "service triggers runtime work and receives a dispatch record suitable for polling or callback followthrough"
-        },
-        {
-          stage_id: "deliver",
-          surface_ref: "/v1/deliveries",
-          expected_outcome: "deliverable and callback truth remain machine-readable for downstream systems"
-        },
-        {
-          stage_id: "prove",
-          surface_ref: "/v1/transaction-center/result-packages/export",
-          expected_outcome: "backend system can export a proof-ready handoff bundle without leaving the automation path"
-        }
-      ],
-      supporting_surfaces: [
-        "/v1/execution-truth/summary",
-        "/v1/deliveries/summary",
-        "/v1/payment-ledger",
-        "/asyncapi.json",
-        "/cloudevents.json"
-      ],
-      claim_boundary: "claim_service_to_service_default_path_only_for_the_listed_dispatch_execute_delivery_and_proof_export_surfaces_not_as_generic_callback_network_or_unbounded_partner_runtime_control"
-    })
-  ];
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-default-path-model",
-    pack_version: "xytara-default-path-model-v1",
-    posture: "multi_surface_real_time_default_path",
-    model_state: "frozen_for_3_0_0_closeout",
-    doctrine: "every_supported_surface_should_converge_on_one_quote_fund_execute_deliver_prove_spine_so_the_public_runtime_story_stays true across cli browser api agent and automation entrypoints",
-    core_claim: "xytara can meet callers where they already are while keeping one runtime, payment, delivery, and proof-handoff truth model",
-    default_path_order: [
-      "discover",
-      "quote",
-      "fund",
-      "execute",
-      "deliver",
-      "prove",
-      "inspect"
-    ],
-    supported_surface_count: surfaces.length,
-    real_time_ready_surface_count: surfaces.filter((entry) => entry.real_time_ready).length,
-    quote_ready_surface_count: surfaces.filter((entry) => entry.quote_ready).length,
-    deliverable_ready_surface_count: surfaces.filter((entry) => entry.deliverable_ready).length,
-    proof_followthrough_ready_surface_count: surfaces.filter((entry) => entry.proof_followthrough_ready).length,
-    surfaces,
-    universal_invariants: [
-      "every_default_path_must_begin_with_public_discovery_or_start_here_guidance",
-      "every_default_path_must_support_quote_or_pre-execution_intent_before_irreversible_spend",
-      "every_default_path_must_converge_back_into_the_same_execution_truth_model",
-      "every_default_path_must_return_the_deliverable_to_the_surface_where_the_caller_is_already_operating",
-      "every_default_path_must_preserve_proof-ready_followthrough_into_xoonya",
-      "surface_specific_payment_fronts_must_not_split_the_runtime_fact_model"
-    ],
-    linked_summaries: {
-      execution_truth_summary: executionTruthSummary,
-      first_run_conversion_summary: firstRunSummary,
-      revenue_launch_path_summary: revenueSummary,
-      provider_runtime_journey_summary: providerJourneySummary,
-      protocol_lane_summary: protocolSummary,
-      checkout_event_security_summary: checkoutSecurity
-    },
-    linked_surfaces: {
-      start_here_ref: "START_HERE.md",
-      first_run_path_ref: "https://www.naxytra.com/v1/first-run-path",
-      first_run_kit_ref: "https://www.naxytra.com/v1/first-run-kit",
-      first_run_conversions_ref: "/v1/first-run/conversions",
-      revenue_launch_paths_ref: "/v1/revenue-launch/paths",
-      providers_journeys_ref: "/v1/providers/journeys",
-      protocols_ref: "/v1/protocols",
-      execution_truth_ref: "/v1/execution-truth",
-      xoonya_result_package_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
-    },
-    claim_boundary: "claim_only_the_listed_multi_surface_default_paths_and_their_shared_runtime_spine_without_implying_unbounded_wallet_checkout_transport_or_partner_platform_ownership"
-  };
-}
-
-function summarizeDefaultPathPack() {
-  const pack = buildDefaultPathPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    summary_version: "xytara-default-path-model-summary-v1",
-    pack_version: pack.pack_version,
-    model_state: pack.model_state,
-    supported_surface_count: pack.supported_surface_count,
-    real_time_ready_surface_count: pack.real_time_ready_surface_count,
-    quote_ready_surface_count: pack.quote_ready_surface_count,
-    deliverable_ready_surface_count: pack.deliverable_ready_surface_count,
-    proof_followthrough_ready_surface_count: pack.proof_followthrough_ready_surface_count,
-    default_path_stage_count: pack.default_path_order.length,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-function getDefaultPathSurfaceDetail(surfaceId) {
-  const normalized = String(surfaceId || "").trim().toLowerCase();
-  return (buildDefaultPathPack().surfaces || []).find((entry) => entry.surface_id === normalized) || null;
-}
-
-module.exports = {
-  buildDefaultPathPack,
-  summarizeDefaultPathPack,
-  getDefaultPathSurfaceDetail
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizeExecutionTruthModelPack } = require("./execution_truth_contract");
+const { summarizeFirstRunConversionPack } = require("./first_run_conversion_contract");
+const { summarizeRevenueLaunchPathPack } = require("./revenue_launch_path_contract");
+const { summarizeProviderRuntimeJourneyPack } = require("./provider_runtime_journey_contract");
+const { summarizeProtocolLanePack } = require("./protocol_lane_contract");
+const { buildCheckoutEventSecuritySummary } = require("./checkout_event_security");
+
+function uniqueSorted(values) {
+  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
+}
+
+function buildStages(stageEntries) {
+  return (Array.isArray(stageEntries) ? stageEntries : []).map((entry, index) => ({
+    stage_index: index + 1,
+    ...entry
+  }));
+}
+
+function buildSurface(entry) {
+  const stages = buildStages(entry.stages);
+  return {
+    surface_id: entry.surface_id,
+    surface_label: entry.surface_label,
+    surface_kind: entry.surface_kind,
+    interaction_modes: uniqueSorted(entry.interaction_modes),
+    actor_classes: uniqueSorted(entry.actor_classes),
+    real_time_ready: true,
+    quote_ready: stages.some((stage) => stage.stage_id === "quote"),
+    funded_execution_ready: stages.some((stage) => stage.stage_id === "fund" || stage.stage_id === "execute"),
+    deliverable_ready: stages.some((stage) => stage.stage_id === "deliver" || stage.stage_id === "execute"),
+    proof_followthrough_ready: stages.some((stage) => stage.stage_id === "prove"),
+    stage_count: stages.length,
+    default_payment_posture: entry.default_payment_posture,
+    primary_entrypoints: uniqueSorted(entry.primary_entrypoints),
+    primary_deliverable_posture: entry.primary_deliverable_posture,
+    default_handoff_ref: entry.default_handoff_ref,
+    stages,
+    supporting_surfaces: uniqueSorted(entry.supporting_surfaces),
+    claim_boundary: entry.claim_boundary
+  };
+}
+
+function buildDefaultPathPack() {
+  const executionTruthSummary = summarizeExecutionTruthModelPack();
+  const firstRunSummary = summarizeFirstRunConversionPack();
+  const revenueSummary = summarizeRevenueLaunchPathPack();
+  const providerJourneySummary = summarizeProviderRuntimeJourneyPack();
+  const protocolSummary = summarizeProtocolLanePack();
+  const checkoutSecurity = buildCheckoutEventSecuritySummary();
+
+  const surfaces = [
+    buildSurface({
+      surface_id: "cli_terminal",
+      surface_label: "CLI and terminal",
+      surface_kind: "human_or_operator_shell_surface",
+      interaction_modes: ["cli", "terminal"],
+      actor_classes: ["human", "operator", "developer", "agent"],
+      default_payment_posture: "quote_first_then_credits_first_or_direct_x402",
+      primary_entrypoints: [
+        "xytara start-here",
+        "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
+        "xytara first-run --execute-with-credits --account ACCOUNT_REF --pretty",
+        "xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json \"{\\\"tool_name\\\":\\\"summarize\\\",\\\"arguments\\\":{\\\"text\\\":\\\"Summarize the naxytra first-run path in one sentence.\\\"}}\" --quote-only --pretty"
+      ],
+      primary_deliverable_posture: "stdout_json_and_runtime_result_ref_with_optional_proof_handoff",
+      default_handoff_ref: "xoonya first-run --verify-native --pretty",
+      stages: [
+        {
+          stage_id: "discover",
+          surface_ref: "xytara start-here",
+          expected_outcome: "outside builder or operator can discover the package-native default path immediately after install"
+        },
+        {
+          stage_id: "quote",
+          surface_ref: "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
+          expected_outcome: "quote-only path produces a safe payment-required challenge without spending funds or requiring wallet secrets"
+        },
+        {
+          stage_id: "fund",
+          surface_ref: "/v1/credit-packs/summary",
+          expected_outcome: "caller chooses reusable credits-first spend or prepares direct machine payment after quote inspection"
+        },
+        {
+          stage_id: "execute",
+          surface_ref: "xytara first-run --execute-with-credits --account ACCOUNT_REF --pretty",
+          expected_outcome: "runtime work executes from the shell without leaving the caller's current surface"
+        },
+        {
+          stage_id: "prove",
+          surface_ref: "xoonya first-run --verify-native --pretty",
+          expected_outcome: "shell caller continues from runtime completion into proof review and verification"
+        },
+        {
+          stage_id: "inspect",
+          surface_ref: "/v1/payment-ledger",
+          expected_outcome: "operator or builder can inspect transaction, payment, and reconciliation state after execution"
+        }
+      ],
+      supporting_surfaces: [
+        "https://www.naxytra.com/v1/first-run-path",
+        "https://www.naxytra.com/v1/first-run-kit",
+        "/v1/first-run/conversions/summary",
+        "/v1/revenue-launch/paths/summary"
+      ],
+      claim_boundary: "claim_cli_terminal_default_path_only_for_the_listed_install_quote_fund_execute_prove_and_inspection_surfaces_not_as_unbounded_local_wallet_or_provider_control"
+    }),
+    buildSurface({
+      surface_id: "direct_api",
+      surface_label: "Direct API",
+      surface_kind: "http_api_surface",
+      interaction_modes: ["api", "http"],
+      actor_classes: ["agent", "machine", "developer", "human", "enterprise"],
+      default_payment_posture: "credits_first_on_governed_execute_or_direct_x402_for_machine_paywall",
+      primary_entrypoints: [
+        "/v1/providers",
+        "/v1/commands/execute",
+        "/x402/commands/execute"
+      ],
+      primary_deliverable_posture: "json_response_plus_result_package_export_and_delivery_state",
+      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run",
+      stages: [
+        {
+          stage_id: "discover",
+          surface_ref: "/v1/providers",
+          expected_outcome: "caller discovers supported provider and runtime posture through machine-readable HTTP surfaces"
+        },
+        {
+          stage_id: "quote",
+          surface_ref: "/v1/payment-quotes",
+          expected_outcome: "machine or application requests a bounded quote before execution"
+        },
+        {
+          stage_id: "fund",
+          surface_ref: "/v1/credit-packs/summary",
+          expected_outcome: "caller selects credits-first spend or prepares x402 payment replay without changing execution semantics"
+        },
+        {
+          stage_id: "execute",
+          surface_ref: "/v1/commands/execute",
+          expected_outcome: "governed runtime execution returns runtime truth, delivery state, and proof-compatible facts"
+        },
+        {
+          stage_id: "deliver",
+          surface_ref: "/v1/transaction-center/result-packages/export-template",
+          expected_outcome: "application can export a portable result package directly from the API path"
+        },
+        {
+          stage_id: "prove",
+          surface_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run",
+          expected_outcome: "API consumer continues into proof-native review and verification without translation gaps"
+        }
+      ],
+      supporting_surfaces: [
+        "/v1/execution-truth",
+        "/v1/lifecycle-continuity/summary",
+        "/v1/transaction-center/result-packages/summary",
+        "/openapi.json"
+      ],
+      claim_boundary: "claim_direct_api_default_path_only_for_the_listed_http_quote_fund_execute_delivery_and_proof_handoff_surfaces_not_as_generic_transport_or_unbounded_external_settlement_ownership"
+    }),
+    buildSurface({
+      surface_id: "browser_checkout",
+      surface_label: "Browser and hosted checkout",
+      surface_kind: "browser_checkout_surface",
+      interaction_modes: ["browser", "checkout"],
+      actor_classes: ["human", "enterprise", "operator"],
+      default_payment_posture: "hosted_checkout_money_in_then_internal_credits_or_runtime_authorization",
+      primary_entrypoints: [
+        "/v1/checkout/purchase-intents",
+        "/v1/checkout/purchase-intents/:purchase_intent_id/session",
+        "/v1/runtime-bridge/dispatch"
+      ],
+      primary_deliverable_posture: "hosted_checkout_to_runtime_dispatch_then_same_runtime_and_proof_spine",
+      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/summary",
+      stages: [
+        {
+          stage_id: "discover",
+          surface_ref: "/v1/revenue-launch/paths/hosted_checkout_credits_execution_proof",
+          expected_outcome: "buyer can inspect the hosted checkout launch path before entering payment"
+        },
+        {
+          stage_id: "quote",
+          surface_ref: "/v1/checkout/purchase-intents",
+          expected_outcome: "browser flow creates a bounded purchase intent tied to a real sellable runtime path"
+        },
+        {
+          stage_id: "fund",
+          surface_ref: "/v1/checkout/purchase-intents/:purchase_intent_id/session",
+          expected_outcome: "caller pays using the hosted front they are most comfortable in while xytara keeps one runtime truth spine"
+        },
+        {
+          stage_id: "execute",
+          surface_ref: "/v1/runtime-bridge/dispatch",
+          expected_outcome: "paid browser-side purchase converges back into the same runtime execution engine"
+        },
+        {
+          stage_id: "deliver",
+          surface_ref: "/v1/operator-export-pack",
+          expected_outcome: "delivery, operator review, and reconciliation remain inspectable after checkout-driven execution"
+        },
+        {
+          stage_id: "prove",
+          surface_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/summary",
+          expected_outcome: "browser-paid work continues into the same proof followthrough posture as other surfaces"
+        }
+      ],
+      supporting_surfaces: [
+        "/v1/checkout/events/security",
+        "/v1/checkout/events/normalize",
+        "/v1/reconciliation-report",
+        "/v1/economics/accounts/:account_id/credit-balance"
+      ],
+      claim_boundary: "claim_browser_checkout_default_path_only_for_the_listed_purchase_intent_checkout_dispatch_reconciliation_and_proof_handoff_surfaces_not_as_public_checkout_processor_or_custody_control"
+    }),
+    buildSurface({
+      surface_id: "chat_agent",
+      surface_label: "Chat window and agent runtime",
+      surface_kind: "agent_protocol_surface",
+      interaction_modes: ["chat", "agent", "mcp", "a2a", "a2c"],
+      actor_classes: ["agent", "machine", "human", "enterprise"],
+      default_payment_posture: "quote_first_then_credits_first_or_x402_inside_named_protocol_lanes",
+      primary_entrypoints: [
+        "/v1/mcp",
+        "/v1/a2a",
+        "/v1/a2c",
+        "/v1/mcp/tools/invoke"
+      ],
+      primary_deliverable_posture: "protocol-native runtime output with portable result-package followthrough",
+      default_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
+      stages: [
+        {
+          stage_id: "discover",
+          surface_ref: "/v1/protocols",
+          expected_outcome: "agent caller discovers the canonical protocol lanes without private interpretation"
+        },
+        {
+          stage_id: "quote",
+          surface_ref: "xytara first-run --run-quote --account ACCOUNT_REF --pretty",
+          expected_outcome: "agent-side first contact can still begin with the same safe quote-first posture"
+        },
+        {
+          stage_id: "fund",
+          surface_ref: "/v1/x402/summary",
+          expected_outcome: "chat or agent runtime chooses machine paywall or funded credits-first posture before invocation"
+        },
+        {
+          stage_id: "execute",
+          surface_ref: "/v1/mcp/tools/invoke",
+          expected_outcome: "agent runtime invokes the default tool lane from inside the surface it already inhabits"
+        },
+        {
+          stage_id: "deliver",
+          surface_ref: "/v1/a2c/flows/tooling",
+          expected_outcome: "session-backed tooling exchange and result carry stay inside agent-native protocol posture"
+        },
+        {
+          stage_id: "prove",
+          surface_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
+          expected_outcome: "agent-visible verification surfaces can confirm the runtime handoff outcome"
+        }
+      ],
+      supporting_surfaces: [
+        "/v1/providers/journeys/summary",
+        "/v1/full-catalog/market-lanes/traces/summary",
+        "/v1/full-catalog/market-lanes/promotion/summary"
+      ],
+      claim_boundary: "claim_chat_agent_default_path_only_for_the_listed_mcp_a2a_a2c_quote_fund_execute_delivery_and_verification_surfaces_not_as_unbounded_protocol_ecosystem_ownership"
+    }),
+    buildSurface({
+      surface_id: "service_to_service",
+      surface_label: "Service-to-service and automation",
+      surface_kind: "backend_automation_surface",
+      interaction_modes: ["service_to_service", "automation", "webhook", "dispatch"],
+      actor_classes: ["machine", "enterprise", "operator", "agent"],
+      default_payment_posture: "credits_first_or_pre-authorized_runtime_dispatch_with_checkout_and_callback_guardrails",
+      primary_entrypoints: [
+        "/v1/runtime-bridge/dispatch",
+        "/v1/runtime-bridge/dispatches",
+        "/v1/commands/execute"
+      ],
+      primary_deliverable_posture: "callback_or_polled_runtime_delivery_with_same_execution_truth_and_result_package_spine",
+      default_handoff_ref: "/v1/transaction-center/result-packages/export",
+      stages: [
+        {
+          stage_id: "discover",
+          surface_ref: "/v1/runtime-bridge/dispatches",
+          expected_outcome: "backend caller can inspect dispatch posture and prior requests before wiring real automation"
+        },
+        {
+          stage_id: "quote",
+          surface_ref: "/v1/payment-quotes",
+          expected_outcome: "service can quote work before attempting autonomous dispatch or callback-bound execution"
+        },
+        {
+          stage_id: "fund",
+          surface_ref: "/v1/economics/accounts/:account_id/credit-balance",
+          expected_outcome: "automation lane confirms funded posture or prepares payment admission before execution"
+        },
+        {
+          stage_id: "execute",
+          surface_ref: "/v1/runtime-bridge/dispatch",
+          expected_outcome: "service triggers runtime work and receives a dispatch record suitable for polling or callback followthrough"
+        },
+        {
+          stage_id: "deliver",
+          surface_ref: "/v1/deliveries",
+          expected_outcome: "deliverable and callback truth remain machine-readable for downstream systems"
+        },
+        {
+          stage_id: "prove",
+          surface_ref: "/v1/transaction-center/result-packages/export",
+          expected_outcome: "backend system can export a proof-ready handoff bundle without leaving the automation path"
+        }
+      ],
+      supporting_surfaces: [
+        "/v1/execution-truth/summary",
+        "/v1/deliveries/summary",
+        "/v1/payment-ledger",
+        "/asyncapi.json",
+        "/cloudevents.json"
+      ],
+      claim_boundary: "claim_service_to_service_default_path_only_for_the_listed_dispatch_execute_delivery_and_proof_export_surfaces_not_as_generic_callback_network_or_unbounded_partner_runtime_control"
+    })
+  ];
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-default-path-model",
+    pack_version: "xytara-default-path-model-v1",
+    posture: "multi_surface_real_time_default_path",
+    model_state: "frozen_for_3_0_0_closeout",
+    doctrine: "every_supported_surface_should_converge_on_one_quote_fund_execute_deliver_prove_spine_so_the_public_runtime_story_stays true across cli browser api agent and automation entrypoints",
+    core_claim: "xytara can meet callers where they already are while keeping one runtime, payment, delivery, and proof-handoff truth model",
+    default_path_order: [
+      "discover",
+      "quote",
+      "fund",
+      "execute",
+      "deliver",
+      "prove",
+      "inspect"
+    ],
+    supported_surface_count: surfaces.length,
+    real_time_ready_surface_count: surfaces.filter((entry) => entry.real_time_ready).length,
+    quote_ready_surface_count: surfaces.filter((entry) => entry.quote_ready).length,
+    deliverable_ready_surface_count: surfaces.filter((entry) => entry.deliverable_ready).length,
+    proof_followthrough_ready_surface_count: surfaces.filter((entry) => entry.proof_followthrough_ready).length,
+    surfaces,
+    universal_invariants: [
+      "every_default_path_must_begin_with_public_discovery_or_start_here_guidance",
+      "every_default_path_must_support_quote_or_pre-execution_intent_before_irreversible_spend",
+      "every_default_path_must_converge_back_into_the_same_execution_truth_model",
+      "every_default_path_must_return_the_deliverable_to_the_surface_where_the_caller_is_already_operating",
+      "every_default_path_must_preserve_proof-ready_followthrough_into_xoonya",
+      "surface_specific_payment_fronts_must_not_split_the_runtime_fact_model"
+    ],
+    linked_summaries: {
+      execution_truth_summary: executionTruthSummary,
+      first_run_conversion_summary: firstRunSummary,
+      revenue_launch_path_summary: revenueSummary,
+      provider_runtime_journey_summary: providerJourneySummary,
+      protocol_lane_summary: protocolSummary,
+      checkout_event_security_summary: checkoutSecurity
+    },
+    linked_surfaces: {
+      start_here_ref: "START_HERE.md",
+      first_run_path_ref: "https://www.naxytra.com/v1/first-run-path",
+      first_run_kit_ref: "https://www.naxytra.com/v1/first-run-kit",
+      first_run_conversions_ref: "/v1/first-run/conversions",
+      revenue_launch_paths_ref: "/v1/revenue-launch/paths",
+      providers_journeys_ref: "/v1/providers/journeys",
+      protocols_ref: "/v1/protocols",
+      execution_truth_ref: "/v1/execution-truth",
+      xoonya_result_package_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
+    },
+    claim_boundary: "claim_only_the_listed_multi_surface_default_paths_and_their_shared_runtime_spine_without_implying_unbounded_wallet_checkout_transport_or_partner_platform_ownership"
+  };
+}
+
+function summarizeDefaultPathPack() {
+  const pack = buildDefaultPathPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: "xytara-default-path-model-summary-v1",
+    pack_version: pack.pack_version,
+    model_state: pack.model_state,
+    supported_surface_count: pack.supported_surface_count,
+    real_time_ready_surface_count: pack.real_time_ready_surface_count,
+    quote_ready_surface_count: pack.quote_ready_surface_count,
+    deliverable_ready_surface_count: pack.deliverable_ready_surface_count,
+    proof_followthrough_ready_surface_count: pack.proof_followthrough_ready_surface_count,
+    default_path_stage_count: pack.default_path_order.length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function getDefaultPathSurfaceDetail(surfaceId) {
+  const normalized = String(surfaceId || "").trim().toLowerCase();
+  return (buildDefaultPathPack().surfaces || []).find((entry) => entry.surface_id === normalized) || null;
+}
+
+module.exports = {
+  buildDefaultPathPack,
+  summarizeDefaultPathPack,
+  getDefaultPathSurfaceDetail
+};