Packages

@cloudflare/sandbox

1.0.3 · 22 Oct 2026Apache-2.02.1M / weekRepositoryHomepagenpmAtom feed

Upgrading @cloudflare/sandbox From 0.12.9 to 1.0.3

9 releases in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 0.12.9Newest 0.x0.12.14
The note of 1.0.0 lists no breaking change or deprecation; the migration guide below lists them.
  1. 0.12.9yours
  2. 4 releases
  3. 0.12.14security
  4. 1.0.0major
  5. 2 releases
  6. 1.0.3target
  7. 16 pre
?
changes to make
0
advisories fixed
1
new
23
fixes

Start here

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 bun command and createBackup() 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 -opencode image ships OpenCode 1.19.4 or later, which also runs on Bun 1.4.4.

    0.12.14

Release by release

  1. 1.0.3

    22 Oct 20261 fix
    • 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 to stat() or other file operations finds the entry.

  2. 1.0.2

    20 Oct 20261 fix
    • 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.

  3. 1.0.1

    13 Oct 20261 fix
    • Fixed

      Pin Zod 4.6.5, the version that Workers tooling such as @cloudflare/vitest-plugin pins, so a project that installs both installs one copy of Zod instead of two.

  4. 1.0.0nothing new or fixed in the note

  5. 0.12.14

    Security fix22 Oct 2026
    • 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 bun command and createBackup() 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 -opencode image ships OpenCode 1.19.4 or later, which also runs on Bun 1.4.4.

  6. 0.12.13

    21 Oct 20261 fix
    • 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 -python image. Bun keeps trusting these certificates until it releases a fix, which affects bun, opencode, and multipart uploads in createBackup() for archives of 10 MiB or more. Update the container image to get this fix. See the eMudhra certificate compromise for details.

  7. 0.12.12

    20 Oct 202611 fixes
    • 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 its timeout. 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 EIO until mountBucket() was called again.

    • Fixed

      Fix createOpencodeServer() and createOpencode() waiting for the full three-minute startup timeout when OPENCODE_SERVER_PASSWORD is set. When the password is passed in env, the client returned by createOpencode() now authenticates with it.

  8. 0.12.11

    19 Oct 20266 fixes
    • Fixed

      Stop backups from dropping whole directories when excludes or gitignore: true match a nested path. For example, excludes: ['.cache/foo/*/node_modules'] no longer removes all of .cache from the archive. A multi-component pattern such as build/output now matches only relative to the backup directory, while a single-component pattern such as node_modules still matches at any depth. Because mksquashfs does not support **, a pattern like **/node_modules/.cache now excludes only node_modules/.cache at 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_found from the bridge's GET /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 Shell and Editor adapters 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's context.command.

    • Fixed

      Fix restoreBackup() error reporting for archives of 10 MB or more. A failed download part now throws a BackupRestoreError that includes curl's error output and each part's exit code, instead of a Shell terminated unexpectedly session error.

    • Fixed

      Sync local bucket mounts outside /workspace, such as /data, from the container back to R2. watch() and checkChanges() 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.

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.