@aeriondyseti/vector-memory-mcp 0.9.0-dev.5 → 0.9.0-dev.9

package/dist/package.json

@@ -0,0 +1,72 @@
+{
+    "name": "@aeriondyseti/vector-memory-mcp",
+    "version": "0.9.0-dev.9",
+    "description": "A zero-configuration RAG memory server for MCP clients",
+    "type": "module",
+    "main": "dist/src/index.js",
+    "bin": {
+        "vector-memory-mcp": "dist/src/index.js"
+    },
+    "files": [
+        "dist",
+        "src",
+        "scripts",
+        "hooks",
+        "README.md",
+        "LICENSE"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/AerionDyseti/vector-memory-mcp.git"
+    },
+    "author": "AerionDyseti",
+    "bugs": {
+        "url": "https://github.com/AerionDyseti/vector-memory-mcp/issues"
+    },
+    "homepage": "https://github.com/AerionDyseti/vector-memory-mcp#readme",
+    "scripts": {
+        "start": "node dist/src/index.js",
+        "start:bun": "bun run src/index.ts",
+        "dev": "bun --watch run src/index.ts",
+        "build": "tsc",
+        "prebuild": "rm -rf dist",
+        "typecheck": "bunx tsc --noEmit",
+        "test": "bun run scripts/test-runner.ts",
+        "test:raw": "bun test --preload ./tests/preload.ts",
+        "test:quick": "bun test",
+        "test:coverage": "bun test --preload ./tests/preload.ts --coverage",
+        "benchmark": "bun test tests/benchmark.test.ts --preload ./tests/preload.ts",
+        "test:preload": "bun run tests/preload.ts",
+        "warmup": "bun run scripts/warmup.ts",
+        "postinstall": "bun run scripts/warmup.ts",
+        "prepublishOnly": "bun run build"
+    },
+    "keywords": [
+        "mcp",
+        "memory",
+        "rag",
+        "embeddings",
+        "lancedb"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "@hono/node-server": "^1.19.9",
+        "@huggingface/transformers": "^3.8.0",
+        "@lancedb/lancedb": "^0.22.3",
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "arg": "^5.0.2",
+        "hono": "^4.11.3"
+    },
+    "devDependencies": {
+        "@types/bun": "latest",
+        "typescript": "^5.0.0"
+    },
+    "trustedDependencies": [
+        "onnxruntime-node",
+        "protobufjs",
+        "sharp"
+    ],
+    "overrides": {
+        "onnxruntime-node": "1.23.2"
+    }
+}

package/dist/scripts/test-runner.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env bun
+/**
+ * Test runner wrapper that handles Bun's post-test crash gracefully.
+ *
+ * Bun crashes during native module cleanup after tests complete successfully.
+ * This wrapper captures the output, verifies tests passed, and exits cleanly.
+ */
+export {};
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/scripts/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../scripts/test-runner.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/scripts/test-runner.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env bun
+/**
+ * Test runner wrapper that handles Bun's post-test crash gracefully.
+ *
+ * Bun crashes during native module cleanup after tests complete successfully.
+ * This wrapper captures the output, verifies tests passed, and exits cleanly.
+ */
+import { spawn } from "bun";
+const proc = spawn(["bun", "test", "--preload", "./tests/preload.ts"], {
+    stdout: "pipe",
+    stderr: "pipe",
+    env: { ...process.env, FORCE_COLOR: "1" },
+});
+let stdout = "";
+let stderr = "";
+const decoder = new TextDecoder();
+// Stream stdout in real-time
+const stdoutReader = proc.stdout.getReader();
+(async () => {
+    while (true) {
+        const { done, value } = await stdoutReader.read();
+        if (done)
+            break;
+        const text = decoder.decode(value);
+        stdout += text;
+        process.stdout.write(text);
+    }
+})();
+// Stream stderr in real-time
+const stderrReader = proc.stderr.getReader();
+(async () => {
+    while (true) {
+        const { done, value } = await stderrReader.read();
+        if (done)
+            break;
+        const text = decoder.decode(value);
+        stderr += text;
+        process.stderr.write(text);
+    }
+})();
+await proc.exited;
+// Check if tests actually passed by looking for the summary line
+const output = stdout + stderr;
+const passMatch = output.match(/(\d+) pass/);
+const failMatch = output.match(/(\d+) fail/);
+const passed = passMatch ? parseInt(passMatch[1], 10) : 0;
+const failed = failMatch ? parseInt(failMatch[1], 10) : 0;
+// Exit based on test results, not Bun's crash
+if (failed > 0) {
+    console.error(`\n❌ ${failed} test(s) failed`);
+    process.exit(1);
+}
+else if (passed > 0) {
+    console.log(`\n✅ All ${passed} tests passed (ignoring Bun cleanup crash)`);
+    process.exit(0);
+}
+else {
+    console.error("\n⚠️  Could not determine test results");
+    process.exit(1);
+}
+//# sourceMappingURL=test-runner.js.map

package/dist/scripts/test-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../scripts/test-runner.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,CAAC,EAAE;IACrE,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;CAC1C,CAAC,CAAC;AAEH,IAAI,MAAM,GAAG,EAAE,CAAC;AAChB,IAAI,MAAM,GAAG,EAAE,CAAC;AAEhB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,6BAA6B;AAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;AAC7C,CAAC,KAAK,IAAI,EAAE;IACV,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,6BAA6B;AAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;AAC7C,CAAC,KAAK,IAAI,EAAE;IACV,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,IAAI,CAAC,MAAM,CAAC;AAElB,iEAAiE;AACjE,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAE7C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,8CAA8C;AAC9C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,OAAO,MAAM,iBAAiB,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;KAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,4CAA4C,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/scripts/warmup.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * Warmup script to pre-download ML models and verify dependencies
+ * This runs during installation to ensure everything is ready to use
+ */
+declare function warmup(): Promise<void>;
+export { warmup };
+//# sourceMappingURL=warmup.d.ts.map

package/dist/scripts/warmup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmup.d.ts","sourceRoot":"","sources":["../../scripts/warmup.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAKH,iBAAe,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDrC;AAOD,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/scripts/warmup.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env bun
+/**
+ * Warmup script to pre-download ML models and verify dependencies
+ * This runs during installation to ensure everything is ready to use
+ */
+import { config } from "../src/config/index.js";
+import { EmbeddingsService } from "../src/services/embeddings.service.js";
+async function warmup() {
+    console.log("🔥 Warming up vector-memory-mcp...");
+    console.log();
+    try {
+        // Check native dependencies
+        console.log("✓ Checking native dependencies...");
+        try {
+            await import("onnxruntime-node");
+            console.log("  ✓ onnxruntime-node loaded");
+        }
+        catch (e) {
+            console.error("  ✗ onnxruntime-node failed:", e.message);
+            process.exit(1);
+        }
+        try {
+            await import("sharp");
+            console.log("  ✓ sharp loaded");
+        }
+        catch (e) {
+            console.error("  ✗ sharp failed:", e.message);
+            process.exit(1);
+        }
+        console.log();
+        // Initialize embeddings service to download model
+        console.log("📥 Downloading ML model (this may take a minute)...");
+        console.log(`   Model: ${config.embeddingModel}`);
+        console.log(`   Cache: ~/.cache/huggingface/`);
+        console.log();
+        const embeddings = new EmbeddingsService(config.embeddingModel, config.embeddingDimension);
+        // Trigger model download by generating a test embedding
+        const startTime = Date.now();
+        await embeddings.embed("warmup test");
+        const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+        console.log();
+        console.log(`✅ Warmup complete! (${duration}s)`);
+        console.log();
+        console.log("Ready to use! Configure your MCP client and restart to get started.");
+        console.log();
+    }
+    catch (error) {
+        console.error();
+        console.error("❌ Warmup failed:", error);
+        console.error();
+        console.error("This is not a critical error - the server will download models on first run.");
+        console.error("You can try running 'vector-memory-mcp warmup' manually later.");
+        process.exit(0); // Exit successfully to not block installation
+    }
+}
+// Only run if this is the main module
+if (import.meta.url === `file://${process.argv[1]}`) {
+    warmup();
+}
+export { warmup };
+//# sourceMappingURL=warmup.js.map

package/dist/scripts/warmup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmup.js","sourceRoot":"","sources":["../../scripts/warmup.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,KAAK,UAAU,MAAM;IACnB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,IAAI,CAAC;QACH,4BAA4B;QAC5B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,kDAAkD;QAClD,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,UAAU,GAAG,IAAI,iBAAiB,CACtC,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,kBAAkB,CAC1B,CAAC;QAEF,wDAAwD;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE9D,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAC9F,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,8CAA8C;IACjE,CAAC;AACH,CAAC;AAED,sCAAsC;AACtC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,EAAE,CAAC;AACX,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/src/config/index.d.ts

@@ -0,0 +1,24 @@
+export declare const VERSION: string;
+export type TransportMode = "stdio" | "http" | "both";
+export interface Config {
+    dbPath: string;
+    embeddingModel: string;
+    embeddingDimension: number;
+    httpPort: number;
+    httpHost: string;
+    enableHttp: boolean;
+    transportMode: TransportMode;
+}
+export interface ConfigOverrides {
+    dbPath?: string;
+    httpPort?: number;
+    enableHttp?: boolean;
+    transportMode?: TransportMode;
+}
+export declare function loadConfig(overrides?: ConfigOverrides): Config;
+/**
+ * Parse CLI arguments into config overrides.
+ */
+export declare function parseCliArgs(argv: string[]): ConfigOverrides;
+export declare const config: Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAAsB,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAaD,wBAAgB,UAAU,CAAC,SAAS,GAAE,eAAoB,GAAG,MAAM,CAclE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAmB5D;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/src/config/index.js

@@ -0,0 +1,48 @@
+import arg from "arg";
+import { isAbsolute, join } from "path";
+import packageJson from "../../package.json" with { type: "json" };
+export const VERSION = packageJson.version;
+// Defaults - always use repo-local .vector-memory folder
+const DEFAULT_DB_PATH = join(process.cwd(), ".vector-memory", "memories.db");
+const DEFAULT_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
+const DEFAULT_EMBEDDING_DIMENSION = 384;
+const DEFAULT_HTTP_PORT = 3271;
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+function resolvePath(path) {
+    return isAbsolute(path) ? path : join(process.cwd(), path);
+}
+export function loadConfig(overrides = {}) {
+    const transportMode = overrides.transportMode ?? "stdio";
+    // HTTP enabled by default (needed for hooks), can disable with --no-http
+    const enableHttp = overrides.enableHttp ?? true;
+    return {
+        dbPath: resolvePath(overrides.dbPath ?? DEFAULT_DB_PATH),
+        embeddingModel: DEFAULT_EMBEDDING_MODEL,
+        embeddingDimension: DEFAULT_EMBEDDING_DIMENSION,
+        httpPort: overrides.httpPort ?? DEFAULT_HTTP_PORT,
+        httpHost: DEFAULT_HTTP_HOST,
+        enableHttp,
+        transportMode,
+    };
+}
+/**
+ * Parse CLI arguments into config overrides.
+ */
+export function parseCliArgs(argv) {
+    const args = arg({
+        "--db-file": String,
+        "--port": Number,
+        "--no-http": Boolean,
+        // Aliases
+        "-d": "--db-file",
+        "-p": "--port",
+    }, { argv, permissive: true });
+    return {
+        dbPath: args["--db-file"],
+        httpPort: args["--port"],
+        enableHttp: args["--no-http"] ? false : undefined,
+    };
+}
+// Default config for imports that don't use CLI args
+export const config = loadConfig();
+//# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAqB3C,yDAAyD;AACzD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAC7E,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAC1D,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEtC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAA6B,EAAE;IACxD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC;IACzD,yEAAyE;IACzE,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC;QACxD,cAAc,EAAE,uBAAuB;QACvC,kBAAkB,EAAE,2BAA2B;QAC/C,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,iBAAiB;QACjD,QAAQ,EAAE,iBAAiB;QAC3B,UAAU;QACV,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,IAAI,GAAG,GAAG,CACd;QACE,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,OAAO;QAEpB,UAAU;QACV,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;KACf,EACD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAC3B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAClD,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC"}

package/dist/src/db/connection.d.ts

@@ -0,0 +1,3 @@
+import * as lancedb from "@lancedb/lancedb";
+export declare function connectToDatabase(dbPath: string): Promise<lancedb.Connection>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAI5C,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAMnF"}

package/dist/src/db/connection.js

@@ -0,0 +1,10 @@
+import * as lancedb from "@lancedb/lancedb";
+import { mkdirSync } from "fs";
+import { dirname } from "path";
+export async function connectToDatabase(dbPath) {
+    // Ensure directory exists
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const db = await lancedb.connect(dbPath);
+    return db;
+}
+//# sourceMappingURL=connection.js.map

package/dist/src/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IACpD,0BAA0B;IAC1B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/src/db/memory.repository.d.ts

@@ -0,0 +1,49 @@
+import * as lancedb from "@lancedb/lancedb";
+import { type Memory, type HybridRow } from "../types/memory.js";
+export declare class MemoryRepository {
+    private db;
+    private ftsIndexPromise;
+    private migrationPromise;
+    constructor(db: lancedb.Connection);
+    private getTable;
+    /**
+     * Ensures schema migration has run. Uses a mutex pattern identical to ensureFtsIndex.
+     * Adds columns introduced after the initial schema (usefulness, access_count, last_accessed).
+     */
+    private ensureMigration;
+    /**
+     * Inspects the existing table schema and adds any missing columns with safe defaults.
+     * This handles databases created before the hybrid memory system was introduced.
+     */
+    private migrateSchemaIfNeeded;
+    /**
+     * Ensures the FTS index exists on the content column.
+     * Uses a mutex pattern to prevent concurrent index creation.
+     * The key insight: we must capture the promise BEFORE any await.
+     */
+    private ensureFtsIndex;
+    /**
+     * Creates the FTS index if it doesn't already exist.
+     * Gets its own table reference to ensure consistent index state.
+     */
+    private createFtsIndexIfNeeded;
+    /**
+     * Converts a raw LanceDB row to a Memory object.
+     */
+    private rowToMemory;
+    insert(memory: Memory): Promise<void>;
+    upsert(memory: Memory): Promise<void>;
+    findById(id: string): Promise<Memory | null>;
+    markDeleted(id: string): Promise<boolean>;
+    /**
+     * Performs hybrid search combining vector similarity and full-text search.
+     * Uses RRF (Reciprocal Rank Fusion) to combine rankings from both search methods.
+     *
+     * @param embedding - Query embedding vector
+     * @param query - Text query for full-text search
+     * @param limit - Maximum number of results to return
+     * @returns Array of HybridRow containing full Memory data plus RRF score
+     */
+    findHybrid(embedding: number[], query: string, limit: number): Promise<HybridRow[]>;
+}
+//# sourceMappingURL=memory.repository.d.ts.map

package/dist/src/db/memory.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.repository.d.ts","sourceRoot":"","sources":["../../../src/db/memory.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAgB;IAQf,OAAO,CAAC,EAAE;IALtB,OAAO,CAAC,eAAe,CAA8B;IAGrD,OAAO,CAAC,gBAAgB,CAA8B;gBAElC,EAAE,EAAE,OAAO,CAAC,UAAU;YAE5B,QAAQ;IAWtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;YACW,qBAAqB;IAqBnC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;YACW,sBAAsB;IAgBpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW5C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB/C;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA2B1F"}

package/dist/src/db/memory.repository.js

@@ -0,0 +1,215 @@
+import { Index, rerankers } from "@lancedb/lancedb";
+import { TABLE_NAME, memorySchema } from "./schema.js";
+import { DELETED_TOMBSTONE, } from "../types/memory.js";
+export class MemoryRepository {
+    db;
+    // Mutex for FTS index creation - ensures only one index creation runs at a time
+    // Once set, this promise is never cleared (FTS index persists in the database)
+    ftsIndexPromise = null;
+    // Mutex for schema migration - runs once per instance to add missing columns
+    migrationPromise = null;
+    constructor(db) {
+        this.db = db;
+    }
+    async getTable() {
+        const names = await this.db.tableNames();
+        if (names.includes(TABLE_NAME)) {
+            const table = await this.db.openTable(TABLE_NAME);
+            await this.ensureMigration(table);
+            return table;
+        }
+        // Create with empty data to initialize schema
+        return await this.db.createTable(TABLE_NAME, [], { schema: memorySchema });
+    }
+    /**
+     * Ensures schema migration has run. Uses a mutex pattern identical to ensureFtsIndex.
+     * Adds columns introduced after the initial schema (usefulness, access_count, last_accessed).
+     */
+    ensureMigration(table) {
+        if (this.migrationPromise) {
+            return this.migrationPromise;
+        }
+        this.migrationPromise = this.migrateSchemaIfNeeded(table).catch((error) => {
+            this.migrationPromise = null;
+            throw error;
+        });
+        return this.migrationPromise;
+    }
+    /**
+     * Inspects the existing table schema and adds any missing columns with safe defaults.
+     * This handles databases created before the hybrid memory system was introduced.
+     */
+    async migrateSchemaIfNeeded(table) {
+        const schema = await table.schema();
+        const existingFields = new Set(schema.fields.map((f) => f.name));
+        const migrations = [];
+        if (!existingFields.has("usefulness")) {
+            migrations.push({ name: "usefulness", valueSql: "cast(0.0 as float)" });
+        }
+        if (!existingFields.has("access_count")) {
+            migrations.push({ name: "access_count", valueSql: "cast(0 as int)" });
+        }
+        if (!existingFields.has("last_accessed")) {
+            migrations.push({ name: "last_accessed", valueSql: "cast(NULL as timestamp)" });
+        }
+        if (migrations.length > 0) {
+            await table.addColumns(migrations);
+        }
+    }
+    /**
+     * Ensures the FTS index exists on the content column.
+     * Uses a mutex pattern to prevent concurrent index creation.
+     * The key insight: we must capture the promise BEFORE any await.
+     */
+    ensureFtsIndex() {
+        // If there's already a pending or completed index creation, return that promise
+        if (this.ftsIndexPromise) {
+            return this.ftsIndexPromise;
+        }
+        // Synchronously set the promise BEFORE any await
+        // This is critical for proper mutex behavior in JS async code
+        this.ftsIndexPromise = this.createFtsIndexIfNeeded().catch((error) => {
+            // Reset on error so the next call can retry
+            this.ftsIndexPromise = null;
+            throw error;
+        });
+        return this.ftsIndexPromise;
+    }
+    /**
+     * Creates the FTS index if it doesn't already exist.
+     * Gets its own table reference to ensure consistent index state.
+     */
+    async createFtsIndexIfNeeded() {
+        const table = await this.getTable();
+        const indices = await table.listIndices();
+        const hasFtsIndex = indices.some((idx) => idx.columns.includes("content") && idx.indexType === "FTS");
+        if (!hasFtsIndex) {
+            await table.createIndex("content", {
+                config: Index.fts(),
+            });
+            // Wait for the index to be fully created and available
+            await table.waitForIndex(["content_idx"], 30);
+        }
+    }
+    /**
+     * Converts a raw LanceDB row to a Memory object.
+     */
+    rowToMemory(row) {
+        // Handle Arrow Vector type conversion
+        // LanceDB returns an Arrow Vector object which is iterable but not an array
+        const vectorData = row.vector;
+        const embedding = Array.isArray(vectorData)
+            ? vectorData
+            : Array.from(vectorData);
+        return {
+            id: row.id,
+            content: row.content,
+            embedding,
+            metadata: JSON.parse(row.metadata),
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+            supersededBy: row.superseded_by,
+            usefulness: row.usefulness ?? 0,
+            accessCount: row.access_count ?? 0,
+            lastAccessed: row.last_accessed
+                ? new Date(row.last_accessed)
+                : null,
+        };
+    }
+    async insert(memory) {
+        const table = await this.getTable();
+        await table.add([
+            {
+                id: memory.id,
+                vector: memory.embedding,
+                content: memory.content,
+                metadata: JSON.stringify(memory.metadata),
+                created_at: memory.createdAt.getTime(),
+                updated_at: memory.updatedAt.getTime(),
+                superseded_by: memory.supersededBy,
+                usefulness: memory.usefulness,
+                access_count: memory.accessCount,
+                last_accessed: memory.lastAccessed?.getTime() ?? null,
+            },
+        ]);
+    }
+    async upsert(memory) {
+        const table = await this.getTable();
+        const existing = await table.query().where(`id = '${memory.id}'`).limit(1).toArray();
+        if (existing.length === 0) {
+            return await this.insert(memory);
+        }
+        await table.update({
+            where: `id = '${memory.id}'`,
+            values: {
+                vector: memory.embedding,
+                content: memory.content,
+                metadata: JSON.stringify(memory.metadata),
+                created_at: memory.createdAt.getTime(),
+                updated_at: memory.updatedAt.getTime(),
+                superseded_by: memory.supersededBy,
+                usefulness: memory.usefulness,
+                access_count: memory.accessCount,
+                last_accessed: memory.lastAccessed?.getTime() ?? null,
+            },
+        });
+    }
+    async findById(id) {
+        const table = await this.getTable();
+        const results = await table.query().where(`id = '${id}'`).limit(1).toArray();
+        if (results.length === 0) {
+            return null;
+        }
+        return this.rowToMemory(results[0]);
+    }
+    async markDeleted(id) {
+        const table = await this.getTable();
+        // Verify existence first to match previous behavior (return false if not found)
+        const existing = await table.query().where(`id = '${id}'`).limit(1).toArray();
+        if (existing.length === 0) {
+            return false;
+        }
+        const now = Date.now();
+        await table.update({
+            where: `id = '${id}'`,
+            values: {
+                superseded_by: DELETED_TOMBSTONE,
+                updated_at: now,
+            },
+        });
+        return true;
+    }
+    /**
+     * Performs hybrid search combining vector similarity and full-text search.
+     * Uses RRF (Reciprocal Rank Fusion) to combine rankings from both search methods.
+     *
+     * @param embedding - Query embedding vector
+     * @param query - Text query for full-text search
+     * @param limit - Maximum number of results to return
+     * @returns Array of HybridRow containing full Memory data plus RRF score
+     */
+    async findHybrid(embedding, query, limit) {
+        // Ensure FTS index exists (with mutex to prevent concurrent creation)
+        // This must happen BEFORE getTable to ensure proper mutex behavior
+        await this.ensureFtsIndex();
+        const table = await this.getTable();
+        // Create RRF reranker with k=60 (standard parameter)
+        const reranker = await rerankers.RRFReranker.create(60);
+        // Perform hybrid search: combine vector search and full-text search
+        const results = await table
+            .query()
+            .nearestTo(embedding)
+            .fullTextSearch(query)
+            .rerank(reranker)
+            .limit(limit)
+            .toArray();
+        return results.map((row) => {
+            const memory = this.rowToMemory(row);
+            return {
+                ...memory,
+                rrfScore: row._relevance_score ?? 0,
+            };
+        });
+    }
+}
+//# sourceMappingURL=memory.repository.js.map

package/dist/src/db/memory.repository.js.map

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

package/dist/src/db/schema.d.ts

@@ -0,0 +1,4 @@
+import { Schema } from "apache-arrow";
+export declare const TABLE_NAME = "memories";
+export declare const memorySchema: Schema<any>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAQP,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,UAAU,aAAa,CAAC;AAErC,eAAO,MAAM,YAAY,aA2BvB,CAAC"}

package/dist/src/db/schema.js

@@ -0,0 +1,15 @@
+import { Schema, Field, FixedSizeList, Float32, Utf8, Timestamp, TimeUnit, Int32, } from "apache-arrow";
+export const TABLE_NAME = "memories";
+export const memorySchema = new Schema([
+    new Field("id", new Utf8(), false),
+    new Field("vector", new FixedSizeList(384, new Field("item", new Float32())), false),
+    new Field("content", new Utf8(), false),
+    new Field("metadata", new Utf8(), false), // JSON string
+    new Field("created_at", new Timestamp(TimeUnit.MILLISECOND), false),
+    new Field("updated_at", new Timestamp(TimeUnit.MILLISECOND), false),
+    new Field("superseded_by", new Utf8(), true), // Nullable
+    new Field("usefulness", new Float32(), false),
+    new Field("access_count", new Int32(), false),
+    new Field("last_accessed", new Timestamp(TimeUnit.MILLISECOND), true),
+]);
+//# sourceMappingURL=schema.js.map