@adverant-nexus/cli 2.0.0

package/dist/core/discovery/plugin-discovery.js

@@ -0,0 +1,333 @@
+/**
+ * Plugin Discovery
+ *
+ * Auto-discovers plugins from ~/.nexus/plugins/ directory
+ * Loads and validates plugin manifests
+ */
+import { readdir, readFile, stat } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Discover all plugins in plugin directory
+ */
+export async function discoverPlugins(options = {}) {
+    const { pluginDir = join(homedir(), '.nexus', 'plugins'), validateStructure = true, loadDisabled = false } = options;
+    const plugins = [];
+    try {
+        // Check if plugins directory exists
+        try {
+            await stat(pluginDir);
+        }
+        catch {
+            // Directory doesn't exist, return empty array
+            return plugins;
+        }
+        // Read all subdirectories
+        const entries = await readdir(pluginDir, { withFileTypes: true });
+        const directories = entries.filter(e => e.isDirectory());
+        // Load each plugin
+        for (const dir of directories) {
+            const pluginPath = join(pluginDir, dir.name);
+            try {
+                const plugin = await loadPlugin(pluginPath, validateStructure);
+                // Skip disabled plugins unless loadDisabled is true
+                if (!loadDisabled && plugin.disabled) {
+                    continue;
+                }
+                plugins.push(plugin);
+            }
+            catch (error) {
+                console.warn(`Warning: Could not load plugin from ${pluginPath}:`, error);
+                // Continue with other plugins
+            }
+        }
+    }
+    catch (error) {
+        console.warn(`Warning: Could not scan plugin directory ${pluginDir}:`, error);
+    }
+    return plugins;
+}
+/**
+ * Load a single plugin from directory
+ */
+export async function loadPlugin(pluginPath, validateStructure = true) {
+    // Load plugin.json manifest
+    const manifestPath = join(pluginPath, 'plugin.json');
+    const manifest = await loadPluginManifest(manifestPath);
+    // Validate manifest
+    validateManifest(manifest);
+    // Validate directory structure if requested
+    if (validateStructure) {
+        await validatePluginStructure(pluginPath, manifest);
+    }
+    return {
+        ...manifest,
+        path: pluginPath,
+        manifestPath,
+        loaded: false,
+        disabled: false,
+        error: undefined
+    };
+}
+/**
+ * Load plugin.json manifest
+ */
+export async function loadPluginManifest(manifestPath) {
+    try {
+        const content = await readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(content);
+        return manifest;
+    }
+    catch (error) {
+        throw new Error(`Failed to load plugin manifest from ${manifestPath}: ${error}`);
+    }
+}
+/**
+ * Validate plugin manifest
+ */
+function validateManifest(manifest) {
+    const required = ['name', 'version', 'description', 'author', 'commands'];
+    for (const field of required) {
+        if (!(field in manifest)) {
+            throw new Error(`Plugin manifest missing required field: ${field}`);
+        }
+    }
+    // Validate version format (semver)
+    if (!/^\d+\.\d+\.\d+/.test(manifest.version)) {
+        throw new Error(`Invalid version format: ${manifest.version}. Expected semver (e.g., 1.0.0)`);
+    }
+    // Validate commands
+    if (!Array.isArray(manifest.commands) || manifest.commands.length === 0) {
+        throw new Error('Plugin must define at least one command');
+    }
+    for (const cmd of manifest.commands) {
+        validateCommand(cmd);
+    }
+    // Validate permissions if present
+    if (manifest.permissions) {
+        validatePermissions(manifest.permissions);
+    }
+}
+/**
+ * Validate plugin command definition
+ */
+function validateCommand(command) {
+    if (!command.name) {
+        throw new Error('Command missing required field: name');
+    }
+    if (!command.description) {
+        throw new Error(`Command ${command.name} missing required field: description`);
+    }
+    // Validate command name format (kebab-case)
+    if (!/^[a-z][a-z0-9-]*$/.test(command.name)) {
+        throw new Error(`Invalid command name: ${command.name}. Must be lowercase kebab-case (e.g., my-command)`);
+    }
+    // Validate args if present
+    if (command.args) {
+        for (const arg of command.args) {
+            validateArgument(arg);
+        }
+    }
+}
+/**
+ * Validate command argument
+ */
+function validateArgument(arg) {
+    const required = ['name', 'type', 'description'];
+    for (const field of required) {
+        if (!(field in arg)) {
+            throw new Error(`Argument missing required field: ${field}`);
+        }
+    }
+    // Validate type
+    const validTypes = ['string', 'number', 'boolean', 'array', 'object', 'file'];
+    if (!validTypes.includes(arg.type)) {
+        throw new Error(`Invalid argument type: ${arg.type}. Must be one of: ${validTypes.join(', ')}`);
+    }
+}
+/**
+ * Validate plugin permissions
+ */
+function validatePermissions(permissions) {
+    const validPermissions = [
+        'file:read',
+        'file:write',
+        'network:http',
+        'network:https',
+        'network:websocket',
+        'service:graphrag',
+        'service:mageagent',
+        'service:sandbox',
+        'docker:read',
+        'docker:write'
+    ];
+    for (const perm of permissions) {
+        // Check if it matches a valid permission pattern
+        const isValid = validPermissions.some(valid => {
+            if (valid.endsWith(':*')) {
+                return perm.startsWith(valid.replace(':*', ':'));
+            }
+            return perm === valid;
+        });
+        if (!isValid) {
+            console.warn(`Warning: Unknown permission: ${perm}`);
+        }
+    }
+}
+/**
+ * Validate plugin directory structure
+ */
+async function validatePluginStructure(pluginPath, manifest) {
+    // Check for required files
+    const requiredFiles = ['plugin.json'];
+    // If main field is specified, check if file exists
+    if (manifest.main) {
+        requiredFiles.push(manifest.main);
+    }
+    for (const file of requiredFiles) {
+        const filePath = join(pluginPath, file);
+        try {
+            await stat(filePath);
+        }
+        catch {
+            throw new Error(`Required file not found: ${file}`);
+        }
+    }
+    // Check for commands directory if commands are defined
+    if (manifest.commands && manifest.commands.length > 0) {
+        const commandsDir = join(pluginPath, 'commands');
+        try {
+            const stats = await stat(commandsDir);
+            if (!stats.isDirectory()) {
+                console.warn(`Warning: commands path exists but is not a directory`);
+            }
+        }
+        catch {
+            console.warn(`Warning: commands directory not found (may be using main entry point)`);
+        }
+    }
+}
+/**
+ * Check plugin dependencies
+ */
+export async function checkPluginDependencies(plugin, availableServices) {
+    const missing = [];
+    if (plugin.dependencies) {
+        for (const dep of plugin.dependencies) {
+            if (!availableServices.has(dep)) {
+                missing.push(dep);
+            }
+        }
+    }
+    return {
+        satisfied: missing.length === 0,
+        missing
+    };
+}
+/**
+ * Filter plugins by permission requirements
+ */
+export function filterPluginsByPermissions(plugins, allowedPermissions) {
+    return plugins.filter(plugin => {
+        if (!plugin.permissions || plugin.permissions.length === 0) {
+            return true; // No permissions required
+        }
+        // Check if all required permissions are allowed
+        return plugin.permissions.every(perm => {
+            // Check for exact match
+            if (allowedPermissions.has(perm)) {
+                return true;
+            }
+            // Check for wildcard match (e.g., service:* allows service:graphrag)
+            const [category] = perm.split(':');
+            if (allowedPermissions.has(`${category}:*`)) {
+                return true;
+            }
+            return false;
+        });
+    });
+}
+/**
+ * Get plugin by name
+ */
+export async function getPlugin(name, options = {}) {
+    const plugins = await discoverPlugins(options);
+    return plugins.find(p => p.name === name) || null;
+}
+/**
+ * Get all plugin commands
+ */
+export function getPluginCommands(plugins) {
+    const commandMap = new Map();
+    for (const plugin of plugins) {
+        commandMap.set(plugin.name, plugin.commands);
+    }
+    return commandMap;
+}
+/**
+ * Search plugins by keyword
+ */
+export function searchPlugins(plugins, query) {
+    const lowerQuery = query.toLowerCase();
+    return plugins.filter(plugin => {
+        // Search in name
+        if (plugin.name.toLowerCase().includes(lowerQuery)) {
+            return true;
+        }
+        // Search in description
+        if (plugin.description.toLowerCase().includes(lowerQuery)) {
+            return true;
+        }
+        // Search in command names
+        if (plugin.commands.some(cmd => cmd.name.toLowerCase().includes(lowerQuery))) {
+            return true;
+        }
+        // Search in tags (if present)
+        if (plugin.tags && plugin.tags.some(tag => tag.toLowerCase().includes(lowerQuery))) {
+            return true;
+        }
+        return false;
+    });
+}
+/**
+ * Group plugins by category
+ */
+export function groupPluginsByCategory(plugins) {
+    const groups = new Map();
+    for (const plugin of plugins) {
+        const category = plugin.category || 'Other';
+        if (!groups.has(category)) {
+            groups.set(category, []);
+        }
+        groups.get(category).push(plugin);
+    }
+    return groups;
+}
+/**
+ * Get plugin statistics
+ */
+export function getPluginStats(plugins) {
+    const stats = {
+        total: plugins.length,
+        enabled: plugins.filter(p => !p.disabled).length,
+        disabled: plugins.filter(p => p.disabled).length,
+        totalCommands: plugins.reduce((sum, p) => sum + p.commands.length, 0),
+        byCategory: {},
+        byPermission: {}
+    };
+    // Group by category
+    for (const plugin of plugins) {
+        const category = plugin.category || 'Other';
+        stats.byCategory[category] = (stats.byCategory[category] || 0) + 1;
+    }
+    // Count permissions
+    for (const plugin of plugins) {
+        if (plugin.permissions) {
+            for (const perm of plugin.permissions) {
+                stats.byPermission[perm] = (stats.byPermission[perm] || 0) + 1;
+            }
+        }
+    }
+    return stats;
+}
+//# sourceMappingURL=plugin-discovery.js.map

package/dist/core/discovery/plugin-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-discovery.js","sourceRoot":"","sources":["../../../src/core/discovery/plugin-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAS7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkC,EAAE;IAEpC,MAAM,EACJ,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,EAChD,iBAAiB,GAAG,IAAI,EACxB,YAAY,GAAG,KAAK,EACrB,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,0BAA0B;QAC1B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAEzD,mBAAmB;QACnB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAE7C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;gBAE/D,oDAAoD;gBACpD,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACrC,SAAS;gBACX,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC1E,8BAA8B;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,4CAA4C,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,oBAA6B,IAAI;IAEjC,4BAA4B;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAExD,oBAAoB;IACpB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE3B,4CAA4C;IAC5C,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,uBAAuB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,UAAU;QAChB,YAAY;QACZ,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,YAAoB;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;QACvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,YAAY,KAAK,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,QAAwB;IAChD,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE1E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,OAAO,iCAAiC,CAAC,CAAC;IAChG,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpC,eAAe,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,kCAAkC;IAClC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,mBAAmB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,OAAyD;IAChF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,sCAAsC,CAAC,CAAC;IACjF,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,CAAC,IAAI,mDAAmD,CACzF,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAQ;IAChC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAEjD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,IAAI,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,WAAqB;IAChD,MAAM,gBAAgB,GAAG;QACvB,WAAW;QACX,YAAY;QACZ,cAAc;QACd,eAAe;QACf,mBAAmB;QACnB,kBAAkB;QAClB,mBAAmB;QACnB,iBAAiB;QACjB,aAAa;QACb,cAAc;KACf,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,iDAAiD;QACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,KAAK,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CACpC,UAAkB,EAClB,QAAwB;IAExB,2BAA2B;IAC3B,MAAM,aAAa,GAAG,CAAC,aAAa,CAAC,CAAC;IAEtC,mDAAmD;IACnD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAc,EACd,iBAA8B;IAK9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC/B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAiB,EACjB,kBAA+B;IAE/B,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC,0BAA0B;QACzC,CAAC;QAED,gDAAgD;QAChD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;YACrC,wBAAwB;YACxB,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,qEAAqE;YACrE,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiB;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB,EAAE,KAAa;IAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QAC7B,iBAAiB;QACjB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wBAAwB;QACxB,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8BAA8B;QAC9B,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAiB;IACtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAiB;IAQ9C,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM;QAChD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM;QAChD,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,UAAU,EAAE,EAA4B;QACxC,YAAY,EAAE,EAA4B;KAC3C,CAAC;IAEF,oBAAoB;IACpB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC;QAC5C,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACtC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/discovery/service-discovery.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Service Discovery Engine
+ *
+ * Main orchestrator that discovers services, commands, and capabilities
+ * Caches results for performance
+ */
+import type { ServiceMetadata, ServiceHealth, ServiceCommand } from '../../types/service.js';
+import type { Plugin } from '../../types/plugin.js';
+export interface ServiceDiscoveryOptions {
+    composeFiles?: string[];
+    mcpUrl?: string;
+    pluginDir?: string;
+    skipHealthCheck?: boolean;
+    skipOpenAPI?: boolean;
+    skipMCP?: boolean;
+    skipPlugins?: boolean;
+    cacheTimeout?: number;
+}
+export interface DiscoveryResult {
+    services: Map<string, ServiceMetadata>;
+    commands: Map<string, ServiceCommand[]>;
+    plugins: Plugin[];
+    nexusCommands: ServiceCommand[];
+    timestamp: Date;
+}
+/**
+ * Discover all services from docker-compose files
+ */
+export declare function discoverServices(options?: ServiceDiscoveryOptions): Promise<Map<string, ServiceMetadata>>;
+/**
+ * Refresh discovery cache
+ */
+export declare function refreshDiscovery(options?: ServiceDiscoveryOptions): Promise<DiscoveryResult>;
+/**
+ * Get cached discovery result or refresh if expired
+ */
+export declare function getDiscovery(options?: ServiceDiscoveryOptions): Promise<DiscoveryResult>;
+/**
+ * Get service health status
+ */
+export declare function getServiceHealth(service: ServiceMetadata): Promise<ServiceHealth>;
+/**
+ * Get service by name
+ */
+export declare function getService(name: string, options?: ServiceDiscoveryOptions): Promise<ServiceMetadata | null>;
+/**
+ * Get all commands for a service
+ */
+export declare function getServiceCommands(serviceName: string, options?: ServiceDiscoveryOptions): Promise<ServiceCommand[]>;
+/**
+ * Get all Nexus commands
+ */
+export declare function getNexusCommands(options?: ServiceDiscoveryOptions): Promise<ServiceCommand[]>;
+/**
+ * Get all plugins
+ */
+export declare function getPlugins(options?: ServiceDiscoveryOptions): Promise<Plugin[]>;
+/**
+ * Search for commands across all services
+ */
+export declare function searchCommands(query: string, options?: ServiceDiscoveryOptions): Promise<Array<{
+    service: string;
+    command: ServiceCommand;
+}>>;
+/**
+ * Get service statistics
+ */
+export declare function getServiceStats(options?: ServiceDiscoveryOptions): Promise<{
+    totalServices: number;
+    runningServices: number;
+    totalCommands: number;
+    totalPlugins: number;
+    totalNexusTools: number;
+}>;
+/**
+ * Clear discovery cache
+ */
+export declare function clearCache(): void;
+/**
+ * Get cache status
+ */
+export declare function getCacheStatus(): {
+    cached: boolean;
+    age: number;
+    timestamp: Date | null;
+};
+/**
+ * Validate service configuration
+ */
+export declare function validateService(serviceName: string, options?: ServiceDiscoveryOptions): Promise<{
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}>;
+/**
+ * Get service dependency graph
+ */
+export declare function getServiceDependencies(options?: ServiceDiscoveryOptions): Promise<Map<string, string[]>>;
+/**
+ * Check if all service dependencies are satisfied
+ */
+export declare function checkDependencies(serviceName: string, options?: ServiceDiscoveryOptions): Promise<{
+    satisfied: boolean;
+    missing: string[];
+    available: string[];
+}>;
+//# sourceMappingURL=service-discovery.d.ts.map

package/dist/core/discovery/service-discovery.d.ts.map

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