@claude-flow/memory 3.0.7 → 3.0.8

package/dist/agentdb-hnsw-adapter.js

@@ -0,0 +1,151 @@
+export class AgentDBHnswAdapter {
+    Index;
+    config;
+    index;
+    ids = new Map();
+    revision = 0;
+    building;
+    searching = Promise.resolve();
+    failed = false;
+    buildTime = 0;
+    constructor(Index, config) {
+        this.Index = Index;
+        this.config = config;
+        // hnswlib-node coerces these values to uint32, rather than validating them.
+        const uint = (value) => Number.isInteger(value) && value > 0 && value <= 0xffffffff;
+        this.failed = !uint(config.dimension) || !uint(config.efConstruction) ||
+            !uint(config.efSearch) || !uint(config.M) || config.M < 2 || config.M > 10000;
+    }
+    normalize(vector) {
+        // Accumulate in JS double precision: the native cosine implementation can
+        // overflow/underflow its float32 norm even when all coordinates are finite.
+        let squaredNorm = 0;
+        for (const value of vector)
+            squaredNorm += value * value;
+        const norm = Math.sqrt(squaredNorm);
+        return Float32Array.from(vector, (value) => norm === 0 ? 0 : value / norm);
+    }
+    invalidate() {
+        this.revision++;
+        // An in-flight search owns its old instance until it completes. Do not
+        // clear that instance beneath it; the revision check rejects stale results.
+        this.index = undefined;
+        this.ids = new Map();
+    }
+    async build(getEntries) {
+        if (this.failed)
+            return false;
+        if (this.index)
+            return true;
+        if (this.building)
+            return this.building;
+        const revision = this.revision;
+        const vectors = getEntries().filter((entry) => entry.embedding);
+        if (vectors.length === 0)
+            return false;
+        // Never feed malformed data to a native addon. Preserve fallback behavior
+        // for callers whose embedding dimensions do not match the configured index.
+        if (vectors.some(({ embedding }) => embedding.length !== this.config.dimension ||
+            !embedding.every(Number.isFinite)))
+            return false;
+        const ids = new Map(vectors.map((entry, id) => [id, entry.id]));
+        const rows = vectors.map((entry, id) => ({
+            id,
+            embedding: this.normalize(entry.embedding),
+        }));
+        this.building = (async () => {
+            try {
+                // HNSWIndex reads this one fixed query. No user-controlled SQL, tables,
+                // filters, native persistence sidecars, or shared AgentDB controller.
+                const db = {
+                    prepare(sql) {
+                        if (sql.replace(/\s+/g, ' ').trim() !==
+                            'SELECT pattern_id as id, embedding FROM pattern_embeddings') {
+                            throw new Error('Unsupported HNSW snapshot query');
+                        }
+                        return { all: () => rows };
+                    },
+                };
+                const candidate = new this.Index(db, {
+                    ...this.config,
+                    metric: 'cosine',
+                    persistIndex: false,
+                    // Do not preallocate the backend's million-entry default capacity.
+                    maxElements: rows.length,
+                });
+                const start = performance.now();
+                await candidate.buildIndex();
+                if (revision !== this.revision || !candidate.isReady())
+                    return false;
+                this.buildTime = performance.now() - start;
+                this.index = candidate;
+                this.ids = ids;
+                return true;
+            }
+            catch {
+                // A missing/incompatible native addon must not break semantic search or
+                // throw/log the same exception on every request. Retry on reinitialize.
+                this.failed = true;
+                return false;
+            }
+        })();
+        try {
+            return await this.building;
+        }
+        finally {
+            this.building = undefined;
+        }
+    }
+    async search(getEntries, embedding, k, ef) {
+        embedding = new Float32Array(embedding);
+        if (!Number.isInteger(k) || k <= 0 || k > 0xffffffff ||
+            embedding.length !== this.config.dimension ||
+            !embedding.every(Number.isFinite))
+            return undefined;
+        const query = this.normalize(embedding);
+        if (!await this.build(getEntries))
+            return undefined;
+        const index = this.index;
+        const ids = this.ids;
+        const revision = this.revision;
+        if (!index)
+            return undefined;
+        // Upstream search awaits initialize() before touching the native index.
+        // Serialize calls so per-query ef cannot be changed by another request.
+        const result = this.searching.then(async () => {
+            if (revision !== this.revision || this.failed)
+                return undefined;
+            try {
+                const expansion = ef ?? this.config.efSearch;
+                if (Number.isInteger(expansion) && expansion > 0 && expansion <= 0xffffffff &&
+                    expansion !== index.getStats().efSearch) {
+                    index.setEfSearch(expansion);
+                }
+                const results = await index.search(query, Math.min(k, ids.size));
+                if (revision !== this.revision)
+                    return undefined;
+                return results.map((result) => ids.get(result.id)).filter((id) => id !== undefined);
+            }
+            catch {
+                this.failed = true;
+                this.invalidate();
+                return undefined;
+            }
+        });
+        this.searching = result;
+        return result;
+    }
+    getStats() {
+        if (!this.index?.isReady() || this.failed)
+            return undefined;
+        const stats = this.index.getStats();
+        return {
+            vectorCount: stats.numElements,
+            memoryUsage: 0, // Native allocation size is not exposed by agentdb.
+            avgSearchTime: stats.avgSearchTimeMs,
+            buildTime: this.buildTime,
+            compressionRatio: 1,
+        };
+    }
+}
+//# sourceMappingURL=agentdb-hnsw-adapter.js.map

package/dist/agentdb-hnsw-adapter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/memory",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "type": "module",
   "description": "Memory module - AgentDB unification, HNSW indexing, vector search, hybrid SQLite+AgentDB backend (ADR-009)",
   "main": "dist/index.js",