fix(gateway): log friendly user message in non-production environments if `AI_GATEWAY_API_KEY` is not configured by gr2m · Pull Request #11113 · vercel/ai

gr2m · 2025-12-11T23:45:18Z

Summary

this PR changes

to

Manual Verification

Tested locally

Checklist

(see future work below) Tests have been added / updated (for bug
fixes / features)
n/a 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)

Future Work

Add tests that cover this error case in local/production
environments

…s if `AI_GATEWAY_API_KEY` is not configured

packages/ai/src/prompt/wrap-gateway-error.ts

gr2m · 2025-12-12T00:16:58Z

packages/ai/src/prompt/wrap-gateway-error.ts

+    'Learn more: \u001b[34mhttps://vercel.link/unauthenticated-ai-gateway-v6\u001b[0m\n',
+  );
+
+  process.exit(1);


I wonder if we would throw prettyErrorMessage instead of using process.exit() (where prettyErrorMessage is the full string with colors that currently gets logged out). We would still get a pretty message, but in a dev server environment it wouldn't kill the process

would look like this

alternatively, throwing an error with stack set to ''

lgrammel

I think it is important to keep the stack traces. Maybe it can be pruned? a nicer message is great

gr2m · 2025-12-12T16:10:31Z

For pruning I really like https://github.com/sindresorhus/clean-stack but we won't bring in new dependencies just for that, even if Sindre's modules are small and high quality.

I'd just limit the number of stack lines to 5

gr2m · 2025-12-12T16:54:30Z

packages/ai/src/prompt/wrap-gateway-error.ts

+  if (!GatewayAuthenticationError.isInstance(error)) return error;
+
+  const isProductionEnv = process?.env.NODE_ENV === 'production';
+  const moreInfoURL = 'https://vercel.link/unauthenticated-ai-gateway-v6';


we are adding redirects to ai-sdk.dev right now

wait until these work:

http://ai-sdk.dev/unauthenticated-ai-gateway

http://v6.ai-sdk.dev/unauthenticated-ai-gateway

lgrammel · 2025-12-12T17:18:55Z

packages/ai/src/prompt/wrap-gateway-error.ts

+  // prune the stack to 5 lines for clarity
+  if (devEnvironmentError.stack) {
+    devEnvironmentError.stack = devEnvironmentError.stack
+      .split('\n')
+      .slice(0, 6)
+      .join('\n');
+  }


hm how would this look like in practice? we do not know how deep the user side stack trace is.

packages/ai/src/prompt/wrap-gateway-error.ts

lgrammel · 2025-12-12T17:27:42Z

packages/ai/src/prompt/wrap-gateway-error.ts

+  if (!GatewayAuthenticationError.isInstance(error)) return error;
+
+  const isProductionEnv = process?.env.NODE_ENV === 'production';
+  const moreInfoURL = 'http://v6.ai-sdk.dev/unauthenticated-ai-gateway';


@nicoalbanese stable path issue here?

… further

gr2m · 2025-12-12T17:58:55Z

packages/ai/src/prompt/wrap-gateway-error.ts

+  if (!GatewayAuthenticationError.isInstance(error)) return error;
+
+  const isProductionEnv = process?.env.NODE_ENV === 'production';
+  const moreInfoURL = 'https://v6.ai-sdk.dev/unauthenticated-ai-gateway';


will change to 'https://ai-sdk.dev/unauthenticated-ai-gateway' in backport to v5

vercel-ai-sdk · 2025-12-12T19:42:21Z

⚠️ Backport to release-v5.0 created but has conflicts: #11137

…nvironments if `AI_GATEWAY_API_KEY` is not configured (#11137) This is an automated backport of #11113 to the release-v5.0 branch. --------- Co-authored-by: Gregor Martynus <39992+gr2m@users.noreply.github.com>

fix(gateway): log friendly user message in non-production environment…

32569b8

…s if `AI_GATEWAY_API_KEY` is not configured

github-actions bot assigned gr2m Dec 11, 2025

vercel-ai-sdk bot added the ai/gateway label Dec 11, 2025

docs: changeset

a3d06ec

gr2m marked this pull request as draft December 11, 2025 23:46

vercel bot deployed to Preview December 11, 2025 23:49 View deployment

vercel bot reviewed Dec 11, 2025

View reviewed changes

packages/ai/src/prompt/wrap-gateway-error.ts Outdated Show resolved Hide resolved

style: prettier

f9e5f67

vercel bot deployed to Preview December 11, 2025 23:55 View deployment

gr2m mentioned this pull request Dec 11, 2025

fix(gateway): remove cause from custom handling of GatewayAuthenticationError error #11111

Closed

gr2m requested a review from lgrammel December 11, 2025 23:56

gr2m commented Dec 12, 2025

View reviewed changes

throw error without stack

c5d17cb

vercel bot had a problem deploying to Preview December 12, 2025 04:37 Failure

lgrammel reviewed Dec 12, 2025

View reviewed changes

limit error stack in dev environment to 5 lines

e5258b9

vercel bot deployed to Preview December 12, 2025 16:17 View deployment

gr2m added 2 commits December 12, 2025 08:29

Update dry-grapes-sleep.md

0c4cf81

single place to configure more info URL

901ebff

vercel bot deployed to Preview December 12, 2025 16:32 View deployment

gr2m marked this pull request as ready for review December 12, 2025 16:50

gr2m commented Dec 12, 2025

View reviewed changes

gr2m marked this pull request as draft December 12, 2025 16:54

gr2m added 2 commits December 12, 2025 08:57

style: prettier

6adeffb

use ai-sdk.dev URL

7e54255

lgrammel reviewed Dec 12, 2025

View reviewed changes

lgrammel approved these changes Dec 12, 2025

View reviewed changes

lgrammel reviewed Dec 12, 2025

View reviewed changes

packages/ai/src/prompt/wrap-gateway-error.ts Outdated Show resolved Hide resolved

lgrammel reviewed Dec 12, 2025

View reviewed changes

do not mess with .stack for now. Use native Error to reduce noise…

6fad09e

… further

vercel bot deployed to Preview December 12, 2025 17:49 View deployment

"configure and use a provider module" -> "use a provider module"

bea63fb

vercel bot deployed to Preview December 12, 2025 17:52 View deployment

gr2m marked this pull request as ready for review December 12, 2025 17:53

return not throw

44ec4e0

vercel bot deployed to Preview December 12, 2025 17:57 View deployment

https

a58bb65

gr2m commented Dec 12, 2025

View reviewed changes

vercel bot deployed to Preview December 12, 2025 17:59 View deployment

remove line break and repetitive Error:

46e7b39

vercel bot deployed to Preview December 12, 2025 19:05 View deployment

remove one line break above stack

7935109

vercel bot deployed to Preview December 12, 2025 19:09 View deployment

gr2m enabled auto-merge (squash) December 12, 2025 19:13

style: prettier

fdc76e2

vercel bot deployed to Preview December 12, 2025 19:16 View deployment

gr2m disabled auto-merge December 12, 2025 19:17

gr2m enabled auto-merge (squash) December 12, 2025 19:17

gr2m merged commit 4e2b04d into main Dec 12, 2025
19 checks passed

gr2m deleted the friendly-message-on-gateway-unauthenticated branch December 12, 2025 19:18

gr2m added the backport Admins only: add this label to a pull request in order to backport it to the prior version label Dec 12, 2025

vercel-ai-sdk bot pushed a commit that referenced this pull request Dec 12, 2025

Backport conflicts for PR #11113 to release-v5.0

86519bc

vercel-ai-sdk bot mentioned this pull request Dec 12, 2025

Backport: fix(gateway): log friendly user message in non-production environments if AI_GATEWAY_API_KEY is not configured #11137

Merged

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 Dec 12, 2025

gr2m added ai/provider related to a provider package. Must be assigned together with at least one `provider/*` label provider/gateway Issues related to the @ai-sdk/gateway provider and removed ai/gateway labels Mar 6, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(gateway): log friendly user message in non-production environments if `AI_GATEWAY_API_KEY` is not configured#11113

fix(gateway): log friendly user message in non-production environments if `AI_GATEWAY_API_KEY` is not configured#11113
gr2m merged 16 commits intomainfrom
friendly-message-on-gateway-unauthenticated

gr2m commented Dec 11, 2025 •

edited

Loading

Uh oh!

Uh oh!

gr2m Dec 12, 2025 •

edited

Loading

Uh oh!

gr2m Dec 12, 2025

Uh oh!

gr2m Dec 12, 2025

Uh oh!

lgrammel left a comment

Uh oh!

gr2m commented Dec 12, 2025

Uh oh!

gr2m Dec 12, 2025

Uh oh!

gr2m Dec 12, 2025

Uh oh!

lgrammel Dec 12, 2025

Uh oh!

Uh oh!

lgrammel Dec 12, 2025

Uh oh!

gr2m Dec 12, 2025 •

edited

Loading

Uh oh!

Uh oh!

vercel-ai-sdk bot commented Dec 12, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

gr2m commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Manual Verification

Checklist

Future Work

Uh oh!

Uh oh!

gr2m Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gr2m Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

gr2m Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

lgrammel left a comment

Choose a reason for hiding this comment

Uh oh!

gr2m commented Dec 12, 2025

Uh oh!

gr2m Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

gr2m Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

lgrammel Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lgrammel Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

gr2m Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vercel-ai-sdk bot commented Dec 12, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gr2m commented Dec 11, 2025 •

edited

Loading

gr2m Dec 12, 2025 •

edited

Loading

gr2m Dec 12, 2025 •

edited

Loading