Add automated error mapping for custom Astroid API error codes

[Cjay-Cyber-2]

Description — what to implement and the why/impact.

Add robust error mapping across client responses in @astroid/client to translate raw HTTP error payloads into strongly-typed SDK error classes.

Context & Requirements — background, constraints, design references, edge cases;

Background: Developers need specific error classes (e.g. BudgetExceededError, PolicyViolationError) rather than generic HTTP errors to handle failure cases gracefully in agent code.
Constraints: Must preserve original error details, stack traces, and status codes.

Acceptance Criteria — a checklist ("- [ ] ...") of specific, testable conditions that define "done".

• Custom error classes defined and exported across workspace packages
• Response interceptor in @astroid/client maps error codes to specific SDK errors
• Unit tests verify correct error instantiation for various API error responses

Implementation Guidance — likely files/modules to touch (use real paths from the repo context)

Check error handling modules under packages/client/src/ and shared types or error definitions.

Testing & Validation — how the contributor should prove it works

Run pnpm test across the workspace to ensure error mapping tests pass successfully.

Submission Guidelines — must open a PR that includes "Closes #"; assignment is required before starting.

---

Wave complexity: Medium

[Tee-Gee57]

@Tee-Gee57 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer, I would like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Tee-Gee57 to this issue.

[OmniZlatoon]

@OmniZlatoon has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Its < than an hour now. Assign me now and see the results. Don't let the issue overdue kind sir/ma'am

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OmniZlatoon to this issue.

[Duyicoda]

@Duyicoda has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Please assign me to this. Thanks!!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Duyicoda to this issue.

[rilwanubala]

@rilwanubala has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi, please allow me to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @rilwanubala to this issue.

[kolawoleoluwaferanmi014-a11y]

@kolawoleoluwaferanmi014-a11y has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi, I’ve gone through the issue in detail and understand what needs to be addressed. I’m confident I can implement the required changes cleanly and efficiently. I’d be glad to take ownership of this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @kolawoleoluwaferanmi014-a11y to this issue.

[Horlarolowo123]

@Horlarolowo123 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer, I’ve carefully reviewed the issue and have a clear understanding of the requirements. I’m ready and confident to take it on. Kindly assign the issue to me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Horlarolowo123 to this issue.

[Peaostrel]

@Peaostrel has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

i can handle this quickly

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Peaostrel to this issue.

[charlesejemai-cyber]

@charlesejemai-cyber has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @charlesejemai-cyber to this issue.

[Phantomcall]

@Phantomcall has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

i would love to help you tackle this issue and i can get it done before the deadline

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Phantomcall to this issue.

[chainsmt]

@chainsmt has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello, I'd like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @chainsmt to this issue.