agentic-flow 3.0.0-alpha.2 → 3.0.0

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

@@ -1,248 +0,0 @@
-/**
- * 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
-        });
-    }
-    /**
-     * Ensure all components are initialized
-     * MUST be called before using any async methods
-     */
-    async initialize() {
-        await this.reasoning.initialize();
-        await this.pool.ensureInitialized();
-    }
-    /**
-     * 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/dist/agentic-flow/src/reasoningbank/AdvancedMemory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdvancedMemory.js","sourceRoot":"","sources":["../../../../src/reasoningbank/AdvancedMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAuBjE,MAAM,OAAO,oBAAoB;IACvB,SAAS,CAAsB;IAC/B,OAAO,CAAiB;IACxB,IAAI,CAAmB;IAE/B,YAAY,UAAoC,EAAE;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAE3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzC,kDAAkD;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE;YAC9C,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC;YAChB,mBAAmB,EAAE,GAAG;YACxB,eAAe,EAAE,GAAG;YACpB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,IAAI;YACrB,gBAAgB,EAAE,GAAG;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,UAAU;QACrB,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,eAAe,CAAC,UAKlB,EAAE;QACJ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAExC,wDAAwD;YACxD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CACtD,OAAO,CAAC,OAAO,IAAI,CAAC,EACpB,OAAO,CAAC,cAAc,IAAI,GAAG,EAC7B,OAAO,CAAC,YAAY,IAAI,EAAE,CAC3B,CAAC;YAEF,OAAO;gBACL,aAAa,EAAE,WAAW,CAAC,aAAa,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;gBACxE,kBAAkB,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;gBAC/C,gBAAgB,EAAE,MAAM,CAAC,oBAAoB,IAAI,CAAC;gBAClD,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACvC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;aAC9C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,KAAK,CAAC,CAAC;YAE1E,kCAAkC;YAClC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CACtD,OAAO,CAAC,OAAO,IAAI,CAAC,EACpB,OAAO,CAAC,cAAc,IAAI,GAAG,EAC7B,OAAO,CAAC,YAAY,IAAI,EAAE,CAC3B,CAAC;YAEF,OAAO;gBACL,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,kBAAkB,EAAE,CAAC;gBACrB,gBAAgB,EAAE,CAAC;gBACnB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACvC,eAAe,EAAE,CAAC,8DAA8D,CAAC;aAClF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAY,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC3D,CAAC;YACD,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YAC/C,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;YACrC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAC/B,eAAe,EAAE,QAAQ,CAAC,MAAM;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAY;QAClC,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;QAC9C,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,cAAc,OAAO,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAY;QACjC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,OAAY;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,kDAAkD;QAClD,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAEjD,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAErD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,MAAc;QASjC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAElE,8BAA8B;QAC9B,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YAClC,cAAc,GAAG,gCAAgC,CAAC,aAAa,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC7G,CAAC;aAAM,IAAI,aAAa,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACzC,cAAc,GAAG,yBAAyB,CAAC,aAAa,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACtG,CAAC;aAAM,IAAI,aAAa,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvC,cAAc,GAAG,gCAAgC,CAAC,aAAa,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC7G,CAAC;aAAM,IAAI,aAAa,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,CAAC;YAC1C,cAAc,GAAG,qBAAqB,CAAC,aAAa,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,kCAAkC,CAAC;QACtD,CAAC;QAED,OAAO;YACL,GAAG,aAAa;YAChB,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,IAAY,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1D,iCAAiC;QACjC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;YAC/E,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;YAC/E,OAAO,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,eAAe,GAAG,0BAA0B,CAAC;QAC/C,CAAC;aAAM,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1E,CAAC;QAED,qDAAqD;QACrD,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3D,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CACtD,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CACzD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,eAAe,EAAE,YAAY;YAC7B,eAAe;YACf,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,eAAe,CAAC;YAC1B,OAAO,EAAE,CAAC;YACV,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;YACxC,OAAO,EAAE,iDAAiD;YAC1D,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;SACjC,CAAC;IACJ,CAAC;CACF","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   * Ensure all components are initialized\n   * MUST be called before using any async methods\n   */\n  public async initialize(): Promise<void> {\n    await this.reasoning.initialize();\n    await this.pool.ensureInitialized();\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/dist/agentic-flow/src/reasoningbank/HybridBackend.d.ts

@@ -1,105 +0,0 @@
-/**
- * Hybrid ReasoningBank Backend - Full Implementation for v1.7.1
- *
- * Combines Rust WASM (compute) + AgentDB TypeScript (storage) for optimal performance:
- * - WASM: 10x faster similarity computation
- * - AgentDB: Persistent SQLite storage with frontier memory
- * - CausalRecall: Utility-based reranking with causal uplift
- * - Automatic backend selection based on task requirements
- *
- * @example
- * ```typescript
- * import { HybridReasoningBank } from 'agentic-flow/reasoningbank';
- *
- * const rb = new HybridReasoningBank({ preferWasm: true });
- * await rb.storePattern({ task: '...', success: true, reward: 0.95 });
- * const patterns = await rb.retrievePatterns('similar task', { k: 5 });
- * const strategy = await rb.learnStrategy('API optimization');
- * ```
- */
-export interface PatternData {
-    sessionId: string;
-    task: string;
-    input?: string;
-    output?: string;
-    critique?: string;
-    success: boolean;
-    reward: number;
-    latencyMs?: number;
-    tokensUsed?: number;
-}
-export interface RetrievalOptions {
-    k?: number;
-    minReward?: number;
-    onlySuccesses?: boolean;
-    onlyFailures?: boolean;
-}
-export interface CausalInsight {
-    action: string;
-    avgReward: number;
-    avgUplift: number;
-    confidence: number;
-    evidenceCount: number;
-    recommendation: 'DO_IT' | 'AVOID' | 'NEUTRAL';
-}
-export declare class HybridReasoningBank {
-    private memory;
-    private reflexion;
-    private skills;
-    private causalRecall;
-    private causalGraph;
-    private useWasm;
-    private wasmModule;
-    private initPromise;
-    constructor(options?: {
-        preferWasm?: boolean;
-    });
-    /**
-     * Ensure database and services are initialized
-     * MUST be called before using any methods that access the database
-     */
-    initialize(): Promise<void>;
-    private loadWasmModule;
-    /**
-     * Store a reasoning pattern
-     */
-    storePattern(pattern: PatternData): Promise<number>;
-    /**
-     * Retrieve similar patterns with optional WASM acceleration
-     */
-    retrievePatterns(query: string, options?: RetrievalOptions): Promise<any[]>;
-    /**
-     * Learn optimal strategy for a task
-     *
-     * Combines pattern retrieval with causal analysis to provide evidence-based recommendations
-     */
-    learnStrategy(task: string): Promise<{
-        patterns: any[];
-        causality: CausalInsight;
-        confidence: number;
-        recommendation: string;
-    }>;
-    /**
-     * Auto-consolidate patterns into skills
-     */
-    autoConsolidate(minUses?: number, minSuccessRate?: number, lookbackDays?: number): Promise<{
-        skillsCreated: number;
-    }>;
-    /**
-     * What-if causal analysis
-     */
-    whatIfAnalysis(action: string): Promise<CausalInsight>;
-    /**
-     * Search for relevant skills
-     */
-    searchSkills(taskType: string, k?: number): Promise<any[]>;
-    /**
-     * Get statistics
-     */
-    getStats(): {
-        causalRecall: any;
-        reflexion: any;
-        skills: number;
-    };
-}
-//# sourceMappingURL=HybridBackend.d.ts.map

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

@@ -1 +0,0 @@
-{"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;IACxB,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO;IA8BlD;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAM1B,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"}