Proto commits in e2b-dev/E2B

These commits are when the Protocol Buffers files have changed: (only the last 100 relevant commits are shown)

2026-06-15

feat(sdk): add allowNetworkMounts option to filesystem watch (#1420) Client-side counterpart to [e2b-dev/infra#2982](https://github.com/e2b-dev/infra/pull/2982): adds an `allowNetworkMounts`/`allow_network_mounts` option to filesystem directory watching across the JS and Python (sync + async) SDKs, so clients can explicitly opt into watching paths on network filesystem mounts (NFS, CIFS, SMB, FUSE), which envd rejects by default. Events on network mounts may be unreliable or not delivered at all, hence the explicit opt-in. This regenerates the filesystem proto code from the updated spec and threads the flag through `watchDir`/`watch_dir` (streaming `WatchDir` and polling `CreateWatcher`). The option requires envd 0.6.4 (shipped by the infra PR); using it against an older sandbox throws a `TemplateError`/`TemplateException`. Default behavior is unchanged. Includes new watch tests for all three SDKs and a minor-bump changeset for `e2b` and `@e2b/python-sdk`. > Note: the new tests exercise the flag on a regular directory (a network mount can't be set up from SDK tests) and require envd 0.6.4, so this should land with/after the infra deploy. All pre-existing watch tests pass; the new ones currently fail with the expected `TemplateError` against the deployed envd. ### Usage **JavaScript** ```ts const handle = await sandbox.files.watchDir( '/mnt/nfs-share/my-dir', (event) => console.log(event.type, event.name), { allowNetworkMounts: true } ) ``` **Python (async)** ```python handle = await sandbox.files.watch_dir( "/mnt/nfs-share/my-dir", on_event=lambda e: print(e.type, e.name), allow_network_mounts=True, ) ``` **Python (sync)** ```python handle = sandbox.files.watch_dir("/mnt/nfs-share/my-dir", allow_network_mounts=True) for e in handle.get_new_events(): print(e.type, e.name) ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

2026-06-10

feat(sdk): add includeEntry option to filesystem watch (#1385) Client-side counterpart to [e2b-dev/infra#2930](https://github.com/e2b-dev/infra/pull/2930): adds an `includeEntry`/`include_entry` option to filesystem directory watching across the JS and Python (sync + async) SDKs, so each `FilesystemEvent` can carry the affected entry's `EntryInfo` (best-effort — unset for remove/rename-away events where the path no longer exists). This regenerates the filesystem proto code from the updated spec, threads the flag through `watchDir`/`watch_dir` (streaming `WatchDir` and polling `CreateWatcher`), maps the new `entry` field onto the event, and extracts a shared entry-mapping helper reused by `list`/`getInfo`/`rename`. The option degrades gracefully: older sandboxes (< envd 0.6.2) ignore it and leave `entry` unset, so there's no hard version gate. Includes new watch tests for all three SDKs and a minor-bump changeset for `e2b` and `@e2b/python-sdk`. > Note: the entry-info tests require envd 0.6.2 (shipped by the infra PR), so this should land with/after that deploy. ### Usage **JavaScript** ```ts const handle = await sandbox.files.watchDir( 'my-dir', (event) => { console.log(event.type, event.name, event.entry?.path, event.entry?.type) }, { includeEntry: true } ) ``` **Python (async)** ```python def on_event(e): print(e.type, e.name, e.entry.path if e.entry else None) handle = await sandbox.files.watch_dir("my-dir", on_event=on_event, include_entry=True) ``` **Python (sync)** ```python handle = sandbox.files.watch_dir("my-dir", include_entry=True) for e in handle.get_new_events(): print(e.type, e.name, e.entry.path if e.entry else None) ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

feat(sdks): expose user-defined file metadata on sandbox.files (#1383) Adds a `metadata` option to file uploads and surfaces persisted metadata on every `EntryInfo` / `WriteInfo` returned by `getInfo`, `list`, `rename`, and write responses, across the JS and Python (sync + async) SDKs. Metadata is sent as `X-Metadata-<key>: <value>` request headers and persisted by envd as `user.e2b.*` extended attributes; the same map is applied to every file in a multi-file upload. Keys and values must be printable US-ASCII and keys are lowercased by the sandbox, so they may differ in case when read back. Requires **envd 0.6.2 or later**. This syncs the envd OpenAPI spec and filesystem proto with [infra#2732](https://github.com/e2b-dev/infra/pull/2732) and regenerates the JS/Python clients. ## Usage **JavaScript / TypeScript** ```ts // Single file const info = await sandbox.files.write('report.txt', 'hello', { metadata: { author: 'mish', purpose: 'demo' }, }) console.log(info.metadata) // { author: 'mish', purpose: 'demo' } // Multiple files (same metadata applied to each) await sandbox.files.writeFiles( [ { path: 'a.txt', data: 'A' }, { path: 'b.txt', data: 'B' }, ], { metadata: { source: 'import' } } ) // Read it back const stat = await sandbox.files.getInfo('report.txt') console.log(stat.metadata) // { author: 'mish', purpose: 'demo' } ``` **Python** ```python # Single file info = sandbox.files.write("report.txt", "hello", metadata={"author": "mish"}) print(info.metadata) # {"author": "mish"} # Multiple files (same metadata applied to each) sandbox.files.write_files( [ WriteEntry(path="a.txt", data="A"), WriteEntry(path="b.txt", data="B"), ], metadata={"source": "import"}, ) # Read it back stat = sandbox.files.get_info("report.txt") print(stat.metadata) # {"author": "mish"} ``` The async Python API is identical with `await`. ## Tests Integration tests cover the round-trip across `write` / `getInfo` / `list` / `rename`, octet-stream uploads, multi-file uploads, overwrite-clears-stale-metadata, and metadata written directly as `user.e2b.*` xattrs via `sandbox.commands.run` surfacing in `getInfo`. They require a sandbox running envd 0.6.2+. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-02-12

feat: enable piping on the e2b cli (#1127) Adds stdin piping support to `e2b sandbox exec`, so users can do: ```bash echo "data" | e2b sandbox exec <id> -- cat cat file.bin | e2b sandbox exec <id> -- python3 -c 'import sys; print(len(sys.stdin.buffer.read()))' ``` Included: - JS SDK updates: - closeStdin() - supportsStdinClose - CLI updates: - detects piped stdin - streams stdin in 64 KiB chunks - closes remote stdin on EOF - graceful fallback for older sandbox versions (requires `envd` >= 0.5.2, warn + ignore piped input) ### Example Usage #### non-piped exec still works ``` e2b sandbox exec <sandbox_id> -- 'echo backend-non-pipe' ``` #### piped stdin path (supported envd) should deliver bytes ``` echo "hello" | e2b sandbox exec <sandbox_id> -- 'wc -c' # expect 6 printf '\x00\x01\x02\xff' | $e2b sandbox exec <sandbox_id> -- 'wc -c' # expect 4 ``` #### optional: legacy template behavior should warn + ignore piped stdin ``` echo "hello" | e2b sandbox exec <legacy_sandbox_id> -- 'wc -c' # expect 0 + "Ignoring piped stdin." ```

2025-09-29

Set stdin to `/dev/null` by default (#919) Disable stdin (setting it to `/dev/null` for `command.run()`, but enable to setting it to pipe, which you can send the input via `command.sendStdin()` This fixes issues with tools checking for stdin and then hanging indefinitely <!-- CURSOR_SUMMARY --> --- > [!NOTE] > Disables stdin by default and introduces a new `StartRequest.stdin` flag to opt-in to stdin piping, updating JS/Python SDKs, version gating, and tests. > > - **Spec/Protobuf**: > - Add `optional bool stdin` to `process.StartRequest` in `spec/envd/process/process.proto` and regenerate JS/Python protos. > - **JS SDK**: > - Add `ENVD_COMMANDS_STDIN = '0.3.0'` and version check; error if `stdin === false` on older envd. > - Extend `CommandStartOpts` with `stdin` (default `false`); pass `stdin` to `rpc.start`. > - **Python SDK**: > - Add `ENVD_COMMANDS_STDIN = Version("0.3.0")` and version check mirroring JS. > - Extend async/sync `commands.run()` with `stdin` (default `False`); pass to `StartRequest`. > - Update generated `process_pb2`/`.pyi` with `StartRequest.stdin`. > - **Tests**: > - Update send-stdin tests to run commands with `stdin: true`/`stdin=True`. > - **Changeset**: > - Minor bump for `@e2b/python-sdk` and `e2b`. > > ^{Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 458a15187e6eadccd43540e6b8972c4d45e1bb78. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).} <!-- /CURSOR_SUMMARY -->

The documentation is generated from this commit.

2025-09-26

Set stdin for commands to `/dev/null` by default

The documentation is generated from this commit.

Set stdin for commands to `/dev/null` by default

The documentation is generated from this commit.

2025-07-29

Adds files.getInfo / files.get_info methods to retrieve information about directory/files (#724) **Changelog** - Adds `files.getInfo`, `files.get_info` methods to the SDKs. - Adds tests for the new methods - Adds documentation for the above. **Examples** JavaScript ```js import { Sandbox } from '@e2b/code-interpreter' const sandbox = await Sandbox.create() // Create a new file await sandbox.files.write('test_file.txt', 'Hello, world!') // Get information about the file const info = await sandbox.files.getInfo('test_file.txt') console.log(info) // { // name: 'test_file.txt', // type: 'file', // path: '/home/user/test_file.txt' // } ``` Python ```py from e2b_code_interpreter import Sandbox sandbox = Sandbox() # Create a new file sandbox.files.write('test_file', 'Hello, world!') # Get information about the file info = sandbox.files.get_info('test_file') print(info) # EntryInfo(name='test_file.txt', type=<FileType.FILE: 'file'>, path='/home/user/test_file.txt') ``` --------- Co-authored-by: Jakub Novak <jakub@e2b.dev>

2025-07-28

Update spec

updated proto

reverted EntryInfo on list()

update list and stat types

2025-05-20

updated proto

2025-05-19

reverted EntryInfo on list()

2025-05-16

update list and stat types

2025-05-14

Flag for securing envd access with auth token (#688) Waiting until secure flag will be available in production cluster. --------- Co-authored-by: Jakub Novák <jakub@e2b.dev>

2025-05-13

updated api/envd clients

2025-05-12

updated api/envd clients

2025-05-07

updated api/envd clients

2025-05-05

Add optional depth parameter to SDK file listing methods. (#649) # Description Do not merge before https://github.com/e2b-dev/infra/pull/524 is merged and deployed. The DX would look like this: ```js const files = await sandbox.files.list(dirName, { depth: 3 }) ``` - [x] update `envd` pb spec - [x] generate for `js-sdk` - [x] update `js-sdk` `file.list` method to include optional depth param - [x] update `js-sdk` tests - [x] generate for `python-sdk` - [x] update `python-sdk` `file.list` method to include optional depth param - [x] sync - [x] async - [x] update `python-sdk` tests - [x] sync - [x] async --------- Co-authored-by: Mish <10400064+mishushakov@users.noreply.github.com>

2025-04-29

updated api/envd clients

2025-04-17

Add autopause option to sdk with latest main (#680) Add latest changes in main to the auto-pause feature branch - [x] python-sdk - [x] successful build? - [x] successful unit tests? - [x] js-sdk - [x] successful build? - [x] successful unit tests? --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Ben Fornefeld <ben.fornefeld@gmail.com> Co-authored-by: never not exploring <50748440+ben-fornefeld@users.noreply.github.com> Co-authored-by: Vasek Mlejnsky <vasek.mlejnsky@gmail.com> Co-authored-by: Vasek Mlejnsky <vasek@e2b.dev> Co-authored-by: handlebauer <hi@donaldgeddes.ca> Co-authored-by: Tereza Tizkova <tereza@e2b.dev> Co-authored-by: tizkovatereza <135881365+tizkovatereza@users.noreply.github.com> Co-authored-by: Jakub Dobrý <jakub.dobry8@gmail.com> Co-authored-by: Jakub Novak <jakub@e2b.dev> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Tomas Valenta <valenta.and.thomas@gmail.com> Co-authored-by: r33drichards <rwendt1337@gmail.com> Co-authored-by: James Murdza <james@jamesmurdza.com> Co-authored-by: yushengchen <yushengchen@nine-yi.com> Co-authored-by: Ziray Hao <ziray.hao@gmail.com> Co-authored-by: Mish Ushakov <10400064+mishushakov@users.noreply.github.com> Co-authored-by: Ziray Hao <45774151+ziruihao@users.noreply.github.com> Co-authored-by: Jiri Sveceny <jiri.sveceny@icloud.com> Co-authored-by: yusheng chen <55658154+samuel871211@users.noreply.github.com> Co-authored-by: David Batey <davidlbatey@gmail.com> Co-authored-by: Penny Templeton <92920463+p-templeton@users.noreply.github.com>

updated api/envd clients

2025-04-01

* update envd spec & generate for js-sdk * update js-sdk file.list method to include optional depth param * update js-sdk tests

2025-03-19

merge main into beta and fix conflicts and generate new specs

2025-01-28

Add watch dir recursive option (missing python client regeneration)

2024-10-15

Rename rpc methods for watcher

2024-10-14

Refactor watch dir

Fix command for generating from rpc spec

2024-10-11

Add sync watch handler

2024-08-06

Remove file info from remove method

Get paths for filesystem operations from envd

2024-06-28

Fix python request timeout error; Change auth

Move user to header

2024-06-18

Change default keepalive interval

2024-06-17

Client keepalive

Add keepalive support; Tweak timeouts

2024-06-16

Regenerate envd rpc clients

Implement fs move in envd

2024-06-13

Fix watch init error

Fix mux; Add start event to watch to wait for init

Update scripts; Fix dir watch; Improve naming

Simplify watch dir

2024-06-07

Regenrate RPC; Fix namespacing

2024-06-06

Simplify naming of envd services

Implement file handling; Fix dir permissions

Finish makedir

Fix output multireader

2024-06-03

Fix input stream; [WIP] Python SDK

Return sensible process info

Add process tag

Simplify envd API

Update spec and JS

2024-06-02

Make cwd optional

Improve types

2024-06-01

Export types in TS SDK; [WIP] Python SDK process handling

Add missing pty output

Fix naming

Imrpove connection config; [WIP] Rework Python SDK

Simplify envd

2024-05-31

Regenerate APIs

2024-05-28

Generate server; [WIP] Finish implementing services

2024-05-20

[WIP] Add process management

2024-05-18

Fix fs user handling

Simplify service; Implement fs

2024-05-17

Tweak types

Remove non essential parameters and methods

Generate clients

[WIP] Finalize protobufs

2024-05-12

[WIP] Add comments

2024-05-10

Properly nest definitions

2024-04-30

Regenerate

[WIP] Generate python client

2024-04-29

Remove unnecessary methods

2024-04-28

Generate server

Fix grpc generation in envd

Merge branch 'ttl' into grpc

2024-04-17

Fix input stream

Unify types

Check bidirectional streams

Improve spec

2024-04-16

Add tests

Rename proto files (naming must be unique)

Connect with API

Move the logic for building the template

Create base service

Change to streaming

Fix sync error in orchestration API # Conflicts: # packages/orchestrator/internal/server/main.go # packages/shared/pkg/grpc/orchestrator/orchestrator.pb.go # packages/shared/pkg/grpc/orchestrator/orchestrator_grpc.pb.go

2024-04-15

Experiment with protobuffers

2024-04-14

Add spec comment

Draft proto and api files

2024-04-13

Add docstring for grpc

Simplify tracing, connect traces automatically

Implement GRPC

2022-09-11

Add session observability links and missing errors; Remove vendor deps; Fix golang version build problems

This commit does not contain any .proto files.

2022-06-03

Update deps

2022-05-21

Cleanup; Add API as a service to Nomad

Add 'modules/cluster/disk-image/firecracker-task-driver/' from commit '2562655ed72f4f29fe31a3e1ebf25889f6edc443' git-subtree-dir: modules/cluster/disk-image/firecracker-task-driver git-subtree-mainline: f90da349e42a957d4a51d91e424816d016e8e6c4 git-subtree-split: 2562655ed72f4f29fe31a3e1ebf25889f6edc443

Cleanup TF hierarchy [WIP]

This commit does not contain any .proto files.

2022-05-03

Add 'modules/orchestrator/firecracker-task-driver/' from commit 'f6b133369934351004265e9fa0526fdd6f84b06c' git-subtree-dir: modules/orchestrator/firecracker-task-driver git-subtree-mainline: daddc851d3a55115702ce06ca02095f21ef34f8d git-subtree-split: f6b133369934351004265e9fa0526fdd6f84b06c