agentdb 1.6.1 → 2.0.0-alpha.2

package/dist/src/benchmarks/wasm-vector-benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-vector-benchmark.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/wasm-vector-benchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/benchmarks/wasm-vector-benchmark.js

@@ -0,0 +1,196 @@
+/**
+ * WASM Vector Operations Benchmark
+ *
+ * Measures actual performance improvements of WASM-accelerated vector operations
+ * compared to pure JavaScript implementations.
+ *
+ * Run with: npx tsx src/benchmarks/wasm-vector-benchmark.ts
+ */
+import { WASMVectorSearch } from '../controllers/WASMVectorSearch.js';
+class VectorBenchmark {
+    dimensions;
+    vectorCount;
+    constructor(dimensions = 384, vectorCount = 1000) {
+        this.dimensions = dimensions;
+        this.vectorCount = vectorCount;
+    }
+    /**
+     * Generate random normalized vector
+     */
+    generateRandomVector() {
+        const vector = new Float32Array(this.dimensions);
+        let norm = 0;
+        for (let i = 0; i < this.dimensions; i++) {
+            vector[i] = Math.random() * 2 - 1;
+            norm += vector[i] * vector[i];
+        }
+        norm = Math.sqrt(norm);
+        for (let i = 0; i < this.dimensions; i++) {
+            vector[i] /= norm;
+        }
+        return vector;
+    }
+    /**
+     * Pure JavaScript cosine similarity (baseline)
+     */
+    cosineSimilarityJS(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];
+        }
+        const denom = Math.sqrt(normA) * Math.sqrt(normB);
+        return denom === 0 ? 0 : dotProduct / denom;
+    }
+    /**
+     * Benchmark cosine similarity (pure JS)
+     */
+    async benchmarkJSSimilarity(iterations = 10000) {
+        const vectorA = this.generateRandomVector();
+        const vectorB = this.generateRandomVector();
+        const start = performance.now();
+        for (let i = 0; i < iterations; i++) {
+            this.cosineSimilarityJS(vectorA, vectorB);
+        }
+        const duration = performance.now() - start;
+        return {
+            name: 'Cosine Similarity (Pure JS)',
+            operations: iterations,
+            duration,
+            opsPerSecond: (iterations / duration) * 1000,
+            avgLatency: duration / iterations,
+        };
+    }
+    /**
+     * Benchmark cosine similarity (WASM-accelerated)
+     */
+    async benchmarkWASMSimilarity(iterations = 10000) {
+        const mockDb = {
+            prepare: () => ({ all: () => [], get: () => null, run: () => ({}) }),
+            exec: () => { },
+        };
+        const wasmSearch = new WASMVectorSearch(mockDb, { enableWASM: true });
+        const vectorA = this.generateRandomVector();
+        const vectorB = this.generateRandomVector();
+        const start = performance.now();
+        for (let i = 0; i < iterations; i++) {
+            wasmSearch.cosineSimilarity(vectorA, vectorB);
+        }
+        const duration = performance.now() - start;
+        return {
+            name: 'Cosine Similarity (WASM-Optimized)',
+            operations: iterations,
+            duration,
+            opsPerSecond: (iterations / duration) * 1000,
+            avgLatency: duration / iterations,
+        };
+    }
+    /**
+     * Benchmark batch similarity operations
+     */
+    async benchmarkBatchSimilarity() {
+        const mockDb = {
+            prepare: () => ({ all: () => [], get: () => null, run: () => ({}) }),
+            exec: () => { },
+        };
+        const wasmSearch = new WASMVectorSearch(mockDb, { enableWASM: true });
+        const query = this.generateRandomVector();
+        const vectors = [];
+        for (let i = 0; i < this.vectorCount; i++) {
+            vectors.push(this.generateRandomVector());
+        }
+        const start = performance.now();
+        wasmSearch.batchSimilarity(query, vectors);
+        const duration = performance.now() - start;
+        return {
+            name: 'Batch Similarity Search',
+            operations: this.vectorCount,
+            duration,
+            opsPerSecond: (this.vectorCount / duration) * 1000,
+            avgLatency: duration / this.vectorCount,
+        };
+    }
+    /**
+     * Benchmark k-NN search
+     */
+    async benchmarkKNNSearch(k = 10) {
+        const mockDb = {
+            prepare: () => ({ all: () => [], get: () => null, run: () => ({}) }),
+            exec: () => { },
+        };
+        const wasmSearch = new WASMVectorSearch(mockDb, { enableWASM: true });
+        const query = this.generateRandomVector();
+        const vectors = [];
+        const ids = [];
+        for (let i = 0; i < this.vectorCount; i++) {
+            vectors.push(this.generateRandomVector());
+            ids.push(i);
+        }
+        // Build index
+        wasmSearch.buildIndex(vectors, ids);
+        const start = performance.now();
+        wasmSearch.searchIndex(query, k);
+        const duration = performance.now() - start;
+        return {
+            name: `k-NN Search (k=${k}, n=${this.vectorCount})`,
+            operations: 1,
+            duration,
+            opsPerSecond: (1 / duration) * 1000,
+            avgLatency: duration,
+        };
+    }
+    /**
+     * Run all benchmarks
+     */
+    async runAll() {
+        console.log('='.repeat(80));
+        console.log('WASM Vector Operations Benchmark');
+        console.log('='.repeat(80));
+        console.log(`Configuration: ${this.dimensions}D vectors, ${this.vectorCount} dataset size\n`);
+        const results = [];
+        // Cosine similarity benchmarks
+        console.log('Running similarity benchmarks...');
+        const jsResult = await this.benchmarkJSSimilarity();
+        results.push(jsResult);
+        const wasmResult = await this.benchmarkWASMSimilarity();
+        results.push(wasmResult);
+        const speedup = wasmResult.opsPerSecond / jsResult.opsPerSecond;
+        console.log(`  Speedup: ${speedup.toFixed(2)}x\n`);
+        // Batch similarity
+        console.log('Running batch similarity benchmark...');
+        const batchResult = await this.benchmarkBatchSimilarity();
+        results.push(batchResult);
+        // k-NN search
+        console.log('Running k-NN search benchmark...');
+        const knnResult = await this.benchmarkKNNSearch();
+        results.push(knnResult);
+        // Print results table
+        console.log('\n' + '='.repeat(80));
+        console.log('Results:');
+        console.log('='.repeat(80));
+        console.log('Benchmark'.padEnd(40) +
+            'Operations'.padStart(12) +
+            'Duration (ms)'.padStart(15) +
+            'Ops/sec'.padStart(15));
+        console.log('-'.repeat(80));
+        results.forEach(result => {
+            console.log(result.name.padEnd(40) +
+                result.operations.toLocaleString().padStart(12) +
+                result.duration.toFixed(2).padStart(15) +
+                result.opsPerSecond.toLocaleString(undefined, { maximumFractionDigits: 0 }).padStart(15));
+        });
+        console.log('='.repeat(80));
+        console.log('\nKey Findings:');
+        console.log(`- WASM provides ${speedup.toFixed(2)}x speedup for cosine similarity`);
+        console.log(`- Batch processing: ${batchResult.opsPerSecond.toFixed(0)} vectors/sec`);
+        console.log(`- k-NN search latency: ${knnResult.avgLatency.toFixed(2)}ms`);
+        console.log('='.repeat(80));
+    }
+}
+// Run benchmarks
+const benchmark = new VectorBenchmark(384, 1000);
+benchmark.runAll().catch(console.error);
+//# sourceMappingURL=wasm-vector-benchmark.js.map

package/dist/src/benchmarks/wasm-vector-benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-vector-benchmark.js","sourceRoot":"","sources":["../../../src/benchmarks/wasm-vector-benchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAUtE,MAAM,eAAe;IACX,UAAU,CAAS;IACnB,WAAW,CAAS;IAE5B,YAAY,aAAqB,GAAG,EAAE,cAAsB,IAAI;QAC9D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACpB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,CAAe,EAAE,CAAe;QACzD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,aAAqB,KAAK;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,6BAA6B;YACnC,UAAU,EAAE,UAAU;YACtB,QAAQ;YACR,YAAY,EAAE,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI;YAC5C,UAAU,EAAE,QAAQ,GAAG,UAAU;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAAC,aAAqB,KAAK;QACtD,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACpE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;SACf,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,oCAAoC;YAC1C,UAAU,EAAE,UAAU;YACtB,QAAQ;YACR,YAAY,EAAE,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI;YAC5C,UAAU,EAAE,QAAQ,GAAG,UAAU;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB;QAC5B,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACpE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;SACf,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,UAAU,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,QAAQ;YACR,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,IAAI;YAClD,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC,WAAW;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAY,EAAE;QACrC,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACpE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;SACf,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,GAAG,GAAa,EAAE,CAAC;QAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;QAED,cAAc;QACd,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAEpC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,UAAU,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,WAAW,GAAG;YACnD,UAAU,EAAE,CAAC;YACb,QAAQ;YACR,YAAY,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI;YACnC,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,UAAU,cAAc,IAAI,CAAC,WAAW,iBAAiB,CAAC,CAAC;QAE9F,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,+BAA+B;QAC/B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzB,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEnD,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE1B,cAAc;QACd,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAExB,sBAAsB;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CACT,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CACvB,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CACzF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,uBAAuB,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,0BAA0B,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,iBAAiB;AACjB,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACjD,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/browser/AdvancedFeatures.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Advanced Features for AgentDB Browser
+ *
+ * Includes:
+ * - GNN (Graph Neural Networks) - Graph attention and message passing
+ * - MMR (Maximal Marginal Relevance) - Diversity ranking
+ * - SVD (Singular Value Decomposition) - Tensor compression
+ * - Batch operations and utilities
+ */
+export interface GNNNode {
+    id: number;
+    features: Float32Array;
+    neighbors: number[];
+}
+export interface GNNEdge {
+    from: number;
+    to: number;
+    weight: number;
+}
+export interface GNNConfig {
+    hiddenDim: number;
+    numHeads: number;
+    dropout: number;
+    learningRate: number;
+    attentionType: 'gat' | 'gcn' | 'sage';
+}
+/**
+ * Graph Neural Network with attention mechanism
+ */
+export declare class GraphNeuralNetwork {
+    private config;
+    private nodes;
+    private edges;
+    private attentionWeights;
+    constructor(config?: Partial<GNNConfig>);
+    /**
+     * Add node to graph
+     */
+    addNode(id: number, features: Float32Array): void;
+    /**
+     * Add edge to graph
+     */
+    addEdge(from: number, to: number, weight?: number): void;
+    /**
+     * Graph Attention Network (GAT) message passing
+     */
+    graphAttention(nodeId: number): Float32Array;
+    /**
+     * Compute attention score between two nodes
+     */
+    private computeAttentionScore;
+    /**
+     * Message passing for all nodes
+     */
+    messagePass(): Map<number, Float32Array>;
+    /**
+     * Update node features after message passing
+     */
+    update(newFeatures: Map<number, Float32Array>): void;
+    /**
+     * Compute graph embeddings for query enhancement
+     */
+    computeGraphEmbedding(nodeId: number, hops?: number): Float32Array;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        numNodes: number;
+        numEdges: number;
+        avgDegree: number;
+        config: GNNConfig;
+    };
+}
+export interface MMRConfig {
+    lambda: number;
+    metric: 'cosine' | 'euclidean';
+}
+/**
+ * Maximal Marginal Relevance for diversity ranking
+ */
+export declare class MaximalMarginalRelevance {
+    private config;
+    constructor(config?: Partial<MMRConfig>);
+    /**
+     * Rerank results for diversity
+     * @param query Query vector
+     * @param candidates Candidate vectors with scores
+     * @param k Number of results to return
+     * @returns Reranked indices
+     */
+    rerank(query: Float32Array, candidates: Array<{
+        id: number;
+        vector: Float32Array;
+        score: number;
+    }>, k: number): number[];
+    /**
+     * Similarity computation
+     */
+    private similarity;
+    private cosineSimilarity;
+    private euclideanDistance;
+    /**
+     * Set lambda (relevance vs diversity trade-off)
+     */
+    setLambda(lambda: number): void;
+}
+/**
+ * Simple SVD implementation for dimension reduction
+ */
+export declare class TensorCompression {
+    /**
+     * Reduce dimensionality using truncated SVD
+     * @param vectors Array of vectors to compress
+     * @param targetDim Target dimension
+     * @returns Compressed vectors
+     */
+    static compress(vectors: Float32Array[], targetDim: number): Float32Array[];
+    /**
+     * Compute mean vector
+     */
+    private static computeMean;
+    /**
+     * Compute covariance matrix
+     */
+    private static computeCovariance;
+    /**
+     * Power iteration for computing top eigenvectors
+     */
+    private static powerIteration;
+}
+/**
+ * Efficient batch processing utilities
+ */
+export declare class BatchProcessor {
+    /**
+     * Batch cosine similarity computation
+     */
+    static batchCosineSimilarity(query: Float32Array, vectors: Float32Array[]): Float32Array;
+    /**
+     * Batch vector normalization
+     */
+    static batchNormalize(vectors: Float32Array[]): Float32Array[];
+}
+//# sourceMappingURL=AdvancedFeatures.d.ts.map

package/dist/src/browser/AdvancedFeatures.d.ts.map

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