@adverant-nexus/cli 2.0.0

package/dist/plugins/plugin-manager.js

@@ -0,0 +1,310 @@
+/**
+ * Plugin Manager
+ *
+ * Manages plugin lifecycle: discovery, registration, enable/disable
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { pluginLoader } from './plugin-loader.js';
+import { pluginValidator } from './plugin-validator.js';
+import { getPluginsDirectory, ensureNexusDirectories } from './plugin-storage.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Plugin Manager Class
+ */
+export class PluginManager {
+    plugins = new Map();
+    initialized = false;
+    /**
+     * Initialize plugin manager
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            // Ensure Nexus directories exist
+            await ensureNexusDirectories();
+            // Discover and load plugins
+            await this.discover();
+            this.initialized = true;
+            logger.info(`Plugin manager initialized with ${this.plugins.size} plugin(s)`);
+        }
+        catch (error) {
+            logger.error('Failed to initialize plugin manager:', error);
+            throw error;
+        }
+    }
+    /**
+     * Discover plugins from ~/.nexus/plugins/
+     */
+    async discover() {
+        const pluginsDir = getPluginsDirectory();
+        const discoveredPlugins = [];
+        try {
+            // Ensure plugins directory exists
+            await fs.ensureDir(pluginsDir);
+            // Read plugin directories
+            const entries = await fs.readdir(pluginsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory()) {
+                    continue;
+                }
+                const pluginPath = path.join(pluginsDir, entry.name);
+                try {
+                    // Check if plugin.json exists
+                    const manifestPath = path.join(pluginPath, 'plugin.json');
+                    if (!(await fs.pathExists(manifestPath))) {
+                        logger.warn(`Skipping ${entry.name}: No plugin.json found`);
+                        continue;
+                    }
+                    // Load plugin
+                    const plugin = await pluginLoader.load(pluginPath);
+                    // Validate plugin
+                    const validationResult = pluginValidator.validatePlugin(plugin);
+                    if (!validationResult.valid) {
+                        logger.error(`Plugin ${plugin.name} validation failed:`, validationResult.errors.join(', '));
+                        continue;
+                    }
+                    // Show warnings
+                    if (validationResult.warnings.length > 0) {
+                        logger.warn(`Plugin ${plugin.name} warnings:`, validationResult.warnings.join(', '));
+                    }
+                    discoveredPlugins.push(plugin);
+                    logger.info(`Discovered plugin: ${plugin.name} v${plugin.version}`);
+                }
+                catch (error) {
+                    logger.error(`Failed to load plugin from ${entry.name}:`, error);
+                }
+            }
+            return discoveredPlugins;
+        }
+        catch (error) {
+            logger.error('Failed to discover plugins:', error);
+            return [];
+        }
+    }
+    /**
+     * Register plugin
+     */
+    async register(plugin) {
+        try {
+            // Validate plugin
+            const validationResult = pluginValidator.validatePlugin(plugin);
+            if (!validationResult.valid) {
+                throw new Error(`Plugin validation failed: ${validationResult.errors.join(', ')}`);
+            }
+            // Check if already registered
+            if (this.plugins.has(plugin.name)) {
+                throw new Error(`Plugin ${plugin.name} is already registered`);
+            }
+            // Call onLoad hook
+            await pluginLoader.executePluginHook(plugin, 'onLoad');
+            // Register plugin
+            this.plugins.set(plugin.name, plugin);
+            logger.info(`Plugin registered: ${plugin.name} v${plugin.version}`);
+        }
+        catch (error) {
+            logger.error(`Failed to register plugin ${plugin.name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Unregister plugin
+     */
+    async unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin ${name} not found`);
+        }
+        try {
+            // Call onUnload hook
+            await pluginLoader.executePluginHook(plugin, 'onUnload');
+            // Unregister
+            this.plugins.delete(name);
+            logger.info(`Plugin unregistered: ${name}`);
+        }
+        catch (error) {
+            logger.error(`Failed to unregister plugin ${name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get plugin by name
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * List all plugins
+     */
+    list() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Enable plugin
+     */
+    async enable(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin ${name} not found`);
+        }
+        if (plugin.enabled) {
+            logger.info(`Plugin ${name} is already enabled`);
+            return;
+        }
+        try {
+            // Call onEnable hook
+            await pluginLoader.executePluginHook(plugin, 'onEnable');
+            // Mark as enabled
+            plugin.enabled = true;
+            // Persist state
+            await this.persistPluginState(plugin);
+            logger.info(`Plugin enabled: ${name}`);
+        }
+        catch (error) {
+            logger.error(`Failed to enable plugin ${name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Disable plugin
+     */
+    async disable(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin ${name} not found`);
+        }
+        if (!plugin.enabled) {
+            logger.info(`Plugin ${name} is already disabled`);
+            return;
+        }
+        try {
+            // Call onDisable hook
+            await pluginLoader.executePluginHook(plugin, 'onDisable');
+            // Mark as disabled
+            plugin.enabled = false;
+            // Persist state
+            await this.persistPluginState(plugin);
+            logger.info(`Plugin disabled: ${name}`);
+        }
+        catch (error) {
+            logger.error(`Failed to disable plugin ${name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Update plugin
+     */
+    async update(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin ${name} not found`);
+        }
+        try {
+            // Unregister current version
+            await this.unregister(name);
+            // Reload plugin
+            const pluginPath = path.join(getPluginsDirectory(), name);
+            const updatedPlugin = await pluginLoader.load(pluginPath);
+            // Register updated version
+            await this.register(updatedPlugin);
+            logger.info(`Plugin updated: ${name} to v${updatedPlugin.version}`);
+        }
+        catch (error) {
+            logger.error(`Failed to update plugin ${name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Install plugin from path
+     */
+    async install(sourcePath) {
+        try {
+            // Load plugin from source
+            const plugin = await pluginLoader.load(sourcePath);
+            // Validate plugin
+            const validationResult = pluginValidator.validatePlugin(plugin);
+            if (!validationResult.valid) {
+                throw new Error(`Plugin validation failed: ${validationResult.errors.join(', ')}`);
+            }
+            // Copy plugin to plugins directory
+            const destPath = path.join(getPluginsDirectory(), plugin.name);
+            if (await fs.pathExists(destPath)) {
+                throw new Error(`Plugin ${plugin.name} already exists. Use update to upgrade.`);
+            }
+            await fs.copy(sourcePath, destPath);
+            // Register plugin
+            await this.register(plugin);
+            logger.info(`Plugin installed: ${plugin.name} v${plugin.version}`);
+            return plugin;
+        }
+        catch (error) {
+            logger.error(`Failed to install plugin from ${sourcePath}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Uninstall plugin
+     */
+    async uninstall(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin ${name} not found`);
+        }
+        try {
+            // Unregister plugin
+            await this.unregister(name);
+            // Remove plugin directory
+            const pluginPath = path.join(getPluginsDirectory(), name);
+            await fs.remove(pluginPath);
+            logger.info(`Plugin uninstalled: ${name}`);
+        }
+        catch (error) {
+            logger.error(`Failed to uninstall plugin ${name}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get enabled plugins
+     */
+    getEnabledPlugins() {
+        return this.list().filter((plugin) => plugin.enabled);
+    }
+    /**
+     * Get disabled plugins
+     */
+    getDisabledPlugins() {
+        return this.list().filter((plugin) => !plugin.enabled);
+    }
+    /**
+     * Persist plugin state to disk
+     */
+    async persistPluginState(plugin) {
+        const pluginPath = path.join(getPluginsDirectory(), plugin.name);
+        const statePath = path.join(pluginPath, '.plugin-state.json');
+        const state = {
+            enabled: plugin.enabled,
+            installed: plugin.installed,
+            lastUpdated: new Date().toISOString(),
+        };
+        await fs.writeFile(statePath, JSON.stringify(state, null, 2));
+    }
+    /**
+     * Load plugin state from disk
+     */
+    async loadPluginState(plugin) {
+        const pluginPath = path.join(getPluginsDirectory(), plugin.name);
+        const statePath = path.join(pluginPath, '.plugin-state.json');
+        if (await fs.pathExists(statePath)) {
+            const state = await fs.readJson(statePath);
+            plugin.enabled = state.enabled ?? false;
+            plugin.installed = state.installed ?? true;
+        }
+    }
+}
+/**
+ * Singleton instance
+ */
+export const pluginManager = new PluginManager();
+//# sourceMappingURL=plugin-manager.js.map

package/dist/plugins/plugin-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../../src/plugins/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IACzC,WAAW,GAAG,KAAK,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,sBAAsB,EAAE,CAAC;YAE/B,4BAA4B;YAC5B,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YAEtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;QACzC,MAAM,iBAAiB,GAAa,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,kCAAkC;YAClC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAE/B,0BAA0B;YAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzB,SAAS;gBACX,CAAC;gBAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAErD,IAAI,CAAC;oBACH,8BAA8B;oBAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;oBAC1D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;wBACzC,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,wBAAwB,CAAC,CAAC;wBAC5D,SAAS;oBACX,CAAC;oBAED,cAAc;oBACd,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAEnD,kBAAkB;oBAClB,MAAM,gBAAgB,GAAG,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;oBAEhE,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;wBAC5B,MAAM,CAAC,KAAK,CACV,UAAU,MAAM,CAAC,IAAI,qBAAqB,EAC1C,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CACnC,CAAC;wBACF,SAAS;oBACX,CAAC;oBAED,gBAAgB;oBAChB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzC,MAAM,CAAC,IAAI,CACT,UAAU,MAAM,CAAC,IAAI,YAAY,EACjC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACrC,CAAC;oBACJ,CAAC;oBAED,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YAED,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,gBAAgB,GAAG,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEhE,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,6BAA6B,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,wBAAwB,CAAC,CAAC;YACjE,CAAC;YAED,mBAAmB;YACnB,MAAM,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEvD,kBAAkB;YAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEtC,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,qBAAqB;YACrB,MAAM,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEzD,aAAa;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1B,MAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,qBAAqB,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,qBAAqB;YACrB,MAAM,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEzD,kBAAkB;YAClB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YAEtB,gBAAgB;YAChB,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,CAAC,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,sBAAsB,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAE1D,mBAAmB;YACnB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YAEvB,gBAAgB;YAChB,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,6BAA6B;YAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAE5B,gBAAgB;YAChB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1D,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE1D,2BAA2B;YAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAEnC,MAAM,CAAC,IAAI,CAAC,mBAAmB,IAAI,QAAQ,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,IAAI,CAAC;YACH,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEnD,kBAAkB;YAClB,MAAM,gBAAgB,GAAG,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEhE,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,6BAA6B,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,UAAU,MAAM,CAAC,IAAI,yCAAyC,CAC/D,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEpC,kBAAkB;YAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAE5B,0BAA0B;YAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1D,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,MAAc;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAE9D,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,MAAc;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAE9D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC;YACxC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/plugins/plugin-sdk.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Plugin SDK
+ *
+ * API for plugin developers to create Nexus plugins
+ */
+import type { Plugin, PluginCommand, PluginCommandHandler, PluginPermission, MCPServerConfig, PluginContext, PluginLogger, PluginArgument, PluginOption } from '../types/plugin.js';
+import { createPluginStorage, type PluginStorage } from './plugin-storage.js';
+/**
+ * Plugin Builder - Fluent API for creating plugins
+ */
+export declare class PluginBuilder {
+    private plugin;
+    private commands;
+    private permissions;
+    private dependencies;
+    private hooks;
+    private mcpConfig?;
+    private constructor();
+    /**
+     * Create new plugin builder
+     */
+    static create(name: string): PluginBuilder;
+    /**
+     * Set plugin version
+     */
+    version(version: string): this;
+    /**
+     * Set plugin description
+     */
+    description(description: string): this;
+    /**
+     * Set plugin author
+     */
+    author(author: string): this;
+    /**
+     * Set plugin homepage
+     */
+    homepage(homepage: string): this;
+    /**
+     * Set plugin repository
+     */
+    repository(repository: string): this;
+    /**
+     * Set main entry file
+     */
+    main(main: string): this;
+    /**
+     * Add command to plugin
+     */
+    command(name: string, config: {
+        description: string;
+        args?: PluginArgument[];
+        options?: PluginOption[];
+        handler: PluginCommandHandler;
+        examples?: string[];
+    }): this;
+    /**
+     * Add onLoad lifecycle hook
+     */
+    onLoad(handler: () => Promise<void>): this;
+    /**
+     * Add onUnload lifecycle hook
+     */
+    onUnload(handler: () => Promise<void>): this;
+    /**
+     * Add onEnable lifecycle hook
+     */
+    onEnable(handler: () => Promise<void>): this;
+    /**
+     * Add onDisable lifecycle hook
+     */
+    onDisable(handler: () => Promise<void>): this;
+    /**
+     * Add permission to plugin
+     */
+    permission(permission: PluginPermission | string): this;
+    /**
+     * Add service dependency
+     */
+    dependency(service: string): this;
+    /**
+     * Configure MCP server
+     */
+    mcp(config: MCPServerConfig): this;
+    /**
+     * Build plugin
+     */
+    build(): Plugin;
+}
+/**
+ * Create plugin logger
+ */
+export declare function createPluginLogger(pluginName: string): PluginLogger;
+/**
+ * Create plugin context
+ */
+export declare function createPluginContext(pluginName: string, services?: any, transport?: any): PluginContext;
+/**
+ * Helper to create file permission
+ */
+export declare function filePermission(scope: string, level?: 'read' | 'write' | 'execute'): PluginPermission;
+/**
+ * Helper to create network permission
+ */
+export declare function networkPermission(scope: string, level?: 'read' | 'write' | 'execute'): PluginPermission;
+/**
+ * Helper to create service permission
+ */
+export declare function servicePermission(scope: string, level?: 'read' | 'write' | 'execute'): PluginPermission;
+/**
+ * Helper to create system permission
+ */
+export declare function systemPermission(scope: string, level?: 'read' | 'write' | 'execute'): PluginPermission;
+/**
+ * Helper to create plugin argument
+ */
+export declare function arg(name: string, config: {
+    description: string;
+    required?: boolean;
+    type?: string;
+    default?: any;
+}): PluginArgument;
+/**
+ * Helper to create plugin option
+ */
+export declare function option(long: string, config: {
+    short?: string;
+    description: string;
+    type?: string;
+    default?: any;
+}): PluginOption;
+/**
+ * Export all SDK components
+ */
+export { type Plugin, type PluginCommand, type PluginCommandHandler, type PluginPermission, type PluginContext, type PluginLogger, type PluginStorage, type MCPServerConfig, type PluginArgument, type PluginOption, createPluginStorage, };
+//# sourceMappingURL=plugin-sdk.d.ts.map

package/dist/plugins/plugin-sdk.d.ts.map

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