Hmbown/CodeWhale · error

Failed to validate runtime thread route: {reason}

Error message

Failed to validate runtime thread route: {reason}

What it means

The resolved runtime thread route failed its client preflight check ({reason} carries the detail — typically credentials, reachability, or model availability), so the turn is refused before starting.

Source

Thrown at crates/tui/src/runtime_threads.rs:5999

                    .as_setting()
                    .to_string()
            });
            (route, reasoning_effort, auto_controls_reasoning)
        } else {
            (
                resolve_runtime_thread_route_for_identity(
                    &cfg_snapshot,
                    &identity,
                    Some(&requested_model),
                )?,
                None,
                false,
            )
        };
        let route = if client_preflight_required {
            route
                .preflight()
                .map_err(|reason| anyhow!("Failed to validate runtime thread route: {reason}"))?
        } else {
            route
        };
        let configured_sandbox_mode = route.config.sandbox_mode.clone();
        let provider = route.identity.provider;
        let provider_identity = route.identity.clone();
        let model = route.model.clone();
        let route_limits = known_route_limits(route.candidate.limits());
        let settings = crate::settings::Settings::load().unwrap_or_default();
        let mut compaction = runtime_compaction_config(
            provider,
            &model,
            route_limits,
            settings.auto_compact,
            crate::settings::Settings::auto_compact_explicitly_configured(),
            settings.auto_compact_threshold_percent,
        );
        let now = Utc::now();

View on GitHub (pinned to 0c42157ee5)

Solutions

1. Read {reason} and fix the underlying credential or connectivity issue
2. Verify the provider endpoint and model are available
3. Retry the request once the preflight cause is resolved

When it happens

Trigger: Thrown at crates/tui/src/runtime_threads.rs:5999 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Hmbown/CodeWhale@0c42157ee5 (2026-08-20). Data as JSON: /api/errors/a753891c80bca144. Report an issue: GitHub.