Generated by /k-housekeep · Last updated: 2026-05-27
Documents errors that cross component boundaries — where an upstream component fails and a downstream component translates/relays the failure to the user. Derived from the Upstream column of each module's docs/technical/errors.md. See errors-catalog.md for the full ID list.
Fluxo: AI request via Koder Gateway (Kode)
sequenceDiagram
Kode->>Koder Gateway: POST /v1/chat (stream)
Koder Gateway-->>Kode: 401 / 429 / 5xx / 400
Kode->>Kode: humanize → KODE-AU-401-001 / KODE-NW-429-001 / KODE-NW-000-001 / KODE-VL-400-001
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| Koder Gateway |
401 |
KODE-AU-401-001 |
You need to sign in to continue. |
| Koder Gateway |
429 |
KODE-NW-429-001 |
Server busy. Please try again in a few seconds. |
| Koder Gateway |
5xx / connection error |
KODE-NW-000-001 / KODE-NW-500-001 |
Server busy. Please try again in a few seconds. |
| Koder Gateway |
400 |
KODE-VL-400-001 |
Check the content and try again. |
| Koder Gateway |
image/video gen failure |
KODE-IM-000-001 / KODE-VD-000-001 |
Image/Video generation failed. Try again. |
Fluxo: token refresh via Koder ID (Kode, Pass, Kruze)
sequenceDiagram
participant App as Kode / Pass / Kruze
App->>Koder ID: refresh token
Koder ID-->>App: refresh expired/revoked
App->>App: KODE-AU-000-001 / PASS-AUTH-001-004 / KRUZE-AU-000-001
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| Koder ID |
token refresh failed |
KODE-AU-000-001 |
(sign in again) |
| Koder ID |
refresh expired/revoked |
PASS-AUTH-001-004 |
Your session has expired. Please sign in again. |
| Koder ID |
sign-incallbacksign-out fails |
KRUZE-AU-000-001 |
You need to sign in again to continue. |
Fluxo: conversation share via Kode Relay (Kode)
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| Kode Relay |
publish failure |
KODE-NW-000-002 / KODE-XX-000-003 |
Could not share this conversation. Try again. |
Fluxo: app install + attestation via Koder Hub
sequenceDiagram
Hub->>depot: fetch attestation / SLSA provenance
depot-->>Hub: record missing / verification fails
Hub->>Hub: HUB-ATTEST-007-001 / HUB-ATTEST-007-002
Hub->>Koder ID: auth for purchase
Koder ID-->>Hub: token expired
Hub->>Hub: HUB-AUTH-004-001
Hub->>Foundation/billing: process payment
Foundation/billing-->>Hub: payment error
Hub->>Hub: HUB-PAY-005-001
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| depot |
attestation record not found |
HUB-ATTEST-007-001 |
Package integrity could not be verified. |
| depot |
SLSA provenance verification fails |
HUB-ATTEST-007-002 |
This package failed the security verification check. |
| Koder ID |
token expired/revoked |
HUB-AUTH-004-001 |
Session expired. Sign in again to continue. |
| Foundation/billing |
payment processor error |
HUB-PAY-005-001 |
Payment failed. Check your payment method and try again. |
Fluxo: AI chat + downloads via Kruze
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| ai/gateway |
no HTTP status |
KRUZE-AI-000-001 |
Koder AI is unavailable. Please try again. |
| ai/gateway |
5xx |
KRUZE-AI-503-001 |
Server busy. Please try again in a few seconds. |
| Remote site |
404 / 5xx / no connection |
KRUZE-DL-404-001 / KRUZE-DL-503-001 / KRUZE-DL-000-001 |
Content unavailable / Server busy / No connection. |
Fluxo: Drive backend + Pass Android AccountManager
| Origem |
Falha upstream |
Repassa como |
Mensagem ao usuário |
| Drive backend |
non-2xx (error JSON) |
DRIVE-NET-002-001 |
DriveApiException.message (backend error field) |
| Android AccountManager |
setAccount() MethodChannel fails |
PASS-AM-004-001 |
Could not register the account in the Android system. |
Coverage: flows above cover the components whose errors.md declares an Upstream column (Kode, Hub, Kruze, Pass, Drive). Eye, Kmail, and Mosaic errors are predominantly local (deviceIMAPown-API) and do not relay a distinct upstream component error to the user.