feat(sdk): retry transient network errors and rate limits

.changeset/retry-transient-errors-js.md

@@ -0,0 +1,5 @@
+---
+'e2b': minor
+---
+
+feat(js-sdk): automatically retry requests on transient failures. The SDK now retries on connection errors and `429`/`502`/`503`/`504` responses using exponential backoff with jitter, and honors a server-provided `Retry-After` header (so rate limiting is handled transparently). Idempotent requests are retried on any transient failure; non-idempotent requests (e.g. `Sandbox.create`) are only retried when the server provably did not process them (e.g. throttling). Configure via the new `retries` option (or `E2B_MAX_RETRIES` env var); set `retries: 0` to disable. Defaults to `3` retries.

.changeset/retry-transient-errors-python.md

@@ -0,0 +1,5 @@
+---
+'@e2b/python-sdk': minor
+---
+
+feat(python-sdk): automatically retry requests on transient failures. The SDK now retries on connection errors and `429`/`502`/`503`/`504` responses using exponential backoff with jitter, and honors a server-provided `Retry-After` header (so rate limiting is handled transparently). Idempotent requests are retried on any transient failure; non-idempotent requests (e.g. `Sandbox.create`) are only retried when the server provably did not process them (e.g. throttling). The envd RPC retry now also uses backoff between attempts. Configure via the new `retries` option (or `E2B_MAX_RETRIES` env var); set `retries=0` to disable. Defaults to `3` retries.

packages/js-sdk/src/api/index.ts

@@ -6,6 +6,7 @@ import { createApiFetch } from './http2'
 import { ConnectionConfig } from '../connectionConfig'
 import { AuthenticationError, RateLimitError, SandboxError } from '../errors'
 import { createApiLogger } from '../logs'
+import { withRetry } from '../retry'
 
 const API_KEY_PATTERN = /^e2b_[0-9a-f]+$/
 const API_KEY_EXAMPLE = `e2b_${'0'.repeat(40)}`
@@ -95,7 +96,7 @@ class ApiClient {
 
     this.api = createClient<paths>({
       baseUrl: config.apiUrl,
-      fetch: createApiFetch(),
+      fetch: withRetry(createApiFetch(), config.retries),
       // In HTTP 1.1, all connections are considered persistent unless declared otherwise
       // keepalive: true,
       headers: {

packages/js-sdk/src/connectionConfig.ts

@@ -1,6 +1,7 @@
 import { Logger } from './logs'
 import { getEnvVar, version } from './api/metadata'
 import { runtime } from './utils'
+import { resolveMaxRetries } from './retry'
 
 // Remove once all deployments support sandbox subdomains
 const supportedDomains = ['e2b.app', 'e2b.dev', 'e2b.pro', 'e2b-staging.dev']
@@ -57,6 +58,19 @@ export interface ConnectionOpts {
    * @default 60_000 // 60 seconds
    */
   requestTimeoutMs?: number
+  /**
+   * Number of times to retry a request after a transient failure (e.g. a
+   * network error, a `429` rate-limit, or a `502`/`503`/`504`). Retries use
+   * exponential backoff with jitter and honor a server-provided `Retry-After`
+   * header. Non-idempotent requests (e.g. creating a sandbox) are only retried
+   * when the server provably did not process the request (e.g. throttling, a
+   * refused connection, or a DNS failure), avoiding duplicate side effects.
+   *
+   * Set to `0` to disable retries.
+   *
+   * @default E2B_MAX_RETRIES // environment variable or `3`
+   */
+  retries?: number
   /**
    * Logger to use for logging messages. It can accept any object that implements `Logger` interface—for example, {@link console}.
    */
@@ -180,6 +194,7 @@ export class ConnectionConfig {
   readonly logger?: Logger
 
   readonly requestTimeoutMs: number
+  readonly retries: number
 
   readonly apiKey?: string
   readonly accessToken?: string
@@ -192,6 +207,7 @@ export class ConnectionConfig {
     this.domain = opts?.domain || ConnectionConfig.domain
     this.accessToken = opts?.accessToken || ConnectionConfig.accessToken
     this.requestTimeoutMs = opts?.requestTimeoutMs ?? REQUEST_TIMEOUT_MS
+    this.retries = resolveMaxRetries(opts?.retries)
     this.logger = opts?.logger
     this.headers = opts?.headers || {}
     this.headers['User-Agent'] = `e2b-js-sdk/${version}`