ai 7.0.91 → 7.0.92

package/docs/07-reference/01-ai-sdk-core/02-stream-text.mdx

@@ -2069,11 +2069,24 @@ To see `streamText` in action, check out [these examples](#examples).
         {
           type: 'OnAbortResult',
           parameters: [
+            {
+              name: 'callId',
+              type: 'string',
+              description:
+                'Unique identifier for this generation call, used to correlate events.',
+            },
             {
               name: 'steps',
               type: 'Array<StepResult>',
               description: 'Details for all previously finished steps.',
             },
+            {
+              name: 'reason',
+              type: 'unknown',
+              isOptional: true,
+              description:
+                'The raw abort reason from the AbortSignal, when one is available.',
+            },
           ],
         },
       ],
@@ -3979,10 +3992,10 @@ To see `streamText` in action, check out [these examples](#examples).
             },
             {
               name: 'reason',
-              type: 'unknown',
+              type: 'string',
               isOptional: true,
               description:
-                'Optional abort reason (from AbortSignal.reason) when the stream is aborted.',
+                'Optional serialized abort reason when the stream is aborted.',
             },
           ],
         },

package/docs/07-reference/01-ai-sdk-core/80-smooth-stream.mdx

@@ -38,7 +38,7 @@ const result = streamText({
       type: 'number | null',
       isOptional: true,
       description:
-        'The delay in milliseconds between outputting each chunk. Defaults to 10ms. Set to `null` to disable delays.',
+        'The delay in milliseconds between outputting each chunk. Defaults to 10ms. Set to `null` to disable delays. The delay is skipped while the document is hidden (e.g. browser background tabs), where timer throttling would otherwise stall the stream.',
     },
     {
       name: 'chunking',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.91",
+  "version": "7.0.92",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,18 +42,18 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.73",
+    "@ai-sdk/gateway": "4.0.74",
     "@ai-sdk/provider": "4.0.10",
     "@ai-sdk/provider-utils": "5.0.36"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.73",
+    "@ai-sdk/amazon-bedrock": "5.0.74",
     "@ai-sdk/deepseek": "3.0.39",
     "@ai-sdk/google": "4.0.63",
     "@ai-sdk/groq": "4.0.37",
     "@ai-sdk/huggingface": "2.0.43",
     "@ai-sdk/moonshotai": "3.0.45",
-    "@ai-sdk/openai": "4.0.57",
+    "@ai-sdk/openai": "4.0.58",
     "@ai-sdk/test-server": "2.0.1",
     "@ai-sdk/xai": "4.0.54",
     "@edge-runtime/vm": "^5.0.0",

package/src/generate-text/generate-text-events.ts

@@ -294,7 +294,7 @@ export type GenerateTextEndEvent<
 };
 
 /**
- * Event passed to the telemetry `onAbort` callback.
+ * Event passed to an `onAbort` callback for text generation.
  *
  * Called when a streaming text generation operation is aborted before it
  * completes.

package/src/generate-text/smooth-stream.ts

@@ -10,6 +10,15 @@ const CHUNKING_REGEXPS = {
   line: /\n+/m,
 };
 
+// Browsers heavily throttle timers in hidden documents (e.g. background tabs),
+// which would stall the smoothing delay and, through backpressure, the entire
+// stream. Smoothing has no visual purpose there, so the delay is skipped.
+function isDocumentHidden(): boolean {
+  return (
+    typeof document !== 'undefined' && document.visibilityState === 'hidden'
+  );
+}
+
 /**
  * Detects the first chunk in a buffer.
  *
@@ -22,7 +31,7 @@ export type ChunkDetector = (buffer: string) => string | undefined | null;
 /**
  * Smooths text and reasoning streaming output.
  *
- * @param delayInMs - The delay in milliseconds between each chunk. Defaults to 10ms. Can be set to `null` to skip the delay.
+ * @param delayInMs - The delay in milliseconds between each chunk. Defaults to 10ms. Can be set to `null` to skip the delay. The delay is skipped while the document is hidden (e.g. browser background tabs), where timer throttling would otherwise stall the stream.
  * @param chunking - Controls how the text is chunked for streaming. Use "word" to stream word by word (default), "line" to stream line by line, provide a custom RegExp pattern that does not match the empty string for custom chunking, provide an Intl.Segmenter for locale-aware word segmentation (recommended for CJK languages), or provide a custom ChunkDetector function.
  *
  * @returns A transform stream that smooths text streaming output.
@@ -126,7 +135,10 @@ export function smoothStream<TOOLS extends ToolSet>({
     function flushBuffer(
       controller: TransformStreamDefaultController<TextStreamPart<TOOLS>>,
     ) {
-      if (buffer.length > 0 && type !== undefined) {
+      if (
+        type !== undefined &&
+        (buffer.length > 0 || providerMetadata != null)
+      ) {
         controller.enqueue({
           type,
           text: buffer,
@@ -148,7 +160,10 @@ export function smoothStream<TOOLS extends ToolSet>({
         }
 
         // Flush buffer when type or id changes
-        if ((chunk.type !== type || chunk.id !== id) && buffer.length > 0) {
+        if (
+          (chunk.type !== type || chunk.id !== id) &&
+          (buffer.length > 0 || providerMetadata != null)
+        ) {
           flushBuffer(controller);
         }
 
@@ -167,7 +182,7 @@ export function smoothStream<TOOLS extends ToolSet>({
           controller.enqueue({ type, text: match, id });
           buffer = buffer.slice(match.length);
 
-          await delay(delayInMs);
+          await delay(isDocumentHidden() ? null : delayInMs);
         }
       },
     });

package/src/generate-text/stream-text.ts

@@ -95,6 +95,7 @@ import {
   type ActiveToolSubset,
 } from './filter-active-tools';
 import type {
+  GenerateTextAbortEvent,
   GenerateTextEndEvent,
   GenerateTextOnStartCallback,
   GenerateTextOnStepEndCallback,
@@ -329,12 +330,7 @@ export type StreamTextOnEndCallback<
 export type StreamTextOnAbortCallback<
   TOOLS extends ToolSet,
   RUNTIME_CONTEXT extends Context,
-> = Callback<{
-  /**
-   * Details for all previously finished steps.
-   */
-  readonly steps: StepResult<TOOLS, RUNTIME_CONTEXT>[];
-}>;
+> = Callback<GenerateTextAbortEvent<TOOLS, RUNTIME_CONTEXT>>;
 
 /**
  * Generate a text and call tools for a given prompt using a language model.

package/src/ui/call-completion-api.ts

@@ -76,7 +76,7 @@ export async function callCompletionApi({
 
     if (!response.ok) {
       throw new Error(
-        (await response.text()) ?? 'Failed to fetch the chat response.',
+        (await response.text()) || 'Failed to fetch the chat response.',
       );
     }
 

package/src/ui/http-chat-transport.ts

@@ -201,7 +201,7 @@ export abstract class HttpChatTransport<
 
     if (!response.ok) {
       throw new Error(
-        (await response.text()) ?? 'Failed to fetch the chat response.',
+        (await response.text()) || 'Failed to fetch the chat response.',
       );
     }
 
@@ -257,7 +257,7 @@ export abstract class HttpChatTransport<
 
     if (!response.ok) {
       throw new Error(
-        (await response.text()) ?? 'Failed to fetch the chat response.',
+        (await response.text()) || 'Failed to fetch the chat response.',
       );
     }
 

package/src/util/async-iterable-stream.ts

@@ -43,7 +43,7 @@ export function asAsyncIterableStream<T>(
    * Implements the async iterator protocol for the stream.
    * Ensures proper cleanup (cancelling and releasing the reader) on completion, early exit, or error.
    */
-  (stream as AsyncIterableStream<T>)[Symbol.asyncIterator] = function (
+  (stream as unknown as AsyncIterable<T>)[Symbol.asyncIterator] = function (
     this: ReadableStream<T>,
   ): AsyncIterator<T> {
     const reader = this.getReader();