@elizaos/agent 0.25.9 → 2.0.0-alpha.84

package/packages/agent/src/runtime/cloud-onboarding.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Cloud onboarding flow for Eliza Cloud integration.
+ *
+ * Handles availability check → browser-based auth → agent provisioning
+ * during `runFirstTimeSetup()`. Extracted to keep `eliza.ts` manageable.
+ *
+ * @module cloud-onboarding
+ */
+/** Lazy-loaded @clack/prompts module type (matches eliza.ts pattern). */
+type ClackModule = typeof import("@clack/prompts");
+/** Style preset from onboarding-presets.ts. */
+interface StylePreset {
+    catchphrase: string;
+    hint?: string;
+    bio?: string[];
+    system?: string;
+    style?: {
+        all?: string[];
+        chat?: string[];
+        post?: string[];
+    };
+    adjectives?: string[];
+    topics?: string[];
+    postExamples?: string[];
+    messageExamples?: Array<Array<{
+        user: string;
+        content: {
+            text: string;
+        };
+    }>>;
+}
+/** Result of a successful cloud onboarding flow. */
+export interface CloudOnboardingResult {
+    apiKey: string;
+    agentId: string | undefined;
+    baseUrl: string;
+    bridgeUrl?: string;
+}
+/**
+ * Quick pre-flight check: is Eliza Cloud accepting new agents?
+ * Returns null if available, or an error message string if not.
+ */
+export declare function checkCloudAvailability(baseUrl: string): Promise<string | null>;
+/**
+ * Run the full cloud onboarding flow:
+ * 1. Check availability
+ * 2. Authenticate via browser
+ * 3. Create + provision agent
+ *
+ * Returns the result or null if the user cancels / an error occurs.
+ * On failure, the caller should fall back to local mode.
+ */
+export declare function runCloudOnboarding(clack: ClackModule, agentName: string, preset?: StylePreset, baseUrl?: string): Promise<CloudOnboardingResult | null>;
+export {};
+//# sourceMappingURL=cloud-onboarding.d.ts.map

package/packages/agent/src/runtime/cloud-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-onboarding.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/cloud-onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,yEAAyE;AACzE,KAAK,WAAW,GAAG,cAAc,gBAAgB,CAAC,CAAC;AAEnD,+CAA+C;AAC/C,UAAU,WAAW;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC,CAAC;CAC7E;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BxB;AAqJD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA8DvC"}

package/packages/agent/src/runtime/cloud-onboarding.js

@@ -0,0 +1,279 @@
+/**
+ * Cloud onboarding flow for Eliza Cloud integration.
+ *
+ * Handles availability check → browser-based auth → agent provisioning
+ * during `runFirstTimeSetup()`. Extracted to keep `eliza.ts` manageable.
+ *
+ * @module cloud-onboarding
+ */
+import { logger } from "@elizaos/core";
+import { cloudLogin } from "../cloud/auth";
+import { normalizeCloudSiteUrl } from "../cloud/base-url";
+import { ElizaCloudClient, } from "../cloud/bridge-client";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_CLOUD_BASE_URL = "https://www.elizacloud.ai";
+const PROVISION_TIMEOUT_MS = 120_000; // 2 minutes
+const PROVISION_POLL_INTERVAL_MS = 3_000;
+// ---------------------------------------------------------------------------
+// Availability check
+// ---------------------------------------------------------------------------
+/**
+ * Quick pre-flight check: is Eliza Cloud accepting new agents?
+ * Returns null if available, or an error message string if not.
+ */
+export async function checkCloudAvailability(baseUrl) {
+    try {
+        const url = `${normalizeCloudSiteUrl(baseUrl)}/api/compat/availability`;
+        const res = await fetch(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            return `Cloud returned HTTP ${res.status}. It may be temporarily unavailable.`;
+        }
+        const body = (await res.json());
+        if (!body.success || !body.data?.acceptingNewAgents) {
+            return "Eliza Cloud is currently at capacity. Try again later or run locally.";
+        }
+        return null; // Available!
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("timed out") || msg.includes("timeout")) {
+            return "Could not reach Eliza Cloud (request timed out). Check your internet connection.";
+        }
+        return `Could not reach Eliza Cloud: ${msg}`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Cloud auth wrapper (with clack UI)
+// ---------------------------------------------------------------------------
+/**
+ * Run the Eliza Cloud browser-based login, wrapped with clack spinners.
+ * Returns the API key/result or null if the user wants to fall back.
+ */
+async function runCloudAuth(clack, baseUrl) {
+    const spinner = clack.spinner();
+    spinner.start("Connecting to Eliza Cloud...");
+    try {
+        const result = await cloudLogin({
+            baseUrl,
+            timeoutMs: 300_000, // 5 minutes
+            onBrowserUrl: (url) => {
+                spinner.stop("Opening your browser to log in...");
+                clack.log.info(`If the browser didn't open, visit:\n  ${url}`);
+                // Try to open the browser
+                openBrowser(url).catch(() => {
+                    // Fallback: user can manually navigate
+                });
+                // Restart spinner for polling
+                spinner.start("Waiting for login in browser...");
+            },
+            onPollStatus: (status) => {
+                if (status === "pending") {
+                    spinner.message("Waiting for login in browser...");
+                }
+            },
+        });
+        spinner.stop("✓ Logged in to Eliza Cloud!");
+        return result;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        spinner.stop(`Login failed: ${msg}`);
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Agent provisioning
+// ---------------------------------------------------------------------------
+/**
+ * Create and provision a cloud agent, polling until it's running.
+ * Returns the agent ID or null if provisioning fails.
+ */
+async function provisionCloudAgent(clack, client, agentName, preset) {
+    const spinner = clack.spinner();
+    spinner.start("Creating your cloud agent...");
+    try {
+        // Build the agent config from the chosen style preset
+        const agentConfig = {};
+        if (preset) {
+            agentConfig.bio = preset.bio;
+            agentConfig.system = preset.system;
+            agentConfig.style = preset.style;
+            agentConfig.adjectives = preset.adjectives;
+            agentConfig.topics = preset.topics;
+            agentConfig.postExamples = preset.postExamples;
+            agentConfig.messageExamples = preset.messageExamples;
+        }
+        const params = {
+            agentName,
+            agentConfig,
+        };
+        const agent = await client.createAgent(params);
+        const agentId = agent.id;
+        spinner.message("Agent created! Provisioning cloud environment...");
+        // Poll for running status
+        const deadline = Date.now() + PROVISION_TIMEOUT_MS;
+        let lastStatus = agent.status;
+        while (Date.now() < deadline) {
+            await sleep(PROVISION_POLL_INTERVAL_MS);
+            try {
+                const current = await client.getAgent(agentId);
+                lastStatus = current.status;
+                switch (lastStatus) {
+                    case "running":
+                    case "completed":
+                        spinner.stop(`☁️  Cloud agent "${agentName}" is running!`);
+                        return { agentId, bridgeUrl: current.bridgeUrl };
+                    case "failed":
+                    case "error":
+                        spinner.stop(`Provisioning failed: ${current.errorMessage ?? "unknown error"}`);
+                        return null;
+                    case "queued":
+                        spinner.message("Queued — waiting for available slot...");
+                        break;
+                    case "provisioning":
+                        spinner.message("Provisioning cloud environment...");
+                        break;
+                    default:
+                        spinner.message(`Status: ${lastStatus}...`);
+                }
+            }
+            catch (pollErr) {
+                // Transient polling error — keep trying
+                logger.debug(`[cloud-onboarding] Poll error: ${pollErr instanceof Error ? pollErr.message : pollErr}`);
+            }
+        }
+        // Timed out
+        spinner.stop(`Provisioning timed out (last status: ${lastStatus}). The agent may still be starting up.`);
+        // Return the ID anyway — user can reconnect later
+        return { agentId };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        spinner.stop(`Failed to create cloud agent: ${msg}`);
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Main orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Run the full cloud onboarding flow:
+ * 1. Check availability
+ * 2. Authenticate via browser
+ * 3. Create + provision agent
+ *
+ * Returns the result or null if the user cancels / an error occurs.
+ * On failure, the caller should fall back to local mode.
+ */
+export async function runCloudOnboarding(clack, agentName, preset, baseUrl) {
+    const resolvedBaseUrl = normalizeCloudSiteUrl(baseUrl ?? DEFAULT_CLOUD_BASE_URL);
+    // ── Step 1: Availability check ──────────────────────────────────────
+    const unavailableReason = await checkCloudAvailability(resolvedBaseUrl);
+    if (unavailableReason) {
+        clack.log.warn(unavailableReason);
+        const fallback = await clack.confirm({
+            message: "Run locally instead?",
+            initialValue: true,
+        });
+        if (clack.isCancel(fallback) || fallback) {
+            return null; // Fall back to local
+        }
+        // User said "no" to fallback — try auth anyway (maybe availability is
+        // temporarily wrong).
+    }
+    // ── Step 2: Browser-based auth ──────────────────────────────────────
+    const authResult = await runCloudAuth(clack, resolvedBaseUrl);
+    if (!authResult) {
+        clack.log.warn("Cloud login was not completed.");
+        const retry = await clack.confirm({
+            message: "Try again, or run locally?",
+            active: "Try again",
+            inactive: "Run locally",
+            initialValue: false,
+        });
+        if (clack.isCancel(retry) || !retry) {
+            return null; // Fall back to local
+        }
+        // Retry auth once
+        const retryResult = await runCloudAuth(clack, resolvedBaseUrl);
+        if (!retryResult) {
+            clack.log.warn("Login was not completed. Falling back to local mode.");
+            return null;
+        }
+        // Use retry result
+        return await finishProvisioning(clack, resolvedBaseUrl, retryResult, agentName, preset);
+    }
+    return await finishProvisioning(clack, resolvedBaseUrl, authResult, agentName, preset);
+}
+/**
+ * Complete provisioning after successful auth.
+ */
+async function finishProvisioning(clack, baseUrl, authResult, agentName, preset) {
+    // ── Step 3: Create + provision agent ──────────────────────────────
+    const client = new ElizaCloudClient(baseUrl, authResult.apiKey);
+    const provisionResult = await provisionCloudAgent(clack, client, agentName, preset);
+    if (!provisionResult) {
+        clack.log.warn("Cloud provisioning did not complete. You can try `eliza cloud connect` later.");
+        const runLocal = await clack.confirm({
+            message: "Continue with local setup instead?",
+            initialValue: true,
+        });
+        if (clack.isCancel(runLocal) || runLocal) {
+            return null;
+        }
+        // User doesn't want local either — just return the auth result
+        // so config is saved (they can reconnect later)
+        return {
+            apiKey: authResult.apiKey,
+            agentId: undefined, // No agent provisioned yet
+            baseUrl,
+        };
+    }
+    return {
+        apiKey: authResult.apiKey,
+        agentId: provisionResult.agentId,
+        baseUrl,
+        bridgeUrl: provisionResult.bridgeUrl,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Try to open a URL in the user's default browser.
+ * Falls back silently — the URL is also printed to the terminal.
+ *
+ * Uses execFile with an args array (not exec with string interpolation)
+ * to avoid shell injection via crafted URLs.
+ */
+async function openBrowser(url) {
+    const { execFile } = await import("node:child_process");
+    const { platform } = await import("node:os");
+    const p = platform();
+    return new Promise((resolve) => {
+        const onError = (err) => {
+            if (err) {
+                logger.debug(`[cloud-onboarding] Failed to open browser: ${err.message}`);
+            }
+            resolve();
+        };
+        if (p === "darwin") {
+            execFile("open", [url], onError);
+        }
+        else if (p === "win32") {
+            execFile("cmd.exe", ["/c", "start", "", url], onError);
+        }
+        else {
+            execFile("xdg-open", [url], onError);
+        }
+    });
+}

package/packages/agent/src/runtime/core-plugins.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core plugin package lists shared by runtime startup and the API server.
+ *
+ * Keeping this in a standalone module avoids a circular dependency between
+ * `api/server.ts` and `runtime/eliza.ts`.
+ */
+/** Core plugins that should always be loaded. collectPluginNames() seeds from this list only. */
+export declare const CORE_PLUGINS: readonly string[];
+/**
+ * Plugins that can be enabled from the admin panel.
+ * Not loaded by default — require explicit configuration or have platform dependencies.
+ */
+export declare const OPTIONAL_CORE_PLUGINS: readonly string[];
+//# sourceMappingURL=core-plugins.d.ts.map

package/packages/agent/src/runtime/core-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-plugins.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/core-plugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iGAAiG;AACjG,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAiBzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAqBlD,CAAC"}

package/packages/agent/src/runtime/core-plugins.js

@@ -0,0 +1,51 @@
+/**
+ * Core plugin package lists shared by runtime startup and the API server.
+ *
+ * Keeping this in a standalone module avoids a circular dependency between
+ * `api/server.ts` and `runtime/eliza.ts`.
+ */
+/** Core plugins that should always be loaded. collectPluginNames() seeds from this list only. */
+export const CORE_PLUGINS = [
+    "@elizaos/plugin-sql", // database adapter — required
+    "@elizaos/plugin-local-embedding", // local embeddings — required for memory
+    "@elizaos/plugin-secrets-manager", // secrets management — load early, other plugins depend on it
+    "@elizaos/plugin-form", // form handling for guided user journeys
+    "@elizaos/plugin-knowledge", // RAG knowledge management — required for knowledge tab
+    "@elizaos/plugin-rolodex", // contact graph and relationship/social memory
+    "@elizaos/plugin-trajectory-logger", // trajectory logging for debugging and RL training
+    "@elizaos/plugin-agent-orchestrator", // multi-agent orchestration (PTY, SwarmCoordinator, workspace provisioning)
+    "@elizaos/plugin-cron", // scheduled jobs and automation
+    "@elizaos/plugin-shell", // shell command execution
+    "@elizaos/plugin-plugin-manager", // dynamic plugin management
+    "@elizaos/plugin-agent-skills", // skill execution and marketplace runtime
+    "@elizaos/plugin-trust", // trust scoring and policy signals
+    "@elizaos/plugin-todo", // todo/task management
+    "@elizaos/plugin-personality", // personality coherence
+    "@elizaos/plugin-experience", // learning from interactions
+];
+/**
+ * Plugins that can be enabled from the admin panel.
+ * Not loaded by default — require explicit configuration or have platform dependencies.
+ */
+export const OPTIONAL_CORE_PLUGINS = [
+    "@elizaos/plugin-pdf", // PDF processing (published bundle broken in alpha.15)
+    "@elizaos/plugin-cua", // CUA computer-use agent (cloud sandbox automation)
+    "@elizaos/plugin-obsidian", // Obsidian vault CLI integration
+    "@elizaos/plugin-code", // code writing and file operations
+    "@elizaos/plugin-repoprompt", // RepoPrompt CLI integration and workflow orchestration
+    "@elizaos/plugin-claude-code-workbench", // Claude Code companion workflows for this monorepo
+    "@elizaos/plugin-computeruse", // computer use automation (requires platform-specific binaries)
+    "@elizaos/plugin-browser", // browser automation (requires stagehand-server)
+    "@elizaos/plugin-vision", // vision/image understanding (feature-gated)
+    "@elizaos/plugin-cli", // CLI interface
+    "@elizaos/plugin-discord", // Discord bot integration
+    "@elizaos/plugin-telegram", // Telegram bot integration
+    "@elizaos/plugin-twitch", // Twitch integration
+    "@elizaos/plugin-edge-tts", // text-to-speech (Microsoft Edge TTS)
+    "@elizaos/plugin-elevenlabs", // ElevenLabs text-to-speech
+    // "@elizaos/plugin-directives", // directive processing - not yet ready
+    // "@elizaos/plugin-commands", // slash command handling - not yet ready
+    // "@elizaos/plugin-mcp", // MCP protocol support - not yet ready
+    // "@elizaos/plugin-scheduling", // scheduling - not yet ready
+    // "@elizaos/plugin-scratchpad", // scratchpad notes - not yet ready
+];

package/packages/agent/src/runtime/custom-actions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Custom Actions runtime loader.
+ *
+ * Converts `CustomActionDef[]` from config into elizaOS `Action[]` objects
+ * so the agent can use them in conversations.
+ *
+ * @module runtime/custom-actions
+ */
+import type { Action, IAgentRuntime } from "@elizaos/core";
+import type { CustomActionDef } from "../config/types.eliza";
+/**
+ * Store the runtime reference so we can hot-register actions later.
+ * Called once from plugin.init().
+ */
+export declare function setCustomActionsRuntime(runtime: IAgentRuntime): void;
+/**
+ * Hot-register a CustomActionDef into the running agent.
+ * Returns the elizaOS Action that was registered, or null if no runtime.
+ */
+export declare function registerCustomActionLive(def: CustomActionDef): Action | null;
+type ResolvedUrlTarget = {
+    parsed: URL;
+    hostname: string;
+    pinnedAddress: string;
+};
+type PinnedFetchInput = {
+    url: URL;
+    init: RequestInit;
+    target: ResolvedUrlTarget;
+    timeoutMs: number;
+};
+type PinnedFetchImpl = (input: PinnedFetchInput) => Promise<Response>;
+export declare function __setPinnedFetchImplForTests(impl: PinnedFetchImpl | null): void;
+export declare function loadCustomActions(): Action[];
+export declare function buildTestHandler(def: CustomActionDef): (params: Record<string, string>) => Promise<{
+    ok: boolean;
+    output: string;
+}>;
+export {};
+//# sourceMappingURL=custom-actions.d.ts.map

package/packages/agent/src/runtime/custom-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-actions.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/custom-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,MAAM,EAAkB,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAS/B;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEpE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAK5E;AAoBD,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAqNtE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,GAC3B,IAAI,CAEN;AAiSD,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAQ5C;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,eAAe,GACnB,CACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE5C"}