@anuma/sdk 3.12.0 → 3.12.2

package/dist/expo/{chunk-Y7XT2VNQ.mjs → chunk-WV7C7VHF.mjs}

@@ -1,3 +1,7 @@
+import {
+  getLogger
+} from "./chunk-ILAWDQDE.mjs";
+
 // src/lib/pii/patterns.ts
 function luhnCheck(digits) {
   let sum = 0;
@@ -637,10 +641,24 @@ 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 {
   PII_PATTERNS,
   PiiRedactor,
   isPiiRedactor,
   resolvePiiRedactor,
-  createStreamingDeAnonymizer
+  createStreamingDeAnonymizer,
+  notifyConsolidationFallback
 };

package/dist/expo/{consolidate-HYIEFPFA.mjs → consolidate-AURTG64H.mjs}

@@ -1,9 +1,9 @@
 import {
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-Y7XT2VNQ.mjs";
+} from "./chunk-WV7C7VHF.mjs";
 import {
-  callPortalJsonCompletion,
-  getLogger
+  callPortalJsonCompletion
 } from "./chunk-ILAWDQDE.mjs";
 import "./chunk-GYKJOWEO.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/expo/index.cjs

@@ -8170,6 +8170,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, {
@@ -8234,15 +8253,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) {
@@ -8282,8 +8293,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;
@@ -14848,6 +14859,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;
@@ -15027,6 +15039,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));
@@ -15078,6 +15095,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;
@@ -15110,12 +15131,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 ?? []
@@ -15140,7 +15171,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: {
@@ -15153,7 +15187,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 ?? []
@@ -15184,7 +15223,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 {
@@ -15196,6 +15238,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) {
@@ -15778,7 +15825,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -15793,7 +15839,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/expo/index.d.mts

@@ -5322,8 +5322,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[];
@@ -6614,7 +6632,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/expo/index.d.ts

@@ -5322,8 +5322,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[];
@@ -6614,7 +6632,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/expo/index.mjs

@@ -120,8 +120,9 @@ import {
   PiiRedactor,
   createStreamingDeAnonymizer,
   isPiiRedactor,
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-Y7XT2VNQ.mjs";
+} from "./chunk-WV7C7VHF.mjs";
 import {
   callPortalJsonCompletion,
   consoleLogger,
@@ -6583,6 +6584,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));
@@ -6634,6 +6640,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;
@@ -6655,7 +6665,7 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-HYIEFPFA.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-AURTG64H.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.content) {
@@ -6666,12 +6676,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 ?? []
@@ -6696,7 +6716,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: {
@@ -6709,7 +6732,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 ?? []
@@ -6740,7 +6768,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 {
@@ -6752,6 +6783,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) {
@@ -7332,7 +7368,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -7347,7 +7382,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/{chunk-TP6CJZ25.mjs → chunk-3NPDZZGO.mjs}

@@ -1,3 +1,7 @@
+import {
+  getLogger
+} from "./chunk-ILAWDQDE.mjs";
+
 // src/lib/pii/patterns.ts
 function luhnCheck(digits) {
   let sum = 0;
@@ -637,9 +641,23 @@ 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 {
   PiiRedactor,
   isPiiRedactor,
   resolvePiiRedactor,
-  createStreamingDeAnonymizer
+  createStreamingDeAnonymizer,
+  notifyConsolidationFallback
 };

package/dist/react/{consolidate-DOY3ZWTE.mjs → consolidate-R6FH7XMV.mjs}

@@ -1,9 +1,9 @@
 import {
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-TP6CJZ25.mjs";
+} from "./chunk-3NPDZZGO.mjs";
 import {
-  callPortalJsonCompletion,
-  getLogger
+  callPortalJsonCompletion
 } from "./chunk-ILAWDQDE.mjs";
 import "./chunk-GYKJOWEO.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) {