Hmbown/CodeWhale · error

Failed to resolve runtime thread route: {reason}

Error message

Failed to resolve runtime thread route: {reason}

What it means

Route resolution for a runtime thread failed while mapping the configured provider and optional model selector to a concrete provider/model route; {reason} names the specific config problem (unknown provider, model, or route).

Source

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

    let bucket = buckets.entry(key.clone()).or_insert_with(|| UsageBucket {
        key,
        ..UsageBucket::default()
    });
    bucket.dropped_usage_records = bucket.dropped_usage_records.saturating_add(dropped);
    bucket.unpriced_turns = bucket.unpriced_turns.saturating_add(dropped);
    bucket.turns = bucket.turns.saturating_add(dropped);
    bucket
        .unpriced_reasons
        .insert("runtime_usage_journal_truncated".to_string());
}

fn resolve_runtime_thread_route(
    config: &Config,
    provider: ApiProvider,
    model_selector: Option<&str>,
) -> Result<ResolvedRuntimeRoute> {
    resolve_runtime_route(config, provider, model_selector)
        .map_err(|reason| anyhow!("Failed to resolve runtime thread route: {reason}"))
}

fn resolve_runtime_thread_route_for_identity(
    config: &Config,
    identity: &ProviderIdentity,
    model_selector: Option<&str>,
) -> Result<ResolvedRuntimeRoute> {
    resolve_runtime_route_for_identity(config, identity, model_selector)
        .map_err(|reason| anyhow!("Failed to resolve runtime thread route: {reason}"))
}

fn runtime_compaction_config(
    provider: ApiProvider,
    model: &str,
    route_limits: Option<codewhale_config::route::RouteLimits>,
    auto_compact: bool,
    auto_compact_explicit: bool,
    threshold_percent: f64,

View on GitHub (pinned to 0c42157ee5)

Solutions

1. Read {reason} and correct the corresponding config entry (provider, model, or route)
2. Verify the provider is configured and the model id is spelled correctly
3. Retry after fixing the route configuration

When it happens

Trigger: Thrown at crates/tui/src/runtime_threads.rs:2363 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/56b4c53848927880. Report an issue: GitHub.