@elizaos/agent 2.0.0-alpha.97 → 2.0.0-beta.1

package/packages/agent/src/services/version-compat.js

@@ -1,195 +0,0 @@
-/**
- * Plugin ↔ Core version compatibility validation.
- *
- * Detects version skew between @elizaos/core and plugins that depend on
- * specific core exports. This catches the class of bug where plugins on npm
- * advance past the core version, importing symbols that don't exist yet in
- * the installed core — causing silent import failures that take down every
- * model provider.
- *
- * @see https://github.com/elizaos/eliza/issues/10
- */
-/**
- * Plugins that provide AI model capabilities. If ALL of these fail to load
- * the agent is completely non-functional — no responses can be generated.
- */
-export const AI_PROVIDER_PLUGINS = [
-    "@elizaos/plugin-anthropic",
-    "@elizaos/plugin-openai",
-    "@elizaos/plugin-openrouter",
-    "@elizaos/plugin-ollama",
-    "@elizaos/plugin-google-genai",
-    "@elizaos/plugin-groq",
-    "@elizaos/plugin-xai",
-    "@homunculuslabs/plugin-zai",
-    "@elizaos/plugin-pi-ai",
-    "@elizaos/plugin-elizacloud",
-];
-// ---------------------------------------------------------------------------
-// Semver comparison (simplified for alpha tags)
-// ---------------------------------------------------------------------------
-/**
- * Parse a semver string (including pre-release tags) into a comparable tuple.
- * Returns null for unparseable versions.
- *
- * Examples:
- *   "2.0.0-alpha.3"          → [2, 0, 0, 3]
- *   "2.0.0-alpha.4"          → [2, 0, 0, 4]
- *   "2.0.0-nightly.20260208" → [2, 0, 0, 20260208]
- *   "2.0.0"                  → [2, 0, 0, Infinity]  (release beats any pre-release)
- *
- * Note: comparisons are only meaningful within the same pre-release tag type
- * (alpha vs alpha, nightly vs nightly). Cross-tag comparisons (alpha.7 vs beta.1)
- * compare only the numeric suffix, which may not reflect the intended ordering.
- * The update checker always compares within the same channel, so this is safe.
- */
-export function parseSemver(version) {
-    const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-(?:alpha|beta|rc|nightly)\.(\d+))?$/);
-    if (!match)
-        return null;
-    const major = Number(match[1]);
-    const minor = Number(match[2]);
-    const patch = Number(match[3]);
-    // A release without a pre-release tag sorts after any pre-release.
-    const pre = match[4] !== undefined ? Number(match[4]) : Number.POSITIVE_INFINITY;
-    return [major, minor, patch, pre];
-}
-/**
- * Compare two semver strings. Returns:
- *   -1 if a < b
- *    0 if a === b
- *    1 if a > b
- *   null if either version is unparseable.
- */
-export function compareSemver(a, b) {
-    const pa = parseSemver(a);
-    const pb = parseSemver(b);
-    if (!pa || !pb)
-        return null;
-    for (let i = 0; i < 4; i++) {
-        if (pa[i] < pb[i])
-            return -1;
-        if (pa[i] > pb[i])
-            return 1;
-    }
-    return 0;
-}
-/**
- * Check if `installed` version satisfies `>= required`.
- */
-export function versionSatisfies(installed, required) {
-    const cmp = compareSemver(installed, required);
-    return cmp !== null && cmp >= 0;
-}
-// ---------------------------------------------------------------------------
-// Core export probing
-// ---------------------------------------------------------------------------
-/**
- * Check whether a specific named export exists in `@elizaos/core`.
- *
- * This does a live import check — it tests the *actual* installed module,
- * not a version number lookup.
- */
-export async function coreExportExists(exportName) {
-    try {
-        const core = (await import("@elizaos/core"));
-        return exportName in core && core[exportName] !== undefined;
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === "MODULE_NOT_FOUND" || code === "ERR_MODULE_NOT_FOUND") {
-            return false;
-        }
-        throw err;
-    }
-}
-/**
- * Read the installed version of a package from its package.json.
- * Returns null if the package is not installed or the version is unreadable.
- */
-export async function getInstalledVersion(packageName) {
-    try {
-        // Dynamic import of package.json is not universally supported, so we
-        // use createRequire as a robust fallback for reading metadata.
-        const { createRequire } = await import("node:module");
-        const require = createRequire(import.meta.url);
-        const pkgPath = require.resolve(`${packageName}/package.json`);
-        const { readFileSync } = await import("node:fs");
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-        return pkg.version ?? null;
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === "MODULE_NOT_FOUND" ||
-            code === "ERR_MODULE_NOT_FOUND" ||
-            code === "ENOENT") {
-            return null;
-        }
-        throw err;
-    }
-}
-// ---------------------------------------------------------------------------
-// Validation
-// ---------------------------------------------------------------------------
-/**
- * Validate a single plugin's compatibility with the installed core.
- */
-export async function validatePluginCompat(pluginName, coreVersion) {
-    const missingExports = [];
-    const pluginVersion = await getInstalledVersion(pluginName);
-    const compatible = missingExports.length === 0;
-    let message = "";
-    if (!compatible) {
-        message =
-            `${pluginName}${pluginVersion ? `@${pluginVersion}` : ""} requires ` +
-                `${missingExports.join(", ")} from @elizaos/core, but the installed ` +
-                `core@${coreVersion} does not export ${missingExports.length === 1 ? "it" : "them"}. ` +
-                `Pin this plugin to a version compatible with core@${coreVersion}, or upgrade core.`;
-    }
-    return {
-        plugin: pluginName,
-        compatible,
-        pluginVersion,
-        coreVersion,
-        missingExports,
-        message,
-    };
-}
-/**
- * After plugin resolution, check whether at least one AI provider plugin
- * loaded successfully. If none loaded, return a diagnostic message explaining
- * whether this is a version-skew issue or a configuration issue.
- *
- * @param loadedPluginNames - Names of plugins that loaded successfully.
- * @param failedPlugins - Names + error strings of plugins that failed to load.
- */
-export function diagnoseNoAIProvider(loadedPluginNames, failedPlugins) {
-    const loadedProviders = loadedPluginNames.filter((n) => AI_PROVIDER_PLUGINS.includes(n));
-    // At least one AI provider loaded — no issue.
-    if (loadedProviders.length > 0)
-        return null;
-    // Check if any AI provider plugins were attempted but failed.
-    const failedProviders = failedPlugins.filter((f) => AI_PROVIDER_PLUGINS.includes(f.name));
-    if (failedProviders.length === 0) {
-        return ("No AI provider plugin was loaded. Set an API key environment variable " +
-            "(e.g. ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY) or log in " +
-            "to Eliza Cloud (ELIZAOS_CLOUD_API_KEY) to enable at least one model provider.");
-    }
-    // Check for the specific version-skew signature.
-    const versionSkewPlugins = failedProviders.filter((f) => f.error.includes("not found in module") ||
-        f.error.includes("Export named") ||
-        f.error.includes("does not provide an export named"));
-    if (versionSkewPlugins.length > 0) {
-        const names = versionSkewPlugins.map((f) => f.name).join(", ");
-        return (`Version skew detected: ${names} failed to import required symbols from ` +
-            `@elizaos/core. This usually means the plugin version is ahead of the ` +
-            `installed core version. Pin the affected plugins to a version compatible ` +
-            `with your installed @elizaos/core, or upgrade core. ` +
-            `See: https://github.com/elizaos/eliza/issues/10`);
-    }
-    // Generic failure.
-    const details = failedProviders
-        .map((f) => `  ${f.name}: ${f.error}`)
-        .join("\n");
-    return `All AI provider plugins failed to load:\n${details}`;
-}

package/packages/agent/src/services/whatsapp-pairing.d.ts

@@ -1,41 +0,0 @@
-/**
- * WhatsApp pairing service — manages Baileys sessions for QR code authentication.
- *
- * This service is separate from `@elizaos/plugin-whatsapp` because the plugin
- * initializes during runtime startup (too late for interactive QR flow).
- * Once pairing succeeds, the auth state is persisted to disk so the plugin
- * can reconnect automatically on subsequent startups.
- */
-/** Validate accountId to prevent path traversal. Only allows alphanumeric, dash, underscore. */
-export declare function sanitizeAccountId(raw: string): string;
-export type WhatsAppPairingStatus = "idle" | "initializing" | "waiting_for_qr" | "connected" | "disconnected" | "timeout" | "error";
-export interface WhatsAppPairingEvent {
-    type: "whatsapp-qr" | "whatsapp-status";
-    accountId: string;
-    qrDataUrl?: string;
-    expiresInMs?: number;
-    status?: WhatsAppPairingStatus;
-    phoneNumber?: string;
-    error?: string;
-}
-export interface WhatsAppPairingOptions {
-    authDir: string;
-    accountId: string;
-    onEvent: (event: WhatsAppPairingEvent) => void;
-}
-export declare class WhatsAppPairingSession {
-    private socket;
-    private status;
-    private options;
-    private qrAttempts;
-    private readonly MAX_QR_ATTEMPTS;
-    private restartTimer;
-    constructor(options: WhatsAppPairingOptions);
-    start(): Promise<void>;
-    stop(): void;
-    getStatus(): WhatsAppPairingStatus;
-    private setStatus;
-}
-export declare function whatsappAuthExists(workspaceDir: string, accountId?: string): boolean;
-export declare function whatsappLogout(workspaceDir: string, accountId?: string): Promise<void>;
-//# sourceMappingURL=whatsapp-pairing.d.ts.map

package/packages/agent/src/services/whatsapp-pairing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"whatsapp-pairing.d.ts","sourceRoot":"","sources":["../../../../../src/services/whatsapp-pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,GAAG,iBAAiB,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAChD;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAEE;IAChB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IACrC,OAAO,CAAC,YAAY,CAA8C;gBAEtD,OAAO,EAAE,sBAAsB;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgH5B,IAAI,IAAI,IAAI;IAaZ,SAAS,IAAI,qBAAqB;IAIlC,OAAO,CAAC,SAAS;CAQlB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,SAAS,SAAY,GACpB,OAAO,CAQT;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,SAAS,SAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/packages/agent/src/services/whatsapp-pairing.js

@@ -1,209 +0,0 @@
-/**
- * WhatsApp pairing service — manages Baileys sessions for QR code authentication.
- *
- * This service is separate from `@elizaos/plugin-whatsapp` because the plugin
- * initializes during runtime startup (too late for interactive QR flow).
- * Once pairing succeeds, the auth state is persisted to disk so the plugin
- * can reconnect automatically on subsequent startups.
- */
-import fs from "node:fs";
-import path from "node:path";
-const LOG_PREFIX = "[whatsapp-pairing]";
-/** Validate accountId to prevent path traversal. Only allows alphanumeric, dash, underscore. */
-export function sanitizeAccountId(raw) {
-    const cleaned = raw.replace(/[^a-zA-Z0-9_-]/g, "");
-    if (!cleaned || cleaned !== raw) {
-        throw new Error(`Invalid accountId: must only contain alphanumeric characters, dashes, and underscores`);
-    }
-    return cleaned;
-}
-export class WhatsAppPairingSession {
-    socket = null;
-    status = "idle";
-    options;
-    qrAttempts = 0;
-    MAX_QR_ATTEMPTS = 5;
-    restartTimer = null;
-    constructor(options) {
-        this.options = options;
-    }
-    async start() {
-        this.setStatus("initializing");
-        const baileys = await import("@whiskeysockets/baileys");
-        const makeWASocket = baileys.default;
-        const { useMultiFileAuthState, fetchLatestBaileysVersion, DisconnectReason, } = baileys;
-        const QRCode = (await import("qrcode")).default;
-        const { Boom } = await import("@hapi/boom");
-        fs.mkdirSync(this.options.authDir, { recursive: true });
-        const { state, saveCreds } = await useMultiFileAuthState(this.options.authDir);
-        const { version } = await fetchLatestBaileysVersion();
-        const pino = (await import("pino")).default;
-        const baileysLogger = pino({ level: "silent" });
-        this.socket = makeWASocket({
-            version,
-            auth: state,
-            logger: baileysLogger,
-            printQRInTerminal: false,
-            browser: ["Eliza AI", "Desktop", "1.0.0"],
-        });
-        this.socket.ev.on("creds.update", saveCreds);
-        this.socket.ev.on("connection.update", async (update) => {
-            const { connection, lastDisconnect, qr } = update;
-            if (qr) {
-                this.qrAttempts++;
-                console.info(`${LOG_PREFIX} QR code received (attempt ${this.qrAttempts}/${this.MAX_QR_ATTEMPTS})`);
-                if (this.qrAttempts > this.MAX_QR_ATTEMPTS) {
-                    this.setStatus("timeout");
-                    this.stop();
-                    return;
-                }
-                try {
-                    const qrDataUrl = await QRCode.toDataURL(qr, {
-                        width: 256,
-                        margin: 2,
-                        color: { dark: "#000000", light: "#ffffff" },
-                    });
-                    this.setStatus("waiting_for_qr");
-                    this.options.onEvent({
-                        type: "whatsapp-qr",
-                        accountId: this.options.accountId,
-                        qrDataUrl,
-                        expiresInMs: 20_000,
-                    });
-                }
-                catch {
-                    // QR generation failure — non-fatal, next QR attempt will retry.
-                }
-            }
-            if (connection === "close") {
-                const statusCode = lastDisconnect?.error
-                    ?.output?.statusCode;
-                console.info(`${LOG_PREFIX} Connection closed, statusCode=${statusCode}, status=${this.status}`);
-                if (statusCode === DisconnectReason.loggedOut) {
-                    this.setStatus("disconnected");
-                }
-                else if (statusCode === DisconnectReason.restartRequired ||
-                    statusCode === DisconnectReason.timedOut ||
-                    statusCode === DisconnectReason.connectionClosed ||
-                    statusCode === DisconnectReason.connectionReplaced) {
-                    console.info(`${LOG_PREFIX} Restarting pairing after transient close...`);
-                    this.socket = null;
-                    this.qrAttempts = 0;
-                    this.restartTimer = setTimeout(() => {
-                        this.restartTimer = null;
-                        this.start().catch((err) => {
-                            console.error(`${LOG_PREFIX} Restart failed:`, err);
-                            this.setStatus("error");
-                            this.options.onEvent({
-                                type: "whatsapp-status",
-                                accountId: this.options.accountId,
-                                status: "error",
-                                error: err instanceof Error ? err.message : String(err),
-                            });
-                        });
-                    }, 3000);
-                }
-            }
-            else if (connection === "open") {
-                const phoneNumber = this.socket?.user?.id?.split(":")[0] ?? "";
-                this.setStatus("connected");
-                this.options.onEvent({
-                    type: "whatsapp-status",
-                    accountId: this.options.accountId,
-                    status: "connected",
-                    phoneNumber,
-                });
-            }
-        });
-    }
-    stop() {
-        if (this.restartTimer) {
-            clearTimeout(this.restartTimer);
-            this.restartTimer = null;
-        }
-        try {
-            this.socket?.end(undefined);
-        }
-        catch {
-            // Ignore cleanup errors.
-        }
-        this.socket = null;
-    }
-    getStatus() {
-        return this.status;
-    }
-    setStatus(status) {
-        this.status = status;
-        this.options.onEvent({
-            type: "whatsapp-status",
-            accountId: this.options.accountId,
-            status,
-        });
-    }
-}
-export function whatsappAuthExists(workspaceDir, accountId = "default") {
-    const credsPath = path.join(workspaceDir, "whatsapp-auth", accountId, "creds.json");
-    return fs.existsSync(credsPath);
-}
-export async function whatsappLogout(workspaceDir, accountId = "default") {
-    const authDir = path.join(workspaceDir, "whatsapp-auth", accountId);
-    const credsPath = path.join(authDir, "creds.json");
-    if (fs.existsSync(credsPath)) {
-        try {
-            const baileys = await import("@whiskeysockets/baileys");
-            const makeWASocket = baileys.default;
-            const { useMultiFileAuthState, fetchLatestBaileysVersion } = baileys;
-            const pino = (await import("pino")).default;
-            const logger = pino({ level: "silent" });
-            const { state } = await useMultiFileAuthState(authDir);
-            const { version } = await fetchLatestBaileysVersion();
-            const sock = makeWASocket({
-                version,
-                auth: state,
-                logger,
-                printQRInTerminal: false,
-            });
-            await new Promise((resolve) => {
-                let settled = false;
-                const finish = () => {
-                    if (settled)
-                        return;
-                    settled = true;
-                    clearTimeout(timeout);
-                    try {
-                        sock.ev.removeAllListeners("connection.update");
-                    }
-                    catch {
-                        /* */
-                    }
-                    try {
-                        sock.end(undefined);
-                    }
-                    catch {
-                        /* */
-                    }
-                    resolve();
-                };
-                const timeout = setTimeout(finish, 10_000);
-                sock.ev.on("connection.update", async (update) => {
-                    if (update.connection === "open") {
-                        try {
-                            await sock.logout();
-                        }
-                        catch {
-                            // May fail if already logged out remotely.
-                        }
-                        finish();
-                    }
-                    else if (update.connection === "close") {
-                        finish();
-                    }
-                });
-            });
-        }
-        catch {
-            // If Baileys can't connect, just delete files anyway.
-        }
-    }
-    fs.rmSync(authDir, { recursive: true, force: true });
-}

package/packages/agent/src/shared/ui-catalog-prompt.d.ts

@@ -1,52 +0,0 @@
-/**
- * ui-catalog-prompt.ts -- Generates a system prompt for LLMs describing
- * all available UiSpec components so they can produce valid JSON specs.
- *
- * Exports:
- *   - COMPONENT_CATALOG   — metadata for every supported component
- *   - generateCatalogPrompt(options?) — builds the system prompt string
- *   - getComponentNames()  — returns the list of component type names
- */
-interface PropMeta {
-    type: string;
-    description: string;
-    required?: boolean;
-}
-export interface ComponentMeta {
-    description: string;
-    props: Record<string, PropMeta>;
-    slots?: string[];
-}
-export declare const COMPONENT_CATALOG: Record<string, ComponentMeta>;
-/** Returns the list of all component type names in the catalog. */
-export declare function getComponentNames(): string[];
-export interface CatalogPromptOptions {
-    /** Extra rules appended to the end of the prompt. */
-    customRules?: string[];
-    /** Include a small example UiSpec at the end. */
-    includeExamples?: boolean;
-    /** Only include these component types (subset of catalog). */
-    componentFilter?: string[];
-    /**
-     * Output mode:
-     *   "generate" (default) — AI outputs ONLY JSONL patches, no prose. Use for
-     *                          standalone UI builders and playgrounds.
-     *   "chat"               — AI responds conversationally first, then emits
-     *                          JSONL patches on their own lines when UI is needed.
-     *                          Text-only replies are allowed (greetings, questions).
-     *                          Use for conversational interfaces.
-     */
-    mode?: "generate" | "chat";
-}
-/**
- * Builds a system prompt string describing the UiSpec JSON format and
- * all available components so an LLM can generate valid specs.
- *
- * Two modes:
- *   "generate" (default) — AI outputs only JSONL patches, no prose.
- *   "chat"               — AI can respond conversationally and embed JSONL
- *                          patches inline when rich UI is appropriate.
- */
-export declare function generateCatalogPrompt(options?: CatalogPromptOptions): string;
-export {};
-//# sourceMappingURL=ui-catalog-prompt.d.ts.map

package/packages/agent/src/shared/ui-catalog-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui-catalog-prompt.d.ts","sourceRoot":"","sources":["../../../../../src/shared/ui-catalog-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAqzB3D,CAAC;AAMF,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAMD,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAyQ5E"}