feat: add optional name to createSnapshot and return snapshot names

[mishushakov]

Summary

• Add optional name parameter to createSnapshot / create_snapshot in the JS and Python SDKs so callers can name the resulting snapshot template.
• Return the names field from the snapshot API on SnapshotInfo (both in createSnapshot responses and in listSnapshots paginator results) so callers can discover the namespaced snapshot names.
• Includes a changeset (patch for e2b and @e2b/python-sdk).

Test plan

• pnpm run format, pnpm run lint, pnpm run typecheck all pass locally
• Integration tests on a sandbox with valid credentials: sandbox.createSnapshot({ name: 'my-snap' }) returns non-empty names

Resolves #1249

[changeset-bot]

🦋 Changeset detected

Latest commit: 3d934ef

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

This PR includes changesets to release 2 packages

Name	Type
@e2b/python-sdk	Patch
e2b	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

[cursor]

PR Summary

Low Risk
Small, additive SDK API surface change that only affects snapshot create/list response shapes and request payloads; primary risk is minor backward-compat/typing impact for consumers expecting SnapshotInfo to only contain snapshotId/snapshot_id.

Overview
Adds support in the JS and Python SDKs to optionally name snapshots on creation (new CreateSnapshotOpts / name parameter), sending the name through to the POST /sandboxes/{sandboxID}/snapshots request.

Extends SnapshotInfo to include returned names (namespaced snapshot template names) and plumbs it through both snapshot creation and snapshot listing/paginators, with new integration tests covering named snapshot creation plus a changeset bumping e2b and @e2b/python-sdk as patch releases.

^{Reviewed by Cursor Bugbot for commit 3d934ef. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Package Artifacts

Built from e79cad3. Download artifacts from this workflow run.

JS SDK (e2b@2.19.1-mishushakov-snapshot-name.0):

npm install ./e2b-2.19.1-mishushakov-snapshot-name.0.tgz

CLI (@e2b/cli@2.9.1-mishushakov-snapshot-name.0):

npm install ./e2b-cli-2.9.1-mishushakov-snapshot-name.0.tgz

Python SDK (e2b==2.20.0+mishushakov-snapshot-name):

pip install ./e2b-2.20.0+mishushakov.snapshot.name-py3-none-any.whl

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit b118044. Configure here.}

[Crunchyman-ralph]

lgtm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3d934ef6d2

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".