@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/packages/agent/src/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../../../src/bin.ts"],"names":[],"mappings":""}

package/packages/agent/src/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runAutonomousCli } from "./cli";
+runAutonomousCli().catch((error) => {
+    console.error("[eliza-autonomous] Failed to start:", error instanceof Error ? (error.stack ?? error.message) : error);
+    process.exit(1);
+});

package/packages/agent/src/cli/index.d.ts

@@ -0,0 +1,2 @@
+export declare function runAutonomousCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/packages/agent/src/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/index.ts"],"names":[],"mappings":"AAuBA,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,MAAM,EAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/packages/agent/src/cli/index.js

@@ -0,0 +1,40 @@
+import { createRequire } from "node:module";
+import process from "node:process";
+import { bootElizaRuntime, startEliza } from "../runtime";
+function printHelp() {
+    console.log(`eliza-autonomous
+
+Usage:
+  eliza-autonomous serve
+  eliza-autonomous runtime
+
+Commands:
+  serve    Start the autonomous backend in server-only mode
+  runtime  Boot the runtime without entering the API/CLI wrapper
+`);
+}
+function printVersion() {
+    const require = createRequire(import.meta.url);
+    const pkg = require("../../package.json");
+    console.log(pkg.version);
+}
+export async function runAutonomousCli(argv = process.argv) {
+    const command = argv[2] ?? "serve";
+    if (command === "--version" || command === "-v" || command === "version") {
+        printVersion();
+        return;
+    }
+    if (command === "--help" || command === "-h" || command === "help") {
+        printHelp();
+        return;
+    }
+    if (command === "runtime") {
+        await bootElizaRuntime();
+        return;
+    }
+    if (command === "serve" || command === "start") {
+        await startEliza({ serverOnly: true });
+        return;
+    }
+    throw new Error(`Unknown command: ${command}`);
+}

package/packages/agent/src/cli/parse-duration.d.ts

@@ -0,0 +1,5 @@
+export type DurationMsParseOptions = {
+    defaultUnit?: "ms" | "s" | "m" | "h" | "d";
+};
+export declare function parseDurationMs(raw: string, opts?: DurationMsParseOptions): number;
+//# sourceMappingURL=parse-duration.d.ts.map

package/packages/agent/src/cli/parse-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-duration.d.ts","sourceRoot":"","sources":["../../../../../src/cli/parse-duration.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC5C,CAAC;AAEF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,sBAAsB,GAC5B,MAAM,CAmCR"}

package/packages/agent/src/cli/parse-duration.js

@@ -0,0 +1,27 @@
+export function parseDurationMs(raw, opts) {
+    const trimmed = String(raw ?? "")
+        .trim()
+        .toLowerCase();
+    if (!trimmed) {
+        throw new Error("invalid duration (empty)");
+    }
+    const m = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/.exec(trimmed);
+    if (!m) {
+        throw new Error(`invalid duration: ${raw}`);
+    }
+    const value = Number(m[1]);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`invalid duration: ${raw}`);
+    }
+    const unit = (m[2] ?? opts?.defaultUnit ?? "ms");
+    const multiplier = unit === "ms"
+        ? 1
+        : unit === "s"
+            ? 1000
+            : unit === "m"
+                ? 60_000
+                : unit === "h"
+                    ? 3_600_000
+                    : 86_400_000;
+    return Math.round(value * multiplier);
+}

package/packages/agent/src/cloud/auth.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Eliza Cloud login flow — reuses the CLI auth session pattern:
+ * create session, open browser, poll until authenticated, return API key.
+ */
+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;
+}
+export declare function cloudLogin(options?: CloudLoginOptions): Promise<CloudLoginResult>;
+//# sourceMappingURL=auth.d.ts.map

package/packages/agent/src/cloud/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AA2BD,wBAAsB,UAAU,CAC9B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA2H3B"}

package/packages/agent/src/cloud/auth.js

@@ -0,0 +1,107 @@
+/**
+ * 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";
+import { validateCloudBaseUrl } from "./validate-url";
+const DEFAULT_CLOUD_REQUEST_TIMEOUT_MS = 10_000;
+function isRedirectResponse(response) {
+    return response.status >= 300 && response.status < 400;
+}
+function isTimeoutError(err) {
+    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, init, timeoutMs) {
+    return fetch(input, {
+        ...init,
+        redirect: "manual",
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+}
+export async function cloudLogin(options = {}) {
+    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;
+    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: ${err instanceof Error ? err.message : 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;
+        try {
+            pollResponse = await fetchWithTimeout(`${baseUrl}/api/auth/cli-session/${encodeURIComponent(sessionId)}`, {}, Math.min(requestTimeoutMs, remaining));
+        }
+        catch (err) {
+            if (isTimeoutError(err)) {
+                throw new Error(`Cloud login polling request timed out (>${Math.min(requestTimeoutMs, remaining)}ms).`);
+            }
+            throw new Error(`Cloud login polling failed: ${err instanceof Error ? err.message : 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());
+        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/packages/agent/src/cloud/backup.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Periodic state backup scheduler for cloud sandboxes.
+ * Default interval: 60s. Configurable via cloud.backup.autoBackupIntervalMs.
+ */
+import type { ElizaCloudClient } from "./bridge-client";
+export declare class BackupScheduler {
+    private client;
+    private agentId;
+    private intervalMs;
+    private timer;
+    private running;
+    constructor(client: ElizaCloudClient, agentId: string, intervalMs?: number);
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+    finalSnapshot(): Promise<void>;
+}
+//# sourceMappingURL=backup.d.ts.map

package/packages/agent/src/cloud/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,qBAAa,eAAe;IAKxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAGd,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAe;IAGrC,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAQZ,SAAS,IAAI,OAAO;IAId,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAOrC"}

package/packages/agent/src/cloud/backup.js

@@ -0,0 +1,42 @@
+/**
+ * Periodic state backup scheduler for cloud sandboxes.
+ * Default interval: 60s. Configurable via cloud.backup.autoBackupIntervalMs.
+ */
+import { logger } from "@elizaos/core";
+export class BackupScheduler {
+    client;
+    agentId;
+    intervalMs;
+    timer = null;
+    running = false;
+    constructor(client, agentId, intervalMs = 60_000) {
+        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: ${err instanceof Error ? err.message : 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: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
+}

package/packages/agent/src/cloud/base-url.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeCloudSiteUrl(rawUrl?: string): string;
+export declare function resolveCloudApiBaseUrl(rawUrl?: string): string;
+//# sourceMappingURL=base-url.d.ts.map

package/packages/agent/src/cloud/base-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-url.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/base-url.ts"],"names":[],"mappings":"AAiBA,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB7D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/packages/agent/src/cloud/base-url.js

@@ -0,0 +1,40 @@
+const DEFAULT_CLOUD_SITE_URL = "https://www.elizacloud.ai";
+const LEGACY_CLOUD_HOST_ALIASES = new Set([
+    "elizacloud.ai",
+    "www.elizacloud.ai",
+]);
+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;
+}
+export function normalizeCloudSiteUrl(rawUrl) {
+    const candidate = rawUrl?.trim() || DEFAULT_CLOUD_SITE_URL;
+    try {
+        const parsed = new URL(candidate);
+        const pathname = trimApiPath(parsed.pathname);
+        const host = parsed.hostname.toLowerCase();
+        parsed.hash = "";
+        parsed.search = "";
+        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(/\/+$/, "");
+    }
+    catch {
+        return candidate.replace(/\/+$/, "");
+    }
+}
+export function resolveCloudApiBaseUrl(rawUrl) {
+    return `${normalizeCloudSiteUrl(rawUrl)}/api/v1`;
+}

package/packages/agent/src/cloud/bridge-client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * HTTP client for the Eliza Cloud Eliza Sandbox API.
+ */
+export interface CloudAgent {
+    id: string;
+    agentName: string;
+    status: string;
+    databaseStatus: string;
+    bridgeUrl?: string;
+    lastBackupAt?: string;
+    lastHeartbeatAt?: string;
+    errorMessage?: string;
+    errorCount?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CloudAgentCreateParams {
+    agentName: string;
+    agentConfig?: Record<string, unknown>;
+    environmentVars?: Record<string, string>;
+}
+export interface ProvisionInfo {
+    id: string;
+    agentName: string;
+    status: string;
+    bridgeUrl?: string;
+    healthUrl?: string;
+}
+export interface BackupInfo {
+    id: string;
+    snapshotType: string;
+    sizeBytes: number | null;
+    createdAt: string;
+}
+export type ChatChannelType = "DM" | "GROUP" | "VOICE_DM" | "VOICE_GROUP" | "API";
+export declare class ElizaCloudClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    listAgents(): Promise<CloudAgent[]>;
+    createAgent(params: CloudAgentCreateParams): Promise<CloudAgent>;
+    getAgent(agentId: string): Promise<CloudAgent>;
+    deleteAgent(agentId: string): Promise<void>;
+    provision(agentId: string): Promise<ProvisionInfo>;
+    sendMessage(agentId: string, text: string, roomId?: string, channelType?: ChatChannelType): Promise<string>;
+    sendMessageStream(agentId: string, text: string, roomId?: string, channelType?: ChatChannelType): AsyncGenerator<{
+        type: string;
+        data: Record<string, unknown>;
+    }>;
+    snapshot(agentId: string): Promise<BackupInfo>;
+    listBackups(agentId: string): Promise<BackupInfo[]>;
+    restore(agentId: string, backupId?: string): Promise<void>;
+    heartbeat(agentId: string): Promise<boolean>;
+    private request;
+}
+//# sourceMappingURL=bridge-client.d.ts.map

package/packages/agent/src/cloud/bridge-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/bridge-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB,IAAI,GACJ,OAAO,GACP,UAAU,GACV,aAAa,GACb,KAAK,CAAC;AAYV,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKrC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKnC,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAWhE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAU9C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUlD,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,SAAa,EACnB,WAAW,GAAE,eAAsB,GAClC,OAAO,CAAC,MAAM,CAAC;IAqCX,iBAAiB,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,SAAa,EACnB,WAAW,GAAE,eAAsB,GAClC,cAAc,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IA2D5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAU9C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQnD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAoBpC,OAAO;CAyCtB"}

package/packages/agent/src/cloud/bridge-client.js

@@ -0,0 +1,190 @@
+/**
+ * HTTP client for the Eliza Cloud Eliza Sandbox API.
+ */
+function isRedirectResponse(response) {
+    return response.status >= 300 && response.status < 400;
+}
+export class ElizaCloudClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        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(60_000),
+        });
+        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("\n\n");
+            buffer = parts.pop() ?? "";
+            for (const part of parts) {
+                if (!part.trim())
+                    continue;
+                let eventType = "message";
+                let eventData = "";
+                for (const line of part.split("\n")) {
+                    if (line.startsWith("event: "))
+                        eventType = line.slice(7).trim();
+                    else if (line.startsWith("data: "))
+                        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(10_000),
+            });
+            if (isRedirectResponse(response))
+                return false;
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    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(30_000),
+        });
+        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(() => "");
+            let parsed = {};
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                /* plain text */
+            }
+            return {
+                success: false,
+                error: parsed.error ??
+                    `HTTP ${response.status}: ${text.slice(0, 200)}`,
+            };
+        }
+        return (await response.json());
+    }
+}

package/packages/agent/src/cloud/cloud-manager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Top-level orchestrator for cloud integration.
+ * Manages client, proxy, backup scheduler, and connection monitor lifecycle.
+ */
+import type { CloudConfig } from "../config/types.eliza";
+import { ElizaCloudClient } from "./bridge-client";
+import { CloudRuntimeProxy } from "./cloud-proxy";
+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>;
+    getProxy(): CloudRuntimeProxy | null;
+    getClient(): ElizaCloudClient | null;
+    getActiveAgentId(): string | null;
+    getStatus(): CloudConnectionStatus;
+    isEnabled(): boolean;
+    private setStatus;
+}
+//# sourceMappingURL=cloud-manager.d.ts.map

package/packages/agent/src/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,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIlD,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;IAkBrB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0DpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,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"}