agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/core/long-running-agent.js

@@ -0,0 +1,220 @@
+/**
+ * Long-Running Agent with Provider Fallback
+ *
+ * Demonstrates how to use ProviderManager for resilient, cost-optimized agents
+ * that can run for hours or days with automatic provider switching.
+ */
+import { ProviderManager } from './provider-manager.js';
+import { logger } from '../utils/logger.js';
+export class LongRunningAgent {
+    providerManager;
+    config;
+    startTime;
+    checkpoints = [];
+    currentState = {};
+    isRunning = false;
+    checkpointInterval;
+    constructor(config) {
+        this.config = config;
+        this.startTime = new Date();
+        // Initialize provider manager
+        this.providerManager = new ProviderManager(config.providers, config.fallbackStrategy);
+        logger.info('Long-running agent initialized', {
+            agentName: config.agentName,
+            providers: config.providers.map(p => p.name)
+        });
+    }
+    /**
+     * Start the agent with automatic checkpointing
+     */
+    async start() {
+        this.isRunning = true;
+        this.startTime = new Date();
+        // Start checkpoint interval
+        if (this.config.checkpointInterval) {
+            this.checkpointInterval = setInterval(() => {
+                this.saveCheckpoint();
+            }, this.config.checkpointInterval);
+        }
+        logger.info('Long-running agent started', {
+            agentName: this.config.agentName,
+            startTime: this.startTime
+        });
+    }
+    /**
+     * Execute a task with automatic provider fallback
+     */
+    async executeTask(task) {
+        if (!this.isRunning) {
+            throw new Error('Agent not running. Call start() first.');
+        }
+        // Check budget constraint
+        if (this.config.costBudget) {
+            const currentCost = this.providerManager.getCostSummary().total;
+            if (currentCost >= this.config.costBudget) {
+                throw new Error(`Cost budget exceeded: $${currentCost.toFixed(2)} >= $${this.config.costBudget}`);
+            }
+        }
+        // Check runtime constraint
+        if (this.config.maxRuntime) {
+            const runtime = Date.now() - this.startTime.getTime();
+            if (runtime >= this.config.maxRuntime) {
+                throw new Error(`Max runtime exceeded: ${runtime}ms >= ${this.config.maxRuntime}ms`);
+            }
+        }
+        logger.info('Executing task', {
+            agentName: this.config.agentName,
+            taskName: task.name,
+            complexity: task.complexity
+        });
+        try {
+            // Execute with automatic fallback
+            const { result, provider, attempts } = await this.providerManager.executeWithFallback(task.execute, task.complexity, task.estimatedTokens);
+            // Update state
+            this.currentState.lastTask = task.name;
+            this.currentState.lastProvider = provider;
+            this.currentState.completedTasks = (this.currentState.completedTasks || 0) + 1;
+            logger.info('Task completed', {
+                agentName: this.config.agentName,
+                taskName: task.name,
+                provider,
+                attempts
+            });
+            return result;
+        }
+        catch (error) {
+            this.currentState.failedTasks = (this.currentState.failedTasks || 0) + 1;
+            logger.error('Task failed', {
+                agentName: this.config.agentName,
+                taskName: task.name,
+                error: error.message
+            });
+            throw error;
+        }
+    }
+    /**
+     * Save checkpoint of current state
+     */
+    saveCheckpoint() {
+        const costSummary = this.providerManager.getCostSummary();
+        const health = this.providerManager.getHealth();
+        const checkpoint = {
+            timestamp: new Date(),
+            taskProgress: this.calculateProgress(),
+            currentProvider: this.currentState.lastProvider || 'none',
+            totalCost: costSummary.total,
+            totalTokens: costSummary.totalTokens,
+            completedTasks: this.currentState.completedTasks || 0,
+            failedTasks: this.currentState.failedTasks || 0,
+            state: { ...this.currentState }
+        };
+        this.checkpoints.push(checkpoint);
+        logger.info('Checkpoint saved', {
+            agentName: this.config.agentName,
+            checkpoint: {
+                ...checkpoint,
+                state: undefined // Don't log full state
+            }
+        });
+        // Alert if cost approaching budget
+        if (this.config.costBudget) {
+            const costPercentage = (costSummary.total / this.config.costBudget) * 100;
+            if (costPercentage >= 80) {
+                logger.warn('Cost budget warning', {
+                    agentName: this.config.agentName,
+                    currentCost: costSummary.total,
+                    budget: this.config.costBudget,
+                    percentage: costPercentage.toFixed(1) + '%'
+                });
+            }
+        }
+        // Alert if providers unhealthy
+        const unhealthyProviders = health.filter(h => !h.isHealthy || h.circuitBreakerOpen);
+        if (unhealthyProviders.length > 0) {
+            logger.warn('Unhealthy providers detected', {
+                agentName: this.config.agentName,
+                unhealthy: unhealthyProviders.map(h => ({
+                    provider: h.provider,
+                    circuitBreakerOpen: h.circuitBreakerOpen,
+                    consecutiveFailures: h.consecutiveFailures
+                }))
+            });
+        }
+    }
+    /**
+     * Calculate task progress (override in subclass)
+     */
+    calculateProgress() {
+        // Default: based on completed vs total tasks
+        const completed = this.currentState.completedTasks || 0;
+        const failed = this.currentState.failedTasks || 0;
+        const total = completed + failed;
+        return total > 0 ? completed / total : 0;
+    }
+    /**
+     * Get current status
+     */
+    getStatus() {
+        const costSummary = this.providerManager.getCostSummary();
+        const health = this.providerManager.getHealth();
+        const runtime = Date.now() - this.startTime.getTime();
+        return {
+            isRunning: this.isRunning,
+            runtime,
+            completedTasks: this.currentState.completedTasks || 0,
+            failedTasks: this.currentState.failedTasks || 0,
+            totalCost: costSummary.total,
+            totalTokens: costSummary.totalTokens,
+            providers: health.map(h => ({
+                name: h.provider,
+                healthy: h.isHealthy,
+                circuitBreakerOpen: h.circuitBreakerOpen,
+                successRate: (h.successRate * 100).toFixed(1) + '%',
+                avgLatency: h.averageLatency.toFixed(0) + 'ms'
+            })),
+            lastCheckpoint: this.checkpoints[this.checkpoints.length - 1]
+        };
+    }
+    /**
+     * Get detailed metrics
+     */
+    getMetrics() {
+        return {
+            providers: this.providerManager.getMetrics(),
+            health: this.providerManager.getHealth(),
+            costs: this.providerManager.getCostSummary(),
+            checkpoints: this.checkpoints
+        };
+    }
+    /**
+     * Restore from checkpoint
+     */
+    restoreFromCheckpoint(checkpoint) {
+        this.currentState = { ...checkpoint.state };
+        logger.info('Restored from checkpoint', {
+            agentName: this.config.agentName,
+            checkpoint: checkpoint.timestamp
+        });
+    }
+    /**
+     * Stop the agent
+     */
+    async stop() {
+        this.isRunning = false;
+        // Clear checkpoint interval
+        if (this.checkpointInterval) {
+            clearInterval(this.checkpointInterval);
+        }
+        // Save final checkpoint
+        this.saveCheckpoint();
+        // Cleanup provider manager
+        this.providerManager.destroy();
+        logger.info('Long-running agent stopped', {
+            agentName: this.config.agentName,
+            runtime: Date.now() - this.startTime.getTime(),
+            completedTasks: this.currentState.completedTasks,
+            failedTasks: this.currentState.failedTasks
+        });
+    }
+}
+//# sourceMappingURL=long-running-agent.js.map

package/dist/agentic-flow/src/core/long-running-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-running-agent.js","sourceRoot":"","sources":["../../../../src/core/long-running-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Long-Running Agent with Provider Fallback\n *\n * Demonstrates how to use ProviderManager for resilient, cost-optimized agents\n * that can run for hours or days with automatic provider switching.\n */\n\nimport { ProviderManager, ProviderConfig, FallbackStrategy } from './provider-manager.js';\nimport { logger } from '../utils/logger.js';\n\nexport interface LongRunningAgentConfig {\n  agentName: string;\n  providers: ProviderConfig[];\n  fallbackStrategy?: FallbackStrategy;\n  checkpointInterval?: number; // Save state every N milliseconds\n  maxRuntime?: number; // Max runtime in milliseconds\n  costBudget?: number; // Max USD to spend\n  performanceTarget?: number; // Target latency in milliseconds\n}\n\nexport interface AgentCheckpoint {\n  timestamp: Date;\n  taskProgress: number; // 0-1\n  currentProvider: string;\n  totalCost: number;\n  totalTokens: number;\n  completedTasks: number;\n  failedTasks: number;\n  state: Record<string, any>;\n}\n\nexport class LongRunningAgent {\n  private providerManager: ProviderManager;\n  private config: LongRunningAgentConfig;\n  private startTime: Date;\n  private checkpoints: AgentCheckpoint[] = [];\n  private currentState: Record<string, any> = {};\n  private isRunning: boolean = false;\n  private checkpointInterval?: NodeJS.Timeout;\n\n  constructor(config: LongRunningAgentConfig) {\n    this.config = config;\n    this.startTime = new Date();\n\n    // Initialize provider manager\n    this.providerManager = new ProviderManager(\n      config.providers,\n      config.fallbackStrategy\n    );\n\n    logger.info('Long-running agent initialized', {\n      agentName: config.agentName,\n      providers: config.providers.map(p => p.name)\n    });\n  }\n\n  /**\n   * Start the agent with automatic checkpointing\n   */\n  public async start(): Promise<void> {\n    this.isRunning = true;\n    this.startTime = new Date();\n\n    // Start checkpoint interval\n    if (this.config.checkpointInterval) {\n      this.checkpointInterval = setInterval(() => {\n        this.saveCheckpoint();\n      }, this.config.checkpointInterval);\n    }\n\n    logger.info('Long-running agent started', {\n      agentName: this.config.agentName,\n      startTime: this.startTime\n    });\n  }\n\n  /**\n   * Execute a task with automatic provider fallback\n   */\n  public async executeTask<T>(\n    task: {\n      name: string;\n      complexity: 'simple' | 'medium' | 'complex';\n      estimatedTokens?: number;\n      execute: (provider: string) => Promise<T>;\n    }\n  ): Promise<T> {\n    if (!this.isRunning) {\n      throw new Error('Agent not running. Call start() first.');\n    }\n\n    // Check budget constraint\n    if (this.config.costBudget) {\n      const currentCost = this.providerManager.getCostSummary().total;\n      if (currentCost >= this.config.costBudget) {\n        throw new Error(`Cost budget exceeded: $${currentCost.toFixed(2)} >= $${this.config.costBudget}`);\n      }\n    }\n\n    // Check runtime constraint\n    if (this.config.maxRuntime) {\n      const runtime = Date.now() - this.startTime.getTime();\n      if (runtime >= this.config.maxRuntime) {\n        throw new Error(`Max runtime exceeded: ${runtime}ms >= ${this.config.maxRuntime}ms`);\n      }\n    }\n\n    logger.info('Executing task', {\n      agentName: this.config.agentName,\n      taskName: task.name,\n      complexity: task.complexity\n    });\n\n    try {\n      // Execute with automatic fallback\n      const { result, provider, attempts } = await this.providerManager.executeWithFallback(\n        task.execute,\n        task.complexity,\n        task.estimatedTokens\n      );\n\n      // Update state\n      this.currentState.lastTask = task.name;\n      this.currentState.lastProvider = provider;\n      this.currentState.completedTasks = (this.currentState.completedTasks || 0) + 1;\n\n      logger.info('Task completed', {\n        agentName: this.config.agentName,\n        taskName: task.name,\n        provider,\n        attempts\n      });\n\n      return result;\n\n    } catch (error) {\n      this.currentState.failedTasks = (this.currentState.failedTasks || 0) + 1;\n\n      logger.error('Task failed', {\n        agentName: this.config.agentName,\n        taskName: task.name,\n        error: (error as Error).message\n      });\n\n      throw error;\n    }\n  }\n\n  /**\n   * Save checkpoint of current state\n   */\n  private saveCheckpoint(): void {\n    const costSummary = this.providerManager.getCostSummary();\n    const health = this.providerManager.getHealth();\n\n    const checkpoint: AgentCheckpoint = {\n      timestamp: new Date(),\n      taskProgress: this.calculateProgress(),\n      currentProvider: this.currentState.lastProvider || 'none',\n      totalCost: costSummary.total,\n      totalTokens: costSummary.totalTokens,\n      completedTasks: this.currentState.completedTasks || 0,\n      failedTasks: this.currentState.failedTasks || 0,\n      state: { ...this.currentState }\n    };\n\n    this.checkpoints.push(checkpoint);\n\n    logger.info('Checkpoint saved', {\n      agentName: this.config.agentName,\n      checkpoint: {\n        ...checkpoint,\n        state: undefined // Don't log full state\n      }\n    });\n\n    // Alert if cost approaching budget\n    if (this.config.costBudget) {\n      const costPercentage = (costSummary.total / this.config.costBudget) * 100;\n      if (costPercentage >= 80) {\n        logger.warn('Cost budget warning', {\n          agentName: this.config.agentName,\n          currentCost: costSummary.total,\n          budget: this.config.costBudget,\n          percentage: costPercentage.toFixed(1) + '%'\n        });\n      }\n    }\n\n    // Alert if providers unhealthy\n    const unhealthyProviders = health.filter(h => !h.isHealthy || h.circuitBreakerOpen);\n    if (unhealthyProviders.length > 0) {\n      logger.warn('Unhealthy providers detected', {\n        agentName: this.config.agentName,\n        unhealthy: unhealthyProviders.map(h => ({\n          provider: h.provider,\n          circuitBreakerOpen: h.circuitBreakerOpen,\n          consecutiveFailures: h.consecutiveFailures\n        }))\n      });\n    }\n  }\n\n  /**\n   * Calculate task progress (override in subclass)\n   */\n  protected calculateProgress(): number {\n    // Default: based on completed vs total tasks\n    const completed = this.currentState.completedTasks || 0;\n    const failed = this.currentState.failedTasks || 0;\n    const total = completed + failed;\n\n    return total > 0 ? completed / total : 0;\n  }\n\n  /**\n   * Get current status\n   */\n  public getStatus(): {\n    isRunning: boolean;\n    runtime: number;\n    completedTasks: number;\n    failedTasks: number;\n    totalCost: number;\n    totalTokens: number;\n    providers: any[];\n    lastCheckpoint?: AgentCheckpoint;\n  } {\n    const costSummary = this.providerManager.getCostSummary();\n    const health = this.providerManager.getHealth();\n    const runtime = Date.now() - this.startTime.getTime();\n\n    return {\n      isRunning: this.isRunning,\n      runtime,\n      completedTasks: this.currentState.completedTasks || 0,\n      failedTasks: this.currentState.failedTasks || 0,\n      totalCost: costSummary.total,\n      totalTokens: costSummary.totalTokens,\n      providers: health.map(h => ({\n        name: h.provider,\n        healthy: h.isHealthy,\n        circuitBreakerOpen: h.circuitBreakerOpen,\n        successRate: (h.successRate * 100).toFixed(1) + '%',\n        avgLatency: h.averageLatency.toFixed(0) + 'ms'\n      })),\n      lastCheckpoint: this.checkpoints[this.checkpoints.length - 1]\n    };\n  }\n\n  /**\n   * Get detailed metrics\n   */\n  public getMetrics() {\n    return {\n      providers: this.providerManager.getMetrics(),\n      health: this.providerManager.getHealth(),\n      costs: this.providerManager.getCostSummary(),\n      checkpoints: this.checkpoints\n    };\n  }\n\n  /**\n   * Restore from checkpoint\n   */\n  public restoreFromCheckpoint(checkpoint: AgentCheckpoint): void {\n    this.currentState = { ...checkpoint.state };\n    logger.info('Restored from checkpoint', {\n      agentName: this.config.agentName,\n      checkpoint: checkpoint.timestamp\n    });\n  }\n\n  /**\n   * Stop the agent\n   */\n  public async stop(): Promise<void> {\n    this.isRunning = false;\n\n    // Clear checkpoint interval\n    if (this.checkpointInterval) {\n      clearInterval(this.checkpointInterval);\n    }\n\n    // Save final checkpoint\n    this.saveCheckpoint();\n\n    // Cleanup provider manager\n    this.providerManager.destroy();\n\n    logger.info('Long-running agent stopped', {\n      agentName: this.config.agentName,\n      runtime: Date.now() - this.startTime.getTime(),\n      completedTasks: this.currentState.completedTasks,\n      failedTasks: this.currentState.failedTasks\n    });\n  }\n}\n"]}

package/dist/agentic-flow/src/core/provider-manager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Provider Manager - Intelligent LLM Provider Fallback & Dynamic Switching
+ *
+ * Features:
+ * - Automatic failover between providers
+ * - Health monitoring and circuit breaking
+ * - Cost-based optimization
+ * - Performance tracking
+ * - Rate limit handling
+ * - Provider quality scoring
+ */
+export type ProviderType = 'anthropic' | 'gemini' | 'openrouter' | 'onnx';
+export interface ProviderConfig {
+    name: ProviderType;
+    apiKey?: string;
+    baseUrl?: string;
+    priority: number;
+    maxRetries: number;
+    timeout: number;
+    costPerToken: number;
+    enabled: boolean;
+    healthCheckInterval?: number;
+}
+export interface ProviderHealth {
+    provider: ProviderType;
+    isHealthy: boolean;
+    lastChecked: Date;
+    consecutiveFailures: number;
+    averageLatency: number;
+    successRate: number;
+    errorRate: number;
+    circuitBreakerOpen: boolean;
+}
+export interface ProviderMetrics {
+    provider: ProviderType;
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    totalTokens: number;
+    totalCost: number;
+    averageLatency: number;
+    lastUsed: Date;
+}
+export interface FallbackStrategy {
+    type: 'priority' | 'cost-optimized' | 'performance-optimized' | 'round-robin';
+    maxFailures: number;
+    recoveryTime: number;
+    retryBackoff: 'linear' | 'exponential';
+    costThreshold?: number;
+    latencyThreshold?: number;
+}
+export declare class ProviderManager {
+    private providers;
+    private health;
+    private metrics;
+    private strategy;
+    private currentProvider;
+    private healthCheckIntervals;
+    constructor(providers: ProviderConfig[], strategy?: FallbackStrategy);
+    /**
+     * Initialize provider configurations
+     */
+    private initializeProviders;
+    /**
+     * Start health check monitoring for all providers
+     */
+    private startHealthChecks;
+    /**
+     * Perform health check on a provider
+     */
+    private performHealthCheck;
+    /**
+     * Select the best provider based on strategy
+     */
+    selectProvider(taskComplexity?: 'simple' | 'medium' | 'complex', estimatedTokens?: number): Promise<ProviderType>;
+    /**
+     * Get list of healthy, available providers
+     */
+    private getAvailableProviders;
+    /**
+     * Select provider by priority
+     */
+    private selectByPriority;
+    /**
+     * Select provider by cost optimization
+     */
+    private selectByCost;
+    /**
+     * Select provider by performance (latency + success rate)
+     */
+    private selectByPerformance;
+    /**
+     * Select provider using round-robin
+     */
+    private selectRoundRobin;
+    /**
+     * Execute request with automatic fallback
+     */
+    executeWithFallback<T>(requestFn: (provider: ProviderType) => Promise<T>, taskComplexity?: 'simple' | 'medium' | 'complex', estimatedTokens?: number): Promise<{
+        result: T;
+        provider: ProviderType;
+        attempts: number;
+    }>;
+    /**
+     * Execute request with retry logic
+     */
+    private executeWithRetry;
+    /**
+     * Calculate backoff delay
+     */
+    private calculateBackoffDelay;
+    /**
+     * Check if error is retryable
+     */
+    private isRetryableError;
+    /**
+     * Record successful request
+     */
+    private recordSuccess;
+    /**
+     * Record failed request
+     */
+    private recordFailure;
+    /**
+     * Get current metrics for all providers
+     */
+    getMetrics(): ProviderMetrics[];
+    /**
+     * Get health status for all providers
+     */
+    getHealth(): ProviderHealth[];
+    /**
+     * Get cost summary
+     */
+    getCostSummary(): {
+        total: number;
+        byProvider: Record<ProviderType, number>;
+        totalTokens: number;
+    };
+    /**
+     * Cleanup and stop health checks
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=provider-manager.d.ts.map

package/dist/agentic-flow/src/core/provider-manager.d.ts.map

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