agentdb 3.0.0-alpha.2 → 3.0.0-alpha.20

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

@@ -26,7 +26,7 @@ export interface Episode {
     latencyMs?: number;
     tokensUsed?: number;
     tags?: string[];
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, any>;
 }
 export interface EpisodeWithEmbedding extends Episode {
     embedding?: Float32Array;
@@ -52,6 +52,13 @@ export declare class ReflexionMemory {
     /**
      * Store a new episode with its critique and outcome
      * Invalidates relevant cache entries
+     *
+     * Persistence guarantee (issue #128 fix):
+     *   storeEpisode() always writes to the SQLite `episodes` and
+     *   `episode_embeddings` tables when a SQL-capable connection is present,
+     *   even when a graph or vector backend handles the primary index. This
+     *   ensures data survives process restarts (graph/vector backends are
+     *   often in-memory or rebuildable from SQL).
      */
     storeEpisode(episode: Episode): Promise<number>;
     /**
@@ -193,5 +200,48 @@ export declare class ReflexionMemory {
      * Warm cache with common queries
      */
     warmCache(sessionId?: string): Promise<void>;
+    /**
+     * Delete an episode by id. Closes the gap from issue #150 (downstream:
+     * ruflo#1784, RuVector#427) — once an episode is written there was no
+     * first-class way to remove it through any backend.
+     *
+     * Strategy mirrors storeEpisode: when a graph backend is present we go
+     * through it (`graphAdapter.deleteNode` / `graphBackend.deleteNode` —
+     * both Cypher-backed under the hood), and we ALWAYS also purge the SQL
+     * `episodes` and `episode_embeddings` rows so durable storage stays in
+     * sync. Vector backend entries are removed too when present.
+     *
+     * @returns True if the episode existed in any backend and was removed.
+     */
+    deleteEpisode(id: number | string): Promise<boolean>;
+    /**
+     * Dual-write helper for issue #128.
+     *
+     * Inserts the given episode into the SQLite `episodes` and
+     * `episode_embeddings` tables when the underlying connection supports it.
+     * Used when a graph or vector backend handles the primary index but the
+     * caller still wants restart-safe persistence.
+     *
+     * Errors are swallowed and logged — the primary write to the graph/vector
+     * backend has already succeeded, and we don't want to fail the caller if
+     * SQL persistence is unavailable (e.g. read-only DB, schema not present).
+     */
+    private dualWriteEpisodeToSQL;
+    /**
+     * Rebuild the in-memory vector index from the SQLite `episodes` /
+     * `episode_embeddings` tables, going through the proper backend channels
+     * so `retrieveRelevant()` sees the data afterwards.
+     *
+     * Fixes the user's recovery use-case from issue #129: rather than calling
+     * `vectorBackend.getInner().insert()` directly (which bypasses the
+     * GuardedBackend wrapper and confuses retrieveRelevant), call this method
+     * to re-hydrate the vector and graph indices from durable storage.
+     *
+     * Returns the number of episodes re-indexed. No-ops cleanly when the SQL
+     * tables are empty or absent.
+     */
+    rebuildIndex(options?: {
+        fromTimestamp?: number;
+    }): Promise<number>;
 }
 //# sourceMappingURL=ReflexionMemory.d.ts.map

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

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

package/dist/src/controllers/ReflexionMemory.js

@@ -10,7 +10,17 @@
 import { normalizeRowId } from '../types/database.types.js';
 import { NodeIdMapper } from '../utils/NodeIdMapper.js';
 import { QueryCache } from '../core/QueryCache.js';
-import { cosineSimilarity } from '../utils/similarity.js';
+/** Parse JSON from DB row values without throwing on malformed data. */
+function safeJsonParse(value, fallback) {
+    if (!value)
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}
 export class ReflexionMemory {
     db;
     embedder;
@@ -29,6 +39,13 @@ export class ReflexionMemory {
     /**
      * Store a new episode with its critique and outcome
      * Invalidates relevant cache entries
+     *
+     * Persistence guarantee (issue #128 fix):
+     *   storeEpisode() always writes to the SQLite `episodes` and
+     *   `episode_embeddings` tables when a SQL-capable connection is present,
+     *   even when a graph or vector backend handles the primary index. This
+     *   ensures data survives process restarts (graph/vector backends are
+     *   often in-memory or rebuildable from SQL).
      */
     async storeEpisode(episode) {
         // Invalidate episode caches on write
@@ -39,7 +56,7 @@ export class ReflexionMemory {
             // GraphDatabaseAdapter has specialized storeEpisode method
             const graphAdapter = this.graphBackend;
             // Generate embedding for the task
-            const taskEmbedding = await this.embedder.embed(episode.task);
+            const taskEmbedding = await this.embedder.embedPassage(episode.task);
             // Create episode node using GraphDatabaseAdapter
             const nodeId = await graphAdapter.storeEpisode({
                 id: episode.id ? `episode-${episode.id}` : `episode-${Date.now()}-${Math.random()}`,
@@ -58,12 +75,15 @@ export class ReflexionMemory {
             const numericId = parseInt(nodeId.split('-').pop() || '0', 36);
             // Register mapping for later use by CausalMemoryGraph
             NodeIdMapper.getInstance().register(numericId, nodeId);
+            // #128: dual-write to SQL for restart-safe persistence. Graph adapter
+            // index is typically in-memory; SQL is the durable record.
+            this.dualWriteEpisodeToSQL(episode, taskEmbedding);
             return numericId;
         }
         // Use generic GraphBackend if available
         if (this.graphBackend) {
             // Generate embedding for the task
-            const taskEmbedding = await this.embedder.embed(episode.task);
+            const taskEmbedding = await this.embedder.embedPassage(episode.task);
             // Create episode node ID
             const nodeId = await this.graphBackend.createNode(['Episode'], {
                 sessionId: episode.sessionId,
@@ -90,6 +110,8 @@ export class ReflexionMemory {
             const numericId = parseInt(nodeId.split('-').pop() || '0', 36);
             // Register mapping for later use by CausalMemoryGraph
             NodeIdMapper.getInstance().register(numericId, nodeId);
+            // #128: dual-write to SQL for restart-safe persistence.
+            this.dualWriteEpisodeToSQL(episode, taskEmbedding);
             return numericId;
         }
         // Fallback to SQLite (v1 compatibility)
@@ -105,7 +127,7 @@ export class ReflexionMemory {
         const episodeId = normalizeRowId(result.lastInsertRowid);
         // Generate and store embedding
         const text = this.buildEpisodeText(episode);
-        const embedding = await this.embedder.embed(text);
+        const embedding = await this.embedder.embedPassage(text);
         // Use vector backend if available (150x faster retrieval)
         if (this.vectorBackend) {
             this.vectorBackend.insert(episodeId.toString(), embedding);
@@ -169,7 +191,7 @@ export class ReflexionMemory {
      */
     async prepareQueryEmbedding(task, currentState, k) {
         const queryText = currentState ? `${task}\n${currentState}` : task;
-        let queryEmbedding = await this.embedder.embed(queryText);
+        let queryEmbedding = await this.embedder.embedQuery(queryText);
         // Enhance query with GNN if learning backend available
         if (this.learningBackend) {
             queryEmbedding = await this.enhanceQueryWithGNN(queryEmbedding, k);
@@ -184,9 +206,8 @@ export class ReflexionMemory {
         const graphAdapter = this.graphBackend;
         // Search using vector similarity
         const results = await graphAdapter.searchSimilarEpisodes(queryEmbedding, k * 3);
-        // Apply filters (cast from graph results to typed format)
-        const typedResults = results;
-        const filtered = this.applyEpisodeFilters(typedResults, {
+        // Apply filters
+        const filtered = this.applyEpisodeFilters(results, {
             minReward,
             onlyFailures,
             onlySuccesses,
@@ -371,25 +392,24 @@ export class ReflexionMemory {
      * Convert Cypher query result to EpisodeWithEmbedding
      */
     convertCypherEpisode(node) {
-        const props = node.properties;
         return {
             id: parseInt(node.id.split('-').pop() || '0', 36),
-            sessionId: props.sessionId,
-            task: props.task,
-            input: props.input,
-            output: props.output,
-            critique: props.critique,
-            reward: typeof props.reward === 'string'
-                ? parseFloat(props.reward)
-                : props.reward,
-            success: typeof props.success === 'string'
-                ? props.success === 'true'
-                : props.success,
-            latencyMs: props.latencyMs,
-            tokensUsed: props.tokensUsed,
-            tags: props.tags ? JSON.parse(props.tags) : [],
-            metadata: props.metadata ? JSON.parse(props.metadata) : {},
-            ts: Math.floor(props.createdAt / 1000),
+            sessionId: node.properties.sessionId,
+            task: node.properties.task,
+            input: node.properties.input,
+            output: node.properties.output,
+            critique: node.properties.critique,
+            reward: typeof node.properties.reward === 'string'
+                ? parseFloat(node.properties.reward)
+                : node.properties.reward,
+            success: typeof node.properties.success === 'string'
+                ? node.properties.success === 'true'
+                : node.properties.success,
+            latencyMs: node.properties.latencyMs,
+            tokensUsed: node.properties.tokensUsed,
+            tags: safeJsonParse(node.properties.tags, []),
+            metadata: safeJsonParse(node.properties.metadata, {}),
+            ts: Math.floor(node.properties.createdAt / 1000),
         };
     }
     /**
@@ -408,8 +428,8 @@ export class ReflexionMemory {
             success: row.success === 1,
             latencyMs: row.latency_ms ?? undefined,
             tokensUsed: row.tokens_used ?? undefined,
-            tags: row.tags ? JSON.parse(row.tags) : undefined,
-            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            tags: safeJsonParse(row.tags, undefined),
+            metadata: safeJsonParse(row.metadata, undefined),
             embedding,
             similarity,
         };
@@ -450,7 +470,7 @@ export class ReflexionMemory {
       WHERE task = ? ${windowFilter}
     `);
         const trend = trendStmt.get(task);
-        const improvementTrend = trend?.recent_reward && trend?.older_reward
+        const improvementTrend = trend.recent_reward && trend.older_reward
             ? (trend.recent_reward - trend.older_reward) / trend.older_reward
             : 0;
         const results = {
@@ -544,8 +564,8 @@ export class ReflexionMemory {
             success: row.success === 1,
             latencyMs: row.latency_ms ?? undefined,
             tokensUsed: row.tokens_used ?? undefined,
-            tags: row.tags ? JSON.parse(row.tags) : undefined,
-            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            tags: safeJsonParse(row.tags, undefined),
+            metadata: safeJsonParse(row.metadata, undefined),
         }));
     }
     /**
@@ -607,7 +627,15 @@ export class ReflexionMemory {
         return new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
     }
     cosineSimilarity(a, b) {
-        return cosineSimilarity(a, b);
+        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];
+        }
+        return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
     }
     // ========================================================================
     // GNN and Graph Integration Methods
@@ -799,13 +827,259 @@ export class ReflexionMemory {
      * Warm cache with common queries
      */
     async warmCache(sessionId) {
-        await this.queryCache.warm(async (_cache) => {
+        await this.queryCache.warm(async (cache) => {
             // Warm cache with recent sessions if sessionId provided
             if (sessionId) {
-                await this.getRecentEpisodes(sessionId, 10);
+                const recent = await this.getRecentEpisodes(sessionId, 10);
                 // Episodes are already loaded, cache will be populated on next access
             }
         });
     }
+    /**
+     * Delete an episode by id. Closes the gap from issue #150 (downstream:
+     * ruflo#1784, RuVector#427) — once an episode is written there was no
+     * first-class way to remove it through any backend.
+     *
+     * Strategy mirrors storeEpisode: when a graph backend is present we go
+     * through it (`graphAdapter.deleteNode` / `graphBackend.deleteNode` —
+     * both Cypher-backed under the hood), and we ALWAYS also purge the SQL
+     * `episodes` and `episode_embeddings` rows so durable storage stays in
+     * sync. Vector backend entries are removed too when present.
+     *
+     * @returns True if the episode existed in any backend and was removed.
+     */
+    async deleteEpisode(id) {
+        const numericId = typeof id === 'number' ? id : parseInt(String(id), 10);
+        const stringId = String(id);
+        // Invalidate caches up front — failures below shouldn't leave stale reads.
+        this.queryCache.invalidateCategory('episodes');
+        this.queryCache.invalidateCategory('task-stats');
+        let removed = false;
+        // 1. Graph adapter (AgentDB v2 fast path)
+        if (this.graphBackend && 'storeEpisode' in this.graphBackend) {
+            const adapter = this.graphBackend;
+            if (typeof adapter.deleteNode === 'function') {
+                try {
+                    // Adapter accepts either the canonical "episode-<id>" key or a raw
+                    // id; try the canonical form first since that's what storeEpisode
+                    // emits.
+                    const r = await adapter.deleteNode(`episode-${numericId}`, { cascade: true });
+                    if (r?.deletedNode)
+                        removed = true;
+                    if (!removed) {
+                        const r2 = await adapter.deleteNode(stringId, { cascade: true });
+                        if (r2?.deletedNode)
+                            removed = true;
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    // eslint-disable-next-line no-console
+                    console.warn(`[ReflexionMemory] deleteEpisode: graph adapter delete failed: ${msg}`);
+                }
+            }
+        }
+        // 2. Generic graph backend
+        else if (this.graphBackend && typeof this.graphBackend.deleteNode === 'function') {
+            try {
+                const r = await this.graphBackend.deleteNode(stringId);
+                if (r === true)
+                    removed = true;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // eslint-disable-next-line no-console
+                console.warn(`[ReflexionMemory] deleteEpisode: graph backend delete failed: ${msg}`);
+            }
+        }
+        // 3. Vector backend (HNSW/RuVector); some implementations don't expose
+        //    delete — guard with a feature check.
+        if (this.vectorBackend && typeof this.vectorBackend.delete === 'function') {
+            try {
+                const r = await this.vectorBackend.delete(String(numericId));
+                if (r === true)
+                    removed = true;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // eslint-disable-next-line no-console
+                console.warn(`[ReflexionMemory] deleteEpisode: vector backend delete failed: ${msg}`);
+            }
+        }
+        // 4. SQL durable storage — always attempt so persistence stays clean
+        //    even when the primary backend was a no-op.
+        if (this.db && typeof this.db.prepare === 'function' && Number.isFinite(numericId)) {
+            try {
+                const embStmt = this.db.prepare(`DELETE FROM episode_embeddings WHERE episode_id = ?`);
+                embStmt.run(numericId);
+                const stmt = this.db.prepare(`DELETE FROM episodes WHERE id = ?`);
+                const r = stmt.run(numericId);
+                const changes = r?.changes ?? 0;
+                if (changes > 0)
+                    removed = true;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (!/no such table/i.test(msg)) {
+                    // eslint-disable-next-line no-console
+                    console.warn(`[ReflexionMemory] deleteEpisode: SQL delete failed: ${msg}`);
+                }
+            }
+        }
+        return removed;
+    }
+    /**
+     * Dual-write helper for issue #128.
+     *
+     * Inserts the given episode into the SQLite `episodes` and
+     * `episode_embeddings` tables when the underlying connection supports it.
+     * Used when a graph or vector backend handles the primary index but the
+     * caller still wants restart-safe persistence.
+     *
+     * Errors are swallowed and logged — the primary write to the graph/vector
+     * backend has already succeeded, and we don't want to fail the caller if
+     * SQL persistence is unavailable (e.g. read-only DB, schema not present).
+     */
+    dualWriteEpisodeToSQL(episode, embedding) {
+        if (!this.db || typeof this.db.prepare !== 'function')
+            return;
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO episodes (
+          session_id, task, input, output, critique, reward, success,
+          latency_ms, tokens_used, tags, metadata
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            const tags = episode.tags ? JSON.stringify(episode.tags) : null;
+            const metadata = episode.metadata ? JSON.stringify(episode.metadata) : null;
+            const result = stmt.run(episode.sessionId, episode.task, episode.input ?? null, episode.output ?? null, episode.critique ?? null, episode.reward, episode.success ? 1 : 0, episode.latencyMs ?? null, episode.tokensUsed ?? null, tags, metadata);
+            if (embedding) {
+                const episodeId = normalizeRowId(result.lastInsertRowid);
+                this.storeEmbedding(episodeId, embedding);
+            }
+        }
+        catch (err) {
+            // The expected failure here is "no such table: episodes" on databases
+            // that intentionally don't carry the v1 schema. Don't escalate — the
+            // primary backend already has the data.
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!/no such table/i.test(msg)) {
+                // eslint-disable-next-line no-console
+                console.warn('[ReflexionMemory] dualWriteEpisodeToSQL failed:', msg);
+            }
+        }
+    }
+    /**
+     * Rebuild the in-memory vector index from the SQLite `episodes` /
+     * `episode_embeddings` tables, going through the proper backend channels
+     * so `retrieveRelevant()` sees the data afterwards.
+     *
+     * Fixes the user's recovery use-case from issue #129: rather than calling
+     * `vectorBackend.getInner().insert()` directly (which bypasses the
+     * GuardedBackend wrapper and confuses retrieveRelevant), call this method
+     * to re-hydrate the vector and graph indices from durable storage.
+     *
+     * Returns the number of episodes re-indexed. No-ops cleanly when the SQL
+     * tables are empty or absent.
+     */
+    async rebuildIndex(options = {}) {
+        if (!this.db || typeof this.db.prepare !== 'function')
+            return 0;
+        const where = options.fromTimestamp !== undefined ? 'WHERE e.ts >= ?' : '';
+        const params = options.fromTimestamp !== undefined ? [options.fromTimestamp] : [];
+        let rows = [];
+        try {
+            const stmt = this.db.prepare(`
+        SELECT
+          e.id, e.ts, e.session_id, e.task, e.input, e.output, e.critique,
+          e.reward, e.success, e.latency_ms, e.tokens_used, e.tags, e.metadata,
+          ee.embedding
+        FROM episodes e
+        LEFT JOIN episode_embeddings ee ON ee.episode_id = e.id
+        ${where}
+        ORDER BY e.id ASC
+      `);
+            rows = stmt.all(...params);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/no such table/i.test(msg))
+                return 0;
+            throw err;
+        }
+        let reindexed = 0;
+        for (const row of rows) {
+            const episode = {
+                id: row.id,
+                ts: row.ts,
+                sessionId: row.session_id,
+                task: row.task,
+                input: row.input ?? undefined,
+                output: row.output ?? undefined,
+                critique: row.critique ?? undefined,
+                reward: row.reward,
+                success: row.success === 1,
+                latencyMs: row.latency_ms ?? undefined,
+                tokensUsed: row.tokens_used ?? undefined,
+                tags: safeJsonParse(row.tags, undefined),
+                metadata: safeJsonParse(row.metadata, undefined),
+            };
+            // Prefer the stored embedding; fall back to recomputing if missing.
+            let embedding;
+            if (row.embedding) {
+                const buf = row.embedding;
+                embedding = new Float32Array(buf.buffer, buf.byteOffset, buf.length / 4);
+            }
+            else {
+                embedding = await this.embedder.embedPassage(this.buildEpisodeText(episode));
+            }
+            // Re-insert through the proper public APIs so the GuardedBackend
+            // wrapper, graph adapter, and HNSW all stay in sync.
+            if (this.vectorBackend) {
+                try {
+                    this.vectorBackend.insert(String(row.id), embedding, {
+                        type: 'episode',
+                        sessionId: episode.sessionId,
+                        reward: episode.reward,
+                        success: episode.success,
+                    });
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    // eslint-disable-next-line no-console
+                    console.warn(`[ReflexionMemory] rebuildIndex: vector insert failed for ${row.id}: ${msg}`);
+                }
+            }
+            if (this.graphBackend && 'storeEpisode' in this.graphBackend) {
+                const adapter = this.graphBackend;
+                try {
+                    await adapter.storeEpisode({
+                        id: `episode-${row.id}`,
+                        sessionId: episode.sessionId,
+                        task: episode.task,
+                        reward: episode.reward,
+                        success: episode.success,
+                        input: episode.input,
+                        output: episode.output,
+                        critique: episode.critique,
+                        createdAt: (episode.ts ?? Date.now() / 1000) * 1000,
+                        tokensUsed: episode.tokensUsed,
+                        latencyMs: episode.latencyMs,
+                    }, embedding);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    // eslint-disable-next-line no-console
+                    console.warn(`[ReflexionMemory] rebuildIndex: graph store failed for ${row.id}: ${msg}`);
+                }
+            }
+            reindexed++;
+        }
+        // Bust any stale read caches so the next retrieveRelevant sees the
+        // freshly-rebuilt index.
+        this.queryCache.invalidateCategory('episodes');
+        this.queryCache.invalidateCategory('task-stats');
+        return reindexed;
+    }
 }
 //# sourceMappingURL=ReflexionMemory.js.map