@adverant-nexus/cli 2.0.0

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

@@ -0,0 +1,349 @@
+/**
+ * Service Discovery Engine
+ *
+ * Main orchestrator that discovers services, commands, and capabilities
+ * Caches results for performance
+ */
+import axios from 'axios';
+import { ServiceStatus } from '../../types/service.js';
+import { parseMultipleComposeFiles, filterApplicationServices } from './docker-parser.js';
+import { fetchOpenAPISpec, parseOpenAPIToCommands } from './openapi-parser.js';
+import { discoverMCPCommands } from './mcp-discovery.js';
+import { discoverPlugins, getPluginCommands } from './plugin-discovery.js';
+// In-memory cache
+let discoveryCache = null;
+let cacheTimestamp = 0;
+const DEFAULT_CACHE_TTL = 30 * 60 * 1000; // 30 minutes
+/**
+ * Discover all services from docker-compose files
+ */
+export async function discoverServices(options = {}) {
+    const { composeFiles = ['/home/user/Adverant-Nexus/docker/docker-compose.unified-nexus.yml'], skipHealthCheck = false } = options;
+    // Parse docker-compose files
+    const services = await parseMultipleComposeFiles(composeFiles);
+    // Filter out infrastructure services (databases, etc.)
+    const appServices = filterApplicationServices(services);
+    // Check health status if not skipped
+    if (!skipHealthCheck) {
+        await updateHealthStatus(appServices);
+    }
+    return appServices;
+}
+/**
+ * Refresh discovery cache
+ */
+export async function refreshDiscovery(options = {}) {
+    const { skipOpenAPI = false, skipMCP = false, skipPlugins = false, cacheTimeout = DEFAULT_CACHE_TTL } = options;
+    console.log('🔍 Discovering services...');
+    // Discover services from docker-compose
+    const services = await discoverServices(options);
+    console.log(`✅ Found ${services.size} services`);
+    // Discover commands from OpenAPI specs
+    const commands = new Map();
+    if (!skipOpenAPI) {
+        console.log('📚 Discovering OpenAPI endpoints...');
+        await discoverServiceCommands(services, commands);
+        const totalCommands = Array.from(commands.values()).reduce((sum, cmds) => sum + cmds.length, 0);
+        console.log(`✅ Found ${totalCommands} commands from ${commands.size} services`);
+    }
+    // Discover Nexus MCP commands
+    let nexusCommands = [];
+    if (!skipMCP) {
+        console.log('🧠 Discovering Nexus MCP tools...');
+        nexusCommands = await discoverMCPCommands({
+            mcpUrl: options.mcpUrl
+        });
+        console.log(`✅ Found ${nexusCommands.length} Nexus tools`);
+    }
+    // Discover plugins
+    let plugins = [];
+    if (!skipPlugins) {
+        console.log('🔌 Discovering plugins...');
+        plugins = await discoverPlugins({
+            pluginDir: options.pluginDir
+        });
+        console.log(`✅ Found ${plugins.length} plugins`);
+        // Add plugin commands to command map
+        const pluginCommands = getPluginCommands(plugins);
+        for (const [pluginName, cmds] of pluginCommands) {
+            commands.set(`plugin:${pluginName}`, cmds);
+        }
+    }
+    // Update cache
+    const result = {
+        services,
+        commands,
+        plugins,
+        nexusCommands,
+        timestamp: new Date()
+    };
+    discoveryCache = result;
+    cacheTimestamp = Date.now();
+    console.log('✨ Discovery complete!');
+    return result;
+}
+/**
+ * Get cached discovery result or refresh if expired
+ */
+export async function getDiscovery(options = {}) {
+    const { cacheTimeout = DEFAULT_CACHE_TTL } = options;
+    // Check if cache is valid
+    if (discoveryCache && (Date.now() - cacheTimestamp) < cacheTimeout) {
+        return discoveryCache;
+    }
+    // Refresh cache
+    return await refreshDiscovery(options);
+}
+/**
+ * Update health status for all services
+ */
+async function updateHealthStatus(services) {
+    const healthChecks = Array.from(services.values()).map(async (service) => {
+        const health = await getServiceHealth(service);
+        service.status = health.status;
+    });
+    await Promise.all(healthChecks);
+}
+/**
+ * Get service health status
+ */
+export async function getServiceHealth(service) {
+    const startTime = Date.now();
+    if (!service.apiUrl || !service.healthEndpoint) {
+        return {
+            healthy: false,
+            status: ServiceStatus.UNKNOWN,
+            lastCheck: new Date(),
+            message: 'No health endpoint configured'
+        };
+    }
+    try {
+        const url = `${service.apiUrl}${service.healthEndpoint}`;
+        const response = await axios.get(url, {
+            timeout: 5000,
+            validateStatus: (status) => status < 500
+        });
+        const latency = Date.now() - startTime;
+        if (response.status === 200) {
+            return {
+                healthy: true,
+                status: ServiceStatus.RUNNING,
+                latency,
+                lastCheck: new Date(),
+                details: response.data
+            };
+        }
+        else {
+            return {
+                healthy: false,
+                status: ServiceStatus.UNHEALTHY,
+                latency,
+                lastCheck: new Date(),
+                message: `HTTP ${response.status}`
+            };
+        }
+    }
+    catch (error) {
+        return {
+            healthy: false,
+            status: ServiceStatus.STOPPED,
+            lastCheck: new Date(),
+            message: error instanceof Error ? error.message : 'Unknown error'
+        };
+    }
+}
+/**
+ * Discover commands from service OpenAPI specs
+ */
+async function discoverServiceCommands(services, commandMap) {
+    for (const [name, service] of services) {
+        if (!service.openApiSpec || !service.apiUrl) {
+            continue;
+        }
+        try {
+            const specUrl = `${service.apiUrl}${service.openApiSpec}`;
+            const spec = await fetchOpenAPISpec(specUrl, { timeout: 5000 });
+            if (spec) {
+                const commands = await parseOpenAPIToCommands(spec, name);
+                if (commands.length > 0) {
+                    commandMap.set(name, commands);
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Warning: Could not fetch OpenAPI spec for ${name}:`, error);
+            // Continue with other services
+        }
+    }
+}
+/**
+ * Get service by name
+ */
+export async function getService(name, options = {}) {
+    const discovery = await getDiscovery(options);
+    return discovery.services.get(name) || null;
+}
+/**
+ * Get all commands for a service
+ */
+export async function getServiceCommands(serviceName, options = {}) {
+    const discovery = await getDiscovery(options);
+    return discovery.commands.get(serviceName) || [];
+}
+/**
+ * Get all Nexus commands
+ */
+export async function getNexusCommands(options = {}) {
+    const discovery = await getDiscovery(options);
+    return discovery.nexusCommands;
+}
+/**
+ * Get all plugins
+ */
+export async function getPlugins(options = {}) {
+    const discovery = await getDiscovery(options);
+    return discovery.plugins;
+}
+/**
+ * Search for commands across all services
+ */
+export async function searchCommands(query, options = {}) {
+    const discovery = await getDiscovery(options);
+    const results = [];
+    const lowerQuery = query.toLowerCase();
+    // Search service commands
+    for (const [serviceName, commands] of discovery.commands) {
+        for (const command of commands) {
+            if (command.name.toLowerCase().includes(lowerQuery) ||
+                command.description.toLowerCase().includes(lowerQuery)) {
+                results.push({ service: serviceName, command });
+            }
+        }
+    }
+    // Search Nexus commands
+    for (const command of discovery.nexusCommands) {
+        if (command.name.toLowerCase().includes(lowerQuery) ||
+            command.description.toLowerCase().includes(lowerQuery)) {
+            results.push({ service: 'nexus', command });
+        }
+    }
+    return results;
+}
+/**
+ * Get service statistics
+ */
+export async function getServiceStats(options = {}) {
+    const discovery = await getDiscovery(options);
+    const runningServices = Array.from(discovery.services.values()).filter(s => s.status === ServiceStatus.RUNNING).length;
+    const totalCommands = Array.from(discovery.commands.values()).reduce((sum, cmds) => sum + cmds.length, 0);
+    return {
+        totalServices: discovery.services.size,
+        runningServices,
+        totalCommands,
+        totalPlugins: discovery.plugins.length,
+        totalNexusTools: discovery.nexusCommands.length
+    };
+}
+/**
+ * Clear discovery cache
+ */
+export function clearCache() {
+    discoveryCache = null;
+    cacheTimestamp = 0;
+}
+/**
+ * Get cache status
+ */
+export function getCacheStatus() {
+    return {
+        cached: discoveryCache !== null,
+        age: discoveryCache ? Date.now() - cacheTimestamp : 0,
+        timestamp: discoveryCache?.timestamp || null
+    };
+}
+/**
+ * Validate service configuration
+ */
+export async function validateService(serviceName, options = {}) {
+    const errors = [];
+    const warnings = [];
+    const service = await getService(serviceName, options);
+    if (!service) {
+        errors.push(`Service '${serviceName}' not found`);
+        return { valid: false, errors, warnings };
+    }
+    // Check if service has API URL
+    if (!service.apiUrl) {
+        errors.push('Service has no API URL');
+    }
+    // Check if service is running
+    if (service.status !== ServiceStatus.RUNNING) {
+        warnings.push(`Service status is ${service.status}, not running`);
+    }
+    // Check if health endpoint is accessible
+    const health = await getServiceHealth(service);
+    if (!health.healthy) {
+        errors.push(`Health check failed: ${health.message}`);
+    }
+    // Check if OpenAPI spec is accessible
+    if (service.openApiSpec) {
+        try {
+            const spec = await fetchOpenAPISpec(`${service.apiUrl}${service.openApiSpec}`, {
+                timeout: 5000
+            });
+            if (!spec) {
+                warnings.push('OpenAPI spec endpoint exists but returned invalid data');
+            }
+        }
+        catch {
+            warnings.push('OpenAPI spec endpoint is not accessible');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Get service dependency graph
+ */
+export async function getServiceDependencies(options = {}) {
+    const discovery = await getDiscovery(options);
+    const deps = new Map();
+    for (const [name, service] of discovery.services) {
+        deps.set(name, service.dependencies);
+    }
+    return deps;
+}
+/**
+ * Check if all service dependencies are satisfied
+ */
+export async function checkDependencies(serviceName, options = {}) {
+    const discovery = await getDiscovery(options);
+    const service = discovery.services.get(serviceName);
+    if (!service) {
+        return {
+            satisfied: false,
+            missing: [],
+            available: []
+        };
+    }
+    const missing = [];
+    const available = [];
+    for (const dep of service.dependencies) {
+        const depService = discovery.services.get(dep);
+        if (!depService || depService.status !== ServiceStatus.RUNNING) {
+            missing.push(dep);
+        }
+        else {
+            available.push(dep);
+        }
+    }
+    return {
+        satisfied: missing.length === 0,
+        missing,
+        available
+    };
+}
+//# sourceMappingURL=service-discovery.js.map

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

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

package/dist/core/nexus-client.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Nexus API Client
+ *
+ * Client for interacting with Nexus API Gateway (port 9092)
+ * Handles health checks, operation queuing, and graceful degradation
+ */
+import { EventEmitter } from 'eventemitter3';
+export interface NexusClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    retries?: number;
+    headers?: Record<string, string>;
+    healthCheckInterval?: number;
+}
+export interface NexusHealth {
+    graphrag: {
+        healthy: boolean;
+        latency?: number;
+        collections?: string[];
+    };
+    mageagent: {
+        healthy: boolean;
+        latency?: number;
+        activeAgents?: number;
+    };
+    learningagent: {
+        healthy: boolean;
+        queuedLearning?: number;
+    };
+}
+export interface QueuedOperation {
+    id: string;
+    operation: string;
+    params: any;
+    timestamp: Date;
+    retries: number;
+}
+export declare class NexusClient extends EventEmitter {
+    private client;
+    private config;
+    private healthCheckTimer?;
+    private isHealthy;
+    private operationQueue;
+    private retryConfig;
+    constructor(config?: NexusClientConfig);
+    /**
+     * Setup axios interceptors for retry and error handling
+     */
+    private setupInterceptors;
+    /**
+     * Create a standardized transport error
+     */
+    private createTransportError;
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryable;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private calculateBackoff;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Start automatic health checks
+     */
+    startHealthChecks(): void;
+    /**
+     * Stop automatic health checks
+     */
+    stopHealthChecks(): void;
+    /**
+     * Check Nexus system health
+     */
+    checkHealth(detailed?: boolean): Promise<NexusHealth>;
+    /**
+     * Get current health status
+     */
+    getHealthStatus(): {
+        healthy: boolean;
+    };
+    /**
+     * Execute a Nexus API operation
+     */
+    execute<T = any>(endpoint: string, method?: 'get' | 'post' | 'put' | 'delete', data?: any, options?: {
+        params?: any;
+        queueOnFailure?: boolean;
+    }): Promise<T>;
+    /**
+     * Queue an operation for later execution
+     */
+    private queueOperation;
+    /**
+     * Process queued operations
+     */
+    private processQueue;
+    /**
+     * Get queue status
+     */
+    getQueueStatus(): {
+        count: number;
+        operations: QueuedOperation[];
+    };
+    /**
+     * Clear the operation queue
+     */
+    clearQueue(): void;
+    /**
+     * Close the client and cleanup
+     */
+    close(): void;
+}
+/**
+ * Create a default Nexus client instance
+ */
+export declare function createNexusClient(config?: NexusClientConfig): NexusClient;
+//# sourceMappingURL=nexus-client.d.ts.map

package/dist/core/nexus-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-client.d.ts","sourceRoot":"","sources":["../../src/core/nexus-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,WAAW,CAMjB;gBAEU,MAAM,GAAE,iBAAsB;IAuB1C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAgBzB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAQxB;;OAEG;IACG,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAiClE;;OAEG;IACH,eAAe,IAAI;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAIvC;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAiB,EAClD,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACnD,OAAO,CAAC,CAAC,CAAC;IAuCb;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;YACW,YAAY;IAuC1B;;OAEG;IACH,cAAc,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,EAAE,CAAA;KAAE;IAOlE;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAEzE"}