xytara 3.1.0 → 3.1.2

package/lib/market_lane_contract.js

@@ -1,467 +1,467 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { buildCatalogResponse } = require("./catalog_contract");
-const { buildAdapterDepthPack } = require("./adapter_depth_contract");
-const { buildFrameworkLanePack } = require("./framework_lane_contract");
-const { buildMajorRailsLanePack } = require("./major_rails_lane_contract");
-const { buildProtocolLanePack } = require("./protocol_lane_contract");
-const { MARKET_CLASS_DEFINITIONS } = require("./catalog_family_model");
-
-function uniqueSorted(values) {
-  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
-}
-
-function tasksForMarket(tasks, marketClass) {
-  return (Array.isArray(tasks) ? tasks : []).filter((entry) => entry && entry.market_class === marketClass);
-}
-
-function buildActivationProfilesByMarket() {
-  return {
-    compute: [
-      {
-        profile_id: "compute.invoke_primary",
-        activation_mode: "callable",
-        activation_label: "invoke primary",
-        operation_ref: "family.invoke",
-        call_surface: "/v1/transaction-center/task-packs/invoke",
-        workflow_ref: "a2c.tooling.flow",
-        recommended_pack_ref: "default.mcp.tool.invoke",
-        task_refs: ["adapter.mcp.invoke"],
-        payload_shape: {
-          pack_ref: "default.mcp.tool.invoke",
-          payload_fields: ["tool_name", "arguments"]
-        },
-        expected_outcome: "provider-bound compute execution through the canonical MCP invocation lane"
-      },
-      {
-        profile_id: "compute.commitment_flow",
-        activation_mode: "callable",
-        activation_label: "commitment flow",
-        operation_ref: "family.quote_commit",
-        call_surface: "/v1/transaction-center/transaction-class-packs/run",
-        workflow_ref: "job.commitment.flow",
-        recommended_pack_ref: "transaction.job.commitment",
-        task_refs: ["jobs.quote", "jobs.reserve", "jobs.commit"],
-        payload_shape: {
-          class_pack_ref: "transaction.job.commitment",
-          payload_fields: ["job_type", "job_id"]
-        },
-        expected_outcome: "quoted, reserved, and committed compute work inside the governed runtime"
-      }
-    ],
-    data: [
-      {
-        profile_id: "data.discovery",
-        activation_mode: "callable",
-        activation_label: "discovery",
-        operation_ref: "family.discover",
-        call_surface: "/v1/catalog/task?ref=zones.list",
-        workflow_ref: null,
-        recommended_pack_ref: null,
-        task_refs: ["zones.list"],
-        payload_shape: {
-          payload_fields: []
-        },
-        expected_outcome: "discoverable runtime zones and public data-facing capability posture"
-      },
-      {
-        profile_id: "data.delivery_export",
-        activation_mode: "callable",
-        activation_label: "delivery export",
-        operation_ref: "family.deliver",
-        call_surface: "/v1/transaction-center/result-packages/export",
-        workflow_ref: "runtime.consequence.flow",
-        recommended_pack_ref: "result.spine.a2c.tooling",
-        task_refs: ["runtime.emit", "jobs.release", "registry.pack.bundle"],
-        payload_shape: {
-          result_package_ref: "result.spine.a2c.tooling",
-          payload_fields: ["workflow_ref", "task_refs"]
-        },
-        expected_outcome: "portable result-package export with receipt and delivery continuity"
-      }
-    ],
-    storage: [
-      {
-        profile_id: "storage.anchor_registry",
-        activation_mode: "callable",
-        activation_label: "anchor registry",
-        operation_ref: "family.anchor",
-        call_surface: "/v1/transaction-center/transaction-class-packs/run",
-        workflow_ref: "registry.anchor.flow",
-        recommended_pack_ref: "transaction.identity.anchor",
-        task_refs: ["registry.register", "anchoring.submit"],
-        payload_shape: {
-          class_pack_ref: "transaction.identity.anchor",
-          payload_fields: ["subject_id", "record_type", "commitment_hash"]
-        },
-        expected_outcome: "registry-backed storage state carried into anchored commitments"
-      }
-    ],
-    messaging: [
-      {
-        profile_id: "messaging.session_tooling",
-        activation_mode: "callable",
-        activation_label: "session tooling",
-        operation_ref: "family.session_send_close",
-        call_surface: "/v1/transaction-center/task-packs/invoke",
-        workflow_ref: "a2c.tooling.flow",
-        recommended_pack_ref: "default.a2c.tooling.run",
-        task_refs: ["a2c.session.open", "a2c.pack.preview"],
-        payload_shape: {
-          pack_ref: "default.a2c.tooling.run",
-          payload_fields: ["agent_id", "channel_ref", "pack_ref"]
-        },
-        expected_outcome: "session-backed messaging and tooling exchange through the canonical A2C lane"
-      },
-      {
-        profile_id: "messaging.negotiation",
-        activation_mode: "callable",
-        activation_label: "negotiation",
-        operation_ref: "family.negotiate",
-        call_surface: "/v1/transaction-center/precommit-packs/run",
-        workflow_ref: "a2a.settlement.flow",
-        recommended_pack_ref: "precommit.a2a.settlement.readiness",
-        task_refs: ["a2a.negotiate"],
-        payload_shape: {
-          precommit_pack_ref: "precommit.a2a.settlement.readiness",
-          payload_fields: ["counterparty_agent_id", "task_pack_ref"]
-        },
-        expected_outcome: "agent-to-agent negotiation readiness with event/system coordination posture"
-      }
-    ],
-    device_robotics: [
-      {
-        profile_id: "device_robotics.protocol_anchor_preview",
-        activation_mode: "preview_only",
-        activation_label: "protocol anchor preview",
-        operation_ref: null,
-        call_surface: null,
-        workflow_ref: null,
-        recommended_pack_ref: null,
-        task_refs: [],
-        payload_shape: {
-          supporting_protocols: ["mqtt", "ros2"]
-        },
-        expected_outcome: "inspect bounded protocol anchor posture without claiming generalized physical execution truth"
-      }
-    ],
-    treasury_payments: [
-      {
-        profile_id: "treasury.preview_credits",
-        activation_mode: "callable",
-        activation_label: "preview credits",
-        operation_ref: "family.meter",
-        call_surface: "/v1/credits/packs",
-        workflow_ref: null,
-        recommended_pack_ref: null,
-        task_refs: ["credits.preview"],
-        payload_shape: {
-          payload_fields: ["account_id"]
-        },
-        expected_outcome: "preview treasury spend posture before settlement-bearing execution"
-      },
-      {
-        profile_id: "treasury.settlement_intent",
-        activation_mode: "callable",
-        activation_label: "settlement intent",
-        operation_ref: "family.settlement_intent",
-        call_surface: "/v1/transaction-center/precommit-packs/run",
-        workflow_ref: "admission.settlement.flow",
-        recommended_pack_ref: "precommit.a2a.settlement.readiness",
-        task_refs: ["policy.simulate", "admission.preview"],
-        payload_shape: {
-          precommit_pack_ref: "precommit.a2a.settlement.readiness",
-          payload_fields: ["source_zone_id", "target_zone_id", "policy"]
-        },
-        expected_outcome: "bounded settlement intent and policy posture before submission"
-      },
-      {
-        profile_id: "treasury.submit_settlement",
-        activation_mode: "callable",
-        activation_label: "submit settlement",
-        operation_ref: "family.settle_reconcile",
-        call_surface: "/v1/settlement/bsv-teranode",
-        workflow_ref: "policy.transaction.flow",
-        recommended_pack_ref: null,
-        task_refs: ["settlement.submit", "credits.apply"],
-        payload_shape: {
-          payload_fields: ["intent_id", "account_id", "amount_minor"]
-        },
-        expected_outcome: "submission and reconciliation posture for treasury-linked settlement"
-      }
-    ]
-  };
-}
-
-function buildMarketLaneIndex(marketLanes) {
-  return new Map((Array.isArray(marketLanes) ? marketLanes : []).map((entry) => [entry.market_class, entry]));
-}
-
-function buildMarketLanePack() {
-  const catalogResponse = buildCatalogResponse();
-  const tasks = Array.isArray(catalogResponse.tasks) ? catalogResponse.tasks : [];
-  const adapterDepth = buildAdapterDepthPack();
-  const frameworkLane = buildFrameworkLanePack();
-  const protocolLane = buildProtocolLanePack();
-  const majorRailsLane = buildMajorRailsLanePack();
-  const activationProfilesByMarket = buildActivationProfilesByMarket();
-
-  const frameworkIds = uniqueSorted([
-    ...Object.keys(frameworkLane.featured_frameworks || {}),
-    ...Object.keys(frameworkLane.registry_backed_frameworks || {})
-  ]);
-  const messagingProtocolIds = uniqueSorted(
-    Object.keys(protocolLane.featured_protocols || {}).filter((entry) =>
-      ["a2a", "a2c", "kafka", "mqtt", "nats", "webhook_event_bus"].includes(entry)
-    )
-  );
-  const deviceProtocolIds = uniqueSorted(
-    Object.keys(protocolLane.featured_protocols || {}).filter((entry) => ["mqtt", "ros2"].includes(entry))
-  );
-  const railIds = uniqueSorted(Object.keys(majorRailsLane.featured_lanes || {}));
-
-  const lanesByMarket = {
-    compute: {
-      posture: "provider_bound_execution_and_framework_routed_compute_lane",
-      claim_status: "bounded_live",
-      evidence_status: "provider_live_plus_first_party_runtime",
-      coverage_posture: "provider_live_anchor_with_bounded_family_breadth",
-      surfaced_task_refs: tasksForMarket(tasks, "compute").map((entry) => entry.public_task_ref),
-      provider_live_task_refs: adapterDepth.public_claim_boundary && adapterDepth.public_claim_boundary.live_provider_claim_allowed
-        ? ["adapter.mcp.invoke"]
-        : [],
-      supporting_lanes: frameworkIds,
-      call_surfaces: [
-        "/v1/transaction-center/task-packs/invoke",
-        "/v1/transaction-center/transaction-class-packs/run"
-      ],
-      supporting_surfaces: [
-        "/v1/adapter-depth/summary",
-        "/v1/frameworks/summary",
-        "/v1/capability-registry/execution-truth/summary"
-      ],
-      claim_boundary: "claim_compute_live_only_for_provider_bound_task_refs_listed_by_adapter_depth_and_keep_the_rest_bounded"
-    },
-    data: {
-      posture: "result_package_receipt_identity_and_discovery_data_lane",
-      claim_status: "bounded_live",
-      evidence_status: "first_party_runtime",
-      coverage_posture: "direct_task_backed",
-      surfaced_task_refs: tasksForMarket(tasks, "data").map((entry) => entry.public_task_ref),
-      provider_live_task_refs: [],
-      supporting_lanes: ["/v1/catalog/summary", "/v1/transaction-center/result-packages/summary"],
-      call_surfaces: [
-        "/v1/catalog/task?ref=zones.list",
-        "/v1/transaction-center/result-packages/export",
-        "/v1/receipts"
-      ],
-      supporting_surfaces: [
-        "/v1/catalog/summary",
-        "/v1/activity-ledger/summary",
-        "/v1/identity-interop/summary"
-      ],
-      claim_boundary: "claim_data_market_coverage_only_for_discovery_identity_receipt_and_result_package_surfaces_listed_publicly"
-    },
-    storage: {
-      posture: "registry_pack_anchoring_and_provenance_storage_lane",
-      claim_status: "bounded_live",
-      evidence_status: "proof_handoff_ready",
-      coverage_posture: "direct_task_backed",
-      surfaced_task_refs: tasksForMarket(tasks, "storage").map((entry) => entry.public_task_ref),
-      provider_live_task_refs: [],
-      supporting_lanes: ["/v1/artifact-distribution/summary", "/v1/provenance/summary"],
-      call_surfaces: [
-        "/v1/transaction-center/transaction-class-packs/run"
-      ],
-      supporting_surfaces: [
-        "/v1/artifact-distribution/summary",
-        "/v1/provenance/summary",
-        "/v1/settlement/bsv-teranode"
-      ],
-      claim_boundary: "claim_storage_market_coverage_only_for_registry_bundle_anchor_and_provenance_surfaces_listed_publicly"
-    },
-    messaging: {
-      posture: "session_negotiation_and_event_bus_messaging_lane",
-      claim_status: "bounded_live",
-      evidence_status: "first_party_runtime",
-      coverage_posture: "direct_task_backed",
-      surfaced_task_refs: tasksForMarket(tasks, "messaging").map((entry) => entry.public_task_ref),
-      provider_live_task_refs: [],
-      supporting_lanes: messagingProtocolIds,
-      call_surfaces: [
-        "/v1/transaction-center/precommit-packs/run",
-        "/v1/transaction-center/task-packs/invoke"
-      ],
-      supporting_surfaces: [
-        "/v1/protocols/summary",
-        "/v1/event-systems/summary",
-        "/v1/transaction-center/task-packs/summary"
-      ],
-      claim_boundary: "claim_messaging_market_coverage_only_for_a2a_a2c_and_listed_event_bus_protocol_lanes"
-    },
-    device_robotics: {
-      posture: "protocol_anchor_only_device_and_robotics_bridge_lane",
-      claim_status: "bounded_live",
-      evidence_status: "protocol_anchor_only",
-      coverage_posture: "protocol_anchor_only",
-      surfaced_task_refs: [],
-      provider_live_task_refs: [],
-      supporting_lanes: deviceProtocolIds,
-      call_surfaces: [],
-      supporting_surfaces: [
-        "/v1/protocols",
-        "/v1/protocols/summary",
-        "/v1/event-systems/summary",
-        "/v1/integrations/protocols"
-      ],
-      claim_boundary: "claim_device_and_robotics_coverage_only_for_protocol_anchor_lanes_and_not_as_generalized_physical_execution_truth"
-    },
-    treasury_payments: {
-      posture: "credits_policy_and_settlement_treasury_lane",
-      claim_status: "bounded_live",
-      evidence_status: "first_party_ledger_and_settlement",
-      coverage_posture: "direct_task_backed",
-      surfaced_task_refs: tasksForMarket(tasks, "treasury_payments").map((entry) => entry.public_task_ref),
-      provider_live_task_refs: [],
-      supporting_lanes: railIds,
-      call_surfaces: [
-        "/v1/credits/packs",
-        "/v1/transaction-center/precommit-packs/run",
-        "/v1/settlement/bsv-teranode"
-      ],
-      supporting_surfaces: [
-        "/v1/payment-ledger",
-        "/v1/pricing-optimization/revenue-signal-summary",
-        "/v1/settlement/bsv-teranode"
-      ],
-      claim_boundary: "claim_treasury_and_payments_coverage_only_for_preview_credit_policy_and_settlement_surfaces_listed_publicly"
-    }
-  };
-
-  const marketLanes = MARKET_CLASS_DEFINITIONS.map((definition) => {
-    const coverage = lanesByMarket[definition.market_class] || {};
-    const surfacedTaskRefs = uniqueSorted(coverage.surfaced_task_refs || []);
-    const activationProfiles = Array.isArray(activationProfilesByMarket[definition.market_class])
-      ? activationProfilesByMarket[definition.market_class]
-      : [];
-    return {
-      market_class: definition.market_class,
-      market_label: definition.label,
-      lane_ref: `market.${definition.market_class}`,
-      posture: coverage.posture || "bounded_market_lane",
-      claim_status: coverage.claim_status || "bounded_live",
-      evidence_status: coverage.evidence_status || "first_party_runtime",
-      coverage_posture: coverage.coverage_posture || "direct_task_backed",
-      surfaced_task_count: surfacedTaskRefs.length,
-      surfaced_task_refs: surfacedTaskRefs,
-      provider_live_task_refs: uniqueSorted(coverage.provider_live_task_refs || []),
-      supporting_lanes: uniqueSorted(coverage.supporting_lanes || []),
-      call_surfaces: uniqueSorted(coverage.call_surfaces || []),
-      supporting_surfaces: uniqueSorted(coverage.supporting_surfaces || []),
-      activation_profile_count: activationProfiles.length,
-      activation_profiles: activationProfiles,
-      activation_posture: activationProfiles.some((entry) => entry.activation_mode === "callable")
-        ? "callable"
-        : "preview_only",
-      claim_boundary: coverage.claim_boundary || "claim_market_class_coverage_only_for_publicly_inspectable_surfaces"
-    };
-  });
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-market-lane-pack",
-    pack_version: "xytara-market-lane-pack-v1",
-    posture: "major_market_classes_exposed_as_bounded_runtime_lanes",
-    doctrine: "one_public_market_lane_per_major_market_class_inside_current_canon",
-    market_lane_count: marketLanes.length,
-    market_lanes: marketLanes,
-    linked_surfaces: {
-      full_catalog_ref: "/v1/full-catalog",
-      full_catalog_summary_ref: "/v1/full-catalog/summary",
-      adapter_depth_summary_ref: "/v1/adapter-depth/summary",
-      frameworks_summary_ref: "/v1/frameworks/summary",
-      protocols_summary_ref: "/v1/protocols/summary",
-      major_rails_summary_ref: "/v1/major-rails/summary",
-      market_lane_activation_ref: "/v1/full-catalog/market-lanes/activation",
-      market_lane_activation_summary_ref: "/v1/full-catalog/market-lanes/activation/summary",
-      market_lane_depth_ref: "/v1/full-catalog/market-lanes/depth",
-      market_lane_depth_summary_ref: "/v1/full-catalog/market-lanes/depth/summary"
-    }
-  };
-}
-
-function getMarketLaneDetail(marketClass) {
-  const marketLanes = buildMarketLanePack().market_lanes || [];
-  const normalized = String(marketClass || "").trim().toLowerCase();
-  return buildMarketLaneIndex(marketLanes).get(normalized) || null;
-}
-
-function buildMarketLaneActivationPack() {
-  const lanePack = buildMarketLanePack();
-  const activationLanes = (lanePack.market_lanes || []).map((lane) => ({
-    market_class: lane.market_class,
-    market_label: lane.market_label,
-    activation_posture: lane.activation_posture,
-    activation_profile_count: lane.activation_profile_count,
-    activation_profiles: lane.activation_profiles,
-    claim_boundary: lane.claim_boundary
-  }));
-  return {
-    ok: true,
-    product: lanePack.product,
-    category: "machine-commerce-market-lane-activation-pack",
-    pack_version: "xytara-market-lane-activation-pack-v1",
-    posture: "canonical_activation_paths_for_major_market_classes",
-    market_lane_count: activationLanes.length,
-    callable_market_lane_count: activationLanes.filter((entry) => entry.activation_posture === "callable").length,
-    preview_only_market_lane_count: activationLanes.filter((entry) => entry.activation_posture === "preview_only").length,
-    market_lanes: activationLanes,
-    linked_surfaces: {
-      market_lanes_ref: "/v1/full-catalog/market-lanes",
-      market_lanes_summary_ref: "/v1/full-catalog/market-lanes/summary",
-      full_catalog_ref: "/v1/full-catalog"
-    }
-  };
-}
-
-function summarizeMarketLaneActivationPack() {
-  const pack = buildMarketLaneActivationPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: "machine-commerce-market-lane-activation-summary",
-    summary_version: "xytara-market-lane-activation-summary-v1",
-    market_lane_count: pack.market_lane_count,
-    callable_market_lane_count: pack.callable_market_lane_count,
-    preview_only_market_lane_count: pack.preview_only_market_lane_count,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-function summarizeMarketLanePack() {
-  const pack = buildMarketLanePack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: "machine-commerce-market-lane-pack-summary",
-    summary_version: "xytara-market-lane-pack-summary-v1",
-    market_lane_count: pack.market_lane_count,
-    bounded_live_market_lane_count: pack.market_lanes.filter((entry) => entry.claim_status === "bounded_live").length,
-    direct_task_backed_market_lane_count: pack.market_lanes.filter((entry) => Number(entry.surfaced_task_count || 0) > 0).length,
-    provider_live_anchor_market_lane_count: pack.market_lanes.filter((entry) => Array.isArray(entry.provider_live_task_refs) && entry.provider_live_task_refs.length > 0).length,
-    protocol_anchor_only_market_lane_count: pack.market_lanes.filter((entry) => entry.coverage_posture === "protocol_anchor_only").length,
-    callable_market_lane_count: pack.market_lanes.filter((entry) => entry.activation_posture === "callable").length,
-    preview_only_market_lane_count: pack.market_lanes.filter((entry) => entry.activation_posture === "preview_only").length,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-module.exports = {
-  buildMarketLaneActivationPack,
-  buildMarketLanePack,
-  getMarketLaneDetail,
-  summarizeMarketLaneActivationPack,
-  summarizeMarketLanePack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const { buildCatalogResponse } = require("./catalog_contract");
+const { buildAdapterDepthPack } = require("./adapter_depth_contract");
+const { buildFrameworkLanePack } = require("./framework_lane_contract");
+const { buildMajorRailsLanePack } = require("./major_rails_lane_contract");
+const { buildProtocolLanePack } = require("./protocol_lane_contract");
+const { MARKET_CLASS_DEFINITIONS } = require("./catalog_family_model");
+
+function uniqueSorted(values) {
+  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
+}
+
+function tasksForMarket(tasks, marketClass) {
+  return (Array.isArray(tasks) ? tasks : []).filter((entry) => entry && entry.market_class === marketClass);
+}
+
+function buildActivationProfilesByMarket() {
+  return {
+    compute: [
+      {
+        profile_id: "compute.invoke_primary",
+        activation_mode: "callable",
+        activation_label: "invoke primary",
+        operation_ref: "family.invoke",
+        call_surface: "/v1/transaction-center/task-packs/invoke",
+        workflow_ref: "a2c.tooling.flow",
+        recommended_pack_ref: "default.mcp.tool.invoke",
+        task_refs: ["adapter.mcp.invoke"],
+        payload_shape: {
+          pack_ref: "default.mcp.tool.invoke",
+          payload_fields: ["tool_name", "arguments"]
+        },
+        expected_outcome: "provider-bound compute execution through the canonical MCP invocation lane"
+      },
+      {
+        profile_id: "compute.commitment_flow",
+        activation_mode: "callable",
+        activation_label: "commitment flow",
+        operation_ref: "family.quote_commit",
+        call_surface: "/v1/transaction-center/transaction-class-packs/run",
+        workflow_ref: "job.commitment.flow",
+        recommended_pack_ref: "transaction.job.commitment",
+        task_refs: ["jobs.quote", "jobs.reserve", "jobs.commit"],
+        payload_shape: {
+          class_pack_ref: "transaction.job.commitment",
+          payload_fields: ["job_type", "job_id"]
+        },
+        expected_outcome: "quoted, reserved, and committed compute work inside the governed runtime"
+      }
+    ],
+    data: [
+      {
+        profile_id: "data.discovery",
+        activation_mode: "callable",
+        activation_label: "discovery",
+        operation_ref: "family.discover",
+        call_surface: "/v1/catalog/task?ref=zones.list",
+        workflow_ref: null,
+        recommended_pack_ref: null,
+        task_refs: ["zones.list"],
+        payload_shape: {
+          payload_fields: []
+        },
+        expected_outcome: "discoverable runtime zones and public data-facing capability posture"
+      },
+      {
+        profile_id: "data.delivery_export",
+        activation_mode: "callable",
+        activation_label: "delivery export",
+        operation_ref: "family.deliver",
+        call_surface: "/v1/transaction-center/result-packages/export",
+        workflow_ref: "runtime.consequence.flow",
+        recommended_pack_ref: "result.spine.a2c.tooling",
+        task_refs: ["runtime.emit", "jobs.release", "registry.pack.bundle"],
+        payload_shape: {
+          result_package_ref: "result.spine.a2c.tooling",
+          payload_fields: ["workflow_ref", "task_refs"]
+        },
+        expected_outcome: "portable result-package export with receipt and delivery continuity"
+      }
+    ],
+    storage: [
+      {
+        profile_id: "storage.anchor_registry",
+        activation_mode: "callable",
+        activation_label: "anchor registry",
+        operation_ref: "family.anchor",
+        call_surface: "/v1/transaction-center/transaction-class-packs/run",
+        workflow_ref: "registry.anchor.flow",
+        recommended_pack_ref: "transaction.identity.anchor",
+        task_refs: ["registry.register", "anchoring.submit"],
+        payload_shape: {
+          class_pack_ref: "transaction.identity.anchor",
+          payload_fields: ["subject_id", "record_type", "commitment_hash"]
+        },
+        expected_outcome: "registry-backed storage state carried into anchored commitments"
+      }
+    ],
+    messaging: [
+      {
+        profile_id: "messaging.session_tooling",
+        activation_mode: "callable",
+        activation_label: "session tooling",
+        operation_ref: "family.session_send_close",
+        call_surface: "/v1/transaction-center/task-packs/invoke",
+        workflow_ref: "a2c.tooling.flow",
+        recommended_pack_ref: "default.a2c.tooling.run",
+        task_refs: ["a2c.session.open", "a2c.pack.preview"],
+        payload_shape: {
+          pack_ref: "default.a2c.tooling.run",
+          payload_fields: ["agent_id", "channel_ref", "pack_ref"]
+        },
+        expected_outcome: "session-backed messaging and tooling exchange through the canonical A2C lane"
+      },
+      {
+        profile_id: "messaging.negotiation",
+        activation_mode: "callable",
+        activation_label: "negotiation",
+        operation_ref: "family.negotiate",
+        call_surface: "/v1/transaction-center/precommit-packs/run",
+        workflow_ref: "a2a.settlement.flow",
+        recommended_pack_ref: "precommit.a2a.settlement.readiness",
+        task_refs: ["a2a.negotiate"],
+        payload_shape: {
+          precommit_pack_ref: "precommit.a2a.settlement.readiness",
+          payload_fields: ["counterparty_agent_id", "task_pack_ref"]
+        },
+        expected_outcome: "agent-to-agent negotiation readiness with event/system coordination posture"
+      }
+    ],
+    device_robotics: [
+      {
+        profile_id: "device_robotics.protocol_anchor_preview",
+        activation_mode: "preview_only",
+        activation_label: "protocol anchor preview",
+        operation_ref: null,
+        call_surface: null,
+        workflow_ref: null,
+        recommended_pack_ref: null,
+        task_refs: [],
+        payload_shape: {
+          supporting_protocols: ["mqtt", "ros2"]
+        },
+        expected_outcome: "inspect bounded protocol anchor posture without claiming generalized physical execution truth"
+      }
+    ],
+    treasury_payments: [
+      {
+        profile_id: "treasury.preview_credits",
+        activation_mode: "callable",
+        activation_label: "preview credits",
+        operation_ref: "family.meter",
+        call_surface: "/v1/credits/packs",
+        workflow_ref: null,
+        recommended_pack_ref: null,
+        task_refs: ["credits.preview"],
+        payload_shape: {
+          payload_fields: ["account_id"]
+        },
+        expected_outcome: "preview treasury spend posture before settlement-bearing execution"
+      },
+      {
+        profile_id: "treasury.settlement_intent",
+        activation_mode: "callable",
+        activation_label: "settlement intent",
+        operation_ref: "family.settlement_intent",
+        call_surface: "/v1/transaction-center/precommit-packs/run",
+        workflow_ref: "admission.settlement.flow",
+        recommended_pack_ref: "precommit.a2a.settlement.readiness",
+        task_refs: ["policy.simulate", "admission.preview"],
+        payload_shape: {
+          precommit_pack_ref: "precommit.a2a.settlement.readiness",
+          payload_fields: ["source_zone_id", "target_zone_id", "policy"]
+        },
+        expected_outcome: "bounded settlement intent and policy posture before submission"
+      },
+      {
+        profile_id: "treasury.submit_settlement",
+        activation_mode: "callable",
+        activation_label: "submit settlement",
+        operation_ref: "family.settle_reconcile",
+        call_surface: "/v1/settlement/bsv-teranode",
+        workflow_ref: "policy.transaction.flow",
+        recommended_pack_ref: null,
+        task_refs: ["settlement.submit", "credits.apply"],
+        payload_shape: {
+          payload_fields: ["intent_id", "account_id", "amount_minor"]
+        },
+        expected_outcome: "submission and reconciliation posture for treasury-linked settlement"
+      }
+    ]
+  };
+}
+
+function buildMarketLaneIndex(marketLanes) {
+  return new Map((Array.isArray(marketLanes) ? marketLanes : []).map((entry) => [entry.market_class, entry]));
+}
+
+function buildMarketLanePack() {
+  const catalogResponse = buildCatalogResponse();
+  const tasks = Array.isArray(catalogResponse.tasks) ? catalogResponse.tasks : [];
+  const adapterDepth = buildAdapterDepthPack();
+  const frameworkLane = buildFrameworkLanePack();
+  const protocolLane = buildProtocolLanePack();
+  const majorRailsLane = buildMajorRailsLanePack();
+  const activationProfilesByMarket = buildActivationProfilesByMarket();
+
+  const frameworkIds = uniqueSorted([
+    ...Object.keys(frameworkLane.featured_frameworks || {}),
+    ...Object.keys(frameworkLane.registry_backed_frameworks || {})
+  ]);
+  const messagingProtocolIds = uniqueSorted(
+    Object.keys(protocolLane.featured_protocols || {}).filter((entry) =>
+      ["a2a", "a2c", "kafka", "mqtt", "nats", "webhook_event_bus"].includes(entry)
+    )
+  );
+  const deviceProtocolIds = uniqueSorted(
+    Object.keys(protocolLane.featured_protocols || {}).filter((entry) => ["mqtt", "ros2"].includes(entry))
+  );
+  const railIds = uniqueSorted(Object.keys(majorRailsLane.featured_lanes || {}));
+
+  const lanesByMarket = {
+    compute: {
+      posture: "provider_bound_execution_and_framework_routed_compute_lane",
+      claim_status: "bounded_live",
+      evidence_status: "provider_live_plus_first_party_runtime",
+      coverage_posture: "provider_live_anchor_with_bounded_family_breadth",
+      surfaced_task_refs: tasksForMarket(tasks, "compute").map((entry) => entry.public_task_ref),
+      provider_live_task_refs: adapterDepth.public_claim_boundary && adapterDepth.public_claim_boundary.live_provider_claim_allowed
+        ? ["adapter.mcp.invoke"]
+        : [],
+      supporting_lanes: frameworkIds,
+      call_surfaces: [
+        "/v1/transaction-center/task-packs/invoke",
+        "/v1/transaction-center/transaction-class-packs/run"
+      ],
+      supporting_surfaces: [
+        "/v1/adapter-depth/summary",
+        "/v1/frameworks/summary",
+        "/v1/capability-registry/execution-truth/summary"
+      ],
+      claim_boundary: "claim_compute_live_only_for_provider_bound_task_refs_listed_by_adapter_depth_and_keep_the_rest_bounded"
+    },
+    data: {
+      posture: "result_package_receipt_identity_and_discovery_data_lane",
+      claim_status: "bounded_live",
+      evidence_status: "first_party_runtime",
+      coverage_posture: "direct_task_backed",
+      surfaced_task_refs: tasksForMarket(tasks, "data").map((entry) => entry.public_task_ref),
+      provider_live_task_refs: [],
+      supporting_lanes: ["/v1/catalog/summary", "/v1/transaction-center/result-packages/summary"],
+      call_surfaces: [
+        "/v1/catalog/task?ref=zones.list",
+        "/v1/transaction-center/result-packages/export",
+        "/v1/receipts"
+      ],
+      supporting_surfaces: [
+        "/v1/catalog/summary",
+        "/v1/activity-ledger/summary",
+        "/v1/identity-interop/summary"
+      ],
+      claim_boundary: "claim_data_market_coverage_only_for_discovery_identity_receipt_and_result_package_surfaces_listed_publicly"
+    },
+    storage: {
+      posture: "registry_pack_anchoring_and_provenance_storage_lane",
+      claim_status: "bounded_live",
+      evidence_status: "proof_handoff_ready",
+      coverage_posture: "direct_task_backed",
+      surfaced_task_refs: tasksForMarket(tasks, "storage").map((entry) => entry.public_task_ref),
+      provider_live_task_refs: [],
+      supporting_lanes: ["/v1/artifact-distribution/summary", "/v1/provenance/summary"],
+      call_surfaces: [
+        "/v1/transaction-center/transaction-class-packs/run"
+      ],
+      supporting_surfaces: [
+        "/v1/artifact-distribution/summary",
+        "/v1/provenance/summary",
+        "/v1/settlement/bsv-teranode"
+      ],
+      claim_boundary: "claim_storage_market_coverage_only_for_registry_bundle_anchor_and_provenance_surfaces_listed_publicly"
+    },
+    messaging: {
+      posture: "session_negotiation_and_event_bus_messaging_lane",
+      claim_status: "bounded_live",
+      evidence_status: "first_party_runtime",
+      coverage_posture: "direct_task_backed",
+      surfaced_task_refs: tasksForMarket(tasks, "messaging").map((entry) => entry.public_task_ref),
+      provider_live_task_refs: [],
+      supporting_lanes: messagingProtocolIds,
+      call_surfaces: [
+        "/v1/transaction-center/precommit-packs/run",
+        "/v1/transaction-center/task-packs/invoke"
+      ],
+      supporting_surfaces: [
+        "/v1/protocols/summary",
+        "/v1/event-systems/summary",
+        "/v1/transaction-center/task-packs/summary"
+      ],
+      claim_boundary: "claim_messaging_market_coverage_only_for_a2a_a2c_and_listed_event_bus_protocol_lanes"
+    },
+    device_robotics: {
+      posture: "protocol_anchor_only_device_and_robotics_bridge_lane",
+      claim_status: "bounded_live",
+      evidence_status: "protocol_anchor_only",
+      coverage_posture: "protocol_anchor_only",
+      surfaced_task_refs: [],
+      provider_live_task_refs: [],
+      supporting_lanes: deviceProtocolIds,
+      call_surfaces: [],
+      supporting_surfaces: [
+        "/v1/protocols",
+        "/v1/protocols/summary",
+        "/v1/event-systems/summary",
+        "/v1/integrations/protocols"
+      ],
+      claim_boundary: "claim_device_and_robotics_coverage_only_for_protocol_anchor_lanes_and_not_as_generalized_physical_execution_truth"
+    },
+    treasury_payments: {
+      posture: "credits_policy_and_settlement_treasury_lane",
+      claim_status: "bounded_live",
+      evidence_status: "first_party_ledger_and_settlement",
+      coverage_posture: "direct_task_backed",
+      surfaced_task_refs: tasksForMarket(tasks, "treasury_payments").map((entry) => entry.public_task_ref),
+      provider_live_task_refs: [],
+      supporting_lanes: railIds,
+      call_surfaces: [
+        "/v1/credits/packs",
+        "/v1/transaction-center/precommit-packs/run",
+        "/v1/settlement/bsv-teranode"
+      ],
+      supporting_surfaces: [
+        "/v1/payment-ledger",
+        "/v1/pricing-optimization/revenue-signal-summary",
+        "/v1/settlement/bsv-teranode"
+      ],
+      claim_boundary: "claim_treasury_and_payments_coverage_only_for_preview_credit_policy_and_settlement_surfaces_listed_publicly"
+    }
+  };
+
+  const marketLanes = MARKET_CLASS_DEFINITIONS.map((definition) => {
+    const coverage = lanesByMarket[definition.market_class] || {};
+    const surfacedTaskRefs = uniqueSorted(coverage.surfaced_task_refs || []);
+    const activationProfiles = Array.isArray(activationProfilesByMarket[definition.market_class])
+      ? activationProfilesByMarket[definition.market_class]
+      : [];
+    return {
+      market_class: definition.market_class,
+      market_label: definition.label,
+      lane_ref: `market.${definition.market_class}`,
+      posture: coverage.posture || "bounded_market_lane",
+      claim_status: coverage.claim_status || "bounded_live",
+      evidence_status: coverage.evidence_status || "first_party_runtime",
+      coverage_posture: coverage.coverage_posture || "direct_task_backed",
+      surfaced_task_count: surfacedTaskRefs.length,
+      surfaced_task_refs: surfacedTaskRefs,
+      provider_live_task_refs: uniqueSorted(coverage.provider_live_task_refs || []),
+      supporting_lanes: uniqueSorted(coverage.supporting_lanes || []),
+      call_surfaces: uniqueSorted(coverage.call_surfaces || []),
+      supporting_surfaces: uniqueSorted(coverage.supporting_surfaces || []),
+      activation_profile_count: activationProfiles.length,
+      activation_profiles: activationProfiles,
+      activation_posture: activationProfiles.some((entry) => entry.activation_mode === "callable")
+        ? "callable"
+        : "preview_only",
+      claim_boundary: coverage.claim_boundary || "claim_market_class_coverage_only_for_publicly_inspectable_surfaces"
+    };
+  });
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-market-lane-pack",
+    pack_version: "xytara-market-lane-pack-v1",
+    posture: "major_market_classes_exposed_as_bounded_runtime_lanes",
+    doctrine: "one_public_market_lane_per_major_market_class_inside_current_canon",
+    market_lane_count: marketLanes.length,
+    market_lanes: marketLanes,
+    linked_surfaces: {
+      full_catalog_ref: "/v1/full-catalog",
+      full_catalog_summary_ref: "/v1/full-catalog/summary",
+      adapter_depth_summary_ref: "/v1/adapter-depth/summary",
+      frameworks_summary_ref: "/v1/frameworks/summary",
+      protocols_summary_ref: "/v1/protocols/summary",
+      major_rails_summary_ref: "/v1/major-rails/summary",
+      market_lane_activation_ref: "/v1/full-catalog/market-lanes/activation",
+      market_lane_activation_summary_ref: "/v1/full-catalog/market-lanes/activation/summary",
+      market_lane_depth_ref: "/v1/full-catalog/market-lanes/depth",
+      market_lane_depth_summary_ref: "/v1/full-catalog/market-lanes/depth/summary"
+    }
+  };
+}
+
+function getMarketLaneDetail(marketClass) {
+  const marketLanes = buildMarketLanePack().market_lanes || [];
+  const normalized = String(marketClass || "").trim().toLowerCase();
+  return buildMarketLaneIndex(marketLanes).get(normalized) || null;
+}
+
+function buildMarketLaneActivationPack() {
+  const lanePack = buildMarketLanePack();
+  const activationLanes = (lanePack.market_lanes || []).map((lane) => ({
+    market_class: lane.market_class,
+    market_label: lane.market_label,
+    activation_posture: lane.activation_posture,
+    activation_profile_count: lane.activation_profile_count,
+    activation_profiles: lane.activation_profiles,
+    claim_boundary: lane.claim_boundary
+  }));
+  return {
+    ok: true,
+    product: lanePack.product,
+    category: "machine-commerce-market-lane-activation-pack",
+    pack_version: "xytara-market-lane-activation-pack-v1",
+    posture: "canonical_activation_paths_for_major_market_classes",
+    market_lane_count: activationLanes.length,
+    callable_market_lane_count: activationLanes.filter((entry) => entry.activation_posture === "callable").length,
+    preview_only_market_lane_count: activationLanes.filter((entry) => entry.activation_posture === "preview_only").length,
+    market_lanes: activationLanes,
+    linked_surfaces: {
+      market_lanes_ref: "/v1/full-catalog/market-lanes",
+      market_lanes_summary_ref: "/v1/full-catalog/market-lanes/summary",
+      full_catalog_ref: "/v1/full-catalog"
+    }
+  };
+}
+
+function summarizeMarketLaneActivationPack() {
+  const pack = buildMarketLaneActivationPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: "machine-commerce-market-lane-activation-summary",
+    summary_version: "xytara-market-lane-activation-summary-v1",
+    market_lane_count: pack.market_lane_count,
+    callable_market_lane_count: pack.callable_market_lane_count,
+    preview_only_market_lane_count: pack.preview_only_market_lane_count,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function summarizeMarketLanePack() {
+  const pack = buildMarketLanePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: "machine-commerce-market-lane-pack-summary",
+    summary_version: "xytara-market-lane-pack-summary-v1",
+    market_lane_count: pack.market_lane_count,
+    bounded_live_market_lane_count: pack.market_lanes.filter((entry) => entry.claim_status === "bounded_live").length,
+    direct_task_backed_market_lane_count: pack.market_lanes.filter((entry) => Number(entry.surfaced_task_count || 0) > 0).length,
+    provider_live_anchor_market_lane_count: pack.market_lanes.filter((entry) => Array.isArray(entry.provider_live_task_refs) && entry.provider_live_task_refs.length > 0).length,
+    protocol_anchor_only_market_lane_count: pack.market_lanes.filter((entry) => entry.coverage_posture === "protocol_anchor_only").length,
+    callable_market_lane_count: pack.market_lanes.filter((entry) => entry.activation_posture === "callable").length,
+    preview_only_market_lane_count: pack.market_lanes.filter((entry) => entry.activation_posture === "preview_only").length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+module.exports = {
+  buildMarketLaneActivationPack,
+  buildMarketLanePack,
+  getMarketLaneDetail,
+  summarizeMarketLaneActivationPack,
+  summarizeMarketLanePack
+};