provider-config-validator

# 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

```bash
# 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)

```bash
./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

```bash
./scripts/generate-fix.sh <issue-type> <p