@anuma/sdk 2.2.1 → 2.3.0

package/dist/expo/index.cjs

@@ -12716,6 +12716,7 @@ init_portalLlm();
 init_operations3();
 init_constants();
 init_embeddings();
+init_vector();
 init_searchTool();
 var DEFAULT_AUTO_MERGE_THRESHOLD = 0.85;
 var DEFAULT_SCOPE = "private";
@@ -12777,6 +12778,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -12806,6 +12816,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -13079,6 +13115,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -13086,7 +13124,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -13330,6 +13368,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window2[window2.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/dist/expo/index.d.mts

@@ -5096,7 +5096,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -5107,6 +5107,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -5156,7 +5164,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/expo/index.d.ts

@@ -5096,7 +5096,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -5107,6 +5107,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -5156,7 +5164,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/expo/index.mjs

@@ -5919,6 +5919,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -5948,6 +5957,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -6221,6 +6256,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -6228,7 +6265,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -6470,6 +6507,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window[window.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/dist/react/index.cjs

@@ -14067,6 +14067,7 @@ init_portalLlm();
 init_operations3();
 init_constants();
 init_embeddings();
+init_vector();
 init_searchTool();
 var DEFAULT_AUTO_MERGE_THRESHOLD = 0.85;
 var DEFAULT_SCOPE = "private";
@@ -14128,6 +14129,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -14157,6 +14167,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -14430,6 +14466,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -14437,7 +14475,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -14681,6 +14719,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window2[window2.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/dist/react/index.d.mts

@@ -6256,7 +6256,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -6267,6 +6267,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -6316,7 +6324,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/react/index.d.ts

@@ -6256,7 +6256,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -6267,6 +6267,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -6316,7 +6324,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/react/index.mjs

@@ -6741,6 +6741,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -6770,6 +6779,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -7043,6 +7078,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -7050,7 +7087,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -7292,6 +7329,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window2[window2.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/dist/server/index.cjs

@@ -25740,6 +25740,7 @@ init_portalLlm();
 init_operations3();
 init_constants();
 init_embeddings();
+init_vector();
 init_searchTool();
 var DEFAULT_AUTO_MERGE_THRESHOLD = 0.85;
 var DEFAULT_SCOPE = "private";
@@ -25801,6 +25802,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -25830,6 +25840,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -26103,6 +26139,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -26110,7 +26148,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -26354,6 +26392,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window2[window2.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/dist/server/index.d.mts

@@ -5759,7 +5759,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -5770,6 +5770,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -5819,7 +5827,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/server/index.d.ts

@@ -5759,7 +5759,7 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
-type RetainAction = "create" | "merge" | "update" | "skip";
+type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
 type ConsolidationFallbackReason = "llm_error" | "invalid_response";
@@ -5770,6 +5770,14 @@ interface RetainOptions {
     folderId?: string | null;
     /** When provided, applies merge-on-write logic instead of plain insert. */
     enableAutoMerge?: boolean;
+    /**
+     * When true, a would-be create is suppressed if it matches a soft-deleted
+     * ("tombstoned") memory above the auto-merge threshold — so auto-extraction
+     * can't silently resurrect a fact the user deleted. Off by default so manual
+     * and other `retain()` callers are unaffected; auto-extraction opts in.
+     * Returns `action: 'suppressed'` with the matched `tombstoneId`.
+     */
+    respectTombstones?: boolean;
     /** Cosine similarity threshold for auto-merge. Default: 0.85. */
     autoMergeThreshold?: number;
     /**
@@ -5819,7 +5827,12 @@ interface RetainResult {
     memoryId: string;
     /** When action is 'merge' or 'update', the prior memory's id. */
     targetId?: string;
-    /** Updated proof_count after this write. */
+    /**
+     * When action is 'suppressed', the id of the soft-deleted memory that blocked
+     * re-creation. `memoryId` is set to the same id (no new memory was written).
+     */
+    tombstoneId?: string;
+    /** Updated proof_count after this write. 0 when nothing was written (suppressed). */
     proofCount: number;
 }
 

package/dist/server/index.mjs

@@ -4722,6 +4722,15 @@ async function retain(content, ctx, options = {}) {
   }
   const embedding = await generateEmbedding(trimmed, ctx.embeddingOptions);
   const embeddingModel = ctx.embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  if (options.respectTombstones) {
+    const tombstoneId = await findTombstoneMatch(embedding, embeddingModel, resolvedScope, ctx, {
+      threshold,
+      folderId: options.folderId
+    });
+    if (tombstoneId) {
+      return { action: "suppressed", memoryId: tombstoneId, tombstoneId, proofCount: 0 };
+    }
+  }
   const created = await createVaultMemoryOp(ctx.vaultCtx, {
     content: trimmed,
     scope: resolvedScope,
@@ -4751,6 +4760,32 @@ async function retain(content, ctx, options = {}) {
 function unionStrings(a, b) {
   return [.../* @__PURE__ */ new Set([...a, ...b])];
 }
+async function findTombstoneMatch(embedding, embeddingModel, scope, ctx, opts) {
+  const rows = await getAllVaultMemoriesOp(ctx.vaultCtx, {
+    includeDeleted: true,
+    scopes: [scope],
+    ...opts.folderId !== void 0 && { folderId: opts.folderId }
+  });
+  let bestId = null;
+  let bestSim = opts.threshold;
+  for (const row of rows) {
+    if (!row.isDeleted || !row.embedding) continue;
+    if (row.embeddingModel !== embeddingModel) continue;
+    let vec;
+    try {
+      vec = JSON.parse(row.embedding);
+    } catch {
+      continue;
+    }
+    if (!Array.isArray(vec) || vec.length !== embedding.length) continue;
+    const sim = cosineSimilarity(embedding, vec);
+    if (sim >= bestSim) {
+      bestSim = sim;
+      bestId = row.uniqueId;
+    }
+  }
+  return bestId;
+}
 function pickEventTimeUpdate(existing, incoming) {
   if (incoming === void 0 || incoming === null) return void 0;
   if (existing.eventTimeStart !== null) return void 0;
@@ -5024,6 +5059,8 @@ async function extractAndRetain(messages, retainCtx, options) {
       const result = await retain(candidate.content, retainCtx, {
         source: "auto-extracted",
         sourceChunkIds: candidate.sourceMessageIds,
+        // Don't let extraction silently resurrect a fact the user deleted.
+        respectTombstones: true,
         ...options.scope !== void 0 && { scope: options.scope },
         ...options.folderId !== void 0 && { folderId: options.folderId },
         ...consolidateOptions !== void 0 && { consolidateOptions },
@@ -5031,7 +5068,7 @@ async function extractAndRetain(messages, retainCtx, options) {
       });
       succeededCandidates.push(candidate);
       results.push(result);
-      if (options.entityCtx && candidate.entities.length > 0) {
+      if (result.action !== "suppressed" && options.entityCtx && candidate.entities.length > 0) {
         try {
           if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
             await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities, {
@@ -5273,6 +5310,7 @@ function createAutoExtractor(options) {
         );
         stateFor(conversationId).watermark = window2[window2.length - 1].id;
         for (let i = 0; i < results.length; i++) {
+          if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
             candidate: candidates[i],
             result: results[i],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",