Vercel AI SDK 7.0.137: latest version, API diff and gotchas

Vercel AI SDK 7.0.137 (2026-10-09 14:53 UTC)

• readUIMessageStream discards unrelated message state when reading resumed streams. (source)

Vercel AI SDK 7.0.136 (2026-10-09 00:38 UTC)

• Clear chunkMs and firstChunkMs timeouts when model response ends so long-running local tools do not trigger model output timeouts. (source)

Vercel AI SDK 7.0.135 (2026-10-08 21:40 UTC)

• Add persistent WebSocketChatTransport with correlated streaming, backpressure, cancellation, validated protocol frames, and sequence resume. (source)
• Add top-level dimensions setting for embedding functions. (source)
• Log warning when default step limit stops a ToolLoopAgent. (source)
• Prevent duplicate continuation requests for repeated tool approval responses. (source)
• Wait for chat stream cleanup when stopping chat. (source)

Vercel AI SDK 7.0.134 (2026-10-08 16:50 UTC)

• Propagate async sendAutomaticallyWhen failures from tool updates. (source)
• Preserve provider-executed tool calls when resuming streams. (source)

Vercel AI SDK 7.0.133 (2026-10-08 00:29 UTC)

• Accept multimodal input and ordered text, file, and JSON parts in decide state. (source)

Vercel AI SDK 7.0.130 → 7.0.137

13 exports added, 0 removed, 7 exports with public members added or removed; 23 declarations changed in any way.

Method: bin/tool-snapshot installed both versions in a throwaway Linux sandbox and listed every export of every package entry point from the type declarations with the TypeScript compiler API (510 and 523 exported symbols), then bin/tool-diff compared them. In the tables, "command" is an exported symbol and "flags" are its public members (function parameters in parentheses).

Commands added:

• ai Experimental_DecisionState
• ai Experimental_DecisionStatePart
• ai PrepareWebSocketChatTransportReconnectToStreamRequest
• ai PrepareWebSocketChatTransportSendMessagesRequest
• ai SafeValidateWebSocketChatTransportRequestResult
• ai WebSocketChatTransport
• ai WebSocketChatTransportAbortRequest
• ai WebSocketChatTransportInitOptions
• ai WebSocketChatTransportRequest
• ai WebSocketChatTransportResponse
• ai WebSocketChatTransportResumeRequest
• ai WebSocketChatTransportSendRequest
• ai safeValidateWebSocketChatTransportRequest

• 13 exports added in 7.0.137, including WebSocketChatTransport and safeValidateWebSocketChatTransportRequest for persistent WebSocket chat transports, and Experimental_DecisionState / Experimental_DecisionStatePart for multimodal decision inputs.
• Public members added: dispose on AbstractChat, close and resumeStreamIsReplay on ChatTransport, onStepEnd and onStepFinish on DirectChatTransportOptions and UIMessageStreamOptions, dimensions on EmbedStartEvent and EmbeddingModelCallStartEvent, and waitForIdle on SerialJobExecutor.

Vercel AI SDK 7.0.129 → 7.0.130

1 export added, 0 removed; 2 core streaming and agent implementations updated.

Method: From source (not run): compared git tags ai@7.0.129 and ai@7.0.130 via gh api repos/vercel/ai/compare/ai@7.0.129...ai@7.0.130 and inspected export declarations of packages/ai and @ai-sdk/provider.

Commands added:

• ai Experimental_DecisionRefusalError

• The last two releases of the previous patch cycle. Experimental_DecisionRefusalError added to ai/error and re-exported from @ai-sdk/provider.
• streamText and ToolLoopAgent cancel the internal reader on abort signal, ensuring promises reject without waiting for unclosed provider streams.

Vercel AI SDK 6.0.301 → 7.0.130

15 exports added, 1 removed; 5 core APIs updated across the v6 to v7 major boundary.

Method: From source (not run): compared git tags ai@6.0.301 and ai@7.0.130 via gh api repos/vercel/ai/compare/ai@6.0.301...ai@7.0.130 and inspected export declarations of packages/ai across the v6 and v7 major lines.

Commands added:

• ai GatewayAsyncJobMetadata
• ai GatewayProviderMetadata
• ai experimental_toolCaller
• ai Experimental_ToolCallerTool
• ai Experimental_SandboxSession
• ai Experimental_SandboxProcess
• ai ToolSet
• ai batch
• ai decide
• ai toolSearch
• ai translate
• ai upload-file
• ai upload-skill
• ai realtime
• ai Experimental_DecisionRefusalError

Commands removed:

• ai ToolCallOptions

• Major line comparison: ai@6.0.301 (active maintenance line) to ai@7.0.130 (current stable).
• v7 replaced ToolCallOptions with ToolExecutionOptions, introduced durable WorkflowAgent, added Standard Schema support, and migrated evaluation helpers to decide.

Passing raw array directly as decision state throws `InvalidArgumentError` (Vercel AI SDK 7.0.133)

// Passing raw array of items directly as decision state in 7.0.133+
await experimental_decide({ model, state: ['alpha', 'beta'], questions });

AI_InvalidArgumentError: Invalid argument for parameter state: must be a string, JSON object, or array of text, file, or json parts

Fix: In 7.0.133+, raw arrays passed as state are treated as DecisionStatePart[]. Wrap arrays in an object (state: { items: ['alpha', 'beta'] }) or an explicit JSON part (state: [{ type: 'json', value: ['alpha', 'beta'] }]). (source)

Negative or non-integer embedding dimensions throw `InvalidArgumentError` (Vercel AI SDK 7.0.135)

// Calling embed with negative or non-integer dimensions
await embed({ model, value: 'test string', dimensions: -1 });

AI_InvalidArgumentError: Invalid argument for parameter dimensions: dimensions must be a positive integer

Fix: Provide a positive integer for dimensions (e.g., dimensions: 512) supported by the model and provider, or omit dimensions to use the model default. (source)

ToolLoopAgent default step limit logs warning on 20 steps (Vercel AI SDK 7.0.135)

// ToolLoopAgent tool loop reaches default 20-step limit without explicit stopWhen
const agent = new ToolLoopAgent({ model, tools: { ping } });
await agent.generate({ prompt: 'Keep pinging' });

(node:62) Warning: AI SDK Warning (mock-provider / mock-model): The tool loop stopped because it reached the default stopWhen condition, isStepCount(20). To allow more steps, set stopWhen to isStepCount(...) with a higher limit or provide a custom stop condition. Learn more: https://ai-sdk.dev/docs/agents/loop-control

Fix: Pass an explicit stopWhen: isStepCount(50) (or custom condition) to allow additional steps, or set globalThis.AI_SDK_LOG_WARNINGS = false to suppress warning logging. (source)

Malformed WebSocket chat request frame rejected (Vercel AI SDK 7.0.135)

// Validating malformed incoming WebSocket chat request frame
await safeValidateWebSocketChatTransportRequest({ value: { type: 'unknown_type' } });

error: Invalid WebSocket chat request frame.

Fix: Ensure client frames conform to WebSocketChatTransportRequest specifications ('send', 'resume', or 'abort' with required requestId and headers). (source)

AbortSignal cancellation rejects pending result promises with AbortError (Vercel AI SDK 7.0.130)

const controller = new AbortController();
const result = streamText({ model, prompt: 'Hello', abortSignal: controller.signal });
controller.abort(new DOMException('User cancelled', 'AbortError'));
await result.text;

AbortError: User cancelled

Fix: In 7.0.130+, result.text, result.steps, result.finishReason, and result.totalUsage reject immediately when abort() is invoked. Wrap calls consuming result promises in try/catch and inspect error.name === 'AbortError'. (source)

2026-10: 7.0.127 to 7.0.137; 6.0.300 to 6.0.303; 5.0.272 to 5.0.273 (17 stable releases to 2026-10-10)

• 7.0.137 (2026-10-09): discard unrelated message state when reading resumed streams (PR #22194). (source)
• 7.0.135 (2026-10-08): persistent WebSocket ChatTransport (PR #21019); top-level dimensions for embeddings (PR #22335); tool loop default step limit warning (PR #22329). (source)
• 7.0.133 (2026-10-08): multimodal input and ordered state parts in decide (PR #22229). (source)
• 7.0.130 (2026-10-07): reject result promises immediately on abort signal (PR #22184); report decision refusals as DecisionRefusalError (PR #22203). (source)

2026-09: 7.0.88 to 7.0.126 (83 stable releases)

• 7.0.127 (2026-10-01): tool search callback ranking and configurable maxResults (PR #21903, #21897). (source)
• 7.0.126 (2026-09-30): clear tool approvals when addToolOutput runs (PR #21879). (source)
• 7.0.100 (2026-09-15): expose typed AI SDK errors for UI transport and completion failures. (source)

2026-08: 7.0.48 to 7.0.87 (88 stable releases)

• 7.0.87 (2026-08-31): preserve approval descriptors in UI message streams. (source)
• 7.0.50 (2026-08-04): asynchronous start and webhook APIs for experimental video model interface. (source)

2026-07: 7.0.1 to 7.0.47; 6.0.218 to 6.0.245 (74 stable releases)

• 7.0.40 (2026-07-25): deprecate Experimental_GeneratedImage in favor of GeneratedFile. (source)
• 7.0.10 (2026-07-05): add maxRetries option for failed MCP tool calls. (source)

2026-06: 6.0.194 to 6.0.217; 7.0.0 (50 stable releases)

• 7.0.0 (2026-06-25): v7 major release with Standard Schema, durable WorkflowAgent, timeout DOMException classification, and UI message stream error redaction. (source)
• 6.0.210 (2026-06-15): publish all packages under the @ai-v6 dist tag for ongoing maintenance. (source)

2026-05: 6.0.173 to 6.0.193 (27 stable releases)

• 6.0.190 (2026-05-28): sandbox shell execution abstractions and file I/O helpers in provider-utils. (source)
• 6.0.180 (2026-05-12): gateway retry support for transient errors and connection drops. (source)