@anuma/sdk 4.0.1 → 4.1.0

package/dist/expo/{chunk-BOAKGY4R.mjs → chunk-VBO6KSNQ.mjs}

@@ -2740,6 +2740,30 @@ async function updateVaultMemoryOp(ctx, id, opts) {
     return null;
   }
 }
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
+  let record;
+  try {
+    record = await ctx.vaultMemoryCollection.find(memoryId);
+  } catch {
+    return false;
+  }
+  if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
+  const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
+  await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
+    await record.update((r) => {
+      r._setRaw("topics_user_managed", false);
+      r._setRaw("topics_extracted_version", null);
+      if (record.topicsExtractedAt === null) {
+        r._setRaw("topics_extracted_at", originalUpdatedAt);
+      }
+      r._setRaw("updated_at", originalUpdatedAt);
+    });
+  });
+  return cleared;
+}
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
   try {
@@ -2901,11 +2925,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -2915,8 +2941,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -2932,11 +2962,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(
@@ -6119,7 +6159,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-O65PGPIQ.mjs");
+        const { recall: recall2 } = await import("./recall-OCQOA7M3.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,

package/dist/expo/index.cjs

@@ -4980,6 +4980,30 @@ async function updateVaultMemoryOp(ctx, id, opts) {
     return null;
   }
 }
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
+  let record;
+  try {
+    record = await ctx.vaultMemoryCollection.find(memoryId);
+  } catch {
+    return false;
+  }
+  if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
+  const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
+  await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
+    await record.update((r) => {
+      r._setRaw("topics_user_managed", false);
+      r._setRaw("topics_extracted_version", null);
+      if (record.topicsExtractedAt === null) {
+        r._setRaw("topics_extracted_at", originalUpdatedAt);
+      }
+      r._setRaw("updated_at", originalUpdatedAt);
+    });
+  });
+  return cleared;
+}
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
   try {
@@ -5140,11 +5164,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -5154,8 +5180,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -5171,11 +5201,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(

package/dist/expo/index.d.mts

@@ -6083,6 +6083,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -6095,9 +6101,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -6149,6 +6156,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/expo/index.d.ts

@@ -6083,6 +6083,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -6095,9 +6101,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -6149,6 +6156,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/expo/index.mjs

@@ -116,7 +116,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-BOAKGY4R.mjs";
+} from "./chunk-VBO6KSNQ.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,

package/dist/expo/{recall-O65PGPIQ.mjs → recall-OCQOA7M3.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-BOAKGY4R.mjs";
+} from "./chunk-VBO6KSNQ.mjs";
 import "./chunk-ILAWDQDE.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {

package/dist/react/{chunk-BAJL46NX.mjs → chunk-BS7C4CUW.mjs}

@@ -2927,7 +2927,7 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
   if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return null;
   let stale = false;
   const originalUpdatedAt = record.updatedAt.getTime();
-  await ctx.database.write(async () => {
+  await ctx.database.write(async (writer) => {
     if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) {
       stale = true;
       return;
@@ -2936,30 +2936,23 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
       r._setRaw("topics_user_managed", true);
       r._setRaw("updated_at", originalUpdatedAt);
     });
+    const linked = entities.length > 0 ? await writer.callWriter(
+      () => linkMemoryEntitiesOp(entityCtx, memoryId, entities, { topicsSource: "user" })
+    ) : [];
+    const keep = new Set(linked.map((e) => e.uniqueId));
+    const existing = await entityCtx.memoryEntityCollection.query(Q3.where("memory_id", memoryId)).fetch();
+    const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
+    if (staleLinks.length === 0 && entities.length > 0) return;
+    const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, memoryId, linked, entities, "user");
+    await ctx.database.batch(
+      ...staleLinks.map((l) => l.prepareDestroyPermanently()),
+      ...topicsOp ? [topicsOp] : []
+    );
   });
   if (stale) return null;
-  const linked = entities.length > 0 ? await linkMemoryEntitiesOp(entityCtx, memoryId, entities, { topicsSource: "user" }) : [];
-  const keep = new Set(linked.map((e) => e.uniqueId));
-  const existing = await entityCtx.memoryEntityCollection.query(Q3.where("memory_id", memoryId)).fetch();
-  const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
-  if (staleLinks.length > 0 || entities.length === 0) {
-    await ctx.database.write(async () => {
-      const topicsOp = await prepareMemoryTopicsUpdate(
-        entityCtx,
-        memoryId,
-        linked,
-        entities,
-        "user"
-      );
-      await ctx.database.batch(
-        ...staleLinks.map((l) => l.prepareDestroyPermanently()),
-        ...topicsOp ? [topicsOp] : []
-      );
-    });
-  }
   return vaultMemoryToStored(record, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner);
 }
-async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
   let record;
   try {
     record = await ctx.vaultMemoryCollection.find(memoryId);
@@ -2968,7 +2961,10 @@ async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
   }
   if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
   const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
   await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
     await record.update((r) => {
       r._setRaw("topics_user_managed", false);
       r._setRaw("topics_extracted_version", null);
@@ -2978,7 +2974,7 @@ async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
       r._setRaw("updated_at", originalUpdatedAt);
     });
   });
-  return true;
+  return cleared;
 }
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
@@ -3141,11 +3137,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -3155,8 +3153,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -3172,11 +3174,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(
@@ -6430,7 +6442,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-R3VX2UST.mjs");
+        const { recall: recall2 } = await import("./recall-WXCZHXHZ.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,

package/dist/react/index.cjs

@@ -5238,7 +5238,7 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
   if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return null;
   let stale = false;
   const originalUpdatedAt = record.updatedAt.getTime();
-  await ctx.database.write(async () => {
+  await ctx.database.write(async (writer) => {
     if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) {
       stale = true;
       return;
@@ -5247,30 +5247,23 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
       r._setRaw("topics_user_managed", true);
       r._setRaw("updated_at", originalUpdatedAt);
     });
+    const linked = entities.length > 0 ? await writer.callWriter(
+      () => linkMemoryEntitiesOp(entityCtx, memoryId, entities, { topicsSource: "user" })
+    ) : [];
+    const keep = new Set(linked.map((e) => e.uniqueId));
+    const existing = await entityCtx.memoryEntityCollection.query(import_watermelondb10.Q.where("memory_id", memoryId)).fetch();
+    const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
+    if (staleLinks.length === 0 && entities.length > 0) return;
+    const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, memoryId, linked, entities, "user");
+    await ctx.database.batch(
+      ...staleLinks.map((l) => l.prepareDestroyPermanently()),
+      ...topicsOp ? [topicsOp] : []
+    );
   });
   if (stale) return null;
-  const linked = entities.length > 0 ? await linkMemoryEntitiesOp(entityCtx, memoryId, entities, { topicsSource: "user" }) : [];
-  const keep = new Set(linked.map((e) => e.uniqueId));
-  const existing = await entityCtx.memoryEntityCollection.query(import_watermelondb10.Q.where("memory_id", memoryId)).fetch();
-  const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
-  if (staleLinks.length > 0 || entities.length === 0) {
-    await ctx.database.write(async () => {
-      const topicsOp = await prepareMemoryTopicsUpdate(
-        entityCtx,
-        memoryId,
-        linked,
-        entities,
-        "user"
-      );
-      await ctx.database.batch(
-        ...staleLinks.map((l) => l.prepareDestroyPermanently()),
-        ...topicsOp ? [topicsOp] : []
-      );
-    });
-  }
   return vaultMemoryToStored(record, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner);
 }
-async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
   let record;
   try {
     record = await ctx.vaultMemoryCollection.find(memoryId);
@@ -5279,7 +5272,10 @@ async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
   }
   if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
   const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
   await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
     await record.update((r) => {
       r._setRaw("topics_user_managed", false);
       r._setRaw("topics_extracted_version", null);
@@ -5289,7 +5285,7 @@ async function clearMemoryTopicsOverrideOp(ctx, memoryId) {
       r._setRaw("updated_at", originalUpdatedAt);
     });
   });
-  return true;
+  return cleared;
 }
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
@@ -5451,11 +5447,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -5465,8 +5463,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -5482,11 +5484,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(

package/dist/react/index.d.mts

@@ -7457,8 +7457,18 @@ declare function setMemoryEntitiesOp(ctx: VaultMemoryOperationsContext, memoryId
  * see the schema note. This op's version-invalidation trick is the reason the
  * earlier plan to exclude them from sync was dropped, and it's the last piece
  * that has to move before they can go.
+ *
+ * `options.unlessTopicsRecorded` declines the reset when the row already has a
+ * `topics` record, re-checked INSIDE the serialized writer. Only the repair path
+ * in {@link getMemoriesNeedingTopicExtractionOp} passes it: that path clears the
+ * flag off rows whose curation is provably empty, and a `setMemoryEntitiesOp`
+ * committing in the gap would have written a real record the autotagger must not
+ * be handed. The user-facing reset leaves it off — resetting a memory that HAS
+ * curated topics is the whole point there.
  */
-declare function clearMemoryTopicsOverrideOp(ctx: VaultMemoryOperationsContext, memoryId: string): Promise<boolean>;
+declare function clearMemoryTopicsOverrideOp(ctx: VaultMemoryOperationsContext, memoryId: string, options?: {
+    unlessTopicsRecorded?: boolean;
+}): Promise<boolean>;
 /**
  * Set a memory's People Nearby visibility (and optionally its twin opt-in).
  *
@@ -7500,6 +7510,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -7512,9 +7528,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -7566,6 +7583,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/react/index.d.ts

@@ -7457,8 +7457,18 @@ declare function setMemoryEntitiesOp(ctx: VaultMemoryOperationsContext, memoryId
  * see the schema note. This op's version-invalidation trick is the reason the
  * earlier plan to exclude them from sync was dropped, and it's the last piece
  * that has to move before they can go.
+ *
+ * `options.unlessTopicsRecorded` declines the reset when the row already has a
+ * `topics` record, re-checked INSIDE the serialized writer. Only the repair path
+ * in {@link getMemoriesNeedingTopicExtractionOp} passes it: that path clears the
+ * flag off rows whose curation is provably empty, and a `setMemoryEntitiesOp`
+ * committing in the gap would have written a real record the autotagger must not
+ * be handed. The user-facing reset leaves it off — resetting a memory that HAS
+ * curated topics is the whole point there.
  */
-declare function clearMemoryTopicsOverrideOp(ctx: VaultMemoryOperationsContext, memoryId: string): Promise<boolean>;
+declare function clearMemoryTopicsOverrideOp(ctx: VaultMemoryOperationsContext, memoryId: string, options?: {
+    unlessTopicsRecorded?: boolean;
+}): Promise<boolean>;
 /**
  * Set a memory's People Nearby visibility (and optionally its twin opt-in).
  *
@@ -7500,6 +7510,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -7512,9 +7528,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -7566,6 +7583,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/react/index.mjs

@@ -161,7 +161,7 @@ import {
   updateVaultMemoryOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-BAJL46NX.mjs";
+} from "./chunk-BS7C4CUW.mjs";
 import {
   PiiRedactor,
   createStreamingDeAnonymizer,

package/dist/react/{recall-R3VX2UST.mjs → recall-WXCZHXHZ.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-BAJL46NX.mjs";
+} from "./chunk-BS7C4CUW.mjs";
 import "./chunk-ILAWDQDE.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {

package/dist/server/{chunk-WZE6ZVKE.mjs → chunk-WADHFDMA.mjs}

@@ -16942,6 +16942,30 @@ async function updateVaultMemoryOp(ctx, id, opts) {
     return null;
   }
 }
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
+  let record;
+  try {
+    record = await ctx.vaultMemoryCollection.find(memoryId);
+  } catch {
+    return false;
+  }
+  if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
+  const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
+  await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
+    await record.update((r) => {
+      r._setRaw("topics_user_managed", false);
+      r._setRaw("topics_extracted_version", null);
+      if (record.topicsExtractedAt === null) {
+        r._setRaw("topics_extracted_at", originalUpdatedAt);
+      }
+      r._setRaw("updated_at", originalUpdatedAt);
+    });
+  });
+  return cleared;
+}
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
   try {
@@ -17103,11 +17127,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -17117,8 +17143,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -17134,11 +17164,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(
@@ -20310,7 +20350,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-YZWIV6IH.mjs");
+        const { recall: recall2 } = await import("./recall-QTVT7HCZ.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,

package/dist/server/index.cjs

@@ -17747,6 +17747,30 @@ async function updateVaultMemoryOp(ctx, id, opts) {
     return null;
   }
 }
+async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
+  let record;
+  try {
+    record = await ctx.vaultMemoryCollection.find(memoryId);
+  } catch {
+    return false;
+  }
+  if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return false;
+  const originalUpdatedAt = record.updatedAt.getTime();
+  let cleared = false;
+  await ctx.database.write(async () => {
+    if (options?.unlessTopicsRecorded && parseTopics(record.topics) !== null) return;
+    cleared = true;
+    await record.update((r) => {
+      r._setRaw("topics_user_managed", false);
+      r._setRaw("topics_extracted_version", null);
+      if (record.topicsExtractedAt === null) {
+        r._setRaw("topics_extracted_at", originalUpdatedAt);
+      }
+      r._setRaw("updated_at", originalUpdatedAt);
+    });
+  });
+  return cleared;
+}
 async function setMemoryVisibilityOp(ctx, id, opts) {
   let record;
   try {
@@ -17907,11 +17931,13 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     entityCtx,
     rows.map((r) => r.id)
   );
+  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
   const pendingRaw = [];
   const stampedPendingRaw = [];
   const linkedUnstampedAll = [];
   const topicsToRelinkAll = [];
   const topicsBackfillAll = [];
+  const emptyCurationToClear = [];
   for (const raw of rows) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
@@ -17921,8 +17947,12 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       continue;
     }
     if (raw.topics_user_managed) {
-      if (topics === null && linked !== void 0) topicsBackfillAll.push(id);
-      continue;
+      if (topics !== null || linked !== void 0) {
+        if (topics === null) topicsBackfillAll.push(id);
+        continue;
+      }
+      if (cap !== void 0 && emptyCurationToClear.length >= cap) continue;
+      emptyCurationToClear.push(id);
     }
     const stamp = raw.topics_extracted_at ?? null;
     let isPending = false;
@@ -17938,11 +17968,21 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
       pendingRaw.push(raw);
       isPending = true;
     }
+    if (!isPending && linked === void 0 && topics === null) {
+      pendingRaw.push(raw);
+      isPending = true;
+    }
     if (!isPending && topics === null && linked !== void 0) {
       topicsBackfillAll.push(id);
     }
   }
-  const cap = options?.limit !== void 0 && options.limit > 0 ? options.limit : void 0;
+  for (const id of emptyCurationToClear) {
+    try {
+      await clearMemoryTopicsOverrideOp(ctx, id, { unlessTopicsRecorded: true });
+    } catch (err) {
+      getLogger().warn("[memory/topics] repair clear failed", err);
+    }
+  }
   const orderedPendingRaw = [...stampedPendingRaw, ...pendingRaw];
   const limitedPendingRaw = cap !== void 0 ? orderedPendingRaw.slice(0, cap) : orderedPendingRaw;
   const pending = await mapInBatches(

package/dist/server/index.d.mts

@@ -6025,6 +6025,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -6037,9 +6043,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -6091,6 +6098,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/server/index.d.ts

@@ -6025,6 +6025,12 @@ declare function getUnfiledVaultMemoriesOp(ctx: VaultMemoryOperationsContext): P
  * older version (including pre-v37 rows, read as version 0) is then re-extracted
  * by the next sweep, so topic-quality improvements propagate across the existing
  * vault. The worker's `limit` drains that re-extraction across sweeps.
+ *
+ * Bumping this is a WHOLE-VAULT re-extraction: the gate is unconditional across
+ * every stamped row, and `stampTopicsExtractedAtOp` stamps this version on every
+ * healthy row, so a bump sends each user's entire extracted vault back to the
+ * LLM. Never reach for it to repair a subset — see the pre-v42-restore repair in
+ * {@link getMemoriesNeedingTopicExtractionOp}, which targets the damaged rows.
  */
 declare const TOPICS_EXTRACTION_VERSION = 3;
 /**
@@ -6037,9 +6043,10 @@ interface MemoriesNeedingTopicExtraction {
      * Memories to run LLM topic extraction on (decrypted): never-extracted rows
      * with no entity links, plus stamped rows edited since their last pass
      * (`updated_at` > `topics_extracted_at`) or extracted under an older
-     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}. Edited /
-     * stale-version rows come first (they get priority under `limit`), each group
-     * newest-created first.
+     * `topics_extracted_version` than {@link TOPICS_EXTRACTION_VERSION}, plus the
+     * pre-v42-restore repair: a stamped row left with neither links nor a `topics`
+     * record, which no no-LLM bucket can reach. Edited / stale-version rows come
+     * first (they get priority under `limit`), each group newest-created first.
      */
     pending: StoredVaultMemory[];
     /**
@@ -6091,6 +6098,11 @@ interface MemoriesNeedingTopicExtraction {
  * between the record and the index and never re-derive them. That's why the
  * ownership filter lives in the partition below rather than in the query: a
  * restored curated memory is exactly the row whose index must be rebuilt.
+ *
+ * NOT purely a read: a curated row with no `topics` record AND no usable link is
+ * a contradiction only a pre-v42 restore produces, and this is the one place
+ * that can see all three facts at once, so it clears the flag there (capped by
+ * `limit`) before returning. See the branch for why that's safe.
  */
 declare function getMemoriesNeedingTopicExtractionOp(ctx: VaultMemoryOperationsContext, options?: {
     limit?: number;

package/dist/server/index.mjs

@@ -133,7 +133,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-WZE6ZVKE.mjs";
+} from "./chunk-WADHFDMA.mjs";
 import {
   createStreamingDeAnonymizer,
   notifyConsolidationFallback,

package/dist/server/{recall-YZWIV6IH.mjs → recall-QTVT7HCZ.mjs}

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

package/package.json

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