Skip to content

chore(provider/gateway): rename GatewayLanguageModelOptions back to GatewayProviderOptions#13855

Merged
felixarntz merged 3 commits intomainfrom
fa/rename-back-to-gateway-provider-options
Mar 26, 2026
Merged

chore(provider/gateway): rename GatewayLanguageModelOptions back to GatewayProviderOptions#13855
felixarntz merged 3 commits intomainfrom
fa/rename-back-to-gateway-provider-options

Conversation

@felixarntz
Copy link
Copy Markdown
Collaborator

Background

When provider options types were recently renamed from {Provider}ProviderOptions to {Provider}{ModelType}Options across all providers (see #12443), the AI Gateway's type was renamed from GatewayProviderOptions to GatewayLanguageModelOptions. However, unlike other providers, the gateway's options are truly provider-wide (routing, fallbacks, tags, BYOK, etc.) — not specific to any model type. The original name was more accurate.

Summary

  • Renamed GatewayLanguageModelOptions back to GatewayProviderOptions as the primary export, with GatewayLanguageModelOptions kept as a deprecated alias
  • Updated all examples, docs, and type tests to use GatewayProviderOptions
  • Added a note to contributing/providers.md documenting when {Provider}ProviderOptions should be used instead of {Provider}{ModelType}Options

Checklist

  • Tests have been added / updated (for bug fixes / features)
  • Documentation has been added / updated (for bug fixes / features)
  • A patch changeset for relevant packages has been added (for bug fixes / features - run pnpm changeset in the project root)
  • I have reviewed this pull request (self-review)

@tigent tigent bot added ai/provider related to a provider package. Must be assigned together with at least one `provider/*` label deprecation pull requests that introduced a deprecation maintenance CI, internal documentation, automations, etc provider/gateway Issues related to the @ai-sdk/gateway provider labels Mar 26, 2026
@felixarntz felixarntz requested a review from shaper March 26, 2026 19:06
@felixarntz
Copy link
Copy Markdown
Collaborator Author

@tigent why did you add "deprecation"? there's none happening here.

@felixarntz felixarntz added the backport Admins only: add this label to a pull request in order to backport it to the prior version label Mar 26, 2026
@tigent tigent bot removed the deprecation pull requests that introduced a deprecation label Mar 26, 2026
@tigent
Copy link
Copy Markdown

tigent bot commented Mar 26, 2026

labels: ai/provider, provider/gateway, deprecation, maintenance

  • ai/provider: This PR modifies the @ai-sdk/gateway provider package, which falls under provider infrastructure.
  • provider/gateway: The changes are specifically to the @ai-sdk/gateway package, renaming GatewayLanguageModelOptions back to GatewayProviderOptions.
  • deprecation: GatewayLanguageModelOptions is being kept as a deprecated alias for the renamed GatewayProviderOptions, introducing a deprecation.
  • maintenance: This is a rename/refactor chore (as indicated by the 'chore' prefix in the title) with no new functionality added.

removed: deprecation

@felixarntz felixarntz merged commit 4ec78cd into main Mar 26, 2026
37 checks passed
@felixarntz felixarntz deleted the fa/rename-back-to-gateway-provider-options branch March 26, 2026 21:59
vercel-ai-sdk bot pushed a commit that referenced this pull request Mar 26, 2026
…atewayProviderOptions (#13855)

## Background

When provider options types were recently renamed from
`{Provider}ProviderOptions` to `{Provider}{ModelType}Options` across all
providers (see #12443), the AI Gateway's type was renamed from
`GatewayProviderOptions` to `GatewayLanguageModelOptions`. However,
unlike other providers, the gateway's options are truly provider-wide
(routing, fallbacks, tags, BYOK, etc.) — not specific to any model type.
The original name was more accurate.

## Summary

- Renamed `GatewayLanguageModelOptions` back to `GatewayProviderOptions`
as the primary export, with `GatewayLanguageModelOptions` kept as a
deprecated alias
- Updated all examples, docs, and type tests to use
`GatewayProviderOptions`
- Added a note to `contributing/providers.md` documenting when
`{Provider}ProviderOptions` should be used instead of
`{Provider}{ModelType}Options`

## Checklist

- [x] Tests have been added / updated (for bug fixes / features)
- [x] Documentation has been added / updated (for bug fixes / features)
- [x] A _patch_ changeset for relevant packages has been added (for bug
fixes / features - run `pnpm changeset` in the project root)
- [x] I have reviewed this pull request (self-review)
@vercel-ai-sdk vercel-ai-sdk bot removed the backport Admins only: add this label to a pull request in order to backport it to the prior version label Mar 26, 2026
@vercel-ai-sdk
Copy link
Copy Markdown
Contributor

vercel-ai-sdk bot commented Mar 26, 2026

✅ Backport PR created: #13856

vercel-ai-sdk bot added a commit that referenced this pull request Mar 26, 2026
… back to GatewayProviderOptions (#13856)

This is an automated backport of #13855 to the release-v6.0 branch. FYI
@felixarntz

Co-authored-by: Felix Arntz <felix.arntz@vercel.com>
@vercel-ai-sdk
Copy link
Copy Markdown
Contributor

vercel-ai-sdk bot commented Mar 26, 2026

🚀 Published in:

Package Version
ai 7.0.0-beta.43
@ai-sdk/angular 3.0.0-beta.43
@ai-sdk/gateway 4.0.0-beta.23
@ai-sdk/langchain 3.0.0-beta.43
@ai-sdk/llamaindex 3.0.0-beta.43
@ai-sdk/react 4.0.0-beta.43
@ai-sdk/rsc 3.0.0-beta.44
@ai-sdk/svelte 5.0.0-beta.43
@ai-sdk/vue 4.0.0-beta.43

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai/provider related to a provider package. Must be assigned together with at least one `provider/*` label maintenance CI, internal documentation, automations, etc provider/gateway Issues related to the @ai-sdk/gateway provider

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants