@melandlabs/memory-store 0.2.7 → 0.3.1

package/dist/server/cli-shared.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { mkdirSync } from 'fs';
-import { homedir } from 'os';
-import { join, dirname } from 'path';
+import { dirname } from 'path';
+import { getOpenContextPath } from '@melandlabs/env-config';
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
 import '@melandlabs/ai/memory';
 import '@melandlabs/rag';
@@ -34,11 +34,10 @@ function isRawMessageChromaEnabled() {
 
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
-var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
 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;
+  return fromEnv && fromEnv.length > 0 ? fromEnv : getOpenContextPath("memory", "store.db");
 }
 async function getSQLiteRawMessageManager(options = {}) {
   if (!manager) {
@@ -61,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";
@@ -281,6 +280,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"
@@ -319,6 +321,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
@@ -336,6 +341,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-Ll6ktm4D.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-Ll6ktm4D.js';
+import { i as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-2Q092MUz.js';
 
 /**
  * Top-level raw-message store facade.

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

@@ -1,6 +1,6 @@
 import { mkdirSync } from 'fs';
-import { homedir } from 'os';
-import { join, dirname } from 'path';
+import { dirname } from 'path';
+import { getOpenContextPath } from '@melandlabs/env-config';
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
 import '@melandlabs/ai/memory';
 import '@melandlabs/rag';
@@ -33,11 +33,10 @@ function isRawMessageChromaEnabled() {
 
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
-var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
 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;
+  return fromEnv && fromEnv.length > 0 ? fromEnv : getOpenContextPath("memory", "store.db");
 }
 async function getSQLiteRawMessageManager(options = {}) {
   if (!manager) {
@@ -60,7 +59,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";

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

@@ -1,5 +1,5 @@
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
-import { b as MemoryStoreEnv } from '../config-Ll6ktm4D.js';
+import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
 
 /**
  * SQLite-backed raw message store.

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

@@ -1,6 +1,6 @@
 import { mkdirSync } from 'fs';
-import { homedir } from 'os';
-import { join, dirname } from 'path';
+import { dirname } from 'path';
+import { getOpenContextPath } from '@melandlabs/env-config';
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
 import '@melandlabs/ai/memory';
 import '@melandlabs/rag';
@@ -26,11 +26,10 @@ function isRawMessageChromaEnabled() {
 
 // src/storage/sqlite-raw-message-store.ts
 var manager = null;
-var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
 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;
+  return fromEnv && fromEnv.length > 0 ? fromEnv : getOpenContextPath("memory", "store.db");
 }
 function isSQLiteRawMessageStorageAvailable(_env) {
   return true;

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-Ll6ktm4D.js';
+import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
 
 /**
  * SQLite-vec-backed raw-message + insight vector index.

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

@@ -1,6 +1,6 @@
 import 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
+import 'path';
+import { getOpenContextPath } from '@melandlabs/env-config';
 import '@melandlabs/sqlite';
 import '@melandlabs/ai/memory';
 import '@melandlabs/rag';
@@ -8,10 +8,9 @@ import '@melandlabs/rag';
 // src/storage/sqlite-raw-message-store.ts
 
 // src/storage/sqlite-raw-message-store.ts
-var DEFAULT_SQLITE_PATH = join(homedir(), ".opencontext", "memory", "store.db");
 function resolveSQLiteRawMessageDbPath(dbPath) {
   const fromEnv = process.env.MEMORY_STORE_DB_PATH?.trim();
-  return fromEnv && fromEnv.length > 0 ? fromEnv : DEFAULT_SQLITE_PATH;
+  return fromEnv && fromEnv.length > 0 ? fromEnv : getOpenContextPath("memory", "store.db");
 }
 
 // src/storage/sqlite-vector-index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melandlabs/memory-store",
-  "version": "0.2.7",
+  "version": "0.3.1",
   "type": "module",
   "files": [
     "dist",
@@ -60,14 +60,15 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "hono": "^4.6.14",
     "zod": "^4.3.6",
-    "@melandlabs/ai": "0.2.1",
-    "@melandlabs/sqlite": "0.2.1",
-    "@melandlabs/shared": "0.2.1",
-    "@melandlabs/rag": "0.2.1"
+    "@melandlabs/ai": "0.3.1",
+    "@melandlabs/env-config": "0.4.0",
+    "@melandlabs/rag": "0.2.2",
+    "@melandlabs/sqlite": "0.3.0",
+    "@melandlabs/shared": "0.3.0"
   },
   "peerDependencies": {
-    "@melandlabs/ai-rag": "0.2.3",
-    "@melandlabs/indexeddb": "0.2.1"
+    "@melandlabs/ai-rag": "0.2.4",
+    "@melandlabs/indexeddb": "0.3.0"
   },
   "peerDependenciesMeta": {
     "@melandlabs/ai-rag": {
@@ -80,8 +81,8 @@
   "devDependencies": {
     "@types/node": "^22.13.10",
     "typescript": "^5.6.3",
-    "@melandlabs/config": "0.2.1",
-    "@melandlabs/ai-rag": "0.2.3"
+    "@melandlabs/ai-rag": "0.2.4",
+    "@melandlabs/config": "0.3.0"
   },
   "scripts": {
     "build": "tsup",
@@ -89,6 +90,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-Ll6ktm4D.d.ts

@@ -1,183 +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 the Postgres backend
-     * (`OPENCONTEXT_MEMORY_STORE_BACKEND=postgres`).
-     */
-    db?: MemoryStoreDb;
-    /**
-     * Custom SQLite database file path for the default SQLite backend.
-     *
-     * If provided, this takes precedence over the `MEMORY_STORE_DB_PATH`
-     * environment variable and the default `~/.opencontext/memory/store.db`.
-     *
-     * For backward compatibility with early tutorials, `db.path` is also
-     * honoured when `db` is supplied as `{ type, path }`.
-     */
-    dbPath?: string;
-    /** 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 };