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

package/dist/services/agentic-flow-hooks/llm-hooks.js

@@ -0,0 +1,415 @@
+/**
+ * LLM-specific hooks for agentic-flow integration
+ *
+ * Provides pre/post operation hooks for all LLM calls with
+ * memory persistence and performance optimization.
+ */
+import { agenticHookManager } from './hook-manager.js';
+// ===== Pre-LLM Call Hook =====
+export const preLLMCallHook = {
+    id: 'agentic-pre-llm-call',
+    type: 'pre-llm-call',
+    priority: 100,
+    handler: async (payload, context) => {
+        const { provider, model, operation, request } = payload;
+        // Check memory for similar requests
+        const cacheKey = generateCacheKey(provider, model, request);
+        const cached = await checkMemoryCache(cacheKey, context);
+        if (cached) {
+            return {
+                continue: false, // Skip LLM call
+                modified: true,
+                payload: {
+                    ...payload,
+                    response: cached.response,
+                    metrics: {
+                        ...cached.metrics,
+                        cacheHit: true,
+                    },
+                },
+                sideEffects: [
+                    {
+                        type: 'metric',
+                        action: 'increment',
+                        data: { name: 'llm.cache.hits' },
+                    },
+                ],
+            };
+        }
+        // Load provider-specific optimizations
+        const optimizations = await loadProviderOptimizations(provider, context);
+        // Apply request optimizations
+        const optimizedRequest = applyRequestOptimizations(request, optimizations, context);
+        // Track pre-call metrics
+        const sideEffects = [
+            {
+                type: 'metric',
+                action: 'increment',
+                data: { name: `llm.calls.${provider}.${model}` },
+            },
+            {
+                type: 'memory',
+                action: 'store',
+                data: {
+                    key: `llm:request:${context.correlationId}`,
+                    value: {
+                        provider,
+                        model,
+                        operation,
+                        request: optimizedRequest,
+                        timestamp: Date.now(),
+                    },
+                    ttl: 3600, // 1 hour
+                },
+            },
+        ];
+        return {
+            continue: true,
+            modified: true,
+            payload: {
+                ...payload,
+                request: optimizedRequest,
+            },
+            sideEffects,
+        };
+    },
+};
+// ===== Post-LLM Call Hook =====
+export const postLLMCallHook = {
+    id: 'agentic-post-llm-call',
+    type: 'post-llm-call',
+    priority: 100,
+    handler: async (payload, context) => {
+        const { provider, model, request, response, metrics } = payload;
+        if (!response || !metrics) {
+            return { continue: true };
+        }
+        const sideEffects = [];
+        // Store response in memory for caching
+        const cacheKey = generateCacheKey(provider, model, request);
+        sideEffects.push({
+            type: 'memory',
+            action: 'store',
+            data: {
+                key: `llm:cache:${cacheKey}`,
+                value: {
+                    response,
+                    metrics,
+                    timestamp: Date.now(),
+                },
+                ttl: determineCacheTTL(operation, response),
+            },
+        });
+        // Extract patterns for neural training
+        const patterns = extractResponsePatterns(request, response, metrics);
+        if (patterns.length > 0) {
+            sideEffects.push({
+                type: 'neural',
+                action: 'train',
+                data: {
+                    patterns,
+                    modelId: `llm-optimizer-${provider}`,
+                },
+            });
+        }
+        // Update performance metrics
+        sideEffects.push({
+            type: 'metric',
+            action: 'update',
+            data: {
+                name: `llm.latency.${provider}.${model}`,
+                value: metrics.latency,
+            },
+        }, {
+            type: 'metric',
+            action: 'update',
+            data: {
+                name: `llm.tokens.${provider}.${model}`,
+                value: response.usage.totalTokens,
+            },
+        }, {
+            type: 'metric',
+            action: 'update',
+            data: {
+                name: `llm.cost.${provider}.${model}`,
+                value: metrics.costEstimate,
+            },
+        });
+        // Check for performance issues
+        if (metrics.latency > getLatencyThreshold(provider, model)) {
+            sideEffects.push({
+                type: 'notification',
+                action: 'send',
+                data: {
+                    level: 'warning',
+                    message: `High latency detected for ${provider}/${model}: ${metrics.latency}ms`,
+                },
+            });
+        }
+        // Store provider health score
+        await updateProviderHealth(provider, metrics.providerHealth, context);
+        return {
+            continue: true,
+            sideEffects,
+        };
+    },
+};
+// ===== LLM Error Hook =====
+export const llmErrorHook = {
+    id: 'agentic-llm-error',
+    type: 'llm-error',
+    priority: 100,
+    handler: async (payload, context) => {
+        const { provider, model, error } = payload;
+        if (!error) {
+            return { continue: true };
+        }
+        const sideEffects = [];
+        // Log error details
+        sideEffects.push({
+            type: 'log',
+            action: 'write',
+            data: {
+                level: 'error',
+                message: `LLM error from ${provider}/${model}`,
+                data: {
+                    error: error.message,
+                    stack: error.stack,
+                    request: payload.request,
+                },
+            },
+        });
+        // Update error metrics
+        sideEffects.push({
+            type: 'metric',
+            action: 'increment',
+            data: { name: `llm.errors.${provider}.${model}` },
+        });
+        // Check if we should fallback
+        const fallbackProvider = await selectFallbackProvider(provider, model, error, context);
+        if (fallbackProvider) {
+            return {
+                continue: false, // Don't propagate error
+                modified: true,
+                payload: {
+                    ...payload,
+                    provider: fallbackProvider.provider,
+                    model: fallbackProvider.model,
+                    error: undefined, // Clear error for retry
+                },
+                sideEffects: [
+                    ...sideEffects,
+                    {
+                        type: 'notification',
+                        action: 'send',
+                        data: {
+                            level: 'info',
+                            message: `Falling back from ${provider}/${model} to ${fallbackProvider.provider}/${fallbackProvider.model}`,
+                        },
+                    },
+                ],
+            };
+        }
+        return {
+            continue: true,
+            sideEffects,
+        };
+    },
+};
+// ===== LLM Retry Hook =====
+export const llmRetryHook = {
+    id: 'agentic-llm-retry',
+    type: 'llm-retry',
+    priority: 90,
+    handler: async (payload, context) => {
+        const { provider, model, metrics } = payload;
+        const retryCount = metrics?.retryCount || 0;
+        // Adjust request parameters for retry
+        const adjustedRequest = adjustRequestForRetry(payload.request, retryCount);
+        const sideEffects = [
+            {
+                type: 'metric',
+                action: 'increment',
+                data: { name: `llm.retries.${provider}.${model}` },
+            },
+        ];
+        // Apply exponential backoff
+        const backoffMs = Math.min(1000 * Math.pow(2, retryCount), 10000);
+        await new Promise(resolve => setTimeout(resolve, backoffMs));
+        return {
+            continue: true,
+            modified: true,
+            payload: {
+                ...payload,
+                request: adjustedRequest,
+                metrics: {
+                    ...metrics,
+                    retryCount: retryCount + 1,
+                },
+            },
+            sideEffects,
+        };
+    },
+};
+// ===== Helper Functions =====
+function generateCacheKey(provider, model, request) {
+    const normalized = {
+        provider,
+        model,
+        messages: request.messages?.map(m => ({
+            role: m.role,
+            content: m.content.substring(0, 100), // First 100 chars
+        })),
+        temperature: request.temperature,
+        maxTokens: request.maxTokens,
+    };
+    return Buffer.from(JSON.stringify(normalized)).toString('base64');
+}
+async function checkMemoryCache(cacheKey, context) {
+    // Implementation would integrate with memory service
+    // This is a placeholder
+    return null;
+}
+async function loadProviderOptimizations(provider, context) {
+    // Load provider-specific optimizations from memory
+    // This is a placeholder
+    return {
+        maxRetries: 3,
+        timeout: 30000,
+        rateLimit: 100,
+    };
+}
+function applyRequestOptimizations(request, optimizations, context) {
+    // Apply various optimizations
+    const optimized = { ...request };
+    // Optimize token usage
+    if (optimized.maxTokens && optimized.maxTokens > 4000) {
+        optimized.maxTokens = 4000; // Cap at reasonable limit
+    }
+    // Optimize temperature for consistency
+    if (optimized.temperature === undefined) {
+        optimized.temperature = 0.7;
+    }
+    // Add stop sequences if missing
+    if (!optimized.stopSequences && optimized.messages) {
+        optimized.stopSequences = ['\n\nHuman:', '\n\nAssistant:'];
+    }
+    return optimized;
+}
+function determineCacheTTL(operation, response) {
+    // Determine cache TTL based on operation and response
+    switch (operation) {
+        case 'embedding':
+            return 86400; // 24 hours for embeddings
+        case 'completion':
+            // Shorter TTL for completions
+            return response?.usage?.totalTokens && response.usage.totalTokens > 1000
+                ? 1800 // 30 minutes for long responses
+                : 3600; // 1 hour for short responses
+        default:
+            return 3600; // 1 hour default
+    }
+}
+function extractResponsePatterns(request, response, metrics) {
+    const patterns = [];
+    // Extract performance patterns
+    if (metrics.latency > 1000) {
+        patterns.push({
+            id: `perf_${Date.now()}`,
+            type: 'optimization',
+            confidence: 0.8,
+            occurrences: 1,
+            context: {
+                provider: metrics.providerHealth < 0.8 ? 'unhealthy' : 'healthy',
+                requestSize: JSON.stringify(request).length,
+                responseTokens: response?.usage?.totalTokens || 0,
+                latency: metrics.latency,
+            },
+        });
+    }
+    // Extract success patterns
+    if (response?.choices?.[0]?.finishReason === 'stop') {
+        patterns.push({
+            id: `success_${Date.now()}`,
+            type: 'success',
+            confidence: 0.9,
+            occurrences: 1,
+            context: {
+                temperature: request.temperature,
+                maxTokens: request.maxTokens,
+                actualTokens: response.usage?.totalTokens || 0,
+            },
+        });
+    }
+    return patterns;
+}
+function getLatencyThreshold(provider, model) {
+    // Provider/model specific thresholds
+    const thresholds = {
+        'openai:gpt-4': 5000,
+        'openai:gpt-3.5-turbo': 2000,
+        'anthropic:claude-3': 4000,
+        'anthropic:claude-instant': 1500,
+    };
+    return thresholds[`${provider}:${model}`] || 3000;
+}
+async function updateProviderHealth(provider, health, context) {
+    // Update provider health in memory
+    const healthKey = `provider:health:${provider}`;
+    const currentHealth = await context.memory.cache.get(healthKey) || [];
+    currentHealth.push({
+        timestamp: Date.now(),
+        health,
+    });
+    // Keep last 100 health checks
+    if (currentHealth.length > 100) {
+        currentHealth.shift();
+    }
+    await context.memory.cache.set(healthKey, currentHealth);
+}
+async function selectFallbackProvider(provider, model, error, context) {
+    // Implement intelligent fallback selection
+    const fallbacks = {
+        'openai': [
+            { provider: 'anthropic', model: 'claude-3' },
+            { provider: 'cohere', model: 'command' },
+        ],
+        'anthropic': [
+            { provider: 'openai', model: 'gpt-4' },
+            { provider: 'cohere', model: 'command' },
+        ],
+    };
+    const candidates = fallbacks[provider] || [];
+    // Select based on health scores
+    for (const candidate of candidates) {
+        const healthKey = `provider:health:${candidate.provider}`;
+        const healthData = await context.memory.cache.get(healthKey) || [];
+        if (healthData.length > 0) {
+            const avgHealth = healthData.reduce((sum, h) => sum + h.health, 0) / healthData.length;
+            if (avgHealth > 0.7) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+function adjustRequestForRetry(request, retryCount) {
+    const adjusted = { ...request };
+    // Increase temperature slightly for variety
+    if (adjusted.temperature !== undefined) {
+        adjusted.temperature = Math.min(adjusted.temperature + (0.1 * retryCount), 1.0);
+    }
+    // Reduce max tokens to improve success rate
+    if (adjusted.maxTokens !== undefined) {
+        adjusted.maxTokens = Math.floor(adjusted.maxTokens * Math.pow(0.9, retryCount));
+    }
+    return adjusted;
+}
+// ===== Register Hooks =====
+export function registerLLMHooks() {
+    agenticHookManager.register(preLLMCallHook);
+    agenticHookManager.register(postLLMCallHook);
+    agenticHookManager.register(llmErrorHook);
+    agenticHookManager.register(llmRetryHook);
+}
+//# sourceMappingURL=llm-hooks.js.map

package/dist/services/agentic-flow-hooks/llm-hooks.js.map

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

package/dist/services/agentic-flow-hooks/memory-hooks.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Memory persistence hooks for agentic-flow
+ *
+ * Provides cross-provider memory state management with
+ * synchronization and persistence capabilities.
+ */
+import type { AgenticHookContext, HookHandlerResult, MemoryHookPayload } from './types.js';
+export declare const preMemoryStoreHook: {
+    id: string;
+    type: "pre-memory-store";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare const postMemoryStoreHook: {
+    id: string;
+    type: "post-memory-store";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare const preMemoryRetrieveHook: {
+    id: string;
+    type: "pre-memory-retrieve";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare const postMemoryRetrieveHook: {
+    id: string;
+    type: "post-memory-retrieve";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare const memorySyncHook: {
+    id: string;
+    type: "memory-sync";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare const memoryPersistHook: {
+    id: string;
+    type: "memory-persist";
+    priority: number;
+    handler: (payload: MemoryHookPayload, context: AgenticHookContext) => Promise<HookHandlerResult>;
+};
+export declare function registerMemoryHooks(): void;
+//# sourceMappingURL=memory-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-hooks.d.ts","sourceRoot":"","sources":["../../../src/services/agentic-flow-hooks/memory-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,kBAAkB;;;;uBAKlB,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CAmE9B,CAAC;AAIF,eAAO,MAAM,mBAAmB;;;;uBAKnB,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CAqD9B,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;uBAKrB,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CAyC9B,CAAC;AAIF,eAAO,MAAM,sBAAsB;;;;uBAKtB,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CA+C9B,CAAC;AAIF,eAAO,MAAM,cAAc;;;;uBAKd,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CAuF9B,CAAC;AAIF,eAAO,MAAM,iBAAiB;;;;uBAKjB,iBAAiB,WACjB,kBAAkB,KAC1B,OAAO,CAAC,iBAAiB,CAAC;CA2C9B,CAAC;AA6RF,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}