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

package/services/permissions/probers/shell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shell access prober.
+ *
+ * Shell execution is app-internal — there's no OS permission for spawning
+ * child processes. We honor an in-app toggle (managed by the existing
+ * `PermissionManager.setShellEnabled` in
+ * `packages/app-core/platforms/electrobun/src/native/permissions.ts`).
+ *
+ * The default prober reports granted access because shell execution is gated
+ * elsewhere by the runtime's shell router and app-internal configuration. A
+ * registry-provided prober can replace this one when a host wants permission
+ * status to mirror a user-toggled `shellEnabled` flag.
+ */
+import type { Prober } from "../contracts.js";
+export declare const shellProber: Prober;
+//# sourceMappingURL=shell.d.ts.map

package/services/permissions/probers/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../src/services/permissions/probers/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK/D,eAAO,MAAM,WAAW,EAAE,MAczB,CAAC"}

package/services/permissions/probers/shell.js

@@ -0,0 +1,28 @@
+/**
+ * Shell access prober.
+ *
+ * Shell execution is app-internal — there's no OS permission for spawning
+ * child processes. We honor an in-app toggle (managed by the existing
+ * `PermissionManager.setShellEnabled` in
+ * `packages/app-core/platforms/electrobun/src/native/permissions.ts`).
+ *
+ * The default prober reports granted access because shell execution is gated
+ * elsewhere by the runtime's shell router and app-internal configuration. A
+ * registry-provided prober can replace this one when a host wants permission
+ * status to mirror a user-toggled `shellEnabled` flag.
+ */
+import { buildState } from "./_bridge.js";
+const ID = "shell";
+export const shellProber = {
+    id: ID,
+    async check() {
+        return buildState(ID, "granted", { canRequest: false });
+    },
+    async request({ reason: _reason }) {
+        // Nothing to request — shell is app-internal.
+        return buildState(ID, "granted", {
+            canRequest: false,
+            lastRequested: Date.now(),
+        });
+    },
+};

package/services/permissions/probers/website-blocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-blocking.d.ts","sourceRoot":"","sources":["../../../../src/services/permissions/probers/website-blocking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK/D,eAAO,MAAM,qBAAqB,EAAE,MAanC,CAAC"}

package/services/permissions/register-probers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Register all native permission probers with the central permissions
+ * registry.
+ *
+ * `PermissionRegistry.start()` calls this during service startup. Custom
+ * registry hosts can also call this helper after constructing an
+ * `IPermissionsRegistry` implementation.
+ */
+import type { IPermissionsRegistry } from "./contracts.js";
+import { ALL_PROBERS } from "./probers/index.js";
+export declare function registerAllProbers(registry: IPermissionsRegistry): void;
+export { ALL_PROBERS };
+//# sourceMappingURL=register-probers.d.ts.map

package/services/permissions/register-probers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-probers.d.ts","sourceRoot":"","sources":["../../../src/services/permissions/register-probers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAIvE;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/services/permissions/register-probers.js

@@ -0,0 +1,15 @@
+/**
+ * Register all native permission probers with the central permissions
+ * registry.
+ *
+ * `PermissionRegistry.start()` calls this during service startup. Custom
+ * registry hosts can also call this helper after constructing an
+ * `IPermissionsRegistry` implementation.
+ */
+import { ALL_PROBERS } from "./probers/index.js";
+export function registerAllProbers(registry) {
+    for (const prober of ALL_PROBERS) {
+        registry.registerProber(prober);
+    }
+}
+export { ALL_PROBERS };

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-registry.d.ts","sourceRoot":"","sources":["../../src/services/permissions-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,KAAK,aAAa,EAGlB,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,MAAM,EACP,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEpE,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AA4BzE,UAAU,kBAAkB;IAC1B,IAAI,IAAI,eAAe,EAAE,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CACxC;AA4BD,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,kBACX,SAAQ,OACR,YAAW,oBAAoB;IAE/B,MAAM,CAAC,WAAW,SAAgC;WAErC,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUvE,qBAAqB,SACkD;IAEvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,yBAA8B;IAQ3E,OAAO,IAAI,IAAI;IAQf,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC,GAAG,CAAC,EAAE,EAAE,YAAY,GAAG,eAAe;IAOhC,KAAK,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAUjD,OAAO,CACX,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACjE,OAAO,CAAC,eAAe,CAAC;IAmB3B,WAAW,CACT,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvC,IAAI;IAaP,IAAI,IAAI,eAAe,EAAE;IAIzB,OAAO,IAAI,eAAe,EAAE;IAU5B,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;CAUrB"}

package/services/permissions-registry.js

@@ -0,0 +1,209 @@
+/**
+ * Central registry for system-permission state. Holds an in-memory map of
+ * `PermissionState` keyed by `PermissionId`, hydrates from disk on boot,
+ * persists changes (debounced), and exposes a pub/sub channel for the UI.
+ *
+ * Probers are pluggable — each `PermissionId` is wired to a `Prober` that
+ * knows how to `check()` the OS state and `request()` user consent. The
+ * registry is the single source of truth; native bridges register probers,
+ * features call `recordBlock()` to surface why a permission is needed.
+ */
+import * as fs from "node:fs";
+import path from "node:path";
+import { logger, resolveStateDir as resolveCoreStateDir, Service, } from "@elizaos/core";
+export const PERMISSIONS_REGISTRY_SERVICE = "eliza_permissions_registry";
+const PENDING_BLOCK_WINDOW_MS = 24 * 60 * 60 * 1000;
+const PERSIST_DEBOUNCE_MS = 500;
+function currentPlatform() {
+    const p = process.platform;
+    return p === "darwin" || p === "win32" || p === "linux" ? p : "linux";
+}
+function defaultStateFor(id) {
+    return {
+        id,
+        status: "not-determined",
+        canRequest: true,
+        lastChecked: Date.now(),
+        platform: currentPlatform(),
+    };
+}
+function resolveStateDir() {
+    return resolveCoreStateDir();
+}
+function resolvePersistencePath() {
+    return path.join(resolveStateDir(), "permissions.json");
+}
+class FilePersistenceAdapter {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    read() {
+        if (!fs.existsSync(this.filePath))
+            return null;
+        const raw = fs.readFileSync(this.filePath, "utf8");
+        if (!raw.trim())
+            return null;
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return null;
+        return parsed.filter((entry) => !!entry &&
+            typeof entry === "object" &&
+            typeof entry.id === "string");
+    }
+    write(states) {
+        const dir = path.dirname(this.filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        const tmp = `${this.filePath}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(states, null, 2), "utf8");
+        fs.renameSync(tmp, this.filePath);
+    }
+}
+export class PermissionRegistry extends Service {
+    static serviceType = PERMISSIONS_REGISTRY_SERVICE;
+    static async start(runtime) {
+        const instance = new PermissionRegistry(runtime);
+        instance.hydrate();
+        const { registerAllProbers } = await import("./permissions/register-probers.js");
+        registerAllProbers(instance);
+        return instance;
+    }
+    capabilityDescription = "Central registry for system permission state, probers, and pub/sub";
+    states = new Map();
+    probers = new Map();
+    subscribers = new Set();
+    persistTimer = null;
+    persistence;
+    persistDebounceMs;
+    constructor(runtime, options = {}) {
+        super(runtime);
+        this.persistence =
+            options.persistence ??
+                new FilePersistenceAdapter(resolvePersistencePath());
+        this.persistDebounceMs = options.persistDebounceMs ?? PERSIST_DEBOUNCE_MS;
+    }
+    hydrate() {
+        const loaded = this.persistence.read();
+        if (!loaded)
+            return;
+        for (const state of loaded) {
+            this.states.set(state.id, state);
+        }
+    }
+    registerProber(prober) {
+        this.probers.set(prober.id, prober);
+    }
+    get(id) {
+        const existing = this.states.get(id);
+        if (existing)
+            return existing;
+        const fresh = defaultStateFor(id);
+        return fresh;
+    }
+    async check(id) {
+        const prober = this.probers.get(id);
+        if (!prober) {
+            throw new Error(`[PermissionRegistry] no prober registered for ${id}`);
+        }
+        const next = await prober.check();
+        this.commit(id, next);
+        return next;
+    }
+    async request(id, opts) {
+        const prober = this.probers.get(id);
+        if (!prober) {
+            throw new Error(`[PermissionRegistry] no prober registered for ${id}`);
+        }
+        const next = await prober.request({ reason: opts.reason });
+        const withRequest = {
+            ...next,
+            lastRequested: Date.now(),
+            lastBlockedFeature: {
+                app: opts.feature.app,
+                action: opts.feature.action,
+                at: Date.now(),
+            },
+        };
+        this.commit(id, withRequest);
+        return withRequest;
+    }
+    recordBlock(id, feature) {
+        const current = this.states.get(id) ?? defaultStateFor(id);
+        const next = {
+            ...current,
+            lastBlockedFeature: {
+                app: feature.app,
+                action: feature.action,
+                at: Date.now(),
+            },
+        };
+        this.commit(id, next);
+    }
+    list() {
+        return Array.from(this.states.values());
+    }
+    pending() {
+        const cutoff = Date.now() - PENDING_BLOCK_WINDOW_MS;
+        return this.list().filter((s) => {
+            if (s.status === "not-determined")
+                return true;
+            if (s.lastBlockedFeature && s.lastBlockedFeature.at >= cutoff)
+                return true;
+            return false;
+        });
+    }
+    subscribe(cb) {
+        this.subscribers.add(cb);
+        return () => {
+            this.subscribers.delete(cb);
+        };
+    }
+    async stop() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+            this.flushPersist();
+        }
+    }
+    commit(id, next) {
+        this.states.set(id, next);
+        this.notify();
+        this.schedulePersist();
+    }
+    notify() {
+        if (this.subscribers.size === 0)
+            return;
+        const snapshot = this.list();
+        for (const sub of this.subscribers) {
+            try {
+                sub(snapshot);
+            }
+            catch (err) {
+                logger.warn({ err: err instanceof Error ? err.message : String(err) }, "[PermissionRegistry] subscriber threw");
+            }
+        }
+    }
+    schedulePersist() {
+        if (this.persistDebounceMs <= 0) {
+            this.flushPersist();
+            return;
+        }
+        if (this.persistTimer)
+            clearTimeout(this.persistTimer);
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = null;
+            this.flushPersist();
+        }, this.persistDebounceMs);
+        if (typeof this.persistTimer.unref === "function") {
+            this.persistTimer.unref();
+        }
+    }
+    flushPersist() {
+        try {
+            this.persistence.write(this.list());
+        }
+        catch (err) {
+            logger.error({ err: err instanceof Error ? err.message : String(err) }, "[PermissionRegistry] failed to persist state");
+        }
+    }
+}

package/services/plugin-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-compiler.d.ts","sourceRoot":"","sources":["../../src/services/plugin-compiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,wBAAwB,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACnB,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAiF7E;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/services/plugin-compiler.js

@@ -0,0 +1,168 @@
+import path from "node:path";
+import * as esbuild from "esbuild";
+const DEFAULT_TARGET = "node20";
+const DEFAULT_EXTERNAL = ["@elizaos/*"];
+/**
+ * Compiles TypeScript plugin source from a project's VFS into JS, also written
+ * to the same VFS. The output is a real on-disk file that can be loaded via
+ * dynamic `import(pathToFileURL(...))`.
+ *
+ * Path-traversal protection is delegated to the VFS: every path that enters
+ * this compiler goes through `vfs.readFile` / `vfs.writeFile` /
+ * `vfs.resolveDiskPath`, which reject any path that would escape the project
+ * root.
+ */
+export class PluginCompiler {
+    async compile(options) {
+        const { vfs, entry, outFile, format = "esm", target = DEFAULT_TARGET, external = DEFAULT_EXTERNAL, sourcemap = true, bundle = true, minify = false, } = options;
+        if (typeof entry !== "string" || entry.trim() === "") {
+            throw new Error("PluginCompiler.compile: `entry` is required");
+        }
+        const resolvedOut = outFile ?? defaultOutFile(entry);
+        const entrySource = await vfs.readFile(entry);
+        const entryDiskPath = vfs.resolveDiskPath(entry);
+        const outDiskPath = vfs.resolveDiskPath(resolvedOut);
+        const loader = inferLoader(entry);
+        const start = Date.now();
+        let warnings = [];
+        let output;
+        try {
+            const result = await esbuild.build({
+                stdin: {
+                    contents: entrySource,
+                    resolveDir: path.dirname(entryDiskPath),
+                    sourcefile: path.basename(entryDiskPath),
+                    loader,
+                },
+                bundle,
+                write: false,
+                format,
+                target,
+                platform: "node",
+                external: [...external],
+                sourcemap: sourcemap ? "inline" : false,
+                minify,
+                logLevel: "silent",
+            });
+            if (!result.outputFiles || result.outputFiles.length === 0) {
+                throw new Error("PluginCompiler.compile: esbuild produced no output files");
+            }
+            const primary = result.outputFiles[0];
+            if (!primary) {
+                throw new Error("PluginCompiler.compile: esbuild produced no output");
+            }
+            warnings = result.warnings;
+            output = primary.contents;
+        }
+        catch (error) {
+            if (!isRecoverableEsbuildRuntimeError(error)) {
+                throw error;
+            }
+            output = await transpileWithoutEsbuild(entrySource, loader, format);
+        }
+        const durationMs = Date.now() - start;
+        await vfs.writeFile(resolvedOut, output);
+        void outDiskPath;
+        return {
+            outFile: vfs.resolveVirtualPath(resolvedOut),
+            format,
+            target,
+            warnings,
+            durationMs,
+        };
+    }
+}
+export function createPluginCompiler() {
+    return new PluginCompiler();
+}
+function inferLoader(entry) {
+    const ext = path.extname(entry).toLowerCase();
+    switch (ext) {
+        case ".ts":
+            return "ts";
+        case ".tsx":
+            return "tsx";
+        case ".jsx":
+            return "jsx";
+        case ".mjs":
+        case ".cjs":
+        case ".js":
+            return "js";
+        default:
+            return "ts";
+    }
+}
+function defaultOutFile(entry) {
+    const normalized = entry.replace(/\\/g, "/").replace(/^\/+/, "");
+    const stem = normalized
+        .split("/")
+        .pop()
+        ?.replace(/\.(tsx?|jsx?|mjs|cjs)$/i, "");
+    return `dist/${stem}.js`;
+}
+function isRecoverableEsbuildRuntimeError(error) {
+    const message = error instanceof Error
+        ? error.message
+        : typeof error === "string"
+            ? error
+            : "";
+    return [
+        /service (?:was stopped|is no longer running)/i,
+        /installed esbuild for another platform/i,
+    ].some((pattern) => pattern.test(message));
+}
+async function transpileWithoutEsbuild(entrySource, loader, format) {
+    const bunGlobal = globalThis;
+    const Transpiler = bunGlobal.Bun?.Transpiler;
+    if (!Transpiler) {
+        return transpileWithTypeScript(entrySource, loader, format);
+    }
+    const transpiler = new Transpiler({
+        loader: toBunLoader(loader),
+        target: "node",
+    });
+    return transpiler.transformSync(entrySource);
+}
+async function transpileWithTypeScript(entrySource, loader, format) {
+    let ts;
+    try {
+        ts = await import("typescript");
+    }
+    catch (error) {
+        throw new Error("PluginCompiler.compile: esbuild is unavailable and neither Bun.Transpiler nor TypeScript is available", { cause: error });
+    }
+    const result = ts.transpileModule(entrySource, {
+        compilerOptions: {
+            esModuleInterop: true,
+            jsx: ts.JsxEmit.ReactJSX,
+            module: format === "cjs" ? ts.ModuleKind.CommonJS : ts.ModuleKind.ESNext,
+            target: ts.ScriptTarget.ES2022,
+        },
+        fileName: `plugin.${toTypeScriptExtension(loader)}`,
+    });
+    return result.outputText;
+}
+function toBunLoader(loader) {
+    switch (loader) {
+        case "tsx":
+            return "tsx";
+        case "jsx":
+            return "jsx";
+        case "js":
+            return "js";
+        default:
+            return "ts";
+    }
+}
+function toTypeScriptExtension(loader) {
+    switch (loader) {
+        case "jsx":
+            return "jsx";
+        case "js":
+            return "js";
+        case "tsx":
+            return "tsx";
+        default:
+            return "ts";
+    }
+}

package/services/plugin-installer.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Plugin Installer for Eliza.
+ *
+ * Cross-platform plugin installation and lifecycle management.
+ *
+ * Install targets:
+ *   <stateDir>/plugins/installed/<sanitised-name>/
+ *
+ * Works identically whether eliza is:
+ *   - Running from source (dev)
+ *   - Running as a CLI install (npm global)
+ *   - Running inside a packaged desktop app bundle
+ *   - Running on macOS, Linux, or Windows
+ *
+ * Strategy:
+ *   1. npm/bun install to an isolated prefix directory
+ *   2. Fallback: git clone from the plugin's GitHub repo
+ *   3. Track the installation in eliza.json config
+ *   4. Trigger agent restart to load the new plugin
+ *
+ * @module services/plugin-installer
+ */
+import { type RegistryPluginInfo } from "./registry-client.js";
+/** npm package names: @scope/name or name. No shell metacharacters. */
+export declare const VALID_PACKAGE_NAME: RegExp;
+/** Git branch names: alphanumeric, hyphens, slashes, dots. No shell metacharacters. */
+export declare const VALID_BRANCH: RegExp;
+/** Git URLs: https:// only, no shell metacharacters. */
+export declare const VALID_GIT_URL: RegExp;
+export declare function assertValidPackageName(name: string): void;
+export declare function assertValidGitUrl(url: string): void;
+export type InstallPhase = "resolving" | "downloading" | "installing-deps" | "validating" | "configuring" | "restarting" | "complete" | "error";
+export interface InstallProgress {
+    phase: InstallPhase;
+    pluginName: string;
+    message: string;
+}
+export type ProgressCallback = (progress: InstallProgress) => void;
+export interface InstallResult {
+    success: boolean;
+    pluginName: string;
+    version: string;
+    installPath: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export interface UninstallResult {
+    success: boolean;
+    pluginName: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export declare function sanitisePackageName(name: string): string;
+export declare function detectPackageManager(): Promise<"bun" | "npm">;
+/**
+ * Install a plugin from the registry.
+ *
+ * 1. Resolves the plugin name in the registry.
+ * 2. Installs via npm/bun to `<stateDir>/plugins/installed/<name>/`.
+ * 3. Falls back to git clone if npm is not available for this package.
+ * 4. Writes an install record to eliza.json.
+ * 5. Returns metadata about the installation for the caller to
+ *    decide whether to trigger a restart.
+ *
+ * @param pluginName - The plugin name (e.g., "@elizaos/plugin-discord")
+ * @param onProgress - Optional progress callback
+ * @param requestedVersion - Optional specific version to install (e.g., "2.0.0-beta.0")
+ */
+export declare function installPlugin(pluginName: string, onProgress?: ProgressCallback, requestedVersion?: string): Promise<InstallResult>;
+/**
+ * Install a plugin and automatically restart the agent to pick it up.
+ */
+export declare function installAndRestart(pluginName: string, onProgress?: ProgressCallback, requestedVersion?: string): Promise<InstallResult>;
+/**
+ * Uninstall a user-installed plugin.
+ *
+ * Removes the install directory and the config record.
+ * Core / built-in plugins cannot be uninstalled.
+ */
+export declare function uninstallPlugin(pluginName: string): Promise<UninstallResult>;
+/**
+ * Uninstall a plugin and restart the agent.
+ */
+export declare function uninstallAndRestart(pluginName: string): Promise<UninstallResult>;
+export declare function resolveGitBranch(info: RegistryPluginInfo): Promise<string>;
+/** List all user-installed plugins from the config. */
+export declare function listInstalledPlugins(): Array<{
+    name: string;
+    version: string;
+    installPath: string;
+    installedAt: string;
+}>;
+//# sourceMappingURL=plugin-installer.d.ts.map

package/services/plugin-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-installer.d.ts","sourceRoot":"","sources":["../../src/services/plugin-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU9E,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,QACiB,CAAC;AAKjD,uFAAuF;AACvF,eAAO,MAAM,YAAY,QAA0B,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,aAAa,QAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzD;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAInD;AAYD,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAoED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,CAYnE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAmKD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAcxB;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5E;AA6DD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAgKD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAsLD,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAUD"}