agentic-qe 2.1.2 → 2.2.1

package/dist/memory/PatternReplicationService.js

@@ -0,0 +1,392 @@
+"use strict";
+/**
+ * PatternReplicationService - Pattern Replication with Health Monitoring
+ *
+ * Features:
+ * - Multi-agent pattern replication with configurable replication factor
+ * - Health monitoring for replication nodes
+ * - Conflict resolution for concurrent updates
+ * - Automatic failover and recovery
+ * - Replication consistency tracking
+ *
+ * @module memory/PatternReplicationService
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternReplicationService = exports.ReplicationNodeStatus = void 0;
+const events_1 = require("events");
+/**
+ * Replication node status
+ */
+var ReplicationNodeStatus;
+(function (ReplicationNodeStatus) {
+    ReplicationNodeStatus["HEALTHY"] = "healthy";
+    ReplicationNodeStatus["DEGRADED"] = "degraded";
+    ReplicationNodeStatus["FAILED"] = "failed";
+    ReplicationNodeStatus["RECOVERING"] = "recovering";
+})(ReplicationNodeStatus || (exports.ReplicationNodeStatus = ReplicationNodeStatus = {}));
+/**
+ * PatternReplicationService - Manages pattern replication across multiple agents
+ *
+ * This service provides:
+ * - Automatic pattern replication to N nodes (configurable replication factor)
+ * - Health monitoring with heartbeat mechanism
+ * - Automatic failover and recovery
+ * - Consistency checking and repair
+ * - Event-driven notifications for replication events
+ */
+class PatternReplicationService extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.DEFAULT_HEARTBEAT_INTERVAL = 5000; // 5 seconds
+        this.DEFAULT_SYNC_INTERVAL = 30000; // 30 seconds
+        this.DEFAULT_FAILURE_THRESHOLD = 3;
+        this.config = {
+            ...config,
+            heartbeatInterval: config.heartbeatInterval || this.DEFAULT_HEARTBEAT_INTERVAL,
+            failureThreshold: config.failureThreshold || this.DEFAULT_FAILURE_THRESHOLD,
+            syncInterval: config.syncInterval || this.DEFAULT_SYNC_INTERVAL,
+            autoRecover: config.autoRecover !== false,
+            minHealthyNodes: config.minHealthyNodes || Math.ceil(config.replicationFactor / 2)
+        };
+        this.nodes = new Map();
+        this.isRunning = false;
+    }
+    /**
+     * Start the replication service
+     */
+    async start() {
+        if (this.isRunning) {
+            throw new Error('Replication service is already running');
+        }
+        this.isRunning = true;
+        // Start heartbeat monitoring
+        this.startHeartbeat();
+        // Start periodic sync
+        this.startSync();
+    }
+    /**
+     * Stop the replication service
+     */
+    async stop() {
+        this.isRunning = false;
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        if (this.syncTimer) {
+            clearInterval(this.syncTimer);
+            this.syncTimer = undefined;
+        }
+    }
+    /**
+     * Register a replication node
+     */
+    async registerNode(agentId, library) {
+        const stats = await library.getStats();
+        const node = {
+            agentId,
+            library,
+            status: ReplicationNodeStatus.HEALTHY,
+            lastHeartbeat: Date.now(),
+            consecutiveFailures: 0,
+            totalPatterns: stats.totalPatterns,
+            lastSyncTimestamp: stats.lastSyncTimestamp
+        };
+        this.nodes.set(agentId, node);
+        // Trigger initial sync if service is running
+        if (this.isRunning) {
+            await this.syncNode(node);
+        }
+    }
+    /**
+     * Unregister a replication node
+     */
+    async unregisterNode(agentId) {
+        return this.nodes.delete(agentId);
+    }
+    /**
+     * Replicate a pattern to all healthy nodes
+     */
+    async replicatePattern(pattern, sourceAgentId) {
+        const healthyNodes = this.getHealthyNodes();
+        if (healthyNodes.length < this.config.minHealthyNodes) {
+            throw new Error(`Insufficient healthy nodes: ${healthyNodes.length} < ${this.config.minHealthyNodes}`);
+        }
+        let replicatedCount = 0;
+        const errors = [];
+        // Replicate to nodes (up to replication factor)
+        const targetNodes = healthyNodes.slice(0, this.config.replicationFactor);
+        for (const node of targetNodes) {
+            // Skip source node if specified
+            if (sourceAgentId && node.agentId === sourceAgentId) {
+                continue;
+            }
+            try {
+                await node.library.storePattern(pattern, sourceAgentId);
+                replicatedCount++;
+            }
+            catch (error) {
+                errors.push({ agentId: node.agentId, error: error });
+                await this.handleNodeFailure(node, error);
+            }
+        }
+        // Emit replication event
+        this.emit('pattern_replicated', {
+            type: 'pattern_replicated',
+            patternId: pattern.id,
+            nodeCount: replicatedCount
+        });
+        if (errors.length > 0 && replicatedCount < this.config.minHealthyNodes) {
+            throw new Error(`Pattern replication failed: only ${replicatedCount} successful replications`);
+        }
+        return replicatedCount;
+    }
+    /**
+     * Sync patterns across all nodes
+     */
+    async syncPatterns() {
+        const startTime = Date.now();
+        let totalSynced = 0;
+        const healthyNodes = this.getHealthyNodes();
+        if (healthyNodes.length < 2) {
+            return { synced: 0, duration: 0 };
+        }
+        // Use first healthy node as source of truth
+        const sourceNode = healthyNodes[0];
+        const sourcePatterns = await sourceNode.library.exportPatterns();
+        // Sync to other nodes
+        for (let i = 1; i < healthyNodes.length; i++) {
+            const targetNode = healthyNodes[i];
+            try {
+                const synced = await targetNode.library.mergePatterns(sourcePatterns);
+                totalSynced += synced;
+                targetNode.lastSyncTimestamp = Date.now();
+            }
+            catch (error) {
+                await this.handleNodeFailure(targetNode, error);
+            }
+        }
+        const duration = Date.now() - startTime;
+        this.emit('sync_completed', {
+            type: 'sync_completed',
+            duration,
+            patternsReplicated: totalSynced
+        });
+        return { synced: totalSynced, duration };
+    }
+    /**
+     * Check replication health
+     */
+    async checkHealth() {
+        let totalReplicationLag = 0;
+        let healthyCount = 0;
+        let degradedCount = 0;
+        let failedCount = 0;
+        let recoveringCount = 0;
+        const now = Date.now();
+        for (const node of Array.from(this.nodes.values())) {
+            // Update stats
+            try {
+                const stats = await node.library.getStats();
+                node.totalPatterns = stats.totalPatterns;
+                node.lastSyncTimestamp = stats.lastSyncTimestamp;
+            }
+            catch {
+                // Ignore stats errors during health check
+            }
+            // Count by status
+            switch (node.status) {
+                case ReplicationNodeStatus.HEALTHY:
+                    healthyCount++;
+                    break;
+                case ReplicationNodeStatus.DEGRADED:
+                    degradedCount++;
+                    break;
+                case ReplicationNodeStatus.FAILED:
+                    failedCount++;
+                    break;
+                case ReplicationNodeStatus.RECOVERING:
+                    recoveringCount++;
+                    break;
+            }
+            // Calculate replication lag
+            const lag = now - node.lastSyncTimestamp;
+            totalReplicationLag += lag;
+        }
+        const averageReplicationLag = this.nodes.size > 0 ? totalReplicationLag / this.nodes.size : 0;
+        // Calculate consistency percentage
+        const consistencyPercentage = await this.calculateConsistency();
+        return {
+            totalNodes: this.nodes.size,
+            healthyNodes: healthyCount,
+            degradedNodes: degradedCount,
+            failedNodes: failedCount,
+            recoveringNodes: recoveringCount,
+            averageReplicationLag,
+            consistencyPercentage,
+            lastHealthCheck: now
+        };
+    }
+    /**
+     * Get replication statistics
+     */
+    async getStats() {
+        const health = await this.checkHealth();
+        return {
+            replicationFactor: this.config.replicationFactor,
+            registeredNodes: this.nodes.size,
+            health
+        };
+    }
+    /**
+     * Get all registered nodes
+     */
+    getNodes() {
+        return Array.from(this.nodes.values());
+    }
+    /**
+     * Get healthy nodes only
+     */
+    getHealthyNodes() {
+        return Array.from(this.nodes.values()).filter(node => node.status === ReplicationNodeStatus.HEALTHY);
+    }
+    /**
+     * Start heartbeat monitoring
+     */
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(async () => {
+            await this.performHeartbeat();
+        }, this.config.heartbeatInterval);
+    }
+    /**
+     * Start periodic sync
+     */
+    startSync() {
+        this.syncTimer = setInterval(async () => {
+            await this.syncPatterns();
+        }, this.config.syncInterval);
+    }
+    /**
+     * Perform heartbeat check on all nodes
+     */
+    async performHeartbeat() {
+        const now = Date.now();
+        for (const node of Array.from(this.nodes.values())) {
+            try {
+                // Try to get stats as health check
+                const stats = await node.library.getStats();
+                node.totalPatterns = stats.totalPatterns;
+                node.lastHeartbeat = now;
+                node.consecutiveFailures = 0;
+                // Update status if recovering
+                if (node.status === ReplicationNodeStatus.RECOVERING) {
+                    node.status = ReplicationNodeStatus.HEALTHY;
+                    this.emit('node_recovered', {
+                        type: 'node_recovered',
+                        agentId: node.agentId
+                    });
+                }
+            }
+            catch (error) {
+                await this.handleNodeFailure(node, error);
+            }
+        }
+    }
+    /**
+     * Handle node failure
+     */
+    async handleNodeFailure(node, error) {
+        node.consecutiveFailures++;
+        if (node.consecutiveFailures >= this.config.failureThreshold) {
+            if (node.status !== ReplicationNodeStatus.FAILED) {
+                node.status = ReplicationNodeStatus.FAILED;
+                this.emit('node_failed', {
+                    type: 'node_failed',
+                    agentId: node.agentId,
+                    reason: error.message
+                });
+                // Attempt recovery if enabled
+                if (this.config.autoRecover) {
+                    await this.attemptRecovery(node);
+                }
+            }
+        }
+        else if (node.status === ReplicationNodeStatus.HEALTHY) {
+            node.status = ReplicationNodeStatus.DEGRADED;
+        }
+    }
+    /**
+     * Attempt to recover a failed node
+     */
+    async attemptRecovery(node) {
+        node.status = ReplicationNodeStatus.RECOVERING;
+        try {
+            // Reinitialize the library
+            await node.library.initialize();
+            // Sync patterns from healthy node
+            await this.syncNode(node);
+            node.status = ReplicationNodeStatus.HEALTHY;
+            node.consecutiveFailures = 0;
+            this.emit('node_recovered', {
+                type: 'node_recovered',
+                agentId: node.agentId
+            });
+        }
+        catch (error) {
+            node.status = ReplicationNodeStatus.FAILED;
+        }
+    }
+    /**
+     * Sync a single node with the cluster
+     */
+    async syncNode(targetNode) {
+        const healthyNodes = this.getHealthyNodes().filter(n => n.agentId !== targetNode.agentId);
+        if (healthyNodes.length === 0) {
+            return; // No healthy nodes to sync from
+        }
+        const sourceNode = healthyNodes[0];
+        const patterns = await sourceNode.library.exportPatterns();
+        await targetNode.library.mergePatterns(patterns);
+        targetNode.lastSyncTimestamp = Date.now();
+    }
+    /**
+     * Calculate consistency percentage across all nodes
+     */
+    async calculateConsistency() {
+        if (this.nodes.size < 2) {
+            return 100; // Single node is always consistent
+        }
+        const healthyNodes = this.getHealthyNodes();
+        if (healthyNodes.length < 2) {
+            return 0; // Need at least 2 healthy nodes to measure consistency
+        }
+        // Get all pattern IDs from all nodes
+        const allPatternIds = new Set();
+        const nodePatterns = new Map();
+        for (const node of healthyNodes) {
+            const patterns = await node.library.exportPatterns();
+            const patternIds = new Set(patterns.map(p => p.pattern.id));
+            nodePatterns.set(node.agentId, patternIds);
+            for (const id of Array.from(patternIds)) {
+                allPatternIds.add(id);
+            }
+        }
+        // Count how many patterns are fully replicated
+        let fullyReplicatedCount = 0;
+        for (const patternId of Array.from(allPatternIds)) {
+            let replicationCount = 0;
+            for (const patternIds of Array.from(nodePatterns.values())) {
+                if (patternIds.has(patternId)) {
+                    replicationCount++;
+                }
+            }
+            if (replicationCount === healthyNodes.length) {
+                fullyReplicatedCount++;
+            }
+        }
+        return allPatternIds.size > 0 ? (fullyReplicatedCount / allPatternIds.size) * 100 : 100;
+    }
+}
+exports.PatternReplicationService = PatternReplicationService;
+//# sourceMappingURL=PatternReplicationService.js.map

package/dist/memory/PatternReplicationService.js.map

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

package/dist/providers/ClaudeProvider.d.ts

@@ -0,0 +1,98 @@
+/**
+ * ClaudeProvider - Anthropic Claude API Implementation
+ *
+ * Provides LLM capabilities through Anthropic's Claude API with support for:
+ * - Prompt caching for cost optimization
+ * - Streaming responses
+ * - Token counting
+ * - Health checks
+ *
+ * @module providers/ClaudeProvider
+ * @version 1.0.0
+ */
+import { ILLMProvider, LLMProviderConfig, LLMCompletionOptions, LLMCompletionResponse, LLMStreamEvent, LLMEmbeddingOptions, LLMEmbeddingResponse, LLMTokenCountOptions, LLMHealthStatus, LLMProviderMetadata } from './ILLMProvider';
+/**
+ * Claude-specific configuration
+ */
+export interface ClaudeProviderConfig extends LLMProviderConfig {
+    /** Anthropic API key (uses ANTHROPIC_API_KEY env var if not provided) */
+    apiKey?: string;
+    /** Default model to use */
+    defaultModel?: string;
+    /** Enable prompt caching */
+    enableCaching?: boolean;
+    /** Base URL for API (for testing/proxies) */
+    baseUrl?: string;
+}
+/**
+ * ClaudeProvider - Anthropic Claude API implementation of ILLMProvider
+ *
+ * This provider enables access to Claude models through the Anthropic API
+ * with full support for caching, streaming, and cost tracking.
+ */
+export declare class ClaudeProvider implements ILLMProvider {
+    private readonly logger;
+    private client?;
+    private config;
+    private isInitialized;
+    private totalCost;
+    private requestCount;
+    constructor(config?: ClaudeProviderConfig);
+    /**
+     * Initialize the Claude provider
+     */
+    initialize(): Promise<void>;
+    /**
+     * Complete a prompt
+     */
+    complete(options: LLMCompletionOptions): Promise<LLMCompletionResponse>;
+    /**
+     * Stream a completion
+     */
+    streamComplete(options: LLMCompletionOptions): AsyncIterableIterator<LLMStreamEvent>;
+    /**
+     * Generate embeddings (Claude doesn't natively support embeddings)
+     */
+    embed(options: LLMEmbeddingOptions): Promise<LLMEmbeddingResponse>;
+    /**
+     * Count tokens in text
+     */
+    countTokens(options: LLMTokenCountOptions): Promise<number>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<LLMHealthStatus>;
+    /**
+     * Get provider metadata
+     */
+    getMetadata(): LLMProviderMetadata;
+    /**
+     * Shutdown the provider
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Track cost for a request
+     */
+    trackCost(usage: LLMCompletionResponse['usage']): number;
+    /**
+     * Get total cost incurred
+     */
+    getTotalCost(): number;
+    /**
+     * Ensure provider is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Map Anthropic stream event to LLMStreamEvent
+     */
+    private mapStreamEvent;
+    /**
+     * Get error code from exception
+     */
+    private getErrorCode;
+    /**
+     * Check if error is retryable
+     */
+    private isRetryableError;
+}
+//# sourceMappingURL=ClaudeProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ClaudeProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EAEpB,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,GAAE,oBAAyB;IAiB7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+F7E;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,cAAc,CAAC;IA0D3F;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IASxE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBjE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAmC7C;;OAEG;IACH,WAAW,IAAI,mBAAmB;IAuBlC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM;IAwBxD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAMzB"}