@anuma/sdk 3.12.0 → 3.12.2

package/dist/react/index.cjs

@@ -8471,6 +8471,25 @@ var init_searchTool = __esm({
   }
 });
 
+// src/lib/memory/consolidationFallback.ts
+function notifyConsolidationFallback(reason, onFallback, detail) {
+  if (detail !== void 0) {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
+  } else {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
+  }
+  try {
+    onFallback?.(reason);
+  } catch {
+  }
+}
+var init_consolidationFallback = __esm({
+  "src/lib/memory/consolidationFallback.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/lib/memory/consolidate.ts
 var consolidate_exports = {};
 __export(consolidate_exports, {
@@ -8535,15 +8554,7 @@ ${candidateText}`;
   return result;
 }
 function degrade(reason, fallback, options, detail) {
-  if (detail !== void 0) {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
-  } else {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
-  }
-  try {
-    options.onFallback?.(reason);
-  } catch {
-  }
+  notifyConsolidationFallback(reason, options.onFallback, detail);
   return { ...fallback, fallbackReason: reason };
 }
 function validate2(parsed, newContent, validIds) {
@@ -8583,8 +8594,8 @@ var DEFAULT_CONSOLIDATION_MODEL, DEFAULT_CONSOLIDATE_ATTEMPTS, DEFAULT_CONSOLIDA
 var init_consolidate = __esm({
   "src/lib/memory/consolidate.ts"() {
     "use strict";
-    init_logger();
     init_redactor();
+    init_consolidationFallback();
     init_portalLlm();
     DEFAULT_CONSOLIDATION_MODEL = "inclusionai/ling-2.6-flash";
     DEFAULT_CONSOLIDATE_ATTEMPTS = 3;
@@ -16165,6 +16176,7 @@ init_constants();
 init_embeddings();
 init_vector();
 init_searchTool();
+init_consolidationFallback();
 var DEFAULT_AUTO_MERGE_THRESHOLD = 0.8;
 var DEFAULT_SCOPE = "private";
 var DEFAULT_CONSOLIDATE_THRESHOLD = 0.55;
@@ -16344,6 +16356,11 @@ async function retain(content, ctx, options = {}) {
         proofCount: 1
       };
     }
+    notifyConsolidationFallback(
+      "target_vanished",
+      options.consolidateOptions?.onFallback,
+      `supersede: primary target ${primaryTargetId} retired or deleted inside the atomic write`
+    );
   }
   const created = await createVaultMemoryOp(ctx.vaultCtx, createOpts);
   ctx.vaultCache.set(created.uniqueId, Float32Array.from(embedding));
@@ -16395,6 +16412,10 @@ function pickFactTypeUpdate(existing, incoming) {
 function resurrectFields(existing) {
   return typeof existing.archivedAt === "number" ? { restore: true } : { preserveUpdatedAt: true };
 }
+function abandonToRace(options, detail) {
+  notifyConsolidationFallback("target_vanished", options.consolidateOptions?.onFallback, detail);
+  return null;
+}
 async function tryConsolidate(trimmed, ctx, options, prepared) {
   const consolidateOptions = options.consolidateOptions;
   if (!consolidateOptions) return null;
@@ -16427,12 +16448,22 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       const existing = await getVaultMemoryOp(ctx.vaultCtx, id);
       if (existing && !existing.supersededBy) valid.push(id);
     }
-    if (valid.length === 0) return null;
+    if (valid.length === 0) {
+      return abandonToRace(
+        options,
+        `supersede: all ${requestedIds.length} target(s) deleted or already superseded`
+      );
+    }
     return { supersede: valid, content: decision.content };
   }
   if (decision.action === "noop" && decision.targetId) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -16457,7 +16488,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} deleted mid-write (proof-count bump lost)`
+      );
     }
     return {
       done: {
@@ -16470,7 +16504,12 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
   }
   if (decision.action === "update" && decision.targetId && decision.content) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -16501,7 +16540,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} deleted mid-write (consolidated rewrite lost)`
+      );
     }
     ctx.vaultCache.set(decision.targetId, Float32Array.from(newEmbedding));
     return {
@@ -16513,6 +16555,11 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       }
     };
   }
+  notifyConsolidationFallback(
+    "invalid_response",
+    options.consolidateOptions?.onFallback,
+    `unapplicable ${decision.action} decision reached the applier \u2014 validate() should have rejected it`
+  );
   return null;
 }
 async function assertMergeTargetGoneOrThrow(ctx, targetId) {
@@ -17095,7 +17142,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -17110,7 +17156,7 @@ function createAutoExtractor(options) {
     isProcessing: () => inflight > 0,
     dispose: () => {
       disposed = true;
-      for (const state of conversations.values()) state.pending = void 0;
+      if (inflight === 0) drainPending();
     }
   };
 }

package/dist/react/index.d.mts

@@ -6595,8 +6595,26 @@ interface RecallDiagnostics {
 }
 type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed" | "supersede";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
-/** Why the consolidator fell back to "create" instead of a real decision. */
-type ConsolidationFallbackReason = "llm_error" | "invalid_response";
+/**
+ * Why a retain fell back to "create" instead of applying a consolidation
+ * decision. Each value names a DIFFERENT thing to go fix, which is the point of
+ * keeping them apart:
+ *
+ * - `llm_error` — the consolidation call never produced a response (network,
+ *   timeout, 5xx, 429, empty completion, or missing credentials). Look at the
+ *   portal and the auth config.
+ * - `invalid_response` — the model answered, but with something unusable: an
+ *   unknown action, a targetId that was not in the candidate set, an `update` or
+ *   `supersede` with empty content, a `noop` with no target. Look at the prompt
+ *   and the model.
+ * - `target_vanished` — the model returned a decision that was valid when it was
+ *   made, and the row it named was deleted or superseded by a concurrent writer
+ *   before the write landed. Nothing is broken in the consolidator; a sustained
+ *   rate points at write contention (for example an auto-extraction worker and a
+ *   manual write racing over the same vault), which quietly costs you the
+ *   dedup that decision would have performed.
+ */
+type ConsolidationFallbackReason = "llm_error" | "invalid_response" | "target_vanished";
 interface RetainOptions {
     source?: RetainSource;
     sourceChunkIds?: string[];
@@ -7841,7 +7859,11 @@ interface AutoExtractor {
     processTurn(messages: AutoExtractMessage[], conversationId?: string): boolean;
     /** True while a turn's extraction is in flight. */
     isProcessing(): boolean;
-    /** Stop accepting new turns. In-flight work continues to completion. */
+    /**
+     * Stop accepting new turns. In-flight work continues to completion, and any
+     * turn already queued (coalesced while an extraction was in flight) is still
+     * flushed — never dropped — so a turn sent right before unmount isn't lost.
+     */
     dispose(): void;
 }
 /**

package/dist/react/index.d.ts

@@ -6595,8 +6595,26 @@ interface RecallDiagnostics {
 }
 type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed" | "supersede";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
-/** Why the consolidator fell back to "create" instead of a real decision. */
-type ConsolidationFallbackReason = "llm_error" | "invalid_response";
+/**
+ * Why a retain fell back to "create" instead of applying a consolidation
+ * decision. Each value names a DIFFERENT thing to go fix, which is the point of
+ * keeping them apart:
+ *
+ * - `llm_error` — the consolidation call never produced a response (network,
+ *   timeout, 5xx, 429, empty completion, or missing credentials). Look at the
+ *   portal and the auth config.
+ * - `invalid_response` — the model answered, but with something unusable: an
+ *   unknown action, a targetId that was not in the candidate set, an `update` or
+ *   `supersede` with empty content, a `noop` with no target. Look at the prompt
+ *   and the model.
+ * - `target_vanished` — the model returned a decision that was valid when it was
+ *   made, and the row it named was deleted or superseded by a concurrent writer
+ *   before the write landed. Nothing is broken in the consolidator; a sustained
+ *   rate points at write contention (for example an auto-extraction worker and a
+ *   manual write racing over the same vault), which quietly costs you the
+ *   dedup that decision would have performed.
+ */
+type ConsolidationFallbackReason = "llm_error" | "invalid_response" | "target_vanished";
 interface RetainOptions {
     source?: RetainSource;
     sourceChunkIds?: string[];
@@ -7841,7 +7859,11 @@ interface AutoExtractor {
     processTurn(messages: AutoExtractMessage[], conversationId?: string): boolean;
     /** True while a turn's extraction is in flight. */
     isProcessing(): boolean;
-    /** Stop accepting new turns. In-flight work continues to completion. */
+    /**
+     * Stop accepting new turns. In-flight work continues to completion, and any
+     * turn already queued (coalesced while an extraction was in flight) is still
+     * flushed — never dropped — so a turn sent right before unmount isn't lost.
+     */
     dispose(): void;
 }
 /**

package/dist/react/index.mjs

@@ -164,8 +164,9 @@ import {
   PiiRedactor,
   createStreamingDeAnonymizer,
   isPiiRedactor,
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-TP6CJZ25.mjs";
+} from "./chunk-3NPDZZGO.mjs";
 import {
   callPortalJsonCompletion,
   consoleLogger,
@@ -7400,6 +7401,11 @@ async function retain(content, ctx, options = {}) {
         proofCount: 1
       };
     }
+    notifyConsolidationFallback(
+      "target_vanished",
+      options.consolidateOptions?.onFallback,
+      `supersede: primary target ${primaryTargetId} retired or deleted inside the atomic write`
+    );
   }
   const created = await createVaultMemoryOp(ctx.vaultCtx, createOpts);
   ctx.vaultCache.set(created.uniqueId, Float32Array.from(embedding));
@@ -7451,6 +7457,10 @@ function pickFactTypeUpdate(existing, incoming) {
 function resurrectFields(existing) {
   return typeof existing.archivedAt === "number" ? { restore: true } : { preserveUpdatedAt: true };
 }
+function abandonToRace(options, detail) {
+  notifyConsolidationFallback("target_vanished", options.consolidateOptions?.onFallback, detail);
+  return null;
+}
 async function tryConsolidate(trimmed, ctx, options, prepared) {
   const consolidateOptions = options.consolidateOptions;
   if (!consolidateOptions) return null;
@@ -7472,7 +7482,7 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-DOY3ZWTE.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-R6FH7XMV.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.content) {
@@ -7483,12 +7493,22 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       const existing = await getVaultMemoryOp(ctx.vaultCtx, id);
       if (existing && !existing.supersededBy) valid.push(id);
     }
-    if (valid.length === 0) return null;
+    if (valid.length === 0) {
+      return abandonToRace(
+        options,
+        `supersede: all ${requestedIds.length} target(s) deleted or already superseded`
+      );
+    }
     return { supersede: valid, content: decision.content };
   }
   if (decision.action === "noop" && decision.targetId) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -7513,7 +7533,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} deleted mid-write (proof-count bump lost)`
+      );
     }
     return {
       done: {
@@ -7526,7 +7549,12 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
   }
   if (decision.action === "update" && decision.targetId && decision.content) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -7557,7 +7585,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} deleted mid-write (consolidated rewrite lost)`
+      );
     }
     ctx.vaultCache.set(decision.targetId, Float32Array.from(newEmbedding));
     return {
@@ -7569,6 +7600,11 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       }
     };
   }
+  notifyConsolidationFallback(
+    "invalid_response",
+    options.consolidateOptions?.onFallback,
+    `unapplicable ${decision.action} decision reached the applier \u2014 validate() should have rejected it`
+  );
   return null;
 }
 async function assertMergeTargetGoneOrThrow(ctx, targetId) {
@@ -8149,7 +8185,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -8164,7 +8199,7 @@ function createAutoExtractor(options) {
     isProcessing: () => inflight > 0,
     dispose: () => {
       disposed = true;
-      for (const state of conversations.values()) state.pending = void 0;
+      if (inflight === 0) drainPending();
     }
   };
 }

package/dist/server/{chunk-PXN5Q3MD.mjs → chunk-RT75PNSJ.mjs}

@@ -1,3 +1,7 @@
+import {
+  getLogger
+} from "./chunk-OBDRKQQI.mjs";
+
 // src/lib/pii/patterns.ts
 function luhnCheck(digits) {
   let sum = 0;
@@ -637,7 +641,21 @@ function createStreamingDeAnonymizer(redactor, emit) {
   };
 }
 
+// src/lib/memory/consolidationFallback.ts
+function notifyConsolidationFallback(reason, onFallback, detail) {
+  if (detail !== void 0) {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
+  } else {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
+  }
+  try {
+    onFallback?.(reason);
+  } catch {
+  }
+}
+
 export {
   resolvePiiRedactor,
-  createStreamingDeAnonymizer
+  createStreamingDeAnonymizer,
+  notifyConsolidationFallback
 };

package/dist/server/{consolidate-JMGL3MXG.mjs → consolidate-4VEAS3YN.mjs}

@@ -1,9 +1,9 @@
 import {
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-PXN5Q3MD.mjs";
+} from "./chunk-RT75PNSJ.mjs";
 import {
-  callPortalJsonCompletion,
-  getLogger
+  callPortalJsonCompletion
 } from "./chunk-OBDRKQQI.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 
@@ -102,15 +102,7 @@ ${candidateText}`;
   return result;
 }
 function degrade(reason, fallback, options, detail) {
-  if (detail !== void 0) {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
-  } else {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
-  }
-  try {
-    options.onFallback?.(reason);
-  } catch {
-  }
+  notifyConsolidationFallback(reason, options.onFallback, detail);
   return { ...fallback, fallbackReason: reason };
 }
 function validate(parsed, newContent, validIds) {

package/dist/server/index.cjs

@@ -22995,6 +22995,25 @@ var init_redactor = __esm({
   }
 });
 
+// src/lib/memory/consolidationFallback.ts
+function notifyConsolidationFallback(reason, onFallback, detail) {
+  if (detail !== void 0) {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
+  } else {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
+  }
+  try {
+    onFallback?.(reason);
+  } catch {
+  }
+}
+var init_consolidationFallback = __esm({
+  "src/lib/memory/consolidationFallback.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/lib/memory/consolidate.ts
 var consolidate_exports = {};
 __export(consolidate_exports, {
@@ -23059,15 +23078,7 @@ ${candidateText}`;
   return result;
 }
 function degrade(reason, fallback, options, detail) {
-  if (detail !== void 0) {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
-  } else {
-    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
-  }
-  try {
-    options.onFallback?.(reason);
-  } catch {
-  }
+  notifyConsolidationFallback(reason, options.onFallback, detail);
   return { ...fallback, fallbackReason: reason };
 }
 function validate2(parsed, newContent, validIds) {
@@ -23107,8 +23118,8 @@ var DEFAULT_CONSOLIDATION_MODEL, DEFAULT_CONSOLIDATE_ATTEMPTS, DEFAULT_CONSOLIDA
 var init_consolidate = __esm({
   "src/lib/memory/consolidate.ts"() {
     "use strict";
-    init_logger();
     init_redactor();
+    init_consolidationFallback();
     init_portalLlm();
     DEFAULT_CONSOLIDATION_MODEL = "inclusionai/ling-2.6-flash";
     DEFAULT_CONSOLIDATE_ATTEMPTS = 3;
@@ -27822,6 +27833,7 @@ init_constants();
 init_embeddings();
 init_vector();
 init_searchTool();
+init_consolidationFallback();
 var DEFAULT_AUTO_MERGE_THRESHOLD = 0.8;
 var DEFAULT_SCOPE = "private";
 var DEFAULT_CONSOLIDATE_THRESHOLD = 0.55;
@@ -28001,6 +28013,11 @@ async function retain(content, ctx, options = {}) {
         proofCount: 1
       };
     }
+    notifyConsolidationFallback(
+      "target_vanished",
+      options.consolidateOptions?.onFallback,
+      `supersede: primary target ${primaryTargetId} retired or deleted inside the atomic write`
+    );
   }
   const created = await createVaultMemoryOp(ctx.vaultCtx, createOpts);
   ctx.vaultCache.set(created.uniqueId, Float32Array.from(embedding));
@@ -28052,6 +28069,10 @@ function pickFactTypeUpdate(existing, incoming) {
 function resurrectFields(existing) {
   return typeof existing.archivedAt === "number" ? { restore: true } : { preserveUpdatedAt: true };
 }
+function abandonToRace(options, detail) {
+  notifyConsolidationFallback("target_vanished", options.consolidateOptions?.onFallback, detail);
+  return null;
+}
 async function tryConsolidate(trimmed, ctx, options, prepared) {
   const consolidateOptions = options.consolidateOptions;
   if (!consolidateOptions) return null;
@@ -28084,12 +28105,22 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       const existing = await getVaultMemoryOp(ctx.vaultCtx, id);
       if (existing && !existing.supersededBy) valid.push(id);
     }
-    if (valid.length === 0) return null;
+    if (valid.length === 0) {
+      return abandonToRace(
+        options,
+        `supersede: all ${requestedIds.length} target(s) deleted or already superseded`
+      );
+    }
     return { supersede: valid, content: decision.content };
   }
   if (decision.action === "noop" && decision.targetId) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -28114,7 +28145,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `noop: target ${decision.targetId} deleted mid-write (proof-count bump lost)`
+      );
     }
     return {
       done: {
@@ -28127,7 +28161,12 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
   }
   if (decision.action === "update" && decision.targetId && decision.content) {
     const existing = await getVaultMemoryOp(ctx.vaultCtx, decision.targetId);
-    if (!existing || existing.supersededBy) return null;
+    if (!existing || existing.supersededBy) {
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} ${existing ? "superseded" : "deleted"} before the write`
+      );
+    }
     const mergedSourceIds = unionStrings(
       existing.sourceChunkIds ?? [],
       options.sourceChunkIds ?? []
@@ -28158,7 +28197,10 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     });
     if (!updated) {
       await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
-      return null;
+      return abandonToRace(
+        options,
+        `update: target ${decision.targetId} deleted mid-write (consolidated rewrite lost)`
+      );
     }
     ctx.vaultCache.set(decision.targetId, Float32Array.from(newEmbedding));
     return {
@@ -28170,6 +28212,11 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
       }
     };
   }
+  notifyConsolidationFallback(
+    "invalid_response",
+    options.consolidateOptions?.onFallback,
+    `unapplicable ${decision.action} decision reached the applier \u2014 validate() should have rejected it`
+  );
   return null;
 }
 async function assertMergeTargetGoneOrThrow(ctx, targetId) {
@@ -28752,7 +28799,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -28767,7 +28813,7 @@ function createAutoExtractor(options) {
     isProcessing: () => inflight > 0,
     dispose: () => {
       disposed = true;
-      for (const state of conversations.values()) state.pending = void 0;
+      if (inflight === 0) drainPending();
     }
   };
 }

package/dist/server/index.d.mts

@@ -5254,8 +5254,26 @@ interface RecallDiagnostics {
 }
 type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed" | "supersede";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
-/** Why the consolidator fell back to "create" instead of a real decision. */
-type ConsolidationFallbackReason = "llm_error" | "invalid_response";
+/**
+ * Why a retain fell back to "create" instead of applying a consolidation
+ * decision. Each value names a DIFFERENT thing to go fix, which is the point of
+ * keeping them apart:
+ *
+ * - `llm_error` — the consolidation call never produced a response (network,
+ *   timeout, 5xx, 429, empty completion, or missing credentials). Look at the
+ *   portal and the auth config.
+ * - `invalid_response` — the model answered, but with something unusable: an
+ *   unknown action, a targetId that was not in the candidate set, an `update` or
+ *   `supersede` with empty content, a `noop` with no target. Look at the prompt
+ *   and the model.
+ * - `target_vanished` — the model returned a decision that was valid when it was
+ *   made, and the row it named was deleted or superseded by a concurrent writer
+ *   before the write landed. Nothing is broken in the consolidator; a sustained
+ *   rate points at write contention (for example an auto-extraction worker and a
+ *   manual write racing over the same vault), which quietly costs you the
+ *   dedup that decision would have performed.
+ */
+type ConsolidationFallbackReason = "llm_error" | "invalid_response" | "target_vanished";
 interface RetainOptions {
     source?: RetainSource;
     sourceChunkIds?: string[];
@@ -7250,7 +7268,11 @@ interface AutoExtractor {
     processTurn(messages: AutoExtractMessage[], conversationId?: string): boolean;
     /** True while a turn's extraction is in flight. */
     isProcessing(): boolean;
-    /** Stop accepting new turns. In-flight work continues to completion. */
+    /**
+     * Stop accepting new turns. In-flight work continues to completion, and any
+     * turn already queued (coalesced while an extraction was in flight) is still
+     * flushed — never dropped — so a turn sent right before unmount isn't lost.
+     */
     dispose(): void;
 }
 /**