📄 ai-sdk/docs/migration-guides/migration-guide-3-3

File: migration-guide-3-3.md | Updated: 11/15/2025

Source: https://ai-sdk.dev/docs/migration-guides/migration-guide-3-3

AI SDK

Menu

v5 (Latest)

AI SDK 5.x

AI SDK by Vercel

AI SDK 6 Beta

Foundations

Overview

Providers and Models

Prompts

Tools

Streaming

Getting Started

Navigating the Library

Next.js App Router

Next.js Pages Router

Svelte

Vue.js (Nuxt)

Node.js

Expo

Agents

Agents

Building Agents

Workflow Patterns

Loop Control

AI SDK Core

Overview

Generating Text

Generating Structured Data

Tool Calling

Model Context Protocol (MCP) Tools

Prompt Engineering

Settings

Embeddings

Image Generation

Transcription

Speech

Language Model Middleware

Provider & Model Management

Error Handling

Testing

Telemetry

AI SDK UI

Overview

Chatbot

Chatbot Message Persistence

Chatbot Resume Streams

Chatbot Tool Usage

Generative User Interfaces

Completion

Object Generation

Streaming Custom Data

Error Handling

Transport

Reading UIMessage Streams

Message Metadata

Stream Protocols

AI SDK RSC

Advanced

Reference

AI SDK Core

AI SDK UI

AI SDK RSC

Stream Helpers

AI SDK Errors

Migration Guides

Versioning

Migrate Your Data to AI SDK 5.0

Migrate AI SDK 4.0 to 5.0

Migrate AI SDK 4.1 to 4.2

Migrate AI SDK 4.0 to 4.1

Migrate AI SDK 3.4 to 4.0

Migrate AI SDK 3.3 to 3.4

Migrate AI SDK 3.2 to 3.3

Migrate AI SDK 3.1 to 3.2

Migrate AI SDK 3.0 to 3.1

Troubleshooting

Copy markdown

Migrate AI SDK 3.2 to 3.3

==================================================================================================================

Check out the AI SDK 3.3 release blog post for more information about the release.

No breaking changes in this release.

The following changelog encompasses all changes made in the 3.2.x series, introducing significant improvements and new features across the AI SDK and its associated libraries:

New Features


Open Telemetry Support

AI SDK UI Improvements

  • Introduced the experimental useObject hook (for React) that can be used in conjunction with streamObject on the backend to enable seamless streaming of structured data.
  • Enhanced useChat with experimental support for attachments and streaming tool calls, providing more versatile chat functionalities.
  • Patched useChat to prevent empty submissions, improving the quality of user interactions by ensuring that only intended inputs are processed.
  • Fix useChat's reload function, now correctly sending data, body, and headers.
  • Implemented setThreadId helper for useAssistant, simplifying thread management.
  • Documented the stream data protocol for useChat and useCompletion, allowing developers to use these functions with any backend. The stream data protocol also enables the use of custom frontends with streamText.
  • Added support for custom fetch functions and request body customization, offering greater control over API interactions.
  • Added onFinish to useChat hook for access to token usage and finish reason.

Core Enhancements

  • Implemented support for sending custom request headers, enabling more tailored API requests.
  • Added raw JSON schema support alongside existing Zod support, providing more options for schema and data validation.
  • Introduced usage information for embed and embedMany functions, offering insights into token usage.
  • Added support for additional settings including stopSequences and topK, allowing for finer control over text generation.
  • Provided access to information for all steps on generateText, providing access to intermediate tool calls and results.

New Providers

Provider Improvements

  • Enhanced existing providers including Anthropic, Google, Azure, and OpenAI with various improvements and bug fixes.
  • Upgraded the LangChain adapter with StreamEvent v2 support and introduced the toDataStreamResponse function, enabling conversion of LangChain output streams to data stream responses.
  • Added legacy function calling support to the OpenAI provider.
  • Updated Mistral AI provider with fixes and improvements for tool calling support.

UI Framework Support Expansion

  • SolidJS: Updated useChat and useCompletion to achieve feature parity with React implementations.
  • Vue.js: Introduced useAssistant hook.
  • Vue.js / Nuxt: Updated examples to showcase latest features and best practices.
  • Svelte: Added tool calling support to useChat.

Fixes and Improvements


  • Resolved various issues across different components of the SDK, including race conditions, error handling, and state management.

On this page

Migrate AI SDK 3.2 to 3.3

New Features

Open Telemetry Support

AI SDK UI Improvements

Core Enhancements

New Providers

Provider Improvements

UI Framework Support Expansion

Fixes and Improvements

Deploy and Scale AI Apps with Vercel.

Vercel delivers the infrastructure and developer experience you need to ship reliable AI-powered applications at scale.

Trusted by industry leaders:

  • OpenAI
  • Photoroom
  • leonardo-ai Logoleonardo-ai Logo
  • zapier Logozapier Logo

Talk to an expert