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

package/dist/cloud/clack-observer.js

@@ -0,0 +1,143 @@
+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/clack-observer.ts
+import { logger } from "@elizaos/core";
+
+class ClackObserver {
+  clack;
+  spinner = null;
+  constructor(clack) {
+    this.clack = clack;
+  }
+  ensureSpinner() {
+    if (!this.spinner) {
+      this.spinner = this.clack.spinner();
+    }
+    return this.spinner;
+  }
+  stopSpinner(message) {
+    if (this.spinner) {
+      this.spinner.stop(message);
+      this.spinner = null;
+    } else {
+      this.clack.log.info(message);
+    }
+  }
+  onAvailabilityChecked(result) {
+    if (!result.ok && result.reason) {
+      this.clack.log.warn(result.reason);
+    }
+  }
+  onAuthStart(loginUrl) {
+    const spinner = this.ensureSpinner();
+    spinner.start("Connecting to Eliza Cloud...");
+    spinner.stop("Opening your browser to log in...");
+    this.spinner = null;
+    this.clack.log.info(`If the browser didn't open, visit:
+  ${loginUrl}`);
+    const polling = this.ensureSpinner();
+    polling.start("Waiting for login in browser...");
+  }
+  onAuthBrowserOpenFailed(loginUrl, error) {
+    this.clack.log.warn(`Could not open browser automatically (${error.message}). Visit this URL to continue:
+  ${loginUrl}`);
+  }
+  onAuthPollStatus(status) {
+    if (status === "pending") {
+      this.ensureSpinner().message("Waiting for login in browser...");
+    }
+  }
+  onAuthSuccess() {
+    this.stopSpinner("✓ Logged in to Eliza Cloud!");
+  }
+  onAuthFailure(message) {
+    this.stopSpinner(message);
+  }
+  onProvisionStart(_agentName) {
+    const spinner = this.ensureSpinner();
+    spinner.start("Creating your cloud agent...");
+  }
+  onProvisionStatus(status) {
+    const spinner = this.ensureSpinner();
+    switch (status) {
+      case "created":
+        spinner.message("Agent created! Provisioning cloud environment...");
+        break;
+      case "queued":
+        spinner.message("Queued — waiting for available slot...");
+        break;
+      case "provisioning":
+        spinner.message("Provisioning cloud environment...");
+        break;
+      default:
+        spinner.message(`Status: ${status}...`);
+    }
+  }
+  onProvisionTimeout(_agentId, lastStatus) {
+    this.stopSpinner(`Provisioning timed out (last status: ${lastStatus}). The agent may still be starting up.`);
+  }
+  onProvisionFailure(reason) {
+    this.stopSpinner(reason);
+  }
+  onProvisionSuccess(result) {
+    this.stopSpinner(`☁️  Cloud agent "${result.agentId}" is running!`);
+  }
+  onNotice(message) {
+    this.clack.log.warn(message);
+  }
+  onFatalError(error, context) {
+    logger.error(`[cloud-setup] ${context}: ${error.message}`);
+    this.clack.log.error(`${context}: ${error.message}`);
+  }
+  async confirm(prompt) {
+    const args = { message: prompt.message };
+    if (prompt.defaultValue !== undefined)
+      args.initialValue = prompt.defaultValue;
+    if (prompt.activeLabel !== undefined)
+      args.active = prompt.activeLabel;
+    if (prompt.inactiveLabel !== undefined)
+      args.inactive = prompt.inactiveLabel;
+    const result = await this.clack.confirm(args);
+    if (this.clack.isCancel(result))
+      return null;
+    return result;
+  }
+  async selectChoice(prompt) {
+    const options = prompt.options.map((option) => {
+      const out = {
+        label: option.label,
+        value: option.value,
+        ...option.hint !== undefined ? { hint: option.hint } : {}
+      };
+      return out;
+    });
+    const result = await this.clack.select({
+      message: prompt.message,
+      options
+    });
+    if (this.clack.isCancel(result))
+      return null;
+    return result;
+  }
+}
+export {
+  ClackObserver
+};
+
+//# debugId=BD987A93A330085A64756E2164756E21

package/dist/cloud/clack-observer.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cloud/clack-observer.ts"],
+  "sourcesContent": [
+    "/**\n * `@clack/prompts`-backed implementation of `CloudSetupObserver`.\n *\n * Used by the CLI first-time-setup flow. Wraps a lazily-loaded clack module\n * (so packaged desktop builds that never run interactive setup don't\n * pay the dep cost) and renders every observer event as a spinner update,\n * `log.info` / `log.warn`, or `confirm` / `select` prompt.\n *\n * @module cloud/clack-observer\n */\nimport { logger } from \"@elizaos/core\";\nimport type {\n  CloudSetupObserver,\n  ConfirmPrompt,\n  ProvisionSuccessInfo,\n  SelectChoicePrompt,\n} from \"./setup-observer.js\";\n\n/** Lazy-loaded @clack/prompts module type. */\ntype ClackModule = typeof import(\"@clack/prompts\");\n\ninterface ClackSpinner {\n  start(message?: string): void;\n  stop(message?: string): void;\n  message(message?: string): void;\n}\n\n/**\n * Observer that drives a clack CLI session. One instance per setup run\n * — internal spinner state is reused across the auth + provisioning phases\n * so we don't stack overlapping spinners.\n */\nexport class ClackObserver implements CloudSetupObserver {\n  private spinner: ClackSpinner | null = null;\n\n  constructor(private readonly clack: ClackModule) {}\n\n  // ── Spinner helpers ──────────────────────────────────────────────────\n  private ensureSpinner(): ClackSpinner {\n    if (!this.spinner) {\n      this.spinner = this.clack.spinner();\n    }\n    return this.spinner;\n  }\n\n  private stopSpinner(message: string): void {\n    if (this.spinner) {\n      this.spinner.stop(message);\n      this.spinner = null;\n    } else {\n      // No active spinner — render the line as a log.info so the\n      // message isn't lost.\n      this.clack.log.info(message);\n    }\n  }\n\n  // ── Availability ─────────────────────────────────────────────────────\n  onAvailabilityChecked(result: { ok: boolean; reason?: string }): void {\n    if (!result.ok && result.reason) {\n      this.clack.log.warn(result.reason);\n    }\n  }\n\n  // ── Auth ─────────────────────────────────────────────────────────────\n  onAuthStart(loginUrl: string): void {\n    const spinner = this.ensureSpinner();\n    spinner.start(\"Connecting to Eliza Cloud...\");\n    // The auth flow's first callback fires when we have the login URL.\n    spinner.stop(\"Opening your browser to log in...\");\n    this.spinner = null;\n    this.clack.log.info(`If the browser didn't open, visit:\\n  ${loginUrl}`);\n    const polling = this.ensureSpinner();\n    polling.start(\"Waiting for login in browser...\");\n  }\n\n  onAuthBrowserOpenFailed(loginUrl: string, error: Error): void {\n    // Previously swallowed at debug-level. Now visible: the user may have\n    // missed the URL printed by onAuthStart, so re-emit it here with the\n    // explicit \"couldn't open browser\" framing.\n    this.clack.log.warn(\n      `Could not open browser automatically (${error.message}). Visit this URL to continue:\\n  ${loginUrl}`,\n    );\n  }\n\n  onAuthPollStatus(status: string): void {\n    if (status === \"pending\") {\n      this.ensureSpinner().message(\"Waiting for login in browser...\");\n    }\n  }\n\n  onAuthSuccess(): void {\n    this.stopSpinner(\"✓ Logged in to Eliza Cloud!\");\n  }\n\n  onAuthFailure(message: string): void {\n    this.stopSpinner(message);\n  }\n\n  // ── Provisioning ─────────────────────────────────────────────────────\n  onProvisionStart(_agentName: string): void {\n    const spinner = this.ensureSpinner();\n    spinner.start(\"Creating your cloud agent...\");\n  }\n\n  onProvisionStatus(status: string): void {\n    const spinner = this.ensureSpinner();\n    switch (status) {\n      case \"created\":\n        spinner.message(\"Agent created! Provisioning cloud environment...\");\n        break;\n      case \"queued\":\n        spinner.message(\"Queued — waiting for available slot...\");\n        break;\n      case \"provisioning\":\n        spinner.message(\"Provisioning cloud environment...\");\n        break;\n      default:\n        spinner.message(`Status: ${status}...`);\n    }\n  }\n\n  onProvisionTimeout(_agentId: string, lastStatus: string): void {\n    this.stopSpinner(\n      `Provisioning timed out (last status: ${lastStatus}). The agent may still be starting up.`,\n    );\n  }\n\n  onProvisionFailure(reason: string): void {\n    this.stopSpinner(reason);\n  }\n\n  onProvisionSuccess(result: ProvisionSuccessInfo): void {\n    this.stopSpinner(`☁️  Cloud agent \"${result.agentId}\" is running!`);\n  }\n\n  // ── Generic ──────────────────────────────────────────────────────────\n  onNotice(message: string): void {\n    this.clack.log.warn(message);\n  }\n\n  onFatalError(error: Error, context: string): void {\n    logger.error(`[cloud-setup] ${context}: ${error.message}`);\n    this.clack.log.error(`${context}: ${error.message}`);\n  }\n\n  // ── Prompts ──────────────────────────────────────────────────────────\n  async confirm(prompt: ConfirmPrompt): Promise<boolean | null> {\n    const args: {\n      message: string;\n      initialValue?: boolean;\n      active?: string;\n      inactive?: string;\n    } = { message: prompt.message };\n\n    if (prompt.defaultValue !== undefined) args.initialValue = prompt.defaultValue;\n    if (prompt.activeLabel !== undefined) args.active = prompt.activeLabel;\n    if (prompt.inactiveLabel !== undefined) args.inactive = prompt.inactiveLabel;\n\n    const result = await this.clack.confirm(args);\n    if (this.clack.isCancel(result)) return null;\n    return result;\n  }\n\n  async selectChoice<T extends string>(\n    prompt: SelectChoicePrompt<T>,\n  ): Promise<T | null> {\n    // Clack's `Option<Value>` is a conditional type that for `Value extends\n    // Primitive` makes `label` optional. TS can't narrow the conditional\n    // for an unresolved generic `T extends string`, so we describe the\n    // option shape via Parameters of clack's `select` and let inference\n    // pick it up. No `as unknown as` escape — the parameter type IS the\n    // right type, we just have to address it positionally.\n    type SelectOpts = Parameters<typeof this.clack.select<T>>[0];\n    const options = prompt.options.map((option) => {\n      const out = {\n        label: option.label,\n        value: option.value,\n        ...(option.hint !== undefined ? { hint: option.hint } : {}),\n      };\n      return out;\n    }) as SelectOpts[\"options\"];\n    const result = await this.clack.select<T>({\n      message: prompt.message,\n      options,\n    });\n    if (this.clack.isCancel(result)) return null;\n    return result;\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "BD987A93A330085A64756E2164756E21",
+  "names": []
+}

package/dist/cloud/cloud-api-key.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cloud API key + base URL resolution.
+ *
+ * Resolves the Eliza Cloud API key and base URL from (in priority order):
+ *   1. Explicit `config.cloud.apiKey` / `config.cloud.baseUrl`
+ *   2. Runtime settings + character secrets (`ELIZAOS_CLOUD_API_KEY`)
+ *   3. Process env (`ELIZAOS_CLOUD_API_KEY`, `ELIZAOS_CLOUD_BASE_URL`)
+ *
+ * Previously these helpers lived in `packages/agent/src/api/wallet-rpc.ts`
+ * because the wallet uses Cloud RPC proxies. They are NOT wallet-specific —
+ * cloud auth is consumed by cloud-status, cloud-billing, cloud-compat,
+ * health, x-relay, and travel-provider-relay routes. Hosting them under
+ * `cloud/` matches their actual ownership.
+ */
+import type { ElizaConfig } from "../lib/config-like";
+export declare const DEFAULT_CLOUD_API_BASE_URL = "https://elizacloud.ai/api/v1";
+export type CloudApiKeyRuntimeLike = {
+    getSetting?: (key: string) => unknown;
+    character?: {
+        secrets?: Record<string, unknown>;
+    } | null;
+} | null;
+export declare function normalizeCloudSecret(value: string | null | undefined): string | null;
+export declare function resolveCloudApiBaseUrl(rawBaseUrl?: string | null): string | null;
+export declare function resolveCloudApiKey(config?: Pick<ElizaConfig, "cloud"> | null, runtime?: CloudApiKeyRuntimeLike): string | null;
+//# sourceMappingURL=cloud-api-key.d.ts.map

package/dist/cloud/cloud-api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-api-key.d.ts","sourceRoot":"","sources":["../../src/cloud/cloud-api-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI,CAAC;CACV,GAAG,IAAI,CAAC;AAET,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAIf;AAgBD,wBAAgB,sBAAsB,CACpC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,GAAG,IAAI,CAkBf;AAED,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1C,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,GAAG,IAAI,CAMf"}

package/dist/cloud/cloud-api-key.js

@@ -0,0 +1,60 @@
+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/cloud-api-key.ts
+function normalizeCloudSecret(value) {
+  if (typeof value !== "string")
+    return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function resolveRuntimeCloudApiKey(runtime) {
+  const fromSetting = runtime?.getSetting?.("ELIZAOS_CLOUD_API_KEY");
+  if (typeof fromSetting === "string") {
+    return normalizeCloudSecret(fromSetting);
+  }
+  const fromSecrets = runtime?.character?.secrets?.ELIZAOS_CLOUD_API_KEY;
+  return typeof fromSecrets === "string" ? normalizeCloudSecret(fromSecrets) : null;
+}
+function resolveCloudApiBaseUrl(rawBaseUrl) {
+  const candidate = normalizeCloudSecret(rawBaseUrl ?? process.env.ELIZAOS_CLOUD_BASE_URL) ?? DEFAULT_CLOUD_API_BASE_URL;
+  try {
+    const parsed = new URL(candidate);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      return null;
+    }
+    parsed.hash = "";
+    parsed.search = "";
+    const normalizedBase = parsed.toString().replace(/\/+$/, "");
+    return normalizedBase.endsWith("/api/v1") ? normalizedBase : `${normalizedBase}/api/v1`;
+  } catch {
+    return null;
+  }
+}
+function resolveCloudApiKey(config, runtime) {
+  return normalizeCloudSecret(config?.cloud?.apiKey ?? resolveRuntimeCloudApiKey(runtime) ?? process.env.ELIZAOS_CLOUD_API_KEY);
+}
+var DEFAULT_CLOUD_API_BASE_URL = "https://elizacloud.ai/api/v1";
+export {
+  resolveCloudApiKey,
+  resolveCloudApiBaseUrl,
+  normalizeCloudSecret,
+  DEFAULT_CLOUD_API_BASE_URL
+};
+
+//# debugId=58F50016C093813664756E2164756E21

package/dist/cloud/cloud-api-key.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cloud/cloud-api-key.ts"],
+  "sourcesContent": [
+    "/**\n * Cloud API key + base URL resolution.\n *\n * Resolves the Eliza Cloud API key and base URL from (in priority order):\n *   1. Explicit `config.cloud.apiKey` / `config.cloud.baseUrl`\n *   2. Runtime settings + character secrets (`ELIZAOS_CLOUD_API_KEY`)\n *   3. Process env (`ELIZAOS_CLOUD_API_KEY`, `ELIZAOS_CLOUD_BASE_URL`)\n *\n * Previously these helpers lived in `packages/agent/src/api/wallet-rpc.ts`\n * because the wallet uses Cloud RPC proxies. They are NOT wallet-specific —\n * cloud auth is consumed by cloud-status, cloud-billing, cloud-compat,\n * health, x-relay, and travel-provider-relay routes. Hosting them under\n * `cloud/` matches their actual ownership.\n */\n\nimport type { ElizaConfig } from \"../lib/config-like\";\n\nexport const DEFAULT_CLOUD_API_BASE_URL = \"https://elizacloud.ai/api/v1\";\n\nexport type CloudApiKeyRuntimeLike = {\n  getSetting?: (key: string) => unknown;\n  character?: {\n    secrets?: Record<string, unknown>;\n  } | null;\n} | null;\n\nexport function normalizeCloudSecret(\n  value: string | null | undefined,\n): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction resolveRuntimeCloudApiKey(\n  runtime?: CloudApiKeyRuntimeLike,\n): string | null {\n  const fromSetting = runtime?.getSetting?.(\"ELIZAOS_CLOUD_API_KEY\");\n  if (typeof fromSetting === \"string\") {\n    return normalizeCloudSecret(fromSetting);\n  }\n\n  const fromSecrets = runtime?.character?.secrets?.ELIZAOS_CLOUD_API_KEY;\n  return typeof fromSecrets === \"string\"\n    ? normalizeCloudSecret(fromSecrets)\n    : null;\n}\n\nexport function resolveCloudApiBaseUrl(\n  rawBaseUrl?: string | null,\n): string | null {\n  const candidate =\n    normalizeCloudSecret(rawBaseUrl ?? process.env.ELIZAOS_CLOUD_BASE_URL) ??\n    DEFAULT_CLOUD_API_BASE_URL;\n  try {\n    const parsed = new URL(candidate);\n    if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n      return null;\n    }\n    parsed.hash = \"\";\n    parsed.search = \"\";\n    const normalizedBase = parsed.toString().replace(/\\/+$/, \"\");\n    return normalizedBase.endsWith(\"/api/v1\")\n      ? normalizedBase\n      : `${normalizedBase}/api/v1`;\n  } catch {\n    return null;\n  }\n}\n\nexport function resolveCloudApiKey(\n  config?: Pick<ElizaConfig, \"cloud\"> | null,\n  runtime?: CloudApiKeyRuntimeLike,\n): string | null {\n  return normalizeCloudSecret(\n    config?.cloud?.apiKey ??\n      resolveRuntimeCloudApiKey(runtime) ??\n      process.env.ELIZAOS_CLOUD_API_KEY,\n  );\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AA0BO,SAAS,oBAAoB,CAClC,OACe;AAAA,EACf,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EACtC,MAAM,UAAU,MAAM,KAAK;AAAA,EAC3B,OAAO,QAAQ,SAAS,IAAI,UAAU;AAAA;AAGxC,SAAS,yBAAyB,CAChC,SACe;AAAA,EACf,MAAM,cAAc,SAAS,aAAa,uBAAuB;AAAA,EACjE,IAAI,OAAO,gBAAgB,UAAU;AAAA,IACnC,OAAO,qBAAqB,WAAW;AAAA,EACzC;AAAA,EAEA,MAAM,cAAc,SAAS,WAAW,SAAS;AAAA,EACjD,OAAO,OAAO,gBAAgB,WAC1B,qBAAqB,WAAW,IAChC;AAAA;AAGC,SAAS,sBAAsB,CACpC,YACe;AAAA,EACf,MAAM,YACJ,qBAAqB,cAAc,QAAQ,IAAI,sBAAsB,KACrE;AAAA,EACF,IAAI;AAAA,IACF,MAAM,SAAS,IAAI,IAAI,SAAS;AAAA,IAChC,IAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UAAU;AAAA,MAC/D,OAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAO;AAAA,IACd,OAAO,SAAS;AAAA,IAChB,MAAM,iBAAiB,OAAO,SAAS,EAAE,QAAQ,QAAQ,EAAE;AAAA,IAC3D,OAAO,eAAe,SAAS,SAAS,IACpC,iBACA,GAAG;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;AAIJ,SAAS,kBAAkB,CAChC,QACA,SACe;AAAA,EACf,OAAO,qBACL,QAAQ,OAAO,UACb,0BAA0B,OAAO,KACjC,QAAQ,IAAI,qBAChB;AAAA;AAAA,IA7DW,6BAA6B;",
+  "debugId": "58F50016C093813664756E2164756E21",
+  "names": []
+}

package/dist/cloud/cloud-manager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Top-level orchestrator for cloud integration.
+ * Manages client, proxy, backup scheduler, and connection monitor lifecycle.
+ */
+import type { CloudConfig } from "../lib/config-like.js";
+import { ElizaCloudClient } from "./bridge-client.js";
+import { CloudRuntimeProxy } from "./cloud-proxy.js";
+export type CloudConnectionStatus = "disconnected" | "connecting" | "connected" | "reconnecting" | "error";
+export interface CloudManagerCallbacks {
+    onStatusChange?: (status: CloudConnectionStatus) => void;
+}
+export declare class CloudManager {
+    private cloudConfig;
+    private callbacks;
+    private client;
+    private proxy;
+    private backupScheduler;
+    private connectionMonitor;
+    private status;
+    private activeAgentId;
+    constructor(cloudConfig: CloudConfig, callbacks?: CloudManagerCallbacks);
+    init(): Promise<void>;
+    connect(agentId: string): Promise<CloudRuntimeProxy>;
+    disconnect(): Promise<void>;
+    replaceApiKey(apiKey: string): Promise<void>;
+    getProxy(): CloudRuntimeProxy | null;
+    getClient(): ElizaCloudClient | null;
+    getActiveAgentId(): string | null;
+    getStatus(): CloudConnectionStatus;
+    isEnabled(): boolean;
+    private setStatus;
+}
+//# sourceMappingURL=cloud-manager.d.ts.map

package/dist/cloud/cloud-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-manager.d.ts","sourceRoot":"","sources":["../../src/cloud/cloud-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,YAAY,GACZ,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC1D;AAED,qBAAa,YAAY;IASrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IATnB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,aAAa,CAAuB;gBAGlC,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,qBAA0B;IAGzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0DpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,QAAQ,IAAI,iBAAiB,GAAG,IAAI;IAGpC,SAAS,IAAI,gBAAgB,GAAG,IAAI;IAGpC,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAGjC,SAAS,IAAI,qBAAqB;IAGlC,SAAS,IAAI,OAAO;IAIpB,OAAO,CAAC,SAAS;CAKlB"}