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.

CodeMeaningDocs
DAWN_E1001Invalid tool scope/docs/tools#scoping-a-routes-tools
DAWN_E1002Invalid sandbox config/docs/configuration#sandbox
DAWN_E1003Unknown build target/docs/deployment
DAWN_E2001Sandbox unavailable/docs/sandbox#what-it-is--and-isnt
DAWN_E2002Sandbox preflight failed/docs/sandbox#quickstart
DAWN_E3001Permission denied/docs/permissions
DAWN_E4001Model provider package missing/docs/configuration
DAWN_E4002Unknown model id/docs/configuration
DAWN_E5001Import or export mismatch
DAWN_E5002Tool file has the wrong shape/docs/tools