Add sandbox lifecycle create option

[matthewlouisbrockman]

adds the lifecycle for autoresume/autopause and timeout to the cli

[changeset-bot]

🦋 Changeset detected

Latest commit: 9d97411

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

This PR includes changesets to release 1 package

Name	Type
@e2b/cli	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
Scoped CLI option parsing and sandbox create wiring with tests; no auth or core API changes beyond existing SDK options.

Overview
e2b sandbox create now accepts --ontimeout (pause or kill), --autoresume (only with --ontimeout pause), and --timeout (seconds, minimum 30). Those values are passed into Sandbox.create as lifecycle and timeoutMs, and attached sessions use the same timeout for keep-alive and when the terminal disconnects instead of always resetting to 1s. A changeset and vitest coverage were added for parsing, validation, and option wiring.

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

[github-actions]

Package Artifacts

Built from 4f34a40. Download artifacts from this workflow run.

JS SDK (e2b@2.28.3-cli-create-lifecycle-json.0):

npm install ./e2b-2.28.3-cli-create-lifecycle-json.0.tgz

CLI (@e2b/cli@2.11.1-cli-create-lifecycle-json.0):

npm install ./e2b-cli-2.11.1-cli-create-lifecycle-json.0.tgz

Python SDK (e2b==2.27.1+cli-create-lifecycle-json):

pip install ./e2b-2.27.1+cli.create.lifecycle.json-py3-none-any.whl

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: caae7c5dad

ℹ️ 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".

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

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[mishushakov]

would change DX here by flattening the params, that should also help with parsing.
if you want them under lifecycle anyways, you could also:

e2b sbx create base --lifecycle.autoresume --lifecycle.ontimeout="pause"

[mishushakov]

I would flatten this to --ontimeout and --autoresume

[matthewlouisbrockman]

kk, fixed

[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 09d5b1b. Configure here.}