@anuma/sdk 3.11.5 → 3.12.0

package/dist/client/index.d.mts

@@ -2400,6 +2400,7 @@ type HandlersNonceResponse = {
 type HandlersNotificationDeviceResponse = {
     app_version?: string;
     id?: number;
+    locale?: string;
     platform?: string;
     token?: string;
 };
@@ -2572,6 +2573,11 @@ type HandlersRefreshRequest = {
 };
 type HandlersRegisterDeviceRequest = {
     app_version?: string;
+    /**
+     * Locale is the optional BCP-47 language tag of the device (e.g.
+     * "en-US"); used for announcement-campaign locale segmentation.
+     */
+    locale?: string;
     platform?: string;
     token?: string;
 };
@@ -8106,10 +8112,6 @@ type PostApiV1NotificationsDevicesErrors = {
      * Forbidden
      */
     403: ResponseErrorResponse;
-    /**
-     * Conflict
-     */
-    409: ResponseErrorResponse;
     /**
      * Internal Server Error
      */
@@ -10736,7 +10738,7 @@ declare const postApiV1Moderate: <ThrowOnError extends boolean = false>(options:
 /**
  * Register push-notification device
  *
- * Stores an Expo push token so the portal can later deliver push notifications to this device. Idempotent — re-posting the same token refreshes the row.
+ * Stores an Expo push token so the portal can later deliver push notifications to this device. Idempotent — re-posting the same token refreshes the row and bumps its last-seen timestamp. A token previously registered by a different account is reassigned to the caller (an Expo token identifies a physical device). Accounts keep at most 10 devices; the least recently seen are evicted.
  */
 declare const postApiV1NotificationsDevices: <ThrowOnError extends boolean = false>(options: Options<PostApiV1NotificationsDevicesData, ThrowOnError>) => RequestResult<PostApiV1NotificationsDevicesResponses, PostApiV1NotificationsDevicesErrors, ThrowOnError>;
 /**

package/dist/client/index.d.ts

@@ -2400,6 +2400,7 @@ type HandlersNonceResponse = {
 type HandlersNotificationDeviceResponse = {
     app_version?: string;
     id?: number;
+    locale?: string;
     platform?: string;
     token?: string;
 };
@@ -2572,6 +2573,11 @@ type HandlersRefreshRequest = {
 };
 type HandlersRegisterDeviceRequest = {
     app_version?: string;
+    /**
+     * Locale is the optional BCP-47 language tag of the device (e.g.
+     * "en-US"); used for announcement-campaign locale segmentation.
+     */
+    locale?: string;
     platform?: string;
     token?: string;
 };
@@ -8106,10 +8112,6 @@ type PostApiV1NotificationsDevicesErrors = {
      * Forbidden
      */
     403: ResponseErrorResponse;
-    /**
-     * Conflict
-     */
-    409: ResponseErrorResponse;
     /**
      * Internal Server Error
      */
@@ -10736,7 +10738,7 @@ declare const postApiV1Moderate: <ThrowOnError extends boolean = false>(options:
 /**
  * Register push-notification device
  *
- * Stores an Expo push token so the portal can later deliver push notifications to this device. Idempotent — re-posting the same token refreshes the row.
+ * Stores an Expo push token so the portal can later deliver push notifications to this device. Idempotent — re-posting the same token refreshes the row and bumps its last-seen timestamp. A token previously registered by a different account is reassigned to the caller (an Expo token identifies a physical device). Accounts keep at most 10 devices; the least recently seen are evicted.
  */
 declare const postApiV1NotificationsDevices: <ThrowOnError extends boolean = false>(options: Options<PostApiV1NotificationsDevicesData, ThrowOnError>) => RequestResult<PostApiV1NotificationsDevicesResponses, PostApiV1NotificationsDevicesErrors, ThrowOnError>;
 /**

package/dist/expo/index.cjs

@@ -11786,13 +11786,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -11805,7 +11810,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -11813,7 +11819,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -11824,7 +11831,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/dist/expo/index.d.mts

@@ -2429,6 +2429,32 @@ type StepFinishEvent = {
         outputTokens?: number;
     };
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2436,6 +2462,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2447,6 +2475,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5299,7 +5339,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5327,9 +5368,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

package/dist/expo/index.d.ts

@@ -2429,6 +2429,32 @@ type StepFinishEvent = {
         outputTokens?: number;
     };
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2436,6 +2462,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2447,6 +2475,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5299,7 +5339,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5327,9 +5368,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

package/dist/expo/index.mjs

@@ -3389,13 +3389,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -3408,7 +3413,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -3416,7 +3422,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -3427,7 +3434,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/dist/react/index.cjs

@@ -12164,13 +12164,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -12183,7 +12188,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -12191,7 +12197,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -12202,7 +12209,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/dist/react/index.d.mts

@@ -6612,7 +6612,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -6640,9 +6641,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

package/dist/react/index.d.ts

@@ -6612,7 +6612,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -6640,9 +6641,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to

package/dist/react/index.mjs

@@ -3266,13 +3266,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -3285,7 +3290,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -3293,7 +3299,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -3304,7 +3311,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/dist/server/index.cjs

@@ -35092,13 +35092,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -35111,7 +35116,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -35119,7 +35125,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -35130,7 +35137,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/dist/server/index.d.mts

@@ -2423,6 +2423,32 @@ type RunToolLoopOptions = {
      */
     hooks?: RunHooks | RunHooks[];
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2430,6 +2456,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2441,6 +2469,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5231,7 +5271,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5259,9 +5300,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to
@@ -9294,4 +9339,4 @@ declare function sanitizeQuotes(s: string): string;
 declare function renderTemplate(value: string | null | undefined, template: string): string | null;
 declare function buildSystemPrompt(ctx: PromptContext, options?: BuildPromptOptions): BuildPromptResult;
 
-export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, 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, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, Message, type MessageChunk, type MessageFeedback, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp };
+export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, 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, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, Message, type MessageChunk, type MessageFeedback, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp };

package/dist/server/index.d.ts

@@ -2423,6 +2423,32 @@ type RunToolLoopOptions = {
      */
     hooks?: RunHooks | RunHooks[];
 };
+/**
+ * Terminal state of the LAST model response in the turn, normalized to the
+ * completions vocabulary (`"stop"` | `"length"` | `"tool_calls"` | provider-
+ * specific values). `undefined` when the stream carried no finish reason at all.
+ *
+ * Exposed because neither response shape reliably carries it out to a caller.
+ * The Responses API shape has no field for it — `LlmapiResponseResponse` declares
+ * neither `status` nor `incomplete_details` — so `buildFinalResponse` cannot
+ * surface truncation there even though the loop detected it (`responses.ts`
+ * normalizes it onto the accumulator). Completions does expose
+ * `choices[0].finish_reason`, but omits `tool_calls` entirely when there are
+ * none, so a caller sniffing the response cannot tell "no tool calls" from
+ * "field absent".
+ *
+ * The loop already knows both, unambiguously and identically for either API.
+ * Reporting them here means callers and test harnesses stop reverse-engineering
+ * them from a response shape that cannot answer. See anuma-ai/sdk#805.
+ */
+type RunTerminalState = {
+    /** Normalized finish reason of the final response. `"length"` means the output
+     *  ceiling cut it off; anything else means the model stopped on its own. */
+    finishReason?: string;
+    /** Tool calls the final response carried. `0` is meaningful — combined with
+     *  empty content it identifies a turn that ended having produced nothing. */
+    finalToolCallCount: number;
+};
 type RunToolLoopResult = {
     data: ApiResponse;
     error: null;
@@ -2430,6 +2456,8 @@ type RunToolLoopResult = {
     toolsChecksum?: string;
     /** Results from tools that were auto-executed by the SDK */
     autoExecutedToolResults?: AutoExecutedToolResult[];
+    /** Terminal state of the final model response. See {@link RunTerminalState}. */
+    terminalState?: RunTerminalState;
 } | {
     data: ApiResponse | null;
     error: string;
@@ -2441,6 +2469,18 @@ type RunToolLoopResult = {
     detached?: true;
     /** Non-null only when `resumable` was true AND an inference id was captured before detach. */
     resume?: StreamResumeHandle | null;
+    /**
+     * Terminal state of the final model response, when the failure is one the
+     * loop diagnosed FROM that response — today, the truncated-to-nothing
+     * error. See {@link RunTerminalState}.
+     *
+     * Absent on failures that never got a terminal response to read (transport
+     * errors, detach, an SSE failure mid-stream), which is why it stays
+     * optional here. Present on the truncation error specifically because that
+     * is where it is most diagnostic: a caller can branch on
+     * `finishReason === "length"` instead of matching the error string.
+     */
+    terminalState?: RunTerminalState;
 };
 /** Capability header: tells the portal this client can resume a detached stream. Pinned with zeta-chain/ai-portal#1139. */
 declare const STREAM_RESUMABLE_HEADER = "X-Stream-Resumable";
@@ -5231,7 +5271,8 @@ interface RetainOptions {
      * Returns `action: 'suppressed'` with the matched `tombstoneId`.
      */
     respectTombstones?: boolean;
-    /** Cosine similarity threshold for auto-merge. Default: 0.85. */
+    /** Cosine similarity threshold for auto-merge. Default: 0.8
+     *  (`DEFAULT_AUTO_MERGE_THRESHOLD` in retain.ts — the source of truth). */
     autoMergeThreshold?: number;
     /**
      * When provided, runs an LLM-based consolidation pass against the top-K
@@ -5259,9 +5300,13 @@ interface RetainOptions {
          */
         piiRedaction?: boolean | PiiRedactor;
     };
-    /** Cosine similarity floor for the consolidator candidate set. Default: 0.65. */
+    /** Cosine similarity floor for the consolidator candidate set. Default: 0.55
+     *  (`DEFAULT_CONSOLIDATE_THRESHOLD` in retain.ts — the source of truth). */
     consolidateThreshold?: number;
-    /** Top-K consolidation candidates to feed the LLM. Default: 5. */
+    /** Top-K consolidation candidates to feed the LLM. Default: 20
+     *  (`DEFAULT_CONSOLIDATE_TOP_K` in retain.ts — the source of truth). Widened
+     *  from 5 so a value change can find and retire ALL stale duplicates of the
+     *  old value in one pass, not just the nearest few. */
     consolidateTopK?: number;
     /**
      * W6 temporal lane — when the event in this fact occurred. Persisted to
@@ -9294,4 +9339,4 @@ declare function sanitizeQuotes(s: string): string;
 declare function renderTemplate(value: string | null | undefined, template: string): string | null;
 declare function buildSystemPrompt(ctx: PromptContext, options?: BuildPromptOptions): BuildPromptResult;
 
-export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, 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, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, Message, type MessageChunk, type MessageFeedback, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp };
+export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, 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, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, Message, type MessageChunk, type MessageFeedback, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp };

package/dist/server/index.mjs

@@ -12329,13 +12329,18 @@ Executing tool: ${toolInfo}
     }
     const truncatedToNothing = (acc) => acc.finishReason === "length" && acc.toolCalls.size === 0 && acc.content.trim() === "";
     const TRUNCATION_ERROR = "Model response was truncated at the output-token limit before it produced any usable content or tool call. Retry with a higher `maxOutputTokens`, or prompt for fewer/smaller tool calls per turn.";
+    const terminalStateOf = (acc) => ({
+      ...acc.finishReason !== void 0 && { finishReason: acc.finishReason },
+      finalToolCallCount: acc.toolCalls.size
+    });
     if (toolIteration > 0) {
       if (truncatedToNothing(currentAccumulator)) {
         await fireRunError({ error: TRUNCATION_ERROR, stage: "model" });
         return {
           data: buildResponseFinal(currentAccumulator),
           error: TRUNCATION_ERROR,
-          toolsChecksum: currentAccumulator.toolsChecksum
+          toolsChecksum: currentAccumulator.toolsChecksum,
+          terminalState: terminalStateOf(currentAccumulator)
         };
       }
       const finalResponse = buildResponseFinal(currentAccumulator);
@@ -12348,7 +12353,8 @@ Executing tool: ${toolInfo}
         data: finalResponse,
         error: null,
         toolsChecksum: currentAccumulator.toolsChecksum,
-        autoExecutedToolResults: accumulatedToolResults
+        autoExecutedToolResults: accumulatedToolResults,
+        terminalState: terminalStateOf(currentAccumulator)
       };
     }
     if (truncatedToNothing(accumulator)) {
@@ -12356,7 +12362,8 @@ Executing tool: ${toolInfo}
       return {
         data: response,
         error: TRUNCATION_ERROR,
-        toolsChecksum: accumulator.toolsChecksum
+        toolsChecksum: accumulator.toolsChecksum,
+        terminalState: terminalStateOf(accumulator)
       };
     }
     if (onFinish) onFinish(response);
@@ -12367,7 +12374,8 @@ Executing tool: ${toolInfo}
     return {
       data: response,
       error: null,
-      toolsChecksum: accumulator.toolsChecksum
+      toolsChecksum: accumulator.toolsChecksum,
+      terminalState: terminalStateOf(accumulator)
     };
   } catch (err) {
     if (isAbortError(err)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "3.11.5",
+  "version": "3.12.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -157,7 +157,7 @@
   "homepage": "https://github.com/anuma-ai/sdk#readme",
   "packageManager": "pnpm@10.23.0",
   "dependencies": {
-    "@anuma/portal": "1.0.0-next.20260726011521",
+    "@anuma/portal": "1.0.0-next.20260727223242",
     "@babel/parser": "^7.29.2",
     "@babel/types": "^7.29.0",
     "ai": "6.0.202",