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

package/dist/cloud/cloud-manager.js

@@ -0,0 +1,853 @@
+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/cloud/base-url.ts
+function isLoopbackHost(hostname) {
+  const normalized = hostname.toLowerCase();
+  return normalized === "localhost" || normalized === "::1" || normalized === "0:0:0:0:0:0:0:1" || normalized.startsWith("127.");
+}
+function trimApiPath(pathname) {
+  const normalized = pathname.trim().replace(/\/+$/, "");
+  if (!normalized)
+    return "";
+  if (normalized === "/api/v1")
+    return "";
+  if (normalized.endsWith("/api/v1")) {
+    return normalized.slice(0, -"/api/v1".length);
+  }
+  return normalized;
+}
+function normalizeCloudSiteUrl(rawUrl) {
+  const envOverride = process.env.ELIZAOS_CLOUD_BASE_URL?.trim();
+  const candidate = envOverride || rawUrl?.trim() || DEFAULT_CLOUD_SITE_URL;
+  try {
+    const parsed = new URL(candidate);
+    const pathname = trimApiPath(parsed.pathname);
+    const host = parsed.hostname.toLowerCase();
+    const preserveLocalOrigin = isLoopbackHost(host);
+    parsed.hash = "";
+    parsed.search = "";
+    if (!preserveLocalOrigin) {
+      parsed.protocol = "https:";
+      parsed.port = "";
+    }
+    parsed.pathname = pathname;
+    if (LEGACY_CLOUD_HOST_ALIASES.has(host)) {
+      parsed.hostname = "www.elizacloud.ai";
+      parsed.pathname = "";
+    }
+    return parsed.toString().replace(/\/{1,1024}$/, "");
+  } catch {
+    const safeCandidate = candidate.length > 8192 ? candidate.slice(0, 8192) : candidate;
+    return safeCandidate.replace(/\/{1,1024}$/, "");
+  }
+}
+function resolveCloudApiBaseUrl(rawUrl) {
+  return `${normalizeCloudSiteUrl(rawUrl)}/api/v1`;
+}
+var DEFAULT_CLOUD_SITE_URL = "https://www.elizacloud.ai", LEGACY_CLOUD_HOST_ALIASES;
+var init_base_url = __esm(() => {
+  LEGACY_CLOUD_HOST_ALIASES = new Set([
+    "elizacloud.ai",
+    "www.elizacloud.ai"
+  ]);
+});
+
+// src/cloud/validate-url.ts
+import dns from "node:dns";
+import net from "node:net";
+import { promisify } from "node:util";
+function normalizeHostLike(value) {
+  return value.trim().toLowerCase().replace(/^\[|\]$/g, "");
+}
+function decodeIpv6MappedHex(mapped) {
+  const parts = mapped.split(":");
+  if (parts.length < 1 || parts.length > 2)
+    return null;
+  const parsed = parts.map((part) => {
+    if (!/^[0-9a-f]{1,4}$/i.test(part))
+      return Number.NaN;
+    return Number.parseInt(part, 16);
+  });
+  if (parsed.some((value) => !Number.isFinite(value)))
+    return null;
+  const [hi, lo] = parsed.length === 1 ? [0, parsed[0]] : parsed;
+  const octets = [hi >> 8, hi & 255, lo >> 8, lo & 255];
+  return octets.join(".");
+}
+function canonicalizeIpv6(ip) {
+  try {
+    return new URL(`http://[${ip}]/`).hostname.replace(/^\[|\]$/g, "");
+  } catch {
+    return null;
+  }
+}
+function normalizeIpForPolicy(ip) {
+  const base = normalizeHostLike(ip).split("%")[0];
+  if (!base)
+    return base;
+  let normalized = base;
+  if (net.isIP(normalized) === 6) {
+    normalized = canonicalizeIpv6(normalized) ?? normalized;
+  }
+  let mapped = null;
+  if (normalized.startsWith("::ffff:")) {
+    mapped = normalized.slice("::ffff:".length);
+  } else if (normalized.startsWith("0:0:0:0:0:ffff:")) {
+    mapped = normalized.slice("0:0:0:0:0:ffff:".length);
+  }
+  if (!mapped)
+    return normalized;
+  if (net.isIP(mapped) === 4)
+    return mapped;
+  return decodeIpv6MappedHex(mapped) ?? normalized;
+}
+function cidrV4(base, prefix) {
+  const parsed = parseIpv4ToInt(base);
+  if (parsed === null) {
+    throw new Error(`Invalid CIDR base IPv4 address: ${base}`);
+  }
+  const shift = 32 - prefix;
+  const mask = shift === 32 ? 0 : 4294967295 << shift >>> 0;
+  return { base: parsed & mask, mask };
+}
+function parseIpv4ToInt(ip) {
+  const parts = ip.split(".");
+  if (parts.length !== 4)
+    return null;
+  let value = 0;
+  for (const part of parts) {
+    if (!/^\d{1,3}$/.test(part))
+      return null;
+    const octet = Number.parseInt(part, 10);
+    if (!Number.isInteger(octet) || octet < 0 || octet > 255)
+      return null;
+    value = value << 8 | octet;
+  }
+  return value >>> 0;
+}
+function isBlockedIpv4(ip) {
+  const asInt = parseIpv4ToInt(ip);
+  if (asInt === null)
+    return true;
+  return BLOCKED_IPV4_CIDRS.some((cidr) => (asInt & cidr.mask) === cidr.base);
+}
+function isBlockedIpv6(ip) {
+  const normalized = ip.toLowerCase();
+  return normalized === "::" || normalized === "::1" || /^fe[89ab][0-9a-f]:/.test(normalized) || /^f[cd][0-9a-f]{2}:/i.test(normalized) || normalized.startsWith("ff");
+}
+function isBlockedIp(ip) {
+  const normalized = normalizeIpForPolicy(ip);
+  const family = net.isIP(normalized);
+  if (family === 4)
+    return isBlockedIpv4(normalized);
+  if (family === 6)
+    return isBlockedIpv6(normalized);
+  return false;
+}
+async function validateCloudBaseUrl(rawUrl) {
+  let parsed;
+  try {
+    parsed = new URL(rawUrl);
+  } catch {
+    return `Invalid cloud base URL: "${rawUrl}"`;
+  }
+  if (parsed.protocol !== "https:") {
+    return `Cloud base URL must use HTTPS, got "${parsed.protocol}" in "${rawUrl}"`;
+  }
+  const hostname = normalizeHostLike(parsed.hostname);
+  if (!hostname) {
+    return `Invalid cloud base URL: "${rawUrl}"`;
+  }
+  if (hostname === "localhost" || hostname.endsWith(".localhost") || hostname.endsWith(".local")) {
+    return `Cloud base URL "${rawUrl}" points to a blocked local hostname.`;
+  }
+  if (true) {
+    return null;
+  }
+  if (isBlockedIp(hostname)) {
+    return `Cloud base URL "${rawUrl}" points to a blocked address.`;
+  }
+  try {
+    const results = await dnsLookupAll(hostname, { all: true });
+    const addresses = Array.isArray(results) ? results : [results];
+    for (const entry of addresses) {
+      const ip = typeof entry === "string" ? entry : entry.address;
+      if (isBlockedIp(ip)) {
+        return `Cloud base URL "${rawUrl}" resolves to ${ip}, ` + "which is a blocked internal/metadata address.";
+      }
+    }
+  } catch {
+    return `Cloud base URL "${rawUrl}" could not be resolved via DNS.`;
+  }
+  return null;
+}
+var dnsLookupAll, BLOCKED_IPV4_CIDRS;
+var init_validate_url = __esm(() => {
+  dnsLookupAll = promisify(dns.lookup);
+  BLOCKED_IPV4_CIDRS = [
+    cidrV4("0.0.0.0", 8),
+    cidrV4("10.0.0.0", 8),
+    cidrV4("172.16.0.0", 12),
+    cidrV4("192.168.0.0", 16),
+    cidrV4("100.64.0.0", 10),
+    cidrV4("127.0.0.0", 8),
+    cidrV4("169.254.0.0", 16),
+    cidrV4("192.0.0.0", 24),
+    cidrV4("198.18.0.0", 15),
+    cidrV4("192.0.2.0", 24),
+    cidrV4("198.51.100.0", 24),
+    cidrV4("203.0.113.0", 24),
+    cidrV4("224.0.0.0", 4),
+    cidrV4("240.0.0.0", 4)
+  ];
+});
+
+// src/cloud/backup.ts
+import { logger } from "@elizaos/core";
+
+class BackupScheduler {
+  client;
+  agentId;
+  intervalMs;
+  timer = null;
+  running = false;
+  constructor(client, agentId, intervalMs = 60000) {
+    this.client = client;
+    this.agentId = agentId;
+    this.intervalMs = intervalMs;
+  }
+  start() {
+    if (this.timer)
+      return;
+    this.running = true;
+    this.timer = setInterval(() => {
+      this.client.snapshot(this.agentId).catch((err) => {
+        logger.warn(`[cloud-backup] Auto-backup failed: ${String(err)}`);
+      });
+    }, this.intervalMs);
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.running = false;
+  }
+  isRunning() {
+    return this.running;
+  }
+  async finalSnapshot() {
+    await this.client.snapshot(this.agentId).catch((err) => {
+      logger.warn(`[cloud-backup] Final snapshot failed: ${String(err)}`);
+    });
+  }
+}
+
+// src/cloud/bridge-client.ts
+init_base_url();
+
+class CloudBridgeError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "CloudBridgeError";
+  }
+}
+
+class SignatureInvalidError extends CloudBridgeError {
+  constructor(message, body) {
+    super(message, 401, body);
+    this.name = "SignatureInvalidError";
+  }
+}
+
+class NonceReplayError extends CloudBridgeError {
+  constructor(message, body) {
+    super(message, 409, body);
+    this.name = "NonceReplayError";
+  }
+}
+
+class SessionExpiredError extends CloudBridgeError {
+  constructor(message, body) {
+    super(message, 410, body);
+    this.name = "SessionExpiredError";
+  }
+}
+
+class CloudUnavailableError extends CloudBridgeError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "CloudUnavailableError";
+  }
+}
+function formatApiErrorBody(text) {
+  if (!text)
+    return null;
+  try {
+    const parsed = JSON.parse(text);
+    const baseError = typeof parsed.error === "string" && parsed.error.trim().length > 0 ? parsed.error.trim() : null;
+    const details = Array.isArray(parsed.details) ? parsed.details.map((detail) => typeof detail?.message === "string" ? detail.message.trim() : "").filter((message) => message.length > 0) : [];
+    if (baseError && details.length > 0) {
+      return `${baseError}: ${details.join("; ")}`;
+    }
+    if (baseError)
+      return baseError;
+  } catch {}
+  return text.slice(0, 200) || null;
+}
+function isRedirectResponse(response) {
+  return response.status >= 300 && response.status < 400;
+}
+function normalizeChainAddress(addresses, chain) {
+  const value = addresses?.[chain];
+  if (typeof value !== "string")
+    return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function looksLikeChainAddress(address, chain) {
+  if (chain === "evm") {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+  }
+  return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);
+}
+function resolveRequestedWalletAddress(data, chain) {
+  const explicit = normalizeChainAddress(data.walletAddresses, chain);
+  if (explicit)
+    return explicit;
+  if (typeof data.walletAddress !== "string")
+    return null;
+  const trimmed = data.walletAddress.trim();
+  if (!trimmed)
+    return null;
+  return looksLikeChainAddress(trimmed, chain) ? trimmed : null;
+}
+
+class ElizaCloudClient {
+  baseUrl;
+  apiKey;
+  constructor(baseUrl, apiKey) {
+    this.baseUrl = normalizeCloudSiteUrl(baseUrl);
+    this.apiKey = apiKey;
+  }
+  async listAgents() {
+    const res = await this.request("GET", "/api/v1/eliza/agents");
+    return res.data ?? [];
+  }
+  async createAgent(params) {
+    const res = await this.request("POST", "/api/v1/eliza/agents", params);
+    if (!res.success || !res.data)
+      throw new Error(res.error ?? "Failed to create cloud agent");
+    return res.data;
+  }
+  async getAgent(agentId) {
+    const res = await this.request("GET", `/api/v1/eliza/agents/${agentId}`);
+    if (!res.success || !res.data)
+      throw new Error(res.error ?? "Agent not found");
+    return res.data;
+  }
+  async deleteAgent(agentId) {
+    const res = await this.request("DELETE", `/api/v1/eliza/agents/${agentId}`);
+    if (!res.success)
+      throw new Error(res.error ?? "Failed to delete agent");
+  }
+  async provision(agentId) {
+    const res = await this.request("POST", `/api/v1/eliza/agents/${agentId}/provision`);
+    if (!res.success || !res.data)
+      throw new Error(res.error ?? "Failed to provision sandbox");
+    return res.data;
+  }
+  async sendMessage(agentId, text, roomId = "web-chat", channelType = "DM") {
+    const url = `${this.baseUrl}/api/v1/eliza/agents/${agentId}/bridge`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Api-Key": this.apiKey },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "message.send",
+        params: { text, roomId, channelType }
+      }),
+      redirect: "manual",
+      signal: AbortSignal.timeout(60000)
+    });
+    if (isRedirectResponse(response)) {
+      throw new Error("Bridge request was redirected; redirects are not allowed");
+    }
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "");
+      throw new Error(`Bridge request failed: HTTP ${response.status} ${errorText.slice(0, 200)}`);
+    }
+    const rpc = await response.json();
+    if (rpc.error)
+      throw new Error(rpc.error.message);
+    return rpc.result?.text ?? "(no response)";
+  }
+  async* sendMessageStream(agentId, text, roomId = "web-chat", channelType = "DM") {
+    const url = `${this.baseUrl}/api/v1/eliza/agents/${agentId}/stream`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Api-Key": this.apiKey },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "message.send",
+        params: { text, roomId, channelType }
+      }),
+      redirect: "manual"
+    });
+    if (isRedirectResponse(response)) {
+      throw new Error("Stream request was redirected; redirects are not allowed");
+    }
+    if (!response.ok || !response.body) {
+      throw new Error(`Stream request failed: HTTP ${response.status}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder;
+    let buffer = "";
+    for (;; ) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      buffer += decoder.decode(value, { stream: true });
+      const parts = buffer.split(`
+
+`);
+      buffer = parts.pop() ?? "";
+      for (const part of parts) {
+        if (!part.trim())
+          continue;
+        let eventType = "message";
+        let eventData = "";
+        for (const line of part.split(`
+`)) {
+          if (line.startsWith("event: "))
+            eventType = line.slice(7).trim();
+          else if (line.startsWith("data: "))
+            eventData += (eventData ? `
+` : "") + line.slice(6);
+        }
+        if (eventData) {
+          let data;
+          try {
+            data = JSON.parse(eventData);
+          } catch {
+            continue;
+          }
+          yield { type: eventType, data };
+        }
+      }
+    }
+  }
+  async snapshot(agentId) {
+    const res = await this.request("POST", `/api/v1/eliza/agents/${agentId}/snapshot`);
+    if (!res.success || !res.data)
+      throw new Error(res.error ?? "Snapshot failed");
+    return res.data;
+  }
+  async listBackups(agentId) {
+    const res = await this.request("GET", `/api/v1/eliza/agents/${agentId}/backups`);
+    return res.data ?? [];
+  }
+  async restore(agentId, backupId) {
+    const res = await this.request("POST", `/api/v1/eliza/agents/${agentId}/restore`, backupId ? { backupId } : {});
+    if (!res.success)
+      throw new Error(res.error ?? "Restore failed");
+  }
+  async heartbeat(agentId) {
+    const url = `${this.baseUrl}/api/v1/eliza/agents/${agentId}/bridge`;
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Api-Key": this.apiKey
+        },
+        body: JSON.stringify({ jsonrpc: "2.0", method: "heartbeat" }),
+        redirect: "manual",
+        signal: AbortSignal.timeout(1e4)
+      });
+      if (isRedirectResponse(response))
+        return false;
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+  async getAgentWallet(agentId, chain) {
+    const res = await this.request("GET", `/api/v1/eliza/agents/${encodeURIComponent(agentId)}/wallet?chain=${encodeURIComponent(chain)}`);
+    if (!res.success || !res.data) {
+      throw new CloudBridgeError(res.error ?? "Failed to fetch agent wallet");
+    }
+    const data = res.data;
+    const walletAddress = resolveRequestedWalletAddress(data, chain);
+    if (!walletAddress || !data.walletProvider) {
+      throw new CloudBridgeError(`Agent has no cloud ${chain} wallet provisioned`);
+    }
+    return {
+      agentWalletId: data.agentId ?? agentId,
+      walletAddress,
+      walletProvider: data.walletProvider,
+      chainType: chain,
+      balance: data.balance ?? undefined
+    };
+  }
+  async provisionWallet(input) {
+    const res = await this.request("POST", "/api/v1/user/wallets/provision", input);
+    if (!res.success || !res.data) {
+      throw new CloudBridgeError(res.error ?? "Failed to provision wallet");
+    }
+    return {
+      walletId: res.data.id,
+      address: res.data.address,
+      chainType: res.data.chainType,
+      provider: res.data.provider ?? "privy"
+    };
+  }
+  async executeRpc(envelope) {
+    const { correlationId, ...body } = envelope;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (correlationId) {
+      headers["X-Correlation-Id"] = correlationId;
+    }
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}/api/v1/user/wallets/rpc`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        redirect: "manual",
+        signal: AbortSignal.timeout(60000)
+      });
+    } catch (err) {
+      throw new CloudUnavailableError(`Cloud RPC network error: ${err.message}`, 0);
+    }
+    if (isRedirectResponse(response)) {
+      throw new CloudBridgeError("Cloud RPC request was redirected; redirects are not allowed", response.status);
+    }
+    const text = await response.text().catch(() => "");
+    if (response.ok) {
+      try {
+        const parsed = JSON.parse(text);
+        if (!parsed.success || parsed.data === undefined) {
+          throw new CloudBridgeError(parsed.error ?? "Cloud RPC returned no data", response.status, text);
+        }
+        return parsed.data;
+      } catch (err) {
+        if (err instanceof CloudBridgeError)
+          throw err;
+        throw new CloudBridgeError(`Cloud RPC returned malformed JSON: ${err.message}`, response.status, text);
+      }
+    }
+    let errMessage = `HTTP ${response.status}`;
+    try {
+      const parsed = JSON.parse(text);
+      if (parsed.error)
+        errMessage = parsed.error;
+    } catch {
+      if (text)
+        errMessage = text.slice(0, 200);
+    }
+    if (response.status === 401) {
+      throw new SignatureInvalidError(errMessage, text);
+    }
+    if (response.status === 409) {
+      throw new NonceReplayError(errMessage, text);
+    }
+    if (response.status === 410) {
+      throw new SessionExpiredError(errMessage, text);
+    }
+    if (response.status >= 500) {
+      throw new CloudUnavailableError(errMessage, response.status, text);
+    }
+    throw new CloudBridgeError(errMessage, response.status, text);
+  }
+  async request(method, path, body) {
+    const headers = { "X-Api-Key": this.apiKey };
+    if (body !== undefined)
+      headers["Content-Type"] = "application/json";
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+      redirect: "manual",
+      signal: AbortSignal.timeout(30000)
+    });
+    if (isRedirectResponse(response)) {
+      return {
+        success: false,
+        error: "Cloud API request was redirected; redirects are not allowed"
+      };
+    }
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      return {
+        success: false,
+        error: formatApiErrorBody(text) ?? `HTTP ${response.status}`
+      };
+    }
+    return await response.json();
+  }
+}
+
+// src/cloud/cloud-proxy.ts
+class CloudRuntimeProxy {
+  client;
+  agentId;
+  _agentName;
+  constructor(client, agentId, _agentName) {
+    this.client = client;
+    this.agentId = agentId;
+    this._agentName = _agentName;
+  }
+  get agentName() {
+    return this._agentName;
+  }
+  async handleChatMessage(text, roomId = "web-chat", channelType = "DM") {
+    return this.client.sendMessage(this.agentId, text, roomId, channelType);
+  }
+  async* handleChatMessageStream(text, roomId = "web-chat", channelType = "DM") {
+    for await (const event of this.client.sendMessageStream(this.agentId, text, roomId, channelType)) {
+      if (event.type === "chunk" && typeof event.data.text === "string") {
+        yield event.data.text;
+      }
+    }
+  }
+  async getStatus() {
+    const agent = await this.client.getAgent(this.agentId);
+    return { state: agent.status, agentName: agent.agentName };
+  }
+  async isAlive() {
+    return this.client.heartbeat(this.agentId).catch(() => false);
+  }
+}
+
+// src/cloud/reconnect.ts
+import { logger as logger2 } from "@elizaos/core";
+
+class ConnectionMonitor {
+  client;
+  agentId;
+  callbacks;
+  heartbeatIntervalMs;
+  maxFailures;
+  timer = null;
+  consecutiveFailures = 0;
+  reconnecting = false;
+  constructor(client, agentId, callbacks, heartbeatIntervalMs = 30000, maxFailures = 3) {
+    this.client = client;
+    this.agentId = agentId;
+    this.callbacks = callbacks;
+    this.heartbeatIntervalMs = heartbeatIntervalMs;
+    this.maxFailures = maxFailures;
+  }
+  start() {
+    if (this.timer)
+      return;
+    logger2.info(`[cloud-monitor] Starting connection monitor (interval: ${this.heartbeatIntervalMs}ms, maxFailures: ${this.maxFailures})`);
+    this.consecutiveFailures = 0;
+    this.timer = setInterval(() => {
+      this.tick();
+    }, this.heartbeatIntervalMs);
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.consecutiveFailures = 0;
+    this.reconnecting = false;
+    logger2.info("[cloud-monitor] Connection monitor stopped");
+  }
+  isMonitoring() {
+    return this.timer !== null;
+  }
+  async tick() {
+    if (this.reconnecting)
+      return;
+    const alive = await this.client.heartbeat(this.agentId).catch(() => false);
+    if (alive) {
+      if (this.consecutiveFailures > 0) {
+        this.consecutiveFailures = 0;
+        this.callbacks.onStatusChange?.("connected");
+      }
+      return;
+    }
+    this.consecutiveFailures++;
+    logger2.warn(`[cloud-monitor] Heartbeat failed (${this.consecutiveFailures}/${this.maxFailures})`);
+    if (this.consecutiveFailures >= this.maxFailures) {
+      this.callbacks.onDisconnect();
+      await this.attemptReconnect();
+    }
+  }
+  async attemptReconnect() {
+    this.reconnecting = true;
+    this.callbacks.onStatusChange?.("reconnecting");
+    let delay = 3000;
+    for (let attempt = 1;attempt <= 10; attempt++) {
+      logger2.info(`[cloud-monitor] Reconnect attempt ${attempt}/10...`);
+      const ok = await this.client.provision(this.agentId).then(() => true).catch(() => false);
+      if (ok) {
+        logger2.info("[cloud-monitor] Reconnection successful");
+        this.consecutiveFailures = 0;
+        this.reconnecting = false;
+        this.callbacks.onStatusChange?.("connected");
+        this.callbacks.onReconnect();
+        return;
+      }
+      await new Promise((r) => setTimeout(r, delay));
+      delay = Math.min(delay * 2, 60000);
+    }
+    logger2.error("[cloud-monitor] Failed to reconnect after 10 attempts");
+    this.reconnecting = false;
+    this.callbacks.onStatusChange?.("disconnected");
+  }
+}
+
+// src/cloud/cloud-manager.ts
+import { logger as logger3 } from "@elizaos/core";
+init_base_url();
+init_validate_url();
+
+class CloudManager {
+  cloudConfig;
+  callbacks;
+  client = null;
+  proxy = null;
+  backupScheduler = null;
+  connectionMonitor = null;
+  status = "disconnected";
+  activeAgentId = null;
+  constructor(cloudConfig, callbacks = {}) {
+    this.cloudConfig = cloudConfig;
+    this.callbacks = callbacks;
+  }
+  async init() {
+    const rawUrl = normalizeCloudSiteUrl(this.cloudConfig.baseUrl);
+    const apiKey = this.cloudConfig.apiKey;
+    if (!apiKey)
+      throw new Error("Cloud API key is not configured. Run cloud login first.");
+    const urlError = await validateCloudBaseUrl(rawUrl);
+    if (urlError) {
+      throw new Error(urlError);
+    }
+    this.client = new ElizaCloudClient(rawUrl, apiKey);
+    logger3.info(`[cloud-manager] Client initialised (baseUrl=${rawUrl})`);
+  }
+  async connect(agentId) {
+    if (!this.client)
+      await this.init();
+    if (!this.client)
+      throw new Error("Cloud client failed to initialise");
+    this.setStatus("connecting");
+    this.activeAgentId = agentId;
+    try {
+      await this.client.provision(agentId);
+      const agent = await this.client.getAgent(agentId);
+      this.proxy = new CloudRuntimeProxy(this.client, agentId, agent.agentName);
+      this.backupScheduler = new BackupScheduler(this.client, agentId, this.cloudConfig.backup?.autoBackupIntervalMs ?? 60000);
+      this.backupScheduler.start();
+      this.connectionMonitor = new ConnectionMonitor(this.client, agentId, {
+        onDisconnect: () => this.setStatus("reconnecting"),
+        onReconnect: () => this.setStatus("connected"),
+        onStatusChange: (s) => {
+          if (s === "connected")
+            this.setStatus("connected");
+          else if (s === "reconnecting")
+            this.setStatus("reconnecting");
+          else
+            this.setStatus("error");
+        }
+      }, this.cloudConfig.bridge?.heartbeatIntervalMs ?? 30000);
+      this.connectionMonitor.start();
+      this.setStatus("connected");
+      logger3.info(`[cloud-manager] Connected to cloud agent (agentId=${agentId}, agentName=${agent.agentName})`);
+      return this.proxy;
+    } catch (err) {
+      this.setStatus("error");
+      if (this.backupScheduler) {
+        this.backupScheduler.stop();
+        this.backupScheduler = null;
+      }
+      if (this.connectionMonitor) {
+        this.connectionMonitor.stop();
+        this.connectionMonitor = null;
+      }
+      this.proxy = null;
+      this.activeAgentId = null;
+      this.setStatus("disconnected");
+      throw err;
+    }
+  }
+  async disconnect() {
+    if (this.backupScheduler) {
+      await this.backupScheduler.finalSnapshot();
+      this.backupScheduler.stop();
+      this.backupScheduler = null;
+    }
+    if (this.connectionMonitor) {
+      this.connectionMonitor.stop();
+      this.connectionMonitor = null;
+    }
+    this.proxy = null;
+    this.activeAgentId = null;
+    this.setStatus("disconnected");
+  }
+  async replaceApiKey(apiKey) {
+    await this.disconnect();
+    this.cloudConfig = {
+      ...this.cloudConfig,
+      apiKey
+    };
+    this.client = null;
+    await this.init();
+  }
+  getProxy() {
+    return this.proxy;
+  }
+  getClient() {
+    return this.client;
+  }
+  getActiveAgentId() {
+    return this.activeAgentId;
+  }
+  getStatus() {
+    return this.status;
+  }
+  isEnabled() {
+    return Boolean(this.cloudConfig.enabled && this.cloudConfig.apiKey);
+  }
+  setStatus(status) {
+    if (this.status === status)
+      return;
+    this.status = status;
+    this.callbacks.onStatusChange?.(status);
+  }
+}
+export {
+  CloudManager
+};
+
+//# debugId=D34BA0F1C08BEDCE64756E2164756E21