Error codes
Every user-facing Dawn failure carries a stable DAWN_Exxxx code. The code is
printed on the surface where the failure appears — CLI stderr, HTTP/SSE error
bodies, and permission-denial tool results — so a failure is searchable and
linkable regardless of how you hit it.
Codes are grouped by range: E1xxx config / dawn check, E2xxx sandbox,
E3xxx permissions, E4xxx model / provider, and E5xxx runtime / import.
A code may omit a docs link and still be a valid, searchable identifier.
| Code | Meaning | Docs |
|---|---|---|
DAWN_E1001 | Invalid tool scope | /docs/tools#scoping-a-routes-tools |
DAWN_E1002 | Invalid sandbox config | /docs/configuration#sandbox |
DAWN_E1003 | Unknown build target | /docs/deployment |
DAWN_E2001 | Sandbox unavailable | /docs/sandbox#what-it-is--and-isnt |
DAWN_E2002 | Sandbox preflight failed | /docs/sandbox#quickstart |
DAWN_E3001 | Permission denied | /docs/permissions |
DAWN_E4001 | Model provider package missing | /docs/configuration |
DAWN_E4002 | Unknown model id | /docs/configuration |
DAWN_E5001 | Import or export mismatch | — |
DAWN_E5002 | Tool file has the wrong shape | /docs/tools |