Dream finding 018 (needs-issue)
Umbrella: #20 | Dream: dream-2026-07-23.1
APIError is public and documented as raised for HTTP failures, but production code never raises it — all ops use response.raise_for_status() → httpx.HTTPStatusError.
Options
A. Wrap HTTPStatusError → APIError to match docs/README
B. Deprecate/remove APIError; document catching httpx errors
README also uses e.message which is wrong for either type.
Evidence: CHANGELOG 0.21.0 standardized raise_for_status intentionally.
Nothing auto-merges — human decides.
Dream finding
018(needs-issue)Umbrella: #20 | Dream: dream-2026-07-23.1
APIErroris public and documented as raised for HTTP failures, but production code never raises it — all ops useresponse.raise_for_status()→httpx.HTTPStatusError.Options
A. Wrap HTTPStatusError → APIError to match docs/README
B. Deprecate/remove APIError; document catching httpx errors
README also uses
e.messagewhich is wrong for either type.Evidence: CHANGELOG 0.21.0 standardized raise_for_status intentionally.
Nothing auto-merges — human decides.