agentic-flow 3.0.0-alpha.2 → 3.0.0

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

@@ -1,220 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,145 +0,0 @@
-/**
- * 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

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