@anuma/sdk 3.11.6 → 3.12.1

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;
@@ -11786,13 +11797,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -11805,7 +11821,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -11813,7 +11830,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -11824,7 +11842,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {
@@ -14840,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;
@@ -15019,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));
@@ -15070,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;
@@ -15102,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 ?? []
@@ -15132,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: {
@@ -15145,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 ?? []
@@ -15176,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 {
@@ -15188,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) {

package/dist/expo/index.d.mts

@@ -2429,6 +2429,32 @@ type StepFinishEvent = {
         outputTokens?: number;
     };
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2436,6 +2462,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2447,6 +2475,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5282,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[];
@@ -5299,7 +5357,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5327,9 +5386,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

package/dist/expo/index.d.ts

@@ -2429,6 +2429,32 @@ type StepFinishEvent = {
         outputTokens?: number;
     };
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2436,6 +2462,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2447,6 +2475,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5282,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[];
@@ -5299,7 +5357,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5327,9 +5386,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

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,
@@ -3389,13 +3390,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -3408,7 +3414,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -3416,7 +3423,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -3427,7 +3435,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {
@@ -6575,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));
@@ -6626,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;
@@ -6647,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) {
@@ -6658,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 ?? []
@@ -6688,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: {
@@ -6701,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 ?? []
@@ -6732,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 {
@@ -6744,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) {