From aee259ebd5ba1c2f8f3d363ec6d1b35fae0380c9 Mon Sep 17 00:00:00 2001 From: Michael Gasperini Date: Tue, 22 Sep 2026 19:56:50 +0200 Subject: [PATCH 1/2] docs: add Troubleshooting FAQ and Dependabot config Add README Troubleshooting section covering missing CHUTES_API_KEY, model-pool routing errors, and Windows console glyph degradation, each grounded in docs/configuration.md, glyphs.rs, and CI env. Add .github/dependabot.yml with cargo, npm, and github-actions ecosystems on a weekly grouped schedule. --- .github/dependabot.yml | 26 ++++++++++++++++++++++++ README.md | 45 +++++++++++++++++++++++++++++++++++++++++- 2 files changed, 70 insertions(+), 1 deletion(-) create mode 100644 .github/dependabot.yml diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 00000000..adc16fde --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,26 @@ +version: 2 +updates: + - package-ecosystem: cargo + directory: / + schedule: + interval: weekly + groups: + rust-dependencies: + patterns: + - "*" + - package-ecosystem: npm + directory: / + schedule: + interval: weekly + groups: + npm-dependencies: + patterns: + - "*" + - package-ecosystem: github-actions + directory: / + schedule: + interval: weekly + groups: + github-actions: + patterns: + - "*" diff --git a/README.md b/README.md index 81a6d003..5d36fd4f 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,7 @@ embedded in editors via the Agent Client Protocol (ACP). [Documentation](#documentation) · [Repository layout](#repository-layout) · [Development](#development) · +[Troubleshooting](#troubleshooting) · [Contributing](#contributing) · [License](#license) @@ -144,9 +145,51 @@ MCP servers, skills, plugins, hooks, headless mode, sandboxing, and more. cargo check -p # always target specific crates; full-workspace builds are slow cargo test -p xai-grok-config # per-crate tests cargo clippy -p # lint config: clippy.toml at the repo root -cargo fmt --all # rustfmt.toml at the repo root ``` +## Troubleshooting + +### Missing `CHUTES_API_KEY` + +On first launch `chutes-build` asks for a Chutes API key (created at +[chutes.ai/app/api](https://chutes.ai/app/api)); it is also readable from the +`CHUTES_API_KEY` environment variable. If requests fail with authentication +errors, check that the variable is exported in the launching shell — Chutes +Build reads the process environment and does not load `.env` files +automatically (see [`docs/configuration.md`](docs/configuration.md)). +Never commit a real key; use your shell, CI platform, or secret manager to +provide it, and run `chutes-build inspect --json` to verify the effective +non-secret configuration. + +### Model-pool routing errors + +The default model route is Chutes' native routing: the saved `default` pool +(managed at chutes.ai/app → Model Routing), or an inline pool via +`CHUTES_ROUTING_POOL` (comma-separated catalogue ids sent as one `model` +value, e.g. `modelA,modelB,modelC`). If the `default` alias cannot resolve +and no dashboard pool is saved, the built-in fallback chain steps down to a +live inline pool from the current catalogue; a saved dashboard pool, once +configured, takes priority. Common fixes: save a pool on the dashboard, set +`CHUTES_ROUTING_POOL` explicitly, check `CHUTES_FALLBACK_MODELS` ordering (or +`CHUTES_STRICT_MODEL=1`, which disables automatic fallback), and pick a +strategy with `CHUTES_ROUTING_STRATEGY` (`sequential` default, `latency`, or +`throughput`). Full reference: [`docs/configuration.md`](docs/configuration.md) +("Native model routing"). + +### Windows console shows wrong glyphs + +The TUI degrades decorative glyphs on the legacy Windows console (ConHost +`cmd.exe` / `powershell.exe`, Consolas/Lucida Console raster font, no font +fallback): arrows, checkmarks, diamonds, and spinners fall back to ASCII or +CP437-safe stand-ins (see +[`crates/codegen/xai-grok-pager-render/src/glyphs.rs`](crates/codegen/xai-grok-pager-render/src/glyphs.rs)). +This is expected on legacy ConHost — for the full rendering use Windows +Terminal, VS Code's terminal, or another modern emulator. Note that CI forces +the modern-glyph path with `CHUTES_BUILD_FORCE_LEGACY_CONSOLE=0` (see +[`.github/workflows/ci.yml`](.github/workflows/ci.yml)), so screenshots and +test rendering may look richer than a legacy local console. + + ## Contributing > [!NOTE] From 31690d58c412845de8ed72632955243ac38b2095 Mon Sep 17 00:00:00 2001 From: TheStreamCode Date: Tue, 22 Sep 2026 21:11:40 +0200 Subject: [PATCH 2/2] chore(deps): bump rustls 0.23.37 -> 0.23.45 to fix RUSTSEC-2026-0285 cargo-deny 'advisories' failed on rustls 0.23.37 (RUSTSEC-2026-0285: TLS 1.3 handshake messages accepted across encryption level boundaries; GHSA-2mjx-qc3c-rqvc). Advisory solution is upgrade to >=0.23.45, applied via 'cargo update -p rustls'. The resolver also moved companion crates aws-lc-rs 1.16.2 -> 1.18.1, aws-lc-sys 0.39.1 -> 0.45.0 and rustls-webpki 0.103.13 -> 0.103.15. No allowlist entry added: a patched release exists, so a bump (not an ignore) is the correct fix per deny.toml policy. Local verification: cargo-deny 0.20.2 'check advisories licenses bans sources' -> advisories ok, bans ok, licenses ok, sources ok. --- Cargo.lock | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index 3486bc9f..af7a9c6f 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -738,9 +738,9 @@ dependencies = [ [[package]] name = "aws-lc-rs" -version = "1.16.2" +version = "1.18.1" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a054912289d18629dc78375ba2c3726a3afe3ff71b4edba9dedfca0e3446d1fc" +checksum = "b281d307588d634de920874890732659e2e7672f72b5e10e81badc1a8a83621e" dependencies = [ "aws-lc-sys", "untrusted 0.7.1", @@ -749,14 +749,15 @@ dependencies = [ [[package]] name = "aws-lc-sys" -version = "0.39.1" +version = "0.45.0" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "83a25cf98105baa966497416dbd42565ce3a8cf8dbfd59803ec9ad46f3126399" +checksum = "9bff6c3b54fad79a2e60b8102caf565819711497c1f5f092f49508e2f5c31b27" dependencies = [ "cc", "cmake", "dunce", "fs_extra", + "pkg-config", ] [[package]] @@ -9227,9 +9228,9 @@ dependencies = [ [[package]] name = "rustls" -version = "0.23.37" +version = "0.23.45" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "758025cb5fccfd3bc2fd74708fd4682be41d99e5dff73c377c0646c6012c73a4" +checksum = "0d41d731c7d2f962d1ccc364cec258de3c0e93b38c2fb3ba97ac74513048d634" dependencies = [ "aws-lc-rs", "log", @@ -9292,9 +9293,9 @@ checksum = "f87165f0995f63a9fbeea62b64d10b4d9d8e78ec6d7d51fb2125fda7bb36788f" [[package]] name = "rustls-webpki" -version = "0.103.13" +version = "0.103.15" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e" +checksum = "f3c3cf1d8b1e7d4927e2d154c3fcb02979afb9939629c62cd9048d4f07b60ac2" dependencies = [ "aws-lc-rs", "ring",