@elizaos/plugin-elizacloud 2.0.0-alpha.8 → 2.0.11-beta.7

package/dist/cloud/cloud-wallet.js

@@ -0,0 +1,362 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/lib/state-paths.ts
+import fs from "node:fs";
+import path from "node:path";
+import {
+  getElizaNamespace,
+  resolveStateDir,
+  resolveUserPath
+} from "@elizaos/core";
+function resolveConfigPath(env = process.env, stateDirPath = resolveStateDir(env)) {
+  const override = env.ELIZA_CONFIG_PATH?.trim();
+  if (override)
+    return resolveUserPath(override);
+  const namespace = getElizaNamespace(env);
+  const primaryPath = path.join(stateDirPath, `${namespace}.json`);
+  if (fs.existsSync(primaryPath))
+    return primaryPath;
+  if (namespace !== "eliza") {
+    const legacyPath = path.join(stateDirPath, "eliza.json");
+    if (fs.existsSync(legacyPath))
+      return legacyPath;
+  }
+  return primaryPath;
+}
+var init_state_paths = () => {};
+
+// src/lib/config-env.ts
+import fs2 from "node:fs/promises";
+import path2 from "node:path";
+function parseConfigEnv(contents) {
+  const lines = contents.length === 0 ? [] : contents.split(/\r?\n/);
+  if (lines.length > 0 && lines[lines.length - 1] === "") {
+    lines.pop();
+  }
+  const index = new Map;
+  for (let i = 0;i < lines.length; i += 1) {
+    const line = lines[i] ?? "";
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+      continue;
+    const eq = line.indexOf("=");
+    if (eq <= 0)
+      continue;
+    const key = line.slice(0, eq).trim();
+    if (KEY_PATTERN.test(key))
+      index.set(key, i);
+  }
+  return { lines, index };
+}
+function serialiseConfigEnv(parsed) {
+  return parsed.lines.length === 0 ? "" : `${parsed.lines.join(`
+`)}
+`;
+}
+function encodeValue(value) {
+  if (value === "")
+    return "";
+  const needsQuoting = /[\s#"'\\]|^\s|\s$/.test(value) || /\n|\r/.test(value);
+  if (!needsQuoting)
+    return value;
+  const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r");
+  return `"${escaped}"`;
+}
+function validateKey(key) {
+  if (!KEY_PATTERN.test(key)) {
+    throw new Error(`persistConfigEnv: invalid key "${key}" - must match /^[A-Z][A-Z0-9_]*$/`);
+  }
+  if (BLOCKED_CONFIG_ENV_KEYS.has(key)) {
+    throw new Error(`persistConfigEnv: key "${key}" is a shell/runtime hijack vector and cannot be written`);
+  }
+}
+async function readIfExists(filePath) {
+  try {
+    return await fs2.readFile(filePath, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return null;
+    throw error;
+  }
+}
+async function writeAtomic(filePath, contents) {
+  const tmpPath = `${filePath}${TMP_SUFFIX}`;
+  const handle = await fs2.open(tmpPath, "w", 384);
+  try {
+    await handle.writeFile(contents, "utf8");
+    await handle.sync();
+  } finally {
+    await handle.close();
+  }
+  await fs2.rename(tmpPath, filePath);
+}
+function serialise(fn) {
+  const next = writeChain.then(fn, fn);
+  writeChain = next.catch(() => {
+    return;
+  });
+  return next;
+}
+function resolveConfigEnvPath(stateDir) {
+  return path2.join(stateDir ?? resolveStateDir(), CONFIG_ENV_FILENAME);
+}
+async function persistConfigEnv(key, value, opts = {}) {
+  validateKey(key);
+  await serialise(async () => {
+    const filePath = resolveConfigEnvPath(opts.stateDir);
+    await fs2.mkdir(path2.dirname(filePath), { recursive: true });
+    const existing = await readIfExists(filePath) ?? "";
+    const parsed = parseConfigEnv(existing);
+    const existingIdx = parsed.index.get(key);
+    const isDelete = value === "";
+    if (isDelete) {
+      if (existingIdx === undefined) {
+        delete process.env[key];
+        return;
+      }
+      parsed.lines.splice(existingIdx, 1);
+    } else {
+      const encoded = `${key}=${encodeValue(value)}`;
+      if (existingIdx === undefined) {
+        parsed.lines.push(encoded);
+      } else {
+        parsed.lines[existingIdx] = encoded;
+      }
+    }
+    if (existing.length > 0) {
+      await fs2.writeFile(`${filePath}${BAK_SUFFIX}`, existing, {
+        encoding: "utf8",
+        mode: 384
+      });
+    }
+    await writeAtomic(filePath, serialiseConfigEnv(parsed));
+    if (isDelete) {
+      delete process.env[key];
+    } else {
+      process.env[key] = value;
+    }
+  });
+}
+var CONFIG_ENV_FILENAME = "config.env", BAK_SUFFIX = ".bak", TMP_SUFFIX = ".tmp", KEY_PATTERN, BLOCKED_CONFIG_ENV_KEYS, writeChain;
+var init_config_env = __esm(() => {
+  init_state_paths();
+  KEY_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+  BLOCKED_CONFIG_ENV_KEYS = new Set([
+    "NODE_OPTIONS",
+    "NODE_EXTRA_CA_CERTS",
+    "NODE_TLS_REJECT_UNAUTHORIZED",
+    "NODE_PATH",
+    "LD_PRELOAD",
+    "LD_LIBRARY_PATH",
+    "DYLD_INSERT_LIBRARIES",
+    "DYLD_LIBRARY_PATH",
+    "DYLD_FRAMEWORK_PATH",
+    "DYLD_FALLBACK_FRAMEWORK_PATH",
+    "DYLD_FALLBACK_LIBRARY_PATH",
+    "PATH",
+    "HOME",
+    "SHELL",
+    "HTTP_PROXY",
+    "HTTPS_PROXY",
+    "ALL_PROXY",
+    "NO_PROXY",
+    "SSL_CERT_FILE",
+    "SSL_CERT_DIR",
+    "CURL_CA_BUNDLE"
+  ]);
+  writeChain = Promise.resolve();
+});
+
+// src/lib/feature-flags.ts
+function readBoolFlag(name, fallback = false) {
+  const raw = process.env[name];
+  if (raw === undefined || raw === null || raw === "")
+    return fallback;
+  const trimmed = String(raw).trim().toLowerCase();
+  if (trimmed === "1" || trimmed === "true" || trimmed === "yes" || trimmed === "on") {
+    return true;
+  }
+  if (trimmed === "0" || trimmed === "false" || trimmed === "no" || trimmed === "off") {
+    return false;
+  }
+  return fallback;
+}
+function isCloudWalletEnabled() {
+  return readBoolFlag("ENABLE_CLOUD_WALLET");
+}
+
+// src/cloud/cloud-wallet.ts
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+function ensureFlag() {
+  if (!isCloudWalletEnabled()) {
+    throw new CloudWalletFlagDisabledError;
+  }
+}
+function normalizePrivateKey(raw) {
+  const trimmed = raw.trim();
+  const hex = trimmed.startsWith("0x") ? trimmed.slice(2) : trimmed;
+  if (!/^[0-9a-fA-F]{64}$/.test(hex)) {
+    throw new Error(`Malformed ${ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV}: expected 32-byte hex`);
+  }
+  return `0x${hex.toLowerCase()}`;
+}
+async function getOrCreateClientAddressKey(opts = {}) {
+  ensureFlag();
+  const existing = process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV];
+  if (existing && existing.trim().length > 0) {
+    const privateKey2 = normalizePrivateKey(existing);
+    const account2 = privateKeyToAccount(privateKey2);
+    return { privateKey: privateKey2, address: account2.address, minted: false };
+  }
+  const privateKey = generatePrivateKey();
+  const account = privateKeyToAccount(privateKey);
+  process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV] = privateKey;
+  await persistConfigEnv(ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV, privateKey, {
+    stateDir: opts.stateDir
+  });
+  return { privateKey, address: account.address, minted: true };
+}
+function inflightKey(agentId, chain) {
+  return `${agentId}::${chain}`;
+}
+async function provisionOne(bridge, agentId, chain, clientAddress) {
+  try {
+    return await bridge.getAgentWallet(agentId, chain);
+  } catch (error) {
+    if (!isMissingCloudWalletError(error, chain)) {
+      throw error;
+    }
+  }
+  const provisioned = await bridge.provisionWallet({
+    chainType: chain,
+    clientAddress
+  });
+  return {
+    agentWalletId: provisioned.walletId,
+    walletAddress: provisioned.address,
+    walletProvider: provisioned.provider,
+    chainType: chain
+  };
+}
+function isMissingCloudWalletError(error, chain) {
+  if (error instanceof Error && new RegExp(`no cloud ${chain} wallet provisioned`, "i").test(error.message)) {
+    return true;
+  }
+  return typeof error === "object" && error !== null && "name" in error && error.name === "CloudBridgeError" && typeof error.status === "number" && error.status === 404;
+}
+function formatProvisionWarning(chain, error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return `Cloud ${chain} wallet import failed: ${message}`;
+}
+async function provisionCloudWalletsBestEffort(bridge, opts) {
+  ensureFlag();
+  const chains = opts.chains ?? ["evm", "solana"];
+  const results = await Promise.all(chains.map((chain) => {
+    const key = inflightKey(opts.agentId, chain);
+    const pending = inflight.get(key);
+    if (pending) {
+      return pending.then((descriptor) => ({
+        chain,
+        ok: true,
+        descriptor
+      }), (error) => ({
+        chain,
+        ok: false,
+        error
+      }));
+    }
+    const p = provisionOne(bridge, opts.agentId, chain, opts.clientAddress).finally(() => {
+      inflight.delete(key);
+    });
+    inflight.set(key, p);
+    return p.then((descriptor) => ({
+      chain,
+      ok: true,
+      descriptor
+    }), (error) => ({
+      chain,
+      ok: false,
+      error
+    }));
+  }));
+  const out = {};
+  const failures = [];
+  for (const result of results) {
+    if ("descriptor" in result) {
+      out[result.chain] = result.descriptor;
+      continue;
+    }
+    failures.push({ chain: result.chain, error: result.error });
+  }
+  return {
+    descriptors: out,
+    failures,
+    warnings: failures.map(({ chain, error }) => formatProvisionWarning(chain, error))
+  };
+}
+async function provisionCloudWallets(bridge, opts) {
+  const result = await provisionCloudWalletsBestEffort(bridge, opts);
+  if (result.failures.length > 0 && Object.keys(result.descriptors).length === 0) {
+    const firstFailure = result.failures[0];
+    if (firstFailure?.error instanceof Error) {
+      throw firstFailure.error;
+    }
+    throw new Error(result.warnings[0] ?? "Failed to provision cloud wallets");
+  }
+  return result.descriptors;
+}
+function persistCloudWalletCache(config, descriptors) {
+  ensureFlag();
+  const wallet = config.wallet ?? {};
+  const cloud = { ...wallet.cloud ?? {} };
+  if (descriptors.evm)
+    cloud.evm = descriptors.evm;
+  if (descriptors.solana)
+    cloud.solana = descriptors.solana;
+  wallet.cloud = cloud;
+  config.wallet = wallet;
+}
+function __resetCloudWalletModuleForTests() {
+  inflight.clear();
+  delete process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV];
+}
+var ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV = "ELIZA_CLOUD_CLIENT_ADDRESS_KEY", CloudWalletFlagDisabledError, inflight;
+var init_cloud_wallet = __esm(() => {
+  init_config_env();
+  CloudWalletFlagDisabledError = class CloudWalletFlagDisabledError extends Error {
+    constructor() {
+      super("ENABLE_CLOUD_WALLET is off; cloud wallet code paths are inactive");
+      this.name = "CloudWalletFlagDisabledError";
+    }
+  };
+  inflight = new Map;
+});
+init_cloud_wallet();
+
+export {
+  provisionCloudWalletsBestEffort,
+  provisionCloudWallets,
+  persistCloudWalletCache,
+  getOrCreateClientAddressKey,
+  __resetCloudWalletModuleForTests,
+  ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV,
+  CloudWalletFlagDisabledError
+};
+
+//# debugId=B0EB8E1A353E263464756E2164756E21

package/dist/cloud/cloud-wallet.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/state-paths.ts", "../src/lib/config-env.ts", "../src/lib/feature-flags.ts", "../src/cloud/cloud-wallet.ts"],
+  "sourcesContent": [
+    "import fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  getElizaNamespace,\n  resolveStateDir,\n  resolveUserPath,\n} from \"@elizaos/core\";\n\nexport { getElizaNamespace, resolveStateDir, resolveUserPath };\n\nexport function resolveConfigPath(\n  env: NodeJS.ProcessEnv = process.env,\n  stateDirPath: string = resolveStateDir(env),\n): string {\n  const override = env.ELIZA_CONFIG_PATH?.trim();\n  if (override) return resolveUserPath(override);\n\n  const namespace = getElizaNamespace(env);\n  const primaryPath = path.join(stateDirPath, `${namespace}.json`);\n  if (fs.existsSync(primaryPath)) return primaryPath;\n\n  if (namespace !== \"eliza\") {\n    const legacyPath = path.join(stateDirPath, \"eliza.json\");\n    if (fs.existsSync(legacyPath)) return legacyPath;\n  }\n\n  return primaryPath;\n}\n",
+    "import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { resolveStateDir } from \"./state-paths\";\n\nconst CONFIG_ENV_FILENAME = \"config.env\";\nconst BAK_SUFFIX = \".bak\";\nconst TMP_SUFFIX = \".tmp\";\nconst KEY_PATTERN = /^[A-Z][A-Z0-9_]*$/;\n\nconst BLOCKED_CONFIG_ENV_KEYS: ReadonlySet<string> = new Set([\n  \"NODE_OPTIONS\",\n  \"NODE_EXTRA_CA_CERTS\",\n  \"NODE_TLS_REJECT_UNAUTHORIZED\",\n  \"NODE_PATH\",\n  \"LD_PRELOAD\",\n  \"LD_LIBRARY_PATH\",\n  \"DYLD_INSERT_LIBRARIES\",\n  \"DYLD_LIBRARY_PATH\",\n  \"DYLD_FRAMEWORK_PATH\",\n  \"DYLD_FALLBACK_FRAMEWORK_PATH\",\n  \"DYLD_FALLBACK_LIBRARY_PATH\",\n  \"PATH\",\n  \"HOME\",\n  \"SHELL\",\n  \"HTTP_PROXY\",\n  \"HTTPS_PROXY\",\n  \"ALL_PROXY\",\n  \"NO_PROXY\",\n  \"SSL_CERT_FILE\",\n  \"SSL_CERT_DIR\",\n  \"CURL_CA_BUNDLE\",\n]);\n\nexport interface PersistConfigEnvOptions {\n  stateDir?: string;\n}\n\ninterface ParsedConfigEnv {\n  lines: string[];\n  index: Map<string, number>;\n}\n\nfunction parseConfigEnv(contents: string): ParsedConfigEnv {\n  const lines = contents.length === 0 ? [] : contents.split(/\\r?\\n/);\n  if (lines.length > 0 && lines[lines.length - 1] === \"\") {\n    lines.pop();\n  }\n  const index = new Map<string, number>();\n  for (let i = 0; i < lines.length; i += 1) {\n    const line = lines[i] ?? \"\";\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith(\"#\")) continue;\n    const eq = line.indexOf(\"=\");\n    if (eq <= 0) continue;\n    const key = line.slice(0, eq).trim();\n    if (KEY_PATTERN.test(key)) index.set(key, i);\n  }\n  return { lines, index };\n}\n\nfunction serialiseConfigEnv(parsed: ParsedConfigEnv): string {\n  return parsed.lines.length === 0 ? \"\" : `${parsed.lines.join(\"\\n\")}\\n`;\n}\n\nfunction encodeValue(value: string): string {\n  if (value === \"\") return \"\";\n  const needsQuoting = /[\\s#\"'\\\\]|^\\s|\\s$/.test(value) || /\\n|\\r/.test(value);\n  if (!needsQuoting) return value;\n  const escaped = value\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\");\n  return `\"${escaped}\"`;\n}\n\nfunction validateKey(key: string): void {\n  if (!KEY_PATTERN.test(key)) {\n    throw new Error(\n      `persistConfigEnv: invalid key \"${key}\" - must match /^[A-Z][A-Z0-9_]*$/`,\n    );\n  }\n  if (BLOCKED_CONFIG_ENV_KEYS.has(key)) {\n    throw new Error(\n      `persistConfigEnv: key \"${key}\" is a shell/runtime hijack vector and cannot be written`,\n    );\n  }\n}\n\nasync function readIfExists(filePath: string): Promise<string | null> {\n  try {\n    return await fs.readFile(filePath, \"utf8\");\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\n    throw error;\n  }\n}\n\nasync function writeAtomic(filePath: string, contents: string): Promise<void> {\n  const tmpPath = `${filePath}${TMP_SUFFIX}`;\n  const handle = await fs.open(tmpPath, \"w\", 0o600);\n  try {\n    await handle.writeFile(contents, \"utf8\");\n    await handle.sync();\n  } finally {\n    await handle.close();\n  }\n  await fs.rename(tmpPath, filePath);\n}\n\nlet writeChain: Promise<unknown> = Promise.resolve();\n\nfunction serialise<T>(fn: () => Promise<T>): Promise<T> {\n  const next = writeChain.then(fn, fn);\n  writeChain = next.catch(() => undefined);\n  return next;\n}\n\nfunction resolveConfigEnvPath(stateDir?: string): string {\n  return path.join(stateDir ?? resolveStateDir(), CONFIG_ENV_FILENAME);\n}\n\nexport async function persistConfigEnv(\n  key: string,\n  value: string,\n  opts: PersistConfigEnvOptions = {},\n): Promise<void> {\n  validateKey(key);\n\n  await serialise(async () => {\n    const filePath = resolveConfigEnvPath(opts.stateDir);\n    await fs.mkdir(path.dirname(filePath), { recursive: true });\n\n    const existing = (await readIfExists(filePath)) ?? \"\";\n    const parsed = parseConfigEnv(existing);\n    const existingIdx = parsed.index.get(key);\n    const isDelete = value === \"\";\n\n    if (isDelete) {\n      if (existingIdx === undefined) {\n        delete process.env[key];\n        return;\n      }\n      parsed.lines.splice(existingIdx, 1);\n    } else {\n      const encoded = `${key}=${encodeValue(value)}`;\n      if (existingIdx === undefined) {\n        parsed.lines.push(encoded);\n      } else {\n        parsed.lines[existingIdx] = encoded;\n      }\n    }\n\n    if (existing.length > 0) {\n      await fs.writeFile(`${filePath}${BAK_SUFFIX}`, existing, {\n        encoding: \"utf8\",\n        mode: 0o600,\n      });\n    }\n\n    await writeAtomic(filePath, serialiseConfigEnv(parsed));\n    if (isDelete) {\n      delete process.env[key];\n    } else {\n      process.env[key] = value;\n    }\n  });\n}\n",
+    "function readBoolFlag(name: string, fallback = false): boolean {\n  const raw = process.env[name];\n  if (raw === undefined || raw === null || raw === \"\") return fallback;\n  const trimmed = String(raw).trim().toLowerCase();\n  if (\n    trimmed === \"1\" ||\n    trimmed === \"true\" ||\n    trimmed === \"yes\" ||\n    trimmed === \"on\"\n  ) {\n    return true;\n  }\n  if (\n    trimmed === \"0\" ||\n    trimmed === \"false\" ||\n    trimmed === \"no\" ||\n    trimmed === \"off\"\n  ) {\n    return false;\n  }\n  return fallback;\n}\n\nexport function isCloudWalletEnabled(): boolean {\n  return readBoolFlag(\"ENABLE_CLOUD_WALLET\");\n}\n",
+    "/**\n * Cloud wallet provisioning + client-address key management.\n *\n * Gated by ENABLE_CLOUD_WALLET. Every export short-circuits when the flag\n * is off so no cloud code paths run in legacy builds.\n *\n * Responsibilities:\n *   1. Generate + persist ELIZA_CLOUD_CLIENT_ADDRESS_KEY (the local secp256k1\n *      key whose address ties this install to cloud-custodied wallets).\n *   2. Provision EVM + Solana cloud wallets for an agent, guarded by a\n *      single-flight mutex keyed on (agentId, chainType) to prevent duplicate\n *      provision under concurrent cloud-login triggers.\n *   3. Write the resulting descriptors into the in-memory config under\n *      wallet.cloud.{evm,solana}; caller persists via saveConfig().\n */\n\nimport { generatePrivateKey, privateKeyToAccount } from \"viem/accounts\";\nimport type {\n  CloudBridgeError,\n  CloudChainType,\n  CloudWalletDescriptor,\n  CloudWalletProvider,\n} from \"./bridge-client.js\";\nimport { persistConfigEnv } from \"../lib/config-env\";\nimport { isCloudWalletEnabled } from \"../lib/feature-flags\";\n\nexport const ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV =\n  \"ELIZA_CLOUD_CLIENT_ADDRESS_KEY\";\n\nexport class CloudWalletFlagDisabledError extends Error {\n  constructor() {\n    super(\"ENABLE_CLOUD_WALLET is off; cloud wallet code paths are inactive\");\n    this.name = \"CloudWalletFlagDisabledError\";\n  }\n}\n\nfunction ensureFlag(): void {\n  if (!isCloudWalletEnabled()) {\n    throw new CloudWalletFlagDisabledError();\n  }\n}\n\n/**\n * Normalize a hex private key to the 0x-prefixed form viem expects.\n */\nfunction normalizePrivateKey(raw: string): `0x${string}` {\n  const trimmed = raw.trim();\n  const hex = trimmed.startsWith(\"0x\") ? trimmed.slice(2) : trimmed;\n  if (!/^[0-9a-fA-F]{64}$/.test(hex)) {\n    throw new Error(\n      `Malformed ${ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV}: expected 32-byte hex`,\n    );\n  }\n  return `0x${hex.toLowerCase()}`;\n}\n\nexport interface GetOrCreateKeyOptions {\n  /** Override state dir for config.env persistence. Used by tests. */\n  stateDir?: string;\n}\n\nexport interface CloudWalletProvisionBridge {\n  getAgentWallet(\n    agentId: string,\n    chain: CloudChainType,\n  ): Promise<CloudWalletDescriptor>;\n  provisionWallet(input: {\n    chainType: CloudChainType;\n    clientAddress: string;\n  }): Promise<{\n    walletId: string;\n    address: string;\n    chainType: CloudChainType;\n    provider: CloudWalletProvider;\n  }>;\n}\n\n/**\n * Read or mint the local client-address secp256k1 key.\n *\n * Priority:\n *   1. process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY] — respected as-is.\n *   2. Generate a fresh key, write to `process.env` AND disk (`config.env`)\n *      so it survives restart.\n *\n * The key is in `BLOCKED_STARTUP_ENV_KEYS` so it never syncs into\n * `eliza.json` — `config.env` is the designated disk home for it.\n */\nexport async function getOrCreateClientAddressKey(\n  opts: GetOrCreateKeyOptions = {},\n): Promise<{\n  privateKey: `0x${string}`;\n  address: `0x${string}`;\n  minted: boolean;\n}> {\n  ensureFlag();\n\n  const existing = process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV];\n  if (existing && existing.trim().length > 0) {\n    const privateKey = normalizePrivateKey(existing);\n    const account = privateKeyToAccount(privateKey);\n    return { privateKey, address: account.address, minted: false };\n  }\n\n  const privateKey = generatePrivateKey();\n  const account = privateKeyToAccount(privateKey);\n\n  process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV] = privateKey;\n  await persistConfigEnv(ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV, privateKey, {\n    stateDir: opts.stateDir,\n  });\n\n  return { privateKey, address: account.address, minted: true };\n}\n\n// ---------------------------------------------------------------------------\n// Single-flight provisioning\n// ---------------------------------------------------------------------------\n\nconst inflight = new Map<string, Promise<CloudWalletDescriptor>>();\n\nfunction inflightKey(agentId: string, chain: CloudChainType): string {\n  return `${agentId}::${chain}`;\n}\n\nasync function provisionOne(\n  bridge: CloudWalletProvisionBridge,\n  agentId: string,\n  chain: CloudChainType,\n  clientAddress: string,\n): Promise<CloudWalletDescriptor> {\n  try {\n    return await bridge.getAgentWallet(agentId, chain);\n  } catch (error) {\n    if (!isMissingCloudWalletError(error, chain)) {\n      throw error;\n    }\n  }\n\n  const provisioned = await bridge.provisionWallet({\n    chainType: chain,\n    clientAddress,\n  });\n\n  return {\n    agentWalletId: provisioned.walletId,\n    walletAddress: provisioned.address,\n    walletProvider: provisioned.provider,\n    chainType: chain,\n  };\n}\n\nfunction isMissingCloudWalletError(\n  error: unknown,\n  chain: CloudChainType,\n): boolean {\n  if (\n    error instanceof Error &&\n    new RegExp(`no cloud ${chain} wallet provisioned`, \"i\").test(error.message)\n  ) {\n    return true;\n  }\n\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"name\" in error &&\n    error.name === \"CloudBridgeError\" &&\n    typeof (error as CloudBridgeError).status === \"number\" &&\n    (error as CloudBridgeError).status === 404\n  );\n}\n\nexport interface ProvisionOptions {\n  agentId: string;\n  clientAddress: string;\n  chains?: CloudChainType[];\n}\n\nexport interface CloudWalletDescriptors {\n  evm: CloudWalletDescriptor;\n  solana: CloudWalletDescriptor;\n}\n\nexport interface CloudWalletProvisionFailure {\n  chain: CloudChainType;\n  error: unknown;\n}\n\nexport interface CloudWalletProvisionResult {\n  descriptors: Partial<CloudWalletDescriptors>;\n  failures: CloudWalletProvisionFailure[];\n  warnings: string[];\n}\n\nfunction formatProvisionWarning(chain: CloudChainType, error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return `Cloud ${chain} wallet import failed: ${message}`;\n}\n\n/**\n * Provision EVM + Solana cloud wallets idempotently.\n *\n * Concurrent callers for the same (agentId, chain) share a single in-flight\n * promise so we never send duplicate provision requests.\n */\nexport async function provisionCloudWalletsBestEffort(\n  bridge: CloudWalletProvisionBridge,\n  opts: ProvisionOptions,\n): Promise<CloudWalletProvisionResult> {\n  ensureFlag();\n\n  const chains: CloudChainType[] = opts.chains ?? [\"evm\", \"solana\"];\n\n  const results = await Promise.all(\n    chains.map((chain) => {\n      const key = inflightKey(opts.agentId, chain);\n      const pending = inflight.get(key);\n      if (pending) {\n        return pending.then(\n          (descriptor) =>\n            ({\n              chain,\n              ok: true as const,\n              descriptor,\n            }) as const,\n          (error) =>\n            ({\n              chain,\n              ok: false as const,\n              error,\n            }) as const,\n        );\n      }\n\n      const p = provisionOne(\n        bridge,\n        opts.agentId,\n        chain,\n        opts.clientAddress,\n      ).finally(() => {\n        inflight.delete(key);\n      });\n      inflight.set(key, p);\n      return p.then(\n        (descriptor) =>\n          ({\n            chain,\n            ok: true as const,\n            descriptor,\n          }) as const,\n        (error) =>\n          ({\n            chain,\n            ok: false as const,\n            error,\n          }) as const,\n      );\n    }),\n  );\n\n  const out: Partial<CloudWalletDescriptors> = {};\n  const failures: CloudWalletProvisionFailure[] = [];\n  for (const result of results) {\n    if (\"descriptor\" in result) {\n      out[result.chain] = result.descriptor;\n      continue;\n    }\n    failures.push({ chain: result.chain, error: result.error });\n  }\n\n  return {\n    descriptors: out,\n    failures,\n    warnings: failures.map(({ chain, error }) =>\n      formatProvisionWarning(chain, error),\n    ),\n  };\n}\n\nexport async function provisionCloudWallets(\n  bridge: CloudWalletProvisionBridge,\n  opts: ProvisionOptions,\n): Promise<Partial<CloudWalletDescriptors>> {\n  const result = await provisionCloudWalletsBestEffort(bridge, opts);\n  if (\n    result.failures.length > 0 &&\n    Object.keys(result.descriptors).length === 0\n  ) {\n    const firstFailure = result.failures[0];\n    if (firstFailure?.error instanceof Error) {\n      throw firstFailure.error;\n    }\n    throw new Error(result.warnings[0] ?? \"Failed to provision cloud wallets\");\n  }\n\n  return result.descriptors;\n}\n\n// ---------------------------------------------------------------------------\n// Config cache write\n// ---------------------------------------------------------------------------\n\nexport interface CloudWalletCacheTarget {\n  wallet?: {\n    cloud?: Partial<Record<CloudChainType, CloudWalletDescriptor>>;\n    [k: string]: unknown;\n  };\n  [k: string]: unknown;\n}\n\n/**\n * Write the descriptors into the provided config object under\n * `wallet.cloud.{evm,solana}`. Caller is responsible for persisting\n * (state.saveConfig()).\n */\nexport function persistCloudWalletCache(\n  config: CloudWalletCacheTarget,\n  descriptors: Partial<CloudWalletDescriptors>,\n): void {\n  ensureFlag();\n\n  const wallet = (config.wallet ?? {}) as NonNullable<\n    CloudWalletCacheTarget[\"wallet\"]\n  >;\n  const cloud = { ...(wallet.cloud ?? {}) };\n  if (descriptors.evm) cloud.evm = descriptors.evm;\n  if (descriptors.solana) cloud.solana = descriptors.solana;\n  wallet.cloud = cloud;\n  config.wallet = wallet;\n}\n\n// ---------------------------------------------------------------------------\n// Test hooks\n// ---------------------------------------------------------------------------\n\n/** @internal — exposed for tests to reset state between cases. */\nexport function __resetCloudWalletModuleForTests(): void {\n  inflight.clear();\n  delete process.env[ELIZA_CLOUD_CLIENT_ADDRESS_KEY_ENV];\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,iBAAiB,CAC/B,MAAyB,QAAQ,KACjC,eAAuB,gBAAgB,GAAG,GAClC;AAAA,EACR,MAAM,WAAW,IAAI,mBAAmB,KAAK;AAAA,EAC7C,IAAI;AAAA,IAAU,OAAO,gBAAgB,QAAQ;AAAA,EAE7C,MAAM,YAAY,kBAAkB,GAAG;AAAA,EACvC,MAAM,cAAc,KAAK,KAAK,cAAc,GAAG,gBAAgB;AAAA,EAC/D,IAAI,GAAG,WAAW,WAAW;AAAA,IAAG,OAAO;AAAA,EAEvC,IAAI,cAAc,SAAS;AAAA,IACzB,MAAM,aAAa,KAAK,KAAK,cAAc,YAAY;AAAA,IACvD,IAAI,GAAG,WAAW,UAAU;AAAA,MAAG,OAAO;AAAA,EACxC;AAAA,EAEA,OAAO;AAAA;AAAA;;;AC1BT;AACA;AAyCA,SAAS,cAAc,CAAC,UAAmC;AAAA,EACzD,MAAM,QAAQ,SAAS,WAAW,IAAI,CAAC,IAAI,SAAS,MAAM,OAAO;AAAA,EACjE,IAAI,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,OAAO,IAAI;AAAA,IACtD,MAAM,IAAI;AAAA,EACZ;AAAA,EACA,MAAM,QAAQ,IAAI;AAAA,EAClB,SAAS,IAAI,EAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,IACxC,MAAM,OAAO,MAAM,MAAM;AAAA,IACzB,MAAM,UAAU,KAAK,KAAK;AAAA,IAC1B,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG;AAAA,MAAG;AAAA,IACzC,MAAM,KAAK,KAAK,QAAQ,GAAG;AAAA,IAC3B,IAAI,MAAM;AAAA,MAAG;AAAA,IACb,MAAM,MAAM,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK;AAAA,IACnC,IAAI,YAAY,KAAK,GAAG;AAAA,MAAG,MAAM,IAAI,KAAK,CAAC;AAAA,EAC7C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM;AAAA;AAGxB,SAAS,kBAAkB,CAAC,QAAiC;AAAA,EAC3D,OAAO,OAAO,MAAM,WAAW,IAAI,KAAK,GAAG,OAAO,MAAM,KAAK;AAAA,CAAI;AAAA;AAAA;AAGnE,SAAS,WAAW,CAAC,OAAuB;AAAA,EAC1C,IAAI,UAAU;AAAA,IAAI,OAAO;AAAA,EACzB,MAAM,eAAe,oBAAoB,KAAK,KAAK,KAAK,QAAQ,KAAK,KAAK;AAAA,EAC1E,IAAI,CAAC;AAAA,IAAc,OAAO;AAAA,EAC1B,MAAM,UAAU,MACb,QAAQ,OAAO,MAAM,EACrB,QAAQ,MAAM,MAAK,EACnB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK;AAAA,EACvB,OAAO,IAAI;AAAA;AAGb,SAAS,WAAW,CAAC,KAAmB;AAAA,EACtC,IAAI,CAAC,YAAY,KAAK,GAAG,GAAG;AAAA,IAC1B,MAAM,IAAI,MACR,kCAAkC,uCACpC;AAAA,EACF;AAAA,EACA,IAAI,wBAAwB,IAAI,GAAG,GAAG;AAAA,IACpC,MAAM,IAAI,MACR,0BAA0B,6DAC5B;AAAA,EACF;AAAA;AAGF,eAAe,YAAY,CAAC,UAA0C;AAAA,EACpE,IAAI;AAAA,IACF,OAAO,MAAM,IAAG,SAAS,UAAU,MAAM;AAAA,IACzC,OAAO,OAAO;AAAA,IACd,IAAK,MAAgC,SAAS;AAAA,MAAU,OAAO;AAAA,IAC/D,MAAM;AAAA;AAAA;AAIV,eAAe,WAAW,CAAC,UAAkB,UAAiC;AAAA,EAC5E,MAAM,UAAU,GAAG,WAAW;AAAA,EAC9B,MAAM,SAAS,MAAM,IAAG,KAAK,SAAS,KAAK,GAAK;AAAA,EAChD,IAAI;AAAA,IACF,MAAM,OAAO,UAAU,UAAU,MAAM;AAAA,IACvC,MAAM,OAAO,KAAK;AAAA,YAClB;AAAA,IACA,MAAM,OAAO,MAAM;AAAA;AAAA,EAErB,MAAM,IAAG,OAAO,SAAS,QAAQ;AAAA;AAKnC,SAAS,SAAY,CAAC,IAAkC;AAAA,EACtD,MAAM,OAAO,WAAW,KAAK,IAAI,EAAE;AAAA,EACnC,aAAa,KAAK,MAAM,MAAG;AAAA,IAAG;AAAA,GAAS;AAAA,EACvC,OAAO;AAAA;AAGT,SAAS,oBAAoB,CAAC,UAA2B;AAAA,EACvD,OAAO,MAAK,KAAK,YAAY,gBAAgB,GAAG,mBAAmB;AAAA;AAGrE,eAAsB,gBAAgB,CACpC,KACA,OACA,OAAgC,CAAC,GAClB;AAAA,EACf,YAAY,GAAG;AAAA,EAEf,MAAM,UAAU,YAAY;AAAA,IAC1B,MAAM,WAAW,qBAAqB,KAAK,QAAQ;AAAA,IACnD,MAAM,IAAG,MAAM,MAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAAA,IAE1D,MAAM,WAAY,MAAM,aAAa,QAAQ,KAAM;AAAA,IACnD,MAAM,SAAS,eAAe,QAAQ;AAAA,IACtC,MAAM,cAAc,OAAO,MAAM,IAAI,GAAG;AAAA,IACxC,MAAM,WAAW,UAAU;AAAA,IAE3B,IAAI,UAAU;AAAA,MACZ,IAAI,gBAAgB,WAAW;AAAA,QAC7B,OAAO,QAAQ,IAAI;AAAA,QACnB;AAAA,MACF;AAAA,MACA,OAAO,MAAM,OAAO,aAAa,CAAC;AAAA,IACpC,EAAO;AAAA,MACL,MAAM,UAAU,GAAG,OAAO,YAAY,KAAK;AAAA,MAC3C,IAAI,gBAAgB,WAAW;AAAA,QAC7B,OAAO,MAAM,KAAK,OAAO;AAAA,MAC3B,EAAO;AAAA,QACL,OAAO,MAAM,eAAe;AAAA;AAAA;AAAA,IAIhC,IAAI,SAAS,SAAS,GAAG;AAAA,MACvB,MAAM,IAAG,UAAU,GAAG,WAAW,cAAc,UAAU;AAAA,QACvD,UAAU;AAAA,QACV,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,YAAY,UAAU,mBAAmB,MAAM,CAAC;AAAA,IACtD,IAAI,UAAU;AAAA,MACZ,OAAO,QAAQ,IAAI;AAAA,IACrB,EAAO;AAAA,MACL,QAAQ,IAAI,OAAO;AAAA;AAAA,GAEtB;AAAA;AAAA,IAlKG,sBAAsB,cACtB,aAAa,QACb,aAAa,QACb,aAEA,yBAqGF;AAAA;AAAA,EA5GJ;AAAA,EAKM,cAAc;AAAA,EAEd,0BAA+C,IAAI,IAAI;AAAA,IAC3D;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EA+EG,aAA+B,QAAQ,QAAQ;AAAA;;;AC9GnD,SAAS,YAAY,CAAC,MAAc,WAAW,OAAgB;AAAA,EAC7D,MAAM,MAAM,QAAQ,IAAI;AAAA,EACxB,IAAI,QAAQ,aAAa,QAAQ,QAAQ,QAAQ;AAAA,IAAI,OAAO;AAAA,EAC5D,MAAM,UAAU,OAAO,GAAG,EAAE,KAAK,EAAE,YAAY;AAAA,EAC/C,IACE,YAAY,OACZ,YAAY,UACZ,YAAY,SACZ,YAAY,MACZ;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IACE,YAAY,OACZ,YAAY,WACZ,YAAY,QACZ,YAAY,OACZ;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,oBAAoB,GAAY;AAAA,EAC9C,OAAO,aAAa,qBAAqB;AAAA;;;ACR3C;AAoBA,SAAS,UAAU,GAAS;AAAA,EAC1B,IAAI,CAAC,qBAAqB,GAAG;AAAA,IAC3B,MAAM,IAAI;AAAA,EACZ;AAAA;AAMF,SAAS,mBAAmB,CAAC,KAA4B;AAAA,EACvD,MAAM,UAAU,IAAI,KAAK;AAAA,EACzB,MAAM,MAAM,QAAQ,WAAW,IAAI,IAAI,QAAQ,MAAM,CAAC,IAAI;AAAA,EAC1D,IAAI,CAAC,oBAAoB,KAAK,GAAG,GAAG;AAAA,IAClC,MAAM,IAAI,MACR,aAAa,0DACf;AAAA,EACF;AAAA,EACA,OAAO,KAAK,IAAI,YAAY;AAAA;AAmC9B,eAAsB,2BAA2B,CAC/C,OAA8B,CAAC,GAK9B;AAAA,EACD,WAAW;AAAA,EAEX,MAAM,WAAW,QAAQ,IAAI;AAAA,EAC7B,IAAI,YAAY,SAAS,KAAK,EAAE,SAAS,GAAG;AAAA,IAC1C,MAAM,cAAa,oBAAoB,QAAQ;AAAA,IAC/C,MAAM,WAAU,oBAAoB,WAAU;AAAA,IAC9C,OAAO,EAAE,yBAAY,SAAS,SAAQ,SAAS,QAAQ,MAAM;AAAA,EAC/D;AAAA,EAEA,MAAM,aAAa,mBAAmB;AAAA,EACtC,MAAM,UAAU,oBAAoB,UAAU;AAAA,EAE9C,QAAQ,IAAI,sCAAsC;AAAA,EAClD,MAAM,iBAAiB,oCAAoC,YAAY;AAAA,IACrE,UAAU,KAAK;AAAA,EACjB,CAAC;AAAA,EAED,OAAO,EAAE,YAAY,SAAS,QAAQ,SAAS,QAAQ,KAAK;AAAA;AAS9D,SAAS,WAAW,CAAC,SAAiB,OAA+B;AAAA,EACnE,OAAO,GAAG,YAAY;AAAA;AAGxB,eAAe,YAAY,CACzB,QACA,SACA,OACA,eACgC;AAAA,EAChC,IAAI;AAAA,IACF,OAAO,MAAM,OAAO,eAAe,SAAS,KAAK;AAAA,IACjD,OAAO,OAAO;AAAA,IACd,IAAI,CAAC,0BAA0B,OAAO,KAAK,GAAG;AAAA,MAC5C,MAAM;AAAA,IACR;AAAA;AAAA,EAGF,MAAM,cAAc,MAAM,OAAO,gBAAgB;AAAA,IAC/C,WAAW;AAAA,IACX;AAAA,EACF,CAAC;AAAA,EAED,OAAO;AAAA,IACL,eAAe,YAAY;AAAA,IAC3B,eAAe,YAAY;AAAA,IAC3B,gBAAgB,YAAY;AAAA,IAC5B,WAAW;AAAA,EACb;AAAA;AAGF,SAAS,yBAAyB,CAChC,OACA,OACS;AAAA,EACT,IACE,iBAAiB,SACjB,IAAI,OAAO,YAAY,4BAA4B,GAAG,EAAE,KAAK,MAAM,OAAO,GAC1E;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAEA,OACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,sBACf,OAAQ,MAA2B,WAAW,YAC7C,MAA2B,WAAW;AAAA;AA0B3C,SAAS,sBAAsB,CAAC,OAAuB,OAAwB;AAAA,EAC7E,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,EACrE,OAAO,SAAS,+BAA+B;AAAA;AASjD,eAAsB,+BAA+B,CACnD,QACA,MACqC;AAAA,EACrC,WAAW;AAAA,EAEX,MAAM,SAA2B,KAAK,UAAU,CAAC,OAAO,QAAQ;AAAA,EAEhE,MAAM,UAAU,MAAM,QAAQ,IAC5B,OAAO,IAAI,CAAC,UAAU;AAAA,IACpB,MAAM,MAAM,YAAY,KAAK,SAAS,KAAK;AAAA,IAC3C,MAAM,UAAU,SAAS,IAAI,GAAG;AAAA,IAChC,IAAI,SAAS;AAAA,MACX,OAAO,QAAQ,KACb,CAAC,gBACE;AAAA,QACC;AAAA,QACA,IAAI;AAAA,QACJ;AAAA,MACF,IACF,CAAC,WACE;AAAA,QACC;AAAA,QACA,IAAI;AAAA,QACJ;AAAA,MACF,EACJ;AAAA,IACF;AAAA,IAEA,MAAM,IAAI,aACR,QACA,KAAK,SACL,OACA,KAAK,aACP,EAAE,QAAQ,MAAM;AAAA,MACd,SAAS,OAAO,GAAG;AAAA,KACpB;AAAA,IACD,SAAS,IAAI,KAAK,CAAC;AAAA,IACnB,OAAO,EAAE,KACP,CAAC,gBACE;AAAA,MACC;AAAA,MACA,IAAI;AAAA,MACJ;AAAA,IACF,IACF,CAAC,WACE;AAAA,MACC;AAAA,MACA,IAAI;AAAA,MACJ;AAAA,IACF,EACJ;AAAA,GACD,CACH;AAAA,EAEA,MAAM,MAAuC,CAAC;AAAA,EAC9C,MAAM,WAA0C,CAAC;AAAA,EACjD,WAAW,UAAU,SAAS;AAAA,IAC5B,IAAI,gBAAgB,QAAQ;AAAA,MAC1B,IAAI,OAAO,SAAS,OAAO;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,SAAS,KAAK,EAAE,OAAO,OAAO,OAAO,OAAO,OAAO,MAAM,CAAC;AAAA,EAC5D;AAAA,EAEA,OAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,IACA,UAAU,SAAS,IAAI,GAAG,OAAO,YAC/B,uBAAuB,OAAO,KAAK,CACrC;AAAA,EACF;AAAA;AAGF,eAAsB,qBAAqB,CACzC,QACA,MAC0C;AAAA,EAC1C,MAAM,SAAS,MAAM,gCAAgC,QAAQ,IAAI;AAAA,EACjE,IACE,OAAO,SAAS,SAAS,KACzB,OAAO,KAAK,OAAO,WAAW,EAAE,WAAW,GAC3C;AAAA,IACA,MAAM,eAAe,OAAO,SAAS;AAAA,IACrC,IAAI,cAAc,iBAAiB,OAAO;AAAA,MACxC,MAAM,aAAa;AAAA,IACrB;AAAA,IACA,MAAM,IAAI,MAAM,OAAO,SAAS,MAAM,mCAAmC;AAAA,EAC3E;AAAA,EAEA,OAAO,OAAO;AAAA;AAoBT,SAAS,uBAAuB,CACrC,QACA,aACM;AAAA,EACN,WAAW;AAAA,EAEX,MAAM,SAAU,OAAO,UAAU,CAAC;AAAA,EAGlC,MAAM,QAAQ,KAAM,OAAO,SAAS,CAAC,EAAG;AAAA,EACxC,IAAI,YAAY;AAAA,IAAK,MAAM,MAAM,YAAY;AAAA,EAC7C,IAAI,YAAY;AAAA,IAAQ,MAAM,SAAS,YAAY;AAAA,EACnD,OAAO,QAAQ;AAAA,EACf,OAAO,SAAS;AAAA;AAQX,SAAS,gCAAgC,GAAS;AAAA,EACvD,SAAS,MAAM;AAAA,EACf,OAAO,QAAQ,IAAI;AAAA;AAAA,IAzTR,qCACX,kCAEW,8BA0FP;AAAA;AAAA,EAhGN;AAAA,EAMa,+BAAN,MAAM,qCAAqC,MAAM;AAAA,IACtD,WAAW,GAAG;AAAA,MACZ,MAAM,kEAAkE;AAAA,MACxE,KAAK,OAAO;AAAA;AAAA,EAEhB;AAAA,EAqFM,WAAW,IAAI;AAAA;",
+  "debugId": "B0EB8E1A353E263464756E2164756E21",
+  "names": []
+}

package/dist/cloud/duffel-client.d.ts

@@ -0,0 +1,181 @@
+export declare class DuffelConfigError extends Error {
+    readonly code: "DUFFEL_NOT_CONFIGURED";
+    constructor(message: string);
+}
+/** Direct mode hits api.duffel.com with the user's own DUFFEL_API_KEY.
+ *  Cloud mode hits the local Eliza Cloud relay which performs the upstream
+ *  Duffel call, applies creator markup, and meters against the user's
+ *  Cloud credit balance. Cloud mode is the default. */
+export type DuffelMode = "cloud" | "direct";
+export interface DuffelConfig {
+    mode: DuffelMode;
+    /** Required when mode === "direct". */
+    apiKey: string | null;
+    /** Required when mode === "cloud". Local Eliza agent API base, e.g.
+     *  http://127.0.0.1:31337. The relay path is appended internally. */
+    cloudRelayBaseUrl: string | null;
+}
+export declare function readDuffelConfigFromEnv(env?: NodeJS.ProcessEnv): DuffelConfig;
+export interface SearchFlightsRequest {
+    /** IATA airport code for origin, e.g. "JFK". */
+    origin: string;
+    /** IATA airport code for destination, e.g. "LHR". */
+    destination: string;
+    /** ISO 8601 date string (YYYY-MM-DD). */
+    departureDate: string;
+    /**
+     * ISO 8601 date string for return leg.
+     * Omit or pass undefined for one-way search.
+     */
+    returnDate?: string;
+    /** Number of adult passengers (default 1). */
+    passengers?: number;
+}
+export interface DuffelSegment {
+    origin: string;
+    destination: string;
+    departingAt: string;
+    arrivingAt: string;
+    carrierIataCode: string;
+    flightNumber: string;
+    duration: string;
+}
+export interface DuffelSlice {
+    origin: string;
+    destination: string;
+    duration: string;
+    segments: DuffelSegment[];
+}
+export interface DuffelOfferPassenger {
+    id: string;
+    type: string;
+    givenName: string | null;
+    familyName: string | null;
+}
+export interface DuffelPaymentRequirements {
+    requiresInstantPayment: boolean;
+    priceGuaranteeExpiresAt: string | null;
+    paymentRequiredBy: string | null;
+}
+export interface DuffelOffer {
+    id: string;
+    totalAmount: string;
+    totalCurrency: string;
+    passengerCount: number;
+    slices: DuffelSlice[];
+    expiresAt: string | null;
+    /** Raw cabin class reported by Duffel for the first slice. */
+    cabinClass: string | null;
+    passengers: DuffelOfferPassenger[];
+    paymentRequirements: DuffelPaymentRequirements | null;
+}
+/**
+ * Cost envelope returned by the cloud relay. The breakdown is computed
+ * server-side (commandment 2 — no client-side math) and the local code
+ * forwards it to the UI for display. In direct mode all values are zero
+ * because no markup is charged.
+ *
+ * `markupPercent` is a *display-only* derived field: it equals
+ * `platformFeeUsd / totalUsd`, computed once at the boundary so UI
+ * components don't repeat the division. The pricing decision itself is
+ * still Cloud-side — this is the same pattern as a "discount %" badge
+ * derived from a server-supplied price.
+ */
+export interface DuffelCallCost {
+    /** Net cost charged to the user's Cloud credit balance, in USD. */
+    totalUsd: number;
+    /** Portion that flows to the creator as markup, in USD. */
+    creatorMarkupUsd: number;
+    /** Eliza Cloud platform fee portion, in USD. */
+    platformFeeUsd: number;
+    /** Display-only ratio of platform fee to total (e.g. 0.2 for 20%).
+     *  Derived from server values, never used for pricing. Null when
+     *  totalUsd is zero (direct mode or free call). */
+    markupPercent: number | null;
+    /** Whether the call was metered (true in cloud mode, false in direct mode). */
+    metered: boolean;
+}
+export interface SearchFlightsResult {
+    offerRequestId: string;
+    offers: DuffelOffer[];
+    cost: DuffelCallCost;
+}
+export interface DuffelOrderPassenger {
+    id: string;
+    givenName: string | null;
+    familyName: string | null;
+}
+export interface DuffelOrderPaymentStatus {
+    awaitingPayment: boolean;
+    paymentRequiredBy: string | null;
+    priceGuaranteeExpiresAt: string | null;
+}
+export interface DuffelOrderDocument {
+    type: string | null;
+    uniqueIdentifier: string | null;
+}
+export interface DuffelOrder {
+    id: string;
+    bookingReference: string | null;
+    totalAmount: string;
+    totalCurrency: string;
+    slices: DuffelSlice[];
+    passengers: DuffelOrderPassenger[];
+    paymentStatus: DuffelOrderPaymentStatus | null;
+    documents: DuffelOrderDocument[];
+}
+export interface DuffelPayment {
+    id: string;
+    orderId: string;
+    status: string;
+    currency: string;
+    amount: string;
+    type: string;
+    failureReason: string | null;
+    createdAt: string | null;
+}
+export interface DuffelOrderPassengerInput {
+    id: string;
+    title?: string;
+    gender?: string;
+    givenName: string;
+    familyName: string;
+    bornOn: string;
+    email?: string;
+    phoneNumber?: string;
+}
+export interface CreateDuffelOrderRequest {
+    selectedOffers: ReadonlyArray<string>;
+    passengers: ReadonlyArray<DuffelOrderPassengerInput>;
+    type: "hold" | "instant";
+    payment?: {
+        type: "balance";
+        amount: string;
+        currency: string;
+    };
+    metadata?: Readonly<Record<string, string>>;
+}
+/**
+ * Search for available flight offers via the Duffel Offer Requests API.
+ *
+ * Throws `DuffelConfigError` when DUFFEL_API_KEY is absent.
+ * One-way search when `returnDate` is omitted; return search when provided.
+ *
+ */
+export declare function searchFlights(request: SearchFlightsRequest, config?: DuffelConfig): Promise<SearchFlightsResult>;
+/**
+ * Retrieve a single flight offer by ID.
+ *
+ * Use after `searchFlights` to get live pricing and full details for a
+ * specific offer before presenting it to the user for approval.
+ *
+ */
+export declare function getOffer(id: string, config?: DuffelConfig): Promise<DuffelOffer>;
+export declare function createOrder(request: CreateDuffelOrderRequest, config?: DuffelConfig): Promise<DuffelOrder>;
+export declare function getOrder(orderId: string, config?: DuffelConfig): Promise<DuffelOrder>;
+export declare function createPayment(args: {
+    orderId: string;
+    amount: string;
+    currency: string;
+}, config?: DuffelConfig): Promise<DuffelPayment>;
+//# sourceMappingURL=duffel-client.d.ts.map

package/dist/cloud/duffel-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duffel-client.d.ts","sourceRoot":"","sources":["../../src/cloud/duffel-client.ts"],"names":[],"mappings":"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"}