ai 7.0.124 → 7.0.126

package/dist/internal/index.js

@@ -111,7 +111,7 @@ function asAsyncIterableStream(stream) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "7.0.124";
+const VERSION = "7.0.126";
 //#endregion
 //#region src/util/download/download.ts
 /**

package/docs/03-ai-sdk-core/16-mcp-tools.mdx

@@ -178,6 +178,31 @@ transports by providing an `authProvider`.
 
 </Note>
 
+### Shared OAuth Credential Storage
+
+When multiple MCP clients or replicas share OAuth credentials, a rotating refresh
+token can be used concurrently. One refresh may save new tokens while another
+receives `invalid_grant` for the old refresh token.
+
+The optional `OAuthClientProvider.invalidateCredentials` method receives a
+second argument identifying the tokens used by a failed refresh:
+
+```typescript
+invalidateCredentials(
+  scope: 'all' | 'client' | 'tokens' | 'verifier',
+  context?: { tokens: OAuthTokens },
+): void | Promise<void>;
+```
+
+For `scope === 'tokens'` with a context, delete the credential only if the stored
+access and refresh tokens still match `context.tokens`. The comparison and
+deletion must be atomic, using a conditional database operation or a transaction.
+If they no longer match, leave the newer tokens in storage. The SDK retries
+authorization and reads the stored tokens again.
+
+The SDK also provides this context when invalidating stored tokens that lack an
+authorization server pin. Other invalidations can omit the context.
+
 ### OAuth Authorization Server Validation
 
 When using MCP OAuth in server-side applications, the MCP server can advertise

package/docs/03-ai-sdk-core/36-transcription.mdx

@@ -343,7 +343,8 @@ try {
 | [Groq](/providers/ai-sdk-providers/groq#transcription-models)                       | `whisper-large-v3`          |
 | [Mistral](/providers/ai-sdk-providers/mistral#transcription-models)                 | `voxtral-mini-latest`       |
 | [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `whisper-1`                 |
-| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe-2)                  | `mai-transcribe-2`          |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-2`          |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-transcribe)                    | `mai-transcribe-1.5`        |
 | [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-transcribe`         |
 | [Azure OpenAI](/providers/ai-sdk-providers/azure#transcription-models)              | `gpt-4o-mini-transcribe`    |
 | [Rev.ai](/providers/ai-sdk-providers/revai#transcription-models)                    | `machine`                   |

package/docs/03-ai-sdk-core/37-speech.mdx

@@ -158,6 +158,8 @@ try {
 | [OpenAI](/providers/ai-sdk-providers/openai#speech-models)               | `tts-1-hd`                          |
 | [OpenAI](/providers/ai-sdk-providers/openai#speech-models)               | `gpt-4o-mini-tts`                   |
 | [Mistral](/providers/ai-sdk-providers/mistral#speech-models)             | `voxtral-mini-tts-2603`             |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-voice)              | `mai-voice-2-flash`                 |
+| [Azure Speech](/providers/ai-sdk-providers/azure#mai-voice)              | `mai-voice-2`                       |
 | [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#speech-models)       | `eleven_v3`                         |
 | [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#speech-models)       | `eleven_multilingual_v2`            |
 | [ElevenLabs](/providers/ai-sdk-providers/elevenlabs#speech-models)       | `eleven_flash_v2_5`                 |

package/docs/07-reference/01-ai-sdk-core/17-create-agent-ui-stream.mdx

@@ -59,6 +59,13 @@ export async function* streamAgent(
       description:
         'Array of input UI message objects (e.g., user/assistant/chat history). These will be validated and converted for the agent.',
     },
+    {
+      name: 'convertDataPart',
+      type: '(part: DataUIPart) => TextPart | FilePart | undefined',
+      isRequired: false,
+      description:
+        'Converts custom UI data parts into text or file parts for the model. Data parts are ignored when this callback is omitted or returns undefined.',
+    },
     {
       name: 'abortSignal',
       type: 'AbortSignal',

package/docs/07-reference/01-ai-sdk-core/18-create-agent-ui-stream-response.mdx

@@ -57,6 +57,13 @@ export async function POST(request: Request) {
       description:
         'Array of input UI messages provided to the agent (e.g., user and assistant messages).',
     },
+    {
+      name: 'convertDataPart',
+      type: '(part: DataUIPart) => TextPart | FilePart | undefined',
+      isRequired: false,
+      description:
+        'Converts custom UI data parts into text or file parts for the model. Data parts are ignored when this callback is omitted or returns undefined.',
+    },
     {
       name: 'abortSignal',
       type: 'AbortSignal',

package/docs/07-reference/01-ai-sdk-core/18-pipe-agent-ui-stream-to-response.mdx

@@ -61,6 +61,13 @@ export async function handler(req, res) {
       description:
         'Array of input UI messages sent to the agent (such as user/assistant message objects).',
     },
+    {
+      name: 'convertDataPart',
+      type: '(part: DataUIPart) => TextPart | FilePart | undefined',
+      isRequired: false,
+      description:
+        'Converts custom UI data parts into text or file parts for the model. Data parts are ignored when this callback is omitted or returns undefined.',
+    },
     {
       name: 'abortSignal',
       type: 'AbortSignal',

package/docs/07-reference/04-ai-sdk-workflow/01-workflow-agent.mdx

@@ -120,7 +120,7 @@ To see `WorkflowAgent` in action, check out [these examples](#examples).
       type: 'ToolCallRepairFunction',
       isOptional: true,
       description:
-        'Default function to repair tool calls that fail to parse. Per-stream values override this default.',
+        "Default function to repair tool calls that fail to parse. Mark the function with 'use step' when used in a workflow. Per-stream values override this default.",
     },
     {
       name: 'experimental_download',
@@ -573,13 +573,13 @@ const result = await agent.stream({
       name: 'repairToolCall',
       type: 'ToolCallRepairFunction',
       isOptional: true,
-      description: 'Callback to attempt automatic recovery when a tool call cannot be parsed.',
+      description: "Callback to attempt automatic recovery when a tool call cannot be parsed. Mark the function with 'use step' when used in a workflow.",
     },
     {
       name: 'experimental_transform',
       type: 'StreamTextTransform | Array<StreamTextTransform>',
       isOptional: true,
-      description: 'Stream transformations applied in order. Must maintain the stream structure.',
+      description: "Factories for stream transformations, applied in order to raw provider events before model processing and writable output. Each factory must return a TransformStream synchronously and maintain the stream structure. Mark each factory with 'use step' when used in a workflow.",
     },
     {
       name: 'experimental_download',
@@ -750,6 +750,63 @@ Returns a `Promise<WorkflowAgentStreamResult>` with the following properties:
   ]}
 />
 
+### `repairToolCall` in a workflow
+
+`repairToolCall` runs inside the model step. When you use it in a workflow,
+define the callback as a function with a `'use step'` directive. You can set
+it on the constructor or pass it to `stream()`.
+
+Workflow saves a reference to the registered function and loads its
+implementation inside the model step. Keep any values captured by the
+function serializable. An ordinary inline callback causes a serialization
+error when it crosses this step boundary.
+
+The callback can be asynchronous. Return the repaired tool call, or `null`
+if the repair cannot be completed. See [tool call repair](/docs/ai-sdk-core/tools-and-tool-calling#tool-call-repair)
+for repair strategies.
+
+### `experimental_transform` in a workflow
+
+Pass a transform factory, or an array of factories, to `stream()`.
+Mark each factory with `'use step'` so Workflow can load it inside the model
+step. The factory must return a `TransformStream` synchronously. Keep any
+captured values serializable.
+
+```ts
+import type { LanguageModelV4StreamPart } from '@ai-sdk/provider';
+import { WorkflowAgent } from '@ai-sdk/workflow';
+import { getWritable } from 'workflow';
+
+function uppercaseText() {
+  'use step';
+
+  return new TransformStream<
+    LanguageModelV4StreamPart,
+    LanguageModelV4StreamPart
+  >({
+    transform(part, controller) {
+      controller.enqueue(
+        part.type === 'text-delta'
+          ? { ...part, delta: part.delta.toUpperCase() }
+          : part,
+      );
+    },
+  });
+}
+
+export async function uppercaseWorkflow() {
+  'use workflow';
+
+  const agent = new WorkflowAgent({ model: 'openai/gpt-5' });
+
+  return agent.stream({
+    messages: [{ role: 'user', content: 'Write a short greeting.' }],
+    writable: getWritable(),
+    experimental_transform: uppercaseText,
+  });
+}
+```
+
 ## Utilities
 
 ### `createModelCallToUIChunkTransform(options?)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.124",
+  "version": "7.0.126",
   "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",
@@ -47,11 +47,11 @@
     "@ai-sdk/provider-utils": "5.0.53"
   },
   "devDependencies": {
-    "@ai-sdk/amazon-bedrock": "5.0.103",
+    "@ai-sdk/amazon-bedrock": "5.0.104",
     "@ai-sdk/deepseek": "3.0.58",
     "@ai-sdk/google": "4.0.87",
     "@ai-sdk/groq": "4.0.54",
-    "@ai-sdk/huggingface": "2.0.61",
+    "@ai-sdk/huggingface": "2.0.62",
     "@ai-sdk/moonshotai": "3.0.62",
     "@ai-sdk/openai": "4.0.83",
     "@ai-sdk/test-server": "2.0.3",

package/src/agent/create-agent-ui-stream-response.ts

@@ -14,8 +14,9 @@ import type { UIMessageStreamOptions } from '../generate-text/stream-text-result
 import type { TimeoutConfiguration } from '../prompt/request-options';
 import { createUIMessageStreamResponse } from '../ui-message-stream';
 import type { UIMessageStreamResponseInit } from '../ui-message-stream/ui-message-stream-response-init';
-import type { InferUITools, UIMessage } from '../ui/ui-messages';
+import type { InferUITools, UIMessage, UIDataTypes } from '../ui/ui-messages';
 import type { Agent } from './agent';
+import type { convertToModelMessages } from '../ui/convert-to-model-messages';
 import { createAgentUIStream } from './create-agent-ui-stream';
 
 /**
@@ -23,6 +24,7 @@ import { createAgentUIStream } from './create-agent-ui-stream';
  *
  * @param agent - The agent to run.
  * @param uiMessages - The input UI messages.
+ * @param convertDataPart - Optional function to convert custom data parts to text or file model message parts.
  * @param abortSignal - Abort signal. Optional.
  * @param timeout - Timeout in milliseconds. Optional.
  * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
@@ -44,6 +46,11 @@ export async function createAgentUIStreamResponse<
   RUNTIME_CONTEXT extends Context = Context,
   OUTPUT extends Output = never,
   MESSAGE_METADATA = unknown,
+  UI_MESSAGE extends UIMessage<
+    MESSAGE_METADATA,
+    UIDataTypes,
+    InferUITools<TOOLS>
+  > = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>,
 >({
   headers,
   status,
@@ -54,6 +61,13 @@ export async function createAgentUIStreamResponse<
 }: {
   agent: Agent<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
   uiMessages: unknown[];
+  /**
+   * Converts custom UI data parts to text or file model message parts.
+   * Data parts are ignored when omitted or when the callback returns undefined.
+   */
+  convertDataPart?: NonNullable<
+    Parameters<typeof convertToModelMessages<UI_MESSAGE>>[1]
+  >['convertDataPart'];
   abortSignal?: AbortSignal;
   timeout?: TimeoutConfiguration<TOOLS>;
   experimental_sandbox?: SandboxSession;
@@ -63,9 +77,7 @@ export async function createAgentUIStreamResponse<
   /** @deprecated Use `onStepEnd` instead. */
   onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
 } & UIMessageStreamResponseInit &
-  UIMessageStreamOptions<
-    UIMessage<MESSAGE_METADATA, never, InferUITools<TOOLS>>
-  >): Promise<Response> {
+  UIMessageStreamOptions<UI_MESSAGE>): Promise<Response> {
   return createUIMessageStreamResponse({
     headers,
     status,

package/src/agent/create-agent-ui-stream.ts

@@ -20,6 +20,7 @@ import type {
   InferUIMessageTools,
   InferUITools,
   UIMessage,
+  UIDataTypes,
 } from '../ui/ui-messages';
 import { validateUIMessagesForAgent } from '../ui/validate-ui-messages';
 import {
@@ -33,6 +34,7 @@ import type { Agent } from './agent';
  *
  * @param agent - The agent to run.
  * @param uiMessages - The input UI messages.
+ * @param convertDataPart - Optional function to convert custom data parts to text or file model message parts.
  * @param abortSignal - The abort signal. Optional.
  * @param timeout - Timeout in milliseconds. Optional.
  * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
@@ -49,11 +51,15 @@ export async function createAgentUIStream<
   RUNTIME_CONTEXT extends Context = Context,
   OUTPUT extends Output = never,
   MESSAGE_METADATA = unknown,
-  UI_MESSAGE extends UIMessage<MESSAGE_METADATA, never, InferUITools<TOOLS>> =
-    UIMessage<MESSAGE_METADATA, never, InferUITools<TOOLS>>,
+  UI_MESSAGE extends UIMessage<
+    MESSAGE_METADATA,
+    UIDataTypes,
+    InferUITools<TOOLS>
+  > = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>,
 >({
   agent,
   uiMessages,
+  convertDataPart,
   options,
   abortSignal,
   timeout,
@@ -65,6 +71,13 @@ export async function createAgentUIStream<
 }: {
   agent: Agent<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
   uiMessages: unknown[];
+  /**
+   * Converts custom UI data parts to text or file model message parts.
+   * Data parts are ignored when omitted or when the callback returns undefined.
+   */
+  convertDataPart?: NonNullable<
+    Parameters<typeof convertToModelMessages<UI_MESSAGE>>[1]
+  >['convertDataPart'];
   abortSignal?: AbortSignal;
   timeout?: TimeoutConfiguration<TOOLS>;
   experimental_sandbox?: SandboxSession;
@@ -91,6 +104,7 @@ export async function createAgentUIStream<
 
   const modelMessages = await convertToModelMessages(validatedMessages, {
     tools: agent.tools,
+    convertDataPart,
   });
 
   const result = await agent.stream({

package/src/agent/pipe-agent-ui-stream-to-response.ts

@@ -15,8 +15,9 @@ import type { UIMessageStreamOptions } from '../generate-text/stream-text-result
 import type { TimeoutConfiguration } from '../prompt/request-options';
 import { pipeUIMessageStreamToResponse } from '../ui-message-stream';
 import type { UIMessageStreamResponseInit } from '../ui-message-stream/ui-message-stream-response-init';
-import type { InferUITools, UIMessage } from '../ui/ui-messages';
+import type { InferUITools, UIMessage, UIDataTypes } from '../ui/ui-messages';
 import type { Agent } from './agent';
+import type { convertToModelMessages } from '../ui/convert-to-model-messages';
 import { createAgentUIStream } from './create-agent-ui-stream';
 
 /**
@@ -25,6 +26,7 @@ import { createAgentUIStream } from './create-agent-ui-stream';
  * @param response - The Node.js ServerResponse object to pipe to.
  * @param agent - The agent to run.
  * @param uiMessages - The input UI messages.
+ * @param convertDataPart - Optional function to convert custom data parts to text or file model message parts.
  * @param abortSignal - Abort signal. Optional.
  * @param timeout - Timeout in milliseconds. Optional.
  * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
@@ -44,6 +46,11 @@ export async function pipeAgentUIStreamToResponse<
   RUNTIME_CONTEXT extends Context = Context,
   OUTPUT extends Output = never,
   MESSAGE_METADATA = unknown,
+  UI_MESSAGE extends UIMessage<
+    MESSAGE_METADATA,
+    UIDataTypes,
+    InferUITools<TOOLS>
+  > = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>,
 >({
   response,
   headers,
@@ -56,6 +63,13 @@ export async function pipeAgentUIStreamToResponse<
   response: ServerResponse;
   agent: Agent<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
   uiMessages: unknown[];
+  /**
+   * Converts custom UI data parts to text or file model message parts.
+   * Data parts are ignored when omitted or when the callback returns undefined.
+   */
+  convertDataPart?: NonNullable<
+    Parameters<typeof convertToModelMessages<UI_MESSAGE>>[1]
+  >['convertDataPart'];
   abortSignal?: AbortSignal;
   timeout?: TimeoutConfiguration<TOOLS>;
   experimental_sandbox?: SandboxSession;
@@ -65,9 +79,7 @@ export async function pipeAgentUIStreamToResponse<
   /** @deprecated Use `onStepEnd` instead. */
   onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
 } & UIMessageStreamResponseInit &
-  UIMessageStreamOptions<
-    UIMessage<MESSAGE_METADATA, never, InferUITools<TOOLS>>
-  >): Promise<void> {
+  UIMessageStreamOptions<UI_MESSAGE>): Promise<void> {
   return pipeUIMessageStreamToResponse({
     response,
     headers,

package/src/ui/chat.ts

@@ -609,7 +609,7 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
     });
 
   addToolOutput: ChatAddToolOutputFunction<UI_MESSAGE> = async ({
-    state = 'output-available',
+    state,
     toolCallId,
     output,
     errorText,
@@ -621,10 +621,41 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
 
       const updatePart = (
         part: UIMessagePart<UIDataTypes, UITools>,
-      ): UIMessagePart<UIDataTypes, UITools> =>
-        isToolUIPart(part) && part.toolCallId === toolCallId
-          ? ({ ...part, state, output, errorText } as typeof part)
-          : part;
+      ): UIMessagePart<UIDataTypes, UITools> => {
+        if (!isToolUIPart(part) || part.toolCallId !== toolCallId) {
+          return part;
+        }
+
+        // Output states can only retain approvals that were granted.
+        const { approval: existingApproval, ...toolPart } = part;
+        const approval =
+          existingApproval?.approved === true
+            ? {
+                approval: {
+                  ...existingApproval,
+                  approved: existingApproval.approved,
+                },
+              }
+            : {};
+
+        return state === 'output-error'
+          ? {
+              ...toolPart,
+              ...approval,
+              state,
+              input: part.input,
+              output: undefined,
+              errorText,
+            }
+          : {
+              ...toolPart,
+              ...approval,
+              state: 'output-available',
+              input: part.input,
+              output,
+              errorText: undefined,
+            };
+      };
 
       // update the message to trigger an immediate UI update
       this.state.replaceMessage(messages.length - 1, {