@anuma/sdk 3.11.2 → 3.11.4

package/dist/server/index.cjs

@@ -12352,7 +12352,7 @@ var require_Query = __commonJS({
     var _subscribeToCount = _interopRequireDefault(require_subscribeToCount());
     var _subscribeToQuery = _interopRequireDefault(require_subscribeToQuery());
     var _subscribeToQueryWithColumns = _interopRequireDefault(require_subscribeToQueryWithColumns());
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q10 = _interopRequireWildcard(require_QueryDescription());
     var _helpers = require_helpers2();
     var _class;
     var _descriptor;
@@ -12384,8 +12384,8 @@ var require_Query = __commonJS({
         (0, _initializerDefineProperty2.default)(this, "_cachedCountSubscribable", _descriptor2, this);
         (0, _initializerDefineProperty2.default)(this, "_cachedCountThrottledSubscribable", _descriptor3, this);
         this.collection = collection;
-        this._rawDescription = Q11.buildQueryDescription(clauses);
-        this.description = Q11.queryWithoutDeleted(this._rawDescription);
+        this._rawDescription = Q10.buildQueryDescription(clauses);
+        this.description = Q10.queryWithoutDeleted(this._rawDescription);
       }
       var _proto = Query2.prototype;
       _proto.extend = function(...args) {
@@ -12404,12 +12404,12 @@ var require_Query = __commonJS({
           sql
         } = this._rawDescription;
         (0, _invariant.default)(!sql, "Cannot extend an unsafe SQL query");
-        return new Query2(collection, [Q11.experimentalJoinTables(joinTables)].concat((0, _toConsumableArray2.default)(nestedJoinTables.map(function({
+        return new Query2(collection, [Q10.experimentalJoinTables(joinTables)].concat((0, _toConsumableArray2.default)(nestedJoinTables.map(function({
           from,
           to
         }) {
-          return Q11.experimentalNestedJoin(from, to);
-        })), (0, _toConsumableArray2.default)(where), (0, _toConsumableArray2.default)(sortBy), (0, _toConsumableArray2.default)(take ? [Q11.take(take)] : []), (0, _toConsumableArray2.default)(skip ? [Q11.skip(skip)] : []), (0, _toConsumableArray2.default)(lokiTransform ? [Q11.unsafeLokiTransform(lokiTransform)] : []), (0, _toConsumableArray2.default)(clauses)));
+          return Q10.experimentalNestedJoin(from, to);
+        })), (0, _toConsumableArray2.default)(where), (0, _toConsumableArray2.default)(sortBy), (0, _toConsumableArray2.default)(take ? [Q10.take(take)] : []), (0, _toConsumableArray2.default)(skip ? [Q10.skip(skip)] : []), (0, _toConsumableArray2.default)(lokiTransform ? [Q10.unsafeLokiTransform(lokiTransform)] : []), (0, _toConsumableArray2.default)(clauses)));
       };
       _proto.pipe = function(transform) {
         return transform(this);
@@ -13851,7 +13851,7 @@ var require_helpers5 = __commonJS({
     exports2.createTimestampsFor = void 0;
     exports2.fetchDescendants = fetchDescendants;
     var _fp = require_fp();
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q10 = _interopRequireWildcard(require_QueryDescription());
     function _getRequireWildcardCache(e) {
       if ("function" != typeof WeakMap) return null;
       var r = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap();
@@ -13889,7 +13889,7 @@ var require_helpers5 = __commonJS({
       });
       var childrenQueries = hasManyAssociations.map(function([key, value]) {
         var childCollection = model.collections.get(key);
-        return childCollection.query(Q11.where(value.foreignKey, model.id));
+        return childCollection.query(Q10.where(value.foreignKey, model.id));
       });
       return childrenQueries;
     }
@@ -14270,8 +14270,8 @@ var require_watermelondb = __commonJS({
     var _interopRequireDefault = require_interopRequireDefault();
     exports2.__esModule = true;
     exports2.tableSchema = exports2.tableName = exports2.localStorageKey = exports2.columnName = exports2.associations = exports2.appSchema = exports2.Relation = exports2.Query = exports2.Q = exports2.Model = exports2.Database = exports2.Collection = void 0;
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
-    exports2.Q = Q11;
+    var Q10 = _interopRequireWildcard(require_QueryDescription());
+    exports2.Q = Q10;
     var _Collection = _interopRequireDefault(require_Collection());
     exports2.Collection = _Collection.default;
     var _Database = _interopRequireDefault(require_Database());
@@ -14475,7 +14475,7 @@ var require_children = __commonJS({
     var _makeDecorator = _interopRequireDefault(require_makeDecorator());
     var _logError = _interopRequireDefault(require_logError());
     var _invariant = _interopRequireDefault(require_invariant());
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q10 = _interopRequireWildcard(require_QueryDescription());
     function _getRequireWildcardCache(e) {
       if ("function" != typeof WeakMap) return null;
       var r = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap();
@@ -14509,7 +14509,7 @@ var require_children = __commonJS({
             var childCollection = model.collections.get(childTable);
             var association = model.constructor.associations[childTable];
             (0, _invariant.default)(association && "has_many" === association.type, "@children decorator used for a table that's not has_many");
-            var query = childCollection.query(Q11.where(association.foreignKey, model.id));
+            var query = childCollection.query(Q10.where(association.foreignKey, model.id));
             that._childrenQueryCache[childTable] = query;
             return query;
           },
@@ -19399,6 +19399,17 @@ var init_mmr = __esm({
   }
 });
 
+// src/lib/memory/recallConstants.ts
+var RECALL_TOOL_NAME, RECALL_MAX_LIMIT, EMBEDDINGS_DEGRADED_EMPTY;
+var init_recallConstants = __esm({
+  "src/lib/memory/recallConstants.ts"() {
+    "use strict";
+    RECALL_TOOL_NAME = "recall_memory";
+    RECALL_MAX_LIMIT = 50;
+    EMBEDDINGS_DEGRADED_EMPTY = "Semantic memory search is temporarily unavailable, so only keyword matching ran and it found no matches. Do not conclude the user has no such memory \u2014 say the memory lookup was degraded, or retry with different keywords.";
+  }
+});
+
 // src/lib/memory/recency.ts
 function recencyMultiplier(updatedAt, opts = {}) {
   const noDate = opts.noDateMultiplier ?? DEFAULT_NO_DATE_MULTIPLIER;
@@ -20717,6 +20728,9 @@ async function recall(query, ctx, options = {}) {
   let vaultSize;
   let didRerank = false;
   let hadV2Head = false;
+  let embeddingsUnavailable = false;
+  let chunkEmbedFailed = false;
+  let factLaneRankedOnCosine = false;
   const emitDiagnostics = (candidateCount) => {
     const cb = options.onDiagnostics;
     if (!cb) return;
@@ -20725,6 +20739,7 @@ async function recall(query, ctx, options = {}) {
       degraded.push("rerank-unavailable");
     }
     if (flags.decompose && !decomposeAvailable) degraded.push("decompose-unavailable");
+    if (embeddingsUnavailable) degraded.push("embeddings-unavailable");
     const diagnostics = {
       usedBudget,
       reranked: didRerank,
@@ -20755,7 +20770,26 @@ async function recall(query, ctx, options = {}) {
   const graphRefiner = flags.traverse && options.graphRefine && options.decomposeOptions ? createLlmNeighborRefiner(options.decomposeOptions) : void 0;
   const prepStart = nowMs();
   const [queryEmbedding, entityRanking, temporalRanking] = await Promise.all([
-    needsChunkEmbedding ? generateEmbedding(query, ctx.embeddingOptions) : Promise.resolve(void 0),
+    // The chunk lane is cosine-only — `searchChunksOp` needs a real vector, and
+    // there is no lexical fallback for it — so an embeddings outage must SKIP the
+    // lane, not reject this shared Promise.all and take the primary fact lane
+    // (which BM25 can still serve) down with it. Mirrors safeLane's posture.
+    needsChunkEmbedding ? generateEmbedding(query, ctx.embeddingOptions).then((vec) => {
+      if (vec.length === 0) {
+        getLogger().warn(
+          "[memory/recall] chunk-lane query embedding came back empty; skipping the chunk lane"
+        );
+        chunkEmbedFailed = true;
+        return void 0;
+      }
+      return vec;
+    }).catch((err) => {
+      getLogger().warn(
+        `[memory/recall] chunk-lane query embedding failed; skipping the chunk lane: ${err instanceof Error ? err.message : String(err)}`
+      );
+      chunkEmbedFailed = true;
+      return void 0;
+    }) : Promise.resolve(void 0),
     // The graph + temporal lanes are AUXILIARY (RRF side-signals). A transient
     // WatermelonDB throw in either must NOT reject this Promise.all and take
     // PRIMARY cosine/BM25 recall down with it — degrade the failing lane to an
@@ -20780,7 +20814,9 @@ async function recall(query, ctx, options = {}) {
       results,
       vaultSize: size,
       reranked,
-      hadV2Head: v2Head
+      hadV2Head: v2Head,
+      embeddingsUnavailable: factEmbeddingsUnavailable,
+      rankedOnCosine: factRankedOnCosine
     } = await searchVaultMemoriesWithSize(
       query,
       ctx.vaultCtx,
@@ -20837,8 +20873,11 @@ async function recall(query, ctx, options = {}) {
     vaultSize = size;
     didRerank = reranked;
     hadV2Head = v2Head;
+    if (factEmbeddingsUnavailable) embeddingsUnavailable = true;
+    factLaneRankedOnCosine = factRankedOnCosine;
     factLaneMs = nowMs() - factStart;
   }
+  if (chunkEmbedFailed && !factLaneRankedOnCosine) embeddingsUnavailable = true;
   if (types.includes("chunk") && ctx.storageCtx && queryEmbedding) {
     const chunkStart = nowMs();
     const chunkMinScore = options.minScore ?? DEFAULT_CHUNK_MIN_SCORE;
@@ -21601,6 +21640,24 @@ async function eagerEmbedContent(content, embeddingOptions, cache, vaultCtx, mem
     );
   }
 }
+async function embedQueryOrDegrade(query, embeddingOptions, onDegraded) {
+  try {
+    const embedding = await generateEmbedding(query, embeddingOptions);
+    if (embedding.length === 0) {
+      getLogger().warn(
+        "memoryVault: query embedding came back empty \u2014 falling back to BM25-only ranking for this search"
+      );
+      onDegraded?.();
+    }
+    return embedding;
+  } catch (err) {
+    getLogger().warn(
+      "memoryVault: query embedding failed \u2014 falling back to BM25-only ranking for this search: " + (err instanceof Error ? err.message : String(err))
+    );
+    onDegraded?.();
+    return [];
+  }
+}
 function admitVaultProjections(queryEmbedding, vectored, k) {
   return vectored.map((it) => ({ it, score: cosineSimilarity(queryEmbedding, it.embedding) })).sort((a, b) => b.score - a.score || b.it.updatedAt.getTime() - a.it.updatedAt.getTime()).slice(0, k).map((s) => s.it.uniqueId);
 }
@@ -21612,23 +21669,36 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
   const hydrateOpts = queryOpts.includeArchived ? { includeArchived: true } : void 0;
   const vaultSize = keys.length;
   if (keys.length === 0) {
-    return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: 0 };
+    return {
+      memories: [],
+      embeddedItems: [],
+      queryEmbedding: [],
+      vaultSize: 0,
+      laneEmbedFailed: false
+    };
   }
-  const queryEmbedding = await generateEmbedding(query, embeddingOptions);
+  const queryEmbedding = await embedQueryOrDegrade(
+    query,
+    embeddingOptions,
+    opts.onEmbeddingDegraded
+  );
+  const embeddingsDegraded = queryEmbedding.length === 0;
   const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const vectored = [];
   const missIds = [];
   const noVectorIds = [];
   const keyById = new Map(keys.map((k2) => [k2.uniqueId, k2]));
-  for (const k2 of keys) {
-    const cached = cache.get(k2.uniqueId);
-    if (cached && cached.length === queryEmbedding.length) {
-      vectored.push({ uniqueId: k2.uniqueId, embedding: cached, updatedAt: k2.updatedAt });
-      continue;
+  if (!embeddingsDegraded) {
+    for (const k2 of keys) {
+      const cached = cache.get(k2.uniqueId);
+      if (cached && cached.length === queryEmbedding.length) {
+        vectored.push({ uniqueId: k2.uniqueId, embedding: cached, updatedAt: k2.updatedAt });
+        continue;
+      }
+      const modelCompatible = (k2.embeddingModel ?? currentModel) === currentModel;
+      if (modelCompatible) missIds.push(k2.uniqueId);
+      else noVectorIds.push(k2.uniqueId);
     }
-    const modelCompatible = (k2.embeddingModel ?? currentModel) === currentModel;
-    if (modelCompatible) missIds.push(k2.uniqueId);
-    else noVectorIds.push(k2.uniqueId);
   }
   if (missIds.length > 0) {
     const rows = await getVaultEmbeddingsByIdsOp(vaultCtx, missIds, hydrateOpts);
@@ -21649,6 +21719,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     }
     for (const id of missIds) if (!gotVector.has(id)) noVectorIds.push(id);
   }
+  let laneEmbedFailed = false;
   if (noVectorIds.length > 0) {
     const laneIds = noVectorIds.slice(0, opts.unembeddedCap);
     if (noVectorIds.length > laneIds.length) {
@@ -21660,26 +21731,44 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
       (m) => !isEncrypted(m.content)
     );
     if (laneRows.length > 0) {
-      const laneVecs = await generateEmbeddings(
-        laneRows.map((m) => m.content),
-        embeddingOptions
-      );
-      laneRows.forEach((m, i) => {
-        const vec = Float32Array.from(laneVecs[i]);
-        cache.set(m.uniqueId, vec);
-        vectored.push({ uniqueId: m.uniqueId, embedding: vec, updatedAt: m.updatedAt });
-        updateVaultMemoryEmbeddingOp(
-          vaultCtx,
-          m.uniqueId,
-          JSON.stringify(laneVecs[i]),
-          currentModel
-        ).catch(() => {
+      let laneVecs;
+      try {
+        laneVecs = await generateEmbeddings(
+          laneRows.map((m) => m.content),
+          embeddingOptions
+        );
+      } catch (err) {
+        laneEmbedFailed = true;
+        getLogger().warn(
+          `memoryVault: un-embedded lane embedding failed for ${laneRows.length} rows \u2014 they rank on BM25 alone for this search: ` + (err instanceof Error ? err.message : String(err))
+        );
+      }
+      if (laneVecs) {
+        const vecs = laneVecs;
+        laneRows.forEach((m, i) => {
+          const vec = Float32Array.from(vecs[i]);
+          cache.set(m.uniqueId, vec);
+          vectored.push({ uniqueId: m.uniqueId, embedding: vec, updatedAt: m.updatedAt });
+          updateVaultMemoryEmbeddingOp(
+            vaultCtx,
+            m.uniqueId,
+            JSON.stringify(vecs[i]),
+            currentModel
+          ).catch(() => {
+          });
         });
-      });
+      }
     }
   }
   const k = Math.max(opts.limit * opts.admitFactor, opts.admitFloor);
   const admittedIds = admitVaultProjections(queryEmbedding, vectored, k);
+  if ((embeddingsDegraded || laneEmbedFailed) && admittedIds.length < k) {
+    const already = new Set(admittedIds);
+    for (const key of [...keys].sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())) {
+      if (admittedIds.length >= k) break;
+      if (!already.has(key.uniqueId)) admittedIds.push(key.uniqueId);
+    }
+  }
   const admissionSet = new Set(admittedIds);
   if (opts.forceIncludeIds) {
     for (const id of opts.forceIncludeIds) {
@@ -21707,11 +21796,18 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     eventTimeKind: normalizeEventTimeKind(m.eventTimeKind),
     factType: m.factType
   }));
-  return { memories, embeddedItems, queryEmbedding, vaultSize };
+  return { memories, embeddedItems, queryEmbedding, vaultSize, laneEmbedFailed };
 }
 async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache, searchOptions) {
   if (!query || typeof query !== "string") {
-    return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: 0 };
+    return {
+      memories: [],
+      embeddedItems: [],
+      queryEmbedding: [],
+      vaultSize: 0,
+      embeddingsUnavailable: false,
+      embeddingFailure: false
+    };
   }
   const limit = searchOptions?.limit ?? 5;
   const scopes = searchOptions?.scopes;
@@ -21728,6 +21824,12 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
   let embeddedItems;
   let queryEmbedding;
   let vaultSize;
+  let embeddingsUnavailable = false;
+  let embeddingFailure = false;
+  const onEmbeddingDegraded = () => {
+    embeddingsUnavailable = true;
+    embeddingFailure = true;
+  };
   if (searchOptions?.decryptLast) {
     const forceIncludeIds = [
       ...searchOptions.entityRanking ?? [],
@@ -21738,14 +21840,30 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       admitFactor: ADMIT_FACTOR,
       admitFloor: ADMIT_FLOOR,
       unembeddedCap: UNEMBEDDED_CAP,
-      ...forceIncludeIds.length > 0 && { forceIncludeIds }
+      ...forceIncludeIds.length > 0 && { forceIncludeIds },
+      onEmbeddingDegraded
     });
     if (corpus.vaultSize === 0) {
-      return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: 0 };
+      return {
+        memories: [],
+        embeddedItems: [],
+        queryEmbedding: [],
+        vaultSize: 0,
+        embeddingsUnavailable: false,
+        embeddingFailure: false
+      };
     }
     ({ memories, embeddedItems, queryEmbedding, vaultSize } = corpus);
+    if (corpus.laneEmbedFailed) embeddingFailure = true;
     if (memories.length === 0) {
-      return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize };
+      return {
+        memories: [],
+        embeddedItems: [],
+        queryEmbedding: [],
+        vaultSize,
+        embeddingsUnavailable,
+        embeddingFailure
+      };
     }
   } else {
     const loaded = await getAllVaultMemoriesOp(
@@ -21760,14 +21878,21 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       );
     }
     if (memories.length === 0) {
-      return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: loaded.length };
+      return {
+        memories: [],
+        embeddedItems: [],
+        queryEmbedding: [],
+        vaultSize: loaded.length,
+        embeddingsUnavailable: false,
+        embeddingFailure: false
+      };
     }
-    queryEmbedding = await generateEmbedding(query, embeddingOptions);
+    queryEmbedding = await embedQueryOrDegrade(query, embeddingOptions, onEmbeddingDegraded);
     const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
     const uncachedTexts = [];
     const uncachedIndices = [];
     let staleReembedCount = 0;
-    for (let i = 0; i < memories.length; i++) {
+    for (let i = 0; queryEmbedding.length > 0 && i < memories.length; i++) {
       const content = memories[i].content;
       const memoryId = memories[i].uniqueId;
       const cached = cache.get(memoryId);
@@ -21795,20 +21920,30 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       );
     }
     if (uncachedTexts.length > 0) {
-      const newEmbeddings = await generateEmbeddings(uncachedTexts, embeddingOptions);
-      for (let j = 0; j < uncachedTexts.length; j++) {
-        cache.set(memories[uncachedIndices[j]].uniqueId, Float32Array.from(newEmbeddings[j]));
-        updateVaultMemoryEmbeddingOp(
-          vaultCtx,
-          memories[uncachedIndices[j]].uniqueId,
-          JSON.stringify(newEmbeddings[j]),
-          currentModel
-        ).catch(
-          // Silently swallow – SDK must not use console.*; embedding will be retried on next search
-          () => {
-          }
+      let newEmbeddings;
+      try {
+        newEmbeddings = await generateEmbeddings(uncachedTexts, embeddingOptions);
+      } catch (err) {
+        embeddingFailure = true;
+        getLogger().warn(
+          `memoryVault: (re)embedding ${uncachedTexts.length} vault rows failed \u2014 they rank on BM25 alone for this search: ` + (err instanceof Error ? err.message : String(err))
         );
       }
+      if (newEmbeddings) {
+        for (let j = 0; j < uncachedTexts.length; j++) {
+          cache.set(memories[uncachedIndices[j]].uniqueId, Float32Array.from(newEmbeddings[j]));
+          updateVaultMemoryEmbeddingOp(
+            vaultCtx,
+            memories[uncachedIndices[j]].uniqueId,
+            JSON.stringify(newEmbeddings[j]),
+            currentModel
+          ).catch(
+            // Silently swallow – SDK must not use console.*; embedding will be retried on next search
+            () => {
+            }
+          );
+        }
+      }
     }
     embeddedItems = memories.map((m) => ({
       id: m.uniqueId,
@@ -21825,12 +21960,22 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       factType: m.factType
     }));
   }
-  return { memories, embeddedItems, queryEmbedding, vaultSize };
+  if (!embeddingsUnavailable && !embeddedItems.some((it) => it.embedding.length > 0)) {
+    embeddingsUnavailable = true;
+  }
+  return {
+    memories,
+    embeddedItems,
+    queryEmbedding,
+    vaultSize,
+    embeddingsUnavailable,
+    embeddingFailure
+  };
 }
 async function rankPreparedVaultCandidates(query, prepared, embeddingOptions, searchOptions) {
   const limit = searchOptions?.limit ?? 5;
   const minSimilarity = searchOptions?.minSimilarity ?? 0.1;
-  const { memories, embeddedItems, queryEmbedding, vaultSize } = prepared;
+  const { memories, embeddedItems, queryEmbedding, vaultSize, embeddingsUnavailable } = prepared;
   if (queryEmbedding.length > 0) {
     const mismatched = embeddedItems.filter(
       (it) => it.embedding.length > 0 && it.embedding.length !== queryEmbedding.length
@@ -21867,7 +22012,8 @@ async function rankPreparedVaultCandidates(query, prepared, embeddingOptions, se
       results: results2,
       vaultSize: out.vaultSize,
       reranked: out.reranked ?? false,
-      hadV2Head: out.hadV2Head ?? false
+      hadV2Head: out.hadV2Head ?? false,
+      embeddingsUnavailable
     };
   };
   const rerankStats = { applied: false };
@@ -21890,36 +22036,46 @@ async function rankPreparedVaultCandidates(query, prepared, embeddingOptions, se
     ...searchOptions?.rrfK !== void 0 && { rrfK: searchOptions.rrfK },
     ...searchOptions?.factTypeWeights && { factTypeWeights: searchOptions.factTypeWeights }
   };
-  if (useFusion && searchOptions?.decompose === "llm" && searchOptions.decomposeOptions) {
+  if (useFusion && !embeddingsUnavailable && searchOptions?.decompose === "llm" && searchOptions.decomposeOptions) {
     const decomp = await decomposeQuery(query, searchOptions.decomposeOptions);
     if (decomp.mode === "composite") {
-      const subEmbeddings = await generateEmbeddings(decomp.subQueries, embeddingOptions);
-      const subQueries = decomp.subQueries.map((sq, i) => ({
-        query: sq,
-        embedding: subEmbeddings[i]
-      }));
-      const v2HeadStats = { hadResults: false };
-      const composite = await rankComposite(query, queryEmbedding, subQueries, embeddedItems, {
-        limit,
-        minSimilarity,
-        rerank: !!searchOptions.rerank,
-        ...searchOptions.rerankTopN !== void 0 && {
-          rerankTopN: searchOptions.rerankTopN
-        },
-        ...searchOptions.ceWeight !== void 0 && { ceWeight: searchOptions.ceWeight },
-        ...searchOptions.mmr !== void 0 && { mmr: searchOptions.mmr },
-        ...tuning,
-        ...searchOptions.entityRanking && { entityRanking: searchOptions.entityRanking },
-        ...searchOptions.temporalRanking && { temporalRanking: searchOptions.temporalRanking },
-        rerankStats,
-        v2HeadStats
-      });
-      return stampTimestamps({
-        results: composite,
-        vaultSize,
-        reranked: rerankStats.applied,
-        hadV2Head: v2HeadStats.hadResults
-      });
+      let subEmbeddings;
+      try {
+        subEmbeddings = await generateEmbeddings(decomp.subQueries, embeddingOptions);
+      } catch (err) {
+        getLogger().warn(
+          "memoryVault: sub-query embedding failed \u2014 falling back to single-query ranking: " + (err instanceof Error ? err.message : String(err))
+        );
+        subEmbeddings = [];
+      }
+      if (subEmbeddings.length > 0) {
+        const subQueries = decomp.subQueries.map((sq, i) => ({
+          query: sq,
+          embedding: subEmbeddings[i]
+        }));
+        const v2HeadStats = { hadResults: false };
+        const composite = await rankComposite(query, queryEmbedding, subQueries, embeddedItems, {
+          limit,
+          minSimilarity,
+          rerank: !!searchOptions.rerank,
+          ...searchOptions.rerankTopN !== void 0 && {
+            rerankTopN: searchOptions.rerankTopN
+          },
+          ...searchOptions.ceWeight !== void 0 && { ceWeight: searchOptions.ceWeight },
+          ...searchOptions.mmr !== void 0 && { mmr: searchOptions.mmr },
+          ...tuning,
+          ...searchOptions.entityRanking && { entityRanking: searchOptions.entityRanking },
+          ...searchOptions.temporalRanking && { temporalRanking: searchOptions.temporalRanking },
+          rerankStats,
+          v2HeadStats
+        });
+        return stampTimestamps({
+          results: composite,
+          vaultSize,
+          reranked: rerankStats.applied,
+          hadV2Head: v2HeadStats.hadResults
+        });
+      }
     }
   }
   if (useFusion && searchOptions?.rerank) {
@@ -21970,7 +22126,14 @@ async function rankPreparedVaultCandidates(query, prepared, embeddingOptions, se
 }
 async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, cache, searchOptions) {
   if (!query || typeof query !== "string") {
-    return { results: [], vaultSize: 0, reranked: false, hadV2Head: false };
+    return {
+      results: [],
+      vaultSize: 0,
+      reranked: false,
+      hadV2Head: false,
+      embeddingsUnavailable: false,
+      rankedOnCosine: false
+    };
   }
   const prepared = await prepareVaultCandidates(
     query,
@@ -21980,12 +22143,32 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
     searchOptions
   );
   if (prepared.vaultSize === 0) {
-    return { results: [], vaultSize: 0, reranked: false, hadV2Head: false };
+    return {
+      results: [],
+      vaultSize: 0,
+      reranked: false,
+      hadV2Head: false,
+      embeddingsUnavailable: prepared.embeddingsUnavailable,
+      rankedOnCosine: false
+    };
   }
   if (prepared.memories.length === 0) {
-    return { results: [], vaultSize: prepared.vaultSize, reranked: false, hadV2Head: false };
+    return {
+      results: [],
+      vaultSize: prepared.vaultSize,
+      reranked: false,
+      hadV2Head: false,
+      embeddingsUnavailable: prepared.embeddingsUnavailable,
+      rankedOnCosine: false
+    };
   }
-  return rankPreparedVaultCandidates(query, prepared, embeddingOptions, searchOptions);
+  const ranked = await rankPreparedVaultCandidates(
+    query,
+    prepared,
+    embeddingOptions,
+    searchOptions
+  );
+  return { ...ranked, rankedOnCosine: !ranked.embeddingsUnavailable };
 }
 async function searchVaultMemories(query, vaultCtx, embeddingOptions, cache, searchOptions) {
   const { results } = await searchVaultMemoriesWithSize(
@@ -22059,26 +22242,36 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
         const budget = searchOptions?.decompose === "llm" && searchOptions.decomposeOptions ? "high" : searchOptions?.rerank ? "mid" : "low";
         const folderId = searchOptions?.folderId ?? argFolderId;
         if (searchOptions?.useFusion === false) {
-          const legacy = await searchVaultMemories(query, vaultCtx, embeddingOptions, cache, {
-            limit: requestLimit,
-            minSimilarity,
-            useFusion: false,
-            ...tuningForward,
-            ...folderId !== void 0 && { folderId },
-            ...searchOptions?.scopes && { scopes: searchOptions.scopes }
-          });
+          const { results: legacy, embeddingsUnavailable } = await searchVaultMemoriesWithSize(
+            query,
+            vaultCtx,
+            embeddingOptions,
+            cache,
+            {
+              limit: requestLimit,
+              minSimilarity,
+              useFusion: false,
+              ...tuningForward,
+              ...folderId !== void 0 && { folderId },
+              ...searchOptions?.scopes && { scopes: searchOptions.scopes }
+            }
+          );
           if (legacy.length === 0) {
-            return "No relevant memories found in the vault.";
+            return embeddingsUnavailable ? EMBEDDINGS_DEGRADED_EMPTY_NO_LEXICAL : "No relevant memories found in the vault.";
           }
           return formatVaultHits(
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
         const { recall: recall2 } = await Promise.resolve().then(() => (init_recall(), recall_exports));
+        let recallDegraded = [];
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },
           {
+            onDiagnostics: (d) => {
+              recallDegraded = d.degraded;
+            },
             types: ["fact"],
             limit: requestLimit,
             minScore: minSimilarity,
@@ -22099,7 +22292,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
           return "The memory vault is empty. No memories have been saved yet.";
         }
         if (result.memories.length === 0) {
-          return "No relevant memories found in the vault.";
+          return recallDegraded.includes("embeddings-unavailable") ? EMBEDDINGS_DEGRADED_EMPTY : "No relevant memories found in the vault.";
         }
         const formatted = formatVaultHits(
           result.memories.map((m) => ({
@@ -22118,7 +22311,7 @@ ${formatted}`;
     }
   };
 }
-var SUPERSESSION_SIMILARITY_THRESHOLD, SUPERSESSION_MIN_AGE_GAP_MS, SUPERSESSION_BOOST_FACTOR, SUPERSESSION_MAX_WINDOW;
+var SUPERSESSION_SIMILARITY_THRESHOLD, SUPERSESSION_MIN_AGE_GAP_MS, SUPERSESSION_BOOST_FACTOR, SUPERSESSION_MAX_WINDOW, EMBEDDINGS_DEGRADED_EMPTY_NO_LEXICAL;
 var init_searchTool = __esm({
   "src/lib/memoryVault/searchTool.ts"() {
     "use strict";
@@ -22126,6 +22319,7 @@ var init_searchTool = __esm({
     init_operations3();
     init_logger();
     init_mmr();
+    init_recallConstants();
     init_recency();
     init_reranker();
     init_rrf();
@@ -22139,6 +22333,7 @@ var init_searchTool = __esm({
     SUPERSESSION_MIN_AGE_GAP_MS = 30 * 24 * 60 * 60 * 1e3;
     SUPERSESSION_BOOST_FACTOR = 0.8;
     SUPERSESSION_MAX_WINDOW = 50;
+    EMBEDDINGS_DEGRADED_EMPTY_NO_LEXICAL = "Memory search is temporarily unavailable \u2014 the semantic lookup failed and this search mode has no keyword fallback, so no memory search ran at all. Do not conclude the user has no such memory; say the memory lookup was unavailable.";
   }
 });
 
@@ -23016,7 +23211,6 @@ __export(index_exports, {
   TextProcessor: () => TextProcessor,
   UserPreference: () => UserPreference,
   VAULT_SIZE_HOP_CAP: () => VAULT_SIZE_HOP_CAP,
-  VaultFolder: () => VaultFolder,
   VaultMemory: () => VaultMemory,
   WalletPoller: () => WalletPoller,
   WordProcessor: () => WordProcessor,
@@ -23072,7 +23266,6 @@ __export(index_exports, {
   createStockPricePreProcessor: () => createStockPricePreProcessor,
   createSummaryContext: () => createSummaryContext,
   createVaultEmbeddingCache: () => createVaultEmbeddingCache,
-  createVaultFolderOp: () => createVaultFolderOp,
   createVaultMemoriesBatchOp: () => createVaultMemoriesBatchOp,
   createVaultMemoryOp: () => createVaultMemoryOp,
   createWeatherPreProcessor: () => createWeatherPreProcessor,
@@ -23093,7 +23286,6 @@ __export(index_exports, {
   deleteModelPreferenceOp: () => deleteModelPreferenceOp,
   deleteProjectOp: () => deleteProjectOp,
   deleteUserPreferenceOp: () => deleteUserPreferenceOp,
-  deleteVaultFolderOp: () => deleteVaultFolderOp,
   deleteVaultMemoryOp: () => deleteVaultMemoryOp,
   eagerEmbedContent: () => eagerEmbedContent,
   embedAllMessages: () => embedAllMessages,
@@ -23102,7 +23294,6 @@ __export(index_exports, {
   encryptDataBatch: () => encryptDataBatch,
   encryptDataBytes: () => encryptDataBytes,
   encryptDataWithKey: () => encryptDataWithKey,
-  ensureDefaultFoldersOp: () => ensureDefaultFoldersOp,
   estimateMessagesTokens: () => estimateMessagesTokens,
   estimateTokens: () => estimateTokens,
   exportPublicKey: () => exportPublicKey,
@@ -23118,7 +23309,6 @@ __export(index_exports, {
   generateProjectId: () => generateProjectId,
   getAIGeneratedMediaOp: () => getAIGeneratedMediaOp,
   getAllFilesOp: () => getAllFilesOp,
-  getAllVaultFoldersOp: () => getAllVaultFoldersOp,
   getAllVaultMemoriesOp: () => getAllVaultMemoriesOp,
   getAllVaultMemoryContentsOp: () => getAllVaultMemoryContentsOp,
   getAudioOp: () => getAudioOp,
@@ -23161,7 +23351,6 @@ __export(index_exports, {
   getUnfiledVaultMemoriesOp: () => getUnfiledVaultMemoriesOp,
   getUserPreferenceOp: () => getUserPreferenceOp,
   getUserUploadedMediaOp: () => getUserUploadedMediaOp,
-  getVaultFolderMemoryCountOp: () => getVaultFolderMemoryCountOp,
   getVaultMemoryOp: () => getVaultMemoryOp,
   getVideosOp: () => getVideosOp,
   hardDeleteDecayedOp: () => hardDeleteDecayedOp,
@@ -23177,7 +23366,6 @@ __export(index_exports, {
   maybeSummarizeHistory: () => maybeSummarizeHistory,
   mediaToStored: () => mediaToStored,
   migrateFromModelPreferencesOp: () => migrateFromModelPreferencesOp,
-  moveMemoriesToFolderOp: () => moveMemoriesToFolderOp,
   onKeyAvailable: () => onKeyAvailable,
   preEmbedVaultMemories: () => preEmbedVaultMemories,
   preprocessFiles: () => preprocessFiles,
@@ -23238,8 +23426,6 @@ __export(index_exports, {
   updateProfileOp: () => updateProfileOp,
   updateProjectNameOp: () => updateProjectNameOp,
   updateProjectOp: () => updateProjectOp,
-  updateVaultFolderContextOp: () => updateVaultFolderContextOp,
-  updateVaultFolderOp: () => updateVaultFolderOp,
   updateVaultMemoryEmbeddingOp: () => updateVaultMemoryEmbeddingOp,
   updateVaultMemoryOp: () => updateVaultMemoryOp,
   upsertConversationSummaryOp: () => upsertConversationSummaryOp,
@@ -25920,182 +26106,8 @@ async function cleanupConversationSummary(database, conversationId) {
 // src/lib/db/memoryVault/index.ts
 init_operations3();
 
-// src/lib/db/vaultFolders/operations.ts
-var import_watermelondb18 = __toESM(require_watermelondb());
-function folderToStored(folder) {
-  return {
-    uniqueId: folder.id,
-    name: folder.name,
-    scope: folder.scope,
-    createdAt: folder.createdAt,
-    updatedAt: folder.updatedAt,
-    isDeleted: folder.isDeleted,
-    isSystem: folder.isSystem ?? false,
-    context: folder.context ?? null
-  };
-}
-async function createVaultFolderOp(ctx, opts) {
-  const created = await ctx.database.write(async () => {
-    return ctx.vaultFolderCollection.create((record) => {
-      record._setRaw("name", opts.name);
-      record._setRaw("scope", opts.scope ?? "private");
-      record._setRaw("is_system", opts.isSystem ?? false);
-      record._setRaw("is_deleted", false);
-    });
-  });
-  return folderToStored(created);
-}
-async function getAllVaultFoldersOp(ctx) {
-  const results = await ctx.vaultFolderCollection.query(import_watermelondb18.Q.where("is_deleted", false), import_watermelondb18.Q.sortBy("created_at", import_watermelondb18.Q.desc)).fetch();
-  return results.map(folderToStored);
-}
-async function updateVaultFolderOp(ctx, id, opts) {
-  try {
-    const record = await ctx.vaultFolderCollection.find(id);
-    if (record.isDeleted) return null;
-    const scopeChanged = opts.scope !== void 0 && opts.scope !== record.scope;
-    const updated = await ctx.database.write(async () => {
-      const memories = scopeChanged ? await ctx.vaultMemoryCollection.query(import_watermelondb18.Q.where("folder_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch() : [];
-      const updates = [];
-      updates.push(
-        record.prepareUpdate((r) => {
-          if (opts.name !== void 0) r._setRaw("name", opts.name);
-          if (opts.scope !== void 0) r._setRaw("scope", opts.scope);
-        })
-      );
-      for (const memory of memories) {
-        updates.push(
-          memory.prepareUpdate((r) => {
-            r._setRaw("scope", opts.scope);
-          })
-        );
-      }
-      await ctx.database.batch(...updates);
-      return ctx.vaultFolderCollection.find(id);
-    });
-    return folderToStored(updated);
-  } catch {
-    return null;
-  }
-}
-async function deleteVaultFolderOp(ctx, id) {
-  try {
-    const record = await ctx.vaultFolderCollection.find(id);
-    if (record.isDeleted) return false;
-    await ctx.database.write(async () => {
-      const memories = await ctx.vaultMemoryCollection.query(import_watermelondb18.Q.where("folder_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch();
-      const preparedMemories = memories.map(
-        (memory) => memory.prepareUpdate((r) => {
-          r._setRaw("folder_id", null);
-          r._setRaw("scope", "private");
-        })
-      );
-      const preparedFolder = record.prepareUpdate((r) => {
-        r._setRaw("is_deleted", true);
-      });
-      await ctx.database.batch(...preparedMemories, preparedFolder);
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function moveMemoriesToFolderOp(ctx, memoryIds, folderId) {
-  if (memoryIds.length === 0) return true;
-  try {
-    let targetScope = "private";
-    if (folderId) {
-      const folder = await ctx.vaultFolderCollection.find(folderId);
-      if (folder.isDeleted) return false;
-      targetScope = folder.scope;
-    }
-    let movedCount = 0;
-    await ctx.database.write(async () => {
-      const memories = [];
-      for (const id of memoryIds) {
-        try {
-          const m = await ctx.vaultMemoryCollection.find(id);
-          if (!m.isDeleted) memories.push(m);
-        } catch {
-        }
-      }
-      if (memories.length === 0) return;
-      const prepared = memories.map(
-        (memory) => memory.prepareUpdate((r) => {
-          r._setRaw("folder_id", folderId);
-          r._setRaw("scope", targetScope);
-        })
-      );
-      await ctx.database.batch(...prepared);
-      movedCount = memories.length;
-    });
-    return movedCount > 0;
-  } catch {
-    return false;
-  }
-}
-async function updateVaultFolderContextOp(ctx, id, context) {
-  try {
-    const record = await ctx.vaultFolderCollection.find(id);
-    if (record.isDeleted) return null;
-    const updated = await ctx.database.write(async () => {
-      await ctx.database.batch(
-        record.prepareUpdate((r) => {
-          r._setRaw("context", context);
-        })
-      );
-      return ctx.vaultFolderCollection.find(id);
-    });
-    return folderToStored(updated);
-  } catch {
-    return null;
-  }
-}
-async function getVaultFolderMemoryCountOp(ctx, folderId) {
-  return await ctx.vaultMemoryCollection.query(import_watermelondb18.Q.where("folder_id", folderId), import_watermelondb18.Q.where("is_deleted", false)).fetchCount();
-}
-
-// src/lib/db/vaultFolders/defaults.ts
-var DEFAULT_FOLDER_NAMES = ["Personal", "Work", "Interests"];
-var ensureDefaultFoldersLocks = /* @__PURE__ */ new WeakMap();
-async function ensureDefaultFoldersOp(ctx) {
-  const existing = ensureDefaultFoldersLocks.get(ctx.database);
-  if (existing) return existing;
-  const promise = _ensureDefaultFoldersImpl(ctx);
-  ensureDefaultFoldersLocks.set(ctx.database, promise);
-  try {
-    return await promise;
-  } finally {
-    ensureDefaultFoldersLocks.delete(ctx.database);
-  }
-}
-async function _ensureDefaultFoldersImpl(ctx) {
-  const existing = await getAllVaultFoldersOp(ctx);
-  const folderMap = /* @__PURE__ */ new Map();
-  const existingByName = new Map(existing.map((f) => [f.name, f]));
-  for (const name of DEFAULT_FOLDER_NAMES) {
-    const found = existingByName.get(name);
-    if (found) {
-      folderMap.set(found.name, found.uniqueId);
-    } else {
-      const created = await createVaultFolderOp(ctx, {
-        name,
-        scope: "private",
-        isSystem: true
-      });
-      folderMap.set(created.name, created.uniqueId);
-    }
-  }
-  for (const folder of existing) {
-    if (!folderMap.has(folder.name)) {
-      folderMap.set(folder.name, folder.uniqueId);
-    }
-  }
-  return folderMap;
-}
-
 // src/lib/db/project/operations.ts
-var import_watermelondb19 = __toESM(require_watermelondb());
+var import_watermelondb18 = __toESM(require_watermelondb());
 init_operations();
 
 // src/lib/db/project/types.ts
@@ -26127,15 +26139,15 @@ async function createProjectOp(ctx, opts, defaultName = "New Project") {
   return projectToStored(created);
 }
 async function getProjectOp(ctx, id) {
-  const results = await ctx.projectsCollection.query(import_watermelondb19.Q.where("project_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.projectsCollection.query(import_watermelondb18.Q.where("project_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch();
   return results.length > 0 ? projectToStored(results[0]) : null;
 }
 async function getProjectsOp(ctx) {
-  const results = await ctx.projectsCollection.query(import_watermelondb19.Q.where("is_deleted", false), import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.desc)).fetch();
+  const results = await ctx.projectsCollection.query(import_watermelondb18.Q.where("is_deleted", false), import_watermelondb18.Q.sortBy("created_at", import_watermelondb18.Q.desc)).fetch();
   return results.map(projectToStored);
 }
 async function updateProjectNameOp(ctx, id, name) {
-  const results = await ctx.projectsCollection.query(import_watermelondb19.Q.where("project_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.projectsCollection.query(import_watermelondb18.Q.where("project_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch();
   if (results.length > 0) {
     await ctx.database.write(async () => {
       await results[0].update((proj) => {
@@ -26147,7 +26159,7 @@ async function updateProjectNameOp(ctx, id, name) {
   return false;
 }
 async function updateProjectOp(ctx, id, opts) {
-  const results = await ctx.projectsCollection.query(import_watermelondb19.Q.where("project_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.projectsCollection.query(import_watermelondb18.Q.where("project_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch();
   if (results.length > 0) {
     await ctx.database.write(async () => {
       await results[0].update((proj) => {
@@ -26159,7 +26171,7 @@ async function updateProjectOp(ctx, id, opts) {
   return false;
 }
 async function deleteProjectOp(ctx, id) {
-  const results = await ctx.projectsCollection.query(import_watermelondb19.Q.where("project_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+  const results = await ctx.projectsCollection.query(import_watermelondb18.Q.where("project_id", id), import_watermelondb18.Q.where("is_deleted", false)).fetch();
   if (results.length > 0) {
     await ctx.database.write(async () => {
       await results[0].update((proj) => {
@@ -26172,14 +26184,14 @@ async function deleteProjectOp(ctx, id) {
 }
 async function getProjectConversationsOp(ctx, projectId) {
   const results = await ctx.conversationsCollection.query(
-    import_watermelondb19.Q.where("project_id", projectId),
-    import_watermelondb19.Q.where("is_deleted", false),
-    import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.desc)
+    import_watermelondb18.Q.where("project_id", projectId),
+    import_watermelondb18.Q.where("is_deleted", false),
+    import_watermelondb18.Q.sortBy("created_at", import_watermelondb18.Q.desc)
   ).fetch();
   return results.map(conversationToStoredRaw);
 }
 async function getProjectConversationCountOp(ctx, projectId) {
-  return await ctx.conversationsCollection.query(import_watermelondb19.Q.where("project_id", projectId), import_watermelondb19.Q.where("is_deleted", false)).fetchCount();
+  return await ctx.conversationsCollection.query(import_watermelondb18.Q.where("project_id", projectId), import_watermelondb18.Q.where("is_deleted", false)).fetchCount();
 }
 
 // src/lib/db/media/types.ts
@@ -26206,7 +26218,7 @@ function isSupportedMediaType(mimeType) {
 }
 
 // src/lib/db/media/operations.ts
-var import_watermelondb20 = __toESM(require_watermelondb());
+var import_watermelondb19 = __toESM(require_watermelondb());
 init_logger();
 
 // src/lib/storage/mcpImages.ts
@@ -26440,7 +26452,7 @@ async function createMediaBatchOp(ctx, optionsArray) {
       })
     );
   });
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", import_watermelondb20.Q.oneOf(mediaIds))).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", import_watermelondb19.Q.oneOf(mediaIds))).fetch();
   return Promise.all(
     results.map(
       (m) => mediaToStored(m, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
@@ -26449,21 +26461,21 @@ async function createMediaBatchOp(ctx, optionsArray) {
 }
 async function getMediaByIdOp(ctx, mediaId) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", mediaId), import_watermelondb20.Q.where("is_deleted", false)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", mediaId), import_watermelondb19.Q.where("is_deleted", false)).fetch();
   return results.length > 0 ? await mediaToStored(results[0], ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner) : null;
 }
 async function getMediaBySourceUrlOp(ctx, sourceUrl, walletAddress) {
   const mediaCollection = ctx.database.get("media");
   const results = await mediaCollection.query(
-    import_watermelondb20.Q.where("source_url", sourceUrl),
-    import_watermelondb20.Q.where("wallet_address", walletAddress),
-    import_watermelondb20.Q.where("is_deleted", false)
+    import_watermelondb19.Q.where("source_url", sourceUrl),
+    import_watermelondb19.Q.where("wallet_address", walletAddress),
+    import_watermelondb19.Q.where("is_deleted", false)
   ).fetch();
   return results.length > 0 ? await mediaToStored(results[0], ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner) : null;
 }
 async function updateMediaOp(ctx, mediaId, options) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", mediaId)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", mediaId)).fetch();
   if (results.length === 0) {
     return null;
   }
@@ -26483,7 +26495,7 @@ async function updateMediaOp(ctx, mediaId, options) {
       m._setRaw("updated_at", now);
     });
   });
-  const updated = await mediaCollection.query(import_watermelondb20.Q.where("media_id", mediaId)).fetch();
+  const updated = await mediaCollection.query(import_watermelondb19.Q.where("media_id", mediaId)).fetch();
   return updated.length > 0 ? await mediaToStored(updated[0], ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner) : null;
 }
 async function updateMediaMessageIdBatchOp(ctx, mediaIds, messageId) {
@@ -26491,7 +26503,7 @@ async function updateMediaMessageIdBatchOp(ctx, mediaIds, messageId) {
     return 0;
   }
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", import_watermelondb20.Q.oneOf(mediaIds))).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", import_watermelondb19.Q.oneOf(mediaIds))).fetch();
   if (results.length === 0) {
     return 0;
   }
@@ -26513,13 +26525,13 @@ var IMAGE_VIDEO_MIMES = VIDEO_EXTENSIONS.map((ext) => `image/${ext}`);
 async function relinkMisclassifiedVideosOp(ctx, walletAddress) {
   const mediaCollection = ctx.database.get("media");
   const candidates = await mediaCollection.query(
-    import_watermelondb20.Q.where("wallet_address", walletAddress),
-    import_watermelondb20.Q.where("is_deleted", false),
-    import_watermelondb20.Q.where("media_type", "image"),
-    import_watermelondb20.Q.or(
-      import_watermelondb20.Q.where("mime_type", import_watermelondb20.Q.like("video/%")),
-      ...IMAGE_VIDEO_MIMES.map((m) => import_watermelondb20.Q.where("mime_type", m)),
-      import_watermelondb20.Q.where("mime_type", "application/octet-stream")
+    import_watermelondb19.Q.where("wallet_address", walletAddress),
+    import_watermelondb19.Q.where("is_deleted", false),
+    import_watermelondb19.Q.where("media_type", "image"),
+    import_watermelondb19.Q.or(
+      import_watermelondb19.Q.where("mime_type", import_watermelondb19.Q.like("video/%")),
+      ...IMAGE_VIDEO_MIMES.map((m) => import_watermelondb19.Q.where("mime_type", m)),
+      import_watermelondb19.Q.where("mime_type", "application/octet-stream")
     )
   ).fetch();
   if (candidates.length === 0) {
@@ -26568,7 +26580,7 @@ async function relinkMisclassifiedVideosOp(ctx, walletAddress) {
 }
 async function deleteMediaOp(ctx, mediaId) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", mediaId)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", mediaId)).fetch();
   if (results.length === 0) {
     return false;
   }
@@ -26586,7 +26598,7 @@ async function deleteMediaOp(ctx, mediaId) {
 }
 async function hardDeleteMediaOp(ctx, mediaId) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("media_id", mediaId)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("media_id", mediaId)).fetch();
   if (results.length === 0) {
     return false;
   }
@@ -26598,28 +26610,28 @@ async function hardDeleteMediaOp(ctx, mediaId) {
 }
 async function getMediaOp(ctx, filters) {
   const mediaCollection = ctx.database.get("media");
-  const conditions = [import_watermelondb20.Q.where("wallet_address", filters.walletAddress)];
+  const conditions = [import_watermelondb19.Q.where("wallet_address", filters.walletAddress)];
   if (!filters.includeDeleted) {
-    conditions.push(import_watermelondb20.Q.where("is_deleted", false));
+    conditions.push(import_watermelondb19.Q.where("is_deleted", false));
   }
   if (filters.mediaType) {
-    conditions.push(import_watermelondb20.Q.where("media_type", filters.mediaType));
+    conditions.push(import_watermelondb19.Q.where("media_type", filters.mediaType));
   }
   if (filters.role) {
-    conditions.push(import_watermelondb20.Q.where("role", filters.role));
+    conditions.push(import_watermelondb19.Q.where("role", filters.role));
   }
   if (filters.conversationId) {
-    conditions.push(import_watermelondb20.Q.where("conversation_id", filters.conversationId));
+    conditions.push(import_watermelondb19.Q.where("conversation_id", filters.conversationId));
   }
   if (filters.model) {
-    conditions.push(import_watermelondb20.Q.where("model", filters.model));
+    conditions.push(import_watermelondb19.Q.where("model", filters.model));
   }
-  conditions.push(import_watermelondb20.Q.sortBy("created_at", import_watermelondb20.Q.desc));
+  conditions.push(import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.desc));
   if (filters.limit) {
-    conditions.push(import_watermelondb20.Q.take(filters.limit));
+    conditions.push(import_watermelondb19.Q.take(filters.limit));
   }
   if (filters.offset) {
-    conditions.push(import_watermelondb20.Q.skip(filters.offset));
+    conditions.push(import_watermelondb19.Q.skip(filters.offset));
   }
   const results = await mediaCollection.query(...conditions).fetch();
   return Promise.all(
@@ -26649,9 +26661,9 @@ async function getMediaByConversationOp(ctx, walletAddress, conversationId, limi
 async function getMediaByMessageOp(ctx, messageId) {
   const mediaCollection = ctx.database.get("media");
   const results = await mediaCollection.query(
-    import_watermelondb20.Q.where("message_id", messageId),
-    import_watermelondb20.Q.where("is_deleted", false),
-    import_watermelondb20.Q.sortBy("created_at", import_watermelondb20.Q.asc)
+    import_watermelondb19.Q.where("message_id", messageId),
+    import_watermelondb19.Q.where("is_deleted", false),
+    import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.asc)
   ).fetch();
   return Promise.all(
     results.map(
@@ -26664,9 +26676,9 @@ async function getMediaByIdsOp(ctx, mediaIds, includeDeleted = false) {
     return [];
   }
   const mediaCollection = ctx.database.get("media");
-  const conditions = [import_watermelondb20.Q.where("media_id", import_watermelondb20.Q.oneOf(mediaIds))];
+  const conditions = [import_watermelondb19.Q.where("media_id", import_watermelondb19.Q.oneOf(mediaIds))];
   if (!includeDeleted) {
-    conditions.push(import_watermelondb20.Q.where("is_deleted", false));
+    conditions.push(import_watermelondb19.Q.where("is_deleted", false));
   }
   const results = await mediaCollection.query(...conditions).fetch();
   const mediaMap = new Map(results.map((m) => [m.mediaId, m]));
@@ -26703,10 +26715,10 @@ async function searchMediaOp(ctx, walletAddress, query, limit) {
   const queryLower = query.toLowerCase();
   const MAX_SEARCH_RECORDS = 500;
   const allResults = await mediaCollection.query(
-    import_watermelondb20.Q.where("wallet_address", walletAddress),
-    import_watermelondb20.Q.where("is_deleted", false),
-    import_watermelondb20.Q.sortBy("created_at", import_watermelondb20.Q.desc),
-    import_watermelondb20.Q.take(MAX_SEARCH_RECORDS)
+    import_watermelondb19.Q.where("wallet_address", walletAddress),
+    import_watermelondb19.Q.where("is_deleted", false),
+    import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.desc),
+    import_watermelondb19.Q.take(MAX_SEARCH_RECORDS)
   ).fetch();
   const decrypted = await Promise.all(
     allResults.map(
@@ -26719,11 +26731,11 @@ async function searchMediaOp(ctx, walletAddress, query, limit) {
 async function getMediaCountOp(ctx, walletAddress, mediaType) {
   const mediaCollection = ctx.database.get("media");
   const conditions = [
-    import_watermelondb20.Q.where("wallet_address", walletAddress),
-    import_watermelondb20.Q.where("is_deleted", false)
+    import_watermelondb19.Q.where("wallet_address", walletAddress),
+    import_watermelondb19.Q.where("is_deleted", false)
   ];
   if (mediaType) {
-    conditions.push(import_watermelondb20.Q.where("media_type", mediaType));
+    conditions.push(import_watermelondb19.Q.where("media_type", mediaType));
   }
   return await mediaCollection.query(...conditions).fetchCount();
 }
@@ -26738,7 +26750,7 @@ async function getMediaCountsByTypeOp(ctx, walletAddress) {
 }
 async function deleteMediaByConversationOp(ctx, conversationId) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("conversation_id", conversationId), import_watermelondb20.Q.where("is_deleted", false)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("conversation_id", conversationId), import_watermelondb19.Q.where("is_deleted", false)).fetch();
   if (results.length === 0) {
     return 0;
   }
@@ -26759,7 +26771,7 @@ async function deleteMediaByConversationOp(ctx, conversationId) {
 }
 async function deleteMediaByMessageOp(ctx, messageId) {
   const mediaCollection = ctx.database.get("media");
-  const results = await mediaCollection.query(import_watermelondb20.Q.where("message_id", messageId), import_watermelondb20.Q.where("is_deleted", false)).fetch();
+  const results = await mediaCollection.query(import_watermelondb19.Q.where("message_id", messageId), import_watermelondb19.Q.where("is_deleted", false)).fetch();
   if (results.length === 0) {
     return 0;
   }
@@ -26780,7 +26792,7 @@ async function deleteMediaByMessageOp(ctx, messageId) {
 }
 
 // src/lib/db/userPreferences/operations.ts
-var import_watermelondb21 = __toESM(require_watermelondb());
+var import_watermelondb20 = __toESM(require_watermelondb());
 function userPreferenceToStored(preference) {
   return {
     uniqueId: preference.id,
@@ -26795,7 +26807,7 @@ function userPreferenceToStored(preference) {
   };
 }
 async function getUserPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.userPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.userPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", walletAddress)).fetch();
   return results.length > 0 ? userPreferenceToStored(results[0]) : null;
 }
 async function createUserPreferenceOp(ctx, opts) {
@@ -26815,7 +26827,7 @@ async function createUserPreferenceOp(ctx, opts) {
   return userPreferenceToStored(created);
 }
 async function updateUserPreferenceOp(ctx, walletAddress, opts) {
-  const results = await ctx.userPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.userPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", walletAddress)).fetch();
   if (results.length === 0) return null;
   const preference = results[0];
   await ctx.database.write(async () => {
@@ -26843,7 +26855,7 @@ async function updateUserPreferenceOp(ctx, walletAddress, opts) {
 async function setUserPreferenceOp(ctx, walletAddress, opts) {
   const now = Date.now();
   const result = await ctx.database.write(async () => {
-    const results = await ctx.userPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
+    const results = await ctx.userPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", walletAddress)).fetch();
     if (results.length > 0) {
       const preference = results[0];
       await preference.update((pref) => {
@@ -26891,7 +26903,7 @@ async function updateModelsOp(ctx, walletAddress, models) {
   return updateUserPreferenceOp(ctx, walletAddress, { models });
 }
 async function deleteUserPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.userPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.userPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", walletAddress)).fetch();
   if (results.length === 0) return false;
   await ctx.database.write(async () => {
     await results[0].destroyPermanently();
@@ -26906,9 +26918,9 @@ async function migrateFromModelPreferencesOp(ctx, walletAddress) {
   if (existing) {
     return existing;
   }
-  const modelResults = await ctx.modelPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
+  const modelResults = await ctx.modelPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", walletAddress)).fetch();
   const personalityKey = `${walletAddress}_personality_settings`;
-  const personalityResults = await ctx.modelPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", personalityKey)).fetch();
+  const personalityResults = await ctx.modelPreferencesCollection.query(import_watermelondb20.Q.where("wallet_address", personalityKey)).fetch();
   if (modelResults.length === 0 && personalityResults.length === 0) {
     return null;
   }
@@ -26988,7 +27000,7 @@ var SLIDER_CONFIG = [
 ];
 
 // src/lib/db/settings/operations.ts
-var import_watermelondb22 = __toESM(require_watermelondb());
+var import_watermelondb21 = __toESM(require_watermelondb());
 function modelPreferenceToStored(preference) {
   return {
     uniqueId: preference.id,
@@ -26997,12 +27009,12 @@ function modelPreferenceToStored(preference) {
   };
 }
 async function getModelPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.modelPreferencesCollection.query(import_watermelondb22.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.modelPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
   return results.length > 0 ? modelPreferenceToStored(results[0]) : null;
 }
 async function setModelPreferenceOp(ctx, walletAddress, models) {
   const result = await ctx.database.write(async () => {
-    const results = await ctx.modelPreferencesCollection.query(import_watermelondb22.Q.where("wallet_address", walletAddress)).fetch();
+    const results = await ctx.modelPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
     if (results.length > 0) {
       const preference = results[0];
       await preference.update((pref) => {
@@ -27020,7 +27032,7 @@ async function setModelPreferenceOp(ctx, walletAddress, models) {
   return modelPreferenceToStored(result);
 }
 async function deleteModelPreferenceOp(ctx, walletAddress) {
-  const results = await ctx.modelPreferencesCollection.query(import_watermelondb22.Q.where("wallet_address", walletAddress)).fetch();
+  const results = await ctx.modelPreferencesCollection.query(import_watermelondb21.Q.where("wallet_address", walletAddress)).fetch();
   if (results.length === 0) return false;
   await ctx.database.write(async () => {
     await results[0].destroyPermanently();
@@ -27366,7 +27378,7 @@ function createMemoryVaultTool(vaultCtx, options, embeddingOptions, cache) {
 }
 
 // src/lib/memory/autoExtract.ts
-var import_watermelondb23 = __toESM(require_watermelondb());
+var import_watermelondb22 = __toESM(require_watermelondb());
 init_operations2();
 init_types3();
 init_logger();
@@ -27835,6 +27847,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) {
@@ -28159,7 +28176,7 @@ async function assertMergeTargetGoneOrThrow(ctx, targetId) {
 // src/lib/memory/autoExtract.ts
 async function isMemoryTopicsUserManaged(ctx, memoryId) {
   try {
-    const rows = await ctx.database.get(VaultMemory.table).query(import_watermelondb23.Q.where("id", memoryId)).fetch();
+    const rows = await ctx.database.get(VaultMemory.table).query(import_watermelondb22.Q.where("id", memoryId)).fetch();
     return rows[0]?.topicsUserManaged === true;
   } catch {
     return true;
@@ -29086,12 +29103,7 @@ init_recall();
 
 // src/lib/memory/recallTool.ts
 init_recall();
-
-// src/lib/memory/recallConstants.ts
-var RECALL_TOOL_NAME = "recall_memory";
-var RECALL_MAX_LIMIT = 50;
-
-// src/lib/memory/recallTool.ts
+init_recallConstants();
 var DEFAULT_LIMIT2 = 8;
 var DEFAULT_BUDGET2 = "low";
 function formatEventTime(start, end, kind) {
@@ -29241,7 +29253,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,
@@ -29273,6 +29289,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}
 
@@ -29453,6 +29472,7 @@ init_embeddings();
 init_vector();
 init_observationTrend();
 init_recall();
+init_recallConstants();
 var DEFAULT_SYNTHESIS_MODEL = "inclusionai/ling-2.6-flash";
 var DEFAULT_FACET_RECALL_LIMIT = 20;
 var DEFAULT_FACET_MAX_TOKENS = 512;
@@ -35661,7 +35681,6 @@ function buildSystemPrompt(ctx, options) {
   TextProcessor,
   UserPreference,
   VAULT_SIZE_HOP_CAP,
-  VaultFolder,
   VaultMemory,
   WalletPoller,
   WordProcessor,
@@ -35717,7 +35736,6 @@ function buildSystemPrompt(ctx, options) {
   createStockPricePreProcessor,
   createSummaryContext,
   createVaultEmbeddingCache,
-  createVaultFolderOp,
   createVaultMemoriesBatchOp,
   createVaultMemoryOp,
   createWeatherPreProcessor,
@@ -35738,7 +35756,6 @@ function buildSystemPrompt(ctx, options) {
   deleteModelPreferenceOp,
   deleteProjectOp,
   deleteUserPreferenceOp,
-  deleteVaultFolderOp,
   deleteVaultMemoryOp,
   eagerEmbedContent,
   embedAllMessages,
@@ -35747,7 +35764,6 @@ function buildSystemPrompt(ctx, options) {
   encryptDataBatch,
   encryptDataBytes,
   encryptDataWithKey,
-  ensureDefaultFoldersOp,
   estimateMessagesTokens,
   estimateTokens,
   exportPublicKey,
@@ -35763,7 +35779,6 @@ function buildSystemPrompt(ctx, options) {
   generateProjectId,
   getAIGeneratedMediaOp,
   getAllFilesOp,
-  getAllVaultFoldersOp,
   getAllVaultMemoriesOp,
   getAllVaultMemoryContentsOp,
   getAudioOp,
@@ -35806,7 +35821,6 @@ function buildSystemPrompt(ctx, options) {
   getUnfiledVaultMemoriesOp,
   getUserPreferenceOp,
   getUserUploadedMediaOp,
-  getVaultFolderMemoryCountOp,
   getVaultMemoryOp,
   getVideosOp,
   hardDeleteDecayedOp,
@@ -35822,7 +35836,6 @@ function buildSystemPrompt(ctx, options) {
   maybeSummarizeHistory,
   mediaToStored,
   migrateFromModelPreferencesOp,
-  moveMemoriesToFolderOp,
   onKeyAvailable,
   preEmbedVaultMemories,
   preprocessFiles,
@@ -35883,8 +35896,6 @@ function buildSystemPrompt(ctx, options) {
   updateProfileOp,
   updateProjectNameOp,
   updateProjectOp,
-  updateVaultFolderContextOp,
-  updateVaultFolderOp,
   updateVaultMemoryEmbeddingOp,
   updateVaultMemoryOp,
   upsertConversationSummaryOp,