claude-flow 2.0.0-alpha.65 → 2.0.0-alpha.67

package/dist/providers/utils.js

@@ -0,0 +1,322 @@
+/**
+ * Utility functions for multi-LLM provider system
+ */
+import { ProviderManager } from './provider-manager.js';
+/**
+ * Create a provider manager with default configuration
+ */
+export function createProviderManager(logger, configManager, customConfig) {
+    const defaultConfig = getDefaultProviderConfig();
+    const config = { ...defaultConfig, ...customConfig };
+    // Load provider configs from environment
+    config.providers = loadProviderConfigs(config.providers);
+    return new ProviderManager(logger, configManager, config);
+}
+/**
+ * Get default provider configuration
+ */
+export function getDefaultProviderConfig() {
+    const defaultProvider = process.env.DEFAULT_LLM_PROVIDER || 'anthropic';
+    return {
+        defaultProvider,
+        providers: {
+            anthropic: {
+                provider: 'anthropic',
+                apiKey: process.env.ANTHROPIC_API_KEY,
+                model: 'claude-3-sonnet-20240229',
+                temperature: 0.7,
+                maxTokens: 4096,
+                enableStreaming: true,
+                enableCaching: true,
+                timeout: 60000,
+                retryAttempts: 3,
+            },
+            openai: {
+                provider: 'openai',
+                apiKey: process.env.OPENAI_API_KEY,
+                model: 'gpt-4-turbo-preview',
+                temperature: 0.7,
+                maxTokens: 4096,
+                enableStreaming: true,
+                enableCaching: true,
+                timeout: 60000,
+                retryAttempts: 3,
+            },
+            google: {
+                provider: 'google',
+                apiKey: process.env.GOOGLE_AI_API_KEY,
+                model: 'gemini-pro',
+                temperature: 0.7,
+                maxTokens: 2048,
+                enableStreaming: true,
+                enableCaching: true,
+                timeout: 60000,
+                retryAttempts: 3,
+            },
+            cohere: {
+                provider: 'cohere',
+                apiKey: process.env.COHERE_API_KEY,
+                model: 'command',
+                temperature: 0.7,
+                maxTokens: 4096,
+                enableStreaming: true,
+                enableCaching: true,
+                timeout: 60000,
+                retryAttempts: 3,
+            },
+            ollama: {
+                provider: 'ollama',
+                apiUrl: process.env.OLLAMA_API_URL || 'http://localhost:11434',
+                model: 'llama-2-7b',
+                temperature: 0.7,
+                maxTokens: 2048,
+                enableStreaming: true,
+                enableCaching: false,
+                timeout: 120000, // Longer timeout for local models
+                retryAttempts: 2,
+            },
+        },
+        fallbackStrategy: getDefaultFallbackStrategy(),
+        loadBalancing: {
+            enabled: false,
+            strategy: 'round-robin',
+        },
+        costOptimization: {
+            enabled: true,
+            maxCostPerRequest: 1.0, // $1 max per request
+            preferredProviders: ['anthropic', 'openai'],
+        },
+        caching: {
+            enabled: true,
+            ttl: 3600, // 1 hour
+            maxSize: 100, // 100MB
+            strategy: 'lru',
+        },
+        monitoring: {
+            enabled: true,
+            metricsInterval: 60000, // 1 minute
+        },
+    };
+}
+/**
+ * Get default fallback strategy
+ */
+function getDefaultFallbackStrategy() {
+    return {
+        name: 'default',
+        enabled: true,
+        maxAttempts: 3,
+        rules: [
+            {
+                condition: 'rate_limit',
+                fallbackProviders: ['openai', 'google', 'cohere', 'ollama'],
+                retryOriginal: true,
+                retryDelay: 60000, // 1 minute
+            },
+            {
+                condition: 'unavailable',
+                fallbackProviders: ['openai', 'google', 'anthropic', 'cohere'],
+                retryOriginal: true,
+                retryDelay: 30000, // 30 seconds
+            },
+            {
+                condition: 'timeout',
+                fallbackProviders: ['anthropic', 'openai', 'cohere'],
+                retryOriginal: false,
+            },
+            {
+                condition: 'cost',
+                fallbackProviders: ['ollama', 'cohere', 'google'],
+                retryOriginal: false,
+            },
+            {
+                condition: 'error',
+                errorCodes: ['AUTHENTICATION', 'MODEL_NOT_FOUND'],
+                fallbackProviders: [],
+                retryOriginal: false, // Don't retry auth errors
+            },
+        ],
+    };
+}
+/**
+ * Load provider configurations from environment variables
+ */
+function loadProviderConfigs(configs) {
+    const loaded = { ...configs };
+    // Override with environment variables if present
+    for (const [provider, config] of Object.entries(loaded)) {
+        const envPrefix = `${provider.toUpperCase()}_`;
+        // Check for provider-specific overrides
+        if (process.env[`${envPrefix}MODEL`]) {
+            config.model = process.env[`${envPrefix}MODEL`];
+        }
+        if (process.env[`${envPrefix}TEMPERATURE`]) {
+            config.temperature = parseFloat(process.env[`${envPrefix}TEMPERATURE`]);
+        }
+        if (process.env[`${envPrefix}MAX_TOKENS`]) {
+            config.maxTokens = parseInt(process.env[`${envPrefix}MAX_TOKENS`], 10);
+        }
+        if (process.env[`${envPrefix}API_URL`]) {
+            config.apiUrl = process.env[`${envPrefix}API_URL`];
+        }
+    }
+    return loaded;
+}
+/**
+ * Validate provider configuration
+ */
+export function validateProviderConfig(config) {
+    const errors = [];
+    if (!config.provider) {
+        errors.push('Provider name is required');
+    }
+    if (!config.model) {
+        errors.push('Model is required');
+    }
+    if (config.temperature !== undefined) {
+        if (config.temperature < 0 || config.temperature > 2) {
+            errors.push('Temperature must be between 0 and 2');
+        }
+    }
+    if (config.maxTokens !== undefined) {
+        if (config.maxTokens < 1 || config.maxTokens > 100000) {
+            errors.push('Max tokens must be between 1 and 100000');
+        }
+    }
+    if (config.topP !== undefined) {
+        if (config.topP < 0 || config.topP > 1) {
+            errors.push('Top-p must be between 0 and 1');
+        }
+    }
+    if (config.timeout !== undefined) {
+        if (config.timeout < 1000 || config.timeout > 600000) {
+            errors.push('Timeout must be between 1000ms and 600000ms');
+        }
+    }
+    return errors;
+}
+/**
+ * Get model recommendations based on use case
+ */
+export function getModelRecommendations(useCase) {
+    const recommendations = {
+        'code-generation': [
+            {
+                provider: 'anthropic',
+                model: 'claude-3-opus-20240229',
+                reasoning: 'Best for complex code generation with high accuracy',
+            },
+            {
+                provider: 'openai',
+                model: 'gpt-4-turbo-preview',
+                reasoning: 'Excellent code generation with function calling support',
+            },
+        ],
+        'chat': [
+            {
+                provider: 'anthropic',
+                model: 'claude-3-sonnet-20240229',
+                reasoning: 'Balanced performance for conversational AI',
+            },
+            {
+                provider: 'openai',
+                model: 'gpt-3.5-turbo',
+                reasoning: 'Fast and cost-effective for chat applications',
+            },
+        ],
+        'analysis': [
+            {
+                provider: 'anthropic',
+                model: 'claude-3-opus-20240229',
+                reasoning: 'Excellent for deep analysis and reasoning',
+            },
+            {
+                provider: 'google',
+                model: 'gemini-pro',
+                reasoning: 'Good for data analysis with multimodal support',
+            },
+        ],
+        'local': [
+            {
+                provider: 'ollama',
+                model: 'llama-2-13b',
+                reasoning: 'Good balance of performance and resource usage for local deployment',
+            },
+            {
+                provider: 'ollama',
+                model: 'mistral-7b',
+                reasoning: 'Fast local model with good performance',
+            },
+        ],
+        'budget': [
+            {
+                provider: 'ollama',
+                model: 'llama-2-7b',
+                reasoning: 'Free local model with no API costs',
+            },
+            {
+                provider: 'google',
+                model: 'gemini-pro',
+                reasoning: 'Very cost-effective cloud model',
+            },
+        ],
+    };
+    return recommendations[useCase] || recommendations['chat'];
+}
+/**
+ * Calculate estimated monthly cost based on usage
+ */
+export function estimateMonthlyCost(provider, model, estimatedRequests, avgTokensPerRequest) {
+    // Get pricing from provider capabilities
+    // This is a simplified calculation
+    const pricing = getPricing(provider, model);
+    if (!pricing) {
+        return {
+            promptCost: 0,
+            completionCost: 0,
+            totalCost: 0,
+            currency: 'USD',
+        };
+    }
+    const promptTokens = avgTokensPerRequest * 0.7; // Assume 70% prompt
+    const completionTokens = avgTokensPerRequest * 0.3; // Assume 30% completion
+    const promptCost = (promptTokens * estimatedRequests / 1000) * pricing.promptCostPer1k;
+    const completionCost = (completionTokens * estimatedRequests / 1000) * pricing.completionCostPer1k;
+    return {
+        promptCost,
+        completionCost,
+        totalCost: promptCost + completionCost,
+        currency: pricing.currency,
+    };
+}
+/**
+ * Get pricing for a specific provider and model
+ */
+function getPricing(provider, model) {
+    // This would typically come from provider capabilities
+    // Simplified for example
+    const pricingData = {
+        'anthropic:claude-3-opus-20240229': {
+            promptCostPer1k: 0.015,
+            completionCostPer1k: 0.075,
+            currency: 'USD',
+        },
+        'openai:gpt-4-turbo-preview': {
+            promptCostPer1k: 0.01,
+            completionCostPer1k: 0.03,
+            currency: 'USD',
+        },
+        'google:gemini-pro': {
+            promptCostPer1k: 0.00025,
+            completionCostPer1k: 0.0005,
+            currency: 'USD',
+        },
+        'ollama:llama-2-7b': {
+            promptCostPer1k: 0,
+            completionCostPer1k: 0,
+            currency: 'USD',
+        },
+    };
+    return pricingData[`${provider}:${model}`] || null;
+}
+//# sourceMappingURL=utils.js.map

package/dist/providers/utils.js.map

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

package/dist/services/agentic-flow-hooks/hook-manager.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Agentic Flow Hook Manager
+ *
+ * Central manager for all agentic-flow hooks, providing registration,
+ * execution, and lifecycle management.
+ */
+import { EventEmitter } from 'events';
+import type { AgenticHookContext, AgenticHookType, HookFilter, HookHandlerResult, HookPayload, HookPipeline, HookRegistration, HookRegistry } from './types.js';
+export declare class AgenticHookManager extends EventEmitter implements HookRegistry {
+    private hooks;
+    private pipelines;
+    private metrics;
+    private activeExecutions;
+    constructor();
+    /**
+     * Register a new hook
+     */
+    register(registration: HookRegistration): void;
+    /**
+     * Unregister a hook
+     */
+    unregister(id: string): void;
+    /**
+     * Get hooks by type with optional filtering
+     */
+    getHooks(type: AgenticHookType, filter?: HookFilter): HookRegistration[];
+    /**
+     * Execute hooks for a given type
+     */
+    executeHooks(type: AgenticHookType, payload: HookPayload, context: AgenticHookContext): Promise<HookHandlerResult[]>;
+    /**
+     * Create a new hook pipeline
+     */
+    createPipeline(config: Partial<HookPipeline>): HookPipeline;
+    /**
+     * Execute a pipeline
+     */
+    executePipeline(pipelineId: string, initialPayload: HookPayload, context: AgenticHookContext): Promise<HookHandlerResult[]>;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): Record<string, any>;
+    private validateRegistration;
+    private matchesFilter;
+    private createFilterFromPayload;
+    private executeHook;
+    private retryHook;
+    private processSideEffects;
+    private processSideEffect;
+    private processMemorySideEffect;
+    private processNeuralSideEffect;
+    private processMetricSideEffect;
+    private processNotificationSideEffect;
+    private processLogSideEffect;
+    private handleHookError;
+    private executeStage;
+    private updatePipelineMetrics;
+    private rollbackPipeline;
+    private getTotalHookCount;
+    private initializeMetrics;
+    private updateMetric;
+    private generateExecutionId;
+    private generatePipelineId;
+    private getCachedResult;
+    private cacheResult;
+    private withTimeout;
+    private delay;
+}
+export declare const agenticHookManager: AgenticHookManager;
+//# sourceMappingURL=hook-manager.d.ts.map

package/dist/services/agentic-flow-hooks/hook-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-manager.d.ts","sourceRoot":"","sources":["../../../src/services/agentic-flow-hooks/hook-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,UAAU,EAEV,iBAAiB,EAEjB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EAIb,MAAM,YAAY,CAAC;AAQpB,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,YAAY;IAC1E,OAAO,CAAC,KAAK,CAAuD;IACpE,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,gBAAgB,CAA0B;;IAOlD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAiC9C;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA4B5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,gBAAgB,EAAE;IAUxE;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAoE/B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY;IAoB3D;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,WAAW,EAC3B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA4D/B;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAkBjC,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,uBAAuB;YAuBjB,WAAW;YA4DX,SAAS;YAqBT,kBAAkB;YAclB,iBAAiB;YA2BjB,uBAAuB;YASvB,uBAAuB;IASrC,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,6BAA6B;IAIrC,OAAO,CAAC,oBAAoB;YAKd,eAAe;YAkBf,YAAY;IAiC1B,OAAO,CAAC,qBAAqB;YA2Bf,gBAAgB;IAU9B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;YAUL,WAAW;IAazB,OAAO,CAAC,KAAK;CAGd;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}