-
-
Notifications
You must be signed in to change notification settings - Fork 1
Open
Open
improvement: Better error messages for common issues#35
Description
Summary
Improve error messages to be more helpful and actionable for common issues users encounter.
Current Issues
1. Rate Limit Errors
Current: FallbackExhaustedError: All models exhausted...
Proposed: More detailed with specific next steps:
All AI models are currently rate-limited
What happened:
* Your Puter account hit its usage limit
* All 20 fallback models are also rate-limited
What to try:
1. Wait 5-10 minutes and try again
2. Switch to a different OpenRouter :free model
3. Add credits to your Puter account at puter.com
4. Create a new Puter account (gets fresh free credits)
5. Run 'npx opencode-puter-auth login' to add another account
Technical details:
* Models tried: 20
* Error types: rate_limit (18), forbidden (2)
* Cooldowns expire in: 45 seconds
2. Authentication Errors
Current: Not authenticated
Proposed:
Puter authentication required
Run this command to authenticate:
npx opencode-puter-auth login
This will open a browser window to sign in with your Puter account.
3. Model Not Found Errors
Already improved in #26 with :free suffix auto-strip, but could add more context.
Implementation
- Create an error formatter utility
- Add emoji indicators for error types
- Include actionable next steps in all error messages
- Show relevant documentation links