@vinaes/succ 1.4.0 → 1.5.42

package/dist/lib/storage/dispatcher/base.js

@@ -0,0 +1,160 @@
+import { logError } from '../../fault-logger.js';
+export class StorageDispatcherBase {
+    /** @internal — Used by dispatcher-export.ts. Do not access directly. */
+    backend;
+    /** @internal */
+    vectorBackend;
+    /** @internal */
+    postgres;
+    /** @internal */
+    qdrant;
+    /** @internal */
+    qdrantStore;
+    _sqliteFns = null;
+    // Cross-module methods are mixed in at runtime via applyMixins.
+    // The base stubs provide type shape only and should never be invoked.
+    async getMemoryStats() {
+        throw new Error('StorageDispatcher mixin method getMemoryStats not initialized');
+    }
+    async appendLearningDelta(_delta) {
+        throw new Error('StorageDispatcher mixin method appendLearningDelta not initialized');
+    }
+    async incrementCorrectionCount(_memoryId) {
+        throw new Error('StorageDispatcher mixin method incrementCorrectionCount not initialized');
+    }
+    async setMemoryInvariant(_memoryId, _isInvariant) {
+        throw new Error('StorageDispatcher mixin method setMemoryInvariant not initialized');
+    }
+    async recomputePriorityScore(_memoryId) {
+        throw new Error('StorageDispatcher mixin method recomputePriorityScore not initialized');
+    }
+    async getMemoryEmbeddingsByIds(_ids) {
+        throw new Error('StorageDispatcher mixin method getMemoryEmbeddingsByIds not initialized');
+    }
+    async getMemoryById(_id) {
+        throw new Error('StorageDispatcher mixin method getMemoryById not initialized');
+    }
+    async _guardPinned(_memoryId) {
+        throw new Error('StorageDispatcher mixin method _guardPinned not initialized');
+    }
+    async _filterOutPinned(_ids) {
+        throw new Error('StorageDispatcher mixin method _filterOutPinned not initialized');
+    }
+    // Qdrant circuit breaker — disable after consecutive failures to stop log spam
+    static QDRANT_CIRCUIT_THRESHOLD = 3;
+    _qdrantConsecutiveFailures = 0;
+    _qdrantCircuitOpen = false;
+    // Learning delta auto-tracking counters
+    _sessionCounters = {
+        memoriesCreated: 0,
+        memoriesDuplicated: 0,
+        globalMemoriesCreated: 0,
+        recallQueries: 0,
+        searchQueries: 0,
+        codeSearchQueries: 0,
+        webSearchQueries: 0,
+        webSearchCostUsd: 0,
+        qdrantSyncFailures: 0,
+        typesCreated: {},
+        startedAt: new Date().toISOString(),
+    };
+    constructor(init) {
+        this.backend = init.backend;
+        this.vectorBackend = init.vectorBackend;
+        this.postgres = init.postgres;
+        this.qdrant = init.qdrant;
+        this.qdrantStore = init.qdrant;
+    }
+    /** Reset consecutive failure counter on successful Qdrant operation. */
+    _resetQdrantFailures() {
+        this._qdrantConsecutiveFailures = 0;
+    }
+    /** Log Qdrant failure, increment counter, open circuit breaker after threshold. */
+    _warnQdrantFailure(operation, error) {
+        this._sessionCounters.qdrantSyncFailures++;
+        this._qdrantConsecutiveFailures++;
+        const msg = error instanceof Error ? error.message : String(error);
+        logError('storage', `Qdrant ${operation}: ${msg}`);
+        if (!this._qdrantCircuitOpen &&
+            this._qdrantConsecutiveFailures >= StorageDispatcherBase.QDRANT_CIRCUIT_THRESHOLD) {
+            this._qdrantCircuitOpen = true;
+            logError('storage', `Qdrant circuit breaker opened after ${this._qdrantConsecutiveFailures} consecutive failures — disabled for this session`);
+        }
+    }
+    /** Get current session counters (non-destructive read) */
+    getSessionCounters() {
+        return { ...this._sessionCounters };
+    }
+    /** Flush session counters to learning_deltas table and reset */
+    async flushSessionCounters(source) {
+        const c = this._sessionCounters;
+        const totalCreated = c.memoriesCreated + c.globalMemoriesCreated;
+        if (totalCreated === 0 &&
+            c.recallQueries === 0 &&
+            c.searchQueries === 0 &&
+            c.codeSearchQueries === 0 &&
+            c.webSearchQueries === 0)
+            return;
+        try {
+            const stats = await this.getMemoryStats();
+            await this.appendLearningDelta({
+                timestamp: new Date().toISOString(),
+                source,
+                memoriesBefore: (stats.total_memories ?? 0) - totalCreated,
+                memoriesAfter: stats.total_memories ?? 0,
+                newMemories: totalCreated,
+                typesAdded: c.typesCreated,
+                avgQualityOfNew: null,
+            });
+        }
+        catch (error) {
+            // Don't let flush errors break shutdown
+            logError('storage', 'Failed to flush session counters', error instanceof Error ? error : new Error(String(error)));
+        }
+        this._sessionCounters = {
+            memoriesCreated: 0,
+            memoriesDuplicated: 0,
+            globalMemoriesCreated: 0,
+            recallQueries: 0,
+            searchQueries: 0,
+            codeSearchQueries: 0,
+            webSearchQueries: 0,
+            webSearchCostUsd: 0,
+            qdrantSyncFailures: 0,
+            typesCreated: {},
+            startedAt: new Date().toISOString(),
+        };
+    }
+    /** @internal — Used by dispatcher-export.ts for backend-specific queries. */
+    async getSqliteFns() {
+        if (!this._sqliteFns) {
+            this._sqliteFns = await import('../../db/index.js');
+        }
+        return this._sqliteFns;
+    }
+    toIsoOrNull(value) {
+        if (value == null)
+            return null;
+        if (value instanceof Date)
+            return value.toISOString();
+        if (typeof value === 'string')
+            return value;
+        return null;
+    }
+    /** Check if Qdrant is configured, available, and circuit breaker is closed */
+    hasQdrant() {
+        return this.vectorBackend === 'qdrant' && this.qdrant !== null && !this._qdrantCircuitOpen;
+    }
+    getBackendInfo() {
+        return {
+            backend: this.backend,
+            vector: this.vectorBackend,
+            vectorName: this.vectorBackend === 'qdrant'
+                ? 'qdrant'
+                : this.backend === 'postgresql'
+                    ? 'pgvector'
+                    : 'sqlite-vec',
+        };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/lib/storage/dispatcher/base.js.map

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

package/dist/lib/storage/dispatcher/documents.d.ts

@@ -0,0 +1,25 @@
+import { StorageDispatcherBase } from './base.js';
+import type { RecentDocumentRecord } from '../types.js';
+export declare class DocumentsDispatcherMixin extends StorageDispatcherBase {
+    upsertDocument(filePath: string, chunkIndex: number, content: string, startLine: number, endLine: number, embedding: number[], symbolName?: string, symbolType?: string, signature?: string): Promise<void>;
+    upsertDocumentsBatch(documents: any[]): Promise<void>;
+    upsertDocumentsBatchWithHashes(documents: any[]): Promise<void>;
+    deleteDocumentsByPath(filePath: string): Promise<void>;
+    searchDocuments(queryEmbedding: number[], limit?: number, threshold?: number): Promise<Array<{
+        file_path: string;
+        content: string;
+        start_line: number;
+        end_line: number;
+        similarity: number;
+    }>>;
+    getRecentDocuments(limit?: number): Promise<RecentDocumentRecord[]>;
+    getStats(): Promise<{
+        total_documents: number;
+        total_files: number;
+        last_indexed: string | null;
+    }>;
+    clearDocuments(): Promise<void>;
+    clearCodeDocuments(): Promise<void>;
+    getStoredEmbeddingDimension(): Promise<number | null>;
+}
+//# sourceMappingURL=documents.d.ts.map

package/dist/lib/storage/dispatcher/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/dispatcher/documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,qBAAa,wBAAyB,SAAQ,qBAAqB;IAC3D,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA6CV,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrD,8BAA8B,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/D,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtD,eAAe,CACnB,cAAc,EAAE,MAAM,EAAE,EACxB,KAAK,GAAE,MAAU,EACjB,SAAS,GAAE,MAAY,GACtB,OAAO,CACR,KAAK,CAAC;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CACH;IA0DK,kBAAkB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOvE,QAAQ,IAAI,OAAO,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IAMI,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC,2BAA2B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU5D"}

package/dist/lib/storage/dispatcher/documents.js

@@ -0,0 +1,194 @@
+import { StorageDispatcherBase } from './base.js';
+export class DocumentsDispatcherMixin extends StorageDispatcherBase {
+    async upsertDocument(filePath, chunkIndex, content, startLine, endLine, embedding, symbolName, symbolType, signature) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            const id = await this.postgres.upsertDocument(filePath, chunkIndex, content, startLine, endLine, embedding, symbolName, symbolType, signature);
+            if (this.hasQdrant()) {
+                try {
+                    await this.qdrant.upsertDocumentWithPayload(id, embedding, {
+                        filePath,
+                        content,
+                        startLine,
+                        endLine,
+                        projectId: this.qdrant.getProjectId() ?? '',
+                        symbolName,
+                        symbolType,
+                        signature,
+                    });
+                }
+                catch (error) {
+                    this._warnQdrantFailure(`Failed to sync document vector ${id}`, error);
+                }
+            }
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.upsertDocument(filePath, chunkIndex, content, startLine, endLine, embedding, symbolName, symbolType, signature);
+    }
+    async upsertDocumentsBatch(documents) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            const ids = await this.postgres.upsertDocumentsBatch(documents);
+            if (this.hasQdrant() && ids.length > 0) {
+                try {
+                    const items = documents.map((doc, idx) => ({
+                        id: ids[idx],
+                        embedding: doc.embedding,
+                        meta: {
+                            filePath: doc.filePath,
+                            content: doc.content,
+                            startLine: doc.startLine,
+                            endLine: doc.endLine,
+                            projectId: this.qdrant.getProjectId() ?? '',
+                            symbolName: doc.symbolName,
+                            symbolType: doc.symbolType,
+                            signature: doc.signature,
+                        },
+                    }));
+                    await this.qdrant.upsertDocumentsBatchWithPayload(items);
+                }
+                catch (error) {
+                    this._warnQdrantFailure(`Failed to sync ${ids.length} document vectors`, error);
+                }
+            }
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.upsertDocumentsBatch(documents);
+    }
+    async upsertDocumentsBatchWithHashes(documents) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            const ids = await this.postgres.upsertDocumentsBatchWithHashes(documents);
+            if (this.hasQdrant() && ids.length > 0) {
+                try {
+                    const items = documents.map((doc, idx) => ({
+                        id: ids[idx],
+                        embedding: doc.embedding,
+                        meta: {
+                            filePath: doc.filePath,
+                            content: doc.content,
+                            startLine: doc.startLine,
+                            endLine: doc.endLine,
+                            projectId: this.qdrant.getProjectId() ?? '',
+                            symbolName: doc.symbolName,
+                            symbolType: doc.symbolType,
+                            signature: doc.signature,
+                        },
+                    }));
+                    await this.qdrant.upsertDocumentsBatchWithPayload(items);
+                }
+                catch (error) {
+                    this._warnQdrantFailure(`Failed to sync ${ids.length} document vectors`, error);
+                }
+            }
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.upsertDocumentsBatchWithHashes(documents);
+    }
+    async deleteDocumentsByPath(filePath) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            const deletedIds = await this.postgres.deleteDocumentsByPath(filePath);
+            if (this.vectorBackend === 'qdrant' && this.qdrant && deletedIds.length > 0) {
+                try {
+                    await this.qdrant.deleteDocumentVectorsByIds(deletedIds);
+                }
+                catch (error) {
+                    this._warnQdrantFailure('Failed to delete document vectors', error);
+                }
+            }
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.deleteDocumentsByPath(filePath);
+    }
+    async searchDocuments(queryEmbedding, limit = 5, threshold = 0.5) {
+        if (this.hasQdrant()) {
+            try {
+                // Access Qdrant private methods via property access for backward compatibility
+                const qdrantAny = this.qdrant;
+                const client = await qdrantAny.getClient();
+                const name = qdrantAny.collectionName('documents');
+                const qResults = await client.query(name, {
+                    query: queryEmbedding,
+                    using: 'dense',
+                    limit,
+                    score_threshold: threshold,
+                    params: { hnsw_ef: 128, exact: false },
+                    with_payload: true,
+                });
+                const points = qResults.points ?? qResults;
+                if (points.length > 0 && points[0].payload?.content) {
+                    return points.map((p) => ({
+                        file_path: p.payload?.file_path ?? '',
+                        content: p.payload?.content ?? '',
+                        start_line: p.payload?.start_line ?? 0,
+                        end_line: p.payload?.end_line ?? 0,
+                        similarity: p.score,
+                    }));
+                }
+                if (this.backend === 'postgresql' && this.postgres) {
+                    const results = await this.qdrant.searchDocuments(queryEmbedding, limit * 3, threshold);
+                    if (results.length > 0) {
+                        const pgRows = await this.postgres.getDocumentsByIds(results.map((r) => r.id));
+                        return pgRows
+                            .map((row) => {
+                            const score = results.find((r) => r.id === row.id)?.similarity ?? 0;
+                            return {
+                                file_path: row.file_path,
+                                content: row.content,
+                                start_line: row.start_line,
+                                end_line: row.end_line,
+                                similarity: score,
+                            };
+                        })
+                            .sort((a, b) => b.similarity - a.similarity)
+                            .slice(0, limit);
+                    }
+                }
+            }
+            catch (error) {
+                this._warnQdrantFailure('searchDocuments failed, falling back', error);
+            }
+        }
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.searchDocuments(queryEmbedding, limit, threshold);
+        }
+        const sqlite = await this.getSqliteFns();
+        return sqlite.searchDocuments(queryEmbedding, limit, threshold);
+    }
+    async getRecentDocuments(limit = 10) {
+        if (this.backend === 'postgresql' && this.postgres)
+            return this.postgres.getRecentDocuments(limit);
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getRecentDocuments(limit);
+    }
+    async getStats() {
+        if (this.backend === 'postgresql' && this.postgres)
+            return this.postgres.getDocumentStats();
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getStats();
+    }
+    async clearDocuments() {
+        if (this.backend === 'postgresql' && this.postgres) {
+            await this.postgres.clearDocuments();
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.clearDocuments();
+    }
+    async clearCodeDocuments() {
+        if (this.backend === 'postgresql' && this.postgres) {
+            await this.postgres.clearCodeDocuments();
+            return;
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.clearCodeDocuments();
+    }
+    async getStoredEmbeddingDimension() {
+        if (this.backend === 'postgresql' && this.postgres)
+            return this.postgres.getStoredEmbeddingDimension();
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getStoredEmbeddingDimension();
+    }
+}
+//# sourceMappingURL=documents.js.map

package/dist/lib/storage/dispatcher/documents.js.map

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

package/dist/lib/storage/dispatcher/embeddings.d.ts

@@ -0,0 +1,34 @@
+import { StorageDispatcherBase } from './base.js';
+import type { MemoryType } from '../types.js';
+export declare class EmbeddingsDispatcherMixin extends StorageDispatcherBase {
+    updateMemoryEmbedding(memoryId: number, embedding: number[]): Promise<void>;
+    updateMemoryEmbeddingsBatch(updates: Array<{
+        id: number;
+        embedding: number[];
+    }>): Promise<void>;
+    getMemoriesNeedingReembedding(limit?: number, afterId?: number): Promise<Array<{
+        id: number;
+        content: string;
+    }>>;
+    getMemoryCount(): Promise<number>;
+    getMemoryEmbeddingCount(): Promise<number>;
+    updateMemoryTags(memoryId: number, tags: string[]): Promise<void>;
+    upsertCentralityScore(memoryId: number, degree: number, normalizedDegree: number): Promise<void>;
+    getCentralityScores(memoryIds: number[]): Promise<Map<number, number>>;
+    getAllMemoriesWithEmbeddings(options?: {
+        types?: string[];
+        excludeInvalidated?: boolean;
+    }): Promise<Array<{
+        id: number;
+        content: string;
+        tags: string[];
+        source: string | null;
+        embedding: number[] | null;
+        type: MemoryType | null;
+        quality_score: number | null;
+        created_at: string;
+        invalidated_by: number | null;
+    }>>;
+    getMemoryEmbeddingsByIds(ids: number[]): Promise<Map<number, number[]>>;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/lib/storage/dispatcher/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/dispatcher/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,yBAA0B,SAAQ,qBAAqB;IAC5D,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E,2BAA2B,CAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAUV,6BAA6B,CACjC,KAAK,GAAE,MAAY,EACnB,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAQ5C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQjC,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ1C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjE,qBAAqB,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAQV,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAStE,4BAA4B,CAAC,OAAO,CAAC,EAAE;QAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GAAG,OAAO,CACT,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC3B,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;QACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC,CACH;IAsDK,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CA4C9E"}

package/dist/lib/storage/dispatcher/embeddings.js

@@ -0,0 +1,144 @@
+import { StorageDispatcherBase } from './base.js';
+export class EmbeddingsDispatcherMixin extends StorageDispatcherBase {
+    async updateMemoryEmbedding(memoryId, embedding) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.updateMemoryEmbedding(memoryId, embedding);
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.updateMemoryEmbedding(memoryId, embedding);
+    }
+    async updateMemoryEmbeddingsBatch(updates) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.updateMemoryEmbeddingsBatch(updates);
+        }
+        const sqlite = await this.getSqliteFns();
+        for (const { id, embedding } of updates) {
+            sqlite.updateMemoryEmbedding(id, embedding);
+        }
+    }
+    async getMemoriesNeedingReembedding(limit = 100, afterId = 0) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.getMemoriesNeedingReembedding(limit, afterId);
+        }
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getMemoriesNeedingReembedding(limit, afterId);
+    }
+    async getMemoryCount() {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.getMemoryCount();
+        }
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getMemoryCount();
+    }
+    async getMemoryEmbeddingCount() {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.getMemoryEmbeddingCount();
+        }
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getMemoryEmbeddingCount();
+    }
+    async updateMemoryTags(memoryId, tags) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.updateMemoryTags(memoryId, tags);
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.updateMemoryTags(memoryId, tags);
+    }
+    async upsertCentralityScore(memoryId, degree, normalizedDegree) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.upsertCentralityScore(memoryId, degree, normalizedDegree);
+        }
+        const sqlite = await this.getSqliteFns();
+        sqlite.upsertCentralityScore(memoryId, degree, normalizedDegree);
+    }
+    async getCentralityScores(memoryIds) {
+        if (memoryIds.length === 0)
+            return new Map();
+        if (this.backend === 'postgresql' && this.postgres) {
+            return this.postgres.getCentralityScores(memoryIds);
+        }
+        const sqlite = await this.getSqliteFns();
+        return sqlite.getCentralityScores(memoryIds);
+    }
+    async getAllMemoriesWithEmbeddings(options) {
+        if (this.backend === 'postgresql' && this.postgres) {
+            const rows = await this.postgres.getAllMemoriesWithEmbeddings();
+            let result = rows.map((r) => ({
+                id: r.id,
+                content: r.content,
+                tags: typeof r.tags === 'string' ? JSON.parse(r.tags) : (r.tags ?? []),
+                source: r.source ?? null,
+                embedding: r.embedding ?? null,
+                type: r.type ?? null,
+                quality_score: r.qualityScore ?? r.quality_score ?? null,
+                created_at: r.createdAt ?? r.created_at ?? new Date().toISOString(),
+                invalidated_by: r.invalidatedBy ?? r.invalidated_by ?? null,
+            }));
+            if (options?.excludeInvalidated)
+                result = result.filter((r) => r.invalidated_by == null);
+            if (options?.types?.length)
+                result = result.filter((r) => r.type != null && options.types.includes(r.type));
+            return result;
+        }
+        const sqlite = await this.getSqliteFns();
+        const db = sqlite.getDb();
+        let sql = `SELECT id, content, tags, source, embedding, type, quality_score, created_at, invalidated_by FROM memories`;
+        const conditions = [];
+        if (options?.excludeInvalidated)
+            conditions.push('invalidated_by IS NULL');
+        if (options?.types?.length) {
+            const placeholders = options.types.map(() => '?').join(', ');
+            conditions.push(`type IN (${placeholders})`);
+        }
+        if (conditions.length)
+            sql += ' WHERE ' + conditions.join(' AND ');
+        sql += ' ORDER BY id ASC';
+        const params = options?.types?.length ? options.types : [];
+        const rows = db.prepare(sql).all(...params);
+        return rows.map((row) => ({
+            id: row.id,
+            content: row.content,
+            tags: row.tags ? JSON.parse(row.tags) : [],
+            source: row.source,
+            embedding: row.embedding
+                ? Array.from(new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4))
+                : null,
+            type: row.type ?? null,
+            quality_score: row.quality_score,
+            created_at: row.created_at,
+            invalidated_by: row.invalidated_by ?? null,
+        }));
+    }
+    async getMemoryEmbeddingsByIds(ids) {
+        if (ids.length === 0)
+            return new Map();
+        if (this.backend === 'postgresql' && this.postgres) {
+            const pool = await this.postgres.getPool();
+            const placeholders = ids.map((_, i) => `$${i + 1}`).join(',');
+            const { rows } = await pool.query(`SELECT id, embedding::text FROM memories WHERE id IN (${placeholders})`, ids);
+            const map = new Map();
+            for (const row of rows) {
+                if (row.embedding) {
+                    // pgvector returns embedding as JSON array string "[0.1,0.2,...]"
+                    const vec = JSON.parse(row.embedding);
+                    map.set(row.id, vec);
+                }
+            }
+            return map;
+        }
+        const sqlite = await this.getSqliteFns();
+        const db = sqlite.getDb();
+        const placeholders = ids.map(() => '?').join(',');
+        const rows = db
+            .prepare(`SELECT id, embedding FROM memories WHERE id IN (${placeholders})`)
+            .all(...ids);
+        const map = new Map();
+        for (const row of rows) {
+            if (row.embedding) {
+                map.set(row.id, Array.from(new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4)));
+            }
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/lib/storage/dispatcher/embeddings.js.map

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