@memoryblock/plugin-installer 0.1.0-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 memoryblock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @memoryblock/plugin-installer — single-command plugin management.
+ *
+ * `mblk add web-search` — installs the plugin + adds tools to block config
+ * `mblk remove web-search` — uninstalls the plugin + removes tools from config
+ */
+export { PluginInstaller, type PluginEntry, type SettingsField } from './installer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @memoryblock/plugin-installer — single-command plugin management.
+ *
+ * `mblk add web-search` — installs the plugin + adds tools to block config
+ * `mblk remove web-search` — uninstalls the plugin + removes tools from config
+ */
+export { PluginInstaller } from './installer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAwC,MAAM,gBAAgB,CAAC"}

package/dist/installer.d.ts

@@ -0,0 +1,79 @@
+/** Settings field types supported in plugin manifests. */
+export interface SettingsField {
+    type: 'text' | 'password' | 'number' | 'select' | 'toggle';
+    label: string;
+    default?: string | number | boolean;
+    placeholder?: string;
+    options?: string[];
+    min?: number;
+    max?: number;
+}
+export interface PluginEntry {
+    id: string;
+    name: string;
+    description: string;
+    package: string;
+    version: string;
+    toolNames: string[];
+    requiresAuth: string[];
+    category: string;
+    status?: string;
+    core?: boolean;
+    blockSpecific?: boolean;
+    settings?: Record<string, SettingsField>;
+}
+interface PluginRegistry {
+    plugins: PluginEntry[];
+}
+/**
+ * Plugin installer — reads from the official registry and manages
+ * installation of npm packages + block config updates.
+ * Extended with settings storage and core plugin support.
+ */
+export declare class PluginInstaller {
+    private registry;
+    private registryPath;
+    constructor();
+    /** Load the plugin registry. */
+    loadRegistry(): Promise<PluginRegistry>;
+    /** List all available plugins. */
+    listPlugins(): Promise<PluginEntry[]>;
+    /** Find a plugin by ID. */
+    findPlugin(id: string): Promise<PluginEntry | undefined>;
+    /**
+     * Install a plugin:
+     * 1. npm install the package
+     * 2. Add tool names to the block's config.json if provided
+     */
+    install(pluginId: string, options?: {
+        blockConfigPath?: string;
+        cwd?: string;
+        onLog?: (chunk: string) => void;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        plugin?: PluginEntry;
+    }>;
+    /**
+     * Remove a plugin:
+     * 1. Check if it's a core plugin (can't remove)
+     * 2. npm uninstall the package
+     * 3. Remove tool names from block config if provided
+     */
+    remove(pluginId: string, options?: {
+        blockConfigPath?: string;
+        cwd?: string;
+        onLog?: (chunk: string) => void;
+    }): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Get the workspace-level settings file path for a plugin. */
+    private pluginSettingsPath;
+    /** Load settings for a plugin. Returns defaults merged with saved values. */
+    getPluginSettings(pluginId: string, workspacePath?: string): Promise<Record<string, unknown>>;
+    /** Save settings for a plugin. */
+    savePluginSettings(pluginId: string, values: Record<string, unknown>, workspacePath?: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAKA,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED,UAAU,cAAc;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,YAAY,CAAS;;IAQ7B,gCAAgC;IAC1B,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAO7C,kCAAkC;IAC5B,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAK3C,2BAA2B;IACrB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAK9D;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5H,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACxB,CAAC;IA6DF;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC;QAC3H,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IA+DF,+DAA+D;IAC/D,OAAO,CAAC,kBAAkB;IAK1B,6EAA6E;IACvE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoBnG,kCAAkC;IAC5B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrH"}

package/dist/installer.js

@@ -0,0 +1,203 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+/**
+ * Plugin installer — reads from the official registry and manages
+ * installation of npm packages + block config updates.
+ * Extended with settings storage and core plugin support.
+ */
+export class PluginInstaller {
+    registry = null;
+    registryPath;
+    constructor() {
+        // Registry lives alongside this package's compiled output
+        const thisDir = dirname(fileURLToPath(import.meta.url));
+        this.registryPath = join(thisDir, '..', 'registry', 'plugins.json');
+    }
+    /** Load the plugin registry. */
+    async loadRegistry() {
+        if (this.registry)
+            return this.registry;
+        const raw = await readFile(this.registryPath, 'utf-8');
+        this.registry = JSON.parse(raw);
+        return this.registry;
+    }
+    /** List all available plugins. */
+    async listPlugins() {
+        const reg = await this.loadRegistry();
+        return reg.plugins;
+    }
+    /** Find a plugin by ID. */
+    async findPlugin(id) {
+        const reg = await this.loadRegistry();
+        return reg.plugins.find(p => p.id === id);
+    }
+    /**
+     * Install a plugin:
+     * 1. npm install the package
+     * 2. Add tool names to the block's config.json if provided
+     */
+    async install(pluginId, options) {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin) {
+            return { success: false, message: `Plugin "${pluginId}" not found in registry.` };
+        }
+        if (plugin.status === 'upcoming') {
+            return { success: false, message: `Plugin "${plugin.name}" is not yet available.` };
+        }
+        // Install npm package
+        const cwd = options?.cwd || process.cwd();
+        try {
+            await new Promise((resolve, reject) => {
+                const child = spawn('npm', ['install', `${plugin.package}@${plugin.version}`], { cwd, shell: true });
+                child.stdout.on('data', data => options?.onLog?.(data.toString()));
+                child.stderr.on('data', data => options?.onLog?.(data.toString()));
+                let done = false;
+                child.on('error', err => { if (!done) {
+                    done = true;
+                    reject(err);
+                } });
+                child.on('close', code => {
+                    if (done)
+                        return;
+                    done = true;
+                    if (code === 0)
+                        resolve();
+                    else
+                        reject(new Error(`Exit code ${code}`));
+                });
+            });
+        }
+        catch (err) {
+            return {
+                success: false,
+                message: `Failed to install ${plugin.package}: ${err.message}`,
+            };
+        }
+        // Auto-update block config if path provided
+        if (options?.blockConfigPath && plugin.toolNames.length > 0) {
+            try {
+                const configRaw = await readFile(options.blockConfigPath, 'utf-8');
+                const config = JSON.parse(configRaw);
+                const enabled = config.tools?.enabled || [];
+                for (const tool of plugin.toolNames) {
+                    if (!enabled.includes(tool)) {
+                        enabled.push(tool);
+                    }
+                }
+                config.tools = { ...config.tools, enabled };
+                await writeFile(options.blockConfigPath, JSON.stringify(config, null, 4), 'utf-8');
+            }
+            catch {
+                // Config update is best-effort
+            }
+        }
+        return {
+            success: true,
+            message: `Installed ${plugin.name} (${plugin.package}@${plugin.version})`,
+            plugin,
+        };
+    }
+    /**
+     * Remove a plugin:
+     * 1. Check if it's a core plugin (can't remove)
+     * 2. npm uninstall the package
+     * 3. Remove tool names from block config if provided
+     */
+    async remove(pluginId, options) {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin) {
+            return { success: false, message: `Plugin "${pluginId}" not found in registry.` };
+        }
+        if (plugin.core) {
+            return { success: false, message: `Plugin "${plugin.name}" is a core plugin and cannot be removed.` };
+        }
+        const cwd = options?.cwd || process.cwd();
+        try {
+            await new Promise((resolve, reject) => {
+                const child = spawn('npm', ['uninstall', plugin.package], { cwd, shell: true });
+                child.stdout.on('data', data => options?.onLog?.(data.toString()));
+                child.stderr.on('data', data => options?.onLog?.(data.toString()));
+                let done = false;
+                child.on('error', err => { if (!done) {
+                    done = true;
+                    reject(err);
+                } });
+                child.on('close', code => {
+                    if (done)
+                        return;
+                    done = true;
+                    if (code === 0)
+                        resolve();
+                    else
+                        reject(new Error(`Exit code ${code}`));
+                });
+            });
+        }
+        catch {
+            // Uninstall failure is non-critical
+            options?.onLog?.('\nNote: npm uninstall encountered an error, but cleanup will proceed.\n');
+        }
+        // Clean up block config
+        if (options?.blockConfigPath && plugin.toolNames.length > 0) {
+            try {
+                const configRaw = await readFile(options.blockConfigPath, 'utf-8');
+                const config = JSON.parse(configRaw);
+                const enabled = config.tools?.enabled || [];
+                config.tools = {
+                    ...config.tools,
+                    enabled: enabled.filter(t => !plugin.toolNames.includes(t)),
+                };
+                await writeFile(options.blockConfigPath, JSON.stringify(config, null, 4), 'utf-8');
+            }
+            catch {
+                // Config cleanup is best-effort
+            }
+        }
+        // Clean up settings
+        try {
+            const settingsPath = this.pluginSettingsPath(pluginId);
+            const { unlink } = await import('node:fs/promises');
+            await unlink(settingsPath);
+        }
+        catch { /* ignore */ }
+        return {
+            success: true,
+            message: `Removed ${plugin.name} (${plugin.package})`,
+        };
+    }
+    // ===== Settings Storage =====
+    /** Get the workspace-level settings file path for a plugin. */
+    pluginSettingsPath(pluginId, workspacePath) {
+        const base = workspacePath || process.cwd();
+        return join(base, 'plugin-settings', `${pluginId}.json`);
+    }
+    /** Load settings for a plugin. Returns defaults merged with saved values. */
+    async getPluginSettings(pluginId, workspacePath) {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin?.settings)
+            return {};
+        // Start with defaults
+        const defaults = {};
+        for (const [key, field] of Object.entries(plugin.settings)) {
+            defaults[key] = field.default ?? '';
+        }
+        // Merge saved values
+        try {
+            const raw = await readFile(this.pluginSettingsPath(pluginId, workspacePath), 'utf-8');
+            const saved = JSON.parse(raw);
+            return { ...defaults, ...saved };
+        }
+        catch {
+            return defaults;
+        }
+    }
+    /** Save settings for a plugin. */
+    async savePluginSettings(pluginId, values, workspacePath) {
+        const settingsPath = this.pluginSettingsPath(pluginId, workspacePath);
+        await mkdir(dirname(settingsPath), { recursive: true });
+        await writeFile(settingsPath, JSON.stringify(values, null, 4), 'utf-8');
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

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

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@memoryblock/plugin-installer",
+  "version": "0.1.0-beta",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "memoryblock": "0.1.0-beta"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/registry/plugins.json

@@ -0,0 +1,74 @@
+{
+  "plugins": [
+    {
+      "id": "agents",
+      "name": "Multi-Agent Orchestration",
+      "description": "Spawn and manage sub-agents from within a block",
+      "package": "@memoryblock/plugin-agents",
+      "version": "0.1.0",
+      "toolNames": ["create_agent", "list_agents", "query_agent"],
+      "requiresAuth": [],
+      "category": "core",
+      "core": true,
+      "blockSpecific": true,
+      "settings": {
+        "maxSubAgents": { "type": "number", "label": "Max sub-agents per block", "default": 3, "min": 1, "max": 10 },
+        "subAgentTimeout": { "type": "number", "label": "Sub-agent timeout (seconds)", "default": 120, "min": 10, "max": 600 }
+      }
+    },
+    {
+      "id": "web-search",
+      "name": "Web Search",
+      "description": "Search the web using your configured provider",
+      "package": "@memoryblock/plugin-web-search",
+      "version": "0.1.0",
+      "toolNames": ["web_search"],
+      "requiresAuth": ["brave"],
+      "category": "search",
+      "settings": {
+        "maxResults": { "type": "number", "label": "Max results per search", "default": 5, "min": 1, "max": 20 }
+      }
+    },
+    {
+      "id": "aws",
+      "name": "AWS Tools",
+      "description": "AWS SDK client factory for service integration",
+      "package": "@memoryblock/plugin-aws",
+      "version": "0.1.0",
+      "toolNames": [],
+      "requiresAuth": ["aws"],
+      "category": "cloud",
+      "settings": {
+        "defaultRegion": { "type": "text", "label": "Default AWS Region", "default": "us-east-1", "placeholder": "us-east-1" }
+      }
+    },
+    {
+      "id": "fetch-webpage",
+      "name": "Fetch Webpage",
+      "description": "Extract and summarize content from web pages",
+      "package": "@memoryblock/plugin-fetch-webpage",
+      "version": "0.1.0",
+      "toolNames": ["fetch_webpage"],
+      "requiresAuth": [],
+      "category": "web",
+      "status": "upcoming"
+    },
+    {
+      "id": "containers",
+      "name": "Container Isolation",
+      "description": "Run tools inside Podman containers for OS-level isolation",
+      "package": "@memoryblock/plugin-containers",
+      "version": "0.1.0",
+      "toolNames": [],
+      "requiresAuth": [],
+      "category": "security",
+      "status": "upcoming",
+      "settings": {
+        "runtime": { "type": "select", "label": "Container Runtime", "default": "podman", "options": ["podman"] },
+        "defaultImage": { "type": "text", "label": "Default Image", "default": "memoryblock/sandbox:latest", "placeholder": "memoryblock/sandbox:latest" },
+        "memoryLimit": { "type": "text", "label": "Memory Limit", "default": "256m", "placeholder": "256m" },
+        "networkMode": { "type": "select", "label": "Network Mode", "default": "none", "options": ["none", "host", "bridge"] }
+      }
+    }
+  ]
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * @memoryblock/plugin-installer — single-command plugin management.
+ * 
+ * `mblk add web-search` — installs the plugin + adds tools to block config
+ * `mblk remove web-search` — uninstalls the plugin + removes tools from config
+ */
+
+export { PluginInstaller, type PluginEntry, type SettingsField } from './installer.js';

package/src/installer.ts

@@ -0,0 +1,246 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+
+/** Settings field types supported in plugin manifests. */
+export interface SettingsField {
+    type: 'text' | 'password' | 'number' | 'select' | 'toggle';
+    label: string;
+    default?: string | number | boolean;
+    placeholder?: string;
+    options?: string[];          // For 'select' type
+    min?: number;                // For 'number' type
+    max?: number;
+}
+
+export interface PluginEntry {
+    id: string;
+    name: string;
+    description: string;
+    package: string;
+    version: string;
+    toolNames: string[];
+    requiresAuth: string[];
+    category: string;
+    status?: string;
+    core?: boolean;              // Core plugins can't be uninstalled
+    blockSpecific?: boolean;     // Plugin can have per-block settings
+    settings?: Record<string, SettingsField>;
+}
+
+interface PluginRegistry {
+    plugins: PluginEntry[];
+}
+
+/**
+ * Plugin installer — reads from the official registry and manages
+ * installation of npm packages + block config updates.
+ * Extended with settings storage and core plugin support.
+ */
+export class PluginInstaller {
+    private registry: PluginRegistry | null = null;
+    private registryPath: string;
+
+    constructor() {
+        // Registry lives alongside this package's compiled output
+        const thisDir = dirname(fileURLToPath(import.meta.url));
+        this.registryPath = join(thisDir, '..', 'registry', 'plugins.json');
+    }
+
+    /** Load the plugin registry. */
+    async loadRegistry(): Promise<PluginRegistry> {
+        if (this.registry) return this.registry;
+        const raw = await readFile(this.registryPath, 'utf-8');
+        this.registry = JSON.parse(raw) as PluginRegistry;
+        return this.registry;
+    }
+
+    /** List all available plugins. */
+    async listPlugins(): Promise<PluginEntry[]> {
+        const reg = await this.loadRegistry();
+        return reg.plugins;
+    }
+
+    /** Find a plugin by ID. */
+    async findPlugin(id: string): Promise<PluginEntry | undefined> {
+        const reg = await this.loadRegistry();
+        return reg.plugins.find(p => p.id === id);
+    }
+
+    /**
+     * Install a plugin:
+     * 1. npm install the package
+     * 2. Add tool names to the block's config.json if provided
+     */
+    async install(pluginId: string, options?: { blockConfigPath?: string; cwd?: string; onLog?: (chunk: string) => void }): Promise<{
+        success: boolean;
+        message: string;
+        plugin?: PluginEntry;
+    }> {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin) {
+            return { success: false, message: `Plugin "${pluginId}" not found in registry.` };
+        }
+
+        if (plugin.status === 'upcoming') {
+            return { success: false, message: `Plugin "${plugin.name}" is not yet available.` };
+        }
+
+        // Install npm package
+        const cwd = options?.cwd || process.cwd();
+        try {
+            await new Promise<void>((resolve, reject) => {
+                const child = spawn('npm', ['install', `${plugin.package}@${plugin.version}`], { cwd, shell: true });
+                child.stdout.on('data', data => options?.onLog?.(data.toString()));
+                child.stderr.on('data', data => options?.onLog?.(data.toString()));
+                
+                let done = false;
+                child.on('error', err => { if (!done) { done = true; reject(err); } });
+                child.on('close', code => {
+                    if (done) return;
+                    done = true;
+                    if (code === 0) resolve();
+                    else reject(new Error(`Exit code ${code}`));
+                });
+            });
+        } catch (err) {
+            return {
+                success: false,
+                message: `Failed to install ${plugin.package}: ${(err as Error).message}`,
+            };
+        }
+
+        // Auto-update block config if path provided
+        if (options?.blockConfigPath && plugin.toolNames.length > 0) {
+            try {
+                const configRaw = await readFile(options.blockConfigPath, 'utf-8');
+                const config = JSON.parse(configRaw);
+                const enabled = config.tools?.enabled || [];
+
+                for (const tool of plugin.toolNames) {
+                    if (!enabled.includes(tool)) {
+                        enabled.push(tool);
+                    }
+                }
+
+                config.tools = { ...config.tools, enabled };
+                await writeFile(options.blockConfigPath, JSON.stringify(config, null, 4), 'utf-8');
+            } catch {
+                // Config update is best-effort
+            }
+        }
+
+        return {
+            success: true,
+            message: `Installed ${plugin.name} (${plugin.package}@${plugin.version})`,
+            plugin,
+        };
+    }
+
+    /**
+     * Remove a plugin:
+     * 1. Check if it's a core plugin (can't remove)
+     * 2. npm uninstall the package
+     * 3. Remove tool names from block config if provided
+     */
+    async remove(pluginId: string, options?: { blockConfigPath?: string; cwd?: string; onLog?: (chunk: string) => void }): Promise<{
+        success: boolean;
+        message: string;
+    }> {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin) {
+            return { success: false, message: `Plugin "${pluginId}" not found in registry.` };
+        }
+
+        if (plugin.core) {
+            return { success: false, message: `Plugin "${plugin.name}" is a core plugin and cannot be removed.` };
+        }
+
+        const cwd = options?.cwd || process.cwd();
+        try {
+            await new Promise<void>((resolve, reject) => {
+                const child = spawn('npm', ['uninstall', plugin.package], { cwd, shell: true });
+                child.stdout.on('data', data => options?.onLog?.(data.toString()));
+                child.stderr.on('data', data => options?.onLog?.(data.toString()));
+                
+                let done = false;
+                child.on('error', err => { if (!done) { done = true; reject(err); } });
+                child.on('close', code => {
+                    if (done) return;
+                    done = true;
+                    if (code === 0) resolve();
+                    else reject(new Error(`Exit code ${code}`));
+                });
+            });
+        } catch {
+            // Uninstall failure is non-critical
+            options?.onLog?.('\nNote: npm uninstall encountered an error, but cleanup will proceed.\n');
+        }
+
+        // Clean up block config
+        if (options?.blockConfigPath && plugin.toolNames.length > 0) {
+            try {
+                const configRaw = await readFile(options.blockConfigPath, 'utf-8');
+                const config = JSON.parse(configRaw);
+                const enabled: string[] = config.tools?.enabled || [];
+
+                config.tools = {
+                    ...config.tools,
+                    enabled: enabled.filter(t => !plugin.toolNames.includes(t)),
+                };
+                await writeFile(options.blockConfigPath, JSON.stringify(config, null, 4), 'utf-8');
+            } catch {
+                // Config cleanup is best-effort
+            }
+        }
+
+        // Clean up settings
+        try {
+            const settingsPath = this.pluginSettingsPath(pluginId);
+            const { unlink } = await import('node:fs/promises');
+            await unlink(settingsPath);
+        } catch { /* ignore */ }
+
+        return {
+            success: true,
+            message: `Removed ${plugin.name} (${plugin.package})`,
+        };
+    }
+
+    // ===== Settings Storage =====
+
+    /** Get the workspace-level settings file path for a plugin. */
+    private pluginSettingsPath(pluginId: string, workspacePath?: string): string {
+        const base = workspacePath || process.cwd();
+        return join(base, 'plugin-settings', `${pluginId}.json`);
+    }
+
+    /** Load settings for a plugin. Returns defaults merged with saved values. */
+    async getPluginSettings(pluginId: string, workspacePath?: string): Promise<Record<string, unknown>> {
+        const plugin = await this.findPlugin(pluginId);
+        if (!plugin?.settings) return {};
+
+        // Start with defaults
+        const defaults: Record<string, unknown> = {};
+        for (const [key, field] of Object.entries(plugin.settings)) {
+            defaults[key] = field.default ?? '';
+        }
+
+        // Merge saved values
+        try {
+            const raw = await readFile(this.pluginSettingsPath(pluginId, workspacePath), 'utf-8');
+            const saved = JSON.parse(raw);
+            return { ...defaults, ...saved };
+        } catch {
+            return defaults;
+        }
+    }
+
+    /** Save settings for a plugin. */
+    async savePluginSettings(pluginId: string, values: Record<string, unknown>, workspacePath?: string): Promise<void> {
+        const settingsPath = this.pluginSettingsPath(pluginId, workspacePath);
+        await mkdir(dirname(settingsPath), { recursive: true });
+        await writeFile(settingsPath, JSON.stringify(values, null, 4), 'utf-8');
+    }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "dist",
+        "rootDir": "src",
+        "resolveJsonModule": true
+    },
+    "include": [
+        "src"
+    ]
+}