@melandlabs/memory-store 0.2.6 → 0.3.0

package/dist/server/cli-shared.js

@@ -35,13 +35,14 @@ function isRawMessageChromaEnabled() {
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
 var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
-function resolveSQLiteRawMessageDbPath() {
+function resolveSQLiteRawMessageDbPath(dbPath) {
+  if (dbPath && dbPath.length > 0) return dbPath;
   const fromEnv = process.env.MEMORY_STORE_DB_PATH?.trim();
   return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_SQLITE_PATH;
 }
-async function getSQLiteRawMessageManager(_env) {
+async function getSQLiteRawMessageManager(options = {}) {
   if (!manager) {
-    const dbPath = resolveSQLiteRawMessageDbPath();
+    const dbPath = resolveSQLiteRawMessageDbPath(options.dbPath);
     mkdirSync(dirname(dbPath), { recursive: true });
     manager = new SQLiteRawMessageManager({
       dbPath,
@@ -60,7 +61,7 @@ async function closeSQLiteRawMessageManager() {
 }
 
 // src/storage/raw-message-store.ts
-function resolveBackend(env) {
+function resolveBackend(_env) {
   const explicit = process.env.OPENCONTEXT_MEMORY_STORE_BACKEND?.trim().toLowerCase();
   if (explicit === "postgres") return "postgres";
   return "sqlite";
@@ -87,7 +88,9 @@ function createRawMessageStore(options = {}) {
         }
         return pg;
       }
-      return await getSQLiteRawMessageManager();
+      return await getSQLiteRawMessageManager({
+        dbPath: options.dbPath
+      });
     },
     async close() {
       await closeSQLiteRawMessageManager();
@@ -278,6 +281,9 @@ async function buildUnified(args) {
   } else if (args.memoryBackend === "chroma") {
     if (!args.chromaUrl)
       throw new Error("--memory-backend=chroma requires --chroma-url <url> (or CHROMA_URL env)");
+    if (!aiRag) {
+      throw new Error("ai-rag modules not loaded");
+    }
     const store = new aiRag.ChromaVectorStore({
       url: args.chromaUrl,
       collectionName: "opencontext_raw_messages"
@@ -316,6 +322,9 @@ async function buildUnified(args) {
       throw new Error("--insights-backend=chroma requires --chroma-url <url> (or CHROMA_URL env)");
     if (!unified.embedQuery)
       throw new Error("--insights-backend=chroma requires --embedding-provider local|openrouter");
+    if (!aiRag) {
+      throw new Error("ai-rag modules not loaded");
+    }
     const store = new aiRag.ChromaVectorStore({
       url: args.chromaUrl,
       collectionName: args.insightsCollection
@@ -333,6 +342,9 @@ async function buildUnified(args) {
       throw new Error("--knowledge-backend=chroma requires --chroma-url <url> (or CHROMA_URL env)");
     if (!unified.embedQuery)
       throw new Error("--knowledge-backend=chroma requires --embedding-provider local|openrouter");
+    if (!aiRag) {
+      throw new Error("ai-rag modules not loaded");
+    }
     const store = new aiRag.ChromaVectorStore({
       url: args.chromaUrl,
       collectionName: args.knowledgeCollection

package/dist/storage/postgres-raw-message-factory.d.ts

@@ -1,4 +1,4 @@
-import { b as MemoryStoreEnv } from '../config-BYfTzG3h.js';
+import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
 
 /**
  * Lazy registration slot for the host's Postgres-backed raw message

package/dist/storage/raw-message-store.d.ts

@@ -1,5 +1,5 @@
 import { RawMessageStorageManager } from '@melandlabs/indexeddb/storage';
-import { b as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-BYfTzG3h.js';
+import { i as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-2Q092MUz.js';
 
 /**
  * Top-level raw-message store facade.
@@ -45,6 +45,8 @@ type RawMessageStorageManagerWithSearch = RawMessageStorageManager & {
 };
 interface CreateRawMessageStoreOptions {
     env?: MemoryStoreEnv;
+    /** Custom SQLite DB file path. Only used by the SQLite backend. */
+    dbPath?: string;
 }
 interface RawMessageStore {
     getManager(): Promise<RawMessageStorageManagerWithSearch>;

package/dist/storage/raw-message-store.js

@@ -34,13 +34,14 @@ function isRawMessageChromaEnabled() {
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
 var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
-function resolveSQLiteRawMessageDbPath() {
+function resolveSQLiteRawMessageDbPath(dbPath) {
+  if (dbPath && dbPath.length > 0) return dbPath;
   const fromEnv = process.env.MEMORY_STORE_DB_PATH?.trim();
   return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_SQLITE_PATH;
 }
-async function getSQLiteRawMessageManager(_env) {
+async function getSQLiteRawMessageManager(options = {}) {
   if (!manager) {
-    const dbPath = resolveSQLiteRawMessageDbPath();
+    const dbPath = resolveSQLiteRawMessageDbPath(options.dbPath);
     mkdirSync(dirname(dbPath), { recursive: true });
     manager = new SQLiteRawMessageManager({
       dbPath,
@@ -59,7 +60,7 @@ async function closeSQLiteRawMessageManager() {
 }
 
 // src/storage/raw-message-store.ts
-function resolveBackend(env) {
+function resolveBackend(_env) {
   const explicit = process.env.OPENCONTEXT_MEMORY_STORE_BACKEND?.trim().toLowerCase();
   if (explicit === "postgres") return "postgres";
   return "sqlite";
@@ -86,7 +87,9 @@ function createRawMessageStore(options = {}) {
         }
         return pg;
       }
-      return await getSQLiteRawMessageManager();
+      return await getSQLiteRawMessageManager({
+        dbPath: options.dbPath
+      });
     },
     async close() {
       await closeSQLiteRawMessageManager();
@@ -95,26 +98,34 @@ function createRawMessageStore(options = {}) {
 }
 var moduleStore = null;
 var moduleConfig = null;
+function resolveDbPath(config) {
+  if (!config) return void 0;
+  if (config.dbPath) return config.dbPath;
+  if (config.db && typeof config.db === "object" && "path" in config.db) {
+    return config.db.path;
+  }
+  return void 0;
+}
 function configureRawMessageStore(config) {
   moduleConfig = config;
-  moduleStore = createRawMessageStore({ env: config.env });
+  moduleStore = createRawMessageStore({ env: config.env, dbPath: resolveDbPath(config) });
   return moduleStore;
 }
 function getRawMessageStorageBackend() {
   if (!moduleStore) {
-    moduleStore = createRawMessageStore({ env: moduleConfig?.env });
+    moduleStore = createRawMessageStore({ env: moduleConfig?.env, dbPath: resolveDbPath(moduleConfig) });
   }
   return moduleStore.getBackend();
 }
 function isRawMessageStorageAvailable() {
   if (!moduleStore) {
-    moduleStore = createRawMessageStore({ env: moduleConfig?.env });
+    moduleStore = createRawMessageStore({ env: moduleConfig?.env, dbPath: resolveDbPath(moduleConfig) });
   }
   return moduleStore.isAvailable();
 }
 async function getRawMessageManager() {
   if (!moduleStore) {
-    moduleStore = createRawMessageStore({ env: moduleConfig?.env });
+    moduleStore = createRawMessageStore({ env: moduleConfig?.env, dbPath: resolveDbPath(moduleConfig) });
   }
   return moduleStore.getManager();
 }

package/dist/storage/sqlite-raw-message-store.d.ts

@@ -1,5 +1,5 @@
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
-import { b as MemoryStoreEnv } from '../config-BYfTzG3h.js';
+import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
 
 /**
  * SQLite-backed raw message store.
@@ -18,13 +18,16 @@ import { b as MemoryStoreEnv } from '../config-BYfTzG3h.js';
  * Resolve the SQLite DB file path from env vars. Exposed so other storage
  * layers (vector index) can stay in sync with the same default.
  */
-declare function resolveSQLiteRawMessageDbPath(): string;
+declare function resolveSQLiteRawMessageDbPath(dbPath?: string): string;
 /**
  * Local SQLite is the default. Every host (Tauri, server, CLI, tests) can
  * open the manager; the only failure mode is filesystem write permission.
  */
 declare function isSQLiteRawMessageStorageAvailable(_env?: MemoryStoreEnv): boolean;
-declare function getSQLiteRawMessageManager(_env?: MemoryStoreEnv): Promise<SQLiteRawMessageManager>;
+declare function getSQLiteRawMessageManager(options?: {
+    env?: MemoryStoreEnv;
+    dbPath?: string;
+}): Promise<SQLiteRawMessageManager>;
 declare function closeSQLiteRawMessageManager(): Promise<void>;
 /**
  * Test-only: reset the singleton. Used by vitest between test cases.

package/dist/storage/sqlite-raw-message-store.js

@@ -27,16 +27,17 @@ function isRawMessageChromaEnabled() {
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
 var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
-function resolveSQLiteRawMessageDbPath() {
+function resolveSQLiteRawMessageDbPath(dbPath) {
+  if (dbPath && dbPath.length > 0) return dbPath;
   const fromEnv = process.env.MEMORY_STORE_DB_PATH?.trim();
   return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_SQLITE_PATH;
 }
 function isSQLiteRawMessageStorageAvailable(_env) {
   return true;
 }
-async function getSQLiteRawMessageManager(_env) {
+async function getSQLiteRawMessageManager(options = {}) {
   if (!manager) {
-    const dbPath = resolveSQLiteRawMessageDbPath();
+    const dbPath = resolveSQLiteRawMessageDbPath(options.dbPath);
     mkdirSync(dirname(dbPath), { recursive: true });
     manager = new SQLiteRawMessageManager({
       dbPath,

package/dist/storage/sqlite-vector-index.d.ts

@@ -1,5 +1,5 @@
 import { VectorSearchResult } from '@melandlabs/rag/vector-service';
-import { b as MemoryStoreEnv } from '../config-BYfTzG3h.js';
+import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
 
 /**
  * SQLite-vec-backed raw-message + insight vector index.

package/dist/storage/sqlite-vector-index.js

@@ -9,7 +9,7 @@ import '@melandlabs/rag';
 
 // src/storage/sqlite-raw-message-store.ts
 var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
-function resolveSQLiteRawMessageDbPath() {
+function resolveSQLiteRawMessageDbPath(dbPath) {
   const fromEnv = process.env.MEMORY_STORE_DB_PATH?.trim();
   return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_SQLITE_PATH;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melandlabs/memory-store",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "type": "module",
   "files": [
     "dist",
@@ -60,14 +60,14 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "hono": "^4.6.14",
     "zod": "^4.3.6",
-    "@melandlabs/shared": "0.2.0",
-    "@melandlabs/sqlite": "0.2.0",
-    "@melandlabs/ai": "0.2.0",
-    "@melandlabs/rag": "0.2.0"
+    "@melandlabs/ai": "0.3.0",
+    "@melandlabs/sqlite": "0.3.0",
+    "@melandlabs/rag": "0.2.2",
+    "@melandlabs/shared": "0.3.0"
   },
   "peerDependencies": {
-    "@melandlabs/ai-rag": "0.2.2",
-    "@melandlabs/indexeddb": "0.2.0"
+    "@melandlabs/ai-rag": "0.2.4",
+    "@melandlabs/indexeddb": "0.3.0"
   },
   "peerDependenciesMeta": {
     "@melandlabs/ai-rag": {
@@ -80,8 +80,8 @@
   "devDependencies": {
     "@types/node": "^22.13.10",
     "typescript": "^5.6.3",
-    "@melandlabs/ai-rag": "0.2.2",
-    "@melandlabs/config": "0.2.0"
+    "@melandlabs/config": "0.3.0",
+    "@melandlabs/ai-rag": "0.2.4"
   },
   "scripts": {
     "build": "tsup",
@@ -89,6 +89,7 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
     "test:watch": "vitest"
   }
 }

package/dist/config-BYfTzG3h.d.ts

@@ -1,170 +0,0 @@
-/**
- * Memory store configuration — injected by the host application.
- *
- * The memory-store package is intentionally decoupled from the
- * opencontext web app's database layer. Each consumer wires up its own
- * implementation of the `db` contract.
- *
- * Backend selection is env-var driven, not host-injected:
- *   - Default: local SQLite at `~/.opencontext/memory/store.db`
- *     (override with `MEMORY_STORE_DB_PATH`).
- *   - Set `OPENCONTEXT_MEMORY_STORE_BACKEND=postgres` to opt into the
- *     host's registered Postgres factory (call `registerPostgresFactory`
- *     at startup). SQLite stays as the default in every other case.
- *
- * Required for raw-message persistence:
- *   - `db.getDb()` — returns a Drizzle DB handle (Postgres path only)
- *
- * Required for vector indexing:
- *   - one of `vector.sqlite-vec.dbPath` or `vector.chroma.url`
- *
- * Required for unified semantic search:
- *   - `unified.embedQuery` — the embedding provider's query embedder
- *
- * Optional for cross-source unified search:
- *   - `unified.searchKnowledge` — RAG over uploaded documents
- *   - `unified.searchInsights`   — over extracted insights
- *
- * If `unified.*` are absent, the SDK still works but the corresponding
- * sources in `searchUnifiedMemory` will return empty results with a
- * warning — fine for a standalone memory daemon.
- */
-
-interface MemoryStoreDb {
-    /** Resolve the active Drizzle DB handle. Must be server-side. */
-    getDb(): unknown;
-    /** Whether the DB has finished initializing (optional, for startup gating). */
-    isDbInitialized?(): boolean;
-    /** Initialize the DB (optional, called by `createMemoryStore` if present). */
-    initDb?(): unknown;
-    /**
-     * Drizzle table references for the postgres backend. Required when
-     * running outside Tauri mode without a registered factory. The host
-     * application owns the actual schema.
-     */
-    tables?: {
-        rawMessages?: unknown;
-        memorySummaries?: unknown;
-    };
-}
-/**
- * Placeholder for the historical host-injected environment. The fields
- * it used to expose (`isTauriMode`, `getTauriDbPath`, `getTauriDataDir`)
- * were Tauri-specific and have been removed. Backend selection is now
- * driven entirely by the `OPENCONTEXT_MEMORY_STORE_BACKEND` env var.
- *
- * The interface is kept (empty) so existing `env?: MemoryStoreEnv`
- * parameters on the public surface still type-check, but new code
- * should not need to construct a value of this type.
- */
-interface MemoryStoreEnv {
-}
-type VectorBackend = "sqlite-vec" | "chroma";
-interface MemoryStoreVectorConfig {
-    /** Active backend selector. Defaults to env-based detection. */
-    backend?: VectorBackend;
-    /** SQLite-vec options (used when backend === "sqlite-vec"). */
-    sqliteVec?: {
-        dbPath?: string;
-        insightsCollection?: string;
-    };
-    /** Chroma options (used when backend === "chroma"). */
-    chroma?: {
-        url?: string;
-        rawMessagesCollection?: string;
-        insightsCollection?: string;
-    };
-}
-type EmbedQueryFn = (input: {
-    userId: string;
-    query: string;
-    authToken?: string;
-}) => Promise<number[]>;
-interface UnifiedSearchKnowledgeResult {
-    chunkId: string;
-    documentId: string;
-    documentName: string;
-    content: string;
-    similarity: number;
-    chunkIndex: number;
-}
-interface UnifiedSearchInsightsResult {
-    id: string;
-    content: string;
-    similarity: number;
-    metadata: Record<string, unknown>;
-}
-interface UnifiedSearchDeps {
-    /** Embed a query string using the active user's provider. */
-    embedQuery?: EmbedQueryFn;
-    /**
-     * Postgres-side ANN search over `raw_messages`. Used when chroma is
-     * not enabled but the host has a postgres-backed manager. If both
-     * chroma and this are absent, the memory source will return empty
-     * (with a warning) in standalone mode.
-     */
-    searchRawMessagesAnn?: (input: {
-        userId: string;
-        queryEmbedding: number[];
-        limit: number;
-        threshold: number;
-        botId?: string;
-    }) => Promise<Array<{
-        id: string;
-        content: string;
-        similarity: number;
-        metadata: Record<string, unknown>;
-    }>>;
-    /** RAG over uploaded knowledge documents. Returns a list of chunk hits. */
-    searchKnowledge?: (input: {
-        userId: string;
-        query: string;
-        options: {
-            limit: number;
-            threshold: number;
-            documentIds?: string[];
-        };
-        authToken?: string;
-    }) => Promise<UnifiedSearchKnowledgeResult[]>;
-    /** Semantic search over extracted insights. */
-    searchInsights?: (input: {
-        userId: string;
-        query: string;
-        limit: number;
-        threshold: number;
-        botIds?: string[];
-        includeArchived?: boolean;
-        authToken?: string;
-    }) => Promise<UnifiedSearchInsightsResult[]>;
-    /**
-     * Optional BM25 (lexical) sub-query for the memory source. Mirrors the
-     * `searchRawMessagesAnn` shape but operates on FTS5 keywords instead of
-     * dense embeddings. When absent, the unified pipeline skips the lexical
-     * path and emits a `memory_lexical_search_not_configured` warning.
-     */
-    searchRawMessagesLexical?: (input: {
-        userId: string;
-        keywords: string[];
-        limit: number;
-        botId?: string;
-    }) => Promise<Array<{
-        id: string;
-        content: string;
-        similarity: number;
-        metadata: Record<string, unknown>;
-    }>>;
-}
-interface MemoryStoreConfig {
-    /** Database handle factory. Required for any persistence. */
-    db?: MemoryStoreDb;
-    /** Environment helpers. Defaults to a process.env-only stub if omitted. */
-    env?: MemoryStoreEnv;
-    /** Vector backend config. Defaults to env-based detection. */
-    vector?: MemoryStoreVectorConfig;
-    /** Optional cross-source search providers. */
-    unified?: UnifiedSearchDeps;
-    /** Optional logger. Defaults to console. */
-    logger?: Pick<Console, "log" | "warn" | "error">;
-}
-
-export type { EmbedQueryFn as E, MemoryStoreConfig as M, UnifiedSearchInsightsResult as U, VectorBackend as V, MemoryStoreDb as a, MemoryStoreEnv as b, UnifiedSearchKnowledgeResult as c, UnifiedSearchDeps as d };