@adverant-nexus/cli 2.0.0

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

@@ -0,0 +1,439 @@
+/**
+ * MCP Discovery
+ *
+ * Discovers MCP tools from nexus-mcp-server and converts them to CLI commands
+ */
+import axios from 'axios';
+/**
+ * Discover all MCP tools from nexus-mcp-server
+ */
+export async function discoverMCPTools(options = {}) {
+    const { mcpUrl = 'http://localhost:9000', timeout = 5000, headers = {} } = options;
+    try {
+        // Try to fetch tools list from MCP server
+        // Note: MCP uses stdio protocol, so we need to call the API gateway instead
+        const gatewayUrl = mcpUrl.replace(':9000', ':9092'); // Use API Gateway
+        const response = await axios.get(`${gatewayUrl}/api/tools`, {
+            timeout,
+            headers: {
+                'Accept': 'application/json',
+                ...headers
+            }
+        });
+        if (response.status === 200 && Array.isArray(response.data)) {
+            return response.data;
+        }
+        // Fallback: return hardcoded list of known Nexus tools
+        return getKnownNexusTools();
+    }
+    catch (error) {
+        console.warn('Could not fetch MCP tools from server, using fallback list');
+        return getKnownNexusTools();
+    }
+}
+/**
+ * Convert MCP tool to CLI command
+ */
+export function mcpToolToCommand(tool) {
+    const params = extractMCPParameters(tool.inputSchema);
+    // Generate command name (nexus_ prefix → nexus namespace)
+    const commandName = tool.name
+        .replace(/^nexus_/, '')
+        .replace(/_/g, '-');
+    // Generate examples
+    const examples = generateMCPExamples(commandName, params);
+    return {
+        name: commandName,
+        namespace: 'nexus',
+        description: tool.description,
+        endpoint: `/api/tools/${tool.name}`,
+        method: 'POST',
+        params,
+        streaming: isStreamingTool(tool.name),
+        examples
+    };
+}
+/**
+ * Extract parameters from MCP input schema
+ */
+function extractMCPParameters(schema) {
+    const params = [];
+    const required = new Set(schema.required || []);
+    for (const [name, prop] of Object.entries(schema.properties)) {
+        params.push({
+            name,
+            type: mapMCPType(prop.type),
+            required: required.has(name),
+            description: prop.description || '',
+            default: prop.default,
+            enum: prop.enum,
+            format: inferFormat(name, prop)
+        });
+    }
+    return params;
+}
+/**
+ * Map MCP type to CLI parameter type
+ */
+function mapMCPType(type) {
+    const typeMap = {
+        'string': 'string',
+        'number': 'number',
+        'boolean': 'boolean',
+        'array': 'array',
+        'object': 'object'
+    };
+    return typeMap[type] || 'string';
+}
+/**
+ * Infer format from parameter name and properties
+ */
+function inferFormat(name, prop) {
+    // File parameters
+    if (name.includes('file') || name.includes('path')) {
+        return 'file';
+    }
+    // URL parameters
+    if (name.includes('url') || name.includes('endpoint')) {
+        return 'url';
+    }
+    // JSON parameters
+    if (prop.type === 'object' || prop.type === 'array') {
+        return 'json';
+    }
+    return undefined;
+}
+/**
+ * Check if tool supports streaming
+ */
+function isStreamingTool(name) {
+    const streamingTools = [
+        'nexus_orchestrate',
+        'nexus_validate_code',
+        'nexus_ingest_url',
+        'nexus_enhanced_retrieve',
+        'nexus_multi_agent_orchestrate'
+    ];
+    return streamingTools.includes(name);
+}
+/**
+ * Generate usage examples for MCP command
+ */
+function generateMCPExamples(commandName, params) {
+    const examples = [];
+    // Basic example
+    const requiredParams = params.filter(p => p.required);
+    if (requiredParams.length > 0) {
+        const paramStr = requiredParams
+            .map(p => {
+            if (p.type === 'boolean') {
+                return `--${p.name}`;
+            }
+            else if (p.format === 'file') {
+                return `--${p.name} /path/to/file`;
+            }
+            else if (p.enum && p.enum.length > 0) {
+                return `--${p.name} ${p.enum[0]}`;
+            }
+            else {
+                const exampleValue = getExampleValue(p.name, p.type);
+                return `--${p.name} "${exampleValue}"`;
+            }
+        })
+            .join(' ');
+        examples.push(`nexus nexus ${commandName} ${paramStr}`);
+    }
+    else {
+        examples.push(`nexus nexus ${commandName}`);
+    }
+    // Streaming example
+    if (isStreamingTool(`nexus_${commandName.replace(/-/g, '_')}`)) {
+        examples.push(`nexus nexus ${commandName} ${requiredParams.map(p => `--${p.name} <value>`).join(' ')} --stream`);
+    }
+    // JSON output example
+    examples.push(`nexus nexus ${commandName} --output-format json`);
+    return examples.slice(0, 3);
+}
+/**
+ * Get example value for parameter
+ */
+function getExampleValue(name, type) {
+    const examples = {
+        'query': 'search query',
+        'content': 'content text',
+        'title': 'document title',
+        'domain': 'code',
+        'type': 'function',
+        'task': 'analyze codebase',
+        'topic': 'typescript_patterns',
+        'code': 'function example() {}',
+        'language': 'typescript',
+        'file': '/path/to/file',
+        'url': 'https://example.com',
+        'limit': '10',
+        'maxAgents': '5',
+        'priority': '8'
+    };
+    if (examples[name]) {
+        return examples[name];
+    }
+    if (type === 'number') {
+        return '10';
+    }
+    if (type === 'boolean') {
+        return 'true';
+    }
+    return 'value';
+}
+/**
+ * Get hardcoded list of known Nexus tools (fallback)
+ */
+function getKnownNexusTools() {
+    return [
+        // Memory Operations
+        {
+            name: 'nexus_store_memory',
+            description: 'Store a memory with tags and metadata',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'Memory content' },
+                    tags: { type: 'array', description: 'Tags for categorization' },
+                    metadata: { type: 'object', description: 'Additional metadata' }
+                },
+                required: ['content']
+            }
+        },
+        {
+            name: 'nexus_recall_memory',
+            description: 'Search and recall memories',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search query' },
+                    limit: { type: 'number', description: 'Maximum results', default: 10 },
+                    score_threshold: { type: 'number', description: 'Minimum similarity score', default: 0.3 }
+                },
+                required: ['query']
+            }
+        },
+        {
+            name: 'nexus_store_document',
+            description: 'Store a document with embeddings',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'Document content' },
+                    title: { type: 'string', description: 'Document title' },
+                    metadata: { type: 'object', description: 'Document metadata' }
+                },
+                required: ['content', 'title']
+            }
+        },
+        {
+            name: 'nexus_retrieve',
+            description: 'Retrieve documents using advanced strategies',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search query' },
+                    strategy: {
+                        type: 'string',
+                        description: 'Retrieval strategy',
+                        enum: ['semantic_chunks', 'graph_traversal', 'hybrid', 'adaptive'],
+                        default: 'semantic_chunks'
+                    },
+                    limit: { type: 'number', description: 'Maximum results', default: 10 },
+                    rerank: { type: 'boolean', description: 'Use Cohere reranking', default: false }
+                },
+                required: ['query']
+            }
+        },
+        // Knowledge Graph
+        {
+            name: 'nexus_store_entity',
+            description: 'Store an entity in knowledge graph',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    domain: { type: 'string', description: 'Domain (code, medical, legal, etc.)' },
+                    entityType: { type: 'string', description: 'Entity type' },
+                    textContent: { type: 'string', description: 'Entity content' },
+                    tags: { type: 'array', description: 'Tags' },
+                    metadata: { type: 'object', description: 'Metadata' }
+                },
+                required: ['domain', 'entityType', 'textContent']
+            }
+        },
+        {
+            name: 'nexus_query_entities',
+            description: 'Query entities in knowledge graph',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    domain: { type: 'string', description: 'Domain filter' },
+                    entityType: { type: 'string', description: 'Entity type filter' },
+                    searchText: { type: 'string', description: 'Search text' },
+                    limit: { type: 'number', description: 'Maximum results', default: 20 }
+                },
+                required: []
+            }
+        },
+        // Code Analysis
+        {
+            name: 'nexus_validate_code',
+            description: 'Multi-model code validation with consensus (3 models)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string', description: 'Code to validate' },
+                    language: { type: 'string', description: 'Programming language' },
+                    context: { type: 'string', description: 'Additional context' },
+                    riskLevel: {
+                        type: 'string',
+                        description: 'Risk level',
+                        enum: ['low', 'medium', 'high', 'critical'],
+                        default: 'medium'
+                    }
+                },
+                required: ['code', 'language']
+            }
+        },
+        {
+            name: 'nexus_analyze_code',
+            description: 'Fast single-model code analysis',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string', description: 'Code to analyze' },
+                    language: { type: 'string', description: 'Programming language' },
+                    depth: {
+                        type: 'string',
+                        description: 'Analysis depth',
+                        enum: ['quick', 'standard', 'deep'],
+                        default: 'standard'
+                    },
+                    focusAreas: { type: 'array', description: 'Focus areas (security, performance, etc.)' }
+                },
+                required: ['code', 'language']
+            }
+        },
+        // Multi-Agent
+        {
+            name: 'nexus_orchestrate',
+            description: 'Spawn multiple AI agents for complex tasks',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    task: { type: 'string', description: 'Task description' },
+                    maxAgents: { type: 'number', description: 'Maximum agents', default: 5 },
+                    timeout: { type: 'number', description: 'Timeout in ms', default: 60000 },
+                    context: { type: 'object', description: 'Additional context' }
+                },
+                required: ['task']
+            }
+        },
+        // Learning System
+        {
+            name: 'nexus_trigger_learning',
+            description: 'Trigger progressive learning on topic',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    topic: { type: 'string', description: 'Topic to learn' },
+                    priority: { type: 'number', description: 'Priority (1-10)', default: 5 },
+                    trigger: {
+                        type: 'string',
+                        description: 'Trigger reason',
+                        enum: ['user_request', 'code_execution_failure', 'knowledge_gap_detected'],
+                        default: 'user_request'
+                    },
+                    context: { type: 'object', description: 'Additional context' }
+                },
+                required: ['topic']
+            }
+        },
+        {
+            name: 'nexus_recall_knowledge',
+            description: 'Retrieve learned knowledge',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    topic: { type: 'string', description: 'Topic to recall' },
+                    layer: {
+                        type: 'string',
+                        description: 'Knowledge layer',
+                        enum: ['OVERVIEW', 'PROCEDURES', 'TECHNIQUES', 'EXPERT', 'all'],
+                        default: 'all'
+                    },
+                    max_results: { type: 'number', description: 'Maximum results', default: 10 }
+                },
+                required: ['topic']
+            }
+        },
+        // Episodes
+        {
+            name: 'nexus_store_episode',
+            description: 'Store session event/observation',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'Episode content' },
+                    type: {
+                        type: 'string',
+                        description: 'Episode type',
+                        enum: ['user_query', 'system_response', 'event', 'observation', 'insight'],
+                        default: 'observation'
+                    },
+                    metadata: { type: 'object', description: 'Episode metadata' }
+                },
+                required: ['content']
+            }
+        },
+        {
+            name: 'nexus_recall_episodes',
+            description: 'Recall past session events',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search query' },
+                    limit: { type: 'number', description: 'Maximum results', default: 10 },
+                    include_decay: { type: 'boolean', description: 'Apply temporal decay', default: true },
+                    type_filter: { type: 'array', description: 'Filter by episode types' }
+                },
+                required: ['query']
+            }
+        },
+        // Health & Status
+        {
+            name: 'nexus_health',
+            description: 'Check Nexus system health',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    detailed: { type: 'boolean', description: 'Include detailed metrics', default: false }
+                },
+                required: []
+            }
+        },
+        {
+            name: 'nexus_ingestion_status',
+            description: 'Check ingestion job status',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    job_id: { type: 'string', description: 'Ingestion job ID' }
+                },
+                required: ['job_id']
+            }
+        }
+    ];
+}
+/**
+ * Convert all MCP tools to commands
+ */
+export async function discoverMCPCommands(options = {}) {
+    const tools = await discoverMCPTools(options);
+    return tools.map(tool => mcpToolToCommand(tool));
+}
+//# sourceMappingURL=mcp-discovery.js.map

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

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

package/dist/core/discovery/openapi-parser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * OpenAPI Parser
+ *
+ * Fetches and parses OpenAPI 3.x schemas from service endpoints
+ * Generates command definitions from API operations
+ */
+import type { ServiceCommand } from '../../types/service.js';
+export interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, OpenAPIPath>;
+    components?: {
+        schemas?: Record<string, any>;
+        parameters?: Record<string, any>;
+        responses?: Record<string, any>;
+        securitySchemes?: Record<string, any>;
+    };
+}
+export interface OpenAPIPath {
+    get?: OpenAPIOperation;
+    post?: OpenAPIOperation;
+    put?: OpenAPIOperation;
+    delete?: OpenAPIOperation;
+    patch?: OpenAPIOperation;
+}
+export interface OpenAPIOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: OpenAPIParameter[];
+    requestBody?: {
+        description?: string;
+        required?: boolean;
+        content: Record<string, {
+            schema: any;
+        }>;
+    };
+    responses: Record<string, any>;
+    'x-streaming'?: boolean;
+}
+export interface OpenAPIParameter {
+    name: string;
+    in: 'query' | 'path' | 'header' | 'cookie';
+    description?: string;
+    required?: boolean;
+    schema: {
+        type: string;
+        format?: string;
+        enum?: any[];
+        default?: any;
+    };
+}
+export interface OpenAPIParserOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    resolveRefs?: boolean;
+}
+/**
+ * Fetch OpenAPI spec from service endpoint
+ */
+export declare function fetchOpenAPISpec(url: string, options?: OpenAPIParserOptions): Promise<OpenAPISpec | null>;
+/**
+ * Parse OpenAPI spec and generate command definitions
+ */
+export declare function parseOpenAPIToCommands(spec: OpenAPISpec, namespace: string): Promise<ServiceCommand[]>;
+/**
+ * Resolve $ref references in OpenAPI spec
+ */
+export declare function resolveRefs(spec: OpenAPISpec, ref: string): any;
+/**
+ * Get all operations from OpenAPI spec
+ */
+export declare function getAllOperations(spec: OpenAPISpec): Array<{
+    path: string;
+    method: string;
+    operation: OpenAPIOperation;
+}>;
+/**
+ * Get authentication requirements from OpenAPI spec
+ */
+export declare function getAuthRequirements(spec: OpenAPISpec): {
+    type: 'apiKey' | 'bearer' | 'oauth2' | 'none';
+    location?: string;
+    name?: string;
+};
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/core/discovery/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/openapi-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YACtB,MAAM,EAAE,GAAG,CAAC;SACb,CAAC,CAAC;KACJ,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAkD7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAqB3B;AAuQD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAW/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC,CAoBD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG;IACtD,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CA+BA"}