@dcyfr/ai 1.0.0

package/dist/ai/core/provider-registry.js

@@ -0,0 +1,360 @@
+/**
+ * Provider Registry & Fallback Manager
+ *
+ * Automatically detects rate limits and failures in primary providers and falls back to
+ * secondary providers with session state preservation.
+ *
+ * Features:
+ * - Rate limit detection
+ * - Automatic session state save/restore
+ * - Provider health monitoring
+ * - Configurable fallback chain
+ * - Context preservation across providers
+ *
+ * @module @dcyfr/ai/core/provider-registry
+ * @example
+ * ```typescript
+ * import { ProviderRegistry } from '@dcyfr/ai/core/provider-registry';
+ *
+ * const registry = new ProviderRegistry({
+ *   primaryProvider: 'claude',
+ *   fallbackChain: ['groq', 'ollama'],
+ *   autoReturn: true,
+ *   healthCheckInterval: 60000,
+ * });
+ *
+ * const result = await registry.executeWithFallback(task, async (provider) => {
+ *   // Your execution logic
+ *   return { data: 'result' };
+ * });
+ * ```
+ */
+/**
+ * Rate limit error
+ */
+export class RateLimitError extends Error {
+    provider;
+    retryAfter;
+    constructor(message, provider, retryAfter) {
+        super(message);
+        this.provider = provider;
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+/**
+ * Provider unavailable error
+ */
+export class ProviderUnavailableError extends Error {
+    provider;
+    constructor(message, provider) {
+        super(message);
+        this.provider = provider;
+        this.name = 'ProviderUnavailableError';
+    }
+}
+/**
+ * Provider Registry - manages multiple AI providers with automatic fallback
+ */
+export class ProviderRegistry {
+    config;
+    providerConfigs;
+    healthStatus;
+    currentProvider;
+    healthCheckTimer;
+    constructor(config) {
+        this.config = config;
+        this.currentProvider = config.primaryProvider;
+        this.providerConfigs = new Map();
+        this.healthStatus = new Map();
+        // Initialize default provider configurations
+        this.initializeProviderConfigs();
+        // Start health monitoring if auto-return enabled
+        if (config.autoReturn) {
+            this.startHealthMonitoring();
+        }
+    }
+    initializeProviderConfigs() {
+        const defaultConfigs = [
+            {
+                name: 'claude',
+                healthCheckUrl: 'https://api.anthropic.com/v1/messages',
+                maxRetries: 3,
+                retryDelay: 1000,
+                timeout: 30000,
+                enabled: true,
+            },
+            {
+                name: 'groq',
+                healthCheckUrl: 'https://api.groq.com/openai/v1/models',
+                maxRetries: 2,
+                retryDelay: 500,
+                timeout: 20000,
+                enabled: true,
+            },
+            {
+                name: 'ollama',
+                apiEndpoint: 'http://localhost:11434',
+                healthCheckUrl: 'http://localhost:11434/api/tags',
+                maxRetries: 1,
+                retryDelay: 100,
+                timeout: 10000,
+                enabled: true,
+            },
+            {
+                name: 'copilot',
+                maxRetries: 2,
+                retryDelay: 500,
+                timeout: 15000,
+                enabled: true,
+            },
+            {
+                name: 'openai',
+                healthCheckUrl: 'https://api.openai.com/v1/models',
+                maxRetries: 3,
+                retryDelay: 1000,
+                timeout: 30000,
+                enabled: true,
+            },
+            {
+                name: 'anthropic',
+                healthCheckUrl: 'https://api.anthropic.com/v1/messages',
+                maxRetries: 3,
+                retryDelay: 1000,
+                timeout: 30000,
+                enabled: true,
+            },
+        ];
+        defaultConfigs.forEach(config => {
+            this.providerConfigs.set(config.name, config);
+            this.healthStatus.set(config.name, {
+                provider: config.name,
+                available: true,
+                lastChecked: new Date(),
+            });
+        });
+    }
+    /**
+     * Check provider health status
+     */
+    async checkProviderHealth(provider) {
+        const config = this.providerConfigs.get(provider);
+        if (!config) {
+            return {
+                provider,
+                available: false,
+                lastChecked: new Date(),
+                error: 'Provider configuration not found',
+            };
+        }
+        if (!config.enabled) {
+            return {
+                provider,
+                available: false,
+                lastChecked: new Date(),
+                error: 'Provider disabled',
+            };
+        }
+        const startTime = Date.now();
+        try {
+            if (!config.healthCheckUrl) {
+                // For providers without health check URL, assume available
+                return {
+                    provider,
+                    available: true,
+                    responseTime: 0,
+                    lastChecked: new Date(),
+                };
+            }
+            // Simple HEAD request to check availability
+            const response = await fetch(config.healthCheckUrl, {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(config.timeout),
+            });
+            const responseTime = Date.now() - startTime;
+            // Extract rate limit info from headers (if available)
+            const rateLimitRemaining = response.headers.get('x-ratelimit-remaining')
+                ? parseInt(response.headers.get('x-ratelimit-remaining'), 10)
+                : undefined;
+            const rateLimitReset = response.headers.get('x-ratelimit-reset')
+                ? new Date(parseInt(response.headers.get('x-ratelimit-reset'), 10) * 1000)
+                : undefined;
+            return {
+                provider,
+                available: response.ok,
+                responseTime,
+                lastChecked: new Date(),
+                rateLimitRemaining,
+                rateLimitReset,
+            };
+        }
+        catch (error) {
+            return {
+                provider,
+                available: false,
+                responseTime: Date.now() - startTime,
+                lastChecked: new Date(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Start periodic health monitoring
+     */
+    startHealthMonitoring() {
+        this.healthCheckTimer = setInterval(async () => {
+            // Check primary provider health
+            const primaryHealth = await this.checkProviderHealth(this.config.primaryProvider);
+            this.healthStatus.set(this.config.primaryProvider, primaryHealth);
+            // If current provider is fallback and primary is healthy, switch back
+            if (this.currentProvider !== this.config.primaryProvider && primaryHealth.available) {
+                console.warn(`✅ Primary provider ${this.config.primaryProvider} available again, switching back...`);
+                await this.switchProvider(this.config.primaryProvider);
+            }
+        }, this.config.healthCheckInterval);
+    }
+    /**
+     * Switch to a different provider
+     */
+    async switchProvider(targetProvider) {
+        if (this.currentProvider === targetProvider) {
+            return;
+        }
+        console.warn(`🔄 Switching provider: ${this.currentProvider} → ${targetProvider}`);
+        // Update current provider
+        const previousProvider = this.currentProvider;
+        this.currentProvider = targetProvider;
+        console.warn(`✅ Provider switched to ${targetProvider}`);
+    }
+    /**
+     * Execute task with a specific provider
+     */
+    async executeWithProvider(provider, task, executor) {
+        const config = this.providerConfigs.get(provider);
+        if (!config) {
+            throw new Error(`Provider configuration not found: ${provider}`);
+        }
+        const startTime = Date.now();
+        let lastError;
+        // Retry logic
+        for (let attempt = 1; attempt <= config.maxRetries; attempt++) {
+            try {
+                console.warn(`🔄 Executing with ${provider} (attempt ${attempt}/${config.maxRetries})`);
+                const data = await executor(provider);
+                const executionTime = Date.now() - startTime;
+                return {
+                    success: true,
+                    data,
+                    provider,
+                    fallbackUsed: provider !== this.config.primaryProvider,
+                    executionTime,
+                    validationsPassed: [],
+                    validationsFailed: [],
+                };
+            }
+            catch (error) {
+                lastError = error;
+                // Check if rate limit error
+                if (error instanceof Error &&
+                    (error.message.includes('rate limit') || error.message.includes('429'))) {
+                    throw new RateLimitError(`Rate limit exceeded for ${provider}`, provider);
+                }
+                // Retry with delay if not last attempt
+                if (attempt < config.maxRetries) {
+                    console.warn(`⏳ Retrying in ${config.retryDelay}ms (attempt ${attempt}/${config.maxRetries})...`);
+                    await new Promise(resolve => setTimeout(resolve, config.retryDelay));
+                }
+            }
+        }
+        // All retries failed
+        throw new ProviderUnavailableError(`Provider ${provider} unavailable after ${config.maxRetries} attempts: ${lastError?.message}`, provider);
+    }
+    /**
+     * Execute a task with automatic fallback on failure
+     */
+    async executeWithFallback(task, executor) {
+        const providers = [this.currentProvider, ...this.config.fallbackChain];
+        let lastError;
+        for (const provider of providers) {
+            try {
+                // Check provider health first
+                const health = await this.checkProviderHealth(provider);
+                this.healthStatus.set(provider, health);
+                if (!health.available) {
+                    console.warn(`⚠️  Provider ${provider} not available, skipping...`);
+                    continue;
+                }
+                // Attempt execution
+                const result = await this.executeWithProvider(provider, task, executor);
+                // Update current provider if fallback was used
+                if (result.fallbackUsed && provider !== this.currentProvider) {
+                    await this.switchProvider(provider);
+                }
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof RateLimitError) {
+                    console.warn(`⏱️  Rate limit hit on ${provider}, trying next provider...`);
+                    continue;
+                }
+                if (error instanceof ProviderUnavailableError) {
+                    console.warn(`❌ Provider ${provider} unavailable, trying next provider...`);
+                    continue;
+                }
+                // Unknown error, try next provider
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.warn(`⚠️  Error with ${provider}: ${errorMessage}, trying next provider...`);
+                continue;
+            }
+        }
+        // All providers failed
+        throw new Error(`All providers exhausted. Last error: ${lastError?.message || 'Unknown'}`);
+    }
+    /**
+     * Get current provider health status
+     */
+    getHealthStatus() {
+        return new Map(this.healthStatus);
+    }
+    /**
+     * Get current active provider
+     */
+    getCurrentProvider() {
+        return this.currentProvider;
+    }
+    /**
+     * Manually trigger fallback to next provider
+     */
+    async fallbackToNext() {
+        const currentIndex = this.config.fallbackChain.indexOf(this.currentProvider);
+        const nextProvider = this.config.fallbackChain[currentIndex + 1] || this.config.fallbackChain[0];
+        await this.switchProvider(nextProvider);
+    }
+    /**
+     * Manually return to primary provider
+     */
+    async returnToPrimary() {
+        await this.switchProvider(this.config.primaryProvider);
+    }
+    /**
+     * Update provider configuration
+     */
+    updateProviderConfig(provider, config) {
+        const existing = this.providerConfigs.get(provider);
+        if (!existing) {
+            throw new Error(`Provider not found: ${provider}`);
+        }
+        this.providerConfigs.set(provider, { ...existing, ...config });
+    }
+    /**
+     * Stop health monitoring and cleanup
+     */
+    destroy() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/ai/core/provider-registry.js.map

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

package/dist/ai/core/telemetry-engine.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Telemetry Engine
+ *
+ * Tracks agent usage, quality metrics, costs, and performance across all AI providers.
+ * Provides data-driven insights for optimizing agent allocation and cost management.
+ *
+ * @module @dcyfr/ai/core/telemetry-engine
+ * @example
+ * ```typescript
+ * import { TelemetryEngine } from '@dcyfr/ai/core/telemetry-engine';
+ *
+ * const telemetry = new TelemetryEngine({ storage: 'memory' });
+ *
+ * // Start tracking a task
+ * const session = telemetry.startSession('claude', {
+ *   taskType: 'feature',
+ *   description: 'Implement dark mode',
+ * });
+ *
+ * // Record metrics
+ * session.recordMetric('tokenCompliance', 0.98);
+ * session.recordValidation('typescript', 'pass');
+ *
+ * // End session
+ * const result = session.end('success');
+ * ```
+ */
+import type { AgentType, TaskType, TaskOutcome, ValidationStatus, StorageAdapter, StorageType } from '../types';
+import type { TelemetrySession, TelemetryMetrics, ViolationRecord, HandoffRecord, AgentStats, ComparisonStats, HandoffPatterns } from '../types/telemetry';
+/**
+ * Telemetry Session Manager - handles individual sessions
+ */
+export declare class TelemetrySessionManager {
+    private session;
+    private startTime;
+    private storage;
+    constructor(sessionId: string, agent: AgentType, taskType: TaskType, taskDescription: string, storage: StorageAdapter);
+    /**
+     * Record a metric value
+     */
+    recordMetric(metric: keyof Omit<TelemetryMetrics, 'validations'>, value: number): void;
+    /**
+     * Record validation status
+     */
+    recordValidation(validation: string, status: ValidationStatus): void;
+    /**
+     * Record a violation
+     */
+    recordViolation(violation: Omit<ViolationRecord, 'timestamp'>): void;
+    /**
+     * Record a handoff to another agent
+     */
+    recordHandoff(handoff: Omit<HandoffRecord, 'timestamp' | 'fromAgent'>): void;
+    /**
+     * Update cost estimate
+     */
+    updateCost(inputTokens: number, outputTokens: number): void;
+    private getCostPerMillionTokens;
+    /**
+     * End the session and return final metrics
+     */
+    end(outcome: TaskOutcome): Promise<TelemetrySession>;
+    /**
+     * Get current session data
+     */
+    getSession(): TelemetrySession;
+    private saveToStorage;
+}
+/**
+ * Main Telemetry Engine
+ */
+export declare class TelemetryEngine {
+    private activeSessions;
+    private storage;
+    constructor(options?: {
+        storage?: StorageType | StorageAdapter;
+        basePath?: string;
+    });
+    /**
+     * Start a new telemetry session
+     */
+    startSession(agent: AgentType, options: {
+        taskType: TaskType;
+        description: string;
+    }): TelemetrySessionManager;
+    /**
+     * Get an active session
+     */
+    getSession(sessionId: string): TelemetrySessionManager | undefined;
+    /**
+     * End a session
+     */
+    endSession(sessionId: string, outcome: TaskOutcome): Promise<TelemetrySession | null>;
+    /**
+     * Get statistics for a specific agent
+     */
+    getAgentStats(agent: AgentType, period?: string): Promise<AgentStats>;
+    /**
+     * Compare stats across all agents
+     */
+    compareAgents(period?: string): Promise<ComparisonStats>;
+    /**
+     * Get handoff patterns
+     */
+    getHandoffPatterns(period?: string): Promise<HandoffPatterns>;
+    private generateSessionId;
+    private getSessionsForPeriod;
+    private getAllSessionsForPeriod;
+    private getPeriodCutoffDate;
+    private calculateCostByTaskType;
+    private generateRecommendations;
+    private getEmptyStats;
+}
+//# sourceMappingURL=telemetry-engine.d.ts.map

package/dist/ai/core/telemetry-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-engine.d.ts","sourceRoot":"","sources":["../../../packages/ai/core/telemetry-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,eAAe,EACf,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAI5B;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAiB;gBAG9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,cAAc;IAuCzB;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,EACnD,KAAK,EAAE,MAAM,GACZ,IAAI;IAIP;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,IAAI;IAIP;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,IAAI;IAcpE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,IAAI;IAQ5E;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAa3D,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW1D;;OAEG;IACH,UAAU,IAAI,gBAAgB;YAIhB,aAAa;CAc5B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAenF;;OAEG;IACH,YAAY,CACV,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE;QACP,QAAQ,EAAE,QAAQ,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,GACA,uBAAuB;IAc1B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIlE;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAS3F;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,SAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAkE1E;;OAEG;IACG,aAAa,CAAC,MAAM,SAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB7D;;OAEG;IACG,kBAAkB,CAAC,MAAM,SAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAoClE,OAAO,CAAC,iBAAiB;YAKX,oBAAoB;YAYpB,uBAAuB;IAOrC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,aAAa;CA2BtB"}