ai 7.0.27 → 7.0.29

package/docs/07-reference/01-ai-sdk-core/33-safe-validate-ui-messages.mdx

@@ -5,7 +5,7 @@ description: API Reference for safeValidateUIMessages
 
 # `safeValidateUIMessages`
 
-`safeValidateUIMessages` is an async function that validates UI messages like [`validateUIMessages`](https://ai-sdk.dev/docs/reference/ai-sdk-core/validate-ui-messages), but instead of throwing it returns an object with a `success` key and either `data` or `error`.
+`safeValidateUIMessages` is an async function that validates UI messages like [`validateUIMessages`](/docs/reference/ai-sdk-core/validate-ui-messages), but instead of throwing it returns an object with a `success` key and either `data` or `error`.
 
 ## Basic Usage
 

package/docs/07-reference/01-ai-sdk-core/index.mdx

@@ -111,11 +111,6 @@ It also contains the following helper functions:
       description: 'Creates a client for connecting to MCP servers.',
       href: '/docs/reference/ai-sdk-core/create-mcp-client',
     },
-    {
-      title: 'validateJSONRPCMessage()',
-      description: 'Validates unknown values as MCP JSON-RPC messages.',
-      href: '/docs/reference/ai-sdk-core/validate-json-rpc-message',
-    },
     {
       title: 'MCP Apps',
       description:

package/docs/07-reference/06-ai-sdk-tui/01-run-agent-tui.mdx

@@ -5,9 +5,9 @@ description: API Reference for the runAgentTUI function.
 
 # `runAgentTUI()`
 
-Runs a `ToolLoopAgent` in an interactive terminal UI. The terminal UI reads user
-prompts, streams assistant responses, renders markdown, displays tool and
-reasoning sections, and handles manual tool approvals.
+Runs a local agent or chat transport in an interactive terminal UI. The
+terminal UI reads user prompts, streams assistant responses, renders markdown,
+displays tool and reasoning sections, and handles manual tool approvals.
 
 `runAgentTUI` runs until the user exits with `Esc` or `Ctrl+C`.
 
@@ -49,9 +49,16 @@ await runAgentTUI({
             {
               name: 'agent',
               type: 'AgentTUIAgent',
-              isRequired: true,
+              isOptional: true,
+              description:
+                'The agent to run. Provide exactly one of `agent` or `transport`. The agent must not require per-call options and must not use structured output.',
+            },
+            {
+              name: 'transport',
+              type: 'ChatTransport<UIMessage>',
+              isOptional: true,
               description:
-                'The agent to run. The agent must not require per-call options and must not use structured output.',
+                'The transport used to communicate with a remote agent. Provide exactly one of `agent` or `transport`.',
             },
             {
               name: 'title',
@@ -168,6 +175,19 @@ await runAgentTUI({
 });
 ```
 
+## Example with a Chat Transport
+
+```ts
+import { DefaultChatTransport } from 'ai';
+
+await runAgentTUI({
+  title: 'Remote Assistant',
+  transport: new DefaultChatTransport({
+    api: 'https://example.com/api/chat',
+  }),
+});
+```
+
 ## Example with Sandbox
 
 ```ts
@@ -192,8 +212,9 @@ working directory or exposed ports.
 
 ## Compatibility
 
-Use `runAgentTUI` for agents that can run directly from free-form user input.
-Use `agent.generate()` or `agent.stream()` directly when you need fixed prompts,
+Use the `agent` option for agents that can run directly from free-form user
+input. Use the `transport` option to communicate with a remote agent. Use
+`agent.generate()` or `agent.stream()` directly when you need fixed prompts,
 per-call options, structured output, custom result inspection, or custom stream
 processing.
 
@@ -201,4 +222,4 @@ processing.
 
 - [Terminal UI guide](/docs/agents/terminal-ui)
 - [Building Agents](/docs/agents/building-agents)
-- [ToolLoopAgent guide](/docs/agents/overview#tooloopagent-class)
+- [ToolLoopAgent guide](/docs/agents/overview#toolloopagent-class)

package/docs/08-migration-guides/23-migration-guide-7-0.mdx

@@ -1902,7 +1902,7 @@ const model = xai('grok-4.3');
 const chatModel = xai.chat('grok-4.3');
 ```
 
-# Migration Skill
+## Migration Skill
 
 Use the command below to add the migration skill and guide your agent
 

package/docs/08-migration-guides/29-migration-guide-4-0.mdx

@@ -817,7 +817,7 @@ The following options have been removed from the `useChat` hook:
 - `maxAutomaticRoundtrips`
 - `maxToolRoundtrips`
 
-Please use the [`maxSteps`](/docs/ai-sdk-core/tools-and-tool-calling#multi-step-calls) option instead.
+Please use the [`maxSteps`](/docs/ai-sdk-core/tools-and-tool-calling#multi-step-calls-using-stopwhen) option instead.
 The value of `maxSteps` is equal to roundtrips + 1.
 
 ```ts filename="AI SDK 3.4"

package/docs/08-migration-guides/37-migration-guide-3-3.mdx

@@ -20,7 +20,7 @@ introducing significant improvements and new features across the AI SDK and its
 
 ### Open Telemetry Support
 
-- Added experimental [OpenTelemetry support](/docs/ai-sdk-core/telemetry#telemetry) for all [AI SDK Core functions](/docs/ai-sdk-core/overview#ai-sdk-core-functions), enabling better observability and tracing capabilities.
+- Added experimental [OpenTelemetry support](/docs/ai-sdk-core/telemetry) for all [AI SDK Core functions](/docs/ai-sdk-core/overview#ai-sdk-core-functions), enabling better observability and tracing capabilities.
 
 ### AI SDK UI Improvements
 

package/docs/08-migration-guides/39-migration-guide-3-1.mdx

@@ -129,7 +129,7 @@ async function submitMessage(userInput = 'What is the weather in SF?') {
 }
 ```
 
-With the new [`streamUI`](/docs/reference/ai-sdk-rsc/stream-ui) function, you can now use any compatible AI SDK provider. In this example, you import the AI SDK OpenAI provider. Then, you pass it to the [`model`](/docs/reference/ai-sdk-rsc/stream-ui#model) key of the new [`streamUI`](/docs/reference/ai-sdk-rsc/stream-ui) function. Finally, you declare a tool and return a React Server Component, defined in the [`generate`](/docs/reference/ai-sdk-rsc/stream-ui#tools-generate) key of the tool.
+With the new [`streamUI`](/docs/reference/ai-sdk-rsc/stream-ui) function, you can now use any compatible AI SDK provider. In this example, you import the AI SDK OpenAI provider. Then, you pass it to the [`model`](/docs/reference/ai-sdk-rsc/stream-ui#model) key of the new [`streamUI`](/docs/reference/ai-sdk-rsc/stream-ui) function. Finally, you declare a tool and return a React Server Component, defined in the [`generate`](/docs/reference/ai-sdk-rsc/stream-ui#tools.tool.generate) key of the tool.
 
 ```tsx
 import { streamUI } from '@ai-sdk/rsc';

package/docs/09-troubleshooting/14-tool-calling-with-structured-outputs.mdx

@@ -45,4 +45,4 @@ const result = await generateText({
 });
 ```
 
-For more information about using structured outputs with `generateText` and `streamText` see [Generating Structured Data](/docs/ai-sdk-core/generating-structured-data#structured-outputs-with-generatetext-and-streamtext).
+For more information about using structured outputs with `generateText` and `streamText` see [Generating Structured Data](/docs/ai-sdk-core/generating-structured-data#generating-structured-outputs).

package/docs/09-troubleshooting/15-stream-text-not-working.mdx

@@ -19,7 +19,7 @@ Errors become part of the stream and are not thrown to prevent e.g. servers from
 
 To log errors, you can provide an `onError` callback that is triggered when an error occurs.
 
-```tsx highlight="6-8"
+```tsx highlight="7-9"
 import { streamText } from 'ai';
 __PROVIDER_IMPORT__;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.27",
+  "version": "7.0.29",
   "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,7 +42,7 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.20",
+    "@ai-sdk/gateway": "4.0.21",
     "@ai-sdk/provider": "4.0.3",
     "@ai-sdk/provider-utils": "5.0.10"
   },

package/src/ui/chat.ts

@@ -650,9 +650,10 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
     let isAbort = false;
     let isDisconnect = false;
     let isError = false;
+    let activeResponse: ActiveResponse<UI_MESSAGE> | undefined;
 
     try {
-      const activeResponse = {
+      const response = {
         state: createStreamingUIMessageState({
           lastMessage: this.state.snapshot(lastMessage),
           messageId: this.generateId(),
@@ -660,11 +661,13 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
         abortController: new AbortController(),
       } as ActiveResponse<UI_MESSAGE>;
 
-      activeResponse.abortController.signal.addEventListener('abort', () => {
+      activeResponse = response;
+
+      response.abortController.signal.addEventListener('abort', () => {
         isAbort = true;
       });
 
-      this.activeResponse = activeResponse;
+      this.activeResponse = response;
 
       let stream: ReadableStream<UIMessageChunk>;
 
@@ -674,7 +677,7 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
         stream = await this.transport.sendMessages({
           chatId: this.id,
           messages: this.state.messages,
-          abortSignal: activeResponse.abortController.signal,
+          abortSignal: response.abortController.signal,
           metadata,
           headers,
           body,
@@ -692,21 +695,21 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
         // serialize the job execution to avoid race conditions:
         this.jobExecutor.run(() =>
           job({
-            state: activeResponse.state,
+            state: response.state,
             write: () => {
               // streaming is set on first write (before it should be "submitted")
               this.setStatus({ status: 'streaming' });
 
               const replaceLastMessage =
-                activeResponse.state.message.id === this.lastMessage?.id;
+                response.state.message.id === this.lastMessage?.id;
 
               if (replaceLastMessage) {
                 this.state.replaceMessage(
                   this.state.messages.length - 1,
-                  activeResponse.state.message,
+                  response.state.message,
                 );
               } else {
-                this.state.pushMessage(activeResponse.state.message);
+                this.state.pushMessage(response.state.message);
               }
             },
           }),
@@ -756,19 +759,23 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
       this.setStatus({ status: 'error', error: err as Error });
     } finally {
       try {
-        this.onFinish?.({
-          message: this.activeResponse!.state.message,
-          messages: this.state.messages,
-          isAbort,
-          isDisconnect,
-          isError,
-          finishReason: this.activeResponse?.state.finishReason,
-        });
+        if (activeResponse) {
+          this.onFinish?.({
+            message: activeResponse.state.message,
+            messages: this.state.messages,
+            isAbort,
+            isDisconnect,
+            isError,
+            finishReason: activeResponse.state.finishReason,
+          });
+        }
       } catch (err) {
         console.error(err);
       }
 
-      this.activeResponse = undefined;
+      if (this.activeResponse === activeResponse) {
+        this.activeResponse = undefined;
+      }
     }
 
     // automatically send the message if the sendAutomaticallyWhen function returns true