agentic-flow 3.0.0-alpha.2 → 3.1.0

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

@@ -1,317 +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');
- * ```
- */
-import { SharedMemoryPool } from '../memory/SharedMemoryPool.js';
-import { ReflexionMemory } from 'agentdb/controllers/ReflexionMemory';
-import { SkillLibrary } from 'agentdb/controllers/SkillLibrary';
-import { CausalRecall } from 'agentdb/controllers/CausalRecall';
-import { CausalMemoryGraph } from 'agentdb/controllers/CausalMemoryGraph';
-export class HybridReasoningBank {
-    memory;
-    reflexion;
-    skills;
-    causalRecall;
-    causalGraph;
-    useWasm;
-    wasmModule;
-    initPromise = null;
-    constructor(options = {}) {
-        this.memory = SharedMemoryPool.getInstance();
-        this.initPromise = this.memory.ensureInitialized(); // ✅ Store init promise
-        const db = this.memory.getDatabase();
-        const embedder = this.memory.getEmbedder();
-        this.reflexion = new ReflexionMemory(db, embedder);
-        this.skills = new SkillLibrary(db, embedder);
-        this.causalGraph = new CausalMemoryGraph(db);
-        // CausalRecall with optimized rerank config
-        this.causalRecall = new CausalRecall(db, embedder, {
-            alpha: 0.6, // 60% weight on similarity
-            beta: 0.3, // 30% weight on causal uplift
-            gamma: 0.1, // 10% penalty for latency
-            minConfidence: 0.7
-        });
-        this.useWasm = options.preferWasm ?? true;
-        this.wasmModule = null;
-        // Try to load WASM module
-        if (this.useWasm) {
-            this.loadWasmModule().catch(err => {
-                console.warn('[HybridReasoningBank] WASM unavailable, using TypeScript:', err.message);
-                this.useWasm = false;
-            });
-        }
-    }
-    /**
-     * Ensure database and services are initialized
-     * MUST be called before using any methods that access the database
-     */
-    async initialize() {
-        if (this.initPromise) {
-            await this.initPromise;
-        }
-    }
-    async loadWasmModule() {
-        try {
-            // Dynamic import for WASM module
-            const wasm = await import('../../wasm/reasoningbank/reasoningbank_wasm.js');
-            this.wasmModule = wasm;
-            console.log('[HybridReasoningBank] WASM module loaded successfully');
-        }
-        catch (error) {
-            throw new Error(`WASM load failed: ${error}`);
-        }
-    }
-    /**
-     * Store a reasoning pattern
-     */
-    async storePattern(pattern) {
-        const episodeId = await this.reflexion.storeEpisode(pattern);
-        // Store causal edge if action led to outcome
-        if (pattern.input && pattern.output && pattern.success) {
-            try {
-                this.causalGraph.addCausalEdge({
-                    fromMemoryId: episodeId,
-                    fromMemoryType: 'episode',
-                    toMemoryId: episodeId + 1, // Next episode
-                    toMemoryType: 'episode',
-                    similarity: pattern.reward,
-                    uplift: pattern.success ? pattern.reward : -pattern.reward,
-                    confidence: 0.8,
-                    sampleSize: 1,
-                    metadata: {
-                        sessionId: pattern.sessionId,
-                        task: pattern.task
-                    }
-                });
-            }
-            catch (error) {
-                console.warn('[HybridReasoningBank] Failed to record causal edge:', error);
-            }
-        }
-        return episodeId;
-    }
-    /**
-     * Retrieve similar patterns with optional WASM acceleration
-     */
-    async retrievePatterns(query, options = {}) {
-        const { k = 5, minReward, onlySuccesses, onlyFailures } = options;
-        // Check cache first
-        const cacheKey = `retrieve:${query}:${k}:${onlySuccesses}:${onlyFailures}`;
-        const cached = this.memory.getCachedQuery(cacheKey);
-        if (cached)
-            return cached;
-        // Use CausalRecall for intelligent retrieval with utility-based ranking
-        try {
-            const result = await this.causalRecall.recall(`query-${Date.now()}`, query, k, undefined, // requirements
-            'public' // accessLevel
-            );
-            // Convert candidates to pattern format and filter
-            let patterns = result.candidates.map(c => ({
-                task: c.content,
-                similarity: c.similarity,
-                uplift: c.uplift || 0,
-                utilityScore: c.utilityScore,
-                type: c.type,
-                id: c.id
-            }));
-            // Apply filters
-            if (minReward !== undefined) {
-                patterns = patterns.filter(p => (p.uplift || 0) >= minReward);
-            }
-            // Cache and return
-            this.memory.cacheQuery(cacheKey, patterns, 60000);
-            return patterns;
-        }
-        catch (error) {
-            console.warn('[HybridReasoningBank] CausalRecall failed, falling back to ReflexionMemory:', error);
-            // Fallback to basic ReflexionMemory
-            const results = await this.reflexion.retrieveRelevant({
-                task: query,
-                k,
-                minReward,
-                onlySuccesses,
-                onlyFailures
-            });
-            this.memory.cacheQuery(cacheKey, results, 60000);
-            return results;
-        }
-    }
-    /**
-     * Learn optimal strategy for a task
-     *
-     * Combines pattern retrieval with causal analysis to provide evidence-based recommendations
-     */
-    async learnStrategy(task) {
-        // Get successful patterns
-        const patterns = await this.retrievePatterns(task, { k: 10, onlySuccesses: true });
-        // Get causal effects for this task type
-        let causalData;
-        try {
-            // Note: queryCausalEffects requires specific memory IDs
-            // For task-level analysis, we'll use pattern success rates instead
-            const stats = await this.reflexion.getTaskStats(task, 30);
-            if (stats.totalAttempts > 0) {
-                causalData = {
-                    action: task,
-                    avgReward: stats.avgReward || 0,
-                    avgUplift: stats.improvementTrend || 0,
-                    confidence: Math.min(stats.totalAttempts / 10, 1.0),
-                    evidenceCount: stats.totalAttempts,
-                    recommendation: (stats.improvementTrend || 0) > 0.1 ? 'DO_IT' :
-                        (stats.improvementTrend || 0) < -0.1 ? 'AVOID' : 'NEUTRAL'
-                };
-            }
-        }
-        catch (error) {
-            console.warn('[HybridReasoningBank] Causal analysis failed:', error);
-        }
-        // Fallback if no causal data
-        if (!causalData) {
-            causalData = {
-                action: task,
-                avgReward: patterns.length > 0 ? (patterns[0].reward || 0) : 0,
-                avgUplift: 0,
-                confidence: patterns.length > 0 ? 0.6 : 0.3,
-                evidenceCount: patterns.length,
-                recommendation: patterns.length > 0 ? 'DO_IT' : 'NEUTRAL'
-            };
-        }
-        // Calculate overall confidence
-        const patternConf = Math.min(patterns.length / 10, 1.0); // 10+ patterns = full confidence
-        const causalConf = causalData.confidence;
-        const confidence = 0.6 * patternConf + 0.4 * causalConf;
-        // Generate recommendation
-        let recommendation = '';
-        if (confidence > 0.8 && causalData.avgUplift > 0.1) {
-            recommendation = `Strong evidence for success (${patterns.length} patterns, +${(causalData.avgUplift * 100).toFixed(1)}% uplift)`;
-        }
-        else if (confidence > 0.5) {
-            recommendation = `Moderate evidence (${patterns.length} patterns available)`;
-        }
-        else {
-            recommendation = `Limited evidence - proceed with caution`;
-        }
-        return {
-            patterns,
-            causality: causalData,
-            confidence,
-            recommendation
-        };
-    }
-    /**
-     * Auto-consolidate patterns into skills
-     */
-    async autoConsolidate(minUses = 3, minSuccessRate = 0.7, lookbackDays = 30) {
-        // Get task statistics
-        const stats = await this.reflexion.getTaskStats('', lookbackDays);
-        if (stats.totalAttempts < minUses || stats.successRate < minSuccessRate) {
-            return { skillsCreated: 0 };
-        }
-        // Get successful episodes for consolidation
-        const episodes = await this.reflexion.retrieveRelevant({
-            task: '',
-            k: 50,
-            onlySuccesses: true,
-            timeWindowDays: lookbackDays
-        });
-        // Group by task type and consolidate
-        const taskGroups = new Map();
-        episodes.forEach(ep => {
-            const group = taskGroups.get(ep.task) || [];
-            group.push(ep);
-            taskGroups.set(ep.task, group);
-        });
-        let skillsCreated = 0;
-        for (const [task, group] of taskGroups) {
-            if (group.length >= minUses) {
-                const successRate = group.filter(e => e.success).length / group.length;
-                if (successRate >= minSuccessRate) {
-                    await this.skills.createSkill({
-                        name: `skill_${task.replace(/\s+/g, '_').toLowerCase()}`,
-                        description: `Consolidated from ${group.length} successful episodes`,
-                        signature: { inputs: {}, outputs: {} },
-                        successRate,
-                        uses: group.length,
-                        avgReward: group.reduce((sum, e) => sum + e.reward, 0) / group.length,
-                        avgLatencyMs: group.reduce((sum, e) => sum + (e.latencyMs || 0), 0) / group.length,
-                        metadata: { consolidatedAt: Date.now(), taskType: task }
-                    });
-                    skillsCreated++;
-                }
-            }
-        }
-        return { skillsCreated };
-    }
-    /**
-     * What-if causal analysis
-     */
-    async whatIfAnalysis(action) {
-        try {
-            // Use task statistics for what-if analysis
-            const stats = await this.reflexion.getTaskStats(action, 30);
-            if (stats.totalAttempts === 0) {
-                return {
-                    action,
-                    avgReward: 0,
-                    avgUplift: 0,
-                    confidence: 0,
-                    evidenceCount: 0,
-                    recommendation: 'NEUTRAL'
-                };
-            }
-            const avgUplift = stats.improvementTrend || 0;
-            const confidence = Math.min(stats.totalAttempts / 10, 1.0);
-            return {
-                action,
-                avgReward: stats.avgReward || 0,
-                avgUplift,
-                confidence,
-                evidenceCount: stats.totalAttempts,
-                recommendation: avgUplift > 0.1 ? 'DO_IT' : avgUplift < -0.1 ? 'AVOID' : 'NEUTRAL'
-            };
-        }
-        catch (error) {
-            console.error('[HybridReasoningBank] What-if analysis failed:', error);
-            return {
-                action,
-                avgReward: 0,
-                avgUplift: 0,
-                confidence: 0,
-                evidenceCount: 0,
-                recommendation: 'NEUTRAL'
-            };
-        }
-    }
-    /**
-     * Search for relevant skills
-     */
-    async searchSkills(taskType, k = 5) {
-        return this.skills.searchSkills({ task: taskType, k, minSuccessRate: 0.5 });
-    }
-    /**
-     * Get statistics
-     */
-    getStats() {
-        return {
-            causalRecall: this.causalRecall.getStats(),
-            reflexion: {}, // ReflexionMemory doesn't expose global stats
-            skills: 0 // Would need to query database
-        };
-    }
-}
-//# sourceMappingURL=HybridBackend.js.map

package/dist/agentic-flow/src/reasoningbank/HybridBackend.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"HybridBackend.js","sourceRoot":"","sources":["../../../../src/reasoningbank/HybridBackend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hybrid ReasoningBank Backend - Full Implementation for v1.7.1\n *\n * Combines Rust WASM (compute) + AgentDB TypeScript (storage) for optimal performance:\n * - WASM: 10x faster similarity computation\n * - AgentDB: Persistent SQLite storage with frontier memory\n * - CausalRecall: Utility-based reranking with causal uplift\n * - Automatic backend selection based on task requirements\n *\n * @example\n * ```typescript\n * import { HybridReasoningBank } from 'agentic-flow/reasoningbank';\n *\n * const rb = new HybridReasoningBank({ preferWasm: true });\n * await rb.storePattern({ task: '...', success: true, reward: 0.95 });\n * const patterns = await rb.retrievePatterns('similar task', { k: 5 });\n * const strategy = await rb.learnStrategy('API optimization');\n * ```\n */\n\nimport { SharedMemoryPool } from '../memory/SharedMemoryPool.js';\nimport { ReflexionMemory } from 'agentdb/controllers/ReflexionMemory';\nimport { SkillLibrary } from 'agentdb/controllers/SkillLibrary';\nimport { CausalRecall } from 'agentdb/controllers/CausalRecall';\nimport { CausalMemoryGraph } from 'agentdb/controllers/CausalMemoryGraph';\n\nexport interface PatternData {\n  sessionId: string;\n  task: string;\n  input?: string;\n  output?: string;\n  critique?: string;\n  success: boolean;\n  reward: number;\n  latencyMs?: number;\n  tokensUsed?: number;\n}\n\nexport interface RetrievalOptions {\n  k?: number;\n  minReward?: number;\n  onlySuccesses?: boolean;\n  onlyFailures?: boolean;\n}\n\nexport interface CausalInsight {\n  action: string;\n  avgReward: number;\n  avgUplift: number;\n  confidence: number;\n  evidenceCount: number;\n  recommendation: 'DO_IT' | 'AVOID' | 'NEUTRAL';\n}\n\nexport class HybridReasoningBank {\n  private memory: SharedMemoryPool;\n  private reflexion: ReflexionMemory;\n  private skills: SkillLibrary;\n  private causalRecall: CausalRecall;\n  private causalGraph: CausalMemoryGraph;\n  private useWasm: boolean;\n  private wasmModule: any;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: { preferWasm?: boolean } = {}) {\n    this.memory = SharedMemoryPool.getInstance();\n    this.initPromise = this.memory.ensureInitialized();  // ✅ Store init promise\n    const db = this.memory.getDatabase();\n    const embedder = this.memory.getEmbedder();\n\n    this.reflexion = new ReflexionMemory(db, embedder);\n    this.skills = new SkillLibrary(db, embedder);\n    this.causalGraph = new CausalMemoryGraph(db);\n\n    // CausalRecall with optimized rerank config\n    this.causalRecall = new CausalRecall(db, embedder, {\n      alpha: 0.6,  // 60% weight on similarity\n      beta: 0.3,   // 30% weight on causal uplift\n      gamma: 0.1,  // 10% penalty for latency\n      minConfidence: 0.7\n    });\n\n    this.useWasm = options.preferWasm ?? true;\n    this.wasmModule = null;\n\n    // Try to load WASM module\n    if (this.useWasm) {\n      this.loadWasmModule().catch(err => {\n        console.warn('[HybridReasoningBank] WASM unavailable, using TypeScript:', err.message);\n        this.useWasm = false;\n      });\n    }\n  }\n\n  /**\n   * Ensure database and services are initialized\n   * MUST be called before using any methods that access the database\n   */\n  public async initialize(): Promise<void> {\n    if (this.initPromise) {\n      await this.initPromise;\n    }\n  }\n\n  private async loadWasmModule(): Promise<void> {\n    try {\n      // Dynamic import for WASM module\n      const wasm = await import('../../wasm/reasoningbank/reasoningbank_wasm.js');\n      this.wasmModule = wasm;\n      console.log('[HybridReasoningBank] WASM module loaded successfully');\n    } catch (error) {\n      throw new Error(`WASM load failed: ${error}`);\n    }\n  }\n\n  /**\n   * Store a reasoning pattern\n   */\n  async storePattern(pattern: PatternData): Promise<number> {\n    const episodeId = await this.reflexion.storeEpisode(pattern);\n\n    // Store causal edge if action led to outcome\n    if (pattern.input && pattern.output && pattern.success) {\n      try {\n        this.causalGraph.addCausalEdge({\n          fromMemoryId: episodeId,\n          fromMemoryType: 'episode',\n          toMemoryId: episodeId + 1, // Next episode\n          toMemoryType: 'episode',\n          similarity: pattern.reward,\n          uplift: pattern.success ? pattern.reward : -pattern.reward,\n          confidence: 0.8,\n          sampleSize: 1,\n          metadata: {\n            sessionId: pattern.sessionId,\n            task: pattern.task\n          }\n        });\n      } catch (error) {\n        console.warn('[HybridReasoningBank] Failed to record causal edge:', error);\n      }\n    }\n\n    return episodeId;\n  }\n\n  /**\n   * Retrieve similar patterns with optional WASM acceleration\n   */\n  async retrievePatterns(query: string, options: RetrievalOptions = {}): Promise<any[]> {\n    const { k = 5, minReward, onlySuccesses, onlyFailures } = options;\n\n    // Check cache first\n    const cacheKey = `retrieve:${query}:${k}:${onlySuccesses}:${onlyFailures}`;\n    const cached = this.memory.getCachedQuery(cacheKey);\n    if (cached) return cached;\n\n    // Use CausalRecall for intelligent retrieval with utility-based ranking\n    try {\n      const result = await this.causalRecall.recall(\n        `query-${Date.now()}`,\n        query,\n        k,\n        undefined, // requirements\n        'public'  // accessLevel\n      );\n\n      // Convert candidates to pattern format and filter\n      let patterns = result.candidates.map(c => ({\n        task: c.content,\n        similarity: c.similarity,\n        uplift: c.uplift || 0,\n        utilityScore: c.utilityScore,\n        type: c.type,\n        id: c.id\n      }));\n\n      // Apply filters\n      if (minReward !== undefined) {\n        patterns = patterns.filter(p => (p.uplift || 0) >= minReward);\n      }\n\n      // Cache and return\n      this.memory.cacheQuery(cacheKey, patterns, 60000);\n      return patterns;\n    } catch (error) {\n      console.warn('[HybridReasoningBank] CausalRecall failed, falling back to ReflexionMemory:', error);\n\n      // Fallback to basic ReflexionMemory\n      const results = await this.reflexion.retrieveRelevant({\n        task: query,\n        k,\n        minReward,\n        onlySuccesses,\n        onlyFailures\n      });\n\n      this.memory.cacheQuery(cacheKey, results, 60000);\n      return results;\n    }\n  }\n\n  /**\n   * Learn optimal strategy for a task\n   *\n   * Combines pattern retrieval with causal analysis to provide evidence-based recommendations\n   */\n  async learnStrategy(task: string): Promise<{\n    patterns: any[];\n    causality: CausalInsight;\n    confidence: number;\n    recommendation: string;\n  }> {\n    // Get successful patterns\n    const patterns = await this.retrievePatterns(task, { k: 10, onlySuccesses: true });\n\n    // Get causal effects for this task type\n    let causalData: any;\n    try {\n      // Note: queryCausalEffects requires specific memory IDs\n      // For task-level analysis, we'll use pattern success rates instead\n      const stats = await this.reflexion.getTaskStats(task, 30);\n\n      if (stats.totalAttempts > 0) {\n        causalData = {\n          action: task,\n          avgReward: stats.avgReward || 0,\n          avgUplift: stats.improvementTrend || 0,\n          confidence: Math.min(stats.totalAttempts / 10, 1.0),\n          evidenceCount: stats.totalAttempts,\n          recommendation: (stats.improvementTrend || 0) > 0.1 ? 'DO_IT' :\n                         (stats.improvementTrend || 0) < -0.1 ? 'AVOID' : 'NEUTRAL'\n        };\n      }\n    } catch (error) {\n      console.warn('[HybridReasoningBank] Causal analysis failed:', error);\n    }\n\n    // Fallback if no causal data\n    if (!causalData) {\n      causalData = {\n        action: task,\n        avgReward: patterns.length > 0 ? (patterns[0].reward || 0) : 0,\n        avgUplift: 0,\n        confidence: patterns.length > 0 ? 0.6 : 0.3,\n        evidenceCount: patterns.length,\n        recommendation: patterns.length > 0 ? 'DO_IT' : 'NEUTRAL'\n      };\n    }\n\n    // Calculate overall confidence\n    const patternConf = Math.min(patterns.length / 10, 1.0); // 10+ patterns = full confidence\n    const causalConf = causalData.confidence;\n    const confidence = 0.6 * patternConf + 0.4 * causalConf;\n\n    // Generate recommendation\n    let recommendation = '';\n    if (confidence > 0.8 && causalData.avgUplift > 0.1) {\n      recommendation = `Strong evidence for success (${patterns.length} patterns, +${(causalData.avgUplift * 100).toFixed(1)}% uplift)`;\n    } else if (confidence > 0.5) {\n      recommendation = `Moderate evidence (${patterns.length} patterns available)`;\n    } else {\n      recommendation = `Limited evidence - proceed with caution`;\n    }\n\n    return {\n      patterns,\n      causality: causalData,\n      confidence,\n      recommendation\n    };\n  }\n\n  /**\n   * Auto-consolidate patterns into skills\n   */\n  async autoConsolidate(minUses: number = 3, minSuccessRate: number = 0.7, lookbackDays: number = 30): Promise<{ skillsCreated: number }> {\n    // Get task statistics\n    const stats = await this.reflexion.getTaskStats('', lookbackDays);\n\n    if (stats.totalAttempts < minUses || stats.successRate < minSuccessRate) {\n      return { skillsCreated: 0 };\n    }\n\n    // Get successful episodes for consolidation\n    const episodes = await this.reflexion.retrieveRelevant({\n      task: '',\n      k: 50,\n      onlySuccesses: true,\n      timeWindowDays: lookbackDays\n    });\n\n    // Group by task type and consolidate\n    const taskGroups = new Map<string, any[]>();\n    episodes.forEach(ep => {\n      const group = taskGroups.get(ep.task) || [];\n      group.push(ep);\n      taskGroups.set(ep.task, group);\n    });\n\n    let skillsCreated = 0;\n    for (const [task, group] of taskGroups) {\n      if (group.length >= minUses) {\n        const successRate = group.filter(e => e.success).length / group.length;\n        if (successRate >= minSuccessRate) {\n          await this.skills.createSkill({\n            name: `skill_${task.replace(/\\s+/g, '_').toLowerCase()}`,\n            description: `Consolidated from ${group.length} successful episodes`,\n            signature: { inputs: {}, outputs: {} },\n            successRate,\n            uses: group.length,\n            avgReward: group.reduce((sum, e) => sum + e.reward, 0) / group.length,\n            avgLatencyMs: group.reduce((sum, e) => sum + (e.latencyMs || 0), 0) / group.length,\n            metadata: { consolidatedAt: Date.now(), taskType: task }\n          });\n          skillsCreated++;\n        }\n      }\n    }\n\n    return { skillsCreated };\n  }\n\n  /**\n   * What-if causal analysis\n   */\n  async whatIfAnalysis(action: string): Promise<CausalInsight> {\n    try {\n      // Use task statistics for what-if analysis\n      const stats = await this.reflexion.getTaskStats(action, 30);\n\n      if (stats.totalAttempts === 0) {\n        return {\n          action,\n          avgReward: 0,\n          avgUplift: 0,\n          confidence: 0,\n          evidenceCount: 0,\n          recommendation: 'NEUTRAL'\n        };\n      }\n\n      const avgUplift = stats.improvementTrend || 0;\n      const confidence = Math.min(stats.totalAttempts / 10, 1.0);\n\n      return {\n        action,\n        avgReward: stats.avgReward || 0,\n        avgUplift,\n        confidence,\n        evidenceCount: stats.totalAttempts,\n        recommendation: avgUplift > 0.1 ? 'DO_IT' : avgUplift < -0.1 ? 'AVOID' : 'NEUTRAL'\n      };\n    } catch (error) {\n      console.error('[HybridReasoningBank] What-if analysis failed:', error);\n      return {\n        action,\n        avgReward: 0,\n        avgUplift: 0,\n        confidence: 0,\n        evidenceCount: 0,\n        recommendation: 'NEUTRAL'\n      };\n    }\n  }\n\n  /**\n   * Search for relevant skills\n   */\n  async searchSkills(taskType: string, k: number = 5): Promise<any[]> {\n    return this.skills.searchSkills({ task: taskType, k, minSuccessRate: 0.5 });\n  }\n\n  /**\n   * Get statistics\n   */\n  getStats(): {\n    causalRecall: any;\n    reflexion: any;\n    skills: number;\n  } {\n    return {\n      causalRecall: this.causalRecall.getStats(),\n      reflexion: {}, // ReflexionMemory doesn't expose global stats\n      skills: 0 // Would need to query database\n    };\n  }\n}\n"]}

package/dist/agentic-flow/src/reasoningbank/backend-selector.d.ts

@@ -1,80 +0,0 @@
-/**
- * Backend Selection Helper for ReasoningBank
- *
- * Automatically selects the optimal ReasoningBank backend based on runtime environment.
- *
- * Usage:
- * ```typescript
- * import { createOptimalReasoningBank, getRecommendedBackend } from 'agentic-flow/reasoningbank/backend-selector';
- *
- * // Automatic backend selection
- * const rb = await createOptimalReasoningBank('my-db');
- *
- * // Manual check
- * const backend = getRecommendedBackend();
- * console.log(`Using ${backend} backend`);
- * ```
- */
-/**
- * Detect runtime environment and recommend optimal backend
- *
- * @returns 'nodejs' for Node.js/Deno environments, 'wasm' for browsers
- */
-export declare function getRecommendedBackend(): 'nodejs' | 'wasm';
-/**
- * Check if IndexedDB is available (browser environment)
- */
-export declare function hasIndexedDB(): boolean;
-/**
- * Check if SQLite adapter is available (Node.js)
- * Uses sql.js pure JavaScript implementation (always available)
- */
-export declare function hasSQLite(): boolean;
-/**
- * Create ReasoningBank instance with optimal backend for current environment
- *
- * @param dbName - Database name (used differently by each backend)
- * @param options - Additional configuration options
- * @returns ReasoningBank instance using optimal backend
- *
- * @example
- * ```typescript
- * // Node.js: Creates SQLite database at .swarm/my-app.db
- * const rb = await createOptimalReasoningBank('my-app');
- *
- * // Browser: Creates IndexedDB database named 'my-app'
- * const rb = await createOptimalReasoningBank('my-app');
- * ```
- */
-export declare function createOptimalReasoningBank(dbName?: string, options?: {
-    /** Force specific backend (overrides auto-detection) */
-    forceBackend?: 'nodejs' | 'wasm';
-    /** Custom database path (Node.js only) */
-    dbPath?: string;
-    /** Enable verbose logging */
-    verbose?: boolean;
-}): Promise<any>;
-/**
- * Get backend information and capabilities
- */
-export declare function getBackendInfo(): {
-    backend: "nodejs" | "wasm";
-    environment: string;
-    features: {
-        persistent: boolean;
-        sqlite: boolean;
-        indexeddb: boolean;
-        wasm: boolean;
-    };
-    storage: string;
-};
-/**
- * Validate environment and warn about limitations
- */
-export declare function validateEnvironment(): {
-    valid: boolean;
-    warnings: string[];
-    backend: 'nodejs' | 'wasm';
-};
-export { validateEnvironment as checkEnvironment };
-//# sourceMappingURL=backend-selector.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"backend-selector.d.ts","sourceRoot":"","sources":["../../../../src/reasoningbank/backend-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAazD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAQnC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,GAAE,MAAwB,EAChC,OAAO,GAAE;IACP,wDAAwD;IACxD,YAAY,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,OAAO,CAAC,GAAG,CAAC,CAuCd;AAED;;GAEG;AACH,wBAAgB,cAAc;;;;;;;;;;EAkB7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC5B,CAqBA;AAGD,OAAO,EAAE,mBAAmB,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/agentic-flow/src/reasoningbank/backend-selector.js

@@ -1,148 +0,0 @@
-/**
- * Backend Selection Helper for ReasoningBank
- *
- * Automatically selects the optimal ReasoningBank backend based on runtime environment.
- *
- * Usage:
- * ```typescript
- * import { createOptimalReasoningBank, getRecommendedBackend } from 'agentic-flow/reasoningbank/backend-selector';
- *
- * // Automatic backend selection
- * const rb = await createOptimalReasoningBank('my-db');
- *
- * // Manual check
- * const backend = getRecommendedBackend();
- * console.log(`Using ${backend} backend`);
- * ```
- */
-/**
- * Detect runtime environment and recommend optimal backend
- *
- * @returns 'nodejs' for Node.js/Deno environments, 'wasm' for browsers
- */
-export function getRecommendedBackend() {
-    // Check for browser environment
-    if (typeof window !== 'undefined' && typeof document !== 'undefined') {
-        return 'wasm';
-    }
-    // Check for Node.js/Deno
-    if (typeof process !== 'undefined' && process.versions?.node) {
-        return 'nodejs';
-    }
-    // Default to WASM for unknown environments (likely web workers, etc.)
-    return 'wasm';
-}
-/**
- * Check if IndexedDB is available (browser environment)
- */
-export function hasIndexedDB() {
-    return typeof indexedDB !== 'undefined';
-}
-/**
- * Check if SQLite adapter is available (Node.js)
- * Uses sql.js pure JavaScript implementation (always available)
- */
-export function hasSQLite() {
-    try {
-        require.resolve('./db/sql-adapter.js');
-        return true;
-    }
-    catch {
-        // sql.js adapter should always be available
-        return true;
-    }
-}
-/**
- * Create ReasoningBank instance with optimal backend for current environment
- *
- * @param dbName - Database name (used differently by each backend)
- * @param options - Additional configuration options
- * @returns ReasoningBank instance using optimal backend
- *
- * @example
- * ```typescript
- * // Node.js: Creates SQLite database at .swarm/my-app.db
- * const rb = await createOptimalReasoningBank('my-app');
- *
- * // Browser: Creates IndexedDB database named 'my-app'
- * const rb = await createOptimalReasoningBank('my-app');
- * ```
- */
-export async function createOptimalReasoningBank(dbName = 'reasoningbank', options = {}) {
-    const backend = options.forceBackend || getRecommendedBackend();
-    if (options.verbose) {
-        console.log(`[ReasoningBank] Environment: ${backend}`);
-        console.log(`[ReasoningBank] Database: ${dbName}`);
-    }
-    if (backend === 'nodejs') {
-        // Import Node.js backend (SQLite)
-        const reasoningBankModule = await import('./index.js');
-        const dbPath = options.dbPath || `.swarm/${dbName}.db`;
-        if (options.verbose) {
-            console.log(`[ReasoningBank] Using Node.js backend with SQLite`);
-            console.log(`[ReasoningBank] Database path: ${dbPath}`);
-        }
-        // The Node.js backend uses the db module and core algorithms
-        // Initialize the database
-        await reasoningBankModule.initialize();
-        // Note: The Node.js backend has a different API than WASM
-        // It uses the functions from db/queries.ts and core algorithms
-        // We return the full module for direct access to all functions
-        return reasoningBankModule;
-    }
-    else {
-        // Import WASM backend (IndexedDB in browser, Memory in Node.js)
-        const { createReasoningBank } = await import('./wasm-adapter.js');
-        if (options.verbose) {
-            const storageType = hasIndexedDB() ? 'IndexedDB (persistent)' : 'Memory (ephemeral)';
-            console.log(`[ReasoningBank] Using WASM backend with ${storageType}`);
-            console.log(`[ReasoningBank] Database name: ${dbName}`);
-        }
-        return await createReasoningBank(dbName);
-    }
-}
-/**
- * Get backend information and capabilities
- */
-export function getBackendInfo() {
-    const backend = getRecommendedBackend();
-    return {
-        backend,
-        environment: typeof window !== 'undefined' ? 'browser' : 'nodejs',
-        features: {
-            persistent: backend === 'nodejs' || hasIndexedDB(),
-            sqlite: backend === 'nodejs' && hasSQLite(),
-            indexeddb: backend === 'wasm' && hasIndexedDB(),
-            wasm: backend === 'wasm',
-        },
-        storage: backend === 'nodejs'
-            ? 'SQLite (disk)'
-            : hasIndexedDB()
-                ? 'IndexedDB (browser)'
-                : 'Memory (ephemeral)',
-    };
-}
-/**
- * Validate environment and warn about limitations
- */
-export function validateEnvironment() {
-    const backend = getRecommendedBackend();
-    const warnings = [];
-    let valid = true;
-    if (backend === 'nodejs' && !hasSQLite()) {
-        warnings.push('sql-adapter not found - database operations will fail');
-        valid = false;
-    }
-    if (backend === 'wasm' && typeof window !== 'undefined' && !hasIndexedDB()) {
-        warnings.push('IndexedDB not available - using ephemeral memory storage');
-        warnings.push('Data will be lost when page/process exits');
-    }
-    if (backend === 'wasm' && typeof window === 'undefined') {
-        warnings.push('WASM in Node.js uses in-memory storage (ephemeral)');
-        warnings.push('Consider using Node.js backend for persistence');
-    }
-    return { valid, warnings, backend };
-}
-// Export validation helper for use in initialization
-export { validateEnvironment as checkEnvironment };
-//# sourceMappingURL=backend-selector.js.map

package/dist/agentic-flow/src/reasoningbank/backend-selector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"backend-selector.js","sourceRoot":"","sources":["../../../../src/reasoningbank/backend-selector.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Backend Selection Helper for ReasoningBank\n *\n * Automatically selects the optimal ReasoningBank backend based on runtime environment.\n *\n * Usage:\n * ```typescript\n * import { createOptimalReasoningBank, getRecommendedBackend } from 'agentic-flow/reasoningbank/backend-selector';\n *\n * // Automatic backend selection\n * const rb = await createOptimalReasoningBank('my-db');\n *\n * // Manual check\n * const backend = getRecommendedBackend();\n * console.log(`Using ${backend} backend`);\n * ```\n */\n\n/**\n * Detect runtime environment and recommend optimal backend\n *\n * @returns 'nodejs' for Node.js/Deno environments, 'wasm' for browsers\n */\nexport function getRecommendedBackend(): 'nodejs' | 'wasm' {\n  // Check for browser environment\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    return 'wasm';\n  }\n\n  // Check for Node.js/Deno\n  if (typeof process !== 'undefined' && process.versions?.node) {\n    return 'nodejs';\n  }\n\n  // Default to WASM for unknown environments (likely web workers, etc.)\n  return 'wasm';\n}\n\n/**\n * Check if IndexedDB is available (browser environment)\n */\nexport function hasIndexedDB(): boolean {\n  return typeof indexedDB !== 'undefined';\n}\n\n/**\n * Check if SQLite adapter is available (Node.js)\n * Uses sql.js pure JavaScript implementation (always available)\n */\nexport function hasSQLite(): boolean {\n  try {\n    require.resolve('./db/sql-adapter.js');\n    return true;\n  } catch {\n    // sql.js adapter should always be available\n    return true;\n  }\n}\n\n/**\n * Create ReasoningBank instance with optimal backend for current environment\n *\n * @param dbName - Database name (used differently by each backend)\n * @param options - Additional configuration options\n * @returns ReasoningBank instance using optimal backend\n *\n * @example\n * ```typescript\n * // Node.js: Creates SQLite database at .swarm/my-app.db\n * const rb = await createOptimalReasoningBank('my-app');\n *\n * // Browser: Creates IndexedDB database named 'my-app'\n * const rb = await createOptimalReasoningBank('my-app');\n * ```\n */\nexport async function createOptimalReasoningBank(\n  dbName: string = 'reasoningbank',\n  options: {\n    /** Force specific backend (overrides auto-detection) */\n    forceBackend?: 'nodejs' | 'wasm';\n    /** Custom database path (Node.js only) */\n    dbPath?: string;\n    /** Enable verbose logging */\n    verbose?: boolean;\n  } = {}\n): Promise<any> {\n  const backend = options.forceBackend || getRecommendedBackend();\n\n  if (options.verbose) {\n    console.log(`[ReasoningBank] Environment: ${backend}`);\n    console.log(`[ReasoningBank] Database: ${dbName}`);\n  }\n\n  if (backend === 'nodejs') {\n    // Import Node.js backend (SQLite)\n    const reasoningBankModule = await import('./index.js');\n\n    const dbPath = options.dbPath || `.swarm/${dbName}.db`;\n\n    if (options.verbose) {\n      console.log(`[ReasoningBank] Using Node.js backend with SQLite`);\n      console.log(`[ReasoningBank] Database path: ${dbPath}`);\n    }\n\n    // The Node.js backend uses the db module and core algorithms\n    // Initialize the database\n    await reasoningBankModule.initialize();\n\n    // Note: The Node.js backend has a different API than WASM\n    // It uses the functions from db/queries.ts and core algorithms\n    // We return the full module for direct access to all functions\n    return reasoningBankModule;\n  } else {\n    // Import WASM backend (IndexedDB in browser, Memory in Node.js)\n    const { createReasoningBank } = await import('./wasm-adapter.js');\n\n    if (options.verbose) {\n      const storageType = hasIndexedDB() ? 'IndexedDB (persistent)' : 'Memory (ephemeral)';\n      console.log(`[ReasoningBank] Using WASM backend with ${storageType}`);\n      console.log(`[ReasoningBank] Database name: ${dbName}`);\n    }\n\n    return await createReasoningBank(dbName);\n  }\n}\n\n/**\n * Get backend information and capabilities\n */\nexport function getBackendInfo() {\n  const backend = getRecommendedBackend();\n\n  return {\n    backend,\n    environment: typeof window !== 'undefined' ? 'browser' : 'nodejs',\n    features: {\n      persistent: backend === 'nodejs' || hasIndexedDB(),\n      sqlite: backend === 'nodejs' && hasSQLite(),\n      indexeddb: backend === 'wasm' && hasIndexedDB(),\n      wasm: backend === 'wasm',\n    },\n    storage: backend === 'nodejs'\n      ? 'SQLite (disk)'\n      : hasIndexedDB()\n        ? 'IndexedDB (browser)'\n        : 'Memory (ephemeral)',\n  };\n}\n\n/**\n * Validate environment and warn about limitations\n */\nexport function validateEnvironment(): {\n  valid: boolean;\n  warnings: string[];\n  backend: 'nodejs' | 'wasm';\n} {\n  const backend = getRecommendedBackend();\n  const warnings: string[] = [];\n  let valid = true;\n\n  if (backend === 'nodejs' && !hasSQLite()) {\n    warnings.push('sql-adapter not found - database operations will fail');\n    valid = false;\n  }\n\n  if (backend === 'wasm' && typeof window !== 'undefined' && !hasIndexedDB()) {\n    warnings.push('IndexedDB not available - using ephemeral memory storage');\n    warnings.push('Data will be lost when page/process exits');\n  }\n\n  if (backend === 'wasm' && typeof window === 'undefined') {\n    warnings.push('WASM in Node.js uses in-memory storage (ephemeral)');\n    warnings.push('Consider using Node.js backend for persistence');\n  }\n\n  return { valid, warnings, backend };\n}\n\n// Export validation helper for use in initialization\nexport { validateEnvironment as checkEnvironment };\n"]}

package/dist/agentic-flow/src/reasoningbank/benchmark.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * ReasoningBank Performance Benchmark Suite
- *
- * Benchmarks:
- * 1. Database Operations (CRUD, queries)
- * 2. Retrieval Algorithm (top-k, MMR, scoring)
- * 3. Embedding Operations (storage, similarity)
- * 4. Scalability (10, 100, 1000, 10000 memories)
- * 5. Configuration Loading
- * 6. View Queries
- */
-export {};
-//# sourceMappingURL=benchmark.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../../src/reasoningbank/benchmark.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}