@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/services/app-package-modules.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from "@elizaos/core";
+import { type AppLaunchDiagnostic, type AppLaunchPreparation, type AppLaunchSessionContext, type AppRunSessionContext, type AppSessionState, type AppViewerAuthMessage } from "@elizaos/shared";
+export type { AppLaunchSessionContext, AppRunSessionContext, } from "@elizaos/shared";
+export type AppLaunchPreparationResolver = (ctx: AppLaunchSessionContext) => Promise<AppLaunchPreparation | null>;
+export type AppViewerAuthMessageResolver = (ctx: AppLaunchSessionContext) => Promise<AppViewerAuthMessage | null>;
+export type AppLaunchSessionResolver = (ctx: AppLaunchSessionContext) => Promise<AppSessionState | null>;
+export type AppRunSessionRefresher = (ctx: AppRunSessionContext) => Promise<AppSessionState | null>;
+export type AppRouteModule = {
+    handleAppRoutes?: (ctx: unknown) => Promise<boolean>;
+    prepareLaunch?: AppLaunchPreparationResolver;
+    resolveViewerAuthMessage?: AppViewerAuthMessageResolver;
+    ensureRuntimeReady?: (ctx: AppLaunchSessionContext) => Promise<void>;
+    collectLaunchDiagnostics?: (ctx: AppRunSessionContext) => Promise<AppLaunchDiagnostic[]>;
+    resolveLaunchSession?: AppLaunchSessionResolver;
+    refreshRunSession?: AppRunSessionRefresher;
+    [key: string]: unknown;
+};
+export declare function resolveWorkspacePackageDir(packageName: string): Promise<string | null>;
+export declare function packageNameToAppSlug(packageName: string): string | null;
+export declare function importAppRouteModule(appIdentifier: string): Promise<AppRouteModule | null>;
+export declare function importAppPlugin(packageName: string): Promise<Plugin | null>;
+//# sourceMappingURL=app-package-modules.d.ts.map

package/packages/agent/src/services/app-package-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-package-modules.d.ts","sourceRoot":"","sources":["../../../../../src/services/app-package-modules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAG1B,MAAM,iBAAiB,CAAC;AAIzB,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,4BAA4B,GAAG,CACzC,GAAG,EAAE,uBAAuB,KACzB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAE1C,MAAM,MAAM,4BAA4B,GAAG,CACzC,GAAG,EAAE,uBAAuB,KACzB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAE1C,MAAM,MAAM,wBAAwB,GAAG,CACrC,GAAG,EAAE,uBAAuB,KACzB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAErC,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,oBAAoB,KACtB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAC7C,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;IACxD,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,wBAAwB,CAAC,EAAE,CACzB,GAAG,EAAE,oBAAoB,KACtB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACpC,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;IAChD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAgJF,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAuBD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvE;AAmQD,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0DhC;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBxB"}

package/packages/agent/src/services/app-package-modules.js

@@ -0,0 +1,397 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { logger, resolveStateDir } from "@elizaos/core";
+import { hasAppInterface, packageNameToAppRouteSlug, } from "@elizaos/shared";
+import { readJsonFile } from "../utils/atomic-json.js";
+import { getPluginInfo } from "./registry-client.js";
+function uniquePaths(paths) {
+    const seen = new Set();
+    const ordered = [];
+    for (const candidate of paths) {
+        const resolved = path.resolve(candidate);
+        if (!seen.has(resolved)) {
+            seen.add(resolved);
+            ordered.push(resolved);
+        }
+    }
+    return ordered;
+}
+function resolveWorkspaceRoots() {
+    const envRoot = process.env.ELIZA_WORKSPACE_ROOT?.trim();
+    if (envRoot) {
+        return uniquePaths([envRoot]);
+    }
+    const cwd = process.cwd();
+    return uniquePaths([
+        cwd,
+        path.resolve(cwd, ".."),
+        path.resolve(cwd, "..", ".."),
+    ]);
+}
+function legacyAppsWorkspaceDiscoveryEnabled() {
+    const raw = process.env.ELIZA_ENABLE_LEGACY_APPS_WORKSPACE_DISCOVERY;
+    if (!raw)
+        return false;
+    const normalized = raw.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+function packageNameToDirName(packageName) {
+    return packageName.replace(/^@[^/]+\//, "");
+}
+function sanitiseInstalledPackageDirName(packageName) {
+    return packageName.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+/**
+ * Directory where the plugin-installer writes dynamically-installed plugins.
+ * Matches `packages/app-core/src/services/plugin-installer.ts::pluginsBaseDir`.
+ */
+function installedPluginsBaseDir() {
+    return path.join(resolveStateDir(), "plugins", "installed");
+}
+/**
+ * Path to a dynamically-installed plugin's actual package directory (inside
+ * `node_modules` under the install target). Returns null if not installed.
+ */
+function resolveInstalledPluginDir(packageName) {
+    const installRoot = path.join(installedPluginsBaseDir(), sanitiseInstalledPackageDirName(packageName), "node_modules", ...packageName.split("/"));
+    return fs.existsSync(path.join(installRoot, "package.json"))
+        ? installRoot
+        : null;
+}
+async function readPackageName(packageDir) {
+    try {
+        const packageJson = JSON.parse(await fs.promises.readFile(path.join(packageDir, "package.json"), "utf8"));
+        return typeof packageJson.name === "string" ? packageJson.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function resolveWorkspacePackageDirs(packageName) {
+    const dirName = packageNameToDirName(packageName);
+    const candidateDirs = [];
+    for (const workspaceRoot of resolveWorkspaceRoots()) {
+        candidateDirs.push(path.join(workspaceRoot, "plugins", dirName), path.join(workspaceRoot, "packages", dirName));
+        if (legacyAppsWorkspaceDiscoveryEnabled()) {
+            // Temporary opt-in for older external workspaces. Current Eliza app
+            // plugins live under plugins/app-* and keep @elizaos/app-* names.
+            candidateDirs.push(path.join(workspaceRoot, "apps", dirName));
+        }
+        let rootEntries = [];
+        try {
+            rootEntries = await fs.promises.readdir(workspaceRoot, {
+                withFileTypes: true,
+            });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of rootEntries) {
+            if (!entry.isDirectory() || entry.name.startsWith(".")) {
+                continue;
+            }
+            candidateDirs.push(path.join(workspaceRoot, entry.name, "plugins", dirName), path.join(workspaceRoot, entry.name, "packages", dirName));
+            if (legacyAppsWorkspaceDiscoveryEnabled()) {
+                candidateDirs.push(path.join(workspaceRoot, entry.name, "apps", dirName));
+            }
+        }
+    }
+    const matches = [];
+    for (const candidateDir of uniquePaths(candidateDirs)) {
+        if (!fs.existsSync(path.join(candidateDir, "package.json"))) {
+            continue;
+        }
+        const discoveredName = await readPackageName(candidateDir);
+        if (discoveredName === packageName) {
+            matches.push(candidateDir);
+        }
+    }
+    return matches;
+}
+export async function resolveWorkspacePackageDir(packageName) {
+    const matches = await resolveWorkspacePackageDirs(packageName);
+    return matches[0] ?? null;
+}
+async function importFirstExistingModule(candidatePaths) {
+    let lastError = null;
+    for (const candidatePath of candidatePaths) {
+        if (!fs.existsSync(candidatePath))
+            continue;
+        try {
+            return (await import(__rewriteRelativeImportExtension(pathToFileURL(candidatePath).href)));
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    if (lastError) {
+        throw lastError;
+    }
+    return null;
+}
+export function packageNameToAppSlug(packageName) {
+    return packageNameToAppRouteSlug(packageName);
+}
+async function readLocalBridgeExport(packageDir) {
+    const packageJson = await readJsonFile(path.join(packageDir, "package.json"));
+    const manifest = await readJsonFile(path.join(packageDir, "elizaos.plugin.json"));
+    const packageBridgeExport = packageJson?.elizaos?.app?.bridgeExport;
+    if (typeof packageBridgeExport === "string") {
+        return packageBridgeExport;
+    }
+    const manifestBridgeExport = manifest?.app?.bridgeExport;
+    return typeof manifestBridgeExport === "string" ? manifestBridgeExport : null;
+}
+async function resolveAppModuleTarget(appIdentifier) {
+    const trimmed = appIdentifier.trim();
+    if (!trimmed)
+        return null;
+    if (!trimmed.startsWith("@")) {
+        const registryInfo = await getPluginInfo(trimmed);
+        if (registryInfo &&
+            (hasAppInterface(registryInfo) || registryInfo.localPath)) {
+            return {
+                packageName: registryInfo.name,
+                localPath: registryInfo.localPath ?? null,
+                bridgeExport: registryInfo.appMeta?.bridgeExport ?? null,
+            };
+        }
+    }
+    const packageCandidates = trimmed.startsWith("@")
+        ? [trimmed]
+        : [`@elizaos/app-${trimmed}`, `@elizaos/plugin-${trimmed}`];
+    for (const packageName of packageCandidates) {
+        const localPath = await resolveWorkspacePackageDir(packageName);
+        if (localPath) {
+            return {
+                packageName,
+                localPath,
+                bridgeExport: await readLocalBridgeExport(localPath),
+            };
+        }
+    }
+    const registryInfo = await getPluginInfo(trimmed);
+    if (registryInfo &&
+        (hasAppInterface(registryInfo) || registryInfo.localPath)) {
+        return {
+            packageName: registryInfo.name,
+            localPath: registryInfo.localPath ?? null,
+            bridgeExport: registryInfo.appMeta?.bridgeExport ?? null,
+        };
+    }
+    return {
+        packageName: trimmed.startsWith("@") ? trimmed : null,
+        localPath: null,
+        bridgeExport: null,
+    };
+}
+function normalizeBridgeExport(bridgeExport) {
+    if (!bridgeExport)
+        return null;
+    const trimmed = bridgeExport.trim();
+    if (!trimmed.startsWith("./") || trimmed.length <= 2) {
+        return null;
+    }
+    return trimmed;
+}
+function buildLocalBridgeCandidates(localPath, bridgeExport) {
+    const normalized = normalizeBridgeExport(bridgeExport);
+    if (!normalized) {
+        return [];
+    }
+    const relativePath = normalized.slice(2);
+    const hasExtension = /\.[cm]?[jt]s$/.test(relativePath);
+    const candidates = new Set();
+    const add = (candidate) => {
+        candidates.add(path.join(localPath, candidate));
+    };
+    if (hasExtension) {
+        add(relativePath);
+        add(path.join("src", relativePath));
+        add(path.join("dist", relativePath.replace(/\.ts$/, ".js")));
+    }
+    else {
+        add(`${relativePath}.ts`);
+        add(`${relativePath}.js`);
+        add(path.join("src", `${relativePath}.ts`));
+        add(path.join("src", `${relativePath}.js`));
+        add(path.join("dist", `${relativePath}.js`));
+    }
+    return [...candidates];
+}
+function bridgeExportToSpecifier(packageName, bridgeExport) {
+    const normalized = normalizeBridgeExport(bridgeExport);
+    if (!normalized) {
+        return null;
+    }
+    return `${packageName}/${normalized.slice(2)}`;
+}
+async function importLocalAppRouteModule(appIdentifier) {
+    const resolved = await resolveAppModuleTarget(appIdentifier);
+    const localPath = resolved?.localPath ?? null;
+    if (!localPath)
+        return null;
+    const candidatePaths = [
+        ...buildLocalBridgeCandidates(localPath, resolved?.bridgeExport ?? null),
+        path.join(localPath, "src", "app.ts"),
+        path.join(localPath, "src", "app.js"),
+        path.join(localPath, "dist", "app.js"),
+        path.join(localPath, "src", "routes.ts"),
+        path.join(localPath, "src", "routes.js"),
+        path.join(localPath, "dist", "routes.js"),
+    ];
+    return importFirstExistingModule(candidatePaths);
+}
+async function importLocalAppPluginModule(packageName) {
+    const resolved = await resolveAppModuleTarget(packageName);
+    const localPaths = [];
+    if (resolved?.localPath) {
+        localPaths.push(resolved.localPath);
+    }
+    for (const dir of await resolveWorkspacePackageDirs(packageName)) {
+        if (!localPaths.includes(dir)) {
+            localPaths.push(dir);
+        }
+    }
+    const installedDir = resolveInstalledPluginDir(packageName);
+    if (installedDir && !localPaths.includes(installedDir)) {
+        localPaths.push(installedDir);
+    }
+    if (localPaths.length === 0)
+        return null;
+    let firstModule = null;
+    let lastError = null;
+    for (const localPath of localPaths) {
+        const candidatePaths = [
+            path.join(localPath, "src", "index.ts"),
+            path.join(localPath, "src", "index.js"),
+            path.join(localPath, "dist", "index.js"),
+        ];
+        let mod = null;
+        try {
+            mod = await importFirstExistingModule(candidatePaths);
+        }
+        catch (err) {
+            lastError = err;
+            logger.warn(`[app-package-modules] Failed to import plugin from ${localPath}: ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        if (!mod)
+            continue;
+        if (firstModule === null) {
+            firstModule = mod;
+        }
+        if (resolvePluginExport(mod, packageName)) {
+            return mod;
+        }
+    }
+    if (firstModule) {
+        return firstModule;
+    }
+    if (lastError) {
+        throw lastError;
+    }
+    return null;
+}
+function isPluginLike(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "name" in value &&
+        typeof value.name === "string");
+}
+function resolvePluginExport(module, packageName) {
+    if (isPluginLike(module.default)) {
+        return module.default;
+    }
+    for (const value of Object.values(module)) {
+        if (isPluginLike(value) && value.name === packageName) {
+            return value;
+        }
+    }
+    return null;
+}
+function resolvePluginAppBridge(plugin) {
+    if (!plugin || typeof plugin !== "object") {
+        return null;
+    }
+    const bridge = plugin.appBridge;
+    if (!bridge || typeof bridge !== "object") {
+        return null;
+    }
+    return bridge;
+}
+export async function importAppRouteModule(appIdentifier) {
+    const resolved = await resolveAppModuleTarget(appIdentifier);
+    const packageName = resolved?.packageName ?? null;
+    const label = packageName ?? appIdentifier;
+    try {
+        // Prefer workspace-local route modules before built-ins so checked-out app
+        // plugins can intentionally override the packaged bridge during local
+        // development. This lookup is repo/workspace-scoped rather than install-
+        // directory scoped, so accidental shadowing stays limited to active dev
+        // workspaces.
+        const localModule = await importLocalAppRouteModule(appIdentifier);
+        if (localModule) {
+            return localModule;
+        }
+    }
+    catch (err) {
+        logger.warn(`[app-package-modules] Failed to import local routes for ${label}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!packageName) {
+        return null;
+    }
+    const bridgeSpecifier = bridgeExportToSpecifier(packageName, resolved?.bridgeExport ?? null);
+    if (bridgeSpecifier) {
+        try {
+            return (await import(__rewriteRelativeImportExtension(
+            /* webpackIgnore: true */ bridgeSpecifier)));
+        }
+        catch {
+            // Fall through to canonical app/routes entrypoints.
+        }
+    }
+    try {
+        return (await import(__rewriteRelativeImportExtension(
+        /* webpackIgnore: true */ `${packageName}/app`)));
+    }
+    catch {
+        // Fall through to legacy routes entrypoint / plugin export bridge.
+    }
+    try {
+        return (await import(__rewriteRelativeImportExtension(
+        /* webpackIgnore: true */ `${packageName}/routes`)));
+    }
+    catch {
+        const plugin = await importAppPlugin(packageName);
+        return resolvePluginAppBridge(plugin);
+    }
+}
+export async function importAppPlugin(packageName) {
+    try {
+        const localModule = await importLocalAppPluginModule(packageName);
+        if (localModule) {
+            return resolvePluginExport(localModule, packageName);
+        }
+    }
+    catch (err) {
+        logger.warn(`[app-package-modules] Failed to import local plugin for ${packageName}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        const packageModule = (await import(__rewriteRelativeImportExtension(
+        /* webpackIgnore: true */ packageName)));
+        return resolvePluginExport(packageModule, packageName);
+    }
+    catch {
+        return null;
+    }
+}

package/packages/agent/src/services/app-run-store.d.ts

@@ -0,0 +1,6 @@
+import type { AppRunSummary } from "@elizaos/shared";
+export declare function resolveAppRunStoreFilePath(stateDir?: string): string;
+export declare function resolveLegacyAppRunStoreFilePath(stateDir?: string): string;
+export declare function readAppRunStore(stateDir?: string): AppRunSummary[];
+export declare function writeAppRunStore(runs: AppRunSummary[], stateDir?: string): AppRunSummary[];
+//# sourceMappingURL=app-run-store.d.ts.map

package/packages/agent/src/services/app-run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-run-store.d.ts","sourceRoot":"","sources":["../../../../../src/services/app-run-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,aAAa,EAId,MAAM,iBAAiB,CAAC;AA2kBzB,wBAAgB,0BAA0B,CACxC,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAER;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAER;AA2BD,wBAAgB,eAAe,CAC7B,QAAQ,GAAE,MAA0B,GACnC,aAAa,EAAE,CA6BjB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EAAE,EACrB,QAAQ,GAAE,MAA0B,GACnC,aAAa,EAAE,CAWjB"}