@adverant-nexus/cli 2.0.0

package/dist/core/nexus-client.js

@@ -0,0 +1,292 @@
+/**
+ * Nexus API Client
+ *
+ * Client for interacting with Nexus API Gateway (port 9092)
+ * Handles health checks, operation queuing, and graceful degradation
+ */
+import axios from 'axios';
+import { EventEmitter } from 'eventemitter3';
+export class NexusClient extends EventEmitter {
+    client;
+    config;
+    healthCheckTimer;
+    isHealthy = false;
+    operationQueue = [];
+    retryConfig = {
+        maxAttempts: 3,
+        initialDelay: 1000,
+        maxDelay: 10000,
+        factor: 2,
+        retryableErrors: ['ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND'],
+    };
+    constructor(config = {}) {
+        super();
+        this.config = {
+            baseUrl: config.baseUrl || 'http://localhost:9092',
+            timeout: config.timeout || 30000,
+            retries: config.retries || 3,
+            headers: config.headers || {},
+            healthCheckInterval: config.healthCheckInterval || 30000,
+        };
+        this.client = axios.create({
+            baseURL: this.config.baseUrl,
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.config.headers,
+            },
+        });
+        this.setupInterceptors();
+    }
+    /**
+     * Setup axios interceptors for retry and error handling
+     */
+    setupInterceptors() {
+        // Request interceptor
+        this.client.interceptors.request.use((config) => {
+            this.emit('request', { url: config.url, method: config.method });
+            return config;
+        }, (error) => Promise.reject(this.createTransportError(error)));
+        // Response interceptor
+        this.client.interceptors.response.use((response) => {
+            this.emit('response', { url: response.config.url, status: response.status });
+            return response;
+        }, async (error) => {
+            const transportError = this.createTransportError(error);
+            // Retry logic for retryable errors
+            if (this.isRetryable(transportError)) {
+                const config = error.config;
+                if (config && !config.__retryCount) {
+                    config.__retryCount = 0;
+                }
+                if (config && config.__retryCount < this.config.retries) {
+                    config.__retryCount += 1;
+                    const delay = this.calculateBackoff(config.__retryCount);
+                    this.emit('retry', {
+                        attempt: config.__retryCount,
+                        delay,
+                        error: transportError,
+                    });
+                    await this.sleep(delay);
+                    return this.client.request(config);
+                }
+            }
+            return Promise.reject(transportError);
+        });
+    }
+    /**
+     * Create a standardized transport error
+     */
+    createTransportError(error) {
+        const transportError = new Error(error.message);
+        transportError.code = error.code || 'UNKNOWN_ERROR';
+        transportError.statusCode = error.response?.status;
+        transportError.details = error.response?.data;
+        transportError.retryable = this.isRetryable(error);
+        return transportError;
+    }
+    /**
+     * Check if an error is retryable
+     */
+    isRetryable(error) {
+        if (error.code && this.retryConfig.retryableErrors?.includes(error.code)) {
+            return true;
+        }
+        if (error.statusCode && [408, 429, 500, 502, 503, 504].includes(error.statusCode)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Calculate exponential backoff delay
+     */
+    calculateBackoff(attempt) {
+        const delay = Math.min(this.retryConfig.initialDelay * Math.pow(this.retryConfig.factor, attempt - 1), this.retryConfig.maxDelay);
+        return delay;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Start automatic health checks
+     */
+    startHealthChecks() {
+        if (this.healthCheckTimer) {
+            return;
+        }
+        // Initial health check
+        this.checkHealth().catch(() => { });
+        // Periodic health checks
+        this.healthCheckTimer = setInterval(() => {
+            this.checkHealth().catch(() => { });
+        }, this.config.healthCheckInterval);
+        this.emit('health-check:started');
+    }
+    /**
+     * Stop automatic health checks
+     */
+    stopHealthChecks() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+            this.emit('health-check:stopped');
+        }
+    }
+    /**
+     * Check Nexus system health
+     */
+    async checkHealth(detailed = false) {
+        try {
+            const response = await this.client.get('/health', {
+                params: { detailed },
+            });
+            const health = response.data;
+            const wasHealthy = this.isHealthy;
+            this.isHealthy = health.graphrag.healthy;
+            // Emit health change events
+            if (wasHealthy !== this.isHealthy) {
+                if (this.isHealthy) {
+                    this.emit('health:recovered');
+                    await this.processQueue();
+                }
+                else {
+                    this.emit('health:degraded');
+                }
+            }
+            return health;
+        }
+        catch (error) {
+            const wasHealthy = this.isHealthy;
+            this.isHealthy = false;
+            if (wasHealthy) {
+                this.emit('health:degraded');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get current health status
+     */
+    getHealthStatus() {
+        return { healthy: this.isHealthy };
+    }
+    /**
+     * Execute a Nexus API operation
+     */
+    async execute(endpoint, method = 'post', data, options) {
+        try {
+            let response;
+            switch (method) {
+                case 'get':
+                    response = await this.client.get(endpoint, {
+                        params: options?.params,
+                    });
+                    break;
+                case 'post':
+                    response = await this.client.post(endpoint, data, {
+                        params: options?.params,
+                    });
+                    break;
+                case 'put':
+                    response = await this.client.put(endpoint, data, {
+                        params: options?.params,
+                    });
+                    break;
+                case 'delete':
+                    response = await this.client.delete(endpoint, {
+                        params: options?.params,
+                    });
+                    break;
+            }
+            return response.data;
+        }
+        catch (error) {
+            // Queue operation if requested and health check fails
+            if (options?.queueOnFailure && !this.isHealthy) {
+                this.queueOperation(endpoint, method, data, options?.params);
+                throw new Error('Nexus unavailable - operation queued for retry');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Queue an operation for later execution
+     */
+    queueOperation(endpoint, method, data, params) {
+        const operation = {
+            id: `op_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            operation: `${method.toUpperCase()} ${endpoint}`,
+            params: { endpoint, method, data, params },
+            timestamp: new Date(),
+            retries: 0,
+        };
+        this.operationQueue.push(operation);
+        this.emit('operation:queued', operation);
+    }
+    /**
+     * Process queued operations
+     */
+    async processQueue() {
+        if (this.operationQueue.length === 0) {
+            return;
+        }
+        this.emit('queue:processing', { count: this.operationQueue.length });
+        const operations = [...this.operationQueue];
+        this.operationQueue = [];
+        for (const op of operations) {
+            try {
+                await this.execute(op.params.endpoint, op.params.method, op.params.data, { params: op.params.params, queueOnFailure: false });
+                this.emit('operation:completed', op);
+            }
+            catch (error) {
+                op.retries += 1;
+                // Re-queue if under max retries
+                if (op.retries < this.retryConfig.maxAttempts) {
+                    this.operationQueue.push(op);
+                    this.emit('operation:requeued', op);
+                }
+                else {
+                    this.emit('operation:failed', { operation: op, error });
+                }
+            }
+        }
+        this.emit('queue:processed', {
+            completed: operations.length - this.operationQueue.length,
+            remaining: this.operationQueue.length,
+        });
+    }
+    /**
+     * Get queue status
+     */
+    getQueueStatus() {
+        return {
+            count: this.operationQueue.length,
+            operations: [...this.operationQueue],
+        };
+    }
+    /**
+     * Clear the operation queue
+     */
+    clearQueue() {
+        const count = this.operationQueue.length;
+        this.operationQueue = [];
+        this.emit('queue:cleared', { count });
+    }
+    /**
+     * Close the client and cleanup
+     */
+    close() {
+        this.stopHealthChecks();
+        this.removeAllListeners();
+    }
+}
+/**
+ * Create a default Nexus client instance
+ */
+export function createNexusClient(config) {
+    return new NexusClient(config);
+}
+//# sourceMappingURL=nexus-client.js.map

package/dist/core/nexus-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-client.js","sourceRoot":"","sources":["../../src/core/nexus-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAoC7C,MAAM,OAAO,WAAY,SAAQ,YAAY;IACnC,MAAM,CAAgB;IACtB,MAAM,CAA8B;IACpC,gBAAgB,CAAkB;IAClC,SAAS,GAAY,KAAK,CAAC;IAC3B,cAAc,GAAsB,EAAE,CAAC;IACvC,WAAW,GAAgB;QACjC,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,CAAC;QACT,eAAe,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,WAAW,CAAC;KAC5D,CAAC;IAEF,YAAY,SAA4B,EAAE;QACxC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,uBAAuB;YAClD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK;SACzD,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;aACvB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,sBAAsB;QACtB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAClC,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAC5D,CAAC;QAEF,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,CAAC,QAAQ,EAAE,EAAE;YACX,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7E,OAAO,QAAQ,CAAC;QAClB,CAAC,EACD,KAAK,EAAE,KAAiB,EAAE,EAAE;YAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAExD,mCAAmC;YACnC,IAAI,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,IAAI,MAAM,IAAI,CAAE,MAAc,CAAC,YAAY,EAAE,CAAC;oBAC3C,MAAc,CAAC,YAAY,GAAG,CAAC,CAAC;gBACnC,CAAC;gBAED,IAAI,MAAM,IAAK,MAAc,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAChE,MAAc,CAAC,YAAY,IAAI,CAAC,CAAC;oBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAE,MAAc,CAAC,YAAY,CAAC,CAAC;oBAElE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;wBACjB,OAAO,EAAG,MAAc,CAAC,YAAY;wBACrC,KAAK;wBACL,KAAK,EAAE,cAAc;qBACtB,CAAC,CAAC;oBAEH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,KAAU;QACrC,MAAM,cAAc,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;QAClE,cAAc,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC;QACpD,cAAc,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACnD,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC9C,cAAc,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEnD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAU;QAC5B,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAClF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAe;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,EAC9E,IAAI,CAAC,WAAW,CAAC,QAAQ,CAC1B,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnC,yBAAyB;QACzB,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAEpC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACrC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,WAAoB,KAAK;QACzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;gBAChD,MAAM,EAAE,EAAE,QAAQ,EAAE;aACrB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAgB,QAAQ,CAAC,IAAI,CAAC;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;YAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAEzC,4BAA4B;YAC5B,IAAI,UAAU,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;oBAC9B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;YAClC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YAEvB,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC/B,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,SAA4C,MAAM,EAClD,IAAU,EACV,OAAoD;QAEpD,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC;YAEb,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,KAAK;oBACR,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE;wBACzC,MAAM,EAAE,OAAO,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,MAAM;gBACR,KAAK,MAAM;oBACT,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE;wBAChD,MAAM,EAAE,OAAO,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,MAAM;gBACR,KAAK,KAAK;oBACR,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE;wBAC/C,MAAM,EAAE,OAAO,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,MAAM;gBACR,KAAK,QAAQ;oBACX,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;wBAC5C,MAAM,EAAE,OAAO,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,MAAM;YACV,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sDAAsD;YACtD,IAAI,OAAO,EAAE,cAAc,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,QAAgB,EAChB,MAAc,EACd,IAAU,EACV,MAAY;QAEZ,MAAM,SAAS,GAAoB;YACjC,EAAE,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACjE,SAAS,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,QAAQ,EAAE;YAChD,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;YAC1C,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,CAAC;SACX,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAEzB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAChB,EAAE,CAAC,MAAM,CAAC,QAAQ,EAClB,EAAE,CAAC,MAAM,CAAC,MAAM,EAChB,EAAE,CAAC,MAAM,CAAC,IAAI,EACd,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CACpD,CAAC;gBAEF,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;gBAEhB,gCAAgC;gBAChC,IAAI,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;oBAC9C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC7B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;gBACtC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC3B,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM;YACzD,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM;SACtC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM;YACjC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC;SACrC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/nexus-tool-executor.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Nexus Tool Executor
+ *
+ * Executes Nexus MCP tools with streaming support
+ * Handles parameter validation, progress tracking, and error handling
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { MCPTool } from '../types/transport.js';
+import type { NexusClient } from './nexus-client.js';
+export interface ToolExecutionOptions {
+    streaming?: boolean;
+    timeout?: number;
+    onProgress?: (progress: ToolProgress) => void;
+    onError?: (error: Error) => void;
+    onComplete?: (result: any) => void;
+}
+export interface ToolProgress {
+    type: 'progress' | 'status' | 'agent' | 'file' | 'complete';
+    message: string;
+    progress?: number;
+    metadata?: any;
+    timestamp: Date;
+}
+export interface ToolExecutionResult {
+    success: boolean;
+    data?: any;
+    error?: Error;
+    duration: number;
+    streaming: boolean;
+    metadata?: {
+        toolName: string;
+        streamed?: boolean;
+        chunks?: number;
+    };
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    expected?: string;
+    received?: any;
+}
+export declare class NexusToolExecutor extends EventEmitter {
+    private nexusClient;
+    constructor(nexusClient: NexusClient);
+    /**
+     * Execute a Nexus MCP tool
+     */
+    execute(tool: MCPTool, params: any, options?: ToolExecutionOptions): Promise<ToolExecutionResult>;
+    /**
+     * Execute tool with standard HTTP request
+     */
+    private executeStandard;
+    /**
+     * Execute tool with streaming support
+     */
+    private executeStreaming;
+    /**
+     * Poll for operation progress (for long-running operations)
+     */
+    private pollForProgress;
+    /**
+     * Get API endpoint for a tool
+     */
+    private getToolEndpoint;
+    /**
+     * Get status endpoint for polling
+     */
+    private getStatusEndpoint;
+    /**
+     * Check if tool supports streaming
+     */
+    private isStreamingTool;
+    /**
+     * Validate parameters against tool schema
+     */
+    private validateParameters;
+    /**
+     * Validate a single parameter type
+     */
+    private validateType;
+    /**
+     * Transform CLI parameters to match tool schema
+     */
+    private transformParameters;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Close and cleanup
+     */
+    close(): void;
+}
+/**
+ * Create a Nexus tool executor instance
+ */
+export declare function createNexusToolExecutor(nexusClient: NexusClient): NexusToolExecutor;
+//# sourceMappingURL=nexus-tool-executor.d.ts.map

package/dist/core/nexus-tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-tool-executor.d.ts","sourceRoot":"","sources":["../../src/core/nexus-tool-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACrC,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAI5C;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,GAAG,EACX,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC;IAqD/B;;OAEG;YACW,eAAe;IAuC7B;;OAEG;YACW,gBAAgB;IA4C9B;;OAEG;YACW,eAAe;IAsD7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmDvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2EpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,iBAAiB,CAEnF"}