xytara 3.1.16 → 3.2.0

package/lib/catalog_contract.js

@@ -1,966 +0,0 @@
-"use strict";
-
-const { catalog, findCreditPack, findTask, findWorkflow } = require("../fixtures/catalog");
-
-function buildDefaultTransactionTaskPacks() {
-  const center = buildDefaultTransactionCenter();
-  const defaultSettlementMode = center.default_settlement && center.default_settlement.settlement_mode
-    ? center.default_settlement.settlement_mode
-    : null;
-  const defaultPaymentProtocol = center.default_payment && center.default_payment.protocol
-    ? center.default_payment.protocol
-    : null;
-  const suggestedPaths = Array.isArray(center.suggested_paths) ? center.suggested_paths : [];
-  const defaultMcpPath = suggestedPaths.find((entry) => entry && entry.path_id === "default_mcp_x402_path") || null;
-  const defaultA2cPath = suggestedPaths.find((entry) => entry && entry.path_id === "default_a2c_tooling_flow") || null;
-  return [
-    {
-      pack_ref: "default.mcp.tool.invoke",
-      title: "Default MCP Tool Invoke",
-      description: "Run one MCP tool through the built-in default transaction path.",
-      pack_kind: "task_set",
-      usage_mode: "direct_invoke",
-      default_protocol: "mcp",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      suggested_path_id: defaultMcpPath ? defaultMcpPath.path_id : null,
-      selection_reason: "first_party_default_task_pack",
-      task_refs: ["adapter.mcp.invoke"],
-      workflow_ref: null,
-      required_inputs: ["tool_name"],
-      optional_inputs: ["arguments", "settlement_mode", "payment_protocol"]
-    },
-    {
-      pack_ref: "default.a2c.tooling.run",
-      title: "Default A2C Tooling Run",
-      description: "Open an A2C session, preview a tooling pack, and invoke an MCP tool through the default path.",
-      pack_kind: "workflow_pack",
-      usage_mode: "guided_flow",
-      default_protocol: "mcp",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      suggested_path_id: defaultA2cPath ? defaultA2cPath.path_id : null,
-      selection_reason: "first_party_default_workflow_pack",
-      task_refs: ["a2c.session.open", "a2c.pack.preview", "adapter.mcp.invoke"],
-      workflow_ref: "a2c.tooling.flow",
-      required_inputs: ["agent_id", "channel_ref", "pack_ref", "tool_name"],
-      optional_inputs: ["arguments", "settlement_mode", "payment_protocol"]
-    },
-    {
-      pack_ref: "default.identity.anchor.run",
-      title: "Default Identity Anchor Run",
-      description: "Preview identity attestation, register the record, link it, and anchor the resulting commitment.",
-      pack_kind: "workflow_pack",
-      usage_mode: "guided_flow",
-      default_protocol: null,
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      suggested_path_id: null,
-      selection_reason: "first_party_default_identity_pack",
-      task_refs: ["identity.attest.preview", "registry.register", "identity.registry.link", "anchoring.submit"],
-      workflow_ref: "identity.anchor.flow",
-      required_inputs: ["subject_id", "record_type", "registry_record_id", "commitment_hash"],
-      optional_inputs: ["registry_scope", "settlement_mode", "payment_protocol"]
-    }
-  ];
-}
-
-function buildDefaultTransactionGuidedLoops() {
-  const center = buildDefaultTransactionCenter();
-  const taskPacks = buildDefaultTransactionTaskPacks();
-  const economics = buildDefaultTransactionEconomics();
-  const buildLoop = (loopRef, packRef, title, description, stages) => {
-    const pack = taskPacks.find((entry) => entry && entry.pack_ref === packRef) || null;
-    return {
-      loop_ref: loopRef,
-      pack_ref: packRef,
-      title,
-      description,
-      stage_count: Array.isArray(stages) ? stages.length : 0,
-      stages: Array.isArray(stages) ? stages : [],
-      default_protocol: pack && pack.default_protocol ? pack.default_protocol : center.default_protocol.protocol,
-      default_payment_protocol: economics.payment_protocol,
-      default_settlement_mode: economics.default_settlement_mode,
-      suggested_path_id: pack && pack.suggested_path_id ? pack.suggested_path_id : null,
-      workflow_ref: pack && pack.workflow_ref ? pack.workflow_ref : null
-    };
-  };
-  return [
-    buildLoop(
-      "default.mcp.loop",
-      "default.mcp.tool.invoke",
-      "Default MCP Loop",
-      "Preview, quote, pay, invoke, and inspect one MCP tool through the built-in first-party path.",
-      ["preview", "quote", "pay", "invoke", "inspect"]
-    ),
-    buildLoop(
-      "default.a2c.tooling.loop",
-      "default.a2c.tooling.run",
-      "Default A2C Tooling Loop",
-      "Open a session, preview a pack, invoke a tool, and inspect the resulting linked records.",
-      ["preview", "quote", "pay", "session", "invoke", "inspect"]
-    ),
-    buildLoop(
-      "default.identity.anchor.loop",
-      "default.identity.anchor.run",
-      "Default Identity Anchor Loop",
-      "Preview identity attestation, register, link, anchor, and inspect the resulting default transaction records.",
-      ["preview", "quote", "pay", "register", "anchor", "inspect"]
-    )
-  ];
-}
-
-function buildTransactionClassPacks() {
-  const center = buildDefaultTransactionCenter();
-  const defaultSettlementMode = center.default_settlement && center.default_settlement.settlement_mode
-    ? center.default_settlement.settlement_mode
-    : null;
-  const defaultPaymentProtocol = center.default_payment && center.default_payment.protocol
-    ? center.default_payment.protocol
-    : null;
-  return [
-    {
-      class_pack_ref: "transaction.trust.receipt",
-      title: "Trust Receipt Transaction",
-      description: "Verify trust posture and validate the paired receipt as one grouped transaction class.",
-      workflow_ref: "trust.flow",
-      task_refs: ["trust.verify", "receipt.validate"],
-      category: "trust",
-      proof_handoff_kind: "receipt_validation",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      required_inputs: ["subject_id", "receipt_id"],
-      optional_inputs: ["payment_protocol", "settlement_mode"]
-    },
-    {
-      class_pack_ref: "transaction.runtime.consequence",
-      title: "Runtime Consequence Transaction",
-      description: "Emit a runtime consequence and anchor the resulting commitment as one grouped transaction class.",
-      workflow_ref: "runtime.consequence.flow",
-      task_refs: ["runtime.emit", "runtime.anchor"],
-      category: "runtime",
-      proof_handoff_kind: "runtime_anchor",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      required_inputs: ["intent_id", "event_type", "event_commitment"],
-      optional_inputs: ["payment_protocol", "settlement_mode"]
-    },
-    {
-      class_pack_ref: "transaction.admission.settlement",
-      title: "Admission Settlement Transaction",
-      description: "Preview admission and submit settlement as one grouped transaction class.",
-      workflow_ref: "admission.settlement.flow",
-      task_refs: ["admission.preview", "settlement.submit"],
-      category: "admission",
-      proof_handoff_kind: "admission_settlement",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      required_inputs: ["source_zone_id", "target_zone_id", "intent_id"],
-      optional_inputs: ["interaction_class", "payment_protocol", "settlement_mode"]
-    },
-    {
-      class_pack_ref: "transaction.registry.anchor",
-      title: "Registry Anchor Transaction",
-      description: "Register a record and anchor its commitment as one grouped transaction class.",
-      workflow_ref: "registry.anchor.flow",
-      task_refs: ["registry.register", "anchoring.submit"],
-      category: "registry",
-      proof_handoff_kind: "registry_anchor",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      required_inputs: ["subject_id", "record_type", "commitment_hash"],
-      optional_inputs: ["payment_protocol", "settlement_mode"]
-    },
-    {
-      class_pack_ref: "transaction.job.commitment",
-      title: "Job Commitment Transaction",
-      description: "Quote, reserve, and commit a job as one grouped transaction class.",
-      workflow_ref: "job.commitment.flow",
-      task_refs: ["jobs.quote", "jobs.reserve", "jobs.commit"],
-      category: "jobs",
-      proof_handoff_kind: "job_commitment",
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      required_inputs: ["job_type", "job_id"],
-      optional_inputs: ["payment_protocol", "settlement_mode"]
-    }
-  ];
-}
-
-function buildPrecommitInteractionPacks() {
-  const center = buildDefaultTransactionCenter();
-  const defaultSettlementMode = center.default_settlement && center.default_settlement.settlement_mode
-    ? center.default_settlement.settlement_mode
-    : null;
-  const defaultPaymentProtocol = center.default_payment && center.default_payment.protocol
-    ? center.default_payment.protocol
-    : null;
-  return [
-    {
-      precommit_pack_ref: "precommit.a2a.settlement.readiness",
-      title: "A2A Settlement Readiness",
-      description: "Negotiate, preview admission, and confirm commit posture before a committed settlement-class transaction.",
-      category: "a2a",
-      protocol: "a2a",
-      task_refs: ["a2a.negotiate", "admission.preview", "a2a.commit"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      commitment_signal: "a2a.commit",
-      readiness_kind: "settlement_commit_readiness",
-      recommended_next_surface: "/v1/transaction-center/transaction-class-packs/run",
-      recommended_next_ref: "transaction.admission.settlement",
-      required_inputs: ["counterparty_agent_id", "intent_id", "source_zone_id", "target_zone_id"],
-      optional_inputs: ["task_pack_ref", "negotiation_mode", "interaction_class", "payment_protocol", "settlement_mode"]
-    },
-    {
-      precommit_pack_ref: "precommit.a2c.tooling.readiness",
-      title: "A2C Tooling Readiness",
-      description: "Open the session, preview the tooling pack, and confirm admission posture before committed tooling execution.",
-      category: "a2c",
-      protocol: "a2c",
-      task_refs: ["a2c.session.open", "a2c.pack.preview", "admission.preview"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      commitment_signal: "a2c.pack.preview",
-      readiness_kind: "tooling_commit_readiness",
-      recommended_next_surface: "/v1/transaction-center/task-packs/invoke",
-      recommended_next_ref: "default.a2c.tooling.run",
-      required_inputs: ["agent_id", "channel_ref", "pack_ref", "source_zone_id", "target_zone_id"],
-      optional_inputs: ["interaction_class", "payment_protocol", "settlement_mode"]
-    },
-    {
-      precommit_pack_ref: "precommit.job.commitment.readiness",
-      title: "Job Commitment Readiness",
-      description: "Quote, preview admission, and reserve the job before committing the full job transaction class.",
-      category: "jobs",
-      protocol: "job",
-      task_refs: ["jobs.quote", "admission.preview", "jobs.reserve"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      commitment_signal: "jobs.reserve",
-      readiness_kind: "job_commitment_readiness",
-      recommended_next_surface: "/v1/transaction-center/transaction-class-packs/run",
-      recommended_next_ref: "transaction.job.commitment",
-      required_inputs: ["job_type", "job_id", "source_zone_id", "target_zone_id", "intent_id"],
-      optional_inputs: ["interaction_class", "payment_protocol", "settlement_mode"]
-    }
-  ];
-}
-
-function buildInteractionSpinePaths() {
-  const center = buildDefaultTransactionCenter();
-  const defaultSettlementMode = center.default_settlement && center.default_settlement.settlement_mode
-    ? center.default_settlement.settlement_mode
-    : null;
-  const defaultPaymentProtocol = center.default_payment && center.default_payment.protocol
-    ? center.default_payment.protocol
-    : null;
-  return [
-    {
-      spine_path_ref: "spine.a2a.settlement",
-      title: "A2A Settlement Spine",
-      description: "Compose negotiation, admission, commit, and settlement as one grouped machine-interaction spine path.",
-      category: "a2a",
-      protocol: "a2a",
-      precommit_pack_ref: "precommit.a2a.settlement.readiness",
-      committed_ref: "transaction.admission.settlement",
-      task_refs: ["a2a.negotiate", "admission.preview", "a2a.commit", "settlement.submit"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      proof_followthrough: "default.proof.bundle.loop",
-      required_inputs: ["counterparty_agent_id", "intent_id", "source_zone_id", "target_zone_id"],
-      optional_inputs: ["task_pack_ref", "negotiation_mode", "interaction_class", "payment_protocol", "settlement_mode"]
-    },
-    {
-      spine_path_ref: "spine.a2c.tooling",
-      title: "A2C Tooling Spine",
-      description: "Compose session open, pack preview, admission posture, and committed tooling execution as one grouped path.",
-      category: "a2c",
-      protocol: "a2c",
-      precommit_pack_ref: "precommit.a2c.tooling.readiness",
-      committed_ref: "default.a2c.tooling.run",
-      task_refs: ["a2c.session.open", "a2c.pack.preview", "admission.preview", "adapter.mcp.invoke"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      proof_followthrough: "default.proof.bundle.loop",
-      required_inputs: ["agent_id", "channel_ref", "pack_ref", "tool_name", "source_zone_id", "target_zone_id"],
-      optional_inputs: ["arguments", "interaction_class", "payment_protocol", "settlement_mode"]
-    },
-    {
-      spine_path_ref: "spine.job.commitment",
-      title: "Job Commitment Spine",
-      description: "Compose quote, admission, reserve, and commit as one grouped job interaction spine path.",
-      category: "jobs",
-      protocol: "job",
-      precommit_pack_ref: "precommit.job.commitment.readiness",
-      committed_ref: "transaction.job.commitment",
-      task_refs: ["jobs.quote", "admission.preview", "jobs.reserve", "jobs.commit"],
-      default_payment_protocol: defaultPaymentProtocol,
-      default_settlement_mode: defaultSettlementMode,
-      proof_followthrough: "default.proof.bundle.loop",
-      required_inputs: ["job_type", "job_id", "source_zone_id", "target_zone_id"],
-      optional_inputs: ["intent_id", "interaction_class", "payment_protocol", "settlement_mode"]
-    }
-  ];
-}
-
-function buildInteractionResultPackages() {
-  return buildInteractionSpinePaths().map((path) => ({
-    result_package_ref: path && path.spine_path_ref ? `result.${path.spine_path_ref}` : null,
-    source_kind: "interaction_spine_path",
-    source_ref: path && path.spine_path_ref ? path.spine_path_ref : null,
-    title: path && path.title ? `${path.title} Result Package` : "Interaction Result Package",
-    description: path && path.description
-      ? `${path.description} Preserve the composed output as a stable result-side package and proof-handoff seam.`
-      : "Preserve the composed output as a stable result-side package and proof-handoff seam.",
-    category: path && path.category ? path.category : null,
-    protocol: path && path.protocol ? path.protocol : null,
-    precommit_pack_ref: path && path.precommit_pack_ref ? path.precommit_pack_ref : null,
-    committed_ref: path && path.committed_ref ? path.committed_ref : null,
-    proof_followthrough: path && path.proof_followthrough ? path.proof_followthrough : null,
-    portable_handoff_surface: "/v1/transaction-center/result-packages/export",
-    portable_proof_surface: "/v1/proof-center/result-package-handoff/run",
-    default_payment_protocol: path && path.default_payment_protocol ? path.default_payment_protocol : null,
-    default_settlement_mode: path && path.default_settlement_mode ? path.default_settlement_mode : null,
-    seam_layers: [
-      "execution_consequence",
-      "payment_settlement_treasury",
-      "proof_handoff"
-    ],
-    required_inputs: Array.isArray(path && path.required_inputs) ? path.required_inputs : [],
-    optional_inputs: Array.isArray(path && path.optional_inputs) ? path.optional_inputs : []
-  }));
-}
-
-function buildInteractionResultPackageContinuationTemplates() {
-  return buildInteractionResultPackages().map((resultPackage) => ({
-    continuation_ref: resultPackage && resultPackage.result_package_ref
-      ? `continue.${resultPackage.result_package_ref}`
-      : null,
-    result_package_ref: resultPackage && resultPackage.result_package_ref ? resultPackage.result_package_ref : null,
-    source_ref: resultPackage && resultPackage.source_ref ? resultPackage.source_ref : null,
-    title: resultPackage && resultPackage.title
-      ? `${resultPackage.title} Continuation`
-      : "Interaction Result Package Continuation",
-    description: resultPackage && resultPackage.description
-      ? `${resultPackage.description} Continue through the reusable default path into proof-native follow-through.`
-      : "Continue through the reusable default path into proof-native follow-through.",
-    continuation_kind: "proof_native_default",
-    default_next_surface: "/v1/transaction-center/result-package-continuations/run",
-    default_export_surface: "/v1/transaction-center/result-packages/export",
-    default_proof_surface: "/v1/proof-center/result-package-handoff/run",
-    committed_ref: resultPackage && resultPackage.committed_ref ? resultPackage.committed_ref : null,
-    precommit_pack_ref: resultPackage && resultPackage.precommit_pack_ref ? resultPackage.precommit_pack_ref : null,
-    seam_layers: Array.isArray(resultPackage && resultPackage.seam_layers) ? resultPackage.seam_layers : [],
-    required_inputs: Array.isArray(resultPackage && resultPackage.required_inputs) ? resultPackage.required_inputs : [],
-    optional_inputs: Array.isArray(resultPackage && resultPackage.optional_inputs) ? resultPackage.optional_inputs : []
-  }));
-}
-
-function buildDefaultTransactionCenter() {
-  const settlementProfiles = Array.isArray(catalog.settlement_profiles) ? catalog.settlement_profiles : [];
-  const defaultSettlementProfile = settlementProfiles[0] || null;
-  const settlementModes = settlementProfiles
-    .map((profile) => profile && profile.mode)
-    .filter(Boolean);
-  return {
-    ok: true,
-    brand: "xytara",
-    product: "default transaction center",
-    payment_scheme: catalog.payment_scheme,
-    default_protocol: {
-      protocol: "mcp",
-      integration_id: "builtin.protocol.mcp",
-      task_ref: "adapter.mcp.invoke",
-      workflow_refs: ["a2c.tooling.flow"],
-      selection_reason: "production_default_protocol_lane"
-    },
-    default_payment: {
-      protocol: "x402",
-      integration_id: "builtin.payment.x402",
-      payment_scheme: catalog.payment_scheme,
-      supported_settlement_modes: settlementModes,
-      selection_reason: "production_default_payment_lane"
-    },
-    default_settlement: {
-      integration_id: "builtin.settlement.chain",
-      settlement_mode: defaultSettlementProfile && defaultSettlementProfile.mode ? defaultSettlementProfile.mode : null,
-      adapter: defaultSettlementProfile && defaultSettlementProfile.adapter ? defaultSettlementProfile.adapter : null,
-      asset: defaultSettlementProfile && defaultSettlementProfile.asset ? defaultSettlementProfile.asset : null,
-      payee_agent_id: defaultSettlementProfile && defaultSettlementProfile.payee_agent_id ? defaultSettlementProfile.payee_agent_id : null,
-      payee_label: defaultSettlementProfile && defaultSettlementProfile.payee_label ? defaultSettlementProfile.payee_label : null,
-      supported_modes: settlementModes,
-      profile_count: settlementProfiles.length
-    },
-    default_treasury: {
-      destination_kind: "account_treasury",
-      destination_template: "treasury_{account_id}",
-      settlement_mode: defaultSettlementProfile && defaultSettlementProfile.mode ? defaultSettlementProfile.mode : null,
-      payee_agent_id: defaultSettlementProfile && defaultSettlementProfile.payee_agent_id ? defaultSettlementProfile.payee_agent_id : null,
-      payee_label: defaultSettlementProfile && defaultSettlementProfile.payee_label ? defaultSettlementProfile.payee_label : null
-    },
-    suggested_paths: [
-      {
-        path_id: "default_mcp_x402_path",
-        path_kind: "first_party_default",
-        protocol: "mcp",
-        payment_protocol: "x402",
-        settlement_mode: defaultSettlementProfile && defaultSettlementProfile.mode ? defaultSettlementProfile.mode : null,
-        task_ref: "adapter.mcp.invoke",
-        integration_ids: ["builtin.protocol.mcp", "builtin.payment.x402", "builtin.settlement.chain"]
-      },
-      {
-        path_id: "default_a2c_tooling_flow",
-        path_kind: "first_party_default",
-        protocol: "mcp",
-        payment_protocol: "x402",
-        settlement_mode: defaultSettlementProfile && defaultSettlementProfile.mode ? defaultSettlementProfile.mode : null,
-        workflow_ref: "a2c.tooling.flow",
-        integration_ids: ["builtin.protocol.mcp", "builtin.payment.x402", "builtin.settlement.chain"]
-      }
-    ]
-  };
-}
-
-function summarizeDefaultTransactionCenter() {
-  const center = buildDefaultTransactionCenter();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: center.product,
-    payment_scheme: center.payment_scheme,
-    default_protocol: center.default_protocol.protocol,
-    default_payment_protocol: center.default_payment.protocol,
-    default_settlement_mode: center.default_settlement.settlement_mode,
-    default_treasury_kind: center.default_treasury.destination_kind,
-    settlement_mode_count: Array.isArray(center.default_settlement.supported_modes) ? center.default_settlement.supported_modes.length : 0,
-    settlement_modes: center.default_settlement.supported_modes,
-    suggested_path_count: Array.isArray(center.suggested_paths) ? center.suggested_paths.length : 0,
-    suggested_paths: center.suggested_paths
-  };
-}
-
-function buildDefaultTransactionEconomics() {
-  const center = buildDefaultTransactionCenter();
-  const settlement = center.default_settlement || {};
-  const payment = center.default_payment || {};
-  const treasury = center.default_treasury || {};
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "default transaction economics",
-    payment_protocol: payment.protocol || null,
-    payment_scheme: payment.payment_scheme || center.payment_scheme || null,
-    default_settlement_mode: settlement.settlement_mode || null,
-    supported_settlement_modes: Array.isArray(settlement.supported_modes) ? settlement.supported_modes : [],
-    settlement_adapter: settlement.adapter || null,
-    settlement_asset: settlement.asset || null,
-    payee_agent_id: settlement.payee_agent_id || null,
-    payee_label: settlement.payee_label || null,
-    treasury_destination_kind: treasury.destination_kind || null,
-    treasury_destination_template: treasury.destination_template || null,
-    suggested_path_ids: Array.isArray(center.suggested_paths)
-      ? center.suggested_paths.map((entry) => entry && entry.path_id).filter(Boolean)
-      : []
-  };
-}
-
-function summarizeDefaultTransactionEconomics() {
-  const economics = buildDefaultTransactionEconomics();
-  return {
-    ok: true,
-    brand: economics.brand,
-    product: economics.product,
-    payment_protocol: economics.payment_protocol,
-    payment_scheme: economics.payment_scheme,
-    default_settlement_mode: economics.default_settlement_mode,
-    settlement_mode_count: economics.supported_settlement_modes.length,
-    supported_settlement_modes: economics.supported_settlement_modes,
-    treasury_destination_kind: economics.treasury_destination_kind,
-    payee_agent_id: economics.payee_agent_id,
-    suggested_path_count: economics.suggested_path_ids.length,
-    suggested_path_ids: economics.suggested_path_ids
-  };
-}
-
-function buildDefaultTransactionTaskPackCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const packs = buildDefaultTransactionTaskPacks();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "default transaction task packs",
-    default_protocol: center.default_protocol && center.default_protocol.protocol ? center.default_protocol.protocol : null,
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    pack_count: packs.length,
-    packs
-  };
-}
-
-function summarizeDefaultTransactionTaskPacks() {
-  const catalogResponse = buildDefaultTransactionTaskPackCatalog();
-  const packs = Array.isArray(catalogResponse.packs) ? catalogResponse.packs : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_protocol: catalogResponse.default_protocol,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    pack_count: packs.length,
-    pack_refs: packs.map((entry) => entry && entry.pack_ref).filter(Boolean),
-    direct_pack_count: packs.filter((entry) => entry && entry.pack_kind === "task_set").length,
-    workflow_pack_count: packs.filter((entry) => entry && entry.pack_kind === "workflow_pack").length,
-    packs
-  };
-}
-
-function getDefaultTransactionTaskPack(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildDefaultTransactionTaskPacks().find((entry) => entry && entry.pack_ref === normalized) || null;
-}
-
-function buildDefaultTransactionGuidedLoopCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const loops = buildDefaultTransactionGuidedLoops();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "default transaction guided loops",
-    default_protocol: center.default_protocol && center.default_protocol.protocol ? center.default_protocol.protocol : null,
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    loop_count: loops.length,
-    loops
-  };
-}
-
-function summarizeDefaultTransactionGuidedLoops() {
-  const catalogResponse = buildDefaultTransactionGuidedLoopCatalog();
-  const loops = Array.isArray(catalogResponse.loops) ? catalogResponse.loops : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_protocol: catalogResponse.default_protocol,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    loop_count: loops.length,
-    loop_refs: loops.map((entry) => entry && entry.loop_ref).filter(Boolean),
-    loops
-  };
-}
-
-function getDefaultTransactionGuidedLoop(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildDefaultTransactionGuidedLoops().find((entry) => entry && entry.loop_ref === normalized) || null;
-}
-
-function buildTransactionClassPackCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const packs = buildTransactionClassPacks();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "transaction class packs",
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    class_pack_count: packs.length,
-    class_packs: packs
-  };
-}
-
-function buildPrecommitInteractionPackCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const packs = buildPrecommitInteractionPacks();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "precommit interaction packs",
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    precommit_pack_count: packs.length,
-    precommit_packs: packs
-  };
-}
-
-function buildInteractionSpinePathCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const paths = buildInteractionSpinePaths();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "interaction spine paths",
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    spine_path_count: paths.length,
-    spine_paths: paths
-  };
-}
-
-function buildInteractionResultPackageCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const packages = buildInteractionResultPackages();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "interaction result packages",
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    result_package_count: packages.length,
-    result_packages: packages
-  };
-}
-
-function buildInteractionResultPackageContinuationCatalog() {
-  const center = buildDefaultTransactionCenter();
-  const templates = buildInteractionResultPackageContinuationTemplates();
-  return {
-    ok: true,
-    brand: center.brand,
-    product: "interaction result package continuations",
-    default_payment_protocol: center.default_payment && center.default_payment.protocol ? center.default_payment.protocol : null,
-    default_settlement_mode: center.default_settlement && center.default_settlement.settlement_mode ? center.default_settlement.settlement_mode : null,
-    continuation_count: templates.length,
-    continuations: templates
-  };
-}
-
-function summarizeTransactionClassPacks() {
-  const catalogResponse = buildTransactionClassPackCatalog();
-  const packs = Array.isArray(catalogResponse.class_packs) ? catalogResponse.class_packs : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    class_pack_count: packs.length,
-    class_pack_refs: packs.map((entry) => entry && entry.class_pack_ref).filter(Boolean),
-    categories: Array.from(new Set(packs.map((entry) => entry && entry.category).filter(Boolean))),
-    class_packs: packs
-  };
-}
-
-function summarizePrecommitInteractionPacks() {
-  const catalogResponse = buildPrecommitInteractionPackCatalog();
-  const packs = Array.isArray(catalogResponse.precommit_packs) ? catalogResponse.precommit_packs : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    precommit_pack_count: packs.length,
-    precommit_pack_refs: packs.map((entry) => entry && entry.precommit_pack_ref).filter(Boolean),
-    categories: Array.from(new Set(packs.map((entry) => entry && entry.category).filter(Boolean))),
-    precommit_packs: packs
-  };
-}
-
-function summarizeInteractionSpinePaths() {
-  const catalogResponse = buildInteractionSpinePathCatalog();
-  const paths = Array.isArray(catalogResponse.spine_paths) ? catalogResponse.spine_paths : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    spine_path_count: paths.length,
-    spine_path_refs: paths.map((entry) => entry && entry.spine_path_ref).filter(Boolean),
-    categories: Array.from(new Set(paths.map((entry) => entry && entry.category).filter(Boolean))),
-    spine_paths: paths
-  };
-}
-
-function summarizeInteractionResultPackages() {
-  const catalogResponse = buildInteractionResultPackageCatalog();
-  const packages = Array.isArray(catalogResponse.result_packages) ? catalogResponse.result_packages : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    result_package_count: packages.length,
-    result_package_refs: packages.map((entry) => entry && entry.result_package_ref).filter(Boolean),
-    source_refs: packages.map((entry) => entry && entry.source_ref).filter(Boolean),
-    seam_layers: Array.from(new Set(packages.flatMap((entry) => Array.isArray(entry && entry.seam_layers) ? entry.seam_layers : []))),
-    result_packages: packages
-  };
-}
-
-function summarizeInteractionResultPackageContinuations() {
-  const catalogResponse = buildInteractionResultPackageContinuationCatalog();
-  const templates = Array.isArray(catalogResponse.continuations) ? catalogResponse.continuations : [];
-  return {
-    ok: true,
-    brand: catalogResponse.brand,
-    product: catalogResponse.product,
-    default_payment_protocol: catalogResponse.default_payment_protocol,
-    default_settlement_mode: catalogResponse.default_settlement_mode,
-    continuation_count: templates.length,
-    continuation_refs: templates.map((entry) => entry && entry.continuation_ref).filter(Boolean),
-    result_package_refs: templates.map((entry) => entry && entry.result_package_ref).filter(Boolean),
-    continuations: templates
-  };
-}
-
-function getTransactionClassPack(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildTransactionClassPacks().find((entry) => entry && entry.class_pack_ref === normalized) || null;
-}
-
-function getPrecommitInteractionPack(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildPrecommitInteractionPacks().find((entry) => entry && entry.precommit_pack_ref === normalized) || null;
-}
-
-function getInteractionSpinePath(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildInteractionSpinePaths().find((entry) => entry && entry.spine_path_ref === normalized) || null;
-}
-
-function getInteractionResultPackage(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildInteractionResultPackages().find((entry) => entry && entry.result_package_ref === normalized) || null;
-}
-
-function getInteractionResultPackageContinuation(ref) {
-  const normalized = String(ref || "").trim();
-  if (!normalized) return null;
-  return buildInteractionResultPackageContinuationTemplates().find((entry) => entry && entry.continuation_ref === normalized) || null;
-}
-
-function buildCatalogResponse() {
-  return {
-    ok: true,
-    brand: "xytara",
-    product: "governed transaction rail",
-    version: catalog.version,
-    catalog_version: catalog.version,
-    currency: catalog.currency,
-    payment_scheme: catalog.payment_scheme,
-    plans: catalog.plans,
-    capabilities: catalog.capabilities,
-    adapters: catalog.adapters,
-    settlement_profiles: catalog.settlement_profiles,
-    task_categories: catalog.task_categories,
-    workflows: catalog.workflows,
-    surfaces: catalog.surfaces,
-    tasks: catalog.tasks
-  };
-}
-
-function summarizeCatalog() {
-  const fullCatalog = buildCatalogResponse();
-  return {
-    ok: true,
-    brand: fullCatalog.brand,
-    product: fullCatalog.product,
-    version: fullCatalog.catalog_version,
-    currency: fullCatalog.currency,
-    payment_scheme: fullCatalog.payment_scheme,
-    capabilities: fullCatalog.capabilities,
-    adapters: fullCatalog.adapters,
-    task_count: fullCatalog.tasks.length,
-    workflow_count: fullCatalog.workflows.length,
-    category_count: fullCatalog.task_categories.length,
-    task_categories: fullCatalog.task_categories,
-    settlement_profile_count: fullCatalog.settlement_profiles.length,
-    settlement_profiles: fullCatalog.settlement_profiles,
-    workflows: fullCatalog.workflows,
-    tasks: fullCatalog.tasks.map((task) => ({
-      task_ref: task.public_task_ref,
-      internal_task_ref: task.task_ref,
-      public_task_ref: task.public_task_ref,
-      aliases: task.public_aliases,
-      category: task.public_category,
-      title: task.public_title,
-      execution_mode: task.execution_mode,
-      pricing_band: task.pricing_band,
-      public_launch_price: task.public_launch_price,
-      pricing_note: task.pricing_note,
-      latency_class: task.latency_class,
-      failure_posture: task.failure_posture,
-      task_family: task.task_family,
-      lifecycle_stage: task.lifecycle_stage,
-      market_class: task.market_class,
-      claim_status: task.claim_status,
-      evidence_status: task.evidence_status,
-      capabilities: task.capabilities,
-      adapters: task.adapters
-    })),
-    workflow_summaries: fullCatalog.workflows.map((workflow) => ({
-      workflow_ref: workflow.workflow_ref,
-      aliases: workflow.aliases,
-      category: workflow.category,
-      title: workflow.title,
-      task_count: workflow.task_count,
-      latency_class: workflow.latency_class,
-      failure_posture: workflow.failure_posture,
-      pricing_basis: workflow.pricing_basis
-    }))
-  };
-}
-
-function getCatalog() {
-  return buildCatalogResponse();
-}
-
-function getTaskDetail(ref) {
-  const task = findTask(ref);
-  if (!task) {
-    return null;
-  }
-  return {
-    task_ref: task.task_ref,
-    public_task_ref: task.public_task_ref,
-    aliases: task.public_aliases,
-    category: task.public_category,
-    title: task.public_title,
-    execution_mode: task.execution_mode,
-    pricing_band: task.pricing_band,
-    public_launch_price: task.public_launch_price,
-    pricing_note: task.pricing_note,
-    latency_class: task.latency_class,
-    failure_posture: task.failure_posture,
-    task_family: task.task_family,
-    lifecycle_stage: task.lifecycle_stage,
-    market_class: task.market_class,
-    claim_status: task.claim_status,
-    evidence_status: task.evidence_status,
-    input_schema: task.input_schema,
-    capabilities: task.capabilities,
-    adapters: task.adapters
-  };
-}
-
-function buildWorkflowShape(workflow) {
-  const workflowTasks = (Array.isArray(workflow.task_refs) ? workflow.task_refs : [])
-    .map((taskRef) => findTask(taskRef))
-    .filter(Boolean)
-    .map((task) => ({
-      public_task_ref: task.public_task_ref,
-      task_ref: task.task_ref,
-      title: task.public_title,
-      category: task.public_category,
-      latency_class: task.latency_class,
-      failure_posture: task.failure_posture,
-      task_family: task.task_family,
-      lifecycle_stage: task.lifecycle_stage,
-      market_class: task.market_class,
-      claim_status: task.claim_status,
-      evidence_status: task.evidence_status,
-      pricing_band: task.pricing_band,
-      public_launch_price: task.public_launch_price
-    }));
-  return {
-    ...workflow,
-    pricing_note: "Workflow pricing is determined by the quoted task set, not a fixed bundle price.",
-    task_refs: workflowTasks.map((task) => task.public_task_ref || task.task_ref),
-    task_count: workflowTasks.length,
-    tasks: workflowTasks
-  };
-}
-
-function getWorkflowList() {
-  return catalog.workflows.map(buildWorkflowShape);
-}
-
-function getWorkflowDetail(ref) {
-  const workflow = findWorkflow(ref);
-  if (!workflow) {
-    return null;
-  }
-  return buildWorkflowShape(workflow);
-}
-
-function getCreditPackList() {
-  return (Array.isArray(catalog.credit_packs) ? catalog.credit_packs : []).map((pack) => ({
-    ...pack
-  }));
-}
-
-function getCreditPackDetail(ref) {
-  const pack = findCreditPack(ref);
-  if (!pack) {
-    return null;
-  }
-  return {
-    ...pack
-  };
-}
-
-function summarizeCreditPacks() {
-  const packs = getCreditPackList();
-  const categoryCounts = packs.reduce((acc, pack) => {
-    const key = pack && pack.category ? pack.category : "unknown";
-    acc[key] = (acc[key] || 0) + 1;
-    return acc;
-  }, {});
-  const pricingBandCoverage = Array.from(new Set(
-    packs.flatMap((pack) => Array.isArray(pack && pack.task_band_targets) ? pack.task_band_targets : []).filter(Boolean)
-  )).sort((left, right) => String(left).localeCompare(String(right)));
-  return {
-    ok: true,
-    credit_pack_count: packs.length,
-    categories: Object.entries(categoryCounts)
-      .map(([category, pack_count]) => ({ category, pack_count }))
-      .sort((left, right) => String(left.category).localeCompare(String(right.category))),
-    pricing_band_coverage_count: pricingBandCoverage.length,
-    pricing_band_coverage: pricingBandCoverage,
-    credit_packs: packs.map((pack) => ({
-      pack_id: pack.pack_id,
-      title: pack.title,
-      category: pack.category,
-      issued_units: pack.issued_units,
-      intended_usage_posture: pack.intended_usage_posture
-    }))
-  };
-}
-
-module.exports = {
-  buildCatalogResponse,
-  buildDefaultTransactionEconomics,
-  buildDefaultTransactionCenter,
-  buildDefaultTransactionGuidedLoopCatalog,
-  buildInteractionResultPackageCatalog,
-  buildInteractionResultPackageContinuationCatalog,
-  buildInteractionSpinePathCatalog,
-  buildPrecommitInteractionPackCatalog,
-  buildDefaultTransactionTaskPackCatalog,
-  buildTransactionClassPackCatalog,
-  getCreditPackDetail,
-  getCreditPackList,
-  getCatalog,
-  getDefaultTransactionGuidedLoop,
-  getDefaultTransactionTaskPack,
-  getInteractionResultPackage,
-  getInteractionResultPackageContinuation,
-  getInteractionSpinePath,
-  getPrecommitInteractionPack,
-  getTransactionClassPack,
-  getTaskDetail,
-  getWorkflowDetail,
-  getWorkflowList,
-  summarizeCatalog,
-  summarizeDefaultTransactionCenter,
-  summarizeDefaultTransactionEconomics,
-  summarizeDefaultTransactionGuidedLoops,
-  summarizeDefaultTransactionTaskPacks,
-  summarizeCreditPacks,
-  summarizeInteractionResultPackageContinuations,
-  summarizeInteractionResultPackages,
-  summarizeInteractionSpinePaths,
-  summarizePrecommitInteractionPacks,
-  summarizeTransactionClassPacks
-};