20. Error messages
[!ref] Full details in the User Manual, "Troubleshooting and FAQ".
Common messages and how to respond:
| Message | Meaning | Action |
|---|---|---|
| Service not ready | Subprocess still warming up | Wait 30 s; otherwise see error drawer |
| Tool call denied | Tool disabled / approval rejected / path out of bounds | Check tool policy and path scope |
| Model timeout | LLM hasn't responded for a while | Resend or switch to fallback Provider |
| Empty model response | LLM produced no output | Usually a filter trigger; rephrase the prompt |
| Context too long | Approaching model context limit | Trigger compaction or new session |
| Workspace locked | Already held by another process | Wait or restart app |
| Credential expired | Login token invalid | Sign in again |
| Insufficient points (HTTP 402) | Account points exhausted | "Buy vouchers" (voucher wording, consistent with account usage / server-side billing — not "top up / reset / balance"; no longer retried as transient) |
| Plan quota exhausted (HTTP 429) | Plan quota out | "Wait for refresh or upgrade" (no longer mistaken for rate limit) |
| Auth failed (HTTP 401 / 403) | Sign-in needed / key invalid | "Sign in again or replace your key" |
| No channel available (HTTP 503) | All channels unusable | Retry later or switch model |
| Upstream error (HTTP 502 / 529 / overloaded) | Upstream issue | Reports honestly; upstream auth failure no longer misleads you |
Provider endpoint not found (HTTP 404, endpoint_not_found_error) |
URL path wrong | Check the Provider Base URL |
| macOS App Translocation | App running in read-only temporary image (not dragged into Applications) | "Quit → drag to Applications → reopen → check for updates again" |
| Channel disconnected | IM channel offline | Auto-retry; rescan after 30 s if still failing |
| Pairing code invalid | Wrong 6-digit code or expired (10 min) | Regenerate |
| Upgrade signature invalid | Upgrade package signature failed | Auto-rollback; try the in-app upgrade again |
| Skill signature invalid | Skill signature failed | Refuse execution; check with the publisher |
| Background task cap | 64 in-flight reached | Wait for GC or stop some manually |