@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.6

package/services/registry-client-network.js

@@ -0,0 +1,211 @@
+import { isCloudReachable } from "@elizaos/shared";
+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),
+    };
+}
+/**
+ * Fetch + parse the generated registry. Returns the parsed plugin map on a
+ * 200, or `null` when the endpoint is absent (404) or the request fails — in
+ * which case the caller falls through to the index registry.
+ */
+async function fetchGeneratedRegistry(params) {
+    const { generatedRegistryUrl, applyLocalWorkspaceApps, applyNodeModulePlugins, sanitizeSandbox, } = params;
+    const generatedSpan = createIntegrationTelemetrySpan({
+        boundary: "marketplace",
+        operation: "fetch_generated_registry",
+    });
+    try {
+        const resp = await fetch(generatedRegistryUrl, createRegistryFetchInit());
+        if (resp.ok) {
+            const data = (await resp.json());
+            const plugins = new Map();
+            for (const [name, e] of Object.entries(data.registry)) {
+                const info = {
+                    name,
+                    gitRepo: e.git.repo,
+                    gitUrl: `https://github.com/${e.git.repo}.git`,
+                    directory: e.directory ?? null,
+                    description: e.description || "",
+                    homepage: e.homepage,
+                    topics: e.topics || [],
+                    stars: e.stargazers_count || 0,
+                    language: e.language || "TypeScript",
+                    npm: {
+                        package: e.npm.repo,
+                        v0Version: e.npm.v0,
+                        v1Version: e.npm.v1,
+                        v2Version: e.npm.v2,
+                    },
+                    git: {
+                        v0Branch: e.git.v0.branch ?? null,
+                        v1Branch: e.git.v1.branch ?? null,
+                        v2Branch: e.git.v2.branch ?? null,
+                    },
+                    supports: e.supports,
+                    origin: e.origin,
+                    source: e.source,
+                    support: e.support,
+                    builtIn: e.builtIn,
+                    firstParty: e.firstParty,
+                    thirdParty: e.thirdParty,
+                    status: e.status,
+                    registryKind: e.registryKind,
+                };
+                if (e.kind) {
+                    info.kind = e.kind;
+                }
+                if (e.kind === "app" || e.app) {
+                    info.kind = "app";
+                }
+                if (e.app) {
+                    info.appMeta = {
+                        displayName: e.app.displayName,
+                        category: e.app.category,
+                        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
+                            ? {
+                                ...e.app.viewer,
+                                sandbox: sanitizeSandbox(e.app.viewer.sandbox),
+                            }
+                            : undefined,
+                        session: e.app.session,
+                        developerOnly: e.app.developerOnly,
+                        visibleInAppStore: e.app.visibleInAppStore,
+                        mainTab: e.app.mainTab,
+                    };
+                }
+                plugins.set(name, info);
+            }
+            await applyLocalWorkspaceApps(plugins);
+            await applyNodeModulePlugins(plugins);
+            generatedSpan.success({ statusCode: resp.status });
+            return plugins;
+        }
+        if (!isExpectedRegistryNotFound(resp)) {
+            generatedSpan.failure({
+                statusCode: resp.status,
+                errorKind: "http_error",
+            });
+        }
+        return null;
+    }
+    catch (err) {
+        generatedSpan.failure({ error: err });
+        // caller logs fallback warnings
+        return null;
+    }
+}
+/**
+ * Fetch + parse the index registry. Throws `RegistryNetworkFallbackError` (or
+ * the raw network error) when it cannot be loaded, signalling the caller to
+ * use the local snapshot.
+ */
+async function fetchIndexRegistry(params) {
+    const { indexRegistryUrl, applyLocalWorkspaceApps, applyNodeModulePlugins } = params;
+    const indexSpan = createIntegrationTelemetrySpan({
+        boundary: "marketplace",
+        operation: "fetch_index_registry",
+    });
+    let resp;
+    try {
+        resp = await fetch(indexRegistryUrl, createRegistryFetchInit());
+    }
+    catch (err) {
+        indexSpan.failure({ error: err });
+        throw err;
+    }
+    if (!resp.ok) {
+        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();
+    for (const [name, gitRef] of Object.entries(data)) {
+        const repo = gitRef.replace(/^github:/, "");
+        const isBuiltIn = name.startsWith("@elizaos/");
+        plugins.set(name, {
+            name,
+            gitRepo: repo,
+            gitUrl: `https://github.com/${repo}.git`,
+            directory: null,
+            description: "",
+            homepage: null,
+            topics: [],
+            stars: 0,
+            language: "TypeScript",
+            npm: { package: name, v0Version: null, v1Version: null, v2Version: null },
+            git: { v0Branch: null, v1Branch: null, v2Branch: "next" },
+            supports: { v0: false, v1: false, v2: false },
+            origin: isBuiltIn ? "builtin" : "third-party",
+            source: isBuiltIn ? "builtin" : "third-party",
+            support: isBuiltIn ? "first-party" : "community",
+            builtIn: isBuiltIn,
+            firstParty: isBuiltIn,
+            thirdParty: !isBuiltIn,
+        });
+    }
+    await applyLocalWorkspaceApps(plugins);
+    await applyNodeModulePlugins(plugins);
+    indexSpan.success({ statusCode: resp.status });
+    return plugins;
+}
+/**
+ * Resolve the plugin registry from the network, preferring the generated
+ * registry over the index registry.
+ *
+ * Both network attempts are issued concurrently so a doomed-offline boot
+ * waits out a single ~2.5s timeout instead of two sequential ones. The
+ * generated result still wins whenever it loads; the index result is only
+ * consulted (and its failure only surfaced) when the generated registry is
+ * absent. When the cloud is already known to be unreachable for this boot we
+ * skip both fetches entirely and go straight to the local-snapshot fallback.
+ */
+export async function fetchFromNetwork(params) {
+    if (!(await isCloudReachable())) {
+        throw new RegistryNetworkFallbackError("cloud unreachable at boot — using local registry snapshot");
+    }
+    const generatedResult = fetchGeneratedRegistry(params);
+    const indexResult = fetchIndexRegistry(params);
+    // Prevent an unhandled rejection if the generated registry wins the race and
+    // we never await the index attempt; its failure is only relevant as a
+    // fallback when the generated registry is absent.
+    indexResult.catch(() => { });
+    const generated = await generatedResult;
+    if (generated) {
+        return generated;
+    }
+    return indexResult;
+}

package/services/registry-client-queries.d.ts.map

@@ -0,0 +1 @@
+{"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,CAmBxB;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,CA+CjB;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,CAgBxB"}

package/services/registry-client-queries.js

@@ -0,0 +1,216 @@
+import { hasAppInterface, packageNameToAppDisplayName, packageNameToAppRouteSlug, } from "@elizaos/shared";
+export function normalizePluginLookupAlias(name) {
+    const trimmed = name.trim();
+    if (!trimmed)
+        return trimmed;
+    const lower = trimmed.toLowerCase();
+    if (lower === "obsidan")
+        return "obsidian";
+    if (lower === "plugin-obsidan")
+        return "plugin-obsidian";
+    if (lower === "@elizaos/plugin-obsidan")
+        return "@elizaos/plugin-obsidian";
+    return trimmed;
+}
+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)
+            return p;
+        p = registry.get(`@elizaos/plugin-${name}`);
+        if (p)
+            return p;
+        p = registry.get(`@elizaos/app-${name}`);
+        if (p)
+            return p;
+    }
+    for (const [key, value] of registry) {
+        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;
+}
+export function scoreEntries(entries, query, limit, extraNames, extraTerms) {
+    const lq = query.toLowerCase();
+    const terms = lq.split(/\s+/).filter((t) => t.length > 1);
+    const scored = [];
+    for (const p of entries) {
+        const ln = p.name.toLowerCase();
+        const ld = p.description.toLowerCase();
+        const aliases = extraNames?.(p) ?? [];
+        let s = 0;
+        if (ln === lq || ln === `@elizaos/${lq}` || aliases.some((a) => a === lq))
+            s += 100;
+        else if (ln.includes(lq) || aliases.some((a) => a.includes(lq)))
+            s += 50;
+        if (ld.includes(lq))
+            s += 30;
+        for (const t of p.topics)
+            if (t.toLowerCase().includes(lq))
+                s += 25;
+        for (const t of extraTerms?.(p) ?? [])
+            if (t.toLowerCase().includes(lq))
+                s += 25;
+        for (const term of terms) {
+            if (ln.includes(term) || aliases.some((a) => a.includes(term)))
+                s += 15;
+            if (ld.includes(term))
+                s += 10;
+            for (const t of p.topics)
+                if (t.toLowerCase().includes(term))
+                    s += 8;
+        }
+        if (s > 0) {
+            if (p.stars > 100)
+                s += 3;
+            if (p.stars > 500)
+                s += 3;
+            if (p.stars > 1000)
+                s += 4;
+            scored.push({ p, s });
+        }
+    }
+    scored.sort((a, b) => b.s - a.s || b.p.stars - a.p.stars);
+    return scored.slice(0, limit);
+}
+export function toSearchResults(results) {
+    const max = results[0]?.s || 1;
+    return results.map(({ p, s }) => ({
+        name: p.name,
+        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}`,
+        origin: p.origin,
+        support: p.support,
+        builtIn: p.builtIn,
+        firstParty: p.firstParty,
+        thirdParty: p.thirdParty,
+    }));
+}
+/**
+ * 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
+        ? {
+            url: meta.viewer.url,
+            embedParams: meta.viewer.embedParams,
+            postMessageAuth: meta.viewer.postMessageAuth,
+            sandbox: sanitizeSandbox(meta.viewer.sandbox),
+        }
+        : meta?.launchType === "connect" || meta?.launchType === "local"
+            ? {
+                url: meta.launchUrl ?? "",
+                sandbox: defaultSandbox,
+            }
+            : undefined;
+    return {
+        name: p.name,
+        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}`,
+        latestVersion: p.npm.v2Version || p.npm.v1Version || p.npm.v0Version,
+        supports: p.supports,
+        npm: p.npm,
+        directory: p.directory ?? null,
+        registryKind: p.registryKind,
+        origin: p.origin,
+        source: p.source,
+        support: p.support,
+        builtIn: p.builtIn,
+        firstParty: p.firstParty,
+        thirdParty: p.thirdParty,
+        status: p.status,
+        uiExtension: meta?.uiExtension,
+        viewer,
+        session: meta?.session,
+        developerOnly: meta?.developerOnly,
+        visibleInAppStore: meta?.visibleInAppStore,
+        mainTab: meta?.mainTab,
+    };
+}
+export function toAppEntry(p, resolveAppOverride) {
+    if (p.kind === "app" || p.appMeta) {
+        return {
+            ...p,
+            kind: "app",
+            appMeta: p.appMeta,
+        };
+    }
+    const appMeta = resolveAppOverride(p.name, undefined);
+    if (!appMeta)
+        return null;
+    return {
+        ...p,
+        kind: "app",
+        appMeta,
+    };
+}
+export function toPluginListItem(p) {
+    return {
+        name: p.name,
+        description: p.description,
+        stars: p.stars,
+        repository: `https://github.com/${p.gitRepo}`,
+        topics: p.topics,
+        latestVersion: p.npm.v2Version || p.npm.v1Version || p.npm.v0Version,
+        supports: p.supports,
+        npm: p.npm,
+        origin: p.origin,
+        support: p.support,
+        builtIn: p.builtIn,
+        firstParty: p.firstParty,
+        thirdParty: p.thirdParty,
+    };
+}

package/services/registry-client-types.d.ts

@@ -0,0 +1,133 @@
+import type { AppSessionConfig, AppSessionFeature, AppSessionMode, AppUiExtensionConfig, AppViewerConfig, RegistryAppInfo } from "@elizaos/shared";
+export type RegistryAppViewerMeta = Omit<AppViewerConfig, "authMessage">;
+export type RegistryAppSessionMode = AppSessionMode;
+export type RegistryAppSessionFeature = AppSessionFeature;
+export type RegistryAppSessionMeta = AppSessionConfig;
+export type { AppUiExtensionConfig, RegistryAppInfo };
+export interface RegistryAppMeta {
+    displayName: string;
+    category: string;
+    launchType: string;
+    launchUrl: string | null;
+    icon: string | null;
+    /**
+     * URL or package-relative path to a full-card hero image. Apps declare
+     * this in `package.json` → `elizaos.app.heroImage` as a relative path
+     * (e.g. `"assets/hero.png"`); the runtime resolves it to a served
+     * URL before surfacing the field on `RegistryAppInfo`, and falls back
+     * to generated `/api/apps/hero/<slug>` artwork when an app ships none.
+     */
+    heroImage: string | null;
+    capabilities: string[];
+    minPlayers: number | null;
+    maxPlayers: number | null;
+    runtimePlugin?: string;
+    bridgeExport?: string;
+    uiExtension?: AppUiExtensionConfig;
+    viewer?: RegistryAppViewerMeta;
+    session?: RegistryAppSessionMeta;
+    /**
+     * If true, the app is a developer-tooling surface (logs, trajectory
+     * viewer, etc.) and is hidden from the main UI unless Developer Mode is
+     * enabled in Settings. The server exposes the flag here; the client
+     * gates the render.
+     */
+    developerOnly?: boolean;
+    /**
+     * Controls whether the app appears in the user-facing app store/catalog.
+     * Defaults to true. Set to false for apps that auto-install or are
+     * surfaced only via direct deep-links. The server exposes the flag;
+     * the client gates the render.
+     */
+    visibleInAppStore?: boolean;
+    /**
+     * If true, the app declares itself as the default landing tab for the
+     * shell. Set via `package.json` → `elizaos.app.mainTab`. Exactly one
+     * installed app should declare this; if multiple do, the shell picks
+     * the first one deterministically and logs a warning. Consumed by
+     * `getMainTabApp()` in `@elizaos/app-core` at boot.
+     */
+    mainTab?: boolean;
+}
+export interface RegistryPluginInfo {
+    name: string;
+    gitRepo: string;
+    gitUrl: string;
+    directory?: string | null;
+    description: string;
+    homepage: string | null;
+    topics: string[];
+    stars: number;
+    language: string;
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+    };
+    git: {
+        v0Branch: string | null;
+        v1Branch: string | null;
+        v2Branch: string | null;
+    };
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    localPath?: string;
+    kind?: string;
+    registryKind?: string;
+    origin?: "builtin" | "third-party" | string;
+    source?: string;
+    support?: "first-party" | "community" | string;
+    builtIn?: boolean;
+    firstParty?: boolean;
+    thirdParty?: boolean;
+    status?: string;
+    appMeta?: RegistryAppMeta;
+}
+export interface RegistrySearchResult {
+    name: string;
+    description: string;
+    score: number;
+    tags: string[];
+    latestVersion: string | null;
+    stars: number;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    repository: string;
+    origin?: string;
+    support?: string;
+    builtIn?: boolean;
+    firstParty?: boolean;
+    thirdParty?: boolean;
+}
+export interface RegistryPluginListItem {
+    name: string;
+    description: string;
+    stars: number;
+    repository: string;
+    topics: string[];
+    latestVersion: string | null;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+    };
+    origin?: string;
+    support?: string;
+    builtIn?: boolean;
+    firstParty?: boolean;
+    thirdParty?: boolean;
+}
+//# sourceMappingURL=registry-client-types.d.ts.map

package/services/registry-client-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client-types.d.ts","sourceRoot":"","sources":["../../src/services/registry-client-types.ts"],"names":[],"mappings":"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"}

package/services/registry-client-types.js

@@ -0,0 +1 @@
+export {};

package/services/registry-client.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Registry Client for Eliza.
+ *
+ * Provides a 3-tier cached registry (memory → file → network) that works
+ * offline, in .app bundles, and in dev. Fetches from plugins.elizacloud.ai.
+ *
+ * @module services/registry-client
+ */
+import type { RegistryEndpoint } from "../config/types.eliza.ts";
+import type { RegistryAppInfo, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult } from "./registry-client-types.ts";
+export type { AppUiExtensionConfig, RegistryAppInfo, RegistryAppMeta, RegistryAppViewerMeta, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult, } from "./registry-client-types.ts";
+/** Return the list of custom registry endpoints from config. */
+export declare function getConfiguredEndpoints(): RegistryEndpoint[];
+/** Add a custom registry endpoint. Blocks duplicate URLs. */
+export declare function addRegistryEndpoint(label: string, url: string): void;
+/** Remove a custom registry endpoint by URL. Cannot remove the default. */
+export declare function removeRegistryEndpoint(url: string): void;
+/** Toggle an endpoint's enabled status. */
+export declare function toggleRegistryEndpoint(url: string, enabled: boolean): void;
+export declare function isDefaultEndpoint(url: string): boolean;
+/** Get all plugins. Resolution: memory → file → network. */
+export declare function getRegistryPlugins(): Promise<Map<string, RegistryPluginInfo>>;
+/** Force-refresh from network. */
+export declare function refreshRegistry(): Promise<Map<string, RegistryPluginInfo>>;
+/** Look up a plugin by name (exact → @elizaos/ prefix → bare suffix). */
+export declare function getPluginInfo(name: string): Promise<RegistryPluginInfo | null>;
+/** Search plugins by query (local fuzzy match on name/description/topics). */
+export declare function searchPlugins(query: string, limit?: number): Promise<RegistrySearchResult[]>;
+/** List all registered apps. */
+export declare function listApps(): Promise<RegistryAppInfo[]>;
+/** Look up a specific app by name. */
+export declare function getAppInfo(name: string): Promise<RegistryAppInfo | null>;
+/** Search apps by query. */
+export declare function searchApps(query: string, limit?: number): Promise<RegistryAppInfo[]>;
+/** List all non-app plugins from the registry. */
+export declare function listNonAppPlugins(): Promise<RegistryPluginListItem[]>;
+/** Search non-app plugins by query. */
+export declare function searchNonAppPlugins(query: string, limit?: number): Promise<RegistryPluginListItem[]>;
+//# sourceMappingURL=registry-client.d.ts.map

package/services/registry-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../src/services/registry-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA6BjE,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAcpC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AA6FpC,gEAAgE;AAChE,wBAAgB,sBAAsB,IAAI,gBAAgB,EAAE,CAY3D;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAkBpE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBxD;AAED,2CAA2C;AAC3C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAW1E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAMD,4DAA4D;AAC5D,wBAAsB,kBAAkB,IAAI,OAAO,CACjD,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CA6DA;AAED,kCAAkC;AAClC,wBAAsB,eAAe,IAAI,OAAO,CAC9C,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CAQA;AAED,yEAAyE;AACzE,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWpC;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAIjC;AAED,gCAAgC;AAChC,wBAAsB,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAY3D;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAMjC;AAED,4BAA4B;AAC5B,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC,CAmB5B;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAY3E;AAED,uCAAuC;AACvC,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAMnC"}