[devin-ai-integration]

Summary

The SDK now lets the server decide whether a control-plane API response can be retried, through the Should-Retry response header (added in e2b-dev/belt#4687). It still has a status-code fallback for responses that don't carry the header, such as errors from a load balancer in front of the E2B proxy. JS withRetry and Python RetryableTransport / AsyncRetryableTransport behave the same way.

Should-Retry present  → retry only if it is "true" (trimmed, case-insensitive); false/malformed → never, whatever the status
Should-Retry absent   → retry 429 / 502 / 503 / 504
retry delay           → Retry-After (delta-seconds) if valid, else exponential backoff with jitter (100 ms → 10 s)

• Removed: REPLAYABLE_METHODS, REPLAYABLE_OPERATIONS, isReplayable / is_replayable and Python NETWORK_ERRORS. No method or path checks are left. RETRYABLE_STATUSES is now {429, 502, 503, 504} and applies only when the header is absent.
• Network errors after the request was written are no longer retried at the request level. This covers dropped connections, ECONNRESET, the browser's opaque TypeError, and httpx ReadError / RemoteProtocolError. Without the allowlists the SDK can't tell whether a replay is safe.
• Connection-setup failures are still retried. In JS, isRetryableFetchError(error) now means isConnectionError(error). In Python, ConnectionRetryTransport handles them.
• Unchanged: the retries count, the request-timeout budget, single-attempt streaming bodies, and the undici connector retries.

Behavior changes:

• A 429 without Retry-After and a 504 are now retried with backoff.
• A 502/504 on create/append operations (e.g. POST /v2/sandboxes) is now retried too, so a load-balancer 502/504 that arrives after the backend already created the sandbox can leave a duplicate.
• Should-Retry: false stops retries for any status.

Usage

No API change. retries still controls how many times the SDK retries:

await Sandbox.create({ retries: 3 }) // 503 with `Should-Retry: true` or without the header → retried; with `Should-Retry: false` → returned

Sandbox.create(retries=3)

Linear: SDK-395

Link to Devin session: https://app.devin.ai/sessions/47966a4990af4fc19daa97413e9ad2ab
Open in Devin Desktop: https://app.devin.ai/desktop/session/47966a4990af4fc19daa97413e9ad2ab?variant=devin
Requested by: @mishushakov

[devin-ai-integration]

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

• Disable automatic comment, CI, and merge conflict monitoring

[changeset-bot]

🦋 Changeset detected

Latest commit: 310b2b7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
e2b	Minor
@e2b/python-sdk	Minor
@e2b/code-interpreter-python	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[linear-code]

SDK-395

[github-actions]

Package Artifacts

Built from f763e68. Download artifacts from this workflow run.

JS SDK (e2b@2.59.1-devin-1792434077-should-retry-header.0, with @e2b/dockerfile-utils@0.1.2-devin-1792434077-should-retry-header.0):

npm install ./e2b-dockerfile-utils-0.1.2-devin-1792434077-should-retry-header.0.tgz ./e2b-2.59.1-devin-1792434077-should-retry-header.0.tgz

CLI (@e2b/cli@2.22.4-devin-1792434077-should-retry-header.0):

npm install ./e2b-cli-2.22.4-devin-1792434077-should-retry-header.0.tgz

Code Interpreter JS SDK (@e2b/code-interpreter@2.9.1-devin-1792434077-should-retry-header.0):

npm install ./e2b-code-interpreter-2.9.1-devin-1792434077-should-retry-header.0.tgz

Desktop JS SDK (@e2b/desktop@2.5.1-devin-1792434077-should-retry-header.0):

npm install ./e2b-desktop-2.5.1-devin-1792434077-should-retry-header.0.tgz

Python SDK (e2b==2.59.0+devin.1792434077.should.retry.header, with e2b-dockerfile-utils==0.1.1+devin.1792434077.should.retry.header):

pip install ./e2b_dockerfile_utils-0.1.1+devin.1792434077.should.retry.header-py3-none-any.whl ./e2b-2.59.0+devin.1792434077.should.retry.header-py3-none-any.whl

Code Interpreter Python SDK (e2b-code-interpreter==2.11.3+devin.1792434077.should.retry.header):

pip install ./e2b_code_interpreter-2.11.3+devin.1792434077.should.retry.header-py3-none-any.whl

Desktop Python SDK (e2b-desktop==2.7.2+devin.1792434077.should.retry.header):

pip install ./e2b_desktop-2.7.2+devin.1792434077.should.retry.header-py3-none-any.whl

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-19T18:53:55.047296Z	8f1344a	Draft marked ready

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[mishushakov]

check all the issues above

[nalekseev-e2b]

🚀