agentdb 1.0.0

package/dist/cli/commands.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * CLI commands implementation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listPlugins = listPlugins;
+exports.listTemplates = listTemplates;
+exports.getPluginInfo = getPluginInfo;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const templates_js_1 = require("./templates.js");
+async function listPlugins(verbose = false) {
+    const pluginsDir = path_1.default.join(process.cwd(), 'plugins');
+    try {
+        const plugins = await promises_1.default.readdir(pluginsDir);
+        console.log(chalk_1.default.cyan.bold('\nAvailable Plugins:\n'));
+        for (const pluginName of plugins) {
+            const pluginPath = path_1.default.join(pluginsDir, pluginName);
+            const stats = await promises_1.default.stat(pluginPath);
+            if (!stats.isDirectory())
+                continue;
+            try {
+                const configPath = path_1.default.join(pluginPath, 'plugin.yaml');
+                const config = await promises_1.default.readFile(configPath, 'utf-8');
+                console.log(chalk_1.default.yellow(`  • ${pluginName}`));
+                if (verbose) {
+                    // Parse YAML and show details
+                    const lines = config.split('\n');
+                    const description = lines.find(l => l.startsWith('description:'));
+                    const version = lines.find(l => l.startsWith('version:'));
+                    const algorithm = lines.find(l => l.startsWith('base_algorithm:'));
+                    if (description)
+                        console.log(chalk_1.default.gray(`    ${description.split(':')[1].trim()}`));
+                    if (version)
+                        console.log(chalk_1.default.gray(`    Version: ${version.split(':')[1].trim()}`));
+                    if (algorithm)
+                        console.log(chalk_1.default.gray(`    Algorithm: ${algorithm.split(':')[1].trim()}`));
+                    console.log();
+                }
+            }
+            catch (error) {
+                console.log(chalk_1.default.red(`    (Invalid plugin configuration)`));
+            }
+        }
+    }
+    catch (error) {
+        console.log(chalk_1.default.yellow('\nNo plugins found. Create one with:'));
+        console.log(chalk_1.default.cyan('  npx agentdb create-plugin\n'));
+    }
+}
+async function listTemplates(detailed = false) {
+    const templates = await (0, templates_js_1.getAvailableTemplates)();
+    console.log(chalk_1.default.cyan.bold('\nAvailable Templates:\n'));
+    for (const template of templates) {
+        console.log(chalk_1.default.yellow(`  • ${template.name}`));
+        if (detailed) {
+            console.log(chalk_1.default.gray(`    ${template.description}`));
+            console.log(chalk_1.default.gray(`    Algorithm: ${template.algorithm}`));
+            console.log(chalk_1.default.gray(`    Use Case: ${template.useCase}`));
+            console.log(chalk_1.default.gray(`    Configuration:`));
+            console.log(chalk_1.default.gray(`      - Learning Rate: ${template.config.algorithm.learning_rate || 'varies'}`));
+            console.log(chalk_1.default.gray(`      - Batch Size: ${template.config.training.batch_size || 'N/A'}`));
+            console.log(chalk_1.default.gray(`      - Min Experiences: ${template.config.training.min_experiences}`));
+            console.log();
+        }
+    }
+    console.log(chalk_1.default.gray('\nCreate a plugin from template:'));
+    console.log(chalk_1.default.cyan('  npx agentdb create-plugin --template <name>\n'));
+}
+async function getPluginInfo(name, asJson = false) {
+    const pluginPath = path_1.default.join(process.cwd(), 'plugins', name);
+    try {
+        const configPath = path_1.default.join(pluginPath, 'plugin.yaml');
+        const config = await promises_1.default.readFile(configPath, 'utf-8');
+        if (asJson) {
+            // Output as JSON
+            const lines = config.split('\n');
+            const jsonInfo = {
+                name: name,
+                description: lines.find(l => l.startsWith('description:'))?.split(':')[1]?.trim() || '',
+                version: lines.find(l => l.startsWith('version:'))?.split(':')[1]?.trim() || '',
+                baseAlgorithm: lines.find(l => l.startsWith('base_algorithm:'))?.split(':')[1]?.trim() || '',
+                author: lines.find(l => l.startsWith('author:'))?.split(':')[1]?.trim() || '',
+                status: 'ready'
+            };
+            console.log(JSON.stringify(jsonInfo, null, 2));
+            return;
+        }
+        console.log(chalk_1.default.cyan.bold(`\n Plugin: ${name}\n`));
+        console.log(chalk_1.default.gray('────────────────────────────────────────'));
+        console.log(config);
+        console.log(chalk_1.default.gray('────────────────────────────────────────\n'));
+        const readmePath = path_1.default.join(pluginPath, 'README.md');
+        try {
+            const readme = await promises_1.default.readFile(readmePath, 'utf-8');
+            console.log(chalk_1.default.white('\nDocumentation:\n'));
+            console.log(readme);
+        }
+        catch {
+            // No README
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\nPlugin "${name}" not found.\n`));
+        console.log(chalk_1.default.gray('List available plugins:'));
+        console.log(chalk_1.default.cyan('  npx agentdb list-plugins\n'));
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;AAOH,kCAwCC;AAED,sCAsBC;AAED,sCAwCC;AA/GD,2DAA6B;AAC7B,gDAAwB;AACxB,kDAA0B;AAC1B,iDAAuD;AAEhD,KAAK,UAAU,WAAW,CAAC,UAAmB,KAAK;IACxD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE7C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAEvD,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAExC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YAEnC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;gBACxD,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAEtD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC;gBAE/C,IAAI,OAAO,EAAE,CAAC;oBACZ,8BAA8B;oBAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACjC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;oBAClE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;oBAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;oBAEnE,IAAI,WAAW;wBAAE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBACpF,IAAI,OAAO;wBAAE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBACrF,IAAI,SAAS;wBAAE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC3F,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,WAAoB,KAAK;IAC3D,MAAM,SAAS,GAAG,MAAM,IAAA,oCAAqB,GAAE,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAEzD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAElD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0BAA0B,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC;YACzG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/F,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4BAA4B,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;YAChG,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC,CAAC;AAC7E,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,SAAkB,KAAK;IACvE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,MAAM,EAAE,CAAC;YACX,iBAAiB;YACjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;gBACvF,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC/E,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC5F,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC7E,MAAM,EAAE,OAAO;aAChB,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAEtE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,aAAa,IAAI,gBAAgB,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/cli/commands.mjs

@@ -0,0 +1,104 @@
+/**
+ * CLI commands implementation
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import { getAvailableTemplates } from './templates.mjs';
+export async function listPlugins(verbose = false) {
+    const pluginsDir = path.join(process.cwd(), 'plugins');
+    try {
+        const plugins = await fs.readdir(pluginsDir);
+        console.log(chalk.cyan.bold('\nAvailable Plugins:\n'));
+        for (const pluginName of plugins) {
+            const pluginPath = path.join(pluginsDir, pluginName);
+            const stats = await fs.stat(pluginPath);
+            if (!stats.isDirectory())
+                continue;
+            try {
+                const configPath = path.join(pluginPath, 'plugin.yaml');
+                const config = await fs.readFile(configPath, 'utf-8');
+                console.log(chalk.yellow(`  • ${pluginName}`));
+                if (verbose) {
+                    // Parse YAML and show details
+                    const lines = config.split('\n');
+                    const description = lines.find(l => l.startsWith('description:'));
+                    const version = lines.find(l => l.startsWith('version:'));
+                    const algorithm = lines.find(l => l.startsWith('base_algorithm:'));
+                    if (description)
+                        console.log(chalk.gray(`    ${description.split(':')[1].trim()}`));
+                    if (version)
+                        console.log(chalk.gray(`    Version: ${version.split(':')[1].trim()}`));
+                    if (algorithm)
+                        console.log(chalk.gray(`    Algorithm: ${algorithm.split(':')[1].trim()}`));
+                    console.log();
+                }
+            }
+            catch (error) {
+                console.log(chalk.red(`    (Invalid plugin configuration)`));
+            }
+        }
+    }
+    catch (error) {
+        console.log(chalk.yellow('\nNo plugins found. Create one with:'));
+        console.log(chalk.cyan('  npx agentdb create-plugin\n'));
+    }
+}
+export async function listTemplates(detailed = false) {
+    const templates = await getAvailableTemplates();
+    console.log(chalk.cyan.bold('\nAvailable Templates:\n'));
+    for (const template of templates) {
+        console.log(chalk.yellow(`  • ${template.name}`));
+        if (detailed) {
+            console.log(chalk.gray(`    ${template.description}`));
+            console.log(chalk.gray(`    Algorithm: ${template.algorithm}`));
+            console.log(chalk.gray(`    Use Case: ${template.useCase}`));
+            console.log(chalk.gray(`    Configuration:`));
+            console.log(chalk.gray(`      - Learning Rate: ${template.config.algorithm.learning_rate || 'varies'}`));
+            console.log(chalk.gray(`      - Batch Size: ${template.config.training.batch_size || 'N/A'}`));
+            console.log(chalk.gray(`      - Min Experiences: ${template.config.training.min_experiences}`));
+            console.log();
+        }
+    }
+    console.log(chalk.gray('\nCreate a plugin from template:'));
+    console.log(chalk.cyan('  npx agentdb create-plugin --template <name>\n'));
+}
+export async function getPluginInfo(name, asJson = false) {
+    const pluginPath = path.join(process.cwd(), 'plugins', name);
+    try {
+        const configPath = path.join(pluginPath, 'plugin.yaml');
+        const config = await fs.readFile(configPath, 'utf-8');
+        if (asJson) {
+            // Output as JSON
+            const lines = config.split('\n');
+            const jsonInfo = {
+                name: name,
+                description: lines.find(l => l.startsWith('description:'))?.split(':')[1]?.trim() || '',
+                version: lines.find(l => l.startsWith('version:'))?.split(':')[1]?.trim() || '',
+                baseAlgorithm: lines.find(l => l.startsWith('base_algorithm:'))?.split(':')[1]?.trim() || '',
+                author: lines.find(l => l.startsWith('author:'))?.split(':')[1]?.trim() || '',
+                status: 'ready'
+            };
+            console.log(JSON.stringify(jsonInfo, null, 2));
+            return;
+        }
+        console.log(chalk.cyan.bold(`\n Plugin: ${name}\n`));
+        console.log(chalk.gray('────────────────────────────────────────'));
+        console.log(config);
+        console.log(chalk.gray('────────────────────────────────────────\n'));
+        const readmePath = path.join(pluginPath, 'README.md');
+        try {
+            const readme = await fs.readFile(readmePath, 'utf-8');
+            console.log(chalk.white('\nDocumentation:\n'));
+            console.log(readme);
+        }
+        catch {
+            // No README
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\nPlugin "${name}" not found.\n`));
+        console.log(chalk.gray('List available plugins:'));
+        console.log(chalk.cyan('  npx agentdb list-plugins\n'));
+    }
+}

package/dist/cli/core/backend-interface.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Backend interface for vector database implementations
+ * Supports both native (better-sqlite3) and WASM (sql.js) backends
+ */
+import { Vector, SearchResult, SimilarityMetric, DatabaseConfig } from '../types';
+/**
+ * Abstract interface for vector database backends
+ */
+export interface VectorBackend {
+    /**
+     * Initialize the database with given configuration
+     */
+    initialize(config: DatabaseConfig): void;
+    /**
+     * Insert a single vector
+     * @returns The ID of the inserted vector
+     */
+    insert(vector: Vector): string;
+    /**
+     * Insert multiple vectors in a transaction
+     * @returns Array of IDs of inserted vectors
+     */
+    insertBatch(vectors: Vector[]): string[];
+    /**
+     * Search for k-nearest neighbors
+     */
+    search(queryEmbedding: number[], k: number, metric: SimilarityMetric, threshold: number): SearchResult[];
+    /**
+     * Get vector by ID
+     */
+    get(id: string): Vector | null;
+    /**
+     * Delete vector by ID
+     * @returns true if deleted, false if not found
+     */
+    delete(id: string): boolean;
+    /**
+     * Get database statistics
+     */
+    stats(): {
+        count: number;
+        size: number;
+    };
+    /**
+     * Close database connection and cleanup resources
+     */
+    close(): void;
+    /**
+     * Export database to binary format (for WASM persistence)
+     */
+    export?(): Uint8Array;
+    /**
+     * Import database from binary format (for WASM persistence)
+     */
+    import?(data: Uint8Array): void;
+}
+/**
+ * Backend type enum
+ */
+export declare enum BackendType {
+    NATIVE = "native",
+    WASM = "wasm"
+}
+/**
+ * Extended database configuration with backend selection
+ */
+export interface ExtendedDatabaseConfig extends DatabaseConfig {
+    backend?: BackendType;
+    wasmBinary?: Uint8Array;
+}

package/dist/cli/core/backend-interface.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Backend interface for vector database implementations
+ * Supports both native (better-sqlite3) and WASM (sql.js) backends
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendType = void 0;
+/**
+ * Backend type enum
+ */
+var BackendType;
+(function (BackendType) {
+    BackendType["NATIVE"] = "native";
+    BackendType["WASM"] = "wasm";
+})(BackendType || (exports.BackendType = BackendType = {}));

package/dist/cli/core/native-backend.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Native backend implementation using better-sqlite3
+ * High-performance backend for Node.js environments
+ */
+import Database from 'better-sqlite3';
+import { Vector, SearchResult, SimilarityMetric, DatabaseConfig } from '../types';
+import { VectorBackend } from './backend-interface';
+import { HNSWConfig } from '../index/hnsw';
+/**
+ * Extended database configuration with HNSW index support
+ */
+export interface NativeBackendConfig extends DatabaseConfig {
+    hnsw?: Partial<HNSWConfig>;
+}
+/**
+ * Native backend using better-sqlite3
+ * Optimized for Node.js with native SQLite bindings
+ * Features HNSW index for high-performance approximate nearest neighbor search
+ */
+export declare class NativeBackend implements VectorBackend {
+    private db;
+    private insertStmt;
+    private initialized;
+    private hnswIndex;
+    private hnswConfig;
+    /**
+     * Initialize the native backend
+     */
+    initialize(config?: NativeBackendConfig): void;
+    /**
+     * Initialize database schema
+     */
+    private initializeSchema;
+    /**
+     * Register custom SQL functions for similarity calculations
+     */
+    private registerCustomFunctions;
+    /**
+     * Prepare frequently used statements
+     */
+    private prepareStatements;
+    /**
+     * Calculate L2 norm of a vector
+     */
+    private calculateNorm;
+    /**
+     * Serialize embedding to binary format
+     */
+    private serializeEmbedding;
+    /**
+     * Deserialize embedding from binary format
+     */
+    private deserializeEmbedding;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Insert a single vector
+     */
+    insert(vector: Vector): string;
+    /**
+     * Insert multiple vectors in a transaction with optimized batch processing
+     * Performance improvements:
+     * - Single transaction for all inserts
+     * - Reused prepared statement
+     * - No wrapper function overhead
+     * - Chunked processing for large batches
+     * - Automatic HNSW index building after batch insert
+     */
+    insertBatch(vectors: Vector[]): string[];
+    /**
+     * Check if HNSW index should be used
+     */
+    private shouldUseHNSW;
+    /**
+     * Search for k-nearest neighbors
+     * Automatically uses HNSW index when available and beneficial
+     */
+    search(queryEmbedding: number[], k?: number, metric?: SimilarityMetric, threshold?: number): SearchResult[];
+    /**
+     * Search using HNSW index (fast approximate search)
+     */
+    private searchWithHNSW;
+    /**
+     * Brute-force search (accurate but slower)
+     */
+    private bruteForceSearch;
+    /**
+     * Get vector by ID
+     */
+    get(id: string): Vector | null;
+    /**
+     * Delete vector by ID
+     */
+    delete(id: string): boolean;
+    /**
+     * Get database statistics
+     */
+    stats(): {
+        count: number;
+        size: number;
+    };
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Get raw database instance (for advanced usage)
+     */
+    getDatabase(): Database.Database | null;
+    /**
+     * Check if backend is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Build HNSW index manually
+     * Useful for pre-building index on existing data
+     */
+    buildHNSWIndex(): void;
+    /**
+     * Get HNSW index statistics
+     */
+    getHNSWStats(): {
+        enabled: boolean;
+        ready: boolean;
+        nodeCount: number;
+        edgeCount: number;
+        maxLevel: number;
+        avgDegree: number;
+    } | null;
+    /**
+     * Clear HNSW index
+     */
+    clearHNSWIndex(): void;
+    /**
+     * Update HNSW configuration and rebuild if needed
+     */
+    updateHNSWConfig(config: Partial<HNSWConfig>, rebuild?: boolean): void;
+}