cursor-errors
CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.
Source facts
- Repository
- HKTITAN/cursor-sdk
- Last source activity
- May 3, 2026 at 08:23
- Detected SKILL.md language
- English
- Stars
- 2
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
11 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cursor-errors
- description
- CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.
- metadata
- {"internal":false,"source":"https://cursor.com/docs/sdk/typescript"}
# cursor-errors
Every SDK throw is a `CursorAgentError` (or subclass). The `isRetryable` flag is your routing decision: retry transient errors, surface terminal ones.
## Base class
- [[references/cursor-agent-error]] — `isRetryable`, `code`, `cause`, `protoErrorCode`
## Subclasses
- [[references/auth-error]] — `AuthenticationError`
- [[references/rate-limit]] — `RateLimitError`
- [[references/configuration]] — `ConfigurationError`
- [[references/integration-not-connected]] — `IntegrationNotConnectedError`
- [[references/network]] — `NetworkError`
- [[references/unknown-agent]] — `UnknownAgentError`
- [[references/unsupported-op]] — `UnsupportedRunOperationError`
## Patterns
- [[references/retry-pattern]] — backoff using `isRetryable`
- [[references/schema-stability]] — defensive parsing of tool call args/result
## Cross-links
- Run status terminal-error vs throw — [[../cursor-runs/references/wait]]
- Operation gating — [[../cursor-runs/references/operation-support]]
View on GitHub