agentdb 1.0.7 → 1.0.9

package/README.md

@@ -78,7 +78,7 @@ npm install agentdb
 **Quick Setup (Recommended):**
 
 ```bash
-claude mcp add agentdb npx agentdb@1.0.5 mcp
+claude mcp add agentdb npx agentdb@1.0.7 mcp
 ```
 
 This automatically configures Claude Code with all 20 AgentDB tools (10 core + 10 learning tools).

package/bin/agentdb.js

@@ -370,28 +370,34 @@ function initDatabase(path) {
   console.log('');
 
   try {
-    const { SqliteVectorDB, Presets } = require('../dist/index.js');
+    const { SQLiteVectorDB, Presets } = require('../dist/index.js');
 
     // Create a small test database
     const config = Presets.smallDataset(1536, path);
-    const db = SqliteVectorDB.new(config);
+    const db = new SQLiteVectorDB(config);
 
     console.log('✅ Database initialized successfully!');
     console.log('');
     console.log('Configuration:');
     console.log(`  Path: ${path}`);
-    console.log(`  Dimension: 1536`);
-    console.log(`  Mode: persistent`);
+    console.log(`  Mode: ${config.memoryMode ? 'in-memory' : 'persistent'}`);
+    console.log(`  Cache Size: ${config.cacheSize}MB`);
+    console.log(`  WAL Mode: ${config.walMode ? 'enabled' : 'disabled'}`);
     console.log('');
     console.log('Next steps:');
-    console.log('  1. Import the library: const { SqliteVectorDB } = require("agentdb")');
-    console.log('  2. Insert vectors: await db.insert({ data: [...], metadata: {...} })');
-    console.log('  3. Search: await db.search(queryVector, 5)');
+    console.log('  1. Import the library: const { SQLiteVectorDB } = require("agentdb")');
+    console.log('  2. Insert vectors: db.insert({ embedding: [...], metadata: {...} })');
+    console.log('  3. Search: db.search(queryVector, 5, "cosine", 0.0)');
+    console.log('  4. View the documentation: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb');
     console.log('');
 
     db.close();
   } catch (error) {
     console.error('❌ Failed to initialize database:', error.message);
+    if (error.stack) {
+      console.error('\nStack trace:');
+      console.error(error.stack);
+    }
     process.exit(1);
   }
 }
@@ -438,16 +444,21 @@ function runBenchmark() {
         process.exit(code);
       });
     } catch (tsError) {
-      console.error('❌ Benchmarks not available');
+      console.error('❌ Benchmarks not available in npm package');
       console.error('');
-      console.error('To run benchmarks:');
-      console.error('  1. Build the project: npm run build');
-      console.error('  2. Run benchmarks: npx agentdb benchmark');
+      console.error('To run benchmarks, clone the source repository:');
       console.error('');
-      console.error('Or run directly:');
-      console.error('  npm run bench');
+      console.error('  git clone https://github.com/ruvnet/agentic-flow.git');
+      console.error('  cd agentic-flow/packages/agentdb');
+      console.error('  npm install');
       console.error('  npm run bench:comprehensive');
       console.error('');
+      console.error('Or create a custom benchmark script:');
+      console.error('');
+      console.error('  const { SQLiteVectorDB } = require("agentdb");');
+      console.error('  const db = new SQLiteVectorDB({ memoryMode: true });');
+      console.error('  // Add your benchmark code here');
+      console.error('');
       process.exit(1);
     }
   }

package/dist/index.d.ts

@@ -16,10 +16,12 @@ import { NativeBackend } from './core/native-backend';
 import { WasmBackend } from './core/wasm-backend';
 import { BackendType, ExtendedDatabaseConfig, VectorBackend } from './core/backend-interface';
 import { initWasm, initSQL, getWasm, isInitialized, resetWasm } from './wasm-loader';
+import { Presets } from './presets';
 export { SQLiteVectorDB };
 export { NativeBackend };
 export { WasmBackend };
 export { BackendType };
+export { Presets };
 export type { VectorBackend, ExtendedDatabaseConfig };
 export { HNSWIndex, DEFAULT_HNSW_CONFIG } from './index/hnsw';
 export { OptimizedHNSWIndex } from './index/hnsw-optimized';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EACV,MAAM,EACN,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACjD,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAS7F;;;;;;;AAGD,wBAKE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EACV,MAAM,EACN,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACjD,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAS7F;;;;;;;AAGD,wBAKE"}

package/dist/index.js

@@ -8,7 +8,7 @@
  * @license MIT OR Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentDBMCPServer = exports.isWasmInitialized = exports.resetWasm = exports.getWasm = exports.initSQL = exports.initWasm = exports.createBinaryQuantizer = exports.BinaryQuantizer = exports.QuantizationUtils = exports.QuantizationProfiles = exports.ImprovedProductQuantizer = exports.ScalarQuantizer = exports.ProductQuantizer = exports.VectorQueryBuilder = exports.QueryCache = exports.OptimizedHNSWIndex = exports.DEFAULT_HNSW_CONFIG = exports.HNSWIndex = exports.BackendType = exports.WasmBackend = exports.NativeBackend = exports.SQLiteVectorDB = void 0;
+exports.AgentDBMCPServer = exports.isWasmInitialized = exports.resetWasm = exports.getWasm = exports.initSQL = exports.initWasm = exports.createBinaryQuantizer = exports.BinaryQuantizer = exports.QuantizationUtils = exports.QuantizationProfiles = exports.ImprovedProductQuantizer = exports.ScalarQuantizer = exports.ProductQuantizer = exports.VectorQueryBuilder = exports.QueryCache = exports.OptimizedHNSWIndex = exports.DEFAULT_HNSW_CONFIG = exports.HNSWIndex = exports.Presets = exports.BackendType = exports.WasmBackend = exports.NativeBackend = exports.SQLiteVectorDB = void 0;
 exports.createVectorDB = createVectorDB;
 /**
  * SQLiteVector - Ultra-fast vector database with dual backend support
@@ -30,6 +30,8 @@ Object.defineProperty(exports, "initSQL", { enumerable: true, get: function () {
 Object.defineProperty(exports, "getWasm", { enumerable: true, get: function () { return wasm_loader_1.getWasm; } });
 Object.defineProperty(exports, "isWasmInitialized", { enumerable: true, get: function () { return wasm_loader_1.isInitialized; } });
 Object.defineProperty(exports, "resetWasm", { enumerable: true, get: function () { return wasm_loader_1.resetWasm; } });
+const presets_1 = require("./presets");
+Object.defineProperty(exports, "Presets", { enumerable: true, get: function () { return presets_1.Presets; } });
 // HNSW indexing for high-performance search
 var hnsw_1 = require("./index/hnsw");
 Object.defineProperty(exports, "HNSWIndex", { enumerable: true, get: function () { return hnsw_1.HNSWIndex; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA+FH,wCASC;AAtGD;;;;GAIG;AAEH,mBAAmB;AACnB,gDAAkD;AAOzC,+FAPA,0BAAc,OAOA;AANvB,0DAAsD;AAO7C,8FAPA,8BAAa,OAOA;AANtB,sDAAkD;AAOzC,4FAPA,0BAAW,OAOA;AANpB,gEAA8F;AAOrF,4FAPA,+BAAW,OAOA;AANpB,+CAAqF;AAwE5E,yFAxEA,sBAAQ,OAwEA;AAAE,wFAxEA,qBAAO,OAwEA;AAAE,wFAxEA,qBAAO,OAwEA;AACT,kGAzEW,2BAAa,OAyEP;AADN,0FAxEe,uBAAS,OAwEf;AA/D9C,4CAA4C;AAC5C,qCAA8D;AAArD,iGAAA,SAAS,OAAA;AAAE,2GAAA,mBAAmB,OAAA;AACvC,yDAA4D;AAAnD,oHAAA,kBAAkB,OAAA;AAI3B,wDAAwD;AACxD,mDAAiD;AAAxC,yGAAA,UAAU,OAAA;AAGnB,8CAA8C;AAC9C,uDAA2D;AAAlD,mHAAA,kBAAkB,OAAA;AAG3B,4CAA4C;AAC5C,4EAAuE;AAA9D,wHAAA,gBAAgB,OAAA;AAGzB,+EAA+E;AAC/E,0EAAqE;AAA5D,sHAAA,eAAe,OAAA;AAOxB,gDAAgD;AAChD,4DAIqC;AAHnC,wHAAA,wBAAwB,OAAA;AACxB,oHAAA,oBAAoB,OAAA;AACpB,iHAAA,iBAAiB,OAAA;AAInB,iEAAiE;AACjE,0EAG4C;AAF1C,sHAAA,eAAe,OAAA;AACf,4HAAA,qBAAqB,OAAA;AA6BvB,aAAa;AACb,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA;AAEzB;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,MAA+B;IAClE,MAAM,EAAE,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,mCAAmC;IACnC,IAAI,EAAE,CAAC,cAAc,EAAE,KAAK,+BAAW,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,EAAE,CAAC,eAAe,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iCAAiC;AACjC,kBAAe;IACb,cAAc,EAAd,0BAAc;IACd,cAAc;IACd,WAAW,EAAX,+BAAW;IACX,QAAQ,EAAR,sBAAQ;CACT,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiGH,wCASC;AAxGD;;;;GAIG;AAEH,mBAAmB;AACnB,gDAAkD;AAQzC,+FARA,0BAAc,OAQA;AAPvB,0DAAsD;AAQ7C,8FARA,8BAAa,OAQA;AAPtB,sDAAkD;AAQzC,4FARA,0BAAW,OAQA;AAPpB,gEAA8F;AAQrF,4FARA,+BAAW,OAQA;AAPpB,+CAAqF;AA0E5E,yFA1EA,sBAAQ,OA0EA;AAAE,wFA1EA,qBAAO,OA0EA;AAAE,wFA1EA,qBAAO,OA0EA;AACT,kGA3EW,2BAAa,OA2EP;AADN,0FA1Ee,uBAAS,OA0Ef;AAzE9C,uCAAoC;AAO3B,wFAPA,iBAAO,OAOA;AAGhB,4CAA4C;AAC5C,qCAA8D;AAArD,iGAAA,SAAS,OAAA;AAAE,2GAAA,mBAAmB,OAAA;AACvC,yDAA4D;AAAnD,oHAAA,kBAAkB,OAAA;AAI3B,wDAAwD;AACxD,mDAAiD;AAAxC,yGAAA,UAAU,OAAA;AAGnB,8CAA8C;AAC9C,uDAA2D;AAAlD,mHAAA,kBAAkB,OAAA;AAG3B,4CAA4C;AAC5C,4EAAuE;AAA9D,wHAAA,gBAAgB,OAAA;AAGzB,+EAA+E;AAC/E,0EAAqE;AAA5D,sHAAA,eAAe,OAAA;AAOxB,gDAAgD;AAChD,4DAIqC;AAHnC,wHAAA,wBAAwB,OAAA;AACxB,oHAAA,oBAAoB,OAAA;AACpB,iHAAA,iBAAiB,OAAA;AAInB,iEAAiE;AACjE,0EAG4C;AAF1C,sHAAA,eAAe,OAAA;AACf,4HAAA,qBAAqB,OAAA;AA6BvB,aAAa;AACb,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA;AAEzB;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,MAA+B;IAClE,MAAM,EAAE,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,mCAAmC;IACnC,IAAI,EAAE,CAAC,cAAc,EAAE,KAAK,+BAAW,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,EAAE,CAAC,eAAe,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iCAAiC;AACjC,kBAAe;IACb,cAAc,EAAd,0BAAc;IACd,cAAc;IACd,WAAW,EAAX,+BAAW;IACX,QAAQ,EAAR,sBAAQ;CACT,CAAC"}

package/dist/index.mjs

@@ -17,11 +17,13 @@ import { NativeBackend } from './core/native-backend.mjs';
 import { WasmBackend } from './core/wasm-backend.mjs';
 import { BackendType } from './core/backend-interface.mjs';
 import { initWasm, initSQL, getWasm, isInitialized, resetWasm } from './wasm-loader.mjs';
+import { Presets } from './presets.mjs';
 // Re-export everything
 export { SQLiteVectorDB };
 export { NativeBackend };
 export { WasmBackend };
 export { BackendType };
+export { Presets };
 // HNSW indexing for high-performance search
 export { HNSWIndex, DEFAULT_HNSW_CONFIG } from './index/hnsw.mjs';
 export { OptimizedHNSWIndex } from './index/hnsw-optimized.mjs';

package/dist/presets.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Database configuration presets for common use cases
+ * Provides convenient factory functions for different dataset sizes
+ *
+ * Note: Vector dimension is not part of DatabaseConfig - it's determined
+ * by the actual vectors inserted. These presets configure database behavior,
+ * caching, and optimization settings.
+ */
+import { DatabaseConfig } from './types';
+export declare class Presets {
+    /**
+     * Small dataset preset (< 10K vectors)
+     * Optimized for quick initialization and small-scale testing
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for small datasets
+     */
+    static smallDataset(dimension?: number, path?: string): DatabaseConfig;
+    /**
+     * Medium dataset preset (10K - 100K vectors)
+     * Balanced configuration for moderate-scale applications
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for medium datasets
+     */
+    static mediumDataset(dimension?: number, path?: string): DatabaseConfig;
+    /**
+     * Large dataset preset (100K+ vectors)
+     * High-performance configuration for large-scale production use
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for large datasets
+     */
+    static largeDataset(dimension?: number, path?: string): DatabaseConfig;
+    /**
+     * In-memory preset
+     * Fast, ephemeral database for testing and temporary operations
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @returns Database configuration for in-memory database
+     */
+    static inMemory(dimension?: number): DatabaseConfig;
+    /**
+     * High-accuracy preset
+     * Larger cache and longer TTL for better accuracy
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for accuracy
+     */
+    static highAccuracy(dimension?: number, path?: string): DatabaseConfig;
+    /**
+     * Fast search preset
+     * Optimized for speed with minimal caching
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for speed
+     */
+    static fastSearch(dimension?: number, path?: string): DatabaseConfig;
+}
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,OAAO;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IAetE;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IAevE;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IAgBtE;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc;IAanD;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IAetE;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;CAcrE"}

package/dist/presets.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Database configuration presets for common use cases
+ * Provides convenient factory functions for different dataset sizes
+ *
+ * Note: Vector dimension is not part of DatabaseConfig - it's determined
+ * by the actual vectors inserted. These presets configure database behavior,
+ * caching, and optimization settings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Presets = void 0;
+class Presets {
+    /**
+     * Small dataset preset (< 10K vectors)
+     * Optimized for quick initialization and small-scale testing
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for small datasets
+     */
+    static smallDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 100, // 100MB cache for small datasets
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 1000,
+                ttl: 60000, // 1 minute
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Medium dataset preset (10K - 100K vectors)
+     * Balanced configuration for moderate-scale applications
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for medium datasets
+     */
+    static mediumDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 500, // 500MB cache for medium datasets
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 5000,
+                ttl: 300000, // 5 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Large dataset preset (100K+ vectors)
+     * High-performance configuration for large-scale production use
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for large datasets
+     */
+    static largeDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 2000, // 2GB cache for large datasets
+            walMode: true,
+            mmapSize: 1073741824, // 1GB mmap
+            queryCache: {
+                enabled: true,
+                maxSize: 10000,
+                ttl: 600000, // 10 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * In-memory preset
+     * Fast, ephemeral database for testing and temporary operations
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @returns Database configuration for in-memory database
+     */
+    static inMemory(dimension) {
+        return {
+            memoryMode: true,
+            cacheSize: 100,
+            queryCache: {
+                enabled: true,
+                maxSize: 500,
+                ttl: 60000,
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * High-accuracy preset
+     * Larger cache and longer TTL for better accuracy
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for accuracy
+     */
+    static highAccuracy(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 1000,
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 20000,
+                ttl: 1800000, // 30 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Fast search preset
+     * Optimized for speed with minimal caching
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for speed
+     */
+    static fastSearch(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 50, // Minimal cache
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 100,
+                ttl: 10000, // 10 seconds
+                enableStats: false
+            }
+        };
+    }
+}
+exports.Presets = Presets;
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAIH,MAAa,OAAO;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAkB,EAAE,IAAa;QACnD,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;YACxC,SAAS,EAAE,GAAG,EAAE,iCAAiC;YACjD,OAAO,EAAE,IAAI;YACb,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,KAAK,EAAE,WAAW;gBACvB,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,SAAkB,EAAE,IAAa;QACpD,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;YACxC,SAAS,EAAE,GAAG,EAAE,kCAAkC;YAClD,OAAO,EAAE,IAAI;YACb,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,MAAM,EAAE,YAAY;gBACzB,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAkB,EAAE,IAAa;QACnD,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;YACxC,SAAS,EAAE,IAAI,EAAE,+BAA+B;YAChD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,UAAU,EAAE,WAAW;YACjC,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,KAAK;gBACd,GAAG,EAAE,MAAM,EAAE,aAAa;gBAC1B,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAkB;QAChC,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,GAAG;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,GAAG;gBACZ,GAAG,EAAE,KAAK;gBACV,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,SAAkB,EAAE,IAAa;QACnD,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;YACxC,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,KAAK;gBACd,GAAG,EAAE,OAAO,EAAE,aAAa;gBAC3B,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,SAAkB,EAAE,IAAa;QACjD,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;YACxC,SAAS,EAAE,EAAE,EAAE,gBAAgB;YAC/B,OAAO,EAAE,IAAI;YACb,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,GAAG;gBACZ,GAAG,EAAE,KAAK,EAAE,aAAa;gBACzB,WAAW,EAAE,KAAK;aACnB;SACF,CAAC;IACJ,CAAC;CACF;AAxID,0BAwIC"}

package/dist/presets.mjs

@@ -0,0 +1,140 @@
+/**
+ * Database configuration presets for common use cases
+ * Provides convenient factory functions for different dataset sizes
+ *
+ * Note: Vector dimension is not part of DatabaseConfig - it's determined
+ * by the actual vectors inserted. These presets configure database behavior,
+ * caching, and optimization settings.
+ */
+export class Presets {
+    /**
+     * Small dataset preset (< 10K vectors)
+     * Optimized for quick initialization and small-scale testing
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for small datasets
+     */
+    static smallDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 100, // 100MB cache for small datasets
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 1000,
+                ttl: 60000, // 1 minute
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Medium dataset preset (10K - 100K vectors)
+     * Balanced configuration for moderate-scale applications
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path (omit or use undefined for in-memory)
+     * @returns Database configuration optimized for medium datasets
+     */
+    static mediumDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 500, // 500MB cache for medium datasets
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 5000,
+                ttl: 300000, // 5 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Large dataset preset (100K+ vectors)
+     * High-performance configuration for large-scale production use
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for large datasets
+     */
+    static largeDataset(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 2000, // 2GB cache for large datasets
+            walMode: true,
+            mmapSize: 1073741824, // 1GB mmap
+            queryCache: {
+                enabled: true,
+                maxSize: 10000,
+                ttl: 600000, // 10 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * In-memory preset
+     * Fast, ephemeral database for testing and temporary operations
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @returns Database configuration for in-memory database
+     */
+    static inMemory(dimension) {
+        return {
+            memoryMode: true,
+            cacheSize: 100,
+            queryCache: {
+                enabled: true,
+                maxSize: 500,
+                ttl: 60000,
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * High-accuracy preset
+     * Larger cache and longer TTL for better accuracy
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for accuracy
+     */
+    static highAccuracy(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 1000,
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 20000,
+                ttl: 1800000, // 30 minutes
+                enableStats: true
+            }
+        };
+    }
+    /**
+     * Fast search preset
+     * Optimized for speed with minimal caching
+     *
+     * @param dimension - Vector dimension (for backward compatibility, not used)
+     * @param path - Database file path
+     * @returns Database configuration optimized for speed
+     */
+    static fastSearch(dimension, path) {
+        return {
+            path: path || undefined,
+            memoryMode: !path || path === ':memory:',
+            cacheSize: 50, // Minimal cache
+            walMode: true,
+            queryCache: {
+                enabled: true,
+                maxSize: 100,
+                ttl: 10000, // 10 seconds
+                enableStats: false
+            }
+        };
+    }
+}

package/examples/test-v1.0.7-cdn.html

@@ -0,0 +1,190 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AgentDB v1.0.7 CDN Test - better-sqlite3 Fix Validation</title>
+  <style>
+    body {
+      font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+      max-width: 1000px;
+      margin: 50px auto;
+      padding: 20px;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+    }
+    .container {
+      background: rgba(255, 255, 255, 0.95);
+      border-radius: 15px;
+      padding: 30px;
+      box-shadow: 0 10px 40px rgba(0,0,0,0.3);
+      color: #333;
+    }
+    h1 {
+      color: #667eea;
+      margin-bottom: 10px;
+    }
+    .status {
+      padding: 15px;
+      margin: 15px 0;
+      border-radius: 8px;
+      font-weight: bold;
+    }
+    .loading { background: #fff3cd; color: #856404; }
+    .success { background: #d4edda; color: #155724; }
+    .error { background: #f8d7da; color: #721c24; }
+    pre {
+      background: #f8f9fa;
+      padding: 15px;
+      border-radius: 8px;
+      overflow-x: auto;
+      font-size: 14px;
+    }
+    .version {
+      color: #6c757d;
+      font-size: 0.9em;
+    }
+    .test-results {
+      margin-top: 20px;
+    }
+    .test-item {
+      padding: 10px;
+      margin: 10px 0;
+      border-left: 4px solid #667eea;
+      background: #f8f9fa;
+      border-radius: 4px;
+    }
+    .pass { border-left-color: #28a745; }
+    .fail { border-left-color: #dc3545; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>🚀 AgentDB v1.0.7 CDN Test</h1>
+    <p class="version">Testing better-sqlite3 fix via unpkg.com CDN</p>
+
+    <div id="status" class="status loading">
+      ⏳ Loading AgentDB from CDN...
+    </div>
+
+    <div class="test-results">
+      <h3>Test Results:</h3>
+      <div id="results"></div>
+    </div>
+
+    <h3>Console Output:</h3>
+    <pre id="console"></pre>
+  </div>
+
+  <script type="module">
+    const statusEl = document.getElementById('status');
+    const resultsEl = document.getElementById('results');
+    const consoleEl = document.getElementById('console');
+
+    let logs = [];
+    function log(message, type = 'info') {
+      const timestamp = new Date().toLocaleTimeString();
+      const logMessage = `[${timestamp}] ${message}`;
+      logs.push(logMessage);
+      consoleEl.textContent = logs.join('\n');
+      console.log(message);
+    }
+
+    function addTestResult(name, passed, details) {
+      const div = document.createElement('div');
+      div.className = `test-item ${passed ? 'pass' : 'fail'}`;
+      div.innerHTML = `
+        <strong>${passed ? '✅' : '❌'} ${name}</strong>
+        ${details ? `<br><small>${details}</small>` : ''}
+      `;
+      resultsEl.appendChild(div);
+    }
+
+    async function runTests() {
+      try {
+        log('🔍 Attempting to import AgentDB v1.0.7 from unpkg CDN...');
+
+        // Import from unpkg CDN
+        const { SQLiteVectorDB, createVectorDB } = await import('https://unpkg.com/agentdb@1.0.7/dist/agentdb.min.js');
+
+        log('✅ Successfully loaded AgentDB module!');
+        addTestResult('Module Import', true, 'No better-sqlite3 import errors!');
+
+        // Test 1: Create database instance
+        log('🧪 Test 1: Creating SQLiteVectorDB instance...');
+        const db = new SQLiteVectorDB({
+          memoryMode: true,
+          backend: 'wasm'
+        });
+        addTestResult('Database Instance Creation', true, 'Backend set to WASM');
+
+        // Test 2: Initialize WASM backend
+        log('🧪 Test 2: Initializing WASM backend...');
+        await db.initializeAsync();
+        log('✅ WASM backend initialized successfully!');
+        addTestResult('WASM Initialization', true, 'sql.js loaded without errors');
+
+        // Test 3: Insert vector
+        log('🧪 Test 3: Inserting test vector...');
+        const vector1 = {
+          id: 'vec1',
+          embedding: [0.1, 0.2, 0.3, 0.4, 0.5],
+          metadata: { test: 'v1.0.7-fix', type: 'validation' }
+        };
+        const id1 = db.insert(vector1);
+        log(`✅ Inserted vector with ID: ${id1}`);
+        addTestResult('Vector Insert', true, `ID: ${id1}`);
+
+        // Test 4: Search
+        log('🧪 Test 4: Searching for similar vectors...');
+        const results = db.search([0.1, 0.2, 0.3, 0.4, 0.5], 1);
+        log(`✅ Found ${results.length} results, score: ${results[0]?.score}`);
+        addTestResult('Vector Search', results.length > 0, `Score: ${results[0]?.score?.toFixed(4)}`);
+
+        // Test 5: Verify backend type
+        log('🧪 Test 5: Verifying backend type...');
+        const backendType = db.getBackendType();
+        log(`✅ Backend type: ${backendType}`);
+        addTestResult('Backend Type Check', backendType === 'wasm', `Using: ${backendType}`);
+
+        // Test 6: Stats
+        log('🧪 Test 6: Getting database stats...');
+        const stats = db.stats();
+        log(`✅ Database has ${stats.count} vectors, size: ${stats.size} bytes`);
+        addTestResult('Database Stats', stats.count === 1, `Vectors: ${stats.count}, Size: ${stats.size}B`);
+
+        // All tests passed!
+        statusEl.textContent = '🎉 All tests passed! The better-sqlite3 fix works perfectly!';
+        statusEl.className = 'status success';
+
+        log('');
+        log('=' .repeat(60));
+        log('🎉 VALIDATION SUCCESSFUL!');
+        log('✅ No better-sqlite3 import errors');
+        log('✅ WASM backend works correctly');
+        log('✅ All vector operations functional');
+        log('✅ AgentDB v1.0.7 ready for production use in browsers!');
+        log('=' .repeat(60));
+
+      } catch (error) {
+        log(`❌ ERROR: ${error.message}`, 'error');
+        log(`Stack: ${error.stack}`, 'error');
+
+        statusEl.textContent = `❌ Test failed: ${error.message}`;
+        statusEl.className = 'status error';
+
+        addTestResult('Error Occurred', false, error.message);
+
+        // Check if it's the better-sqlite3 error
+        if (error.message.includes('better-sqlite3')) {
+          log('🚨 CRITICAL: better-sqlite3 dependency still present in bundle!');
+          addTestResult('better-sqlite3 Fix', false, 'Module still contains Node.js dependency');
+        }
+      }
+    }
+
+    // Run tests when page loads
+    runTests();
+  </script>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentdb",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Ultra-fast agent memory and vector database with ReasoningBank for AI agents. Built on SQLite with QUIC sync. From ruv.io - Advanced AI Infrastructure.",
   "keywords": [
     "agent",