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