Error Codes (v0)

• PROVIDER_TIMEOUT — upstream provider missed deadline; retriable: true
• PROVIDER_ERROR — upstream provider returned error; retriable: true
• BUDGET_EXCEEDED — trimming failed to meet strict token budget; retriable: false
• INVALID_REQUEST — malformed input; retriable: false
• EXPANSION_DECLINED — L1 expansion declined by policy; retriable: false
• NO_CANDIDATES — no candidates after retries; retriable: false

Notes

• Return structured error envelope as in api.md.

Example (schema-shaped)

{
	"request_id": "req-xyz",
	"fragments": [],
	"metrics": { "used_tokens": 0, "planner_ms": 35, "coverage_entities": 0.0 },
	"error": {
		"code": "BUDGET_EXCEEDED",
		"message": "Token budget exceeded while assembling context",
		"retriable": false,
		"attempt": 1,
		"max_attempts": 1,
		"options": [ { "action": "return_minimal", "hint": "lower tokens_max or intent scope" } ]
	}
}