Packages

@cloudflare/sandbox

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

Upgrading @cloudflare/sandbox From 0.4.3 to 0.12.14

88 releases in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 0.4.3Latest1.0.3
  1. 0.4.3yours
  2. 19 releases
  3. 0.6.0major
  4. 9 releases
  5. 0.7.0major
  6. 20 releases
  7. 0.8.0major
  8. 3 releases
  9. 0.8.4security
  10. 8 releases
  11. 0.9.0major
  12. 4 releases
  13. 0.10.0major
  14. 3 releases
  15. 0.11.0major
  16. 0.12.0major
  17. 13 releases
  18. 0.12.14target

Before you upgrade

Tick each one off as you go
  • Breaking0.12.0
  • Breaking0.8.8
  • Breaking0.8.7
  • Breaking0.8.2
  • Breaking0.7.0
  • Breaking0.6.0
  • Breaking0.5.6

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
  • Upgrade Go toolchain to 1.25 and update dependencies in the desktop container variant, including a security fix for image processing (CVE-2026-33809).

    0.8.4

Release by release

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 0.12.10

    23 Sep 20261 new · 2 fixes
    • New

      Allow multipart backup uploads to trust the runtime HTTPS interception certificate, so backups larger than 10 MiB work when interceptHttps is enabled.

    • Fixed

      Reject bucket-level mutations sent through credentialProxy mounts while preserving object writes, bucket probes, and scoped listings.

    • Fixed

      Fix File exists errors when git or other tools recreate files in a directory restored with restoreBackup(), such as running git reset --hard while a dev server watches the project.

  6. 0.12.9

    27 Aug 20261 new
    • New

      Allow mounted R2 buckets to open object keys containing spaces, symbols, percent signs, and non-ASCII characters.

  7. 0.12.8

    24 Aug 20261 fix
    • Fixed

      Enforce source mount prefixes for server-side copies between R2 bindings.

  8. 0.12.7

    14 Aug 20261 fix
    • Fixed

      Ensure stable releases advance npm's latest tag only after all release artifacts pass verification.

7 other lines we could not sort, mostly version bumps
  • Instrument the bridge API with Cloudflare custom spans. Each endpoint now emits a bridge.<operation> span annotated with the sandbox ID, container UUID, and operation-specific metadata (command, file path, port, session ID, and so on), so requests are traceable end to end. Enable tracing with observability.traces.enabled in your Worker configuration.

    0.12.5
  • Make destroy() succeed when the sandbox container was never admitted, so cleanup no longer fails with a no-instance platform error.

    0.12.5
  • Reduce intermittent startup failures during concurrent sandbox creation where operations could fail with a disposed RPC session error.

    0.12.5
  • Surface container capacity and admission failures as retryable ContainerUnavailableError with a structured reason, including no-instance and max-instances cases. Callers can branch on error.reason instead of parsing platform messages.

    0.12.5
  • Fill the warm pool in bounded-parallel batches instead of one container at a time, so it primes and recovers far faster after a burst. Tune the batch size with WARM_POOL_SCALE_BATCH_SIZE (default 5, clamped to 20).

    0.12.5
  • Refill the warm pool the moment it drains instead of waiting for the next background tick. After a burst consumes warm containers, replenishment now starts immediately, cutting the latency tail for sandboxes created during sustained or back-to-back bursts.

    0.12.5
  • Let the warm pool know its instance ceiling up front via the WARM_POOL_MAX_INSTANCES bridge variable. Set it to match your container's max_instances so the pool makes correct capacity decisions without first crashing into the limit. 0 (the default) preserves the existing auto-learn behaviour.

    0.12.5

6 internal lines (docs, tests, tooling) left out.

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.