Provider Configuration Validator

Purpose: Autonomously validate, diagnose, and fix Vercel AI SDK provider configurations.

Activation Triggers:

• API errors (401, 403, 429, 404)

• Missing/invalid API keys

• Package installation issues

• Model compatibility errors

• Environment variable problems

• Import/connection failures

Key Resources:

• scripts/validate-provider.sh

• Full validation (packages, keys, env)

• scripts/check-model-compatibility.sh

• Validate model names

• scripts/generate-fix.sh

• Generate fixes for common issues

• scripts/test-provider-connection.sh

• Test real API connection

• examples/troubleshooting-guide.md

• Comprehensive troubleshooting (10+ scenarios)

• templates/

• .env, .gitignore, error handler code templates

Diagnostic Workflow

1. Detect Issue Type

Identify error from symptoms:

• 401/403: Invalid API key → Check key format and env var

• 429: Rate limiting → Add retry logic

• 404/model_not_found: Invalid model → Validate model name

• Cannot find module: Missing package → Install provider SDK

• Missing env var: No .env → Create .env file

• Import error: Wrong syntax → Fix imports for framework

2. Run Validation Script

Main validation - checks everything

./scripts/validate-provider.sh <provider>

Examples:

./scripts/validate-provider.sh openai ./scripts/validate-provider.sh anthropic

Checks performed:

• ✅ Provider package installed (correct version)

• ✅ Core SDK (ai ) installed

• ✅ .env file exists

• ✅ API key set with correct format

• ✅ .env in .gitignore (security)

3. Validate Model Name (if applicable)

./scripts/check-model-compatibility.sh <provider> <model>

Examples:

./scripts/check-model-compatibility.sh openai gpt-4o ./scripts/check-model-compatibility.sh anthropic claude-sonnet-4-5-20250929

Shows valid models if name is wrong, suggests closest matches.

4. Generate Fixes

./scripts/generate-fix.sh <issue-type> <provider>

Issue types:

- missing-api-key → Creates .env with correct format

- wrong-format → Shows valid key format

- missing-package → Installs provider package

- model-compatibility → Lists valid models

- rate-limiting → Adds retry helper with exponential backoff

- import-error → Fixes import statements

5. Test Connection

Verify API credentials work

./scripts/test-provider-connection.sh <provider>

Makes real API call with minimal tokens to verify setup.

Provider-Specific Info

OpenAI:

• Package: @ai-sdk/openai

• Env: OPENAI_API_KEY

• Format: sk-proj-... or sk-...

• Models: gpt-4o, gpt-4o-mini, gpt-4, gpt-3.5-turbo

Anthropic:

• Package: @ai-sdk/anthropic

• Env: ANTHROPIC_API_KEY

• Format: sk-ant-api03-...

• Models: claude-sonnet-4-5-20250929, claude-opus-4-20250514

Google:

• Package: @ai-sdk/google

• Env: GOOGLE_GENERATIVE_AI_API_KEY

• Format: AIza...

• Models: gemini-1.5-pro, gemini-1.5-flash

xAI:

• Package: @ai-sdk/xai

• Env: XAI_API_KEY

• Format: xai-...

• Models: grok-beta, grok-vision-beta

Common Fixes

Missing API Key

Create .env with correct structure

./scripts/generate-fix.sh missing-api-key openai

Then add actual key from provider dashboard

Wrong Model Name

Check valid models

./scripts/check-model-compatibility.sh anthropic claude-v3-opus

Shows: Did you mean? → claude-opus-4-20250514

Rate Limiting

Generate retry helper

./scripts/generate-fix.sh rate-limiting openai

Creates retryHelper.ts with exponential backoff

Package Not Installed

Install provider package

./scripts/generate-fix.sh missing-package anthropic

Runs: npm install ai @ai-sdk/anthropic

Resources

Scripts: All scripts in scripts/ directory are executable and documented in README.md

Templates: templates/ contains .env, .gitignore, and error-handler-template.ts

Examples: examples/troubleshooting-guide.md has detailed solutions for 10+ scenarios including CORS, streaming, TypeScript, and provider-specific issues

Supported Providers: OpenAI, Anthropic, Google, xAI, Groq, Mistral, Cohere, DeepSeek

Version: 1.0.0 SDK Compatibility: Vercel AI SDK 5+