ai 7.0.101 → 7.0.102

package/dist/internal/index.js

@@ -91,7 +91,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.101" : "0.0.0-test";
+var VERSION = true ? "7.0.102" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/03-agents/07-workflow-agent.mdx

@@ -198,7 +198,7 @@ Workflow functions can time out or be interrupted by network failures. `Workflow
 'use client';
 
 import { useChat } from '@ai-sdk/react';
-import { WorkflowChatTransport } from '@ai-sdk/workflow';
+import { WorkflowChatTransport } from '@ai-sdk/workflow/client';
 import { useMemo } from 'react';
 
 export default function Chat() {

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

@@ -7,11 +7,15 @@ description: Learn how to build realtime voice conversations with the AI SDK.
 
 <Note type="warning">Realtime is an experimental feature.</Note>
 
-The AI SDK provides realtime models for bidirectional audio and text
-conversations over WebSockets. Realtime sessions run in the browser and connect
+This guide covers legacy token-based, turn-based realtime conversations over
+WebSockets. These sessions run in the browser and connect
 directly to the provider using a short-lived token that you create on your
 server. You can also route the connection through [AI Gateway](/providers/ai-sdk-providers/ai-gateway#realtime).
 
+For OpenAI Live's continuous JSON/PCM16 WSS relay runtime and application-handled
+client delegation, see
+[`experimental_useRealtime`](/docs/reference/ai-sdk-ui/use-realtime#continuous-conversations).
+
 The typical flow is:
 
 1. The browser calls your setup endpoint.
@@ -20,6 +24,13 @@ The typical flow is:
 1. The model streams audio, text, and tool calls back to the browser.
 1. Tool calls are handled by your application with `onToolCall`.
 
+For continuous **OpenAI Live** conversations, use an application-owned WebSocket
+relay or optional WebRTC via `api.session`. Live uses client delegation: your
+application handles delegated work and submits context rather than using the
+turn-based tool loop below. See the
+[`experimental_useRealtime` reference](/docs/reference/ai-sdk-ui/use-realtime)
+for SDP setup, server-owned permissions, capture ownership, and graceful close.
+
 ## Setup Endpoint
 
 Create a setup endpoint that returns a short-lived token for the realtime
@@ -94,18 +105,21 @@ Then use the matching Gateway realtime model in the browser:
 import { experimental_useRealtime } from '@ai-sdk/react';
 import { gateway } from 'ai';
 
+const model = gateway.experimental_realtime('openai/gpt-realtime-2');
+const sessionConfig = {
+  instructions: 'You are a helpful assistant. Be concise.',
+  inputAudioTranscription: {},
+  voice: 'alloy',
+  turnDetection: { type: 'server-vad' as const },
+};
+
 export default function RealtimePage() {
   const realtime = experimental_useRealtime({
-    model: gateway.experimental_realtime('openai/gpt-realtime-2'),
+    model,
     api: {
       token: '/api/realtime/setup',
     },
-    sessionConfig: {
-      instructions: 'You are a helpful assistant. Be concise.',
-      inputAudioTranscription: {},
-      voice: 'alloy',
-      turnDetection: { type: 'server-vad' },
-    },
+    sessionConfig,
   });
 
   // ...
@@ -134,18 +148,21 @@ microphone audio, play model audio, send text messages, and render messages.
 import { openai } from '@ai-sdk/openai';
 import { experimental_useRealtime } from '@ai-sdk/react';
 
+const model = openai.experimental_realtime('gpt-realtime');
+const sessionConfig = {
+  instructions: 'You are a helpful assistant. Be concise.',
+  inputAudioTranscription: {},
+  voice: 'alloy',
+  turnDetection: { type: 'server-vad' as const },
+};
+
 export default function RealtimePage() {
   const realtime = experimental_useRealtime({
-    model: openai.experimental_realtime('gpt-realtime'),
+    model,
     api: {
       token: '/api/realtime/setup',
     },
-    sessionConfig: {
-      instructions: 'You are a helpful assistant. Be concise.',
-      inputAudioTranscription: {},
-      voice: 'alloy',
-      turnDetection: { type: 'server-vad' },
-    },
+    sessionConfig,
   });
 
   return (
@@ -166,6 +183,10 @@ export default function RealtimePage() {
 }
 ```
 
+Keep model and session configuration objects stable across renders. Use module
+scope as above, or `useMemo` when configuration depends on props. Replacing either
+object replaces the hook's session.
+
 ## Tool Calling
 
 Realtime tool execution is client-driven. The provider sends tool calls over the
@@ -204,13 +225,15 @@ export async function POST(request: Request) {
 
 ### Client Tool Handler
 
-```tsx filename='app/realtime/page.tsx' highlight="10-24"
+```tsx filename='app/realtime/page.tsx' highlight="12-26"
 import { openai } from '@ai-sdk/openai';
 import { experimental_useRealtime } from '@ai-sdk/react';
 
+const model = openai.experimental_realtime('gpt-realtime');
+
 export default function RealtimePage() {
   const realtime = experimental_useRealtime({
-    model: openai.experimental_realtime('gpt-realtime'),
+    model,
     api: {
       token: '/api/realtime/setup',
     },

package/docs/04-ai-sdk-ui/21-transport.mdx

@@ -162,7 +162,7 @@ For chat apps built on the [Workflow SDK](/docs/agents/workflow-agent), `Workflo
 
 ```tsx
 import { useChat } from '@ai-sdk/react';
-import { WorkflowChatTransport } from '@ai-sdk/workflow';
+import { WorkflowChatTransport } from '@ai-sdk/workflow/client';
 import { useMemo } from 'react';
 
 export default function Chat() {