@melandlabs/memory-store 0.3.0 → 1.0.0

package/dist/server/cli-shared.d.ts

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
-import { H as UnifiedSearchDeps } from '../config-2Q092MUz.js';
+import { U as UnifiedSearchDeps } from '../config-CnbqSek5.js';
+import '@melandlabs/memory-consolidation';
+import '@melandlabs/contracts/peer';
+import '@melandlabs/contracts';
 
 /**
  * Shared argv parsing + `unified.*` wiring for the memory-store CLI bins.
  *
  * Both `cli-http.ts` (the HTTP daemon) and `cli-mcp.ts` (the MCP daemon)
  * take the same `--embedding-provider` / `--*-backend` flag surface —
- * the MCP server exposes the same `searchUnifiedMemory` tool the HTTP
+ * the MCP server exposes the same `memory.search` tool the HTTP
  * `/v1/search` route does, so they must speak the same config. This
  * module owns that surface so the two bins stay in lock-step.
  *

package/dist/server/cli-shared.js

@@ -1,10 +1,11 @@
 #!/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';
+import '@melandlabs/contracts';
 
 // src/storage/postgres-raw-message-factory.ts
 var factory = null;
@@ -14,6 +15,8 @@ async function resolvePostgresFactory(env) {
 function hasPostgresFactory() {
   return factory !== null;
 }
+
+// src/storage/chroma-memory-index.ts
 var RAW_VECTOR_BACKEND_ENV_KEYS = [
   "RAW_MESSAGE_VECTOR_STORE_BACKEND",
   "MEMORY_VECTOR_STORE_BACKEND",
@@ -34,11 +37,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) {

package/dist/storage/chroma-memory-index.d.ts

@@ -1,5 +1,6 @@
 import { RawMessage } from '../contracts.js';
 import '@melandlabs/ai/memory';
+import '@melandlabs/contracts';
 
 /**
  * Chroma-backed raw-message + insight vector index.

package/dist/storage/chroma-memory-index.js

@@ -1,9 +1,8 @@
 import { buildMemoryRecordEmbeddingDocument } from '@melandlabs/ai/memory';
 import { ChromaVectorStore } from '@melandlabs/rag';
+import '@melandlabs/contracts';
 
 // src/storage/chroma-memory-index.ts
-
-// src/contracts.ts
 function normalizeTimestampToMs(value) {
   if (!Number.isFinite(value)) {
     return 0;

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

@@ -1,4 +1,7 @@
-import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
+import { a as MemoryStoreEnv } from '../config-CnbqSek5.js';
+import '@melandlabs/memory-consolidation';
+import '@melandlabs/contracts/peer';
+import '@melandlabs/contracts';
 
 /**
  * Lazy registration slot for the host's Postgres-backed raw message

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

@@ -1,5 +1,8 @@
-import { RawMessageStorageManager } from '@melandlabs/indexeddb/storage';
-import { i as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-2Q092MUz.js';
+import { RawMessageStorageManager } from '@melandlabs/indexeddb';
+import { a as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-CnbqSek5.js';
+import '@melandlabs/memory-consolidation';
+import '@melandlabs/contracts/peer';
+import '@melandlabs/contracts';
 
 /**
  * Top-level raw-message store facade.

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

@@ -1,9 +1,10 @@
 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';
+import '@melandlabs/contracts';
 
 // src/storage/postgres-raw-message-factory.ts
 var factory = null;
@@ -13,6 +14,8 @@ async function resolvePostgresFactory(env) {
 function hasPostgresFactory() {
   return factory !== null;
 }
+
+// src/storage/chroma-memory-index.ts
 var RAW_VECTOR_BACKEND_ENV_KEYS = [
   "RAW_MESSAGE_VECTOR_STORE_BACKEND",
   "MEMORY_VECTOR_STORE_BACKEND",
@@ -33,11 +36,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) {

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

@@ -1,5 +1,8 @@
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
-import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
+import { a as MemoryStoreEnv } from '../config-CnbqSek5.js';
+import '@melandlabs/memory-consolidation';
+import '@melandlabs/contracts/peer';
+import '@melandlabs/contracts';
 
 /**
  * SQLite-backed raw message store.
@@ -45,6 +48,7 @@ declare function lexicalSearchRawMessages(input: {
     includeArchived?: boolean;
     platform?: string;
     botId?: string;
+    factTypes?: Array<"world" | "experience" | "mental_model">;
 }): Promise<unknown[]>;
 
 export { __resetSQLiteRawMessageManagerForTests, closeSQLiteRawMessageManager, getSQLiteRawMessageManager, isSQLiteRawMessageStorageAvailable, lexicalSearchRawMessages, resolveSQLiteRawMessageDbPath };

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

@@ -1,11 +1,14 @@
 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';
+import '@melandlabs/contracts';
 
 // src/storage/sqlite-raw-message-store.ts
+
+// src/storage/chroma-memory-index.ts
 var RAW_VECTOR_BACKEND_ENV_KEYS = [
   "RAW_MESSAGE_VECTOR_STORE_BACKEND",
   "MEMORY_VECTOR_STORE_BACKEND",
@@ -26,11 +29,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,8 @@
 import { VectorSearchResult } from '@melandlabs/rag/vector-service';
-import { i as MemoryStoreEnv } from '../config-2Q092MUz.js';
+import { a as MemoryStoreEnv } from '../config-CnbqSek5.js';
+import '@melandlabs/memory-consolidation';
+import '@melandlabs/contracts/peer';
+import '@melandlabs/contracts';
 
 /**
  * SQLite-vec-backed raw-message + insight vector index.

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

@@ -1,17 +1,17 @@
 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';
+import '@melandlabs/contracts';
 
 // 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/dist/unified-search-Bft57TRH.d.ts

@@ -0,0 +1,122 @@
+import { S as SearchTier, b as UnifiedMemorySearchWarning, c as SearchEvidence, U as UnifiedSearchDeps, d as SearchInput, e as SearchOutput, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult } from './config-CnbqSek5.js';
+import { MemoryStorageAdapter } from '@melandlabs/ai/memory';
+import { Peer } from '@melandlabs/contracts/peer';
+import { OwnerScope, MemoryConsolidationPlan, ReflectApplyClusterKeyFn, MemoryStorageAdapterLike, MemoryGraphStoreWithOperationHistory, MemoryGraphUpdateResult } from '@melandlabs/memory-consolidation';
+
+/**
+ * `applyReflectedPlan` — agentic write-back facade.
+ *
+ * Composes the read-only `search({ synthesize })` evidence pipeline with
+ * the `applyReflectedConsolidationPlan` write-side so a single call
+ * gathers evidence (raw + summaries + insights + knowledge), vets the
+ * plan with the LLM (optional), and persists the result to the graph
+ * store + storage.
+ *
+ * Behaviour parity with `search({ synthesize: true })`:
+ *   - Reuses the same gather-evidence pipeline so the answer + evidence
+ *     are identical to a read-only search call.
+ *   - Honours `peerFilter` via the same scope check used by the unified
+ *     read pipeline.
+ *   - LLM `complete` is the same `deps.reasoning.complete` the read-only
+ *     path uses — no new injection point.
+ *
+ * Write path:
+ *   - When `graphStore` is set (either passed in or attached via
+ *     `attachMemoryGraphStore`), persists the graph plan via
+ *     `MemoryGraphStoreWithOperationHistory.persistPlan`.
+ *   - Always runs `storage.deprecateRecords` for `deprecate` entries — the
+ *     deprecation chain is the critical path, so it runs even when the
+ *     graph store is missing (with a `reflect_apply_graph_store_not_configured`
+ *     warning).
+ */
+
+interface ApplyConsolidateInput {
+    userId: string;
+    query: string;
+    ownerScope: OwnerScope;
+    botIds?: string[];
+    dateFrom?: string;
+    dateTo?: string;
+    tiers?: ReadonlyArray<SearchTier>;
+    limit?: number;
+    threshold?: number;
+    plan?: MemoryConsolidationPlan;
+    dryRun?: boolean;
+    expectedVersion?: string;
+    llmPlanReview?: {
+        maxTokens?: number;
+    };
+    authToken?: string;
+    peerFilter?: ReadonlyArray<Peer>;
+    /**
+     * Cluster-key selector forwarded to `buildMemoryConsolidationPlan`.
+     * When omitted, callers should pass a pre-built `plan`.
+     */
+    getClusterKey?: ReflectApplyClusterKeyFn;
+    /**
+     * Optional storage adapter — falls back to `store.raw` when wired up by
+     * `createMemoryStore`. Required when no `graphStore` is attached and the
+     * caller still wants `deprecateRecords` writes.
+     */
+    storage?: MemoryStorageAdapterLike;
+    graphStore?: MemoryGraphStoreWithOperationHistory;
+}
+interface ApplyConsolidateOutput {
+    answer: string;
+    plan: MemoryConsolidationPlan;
+    persistenceResult?: MemoryGraphUpdateResult;
+    deprecationCounts?: Array<{
+        supersededBySummaryId: string;
+        count: number;
+    }>;
+    warnings: UnifiedMemorySearchWarning[];
+    applied: boolean;
+    evidence: SearchEvidence[];
+}
+interface MemoryStoreLike {
+    graphStore?: MemoryGraphStoreWithOperationHistory;
+    storage?: MemoryStorageAdapterLike | MemoryStorageAdapter;
+}
+declare function applyReflectedPlan(deps: UnifiedSearchDeps, store: MemoryStoreLike, input: ApplyConsolidateInput, _logger: Pick<Console, "log" | "warn" | "error">): Promise<ApplyConsolidateOutput>;
+
+/**
+ * Unified semantic search facade.
+ *
+ * Cross-source search over raw messages (always), insights, and
+ * uploaded knowledge documents. The host wires up the cross-domain
+ * dependencies via `UnifiedSearchDeps` so this module stays
+ * framework-agnostic.
+ *
+ * The public entry point is `search(input)` — a single method. Set
+ * `synthesize: true` to opt into the LLM synthesis step.
+ */
+
+interface UnifiedSearch {
+    /**
+     * Single unified read entry point. Set `synthesize: true` to opt into
+     * LLM synthesis.
+     */
+    search(input: SearchInput): Promise<SearchOutput>;
+    /**
+     * @deprecated Use `search(input)` instead. Forwarding shim kept for
+     * one release window.
+     */
+    searchUnifiedMemory(input: UnifiedMemorySearchInput): Promise<UnifiedMemorySearchOutput>;
+    /**
+     * @deprecated Use `search({ ...input, sources: ["memory"] })` and
+     * read `.results` instead.
+     */
+    searchRawMemorySemantically(input: UnifiedMemorySearchInput): Promise<UnifiedMemorySearchResult[]>;
+    /**
+     * Agentic write-back: runs the same evidence pipeline as `search`,
+     * then builds a memory-consolidation plan, optionally asks the LLM
+     * to veto unsafe entries, and persists via the attached graph store
+     * (when present) + soft-deprecates superseded records via the storage
+     * adapter. See `./apply-reflect.ts` for the contract and degradation
+     * rules.
+     */
+    consolidate(input: ApplyConsolidateInput): Promise<ApplyConsolidateOutput>;
+}
+declare function createUnifiedSearch(deps?: UnifiedSearchDeps): UnifiedSearch;
+
+export { type ApplyConsolidateInput as A, type UnifiedSearch as U, type ApplyConsolidateOutput as a, applyReflectedPlan as b, createUnifiedSearch as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melandlabs/memory-store",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "type": "module",
   "files": [
     "dist",
@@ -60,14 +60,18 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "hono": "^4.6.14",
     "zod": "^4.3.6",
-    "@melandlabs/ai": "0.3.0",
-    "@melandlabs/sqlite": "0.3.0",
+    "@melandlabs/ai": "0.5.0",
+    "@melandlabs/memory-consolidation": "0.5.0",
+    "@melandlabs/env-config": "0.4.0",
+    "@melandlabs/contracts": "0.5.0",
+    "@melandlabs/sqlite": "0.5.0",
+    "@melandlabs/vsa": "0.3.0",
     "@melandlabs/rag": "0.2.2",
     "@melandlabs/shared": "0.3.0"
   },
   "peerDependencies": {
-    "@melandlabs/ai-rag": "0.2.4",
-    "@melandlabs/indexeddb": "0.3.0"
+    "@melandlabs/ai-rag": "0.2.6",
+    "@melandlabs/indexeddb": "0.5.0"
   },
   "peerDependenciesMeta": {
     "@melandlabs/ai-rag": {
@@ -80,8 +84,8 @@
   "devDependencies": {
     "@types/node": "^22.13.10",
     "typescript": "^5.6.3",
-    "@melandlabs/config": "0.3.0",
-    "@melandlabs/ai-rag": "0.2.4"
+    "@melandlabs/ai-rag": "0.2.6",
+    "@melandlabs/config": "0.3.0"
   },
   "scripts": {
     "build": "tsup",