@anuma/sdk 6.9.0 → 6.11.0

package/dist/expo/index.cjs

@@ -6507,9 +6507,9 @@ function recencyMultiplier(updatedAt, opts = {}) {
   const updatedMs = updatedAt.getTime();
   if (!Number.isFinite(updatedMs)) return noDate;
   const now = opts.now ?? /* @__PURE__ */ new Date();
-  const nowMs2 = now.getTime();
-  if (!Number.isFinite(nowMs2)) return noDate;
-  const ageDays2 = Math.max(0, (nowMs2 - updatedMs) / DAY_MS2);
+  const nowMs3 = now.getTime();
+  if (!Number.isFinite(nowMs3)) return noDate;
+  const ageDays2 = Math.max(0, (nowMs3 - updatedMs) / DAY_MS2);
   const perYearDecay = opts.perYearDecay ?? DEFAULT_PER_YEAR_DECAY;
   const floor = opts.floor ?? DEFAULT_FLOOR;
   const decay = perYearDecay * (ageDays2 / 365);
@@ -7563,6 +7563,9 @@ async function recall(query, ctx, options = {}) {
   const chunkResults = [];
   let vaultSize;
   let didRerank = false;
+  let rerankMs = 0;
+  let queryEmbedMs = 0;
+  let vaultRowsEmbedded;
   let hadV2Head = false;
   let embeddingsUnavailable = false;
   let chunkEmbedFailed = false;
@@ -7587,12 +7590,15 @@ async function recall(query, ctx, options = {}) {
       ...vaultSize !== void 0 && { vaultSize },
       ...decryptLastRan !== void 0 && { decryptLast: decryptLastRan },
       ...vaultRowsDecrypted !== void 0 && { vaultRowsDecrypted },
+      ...vaultRowsEmbedded !== void 0 && { vaultRowsEmbedded },
       factCount: factResults.length,
       chunkCount: chunkResults.length,
       timings: {
         total: nowMs() - t0,
         prep: prepMs,
         factLane: factLaneMs,
+        rerank: rerankMs,
+        queryEmbed: queryEmbedMs,
         chunkLane: chunkLaneMs,
         fuse: fuseMs
       },
@@ -7656,6 +7662,9 @@ async function recall(query, ctx, options = {}) {
       results,
       vaultSize: size,
       reranked,
+      rerankMs: factRerankMs,
+      queryEmbedMs: factQueryEmbedMs,
+      rowsEmbedded: factRowsEmbedded,
       hadV2Head: v2Head,
       embeddingsUnavailable: factEmbeddingsUnavailable,
       rankedOnCosine: factRankedOnCosine,
@@ -7714,6 +7723,9 @@ async function recall(query, ctx, options = {}) {
     );
     vaultSize = size;
     didRerank = reranked;
+    rerankMs = factRerankMs;
+    queryEmbedMs = factQueryEmbedMs;
+    vaultRowsEmbedded = factRowsEmbedded;
     hadV2Head = v2Head;
     if (factEmbeddingsUnavailable) embeddingsUnavailable = true;
     factLaneRankedOnCosine = factRankedOnCosine;
@@ -8178,6 +8190,7 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
     const rerankTopN = options.rerankTopN ?? 30;
     const ceWeight = options.ceWeight ?? 0.1;
     const headSlice = v2Ranked.slice(0, rerankTopN);
+    const ceStart = nowMs2();
     try {
       const reranked = await rerankPairs(
         query,
@@ -8205,6 +8218,8 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
         getLogger().warn("[memory/search] cross-encoder rerank failed; using V2 ranking", err);
       }
       combined = v2Ranked;
+    } finally {
+      if (options.rerankStats) options.rerankStats.ms += nowMs2() - ceStart;
     }
   } else {
     combined = v2Ranked;
@@ -8371,6 +8386,7 @@ async function rankComposite(originalQuery, originalQueryEmbedding, subQueries,
     const ceWeight = options.ceWeight ?? 0.1;
     const headSlice = combined.slice(0, rerankTopN);
     const tailSlice = combined.slice(rerankTopN);
+    const ceStart = nowMs2();
     try {
       const reranked = await rerankPairs(
         originalQuery,
@@ -8398,6 +8414,8 @@ async function rankComposite(originalQuery, originalQueryEmbedding, subQueries,
           err
         );
       }
+    } finally {
+      if (options.rerankStats) options.rerankStats.ms += nowMs2() - ceStart;
     }
   }
   if (options?.mmr) {
@@ -8524,11 +8542,13 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
       rowsDecrypted: 0
     };
   }
+  const queryEmbedStart = nowMs2();
   const queryEmbedding = await embedQueryOrDegrade(
     query,
     embeddingOptions,
     opts.onEmbeddingDegraded
   );
+  if (opts.embedStats) opts.embedStats.queryMs += nowMs2() - queryEmbedStart;
   const embeddingsDegraded = queryEmbedding.length === 0;
   const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const vectored = [];
@@ -8581,6 +8601,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     const laneRows = laneFetched.filter((m) => !isEncrypted(m.content));
     if (laneRows.length > 0) {
       let laneVecs;
+      if (opts.embedStats) opts.embedStats.rowsEmbedded += laneRows.length;
       try {
         laneVecs = await generateEmbeddings(
           laneRows.map((m) => m.content),
@@ -8659,6 +8680,10 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
 async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache, searchOptions) {
   if (!query || typeof query !== "string") {
     return {
+      // Nothing was read and nothing was embedded — the short-circuit fires
+      // before either.
+      queryEmbedMs: 0,
+      rowsEmbedded: 0,
       memories: [],
       embeddedItems: [],
       queryEmbedding: [],
@@ -8691,6 +8716,7 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
     embeddingsUnavailable = true;
     embeddingFailure = true;
   };
+  const embedStats = { queryMs: 0, rowsEmbedded: 0 };
   if (searchOptions?.decryptLast) {
     const forceIncludeIds = [
       ...searchOptions.entityRanking ?? [],
@@ -8702,7 +8728,8 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       admitFloor: ADMIT_FLOOR,
       unembeddedCap: UNEMBEDDED_CAP,
       ...forceIncludeIds.length > 0 && { forceIncludeIds },
-      onEmbeddingDegraded
+      onEmbeddingDegraded,
+      embedStats
     });
     if (corpus.vaultSize === 0) {
       return {
@@ -8713,7 +8740,9 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
         embeddingsUnavailable: false,
         embeddingFailure: false,
         decryptLast: true,
-        rowsDecrypted: corpus.rowsDecrypted
+        rowsDecrypted: corpus.rowsDecrypted,
+        queryEmbedMs: embedStats.queryMs,
+        rowsEmbedded: embedStats.rowsEmbedded
       };
     }
     ({ memories, embeddedItems, queryEmbedding, vaultSize } = corpus);
@@ -8730,7 +8759,9 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
         decryptLast: true,
         // Rows WERE decrypt-attempted even though none came back readable — that
         // is the whole point of reporting attempts rather than successes.
-        rowsDecrypted: corpus.rowsDecrypted
+        rowsDecrypted: corpus.rowsDecrypted,
+        queryEmbedMs: embedStats.queryMs,
+        rowsEmbedded: embedStats.rowsEmbedded
       };
     }
   } else {
@@ -8755,10 +8786,14 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
         embeddingsUnavailable: false,
         embeddingFailure: false,
         decryptLast: false,
-        rowsDecrypted: loaded.length
+        rowsDecrypted: loaded.length,
+        queryEmbedMs: embedStats.queryMs,
+        rowsEmbedded: embedStats.rowsEmbedded
       };
     }
+    const legacyEmbedStart = nowMs2();
     queryEmbedding = await embedQueryOrDegrade(query, embeddingOptions, onEmbeddingDegraded);
+    embedStats.queryMs += nowMs2() - legacyEmbedStart;
     const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
     const uncachedTexts = [];
     const uncachedIndices = [];
@@ -8792,6 +8827,7 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
     }
     if (uncachedTexts.length > 0) {
       let newEmbeddings;
+      embedStats.rowsEmbedded += uncachedTexts.length;
       try {
         newEmbeddings = await generateEmbeddings(uncachedTexts, embeddingOptions);
       } catch (err) {
@@ -8835,6 +8871,8 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
     embeddingsUnavailable = true;
   }
   return {
+    queryEmbedMs: embedStats.queryMs,
+    rowsEmbedded: embedStats.rowsEmbedded,
     memories,
     embeddedItems,
     queryEmbedding,
@@ -8885,11 +8923,15 @@ async function rankPreparedVaultCandidates(query, prepared, embeddingOptions, se
       results: results2,
       vaultSize: out.vaultSize,
       reranked: out.reranked ?? false,
+      // Read straight off the shared stats object rather than being passed in at
+      // each call site: every return in this function funnels through here, so a
+      // path added later reports the CE bill without having to remember to.
+      rerankMs: rerankStats.ms,
       hadV2Head: out.hadV2Head ?? false,
       embeddingsUnavailable
     };
   };
-  const rerankStats = { applied: false };
+  const rerankStats = { applied: false, ms: 0 };
   const useFusion = searchOptions?.useFusion ?? true;
   const tuning = {
     ...searchOptions?.recencyAlpha !== void 0 && { recencyAlpha: searchOptions.recencyAlpha },
@@ -9008,13 +9050,16 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
       results: [],
       vaultSize: 0,
       reranked: false,
+      rerankMs: 0,
       hadV2Head: false,
       embeddingsUnavailable: false,
       rankedOnCosine: false,
       // No storage read happened, so nothing was decrypted; report the path the
       // caller asked for so this turn is still attributable.
       decryptLast: !!searchOptions?.decryptLast,
-      rowsDecrypted: 0
+      rowsDecrypted: 0,
+      queryEmbedMs: 0,
+      rowsEmbedded: 0
     };
   }
   if (searchOptions?.decompose === "llm" && normalizeSubQueries(searchOptions.subQueries).length < 2 && !warnedProgrammaticDecomposeIgnored) {
@@ -9035,11 +9080,14 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
       results: [],
       vaultSize: 0,
       reranked: false,
+      rerankMs: 0,
       hadV2Head: false,
       embeddingsUnavailable: prepared.embeddingsUnavailable,
       rankedOnCosine: false,
       decryptLast: prepared.decryptLast,
-      rowsDecrypted: prepared.rowsDecrypted
+      rowsDecrypted: prepared.rowsDecrypted,
+      queryEmbedMs: prepared.queryEmbedMs,
+      rowsEmbedded: prepared.rowsEmbedded
     };
   }
   if (prepared.memories.length === 0) {
@@ -9047,11 +9095,14 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
       results: [],
       vaultSize: prepared.vaultSize,
       reranked: false,
+      rerankMs: 0,
       hadV2Head: false,
       embeddingsUnavailable: prepared.embeddingsUnavailable,
       rankedOnCosine: false,
       decryptLast: prepared.decryptLast,
-      rowsDecrypted: prepared.rowsDecrypted
+      rowsDecrypted: prepared.rowsDecrypted,
+      queryEmbedMs: prepared.queryEmbedMs,
+      rowsEmbedded: prepared.rowsEmbedded
     };
   }
   const ranked = await rankPreparedVaultCandidates(
@@ -9064,7 +9115,9 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
     ...ranked,
     rankedOnCosine: !ranked.embeddingsUnavailable,
     decryptLast: prepared.decryptLast,
-    rowsDecrypted: prepared.rowsDecrypted
+    rowsDecrypted: prepared.rowsDecrypted,
+    queryEmbedMs: prepared.queryEmbedMs,
+    rowsEmbedded: prepared.rowsEmbedded
   };
 }
 async function searchVaultMemories(query, vaultCtx, embeddingOptions, cache, searchOptions) {
@@ -9214,7 +9267,7 @@ ${formatted}`;
     }
   };
 }
-var warnedProgrammaticDecomposeIgnored, SUPERSESSION_SIMILARITY_THRESHOLD, SUPERSESSION_MIN_AGE_GAP_MS, SUPERSESSION_BOOST_FACTOR, SUPERSESSION_MAX_WINDOW, EMBEDDINGS_DEGRADED_EMPTY_NO_LEXICAL;
+var nowMs2, warnedProgrammaticDecomposeIgnored, 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";
@@ -9232,6 +9285,7 @@ var init_searchTool = __esm({
     init_bm25();
     init_decomposeQuery();
     init_lruCache();
+    nowMs2 = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
     warnedProgrammaticDecomposeIgnored = false;
     SUPERSESSION_SIMILARITY_THRESHOLD = 0.7;
     SUPERSESSION_MIN_AGE_GAP_MS = 30 * 24 * 60 * 60 * 1e3;
@@ -9595,6 +9649,7 @@ __export(index_exports, {
   hasEncryptionKey: () => hasEncryptionKey,
   ingestPublishedPhotoMemoriesOp: () => ingestPublishedPhotoMemoriesOp,
   injectionSignatureCatalog: () => injectionSignatureCatalog,
+  isDegradedTopicSkip: () => isDegradedTopicSkip,
   isPiiRedactor: () => isPiiRedactor,
   isRerankerAvailable: () => isRerankerAvailable,
   moveMemoriesToFolderOp: () => moveMemoriesToFolderOp,
@@ -18463,6 +18518,18 @@ function parseTopicResponse(parsed, validIds) {
   }
   return out;
 }
+var DEGRADED_TOPIC_SKIP = {
+  excluded: false,
+  "link-declined": false,
+  "stamp-declined": false,
+  "llm-unanswered": true,
+  unreadable: true,
+  "not-found": true,
+  "link-failed": true
+};
+function isDegradedTopicSkip(reason) {
+  return DEGRADED_TOPIC_SKIP[reason] === true;
+}
 async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const entityCtx = ctx.entityCtx;
   if (!entityCtx) {
@@ -18471,17 +18538,24 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const log = getLogger();
   const extractedAt = options.now ?? Date.now();
   const skippedIds = [];
+  const skippedReasons = /* @__PURE__ */ new Map();
+  const skip = (id, reason) => {
+    if (skippedReasons.has(id)) return;
+    skippedIds.push(id);
+    skippedReasons.set(id, reason);
+  };
   const inputs = [];
-  for (const id of memoryIds) {
+  for (const id of new Set(memoryIds)) {
     let record;
     try {
       record = await ctx.vaultMemoryCollection.find(id);
-    } catch {
-      skippedIds.push(id);
+    } catch (err) {
+      log.warn("[memory/topics] vault lookup failed for extraction", err);
+      skip(id, "not-found");
       continue;
     }
     if (record.isDeleted || ctx.userId !== void 0 && record.userId !== ctx.userId || record.topicsUserManaged) {
-      skippedIds.push(id);
+      skip(id, "excluded");
       continue;
     }
     try {
@@ -18494,7 +18568,7 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
       inputs.push({ id, content: stored.content });
     } catch (err) {
       log.warn("[memory/topics] failed to load memory for extraction", err);
-      skippedIds.push(id);
+      skip(id, "unreadable");
     }
   }
   const entitiesByMemory = await extractEntitiesForMemories(inputs, options);
@@ -18502,19 +18576,19 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   for (const input of inputs) {
     const entities = entitiesByMemory.get(input.id);
     if (entities === void 0) {
-      skippedIds.push(input.id);
+      skip(input.id, "llm-unanswered");
       continue;
     }
     try {
       const linked = await replaceMemoryEntitiesGuardedOp(entityCtx, input.id, entities);
       if (linked === null) {
-        skippedIds.push(input.id);
+        skip(input.id, "link-declined");
         entitiesByMemory.delete(input.id);
         continue;
       }
     } catch (err) {
       log.warn("[memory/topics] replaceMemoryEntitiesGuardedOp failed", err);
-      skippedIds.push(input.id);
+      skip(input.id, "link-failed");
       entitiesByMemory.delete(input.id);
       continue;
     }
@@ -18524,11 +18598,11 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const stampedSet = new Set(stampedIds);
   for (const id of toStamp) {
     if (!stampedSet.has(id)) {
-      skippedIds.push(id);
+      skip(id, "stamp-declined");
       entitiesByMemory.delete(id);
     }
   }
-  return { entitiesByMemory, stampedIds, skippedIds };
+  return { entitiesByMemory, stampedIds, skippedIds, skippedReasons };
 }
 
 // src/lib/memory/verifySupport.ts
@@ -24560,6 +24634,7 @@ function createNotionTools(getAccessToken, requestNotionAccess) {
   hasEncryptionKey,
   ingestPublishedPhotoMemoriesOp,
   injectionSignatureCatalog,
+  isDegradedTopicSkip,
   isPiiRedactor,
   isRerankerAvailable,
   moveMemoriesToFolderOp,

package/dist/expo/index.d.mts

@@ -5732,6 +5732,17 @@ interface RecallDiagnostics {
      * never the cost.
      */
     vaultRowsDecrypted?: number;
+    /**
+     * Rows the fact lane had to re-embed through the portal because their stored
+     * vector was unusable — stale `embedding_model`, wrong dimension, or
+     * unparseable. Absent when the fact lane didn't run.
+     *
+     * Expected to be 0 on a healthy vault: rows are embedded at write time and the
+     * re-embed writes the current model back, so a persistently non-zero value
+     * means the writeback is not sticking and every turn is paying for it. On the
+     * LEGACY read path this batch is uncapped, so it can be the whole vault.
+     */
+    vaultRowsEmbedded?: number;
     /** Facts the fact lane returned (post-dedupe, pre-fusion). */
     factCount: number;
     /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
@@ -5744,6 +5755,37 @@ interface RecallDiagnostics {
         prep: number;
         /** Vault fact-lane search (`searchVaultMemoriesWithSize`). */
         factLane: number;
+        /**
+         * The cross-encoder's share of {@link factLane} — wall-clock spent inside
+         * `rerankPairs`. Billed even when the CE threw partway through, because a
+         * rerank that burned three seconds and then failed still cost them.
+         *
+         * A SUBSET of `factLane`, not a sibling: read `factLane - rerank` for
+         * everything else the lane did (query embed, vault read, fused ranking).
+         * 0 when the CE did not run; `reranked` is what distinguishes that from a
+         * rerank that cost nothing.
+         *
+         * Exists because #845 spent three rounds arguing about which stage inside
+         * the fact lane dominated — whole-vault read, then admission window, then
+         * the CE — with one aggregate number for all of them. Every hypothesis was
+         * an inference; this makes the question a query.
+         */
+        rerank: number;
+        /**
+         * The query embed's share of {@link factLane} — one portal round trip.
+         *
+         * Also a SUBSET of `factLane`. Together with `rerank` this makes the lane
+         * decomposable: `factLane - queryEmbed - rerank` is the local work (vault
+         * read, decrypt, BM25/cosine fusion), and each of the three implies a
+         * completely different fix.
+         *
+         * 0 when the lane returned before embedding, which includes every empty
+         * vault — `prepareVaultCandidates` short-circuits first. That is why the
+         * fast `vault_size = 0` population never established a baseline for this
+         * cost, and why the ~850ms floor on the smallest NON-empty vaults had no
+         * attributable owner.
+         */
+        queryEmbed: number;
         /** Chunk-lane search (`searchChunksOp`). */
         chunkLane: number;
         /** Cross-lane RRF fusion + provenance dedup after both lanes. */
@@ -8519,6 +8561,39 @@ interface TopicExtractOptions extends PortalLlmAuth {
  * later sweep, never stamp them.
  */
 declare function extractEntitiesForMemories(memories: readonly TopicExtractionInput[], options: TopicExtractOptions): Promise<Map<string, ExtractedEntity[]>>;
+/**
+ * Why one memory was skipped by a topic sweep.
+ *
+ * Split along the line that actually matters operationally — did the sweep
+ * DECLINE this row on purpose, or did something BREAK:
+ *
+ * Deliberate (healthy; a sweep of nothing but these is a success):
+ * - `excluded`        — deleted, owned by another user, or `topicsUserManaged`.
+ * - `link-declined`   — the entity-link write's in-row guard declined (the row
+ *                       became user-managed / deleted / absent mid-run).
+ * - `stamp-declined`  — same, caught by the stamp op's own re-check.
+ *
+ * Degraded (something is wrong; see {@link isDegradedTopicSkip}):
+ * - `llm-unanswered`  — the batch failed or the model omitted this id. THE one
+ *                       to alarm on: it is how a wholly broken sweep looks.
+ * - `unreadable`      — the row could not be loaded/decrypted.
+ * - `not-found`       — the lookup threw (absent row or read fault).
+ * - `link-failed`     — the entity-link write threw.
+ *
+ * @public
+ */
+type TopicSkipReason = "excluded" | "link-declined" | "stamp-declined" | "llm-unanswered" | "unreadable" | "not-found" | "link-failed";
+/**
+ * Whether a skip reason means the sweep FAILED on that row, rather than
+ * deliberately passing over it.
+ *
+ * Exported so callers classify identically instead of each re-deriving the
+ * split — the reason this type exists is that one wrong grouping turns a broken
+ * sweep back into a healthy-looking one.
+ *
+ * @public
+ */
+declare function isDegradedTopicSkip(reason: TopicSkipReason): boolean;
 /** Outcome of one {@link extractAndLinkEntitiesForMemoriesOp} run. */
 interface TopicExtractionRunResult {
     /** memoryId → entities the LLM returned (post-validation, post-linking). */
@@ -8531,6 +8606,24 @@ interface TopicExtractionRunResult {
      * LLM batches. Skipped ids are not stamped, so failed batches are retried
      * by a later sweep — callers should apply their own attempt caps. */
     skippedIds: string[];
+    /**
+     * Why each id in {@link skippedIds} was skipped.
+     *
+     * `skippedIds` alone cannot distinguish a sweep that deliberately declined
+     * work from one that FAILED: a run where every LLM batch errored and a run
+     * over rows the user has taken manual control of produce an identical array.
+     * That is the same blindness `outcome: 'empty-after-retry'` had before #888 —
+     * a degradation wearing the shape of normal control flow.
+     *
+     * It matters here because topics feed the entity recall lane, so a silently
+     * failing sweep means memories that exist but cannot be found by entity, with
+     * nothing in production saying so.
+     *
+     * Populated in lockstep with `skippedIds` (single `skip()` helper), so the two
+     * cannot drift. Group by {@link isDegradedTopicSkip} to separate "declined" from
+     * "broke".
+     */
+    skippedReasons: Map<string, TopicSkipReason>;
 }
 /**
  * Run LLM topic extraction over existing vault memories and persist the
@@ -10377,4 +10470,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isDegradedTopicSkip, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };