@adverant-nexus/cli 2.0.0

package/dist/core/nexus-tool-executor.js

@@ -0,0 +1,386 @@
+/**
+ * Nexus Tool Executor
+ *
+ * Executes Nexus MCP tools with streaming support
+ * Handles parameter validation, progress tracking, and error handling
+ */
+import { EventEmitter } from 'eventemitter3';
+export class NexusToolExecutor extends EventEmitter {
+    nexusClient;
+    constructor(nexusClient) {
+        super();
+        this.nexusClient = nexusClient;
+    }
+    /**
+     * Execute a Nexus MCP tool
+     */
+    async execute(tool, params, options = {}) {
+        const startTime = Date.now();
+        try {
+            // Validate parameters
+            const validation = this.validateParameters(tool, params);
+            if (!validation.valid) {
+                throw new Error(`Invalid parameters: ${validation.errors.map((e) => e.message).join(', ')}`);
+            }
+            // Transform parameters to match tool schema
+            const transformedParams = this.transformParameters(tool, params);
+            // Check if tool supports streaming
+            const isStreaming = Boolean(options.streaming && this.isStreamingTool(tool.name));
+            let result;
+            if (isStreaming) {
+                result = await this.executeStreaming(tool, transformedParams, options);
+            }
+            else {
+                result = await this.executeStandard(tool, transformedParams, options);
+            }
+            const duration = Date.now() - startTime;
+            return {
+                success: true,
+                data: result,
+                duration,
+                streaming: isStreaming,
+                metadata: {
+                    toolName: tool.name,
+                    streamed: isStreaming,
+                },
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            return {
+                success: false,
+                error: error,
+                duration,
+                streaming: false,
+                metadata: {
+                    toolName: tool.name,
+                },
+            };
+        }
+    }
+    /**
+     * Execute tool with standard HTTP request
+     */
+    async executeStandard(tool, params, options) {
+        this.emit('execution:start', { tool: tool.name, params });
+        try {
+            // Determine endpoint based on tool name
+            const endpoint = this.getToolEndpoint(tool.name);
+            // Execute via Nexus Client
+            const result = await this.nexusClient.execute(endpoint, 'post', params, {
+                queueOnFailure: true,
+            });
+            this.emit('execution:complete', { tool: tool.name, result });
+            if (options.onComplete) {
+                options.onComplete(result);
+            }
+            return result;
+        }
+        catch (error) {
+            this.emit('execution:error', { tool: tool.name, error });
+            if (options.onError) {
+                options.onError(error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Execute tool with streaming support
+     */
+    async executeStreaming(tool, params, options) {
+        this.emit('execution:start', { tool: tool.name, params, streaming: true });
+        try {
+            const endpoint = this.getToolEndpoint(tool.name);
+            // For streaming, we need to handle WebSocket or SSE
+            // This is a simplified implementation - in production, you'd use WebSocket
+            const result = await this.nexusClient.execute(endpoint, 'post', params, {
+                queueOnFailure: true,
+            });
+            // Simulate streaming progress if the tool returns a job ID
+            if (result.jobId || result.validationId || result.taskId) {
+                await this.pollForProgress(result, options);
+            }
+            this.emit('execution:complete', { tool: tool.name, result });
+            if (options.onComplete) {
+                options.onComplete(result);
+            }
+            return result;
+        }
+        catch (error) {
+            this.emit('execution:error', { tool: tool.name, error });
+            if (options.onError) {
+                options.onError(error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Poll for operation progress (for long-running operations)
+     */
+    async pollForProgress(initialResult, options) {
+        const jobId = initialResult.jobId || initialResult.validationId || initialResult.taskId;
+        if (!jobId)
+            return;
+        const maxAttempts = 60; // 5 minutes with 5s intervals
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            try {
+                const statusEndpoint = this.getStatusEndpoint(initialResult);
+                const status = await this.nexusClient.execute(statusEndpoint, 'get', undefined, {
+                    params: { id: jobId },
+                });
+                // Emit progress
+                if (options.onProgress && status.progress !== undefined) {
+                    const progress = {
+                        type: 'progress',
+                        message: status.message || `Processing... ${status.progress}%`,
+                        progress: status.progress,
+                        timestamp: new Date(),
+                        metadata: status,
+                    };
+                    options.onProgress(progress);
+                    this.emit('execution:progress', progress);
+                }
+                // Check if complete
+                if (status.status === 'completed' || status.status === 'complete') {
+                    break;
+                }
+                // Check if failed
+                if (status.status === 'failed' || status.status === 'error') {
+                    throw new Error(status.error || 'Operation failed');
+                }
+                // Wait before next poll
+                await this.sleep(5000);
+                attempts += 1;
+            }
+            catch (error) {
+                if (attempts >= maxAttempts - 1) {
+                    throw error;
+                }
+                await this.sleep(5000);
+                attempts += 1;
+            }
+        }
+    }
+    /**
+     * Get API endpoint for a tool
+     */
+    getToolEndpoint(toolName) {
+        // Map tool names to API endpoints
+        const toolToEndpoint = {
+            // Memory operations
+            nexus_store_memory: '/nexus/memory/store',
+            nexus_recall_memory: '/nexus/memory/recall',
+            nexus_store_document: '/nexus/documents/store',
+            nexus_retrieve: '/nexus/documents/retrieve',
+            // Knowledge graph
+            nexus_store_entity: '/nexus/entities/store',
+            nexus_query_entities: '/nexus/entities/query',
+            nexus_create_entity_relationship: '/nexus/entities/relationships',
+            // Code analysis
+            nexus_validate_code: '/nexus/code/validate',
+            nexus_analyze_code: '/nexus/code/analyze',
+            nexus_validate_command: '/nexus/command/validate',
+            // Multi-agent
+            nexus_orchestrate: '/nexus/agents/orchestrate',
+            nexus_get_suggestions: '/nexus/agents/suggestions',
+            // Learning
+            nexus_trigger_learning: '/nexus/learning/trigger',
+            nexus_recall_knowledge: '/nexus/learning/recall',
+            // Episodes
+            nexus_store_episode: '/nexus/episodes/store',
+            nexus_recall_episodes: '/nexus/episodes/recall',
+            // Health
+            nexus_health: '/nexus/health',
+            nexus_ingestion_status: '/nexus/ingestion/status',
+        };
+        // Check for exact match
+        if (toolToEndpoint[toolName]) {
+            return toolToEndpoint[toolName];
+        }
+        // Try without prefix
+        const withoutPrefix = toolName.replace(/^(mcp__MCP_DOCKER__|nexus_)/, '');
+        if (toolToEndpoint[`nexus_${withoutPrefix}`]) {
+            return toolToEndpoint[`nexus_${withoutPrefix}`];
+        }
+        // Default fallback
+        return `/nexus/${withoutPrefix.replace(/_/g, '/')}`;
+    }
+    /**
+     * Get status endpoint for polling
+     */
+    getStatusEndpoint(initialResult) {
+        if (initialResult.jobId) {
+            return '/nexus/ingestion/status';
+        }
+        if (initialResult.validationId) {
+            return '/nexus/code/validation-status';
+        }
+        if (initialResult.taskId) {
+            return '/nexus/agents/status';
+        }
+        return '/nexus/status';
+    }
+    /**
+     * Check if tool supports streaming
+     */
+    isStreamingTool(toolName) {
+        const streamingTools = [
+            'orchestrate',
+            'ingest',
+            'validate_code',
+            'analyze_code',
+            'process',
+            'batch',
+        ];
+        return streamingTools.some((keyword) => toolName.toLowerCase().includes(keyword));
+    }
+    /**
+     * Validate parameters against tool schema
+     */
+    validateParameters(tool, params) {
+        const errors = [];
+        if (!tool.inputSchema || !tool.inputSchema.properties) {
+            return { valid: true, errors: [] };
+        }
+        const schema = tool.inputSchema;
+        const required = schema.required || [];
+        // Check required parameters
+        for (const field of required) {
+            if (params[field] === undefined || params[field] === null) {
+                errors.push({
+                    field,
+                    message: `Required parameter '${field}' is missing`,
+                    expected: 'non-null value',
+                    received: params[field],
+                });
+            }
+        }
+        // Validate parameter types
+        for (const [field, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            const fieldSchema = schema.properties[field];
+            if (!fieldSchema)
+                continue;
+            const typeError = this.validateType(field, value, fieldSchema);
+            if (typeError) {
+                errors.push(typeError);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Validate a single parameter type
+     */
+    validateType(field, value, schema) {
+        const expectedType = schema.type;
+        const actualType = Array.isArray(value) ? 'array' : typeof value;
+        switch (expectedType) {
+            case 'string':
+                if (typeof value !== 'string') {
+                    return {
+                        field,
+                        message: `Parameter '${field}' must be a string`,
+                        expected: 'string',
+                        received: actualType,
+                    };
+                }
+                break;
+            case 'number':
+            case 'integer':
+                if (typeof value !== 'number') {
+                    return {
+                        field,
+                        message: `Parameter '${field}' must be a number`,
+                        expected: 'number',
+                        received: actualType,
+                    };
+                }
+                break;
+            case 'boolean':
+                if (typeof value !== 'boolean') {
+                    return {
+                        field,
+                        message: `Parameter '${field}' must be a boolean`,
+                        expected: 'boolean',
+                        received: actualType,
+                    };
+                }
+                break;
+            case 'array':
+                if (!Array.isArray(value)) {
+                    return {
+                        field,
+                        message: `Parameter '${field}' must be an array`,
+                        expected: 'array',
+                        received: actualType,
+                    };
+                }
+                break;
+            case 'object':
+                if (typeof value !== 'object' || Array.isArray(value)) {
+                    return {
+                        field,
+                        message: `Parameter '${field}' must be an object`,
+                        expected: 'object',
+                        received: actualType,
+                    };
+                }
+                break;
+        }
+        // Check enum constraints
+        if (schema.enum && !schema.enum.includes(value)) {
+            return {
+                field,
+                message: `Parameter '${field}' must be one of: ${schema.enum.join(', ')}`,
+                expected: schema.enum.join(', '),
+                received: value,
+            };
+        }
+        return null;
+    }
+    /**
+     * Transform CLI parameters to match tool schema
+     */
+    transformParameters(tool, params) {
+        const transformed = {};
+        for (const [key, value] of Object.entries(params)) {
+            // Skip undefined values
+            if (value === undefined)
+                continue;
+            // Convert kebab-case to snake_case
+            const toolKey = key.replace(/-/g, '_');
+            // Parse arrays from comma-separated strings
+            if (typeof value === 'string' && value.includes(',')) {
+                transformed[toolKey] = value.split(',').map((v) => v.trim());
+            }
+            else {
+                transformed[toolKey] = value;
+            }
+        }
+        return transformed;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Close and cleanup
+     */
+    close() {
+        this.removeAllListeners();
+    }
+}
+/**
+ * Create a Nexus tool executor instance
+ */
+export function createNexusToolExecutor(nexusClient) {
+    return new NexusToolExecutor(nexusClient);
+}
+//# sourceMappingURL=nexus-tool-executor.js.map

package/dist/core/nexus-tool-executor.js.map

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

package/dist/core/react-handler.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ReAct Event Handler
+ *
+ * Processes and displays ReAct loop events (thought-action-observation cycles)
+ * Handles user approval prompts and progress tracking
+ */
+import type { ReActEvent, ReActOptions, AgentResult } from '../types/agent.js';
+/**
+ * Handle a stream of ReAct events
+ * Returns the final agent result
+ */
+export declare function handleReActStream(stream: AsyncIterable<ReActEvent>, options?: ReActOptions): Promise<AgentResult>;
+/**
+ * Display progress bar for iterations
+ */
+export declare function displayProgress(current: number, total: number): void;
+//# sourceMappingURL=react-handler.d.ts.map

package/dist/core/react-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-handler.d.ts","sourceRoot":"","sources":["../../src/core/react-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqFtB;AA0OD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQpE"}