NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #3484 most downloaded on npm
Latest stable
4.0.114
Last release 7 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Some releases are documented
notes for 31 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
795 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
@ai-sdk/provider-utils@5.0.0-canary.44
17b5597: fix(openai): skip passing reasoning items when using previous response id
Your coding agent can read these notes before it upgrades. Set up the MCP server →
bf837fe: feat(provider/gateway): add speech and transcription model support
7fc6bd6: Raise minimum supported Node.js version to 22. Supported versions: 22, 24, and 26.
685cec7: feat(openai): add opt-in pass-through for unsupported file media types
@ai-sdk/provider-utils@5.0.0-canary.41
@ai-sdk/provider-utils@5.0.0-canary.40
@ai-sdk/provider-utils@5.0.0-canary.39
@ai-sdk/provider-utils@5.0.0-canary.38
@ai-sdk/provider-utils@5.0.0-canary.37
@ai-sdk/provider-utils@5.0.0-canary.36
@ai-sdk/provider-utils@5.0.0-canary.35
@ai-sdk/provider-utils@5.0.0-canary.34
29e6ac6: feat: add allowedTools provider option for OpenAI Responses
7bbc194: feat(provider/openai): forward imageDetail providerOptions on tool-result image content
d6c79e3: feat(openai): add GPT-5.5 chat model IDs
5463d0d: feat(provider): align tool result output content file part types with top-level message file part types
cd9c311: fix(openai, openai-compatible): only send null content for assistant messages with tool calls
0c4c275: trigger initial canary release
@ai-sdk/provider-utils@5.0.0-beta.50
2c4767d: feat(openai): add orchestration token usage details to Responses API usage
1772a63: Default OpenAI Responses reasoning summaries to detailed when reasoning effort is enabled.
b8396f0: trigger initial beta release
bada0f3: feat(openai): preserve namespace on function_call output items
namespace on function_call output itemsFor all externally exported symbols that were renamed, the old names continue to work via deprecated aliases.
04e9009: chore: 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.
9bd6512: feat(provider): change file part data property to be tagged with a type and remove the image part type
9f0e36c: trigger release for all packages after provenance setup
58a2ad7: fix: more precise default message for tool execution denial
bfb756d: patch - send content: null instead of empty string for tool-only assistant messages
@ai-sdk/provider-utils@5.0.0-beta.25
f807e45: Extract shared StreamingToolCallTracker class into @ai-sdk/provider-utils to deduplicate streaming tool call handling across OpenAI-compatibl
StreamingToolCallTracker class into @ai-sdk/provider-utils to deduplicate streaming tool call handling across OpenAI-compatible providers. Also adds missing generateId() fallback for toolCallId in Alibaba's doGenerate path and ensures all providers finalize unfinished tool calls during stream flush.@ai-sdk/provider-utils@5.0.0-beta.23
@ai-sdk/provider-utils@5.0.0-beta.22
@ai-sdk/provider-utils@5.0.0-beta.21
0c4ac8a: fix(openai): default undefined tool-call input to empty object before serializing tool arguments
b3976a2: Add workflow serialization support to all provider models.
b3976a2: Add workflow serialization support to all provider models.
@ai-sdk/provider-utils: New serializeModel() 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: headers is now optional in provider config types. This is non-breaking — existing code that passes headers continues to work. Custom provider implementations that construct model configs manually can now omit headers, which is useful when models are deserialized from a workflow step boundary where auth is provided separately.
All provider model classes now include WORKFLOW_SERIALIZE and WORKFLOW_DESERIALIZE static methods, enabling them to cross workflow step boundaries without serialization errors.
ff5eba1: feat: roll image-* tool output types into their equivalent file-* types
Updated dependencies [b3976a2]
Updated dependencies [ff5eba1]
ef992f8: Remove CommonJS exports from all packages. All packages are now ESM-only ("type": "module"). Consumers using require() must switch to ESM imp
"type": "module"). Consumers using require() must switch to ESM import syntax.90e2d8a: chore: fix unused vars not being flagged by our lint tooling
@ai-sdk/provider-utils@5.0.0-beta.17
@ai-sdk/provider-utils@5.0.0-beta.16
e311194: feat(ai): allow passing provider instance to uploadFile and uploadSkill as shorthand
uploadFile and uploadSkill as shorthand34bd95d: feat(ai): add support for uploading provider skills using the provider references abstraction
@ai-sdk/provider-utils@5.0.0-beta.12
6fd51c0: fix(provider): preserve error type prefix in getErrorMessage
c29a26f: feat(provider): add support for provider references and uploading files as supported per provider
38fc777: Add AI Gateway hint to provider READMEs
@ai-sdk/provider-utils@5.0.0-beta.9
@ai-sdk/provider-utils@5.0.0-beta.8
817a1a6: fix(openai): support file-url parts in tool output content
1f509d4: fix(ai): force template check on 'kind' param
365da1a: Add gpt-5.4-mini, gpt-5.4-mini-2026-03-17, gpt-5.4-nano, and gpt-5.4-nano-2026-03-17 models.
gpt-5.4-mini, gpt-5.4-mini-2026-03-17, gpt-5.4-nano, and gpt-5.4-nano-2026-03-17 models.3887c70: feat(provider): add new top-level reasoning parameter to spec and support it in generateText and streamText
generateText and streamTextd9a1e9a: feat(openai): add server side compaction for openai
@ai-sdk/provider-utils@5.0.0-beta.5
61753c3: ### @ai-sdk/openai: remove redundant name argument from openai.tools.customTool()
61753c3: ### @ai-sdk/openai: remove redundant name argument from openai.tools.customTool()
openai.tools.customTool() no longer accepts a name field. the tool name is now derived from the sdk tool key (the object key in the tools object).
migration: remove the name property from customTool() calls. the object key is now used as the tool name sent to the openai api.
before:
tools: {
write_sql: openai.tools.customTool({
name: 'write_sql',
description: '...',
}),
}
after:
tools: {
write_sql: openai.tools.customTool({
description: '...',
}),
}
@ai-sdk/provider-utils: createToolNameMapping() no longer accepts the resolveProviderToolName parameterbefore: tool name can be set dynamically
const toolNameMapping = createToolNameMapping({
tools,
providerToolNames: {
"openai.code_interpreter": "code_interpreter",
"openai.file_search": "file_search",
"openai.image_generation": "image_generation",
"openai.local_shell": "local_shell",
"openai.shell": "shell",
"openai.web_search": "web_search",
"openai.web_search_preview": "web_search_preview",
"openai.mcp": "mcp",
"openai.apply_patch": "apply_patch",
},
resolveProviderToolName: (tool) =>
tool.id === "openai.custom"
? (tool.args as { name?: string }).name
: undefined,
});
after: tool name is static based on tools keys
const toolNameMapping = createToolNameMapping({
tools,
providerToolNames: {
'openai.code_interpreter': 'code_interpreter',
'openai.file_search': 'file_search',
'openai.image_generation': 'image_generation',
'openai.local_shell': 'local_shell',
'openai.shell': 'shell',
'openai.web_search': 'web_search',
'openai.web_search_preview': 'web_search_preview',
'openai.mcp': 'mcp',
'openai.apply_patch': 'apply_patch',
}
});
156cdf0: feat(openai): add new tool search tool
@ai-sdk/provider-utils@5.0.0-beta.3
@ai-sdk/provider-utils@5.0.0-beta.2
83f9d04: feat(openai): upgrade v3 specs to v4
ac18f89: feat(provider/openai): add gpt-5.3-chat-latest
gpt-5.3-chat-latestOne column per month.