@elizaos/plugin-steward-app 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/api/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/wallet.ts"],"sourcesContent":["/**\n * Wallet key generation, address derivation, and balance/NFT fetching.\n * Uses Node crypto primitives + ethers (keccak-256 / checksum).\n * Balance data from Alchemy/Ankr (EVM), NodeReal/QuickNode (BSC RPC),\n * and Helius (Solana) REST APIs.\n *\n * DEX price oracle logic lives in ./wallet-dex-prices.ts\n * EVM balance + NFT fetching lives in ./wallet-evm-balance.ts\n */\nimport crypto from \"node:crypto\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n  KeyValidationResult,\n  SolanaTokenBalance,\n  WalletAddresses,\n  WalletChain,\n  WalletGenerateResult,\n  WalletImportResult,\n  WalletKeys,\n} from \"@elizaos/core\";\nimport { logger, resolveStateDir } from \"@elizaos/core\";\nimport { secp256k1 } from \"@noble/curves/secp256k1.js\";\nimport * as ethers from \"ethers\";\n\ntype StewardAgentWalletPayload = {\n  walletAddress?: string;\n  walletAddresses?: { evm?: string; solana?: string };\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction readStringField(\n  record: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = record[key];\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction readStewardAgentWalletPayload(\n  value: unknown,\n): StewardAgentWalletPayload {\n  const envelope = isRecord(value) ? value : {};\n  const payload = isRecord(envelope.data) ? envelope.data : envelope;\n  const walletAddresses = isRecord(payload.walletAddresses)\n    ? {\n        evm: readStringField(payload.walletAddresses, \"evm\"),\n        solana: readStringField(payload.walletAddresses, \"solana\"),\n      }\n    : undefined;\n  return {\n    walletAddress: readStringField(payload, \"walletAddress\"),\n    walletAddresses,\n  };\n}\n\n// ── Re-exports from contracts/wallet ──────────────────────────────────\n\nexport type {\n  BscTradeExecuteRequest,\n  BscTradeExecuteResponse,\n  BscTradeExecutionResult,\n  BscTradePreflightRequest,\n  BscTradePreflightResponse,\n  BscTradeQuoteRequest,\n  BscTradeQuoteResponse,\n  BscTradeSide,\n  BscTradeTxStatus,\n  BscTradeTxStatusResponse,\n  BscTransferExecuteRequest,\n  BscTransferExecuteResponse,\n  BscTransferExecutionResult,\n  BscUnsignedApprovalTx,\n  BscUnsignedTradeTx,\n  BscUnsignedTransferTx,\n  EvmChainBalance,\n  EvmTokenBalance,\n  KeyValidationResult,\n  SolanaTokenBalance,\n  TradePermissionMode,\n  WalletAddresses,\n  WalletBalancesResponse,\n  WalletChain,\n  WalletConfigStatus,\n  WalletGenerateResult,\n  WalletImportResult,\n  WalletKeys,\n  WalletTradeLedgerEntry,\n  WalletTradeSource,\n  WalletTradingProfileResponse,\n  WalletTradingProfileSourceFilter,\n  WalletTradingProfileWindow,\n} from \"@elizaos/core\";\n\n// ── Re-exports from extracted modules ─────────────────────────────────\n\nexport {\n  computeValueUsd,\n  DEX_PRICE_TIMEOUT_MS,\n  DEXPAPRIKA_CHAIN_MAP,\n  DEXSCREENER_CHAIN_MAP,\n  type DexScreenerPair,\n  type DexTokenMeta,\n  fetchDexPaprikaPrices,\n  fetchDexPrices,\n  fetchDexScreenerPrices,\n  WRAPPED_NATIVE,\n} from \"./wallet-dex-prices.js\";\n\nexport {\n  type AnkrTokenAsset,\n  DEFAULT_EVM_CHAINS,\n  type EvmProviderKeys,\n  fetchEvmBalances,\n  resolveEvmProviderKeys,\n} from \"./wallet-evm-balance.js\";\n\n// ── Constants ─────────────────────────────────────────────────────────\n\nconst FETCH_TIMEOUT_MS = 15_000;\nexport const MANAGED_EVM_ADDRESS_ENV_KEY = \"ELIZA_MANAGED_EVM_ADDRESS\";\nexport const MANAGED_SOLANA_ADDRESS_ENV_KEY = \"ELIZA_MANAGED_SOLANA_ADDRESS\";\n\n/** Module-level cache for steward wallet addresses (avoids process.env mutation). */\nlet stewardAddressCache: { evm: string | null; solana: string | null } | null =\n  null;\n\n// ── EVM key derivation (secp256k1 via @noble/curves + keccak-256) ─────\n\nfunction generateEvmPrivateKey(): string {\n  return `0x${crypto.randomBytes(32).toString(\"hex\")}`;\n}\n\nexport function deriveEvmAddress(privateKeyHex: string): string {\n  const cleaned = privateKeyHex.startsWith(\"0x\")\n    ? privateKeyHex.slice(2)\n    : privateKeyHex;\n  // Use @noble/curves — works in Node, Bun, and browsers.\n  // (Node's crypto.createECDH(\"secp256k1\") fails in Bun due to BoringSSL.)\n  const pubKey = secp256k1.getPublicKey(Buffer.from(cleaned, \"hex\"), false); // uncompressed (65 bytes)\n  const pubNoPrefix = pubKey.subarray(1); // drop the 04 prefix\n  // Ethereum address = last 20 bytes of keccak-256(pubkey).\n  const hash = ethers.keccak256(pubNoPrefix);\n  const raw = hash.slice(26); // drop '0x' + first 24 hex chars (12 bytes)\n  return ethers.getAddress(`0x${raw}`);\n}\n\n// ── Solana key derivation (Ed25519 via Node crypto) ───────────────────\n\nfunction generateSolanaKeypair(): { privateKey: string; publicKey: string } {\n  const { privateKey, publicKey } = crypto.generateKeyPairSync(\"ed25519\");\n  const privBytes = privateKey.export({ type: \"pkcs8\", format: \"der\" });\n  const pubBytes = publicKey.export({ type: \"spki\", format: \"der\" });\n  // Ed25519 PKCS8 DER: raw 32-byte seed at offset 16; SPKI DER: raw 32-byte pubkey at offset 12\n  const seed = (privBytes as Buffer).subarray(16, 48);\n  const pubRaw = (pubBytes as Buffer).subarray(12, 44);\n  // Solana secret key = seed(32) + pubkey(32)\n  return {\n    privateKey: base58Encode(Buffer.concat([seed, pubRaw])),\n    publicKey: base58Encode(pubRaw),\n  };\n}\n\nexport function deriveSolanaAddress(privateKeyString: string): string {\n  const secretBytes = decodeSolanaPrivateKey(privateKeyString);\n  if (secretBytes.length === 64) return base58Encode(secretBytes.subarray(32));\n  if (secretBytes.length === 32) {\n    // Derive pubkey from 32-byte seed\n    const keyObj = crypto.createPrivateKey({\n      key: Buffer.concat([\n        Buffer.from(\"302e020100300506032b657004220420\", \"hex\"),\n        secretBytes,\n      ]),\n      format: \"der\",\n      type: \"pkcs8\",\n    });\n    const pubDer = crypto\n      .createPublicKey(keyObj)\n      .export({ type: \"spki\", format: \"der\" }) as Buffer;\n    return base58Encode(pubDer.subarray(12, 44));\n  }\n  throw new Error(`Invalid Solana secret key length: ${secretBytes.length}`);\n}\n\n// ── Base58 (Bitcoin alphabet) ─────────────────────────────────────────\n\nconst B58 = \"123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz\";\n\nfunction base58Encode(data: Buffer | Uint8Array): string {\n  let num = BigInt(`0x${Buffer.from(data).toString(\"hex\")}`);\n  const chars: string[] = [];\n  while (num > 0n) {\n    chars.unshift(B58[Number(num % 58n)]);\n    num /= 58n;\n  }\n  for (const byte of data) {\n    if (byte === 0) chars.unshift(\"1\");\n    else break;\n  }\n  return chars.join(\"\") || \"1\";\n}\n\nfunction base58Decode(str: string): Buffer {\n  if (str.length === 0) return Buffer.alloc(0);\n  let num = 0n;\n  for (const c of str) {\n    const i = B58.indexOf(c);\n    if (i === -1) throw new Error(`Invalid base58: ${c}`);\n    num = num * 58n + BigInt(i);\n  }\n  const hex = num.toString(16).padStart(2, \"0\");\n  const bytes = Buffer.from(hex.length % 2 ? `0${hex}` : hex, \"hex\");\n  let zeros = 0;\n  for (const c of str) {\n    if (c === \"1\") zeros++;\n    else break;\n  }\n  return zeros > 0 ? Buffer.concat([Buffer.alloc(zeros), bytes]) : bytes;\n}\n\n/** Redacted/sentinel env values to skip without treating them as keys. */\nconst ENV_SENTINEL_RE =\n  /^\\[?\\s*(REDACTED|PLACEHOLDER|T(?:O)D(?:O)|CHANGEME|EMPTY)\\s*]?$/i;\n\nfunction decodeSolanaPrivateKey(key: string): Buffer {\n  if (ENV_SENTINEL_RE.test(key)) {\n    throw new Error(\"sentinel env value\");\n  }\n  // Only attempt JSON array parse when the content looks like a numeric array\n  // e.g. [1,2,3,...] — not [REDACTED] or other bracket-wrapped strings\n  if (key.startsWith(\"[\") && key.endsWith(\"]\") && /^\\[\\s*\\d/.test(key)) {\n    try {\n      const parsed = JSON.parse(key) as unknown;\n      if (\n        !Array.isArray(parsed) ||\n        !parsed.every((v) => typeof v === \"number\")\n      ) {\n        throw new Error(\"not a numeric array\");\n      }\n      return Buffer.from(parsed);\n    } catch {\n      throw new Error(\"Invalid JSON byte-array format\");\n    }\n  }\n  return base58Decode(key);\n}\n\n// ── Key validation ────────────────────────────────────────────────────\n\nconst HEX_RE = /^[0-9a-fA-F]+$/;\n\nexport function validateEvmPrivateKey(key: string): KeyValidationResult {\n  const cleaned = key.startsWith(\"0x\") ? key.slice(2) : key;\n  if (cleaned.length !== 64)\n    return {\n      valid: false,\n      chain: \"evm\",\n      address: null,\n      error: \"Must be 64 hex characters\",\n    };\n  if (!HEX_RE.test(cleaned))\n    return {\n      valid: false,\n      chain: \"evm\",\n      address: null,\n      error: \"Invalid hex characters\",\n    };\n  try {\n    return {\n      valid: true,\n      chain: \"evm\",\n      address: deriveEvmAddress(key),\n      error: null,\n    };\n  } catch (err) {\n    return {\n      valid: false,\n      chain: \"evm\",\n      address: null,\n      error: `Derivation failed: ${String(err)}`,\n    };\n  }\n}\n\nexport function validateSolanaPrivateKey(key: string): KeyValidationResult {\n  try {\n    const bytes = decodeSolanaPrivateKey(key);\n    if (bytes.length !== 64 && bytes.length !== 32) {\n      return {\n        valid: false,\n        chain: \"solana\",\n        address: null,\n        error: `Must be 32 or 64 bytes, got ${bytes.length}`,\n      };\n    }\n    return {\n      valid: true,\n      chain: \"solana\",\n      address: deriveSolanaAddress(key),\n      error: null,\n    };\n  } catch (err) {\n    return {\n      valid: false,\n      chain: \"solana\",\n      address: null,\n      error: `Invalid key: ${String(err)}`,\n    };\n  }\n}\n\n/** Auto-detect chain from key format and validate. */\nexport function validatePrivateKey(key: string): KeyValidationResult {\n  const trimmed = key.trim();\n  if (\n    trimmed.startsWith(\"0x\") ||\n    (trimmed.length === 64 && HEX_RE.test(trimmed))\n  )\n    return validateEvmPrivateKey(trimmed);\n  return validateSolanaPrivateKey(trimmed);\n}\n\n/** Mask a secret string for safe display (e.g. logs, UI). */\nexport function maskSecret(value: string): string {\n  if (!value || value.length <= 8) return \"****\";\n  return `${value.slice(0, 4)}...${value.slice(-4)}`;\n}\n\n// ── Key generation ────────────────────────────────────────────────────\n\nexport function generateWalletKeys(): WalletKeys {\n  const evmPrivateKey = generateEvmPrivateKey();\n  const solana = generateSolanaKeypair();\n  return {\n    evmPrivateKey,\n    evmAddress: deriveEvmAddress(evmPrivateKey),\n    solanaPrivateKey: solana.privateKey,\n    solanaAddress: solana.publicKey,\n  };\n}\n\nexport function generateWalletForChain(\n  chain: WalletChain,\n): WalletGenerateResult {\n  if (chain === \"evm\") {\n    const pk = generateEvmPrivateKey();\n    return { chain, address: deriveEvmAddress(pk), privateKey: pk };\n  }\n  const sol = generateSolanaKeypair();\n  return {\n    chain: \"solana\",\n    address: sol.publicKey,\n    privateKey: sol.privateKey,\n  };\n}\n\nexport function syncSolanaPublicKeyEnv(\n  privateKey = process.env.SOLANA_PRIVATE_KEY,\n): string | null {\n  const trimmed = privateKey?.trim();\n  if (!trimmed || ENV_SENTINEL_RE.test(trimmed)) {\n    return null;\n  }\n\n  try {\n    const publicKey = deriveSolanaAddress(trimmed);\n    process.env.SOLANA_PUBLIC_KEY = publicKey;\n    process.env.WALLET_PUBLIC_KEY = publicKey;\n    return publicKey;\n  } catch {\n    return null;\n  }\n}\n\nexport function setSolanaWalletEnv(privateKey: string): string | null {\n  const trimmed = privateKey.trim();\n  process.env.SOLANA_PRIVATE_KEY = trimmed;\n  return syncSolanaPublicKeyEnv(trimmed);\n}\n\n/** Validate key, store in process.env. Caller persists to config if needed. */\nexport function importWallet(\n  chain: WalletChain,\n  privateKey: string,\n): WalletImportResult {\n  const trimmed = privateKey.trim();\n  if (chain === \"evm\") {\n    const v = validateEvmPrivateKey(trimmed);\n    if (!v.valid)\n      return { success: false, chain, address: null, error: v.error };\n    process.env.EVM_PRIVATE_KEY = trimmed.startsWith(\"0x\")\n      ? trimmed\n      : `0x${trimmed}`;\n    logger.info(`[wallet] Imported EVM wallet: ${v.address}`);\n    return { success: true, chain, address: v.address, error: null };\n  }\n  const v = validateSolanaPrivateKey(trimmed);\n  if (!v.valid) return { success: false, chain, address: null, error: v.error };\n  setSolanaWalletEnv(trimmed);\n  logger.info(`[wallet] Imported Solana wallet: ${v.address}`);\n  return { success: true, chain, address: v.address, error: null };\n}\n\n// ── Steward wallet cache env keys ─────────────────────────────────────\n\nexport const STEWARD_EVM_ADDRESS_ENV_KEY = \"STEWARD_EVM_ADDRESS\";\nexport const STEWARD_SOLANA_ADDRESS_ENV_KEY = \"STEWARD_SOLANA_ADDRESS\";\n\nfunction resolveStewardCredentialsPath(): string {\n  return path.join(resolveStateDir(), \"steward-credentials.json\");\n}\n\ntype PersistedStewardCredentials = {\n  apiUrl?: string;\n  tenantId?: string;\n  agentId?: string;\n  apiKey?: string;\n  agentToken?: string;\n};\n\nfunction normalizeOptionalString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction readPersistedStewardCredentials(): {\n  apiUrl: string | null;\n  tenantId: string | null;\n  agentId: string | null;\n  apiKey: string | null;\n  agentToken: string | null;\n} | null {\n  const credentialsPath = resolveStewardCredentialsPath();\n  try {\n    if (!fs.existsSync(credentialsPath)) {\n      return null;\n    }\n    const parsed = JSON.parse(\n      fs.readFileSync(credentialsPath, \"utf8\"),\n    ) as PersistedStewardCredentials;\n    return {\n      apiUrl: normalizeOptionalString(parsed.apiUrl),\n      tenantId: normalizeOptionalString(parsed.tenantId),\n      agentId: normalizeOptionalString(parsed.agentId),\n      apiKey: normalizeOptionalString(parsed.apiKey),\n      agentToken: normalizeOptionalString(parsed.agentToken),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Initialise the steward wallet address cache.\n *\n * Call once during server startup.  Fetches addresses from the steward API\n * and writes them to `process.env.STEWARD_EVM_ADDRESS` /\n * `process.env.STEWARD_SOLANA_ADDRESS` so the synchronous\n * `getWalletAddresses()` can use them without hitting the network.\n */\nexport async function initStewardWalletCache(): Promise<void> {\n  const persisted = readPersistedStewardCredentials();\n  const stewardApiUrl =\n    normalizeOptionalString(process.env.STEWARD_API_URL) ?? persisted?.apiUrl;\n  if (!stewardApiUrl) return;\n\n  const agentId =\n    normalizeOptionalString(process.env.STEWARD_AGENT_ID) ||\n    normalizeOptionalString(process.env.ELIZA_STEWARD_AGENT_ID) ||\n    persisted?.agentId ||\n    null;\n\n  if (!agentId) return;\n\n  try {\n    const headers: Record<string, string> = { Accept: \"application/json\" };\n    const bearerToken =\n      normalizeOptionalString(process.env.STEWARD_AGENT_TOKEN) ??\n      persisted?.agentToken;\n    const apiKey =\n      normalizeOptionalString(process.env.STEWARD_API_KEY) ?? persisted?.apiKey;\n    const tenantId =\n      normalizeOptionalString(process.env.STEWARD_TENANT_ID) ??\n      persisted?.tenantId;\n\n    if (bearerToken) {\n      headers.Authorization = `Bearer ${bearerToken}`;\n    } else if (apiKey) {\n      headers[\"X-Steward-Key\"] = apiKey;\n    }\n    if (tenantId) {\n      headers[\"X-Steward-Tenant\"] = tenantId;\n    }\n\n    const res = await fetch(\n      `${stewardApiUrl}/agents/${encodeURIComponent(agentId)}`,\n      { headers, signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) },\n    );\n\n    if (!res.ok) {\n      logger.warn(\n        `[wallet] Steward wallet cache init: agent lookup returned ${res.status}`,\n      );\n      return;\n    }\n\n    const agent = readStewardAgentWalletPayload(await res.json());\n    const stewardEvm =\n      agent?.walletAddresses?.evm?.trim() ||\n      agent?.walletAddress?.trim() ||\n      null;\n    const stewardSolana = agent?.walletAddresses?.solana?.trim() || null;\n\n    stewardAddressCache = { evm: stewardEvm, solana: stewardSolana };\n    if (stewardEvm) {\n      process.env[STEWARD_EVM_ADDRESS_ENV_KEY] = stewardEvm;\n    } else {\n      delete process.env[STEWARD_EVM_ADDRESS_ENV_KEY];\n    }\n    if (stewardSolana) {\n      process.env[STEWARD_SOLANA_ADDRESS_ENV_KEY] = stewardSolana;\n      if (!process.env.SOLANA_PUBLIC_KEY?.trim()) {\n        process.env.SOLANA_PUBLIC_KEY = stewardSolana;\n      }\n      if (!process.env.WALLET_PUBLIC_KEY?.trim()) {\n        process.env.WALLET_PUBLIC_KEY = stewardSolana;\n      }\n    } else {\n      delete process.env[STEWARD_SOLANA_ADDRESS_ENV_KEY];\n    }\n\n    if (stewardEvm) {\n      logger.info(`[wallet] Steward EVM address cached: ${stewardEvm}`);\n    }\n    if (stewardSolana) {\n      logger.info(`[wallet] Steward Solana address cached: ${stewardSolana}`);\n    }\n  } catch (err) {\n    logger.debug(`[wallet] Steward wallet cache init unavailable: ${err}`);\n  }\n}\n\n/**\n * Derive addresses from env keys.  Works without a running runtime.\n *\n * Resolution order (steward-first):\n *   1. Steward cached addresses  (`STEWARD_EVM_ADDRESS` / `STEWARD_SOLANA_ADDRESS`)\n *   2. Local private key derivation  (`EVM_PRIVATE_KEY` / `SOLANA_PRIVATE_KEY`)\n *   3. Managed address env vars  (`ELIZA_MANAGED_EVM_ADDRESS` / `ELIZA_MANAGED_SOLANA_ADDRESS`)\n */\nexport function getWalletAddresses(): WalletAddresses {\n  let evmAddress: string | null = null;\n  let solanaAddress: string | null = null;\n\n  // ── 1. Steward cached addresses (primary) ──────────────────────────\n  const stewardEvm =\n    stewardAddressCache?.evm?.trim() ??\n    process.env[STEWARD_EVM_ADDRESS_ENV_KEY]?.trim();\n  if (stewardEvm && /^0x[0-9a-fA-F]{40}$/.test(stewardEvm)) {\n    evmAddress = stewardEvm;\n  }\n\n  const stewardSolana =\n    stewardAddressCache?.solana?.trim() ??\n    process.env[STEWARD_SOLANA_ADDRESS_ENV_KEY]?.trim();\n  if (stewardSolana) {\n    try {\n      const decoded = base58Decode(stewardSolana);\n      if (decoded.length === 32) {\n        solanaAddress = stewardSolana;\n      }\n    } catch {\n      // invalid — skip\n    }\n  }\n\n  // ── 2. Local private key derivation (fallback) ─────────────────────\n  if (!evmAddress) {\n    const evmKey = process.env.EVM_PRIVATE_KEY;\n    if (evmKey && !ENV_SENTINEL_RE.test(evmKey)) {\n      try {\n        evmAddress = deriveEvmAddress(evmKey);\n      } catch (e) {\n        logger.warn(`Bad EVM key: ${e}`);\n      }\n    }\n  }\n\n  if (!solanaAddress) {\n    const solKey = process.env.SOLANA_PRIVATE_KEY;\n    if (solKey && !ENV_SENTINEL_RE.test(solKey)) {\n      try {\n        solanaAddress = deriveSolanaAddress(solKey);\n      } catch (e) {\n        logger.warn(`Bad SOL key: ${e}`);\n      }\n    }\n  }\n\n  // ── 3. Managed address env vars (last resort) ──────────────────────\n  if (!evmAddress) {\n    const managedEvmAddress = process.env[MANAGED_EVM_ADDRESS_ENV_KEY];\n    if (managedEvmAddress) {\n      const trimmed = managedEvmAddress.trim();\n      if (/^0x[0-9a-fA-F]{40}$/.test(trimmed)) {\n        evmAddress = trimmed;\n      } else {\n        logger.warn(\"Bad managed EVM address in env\");\n      }\n    }\n  }\n\n  if (!solanaAddress) {\n    const managedSolanaAddress = process.env[MANAGED_SOLANA_ADDRESS_ENV_KEY];\n    if (managedSolanaAddress) {\n      const trimmed = managedSolanaAddress.trim();\n      try {\n        const decoded = base58Decode(trimmed);\n        if (decoded.length === 32) {\n          solanaAddress = trimmed;\n        } else {\n          logger.warn(\"Bad managed Solana address in env\");\n        }\n      } catch {\n        logger.warn(\"Bad managed Solana address in env\");\n      }\n    }\n  }\n\n  return { evmAddress, solanaAddress };\n}\n\n/**\n * Extended wallet addresses including steward-managed wallets.\n * Calls steward API (async) to discover additional addresses.\n * Key-derived addresses are always preferred; steward addresses fill gaps.\n */\nexport async function getWalletAddressesWithSteward(): Promise<\n  WalletAddresses & {\n    stewardEvmAddress?: string | null;\n    stewardSolanaAddress?: string | null;\n  }\n> {\n  const base = getWalletAddresses();\n\n  // Only augment when steward is configured\n  const stewardApiUrl = process.env.STEWARD_API_URL?.trim();\n  if (!stewardApiUrl) {\n    return base;\n  }\n\n  const agentId =\n    process.env.STEWARD_AGENT_ID?.trim() ||\n    process.env.ELIZA_STEWARD_AGENT_ID?.trim() ||\n    base.evmAddress?.trim() ||\n    null;\n\n  if (!agentId) {\n    return base;\n  }\n\n  try {\n    const headers: Record<string, string> = {\n      Accept: \"application/json\",\n    };\n    const bearerToken = process.env.STEWARD_AGENT_TOKEN?.trim();\n    const apiKey = process.env.STEWARD_API_KEY?.trim();\n    const tenantId = process.env.STEWARD_TENANT_ID?.trim();\n\n    if (bearerToken) {\n      headers.Authorization = `Bearer ${bearerToken}`;\n    } else if (apiKey) {\n      headers[\"X-Steward-Key\"] = apiKey;\n    }\n    if (tenantId) {\n      headers[\"X-Steward-Tenant\"] = tenantId;\n    }\n\n    const res = await fetch(\n      `${stewardApiUrl}/agents/${encodeURIComponent(agentId)}`,\n      { headers, signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) },\n    );\n\n    if (!res.ok) {\n      logger.warn(`Steward agent lookup returned ${res.status}`);\n      return base;\n    }\n\n    const agent = readStewardAgentWalletPayload(await res.json());\n    const stewardEvm =\n      agent?.walletAddresses?.evm?.trim() ||\n      agent?.walletAddress?.trim() ||\n      null;\n    const stewardSolana = agent?.walletAddresses?.solana?.trim() || null;\n\n    return {\n      evmAddress: base.evmAddress ?? stewardEvm,\n      solanaAddress: base.solanaAddress ?? stewardSolana,\n      stewardEvmAddress: stewardEvm,\n      stewardSolanaAddress: stewardSolana,\n    };\n  } catch (err) {\n    logger.warn(`Steward wallet address lookup failed: ${err}`);\n    return base;\n  }\n}\n\n// ── Helius API (Solana tokens + NFTs) ─────────────────────────────────\n\ninterface HeliusAsset {\n  id: string;\n  interface: string;\n  content?: {\n    metadata?: { name?: string; symbol?: string; description?: string };\n    links?: { image?: string };\n  };\n  token_info?: {\n    balance?: number;\n    decimals?: number;\n    price_info?: { total_price?: number };\n    symbol?: string;\n  };\n  grouping?: Array<{\n    group_key?: string;\n    collection_metadata?: { name?: string };\n  }>;\n}\n\nfunction rpcJsonRequest(body: string): RequestInit {\n  return {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),\n    body,\n  };\n}\n\nfunction describeRpcEndpoint(url: string): string {\n  try {\n    return new URL(url).host;\n  } catch {\n    return \"rpc\";\n  }\n}\n\n/** Parse JSON from a fetch response. If the body isn't JSON, throw with the raw text. */\nasync function jsonOrThrow<T>(res: Response): Promise<T> {\n  const text = await res.text();\n  if (!res.ok) throw new Error(text.slice(0, 200) || `HTTP ${res.status}`);\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    throw new Error(text.slice(0, 200) || \"Invalid JSON\");\n  }\n}\n\nexport async function fetchSolanaBalances(\n  address: string,\n  heliusKey: string,\n): Promise<{\n  solBalance: string;\n  solValueUsd: string;\n  tokens: SolanaTokenBalance[];\n}> {\n  const url = `https://mainnet.helius-rpc.com/?api-key=${heliusKey}`;\n  const rpc = (body: string): RequestInit => ({\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),\n    body,\n  });\n\n  let solBalance = \"0\";\n  try {\n    const data = await jsonOrThrow<{\n      result?: { value?: number };\n      error?: { message?: string };\n    }>(\n      await fetch(\n        url,\n        rpc(\n          JSON.stringify({\n            jsonrpc: \"2.0\",\n            id: 1,\n            method: \"getBalance\",\n            params: [address],\n          }),\n        ),\n      ),\n    );\n    if (data.error?.message) throw new Error(data.error.message);\n    solBalance = ((data.result?.value ?? 0) / 1e9).toFixed(9);\n  } catch (err) {\n    logger.warn(`SOL balance fetch failed: ${String(err)}`);\n  }\n\n  const tokens: SolanaTokenBalance[] = [];\n  try {\n    const data = await jsonOrThrow<{\n      result?: { items?: HeliusAsset[] };\n      error?: { message?: string };\n    }>(\n      await fetch(\n        url,\n        rpc(\n          JSON.stringify({\n            jsonrpc: \"2.0\",\n            id: 2,\n            method: \"getAssetsByOwner\",\n            params: {\n              ownerAddress: address,\n              displayOptions: { showFungible: true, showNativeBalance: true },\n              page: 1,\n              limit: 100,\n            },\n          }),\n        ),\n      ),\n    );\n    if (data.error?.message) throw new Error(data.error.message);\n    for (const item of data.result?.items ?? []) {\n      if (\n        item.interface !== \"FungibleToken\" &&\n        item.interface !== \"FungibleAsset\"\n      )\n        continue;\n      const dec = item.token_info?.decimals ?? 0;\n      const raw = item.token_info?.balance ?? 0;\n      tokens.push({\n        symbol:\n          item.token_info?.symbol ?? item.content?.metadata?.symbol ?? \"???\",\n        name: item.content?.metadata?.name ?? \"Unknown\",\n        mint: item.id,\n        balance: dec > 0 ? (raw / 10 ** dec).toString() : raw.toString(),\n        decimals: dec,\n        valueUsd: item.token_info?.price_info?.total_price?.toFixed(2) ?? \"0\",\n        logoUrl: item.content?.links?.image ?? \"\",\n      });\n    }\n  } catch (err) {\n    logger.warn(`Solana token fetch failed: ${String(err)}`);\n  }\n\n  return { solBalance, solValueUsd: \"0\", tokens };\n}\n\nexport async function fetchSolanaNativeBalanceViaRpc(\n  address: string,\n  rpcUrls: string[],\n): Promise<{\n  solBalance: string;\n  solValueUsd: string;\n  tokens: SolanaTokenBalance[];\n}> {\n  const urls = [...new Set(rpcUrls)].filter((u) => Boolean(u?.trim()));\n  const errors: string[] = [];\n\n  for (const rpcUrl of urls) {\n    try {\n      const data = await jsonOrThrow<{\n        result?: { value?: number };\n        error?: { message?: string };\n      }>(\n        await fetch(\n          rpcUrl,\n          rpcJsonRequest(\n            JSON.stringify({\n              jsonrpc: \"2.0\",\n              id: 1,\n              method: \"getBalance\",\n              params: [address],\n            }),\n          ),\n        ),\n      );\n      if (data.error?.message) throw new Error(data.error.message);\n\n      const solBalance = ((data.result?.value ?? 0) / 1e9).toFixed(9);\n      return { solBalance, solValueUsd: \"0\", tokens: [] };\n    } catch (err) {\n      const msg = String(err);\n      errors.push(`${describeRpcEndpoint(rpcUrl)}: ${msg}`);\n    }\n  }\n\n  throw new Error(errors.join(\" | \").slice(0, 400) || \"Solana RPC unavailable\");\n}\n"],"mappings":"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","names":["v"]}

package/dist/chain-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Chain utilities for displaying chain names, symbols, and block explorer links.
+ */
+export declare function getChainName(chainId: number): string;
+export declare function getChainSymbol(chainId: number): string;
+export declare function getExplorerTxUrl(chainId: number, txHash: string): string | null;
+export declare function getExplorerAddressUrl(chainId: number, address: string): string | null;
+export declare function truncateAddress(address: string, chars?: number): string;
+export declare function formatWeiValue(weiStr: string, chainId: number): string;
+//# sourceMappingURL=chain-utils.d.ts.map

package/dist/chain-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-utils.d.ts","sourceRoot":"","sources":["../src/chain-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAGlE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBtE"}

package/dist/chain-utils.js

@@ -0,0 +1,81 @@
+const CHAIN_MAP = {
+  1: { name: "Ethereum", symbol: "ETH", explorerBase: "https://etherscan.io" },
+  56: { name: "BSC", symbol: "BNB", explorerBase: "https://bscscan.com" },
+  97: {
+    name: "BSC Testnet",
+    symbol: "tBNB",
+    explorerBase: "https://testnet.bscscan.com"
+  },
+  137: {
+    name: "Polygon",
+    symbol: "POL",
+    explorerBase: "https://polygonscan.com"
+  },
+  8453: { name: "Base", symbol: "ETH", explorerBase: "https://basescan.org" },
+  42161: {
+    name: "Arbitrum",
+    symbol: "ETH",
+    explorerBase: "https://arbiscan.io"
+  },
+  84532: {
+    name: "Base Sepolia",
+    symbol: "ETH",
+    explorerBase: "https://sepolia.basescan.org"
+  },
+  101: { name: "Solana", symbol: "SOL", explorerBase: "https://solscan.io" },
+  102: {
+    name: "Solana Devnet",
+    symbol: "SOL",
+    explorerBase: "https://solscan.io"
+  }
+};
+function getChainName(chainId) {
+  return CHAIN_MAP[chainId]?.name ?? `Chain ${chainId}`;
+}
+function getChainSymbol(chainId) {
+  return CHAIN_MAP[chainId]?.symbol ?? "???";
+}
+function getExplorerTxUrl(chainId, txHash) {
+  const meta = CHAIN_MAP[chainId];
+  if (!meta || !txHash) return null;
+  if (chainId === 101 || chainId === 102) {
+    return `${meta.explorerBase}/tx/${txHash}${chainId === 102 ? "?cluster=devnet" : ""}`;
+  }
+  return `${meta.explorerBase}/tx/${txHash}`;
+}
+function getExplorerAddressUrl(chainId, address) {
+  const meta = CHAIN_MAP[chainId];
+  if (!meta || !address) return null;
+  if (chainId === 101 || chainId === 102) {
+    return `${meta.explorerBase}/account/${address}${chainId === 102 ? "?cluster=devnet" : ""}`;
+  }
+  return `${meta.explorerBase}/address/${address}`;
+}
+function truncateAddress(address, chars = 6) {
+  if (!address || address.length <= chars * 2 + 2) return address;
+  return `${address.slice(0, chars + 2)}\u2026${address.slice(-chars)}`;
+}
+function formatWeiValue(weiStr, chainId) {
+  try {
+    const wei = BigInt(weiStr);
+    const isSolana = chainId === 101 || chainId === 102;
+    const decimals = isSolana ? 9 : 18;
+    const divisor = BigInt(10 ** decimals);
+    const whole = wei / divisor;
+    const frac = wei % divisor;
+    const fracStr = frac.toString().padStart(decimals, "0").slice(0, 6).replace(/0+$/, "");
+    const symbol = getChainSymbol(chainId);
+    return `${whole}${fracStr ? `.${fracStr}` : ""} ${symbol}`;
+  } catch {
+    return `${weiStr} wei`;
+  }
+}
+export {
+  formatWeiValue,
+  getChainName,
+  getChainSymbol,
+  getExplorerAddressUrl,
+  getExplorerTxUrl,
+  truncateAddress
+};
+//# sourceMappingURL=chain-utils.js.map

package/dist/chain-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chain-utils.ts"],"sourcesContent":["/**\n * Chain utilities for displaying chain names, symbols, and block explorer links.\n */\n\ninterface ChainMeta {\n  name: string;\n  symbol: string;\n  explorerBase: string;\n}\n\nconst CHAIN_MAP: Record<number, ChainMeta> = {\n  1: { name: \"Ethereum\", symbol: \"ETH\", explorerBase: \"https://etherscan.io\" },\n  56: { name: \"BSC\", symbol: \"BNB\", explorerBase: \"https://bscscan.com\" },\n  97: {\n    name: \"BSC Testnet\",\n    symbol: \"tBNB\",\n    explorerBase: \"https://testnet.bscscan.com\",\n  },\n  137: {\n    name: \"Polygon\",\n    symbol: \"POL\",\n    explorerBase: \"https://polygonscan.com\",\n  },\n  8453: { name: \"Base\", symbol: \"ETH\", explorerBase: \"https://basescan.org\" },\n  42161: {\n    name: \"Arbitrum\",\n    symbol: \"ETH\",\n    explorerBase: \"https://arbiscan.io\",\n  },\n  84532: {\n    name: \"Base Sepolia\",\n    symbol: \"ETH\",\n    explorerBase: \"https://sepolia.basescan.org\",\n  },\n  101: { name: \"Solana\", symbol: \"SOL\", explorerBase: \"https://solscan.io\" },\n  102: {\n    name: \"Solana Devnet\",\n    symbol: \"SOL\",\n    explorerBase: \"https://solscan.io\",\n  },\n};\n\nexport function getChainName(chainId: number): string {\n  return CHAIN_MAP[chainId]?.name ?? `Chain ${chainId}`;\n}\n\nexport function getChainSymbol(chainId: number): string {\n  return CHAIN_MAP[chainId]?.symbol ?? \"???\";\n}\n\nexport function getExplorerTxUrl(\n  chainId: number,\n  txHash: string,\n): string | null {\n  const meta = CHAIN_MAP[chainId];\n  if (!meta || !txHash) return null;\n  if (chainId === 101 || chainId === 102) {\n    return `${meta.explorerBase}/tx/${txHash}${chainId === 102 ? \"?cluster=devnet\" : \"\"}`;\n  }\n  return `${meta.explorerBase}/tx/${txHash}`;\n}\n\nexport function getExplorerAddressUrl(\n  chainId: number,\n  address: string,\n): string | null {\n  const meta = CHAIN_MAP[chainId];\n  if (!meta || !address) return null;\n  if (chainId === 101 || chainId === 102) {\n    return `${meta.explorerBase}/account/${address}${chainId === 102 ? \"?cluster=devnet\" : \"\"}`;\n  }\n  return `${meta.explorerBase}/address/${address}`;\n}\n\nexport function truncateAddress(address: string, chars = 6): string {\n  if (!address || address.length <= chars * 2 + 2) return address;\n  return `${address.slice(0, chars + 2)}…${address.slice(-chars)}`;\n}\n\nexport function formatWeiValue(weiStr: string, chainId: number): string {\n  try {\n    const wei = BigInt(weiStr);\n    const isSolana = chainId === 101 || chainId === 102;\n    const decimals = isSolana ? 9 : 18;\n    const divisor = BigInt(10 ** decimals);\n    const whole = wei / divisor;\n    const frac = wei % divisor;\n    const fracStr = frac\n      .toString()\n      .padStart(decimals, \"0\")\n      .slice(0, 6)\n      .replace(/0+$/, \"\");\n    const symbol = getChainSymbol(chainId);\n    return `${whole}${fracStr ? `.${fracStr}` : \"\"} ${symbol}`;\n  } catch {\n    return `${weiStr} wei`;\n  }\n}\n"],"mappings":"AAUA,MAAM,YAAuC;AAAA,EAC3C,GAAG,EAAE,MAAM,YAAY,QAAQ,OAAO,cAAc,uBAAuB;AAAA,EAC3E,IAAI,EAAE,MAAM,OAAO,QAAQ,OAAO,cAAc,sBAAsB;AAAA,EACtE,IAAI;AAAA,IACF,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AAAA,EACA,KAAK;AAAA,IACH,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AAAA,EACA,MAAM,EAAE,MAAM,QAAQ,QAAQ,OAAO,cAAc,uBAAuB;AAAA,EAC1E,OAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AAAA,EACA,KAAK,EAAE,MAAM,UAAU,QAAQ,OAAO,cAAc,qBAAqB;AAAA,EACzE,KAAK;AAAA,IACH,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,cAAc;AAAA,EAChB;AACF;AAEO,SAAS,aAAa,SAAyB;AACpD,SAAO,UAAU,OAAO,GAAG,QAAQ,SAAS,OAAO;AACrD;AAEO,SAAS,eAAe,SAAyB;AACtD,SAAO,UAAU,OAAO,GAAG,UAAU;AACvC;AAEO,SAAS,iBACd,SACA,QACe;AACf,QAAM,OAAO,UAAU,OAAO;AAC9B,MAAI,CAAC,QAAQ,CAAC,OAAQ,QAAO;AAC7B,MAAI,YAAY,OAAO,YAAY,KAAK;AACtC,WAAO,GAAG,KAAK,YAAY,OAAO,MAAM,GAAG,YAAY,MAAM,oBAAoB,EAAE;AAAA,EACrF;AACA,SAAO,GAAG,KAAK,YAAY,OAAO,MAAM;AAC1C;AAEO,SAAS,sBACd,SACA,SACe;AACf,QAAM,OAAO,UAAU,OAAO;AAC9B,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,MAAI,YAAY,OAAO,YAAY,KAAK;AACtC,WAAO,GAAG,KAAK,YAAY,YAAY,OAAO,GAAG,YAAY,MAAM,oBAAoB,EAAE;AAAA,EAC3F;AACA,SAAO,GAAG,KAAK,YAAY,YAAY,OAAO;AAChD;AAEO,SAAS,gBAAgB,SAAiB,QAAQ,GAAW;AAClE,MAAI,CAAC,WAAW,QAAQ,UAAU,QAAQ,IAAI,EAAG,QAAO;AACxD,SAAO,GAAG,QAAQ,MAAM,GAAG,QAAQ,CAAC,CAAC,SAAI,QAAQ,MAAM,CAAC,KAAK,CAAC;AAChE;AAEO,SAAS,eAAe,QAAgB,SAAyB;AACtE,MAAI;AACF,UAAM,MAAM,OAAO,MAAM;AACzB,UAAM,WAAW,YAAY,OAAO,YAAY;AAChD,UAAM,WAAW,WAAW,IAAI;AAChC,UAAM,UAAU,OAAO,MAAM,QAAQ;AACrC,UAAM,QAAQ,MAAM;AACpB,UAAM,OAAO,MAAM;AACnB,UAAM,UAAU,KACb,SAAS,EACT,SAAS,UAAU,GAAG,EACtB,MAAM,GAAG,CAAC,EACV,QAAQ,OAAO,EAAE;AACpB,UAAM,SAAS,eAAe,OAAO;AACrC,WAAO,GAAG,KAAK,GAAG,UAAU,IAAI,OAAO,KAAK,EAAE,IAAI,MAAM;AAAA,EAC1D,QAAQ;AACN,WAAO,GAAG,MAAM;AAAA,EAClB;AACF;","names":[]}

package/dist/components/StewardSpatialView.d.ts

@@ -0,0 +1,74 @@
+/**
+ * StewardSpatialView — the Steward approvals + history panel authored once with
+ * the spatial vocabulary, so it renders correctly wherever it is displayed:
+ *
+ *   - GUI / XR - mounted in `<SpatialSurface>` (DOM; XR scales up).
+ *   - TUI      - rendered to real terminal lines by the agent terminal, via
+ *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).
+ *
+ * It is purely presentational (a snapshot + an action callback in, primitives
+ * out) and imports only the cross-modality primitives plus type-only views of
+ * the Steward response shapes, so it is safe to render in the Node agent process
+ * where the terminal lives (no browser/app-runtime import).
+ */
+import type { StewardPendingApproval, StewardTxRecord, StewardTxStatus } from "../types/steward.js";
+/** A pending-approval row in the snapshot (mirrors the loopback pending shape). */
+export interface StewardApprovalRow {
+    queueId: string;
+    requestedAt: string;
+    txId: string;
+    status: string;
+    chainId: number;
+    to: string;
+    value: string;
+    /** Count of policy results attached to the transaction. */
+    policyCount: number;
+}
+/** A history row in the snapshot (mirrors the loopback tx-record shape). */
+export interface StewardHistoryRow {
+    id: string;
+    createdAt: string;
+    status: StewardTxStatus;
+    chainId: number;
+    to: string;
+    value: string;
+    txHash?: string;
+}
+export interface StewardSnapshot {
+    /** Active tab — Approvals or History. */
+    tab: "approvals" | "history";
+    connected: boolean;
+    configured: boolean;
+    available: boolean;
+    evmAddress: string | null;
+    pendingApprovals: StewardApprovalRow[];
+    history: StewardHistoryRow[];
+    /** Total history records (for pagination, not the visible slice length). */
+    historyTotal: number;
+    /** Active history filters. */
+    statusFilter: string | null;
+    chainFilter: number | null;
+    /** 0-based page index. */
+    page: number;
+    pageSize: number;
+    loading?: boolean;
+    error?: string | null;
+}
+/** Map a native pending-approval entry to the presentational row shape. */
+export declare function toStewardApprovalRow(entry: StewardPendingApproval): StewardApprovalRow;
+/** Map a native tx record to the presentational history row shape. */
+export declare function toStewardHistoryRow(record: StewardTxRecord): StewardHistoryRow;
+export interface StewardSpatialViewProps {
+    snapshot: StewardSnapshot;
+    /**
+     * Dispatch by agent id: `tab:approvals`, `tab:history`, `refresh`,
+     * `approve:<queueId>`, `reject:<queueId>`, `copy:<value>`,
+     * `filter-status`, `filter-chain`, `page-prev`, `page-next`.
+     *
+     * `copy:<value>` carries the literal string to copy to the clipboard (the
+     * recipient address for both approval and history rows).
+     */
+    onAction?: (action: string) => void;
+}
+export declare function StewardSpatialView({ snapshot, onAction, }: StewardSpatialViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=StewardSpatialView.d.ts.map

package/dist/components/StewardSpatialView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StewardSpatialView.d.ts","sourceRoot":"","sources":["../../src/components/StewardSpatialView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;IACvC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AA2BD,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,sBAAsB,GAC5B,kBAAkB,CAYpB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,GACtB,iBAAiB,CAUnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAyMD,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,GACT,EAAE,uBAAuB,2CA8DzB"}

package/dist/components/StewardSpatialView.js

@@ -0,0 +1,309 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import {
+  Button,
+  Card,
+  Divider,
+  HStack,
+  List,
+  Text,
+  VStack
+} from "@elizaos/ui/spatial";
+const PAGE_SIZE = 25;
+function statusTone(status) {
+  switch (status) {
+    case "confirmed":
+    case "broadcast":
+    case "approved":
+    case "signed":
+      return "success";
+    case "failed":
+    case "rejected":
+      return "danger";
+    case "pending":
+      return "warning";
+    default:
+      return "muted";
+  }
+}
+function shortAddress(value) {
+  if (!value) return "no steward evm address";
+  if (value.length <= 12) return value;
+  return `${value.slice(0, 6)}..${value.slice(-4)}`;
+}
+function toStewardApprovalRow(entry) {
+  const tx = entry.transaction;
+  return {
+    queueId: entry.queueId,
+    requestedAt: entry.requestedAt,
+    txId: tx.id,
+    status: tx.status,
+    chainId: tx.request.chainId,
+    to: tx.request.to,
+    value: tx.request.value,
+    policyCount: tx.policyResults.length
+  };
+}
+function toStewardHistoryRow(record) {
+  return {
+    id: record.id,
+    createdAt: record.createdAt,
+    status: record.status,
+    chainId: record.request.chainId,
+    to: record.request.to,
+    value: record.request.value,
+    txHash: record.txHash
+  };
+}
+function StatusLine({ label, value }) {
+  return /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", children: [
+    /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", children: label }),
+    /* @__PURE__ */ jsx(Text, { style: "caption", grow: 1, wrap: false, children: value })
+  ] });
+}
+function ApprovalsBody({
+  snapshot,
+  dispatch
+}) {
+  return /* @__PURE__ */ jsxs(VStack, { gap: 1, width: "100%", children: [
+    /* @__PURE__ */ jsx(
+      StatusLine,
+      {
+        label: "configured",
+        value: snapshot.configured ? "yes" : "no"
+      }
+    ),
+    /* @__PURE__ */ jsx(StatusLine, { label: "available", value: snapshot.available ? "yes" : "no" }),
+    /* @__PURE__ */ jsx(StatusLine, { label: "evm", value: shortAddress(snapshot.evmAddress) }),
+    !snapshot.connected && !snapshot.loading ? /* @__PURE__ */ jsx(Text, { tone: "muted", style: "caption", wrap: true, children: "Set STEWARD_API_URL and STEWARD_API_KEY to enable vault approvals." }) : null,
+    /* @__PURE__ */ jsx(Divider, { label: "pending approvals" }),
+    snapshot.pendingApprovals.length === 0 ? /* @__PURE__ */ jsx(Text, { tone: "muted", align: "center", style: "caption", children: snapshot.loading ? "Loading" : "None" }) : /* @__PURE__ */ jsx(List, { gap: 1, width: "100%", children: snapshot.pendingApprovals.map((item) => /* @__PURE__ */ jsxs(
+      VStack,
+      {
+        gap: 0,
+        width: "100%",
+        agent: `approval-${item.queueId}`,
+        children: [
+          /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+            /* @__PURE__ */ jsx(Text, { bold: true, grow: 1, wrap: false, children: item.txId }),
+            /* @__PURE__ */ jsx(Text, { style: "caption", tone: statusTone(item.status), children: item.status })
+          ] }),
+          /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+            /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", grow: 1, wrap: false, children: [
+              "chain ",
+              item.chainId,
+              " to ",
+              item.to
+            ] }),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "ghost",
+                tone: "default",
+                agent: `copy-${item.queueId}`,
+                onPress: dispatch(`copy:${item.to}`),
+                children: "Copy"
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", wrap: false, children: [
+            "value ",
+            item.value,
+            " | ",
+            item.policyCount,
+            " policy"
+          ] }),
+          /* @__PURE__ */ jsxs(HStack, { gap: 1, width: "100%", children: [
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                tone: "primary",
+                grow: 1,
+                agent: `approve-${item.queueId}`,
+                onPress: dispatch(`approve:${item.queueId}`),
+                children: "Approve"
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "outline",
+                tone: "danger",
+                grow: 1,
+                agent: `reject-${item.queueId}`,
+                onPress: dispatch(`reject:${item.queueId}`),
+                children: "Reject"
+              }
+            )
+          ] })
+        ]
+      },
+      item.queueId
+    )) })
+  ] });
+}
+function HistoryBody({
+  snapshot,
+  dispatch
+}) {
+  const pageSize = snapshot.pageSize || PAGE_SIZE;
+  const totalPages = Math.max(1, Math.ceil(snapshot.historyTotal / pageSize));
+  const pageLabel = `page ${snapshot.page + 1}/${totalPages}`;
+  return /* @__PURE__ */ jsxs(VStack, { gap: 1, width: "100%", children: [
+    /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+      /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", grow: 1, children: [
+        snapshot.historyTotal,
+        " records"
+      ] }),
+      /* @__PURE__ */ jsxs(
+        Button,
+        {
+          variant: "outline",
+          tone: "default",
+          agent: "filter-status",
+          onPress: dispatch("filter-status"),
+          children: [
+            "status: ",
+            snapshot.statusFilter ?? "all"
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsxs(
+        Button,
+        {
+          variant: "outline",
+          tone: "default",
+          agent: "filter-chain",
+          onPress: dispatch("filter-chain"),
+          children: [
+            "chain: ",
+            snapshot.chainFilter ?? "all"
+          ]
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(Divider, { label: "transaction history" }),
+    snapshot.history.length === 0 ? /* @__PURE__ */ jsx(Text, { tone: "muted", align: "center", style: "caption", children: snapshot.loading ? "Loading" : "None" }) : /* @__PURE__ */ jsx(List, { gap: 1, width: "100%", children: snapshot.history.map((tx) => /* @__PURE__ */ jsxs(VStack, { gap: 0, width: "100%", agent: `tx-${tx.id}`, children: [
+      /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+        /* @__PURE__ */ jsx(Text, { bold: true, grow: 1, wrap: false, children: tx.id }),
+        /* @__PURE__ */ jsx(Text, { style: "caption", tone: statusTone(tx.status), children: tx.status }),
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            variant: "ghost",
+            tone: "default",
+            agent: `copy-${tx.id}`,
+            onPress: dispatch(`copy:${tx.to}`),
+            children: "Copy"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", wrap: false, children: [
+        "chain ",
+        tx.chainId,
+        " to ",
+        tx.to
+      ] }),
+      tx.txHash ? /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", wrap: false, children: [
+        "hash ",
+        tx.txHash
+      ] }) : null
+    ] }, tx.id)) }),
+    /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "outline",
+          tone: "default",
+          disabled: snapshot.page <= 0,
+          agent: "page-prev",
+          onPress: dispatch("page-prev"),
+          children: "Prev"
+        }
+      ),
+      /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", align: "center", grow: 1, children: pageLabel }),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "outline",
+          tone: "default",
+          disabled: snapshot.page + 1 >= totalPages,
+          agent: "page-next",
+          onPress: dispatch("page-next"),
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+function StewardSpatialView({
+  snapshot,
+  onAction
+}) {
+  const dispatch = (action) => () => onAction?.(action);
+  const title = snapshot.tab === "approvals" ? "Approvals" : "History";
+  return /* @__PURE__ */ jsxs(Card, { gap: 1, padding: 1, children: [
+    /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", width: "100%", children: [
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          style: "caption",
+          tone: snapshot.connected ? "success" : "danger",
+          grow: 1,
+          children: snapshot.connected ? "connected" : "not-connected"
+        }
+      ),
+      /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", children: shortAddress(snapshot.evmAddress) })
+    ] }),
+    snapshot.error ? /* @__PURE__ */ jsx(Text, { tone: "danger", style: "caption", wrap: true, children: snapshot.error }) : null,
+    /* @__PURE__ */ jsxs(HStack, { gap: 1, width: "100%", wrap: true, children: [
+      /* @__PURE__ */ jsxs(
+        Button,
+        {
+          variant: snapshot.tab === "approvals" ? "solid" : "outline",
+          tone: snapshot.tab === "approvals" ? "primary" : "default",
+          grow: 1,
+          agent: "tab-approvals",
+          onPress: dispatch("tab:approvals"),
+          children: [
+            "Approvals (",
+            snapshot.pendingApprovals.length,
+            ")"
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsxs(
+        Button,
+        {
+          variant: snapshot.tab === "history" ? "solid" : "outline",
+          tone: snapshot.tab === "history" ? "primary" : "default",
+          grow: 1,
+          agent: "tab-history",
+          onPress: dispatch("tab:history"),
+          children: [
+            "History (",
+            snapshot.historyTotal,
+            ")"
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "ghost",
+          tone: "default",
+          agent: "refresh",
+          onPress: dispatch("refresh"),
+          children: snapshot.loading ? "..." : "Refresh"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(Divider, { label: title }),
+    snapshot.tab === "approvals" ? /* @__PURE__ */ jsx(ApprovalsBody, { snapshot, dispatch }) : /* @__PURE__ */ jsx(HistoryBody, { snapshot, dispatch })
+  ] });
+}
+export {
+  StewardSpatialView,
+  toStewardApprovalRow,
+  toStewardHistoryRow
+};
+//# sourceMappingURL=StewardSpatialView.js.map

package/dist/components/StewardSpatialView.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/StewardSpatialView.tsx"],"sourcesContent":["/**\n * StewardSpatialView — the Steward approvals + history panel authored once with\n * the spatial vocabulary, so it renders correctly wherever it is displayed:\n *\n *   - GUI / XR - mounted in `<SpatialSurface>` (DOM; XR scales up).\n *   - TUI      - rendered to real terminal lines by the agent terminal, via\n *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).\n *\n * It is purely presentational (a snapshot + an action callback in, primitives\n * out) and imports only the cross-modality primitives plus type-only views of\n * the Steward response shapes, so it is safe to render in the Node agent process\n * where the terminal lives (no browser/app-runtime import).\n */\n\nimport {\n  Button,\n  Card,\n  Divider,\n  HStack,\n  List,\n  type SpatialTone,\n  Text,\n  VStack,\n} from \"@elizaos/ui/spatial\";\nimport type {\n  StewardPendingApproval,\n  StewardTxRecord,\n  StewardTxStatus,\n} from \"../types/steward.js\";\n\n/** A pending-approval row in the snapshot (mirrors the loopback pending shape). */\nexport interface StewardApprovalRow {\n  queueId: string;\n  requestedAt: string;\n  txId: string;\n  status: string;\n  chainId: number;\n  to: string;\n  value: string;\n  /** Count of policy results attached to the transaction. */\n  policyCount: number;\n}\n\n/** A history row in the snapshot (mirrors the loopback tx-record shape). */\nexport interface StewardHistoryRow {\n  id: string;\n  createdAt: string;\n  status: StewardTxStatus;\n  chainId: number;\n  to: string;\n  value: string;\n  txHash?: string;\n}\n\nexport interface StewardSnapshot {\n  /** Active tab — Approvals or History. */\n  tab: \"approvals\" | \"history\";\n  connected: boolean;\n  configured: boolean;\n  available: boolean;\n  evmAddress: string | null;\n  pendingApprovals: StewardApprovalRow[];\n  history: StewardHistoryRow[];\n  /** Total history records (for pagination, not the visible slice length). */\n  historyTotal: number;\n  /** Active history filters. */\n  statusFilter: string | null;\n  chainFilter: number | null;\n  /** 0-based page index. */\n  page: number;\n  pageSize: number;\n  loading?: boolean;\n  error?: string | null;\n}\n\nconst PAGE_SIZE = 25;\n\nfunction statusTone(status: string): SpatialTone {\n  switch (status) {\n    case \"confirmed\":\n    case \"broadcast\":\n    case \"approved\":\n    case \"signed\":\n      return \"success\";\n    case \"failed\":\n    case \"rejected\":\n      return \"danger\";\n    case \"pending\":\n      return \"warning\";\n    default:\n      return \"muted\";\n  }\n}\n\nfunction shortAddress(value: string | null | undefined): string {\n  if (!value) return \"no steward evm address\";\n  if (value.length <= 12) return value;\n  return `${value.slice(0, 6)}..${value.slice(-4)}`;\n}\n\n/** Map a native pending-approval entry to the presentational row shape. */\nexport function toStewardApprovalRow(\n  entry: StewardPendingApproval,\n): StewardApprovalRow {\n  const tx = entry.transaction;\n  return {\n    queueId: entry.queueId,\n    requestedAt: entry.requestedAt,\n    txId: tx.id,\n    status: tx.status,\n    chainId: tx.request.chainId,\n    to: tx.request.to,\n    value: tx.request.value,\n    policyCount: tx.policyResults.length,\n  };\n}\n\n/** Map a native tx record to the presentational history row shape. */\nexport function toStewardHistoryRow(\n  record: StewardTxRecord,\n): StewardHistoryRow {\n  return {\n    id: record.id,\n    createdAt: record.createdAt,\n    status: record.status,\n    chainId: record.request.chainId,\n    to: record.request.to,\n    value: record.request.value,\n    txHash: record.txHash,\n  };\n}\n\nexport interface StewardSpatialViewProps {\n  snapshot: StewardSnapshot;\n  /**\n   * Dispatch by agent id: `tab:approvals`, `tab:history`, `refresh`,\n   * `approve:<queueId>`, `reject:<queueId>`, `copy:<value>`,\n   * `filter-status`, `filter-chain`, `page-prev`, `page-next`.\n   *\n   * `copy:<value>` carries the literal string to copy to the clipboard (the\n   * recipient address for both approval and history rows).\n   */\n  onAction?: (action: string) => void;\n}\n\nfunction StatusLine({ label, value }: { label: string; value: string }) {\n  return (\n    <HStack gap={1} align=\"center\">\n      <Text style=\"caption\" tone=\"muted\">\n        {label}\n      </Text>\n      <Text style=\"caption\" grow={1} wrap={false}>\n        {value}\n      </Text>\n    </HStack>\n  );\n}\n\nfunction ApprovalsBody({\n  snapshot,\n  dispatch,\n}: {\n  snapshot: StewardSnapshot;\n  dispatch: (action: string) => () => void;\n}) {\n  return (\n    <VStack gap={1} width=\"100%\">\n      <StatusLine\n        label=\"configured\"\n        value={snapshot.configured ? \"yes\" : \"no\"}\n      />\n      <StatusLine label=\"available\" value={snapshot.available ? \"yes\" : \"no\"} />\n      <StatusLine label=\"evm\" value={shortAddress(snapshot.evmAddress)} />\n\n      {!snapshot.connected && !snapshot.loading ? (\n        <Text tone=\"muted\" style=\"caption\" wrap>\n          Set STEWARD_API_URL and STEWARD_API_KEY to enable vault approvals.\n        </Text>\n      ) : null}\n\n      <Divider label=\"pending approvals\" />\n      {snapshot.pendingApprovals.length === 0 ? (\n        <Text tone=\"muted\" align=\"center\" style=\"caption\">\n          {snapshot.loading ? \"Loading\" : \"None\"}\n        </Text>\n      ) : (\n        <List gap={1} width=\"100%\">\n          {snapshot.pendingApprovals.map((item) => (\n            <VStack\n              key={item.queueId}\n              gap={0}\n              width=\"100%\"\n              agent={`approval-${item.queueId}`}\n            >\n              <HStack gap={1} align=\"center\" width=\"100%\">\n                <Text bold grow={1} wrap={false}>\n                  {item.txId}\n                </Text>\n                <Text style=\"caption\" tone={statusTone(item.status)}>\n                  {item.status}\n                </Text>\n              </HStack>\n              <HStack gap={1} align=\"center\" width=\"100%\">\n                <Text style=\"caption\" tone=\"muted\" grow={1} wrap={false}>\n                  chain {item.chainId} to {item.to}\n                </Text>\n                <Button\n                  variant=\"ghost\"\n                  tone=\"default\"\n                  agent={`copy-${item.queueId}`}\n                  onPress={dispatch(`copy:${item.to}`)}\n                >\n                  Copy\n                </Button>\n              </HStack>\n              <Text style=\"caption\" tone=\"muted\" wrap={false}>\n                value {item.value} | {item.policyCount} policy\n              </Text>\n              <HStack gap={1} width=\"100%\">\n                <Button\n                  tone=\"primary\"\n                  grow={1}\n                  agent={`approve-${item.queueId}`}\n                  onPress={dispatch(`approve:${item.queueId}`)}\n                >\n                  Approve\n                </Button>\n                <Button\n                  variant=\"outline\"\n                  tone=\"danger\"\n                  grow={1}\n                  agent={`reject-${item.queueId}`}\n                  onPress={dispatch(`reject:${item.queueId}`)}\n                >\n                  Reject\n                </Button>\n              </HStack>\n            </VStack>\n          ))}\n        </List>\n      )}\n    </VStack>\n  );\n}\n\nfunction HistoryBody({\n  snapshot,\n  dispatch,\n}: {\n  snapshot: StewardSnapshot;\n  dispatch: (action: string) => () => void;\n}) {\n  const pageSize = snapshot.pageSize || PAGE_SIZE;\n  const totalPages = Math.max(1, Math.ceil(snapshot.historyTotal / pageSize));\n  const pageLabel = `page ${snapshot.page + 1}/${totalPages}`;\n  return (\n    <VStack gap={1} width=\"100%\">\n      <HStack gap={1} align=\"center\" width=\"100%\">\n        <Text style=\"caption\" tone=\"muted\" grow={1}>\n          {snapshot.historyTotal} records\n        </Text>\n        <Button\n          variant=\"outline\"\n          tone=\"default\"\n          agent=\"filter-status\"\n          onPress={dispatch(\"filter-status\")}\n        >\n          status: {snapshot.statusFilter ?? \"all\"}\n        </Button>\n        <Button\n          variant=\"outline\"\n          tone=\"default\"\n          agent=\"filter-chain\"\n          onPress={dispatch(\"filter-chain\")}\n        >\n          chain: {snapshot.chainFilter ?? \"all\"}\n        </Button>\n      </HStack>\n\n      <Divider label=\"transaction history\" />\n      {snapshot.history.length === 0 ? (\n        <Text tone=\"muted\" align=\"center\" style=\"caption\">\n          {snapshot.loading ? \"Loading\" : \"None\"}\n        </Text>\n      ) : (\n        <List gap={1} width=\"100%\">\n          {snapshot.history.map((tx) => (\n            <VStack key={tx.id} gap={0} width=\"100%\" agent={`tx-${tx.id}`}>\n              <HStack gap={1} align=\"center\" width=\"100%\">\n                <Text bold grow={1} wrap={false}>\n                  {tx.id}\n                </Text>\n                <Text style=\"caption\" tone={statusTone(tx.status)}>\n                  {tx.status}\n                </Text>\n                <Button\n                  variant=\"ghost\"\n                  tone=\"default\"\n                  agent={`copy-${tx.id}`}\n                  onPress={dispatch(`copy:${tx.to}`)}\n                >\n                  Copy\n                </Button>\n              </HStack>\n              <Text style=\"caption\" tone=\"muted\" wrap={false}>\n                chain {tx.chainId} to {tx.to}\n              </Text>\n              {tx.txHash ? (\n                <Text style=\"caption\" tone=\"muted\" wrap={false}>\n                  hash {tx.txHash}\n                </Text>\n              ) : null}\n            </VStack>\n          ))}\n        </List>\n      )}\n\n      <HStack gap={1} align=\"center\" width=\"100%\">\n        <Button\n          variant=\"outline\"\n          tone=\"default\"\n          disabled={snapshot.page <= 0}\n          agent=\"page-prev\"\n          onPress={dispatch(\"page-prev\")}\n        >\n          Prev\n        </Button>\n        <Text style=\"caption\" tone=\"muted\" align=\"center\" grow={1}>\n          {pageLabel}\n        </Text>\n        <Button\n          variant=\"outline\"\n          tone=\"default\"\n          disabled={snapshot.page + 1 >= totalPages}\n          agent=\"page-next\"\n          onPress={dispatch(\"page-next\")}\n        >\n          Next\n        </Button>\n      </HStack>\n    </VStack>\n  );\n}\n\nexport function StewardSpatialView({\n  snapshot,\n  onAction,\n}: StewardSpatialViewProps) {\n  const dispatch = (action: string) => () => onAction?.(action);\n  const title = snapshot.tab === \"approvals\" ? \"Approvals\" : \"History\";\n  return (\n    <Card gap={1} padding={1}>\n      <HStack gap={1} align=\"center\" width=\"100%\">\n        <Text\n          style=\"caption\"\n          tone={snapshot.connected ? \"success\" : \"danger\"}\n          grow={1}\n        >\n          {snapshot.connected ? \"connected\" : \"not-connected\"}\n        </Text>\n        <Text style=\"caption\" tone=\"muted\">\n          {shortAddress(snapshot.evmAddress)}\n        </Text>\n      </HStack>\n\n      {snapshot.error ? (\n        <Text tone=\"danger\" style=\"caption\" wrap>\n          {snapshot.error}\n        </Text>\n      ) : null}\n\n      <HStack gap={1} width=\"100%\" wrap>\n        <Button\n          variant={snapshot.tab === \"approvals\" ? \"solid\" : \"outline\"}\n          tone={snapshot.tab === \"approvals\" ? \"primary\" : \"default\"}\n          grow={1}\n          agent=\"tab-approvals\"\n          onPress={dispatch(\"tab:approvals\")}\n        >\n          Approvals ({snapshot.pendingApprovals.length})\n        </Button>\n        <Button\n          variant={snapshot.tab === \"history\" ? \"solid\" : \"outline\"}\n          tone={snapshot.tab === \"history\" ? \"primary\" : \"default\"}\n          grow={1}\n          agent=\"tab-history\"\n          onPress={dispatch(\"tab:history\")}\n        >\n          History ({snapshot.historyTotal})\n        </Button>\n        <Button\n          variant=\"ghost\"\n          tone=\"default\"\n          agent=\"refresh\"\n          onPress={dispatch(\"refresh\")}\n        >\n          {snapshot.loading ? \"...\" : \"Refresh\"}\n        </Button>\n      </HStack>\n\n      <Divider label={title} />\n\n      {snapshot.tab === \"approvals\" ? (\n        <ApprovalsBody snapshot={snapshot} dispatch={dispatch} />\n      ) : (\n        <HistoryBody snapshot={snapshot} dispatch={dispatch} />\n      )}\n    </Card>\n  );\n}\n"],"mappings":"AAmJI,SACE,KADF;AArIJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AAoDP,MAAM,YAAY;AAElB,SAAS,WAAW,QAA6B;AAC/C,UAAQ,QAAQ;AAAA,IACd,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,aAAa,OAA0C;AAC9D,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAM,UAAU,GAAI,QAAO;AAC/B,SAAO,GAAG,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM,MAAM,EAAE,CAAC;AACjD;AAGO,SAAS,qBACd,OACoB;AACpB,QAAM,KAAK,MAAM;AACjB,SAAO;AAAA,IACL,SAAS,MAAM;AAAA,IACf,aAAa,MAAM;AAAA,IACnB,MAAM,GAAG;AAAA,IACT,QAAQ,GAAG;AAAA,IACX,SAAS,GAAG,QAAQ;AAAA,IACpB,IAAI,GAAG,QAAQ;AAAA,IACf,OAAO,GAAG,QAAQ;AAAA,IAClB,aAAa,GAAG,cAAc;AAAA,EAChC;AACF;AAGO,SAAS,oBACd,QACmB;AACnB,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,WAAW,OAAO;AAAA,IAClB,QAAQ,OAAO;AAAA,IACf,SAAS,OAAO,QAAQ;AAAA,IACxB,IAAI,OAAO,QAAQ;AAAA,IACnB,OAAO,OAAO,QAAQ;AAAA,IACtB,QAAQ,OAAO;AAAA,EACjB;AACF;AAeA,SAAS,WAAW,EAAE,OAAO,MAAM,GAAqC;AACtE,SACE,qBAAC,UAAO,KAAK,GAAG,OAAM,UACpB;AAAA,wBAAC,QAAK,OAAM,WAAU,MAAK,SACxB,iBACH;AAAA,IACA,oBAAC,QAAK,OAAM,WAAU,MAAM,GAAG,MAAM,OAClC,iBACH;AAAA,KACF;AAEJ;AAEA,SAAS,cAAc;AAAA,EACrB;AAAA,EACA;AACF,GAGG;AACD,SACE,qBAAC,UAAO,KAAK,GAAG,OAAM,QACpB;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,OAAM;AAAA,QACN,OAAO,SAAS,aAAa,QAAQ;AAAA;AAAA,IACvC;AAAA,IACA,oBAAC,cAAW,OAAM,aAAY,OAAO,SAAS,YAAY,QAAQ,MAAM;AAAA,IACxE,oBAAC,cAAW,OAAM,OAAM,OAAO,aAAa,SAAS,UAAU,GAAG;AAAA,IAEjE,CAAC,SAAS,aAAa,CAAC,SAAS,UAChC,oBAAC,QAAK,MAAK,SAAQ,OAAM,WAAU,MAAI,MAAC,gFAExC,IACE;AAAA,IAEJ,oBAAC,WAAQ,OAAM,qBAAoB;AAAA,IAClC,SAAS,iBAAiB,WAAW,IACpC,oBAAC,QAAK,MAAK,SAAQ,OAAM,UAAS,OAAM,WACrC,mBAAS,UAAU,YAAY,QAClC,IAEA,oBAAC,QAAK,KAAK,GAAG,OAAM,QACjB,mBAAS,iBAAiB,IAAI,CAAC,SAC9B;AAAA,MAAC;AAAA;AAAA,QAEC,KAAK;AAAA,QACL,OAAM;AAAA,QACN,OAAO,YAAY,KAAK,OAAO;AAAA,QAE/B;AAAA,+BAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA,gCAAC,QAAK,MAAI,MAAC,MAAM,GAAG,MAAM,OACvB,eAAK,MACR;AAAA,YACA,oBAAC,QAAK,OAAM,WAAU,MAAM,WAAW,KAAK,MAAM,GAC/C,eAAK,QACR;AAAA,aACF;AAAA,UACA,qBAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA,iCAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,MAAM,GAAG,MAAM,OAAO;AAAA;AAAA,cAChD,KAAK;AAAA,cAAQ;AAAA,cAAK,KAAK;AAAA,eAChC;AAAA,YACA;AAAA,cAAC;AAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,OAAO,QAAQ,KAAK,OAAO;AAAA,gBAC3B,SAAS,SAAS,QAAQ,KAAK,EAAE,EAAE;AAAA,gBACpC;AAAA;AAAA,YAED;AAAA,aACF;AAAA,UACA,qBAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,MAAM,OAAO;AAAA;AAAA,YACvC,KAAK;AAAA,YAAM;AAAA,YAAI,KAAK;AAAA,YAAY;AAAA,aACzC;AAAA,UACA,qBAAC,UAAO,KAAK,GAAG,OAAM,QACpB;AAAA;AAAA,cAAC;AAAA;AAAA,gBACC,MAAK;AAAA,gBACL,MAAM;AAAA,gBACN,OAAO,WAAW,KAAK,OAAO;AAAA,gBAC9B,SAAS,SAAS,WAAW,KAAK,OAAO,EAAE;AAAA,gBAC5C;AAAA;AAAA,YAED;AAAA,YACA;AAAA,cAAC;AAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,MAAM;AAAA,gBACN,OAAO,UAAU,KAAK,OAAO;AAAA,gBAC7B,SAAS,SAAS,UAAU,KAAK,OAAO,EAAE;AAAA,gBAC3C;AAAA;AAAA,YAED;AAAA,aACF;AAAA;AAAA;AAAA,MA/CK,KAAK;AAAA,IAgDZ,CACD,GACH;AAAA,KAEJ;AAEJ;AAEA,SAAS,YAAY;AAAA,EACnB;AAAA,EACA;AACF,GAGG;AACD,QAAM,WAAW,SAAS,YAAY;AACtC,QAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,SAAS,eAAe,QAAQ,CAAC;AAC1E,QAAM,YAAY,QAAQ,SAAS,OAAO,CAAC,IAAI,UAAU;AACzD,SACE,qBAAC,UAAO,KAAK,GAAG,OAAM,QACpB;AAAA,yBAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA,2BAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,MAAM,GACtC;AAAA,iBAAS;AAAA,QAAa;AAAA,SACzB;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,OAAM;AAAA,UACN,SAAS,SAAS,eAAe;AAAA,UAClC;AAAA;AAAA,YACU,SAAS,gBAAgB;AAAA;AAAA;AAAA,MACpC;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,OAAM;AAAA,UACN,SAAS,SAAS,cAAc;AAAA,UACjC;AAAA;AAAA,YACS,SAAS,eAAe;AAAA;AAAA;AAAA,MAClC;AAAA,OACF;AAAA,IAEA,oBAAC,WAAQ,OAAM,uBAAsB;AAAA,IACpC,SAAS,QAAQ,WAAW,IAC3B,oBAAC,QAAK,MAAK,SAAQ,OAAM,UAAS,OAAM,WACrC,mBAAS,UAAU,YAAY,QAClC,IAEA,oBAAC,QAAK,KAAK,GAAG,OAAM,QACjB,mBAAS,QAAQ,IAAI,CAAC,OACrB,qBAAC,UAAmB,KAAK,GAAG,OAAM,QAAO,OAAO,MAAM,GAAG,EAAE,IACzD;AAAA,2BAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA,4BAAC,QAAK,MAAI,MAAC,MAAM,GAAG,MAAM,OACvB,aAAG,IACN;AAAA,QACA,oBAAC,QAAK,OAAM,WAAU,MAAM,WAAW,GAAG,MAAM,GAC7C,aAAG,QACN;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,OAAO,QAAQ,GAAG,EAAE;AAAA,YACpB,SAAS,SAAS,QAAQ,GAAG,EAAE,EAAE;AAAA,YAClC;AAAA;AAAA,QAED;AAAA,SACF;AAAA,MACA,qBAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,MAAM,OAAO;AAAA;AAAA,QACvC,GAAG;AAAA,QAAQ;AAAA,QAAK,GAAG;AAAA,SAC5B;AAAA,MACC,GAAG,SACF,qBAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,MAAM,OAAO;AAAA;AAAA,QACxC,GAAG;AAAA,SACX,IACE;AAAA,SAxBO,GAAG,EAyBhB,CACD,GACH;AAAA,IAGF,qBAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,UAAU,SAAS,QAAQ;AAAA,UAC3B,OAAM;AAAA,UACN,SAAS,SAAS,WAAW;AAAA,UAC9B;AAAA;AAAA,MAED;AAAA,MACA,oBAAC,QAAK,OAAM,WAAU,MAAK,SAAQ,OAAM,UAAS,MAAM,GACrD,qBACH;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,UAAU,SAAS,OAAO,KAAK;AAAA,UAC/B,OAAM;AAAA,UACN,SAAS,SAAS,WAAW;AAAA,UAC9B;AAAA;AAAA,MAED;AAAA,OACF;AAAA,KACF;AAEJ;AAEO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAA4B;AAC1B,QAAM,WAAW,CAAC,WAAmB,MAAM,WAAW,MAAM;AAC5D,QAAM,QAAQ,SAAS,QAAQ,cAAc,cAAc;AAC3D,SACE,qBAAC,QAAK,KAAK,GAAG,SAAS,GACrB;AAAA,yBAAC,UAAO,KAAK,GAAG,OAAM,UAAS,OAAM,QACnC;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,OAAM;AAAA,UACN,MAAM,SAAS,YAAY,YAAY;AAAA,UACvC,MAAM;AAAA,UAEL,mBAAS,YAAY,cAAc;AAAA;AAAA,MACtC;AAAA,MACA,oBAAC,QAAK,OAAM,WAAU,MAAK,SACxB,uBAAa,SAAS,UAAU,GACnC;AAAA,OACF;AAAA,IAEC,SAAS,QACR,oBAAC,QAAK,MAAK,UAAS,OAAM,WAAU,MAAI,MACrC,mBAAS,OACZ,IACE;AAAA,IAEJ,qBAAC,UAAO,KAAK,GAAG,OAAM,QAAO,MAAI,MAC/B;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,SAAS,SAAS,QAAQ,cAAc,UAAU;AAAA,UAClD,MAAM,SAAS,QAAQ,cAAc,YAAY;AAAA,UACjD,MAAM;AAAA,UACN,OAAM;AAAA,UACN,SAAS,SAAS,eAAe;AAAA,UAClC;AAAA;AAAA,YACa,SAAS,iBAAiB;AAAA,YAAO;AAAA;AAAA;AAAA,MAC/C;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,SAAS,SAAS,QAAQ,YAAY,UAAU;AAAA,UAChD,MAAM,SAAS,QAAQ,YAAY,YAAY;AAAA,UAC/C,MAAM;AAAA,UACN,OAAM;AAAA,UACN,SAAS,SAAS,aAAa;AAAA,UAChC;AAAA;AAAA,YACW,SAAS;AAAA,YAAa;AAAA;AAAA;AAAA,MAClC;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,OAAM;AAAA,UACN,SAAS,SAAS,SAAS;AAAA,UAE1B,mBAAS,UAAU,QAAQ;AAAA;AAAA,MAC9B;AAAA,OACF;AAAA,IAEA,oBAAC,WAAQ,OAAO,OAAO;AAAA,IAEtB,SAAS,QAAQ,cAChB,oBAAC,iBAAc,UAAoB,UAAoB,IAEvD,oBAAC,eAAY,UAAoB,UAAoB;AAAA,KAEzD;AAEJ;","names":[]}