build-error-adapter
SolidBuild new Arcade error adapters from scratch using public Arcade TDK patterns. Use when adding provider integrations, mapping SDK exceptions, or extending HTTP/GraphQL/auth adapter behavior.
AI & Automation 919 stars
98 forks Updated today MIT
Install
Quality Score: 93/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Build Error Adapter
Use this workflow to create new error adapters that fit Arcade TDK conventions.
## Official Reference
Start here and align behavior with this doc:
- [Arcade docs: Providing useful tool errors (Error adapters)](https://docs.arcade.dev/en/guides/create-tools/error-handling/useful-tool-errors#error-adapters)
## Quick Context
- Adapter protocol: `arcade_tdk.error_adapters.base.ErrorAdapter`
- Common error classes:
- `arcade_tdk.errors.UpstreamError` — upstream responded with an HTTP status code
- `arcade_tdk.errors.UpstreamRateLimitError` — 429 / quota-exhausted with `retry_after_ms`
- `arcade_tdk.errors.NetworkTransportError` — no complete response was received
(timeouts, connection/DNS/TLS failures, decoding errors, redirect exhaustion).
`status_code` is always `None`; use one of the `NETWORK_TRANSPORT_RUNTIME_*`
kinds: `_TIMEOUT`, `_UNREACHABLE`, `_UNMAPPED`.
- `arcade_tdk.errors.FatalToolError` — unrecoverable tool-authoring bug or
environment misconfiguration (invalid URL, unsupported protocol, bad headers,
TLS trust failures). Never retried.
- `arcade_tdk.errors.RetryableToolError` — transient tool-body failure with a
hint for the LLM to retry.
- `arcade_tdk.errors.ContextRequiredToolError` — needs human input before retry.
## Rules To Follow
1. Keep imports at top-level only (no inline imports), except optional dependency imports that must be lazy by design.
2. Adapter interface contract:
- `slug` class a...
Details
- Author
- ArcadeAI
- Repository
- ArcadeAI/arcade-mcp
- Created
- 2 years ago
- Last Updated
- today
- Language
- Python
- License
- MIT
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
adapter-dev
SOP for developing new Agent CLI adapters in AgentHub. Agent should use when adding a new agent integration (e.g. Copilot, Gemini CLI, Qwen CLI) or debugging adapter issues around model resolution, environment, or stream parsing.
2 Updated yesterday
TokenDanceLab Data & Documents Listed
patternsadapter
Adapter (Wrapper) Pattern pattern for C development
45 Updated 3 months ago
diegosouzapw API & Backend Listed
backend-builder
Build API routes, server actions, data adapters, and validation logic in web/. Use when creating or editing backend web code, API endpoints, or data-loading functions.
0 Updated 2 months ago
kanitmann01