@framers/agentos 0.1.126 → 0.1.127

package/dist/rag/search/BM25Index.js

@@ -25,7 +25,7 @@
  * @see HybridSearcher for combining BM25 with dense vector search
  */
 // ── Stop Words ────────────────────────────────────────────────────────────
-import { getNaturalStopWords } from '../../core/text-processing/filters/StopWordFilter.js';
+import { getNaturalStopWords } from '../../nlp/filters/StopWordFilter.js';
 /**
  * Stop words used by the fallback regex tokenizer (when no pipeline is configured).
  * Uses `natural`'s 170-word list when available, falls back to the built-in

package/dist/rag/search/BM25Index.js.map

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

package/dist/rag/unified/UnifiedRetriever.d.ts

@@ -60,7 +60,7 @@ import type { RaptorTree } from '../raptor/RaptorTree.js';
 import type { HydeRetriever } from '../HydeRetriever.js';
 import type { ICognitiveMemoryManager } from '../../memory/CognitiveMemoryManager.js';
 import type { MultimodalIndexer } from '../multimodal/MultimodalIndexer.js';
-import type { IGraphRAGEngine } from '../graphrag/IGraphRAG.js';
+import type { IGraphRAGEngine } from '../../memory/retrieval/graph/graphrag/IGraphRAG.js';
 /**
  * Dependencies injected into the {@link UnifiedRetriever}.
  *

package/dist/rag/unified/UnifiedRetriever.d.ts.map

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

package/dist/rag/vector-search/HnswIndexSidecar.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Shared HNSW index sidecar that sits alongside a SQLite database.
+ * Provides O(log n) approximate nearest neighbor search via hnswlib-node,
+ * with automatic activation at a configurable document count threshold
+ * and graceful fallback when the native addon is unavailable.
+ *
+ * Used by both the RAG system (SqlVectorStore) and the Memory system (SqliteBrain).
+ *
+ * @module agentos/rag/vector-search/HnswIndexSidecar
+ */
+import type { HnswSidecarConfig, HnswSidecarStats, HnswSearchResult } from './types';
+/**
+ * HNSW index sidecar — manages an hnswlib-node index file alongside
+ * a primary data store (SQLite, etc.).
+ *
+ * The primary store remains the source of truth. The HNSW index is
+ * rebuildable from it at any time. This sidecar handles:
+ * - Dynamic import of hnswlib-node (graceful if missing)
+ * - Auto-activation at document count threshold
+ * - Auto-resize when capacity is reached
+ * - Persistence to disk (.hnsw + .hnsw.map.json)
+ * - Dirty tracking with explicit save()
+ */
+export declare class HnswIndexSidecar {
+    private config;
+    private index;
+    private hnswlib;
+    /** Maps HNSW integer labels → document string IDs. */
+    private labelToId;
+    /** Maps document string IDs → HNSW integer labels. */
+    private idToLabel;
+    /** Next label to assign. */
+    private nextLabel;
+    /** Current index capacity. */
+    private capacity;
+    /** Whether index has unsaved changes. */
+    private dirty;
+    /** Whether hnswlib-node was successfully imported. */
+    private hnswAvailable;
+    /**
+     * Initialize the sidecar. Attempts to dynamically import hnswlib-node.
+     * If the import fails, the sidecar stays inactive (brute-force fallback).
+     * If an existing index file is found, it's loaded from disk.
+     */
+    initialize(config: HnswSidecarConfig): Promise<void>;
+    /** Persist and release the index. */
+    shutdown(): Promise<void>;
+    /** True when the index is loaded AND has vectors (above threshold or loaded from disk). */
+    isActive(): boolean;
+    /** True when hnswlib-node was successfully imported. */
+    isAvailable(): boolean;
+    /** Get statistics about the sidecar. */
+    getStats(): HnswSidecarStats;
+    /**
+     * Add a single vector. Auto-resizes if capacity is reached.
+     * Does nothing if hnswlib is unavailable or the item is already indexed.
+     */
+    add(id: string, embedding: number[]): Promise<void>;
+    /**
+     * Add multiple vectors at once. More efficient than calling add() in a loop.
+     */
+    addBatch(items: Array<{
+        id: string;
+        embedding: number[];
+    }>): Promise<void>;
+    /**
+     * Upsert a single vector into an active index.
+     * Replaces the previous vector when the ID already exists.
+     */
+    upsert(id: string, embedding: number[]): Promise<void>;
+    /**
+     * Upsert multiple vectors, replacing existing IDs in place.
+     */
+    upsertBatch(items: Array<{
+        id: string;
+        embedding: number[];
+    }>): Promise<void>;
+    /**
+     * Soft-delete a vector by marking its label as deleted in the HNSW graph.
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Soft-delete multiple vectors in one pass.
+     */
+    removeBatch(ids: string[]): Promise<void>;
+    /**
+     * Search for the top-K nearest neighbors.
+     * Returns empty if the sidecar is inactive.
+     */
+    search(query: number[], topK: number): Promise<HnswSearchResult[]>;
+    /**
+     * Full rebuild of the HNSW index from source-of-truth data.
+     * Called when the activation threshold is crossed or on manual rebuild.
+     */
+    rebuildFromData(items: Array<{
+        id: string;
+        embedding: number[];
+    }>): Promise<void>;
+    /** Save the HNSW index and label map to disk. */
+    save(): Promise<void>;
+    /**
+     * Load an existing HNSW index from disk.
+     * Returns true if loaded successfully, false if no index exists.
+     */
+    load(): Promise<boolean>;
+}
+//# sourceMappingURL=HnswIndexSidecar.d.ts.map

package/dist/rag/vector-search/HnswIndexSidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HnswIndexSidecar.d.ts","sourceRoot":"","sources":["../../../src/rag/vector-search/HnswIndexSidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAkBjB;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAa;IAE5B,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAkC;IACnD,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAkC;IACnD,4BAA4B;IAC5B,OAAO,CAAC,SAAS,CAAa;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAa;IAC7B,yCAAyC;IACzC,OAAO,CAAC,KAAK,CAAkB;IAC/B,sDAAsD;IACtD,OAAO,CAAC,aAAa,CAAkB;IAIvC;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1D,qCAAqC;IAC/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,2FAA2F;IAC3F,QAAQ,IAAI,OAAO;IAInB,wDAAwD;IACxD,WAAW,IAAI,OAAO;IAItB,wCAAwC;IACxC,QAAQ,IAAI,gBAAgB;IAY5B;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzD;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhF;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnF;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkCxE;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvF,iDAAiD;IAC3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAkC/B"}

package/dist/rag/vector-search/HnswIndexSidecar.js

@@ -0,0 +1,298 @@
+/**
+ * @fileoverview Shared HNSW index sidecar that sits alongside a SQLite database.
+ * Provides O(log n) approximate nearest neighbor search via hnswlib-node,
+ * with automatic activation at a configurable document count threshold
+ * and graceful fallback when the native addon is unavailable.
+ *
+ * Used by both the RAG system (SqlVectorStore) and the Memory system (SqliteBrain).
+ *
+ * @module agentos/rag/vector-search/HnswIndexSidecar
+ */
+import * as fs from 'fs/promises';
+/** Default HNSW parameters matching the literature recommendations. */
+const DEFAULTS = {
+    activationThreshold: 1000,
+    hnswM: 16,
+    hnswEfConstruction: 200,
+    hnswEfSearch: 50,
+    capacityIncrement: 1000,
+};
+/** hnswlib-node space type mapping. */
+const METRIC_TO_SPACE = {
+    cosine: 'cosine',
+    euclidean: 'l2',
+    dotproduct: 'ip',
+};
+/**
+ * HNSW index sidecar — manages an hnswlib-node index file alongside
+ * a primary data store (SQLite, etc.).
+ *
+ * The primary store remains the source of truth. The HNSW index is
+ * rebuildable from it at any time. This sidecar handles:
+ * - Dynamic import of hnswlib-node (graceful if missing)
+ * - Auto-activation at document count threshold
+ * - Auto-resize when capacity is reached
+ * - Persistence to disk (.hnsw + .hnsw.map.json)
+ * - Dirty tracking with explicit save()
+ */
+export class HnswIndexSidecar {
+    constructor() {
+        this.index = null;
+        this.hnswlib = null;
+        /** Maps HNSW integer labels → document string IDs. */
+        this.labelToId = new Map();
+        /** Maps document string IDs → HNSW integer labels. */
+        this.idToLabel = new Map();
+        /** Next label to assign. */
+        this.nextLabel = 0;
+        /** Current index capacity. */
+        this.capacity = 0;
+        /** Whether index has unsaved changes. */
+        this.dirty = false;
+        /** Whether hnswlib-node was successfully imported. */
+        this.hnswAvailable = false;
+    }
+    /* ---- Lifecycle ------------------------------------------------- */
+    /**
+     * Initialize the sidecar. Attempts to dynamically import hnswlib-node.
+     * If the import fails, the sidecar stays inactive (brute-force fallback).
+     * If an existing index file is found, it's loaded from disk.
+     */
+    async initialize(config) {
+        this.config = {
+            ...config,
+            activationThreshold: config.activationThreshold ?? DEFAULTS.activationThreshold,
+            hnswM: config.hnswM ?? DEFAULTS.hnswM,
+            hnswEfConstruction: config.hnswEfConstruction ?? DEFAULTS.hnswEfConstruction,
+            hnswEfSearch: config.hnswEfSearch ?? DEFAULTS.hnswEfSearch,
+        };
+        try {
+            this.hnswlib = await import('../../index.js');
+            this.hnswAvailable = true;
+        }
+        catch {
+            this.hnswAvailable = false;
+            return;
+        }
+        /* Try loading existing index from disk */
+        await this.load();
+    }
+    /** Persist and release the index. */
+    async shutdown() {
+        if (this.dirty)
+            await this.save();
+        this.index = null;
+        this.labelToId.clear();
+        this.idToLabel.clear();
+        this.nextLabel = 0;
+        this.capacity = 0;
+    }
+    /* ---- State ----------------------------------------------------- */
+    /** True when the index is loaded AND has vectors (above threshold or loaded from disk). */
+    isActive() {
+        return this.index !== null && this.labelToId.size > 0;
+    }
+    /** True when hnswlib-node was successfully imported. */
+    isAvailable() {
+        return this.hnswAvailable;
+    }
+    /** Get statistics about the sidecar. */
+    getStats() {
+        return {
+            active: this.isActive(),
+            available: this.hnswAvailable,
+            vectorCount: this.labelToId.size,
+            capacity: this.capacity,
+            indexPath: this.config?.indexPath ?? '',
+        };
+    }
+    /* ---- Operations ------------------------------------------------ */
+    /**
+     * Add a single vector. Auto-resizes if capacity is reached.
+     * Does nothing if hnswlib is unavailable or the item is already indexed.
+     */
+    async add(id, embedding) {
+        if (!this.hnswAvailable)
+            return;
+        if (this.idToLabel.has(id))
+            return;
+        if (!this.index) {
+            /* Don't create index until threshold is crossed via rebuildFromData */
+            return;
+        }
+        /* Auto-resize */
+        if (this.nextLabel >= this.capacity) {
+            this.capacity += DEFAULTS.capacityIncrement;
+            this.index.resizeIndex(this.capacity);
+        }
+        const label = this.nextLabel++;
+        this.index.addPoint(embedding, label);
+        this.labelToId.set(label, id);
+        this.idToLabel.set(id, label);
+        this.dirty = true;
+    }
+    /**
+     * Add multiple vectors at once. More efficient than calling add() in a loop.
+     */
+    async addBatch(items) {
+        for (const item of items) {
+            await this.add(item.id, item.embedding);
+        }
+    }
+    /**
+     * Upsert a single vector into an active index.
+     * Replaces the previous vector when the ID already exists.
+     */
+    async upsert(id, embedding) {
+        if (!this.hnswAvailable)
+            return;
+        if (this.idToLabel.has(id)) {
+            await this.remove(id);
+        }
+        await this.add(id, embedding);
+    }
+    /**
+     * Upsert multiple vectors, replacing existing IDs in place.
+     */
+    async upsertBatch(items) {
+        for (const item of items) {
+            await this.upsert(item.id, item.embedding);
+        }
+    }
+    /**
+     * Soft-delete a vector by marking its label as deleted in the HNSW graph.
+     */
+    async remove(id) {
+        if (!this.index)
+            return;
+        const label = this.idToLabel.get(id);
+        if (label === undefined)
+            return;
+        this.index.markDelete(label);
+        this.labelToId.delete(label);
+        this.idToLabel.delete(id);
+        this.dirty = true;
+    }
+    /**
+     * Soft-delete multiple vectors in one pass.
+     */
+    async removeBatch(ids) {
+        for (const id of ids) {
+            await this.remove(id);
+        }
+    }
+    /**
+     * Search for the top-K nearest neighbors.
+     * Returns empty if the sidecar is inactive.
+     */
+    async search(query, topK) {
+        if (!this.index || this.labelToId.size === 0)
+            return [];
+        const k = Math.min(topK, this.labelToId.size);
+        const { neighbors, distances } = this.index.searchKnn(query, k);
+        const results = [];
+        for (let i = 0; i < neighbors.length; i++) {
+            const label = neighbors[i];
+            const id = this.labelToId.get(label);
+            if (!id)
+                continue;
+            /* Convert distance to similarity score */
+            let score;
+            switch (this.config.metric) {
+                case 'cosine':
+                    score = 1 - distances[i];
+                    break;
+                case 'euclidean':
+                    score = -distances[i];
+                    break;
+                case 'dotproduct':
+                    score = -distances[i];
+                    break;
+                default:
+                    score = 1 - distances[i];
+            }
+            results.push({ id, score });
+        }
+        return results.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Full rebuild of the HNSW index from source-of-truth data.
+     * Called when the activation threshold is crossed or on manual rebuild.
+     */
+    async rebuildFromData(items) {
+        if (!this.hnswAvailable || items.length === 0)
+            return;
+        const space = METRIC_TO_SPACE[this.config.metric] ?? 'cosine';
+        this.capacity = items.length + DEFAULTS.capacityIncrement;
+        const HierarchicalNSW = this.hnswlib.HierarchicalNSW ?? this.hnswlib.default?.HierarchicalNSW;
+        this.index = new HierarchicalNSW(space, this.config.dimensions);
+        this.index.initIndex(this.capacity, this.config.hnswM, this.config.hnswEfConstruction);
+        this.index.setEf(this.config.hnswEfSearch);
+        this.labelToId.clear();
+        this.idToLabel.clear();
+        this.nextLabel = 0;
+        for (const item of items) {
+            const label = this.nextLabel++;
+            this.index.addPoint(item.embedding, label);
+            this.labelToId.set(label, item.id);
+            this.idToLabel.set(item.id, label);
+        }
+        this.dirty = true;
+        await this.save();
+    }
+    /* ---- Persistence ----------------------------------------------- */
+    /** Save the HNSW index and label map to disk. */
+    async save() {
+        if (!this.index || !this.dirty)
+            return;
+        try {
+            this.index.writeIndex(this.config.indexPath);
+            const mapData = {
+                nextLabel: this.nextLabel,
+                capacity: this.capacity,
+                entries: Array.from(this.labelToId.entries()),
+            };
+            await fs.writeFile(`${this.config.indexPath}.map.json`, JSON.stringify(mapData), 'utf8');
+            this.dirty = false;
+        }
+        catch (err) {
+            /* Best-effort persistence — index is rebuildable from source of truth */
+            console.warn(`HnswIndexSidecar: failed to save index to ${this.config.indexPath}:`, err);
+        }
+    }
+    /**
+     * Load an existing HNSW index from disk.
+     * Returns true if loaded successfully, false if no index exists.
+     */
+    async load() {
+        if (!this.hnswAvailable)
+            return false;
+        try {
+            await fs.access(this.config.indexPath);
+            await fs.access(`${this.config.indexPath}.map.json`);
+        }
+        catch {
+            return false; /* No index files on disk */
+        }
+        try {
+            const mapJson = await fs.readFile(`${this.config.indexPath}.map.json`, 'utf8');
+            const mapData = JSON.parse(mapJson);
+            const space = METRIC_TO_SPACE[this.config.metric] ?? 'cosine';
+            const HierarchicalNSW = this.hnswlib.HierarchicalNSW ?? this.hnswlib.default?.HierarchicalNSW;
+            this.index = new HierarchicalNSW(space, this.config.dimensions);
+            this.index.readIndex(this.config.indexPath);
+            this.index.setEf(this.config.hnswEfSearch);
+            this.nextLabel = mapData.nextLabel;
+            this.capacity = mapData.capacity;
+            this.labelToId = new Map(mapData.entries);
+            this.idToLabel = new Map(mapData.entries.map(([label, id]) => [id, label]));
+            this.dirty = false;
+            return true;
+        }
+        catch (err) {
+            console.warn(`HnswIndexSidecar: failed to load index from ${this.config.indexPath}:`, err);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=HnswIndexSidecar.js.map

package/dist/rag/vector-search/HnswIndexSidecar.js.map

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

package/dist/rag/vector-search/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Shared vector search utilities — HNSW index sidecar.
+ * @module agentos/rag/vector-search
+ */
+export { HnswIndexSidecar } from './HnswIndexSidecar';
+export type { HnswSidecarConfig, HnswSidecarStats, HnswSearchResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/rag/vector-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rag/vector-search/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/rag/vector-search/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Shared vector search utilities — HNSW index sidecar.
+ * @module agentos/rag/vector-search
+ */
+export { HnswIndexSidecar } from './HnswIndexSidecar.js';
+//# sourceMappingURL=index.js.map

package/dist/rag/vector-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rag/vector-search/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/rag/vector-search/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Types for the HNSW index sidecar.
+ * @module agentos/rag/vector-search/types
+ */
+/** Configuration for {@link HnswIndexSidecar}. */
+export interface HnswSidecarConfig {
+    /** Path to the HNSW index file (e.g. `/path/to/data.hnsw`). */
+    indexPath: string;
+    /** Embedding dimensions (e.g. 1536 for OpenAI, 768 for smaller models). */
+    dimensions: number;
+    /** Distance metric for similarity computation. */
+    metric: 'cosine' | 'euclidean' | 'dotproduct';
+    /** Document count threshold before HNSW activates (default 1000). Below this, brute-force is used. */
+    activationThreshold: number;
+    /** HNSW M parameter — connections per node (default 16). Higher = more accuracy, more memory. */
+    hnswM?: number;
+    /** HNSW efConstruction — build-time search width (default 200). Higher = better index quality. */
+    hnswEfConstruction?: number;
+    /** HNSW efSearch — query-time search width (default 50). Higher = more accuracy, slower queries. */
+    hnswEfSearch?: number;
+}
+/** Statistics from an HNSW sidecar instance. */
+export interface HnswSidecarStats {
+    /** Whether the sidecar is actively serving queries. */
+    active: boolean;
+    /** Whether hnswlib-node is importable on this platform. */
+    available: boolean;
+    /** Number of vectors in the index. */
+    vectorCount: number;
+    /** Current index capacity. */
+    capacity: number;
+    /** Path to the index file. */
+    indexPath: string;
+}
+/** A single search result from the HNSW index. */
+export interface HnswSearchResult {
+    /** Document ID. */
+    id: string;
+    /** Similarity score (higher = more similar for cosine/dot, lower = closer for euclidean). */
+    score: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/vector-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/vector-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;IAC9C,sGAAsG;IACtG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/rag/vector-search/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Types for the HNSW index sidecar.
+ * @module agentos/rag/vector-search/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/vector-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rag/vector-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}