agentic-flow 2.0.1 → 2.0.2-alpha

package/agentic-flow/dist/proxy/quic-proxy.js

@@ -0,0 +1,228 @@
+// QUIC-enabled Proxy for Anthropic API
+// Optional QUIC transport with automatic HTTP/2 fallback
+import { QuicClient, QuicConnectionPool } from '../transport/quic.js';
+import { logger } from '../utils/logger.js';
+import { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';
+export class QuicEnabledProxy extends AnthropicToOpenRouterProxy {
+    quicClient;
+    quicPool;
+    transport;
+    quicEnabled;
+    fallbackToHttp2;
+    constructor(config) {
+        super({
+            openrouterApiKey: config.openrouterApiKey,
+            openrouterBaseUrl: config.openrouterBaseUrl,
+            defaultModel: config.defaultModel
+        });
+        this.transport = config.transport || 'auto';
+        this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();
+        this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;
+        if (this.quicEnabled) {
+            this.initializeQuic(config.quic || {});
+        }
+    }
+    /**
+     * Check if QUIC is enabled via environment variable
+     */
+    checkQuicFeatureFlag() {
+        const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;
+        return flag === 'true' || flag === '1';
+    }
+    /**
+     * Initialize QUIC client and connection pool
+     */
+    async initializeQuic(quicConfig) {
+        try {
+            logger.info('Initializing QUIC transport...', { config: quicConfig });
+            this.quicClient = new QuicClient(quicConfig);
+            await this.quicClient.initialize();
+            this.quicPool = new QuicConnectionPool(this.quicClient, 20);
+            logger.info('QUIC transport initialized successfully');
+        }
+        catch (error) {
+            logger.error('Failed to initialize QUIC transport', { error });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 transport');
+                this.quicEnabled = false;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Select transport protocol based on configuration and availability
+     */
+    selectTransport() {
+        if (this.transport === 'quic' && this.quicEnabled) {
+            return 'quic';
+        }
+        if (this.transport === 'http2') {
+            return 'http2';
+        }
+        // Auto mode: prefer QUIC if available, fallback to HTTP/2
+        if (this.transport === 'auto') {
+            return this.quicEnabled ? 'quic' : 'http2';
+        }
+        return 'http2';
+    }
+    /**
+     * Send request using selected transport
+     */
+    async sendRequest(url, options) {
+        const selectedTransport = this.selectTransport();
+        logger.debug('Sending request', {
+            transport: selectedTransport,
+            url,
+            method: options.method
+        });
+        if (selectedTransport === 'quic') {
+            return this.sendQuicRequest(url, options);
+        }
+        else {
+            return this.sendHttp2Request(url, options);
+        }
+    }
+    /**
+     * Send request over QUIC
+     */
+    async sendQuicRequest(url, options) {
+        if (!this.quicClient || !this.quicPool) {
+            throw new Error('QUIC client not initialized');
+        }
+        try {
+            const urlObj = new URL(url);
+            const connection = await this.quicPool.getConnection(urlObj.hostname, parseInt(urlObj.port) || 443);
+            logger.debug('Using QUIC connection', {
+                connectionId: connection.id,
+                url
+            });
+            // Prepare headers
+            const headers = {};
+            if (options.headers) {
+                const headerEntries = options.headers instanceof Headers
+                    ? Array.from(options.headers.entries())
+                    : Object.entries(options.headers);
+                for (const [key, value] of headerEntries) {
+                    headers[key] = value;
+                }
+            }
+            // Convert body to Uint8Array
+            let body;
+            if (options.body) {
+                if (typeof options.body === 'string') {
+                    body = new TextEncoder().encode(options.body);
+                }
+                else if (options.body instanceof Uint8Array) {
+                    body = options.body;
+                }
+                else {
+                    body = new TextEncoder().encode(JSON.stringify(options.body));
+                }
+            }
+            // Send HTTP/3 request over QUIC
+            const response = await this.quicClient.sendRequest(connection.id, options.method || 'GET', urlObj.pathname + urlObj.search, headers, body);
+            logger.info('QUIC request completed', {
+                status: response.status,
+                bytes: response.body.length
+            });
+            // Convert to fetch Response
+            const responseText = new TextDecoder().decode(response.body);
+            return new Response(responseText, {
+                status: response.status,
+                headers: new Headers(response.headers)
+            });
+        }
+        catch (error) {
+            logger.error('QUIC request failed', { error, url });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 for this request');
+                return this.sendHttp2Request(url, options);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Send request over HTTP/2 (standard fetch)
+     */
+    async sendHttp2Request(url, options) {
+        logger.debug('Using HTTP/2 transport', { url });
+        return fetch(url, options);
+    }
+    /**
+     * Get transport statistics
+     */
+    getTransportStats() {
+        if (this.quicClient) {
+            return {
+                transport: this.selectTransport(),
+                quicEnabled: this.quicEnabled,
+                quicStats: this.quicClient.getStats()
+            };
+        }
+        return {
+            transport: 'http2',
+            quicEnabled: false
+        };
+    }
+    /**
+     * Shutdown and cleanup
+     */
+    async shutdown() {
+        if (this.quicPool) {
+            await this.quicPool.clear();
+        }
+        if (this.quicClient) {
+            await this.quicClient.shutdown();
+        }
+        logger.info('QUIC proxy shutdown complete');
+    }
+}
+/**
+ * Create QUIC-enabled proxy with configuration
+ */
+export function createQuicProxy(config) {
+    const proxy = new QuicEnabledProxy(config);
+    logger.info('QUIC proxy created', {
+        transport: config.transport || 'auto',
+        quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),
+        fallbackEnabled: config.fallbackToHttp2 ?? true
+    });
+    return proxy;
+}
+// CLI entry point for QUIC proxy
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const port = parseInt(process.env.PORT || '3000');
+    const openrouterApiKey = process.env.OPENROUTER_API_KEY;
+    if (!openrouterApiKey) {
+        console.error('❌ Error: OPENROUTER_API_KEY environment variable required');
+        process.exit(1);
+    }
+    const proxy = createQuicProxy({
+        openrouterApiKey,
+        openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,
+        defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,
+        transport: process.env.TRANSPORT || 'auto',
+        enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',
+        quic: {
+            port: parseInt(process.env.QUIC_PORT || '4433'),
+            serverHost: process.env.QUIC_HOST || 'localhost',
+            certPath: process.env.QUIC_CERT_PATH,
+            keyPath: process.env.QUIC_KEY_PATH
+        }
+    });
+    proxy.start(port);
+    // Graceful shutdown
+    process.on('SIGTERM', async () => {
+        logger.info('Received SIGTERM, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+    process.on('SIGINT', async () => {
+        logger.info('Received SIGINT, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=quic-proxy.js.map

package/agentic-flow/dist/proxy/quic-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quic-proxy.js","sourceRoot":"","sources":["../../src/proxy/quic-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["// QUIC-enabled Proxy for Anthropic API\n// Optional QUIC transport with automatic HTTP/2 fallback\n\nimport express, { Request, Response, NextFunction } from 'express';\nimport { QuicClient, QuicConnectionPool, QuicConfig } from '../transport/quic.js';\nimport { logger } from '../utils/logger.js';\nimport { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';\n\nexport interface QuicProxyConfig {\n  // Base proxy config\n  openrouterApiKey: string;\n  openrouterBaseUrl?: string;\n  defaultModel?: string;\n\n  // Transport selection\n  transport?: 'quic' | 'http2' | 'auto';\n  enableQuic?: boolean;\n\n  // QUIC configuration\n  quic?: QuicConfig;\n\n  // Fallback behavior\n  fallbackToHttp2?: boolean;\n  fallbackTimeout?: number;\n}\n\nexport class QuicEnabledProxy extends AnthropicToOpenRouterProxy {\n  private quicClient?: QuicClient;\n  private quicPool?: QuicConnectionPool;\n  private transport: 'quic' | 'http2' | 'auto';\n  private quicEnabled: boolean;\n  private fallbackToHttp2: boolean;\n\n  constructor(config: QuicProxyConfig) {\n    super({\n      openrouterApiKey: config.openrouterApiKey,\n      openrouterBaseUrl: config.openrouterBaseUrl,\n      defaultModel: config.defaultModel\n    });\n\n    this.transport = config.transport || 'auto';\n    this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();\n    this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;\n\n    if (this.quicEnabled) {\n      this.initializeQuic(config.quic || {});\n    }\n  }\n\n  /**\n   * Check if QUIC is enabled via environment variable\n   */\n  private checkQuicFeatureFlag(): boolean {\n    const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;\n    return flag === 'true' || flag === '1';\n  }\n\n  /**\n   * Initialize QUIC client and connection pool\n   */\n  private async initializeQuic(quicConfig: QuicConfig): Promise<void> {\n    try {\n      logger.info('Initializing QUIC transport...', { config: quicConfig });\n\n      this.quicClient = new QuicClient(quicConfig);\n      await this.quicClient.initialize();\n\n      this.quicPool = new QuicConnectionPool(this.quicClient, 20);\n\n      logger.info('QUIC transport initialized successfully');\n    } catch (error) {\n      logger.error('Failed to initialize QUIC transport', { error });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 transport');\n        this.quicEnabled = false;\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Select transport protocol based on configuration and availability\n   */\n  private selectTransport(): 'quic' | 'http2' {\n    if (this.transport === 'quic' && this.quicEnabled) {\n      return 'quic';\n    }\n\n    if (this.transport === 'http2') {\n      return 'http2';\n    }\n\n    // Auto mode: prefer QUIC if available, fallback to HTTP/2\n    if (this.transport === 'auto') {\n      return this.quicEnabled ? 'quic' : 'http2';\n    }\n\n    return 'http2';\n  }\n\n  /**\n   * Send request using selected transport\n   */\n  protected async sendRequest(url: string, options: RequestInit): Promise<Response> {\n    const selectedTransport = this.selectTransport();\n\n    logger.debug('Sending request', {\n      transport: selectedTransport,\n      url,\n      method: options.method\n    });\n\n    if (selectedTransport === 'quic') {\n      return this.sendQuicRequest(url, options);\n    } else {\n      return this.sendHttp2Request(url, options);\n    }\n  }\n\n  /**\n   * Send request over QUIC\n   */\n  private async sendQuicRequest(url: string, options: RequestInit): Promise<Response> {\n    if (!this.quicClient || !this.quicPool) {\n      throw new Error('QUIC client not initialized');\n    }\n\n    try {\n      const urlObj = new URL(url);\n      const connection = await this.quicPool.getConnection(\n        urlObj.hostname,\n        parseInt(urlObj.port) || 443\n      );\n\n      logger.debug('Using QUIC connection', {\n        connectionId: connection.id,\n        url\n      });\n\n      // Prepare headers\n      const headers: Record<string, string> = {};\n      if (options.headers) {\n        const headerEntries = options.headers instanceof Headers\n          ? Array.from(options.headers.entries())\n          : Object.entries(options.headers);\n\n        for (const [key, value] of headerEntries) {\n          headers[key] = value;\n        }\n      }\n\n      // Convert body to Uint8Array\n      let body: Uint8Array | undefined;\n      if (options.body) {\n        if (typeof options.body === 'string') {\n          body = new TextEncoder().encode(options.body);\n        } else if (options.body instanceof Uint8Array) {\n          body = options.body;\n        } else {\n          body = new TextEncoder().encode(JSON.stringify(options.body));\n        }\n      }\n\n      // Send HTTP/3 request over QUIC\n      const response = await this.quicClient.sendRequest(\n        connection.id,\n        options.method || 'GET',\n        urlObj.pathname + urlObj.search,\n        headers,\n        body\n      );\n\n      logger.info('QUIC request completed', {\n        status: response.status,\n        bytes: response.body.length\n      });\n\n      // Convert to fetch Response\n      const responseText = new TextDecoder().decode(response.body);\n      return new Response(responseText, {\n        status: response.status,\n        headers: new Headers(response.headers)\n      }) as any;\n\n    } catch (error) {\n      logger.error('QUIC request failed', { error, url });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 for this request');\n        return this.sendHttp2Request(url, options);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Send request over HTTP/2 (standard fetch)\n   */\n  private async sendHttp2Request(url: string, options: RequestInit): Promise<Response> {\n    logger.debug('Using HTTP/2 transport', { url });\n    return fetch(url, options) as any;\n  }\n\n  /**\n   * Get transport statistics\n   */\n  getTransportStats(): any {\n    if (this.quicClient) {\n      return {\n        transport: this.selectTransport(),\n        quicEnabled: this.quicEnabled,\n        quicStats: this.quicClient.getStats()\n      };\n    }\n\n    return {\n      transport: 'http2',\n      quicEnabled: false\n    };\n  }\n\n  /**\n   * Shutdown and cleanup\n   */\n  async shutdown(): Promise<void> {\n    if (this.quicPool) {\n      await this.quicPool.clear();\n    }\n\n    if (this.quicClient) {\n      await this.quicClient.shutdown();\n    }\n\n    logger.info('QUIC proxy shutdown complete');\n  }\n}\n\n/**\n * Create QUIC-enabled proxy with configuration\n */\nexport function createQuicProxy(config: QuicProxyConfig): QuicEnabledProxy {\n  const proxy = new QuicEnabledProxy(config);\n\n  logger.info('QUIC proxy created', {\n    transport: config.transport || 'auto',\n    quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),\n    fallbackEnabled: config.fallbackToHttp2 ?? true\n  });\n\n  return proxy;\n}\n\n// CLI entry point for QUIC proxy\nif (import.meta.url === `file://${process.argv[1]}`) {\n  const port = parseInt(process.env.PORT || '3000');\n  const openrouterApiKey = process.env.OPENROUTER_API_KEY;\n\n  if (!openrouterApiKey) {\n    console.error('❌ Error: OPENROUTER_API_KEY environment variable required');\n    process.exit(1);\n  }\n\n  const proxy = createQuicProxy({\n    openrouterApiKey,\n    openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,\n    defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,\n    transport: (process.env.TRANSPORT as 'quic' | 'http2' | 'auto') || 'auto',\n    enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',\n    quic: {\n      port: parseInt(process.env.QUIC_PORT || '4433'),\n      serverHost: process.env.QUIC_HOST || 'localhost',\n      certPath: process.env.QUIC_CERT_PATH,\n      keyPath: process.env.QUIC_KEY_PATH\n    }\n  });\n\n  proxy.start(port);\n\n  // Graceful shutdown\n  process.on('SIGTERM', async () => {\n    logger.info('Received SIGTERM, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n\n  process.on('SIGINT', async () => {\n    logger.info('Received SIGINT, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n}\n"]}

package/agentic-flow/dist/reasoningbank/AdvancedMemory.js

@@ -0,0 +1,240 @@
+/**
+ * Advanced Memory System - Full Implementation for v1.7.1
+ *
+ * Provides high-level memory operations on top of HybridReasoningBank:
+ * - Auto-consolidation (patterns → skills) using NightlyLearner
+ * - Episodic replay (learn from failures)
+ * - Causal reasoning (what-if analysis)
+ * - Skill composition (combine learned skills)
+ *
+ * @example
+ * ```typescript
+ * import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';
+ *
+ * const memory = new AdvancedMemorySystem();
+ *
+ * // Auto-consolidate patterns into skills
+ * const result = await memory.autoConsolidate({ minUses: 3, minSuccessRate: 0.7 });
+ *
+ * // Learn from failures
+ * const failures = await memory.replayFailures('authentication', 5);
+ *
+ * // Causal what-if analysis
+ * const insight = await memory.whatIfAnalysis('add caching');
+ * ```
+ */
+import { HybridReasoningBank } from './HybridBackend.js';
+import { NightlyLearner } from 'agentdb/controllers/NightlyLearner';
+import { SharedMemoryPool } from '../memory/SharedMemoryPool.js';
+export class AdvancedMemorySystem {
+    reasoning;
+    learner;
+    pool;
+    constructor(options = {}) {
+        this.reasoning = new HybridReasoningBank(options);
+        this.pool = SharedMemoryPool.getInstance();
+        const db = this.pool.getDatabase();
+        const embedder = this.pool.getEmbedder();
+        // Initialize NightlyLearner with optimized config
+        this.learner = new NightlyLearner(db, embedder, {
+            minSimilarity: 0.7,
+            minSampleSize: 5,
+            confidenceThreshold: 0.6,
+            upliftThreshold: 0.1,
+            pruneOldEdges: true,
+            edgeMaxAgeDays: 90,
+            autoExperiments: true,
+            experimentBudget: 100
+        });
+    }
+    /**
+     * Auto-consolidate successful patterns into skills
+     *
+     * Uses NightlyLearner to:
+     * 1. Discover causal edges from episode patterns
+     * 2. Complete A/B experiments
+     * 3. Calculate uplift for experiments
+     * 4. Prune low-confidence edges
+     * 5. Consolidate high-performing patterns into skills
+     */
+    async autoConsolidate(options = {}) {
+        const startTime = Date.now();
+        try {
+            // Run NightlyLearner's discovery and consolidation pipeline
+            const report = await this.learner.run();
+            // Also run skill consolidation from HybridReasoningBank
+            const skillResult = await this.reasoning.autoConsolidate(options.minUses || 3, options.minSuccessRate || 0.7, options.lookbackDays || 30);
+            return {
+                skillsCreated: skillResult.skillsCreated + (report.edgesDiscovered || 0),
+                causalEdgesCreated: report.edgesDiscovered || 0,
+                patternsAnalyzed: report.experimentsCompleted || 0,
+                executionTimeMs: Date.now() - startTime,
+                recommendations: report.recommendations || []
+            };
+        }
+        catch (error) {
+            console.error('[AdvancedMemorySystem] Auto-consolidation failed:', error);
+            // Fallback to basic consolidation
+            const skillResult = await this.reasoning.autoConsolidate(options.minUses || 3, options.minSuccessRate || 0.7, options.lookbackDays || 30);
+            return {
+                skillsCreated: skillResult.skillsCreated,
+                causalEdgesCreated: 0,
+                patternsAnalyzed: 0,
+                executionTimeMs: Date.now() - startTime,
+                recommendations: ['Causal discovery unavailable - basic consolidation completed']
+            };
+        }
+    }
+    /**
+     * Learn from past failures with episodic replay
+     *
+     * Retrieves failed attempts, extracts lessons, and provides recommendations
+     */
+    async replayFailures(task, k = 5) {
+        const failures = await this.reasoning.retrievePatterns(task, {
+            k,
+            onlyFailures: true
+        });
+        return failures.map(f => ({
+            critique: f.critique || this.extractCritique(f),
+            whatWentWrong: this.analyzeFailure(f),
+            howToFix: this.generateFixes(f),
+            similarFailures: failures.length
+        }));
+    }
+    /**
+     * Extract critique from failure pattern
+     */
+    extractCritique(failure) {
+        if (failure.critique)
+            return failure.critique;
+        if (failure.task)
+            return `Failed at: ${failure.task}`;
+        return 'No critique available';
+    }
+    /**
+     * Analyze what went wrong in a failure
+     */
+    analyzeFailure(failure) {
+        const issues = [];
+        if (failure.reward !== undefined && failure.reward < 0.3) {
+            issues.push('Low success rate observed');
+        }
+        if (failure.latencyMs && failure.latencyMs > 5000) {
+            issues.push('High latency detected');
+        }
+        if (failure.task) {
+            issues.push(`Task type: ${failure.task}`);
+        }
+        if (issues.length === 0) {
+            issues.push('General failure - review approach');
+        }
+        return issues;
+    }
+    /**
+     * Generate fix recommendations
+     */
+    generateFixes(failure) {
+        const fixes = [];
+        // Look for successful patterns with similar tasks
+        fixes.push('Review similar successful patterns');
+        if (failure.latencyMs && failure.latencyMs > 5000) {
+            fixes.push('Optimize for lower latency');
+        }
+        if (failure.reward !== undefined && failure.reward < 0.3) {
+            fixes.push('Consider alternative approach');
+        }
+        fixes.push('Add more validation and error handling');
+        return fixes;
+    }
+    /**
+     * What-if causal analysis
+     *
+     * Analyzes potential outcomes of taking an action based on causal evidence
+     */
+    async whatIfAnalysis(action) {
+        const causalInsight = await this.reasoning.whatIfAnalysis(action);
+        // Generate impact description
+        let expectedImpact = '';
+        if (causalInsight.avgUplift > 0.2) {
+            expectedImpact = `Highly beneficial: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;
+        }
+        else if (causalInsight.avgUplift > 0.1) {
+            expectedImpact = `Beneficial: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;
+        }
+        else if (causalInsight.avgUplift > 0) {
+            expectedImpact = `Slightly positive: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;
+        }
+        else if (causalInsight.avgUplift < -0.1) {
+            expectedImpact = `Harmful: Expected ${(causalInsight.avgUplift * 100).toFixed(1)}% degradation`;
+        }
+        else {
+            expectedImpact = 'Neutral or insufficient evidence';
+        }
+        return {
+            ...causalInsight,
+            expectedImpact
+        };
+    }
+    /**
+     * Compose multiple skills for a complex task
+     *
+     * Finds relevant skills and creates an execution plan
+     */
+    async composeSkills(task, k = 5) {
+        const skills = await this.reasoning.searchSkills(task, k);
+        // Sort by success rate and usage
+        const sortedSkills = skills.sort((a, b) => {
+            const scoreA = (a.successRate || 0) * 0.7 + (Math.log(a.uses || 1) / 10) * 0.3;
+            const scoreB = (b.successRate || 0) * 0.7 + (Math.log(b.uses || 1) / 10) * 0.3;
+            return scoreB - scoreA;
+        });
+        // Create composition plan
+        let compositionPlan = '';
+        if (sortedSkills.length === 0) {
+            compositionPlan = 'No relevant skills found';
+        }
+        else if (sortedSkills.length === 1) {
+            compositionPlan = sortedSkills[0].name;
+        }
+        else {
+            compositionPlan = sortedSkills.slice(0, 3).map(s => s.name).join(' → ');
+        }
+        // Calculate expected success rate (weighted average)
+        let expectedSuccessRate = 0;
+        if (sortedSkills.length > 0) {
+            const weights = sortedSkills.map(s => s.uses || 1);
+            const totalWeight = weights.reduce((sum, w) => sum + w, 0);
+            expectedSuccessRate = sortedSkills.reduce((sum, s, i) => sum + (s.successRate || 0) * weights[i] / totalWeight, 0);
+        }
+        return {
+            availableSkills: sortedSkills,
+            compositionPlan,
+            expectedSuccessRate
+        };
+    }
+    /**
+     * Run automated learning cycle
+     *
+     * Discovers causal edges, consolidates skills, and optimizes performance
+     */
+    async runLearningCycle() {
+        return this.autoConsolidate({
+            minUses: 3,
+            minSuccessRate: 0.7,
+            lookbackDays: 30,
+            dryRun: false
+        });
+    }
+    /**
+     * Get comprehensive memory statistics
+     */
+    getStats() {
+        return {
+            reasoningBank: this.reasoning.getStats(),
+            learner: 'NightlyLearner configured with auto-experiments',
+            memoryPool: this.pool.getStats()
+        };
+    }
+}
+//# sourceMappingURL=AdvancedMemory.js.map

package/agentic-flow/dist/reasoningbank/AdvancedMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedMemory.js","sourceRoot":"","sources":["../../src/reasoningbank/AdvancedMemory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Advanced Memory System - Full Implementation for v1.7.1\n *\n * Provides high-level memory operations on top of HybridReasoningBank:\n * - Auto-consolidation (patterns → skills) using NightlyLearner\n * - Episodic replay (learn from failures)\n * - Causal reasoning (what-if analysis)\n * - Skill composition (combine learned skills)\n *\n * @example\n * ```typescript\n * import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';\n *\n * const memory = new AdvancedMemorySystem();\n *\n * // Auto-consolidate patterns into skills\n * const result = await memory.autoConsolidate({ minUses: 3, minSuccessRate: 0.7 });\n *\n * // Learn from failures\n * const failures = await memory.replayFailures('authentication', 5);\n *\n * // Causal what-if analysis\n * const insight = await memory.whatIfAnalysis('add caching');\n * ```\n */\n\nimport { HybridReasoningBank } from './HybridBackend.js';\nimport { NightlyLearner } from 'agentdb/controllers/NightlyLearner';\nimport { SharedMemoryPool } from '../memory/SharedMemoryPool.js';\n\nexport interface FailureAnalysis {\n  critique: string;\n  whatWentWrong: string[];\n  howToFix: string[];\n  similarFailures: number;\n}\n\nexport interface SkillComposition {\n  availableSkills: any[];\n  compositionPlan: string;\n  expectedSuccessRate: number;\n}\n\nexport interface ConsolidationResult {\n  skillsCreated: number;\n  causalEdgesCreated: number;\n  patternsAnalyzed: number;\n  executionTimeMs: number;\n  recommendations: string[];\n}\n\nexport class AdvancedMemorySystem {\n  private reasoning: HybridReasoningBank;\n  private learner: NightlyLearner;\n  private pool: SharedMemoryPool;\n\n  constructor(options: { preferWasm?: boolean } = {}) {\n    this.reasoning = new HybridReasoningBank(options);\n    this.pool = SharedMemoryPool.getInstance();\n\n    const db = this.pool.getDatabase();\n    const embedder = this.pool.getEmbedder();\n\n    // Initialize NightlyLearner with optimized config\n    this.learner = new NightlyLearner(db, embedder, {\n      minSimilarity: 0.7,\n      minSampleSize: 5,\n      confidenceThreshold: 0.6,\n      upliftThreshold: 0.1,\n      pruneOldEdges: true,\n      edgeMaxAgeDays: 90,\n      autoExperiments: true,\n      experimentBudget: 100\n    });\n  }\n\n  /**\n   * Auto-consolidate successful patterns into skills\n   *\n   * Uses NightlyLearner to:\n   * 1. Discover causal edges from episode patterns\n   * 2. Complete A/B experiments\n   * 3. Calculate uplift for experiments\n   * 4. Prune low-confidence edges\n   * 5. Consolidate high-performing patterns into skills\n   */\n  async autoConsolidate(options: {\n    minUses?: number;\n    minSuccessRate?: number;\n    lookbackDays?: number;\n    dryRun?: boolean;\n  } = {}): Promise<ConsolidationResult> {\n    const startTime = Date.now();\n\n    try {\n      // Run NightlyLearner's discovery and consolidation pipeline\n      const report = await this.learner.run();\n\n      // Also run skill consolidation from HybridReasoningBank\n      const skillResult = await this.reasoning.autoConsolidate(\n        options.minUses || 3,\n        options.minSuccessRate || 0.7,\n        options.lookbackDays || 30\n      );\n\n      return {\n        skillsCreated: skillResult.skillsCreated + (report.edgesDiscovered || 0),\n        causalEdgesCreated: report.edgesDiscovered || 0,\n        patternsAnalyzed: report.experimentsCompleted || 0,\n        executionTimeMs: Date.now() - startTime,\n        recommendations: report.recommendations || []\n      };\n    } catch (error) {\n      console.error('[AdvancedMemorySystem] Auto-consolidation failed:', error);\n\n      // Fallback to basic consolidation\n      const skillResult = await this.reasoning.autoConsolidate(\n        options.minUses || 3,\n        options.minSuccessRate || 0.7,\n        options.lookbackDays || 30\n      );\n\n      return {\n        skillsCreated: skillResult.skillsCreated,\n        causalEdgesCreated: 0,\n        patternsAnalyzed: 0,\n        executionTimeMs: Date.now() - startTime,\n        recommendations: ['Causal discovery unavailable - basic consolidation completed']\n      };\n    }\n  }\n\n  /**\n   * Learn from past failures with episodic replay\n   *\n   * Retrieves failed attempts, extracts lessons, and provides recommendations\n   */\n  async replayFailures(task: string, k: number = 5): Promise<FailureAnalysis[]> {\n    const failures = await this.reasoning.retrievePatterns(task, {\n      k,\n      onlyFailures: true\n    });\n\n    return failures.map(f => ({\n      critique: f.critique || this.extractCritique(f),\n      whatWentWrong: this.analyzeFailure(f),\n      howToFix: this.generateFixes(f),\n      similarFailures: failures.length\n    }));\n  }\n\n  /**\n   * Extract critique from failure pattern\n   */\n  private extractCritique(failure: any): string {\n    if (failure.critique) return failure.critique;\n    if (failure.task) return `Failed at: ${failure.task}`;\n    return 'No critique available';\n  }\n\n  /**\n   * Analyze what went wrong in a failure\n   */\n  private analyzeFailure(failure: any): string[] {\n    const issues: string[] = [];\n\n    if (failure.reward !== undefined && failure.reward < 0.3) {\n      issues.push('Low success rate observed');\n    }\n\n    if (failure.latencyMs && failure.latencyMs > 5000) {\n      issues.push('High latency detected');\n    }\n\n    if (failure.task) {\n      issues.push(`Task type: ${failure.task}`);\n    }\n\n    if (issues.length === 0) {\n      issues.push('General failure - review approach');\n    }\n\n    return issues;\n  }\n\n  /**\n   * Generate fix recommendations\n   */\n  private generateFixes(failure: any): string[] {\n    const fixes: string[] = [];\n\n    // Look for successful patterns with similar tasks\n    fixes.push('Review similar successful patterns');\n\n    if (failure.latencyMs && failure.latencyMs > 5000) {\n      fixes.push('Optimize for lower latency');\n    }\n\n    if (failure.reward !== undefined && failure.reward < 0.3) {\n      fixes.push('Consider alternative approach');\n    }\n\n    fixes.push('Add more validation and error handling');\n\n    return fixes;\n  }\n\n  /**\n   * What-if causal analysis\n   *\n   * Analyzes potential outcomes of taking an action based on causal evidence\n   */\n  async whatIfAnalysis(action: string): Promise<{\n    action: string;\n    avgReward: number;\n    avgUplift: number;\n    confidence: number;\n    evidenceCount: number;\n    recommendation: 'DO_IT' | 'AVOID' | 'NEUTRAL';\n    expectedImpact: string;\n  }> {\n    const causalInsight = await this.reasoning.whatIfAnalysis(action);\n\n    // Generate impact description\n    let expectedImpact = '';\n    if (causalInsight.avgUplift > 0.2) {\n      expectedImpact = `Highly beneficial: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;\n    } else if (causalInsight.avgUplift > 0.1) {\n      expectedImpact = `Beneficial: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;\n    } else if (causalInsight.avgUplift > 0) {\n      expectedImpact = `Slightly positive: Expected +${(causalInsight.avgUplift * 100).toFixed(1)}% improvement`;\n    } else if (causalInsight.avgUplift < -0.1) {\n      expectedImpact = `Harmful: Expected ${(causalInsight.avgUplift * 100).toFixed(1)}% degradation`;\n    } else {\n      expectedImpact = 'Neutral or insufficient evidence';\n    }\n\n    return {\n      ...causalInsight,\n      expectedImpact\n    };\n  }\n\n  /**\n   * Compose multiple skills for a complex task\n   *\n   * Finds relevant skills and creates an execution plan\n   */\n  async composeSkills(task: string, k: number = 5): Promise<SkillComposition> {\n    const skills = await this.reasoning.searchSkills(task, k);\n\n    // Sort by success rate and usage\n    const sortedSkills = skills.sort((a, b) => {\n      const scoreA = (a.successRate || 0) * 0.7 + (Math.log(a.uses || 1) / 10) * 0.3;\n      const scoreB = (b.successRate || 0) * 0.7 + (Math.log(b.uses || 1) / 10) * 0.3;\n      return scoreB - scoreA;\n    });\n\n    // Create composition plan\n    let compositionPlan = '';\n    if (sortedSkills.length === 0) {\n      compositionPlan = 'No relevant skills found';\n    } else if (sortedSkills.length === 1) {\n      compositionPlan = sortedSkills[0].name;\n    } else {\n      compositionPlan = sortedSkills.slice(0, 3).map(s => s.name).join(' → ');\n    }\n\n    // Calculate expected success rate (weighted average)\n    let expectedSuccessRate = 0;\n    if (sortedSkills.length > 0) {\n      const weights = sortedSkills.map(s => s.uses || 1);\n      const totalWeight = weights.reduce((sum, w) => sum + w, 0);\n      expectedSuccessRate = sortedSkills.reduce((sum, s, i) =>\n        sum + (s.successRate || 0) * weights[i] / totalWeight, 0\n      );\n    }\n\n    return {\n      availableSkills: sortedSkills,\n      compositionPlan,\n      expectedSuccessRate\n    };\n  }\n\n  /**\n   * Run automated learning cycle\n   *\n   * Discovers causal edges, consolidates skills, and optimizes performance\n   */\n  async runLearningCycle(): Promise<ConsolidationResult> {\n    return this.autoConsolidate({\n      minUses: 3,\n      minSuccessRate: 0.7,\n      lookbackDays: 30,\n      dryRun: false\n    });\n  }\n\n  /**\n   * Get comprehensive memory statistics\n   */\n  getStats(): {\n    reasoningBank: any;\n    learner: string;\n    memoryPool: any;\n  } {\n    return {\n      reasoningBank: this.reasoning.getStats(),\n      learner: 'NightlyLearner configured with auto-experiments',\n      memoryPool: this.pool.getStats()\n    };\n  }\n}\n"]}

package/agentic-flow/dist/reasoningbank/HybridBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HybridBackend.d.ts","sourceRoot":"","sources":["../../src/reasoningbank/HybridBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAM;gBAEZ,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO;YA6BpC,cAAc;IAW5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BzD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAqDrF;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACzC,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,SAAS,EAAE,aAAa,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IA6DF;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE,MAAU,EAAE,cAAc,GAAE,MAAY,EAAE,YAAY,GAAE,MAAW,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IA+CvI;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwC5D;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAInE;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,GAAG,CAAC;QAClB,SAAS,EAAE,GAAG,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB;CAOF"}