From 22dda6178a0759745af5fb2d6acb3fc1e4b055ca Mon Sep 17 00:00:00 2001 From: Youngbin Kim <64558592+youngbinkim0@users.noreply.github.com> Date: Tue, 17 Feb 2026 16:29:29 -0500 Subject: [PATCH] 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 --- docs/configurations.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/configurations.md b/docs/configurations.md index 631b381a9..ef0c36170 100644 --- a/docs/configurations.md +++ b/docs/configurations.md @@ -723,7 +723,7 @@ Automatically switch to backup models when the primary model encounters retryabl { "runtime_fallback": { "enabled": true, - "retry_on_errors": [429, 503, 529], + "retry_on_errors": [400, 429, 503, 529], "max_fallback_attempts": 3, "cooldown_seconds": 60, "timeout_seconds": 30, @@ -732,14 +732,14 @@ Automatically switch to backup models when the primary model encounters retryabl } ``` -| Option | Default | Description | -| ----------------------- | ----------------- | --------------------------------------------------------------------------- | -| `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. | -| `max_fallback_attempts` | `3` | Maximum fallback attempts per session (1-10) | -| `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. | -| `notify_on_fallback` | `true` | Show toast notification when switching to a fallback model | +| Option | Default | Description | +| ----------------------- | ---------------------- | --------------------------------------------------------------------------- | +| `enabled` | `true` | Enable runtime fallback | +| `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-20) | +| `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. | +| `notify_on_fallback` | `true` | Show toast notification when switching to a fallback model | ### How It Works