@anuma/sdk 3.11.2 → 3.11.3

package/dist/server/index.d.ts

@@ -5164,7 +5164,20 @@ type RecallDegradation =
 "rerank-unavailable"
 /** `budget: 'high'` requested but no `decomposeOptions`, so query
  *  decomposition was skipped and the budget downgraded to mid. */
- | "decompose-unavailable";
+ | "decompose-unavailable"
+/** There was no usable cosine lane, so results were ranked on BM25 (lexical)
+ *  alone: either the query embedding failed (or came back empty), or no
+ *  candidate had a vector to score against it because the row (re)embed failed.
+ *  Also set when the chunk lane — cosine-only, with no lexical equivalent — was
+ *  skipped for the same reason. The embeddings provider is a single upstream
+ *  with no fallback, so this is a whole-provider outage rather than a per-item
+ *  miss — expect a quality drop, not a total loss.
+ *
+ *  NOT set for a partial failure that leaves cosine running (a sub-query embed
+ *  failing back to the single-query path, or a row batch failing while other
+ *  rows keep usable vectors) — those are logged, not reported, so this stays a
+ *  reliable outage signal rather than a general embedding-error counter. */
+ | "embeddings-unavailable";
 /**
  * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
  * All timings are wall-clock milliseconds. Lane counts are post-dedupe,

package/dist/server/index.mjs

@@ -4,11 +4,14 @@ import {
   DEFAULT_CHUNK_SIZE,
   DEFAULT_MIN_CHUNK_SIZE,
   DEFAULT_VAULT_CACHE_SIZE,
+  EMBEDDINGS_DEGRADED_EMPTY,
   ENTITY_FANOUT,
   ENTITY_KINDS,
   LRUCache,
   MAX_HOPS,
   NODE_BUDGET,
+  RECALL_MAX_LIMIT,
+  RECALL_TOOL_NAME,
   RerankerUnavailableError,
   TOPICS_EXTRACTION_VERSION,
   TREND_RECENT_WINDOW_DAYS,
@@ -128,7 +131,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-NCKDSZPQ.mjs";
+} from "./chunk-FZZCEZL2.mjs";
 import {
   createStreamingDeAnonymizer,
   resolvePiiRedactor
@@ -5334,6 +5337,11 @@ async function retain(content, ctx, options = {}) {
         ...options.folderId !== void 0 && { folderId: options.folderId }
       }
     );
+    if (prepared.embeddingFailure || prepared.embeddingsUnavailable) {
+      throw new Error(
+        "retain: embeddings unavailable \u2014 refusing to auto-merge against an inert cosine lane, which would create a duplicate instead of merging into the existing memory. Retry when embeddings recover, or pass enableAutoMerge: false to force a create."
+      );
+    }
     if (options.consolidateOptions) {
       const outcome = await tryConsolidate(trimmed, ctx, options, prepared);
       if (outcome) {
@@ -6566,10 +6574,6 @@ function rankProfileCandidates(inputs, now = Date.now(), options = {}) {
   return ranked;
 }
 
-// src/lib/memory/recallConstants.ts
-var RECALL_TOOL_NAME = "recall_memory";
-var RECALL_MAX_LIMIT = 50;
-
 // src/lib/memory/recallTool.ts
 var DEFAULT_LIMIT = 8;
 var DEFAULT_BUDGET = "low";
@@ -6720,7 +6724,11 @@ function createRecallTool(ctx, toolOptions, callbacks) {
       conversationMemories += effectiveLimit;
       let surfaced = 0;
       try {
+        let recallDegraded = [];
         const recallOpts = {
+          onDiagnostics: (d) => {
+            recallDegraded = d.degraded;
+          },
           types: defaultTypes,
           limit: effectiveLimit,
           budget: defaultBudget,
@@ -6752,6 +6760,9 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           }
         }
         surfaced = result.memories.length;
+        if (result.memories.length === 0 && recallDegraded.includes("embeddings-unavailable")) {
+          return EMBEDDINGS_DEGRADED_EMPTY;
+        }
         const formatted = formatRecallResult(result.memories);
         return truncatedByBudget && surfaced > 0 ? `${formatted}
 

package/dist/server/{recall-AN7HBEFS.mjs → recall-QH3YX6T4.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-NCKDSZPQ.mjs";
+} from "./chunk-FZZCEZL2.mjs";
 import "./chunk-OBDRKQQI.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 export {

package/package.json

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