error-handling
Installation
SKILL.md
Language routing: The SDK patterns and transactions handoffs in the frontmatter are variant edges — they default to Python but apply to all languages. If the user's language is known, route to the matching
sdk-patterns-<lang>ortransactions-<lang>skill directly. If unknown, ask before routing.
Error Handling
The two timeout types
This is the most confusing error distinction in the SDK.
| Exception | Meaning | Safe to retry? |
|---|---|---|
UnambiguousTimeoutException |
Operation timed out before being sent to the server. The mutation did not happen. | ✅ Yes |
AmbiguousTimeoutException |
Operation timed out after being sent. The mutation may or may not have happened. | ⚠️ Only if idempotent (upsert/replace with CAS) |