@framers/agentos 0.1.119 → 0.1.120

package/dist/memory/store/HnswSidecar.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview HNSW sidecar index for SqliteBrain.
+ * @module memory/store/HnswSidecar
+ *
+ * Maintains an HNSW index file alongside brain.sqlite for O(log n)
+ * approximate nearest neighbor search. SQLite remains the source of
+ * truth; the HNSW index is rebuildable from SQLite data at any time.
+ *
+ * Auto-activates when trace count exceeds threshold (default: 1000).
+ * Below that, brute-force cosine in the Memory facade is fast enough.
+ *
+ * Architecture:
+ * ```
+ * ~/.wunderland/agents/{name}/
+ *   ├── brain.sqlite   ← source of truth
+ *   └── brain.hnsw     ← HNSW index (rebuildable)
+ *        brain.hnsw.map.json ← label↔id mapping
+ * ```
+ */
+export interface HnswSidecarConfig {
+    /** Path to brain.sqlite — HNSW file will be at same dir with .hnsw extension. */
+    sqlitePath: string;
+    /** Embedding dimensions. */
+    dimensions: number;
+    /** Auto-build threshold. Below this count, brute-force is used. @default 1000 */
+    autoThreshold?: number;
+    /** HNSW M parameter (connections per node). @default 16 */
+    m?: number;
+    /** HNSW efConstruction (build quality). @default 200 */
+    efConstruction?: number;
+    /** HNSW efSearch (query quality). @default 50 */
+    efSearch?: number;
+}
+/** Result from a KNN query. */
+export interface HnswQueryResult {
+    /** Trace ID. */
+    id: string;
+    /** Distance from query vector (lower = closer for cosine distance). */
+    distance: number;
+}
+export declare class HnswSidecar {
+    private index;
+    private HierarchicalNSW;
+    private readonly indexPath;
+    private readonly mapPath;
+    private readonly config;
+    /** Maps HNSW internal integer labels → trace ID strings. */
+    private labelToId;
+    /** Maps trace ID strings → HNSW internal integer labels. */
+    private idToLabel;
+    private nextLabel;
+    private _isActive;
+    private _hnswAvailable;
+    constructor(config: HnswSidecarConfig);
+    /** Whether the HNSW index is currently active and queryable. */
+    get isActive(): boolean;
+    /** Number of vectors currently indexed. */
+    get size(): number;
+    /**
+     * Initialize the sidecar. Loads existing index from disk if present.
+     * If hnswlib-node is not installed, silently stays inactive.
+     */
+    init(): Promise<void>;
+    /**
+     * Add a vector to the index. If below threshold, does nothing.
+     * If threshold is crossed, caller should call rebuildFromData().
+     *
+     * @param traceId    - The trace ID to associate with this vector.
+     * @param embedding  - The embedding vector.
+     * @param totalCount - Current total trace count (to check threshold).
+     */
+    add(traceId: string, embedding: number[], totalCount: number): Promise<void>;
+    /**
+     * Query the HNSW index for top-K nearest neighbors.
+     * Returns trace IDs sorted by distance (closest first).
+     *
+     * @param embedding - Query vector.
+     * @param topK      - Number of results to return.
+     * @returns Array of { id, distance } sorted by distance ascending.
+     */
+    query(embedding: number[], topK: number): HnswQueryResult[];
+    /**
+     * Remove a trace from the index by marking its label as deleted.
+     * HNSW doesn't support true deletion — cleaned up on rebuild.
+     *
+     * @param traceId - The trace ID to remove.
+     */
+    remove(traceId: string): void;
+    /**
+     * Rebuild the entire index from a set of id/embedding pairs.
+     * Called on first threshold crossing or when brain.hnsw is missing/corrupt.
+     *
+     * @param data - Array of { id, embedding } to index.
+     */
+    rebuildFromData(data: {
+        id: string;
+        embedding: number[];
+    }[]): Promise<void>;
+    /**
+     * Persist index and label map to disk.
+     * Called after rebuildFromData() and periodically after adds.
+     */
+    saveToDisk(): void;
+    /**
+     * Delete index files from disk and deactivate.
+     */
+    destroy(): void;
+    /** Try to load hnswlib-node. Returns false if not installed. */
+    private _ensureHnswlib;
+    /** Load index + label map from disk. */
+    private _loadFromDisk;
+    /** Persist index + label map to disk. */
+    private _saveToDisk;
+}
+//# sourceMappingURL=HnswSidecar.d.ts.map

package/dist/memory/store/HnswSidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HnswSidecar.d.ts","sourceRoot":"","sources":["../../../src/memory/store/HnswSidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IAErD,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAkC;IACnD,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAwB;gBAElC,MAAM,EAAE,iBAAiB;IAYrC,gEAAgE;IAChE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,2CAA2C;IAC3C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlF;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAqB3D;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAa7B;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjF;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;IAkBf,gEAAgE;YAClD,cAAc;IAe5B,wCAAwC;YAC1B,aAAa;IAuB3B,yCAAyC;IACzC,OAAO,CAAC,WAAW;CAepB"}

package/dist/memory/store/HnswSidecar.js

@@ -0,0 +1,256 @@
+/**
+ * @fileoverview HNSW sidecar index for SqliteBrain.
+ * @module memory/store/HnswSidecar
+ *
+ * Maintains an HNSW index file alongside brain.sqlite for O(log n)
+ * approximate nearest neighbor search. SQLite remains the source of
+ * truth; the HNSW index is rebuildable from SQLite data at any time.
+ *
+ * Auto-activates when trace count exceeds threshold (default: 1000).
+ * Below that, brute-force cosine in the Memory facade is fast enough.
+ *
+ * Architecture:
+ * ```
+ * ~/.wunderland/agents/{name}/
+ *   ├── brain.sqlite   ← source of truth
+ *   └── brain.hnsw     ← HNSW index (rebuildable)
+ *        brain.hnsw.map.json ← label↔id mapping
+ * ```
+ */
+import { existsSync, unlinkSync, writeFileSync, readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// HnswSidecar
+// ---------------------------------------------------------------------------
+export class HnswSidecar {
+    constructor(config) {
+        this.index = null; // HierarchicalNSW instance (dynamic import)
+        this.HierarchicalNSW = null; // Constructor reference
+        /** Maps HNSW internal integer labels → trace ID strings. */
+        this.labelToId = new Map();
+        /** Maps trace ID strings → HNSW internal integer labels. */
+        this.idToLabel = new Map();
+        this.nextLabel = 0;
+        this._isActive = false;
+        this._hnswAvailable = null;
+        this.config = {
+            autoThreshold: 1000,
+            m: 16,
+            efConstruction: 200,
+            efSearch: 50,
+            ...config,
+        };
+        this.indexPath = join(dirname(this.config.sqlitePath), 'brain.hnsw');
+        this.mapPath = this.indexPath + '.map.json';
+    }
+    /** Whether the HNSW index is currently active and queryable. */
+    get isActive() {
+        return this._isActive;
+    }
+    /** Number of vectors currently indexed. */
+    get size() {
+        return this.labelToId.size;
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Initialize the sidecar. Loads existing index from disk if present.
+     * If hnswlib-node is not installed, silently stays inactive.
+     */
+    async init() {
+        if (!(await this._ensureHnswlib()))
+            return;
+        if (existsSync(this.indexPath) && existsSync(this.mapPath)) {
+            try {
+                await this._loadFromDisk();
+            }
+            catch {
+                // Corrupt index — will rebuild when threshold is reached
+                this._isActive = false;
+                this.index = null;
+            }
+        }
+    }
+    /**
+     * Add a vector to the index. If below threshold, does nothing.
+     * If threshold is crossed, caller should call rebuildFromData().
+     *
+     * @param traceId    - The trace ID to associate with this vector.
+     * @param embedding  - The embedding vector.
+     * @param totalCount - Current total trace count (to check threshold).
+     */
+    async add(traceId, embedding, totalCount) {
+        if (!this._isActive) {
+            // If we just crossed the threshold, caller needs to rebuildFromData()
+            if (totalCount >= this.config.autoThreshold)
+                return;
+            return;
+        }
+        if (!this.index)
+            return;
+        if (this.idToLabel.has(traceId))
+            return; // Already indexed
+        // Resize if needed
+        const currentMax = this.index.getMaxElements();
+        if (this.nextLabel >= currentMax) {
+            this.index.resizeIndex(currentMax + 1000);
+        }
+        const label = this.nextLabel++;
+        this.index.addPoint(embedding, label);
+        this.labelToId.set(label, traceId);
+        this.idToLabel.set(traceId, label);
+    }
+    /**
+     * Query the HNSW index for top-K nearest neighbors.
+     * Returns trace IDs sorted by distance (closest first).
+     *
+     * @param embedding - Query vector.
+     * @param topK      - Number of results to return.
+     * @returns Array of { id, distance } sorted by distance ascending.
+     */
+    query(embedding, topK) {
+        if (!this._isActive || !this.index)
+            return [];
+        const currentCount = this.index.getCurrentCount();
+        if (currentCount === 0)
+            return [];
+        const k = Math.min(topK, currentCount);
+        const result = this.index.searchKnn(embedding, k);
+        const hits = [];
+        for (let i = 0; i < result.neighbors.length; i++) {
+            const label = result.neighbors[i];
+            const id = this.labelToId.get(label);
+            if (id) {
+                hits.push({ id, distance: result.distances[i] });
+            }
+        }
+        return hits;
+    }
+    /**
+     * Remove a trace from the index by marking its label as deleted.
+     * HNSW doesn't support true deletion — cleaned up on rebuild.
+     *
+     * @param traceId - The trace ID to remove.
+     */
+    remove(traceId) {
+        const label = this.idToLabel.get(traceId);
+        if (label !== undefined && this.index) {
+            try {
+                this.index.markDelete(label);
+            }
+            catch {
+                // markDelete may not be available in all hnswlib-node versions
+            }
+            this.labelToId.delete(label);
+            this.idToLabel.delete(traceId);
+        }
+    }
+    /**
+     * Rebuild the entire index from a set of id/embedding pairs.
+     * Called on first threshold crossing or when brain.hnsw is missing/corrupt.
+     *
+     * @param data - Array of { id, embedding } to index.
+     */
+    async rebuildFromData(data) {
+        if (data.length === 0)
+            return;
+        if (!(await this._ensureHnswlib()))
+            return;
+        const dim = this.config.dimensions;
+        this.index = new this.HierarchicalNSW('cosine', dim);
+        this.index.initIndex(Math.max(data.length + 1000, data.length * 1.2 | 0), this.config.m, this.config.efConstruction);
+        this.index.setEf(this.config.efSearch);
+        this.labelToId.clear();
+        this.idToLabel.clear();
+        this.nextLabel = 0;
+        for (const { id, embedding } of data) {
+            if (embedding.length !== dim)
+                continue; // Skip dimension mismatches
+            const label = this.nextLabel++;
+            this.index.addPoint(embedding, label);
+            this.labelToId.set(label, id);
+            this.idToLabel.set(id, label);
+        }
+        this._isActive = true;
+        this._saveToDisk();
+    }
+    /**
+     * Persist index and label map to disk.
+     * Called after rebuildFromData() and periodically after adds.
+     */
+    saveToDisk() {
+        this._saveToDisk();
+    }
+    /**
+     * Delete index files from disk and deactivate.
+     */
+    destroy() {
+        this._isActive = false;
+        this.index = null;
+        this.labelToId.clear();
+        this.idToLabel.clear();
+        this.nextLabel = 0;
+        try {
+            if (existsSync(this.indexPath))
+                unlinkSync(this.indexPath);
+            if (existsSync(this.mapPath))
+                unlinkSync(this.mapPath);
+        }
+        catch {
+            // Best effort cleanup
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    /** Try to load hnswlib-node. Returns false if not installed. */
+    async _ensureHnswlib() {
+        if (this._hnswAvailable === true)
+            return true;
+        if (this._hnswAvailable === false)
+            return false;
+        try {
+            const mod = await import('hnswlib-node');
+            this.HierarchicalNSW = mod.HierarchicalNSW;
+            this._hnswAvailable = true;
+            return true;
+        }
+        catch {
+            this._hnswAvailable = false;
+            return false;
+        }
+    }
+    /** Load index + label map from disk. */
+    async _loadFromDisk() {
+        if (!(await this._ensureHnswlib()))
+            return;
+        const dim = this.config.dimensions;
+        this.index = new this.HierarchicalNSW('cosine', dim);
+        this.index.readIndexSync(this.indexPath);
+        this.index.setEf(this.config.efSearch);
+        // Load label map
+        const raw = readFileSync(this.mapPath, 'utf-8');
+        const data = JSON.parse(raw);
+        this.labelToId = new Map(data.labelToId);
+        this.idToLabel = new Map(data.labelToId.map(([label, id]) => [id, label]));
+        this.nextLabel = data.nextLabel ?? this.labelToId.size;
+        this._isActive = true;
+    }
+    /** Persist index + label map to disk. */
+    _saveToDisk() {
+        if (!this.index)
+            return;
+        try {
+            this.index.writeIndexSync(this.indexPath);
+            writeFileSync(this.mapPath, JSON.stringify({
+                labelToId: Array.from(this.labelToId.entries()),
+                nextLabel: this.nextLabel,
+            }));
+        }
+        catch {
+            // Best effort — index can always be rebuilt from SQLite
+        }
+    }
+}
+//# sourceMappingURL=HnswSidecar.js.map

package/dist/memory/store/HnswSidecar.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.119",
+  "version": "0.1.120",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",
@@ -217,6 +217,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/natural": "^5.1.5",
     "@types/node": "^20.12.12",
+    "better-sqlite3": "^12.4.1",
     "conventional-changelog-conventionalcommits": "^7.0.2",
     "eslint": "^9.11.0",
     "eslint-config-prettier": "^9.1.0",