agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/src/controllers/ReasoningBank.js

@@ -0,0 +1,494 @@
+/**
+ * ReasoningBank Controller - Pattern Storage and Retrieval
+ *
+ * Manages reasoning patterns with embeddings for semantic similarity search.
+ * Integrates with ReasoningBank WASM for high-performance pattern matching.
+ *
+ * Pattern Structure:
+ * - taskType: Type of task (e.g., "code_review", "data_analysis")
+ * - approach: Description of the reasoning approach used
+ * - successRate: Success rate of this pattern (0-1)
+ * - embedding: Vector embedding of the pattern for similarity search
+ * - metadata: Additional contextual information
+ *
+ * AgentDB v2 Migration:
+ * - Uses VectorBackend abstraction for 8x faster search (RuVector/hnswlib)
+ * - Optional GNN enhancement via LearningBackend
+ * - 100% backward compatible with v1 API
+ * - New features: useGNN option, recordOutcome for learning
+ */
+export class ReasoningBank {
+    db;
+    embedder;
+    cache;
+    // v2: Optional vector backend (uses legacy if not provided)
+    vectorBackend;
+    learningBackend;
+    // Maps pattern ID (number) to vector backend ID (string) for hybrid mode
+    idMapping = new Map();
+    nextVectorId = 0;
+    /**
+     * Constructor supports both legacy (v1) and new (v2) modes
+     *
+     * Legacy mode (v1 - backward compatible):
+     *   new ReasoningBank(db, embedder)
+     *
+     * New mode (v2 - with VectorBackend):
+     *   new ReasoningBank(db, embedder, vectorBackend, learningBackend?)
+     */
+    constructor(db, embedder, vectorBackend, learningBackend) {
+        this.db = db;
+        this.embedder = embedder;
+        this.vectorBackend = vectorBackend;
+        this.learningBackend = learningBackend;
+        this.cache = new Map();
+        this.initializeSchema();
+    }
+    /**
+     * Initialize reasoning patterns schema
+     */
+    initializeSchema() {
+        // Create patterns table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS reasoning_patterns (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts INTEGER DEFAULT (strftime('%s', 'now')),
+        task_type TEXT NOT NULL,
+        approach TEXT NOT NULL,
+        success_rate REAL NOT NULL DEFAULT 0.0,
+        uses INTEGER DEFAULT 0,
+        avg_reward REAL DEFAULT 0.0,
+        tags TEXT,
+        metadata TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_patterns_task_type ON reasoning_patterns(task_type);
+      CREATE INDEX IF NOT EXISTS idx_patterns_success_rate ON reasoning_patterns(success_rate);
+      CREATE INDEX IF NOT EXISTS idx_patterns_uses ON reasoning_patterns(uses);
+    `);
+        // Create pattern embeddings table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS pattern_embeddings (
+        pattern_id INTEGER PRIMARY KEY,
+        embedding BLOB NOT NULL,
+        FOREIGN KEY (pattern_id) REFERENCES reasoning_patterns(id) ON DELETE CASCADE
+      );
+    `);
+    }
+    /**
+     * Store a reasoning pattern with embedding
+     *
+     * v1 (legacy): Stores in SQLite with pattern_embeddings table
+     * v2 (VectorBackend): Stores metadata in SQLite, vectors in VectorBackend
+     */
+    async storePattern(pattern) {
+        // Generate embedding from approach text
+        const embedding = await this.embedder.embed(`${pattern.taskType}: ${pattern.approach}`);
+        // Insert pattern metadata into SQLite
+        const stmt = this.db.prepare(`
+      INSERT INTO reasoning_patterns (
+        task_type, approach, success_rate, uses, avg_reward, tags, metadata
+      ) VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        const result = stmt.run(pattern.taskType, pattern.approach, pattern.successRate, pattern.uses || 0, pattern.avgReward || 0.0, pattern.tags ? JSON.stringify(pattern.tags) : null, pattern.metadata ? JSON.stringify(pattern.metadata) : null);
+        const patternId = result.lastInsertRowid;
+        // Store embedding based on mode
+        if (this.vectorBackend) {
+            // v2: Use VectorBackend for high-performance search
+            const vectorId = `pattern_${this.nextVectorId++}`;
+            this.idMapping.set(patternId, vectorId);
+            this.vectorBackend.insert(vectorId, embedding, {
+                patternId,
+                taskType: pattern.taskType,
+                successRate: pattern.successRate,
+            });
+        }
+        else {
+            // v1: Use legacy SQLite storage (backward compatible)
+            this.storePatternEmbedding(patternId, embedding);
+        }
+        // Invalidate cache
+        this.cache.clear();
+        return patternId;
+    }
+    /**
+     * Store pattern embedding
+     */
+    storePatternEmbedding(patternId, embedding) {
+        const blob = Buffer.from(embedding.buffer);
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO pattern_embeddings (pattern_id, embedding)
+      VALUES (?, ?)
+    `);
+        stmt.run(patternId, blob);
+    }
+    /**
+     * Search patterns by semantic similarity
+     *
+     * v1 (legacy): Uses SQLite with cosine similarity computation
+     * v2 (VectorBackend): Uses high-performance vector search (8x faster)
+     * v2 + GNN: Optionally enhances query with learned patterns
+     */
+    async searchPatterns(query) {
+        const k = query.k || 10;
+        const threshold = query.threshold || 0.0;
+        // Generate embedding if task string provided (v1 API compatibility)
+        let queryEmbedding;
+        if (query.task && !query.taskEmbedding) {
+            queryEmbedding = await this.embedder.embed(query.task);
+        }
+        else if (query.taskEmbedding) {
+            queryEmbedding = query.taskEmbedding;
+        }
+        else {
+            throw new Error('PatternSearchQuery must provide either task (v1) or taskEmbedding (v2)');
+        }
+        // Create enriched query with embedding (ensure taskEmbedding is always defined)
+        const enrichedQuery = {
+            ...query,
+            taskEmbedding: queryEmbedding
+        };
+        // Use VectorBackend if available (v2 mode)
+        if (this.vectorBackend) {
+            return this.searchPatternsV2(enrichedQuery);
+        }
+        // Legacy v1 search (100% backward compatible)
+        return this.searchPatternsLegacy(enrichedQuery);
+    }
+    /**
+     * v2: Search using VectorBackend with optional GNN enhancement
+     */
+    async searchPatternsV2(query) {
+        const k = query.k || 10;
+        const threshold = query.threshold || 0.0;
+        let queryEmbedding = query.taskEmbedding;
+        // Optional: Apply GNN enhancement
+        if (query.useGNN && this.learningBackend) {
+            // Get initial candidates for GNN context
+            const candidates = this.vectorBackend.search(queryEmbedding, k * 3, { threshold: 0.0 });
+            if (candidates.length > 0) {
+                // Retrieve neighbor embeddings for GNN
+                const neighborEmbeddings = await this.getEmbeddingsForVectorIds(candidates.map(c => c.id));
+                const weights = candidates.map(c => c.similarity);
+                // Enhance query using GNN
+                queryEmbedding = this.learningBackend.enhance(queryEmbedding, neighborEmbeddings, weights);
+            }
+        }
+        // Perform vector search
+        const results = this.vectorBackend.search(queryEmbedding, k, { threshold });
+        // Hydrate with metadata from SQLite
+        return this.hydratePatterns(results);
+    }
+    /**
+     * v1: Legacy search using SQLite (backward compatible)
+     */
+    async searchPatternsLegacy(query) {
+        const k = query.k || 10;
+        const threshold = query.threshold || 0.0;
+        // Build WHERE clause for filters
+        const conditions = [];
+        const params = [];
+        if (query.filters?.taskType) {
+            conditions.push('rp.task_type = ?');
+            params.push(query.filters.taskType);
+        }
+        if (query.filters?.minSuccessRate !== undefined) {
+            conditions.push('rp.success_rate >= ?');
+            params.push(query.filters.minSuccessRate);
+        }
+        if (query.filters?.tags && query.filters.tags.length > 0) {
+            // Check if any of the tags match
+            const tagConditions = query.filters.tags.map(() => 'rp.tags LIKE ?').join(' OR ');
+            conditions.push(`(${tagConditions})`);
+            query.filters.tags.forEach(tag => {
+                params.push(`%"${tag}"%`);
+            });
+        }
+        const whereClause = conditions.length > 0
+            ? `WHERE ${conditions.join(' AND ')}`
+            : '';
+        // Retrieve all candidate patterns
+        const stmt = this.db.prepare(`
+      SELECT
+        rp.id,
+        rp.ts,
+        rp.task_type,
+        rp.approach,
+        rp.success_rate,
+        rp.uses,
+        rp.avg_reward,
+        rp.tags,
+        rp.metadata,
+        pe.embedding
+      FROM reasoning_patterns rp
+      JOIN pattern_embeddings pe ON rp.id = pe.pattern_id
+      ${whereClause}
+    `);
+        const rows = stmt.all(...params);
+        // Calculate similarities
+        const candidates = rows.map(row => {
+            const embedding = new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4);
+            const similarity = this.cosineSimilarity(query.taskEmbedding, embedding);
+            return {
+                id: row.id,
+                taskType: row.task_type,
+                approach: row.approach,
+                successRate: row.success_rate,
+                uses: row.uses,
+                avgReward: row.avg_reward,
+                tags: row.tags ? JSON.parse(row.tags) : [],
+                metadata: row.metadata ? JSON.parse(row.metadata) : {},
+                createdAt: row.ts,
+                embedding,
+                similarity,
+            };
+        });
+        // Filter by threshold and sort by similarity
+        const filtered = candidates
+            .filter(c => c.similarity >= threshold)
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, k);
+        return filtered;
+    }
+    /**
+     * Hydrate search results with metadata from SQLite
+     */
+    hydratePatterns(results) {
+        // Prepare statement OUTSIDE loop for better-sqlite3 best practice
+        const stmt = this.db.prepare(`
+      SELECT * FROM reasoning_patterns WHERE id = ?
+    `);
+        return results.map(result => {
+            const patternId = result.metadata?.patternId;
+            if (!patternId) {
+                throw new Error(`VectorBackend result missing patternId: ${result.id}`);
+            }
+            const row = stmt.get(patternId);
+            if (!row) {
+                throw new Error(`Pattern ${patternId} not found in database`);
+            }
+            return {
+                id: row.id,
+                taskType: row.task_type,
+                approach: row.approach,
+                successRate: row.success_rate,
+                uses: row.uses,
+                avgReward: row.avg_reward,
+                tags: row.tags ? JSON.parse(row.tags) : [],
+                metadata: row.metadata ? JSON.parse(row.metadata) : {},
+                createdAt: row.ts,
+                similarity: result.similarity,
+            };
+        });
+    }
+    /**
+     * Get embeddings for vector IDs (for GNN)
+     */
+    async getEmbeddingsForVectorIds(vectorIds) {
+        // In a full implementation, this would retrieve embeddings from VectorBackend
+        // For now, we regenerate them from the database
+        const embeddings = [];
+        for (const vectorId of vectorIds) {
+            // Find pattern ID from mapping
+            let patternId;
+            for (const [pid, vid] of this.idMapping.entries()) {
+                if (vid === vectorId) {
+                    patternId = pid;
+                    break;
+                }
+            }
+            if (patternId) {
+                const pattern = this.getPattern(patternId);
+                if (pattern?.approach) {
+                    const embedding = await this.embedder.embed(`${pattern.taskType}: ${pattern.approach}`);
+                    embeddings.push(embedding);
+                }
+            }
+        }
+        return embeddings;
+    }
+    /**
+     * Get pattern statistics
+     */
+    getPatternStats() {
+        // Check cache first
+        const cacheKey = 'pattern_stats';
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        // Total patterns
+        const totalRow = this.db.prepare('SELECT COUNT(*) as count FROM reasoning_patterns').get();
+        // Average success rate and uses
+        const avgRow = this.db.prepare(`
+      SELECT
+        AVG(success_rate) as avg_success_rate,
+        AVG(uses) as avg_uses
+      FROM reasoning_patterns
+    `).get();
+        // Top task types
+        const topTaskTypes = this.db.prepare(`
+      SELECT
+        task_type,
+        COUNT(*) as count
+      FROM reasoning_patterns
+      GROUP BY task_type
+      ORDER BY count DESC
+      LIMIT 10
+    `).all();
+        // Recent patterns (last 7 days)
+        const recentRow = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM reasoning_patterns
+      WHERE ts >= strftime('%s', 'now', '-7 days')
+    `).get();
+        // High performing patterns (success_rate >= 0.8)
+        const highPerfRow = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM reasoning_patterns
+      WHERE success_rate >= 0.8
+    `).get();
+        const stats = {
+            totalPatterns: totalRow.count,
+            avgSuccessRate: avgRow.avg_success_rate || 0,
+            avgUses: avgRow.avg_uses || 0,
+            topTaskTypes: topTaskTypes.map(row => ({
+                taskType: row.task_type,
+                count: row.count,
+            })),
+            recentPatterns: recentRow.count,
+            highPerformingPatterns: highPerfRow.count,
+        };
+        // Cache for 5 minutes
+        this.cache.set(cacheKey, stats);
+        setTimeout(() => this.cache.delete(cacheKey), 5 * 60 * 1000);
+        return stats;
+    }
+    /**
+     * Update pattern statistics after use
+     */
+    updatePatternStats(patternId, success, reward) {
+        const stmt = this.db.prepare(`
+      UPDATE reasoning_patterns
+      SET
+        uses = uses + 1,
+        success_rate = (success_rate * uses + ?) / (uses + 1),
+        avg_reward = (avg_reward * uses + ?) / (uses + 1)
+      WHERE id = ?
+    `);
+        stmt.run(success ? 1 : 0, reward, patternId);
+        // Invalidate cache
+        this.cache.clear();
+    }
+    /**
+     * Record pattern outcome for GNN learning (v2 feature)
+     *
+     * Updates pattern stats and adds training sample to LearningBackend
+     * for future GNN model improvements.
+     *
+     * @param patternId - Pattern ID to update
+     * @param success - Whether the pattern was successful
+     * @param reward - Optional reward value (default: 1 for success, 0 for failure)
+     */
+    async recordOutcome(patternId, success, reward) {
+        // Update pattern statistics
+        const actualReward = reward !== undefined ? reward : (success ? 1.0 : 0.0);
+        this.updatePatternStats(patternId, success, actualReward);
+        // Add to GNN training buffer if available
+        if (this.learningBackend) {
+            const pattern = this.getPattern(patternId);
+            if (pattern?.approach) {
+                const embedding = await this.embedder.embed(`${pattern.taskType}: ${pattern.approach}`);
+                this.learningBackend.addSample(embedding, success);
+            }
+        }
+    }
+    /**
+     * Train GNN model on collected samples (v2 feature)
+     *
+     * Trains the learning backend using accumulated pattern outcomes.
+     * Requires LearningBackend to be configured.
+     *
+     * @param options - Training options (epochs, batchSize)
+     * @returns Training results with epochs and final loss
+     * @throws Error if LearningBackend not available
+     */
+    async trainGNN(options) {
+        if (!this.learningBackend) {
+            throw new Error('GNN learning not available. Initialize ReasoningBank with LearningBackend.');
+        }
+        return this.learningBackend.train(options);
+    }
+    /**
+     * Get pattern by ID
+     */
+    getPattern(patternId) {
+        const stmt = this.db.prepare(`
+      SELECT
+        rp.id,
+        rp.ts,
+        rp.task_type,
+        rp.approach,
+        rp.success_rate,
+        rp.uses,
+        rp.avg_reward,
+        rp.tags,
+        rp.metadata,
+        pe.embedding
+      FROM reasoning_patterns rp
+      LEFT JOIN pattern_embeddings pe ON rp.id = pe.pattern_id
+      WHERE rp.id = ?
+    `);
+        const row = stmt.get(patternId);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            taskType: row.task_type,
+            approach: row.approach,
+            successRate: row.success_rate,
+            uses: row.uses,
+            avgReward: row.avg_reward,
+            tags: row.tags ? JSON.parse(row.tags) : [],
+            metadata: row.metadata ? JSON.parse(row.metadata) : {},
+            createdAt: row.ts,
+            embedding: row.embedding
+                ? new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4)
+                : undefined,
+        };
+    }
+    /**
+     * Delete pattern by ID
+     */
+    deletePattern(patternId) {
+        const stmt = this.db.prepare('DELETE FROM reasoning_patterns WHERE id = ?');
+        const result = stmt.run(patternId);
+        // Invalidate cache
+        this.cache.clear();
+        return result.changes > 0;
+    }
+    /**
+     * Clear query cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error('Vectors must have same length');
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denom = Math.sqrt(normA) * Math.sqrt(normB);
+        return denom === 0 ? 0 : dotProduct / denom;
+    }
+}
+//# sourceMappingURL=ReasoningBank.js.map

package/dist/src/controllers/ReasoningBank.js.map

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

package/dist/src/controllers/ReflexionMemory.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ReflexionMemory - Episodic Replay Memory System
+ *
+ * Implements reflexion-style episodic replay for agent self-improvement.
+ * Stores self-critiques and outcomes, retrieves relevant past experiences.
+ *
+ * Based on: "Reflexion: Language Agents with Verbal Reinforcement Learning"
+ * https://arxiv.org/abs/2303.11366
+ */
+type Database = any;
+import { EmbeddingService } from './EmbeddingService.js';
+import type { VectorBackend } from '../backends/VectorBackend.js';
+import type { LearningBackend } from '../backends/LearningBackend.js';
+import type { GraphBackend } from '../backends/GraphBackend.js';
+export interface Episode {
+    id?: number;
+    ts?: number;
+    sessionId: string;
+    task: string;
+    input?: string;
+    output?: string;
+    critique?: string;
+    reward: number;
+    success: boolean;
+    latencyMs?: number;
+    tokensUsed?: number;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+export interface EpisodeWithEmbedding extends Episode {
+    embedding?: Float32Array;
+    similarity?: number;
+}
+export interface ReflexionQuery {
+    task: string;
+    currentState?: string;
+    k?: number;
+    minReward?: number;
+    onlyFailures?: boolean;
+    onlySuccesses?: boolean;
+    timeWindowDays?: number;
+}
+export declare class ReflexionMemory {
+    private db;
+    private embedder;
+    private vectorBackend?;
+    private learningBackend?;
+    private graphBackend?;
+    constructor(db: Database, embedder: EmbeddingService, vectorBackend?: VectorBackend, learningBackend?: LearningBackend, graphBackend?: GraphBackend);
+    /**
+     * Store a new episode with its critique and outcome
+     */
+    storeEpisode(episode: Episode): Promise<number>;
+    /**
+     * Retrieve relevant past episodes for a new task attempt
+     */
+    retrieveRelevant(query: ReflexionQuery): Promise<EpisodeWithEmbedding[]>;
+    /**
+     * Get statistics for a task
+     */
+    getTaskStats(task: string, timeWindowDays?: number): {
+        totalAttempts: number;
+        successRate: number;
+        avgReward: number;
+        avgLatency: number;
+        improvementTrend: number;
+    };
+    /**
+     * Build critique summary from similar failed episodes
+     */
+    getCritiqueSummary(query: ReflexionQuery): Promise<string>;
+    /**
+     * Get successful strategies for a task
+     */
+    getSuccessStrategies(query: ReflexionQuery): Promise<string>;
+    /**
+     * Get recent episodes for a session
+     */
+    getRecentEpisodes(sessionId: string, limit?: number): Promise<Episode[]>;
+    /**
+     * Prune low-quality episodes based on TTL and quality threshold
+     */
+    pruneEpisodes(config: {
+        minReward?: number;
+        maxAgeDays?: number;
+        keepMinPerTask?: number;
+    }): number;
+    private buildEpisodeText;
+    private storeEmbedding;
+    private serializeEmbedding;
+    private deserializeEmbedding;
+    private cosineSimilarity;
+    /**
+     * Create graph node for episode with relationships
+     */
+    private createEpisodeGraphNode;
+    /**
+     * Enhance query embedding using GNN attention mechanism
+     */
+    private enhanceQueryWithGNN;
+    /**
+     * Get graph-based episode relationships
+     */
+    getEpisodeRelationships(episodeId: number): Promise<{
+        similar: number[];
+        session: string;
+        learnedFrom: number[];
+    }>;
+    /**
+     * Train GNN model on accumulated samples
+     */
+    trainGNN(options?: {
+        epochs?: number;
+    }): Promise<void>;
+    /**
+     * Get learning backend statistics
+     */
+    getLearningStats(): import("../backends/LearningBackend.js").LearningStats | null;
+    /**
+     * Get graph backend statistics
+     */
+    getGraphStats(): import("../backends/GraphBackend.js").GraphStats | null;
+}
+export {};
+//# sourceMappingURL=ReflexionMemory.d.ts.map

package/dist/src/controllers/ReflexionMemory.d.ts.map

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