xytara 3.1.0 → 3.1.2

package/lib/commerce_artifacts.js

@@ -1,503 +1,503 @@
-"use strict";
-
-const crypto = require("crypto");
-const { findTask } = require("../fixtures/catalog");
-const { buildDefaultEconomicPath, buildTreasuryDestination } = require("./commerce_quotes");
-const {
-  buildBsvTeranodeSettlementHints,
-  extractBsvTeranodePaymentReference,
-  isBsvTeranodeSettlementMode
-} = require("./settlement_bsv_teranode");
-
-function classifyObservedLatency(durationMs) {
-  if (durationMs <= 1000) return "instant";
-  if (durationMs <= 15000) return "near_real_time";
-  return "governed_async";
-}
-
-function assessLatency(declaredLatencyClass, observedLatencyClass) {
-  const order = {
-    instant: 1,
-    near_real_time: 2,
-    governed_async: 3
-  };
-  const declared = order[declaredLatencyClass] || 99;
-  const observed = order[observedLatencyClass] || 99;
-  return observed <= declared ? "within_posture" : "outside_posture";
-}
-
-function createCommandArtifacts(payload, quote, options) {
-  const opts = options || {};
-  const transactionId = `txn_${crypto.randomBytes(6).toString("hex")}`;
-  const receiptId = `rcpt_${crypto.randomBytes(6).toString("hex")}`;
-  const startedAt = new Date();
-  const durationMs = 250;
-  const completedAt = new Date(startedAt.getTime() + durationMs);
-  const requestedTasks = Array.isArray(payload.tasks) && payload.tasks.length > 0
-    ? payload.tasks.map((task, index) => ({
-        task_id: task && task.task_id ? String(task.task_id).trim() : `task_${index + 1}`,
-        task_ref: task && task.task_ref ? String(task.task_ref).trim() : ""
-      }))
-    : [{
-        task_id: "task_1",
-        task_ref: String(payload.task_ref || "").trim()
-      }];
-  const resolvedTasks = requestedTasks
-    .map((task) => {
-      const catalogTask = findTask(task.task_ref);
-      return catalogTask ? { ...task, catalogTask } : null;
-    })
-    .filter(Boolean);
-  const primaryTask = resolvedTasks[0] && resolvedTasks[0].catalogTask ? resolvedTasks[0].catalogTask : null;
-  const declaredLatencyClass = (primaryTask && primaryTask.latency_class) || "near_real_time";
-  const observedLatencyClass = classifyObservedLatency(durationMs);
-  const deferredCompletion = opts.deferredCompletion === true;
-  const timing = {
-    declared_latency_class: declaredLatencyClass,
-    started_at_iso: startedAt.toISOString(),
-    completed_at_iso: deferredCompletion ? null : completedAt.toISOString(),
-    duration_ms: deferredCompletion ? null : durationMs,
-    observed_latency_class: deferredCompletion ? null : observedLatencyClass,
-    assessment: deferredCompletion ? "pending" : assessLatency(declaredLatencyClass, observedLatencyClass)
-  };
-  const resultTasks = resolvedTasks.length > 0 ? resolvedTasks : requestedTasks.map((task) => ({
-    ...task,
-    catalogTask: null
-  }));
-  const normalizedBody = payload && payload.body && typeof payload.body === "object" && !Array.isArray(payload.body)
-    ? payload.body
-    : {};
-  const externalExecution = opts.externalExecution && typeof opts.externalExecution === "object"
-    ? opts.externalExecution
-    : null;
-  const externalResponse = externalExecution && externalExecution.target_response && typeof externalExecution.target_response === "object"
-    ? externalExecution.target_response
-    : null;
-  const resultsByTaskId = Object.fromEntries(resultTasks.map((task, index) => [
-    task.task_id,
-    (() => {
-      const base = {
-        task_ref: task.task_ref,
-        status: "completed",
-        output_ref: `output_${transactionId}_${index + 1}`
-      };
-      if (task.task_ref === "admission.preview") {
-        base.preview_kind = "admission";
-        base.admission_ref = `admission_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "a2a.negotiate") {
-        base.negotiation_ref = `a2a_negotiation_${transactionId}_${index + 1}`;
-        base.interaction_front = "a2a";
-      }
-      if (task.task_ref === "a2a.commit") {
-        base.negotiation_ref = `a2a_negotiation_${transactionId}_${index + 1}`;
-        base.commitment_ref = `a2a_commitment_${transactionId}_${index + 1}`;
-        base.interaction_front = "a2a";
-      }
-      if (task.task_ref === "a2c.session.open") {
-        base.session_ref = `a2c_session_${transactionId}_${index + 1}`;
-        base.interaction_front = "a2c";
-      }
-      if (task.task_ref === "a2c.pack.preview") {
-        base.preview_kind = "a2c_pack";
-        base.pack_preview_ref = `a2c_pack_preview_${transactionId}_${index + 1}`;
-        base.interaction_front = "a2c";
-      }
-      if (task.task_ref === "trust.handoff.emit") {
-        base.handoff_kind = "trust";
-        base.handoff_action = "emit";
-        base.handoff_ref = `trust_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "trust.handoff.validate") {
-        base.handoff_kind = "trust";
-        base.handoff_action = "validate";
-        base.handoff_ref = `trust_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "execution_receipt.handoff.emit") {
-        base.handoff_kind = "execution_receipt";
-        base.handoff_action = "emit";
-        base.handoff_ref = `execution_receipt_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "execution_receipt.handoff.validate") {
-        base.handoff_kind = "execution_receipt";
-        base.handoff_action = "validate";
-        base.handoff_ref = `execution_receipt_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "receipt_ledger.handoff.emit") {
-        base.handoff_kind = "receipt_ledger";
-        base.handoff_action = "emit";
-        base.handoff_ref = `receipt_ledger_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "receipt_ledger.handoff.validate") {
-        base.handoff_kind = "receipt_ledger";
-        base.handoff_action = "validate";
-        base.handoff_ref = `receipt_ledger_handoff_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "runtime.emit") {
-        base.runtime_ref = `runtime_event_${transactionId}_${index + 1}`;
-        base.runtime_action = "emit";
-      }
-      if (task.task_ref === "runtime.anchor") {
-        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
-        base.runtime_action = "anchor";
-      }
-      if (task.task_ref === "runtime.emit_anchor") {
-        base.runtime_ref = `runtime_event_${transactionId}_${index + 1}`;
-        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
-        base.runtime_action = "emit_anchor";
-      }
-      if (task.task_ref === "identity.attest.preview") {
-        base.preview_kind = "identity_attestation";
-        base.identity_attestation_ref = `identity_attestation_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "identity.registry.link") {
-        base.identity_link_ref = `identity_link_${transactionId}_${index + 1}`;
-        base.registry_record_ref = `registry_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "registry.register") {
-        base.registry_record_ref = `registry_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "registry.pack.bundle") {
-        base.registry_pack_ref = `registry_pack_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "anchoring.submit") {
-        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "anchoring.pack.preview") {
-        base.preview_kind = "anchoring_pack";
-        base.anchor_preview_ref = `anchor_preview_${transactionId}_${index + 1}`;
-      }
-      if (task.task_ref === "adapter.mcp.invoke") {
-        base.adapter_lane = "mcp";
-        base.tool_name = normalizedBody.tool_name || null;
-        base.invocation_status = externalExecution ? "provider_completed" : "simulated";
-      }
-      if (externalExecution) {
-        base.execution_provider = externalExecution.provider || null;
-        base.execution_target_id = externalExecution.target_id || null;
-        if (externalResponse && externalResponse.provider_job_id) base.provider_job_id = externalResponse.provider_job_id;
-        if (externalResponse && externalResponse.output_payload) base.output_payload = externalResponse.output_payload;
-        if (externalResponse && externalResponse.output_ref) base.output_ref = externalResponse.output_ref;
-        base.provider_status = externalResponse && externalResponse.provider_status
-          ? externalResponse.provider_status
-          : "completed";
-      }
-      return base;
-    })()
-  ]));
-  const capabilityScopes = Array.from(new Set(resultTasks.flatMap((task) =>
-    Array.isArray(task.catalogTask && task.catalogTask.capabilities) ? task.catalogTask.capabilities : []
-  )));
-  const adaptersUsed = Array.from(new Set(resultTasks.flatMap((task) =>
-    Array.isArray(task.catalogTask && task.catalogTask.adapters) ? task.catalogTask.adapters : []
-  )));
-  const remediation = {
-    status: "none",
-    reason_code: null,
-    active_case_type: null,
-    active_case_id: null,
-    compensating_action_status: null,
-    updated_at_iso: completedAt.toISOString()
-  };
-  const payment = {
-    payment_id: `pay_${quote.quote_id}`,
-    scheme: quote.payment_scheme || "native",
-    protocol: quote.payment_protocol || null,
-    status: deferredCompletion ? "authorized" : "recorded",
-    amount_minor: quote.amount_minor,
-    currency: quote.currency,
-    quote_id: quote.quote_id,
-    wallet_id: opts.paymentVerification && opts.paymentVerification.wallet_id
-      ? opts.paymentVerification.wallet_id
-      : null,
-    verification_mode: opts.paymentVerification && opts.paymentVerification.verification_mode
-      ? opts.paymentVerification.verification_mode
-      : null,
-    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
-  };
-  const bsvHints = buildBsvTeranodeSettlementHints({
-    settlementMode: quote.settlement_mode,
-    amountMinor: quote.amount_minor,
-    currency: quote.currency,
-    settlementBindingHash: quote.settlement_binding_hash,
-    treasuryDestination: quote.treasury
-  });
-  const bsvPaymentReference = extractBsvTeranodePaymentReference(
-    opts.paymentVerification && opts.paymentVerification.payment_payload
-      ? opts.paymentVerification.payment_payload
-      : null
-  );
-  const settlement = {
-    settlement_id: `settlement_${transactionId}`,
-    mode: quote.settlement_mode || null,
-    preference: quote.settlement_preference || null,
-    adapter: quote.settlement_adapter || null,
-    integration_id: quote.settlement_integration_id || null,
-    binding_hash: quote.settlement_binding_hash || null,
-    rail: isBsvTeranodeSettlementMode(quote.settlement_mode) ? "bsv_teranode" : null,
-    network: bsvHints ? bsvHints.network : null,
-    hints: bsvHints,
-    txid: bsvPaymentReference && bsvPaymentReference.txid ? bsvPaymentReference.txid : null,
-    raw_tx: bsvPaymentReference && (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
-      ? (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
-      : null,
-    status: deferredCompletion ? "pending_completion" : "recorded",
-    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
-  };
-  const treasuryDestination = buildTreasuryDestination(quote.account_id, quote.settlement_mode);
-  const treasury = {
-    ...treasuryDestination,
-    treasury_receipt_id: `treasury_${receiptId}`,
-    status: deferredCompletion ? "pending_settlement" : "recorded",
-    amount_minor: quote.amount_minor,
-    currency: quote.currency,
-    payment_id: payment.payment_id,
-    settlement_id: settlement.settlement_id,
-    custody_external_ref: treasuryDestination.external_ref || null,
-    rail: treasuryDestination.rail || settlement.rail || null,
-    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
-  };
-  const defaultPath = quote.default_path || buildDefaultEconomicPath(
-    Array.isArray(quote.integration_ids)
-      ? quote.integration_ids.find((integrationId) => typeof integrationId === "string" && integrationId.startsWith("builtin.payment."))
-      : null,
-    quote.settlement_integration_id || null,
-    treasury,
-    {
-      paymentProtocol: quote.payment_protocol || null,
-      settlementMode: quote.settlement_mode || null,
-      status: deferredCompletion ? "pending_completion" : "recorded"
-    }
-  );
-  const transaction = {
-    transaction_id: transactionId,
-    account_id: quote.account_id,
-    status: deferredCompletion ? "accepted" : "completed",
-    intent: payload.command || "command.execute",
-    amount_minor: quote.amount_minor,
-    currency: quote.currency,
-    quote_id: quote.quote_id,
-    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
-    protocols: Array.isArray(quote.protocols) ? quote.protocols : [],
-    output_ref: externalResponse && externalResponse.output_ref ? externalResponse.output_ref : `output_${transactionId}`,
-    callback_url: payload.callback_url || null,
-    capabilities: quote.capabilities,
-    adapters: quote.adapters,
-    payment,
-    settlement,
-    treasury,
-    default_path: {
-      ...defaultPath,
-      status: deferredCompletion ? "pending_completion" : "recorded"
-    },
-    execution: {
-      status: deferredCompletion ? "accepted" : "completed",
-      task_count: resultTasks.length,
-      capability_scopes: capabilityScopes,
-      adapters_used: adaptersUsed,
-      integration_ids: Array.isArray(quote.execution_integration_ids) ? quote.execution_integration_ids : [],
-      results_by_task_id: resultsByTaskId,
-      provider: externalExecution ? externalExecution.provider || null : null,
-      provider_target_id: externalExecution ? externalExecution.target_id || null : null,
-      provider_job_id: externalResponse && externalResponse.provider_job_id ? externalResponse.provider_job_id : null
-    },
-    created_at_iso: startedAt.toISOString(),
-    completed_at_iso: deferredCompletion ? null : completedAt.toISOString(),
-    timing,
-    remediation
-  };
-  const receipt = {
-    receipt_id: receiptId,
-    transaction_id: transactionId,
-    account_id: quote.account_id,
-    status: deferredCompletion ? "pending" : "completed",
-    amount_minor: quote.amount_minor,
-    currency: quote.currency,
-    quote_id: quote.quote_id,
-    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
-    settlement_integration_id: quote.settlement_integration_id || null,
-    payment,
-    settlement,
-    treasury,
-    default_path: {
-      ...defaultPath,
-      status: deferredCompletion ? "pending_completion" : "recorded"
-    },
-    proof_ref: externalResponse && externalResponse.proof_ref ? externalResponse.proof_ref : `proof_${receiptId}`,
-    execution_summary: {
-      command: payload.command || "command.execute",
-      task_count: resultTasks.length,
-      tasks: resultTasks.map((task) => ({
-        task_id: task.task_id,
-        task_ref: task.task_ref
-      }))
-    },
-    created_at_iso: deferredCompletion ? startedAt.toISOString() : completedAt.toISOString(),
-    timing,
-    remediation
-  };
-  const command = {
-    command: payload.command || "command.execute",
-    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
-    payment,
-    settlement,
-    treasury,
-    default_path: {
-      ...defaultPath,
-      status: deferredCompletion ? "pending_completion" : "recorded"
-    },
-    deliverables: resultTasks.map((task, index) => ({
-      kind: task.task_ref === "admission.preview" ? "preview" : "result",
-      ...(task.task_ref === "a2c.pack.preview"
-        ? {
-            kind: "preview"
-          }
-        : {}),
-      task_id: task.task_id,
-      task_ref: task.task_ref,
-      ref: `deliverable_${transactionId}_${index + 1}`,
-      ...(task.task_ref === "admission.preview"
-        ? {
-            admission_ref: `admission_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "identity.attest.preview"
-        ? {
-            kind: "preview",
-            identity_attestation_ref: `identity_attestation_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "identity.registry.link"
-        ? {
-            identity_link_ref: `identity_link_${transactionId}_${index + 1}`,
-            registry_record_ref: `registry_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "a2a.negotiate"
-        ? {
-            negotiation_ref: `a2a_negotiation_${transactionId}_${index + 1}`,
-            interaction_front: "a2a"
-          }
-        : {}),
-      ...(task.task_ref === "a2a.commit"
-        ? {
-            negotiation_ref: `a2a_negotiation_${transactionId}_${index + 1}`,
-            commitment_ref: `a2a_commitment_${transactionId}_${index + 1}`,
-            interaction_front: "a2a"
-          }
-        : {}),
-      ...(task.task_ref === "a2c.session.open"
-        ? {
-            session_ref: `a2c_session_${transactionId}_${index + 1}`,
-            interaction_front: "a2c"
-          }
-        : {}),
-      ...(task.task_ref === "a2c.pack.preview"
-        ? {
-            pack_preview_ref: `a2c_pack_preview_${transactionId}_${index + 1}`,
-            interaction_front: "a2c"
-          }
-        : {}),
-      ...(task.task_ref === "trust.handoff.emit"
-        ? {
-            handoff_kind: "trust",
-            handoff_action: "emit",
-            handoff_ref: `trust_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "trust.handoff.validate"
-        ? {
-            handoff_kind: "trust",
-            handoff_action: "validate",
-            handoff_ref: `trust_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "execution_receipt.handoff.emit"
-        ? {
-            handoff_kind: "execution_receipt",
-            handoff_action: "emit",
-            handoff_ref: `execution_receipt_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "execution_receipt.handoff.validate"
-        ? {
-            handoff_kind: "execution_receipt",
-            handoff_action: "validate",
-            handoff_ref: `execution_receipt_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "receipt_ledger.handoff.emit"
-        ? {
-            handoff_kind: "receipt_ledger",
-            handoff_action: "emit",
-            handoff_ref: `receipt_ledger_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "receipt_ledger.handoff.validate"
-        ? {
-            handoff_kind: "receipt_ledger",
-            handoff_action: "validate",
-            handoff_ref: `receipt_ledger_handoff_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "runtime.emit"
-        ? {
-            runtime_ref: `runtime_event_${transactionId}_${index + 1}`,
-            runtime_action: "emit"
-          }
-        : {}),
-      ...(task.task_ref === "runtime.anchor"
-        ? {
-            anchor_ref: `anchor_${transactionId}_${index + 1}`,
-            runtime_action: "anchor"
-          }
-        : {}),
-      ...(task.task_ref === "runtime.emit_anchor"
-        ? {
-            runtime_ref: `runtime_event_${transactionId}_${index + 1}`,
-            anchor_ref: `anchor_${transactionId}_${index + 1}`,
-            runtime_action: "emit_anchor"
-          }
-        : {}),
-      ...(task.task_ref === "registry.register"
-        ? {
-            registry_record_ref: `registry_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "registry.pack.bundle"
-        ? {
-            registry_pack_ref: `registry_pack_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "anchoring.submit"
-        ? {
-            anchor_ref: `anchor_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "anchoring.pack.preview"
-        ? {
-            kind: "preview",
-            anchor_preview_ref: `anchor_preview_${transactionId}_${index + 1}`
-          }
-        : {}),
-      ...(task.task_ref === "adapter.mcp.invoke"
-        ? {
-            adapter_lane: "mcp",
-            tool_name: normalizedBody.tool_name || null
-          }
-        : {})
-    })),
-    monitor: {
-      transaction_id: transactionId,
-      status_url: `/v1/governed-transactions/${transactionId}`,
-      receipt_url: `/v1/receipts/${receiptId}`,
-      delivery_url: `/v1/deliveries/delivery_${transactionId}`,
-      payment_url: `/v1/payment-ledger/${payment.payment_id}`
-    }
-  };
-  return { transaction, receipt, command };
-}
-
-module.exports = {
-  createCommandArtifacts
-};
+"use strict";
+
+const crypto = require("crypto");
+const { findTask } = require("../fixtures/catalog");
+const { buildDefaultEconomicPath, buildTreasuryDestination } = require("./commerce_quotes");
+const {
+  buildBsvTeranodeSettlementHints,
+  extractBsvTeranodePaymentReference,
+  isBsvTeranodeSettlementMode
+} = require("./settlement_bsv_teranode");
+
+function classifyObservedLatency(durationMs) {
+  if (durationMs <= 1000) return "instant";
+  if (durationMs <= 15000) return "near_real_time";
+  return "governed_async";
+}
+
+function assessLatency(declaredLatencyClass, observedLatencyClass) {
+  const order = {
+    instant: 1,
+    near_real_time: 2,
+    governed_async: 3
+  };
+  const declared = order[declaredLatencyClass] || 99;
+  const observed = order[observedLatencyClass] || 99;
+  return observed <= declared ? "within_posture" : "outside_posture";
+}
+
+function createCommandArtifacts(payload, quote, options) {
+  const opts = options || {};
+  const transactionId = `txn_${crypto.randomBytes(6).toString("hex")}`;
+  const receiptId = `rcpt_${crypto.randomBytes(6).toString("hex")}`;
+  const startedAt = new Date();
+  const durationMs = 250;
+  const completedAt = new Date(startedAt.getTime() + durationMs);
+  const requestedTasks = Array.isArray(payload.tasks) && payload.tasks.length > 0
+    ? payload.tasks.map((task, index) => ({
+        task_id: task && task.task_id ? String(task.task_id).trim() : `task_${index + 1}`,
+        task_ref: task && task.task_ref ? String(task.task_ref).trim() : ""
+      }))
+    : [{
+        task_id: "task_1",
+        task_ref: String(payload.task_ref || "").trim()
+      }];
+  const resolvedTasks = requestedTasks
+    .map((task) => {
+      const catalogTask = findTask(task.task_ref);
+      return catalogTask ? { ...task, catalogTask } : null;
+    })
+    .filter(Boolean);
+  const primaryTask = resolvedTasks[0] && resolvedTasks[0].catalogTask ? resolvedTasks[0].catalogTask : null;
+  const declaredLatencyClass = (primaryTask && primaryTask.latency_class) || "near_real_time";
+  const observedLatencyClass = classifyObservedLatency(durationMs);
+  const deferredCompletion = opts.deferredCompletion === true;
+  const timing = {
+    declared_latency_class: declaredLatencyClass,
+    started_at_iso: startedAt.toISOString(),
+    completed_at_iso: deferredCompletion ? null : completedAt.toISOString(),
+    duration_ms: deferredCompletion ? null : durationMs,
+    observed_latency_class: deferredCompletion ? null : observedLatencyClass,
+    assessment: deferredCompletion ? "pending" : assessLatency(declaredLatencyClass, observedLatencyClass)
+  };
+  const resultTasks = resolvedTasks.length > 0 ? resolvedTasks : requestedTasks.map((task) => ({
+    ...task,
+    catalogTask: null
+  }));
+  const normalizedBody = payload && payload.body && typeof payload.body === "object" && !Array.isArray(payload.body)
+    ? payload.body
+    : {};
+  const externalExecution = opts.externalExecution && typeof opts.externalExecution === "object"
+    ? opts.externalExecution
+    : null;
+  const externalResponse = externalExecution && externalExecution.target_response && typeof externalExecution.target_response === "object"
+    ? externalExecution.target_response
+    : null;
+  const resultsByTaskId = Object.fromEntries(resultTasks.map((task, index) => [
+    task.task_id,
+    (() => {
+      const base = {
+        task_ref: task.task_ref,
+        status: "completed",
+        output_ref: `output_${transactionId}_${index + 1}`
+      };
+      if (task.task_ref === "admission.preview") {
+        base.preview_kind = "admission";
+        base.admission_ref = `admission_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "a2a.negotiate") {
+        base.negotiation_ref = `a2a_negotiation_${transactionId}_${index + 1}`;
+        base.interaction_front = "a2a";
+      }
+      if (task.task_ref === "a2a.commit") {
+        base.negotiation_ref = `a2a_negotiation_${transactionId}_${index + 1}`;
+        base.commitment_ref = `a2a_commitment_${transactionId}_${index + 1}`;
+        base.interaction_front = "a2a";
+      }
+      if (task.task_ref === "a2c.session.open") {
+        base.session_ref = `a2c_session_${transactionId}_${index + 1}`;
+        base.interaction_front = "a2c";
+      }
+      if (task.task_ref === "a2c.pack.preview") {
+        base.preview_kind = "a2c_pack";
+        base.pack_preview_ref = `a2c_pack_preview_${transactionId}_${index + 1}`;
+        base.interaction_front = "a2c";
+      }
+      if (task.task_ref === "trust.handoff.emit") {
+        base.handoff_kind = "trust";
+        base.handoff_action = "emit";
+        base.handoff_ref = `trust_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "trust.handoff.validate") {
+        base.handoff_kind = "trust";
+        base.handoff_action = "validate";
+        base.handoff_ref = `trust_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "execution_receipt.handoff.emit") {
+        base.handoff_kind = "execution_receipt";
+        base.handoff_action = "emit";
+        base.handoff_ref = `execution_receipt_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "execution_receipt.handoff.validate") {
+        base.handoff_kind = "execution_receipt";
+        base.handoff_action = "validate";
+        base.handoff_ref = `execution_receipt_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "receipt_ledger.handoff.emit") {
+        base.handoff_kind = "receipt_ledger";
+        base.handoff_action = "emit";
+        base.handoff_ref = `receipt_ledger_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "receipt_ledger.handoff.validate") {
+        base.handoff_kind = "receipt_ledger";
+        base.handoff_action = "validate";
+        base.handoff_ref = `receipt_ledger_handoff_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "runtime.emit") {
+        base.runtime_ref = `runtime_event_${transactionId}_${index + 1}`;
+        base.runtime_action = "emit";
+      }
+      if (task.task_ref === "runtime.anchor") {
+        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
+        base.runtime_action = "anchor";
+      }
+      if (task.task_ref === "runtime.emit_anchor") {
+        base.runtime_ref = `runtime_event_${transactionId}_${index + 1}`;
+        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
+        base.runtime_action = "emit_anchor";
+      }
+      if (task.task_ref === "identity.attest.preview") {
+        base.preview_kind = "identity_attestation";
+        base.identity_attestation_ref = `identity_attestation_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "identity.registry.link") {
+        base.identity_link_ref = `identity_link_${transactionId}_${index + 1}`;
+        base.registry_record_ref = `registry_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "registry.register") {
+        base.registry_record_ref = `registry_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "registry.pack.bundle") {
+        base.registry_pack_ref = `registry_pack_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "anchoring.submit") {
+        base.anchor_ref = `anchor_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "anchoring.pack.preview") {
+        base.preview_kind = "anchoring_pack";
+        base.anchor_preview_ref = `anchor_preview_${transactionId}_${index + 1}`;
+      }
+      if (task.task_ref === "adapter.mcp.invoke") {
+        base.adapter_lane = "mcp";
+        base.tool_name = normalizedBody.tool_name || null;
+        base.invocation_status = externalExecution ? "provider_completed" : "simulated";
+      }
+      if (externalExecution) {
+        base.execution_provider = externalExecution.provider || null;
+        base.execution_target_id = externalExecution.target_id || null;
+        if (externalResponse && externalResponse.provider_job_id) base.provider_job_id = externalResponse.provider_job_id;
+        if (externalResponse && externalResponse.output_payload) base.output_payload = externalResponse.output_payload;
+        if (externalResponse && externalResponse.output_ref) base.output_ref = externalResponse.output_ref;
+        base.provider_status = externalResponse && externalResponse.provider_status
+          ? externalResponse.provider_status
+          : "completed";
+      }
+      return base;
+    })()
+  ]));
+  const capabilityScopes = Array.from(new Set(resultTasks.flatMap((task) =>
+    Array.isArray(task.catalogTask && task.catalogTask.capabilities) ? task.catalogTask.capabilities : []
+  )));
+  const adaptersUsed = Array.from(new Set(resultTasks.flatMap((task) =>
+    Array.isArray(task.catalogTask && task.catalogTask.adapters) ? task.catalogTask.adapters : []
+  )));
+  const remediation = {
+    status: "none",
+    reason_code: null,
+    active_case_type: null,
+    active_case_id: null,
+    compensating_action_status: null,
+    updated_at_iso: completedAt.toISOString()
+  };
+  const payment = {
+    payment_id: `pay_${quote.quote_id}`,
+    scheme: quote.payment_scheme || "native",
+    protocol: quote.payment_protocol || null,
+    status: deferredCompletion ? "authorized" : "recorded",
+    amount_minor: quote.amount_minor,
+    currency: quote.currency,
+    quote_id: quote.quote_id,
+    wallet_id: opts.paymentVerification && opts.paymentVerification.wallet_id
+      ? opts.paymentVerification.wallet_id
+      : null,
+    verification_mode: opts.paymentVerification && opts.paymentVerification.verification_mode
+      ? opts.paymentVerification.verification_mode
+      : null,
+    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
+  };
+  const bsvHints = buildBsvTeranodeSettlementHints({
+    settlementMode: quote.settlement_mode,
+    amountMinor: quote.amount_minor,
+    currency: quote.currency,
+    settlementBindingHash: quote.settlement_binding_hash,
+    treasuryDestination: quote.treasury
+  });
+  const bsvPaymentReference = extractBsvTeranodePaymentReference(
+    opts.paymentVerification && opts.paymentVerification.payment_payload
+      ? opts.paymentVerification.payment_payload
+      : null
+  );
+  const settlement = {
+    settlement_id: `settlement_${transactionId}`,
+    mode: quote.settlement_mode || null,
+    preference: quote.settlement_preference || null,
+    adapter: quote.settlement_adapter || null,
+    integration_id: quote.settlement_integration_id || null,
+    binding_hash: quote.settlement_binding_hash || null,
+    rail: isBsvTeranodeSettlementMode(quote.settlement_mode) ? "bsv_teranode" : null,
+    network: bsvHints ? bsvHints.network : null,
+    hints: bsvHints,
+    txid: bsvPaymentReference && bsvPaymentReference.txid ? bsvPaymentReference.txid : null,
+    raw_tx: bsvPaymentReference && (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
+      ? (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
+      : null,
+    status: deferredCompletion ? "pending_completion" : "recorded",
+    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
+  };
+  const treasuryDestination = buildTreasuryDestination(quote.account_id, quote.settlement_mode);
+  const treasury = {
+    ...treasuryDestination,
+    treasury_receipt_id: `treasury_${receiptId}`,
+    status: deferredCompletion ? "pending_settlement" : "recorded",
+    amount_minor: quote.amount_minor,
+    currency: quote.currency,
+    payment_id: payment.payment_id,
+    settlement_id: settlement.settlement_id,
+    custody_external_ref: treasuryDestination.external_ref || null,
+    rail: treasuryDestination.rail || settlement.rail || null,
+    recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
+  };
+  const defaultPath = quote.default_path || buildDefaultEconomicPath(
+    Array.isArray(quote.integration_ids)
+      ? quote.integration_ids.find((integrationId) => typeof integrationId === "string" && integrationId.startsWith("builtin.payment."))
+      : null,
+    quote.settlement_integration_id || null,
+    treasury,
+    {
+      paymentProtocol: quote.payment_protocol || null,
+      settlementMode: quote.settlement_mode || null,
+      status: deferredCompletion ? "pending_completion" : "recorded"
+    }
+  );
+  const transaction = {
+    transaction_id: transactionId,
+    account_id: quote.account_id,
+    status: deferredCompletion ? "accepted" : "completed",
+    intent: payload.command || "command.execute",
+    amount_minor: quote.amount_minor,
+    currency: quote.currency,
+    quote_id: quote.quote_id,
+    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
+    protocols: Array.isArray(quote.protocols) ? quote.protocols : [],
+    output_ref: externalResponse && externalResponse.output_ref ? externalResponse.output_ref : `output_${transactionId}`,
+    callback_url: payload.callback_url || null,
+    capabilities: quote.capabilities,
+    adapters: quote.adapters,
+    payment,
+    settlement,
+    treasury,
+    default_path: {
+      ...defaultPath,
+      status: deferredCompletion ? "pending_completion" : "recorded"
+    },
+    execution: {
+      status: deferredCompletion ? "accepted" : "completed",
+      task_count: resultTasks.length,
+      capability_scopes: capabilityScopes,
+      adapters_used: adaptersUsed,
+      integration_ids: Array.isArray(quote.execution_integration_ids) ? quote.execution_integration_ids : [],
+      results_by_task_id: resultsByTaskId,
+      provider: externalExecution ? externalExecution.provider || null : null,
+      provider_target_id: externalExecution ? externalExecution.target_id || null : null,
+      provider_job_id: externalResponse && externalResponse.provider_job_id ? externalResponse.provider_job_id : null
+    },
+    created_at_iso: startedAt.toISOString(),
+    completed_at_iso: deferredCompletion ? null : completedAt.toISOString(),
+    timing,
+    remediation
+  };
+  const receipt = {
+    receipt_id: receiptId,
+    transaction_id: transactionId,
+    account_id: quote.account_id,
+    status: deferredCompletion ? "pending" : "completed",
+    amount_minor: quote.amount_minor,
+    currency: quote.currency,
+    quote_id: quote.quote_id,
+    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
+    settlement_integration_id: quote.settlement_integration_id || null,
+    payment,
+    settlement,
+    treasury,
+    default_path: {
+      ...defaultPath,
+      status: deferredCompletion ? "pending_completion" : "recorded"
+    },
+    proof_ref: externalResponse && externalResponse.proof_ref ? externalResponse.proof_ref : `proof_${receiptId}`,
+    execution_summary: {
+      command: payload.command || "command.execute",
+      task_count: resultTasks.length,
+      tasks: resultTasks.map((task) => ({
+        task_id: task.task_id,
+        task_ref: task.task_ref
+      }))
+    },
+    created_at_iso: deferredCompletion ? startedAt.toISOString() : completedAt.toISOString(),
+    timing,
+    remediation
+  };
+  const command = {
+    command: payload.command || "command.execute",
+    integration_ids: Array.isArray(quote.integration_ids) ? quote.integration_ids : [],
+    payment,
+    settlement,
+    treasury,
+    default_path: {
+      ...defaultPath,
+      status: deferredCompletion ? "pending_completion" : "recorded"
+    },
+    deliverables: resultTasks.map((task, index) => ({
+      kind: task.task_ref === "admission.preview" ? "preview" : "result",
+      ...(task.task_ref === "a2c.pack.preview"
+        ? {
+            kind: "preview"
+          }
+        : {}),
+      task_id: task.task_id,
+      task_ref: task.task_ref,
+      ref: `deliverable_${transactionId}_${index + 1}`,
+      ...(task.task_ref === "admission.preview"
+        ? {
+            admission_ref: `admission_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "identity.attest.preview"
+        ? {
+            kind: "preview",
+            identity_attestation_ref: `identity_attestation_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "identity.registry.link"
+        ? {
+            identity_link_ref: `identity_link_${transactionId}_${index + 1}`,
+            registry_record_ref: `registry_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "a2a.negotiate"
+        ? {
+            negotiation_ref: `a2a_negotiation_${transactionId}_${index + 1}`,
+            interaction_front: "a2a"
+          }
+        : {}),
+      ...(task.task_ref === "a2a.commit"
+        ? {
+            negotiation_ref: `a2a_negotiation_${transactionId}_${index + 1}`,
+            commitment_ref: `a2a_commitment_${transactionId}_${index + 1}`,
+            interaction_front: "a2a"
+          }
+        : {}),
+      ...(task.task_ref === "a2c.session.open"
+        ? {
+            session_ref: `a2c_session_${transactionId}_${index + 1}`,
+            interaction_front: "a2c"
+          }
+        : {}),
+      ...(task.task_ref === "a2c.pack.preview"
+        ? {
+            pack_preview_ref: `a2c_pack_preview_${transactionId}_${index + 1}`,
+            interaction_front: "a2c"
+          }
+        : {}),
+      ...(task.task_ref === "trust.handoff.emit"
+        ? {
+            handoff_kind: "trust",
+            handoff_action: "emit",
+            handoff_ref: `trust_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "trust.handoff.validate"
+        ? {
+            handoff_kind: "trust",
+            handoff_action: "validate",
+            handoff_ref: `trust_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "execution_receipt.handoff.emit"
+        ? {
+            handoff_kind: "execution_receipt",
+            handoff_action: "emit",
+            handoff_ref: `execution_receipt_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "execution_receipt.handoff.validate"
+        ? {
+            handoff_kind: "execution_receipt",
+            handoff_action: "validate",
+            handoff_ref: `execution_receipt_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "receipt_ledger.handoff.emit"
+        ? {
+            handoff_kind: "receipt_ledger",
+            handoff_action: "emit",
+            handoff_ref: `receipt_ledger_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "receipt_ledger.handoff.validate"
+        ? {
+            handoff_kind: "receipt_ledger",
+            handoff_action: "validate",
+            handoff_ref: `receipt_ledger_handoff_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "runtime.emit"
+        ? {
+            runtime_ref: `runtime_event_${transactionId}_${index + 1}`,
+            runtime_action: "emit"
+          }
+        : {}),
+      ...(task.task_ref === "runtime.anchor"
+        ? {
+            anchor_ref: `anchor_${transactionId}_${index + 1}`,
+            runtime_action: "anchor"
+          }
+        : {}),
+      ...(task.task_ref === "runtime.emit_anchor"
+        ? {
+            runtime_ref: `runtime_event_${transactionId}_${index + 1}`,
+            anchor_ref: `anchor_${transactionId}_${index + 1}`,
+            runtime_action: "emit_anchor"
+          }
+        : {}),
+      ...(task.task_ref === "registry.register"
+        ? {
+            registry_record_ref: `registry_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "registry.pack.bundle"
+        ? {
+            registry_pack_ref: `registry_pack_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "anchoring.submit"
+        ? {
+            anchor_ref: `anchor_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "anchoring.pack.preview"
+        ? {
+            kind: "preview",
+            anchor_preview_ref: `anchor_preview_${transactionId}_${index + 1}`
+          }
+        : {}),
+      ...(task.task_ref === "adapter.mcp.invoke"
+        ? {
+            adapter_lane: "mcp",
+            tool_name: normalizedBody.tool_name || null
+          }
+        : {})
+    })),
+    monitor: {
+      transaction_id: transactionId,
+      status_url: `/v1/governed-transactions/${transactionId}`,
+      receipt_url: `/v1/receipts/${receiptId}`,
+      delivery_url: `/v1/deliveries/delivery_${transactionId}`,
+      payment_url: `/v1/payment-ledger/${payment.payment_id}`
+    }
+  };
+  return { transaction, receipt, command };
+}
+
+module.exports = {
+  createCommandArtifacts
+};