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

package/packages/agent/src/services/registry-client-local.js

@@ -1,7 +1,10 @@
 import fs from "node:fs/promises";
-import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { logger } from "@elizaos/core";
+import { packageNameToAppDisplayName } from "@elizaos/shared";
+import { resolveStateDir } from "../config/paths.js";
+import { readJsonFile } from "../utils/atomic-json.js";
 import { mergeAppMeta, resolveAppOverride, } from "./registry-client-app-meta.js";
 const LOCAL_PLUGIN_TAG_STOPWORDS = new Set([
     "plugin",
@@ -38,8 +41,45 @@ function resolveWorkspaceRoots() {
         path.resolve(cwd, ".."),
         path.resolve(cwd, "..", ".."),
     ].filter((candidate) => Boolean(candidate));
+    // Monorepos (e.g. Eliza) hoist `@elizaos/*` under the repo root, while this
+    // module lives in `packages/agent`. When the process cwd is deep (`apps/...`,
+    // Electrobun bundle, etc.), cwd-based roots never reach that `node_modules`.
+    // Walk up from the agent package so `getPluginInfo` can resolve vendored
+    // workspace plugins for install.
+    let walk = path.resolve(packageRoot);
+    for (let depth = 0; depth < 8; depth += 1) {
+        roots.push(walk);
+        const parent = path.dirname(walk);
+        if (parent === walk)
+            break;
+        walk = parent;
+    }
     return uniquePaths(roots);
 }
+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 isMissingPathError(err) {
+    return (err instanceof Error &&
+        "code" in err &&
+        ((err.code ?? "") === "ENOENT" ||
+            (err.code ?? "") === "ENOTDIR"));
+}
+async function readDirectoryEntries(dirPath, label, options = {}) {
+    try {
+        return await fs.readdir(dirPath, { withFileTypes: true });
+    }
+    catch (err) {
+        if (!(options.suppressMissing && isMissingPathError(err))) {
+            logger.debug(`[registry] could not read ${label} ${dirPath}: ${err}`);
+        }
+        return [];
+    }
+}
 function repoString(repo) {
     if (!repo)
         return null;
@@ -62,15 +102,6 @@ function normaliseGitHubRepo(repo) {
         return null;
     return cleaned;
 }
-async function readJsonFile(filePath) {
-    try {
-        const raw = await fs.readFile(filePath, "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
 function normalizeLocalTag(tag) {
     const normalized = tag
         .trim()
@@ -98,30 +129,68 @@ function normalizeLocalTags(values) {
     }
     return tags;
 }
-function toLocalAppMeta(app, fallbackDisplayName) {
-    if (!app)
+function toLocalAppMeta(app, fallbackDisplayName, legacy) {
+    if (!app && !legacy?.viewer && !legacy?.session)
         return undefined;
-    const launchType = app.launchType ?? "url";
+    const launchType = app?.launchType ?? (legacy?.viewer || legacy?.session ? "connect" : "url");
     return {
-        displayName: app.displayName ?? fallbackDisplayName,
-        category: app.category ?? "game",
+        displayName: app?.displayName ?? fallbackDisplayName,
+        category: app?.category ?? "game",
         launchType,
-        launchUrl: app.launchUrl ?? null,
-        icon: app.icon ?? null,
-        capabilities: app.capabilities ?? [],
-        minPlayers: app.minPlayers ?? null,
-        maxPlayers: app.maxPlayers ?? null,
-        uiExtension: app.uiExtension,
-        viewer: app.viewer,
+        launchUrl: app?.launchUrl ?? null,
+        icon: app?.icon ?? null,
+        heroImage: app?.heroImage ?? null,
+        capabilities: app?.capabilities ?? [],
+        minPlayers: app?.minPlayers ?? null,
+        maxPlayers: app?.maxPlayers ?? null,
+        runtimePlugin: app?.runtimePlugin,
+        bridgeExport: app?.bridgeExport,
+        uiExtension: app?.uiExtension,
+        viewer: app?.viewer ?? legacy?.viewer,
+        session: app?.session ?? legacy?.session,
+        developerOnly: app?.developerOnly,
+        visibleInAppStore: app?.visibleInAppStore,
+        mainTab: app?.mainTab,
     };
 }
 function toDisplayNameFromDirName(dirName) {
-    return dirName
-        .replace(/^app-/, "")
-        .split("-")
-        .filter((part) => part.length > 0)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
+    return packageNameToAppDisplayName(dirName);
+}
+function isDiscoverableAppPackage(packageJson, manifest) {
+    if (!packageJson.name)
+        return false;
+    return Boolean(packageJson.elizaos?.kind === "app" ||
+        manifest?.kind === "app" ||
+        packageJson.elizaos?.app ||
+        packageJson.elizaos?.viewer ||
+        packageJson.elizaos?.session ||
+        manifest?.app ||
+        manifest?.viewer ||
+        manifest?.session ||
+        resolveAppOverride(packageJson.name, undefined));
+}
+async function collectWorkspacePackageCandidates(searchRoot, includeTypescriptChild = false) {
+    const candidates = new Map();
+    const entries = await readDirectoryEntries(searchRoot, "workspace dir", {
+        suppressMissing: true,
+    });
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const repoDir = path.join(searchRoot, entry.name);
+        candidates.set(repoDir, {
+            packageDir: repoDir,
+            dirName: entry.name,
+        });
+        if (!includeTypescriptChild)
+            continue;
+        const typescriptDir = path.join(repoDir, "typescript");
+        candidates.set(typescriptDir, {
+            packageDir: typescriptDir,
+            dirName: entry.name,
+        });
+    }
+    return [...candidates.values()];
 }
 function parseRepositoryMetadata(repository) {
     const repoValue = repoString(repository);
@@ -134,8 +203,14 @@ function parseRepositoryMetadata(repository) {
 function buildDiscoveredEntry(packageDir, dirName, packageJson, manifest) {
     if (!packageJson?.name || packageJson.name.length === 0)
         return null;
-    const packageAppMeta = toLocalAppMeta(packageJson.elizaos?.app, toDisplayNameFromDirName(dirName));
-    const manifestAppMeta = toLocalAppMeta(manifest?.app, toDisplayNameFromDirName(dirName));
+    const packageAppMeta = toLocalAppMeta(packageJson.elizaos?.app, toDisplayNameFromDirName(dirName), {
+        viewer: packageJson.elizaos?.viewer,
+        session: packageJson.elizaos?.session,
+    });
+    const manifestAppMeta = toLocalAppMeta(manifest?.app, toDisplayNameFromDirName(dirName), {
+        viewer: manifest?.viewer,
+        session: manifest?.session,
+    });
     const mergedMeta = mergeAppMeta(manifestAppMeta, packageAppMeta);
     const overriddenMeta = resolveAppOverride(packageJson.name, mergedMeta);
     const kind = packageJson.elizaos?.kind === "app" || manifest?.kind === "app"
@@ -182,30 +257,59 @@ function buildDiscoveredEntry(packageDir, dirName, packageJson, manifest) {
 }
 async function discoverLocalWorkspaceApps() {
     const discovered = new Map();
+    const packageCandidates = new Map();
     for (const workspaceRoot of resolveWorkspaceRoots()) {
-        const pluginsDir = path.join(workspaceRoot, "plugins");
-        let entries;
-        try {
-            entries = await fs.readdir(pluginsDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
+        const discoveredRoots = new Map();
+        const addDiscoveredRoot = (root, includeTypescriptChild) => {
+            const resolvedRoot = path.resolve(root);
+            discoveredRoots.set(resolvedRoot, (discoveredRoots.get(resolvedRoot) ?? false) || includeTypescriptChild);
+        };
+        addDiscoveredRoot(path.join(workspaceRoot, "plugins"), true);
+        addDiscoveredRoot(path.join(workspaceRoot, "packages"), false);
+        addDiscoveredRoot(path.join(workspaceRoot, "eliza", "packages"), false);
+        addDiscoveredRoot(path.join(workspaceRoot, "eliza", "plugins"), true);
+        if (legacyAppsWorkspaceDiscoveryEnabled()) {
+            // Temporary opt-in for older external workspaces that still keep app
+            // plugins under apps/app-*. The current repo discovers plugins/app-* by
+            // default and must not depend on top-level apps/*.
+            addDiscoveredRoot(path.join(workspaceRoot, "apps"), false);
+            addDiscoveredRoot(path.join(workspaceRoot, "eliza", "apps"), false);
         }
-        for (const entry of entries) {
-            if ((!entry.isDirectory() && !entry.isSymbolicLink()) ||
-                !entry.name.startsWith("app-"))
-                continue;
-            const packageDir = path.join(pluginsDir, entry.name);
-            const packageJson = await readJsonFile(path.join(packageDir, "package.json"));
-            if (!packageJson)
+        const workspaceEntries = await readDirectoryEntries(workspaceRoot, "workspace root");
+        for (const entry of workspaceEntries) {
+            if (!entry.isDirectory() || entry.name.startsWith(".")) {
                 continue;
-            const manifest = await readJsonFile(path.join(packageDir, "elizaos.plugin.json"));
-            const info = buildDiscoveredEntry(packageDir, entry.name, packageJson, manifest);
-            if (info)
-                discovered.set(info.name, info);
+            }
+            const repoRoot = path.join(workspaceRoot, entry.name);
+            addDiscoveredRoot(path.join(repoRoot, "plugins"), true);
+            addDiscoveredRoot(path.join(repoRoot, "packages"), false);
+            addDiscoveredRoot(path.join(repoRoot, "eliza", "packages"), false);
+            addDiscoveredRoot(path.join(repoRoot, "eliza", "plugins"), true);
+            if (legacyAppsWorkspaceDiscoveryEnabled()) {
+                addDiscoveredRoot(path.join(repoRoot, "apps"), false);
+                addDiscoveredRoot(path.join(repoRoot, "eliza", "apps"), false);
+            }
+        }
+        for (const [root, includeTypescriptChild] of discoveredRoots) {
+            const candidates = await collectWorkspacePackageCandidates(root, includeTypescriptChild);
+            for (const candidate of candidates) {
+                packageCandidates.set(candidate.packageDir, candidate);
+            }
         }
     }
-    const stateDir = process.env.ELIZA_STATE_DIR?.trim() || path.join(os.homedir(), ".eliza");
+    for (const { packageDir, dirName } of packageCandidates.values()) {
+        const packageJson = await readJsonFile(path.join(packageDir, "package.json"));
+        if (!packageJson)
+            continue;
+        const manifest = await readJsonFile(path.join(packageDir, "elizaos.plugin.json"));
+        if (!isDiscoverableAppPackage(packageJson, manifest))
+            continue;
+        const info = buildDiscoveredEntry(packageDir, dirName, packageJson, manifest);
+        if (info && !discovered.has(info.name)) {
+            discovered.set(info.name, info);
+        }
+    }
+    const stateDir = resolveStateDir();
     const installedBase = path.join(stateDir, "plugins", "installed");
     try {
         const installedEntries = await fs.readdir(installedBase, {
@@ -230,8 +334,8 @@ async function discoverLocalWorkspaceApps() {
                                 pkgDirs.push(path.join(scopeDir, se.name));
                             }
                         }
-                        catch {
-                            // skip
+                        catch (err) {
+                            logger.debug(`[registry] could not read scope dir ${scopeDir}: ${err}`);
                         }
                     }
                     else if (nm.isDirectory() || nm.isSymbolicLink()) {
@@ -239,18 +343,19 @@ async function discoverLocalWorkspaceApps() {
                     }
                 }
             }
-            catch {
+            catch (err) {
+                logger.debug(`[registry] could not read node_modules dir ${nmDir}: ${err}`);
                 continue;
             }
             for (const pkgDir of pkgDirs) {
                 const pkgJson = await readJsonFile(path.join(pkgDir, "package.json"));
                 if (!pkgJson?.name)
                     continue;
-                if (pkgJson.elizaos?.kind !== "app")
+                const manifest = await readJsonFile(path.join(pkgDir, "elizaos.plugin.json"));
+                if (!isDiscoverableAppPackage(pkgJson, manifest))
                     continue;
                 if (discovered.has(pkgJson.name))
                     continue;
-                const manifest = await readJsonFile(path.join(pkgDir, "elizaos.plugin.json"));
                 const dirName = pkgJson.name
                     .replace(/^@[^/]+\//, "")
                     .replace(/^plugin-/, "app-");
@@ -269,13 +374,9 @@ async function discoverNodeModulePlugins() {
     const discovered = new Map();
     for (const workspaceRoot of resolveWorkspaceRoots()) {
         const elizaosDir = path.join(workspaceRoot, "node_modules", "@elizaos");
-        let entries;
-        try {
-            entries = await fs.readdir(elizaosDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
+        const entries = await readDirectoryEntries(elizaosDir, "@elizaos dir", {
+            suppressMissing: true,
+        });
         for (const entry of entries) {
             if (!entry.name.startsWith("plugin-"))
                 continue;
@@ -331,8 +432,85 @@ async function discoverNodeModulePlugins() {
     }
     return discovered;
 }
+/** Workspace-vendored `packages/plugin-*` trees (not always linked under root node_modules). */
+async function discoverPackagesFolderPlugins() {
+    const discovered = new Map();
+    for (const workspaceRoot of resolveWorkspaceRoots()) {
+        const packagesDir = path.join(workspaceRoot, "packages");
+        const entries = await readDirectoryEntries(packagesDir, "packages dir", {
+            suppressMissing: true,
+        });
+        for (const entry of entries) {
+            if (!entry.name.startsWith("plugin-"))
+                continue;
+            if (!entry.isDirectory() && !entry.isSymbolicLink())
+                continue;
+            const packageDir = path.join(packagesDir, entry.name);
+            const packageJson = await readJsonFile(path.join(packageDir, "package.json"));
+            if (!packageJson?.name)
+                continue;
+            const isPlugin = packageJson.packageType === "plugin" ||
+                packageJson.keywords?.includes("elizaos") ||
+                packageJson.elizaos !== undefined ||
+                packageJson.agentConfig !== undefined;
+            if (!isPlugin)
+                continue;
+            if (packageJson.elizaos?.kind === "app")
+                continue;
+            if (!packageJson.name.startsWith("@elizaos/plugin-"))
+                continue;
+            const repo = parseRepositoryMetadata(packageJson.repository);
+            const version = packageJson.version ?? null;
+            let localPath = packageDir;
+            try {
+                const realPath = await fs.realpath(packageDir);
+                if (realPath !== packageDir)
+                    localPath = realPath;
+            }
+            catch {
+                // fallback
+            }
+            discovered.set(packageJson.name, {
+                name: packageJson.name,
+                gitRepo: repo.gitRepo,
+                gitUrl: repo.gitUrl,
+                description: packageJson.description ?? "",
+                homepage: packageJson.homepage ?? null,
+                topics: normalizeLocalTags(packageJson.keywords),
+                stars: 0,
+                language: "TypeScript",
+                npm: {
+                    package: packageJson.name,
+                    v0Version: null,
+                    v1Version: null,
+                    v2Version: version,
+                },
+                git: {
+                    v0Branch: null,
+                    v1Branch: null,
+                    v2Branch: "main",
+                },
+                supports: { v0: false, v1: false, v2: true },
+                localPath,
+            });
+        }
+    }
+    return discovered;
+}
 export async function applyNodeModulePlugins(plugins) {
     const localPlugins = await discoverNodeModulePlugins();
+    const packagesPlugins = await discoverPackagesFolderPlugins();
+    for (const [name, info] of packagesPlugins) {
+        if (!localPlugins.has(name)) {
+            localPlugins.set(name, info);
+        }
+        else {
+            const existing = localPlugins.get(name);
+            if (existing && !existing.localPath && info.localPath) {
+                localPlugins.set(name, { ...existing, localPath: info.localPath });
+            }
+        }
+    }
     if (localPlugins.size === 0)
         return;
     for (const [name, localInfo] of localPlugins.entries()) {

package/packages/agent/src/services/registry-client-network.d.ts

@@ -1,4 +1,9 @@
-import type { RegistryPluginInfo } from "./registry-client-types.js";
+import type { RegistryPluginInfo } from "./registry-client-types.ts";
+export declare class RegistryNetworkFallbackError extends Error {
+    readonly expectedLocalFallback = true;
+    constructor(message: string);
+}
+export declare function isExpectedRegistryNetworkFallback(error: unknown): error is RegistryNetworkFallbackError;
 export declare function fetchFromNetwork(params: {
     generatedRegistryUrl: string;
     indexRegistryUrl: string;

package/packages/agent/src/services/registry-client-network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-client-network.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client-network.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,CACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB,EAAE,CACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CA+J3C"}
+{"version":3,"file":"registry-client-network.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client-network.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,qBAAqB,QAAQ;gBAE1B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CASvC;AAaD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,CACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB,EAAE,CACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAyL3C"}

package/packages/agent/src/services/registry-client-network.js

@@ -1,4 +1,29 @@
 import { createIntegrationTelemetrySpan } from "../diagnostics/integration-observability.js";
+const REGISTRY_FETCH_TIMEOUT_MS = 2_500;
+export class RegistryNetworkFallbackError extends Error {
+    expectedLocalFallback = true;
+    constructor(message) {
+        super(message);
+        this.name = "RegistryNetworkFallbackError";
+    }
+}
+export function isExpectedRegistryNetworkFallback(error) {
+    return (error instanceof RegistryNetworkFallbackError ||
+        (typeof error === "object" &&
+            error !== null &&
+            "expectedLocalFallback" in error &&
+            error.expectedLocalFallback ===
+                true));
+}
+function isExpectedRegistryNotFound(resp) {
+    return resp.status === 404;
+}
+function createRegistryFetchInit() {
+    return {
+        redirect: "error",
+        signal: AbortSignal.timeout(REGISTRY_FETCH_TIMEOUT_MS),
+    };
+}
 export async function fetchFromNetwork(params) {
     const { generatedRegistryUrl, indexRegistryUrl, applyLocalWorkspaceApps, applyNodeModulePlugins, sanitizeSandbox, } = params;
     const generatedSpan = createIntegrationTelemetrySpan({
@@ -6,7 +31,7 @@ export async function fetchFromNetwork(params) {
         operation: "fetch_generated_registry",
     });
     try {
-        const resp = await fetch(generatedRegistryUrl, { redirect: "error" });
+        const resp = await fetch(generatedRegistryUrl, createRegistryFetchInit());
         if (resp.ok) {
             const data = (await resp.json());
             const plugins = new Map();
@@ -43,9 +68,12 @@ export async function fetchFromNetwork(params) {
                         launchType: e.app.launchType,
                         launchUrl: e.app.launchUrl,
                         icon: e.app.icon,
+                        heroImage: e.app.heroImage ?? null,
                         capabilities: e.app.capabilities || [],
                         minPlayers: e.app.minPlayers ?? null,
                         maxPlayers: e.app.maxPlayers ?? null,
+                        runtimePlugin: e.app.runtimePlugin,
+                        bridgeExport: e.app.bridgeExport,
                         uiExtension: e.app.uiExtension,
                         viewer: e.app.viewer
                             ? {
@@ -53,6 +81,9 @@ export async function fetchFromNetwork(params) {
                                 sandbox: sanitizeSandbox(e.app.viewer.sandbox),
                             }
                             : undefined,
+                        session: e.app.session,
+                        developerOnly: e.app.developerOnly,
+                        visibleInAppStore: e.app.visibleInAppStore,
                     };
                 }
                 plugins.set(name, info);
@@ -62,7 +93,12 @@ export async function fetchFromNetwork(params) {
             generatedSpan.success({ statusCode: resp.status });
             return plugins;
         }
-        generatedSpan.failure({ statusCode: resp.status, errorKind: "http_error" });
+        if (!isExpectedRegistryNotFound(resp)) {
+            generatedSpan.failure({
+                statusCode: resp.status,
+                errorKind: "http_error",
+            });
+        }
     }
     catch (err) {
         generatedSpan.failure({ error: err });
@@ -74,15 +110,17 @@ export async function fetchFromNetwork(params) {
     });
     let resp;
     try {
-        resp = await fetch(indexRegistryUrl, { redirect: "error" });
+        resp = await fetch(indexRegistryUrl, createRegistryFetchInit());
     }
     catch (err) {
         indexSpan.failure({ error: err });
         throw err;
     }
     if (!resp.ok) {
-        indexSpan.failure({ statusCode: resp.status, errorKind: "http_error" });
-        throw new Error(`index.json: ${resp.status} ${resp.statusText}`);
+        if (!isExpectedRegistryNotFound(resp)) {
+            indexSpan.failure({ statusCode: resp.status, errorKind: "http_error" });
+        }
+        throw new RegistryNetworkFallbackError(`index.json: ${resp.status} ${resp.statusText}`);
     }
     const data = (await resp.json());
     const plugins = new Map();

package/packages/agent/src/services/registry-client-queries.d.ts

@@ -1,14 +1,25 @@
-import type { RegistryAppInfo, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult } from "./registry-client-types.js";
+import type { RegistryAppInfo, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult } from "./registry-client-types.ts";
 export declare function normalizePluginLookupAlias(name: string): string;
 export declare function getPluginInfoFromRegistry(registry: Map<string, RegistryPluginInfo>, name: string): RegistryPluginInfo | null;
-export declare function scoreEntries(entries: Iterable<RegistryPluginInfo>, query: string, limit: number, extraNames?: (p: RegistryPluginInfo) => string[], extraTerms?: (p: RegistryPluginInfo) => string[]): Array<{
-    p: RegistryPluginInfo;
+export declare function scoreEntries<T extends RegistryPluginInfo>(entries: Iterable<T>, query: string, limit: number, extraNames?: (p: T) => string[], extraTerms?: (p: T) => string[]): Array<{
+    p: T;
     s: number;
 }>;
-export declare function toSearchResults(results: Array<{
-    p: RegistryPluginInfo;
+export declare function toSearchResults<T extends RegistryPluginInfo>(results: Array<{
+    p: T;
     s: number;
 }>): RegistrySearchResult[];
+/**
+ * Resolve a declared `heroImage` value to a URL the client can load.
+ *
+ * Accepts three shapes:
+ *   - null / empty → `/api/apps/hero/<slug>` for generated fallback art
+ *   - absolute URL / data URL / already-rooted `/api/...` or `/...` path → returned as-is
+ *   - package-relative path (e.g. `"assets/hero.png"`) → rewritten to
+ *     `/api/apps/hero/<slug>` so the runtime can stream it from the app's
+ *     local package directory or synthesize fallback art
+ */
+export declare function resolveAppHeroImage(packageName: string, heroImage: string | null | undefined): string | null;
 export declare function toAppInfo(p: RegistryPluginInfo, sanitizeSandbox: (value?: string) => string, defaultSandbox: string): RegistryAppInfo;
 export declare function toAppEntry(p: RegistryPluginInfo, resolveAppOverride: (packageName: string, appMeta: RegistryPluginInfo["appMeta"]) => RegistryPluginInfo["appMeta"]): RegistryPluginInfo | null;
 export declare function toPluginListItem(p: RegistryPluginInfo): RegistryPluginListItem;

package/packages/agent/src/services/registry-client-queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-client-queries.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACzC,IAAI,EAAE,MAAM,GACX,kBAAkB,GAAG,IAAI,CAkB3B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,MAAM,EAAE,EAChD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,MAAM,EAAE,GAC/C,KAAK,CAAC;IAAE,CAAC,EAAE,kBAAkB,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC7C;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,kBAAkB,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACnD,oBAAoB,EAAE,CAYxB;AAED,wBAAgB,SAAS,CACvB,CAAC,EAAE,kBAAkB,EACrB,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,EAC3C,cAAc,EAAE,MAAM,GACrB,eAAe,CAiCjB;AAED,wBAAgB,UAAU,CACxB,CAAC,EAAE,kBAAkB,EACrB,kBAAkB,EAAE,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,KACnC,kBAAkB,CAAC,SAAS,CAAC,GACjC,kBAAkB,GAAG,IAAI,CAgB3B;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,kBAAkB,GACpB,sBAAsB,CAWxB"}
+{"version":3,"file":"registry-client-queries.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client-queries.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACzC,IAAI,EAAE,MAAM,GACX,kBAAkB,GAAG,IAAI,CAsC3B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,kBAAkB,EACvD,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,EAC/B,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,GAC9B,KAAK,CAAC;IAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC5B;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,kBAAkB,EAC1D,OAAO,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClC,oBAAoB,EAAE,CAcxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,MAAM,GAAG,IAAI,CAaf;AAED,wBAAgB,SAAS,CACvB,CAAC,EAAE,kBAAkB,EACrB,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,EAC3C,cAAc,EAAE,MAAM,GACrB,eAAe,CAsCjB;AAED,wBAAgB,UAAU,CACxB,CAAC,EAAE,kBAAkB,EACrB,kBAAkB,EAAE,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,KACnC,kBAAkB,CAAC,SAAS,CAAC,GACjC,kBAAkB,GAAG,IAAI,CAgB3B;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,kBAAkB,GACpB,sBAAsB,CAWxB"}

package/packages/agent/src/services/registry-client-queries.js

@@ -1,3 +1,4 @@
+import { hasAppInterface, packageNameToAppDisplayName, packageNameToAppRouteSlug, } from "@elizaos/shared";
 export function normalizePluginLookupAlias(name) {
     const trimmed = name.trim();
     if (!trimmed)
@@ -15,6 +16,7 @@ export function getPluginInfoFromRegistry(registry, name) {
     let p = registry.get(name);
     if (p)
         return p;
+    const requestedBare = name.replace(/^@[^/]+\//, "").toLowerCase();
     if (!name.startsWith("@")) {
         p = registry.get(`@elizaos/${name}`);
         if (p)
@@ -22,11 +24,28 @@ export function getPluginInfoFromRegistry(registry, name) {
         p = registry.get(`@elizaos/plugin-${name}`);
         if (p)
             return p;
+        p = registry.get(`@elizaos/app-${name}`);
+        if (p)
+            return p;
     }
-    const bare = name.replace(/^@[^/]+\//, "");
     for (const [key, value] of registry) {
-        if (key.endsWith(`/${bare}`))
+        if (key.toLowerCase().endsWith(`/${requestedBare}`))
+            return value;
+        const aliases = new Set();
+        for (const candidate of [value.name, value.npm.package]) {
+            const trimmed = candidate?.trim();
+            if (!trimmed)
+                continue;
+            aliases.add(trimmed.replace(/^@[^/]+\//, "").toLowerCase());
+            if (hasAppInterface(value)) {
+                const routeSlug = packageNameToAppRouteSlug(trimmed);
+                if (routeSlug)
+                    aliases.add(routeSlug.toLowerCase());
+            }
+        }
+        if (aliases.has(requestedBare)) {
             return value;
+        }
     }
     return null;
 }
@@ -80,12 +99,35 @@ export function toSearchResults(results) {
         description: p.description,
         score: s / max,
         tags: p.topics,
+        version: p.npm.v2Version || p.npm.v1Version || p.npm.v0Version,
         latestVersion: p.npm.v2Version || p.npm.v1Version || p.npm.v0Version,
+        npmPackage: p.npm.package,
         stars: p.stars,
         supports: p.supports,
         repository: `https://github.com/${p.gitRepo}`,
     }));
 }
+/**
+ * Resolve a declared `heroImage` value to a URL the client can load.
+ *
+ * Accepts three shapes:
+ *   - null / empty → `/api/apps/hero/<slug>` for generated fallback art
+ *   - absolute URL / data URL / already-rooted `/api/...` or `/...` path → returned as-is
+ *   - package-relative path (e.g. `"assets/hero.png"`) → rewritten to
+ *     `/api/apps/hero/<slug>` so the runtime can stream it from the app's
+ *     local package directory or synthesize fallback art
+ */
+export function resolveAppHeroImage(packageName, heroImage) {
+    const value = heroImage?.trim();
+    if (value &&
+        /^(https?:|data:image\/|blob:|file:|capacitor:|electrobun:|app:|\/)/i.test(value)) {
+        return value;
+    }
+    const slug = packageNameToAppRouteSlug(packageName);
+    if (!slug)
+        return null;
+    return `/api/apps/hero/${slug}`;
+}
 export function toAppInfo(p, sanitizeSandbox, defaultSandbox) {
     const meta = p.appMeta;
     const viewer = meta?.viewer
@@ -103,12 +145,13 @@ export function toAppInfo(p, sanitizeSandbox, defaultSandbox) {
             : undefined;
     return {
         name: p.name,
-        displayName: meta?.displayName ?? p.name.replace(/^@elizaos\/app-/, ""),
+        displayName: meta?.displayName ?? packageNameToAppDisplayName(p.name),
         description: p.description,
         category: meta?.category ?? "game",
         launchType: meta?.launchType ?? "url",
         launchUrl: meta?.launchUrl ?? p.homepage,
         icon: meta?.icon ?? null,
+        heroImage: resolveAppHeroImage(p.name, meta?.heroImage),
         capabilities: meta?.capabilities ?? [],
         stars: p.stars,
         repository: `https://github.com/${p.gitRepo}`,
@@ -117,6 +160,10 @@ export function toAppInfo(p, sanitizeSandbox, defaultSandbox) {
         npm: p.npm,
         uiExtension: meta?.uiExtension,
         viewer,
+        session: meta?.session,
+        developerOnly: meta?.developerOnly,
+        visibleInAppStore: meta?.visibleInAppStore,
+        mainTab: meta?.mainTab,
     };
 }
 export function toAppEntry(p, resolveAppOverride) {