cursor-errors
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
More from hktitan/cursor-sdk
cursor-hooks
File-based agent loop hooks via `.cursor/hooks.json` — pre/post commands, governance gates. Use when enforcing policy without modifying agent prompts.
1cursor-runs
Run lifecycle, streaming, follow-ups, and conversation introspection in the Cursor SDK. Use when consuming agent output, handling progress events, or chaining turns.
1cursor-subagents
Define delegated subagents on a Cursor SDK agent via the `agents` field — `AgentDefinition`, MCP scoping, and model inheritance. Use when decomposing work across specialist personas.
1cursor-sdk
Entry point for the Cursor TypeScript SDK — install, auth, and the Agent.create / Agent.resume / Agent.prompt lifecycle. Use when starting any Cursor SDK integration or wiring durable agent IDs.
1cursor-models
Model discovery and selection on Cursor SDK — Cursor.models.list, ModelSelection, parameters (e.g. thinking levels), per-run sticky overrides.
1cursor-cloud
Cloud runtime for Cursor SDK — dedicated VMs, repo-bound runs, auto-PR creation, artifacts, and reattachment. Use when running long, review-oriented, or repo-modifying agents off the local machine.
1