@anuma/sdk 3.12.0 → 3.12.2

package/dist/server/index.d.ts

@@ -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;
 }
 /**

package/dist/server/index.mjs

@@ -134,8 +134,9 @@ import {
 } from "./chunk-FXGG7JA5.mjs";
 import {
   createStreamingDeAnonymizer,
+  notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-PXN5Q3MD.mjs";
+} from "./chunk-RT75PNSJ.mjs";
 import {
   callPortalJsonCompletion,
   extractJsonCandidate,
@@ -5311,6 +5312,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));
@@ -5362,6 +5368,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;
@@ -5383,7 +5393,7 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-JMGL3MXG.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-4VEAS3YN.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.content) {
@@ -5394,12 +5404,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 ?? []
@@ -5424,7 +5444,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: {
@@ -5437,7 +5460,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 ?? []
@@ -5468,7 +5496,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 {
@@ -5480,6 +5511,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) {
@@ -6060,7 +6096,6 @@ function createAutoExtractor(options) {
     return true;
   }
   function drainPending() {
-    if (disposed) return;
     for (const [conversationId, state] of conversations) {
       if (state.pending) {
         const messages = state.pending;
@@ -6075,7 +6110,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "3.12.0",
+  "version": "3.12.2",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -123,6 +123,7 @@
     "e2e:tools": "vitest run --config vitest.e2e.config.mts",
     "e2e:compare": "tsx scripts/compare-app-gen-runs.ts",
     "perf:slides": "vitest run --config vitest.perf.config.mts",
+    "perf:memory": "vitest run --config vitest.perf-memory.config.mts",
     "eval:engine": "tsx test/memory/longmemeval.ts --strategy engine",
     "eval:vault": "tsx test/memory/longmemeval.ts --strategy vault",
     "eval:longmemeval": "tsx test/memory/longmemeval.ts",