@hasna/mementos 0.10.9 → 0.10.11

package/dist/cli/index.js

@@ -2584,12 +2584,23 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
 CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
 CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
 INSERT OR IGNORE INTO _migrations (id) VALUES (14);
+`,
+    `
+CREATE TABLE IF NOT EXISTS memory_embeddings (
+  memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+  embedding TEXT NOT NULL,
+  model TEXT NOT NULL DEFAULT 'tfidf-512',
+  dimensions INTEGER NOT NULL DEFAULT 512,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memory_embeddings_model ON memory_embeddings(model);
+INSERT OR IGNORE INTO _migrations (id) VALUES (15);
 `
   ];
 });
 
 // src/types/index.ts
-var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, VersionConflictError;
+var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, VersionConflictError, MemoryConflictError;
 var init_types = __esm(() => {
   AgentConflictError = class AgentConflictError extends Error {
     conflict = true;
@@ -2631,8 +2642,92 @@ var init_types = __esm(() => {
       this.actual = actual;
     }
   };
+  MemoryConflictError = class MemoryConflictError extends Error {
+    existingId;
+    existingAgentId;
+    existingUpdatedAt;
+    constructor(key, existing) {
+      super(`Memory conflict: key "${key}" already exists (last written by ${existing.agent_id ?? "unknown"} at ${existing.updated_at}). Use conflict:"overwrite" to replace it.`);
+      this.name = "MemoryConflictError";
+      this.existingId = existing.id;
+      this.existingAgentId = existing.agent_id;
+      this.existingUpdatedAt = existing.updated_at;
+    }
+  };
 });
 
+// src/lib/embeddings.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length || a.length === 0)
+    return 0;
+  let dot = 0, magA = 0, magB = 0;
+  for (let i = 0;i < a.length; i++) {
+    dot += a[i] * b[i];
+    magA += a[i] * a[i];
+    magB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(magA) * Math.sqrt(magB);
+  return denom === 0 ? 0 : dot / denom;
+}
+async function openAIEmbed(text, apiKey) {
+  const res = await fetch(OPENAI_EMBED_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model: EMBED_MODEL,
+      input: text.slice(0, 8192)
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!res.ok) {
+    throw new Error(`OpenAI embedding API ${res.status}: ${await res.text()}`);
+  }
+  const data = await res.json();
+  return data.data[0].embedding;
+}
+function tfidfVector(text) {
+  const DIMS = 512;
+  const vec = new Float32Array(DIMS);
+  const tokens = text.toLowerCase().match(/\b\w+\b/g) ?? [];
+  for (const token of tokens) {
+    let hash = 2166136261;
+    for (let i = 0;i < token.length; i++) {
+      hash ^= token.charCodeAt(i);
+      hash = hash * 16777619 >>> 0;
+    }
+    vec[hash % DIMS] += 1;
+  }
+  let norm = 0;
+  for (let i = 0;i < DIMS; i++)
+    norm += vec[i] * vec[i];
+  norm = Math.sqrt(norm);
+  if (norm > 0)
+    for (let i = 0;i < DIMS; i++)
+      vec[i] /= norm;
+  return Array.from(vec);
+}
+async function generateEmbedding(text) {
+  const apiKey = process.env["OPENAI_API_KEY"];
+  if (apiKey) {
+    try {
+      const embedding2 = await openAIEmbed(text, apiKey);
+      return { embedding: embedding2, model: EMBED_MODEL, dimensions: EMBED_DIMENSIONS };
+    } catch {}
+  }
+  const embedding = tfidfVector(text);
+  return { embedding, model: "tfidf-512", dimensions: 512 };
+}
+function serializeEmbedding(embedding) {
+  return JSON.stringify(embedding);
+}
+function deserializeEmbedding(raw) {
+  return JSON.parse(raw);
+}
+var OPENAI_EMBED_URL = "https://api.openai.com/v1/embeddings", EMBED_MODEL = "text-embedding-3-small", EMBED_DIMENSIONS = 1536;
+
 // src/lib/redact.ts
 function redactSecrets(text) {
   let result = text;
@@ -2809,8 +2904,10 @@ var exports_memories = {};
 __export(exports_memories, {
   updateMemory: () => updateMemory,
   touchMemory: () => touchMemory,
+  semanticSearch: () => semanticSearch,
   parseMemoryRow: () => parseMemoryRow,
   listMemories: () => listMemories,
+  indexMemoryEmbedding: () => indexMemoryEmbedding,
   incrementRecallCount: () => incrementRecallCount,
   getMemoryVersions: () => getMemoryVersions,
   getMemoryByKey: () => getMemoryByKey,
@@ -2866,7 +2963,16 @@ function createMemory(input, dedupeMode = "merge", db) {
   const metadataJson = JSON.stringify(input.metadata || {});
   const safeValue = redactSecrets(input.value);
   const safeSummary = input.summary ? redactSecrets(input.summary) : null;
-  if (dedupeMode === "merge") {
+  const effectiveMode = dedupeMode === "overwrite" ? "merge" : dedupeMode === "version-fork" ? "create" : dedupeMode;
+  if (effectiveMode === "error") {
+    const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
+       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ? AND status = 'active'
+       LIMIT 1`).get(input.key, input.scope || "private", input.project_id || "");
+    if (existing) {
+      throw new MemoryConflictError(input.key, existing);
+    }
+  }
+  if (effectiveMode === "merge") {
     const existing = d.query(`SELECT id, version FROM memories
          WHERE key = ? AND scope = ?
            AND COALESCE(agent_id, '') = ?
@@ -3252,6 +3358,52 @@ function getMemoryVersions(memoryId, db) {
     return [];
   }
 }
+async function indexMemoryEmbedding(memoryId, text, db) {
+  try {
+    const d = db || getDatabase();
+    const { embedding, model, dimensions } = await generateEmbedding(text);
+    const serialized = serializeEmbedding(embedding);
+    d.run(`INSERT INTO memory_embeddings (memory_id, embedding, model, dimensions)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(memory_id) DO UPDATE SET embedding=excluded.embedding, model=excluded.model, dimensions=excluded.dimensions, created_at=datetime('now')`, [memoryId, serialized, model, dimensions]);
+  } catch {}
+}
+async function semanticSearch(queryText, options = {}, db) {
+  const d = db || getDatabase();
+  const { threshold = 0.5, limit = 10, scope, agent_id, project_id } = options;
+  const { embedding: queryEmbedding } = await generateEmbedding(queryText);
+  const conditions = ["m.status = 'active'", "e.embedding IS NOT NULL"];
+  const params = [];
+  if (scope) {
+    conditions.push("m.scope = ?");
+    params.push(scope);
+  }
+  if (agent_id) {
+    conditions.push("m.agent_id = ?");
+    params.push(agent_id);
+  }
+  if (project_id) {
+    conditions.push("m.project_id = ?");
+    params.push(project_id);
+  }
+  const where = conditions.join(" AND ");
+  const rows = d.prepare(`SELECT m.*, e.embedding FROM memories m
+     JOIN memory_embeddings e ON e.memory_id = m.id
+     WHERE ${where}`).all(...params);
+  const scored = [];
+  for (const row of rows) {
+    try {
+      const docEmbedding = deserializeEmbedding(row.embedding);
+      const score = cosineSimilarity(queryEmbedding, docEmbedding);
+      if (score >= threshold) {
+        const { embedding: _, ...memRow } = row;
+        scored.push({ memory: parseMemoryRow(memRow), score: Math.round(score * 1000) / 1000 });
+      }
+    } catch {}
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit);
+}
 var RECALL_PROMOTE_THRESHOLD = 3;
 var init_memories = __esm(() => {
   init_types();
@@ -5473,6 +5625,18 @@ var init_built_in_hooks = __esm(() => {
       });
     }
   });
+  hookRegistry.register({
+    type: "PostMemorySave",
+    blocking: false,
+    builtin: true,
+    priority: 300,
+    description: "Generate and store vector embedding for semantic memory search",
+    handler: async (ctx) => {
+      const { indexMemoryEmbedding: indexMemoryEmbedding2 } = await Promise.resolve().then(() => (init_memories(), exports_memories));
+      const text = [ctx.memory.value, ctx.memory.summary].filter(Boolean).join(" ");
+      indexMemoryEmbedding2(ctx.memory.id, text);
+    }
+  });
   hookRegistry.register({
     type: "PostMemoryInject",
     blocking: false,

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AA6ZD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AA0aD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}

package/dist/db/memories.d.ts

@@ -17,4 +17,24 @@ export declare function touchMemory(id: string, db?: Database): void;
 export declare function incrementRecallCount(id: string, db?: Database): void;
 export declare function cleanExpiredMemories(db?: Database): number;
 export declare function getMemoryVersions(memoryId: string, db?: Database): MemoryVersion[];
+export interface SemanticSearchResult {
+    memory: Memory;
+    score: number;
+}
+/**
+ * Store or update the embedding for a memory. Called asynchronously after saves.
+ * Non-blocking: failures are silently ignored.
+ */
+export declare function indexMemoryEmbedding(memoryId: string, text: string, db?: Database): Promise<void>;
+/**
+ * Semantic search across memories using cosine similarity.
+ * Falls back gracefully if no embeddings exist yet.
+ */
+export declare function semanticSearch(queryText: string, options?: {
+    threshold?: number;
+    limit?: number;
+    scope?: string;
+    agent_id?: string;
+    project_id?: string;
+}, db?: Database): Promise<SemanticSearchResult[]>;
 //# sourceMappingURL=memories.d.ts.map

package/dist/db/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/db/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AA6B3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAwBnE;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,UAAU,GAAE,UAAoB,EAChC,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CA8IR;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CA4Bf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CAuBV;AAMD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CA4G3E;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAiHR;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAW/D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmBvE;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAUD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAsBpE;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAiB1D;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,EAAE,CAwBlF"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/db/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AA+B3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAwBnE;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,UAAU,GAAE,UAAoB,EAChC,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAqKR;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CA4Bf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CAuBV;AAMD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CA4G3E;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAiHR;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAW/D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmBvE;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAUD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAsBpE;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAiB1D;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,EAAE,CAwBlF;AAMD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuCjC"}

package/dist/index.js

@@ -63,6 +63,19 @@ class VersionConflictError extends Error {
     this.actual = actual;
   }
 }
+
+class MemoryConflictError extends Error {
+  existingId;
+  existingAgentId;
+  existingUpdatedAt;
+  constructor(key, existing) {
+    super(`Memory conflict: key "${key}" already exists (last written by ${existing.agent_id ?? "unknown"} at ${existing.updated_at}). Use conflict:"overwrite" to replace it.`);
+    this.name = "MemoryConflictError";
+    this.existingId = existing.id;
+    this.existingAgentId = existing.agent_id;
+    this.existingUpdatedAt = existing.updated_at;
+  }
+}
 // src/db/database.ts
 import { Database } from "bun:sqlite";
 import { existsSync, mkdirSync } from "fs";
@@ -477,6 +490,17 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
 CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
 CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
 INSERT OR IGNORE INTO _migrations (id) VALUES (14);
+`,
+  `
+CREATE TABLE IF NOT EXISTS memory_embeddings (
+  memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+  embedding TEXT NOT NULL,
+  model TEXT NOT NULL DEFAULT 'tfidf-512',
+  dimensions INTEGER NOT NULL DEFAULT 512,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memory_embeddings_model ON memory_embeddings(model);
+INSERT OR IGNORE INTO _migrations (id) VALUES (15);
 `
 ];
 var _db = null;
@@ -783,7 +807,16 @@ function createMemory(input, dedupeMode = "merge", db) {
   const metadataJson = JSON.stringify(input.metadata || {});
   const safeValue = redactSecrets(input.value);
   const safeSummary = input.summary ? redactSecrets(input.summary) : null;
-  if (dedupeMode === "merge") {
+  const effectiveMode = dedupeMode === "overwrite" ? "merge" : dedupeMode === "version-fork" ? "create" : dedupeMode;
+  if (effectiveMode === "error") {
+    const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
+       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ? AND status = 'active'
+       LIMIT 1`).get(input.key, input.scope || "private", input.project_id || "");
+    if (existing) {
+      throw new MemoryConflictError(input.key, existing);
+    }
+  }
+  if (effectiveMode === "merge") {
     const existing = d.query(`SELECT id, version FROM memories
          WHERE key = ? AND scope = ?
            AND COALESCE(agent_id, '') = ?

package/dist/lib/built-in-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/built-in-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAwHlD,wBAAgB,kBAAkB,IAAI,IAAI,CAyBzC;AAuBD,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAGD,YAAY,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"built-in-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/built-in-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAyIlD,wBAAgB,kBAAkB,IAAI,IAAI,CAyBzC;AAuBD,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAGD,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/lib/embeddings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Embedding generation and cosine similarity for semantic memory search.
+ *
+ * Uses OpenAI text-embedding-3-small if OPENAI_API_KEY is set,
+ * falls back to a simple TF-IDF term frequency vector otherwise.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    dimensions: number;
+}
+/**
+ * Generate an embedding for a text string.
+ * Uses OpenAI if OPENAI_API_KEY is available, otherwise uses TF-IDF hash trick.
+ */
+export declare function generateEmbedding(text: string): Promise<EmbeddingResult>;
+export declare function serializeEmbedding(embedding: number[]): string;
+export declare function deserializeEmbedding(raw: string): number[];
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/lib/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAUjE;AAwDD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAY9E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D"}

package/dist/mcp/index.js

@@ -17,7 +17,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/types/index.ts
-var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, DuplicateMemoryError, InvalidScopeError, VersionConflictError;
+var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, DuplicateMemoryError, InvalidScopeError, VersionConflictError, MemoryConflictError;
 var init_types = __esm(() => {
   AgentConflictError = class AgentConflictError extends Error {
     conflict = true;
@@ -71,6 +71,18 @@ var init_types = __esm(() => {
       this.actual = actual;
     }
   };
+  MemoryConflictError = class MemoryConflictError extends Error {
+    existingId;
+    existingAgentId;
+    existingUpdatedAt;
+    constructor(key, existing) {
+      super(`Memory conflict: key "${key}" already exists (last written by ${existing.agent_id ?? "unknown"} at ${existing.updated_at}). Use conflict:"overwrite" to replace it.`);
+      this.name = "MemoryConflictError";
+      this.existingId = existing.id;
+      this.existingAgentId = existing.agent_id;
+      this.existingUpdatedAt = existing.updated_at;
+    }
+  };
 });
 
 // src/db/database.ts
@@ -538,10 +550,93 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
 CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
 CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
 INSERT OR IGNORE INTO _migrations (id) VALUES (14);
+`,
+    `
+CREATE TABLE IF NOT EXISTS memory_embeddings (
+  memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+  embedding TEXT NOT NULL,
+  model TEXT NOT NULL DEFAULT 'tfidf-512',
+  dimensions INTEGER NOT NULL DEFAULT 512,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memory_embeddings_model ON memory_embeddings(model);
+INSERT OR IGNORE INTO _migrations (id) VALUES (15);
 `
   ];
 });
 
+// src/lib/embeddings.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length || a.length === 0)
+    return 0;
+  let dot = 0, magA = 0, magB = 0;
+  for (let i = 0;i < a.length; i++) {
+    dot += a[i] * b[i];
+    magA += a[i] * a[i];
+    magB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(magA) * Math.sqrt(magB);
+  return denom === 0 ? 0 : dot / denom;
+}
+async function openAIEmbed(text, apiKey) {
+  const res = await fetch(OPENAI_EMBED_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model: EMBED_MODEL,
+      input: text.slice(0, 8192)
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!res.ok) {
+    throw new Error(`OpenAI embedding API ${res.status}: ${await res.text()}`);
+  }
+  const data = await res.json();
+  return data.data[0].embedding;
+}
+function tfidfVector(text) {
+  const DIMS = 512;
+  const vec = new Float32Array(DIMS);
+  const tokens = text.toLowerCase().match(/\b\w+\b/g) ?? [];
+  for (const token of tokens) {
+    let hash = 2166136261;
+    for (let i = 0;i < token.length; i++) {
+      hash ^= token.charCodeAt(i);
+      hash = hash * 16777619 >>> 0;
+    }
+    vec[hash % DIMS] += 1;
+  }
+  let norm = 0;
+  for (let i = 0;i < DIMS; i++)
+    norm += vec[i] * vec[i];
+  norm = Math.sqrt(norm);
+  if (norm > 0)
+    for (let i = 0;i < DIMS; i++)
+      vec[i] /= norm;
+  return Array.from(vec);
+}
+async function generateEmbedding(text) {
+  const apiKey = process.env["OPENAI_API_KEY"];
+  if (apiKey) {
+    try {
+      const embedding2 = await openAIEmbed(text, apiKey);
+      return { embedding: embedding2, model: EMBED_MODEL, dimensions: EMBED_DIMENSIONS };
+    } catch {}
+  }
+  const embedding = tfidfVector(text);
+  return { embedding, model: "tfidf-512", dimensions: 512 };
+}
+function serializeEmbedding(embedding) {
+  return JSON.stringify(embedding);
+}
+function deserializeEmbedding(raw) {
+  return JSON.parse(raw);
+}
+var OPENAI_EMBED_URL = "https://api.openai.com/v1/embeddings", EMBED_MODEL = "text-embedding-3-small", EMBED_DIMENSIONS = 1536;
+
 // src/lib/redact.ts
 function redactSecrets(text) {
   let result = text;
@@ -714,8 +809,10 @@ var exports_memories = {};
 __export(exports_memories, {
   updateMemory: () => updateMemory,
   touchMemory: () => touchMemory,
+  semanticSearch: () => semanticSearch,
   parseMemoryRow: () => parseMemoryRow,
   listMemories: () => listMemories,
+  indexMemoryEmbedding: () => indexMemoryEmbedding,
   incrementRecallCount: () => incrementRecallCount,
   getMemoryVersions: () => getMemoryVersions,
   getMemoryByKey: () => getMemoryByKey,
@@ -771,7 +868,16 @@ function createMemory(input, dedupeMode = "merge", db) {
   const metadataJson = JSON.stringify(input.metadata || {});
   const safeValue = redactSecrets(input.value);
   const safeSummary = input.summary ? redactSecrets(input.summary) : null;
-  if (dedupeMode === "merge") {
+  const effectiveMode = dedupeMode === "overwrite" ? "merge" : dedupeMode === "version-fork" ? "create" : dedupeMode;
+  if (effectiveMode === "error") {
+    const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
+       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ? AND status = 'active'
+       LIMIT 1`).get(input.key, input.scope || "private", input.project_id || "");
+    if (existing) {
+      throw new MemoryConflictError(input.key, existing);
+    }
+  }
+  if (effectiveMode === "merge") {
     const existing = d.query(`SELECT id, version FROM memories
          WHERE key = ? AND scope = ?
            AND COALESCE(agent_id, '') = ?
@@ -1157,6 +1263,52 @@ function getMemoryVersions(memoryId, db) {
     return [];
   }
 }
+async function indexMemoryEmbedding(memoryId, text, db) {
+  try {
+    const d = db || getDatabase();
+    const { embedding, model, dimensions } = await generateEmbedding(text);
+    const serialized = serializeEmbedding(embedding);
+    d.run(`INSERT INTO memory_embeddings (memory_id, embedding, model, dimensions)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(memory_id) DO UPDATE SET embedding=excluded.embedding, model=excluded.model, dimensions=excluded.dimensions, created_at=datetime('now')`, [memoryId, serialized, model, dimensions]);
+  } catch {}
+}
+async function semanticSearch(queryText, options = {}, db) {
+  const d = db || getDatabase();
+  const { threshold = 0.5, limit = 10, scope, agent_id, project_id } = options;
+  const { embedding: queryEmbedding } = await generateEmbedding(queryText);
+  const conditions = ["m.status = 'active'", "e.embedding IS NOT NULL"];
+  const params = [];
+  if (scope) {
+    conditions.push("m.scope = ?");
+    params.push(scope);
+  }
+  if (agent_id) {
+    conditions.push("m.agent_id = ?");
+    params.push(agent_id);
+  }
+  if (project_id) {
+    conditions.push("m.project_id = ?");
+    params.push(project_id);
+  }
+  const where = conditions.join(" AND ");
+  const rows = d.prepare(`SELECT m.*, e.embedding FROM memories m
+     JOIN memory_embeddings e ON e.memory_id = m.id
+     WHERE ${where}`).all(...params);
+  const scored = [];
+  for (const row of rows) {
+    try {
+      const docEmbedding = deserializeEmbedding(row.embedding);
+      const score = cosineSimilarity(queryEmbedding, docEmbedding);
+      if (score >= threshold) {
+        const { embedding: _, ...memRow } = row;
+        scored.push({ memory: parseMemoryRow(memRow), score: Math.round(score * 1000) / 1000 });
+      }
+    } catch {}
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit);
+}
 var RECALL_PROMOTE_THRESHOLD = 3;
 var init_memories = __esm(() => {
   init_types();
@@ -3244,6 +3396,18 @@ var init_built_in_hooks = __esm(() => {
       });
     }
   });
+  hookRegistry.register({
+    type: "PostMemorySave",
+    blocking: false,
+    builtin: true,
+    priority: 300,
+    description: "Generate and store vector embedding for semantic memory search",
+    handler: async (ctx) => {
+      const { indexMemoryEmbedding: indexMemoryEmbedding2 } = await Promise.resolve().then(() => (init_memories(), exports_memories));
+      const text = [ctx.memory.value, ctx.memory.summary].filter(Boolean).join(" ");
+      indexMemoryEmbedding2(ctx.memory.id, text);
+    }
+  });
   hookRegistry.register({
     type: "PostMemoryInject",
     blocking: false,
@@ -9179,7 +9343,7 @@ function formatMemory(m) {
   return parts.join(`
 `);
 }
-server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shared=project, private=single agent.", {
+server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shared=project, private=single agent. conflict controls what happens when key already exists.", {
   key: exports_external.string(),
   value: exports_external.string(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
@@ -9192,20 +9356,23 @@ server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shar
   session_id: exports_external.string().optional(),
   ttl_ms: exports_external.union([exports_external.string(), exports_external.number()]).optional(),
   source: exports_external.enum(["user", "agent", "system", "auto", "imported"]).optional(),
-  metadata: exports_external.record(exports_external.unknown()).optional()
+  metadata: exports_external.record(exports_external.unknown()).optional(),
+  conflict: exports_external.enum(["merge", "overwrite", "error", "version-fork"]).optional().describe("Conflict strategy: merge=upsert(default), overwrite=same as merge, error=fail if key exists, version-fork=always create new")
 }, async (args) => {
   try {
     ensureAutoProject();
-    const input = { ...args };
-    if (args.ttl_ms !== undefined) {
-      input.ttl_ms = parseDuration(args.ttl_ms);
+    const { conflict, ...restArgs } = args;
+    const input = { ...restArgs };
+    if (restArgs.ttl_ms !== undefined) {
+      input.ttl_ms = parseDuration(restArgs.ttl_ms);
     }
     if (!input.project_id && input.agent_id) {
       const focusedProject = resolveProjectId(input.agent_id, null);
       if (focusedProject)
         input.project_id = focusedProject;
     }
-    const memory = createMemory(input);
+    const dedupeMode = conflict ?? "merge";
+    const memory = createMemory(input, dedupeMode);
     if (args.agent_id)
       touchAgent(args.agent_id);
     if (memory.scope === "shared" && memory.project_id && args.agent_id) {
@@ -9214,7 +9381,12 @@ server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shar
         broadcastSharedMemory2(memory, args.agent_id).catch(() => {});
       } catch {}
     }
-    return { content: [{ type: "text", text: `Saved: ${memory.key} (${memory.id.slice(0, 8)})` }] };
+    return { content: [{ type: "text", text: JSON.stringify({
+      saved: memory.key,
+      id: memory.id.slice(0, 8),
+      version: memory.version,
+      conflict_mode: dedupeMode
+    }) }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
@@ -9521,6 +9693,46 @@ ${lines.join(`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_search_semantic", "Semantic (meaning-based) memory search using vector embeddings. Finds memories by conceptual similarity, not keyword match. Uses OpenAI embeddings if OPENAI_API_KEY is set, otherwise TF-IDF.", {
+  query: exports_external.string().describe("Natural language query"),
+  threshold: exports_external.coerce.number().min(0).max(1).optional().describe("Minimum cosine similarity score (default: 0.5)"),
+  limit: exports_external.coerce.number().optional().describe("Max results (default: 10)"),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  index_missing: exports_external.coerce.boolean().optional().describe("If true, index any memories that lack embeddings before searching")
+}, async (args) => {
+  try {
+    ensureAutoProject();
+    if (args.index_missing) {
+      const db = getDatabase();
+      const unindexed = db.prepare(`SELECT id, value, summary FROM memories
+           WHERE status = 'active' AND id NOT IN (SELECT memory_id FROM memory_embeddings)
+           LIMIT 100`).all();
+      await Promise.all(unindexed.map((m) => indexMemoryEmbedding(m.id, [m.value, m.summary].filter(Boolean).join(" "))));
+    }
+    let effectiveProjectId = args.project_id;
+    if (!args.project_id && args.agent_id) {
+      effectiveProjectId = resolveProjectId(args.agent_id, null) ?? undefined;
+    }
+    const results = await semanticSearch(args.query, {
+      threshold: args.threshold,
+      limit: args.limit,
+      scope: args.scope,
+      agent_id: args.agent_id,
+      project_id: effectiveProjectId
+    });
+    if (results.length === 0) {
+      return { content: [{ type: "text", text: `No semantically similar memories found for: "${args.query}". Try a lower threshold or call with index_missing:true to generate embeddings first.` }] };
+    }
+    const lines = results.map((r, i) => `${i + 1}. [score:${r.score}] [${r.memory.scope}/${r.memory.category}] ${r.memory.key} = ${r.memory.value.slice(0, 120)}${r.memory.value.length > 120 ? "..." : ""}`);
+    return { content: [{ type: "text", text: `${results.length} semantic result(s) for "${args.query}":
+${lines.join(`
+`)}` }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_stats", "Get aggregate statistics about stored memories", {}, async () => {
   try {
     const db = getDatabase();

package/dist/server/index.js

@@ -18,7 +18,7 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/types/index.ts
-var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, DuplicateMemoryError, VersionConflictError;
+var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, DuplicateMemoryError, VersionConflictError, MemoryConflictError;
 var init_types = __esm(() => {
   AgentConflictError = class AgentConflictError extends Error {
     conflict = true;
@@ -66,6 +66,18 @@ var init_types = __esm(() => {
       this.actual = actual;
     }
   };
+  MemoryConflictError = class MemoryConflictError extends Error {
+    existingId;
+    existingAgentId;
+    existingUpdatedAt;
+    constructor(key, existing) {
+      super(`Memory conflict: key "${key}" already exists (last written by ${existing.agent_id ?? "unknown"} at ${existing.updated_at}). Use conflict:"overwrite" to replace it.`);
+      this.name = "MemoryConflictError";
+      this.existingId = existing.id;
+      this.existingAgentId = existing.agent_id;
+      this.existingUpdatedAt = existing.updated_at;
+    }
+  };
 });
 
 // src/db/database.ts
@@ -533,10 +545,93 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
 CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
 CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
 INSERT OR IGNORE INTO _migrations (id) VALUES (14);
+`,
+    `
+CREATE TABLE IF NOT EXISTS memory_embeddings (
+  memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+  embedding TEXT NOT NULL,
+  model TEXT NOT NULL DEFAULT 'tfidf-512',
+  dimensions INTEGER NOT NULL DEFAULT 512,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memory_embeddings_model ON memory_embeddings(model);
+INSERT OR IGNORE INTO _migrations (id) VALUES (15);
 `
   ];
 });
 
+// src/lib/embeddings.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length || a.length === 0)
+    return 0;
+  let dot = 0, magA = 0, magB = 0;
+  for (let i = 0;i < a.length; i++) {
+    dot += a[i] * b[i];
+    magA += a[i] * a[i];
+    magB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(magA) * Math.sqrt(magB);
+  return denom === 0 ? 0 : dot / denom;
+}
+async function openAIEmbed(text, apiKey) {
+  const res = await fetch(OPENAI_EMBED_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model: EMBED_MODEL,
+      input: text.slice(0, 8192)
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!res.ok) {
+    throw new Error(`OpenAI embedding API ${res.status}: ${await res.text()}`);
+  }
+  const data = await res.json();
+  return data.data[0].embedding;
+}
+function tfidfVector(text) {
+  const DIMS = 512;
+  const vec = new Float32Array(DIMS);
+  const tokens = text.toLowerCase().match(/\b\w+\b/g) ?? [];
+  for (const token of tokens) {
+    let hash = 2166136261;
+    for (let i = 0;i < token.length; i++) {
+      hash ^= token.charCodeAt(i);
+      hash = hash * 16777619 >>> 0;
+    }
+    vec[hash % DIMS] += 1;
+  }
+  let norm = 0;
+  for (let i = 0;i < DIMS; i++)
+    norm += vec[i] * vec[i];
+  norm = Math.sqrt(norm);
+  if (norm > 0)
+    for (let i = 0;i < DIMS; i++)
+      vec[i] /= norm;
+  return Array.from(vec);
+}
+async function generateEmbedding(text) {
+  const apiKey = process.env["OPENAI_API_KEY"];
+  if (apiKey) {
+    try {
+      const embedding2 = await openAIEmbed(text, apiKey);
+      return { embedding: embedding2, model: EMBED_MODEL, dimensions: EMBED_DIMENSIONS };
+    } catch {}
+  }
+  const embedding = tfidfVector(text);
+  return { embedding, model: "tfidf-512", dimensions: 512 };
+}
+function serializeEmbedding(embedding) {
+  return JSON.stringify(embedding);
+}
+function deserializeEmbedding(raw) {
+  return JSON.parse(raw);
+}
+var OPENAI_EMBED_URL = "https://api.openai.com/v1/embeddings", EMBED_MODEL = "text-embedding-3-small", EMBED_DIMENSIONS = 1536;
+
 // src/lib/redact.ts
 function redactSecrets(text) {
   let result = text;
@@ -709,8 +804,10 @@ var exports_memories = {};
 __export(exports_memories, {
   updateMemory: () => updateMemory,
   touchMemory: () => touchMemory,
+  semanticSearch: () => semanticSearch,
   parseMemoryRow: () => parseMemoryRow,
   listMemories: () => listMemories,
+  indexMemoryEmbedding: () => indexMemoryEmbedding,
   incrementRecallCount: () => incrementRecallCount,
   getMemoryVersions: () => getMemoryVersions,
   getMemoryByKey: () => getMemoryByKey,
@@ -766,7 +863,16 @@ function createMemory(input, dedupeMode = "merge", db) {
   const metadataJson = JSON.stringify(input.metadata || {});
   const safeValue = redactSecrets(input.value);
   const safeSummary = input.summary ? redactSecrets(input.summary) : null;
-  if (dedupeMode === "merge") {
+  const effectiveMode = dedupeMode === "overwrite" ? "merge" : dedupeMode === "version-fork" ? "create" : dedupeMode;
+  if (effectiveMode === "error") {
+    const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
+       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ? AND status = 'active'
+       LIMIT 1`).get(input.key, input.scope || "private", input.project_id || "");
+    if (existing) {
+      throw new MemoryConflictError(input.key, existing);
+    }
+  }
+  if (effectiveMode === "merge") {
     const existing = d.query(`SELECT id, version FROM memories
          WHERE key = ? AND scope = ?
            AND COALESCE(agent_id, '') = ?
@@ -1152,6 +1258,52 @@ function getMemoryVersions(memoryId, db) {
     return [];
   }
 }
+async function indexMemoryEmbedding(memoryId, text, db) {
+  try {
+    const d = db || getDatabase();
+    const { embedding, model, dimensions } = await generateEmbedding(text);
+    const serialized = serializeEmbedding(embedding);
+    d.run(`INSERT INTO memory_embeddings (memory_id, embedding, model, dimensions)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(memory_id) DO UPDATE SET embedding=excluded.embedding, model=excluded.model, dimensions=excluded.dimensions, created_at=datetime('now')`, [memoryId, serialized, model, dimensions]);
+  } catch {}
+}
+async function semanticSearch(queryText, options = {}, db) {
+  const d = db || getDatabase();
+  const { threshold = 0.5, limit = 10, scope, agent_id, project_id } = options;
+  const { embedding: queryEmbedding } = await generateEmbedding(queryText);
+  const conditions = ["m.status = 'active'", "e.embedding IS NOT NULL"];
+  const params = [];
+  if (scope) {
+    conditions.push("m.scope = ?");
+    params.push(scope);
+  }
+  if (agent_id) {
+    conditions.push("m.agent_id = ?");
+    params.push(agent_id);
+  }
+  if (project_id) {
+    conditions.push("m.project_id = ?");
+    params.push(project_id);
+  }
+  const where = conditions.join(" AND ");
+  const rows = d.prepare(`SELECT m.*, e.embedding FROM memories m
+     JOIN memory_embeddings e ON e.memory_id = m.id
+     WHERE ${where}`).all(...params);
+  const scored = [];
+  for (const row of rows) {
+    try {
+      const docEmbedding = deserializeEmbedding(row.embedding);
+      const score = cosineSimilarity(queryEmbedding, docEmbedding);
+      if (score >= threshold) {
+        const { embedding: _, ...memRow } = row;
+        scored.push({ memory: parseMemoryRow(memRow), score: Math.round(score * 1000) / 1000 });
+      }
+    } catch {}
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit);
+}
 var RECALL_PROMOTE_THRESHOLD = 3;
 var init_memories = __esm(() => {
   init_types();
@@ -3599,6 +3751,18 @@ hookRegistry.register({
     });
   }
 });
+hookRegistry.register({
+  type: "PostMemorySave",
+  blocking: false,
+  builtin: true,
+  priority: 300,
+  description: "Generate and store vector embedding for semantic memory search",
+  handler: async (ctx) => {
+    const { indexMemoryEmbedding: indexMemoryEmbedding2 } = await Promise.resolve().then(() => (init_memories(), exports_memories));
+    const text = [ctx.memory.value, ctx.memory.summary].filter(Boolean).join(" ");
+    indexMemoryEmbedding2(ctx.memory.id, text);
+  }
+});
 hookRegistry.register({
   type: "PostMemoryInject",
   blocking: false,

package/dist/types/index.d.ts

@@ -158,7 +158,7 @@ export interface MementosConfig {
         stale_deprioritize_days: number;
     };
 }
-export type DedupeMode = "merge" | "create";
+export type DedupeMode = "merge" | "create" | "overwrite" | "error" | "version-fork";
 export type SyncDirection = "push" | "pull" | "both";
 export type ConflictResolution = "prefer-local" | "prefer-remote" | "prefer-newer";
 export interface SyncOptions {
@@ -259,4 +259,14 @@ export declare class VersionConflictError extends Error {
     actual: number;
     constructor(id: string, expected: number, actual: number);
 }
+export declare class MemoryConflictError extends Error {
+    existingId: string;
+    existingAgentId: string | null;
+    existingUpdatedAt: string;
+    constructor(key: string, existing: {
+        id: string;
+        agent_id: string | null;
+        updated_at: string;
+    });
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAM1D,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAM7E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAM7E,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAM7D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAMD,MAAM,WAAW,mBAAoB,SAAQ,MAAM;IACjD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAMD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACtC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,QAAQ,EAAG,IAAI,CAAU;IACzC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,SAAgB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE/B,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;CAUF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,kBAAkB,CAE7E;AAMD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,WAAW,CAAC;IAC3B,gBAAgB,EAAE,cAAc,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,cAAc,EAAE,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAMD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAM5C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,CAAC;AACjH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AACpI,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,MAAM;IACjD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,EAAE,EAAE,MAAM;CAIvB;AAUD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;CAI5C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;gBAEV,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.10.9",
+  "version": "0.10.11",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",