Migration GuideMigrate 3.2 to 3.3
Migration Guide (3.2 to 3.3)
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
- Added experimental OpenTelemetry support for all AI SDK Core functions, enabling better observability and tracing capabilities.
AI SDK UI Improvements
- Introduced the experimental
useObject
hook (for React) that can be used in conjunction withstreamObject
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
'sreload
function, now correctly sending data, body, and headers. - Implemented
setThreadId
helper foruseAssistant
, simplifying thread management. - Documented the stream data protocol for
useChat
anduseCompletion
, allowing developers to use these functions with any backend. The stream data protocol also enables the use of custom frontends withstreamText
. - Added support for custom fetch functions and request body customization, offering greater control over API interactions.
- Added
onFinish
touseChat
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
andembedMany
functions, offering insights into token usage. - Added support for additional settings including
stopSequences
andtopK
, 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
- AWS Bedrock provider.
- Chrome AI provider (community-maintained).
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
anduseCompletion
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.