docs(config): fix runtime fallback documentation

Remove duplicate Runtime Fallback section from configurations.md.

Fix max_fallback_attempts range from (1-10) to (1-20) to match schema.

Update retry_on_errors default to include 400 status code.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
Youngbin Kim 2026-02-17 16:29:29 -05:00 committed by YeonGyu-Kim
parent c54da1e670
commit 22dda6178a

View File

@ -723,7 +723,7 @@ Automatically switch to backup models when the primary model encounters retryabl
{ {
"runtime_fallback": { "runtime_fallback": {
"enabled": true, "enabled": true,
"retry_on_errors": [429, 503, 529], "retry_on_errors": [400, 429, 503, 529],
"max_fallback_attempts": 3, "max_fallback_attempts": 3,
"cooldown_seconds": 60, "cooldown_seconds": 60,
"timeout_seconds": 30, "timeout_seconds": 30,
@ -733,10 +733,10 @@ Automatically switch to backup models when the primary model encounters retryabl
``` ```
| Option | Default | Description | | Option | Default | Description |
| ----------------------- | ----------------- | --------------------------------------------------------------------------- | | ----------------------- | ---------------------- | --------------------------------------------------------------------------- |
| `enabled` | `true` | Enable runtime fallback | | `enabled` | `true` | Enable runtime fallback |
| `retry_on_errors` | `[429, 503, 529]` | HTTP status codes that trigger fallback (rate limit, service unavailable). Also supports certain classified provider errors (for example, missing API key) that do not expose HTTP status codes. | | `retry_on_errors` | `[400, 429, 503, 529]` | HTTP status codes that trigger fallback (rate limit, service unavailable). Also supports certain classified provider errors (for example, missing API key) that do not expose HTTP status codes. |
| `max_fallback_attempts` | `3` | Maximum fallback attempts per session (1-10) | | `max_fallback_attempts` | `3` | Maximum fallback attempts per session (1-20) |
| `cooldown_seconds` | `60` | Cooldown in seconds before retrying a failed model | | `cooldown_seconds` | `60` | Cooldown in seconds before retrying a failed model |
| `timeout_seconds` | `30` | Timeout in seconds for an in-flight fallback request before forcing the next fallback model. Set to `0` to disable timeout-based fallback and provider quota retry signal detection. | | `timeout_seconds` | `30` | Timeout in seconds for an in-flight fallback request before forcing the next fallback model. Set to `0` to disable timeout-based fallback and provider quota retry signal detection. |
| `notify_on_fallback` | `true` | Show toast notification when switching to a fallback model | | `notify_on_fallback` | `true` | Show toast notification when switching to a fallback model |