Cursor Errors

CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.

HKTITAN c8f7484 11 files · 5.6 KB Updated

File contents

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]]

HKTITAN/cursor-sdk/tree/main/skills/cursor-errors commit c8f7484e56

Frequently asked questions

npx skillmds@latest add hktitan/cursor-errors