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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@elizaos/plugin-elizacloud",
-  "version": "2.0.0-alpha.8",
+  "version": "2.0.11-beta.7",
   "type": "module",
-  "main": "dist/cjs/index.node.cjs",
+  "main": "dist/node/index.node.js",
   "module": "dist/node/index.node.js",
   "types": "dist/node/index.d.ts",
   "browser": "dist/browser/index.browser.js",
@@ -15,6 +15,11 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/node/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.node.ts",
+        "import": "./src/index.node.ts",
+        "default": "./src/index.node.ts"
+      },
       "browser": {
         "types": "./dist/browser/index.d.ts",
         "import": "./dist/browser/index.browser.js",
@@ -23,45 +28,90 @@
       "node": {
         "types": "./dist/node/index.d.ts",
         "import": "./dist/node/index.node.js",
-        "require": "./dist/cjs/index.node.cjs",
         "default": "./dist/node/index.node.js"
       },
       "default": "./dist/node/index.node.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
     "dist",
-    "types"
+    "src",
+    "types",
+    "auto-enable.ts"
   ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "text-large",
+        "text-small",
+        "tool-use",
+        "embedding",
+        "text-to-speech",
+        "image-description"
+      ]
+    }
+  },
   "dependencies": {
+    "@ai-sdk/gateway": "3.0.133",
     "@ai-sdk/openai": "^3.0.9",
-    "@elizaos/core": "2.0.0-alpha.114",
+    "@ai-sdk/provider": "3.0.10",
+    "@ai-sdk/provider-utils": "4.0.26",
+    "@elizaos/cloud-sdk": "2.0.11-beta.7",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/shared": "2.0.11-beta.7",
+    "@noble/curves": "2.2.0",
+    "@noble/hashes": "1.8.0",
+    "@opentelemetry/api": "1.9.1",
+    "@scure/bip32": "1.7.0",
+    "@scure/bip39": "1.6.0",
+    "abitype": "1.2.3",
     "ai": "^6.0.30",
+    "isows": "1.0.7",
+    "jose": "^6.2.2",
     "js-tiktoken": "^1.0.21",
-    "undici": "^7.16.0"
+    "ox": "0.14.20",
+    "undici": "8.5.0",
+    "viem": "^2.48.8",
+    "ws": "8.21.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
+    "@biomejs/biome": "^2.4.14",
+    "@clack/prompts": "^1.5.1",
     "@types/bun": "^1.3.5",
     "@types/node": "^25.0.3",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "scripts": {
     "dev": "bun run build.ts --watch",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
-    "clean": "rm -rf dist .turbo node_modules .turbo-tsconfig.json tsconfig.tsbuildinfo",
+    "clean": "rm -rf dist .turbo .turbo-tsconfig.json tsconfig.tsbuildinfo",
     "format": "bunx @biomejs/biome format --write .",
     "format:check": "bunx @biomejs/biome format .",
-    "test": "npx -y vitest@4.0.18 run --passWithNoTests",
+    "test": "vitest run",
     "test:unit": "vitest run __tests__/unit/",
     "test:integration": "vitest run __tests__/integration/",
     "lint:check": "bunx @biomejs/biome check .",
     "build": "bun run build.ts",
-    "build:ts": "bun run build.ts"
+    "build:ts": "bun run build.ts",
+    "test:e2e": "node ../../packages/app-core/scripts/run-local-plugin-live-smoke.mjs",
+    "test:live": "bun run test:e2e"
   },
   "publishConfig": {
     "access": "public"
@@ -82,30 +132,98 @@
         "default": "https://www.elizacloud.ai/api/v1",
         "sensitive": false
       },
+      "ELIZAOS_CLOUD_NANO_MODEL": {
+        "type": "string",
+        "description": "Nano/cheapest text model for lightweight routing and should-respond tasks (overrides NANO_MODEL). Default: gpt-oss-120b",
+        "required": false,
+        "default": "gpt-oss-120b",
+        "sensitive": false
+      },
+      "NANO_MODEL": {
+        "type": "string",
+        "description": "Fallback identifier for the nano language model if ELIZAOS_CLOUD_NANO_MODEL is not set.",
+        "required": false,
+        "default": "gpt-oss-120b",
+        "sensitive": false
+      },
       "ELIZAOS_CLOUD_SMALL_MODEL": {
         "type": "string",
-        "description": "Small/fast model for quick tasks (overrides SMALL_MODEL). Available: gpt-5-mini, gpt-5, claude-3-5-sonnet, gemini-2.0-flash",
+        "description": "Small/fast model for quick tasks (overrides SMALL_MODEL). Default: gpt-oss-120b",
         "required": false,
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "SMALL_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the small language model if ELIZAOS_CLOUD_SMALL_MODEL is not set.",
         "required": false,
-        "default": "gpt-5-mini",
+        "default": "gpt-oss-120b",
+        "sensitive": false
+      },
+      "ELIZAOS_CLOUD_MEDIUM_MODEL": {
+        "type": "string",
+        "description": "Medium planning model for multi-step reasoning (overrides MEDIUM_MODEL). Default: gpt-oss-120b",
+        "required": false,
+        "default": "gpt-oss-120b",
+        "sensitive": false
+      },
+      "MEDIUM_MODEL": {
+        "type": "string",
+        "description": "Fallback identifier for the medium language model if ELIZAOS_CLOUD_MEDIUM_MODEL is not set.",
+        "required": false,
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_LARGE_MODEL": {
         "type": "string",
-        "description": "Large/powerful model for complex tasks (overrides LARGE_MODEL). Available: gpt-5-mini, gpt-5, claude-3-5-sonnet, gemini-2.0-flash",
+        "description": "Large/powerful model for complex tasks (overrides LARGE_MODEL). Default: zai-glm-4.7",
         "required": false,
+        "default": "zai-glm-4.7",
         "sensitive": false
       },
       "LARGE_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the large language model if ELIZAOS_CLOUD_LARGE_MODEL is not set.",
         "required": false,
-        "default": "gpt-5",
+        "default": "zai-glm-4.7",
+        "sensitive": false
+      },
+      "ELIZAOS_CLOUD_MEGA_MODEL": {
+        "type": "string",
+        "description": "Mega/top-tier model for the heaviest generation tasks (overrides MEGA_MODEL). Falls back to the large tier when unset.",
+        "required": false,
+        "default": "zai-glm-4.7",
+        "sensitive": false
+      },
+      "MEGA_MODEL": {
+        "type": "string",
+        "description": "Fallback identifier for the mega language model if ELIZAOS_CLOUD_MEGA_MODEL is not set.",
+        "required": false,
+        "default": "zai-glm-4.7",
+        "sensitive": false
+      },
+      "ELIZAOS_CLOUD_RESPONSE_HANDLER_MODEL": {
+        "type": "string",
+        "description": "Optional override for RESPONSE_HANDLER. Defaults to the configured nano tier when unset.",
+        "required": false,
+        "sensitive": false
+      },
+      "RESPONSE_HANDLER_MODEL": {
+        "type": "string",
+        "description": "Fallback identifier for RESPONSE_HANDLER if ELIZAOS_CLOUD_RESPONSE_HANDLER_MODEL is not set.",
+        "required": false,
+        "sensitive": false
+      },
+      "ELIZAOS_CLOUD_ACTION_PLANNER_MODEL": {
+        "type": "string",
+        "description": "Optional override for ACTION_PLANNER. Defaults to the configured medium tier when unset.",
+        "required": false,
+        "sensitive": false
+      },
+      "ACTION_PLANNER_MODEL": {
+        "type": "string",
+        "description": "Fallback identifier for ACTION_PLANNER if ELIZAOS_CLOUD_ACTION_PLANNER_MODEL is not set.",
+        "required": false,
         "sensitive": false
       },
       "ELIZAOS_CLOUD_EMBEDDING_MODEL": {
@@ -138,7 +256,7 @@
         "type": "string",
         "description": "Identifier of the model used for describing images.",
         "required": false,
-        "default": "gpt-5-mini",
+        "default": "gpt-5.4-mini",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_IMAGE_DESCRIPTION_MAX_TOKENS": {
@@ -198,13 +316,13 @@
         "type": "string",
         "description": "Application version sent during device authentication.",
         "required": false,
-        "default": "2.0.0-alpha",
+        "default": "2.0.0-beta.0",
         "sensitive": false
       }
     }
   },
-  "gitHead": "646c632924826e2b75c2304a75ee56959fe4a460",
-  "milady": {
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e",
+  "eliza": {
     "platforms": [
       "browser",
       "node"

package/src/cloud/auth-service-types.ts

@@ -0,0 +1,24 @@
+import type { Service } from "@elizaos/core";
+
+export interface CloudAuthApiKeyService {
+  isAuthenticated: () => boolean;
+  getApiKey?: () => string | undefined;
+}
+
+export function isCloudAuthApiKeyService(
+  value: Service | null | undefined,
+): value is Service & CloudAuthApiKeyService {
+  return (
+    value !== null &&
+    value !== undefined &&
+    typeof (value as Partial<CloudAuthApiKeyService>).isAuthenticated ===
+      "function"
+  );
+}
+
+export function normalizeCloudApiKey(value: string | null | undefined): string | null {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (!trimmed || trimmed.toUpperCase() === "[REDACTED]") return null;
+  return trimmed;
+}

package/src/cloud/auth.ts

@@ -0,0 +1,175 @@
+/**
+ * Eliza Cloud login flow — reuses the CLI auth session pattern:
+ * create session, open browser, poll until authenticated, return API key.
+ */
+
+import crypto from "node:crypto";
+import { logger } from "@elizaos/core";
+import { normalizeCloudSiteUrl } from "./base-url.js";
+import { validateCloudBaseUrl } from "./validate-url.js";
+
+export interface CloudLoginResult {
+  apiKey: string;
+  keyPrefix: string;
+  expiresAt: string | null;
+}
+
+export interface CloudLoginOptions {
+  baseUrl?: string;
+  timeoutMs?: number;
+  requestTimeoutMs?: number;
+  pollIntervalMs?: number;
+  onBrowserUrl?: (url: string) => void;
+  onPollStatus?: (status: string) => void;
+}
+
+const DEFAULT_CLOUD_REQUEST_TIMEOUT_MS = 10_000;
+
+function isRedirectResponse(response: Response): boolean {
+  return response.status >= 300 && response.status < 400;
+}
+
+function isTimeoutError(err: unknown): boolean {
+  if (!(err instanceof Error)) return false;
+  if (err.name === "TimeoutError" || err.name === "AbortError") return true;
+  const msg = err.message.toLowerCase();
+  return msg.includes("timed out") || msg.includes("timeout");
+}
+
+async function fetchWithTimeout(
+  input: string,
+  init: RequestInit,
+  timeoutMs: number,
+): Promise<Response> {
+  return fetch(input, {
+    ...init,
+    redirect: "manual",
+    signal: AbortSignal.timeout(timeoutMs),
+  });
+}
+
+export async function cloudLogin(
+  options: CloudLoginOptions = {},
+): Promise<CloudLoginResult> {
+  const baseUrl = normalizeCloudSiteUrl(options.baseUrl);
+  const urlError = await validateCloudBaseUrl(baseUrl);
+  if (urlError) {
+    throw new Error(urlError);
+  }
+  const timeoutMs = options.timeoutMs ?? 300_000;
+  const requestTimeoutMs =
+    options.requestTimeoutMs ?? DEFAULT_CLOUD_REQUEST_TIMEOUT_MS;
+  const pollIntervalMs = options.pollIntervalMs ?? 2_000;
+  const sessionId = crypto.randomUUID();
+
+  logger.info("[cloud-auth] Creating auth session...");
+
+  let createResponse: Response;
+  try {
+    createResponse = await fetchWithTimeout(
+      `${baseUrl}/api/auth/cli-session`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ sessionId }),
+      },
+      requestTimeoutMs,
+    );
+  } catch (err) {
+    if (isTimeoutError(err)) {
+      throw new Error(
+        `Cloud login request timed out while creating session (>${requestTimeoutMs}ms).`,
+      );
+    }
+    throw new Error(`Failed to create auth session: ${String(err)}`);
+  }
+
+  if (!createResponse.ok) {
+    if (isRedirectResponse(createResponse)) {
+      throw new Error(
+        "Cloud login request was redirected; redirects are not allowed.",
+      );
+    }
+    const errorText = await createResponse.text();
+    throw new Error(
+      `Failed to create auth session (HTTP ${createResponse.status}): ${errorText}`,
+    );
+  }
+
+  const browserUrl = `${baseUrl}/auth/cli-login?session=${encodeURIComponent(sessionId)}`;
+  logger.info(`[cloud-auth] Browser URL: ${browserUrl}`);
+  options.onBrowserUrl?.(browserUrl);
+
+  const deadline = Date.now() + timeoutMs;
+
+  while (Date.now() < deadline) {
+    const remainingBeforeSleep = deadline - Date.now();
+    if (remainingBeforeSleep <= 0) break;
+    await new Promise((resolve) =>
+      setTimeout(resolve, Math.min(pollIntervalMs, remainingBeforeSleep)),
+    );
+
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) break;
+
+    let pollResponse: Response;
+    try {
+      pollResponse = await fetchWithTimeout(
+        `${baseUrl}/api/auth/cli-session/${encodeURIComponent(sessionId)}`,
+        {},
+        Math.min(requestTimeoutMs, remaining),
+      );
+    } catch (err) {
+      if (isTimeoutError(err)) {
+        if (remaining <= requestTimeoutMs) {
+          break;
+        }
+        throw new Error(
+          `Cloud login polling request timed out (>${Math.min(requestTimeoutMs, remaining)}ms).`,
+        );
+      }
+      throw new Error(`Cloud login polling failed: ${String(err)}`);
+    }
+
+    if (!pollResponse.ok) {
+      if (isRedirectResponse(pollResponse)) {
+        throw new Error(
+          "Cloud login polling request was redirected; redirects are not allowed.",
+        );
+      }
+      if (pollResponse.status === 404) {
+        throw new Error("Auth session expired or not found. Please try again.");
+      }
+      options.onPollStatus?.("error");
+      continue;
+    }
+
+    const data = (await pollResponse.json()) as {
+      status: string;
+      apiKey?: string;
+      keyPrefix?: string;
+      expiresAt?: string;
+    };
+
+    options.onPollStatus?.(data.status);
+
+    if (data.status === "authenticated" && data.apiKey) {
+      logger.info("[cloud-auth] Authentication complete");
+      return {
+        apiKey: data.apiKey,
+        keyPrefix: data.keyPrefix ?? "",
+        expiresAt: data.expiresAt ?? null,
+      };
+    }
+
+    if (data.status === "authenticated" && !data.apiKey) {
+      throw new Error(
+        "Auth session was completed but the API key was already retrieved. Please try logging in again.",
+      );
+    }
+  }
+
+  throw new Error(
+    `Cloud login timed out. The browser login was not completed within ${Math.round(timeoutMs / 1000)} seconds.`,
+  );
+}

package/src/cloud/backup.ts

@@ -0,0 +1,46 @@
+/**
+ * Periodic state backup scheduler for cloud sandboxes.
+ * Default interval: 60s. Configurable via cloud.backup.autoBackupIntervalMs.
+ */
+
+import { logger } from "@elizaos/core";
+import type { ElizaCloudClient } from "./bridge-client.js";
+
+export class BackupScheduler {
+  private timer: ReturnType<typeof setInterval> | null = null;
+  private running = false;
+
+  constructor(
+    private client: ElizaCloudClient,
+    private agentId: string,
+    private intervalMs: number = 60_000,
+  ) {}
+
+  start(): void {
+    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(): void {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.running = false;
+  }
+
+  isRunning(): boolean {
+    return this.running;
+  }
+
+  async finalSnapshot(): Promise<void> {
+    await this.client.snapshot(this.agentId).catch((err) => {
+      logger.warn(`[cloud-backup] Final snapshot failed: ${String(err)}`);
+    });
+  }
+}

package/src/cloud/base-url.ts

@@ -0,0 +1,6 @@
+/**
+ * Cloud site/API URL normalizer. The implementation moved to
+ * `@elizaos/shared/elizacloud/base-url` so host-layer packages can normalize
+ * URLs without reverse-importing this plugin.
+ */
+export { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from "@elizaos/shared";