xytara 3.1.0 → 3.1.2

package/lib/commerce_shell.js

@@ -1,257 +1,257 @@
-"use strict";
-
-const crypto = require("crypto");
-
-function normalizeString(value) {
-  return String(value == null ? "" : value).trim();
-}
-
-function shellHash(seed) {
-  return crypto.createHash("sha256").update(seed).digest("hex");
-}
-
-function buildShellRef(prefix, seed) {
-  return `${prefix}.${shellHash(JSON.stringify(seed)).slice(0, 16)}`;
-}
-
-function buildAgentAccountPublicView(payload, includeOnboarding = false) {
-  const item = payload && typeof payload === "object" ? payload : {};
-  const view = {
-    ok: item.ok === true,
-    account: item.account && typeof item.account === "object" ? item.account : null
-  };
-  if (includeOnboarding) {
-    view.onboarding = item.onboarding && typeof item.onboarding === "object" ? item.onboarding : null;
-  }
-  return view;
-}
-
-function createAgentAccount(state, body) {
-  const input = body && typeof body === "object" && !Array.isArray(body) ? body : {};
-  const requestedLabel = normalizeString(input.label || input.name || input.account_label || "");
-  const settlementMode = normalizeString(input.settlement_mode || "ethereum_evm");
-  const protocol = normalizeString(input.protocol || "mcp");
-  const adapterProfile = normalizeString(input.adapter_profile || "default");
-  const seed = shellHash(JSON.stringify({
-    requestedLabel,
-    settlementMode,
-    protocol,
-    adapterProfile,
-    createdAt: new Date().toISOString()
-  }));
-  const accountId = `acct_${seed.slice(0, 12)}`;
-  const walletId = `wallet_${seed.slice(12, 24)}`;
-  const apiKey = `xytara_live_${seed.slice(24, 48)}`;
-  const walletSecret = `xytara_wallet_${seed.slice(0, 32)}`;
-  const account = {
-    account_id: accountId,
-    wallet_id: walletId,
-    label: requestedLabel || accountId,
-    settlement_mode: settlementMode,
-    protocol,
-    adapter_profile: adapterProfile,
-    status: "active",
-    created_at_iso: new Date().toISOString()
-  };
-  const payload = {
-    ok: true,
-    account,
-    onboarding: {
-      api_key: apiKey,
-      wallet_secret: walletSecret,
-      default_headers: {
-        authorization: `Bearer ${apiKey}`,
-        "x-xytara-wallet-id": walletId
-      },
-      default_context: {
-        account_id: accountId,
-        settlement_mode: settlementMode,
-        protocol
-      },
-      next_surfaces: {
-        transaction_center: "/v1/transaction-center",
-        operations_dashboard: `/v1/operations/dashboard?account_id=${encodeURIComponent(accountId)}`,
-        operator_shell_summary: "/v1/operator-shell/summary"
-      }
-    }
-  };
-  state.agentAccounts.set(accountId, payload);
-  return payload;
-}
-
-function listAgentAccounts(state) {
-  const accounts = Array.from(state.agentAccounts.values()).map((entry) => entry.account);
-  return {
-    ok: true,
-    count: accounts.length,
-    accounts
-  };
-}
-
-function getAgentAccount(state, accountId) {
-  const payload = state.agentAccounts.get(accountId) || null;
-  return payload ? buildAgentAccountPublicView(payload, false) : null;
-}
-
-function buildOperatorShellCenter() {
-  return {
-    center_ref: "operator-shell.center",
-    account_issue_surface: "/v1/agent-accounts",
-    summary_surface: "/v1/operator-shell/summary",
-    workflow_pack_surface: "/v1/operator-shell/workflow-pack",
-    admin_pack_surface: "/v1/operator-shell/admin-pack",
-    supported_capabilities: [
-      "agent_account_onboarding",
-      "operator_shell_summary",
-      "workflow_packaging",
-      "admin_packaging",
-      "cross_layer_visibility",
-      "hosted_checkout_review_visibility"
-    ]
-  };
-}
-
-function summarizeOperatorShellCenter() {
-  const center = buildOperatorShellCenter();
-  return {
-    center_ref: center.center_ref,
-    capability_count: center.supported_capabilities.length,
-    account_issue_surface: center.account_issue_surface,
-    workflow_pack_surface: center.workflow_pack_surface
-  };
-}
-
-function buildOperatorShellSummary(input) {
-  const body = input && typeof input === "object" && !Array.isArray(input) ? input : {};
-  const accountId = normalizeString(body.account_id || "acct_demo");
-  const operationsDashboard = body.operations_dashboard || {};
-  const operatorExportPack = body.operator_export_pack || {};
-  const economicsOperatorView = body.economics_operator_view || {};
-  const economicsOperatorDashboard = body.economics_operator_dashboard || {};
-  const coordinationOperatorView = body.coordination_operator_view || {};
-  const coordinationAdminView = body.coordination_admin_view || {};
-  const hostedCheckoutOperatorSummary = body.hosted_checkout_operator_summary || {};
-  const entitlementReplenishmentSummary = body.entitlement_replenishment_summary || {};
-  const runtimeDurability = body.runtime_durability || {};
-  const nativeSettlementReadiness = body.native_settlement_readiness || {};
-
-  return {
-    ok: true,
-    shell_summary_ref: buildShellRef("operator-shell.summary", {
-      account_id: accountId,
-      attention_count: operationsDashboard.attention_count || 0,
-      export_version: operatorExportPack.export_version || null
-    }),
-    account_id: accountId,
-    shell_surfaces: {
-      operations_dashboard: "/v1/operations/dashboard",
-      operator_export_pack: "/v1/operator-export-pack",
-      economics_operator_view: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-view`,
-      economics_operator_dashboard: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`,
-      coordination_operator_view: "/v1/coordination-center/operator-view",
-      coordination_admin_view: "/v1/coordination-center/admin-view",
-      hosted_checkout_purchase_intents: `/v1/checkout/purchase-intents?account_id=${encodeURIComponent(accountId)}`,
-      hosted_checkout_runtime_bridge_dispatches: `/v1/runtime-bridge/dispatches?account_id=${encodeURIComponent(accountId)}`,
-      runtime_durability: "/v1/runtime/durability",
-      native_settlement_readiness: "/v1/settlement/bsv-teranode/readiness",
-      proof_governance_dashboard: "/v1/proof-center/governance/dashboard",
-      proof_bridge_admin_pack: "/v1/proof-center/bridge/admin-pack"
-    },
-    shell_state: {
-      attention_count: Number(operationsDashboard.attention_count || 0),
-      open_issue_count: Number(operationsDashboard.open_issue_count || 0),
-      export_generated_at_iso: operatorExportPack.generated_at_iso || null,
-      economics_receipt_count: Number(
-        economicsOperatorDashboard.receipt_summary && economicsOperatorDashboard.receipt_summary.receipt_count || 0
-      ),
-      coordination_zone_count: Number(coordinationAdminView.zone_count || coordinationOperatorView.zone_count || 0),
-      hosted_checkout_purchase_intent_count: Number(hostedCheckoutOperatorSummary.purchase_intent_count || 0),
-      hosted_checkout_refund_review_required_count: Number(hostedCheckoutOperatorSummary.refund_review_required_count || 0),
-      hosted_checkout_execution_dispatched_count: Number(hostedCheckoutOperatorSummary.execution_dispatched_count || 0),
-      hosted_checkout_auto_compensated_count: Number(hostedCheckoutOperatorSummary.auto_compensated_count || 0),
-      hosted_checkout_compensation_review_required_count: Number(hostedCheckoutOperatorSummary.compensation_review_required_count || 0),
-      hosted_checkout_compensation_failed_count: Number(hostedCheckoutOperatorSummary.compensation_failed_count || 0),
-      low_balance_entitlement_count: Number(entitlementReplenishmentSummary.low_balance_count || 0),
-      depleted_entitlement_count: Number(entitlementReplenishmentSummary.depleted_count || 0),
-      runtime_snapshot_enabled: runtimeDurability.enabled === true,
-      runtime_snapshot_exists: runtimeDurability.snapshot_exists === true,
-      runtime_recovery_posture: runtimeDurability.recovery_posture || null,
-      native_settlement_runtime_mode: runtimeDurability.enabled === true || nativeSettlementReadiness.runtime_mode
-        ? nativeSettlementReadiness.runtime_mode || null
-        : null,
-      native_settlement_ready: nativeSettlementReadiness.ready === true,
-      native_settlement_blocker_count: Array.isArray(nativeSettlementReadiness.blockers)
-        ? nativeSettlementReadiness.blockers.length
-        : 0
-    },
-    linked_refs: {
-      operations_dashboard_ref: buildShellRef("operator-shell.operations-dashboard", {
-        account_id: accountId,
-        attention_count: operationsDashboard.attention_count || 0,
-        attention_signal_count: operationsDashboard.attention_signal_count || 0
-      }),
-      economics_operator_view_ref: economicsOperatorView.operator_view_ref || null,
-      economics_operator_dashboard_ref: economicsOperatorDashboard.operator_dashboard_ref || null,
-      coordination_operator_view_ref: coordinationOperatorView.operator_view_ref || null,
-      coordination_admin_view_ref: coordinationAdminView.admin_view_ref || null,
-      hosted_checkout_operator_summary_ref: hostedCheckoutOperatorSummary.operator_summary_ref || null
-      ,
-      entitlement_replenishment_summary_ref: entitlementReplenishmentSummary.entitlement_count != null
-        ? `/v1/economics/accounts/${encodeURIComponent(accountId)}/entitlements/replenishment-summary`
-        : null,
-      runtime_durability_ref: runtimeDurability.inspect_ref || "/v1/runtime/durability",
-      native_settlement_readiness_ref: nativeSettlementReadiness.readiness_ref || "/v1/settlement/bsv-teranode/readiness"
-    }
-  };
-}
-
-function buildOperatorShellWorkflowPack(summary) {
-  const shellSummary = buildOperatorShellSummary(summary);
-  return {
-    ok: true,
-    workflow_pack_ref: buildShellRef("operator-shell.workflow-pack", shellSummary),
-    shell_summary_ref: shellSummary.shell_summary_ref,
-    account_id: shellSummary.account_id,
-    workflow_steps: [
-      "issue_or_select_agent_account",
-      "start_or_review_governed_transaction",
-      "review_hosted_checkout_purchase_and_refund_queue",
-      "inspect_economics_and_coordination",
-      "export_operator_pack",
-      "handoff_to_proof_review_when_needed"
-    ],
-    linked_surfaces: shellSummary.shell_surfaces
-  };
-}
-
-function buildOperatorShellAdminPack(summary) {
-  const shellSummary = buildOperatorShellSummary(summary);
-  const workflowPack = buildOperatorShellWorkflowPack(summary);
-  return {
-    ok: true,
-    admin_pack_ref: buildShellRef("operator-shell.admin-pack", {
-      shell_summary_ref: shellSummary.shell_summary_ref,
-      workflow_pack_ref: workflowPack.workflow_pack_ref
-    }),
-    shell_summary_ref: shellSummary.shell_summary_ref,
-    workflow_pack_ref: workflowPack.workflow_pack_ref,
-    operator_refs: shellSummary.linked_refs,
-    export_surface: "/v1/operator-export-pack",
-    guidance: [
-      "operator_shell_is_a_public_control_surface_inside_xytara",
-      "operator_shell_does_not_create_a_separate_product_identity"
-    ]
-  };
-}
-
-module.exports = {
-  buildAgentAccountPublicView,
-  createAgentAccount,
-  listAgentAccounts,
-  getAgentAccount,
-  buildOperatorShellCenter,
-  summarizeOperatorShellCenter,
-  buildOperatorShellSummary,
-  buildOperatorShellWorkflowPack,
-  buildOperatorShellAdminPack
-};
+"use strict";
+
+const crypto = require("crypto");
+
+function normalizeString(value) {
+  return String(value == null ? "" : value).trim();
+}
+
+function shellHash(seed) {
+  return crypto.createHash("sha256").update(seed).digest("hex");
+}
+
+function buildShellRef(prefix, seed) {
+  return `${prefix}.${shellHash(JSON.stringify(seed)).slice(0, 16)}`;
+}
+
+function buildAgentAccountPublicView(payload, includeOnboarding = false) {
+  const item = payload && typeof payload === "object" ? payload : {};
+  const view = {
+    ok: item.ok === true,
+    account: item.account && typeof item.account === "object" ? item.account : null
+  };
+  if (includeOnboarding) {
+    view.onboarding = item.onboarding && typeof item.onboarding === "object" ? item.onboarding : null;
+  }
+  return view;
+}
+
+function createAgentAccount(state, body) {
+  const input = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+  const requestedLabel = normalizeString(input.label || input.name || input.account_label || "");
+  const settlementMode = normalizeString(input.settlement_mode || "ethereum_evm");
+  const protocol = normalizeString(input.protocol || "mcp");
+  const adapterProfile = normalizeString(input.adapter_profile || "default");
+  const seed = shellHash(JSON.stringify({
+    requestedLabel,
+    settlementMode,
+    protocol,
+    adapterProfile,
+    createdAt: new Date().toISOString()
+  }));
+  const accountId = `acct_${seed.slice(0, 12)}`;
+  const walletId = `wallet_${seed.slice(12, 24)}`;
+  const apiKey = `xytara_live_${seed.slice(24, 48)}`;
+  const walletSecret = `xytara_wallet_${seed.slice(0, 32)}`;
+  const account = {
+    account_id: accountId,
+    wallet_id: walletId,
+    label: requestedLabel || accountId,
+    settlement_mode: settlementMode,
+    protocol,
+    adapter_profile: adapterProfile,
+    status: "active",
+    created_at_iso: new Date().toISOString()
+  };
+  const payload = {
+    ok: true,
+    account,
+    onboarding: {
+      api_key: apiKey,
+      wallet_secret: walletSecret,
+      default_headers: {
+        authorization: `Bearer ${apiKey}`,
+        "x-xytara-wallet-id": walletId
+      },
+      default_context: {
+        account_id: accountId,
+        settlement_mode: settlementMode,
+        protocol
+      },
+      next_surfaces: {
+        transaction_center: "/v1/transaction-center",
+        operations_dashboard: `/v1/operations/dashboard?account_id=${encodeURIComponent(accountId)}`,
+        operator_shell_summary: "/v1/operator-shell/summary"
+      }
+    }
+  };
+  state.agentAccounts.set(accountId, payload);
+  return payload;
+}
+
+function listAgentAccounts(state) {
+  const accounts = Array.from(state.agentAccounts.values()).map((entry) => entry.account);
+  return {
+    ok: true,
+    count: accounts.length,
+    accounts
+  };
+}
+
+function getAgentAccount(state, accountId) {
+  const payload = state.agentAccounts.get(accountId) || null;
+  return payload ? buildAgentAccountPublicView(payload, false) : null;
+}
+
+function buildOperatorShellCenter() {
+  return {
+    center_ref: "operator-shell.center",
+    account_issue_surface: "/v1/agent-accounts",
+    summary_surface: "/v1/operator-shell/summary",
+    workflow_pack_surface: "/v1/operator-shell/workflow-pack",
+    admin_pack_surface: "/v1/operator-shell/admin-pack",
+    supported_capabilities: [
+      "agent_account_onboarding",
+      "operator_shell_summary",
+      "workflow_packaging",
+      "admin_packaging",
+      "cross_layer_visibility",
+      "hosted_checkout_review_visibility"
+    ]
+  };
+}
+
+function summarizeOperatorShellCenter() {
+  const center = buildOperatorShellCenter();
+  return {
+    center_ref: center.center_ref,
+    capability_count: center.supported_capabilities.length,
+    account_issue_surface: center.account_issue_surface,
+    workflow_pack_surface: center.workflow_pack_surface
+  };
+}
+
+function buildOperatorShellSummary(input) {
+  const body = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+  const accountId = normalizeString(body.account_id || "acct_demo");
+  const operationsDashboard = body.operations_dashboard || {};
+  const operatorExportPack = body.operator_export_pack || {};
+  const economicsOperatorView = body.economics_operator_view || {};
+  const economicsOperatorDashboard = body.economics_operator_dashboard || {};
+  const coordinationOperatorView = body.coordination_operator_view || {};
+  const coordinationAdminView = body.coordination_admin_view || {};
+  const hostedCheckoutOperatorSummary = body.hosted_checkout_operator_summary || {};
+  const entitlementReplenishmentSummary = body.entitlement_replenishment_summary || {};
+  const runtimeDurability = body.runtime_durability || {};
+  const nativeSettlementReadiness = body.native_settlement_readiness || {};
+
+  return {
+    ok: true,
+    shell_summary_ref: buildShellRef("operator-shell.summary", {
+      account_id: accountId,
+      attention_count: operationsDashboard.attention_count || 0,
+      export_version: operatorExportPack.export_version || null
+    }),
+    account_id: accountId,
+    shell_surfaces: {
+      operations_dashboard: "/v1/operations/dashboard",
+      operator_export_pack: "/v1/operator-export-pack",
+      economics_operator_view: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-view`,
+      economics_operator_dashboard: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`,
+      coordination_operator_view: "/v1/coordination-center/operator-view",
+      coordination_admin_view: "/v1/coordination-center/admin-view",
+      hosted_checkout_purchase_intents: `/v1/checkout/purchase-intents?account_id=${encodeURIComponent(accountId)}`,
+      hosted_checkout_runtime_bridge_dispatches: `/v1/runtime-bridge/dispatches?account_id=${encodeURIComponent(accountId)}`,
+      runtime_durability: "/v1/runtime/durability",
+      native_settlement_readiness: "/v1/settlement/bsv-teranode/readiness",
+      proof_governance_dashboard: "/v1/proof-center/governance/dashboard",
+      proof_bridge_admin_pack: "/v1/proof-center/bridge/admin-pack"
+    },
+    shell_state: {
+      attention_count: Number(operationsDashboard.attention_count || 0),
+      open_issue_count: Number(operationsDashboard.open_issue_count || 0),
+      export_generated_at_iso: operatorExportPack.generated_at_iso || null,
+      economics_receipt_count: Number(
+        economicsOperatorDashboard.receipt_summary && economicsOperatorDashboard.receipt_summary.receipt_count || 0
+      ),
+      coordination_zone_count: Number(coordinationAdminView.zone_count || coordinationOperatorView.zone_count || 0),
+      hosted_checkout_purchase_intent_count: Number(hostedCheckoutOperatorSummary.purchase_intent_count || 0),
+      hosted_checkout_refund_review_required_count: Number(hostedCheckoutOperatorSummary.refund_review_required_count || 0),
+      hosted_checkout_execution_dispatched_count: Number(hostedCheckoutOperatorSummary.execution_dispatched_count || 0),
+      hosted_checkout_auto_compensated_count: Number(hostedCheckoutOperatorSummary.auto_compensated_count || 0),
+      hosted_checkout_compensation_review_required_count: Number(hostedCheckoutOperatorSummary.compensation_review_required_count || 0),
+      hosted_checkout_compensation_failed_count: Number(hostedCheckoutOperatorSummary.compensation_failed_count || 0),
+      low_balance_entitlement_count: Number(entitlementReplenishmentSummary.low_balance_count || 0),
+      depleted_entitlement_count: Number(entitlementReplenishmentSummary.depleted_count || 0),
+      runtime_snapshot_enabled: runtimeDurability.enabled === true,
+      runtime_snapshot_exists: runtimeDurability.snapshot_exists === true,
+      runtime_recovery_posture: runtimeDurability.recovery_posture || null,
+      native_settlement_runtime_mode: runtimeDurability.enabled === true || nativeSettlementReadiness.runtime_mode
+        ? nativeSettlementReadiness.runtime_mode || null
+        : null,
+      native_settlement_ready: nativeSettlementReadiness.ready === true,
+      native_settlement_blocker_count: Array.isArray(nativeSettlementReadiness.blockers)
+        ? nativeSettlementReadiness.blockers.length
+        : 0
+    },
+    linked_refs: {
+      operations_dashboard_ref: buildShellRef("operator-shell.operations-dashboard", {
+        account_id: accountId,
+        attention_count: operationsDashboard.attention_count || 0,
+        attention_signal_count: operationsDashboard.attention_signal_count || 0
+      }),
+      economics_operator_view_ref: economicsOperatorView.operator_view_ref || null,
+      economics_operator_dashboard_ref: economicsOperatorDashboard.operator_dashboard_ref || null,
+      coordination_operator_view_ref: coordinationOperatorView.operator_view_ref || null,
+      coordination_admin_view_ref: coordinationAdminView.admin_view_ref || null,
+      hosted_checkout_operator_summary_ref: hostedCheckoutOperatorSummary.operator_summary_ref || null
+      ,
+      entitlement_replenishment_summary_ref: entitlementReplenishmentSummary.entitlement_count != null
+        ? `/v1/economics/accounts/${encodeURIComponent(accountId)}/entitlements/replenishment-summary`
+        : null,
+      runtime_durability_ref: runtimeDurability.inspect_ref || "/v1/runtime/durability",
+      native_settlement_readiness_ref: nativeSettlementReadiness.readiness_ref || "/v1/settlement/bsv-teranode/readiness"
+    }
+  };
+}
+
+function buildOperatorShellWorkflowPack(summary) {
+  const shellSummary = buildOperatorShellSummary(summary);
+  return {
+    ok: true,
+    workflow_pack_ref: buildShellRef("operator-shell.workflow-pack", shellSummary),
+    shell_summary_ref: shellSummary.shell_summary_ref,
+    account_id: shellSummary.account_id,
+    workflow_steps: [
+      "issue_or_select_agent_account",
+      "start_or_review_governed_transaction",
+      "review_hosted_checkout_purchase_and_refund_queue",
+      "inspect_economics_and_coordination",
+      "export_operator_pack",
+      "handoff_to_proof_review_when_needed"
+    ],
+    linked_surfaces: shellSummary.shell_surfaces
+  };
+}
+
+function buildOperatorShellAdminPack(summary) {
+  const shellSummary = buildOperatorShellSummary(summary);
+  const workflowPack = buildOperatorShellWorkflowPack(summary);
+  return {
+    ok: true,
+    admin_pack_ref: buildShellRef("operator-shell.admin-pack", {
+      shell_summary_ref: shellSummary.shell_summary_ref,
+      workflow_pack_ref: workflowPack.workflow_pack_ref
+    }),
+    shell_summary_ref: shellSummary.shell_summary_ref,
+    workflow_pack_ref: workflowPack.workflow_pack_ref,
+    operator_refs: shellSummary.linked_refs,
+    export_surface: "/v1/operator-export-pack",
+    guidance: [
+      "operator_shell_is_a_public_control_surface_inside_xytara",
+      "operator_shell_does_not_create_a_separate_product_identity"
+    ]
+  };
+}
+
+module.exports = {
+  buildAgentAccountPublicView,
+  createAgentAccount,
+  listAgentAccounts,
+  getAgentAccount,
+  buildOperatorShellCenter,
+  summarizeOperatorShellCenter,
+  buildOperatorShellSummary,
+  buildOperatorShellWorkflowPack,
+  buildOperatorShellAdminPack
+};