updates

1 files changed, 169 insertions, 0 deletions

diff --git a/tooling/vercel-ai-sdk/.claude/commands/ai-provider-setup.md b/tooling/vercel-ai-sdk/.claude/commands/ai-provider-setup.md
new file mode 100644
index 0000000..0d83374
--- /dev/null
+++ b/tooling/vercel-ai-sdk/.claude/commands/ai-provider-setup.md
@@ -0,0 +1,169 @@
+---
+allowed-tools: Read, Write, Edit, MultiEdit, Bash
+description: Configure AI providers and multi-provider setup
+argument-hint: "[single|multi|fallback] [anthropic|openai|google|cohere]"
+---
+
+## Set up AI Provider Configuration
+
+Configure robust AI provider setup with the Vercel AI SDK: $ARGUMENTS
+
+### Current Configuration Analysis
+
+Existing provider setup: !`grep -r "@ai-sdk/" . --include="*.ts" --include="*.tsx" | head -5`
+
+Environment variables: !`grep -r "API_KEY\|_KEY" .env* 2>/dev/null | head -5 || echo "No API keys found in .env files"`
+
+Provider imports: !`grep -r "from '@ai-sdk/" . --include="*.ts" | head -10`
+
+### Configuration Strategy
+
+**Single Provider**: Focus on one provider with optimal configuration
+**Multi Provider**: Set up multiple providers with consistent interface
+**Fallback**: Implement automatic failover between providers
+
+### Your Task
+
+1. **Analyze current provider setup** and identify improvements needed
+2. **Design provider architecture** with proper abstraction layers
+3. **Implement configuration management** with environment handling
+4. **Set up provider fallback logic** for reliability
+5. **Add usage tracking and cost monitoring** for optimization
+6. **Create provider health checks** for monitoring
+7. **Implement proper error handling** and recovery
+8. **Add comprehensive testing** for all providers
+
+### Implementation Requirements
+
+#### Environment Configuration
+
+- Secure API key management
+- Environment-specific configurations
+- Provider availability detection
+- Default provider selection
+- Feature flag support for provider switching
+
+#### Provider Abstraction
+
+- Unified interface across all providers
+- Model capability mapping
+- Feature detection and adaptation
+- Consistent error handling
+- Performance monitoring integration
+
+#### Fallback and Reliability
+
+- Automatic provider failover
+- Health check implementation
+- Circuit breaker patterns
+- Retry logic with exponential backoff
+- Graceful degradation strategies
+
+### Expected Deliverables
+
+1. **Provider configuration system** with environment management
+2. **Multi-provider client wrapper** with unified interface
+3. **Fallback and health monitoring** implementation
+4. **Usage tracking and analytics** system
+5. **Cost optimization utilities** for model selection
+6. **Testing suite** covering all provider scenarios
+7. **Documentation** with setup guides and best practices
+
+### Provider-Specific Optimizations
+
+#### Anthropic Configuration
+
+- Claude model selection (Haiku, Sonnet, Opus, Claude 4)
+- Extended thinking capabilities setup
+- Prompt caching configuration
+- Tool use optimization
+- Context window management
+
+#### OpenAI Configuration
+
+- Model selection (GPT-3.5, GPT-4, GPT-4o, O1)
+- Responses API integration
+- Function calling optimization
+- Structured output configuration
+- Built-in tool integration (web search)
+
+#### Google Configuration
+
+- Gemini model variants setup
+- Search grounding capabilities
+- Multimodal processing optimization
+- Safety settings configuration
+- Thinking mode integration
+
+#### Cohere Configuration
+
+- Command model setup
+- RAG optimization
+- Embedding integration
+- Multilingual support
+- Custom model fine-tuning
+
+### Cost Management
+
+#### Usage Tracking
+
+- Token usage monitoring across providers
+- Cost calculation and reporting
+- Budget limits and alerting
+- Usage pattern analysis
+- Optimization recommendations
+
+#### Model Selection
+
+- Intelligent model routing based on task complexity
+- Cost-performance optimization
+- Usage-based provider selection
+- Dynamic model switching
+- A/B testing for provider performance
+
+### Security and Compliance
+
+#### API Key Management
+
+- Secure key storage and rotation
+- Environment variable validation
+- Access control and permissions
+- Audit logging for API usage
+- Compliance reporting
+
+#### Data Privacy
+
+- Request/response logging controls
+- Data retention policies
+- Regional data handling
+- Privacy-preserving configurations
+- Compliance monitoring
+
+### Monitoring and Observability
+
+#### Health Monitoring
+
+- Provider availability checks
+- Latency and performance monitoring
+- Error rate tracking
+- Success rate analysis
+- Capacity utilization monitoring
+
+#### Analytics and Reporting
+
+- Usage dashboards and reports
+- Cost analysis and forecasting
+- Performance benchmarking
+- User behavior analysis
+- Provider comparison metrics
+
+### Testing Strategy
+
+- Provider connectivity tests
+- Failover scenario testing
+- Performance and load testing
+- Cost calculation validation
+- Security and compliance testing
+- Integration testing with applications
+
+Focus on building a robust, cost-effective, and reliable multi-provider architecture that ensures high availability and optimal performance while maintaining security and compliance standards.