@anuma/sdk 6.30.1 → 6.31.0

package/dist/server/index.cjs

@@ -14957,10 +14957,23 @@ var require_stepsForMigration = __commonJS({
 });
 
 // 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 getLogger() {
-  return currentLogger;
+  return getLoggerState().logger;
 }
-var consoleLogger, currentLogger;
+var consoleLogger, LOGGER_STATE_KEY, loggerGlobal, fallbackLoggerState, fallbackWarned;
 var init_logger = __esm({
   "src/lib/logger.ts"() {
     "use strict";
@@ -14970,7 +14983,10 @@ var init_logger = __esm({
       warn: console.warn.bind(console),
       error: console.error.bind(console)
     };
-    currentLogger = consoleLogger;
+    LOGGER_STATE_KEY = /* @__PURE__ */ Symbol.for("@anuma/sdk/logger/v1");
+    loggerGlobal = globalThis;
+    fallbackLoggerState = { logger: consoleLogger };
+    fallbackWarned = false;
   }
 });
 
@@ -15076,9 +15092,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.`
   );
@@ -15123,14 +15147,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();
@@ -15155,7 +15185,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;
@@ -15307,6 +15340,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 {
@@ -15392,6 +15432,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);
@@ -20787,6 +20830,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);
     });
   });
@@ -20803,6 +20849,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);
     });
   });
@@ -22838,7 +22887,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;
     }
@@ -22932,18 +22981,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);
     }
@@ -32417,6 +32468,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 {
@@ -32425,6 +32498,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")));
 }
@@ -32575,6 +32658,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);
@@ -32701,37 +32788,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);
@@ -35625,6 +35725,7 @@ function toolsToApiFormat(tools, apiType) {
       executor: _executor,
       skipContinuation: _skipContinuation,
       removeAfterExecution: _removeAfterExecution,
+      removeAfterResult: _removeAfterResult,
       executorTimeout: _executorTimeout,
       dependsOn: _dependsOn,
       deAnonymizeArgs: _deAnonymizeArgs,
@@ -38069,9 +38170,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) {
@@ -38080,7 +38183,15 @@ Executing tool: ${toolInfo}
             const tc = t;
             const func = tc.function;
             const toolName2 = typeof func?.name === "string" ? func.name : typeof tc.name === "string" ? tc.name : void 0;
-            if (tc.removeAfterExecution === true && toolName2 && successfullyExecutedNames.has(toolName2)) {
+            if (!toolName2) continue;
+            const removeAfterResult = tc.removeAfterResult;
+            if (tc.removeAfterExecution === true && successfullyExecutedNames.has(toolName2) || typeof removeAfterResult === "function" && successfulResults.some((result) => {
+              try {
+                return removeAfterResult(result);
+              } catch {
+                return false;
+              }
+            })) {
               toolsToRemove.add(toolName2);
             }
           }

package/dist/server/index.d.mts

@@ -2706,6 +2706,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.
@@ -3546,6 +3561,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
@@ -3558,7 +3574,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.
  *
@@ -4988,7 +5004,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
@@ -6338,7 +6359,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}).
      *
@@ -7113,7 +7136,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[]>;
 /**
@@ -8089,9 +8113,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>;
@@ -8149,9 +8172,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>;
@@ -9768,7 +9790,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}).
      */

package/dist/server/index.d.ts

@@ -2706,6 +2706,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.
@@ -3546,6 +3561,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
@@ -3558,7 +3574,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.
  *
@@ -4988,7 +5004,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
@@ -6338,7 +6359,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}).
      *
@@ -7113,7 +7136,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[]>;
 /**
@@ -8089,9 +8113,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>;
@@ -8149,9 +8172,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>;
@@ -9768,7 +9790,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}).
      */