@cloudflare/sandbox
1.0.3 · 22 Oct 2026Apache-2.02.1M / weekRepositoryHomepagenpmAtom feed
0.12.14 is the newest release of 0.12.x.
In short
7 changed
Release note
Instrument the bridge API with Cloudflare custom spans. Each endpoint now emits
abridge.<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 withobservability.traces.enabledin your Worker configuration.Make
destroy()succeed when the sandbox container was never admitted, so cleanup no longer fails with a no-instance platform error.Reduce intermittent startup failures during concurrent sandbox creation where operations could fail with a disposed RPC session error.
Surface container capacity and admission failures as retryable
ContainerUnavailableErrorwith a structuredreason, including no-instance and max-instances cases. Callers can branch onerror.reasoninstead of parsing platform messages.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
withWARM_POOL_SCALE_BATCH_SIZE(default 5, clamped to 20).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.Let the warm pool know its instance ceiling up front via the
WARM_POOL_MAX_INSTANCESbridge variable. Set it to match your container'smax_instancesso the pool makes correct capacity decisions without first
crashing into the limit.0(the default) preserves the existing auto-learn
behaviour.
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.