@anuma/sdk 6.30.2 → 6.31.1

package/dist/expo/{chunk-VD5M6QAI.mjs → chunk-XD6WOQ5I.mjs}

@@ -19,12 +19,28 @@ var noopLogger = {
   error: () => {
   }
 };
-var currentLogger = consoleLogger;
+var LOGGER_STATE_KEY = /* @__PURE__ */ Symbol.for("@anuma/sdk/logger/v1");
+var loggerGlobal = globalThis;
+var fallbackLoggerState = { logger: consoleLogger };
+var fallbackWarned = false;
+function getLoggerState() {
+  try {
+    return loggerGlobal[LOGGER_STATE_KEY] ?? (loggerGlobal[LOGGER_STATE_KEY] = fallbackLoggerState);
+  } catch {
+    if (!fallbackWarned) {
+      fallbackWarned = true;
+      fallbackLoggerState.logger.warn(
+        "@anuma/sdk: the global object rejects new properties. This entrypoint keeps its own logger, so setLogger does not reach other entrypoints."
+      );
+    }
+    return fallbackLoggerState;
+  }
+}
 function setLogger(logger) {
-  currentLogger = logger;
+  getLoggerState().logger = logger;
 }
 function getLogger() {
-  return currentLogger;
+  return getLoggerState().logger;
 }
 
 // src/lib/pii/patterns.ts

package/dist/expo/{consolidate-6J5HHAJY.mjs → consolidate-7DBUHQRK.mjs}

@@ -2,7 +2,7 @@ import {
   callPortalJsonCompletion,
   notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-VD5M6QAI.mjs";
+} from "./chunk-XD6WOQ5I.mjs";
 import "./chunk-GYKJOWEO.mjs";
 
 // src/lib/memory/consolidate.ts

package/dist/expo/index.cjs

@@ -44,13 +44,26 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 
 // src/lib/logger.ts
+function getLoggerState() {
+  try {
+    return loggerGlobal[LOGGER_STATE_KEY] ?? (loggerGlobal[LOGGER_STATE_KEY] = fallbackLoggerState);
+  } catch {
+    if (!fallbackWarned) {
+      fallbackWarned = true;
+      fallbackLoggerState.logger.warn(
+        "@anuma/sdk: the global object rejects new properties. This entrypoint keeps its own logger, so setLogger does not reach other entrypoints."
+      );
+    }
+    return fallbackLoggerState;
+  }
+}
 function setLogger(logger) {
-  currentLogger = logger;
+  getLoggerState().logger = logger;
 }
 function getLogger() {
-  return currentLogger;
+  return getLoggerState().logger;
 }
-var consoleLogger, noopLogger, currentLogger;
+var consoleLogger, noopLogger, LOGGER_STATE_KEY, loggerGlobal, fallbackLoggerState, fallbackWarned;
 var init_logger = __esm({
   "src/lib/logger.ts"() {
     "use strict";
@@ -70,7 +83,10 @@ var init_logger = __esm({
       error: () => {
       }
     };
-    currentLogger = consoleLogger;
+    LOGGER_STATE_KEY = /* @__PURE__ */ Symbol.for("@anuma/sdk/logger/v1");
+    loggerGlobal = globalThis;
+    fallbackLoggerState = { logger: consoleLogger };
+    fallbackWarned = false;
   }
 });
 
@@ -3734,6 +3750,9 @@ async function updateMessageEmbeddingOp(ctx, uniqueId, vector, embeddingModel) {
   await ctx.database.write(async () => {
     await message.update((msg) => {
       msg._setRaw("vector", JSON.stringify(vector));
+      if (msg.origin === "chunks_discarded" && vector.length > 0) {
+        msg._setRaw("origin", "message");
+      }
       msg._setRaw("embedding_model", embeddingModel);
     });
   });
@@ -3750,6 +3769,9 @@ async function updateMessageChunksOp(ctx, uniqueId, chunks, embeddingModel) {
   await ctx.database.write(async () => {
     await message.update((msg) => {
       msg._setRaw("chunks", JSON.stringify(storedChunks));
+      if (msg.origin === "chunks_discarded" && storedChunks.length > 0 && storedChunks.every((chunk) => chunk.vector.length > 0)) {
+        msg._setRaw("origin", "message");
+      }
       msg._setRaw("embedding_model", embeddingModel);
     });
   });
@@ -5974,6 +5996,9 @@ function clientToolToResponsesFormat(tool) {
     ...toolConfig.removeAfterExecution !== void 0 && {
       removeAfterExecution: toolConfig.removeAfterExecution
     },
+    ...toolConfig.removeAfterResult !== void 0 && {
+      removeAfterResult: toolConfig.removeAfterResult
+    },
     ...toolConfig.executorTimeout !== void 0 && {
       executorTimeout: toolConfig.executorTimeout
     },
@@ -6007,6 +6032,9 @@ function clientToolToCompletionsFormat(tool) {
     ...toolConfig.removeAfterExecution !== void 0 && {
       removeAfterExecution: toolConfig.removeAfterExecution
     },
+    ...toolConfig.removeAfterResult !== void 0 && {
+      removeAfterResult: toolConfig.removeAfterResult
+    },
     ...toolConfig.executorTimeout !== void 0 && {
       executorTimeout: toolConfig.executorTimeout
     },
@@ -6941,6 +6969,7 @@ function toolsToApiFormat(tools, apiType) {
       executor: _executor,
       skipContinuation: _skipContinuation,
       removeAfterExecution: _removeAfterExecution,
+      removeAfterResult: _removeAfterResult,
       executorTimeout: _executorTimeout,
       dependsOn: _dependsOn,
       deAnonymizeArgs: _deAnonymizeArgs,
@@ -9385,9 +9414,11 @@ Executing tool: ${toolInfo}
       }
       if (tools && apiTools) {
         const successfullyExecutedNames = /* @__PURE__ */ new Set();
+        const successfulResults = [];
         for (const r of executionResults) {
           if (!r.error && !isToolErrorResult(r.result) && "name" in r && r.name) {
             successfullyExecutedNames.add(r.name);
+            successfulResults.push(r.result);
           }
         }
         if (successfullyExecutedNames.size > 0) {
@@ -9396,7 +9427,15 @@ Executing tool: ${toolInfo}
             const tc = t;
             const func = tc.function;
             const toolName = typeof func?.name === "string" ? func.name : typeof tc.name === "string" ? tc.name : void 0;
-            if (tc.removeAfterExecution === true && toolName && successfullyExecutedNames.has(toolName)) {
+            if (!toolName) continue;
+            const removeAfterResult = tc.removeAfterResult;
+            if (tc.removeAfterExecution === true && successfullyExecutedNames.has(toolName) || typeof removeAfterResult === "function" && successfulResults.some((result) => {
+              try {
+                return removeAfterResult(result);
+              } catch {
+                return false;
+              }
+            })) {
               toolsToRemove.add(toolName);
             }
           }
@@ -13237,7 +13276,7 @@ async function getMemoriesNeedingTopicExtractionOp(ctx, options) {
     const id = raw.id;
     const topics = parseTopics(raw.topics);
     const linked = linkedNames.get(id);
-    if (topics !== null && topics.length > 0 && linksDivergeFromTopics(topics, linked ?? /* @__PURE__ */ new Set())) {
+    if (topics !== null && linksDivergeFromTopics(topics, linked ?? /* @__PURE__ */ new Set())) {
       topicsToRelinkAll.push(id);
       continue;
     }
@@ -13331,18 +13370,20 @@ async function relinkMemoryTopicsOp(ctx, memoryIds) {
   }
   const relinked = [];
   for (const id of Array.from(new Set(memoryIds))) {
-    let record;
     try {
-      record = await ctx.vaultMemoryCollection.find(id);
-    } catch {
-      continue;
-    }
-    if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) continue;
-    const topics = parseTopics(record.topics);
-    if (topics === null || topics.length === 0) continue;
-    try {
-      await relinkMemoryEntitiesFromTopicsOp(entityCtx, id, topics);
-      relinked.push(id);
+      await ctx.database.write(async (writer) => {
+        let record;
+        try {
+          record = await ctx.vaultMemoryCollection.find(id);
+        } catch {
+          return;
+        }
+        if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return;
+        const topics = parseTopics(record.topics);
+        if (topics === null) return;
+        await writer.callWriter(() => relinkMemoryEntitiesFromTopicsOp(entityCtx, id, topics));
+        relinked.push(id);
+      });
     } catch (err) {
       getLogger().warn("[memory/topics] relink failed", err);
     }
@@ -21397,14 +21438,14 @@ async function autoFilterClientTools(clientTools, promptEmbeddings, cache, embed
   const alwaysInclude = clientTools.filter(isAlwaysIncluded);
   const filterCandidates = clientTools.filter((t) => !isAlwaysIncluded(t));
   if (filterCandidates.length === 0) {
-    return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set() };
+    return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set(), matchedSetNames: /* @__PURE__ */ new Set() };
   }
   if (!promptEmbeddings && noEmbeddingsReason === "error") {
-    return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set() };
+    return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set(), matchedSetNames: /* @__PURE__ */ new Set() };
   }
   if (!promptEmbeddings) {
     if (activeToolSets.length === 0) {
-      return { tools: [], activatedSetNames: /* @__PURE__ */ new Set() };
+      return { tools: [], activatedSetNames: /* @__PURE__ */ new Set(), matchedSetNames: /* @__PURE__ */ new Set() };
     }
     const allSets = extraToolSets.length > 0 ? [...BUILT_IN_TOOL_SETS, ...extraToolSets] : BUILT_IN_TOOL_SETS;
     const activeSets = allSets.filter((s) => activeToolSets.includes(s.name));
@@ -21414,7 +21455,8 @@ async function autoFilterClientTools(clientTools, promptEmbeddings, cache, embed
         ...alwaysInclude,
         ...filterCandidates.filter((t) => stickyMembers.has(getToolName2(t)))
       ],
-      activatedSetNames: new Set(activeSets.map((s) => s.name))
+      activatedSetNames: new Set(activeSets.map((s) => s.name)),
+      matchedSetNames: /* @__PURE__ */ new Set()
     };
   }
   const toolsNeedingEmbeddings = [];
@@ -21432,7 +21474,7 @@ async function autoFilterClientTools(clientTools, promptEmbeddings, cache, embed
         cache.set(toolsNeedingEmbeddings[i].name, embeddings[i]);
       }
     } catch {
-      return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set() };
+      return { tools: clientTools, activatedSetNames: /* @__PURE__ */ new Set(), matchedSetNames: /* @__PURE__ */ new Set() };
     }
   }
   const pseudoServerTools = [];
@@ -21478,16 +21520,171 @@ async function autoFilterClientTools(clientTools, promptEmbeddings, cache, embed
     activeSetNames
   );
   const activatedSetNames = activatedToolSetNames(scores, toolSets, activeSetNames);
+  const matchedSetNames = activatedToolSetNames(scores, toolSets);
   if (finalNames.size === 0) {
-    return { tools: alwaysInclude, activatedSetNames };
+    return { tools: alwaysInclude, activatedSetNames, matchedSetNames };
   }
   const filtered = filterCandidates.filter((t) => {
     const name = getToolName2(t);
     return name && finalNames.has(name);
   });
-  return { tools: [...alwaysInclude, ...filtered], activatedSetNames };
+  return { tools: [...alwaysInclude, ...filtered], activatedSetNames, matchedSetNames };
+}
+
+// src/lib/tools/toolCatalog.ts
+var TOOL_CATALOG = {
+  // Gmail (src/tools/gmail.ts)
+  gmail_search_messages: { label: "Search emails", provider: "gmail", connector: "Gmail" },
+  gmail_get_message: { label: "Read an email", provider: "gmail", connector: "Gmail" },
+  gmail_create_draft: { label: "Draft a reply", provider: "gmail", connector: "Gmail" },
+  gmail_send_message: { label: "Send an email", provider: "gmail", connector: "Gmail" },
+  // Google Calendar (src/tools/googleCalendar.ts)
+  google_calendar_list_events: {
+    label: "Search calendar events",
+    provider: "gcalendar",
+    connector: "Calendar"
+  },
+  google_calendar_create_event: {
+    label: "Create calendar event",
+    provider: "gcalendar",
+    connector: "Calendar"
+  },
+  google_calendar_update_event: {
+    label: "Update calendar event",
+    provider: "gcalendar",
+    connector: "Calendar"
+  },
+  // Google Drive (src/tools/googleDrive.ts)
+  google_drive_search: { label: "Search files", provider: "gdrive", connector: "Drive" },
+  google_drive_list_recent: { label: "List recent files", provider: "gdrive", connector: "Drive" },
+  google_drive_get_content: { label: "Read file content", provider: "gdrive", connector: "Drive" },
+  google_drive_create_file: {
+    label: "Create a file in Drive",
+    provider: "gdrive",
+    connector: "Drive"
+  },
+  google_drive_update_file: {
+    label: "Update a Drive file",
+    provider: "gdrive",
+    connector: "Drive"
+  },
+  // Notion (src/tools/notion.ts)
+  "notion-search": { label: "Search", provider: "notion", connector: "Notion" },
+  "notion-fetch": { label: "Read page", provider: "notion", connector: "Notion" },
+  "notion-create-pages": { label: "Create page", provider: "notion", connector: "Notion" },
+  "notion-update-page": { label: "Update page", provider: "notion", connector: "Notion" },
+  "notion-move-pages": { label: "Move pages", provider: "notion", connector: "Notion" },
+  "notion-duplicate-page": { label: "Duplicate page", provider: "notion", connector: "Notion" },
+  "notion-create-database": { label: "Create database", provider: "notion", connector: "Notion" },
+  "notion-update-data-source": {
+    label: "Update data source",
+    provider: "notion",
+    connector: "Notion"
+  },
+  "notion-create-comment": { label: "Add a comment", provider: "notion", connector: "Notion" },
+  "notion-get-comments": { label: "Read comments", provider: "notion", connector: "Notion" },
+  "notion-get-users": {
+    label: "List workspace members",
+    provider: "notion",
+    connector: "Notion"
+  },
+  "notion-get-teams": { label: "List teamspaces", provider: "notion", connector: "Notion" },
+  // GitHub (src/tools/github.ts)
+  github_api: { label: "Use GitHub", provider: "github", connector: "GitHub" },
+  github_get_authenticated_user: {
+    label: "Read GitHub profile",
+    provider: "github",
+    connector: "GitHub"
+  },
+  // X / Twitter (src/tools/x.ts)
+  x_get_me: { label: "Get my X profile", provider: "x", connector: "X" },
+  x_get_my_posts: { label: "Read my recent posts", provider: "x", connector: "X" },
+  // Dropbox (src/tools/dropbox.ts)
+  dropbox_list_folders: { label: "List files", provider: "dropbox", connector: "Dropbox" },
+  dropbox_get_file_content: {
+    label: "Read file content",
+    provider: "dropbox",
+    connector: "Dropbox"
+  },
+  dropbox_search: { label: "Search files", provider: "dropbox", connector: "Dropbox" },
+  // Slack (src/tools/slack.ts)
+  slack_get_me: { label: "Get my Slack profile", provider: "slack", connector: "Slack" },
+  slack_list_channels: { label: "List channels", provider: "slack", connector: "Slack" },
+  slack_list_dms: { label: "List direct messages", provider: "slack", connector: "Slack" },
+  slack_search_messages: { label: "Search messages", provider: "slack", connector: "Slack" },
+  slack_list_users: { label: "List members", provider: "slack", connector: "Slack" },
+  slack_get_channel_history: {
+    label: "Read channel history",
+    provider: "slack",
+    connector: "Slack"
+  },
+  slack_get_thread_replies: {
+    label: "Read thread replies",
+    provider: "slack",
+    connector: "Slack"
+  },
+  slack_post_message: { label: "Post a message", provider: "slack", connector: "Slack" }
+};
+
+// src/lib/tools/selection/activeToolSets.ts
+function mergeActiveToolSets(current, derived) {
+  if (derived.length === 0) return current;
+  const merged = Array.from(/* @__PURE__ */ new Set([...current, ...derived]));
+  return merged.length === current.length ? current : merged;
 }
 
+// src/lib/tools/selection/recentToolSets.ts
+var RECENT_TOOL_SET_TURNS = 2;
+var RECENT_TOOL_SET_CONVERSATION_LIMIT = 50;
+var CARRYABLE_TOOL_SETS = new Set(
+  BUILT_IN_TOOL_SETS.filter(
+    (s) => s.anchors.length > 0 && s.anchors.every((a) => a in TOOL_CATALOG)
+  ).map((s) => s.name)
+);
+var recentToolSets = /* @__PURE__ */ new WeakMap();
+function touch(conversations, conversationId) {
+  const turns = conversations.get(conversationId);
+  if (!turns) return void 0;
+  conversations.delete(conversationId);
+  conversations.set(conversationId, turns);
+  return turns;
+}
+function carriedToolSets(database, conversationId) {
+  if (!conversationId) return [];
+  const conversations = recentToolSets.get(database);
+  if (!conversations) return [];
+  return [...touch(conversations, conversationId)?.keys() ?? []];
+}
+function recordToolSetTurn(database, conversationId, matched) {
+  if (!conversationId) return;
+  let conversations = recentToolSets.get(database);
+  if (!conversations) {
+    conversations = /* @__PURE__ */ new Map();
+    recentToolSets.set(database, conversations);
+  }
+  const turns = touch(conversations, conversationId) ?? /* @__PURE__ */ new Map();
+  for (const [name, left] of turns) {
+    if (left > 1) turns.set(name, left - 1);
+    else turns.delete(name);
+  }
+  for (const name of matched) {
+    if (CARRYABLE_TOOL_SETS.has(name)) turns.set(name, RECENT_TOOL_SET_TURNS);
+  }
+  if (turns.size === 0) {
+    conversations.delete(conversationId);
+    return;
+  }
+  conversations.set(conversationId, turns);
+  if (conversations.size > RECENT_TOOL_SET_CONVERSATION_LIMIT) {
+    const oldest = conversations.keys().next().value;
+    if (oldest !== void 0) conversations.delete(oldest);
+  }
+}
+function resetRecentToolSets() {
+  recentToolSets = /* @__PURE__ */ new WeakMap();
+}
+onClearAllEncryptionState(resetRecentToolSets);
+
 // src/expo/useChatStorage.ts
 var CONVERSATION_REDACTOR_LIMIT = 50;
 var NO_CONVERSATION_KEY = "__no_conversation__";
@@ -22367,6 +22564,7 @@ function useChatStorage(options) {
         }
         let narrowedClientTools2 = clientTools;
         let clientActivatedSetNames2;
+        let matchedToolSets2 = /* @__PURE__ */ new Set();
         if (clientTools?.length) {
           try {
             if (!skipUserEmbedding && getTokenRef.current && messageContent.length >= MIN_CONTENT_LENGTH_FOR_TOOLS) {
@@ -22387,17 +22585,25 @@ function useChatStorage(options) {
                 narrowedClientTools2 = clientTools.filter((t) => keep.has(getToolName2(t)));
               }
             } else if (getTokenRef.current) {
-              const { tools: autoTools, activatedSetNames } = await autoFilterClientTools(
+              const {
+                tools: autoTools,
+                activatedSetNames,
+                matchedSetNames
+              } = await autoFilterClientTools(
                 clientTools,
                 skipUserEmbedding ?? null,
                 clientToolFilterCache,
                 { getToken: getTokenRef.current, baseUrl, model: embeddingModel },
                 extraToolSets ?? [],
-                activeToolSetsRef.current ?? [],
+                mergeActiveToolSets(
+                  activeToolSetsRef.current ?? [],
+                  carriedToolSets(database, currentConversationId)
+                ),
                 skipEmbeddingFailed ? "error" : "short-prompt"
               );
               narrowedClientTools2 = autoTools;
               clientActivatedSetNames2 = activatedSetNames;
+              matchedToolSets2 = matchedSetNames;
             }
           } catch (error) {
             getLogger().warn("[useChatStorage] client tool filtering failed (skipStorage):", error);
@@ -22449,6 +22655,7 @@ function useChatStorage(options) {
           headers
         });
         if ("detached" in result2 && result2.detached) {
+          recordToolSetTurn(database, currentConversationId, matchedToolSets2);
           return {
             data: result2.data,
             error: result2.error,
@@ -22462,6 +22669,7 @@ function useChatStorage(options) {
             error: result2.error || "Unknown error"
           };
         }
+        recordToolSetTurn(database, currentConversationId, matchedToolSets2);
         const skipRefreshGetToken = getTokenRef.current;
         const skipRefreshData = result2.data;
         if (skipRefreshGetToken) {
@@ -22677,6 +22885,7 @@ function useChatStorage(options) {
       }
       let narrowedClientTools = clientTools;
       let clientActivatedSetNames;
+      let matchedToolSets = /* @__PURE__ */ new Set();
       if (clientTools?.length) {
         try {
           if (!userMessageEmbedding && getTokenRef.current && contentForStorage.length >= MIN_CONTENT_LENGTH_FOR_TOOLS) {
@@ -22693,17 +22902,25 @@ function useChatStorage(options) {
               narrowedClientTools = clientTools.filter((t) => keep.has(getToolName2(t)));
             }
           } else if (getTokenRef.current) {
-            const { tools: autoTools, activatedSetNames } = await autoFilterClientTools(
+            const {
+              tools: autoTools,
+              activatedSetNames,
+              matchedSetNames
+            } = await autoFilterClientTools(
               clientTools,
               userMessageEmbedding ?? null,
               clientToolFilterCache,
               { getToken: getTokenRef.current, baseUrl, model: embeddingModel },
               extraToolSets ?? [],
-              activeToolSetsRef.current ?? [],
+              mergeActiveToolSets(
+                activeToolSetsRef.current ?? [],
+                carriedToolSets(database, convId)
+              ),
               userMessageEmbeddingFailed ? "error" : "short-prompt"
             );
             narrowedClientTools = autoTools;
             clientActivatedSetNames = activatedSetNames;
+            matchedToolSets = matchedSetNames;
           }
           mergedTools = filteredServerTools.length > 0 || (narrowedClientTools?.length ?? 0) > 0 ? mergeTools(
             filteredServerTools,
@@ -22790,6 +23007,7 @@ function useChatStorage(options) {
       const responseDuration = (Date.now() - startTime) / 1e3;
       const detachedResult = result;
       if (detachedResult.detached) {
+        recordToolSetTurn(database, convId, matchedToolSets);
         const rowId = effectiveAssistantUniqueId ?? `msg_${(0, import_uuid5.v7)()}`;
         pendingResumeRef.current = {
           handle: detachedResult.resume ?? null,
@@ -22858,6 +23076,7 @@ function useChatStorage(options) {
               ],
               usage: void 0
             };
+            recordToolSetTurn(database, convId, matchedToolSets);
             return {
               data: responseData2,
               error: null,
@@ -22896,6 +23115,7 @@ function useChatStorage(options) {
           userMessage: { ...storedUserMessage, error: errorMessage }
         };
       }
+      recordToolSetTurn(database, convId, matchedToolSets);
       const responseData = result.data;
       let assistantContent = "";
       let thinkingContent;

package/dist/expo/index.d.mts

@@ -2209,6 +2209,21 @@ type ToolConfig = LlmapiChatCompletionTool & {
      * execution fails, allowing the model to retry.
      */
     removeAfterExecution?: boolean;
+    /**
+     * Remove this tool for the rest of the turn once ANY tool returns a
+     * successful result this predicate accepts — its own or another's. Errors
+     * never count, as for `removeAfterExecution`.
+     *
+     * Only results of tools executed on this client are offered; tools the
+     * portal runs server-side never reach the predicate. A predicate that throws
+     * is treated as not matching.
+     *
+     * For a family of tools that has to leave together: when one of them
+     * declines an out-of-scope request, the model otherwise works through its
+     * siblings round after round until the round cap. Give every member the same
+     * predicate and the first refusal removes the whole family.
+     */
+    removeAfterResult?: (result: unknown) => boolean;
     /**
      * Timeout in milliseconds for this tool's executor.
      * Overrides the default 30-second timeout.
@@ -3512,6 +3527,7 @@ type MessageFeedback = "like" | "dislike" | null;
  * - `tool_result`: the hidden `[Tool Execution Results]` row built from a
  *   turn's auto-executed tool results. Skipped by the embedding sweep (see
  *   `memoryEngine/embeddings`) AND hidden from the transcript.
+ * - `message`: an ordinary message with an index after explicit repair.
  * - `chunks_discarded`: an ordinary, still-rendered message whose chunk vectors
  *   were built over `enc:v3:` ciphertext (sdk#864) and have been discarded
  *   rather than re-embedded at the user's own expense (client#5618). Skipped by
@@ -3524,7 +3540,7 @@ type MessageFeedback = "like" | "dislike" | null;
  * encrypted flag would be unreadable exactly where it matters and the skip
  * would fail open.
  */
-type MessageOrigin = "tool_result" | "chunks_discarded";
+type MessageOrigin = "tool_result" | "chunks_discarded" | "message";
 /**
  * Metadata for files attached to messages.
  *
@@ -7299,7 +7315,8 @@ declare function stampTopicsExtractedAtOp(ctx: VaultMemoryOperationsContext, mem
  * `topics_user_managed` in particular is left exactly as it arrived, so the
  * autotagger stays off a curated memory whose links this just restored.
  *
- * Skips deleted, foreign-user, and record-less rows. Returns the ids relinked.
+ * Skips deleted rows, foreign-user rows, and rows with null topics.
+ * Empty topics remove stale links. Returns the relinked IDs.
  */
 declare function relinkMemoryTopicsOp(ctx: VaultMemoryOperationsContext, memoryIds: readonly string[]): Promise<string[]>;
 /**
@@ -9756,14 +9773,10 @@ declare function generateEmbeddings(texts: string[], options: EmbeddingOptions):
  * re-index. Off by default, so no background pass can spend a user's credits
  * without being asked to.
  *
- * That flag opens the gate for one call and nothing more. It does not heal the
- * row: a message that re-indexes successfully still carries `chunks_discarded`
- * afterwards, so the next pass skips it again unless that pass sets the flag
- * too. An embedding-model migration is where this bites. It reaches this gate
- * before it can do anything, so the repaired rows stay on the old model, and
- * `searchChunksOp` already drops stale-model vectors — they go quiet with
- * nothing telling them apart from rows that were never repaired. Clearing the
- * marker on a successful re-index is the real fix, tracked in #879.
+ * A successful repair replaces the marker with `message` in the index write.
+ * The new marker preserves ordinary message provenance during chat replay.
+ * Later model migrations can then include the repaired row without this flag.
+ * Failed embedding requests and empty index data do not clear the marker.
  *
  * `satisfies MessageOrigin` so the constant and the union cannot drift apart
  * silently — the column's type is the union, and a typo here would otherwise
@@ -9800,9 +9813,8 @@ declare function embedAllMessages(ctx: StorageOperationsContext, options: Embedd
      * to an explicit user action, never to a background pass. Opens that marker
      * only — `tool_result` rows stay excluded.
      *
-     * Per call, not a state change: a row that re-indexes successfully keeps its
-     * marker, so a later pass that omits this flag skips it again. See
-     * {@link CHUNKS_DISCARDED_ORIGIN}.
+     * A successful repair clears the marker. Later model migrations include
+     * the repaired row without this flag. See {@link CHUNKS_DISCARDED_ORIGIN}.
      */
     reembedDiscarded?: boolean;
 }): Promise<number>;
@@ -9860,9 +9872,8 @@ declare function chunkAndEmbedAllMessages(ctx: StorageOperationsContext, options
      * chunks nor vector, so it never reaches that check and falls straight to the
      * origin gate.
      *
-     * Per call, not a state change: a row that re-indexes successfully keeps its
-     * marker, so a later pass that omits this flag skips it again. See
-     * {@link CHUNKS_DISCARDED_ORIGIN}.
+     * A successful repair clears the marker. Later model migrations include
+     * the repaired row without this flag. See {@link CHUNKS_DISCARDED_ORIGIN}.
      */
     reembedDiscarded?: boolean;
 }): Promise<number>;