agentic-qe 2.1.1 → 2.2.0

package/dist/providers/RuvllmProvider.js

@@ -0,0 +1,417 @@
+"use strict";
+/**
+ * RuvllmProvider - Local LLM Inference via ruvllm
+ *
+ * Provides local LLM inference for cost-effective operations on capable hardware.
+ * Uses ruvllm for fast local inference with support for various open models.
+ *
+ * Features:
+ * - Zero cloud costs for local inference
+ * - Low latency for local operations
+ * - Privacy-preserving (no data leaves the machine)
+ * - Streaming support
+ * - Model hot-swapping
+ *
+ * @module providers/RuvllmProvider
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuvllmProvider = void 0;
+const child_process_1 = require("child_process");
+const ILLMProvider_1 = require("./ILLMProvider");
+const Logger_1 = require("../utils/Logger");
+/**
+ * RuvllmProvider - Local LLM inference implementation of ILLMProvider
+ *
+ * This provider enables local LLM inference using ruvllm, providing
+ * cost-free, low-latency inference for development and privacy-sensitive tasks.
+ */
+class RuvllmProvider {
+    constructor(config = {}) {
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = {
+            name: config.name || 'ruvllm',
+            debug: config.debug ?? false,
+            timeout: config.timeout ?? 120000, // Longer timeout for local inference
+            maxRetries: config.maxRetries ?? 2,
+            ruvllmPath: config.ruvllmPath || 'npx',
+            port: config.port ?? 8080,
+            defaultModel: config.defaultModel || 'llama-3.2-3b-instruct',
+            gpuLayers: config.gpuLayers ?? -1,
+            contextSize: config.contextSize ?? 4096,
+            threads: config.threads ?? 4,
+            defaultTemperature: config.defaultTemperature ?? 0.7,
+            enableEmbeddings: config.enableEmbeddings ?? false
+        };
+        this.isInitialized = false;
+        this.baseUrl = `http://localhost:${this.config.port}`;
+        this.requestCount = 0;
+    }
+    /**
+     * Initialize the ruvllm provider
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            this.logger.warn('RuvllmProvider already initialized');
+            return;
+        }
+        try {
+            // Check if server is already running
+            const isRunning = await this.checkServerHealth();
+            if (isRunning) {
+                this.isInitialized = true;
+                this.logger.info('Connected to existing ruvllm server');
+                return;
+            }
+            // Start ruvllm server
+            await this.startServer();
+            this.isInitialized = true;
+            this.logger.info('RuvllmProvider initialized', {
+                model: this.config.defaultModel,
+                port: this.config.port,
+                gpuLayers: this.config.gpuLayers
+            });
+        }
+        catch (error) {
+            throw new ILLMProvider_1.LLMProviderError(`Failed to initialize ruvllm: ${error.message}`, 'ruvllm', 'INIT_ERROR', false, error);
+        }
+    }
+    /**
+     * Complete a prompt using local inference
+     */
+    async complete(options) {
+        this.ensureInitialized();
+        const startTime = Date.now();
+        try {
+            // Build request body
+            const requestBody = {
+                model: options.model || this.config.defaultModel,
+                messages: options.messages.map(m => ({
+                    role: m.role,
+                    content: typeof m.content === 'string' ? m.content : m.content.map(c => c.text || '').join('')
+                })),
+                max_tokens: options.maxTokens || 2048,
+                temperature: options.temperature ?? this.config.defaultTemperature,
+                stream: false
+            };
+            // Add system message if provided
+            if (options.system && options.system.length > 0) {
+                const systemContent = options.system.map(s => s.text).join('\n');
+                requestBody.messages = [
+                    { role: 'system', content: systemContent },
+                    ...requestBody.messages
+                ];
+            }
+            const response = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(requestBody),
+                signal: AbortSignal.timeout(this.config.timeout)
+            });
+            if (!response.ok) {
+                throw new Error(`Server returned ${response.status}: ${await response.text()}`);
+            }
+            const data = await response.json();
+            this.requestCount++;
+            // Map to standard response format
+            const result = {
+                content: [{
+                        type: 'text',
+                        text: data.choices?.[0]?.message?.content || ''
+                    }],
+                usage: {
+                    input_tokens: data.usage?.prompt_tokens || 0,
+                    output_tokens: data.usage?.completion_tokens || 0
+                },
+                model: data.model || this.config.defaultModel,
+                stop_reason: this.mapStopReason(data.choices?.[0]?.finish_reason),
+                id: data.id || `ruvllm-${Date.now()}`,
+                metadata: {
+                    latency: Date.now() - startTime,
+                    cost: 0 // Local inference is free
+                }
+            };
+            this.logger.debug('Ruvllm completion successful', {
+                model: result.model,
+                inputTokens: result.usage.input_tokens,
+                outputTokens: result.usage.output_tokens,
+                latency: result.metadata?.latency
+            });
+            return result;
+        }
+        catch (error) {
+            throw new ILLMProvider_1.LLMProviderError(`Ruvllm completion failed: ${error.message}`, 'ruvllm', 'INFERENCE_ERROR', true, error);
+        }
+    }
+    /**
+     * Stream a completion
+     */
+    async *streamComplete(options) {
+        this.ensureInitialized();
+        try {
+            const requestBody = {
+                model: options.model || this.config.defaultModel,
+                messages: options.messages.map(m => ({
+                    role: m.role,
+                    content: typeof m.content === 'string' ? m.content : m.content.map(c => c.text || '').join('')
+                })),
+                max_tokens: options.maxTokens || 2048,
+                temperature: options.temperature ?? this.config.defaultTemperature,
+                stream: true
+            };
+            if (options.system && options.system.length > 0) {
+                const systemContent = options.system.map(s => s.text).join('\n');
+                requestBody.messages = [
+                    { role: 'system', content: systemContent },
+                    ...requestBody.messages
+                ];
+            }
+            const response = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(requestBody)
+            });
+            if (!response.ok) {
+                throw new Error(`Server returned ${response.status}`);
+            }
+            const reader = response.body?.getReader();
+            if (!reader) {
+                throw new Error('No response body');
+            }
+            const decoder = new TextDecoder();
+            let buffer = '';
+            yield { type: 'message_start' };
+            yield { type: 'content_block_start', content_block: { type: 'text', text: '' } };
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    if (line.startsWith('data: ')) {
+                        const data = line.slice(6);
+                        if (data === '[DONE]')
+                            continue;
+                        try {
+                            const parsed = JSON.parse(data);
+                            const content = parsed.choices?.[0]?.delta?.content;
+                            if (content) {
+                                yield {
+                                    type: 'content_block_delta',
+                                    delta: { type: 'text_delta', text: content }
+                                };
+                            }
+                        }
+                        catch {
+                            // Skip invalid JSON
+                        }
+                    }
+                }
+            }
+            yield { type: 'content_block_stop' };
+            yield { type: 'message_stop' };
+            this.requestCount++;
+        }
+        catch (error) {
+            throw new ILLMProvider_1.LLMProviderError(`Ruvllm stream failed: ${error.message}`, 'ruvllm', 'STREAM_ERROR', true, error);
+        }
+    }
+    /**
+     * Generate embeddings
+     */
+    async embed(options) {
+        this.ensureInitialized();
+        if (!this.config.enableEmbeddings) {
+            throw new ILLMProvider_1.LLMProviderError('Embeddings not enabled. Set enableEmbeddings: true in config.', 'ruvllm', 'UNSUPPORTED', false);
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/embeddings`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: options.model || 'embedding',
+                    input: options.text
+                })
+            });
+            if (!response.ok) {
+                throw new Error(`Server returned ${response.status}`);
+            }
+            const data = await response.json();
+            return {
+                embedding: data.data?.[0]?.embedding || [],
+                model: data.model || 'embedding',
+                tokens: data.usage?.total_tokens || 0
+            };
+        }
+        catch (error) {
+            throw new ILLMProvider_1.LLMProviderError(`Embedding generation failed: ${error.message}`, 'ruvllm', 'EMBEDDING_ERROR', true, error);
+        }
+    }
+    /**
+     * Count tokens in text
+     */
+    async countTokens(options) {
+        // Approximate token count (ruvllm doesn't have a direct endpoint)
+        // Most models use ~4 characters per token
+        return Math.ceil(options.text.length / 4);
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        const startTime = Date.now();
+        try {
+            const isHealthy = await this.checkServerHealth();
+            return {
+                healthy: isHealthy,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+                metadata: {
+                    model: this.config.defaultModel,
+                    port: this.config.port,
+                    requestCount: this.requestCount
+                }
+            };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                error: error.message,
+                timestamp: new Date()
+            };
+        }
+    }
+    /**
+     * Get provider metadata
+     */
+    getMetadata() {
+        return {
+            name: 'ruvllm',
+            version: '1.0.0',
+            models: [
+                'llama-3.2-3b-instruct',
+                'llama-3.2-1b-instruct',
+                'llama-3.1-8b-instruct',
+                'phi-3-mini',
+                'mistral-7b-instruct',
+                'qwen2-7b-instruct'
+            ],
+            capabilities: {
+                streaming: true,
+                caching: false,
+                embeddings: this.config.enableEmbeddings,
+                vision: false
+            },
+            costs: {
+                inputPerMillion: 0, // Free for local inference
+                outputPerMillion: 0
+            },
+            location: 'local'
+        };
+    }
+    /**
+     * Shutdown the provider
+     */
+    async shutdown() {
+        if (this.serverProcess) {
+            this.serverProcess.kill();
+            this.serverProcess = undefined;
+        }
+        this.isInitialized = false;
+        this.logger.info('RuvllmProvider shutdown', {
+            requestCount: this.requestCount
+        });
+    }
+    /**
+     * Track cost (always 0 for local inference)
+     */
+    trackCost(usage) {
+        return 0; // Local inference is free
+    }
+    /**
+     * Start the ruvllm server
+     */
+    async startServer() {
+        return new Promise((resolve, reject) => {
+            const args = [
+                'ruvllm',
+                'serve',
+                '--model', this.config.defaultModel,
+                '--port', String(this.config.port),
+                '--gpu-layers', String(this.config.gpuLayers),
+                '--context-size', String(this.config.contextSize),
+                '--threads', String(this.config.threads)
+            ];
+            if (this.config.ruvllmPath === 'npx') {
+                this.serverProcess = (0, child_process_1.spawn)('npx', args, {
+                    stdio: this.config.debug ? 'inherit' : 'pipe'
+                });
+            }
+            else {
+                this.serverProcess = (0, child_process_1.spawn)(this.config.ruvllmPath, args.slice(1), {
+                    stdio: this.config.debug ? 'inherit' : 'pipe'
+                });
+            }
+            this.serverProcess.on('error', (error) => {
+                reject(new Error(`Failed to start ruvllm: ${error.message}`));
+            });
+            // Wait for server to be ready
+            const checkInterval = setInterval(async () => {
+                try {
+                    const isReady = await this.checkServerHealth();
+                    if (isReady) {
+                        clearInterval(checkInterval);
+                        resolve();
+                    }
+                }
+                catch {
+                    // Server not ready yet
+                }
+            }, 500);
+            // Timeout after 60 seconds
+            setTimeout(() => {
+                clearInterval(checkInterval);
+                reject(new Error('Timeout waiting for ruvllm server to start'));
+            }, 60000);
+        });
+    }
+    /**
+     * Check if server is healthy
+     */
+    async checkServerHealth() {
+        try {
+            const response = await fetch(`${this.baseUrl}/health`, {
+                signal: AbortSignal.timeout(5000)
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Ensure provider is initialized
+     */
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new ILLMProvider_1.LLMProviderError('RuvllmProvider not initialized. Call initialize() first.', 'ruvllm', 'NOT_INITIALIZED', false);
+        }
+    }
+    /**
+     * Map finish reason to standard stop reason
+     */
+    mapStopReason(reason) {
+        switch (reason) {
+            case 'length':
+                return 'max_tokens';
+            case 'stop':
+                return 'stop_sequence';
+            default:
+                return 'end_turn';
+        }
+    }
+}
+exports.RuvllmProvider = RuvllmProvider;
+//# sourceMappingURL=RuvllmProvider.js.map

package/dist/providers/RuvllmProvider.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * LLM Providers - Unified LLM Provider Layer
+ *
+ * This module provides a unified interface for multiple LLM providers:
+ * - ClaudeProvider: Anthropic Claude API
+ * - RuvllmProvider: Local LLM inference via ruvllm
+ * - LLMProviderFactory: Factory for provider creation and hybrid routing
+ *
+ * @module providers
+ * @version 1.0.0
+ */
+export { ILLMProvider, LLMProviderConfig, LLMCompletionOptions, LLMCompletionResponse, LLMStreamEvent, LLMEmbeddingOptions, LLMEmbeddingResponse, LLMTokenCountOptions, LLMHealthStatus, LLMProviderMetadata, LLMMessageParam, LLMTextBlockParam, LLMProviderError, isLLMProviderError } from './ILLMProvider';
+export { ClaudeProvider, ClaudeProviderConfig } from './ClaudeProvider';
+export { RuvllmProvider, RuvllmProviderConfig } from './RuvllmProvider';
+export { LLMProviderFactory, LLMProviderFactoryConfig, ProviderType, ProviderSelectionCriteria, ProviderUsageStats, getGlobalLLMFactory, setGlobalLLMFactory } from './LLMProviderFactory';
+import type { ILLMProvider } from './ILLMProvider';
+/**
+ * Create a default LLM provider based on environment
+ *
+ * Uses Claude if ANTHROPIC_API_KEY is set, otherwise attempts ruvllm
+ */
+export declare function createDefaultProvider(): Promise<ILLMProvider>;
+/**
+ * Create a hybrid provider that routes between local and cloud
+ */
+export declare function createHybridProvider(config?: {
+    preferLocal?: boolean;
+    claudeConfig?: any;
+    ruvllmConfig?: any;
+}): Promise<ILLMProvider>;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,YAAY,CAAC,CAkBnE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxB"}

package/dist/providers/index.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * LLM Providers - Unified LLM Provider Layer
+ *
+ * This module provides a unified interface for multiple LLM providers:
+ * - ClaudeProvider: Anthropic Claude API
+ * - RuvllmProvider: Local LLM inference via ruvllm
+ * - LLMProviderFactory: Factory for provider creation and hybrid routing
+ *
+ * @module providers
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setGlobalLLMFactory = exports.getGlobalLLMFactory = exports.LLMProviderFactory = exports.RuvllmProvider = exports.ClaudeProvider = exports.isLLMProviderError = exports.LLMProviderError = void 0;
+exports.createDefaultProvider = createDefaultProvider;
+exports.createHybridProvider = createHybridProvider;
+// Core interface and types
+var ILLMProvider_1 = require("./ILLMProvider");
+Object.defineProperty(exports, "LLMProviderError", { enumerable: true, get: function () { return ILLMProvider_1.LLMProviderError; } });
+Object.defineProperty(exports, "isLLMProviderError", { enumerable: true, get: function () { return ILLMProvider_1.isLLMProviderError; } });
+// Provider implementations
+var ClaudeProvider_1 = require("./ClaudeProvider");
+Object.defineProperty(exports, "ClaudeProvider", { enumerable: true, get: function () { return ClaudeProvider_1.ClaudeProvider; } });
+var RuvllmProvider_1 = require("./RuvllmProvider");
+Object.defineProperty(exports, "RuvllmProvider", { enumerable: true, get: function () { return RuvllmProvider_1.RuvllmProvider; } });
+// Factory and utilities
+var LLMProviderFactory_1 = require("./LLMProviderFactory");
+Object.defineProperty(exports, "LLMProviderFactory", { enumerable: true, get: function () { return LLMProviderFactory_1.LLMProviderFactory; } });
+Object.defineProperty(exports, "getGlobalLLMFactory", { enumerable: true, get: function () { return LLMProviderFactory_1.getGlobalLLMFactory; } });
+Object.defineProperty(exports, "setGlobalLLMFactory", { enumerable: true, get: function () { return LLMProviderFactory_1.setGlobalLLMFactory; } });
+const ClaudeProvider_2 = require("./ClaudeProvider");
+const RuvllmProvider_2 = require("./RuvllmProvider");
+const LLMProviderFactory_2 = require("./LLMProviderFactory");
+/**
+ * Create a default LLM provider based on environment
+ *
+ * Uses Claude if ANTHROPIC_API_KEY is set, otherwise attempts ruvllm
+ */
+async function createDefaultProvider() {
+    // Try Claude first (most common use case)
+    if (process.env.ANTHROPIC_API_KEY) {
+        const provider = new ClaudeProvider_2.ClaudeProvider();
+        await provider.initialize();
+        return provider;
+    }
+    // Fall back to local ruvllm
+    const provider = new RuvllmProvider_2.RuvllmProvider();
+    try {
+        await provider.initialize();
+        return provider;
+    }
+    catch {
+        throw new Error('No LLM provider available. Set ANTHROPIC_API_KEY for Claude or ensure ruvllm is installed.');
+    }
+}
+/**
+ * Create a hybrid provider that routes between local and cloud
+ */
+async function createHybridProvider(config) {
+    const factory = new LLMProviderFactory_2.LLMProviderFactory({
+        claude: config?.claudeConfig,
+        ruvllm: config?.ruvllmConfig,
+        defaultProvider: config?.preferLocal ? 'ruvllm' : 'claude',
+        enableFallback: true
+    });
+    await factory.initialize();
+    return factory.createHybridRouter();
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA6CH,sDAkBC;AAKD,oDAeC;AAjFD,2BAA2B;AAC3B,+CAewB;AAFtB,gHAAA,gBAAgB,OAAA;AAChB,kHAAA,kBAAkB,OAAA;AAGpB,2BAA2B;AAC3B,mDAAwE;AAA/D,gHAAA,cAAc,OAAA;AACvB,mDAAwE;AAA/D,gHAAA,cAAc,OAAA;AAEvB,wBAAwB;AACxB,2DAQ8B;AAP5B,wHAAA,kBAAkB,OAAA;AAKlB,yHAAA,mBAAmB,OAAA;AACnB,yHAAA,mBAAmB,OAAA;AAIrB,qDAAkD;AAClD,qDAAkD;AAClD,6DAA0D;AAE1D;;;;GAIG;AACI,KAAK,UAAU,qBAAqB;IACzC,0CAA0C;IAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,+BAAc,EAAE,CAAC;QACtC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,IAAI,+BAAc,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,MAI1C;IACC,MAAM,OAAO,GAAG,IAAI,uCAAkB,CAAC;QACrC,MAAM,EAAE,MAAM,EAAE,YAAY;QAC5B,MAAM,EAAE,MAAM,EAAE,YAAY;QAC5B,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC1D,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAE3B,OAAO,OAAO,CAAC,kBAAkB,EAAE,CAAC;AACtC,CAAC"}

package/dist/utils/IntervalRegistry.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Global Interval Registry for Memory Leak Prevention
+ *
+ * Provides a centralized registry for tracking intervals that need cleanup.
+ * This is especially important for:
+ * - Module-level intervals that persist across tests
+ * - Intervals in singleton instances
+ * - Cleanup during graceful shutdown
+ *
+ * Usage:
+ * ```typescript
+ * import { IntervalRegistry } from './utils/IntervalRegistry';
+ *
+ * // Register an interval for cleanup
+ * const intervalId = setInterval(fn, 1000);
+ * IntervalRegistry.register('my-feature', intervalId);
+ *
+ * // Register with shutdown callback
+ * IntervalRegistry.registerWithShutdown('my-feature', {
+ *   interval: intervalId,
+ *   shutdown: async () => { ... }
+ * });
+ *
+ * // Cleanup specific feature
+ * await IntervalRegistry.shutdown('my-feature');
+ *
+ * // Cleanup all (for tests or process exit)
+ * await IntervalRegistry.shutdownAll();
+ * ```
+ *
+ * @module utils/IntervalRegistry
+ */
+export interface RegisteredInterval {
+    interval: NodeJS.Timeout;
+    shutdown?: () => Promise<void> | void;
+    registeredAt: number;
+}
+/**
+ * Global registry for tracking intervals that need cleanup
+ */
+declare class IntervalRegistryClass {
+    private registry;
+    private shutdownCallbacks;
+    /**
+     * Register an interval for later cleanup
+     *
+     * @param feature - Feature/module name for grouping
+     * @param interval - The interval handle from setInterval
+     */
+    register(feature: string, interval: NodeJS.Timeout): void;
+    /**
+     * Register an interval with a custom shutdown callback
+     *
+     * @param feature - Feature/module name for grouping
+     * @param config - Interval and optional shutdown callback
+     */
+    registerWithShutdown(feature: string, config: {
+        interval: NodeJS.Timeout;
+        shutdown?: () => Promise<void> | void;
+    }): void;
+    /**
+     * Register a shutdown callback for a feature
+     * This is called even if no intervals are registered
+     *
+     * @param feature - Feature/module name
+     * @param callback - Shutdown callback
+     */
+    registerShutdownCallback(feature: string, callback: () => Promise<void> | void): void;
+    /**
+     * Unregister a specific interval
+     *
+     * @param feature - Feature name
+     * @param interval - The interval to unregister
+     */
+    unregister(feature: string, interval: NodeJS.Timeout): void;
+    /**
+     * Shutdown all intervals for a specific feature
+     *
+     * @param feature - Feature name to shutdown
+     */
+    shutdown(feature: string): Promise<void>;
+    /**
+     * Shutdown all registered intervals
+     * Typically called during test teardown or process exit
+     */
+    shutdownAll(): Promise<void>;
+    /**
+     * Get statistics about registered intervals
+     */
+    getStats(): {
+        totalIntervals: number;
+        features: string[];
+        byFeature: Record<string, number>;
+    };
+    /**
+     * Clear all registrations without calling shutdown
+     * Use with caution - primarily for testing
+     */
+    clear(): void;
+}
+/**
+ * Singleton instance of the interval registry
+ */
+export declare const IntervalRegistry: IntervalRegistryClass;
+/**
+ * Export shutdown functions for chaos handlers and other modules
+ */
+export { shutdown as shutdownChaosLatency } from '../mcp/handlers/chaos/chaos-inject-latency';
+export { shutdown as shutdownChaosFailure } from '../mcp/handlers/chaos/chaos-inject-failure';
+//# sourceMappingURL=IntervalRegistry.d.ts.map

package/dist/utils/IntervalRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/IntervalRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,QAAQ,CAAgD;IAChE,OAAO,CAAC,iBAAiB,CAAsD;IAE/E;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IAWzD;;;;;OAKG;IACH,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,GAC1E,IAAI;IAYP;;;;;;OAMG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAIrF;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IAY3D;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B9C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBlC;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC;IAgBD;;;OAGG;IACH,KAAK,IAAI,IAAI;CASd;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,uBAA8B,CAAC;AAE5D;;GAEG;AACH,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAC9F,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,4CAA4C,CAAC"}