@anuma/sdk 6.30.1 → 6.31.0

package/dist/expo/{chunk-N5CKISI3.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
@@ -726,13 +742,21 @@ function responsesExtra(extra) {
   }
   return out;
 }
+function splitEndpoint(endpoint) {
+  const cut = endpoint.search(/[?#]/);
+  const rawPath = cut === -1 ? endpoint : endpoint.slice(0, cut);
+  return {
+    path: rawPath.replace(/\/+$/, ""),
+    rest: cut === -1 ? "" : endpoint.slice(cut)
+  };
+}
 var FOREIGN_ENDPOINT_SUFFIX = {
   chat: "/responses",
   responses: "/chat/completions"
 };
 function assertTransportMatchesEndpoint(transport, endpoint) {
   const foreign = FOREIGN_ENDPOINT_SUFFIX[transport];
-  if (!endpoint.endsWith(foreign)) return;
+  if (!splitEndpoint(endpoint).path.endsWith(foreign)) return;
   throw new Error(
     `endpointOverride "${endpoint}" is the other transport's endpoint, but transport is "${transport}". The request body is built for the transport, so this sends the wrong shape and 400s without retry.`
   );
@@ -778,14 +802,20 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
-  let endpoint = req.transport === "responses" ? "/api/v1/responses" : "/api/v1/chat/completions";
+  const transport = req.transport ?? (requiresResponsesTransport(req.model) ? "responses" : "chat");
+  const autoUpgraded = req.transport === void 0 && transport === "responses";
+  let endpoint = transport === "responses" ? "/api/v1/responses" : "/api/v1/chat/completions";
   if (req.endpointOverride !== void 0) {
     const overrideValidation = validateEndpointOverride(req.endpointOverride);
     if (!overrideValidation.valid) {
       throw new Error(overrideValidation.message);
     }
     endpoint = overrideValidation.endpoint;
-    assertTransportMatchesEndpoint(req.transport ?? "chat", endpoint);
+    const { path, rest } = splitEndpoint(endpoint);
+    if (autoUpgraded && path.endsWith("/chat/completions")) {
+      endpoint = `${path.slice(0, -"/chat/completions".length)}/responses${rest}`;
+    }
+    assertTransportMatchesEndpoint(transport, endpoint);
   }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
@@ -810,7 +840,10 @@ async function callPortalJsonCompletion(req) {
       ),
       ...reinforce && { reinforceJsonContract: true }
     } : reinforce ? { ...req, reinforceJsonContract: true } : req;
-    const outcome = await attemptPortalJson(attemptReq, endpoint);
+    const outcome = await attemptPortalJson(
+      { ...attemptReq, transport },
+      endpoint
+    );
     if (outcome.kind === "ok") {
       req.onAttempt?.({ attempt, ok: true });
       return outcome.value;
@@ -962,6 +995,13 @@ async function attemptPortalJson(req, endpoint) {
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
+  if (isModerationResponse(body)) {
+    return {
+      kind: "terminal",
+      code: "content-flagged",
+      reason: "portal moderation refused the request"
+    };
+  }
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
     return {
@@ -1047,6 +1087,9 @@ function logPortalUsage(body, tag) {
   } catch {
   }
 }
+function isModerationResponse(body) {
+  return typeof body === "object" && body !== null && body.id === "moderation";
+}
 function extractCompletionContent(body) {
   if (typeof body !== "object" || body === null) return null;
   const responsesText = extractResponsesContent(body);

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

@@ -2,7 +2,7 @@ import {
   callPortalJsonCompletion,
   notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-N5CKISI3.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;
   }
 });
 
@@ -828,9 +844,17 @@ function responsesExtra(extra) {
   }
   return out;
 }
+function splitEndpoint(endpoint) {
+  const cut = endpoint.search(/[?#]/);
+  const rawPath = cut === -1 ? endpoint : endpoint.slice(0, cut);
+  return {
+    path: rawPath.replace(/\/+$/, ""),
+    rest: cut === -1 ? "" : endpoint.slice(cut)
+  };
+}
 function assertTransportMatchesEndpoint(transport, endpoint) {
   const foreign = FOREIGN_ENDPOINT_SUFFIX[transport];
-  if (!endpoint.endsWith(foreign)) return;
+  if (!splitEndpoint(endpoint).path.endsWith(foreign)) return;
   throw new Error(
     `endpointOverride "${endpoint}" is the other transport's endpoint, but transport is "${transport}". The request body is built for the transport, so this sends the wrong shape and 400s without retry.`
   );
@@ -875,14 +899,20 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
-  let endpoint = req.transport === "responses" ? "/api/v1/responses" : "/api/v1/chat/completions";
+  const transport = req.transport ?? (requiresResponsesTransport(req.model) ? "responses" : "chat");
+  const autoUpgraded = req.transport === void 0 && transport === "responses";
+  let endpoint = transport === "responses" ? "/api/v1/responses" : "/api/v1/chat/completions";
   if (req.endpointOverride !== void 0) {
     const overrideValidation = validateEndpointOverride(req.endpointOverride);
     if (!overrideValidation.valid) {
       throw new Error(overrideValidation.message);
     }
     endpoint = overrideValidation.endpoint;
-    assertTransportMatchesEndpoint(req.transport ?? "chat", endpoint);
+    const { path, rest } = splitEndpoint(endpoint);
+    if (autoUpgraded && path.endsWith("/chat/completions")) {
+      endpoint = `${path.slice(0, -"/chat/completions".length)}/responses${rest}`;
+    }
+    assertTransportMatchesEndpoint(transport, endpoint);
   }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
@@ -907,7 +937,10 @@ async function callPortalJsonCompletion(req) {
       ),
       ...reinforce && { reinforceJsonContract: true }
     } : reinforce ? { ...req, reinforceJsonContract: true } : req;
-    const outcome = await attemptPortalJson(attemptReq, endpoint);
+    const outcome = await attemptPortalJson(
+      { ...attemptReq, transport },
+      endpoint
+    );
     if (outcome.kind === "ok") {
       req.onAttempt?.({ attempt, ok: true });
       return outcome.value;
@@ -1059,6 +1092,13 @@ async function attemptPortalJson(req, endpoint) {
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
+  if (isModerationResponse(body)) {
+    return {
+      kind: "terminal",
+      code: "content-flagged",
+      reason: "portal moderation refused the request"
+    };
+  }
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
     return {
@@ -1144,6 +1184,9 @@ function logPortalUsage(body, tag) {
   } catch {
   }
 }
+function isModerationResponse(body) {
+  return typeof body === "object" && body !== null && body.id === "moderation";
+}
 function extractCompletionContent(body) {
   if (typeof body !== "object" || body === null) return null;
   const responsesText = extractResponsesContent(body);
@@ -3707,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);
     });
   });
@@ -3723,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);
     });
   });
@@ -5947,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
     },
@@ -5980,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
     },
@@ -6914,6 +6969,7 @@ function toolsToApiFormat(tools, apiType) {
       executor: _executor,
       skipContinuation: _skipContinuation,
       removeAfterExecution: _removeAfterExecution,
+      removeAfterResult: _removeAfterResult,
       executorTimeout: _executorTimeout,
       dependsOn: _dependsOn,
       deAnonymizeArgs: _deAnonymizeArgs,
@@ -9358,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) {
@@ -9369,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);
             }
           }
@@ -13210,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;
     }
@@ -13304,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);
     }
@@ -20269,6 +20337,28 @@ var BatchFailureError = class extends Error {
     this.terminal = terminal;
   }
 };
+var FlaggedBatchError = class extends Error {
+};
+function extracted(result) {
+  return result.failedCount === 0 && result.outcome !== "empty-after-retry";
+}
+function batchError(result) {
+  const failure = result.failure;
+  if (failure?.reason === "http-terminal") {
+    const status = failure.httpStatus;
+    if (status !== void 0 && REQUEST_REJECTED_STATUSES.has(status))
+      return new BatchFailureError(
+        `Extraction rejected the batch (HTTP ${status}); not retried this session`,
+        true
+      );
+    return new AccountFailureError(
+      `Extraction refused for the account (HTTP ${status ?? "unknown"}); retried next session`
+    );
+  }
+  if (result.failedCount > 0 || failure !== void 0 && CONTENT_FAILURE_REASONS.has(failure.reason))
+    return new BatchFailureError("Extraction batch incomplete; retained for retry", false);
+  return new Error("Extraction batch incomplete; retained for retry");
+}
 var AccountFailureError = class extends Error {
 };
 var LockedSourcesError = class extends Error {
@@ -20277,6 +20367,16 @@ var LockedSourcesError = class extends Error {
     this.persistentIds = persistentIds;
   }
 };
+function splitTurns(messages) {
+  const turns = [];
+  for (const message of messages) {
+    const last = turns[turns.length - 1];
+    if (!last || message.role === "user" && last.some((m) => m.role === "user"))
+      turns.push([message]);
+    else last.push(message);
+  }
+  return turns;
+}
 function idsOf(job) {
   return JSON.parse(String(job._getRaw("message_ids")));
 }
@@ -20427,6 +20527,10 @@ function createDurableAutoExtractor(options) {
       skippedThisSession.add(job.id);
       return false;
     }
+    if (error instanceof FlaggedBatchError) {
+      await acknowledge(job, ids, loaded, true);
+      return true;
+    }
     const counted = error instanceof BatchFailureError || error instanceof LockedSourcesError && error.persistentIds.length > 0;
     if (!counted) return false;
     const prior = sessionFailures.get(job.id);
@@ -20553,37 +20657,50 @@ function createDurableAutoExtractor(options) {
           const messages = loaded.flatMap(
             (m) => m && m.conversationId === conversationId && (m.role === "user" || m.role === "assistant") ? [{ id: m.uniqueId, role: m.role, content: m.content }] : []
           );
-          let success = messages.length === 0;
-          let result;
-          if (messages.length) {
-            result = await extractBatch(
-              messages,
+          const jobScope = currentScope() === "private" ? "private" : String(job._getRaw("scope"));
+          const jobFolderId = job._getRaw("folder_id") ?? null;
+          const runExtraction = async (batch, batchIds) => {
+            const result = await extractBatch(
+              batch,
               conversationId,
-              ids,
-              currentScope() === "private" ? "private" : String(job._getRaw("scope")),
-              job._getRaw("folder_id") ?? null
+              batchIds,
+              jobScope,
+              jobFolderId
             );
-            success = result.failedCount === 0 && result.outcome !== "empty-after-retry";
             options.onTurnComplete?.(result);
-          }
-          if (!success) {
-            const failure = result?.failure;
-            if (failure?.reason === "http-terminal") {
-              const status = failure.httpStatus;
-              if (status !== void 0 && REQUEST_REJECTED_STATUSES.has(status))
-                throw new BatchFailureError(
-                  `Extraction rejected the batch (HTTP ${status}); not retried this session`,
-                  true
+            return result;
+          };
+          const flaggedIds = /* @__PURE__ */ new Set();
+          if (messages.length) {
+            const result = await runExtraction(messages, ids);
+            if (result.failure?.reason === "content-flagged") {
+              const turns = splitTurns(messages);
+              if (turns.length < 2)
+                throw new FlaggedBatchError("Extraction batch refused by moderation; abandoned");
+              for (const turn of turns) {
+                const turnResult = await runExtraction(
+                  turn,
+                  turn.map((m) => m.id)
                 );
-              throw new AccountFailureError(
-                `Extraction refused for the account (HTTP ${status ?? "unknown"}); retried next session`
-              );
-            }
-            if ((result?.failedCount ?? 0) > 0 || failure !== void 0 && CONTENT_FAILURE_REASONS.has(failure.reason))
-              throw new BatchFailureError("Extraction batch incomplete; retained for retry", false);
-            throw new Error("Extraction batch incomplete; retained for retry");
+                if (turnResult.failure?.reason === "content-flagged")
+                  for (const m of turn) flaggedIds.add(m.id);
+                else if (!extracted(turnResult)) throw batchError(turnResult);
+              }
+              if (flaggedIds.size)
+                reportError(
+                  new Error(
+                    `Dropped ${flaggedIds.size} source id(s) of an extraction batch refused by moderation`
+                  ),
+                  conversationId
+                );
+            } else if (!extracted(result)) throw batchError(result);
           }
-          await acknowledge(job, ids, loaded, false);
+          await acknowledge(
+            job,
+            ids,
+            loaded,
+            ids.slice(-2).some((id) => flaggedIds.has(id))
+          );
           scheduleAfterSuccess = true;
         } catch (error) {
           attempts.set(job.id, attempted + 1);
@@ -22241,10 +22358,10 @@ function useChatStorage(options) {
         let mergedTools2 = void 0;
         let filteredServerTools2 = [];
         const isServerToolsFunction2 = typeof serverToolsFilter === "function";
-        const extracted2 = extractUserMessageFromMessages(messages);
+        const extracted3 = extractUserMessageFromMessages(messages);
         const messageContent = resolveStoredUserContent(
           storedUserContent,
-          extracted2?.content ?? ""
+          extracted3?.content ?? ""
         );
         let skipUserEmbedding;
         let skipEmbeddingFailed = false;
@@ -22410,15 +22527,15 @@ function useChatStorage(options) {
           skipped: true
         };
       }
-      const extracted = extractUserMessageFromMessages(messages);
-      if (!extracted || !extracted.content && !extracted.files?.length) {
+      const extracted2 = extractUserMessageFromMessages(messages);
+      if (!extracted2 || !extracted2.content && !extracted2.files?.length) {
         return {
           data: null,
           error: "No user message found in messages array"
         };
       }
-      const contentForStorage = resolveStoredUserContent(storedUserContent, extracted.content);
-      const filesForStorage = files ?? extracted.files;
+      const contentForStorage = resolveStoredUserContent(storedUserContent, extracted2.content);
+      const filesForStorage = files ?? extracted2.files;
       let convId;
       try {
         convId = await ensureConversation();
@@ -22746,9 +22863,9 @@ function useChatStorage(options) {
       if (result.error || !result.data) {
         const abortedResult = result;
         if (abortedResult.error === "Request aborted") {
-          const extracted2 = abortedResult.data ? extractAssistantText(abortedResult.data) : { content: "", thinking: void 0 };
-          const assistantContent2 = extracted2.content;
-          const abortedThinkingContent = extracted2.thinking;
+          const extracted3 = abortedResult.data ? extractAssistantText(abortedResult.data) : { content: "", thinking: void 0 };
+          const assistantContent2 = extracted3.content;
+          const abortedThinkingContent = extracted3.thinking;
           const responseModel = abortedResult.data?.model || model || "";
           let storedAssistantMessage2;
           try {

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.
  *
@@ -5202,7 +5218,12 @@ type PortalLlmFailureReason =
 /** Content parsed to a literal `null`, which is never a valid response. */
  | "null-completion"
 /** `totalTimeoutMs` was spent before the next attempt could run. */
- | "time-budget-exhausted";
+ | "time-budget-exhausted"
+/**
+ * The portal's moderation gate refused the request. Terminal: the same input
+ * is flagged again on every retry. See {@link isModerationResponse}.
+ */
+ | "content-flagged";
 /**
  * One attempt of a {@link callPortalJsonCompletion} call, reported to
  * `onAttempt` as it settles — success included. The wire-level diagnostic the
@@ -6439,7 +6460,9 @@ interface ExtractFactsOptions extends PortalLlmAuth {
      * Optional per-call request path override, forwarded to
      * {@link callPortalJsonCompletion}. When set, the extraction call POSTs to
      * `baseUrl + endpointOverride` instead of the default
-     * `/api/v1/chat/completions` — path only, body unchanged. Lets callers route
+     * `/api/v1/chat/completions`. The body follows the transport, not the path: a
+     * model that needs the Responses API is moved from a `.../chat/completions`
+     * override to its sibling `.../responses` with a Responses-shaped body. Lets callers route
      * this internal-utility pass to a dedicated endpoint. Invalid values throw at
      * call time (see {@link validateEndpointOverride}).
      *
@@ -7292,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[]>;
 /**
@@ -9121,7 +9145,9 @@ interface TopicExtractOptions extends PortalLlmAuth {
      * Optional per-call request path override, forwarded to
      * {@link callPortalJsonCompletion}. When set, topic extraction POSTs to
      * `baseUrl + endpointOverride` instead of the default
-     * `/api/v1/chat/completions` — path only, body unchanged. Lets callers route
+     * `/api/v1/chat/completions`. The body follows the transport, not the path: a
+     * model that needs the Responses API is moved from a `.../chat/completions`
+     * override to its sibling `.../responses` with a Responses-shaped body. Lets callers route
      * this internal-utility pass to a dedicated endpoint. Invalid values throw at
      * call time (see {@link validateEndpointOverride}).
      */
@@ -9747,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
@@ -9791,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>;
@@ -9851,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>;