@ai-sdk/openai-compatible
3.0.93 · 17 Nov 2026Apache-2.014M / weekRepositoryHomepagenpmAtom feed
3.0.93 is the newest release of 3.x.
In short
5 breaking6 new13 fixed3 internal
- Breaking
Remove CommonJS exports from all packages. All packages are now ESM-only (
"type": "module"). Consumers usingrequire()must switch to ESMimportsyntax. - Breaking
provider: Add support for provider references and uploading files as supported per provider
- Breaking
Start v7 pre-release
- Breaking
Make provider implementations code patterns more consistent, including renaming certain exported symbols
- Breaking
Raise minimum supported Node.js version to 22. Supported versions: 22, 24, and 26.
Release note
Major Changes
- Breaking
Remove CommonJS exports from all packages. All packages are now ESM-only (
"type": "module"). Consumers usingrequire()must switch to ESMimportsyntax. - Breaking
provider: Add support for provider references and uploading files as supported per provider
- Breaking
Start v7 pre-release
- Breaking
Make provider implementations code patterns more consistent, including renaming certain exported symbols
For all externally exported symbols that were renamed, the old names continue to work via deprecated aliases.
Patch Changes
openai-compatible: Buffer tool call deltas until function.name arrives
Add AI Gateway hint to provider READMEs
Migrate providers to support new top-level
reasoningparametervertex: Add grok models to vertex provider
openai-compatible: Honor camelCase providerOptions key in chat and completion models
Accept empty string
rolein streaming delta chunks from OpenAI-compatible providerssecurity: Prevent streaming tool calls from finalizing on parsable partial JSON
Streaming tool call arguments were finalized using
isParsableJson()as a heuristic for completion. If partial accumulated JSON happened to be valid JSON before all chunks arrived, the tool call would be executed with incomplete arguments. Tool call finalization now only occurs inflush()after the stream is fully consumed.Trigger release for all packages after provenance setup
More precise default message for tool execution denial
Revert incorrect fix #13172
openai-compatible: Emit warning when using kebab-case instead of camelCase
- Breaking
Raise minimum supported Node.js version to 22. Supported versions: 22, 24, and 26.
Extract shared
StreamingToolCallTrackerclass into@ai-sdk/provider-utilsto deduplicate streaming tool call handling across OpenAI-compatible providers. Also adds missinggenerateId()fallback fortoolCallIdin Alibaba'sdoGeneratepath and ensures all providers finalize unfinished tool calls during stream flush.Trigger initial canary release
provider: Preserve error type prefix in getErrorMessage
openai, openai-compatible: Only send null content for assistant messages with tool calls
provider: Change file part data property to be tagged with a type and remove the image part type
Trigger initial beta release
Patch - send content: null instead of empty string for tool-only assistant messages
Add workflow serialization support to all provider models.
@ai-sdk/provider-utils: NewserializeModel()helper that extracts only serializable properties from a model instance, filtering out functions and objects containing functions. Third-party provider authors can use this to add workflow support to their own models.All providers:
headersis now optional in provider config types. This is non-breaking — existing code that passesheaderscontinues to work. Custom provider implementations that construct model configs manually can now omitheaders, which is useful when models are deserialized from a workflow step boundary where auth is provided separately.All provider model classes now include
WORKFLOW_SERIALIZEandWORKFLOW_DESERIALIZEstatic methods, enabling them to cross workflow step boundaries without serialization errors.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.