@cloudflare/sandbox
1.0.3 · 22 Oct 2026Apache-2.02.1M / weekRepositoryHomepagenpmAtom feed
Upgrading @cloudflare/sandbox From 0.12.8 to 1.0.3
10 releases in betweenevery note read
Reading releases, release notes and advisories…
Start here
Security
- 0.12.14
Update the container runtime to Bun 1.4.4. Bun checks certificates against its own built-in CA list, and in 1.4.4 that list no longer trusts the compromised eMudhra intermediates, so the
buncommand andcreateBackup()uploads of 10 MiB or more now reject their certificates. Bun 1.4.4 also updates Brotli to 1.2.1, which fixes CVE-2026-111497. The-opencodeimage ships OpenCode 1.19.4 or later, which also runs on Bun 1.4.4.
Release by release
- Fixed
Fix
Files.readDirectory()dropping a leading U+FEFF from entry names. Names that start with U+FEFF now come back unchanged, so passing them tostat()or other file operations finds the entry.
- Fixed
- Fixed
Fix
Files.readFile()hanging forever when the container sends file bytes before the opening control frame. The read now completes however the container transport orders the two streams.
- Fixed
- Fixed
Pin Zod 4.6.5, the version that Workers tooling such as
@cloudflare/vitest-pluginpins, so a project that installs both installs one copy of Zod instead of two.
- Fixed
1.0.0nothing new or fixed in the note
- Security
Update the container runtime to Bun 1.4.4. Bun checks certificates against its own built-in CA list, and in 1.4.4 that list no longer trusts the compromised eMudhra intermediates, so the
buncommand andcreateBackup()uploads of 10 MiB or more now reject their certificates. Bun 1.4.4 also updates Brotli to 1.2.1, which fixes CVE-2026-111497. The-opencodeimage ships OpenCode 1.19.4 or later, which also runs on Bun 1.4.4.
- Security
- Fixed
Stop trusting certificates from the compromised eMudhra intermediate CAs in the container images. The images now ship the updated Ubuntu and Alpine CA bundles, Node.js 22.23.4, cloudflared 2026.10.2, and pip 26.2.2 in the
-pythonimage. Bun keeps trusting these certificates until it releases a fix, which affectsbun, opencode, and multipart uploads increateBackup()for archives of 10 MiB or more. Update the container image to get this fix. See the eMudhra certificate compromise for details.
- Fixed
- Fixed
Fix
mountBucket()breaking an existing mount when a second call for the same mount path fails with "already in use". The existing mount now stays mounted and usable. - Fixed
Keep streaming
exec()alive while a command is quiet, and enforce itstimeout. Quiet commands were cut off after about four minutes on the HTTP transport and five on WebSocket. The timeout was ignored on those transports, and on every transport for commands that run in a session. Requires the matching container image. - Fixed
Keep R2 binding and credential-proxy bucket mounts working when the Sandbox Durable Object restarts while its container keeps running. The mounts used to stay listed but fail every read and write with
EIOuntilmountBucket()was called again. - Fixed
Fix
createOpencodeServer()andcreateOpencode()waiting for the full three-minute startup timeout whenOPENCODE_SERVER_PASSWORDis set. When the password is passed inenv, the client returned bycreateOpencode()now authenticates with it.
- Fixed
- Fixed
Stop backups from dropping whole directories when
excludesorgitignore: truematch a nested path. For example,excludes: ['.cache/foo/*/node_modules']no longer removes all of.cachefrom the archive. A multi-component pattern such asbuild/outputnow matches only relative to the backup directory, while a single-component pattern such asnode_modulesstill matches at any depth. Because mksquashfs does not support**, a pattern like**/node_modules/.cachenow excludes onlynode_modules/.cacheat the root of the backup directory; add a pattern for each nested location that must stay out of the backup. - Fixed
Return 404 with
workspace_read_not_foundfrom the bridge'sGET /v1/sandbox/:id/file/*when the file doesn't exist. The route used to return 200 with an empty body, the same response as an empty file. - Fixed
Fix local bucket mounts for large files and write bursts. On the RPC transport, objects over 4 MiB now stream into the container instead of failing with an interrupted runtime connection. Container files stream back to R2 byte for byte, without loading the whole file into Worker memory. A file being written uploads once its changes settle, instead of on every write.
- Fixed
Stop writing command text and output to Sandbox logs. Exec and process log events now record IDs, exit codes, durations, and output lengths, and the OpenAI Agents
ShellandEditoradapters no longer log commands, stderr, or patch text, so secrets in commands, output, or patches no longer reach Workers Logs or container logs. Command failure messages no longer repeat the command; it remains available on the error'scontext.command. - Fixed
Fix
restoreBackup()error reporting for archives of 10 MB or more. A failed download part now throws aBackupRestoreErrorthat includes curl's error output and each part's exit code, instead of aShell terminated unexpectedlysession error. - Fixed
Sync local bucket mounts outside
/workspace, such as/data, from the container back to R2.watch()andcheckChanges()now accept any absolute path on every transport, as documented. A local mount whose container rejects the watch now logs one error instead of retrying forever.
- Fixed
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.