Skip to content

Releases ​

The reviewed source release is @anvia/sandbox 1.2.1. The entries below preserve notable v0 history.

Changes through 1.2.0 ​

Reviewed 1.1.8 → 1.2.0 against SDK source on 2026-10-15. Natural commands in exec_command and start_process now prefer /bin/bash -c, falling back to sh -c only if Bash is unavailable. Allow policies check the selected executable; explicit argv and low-level APIs keep their behavior. See Commands.

See the source changelog for individual release entries. The reviewed version is a source baseline; consult npm for the currently published tag.

VersionSummary
1.1.8Refreshed the package README.
1.1.7Redacted sandbox env values (--env KEY=<redacted>) in Docker command error messages.
1.1.6Accepted natural shell command lines in exec_command (run as sh -c, rejected under block-mode policies), supported file listing in Alpine and other BusyBox images, and avoided false file-boundary errors from macOS temporary path aliases.
1.1.5Fixed the package-manager-symlinked CLI entry point and accepted workspace-absolute paths inside the sandbox workdir in tool calls.
1.1.4Updated upstream runtime and schema dependencies and aligned the browser image and Playwright host pins.
1.1.3Block shell interpreters by default in allow-mode command policies, plus the peer-range fix.
1.1.2Added containerRuntime option to DockerSandboxClient.createSandbox() for running sandboxes on gVisor (e.g. runsc); creation fails with runtime_not_found unless registered.
1.1.1Bumped upstream runtime dependencies and aligned zod to 4.5.4 across packages.
1.0.10Updated the Core dependency to 1.0.10.
1.0.9Updated the Core dependency to 1.0.9.
1.0.8Updated the Core dependency to 1.0.8.
1.0.7Updated the Core dependency to 1.0.7.
1.0.6Updated the Core dependency to 1.0.6.
1.0.5Updated the Core dependency to 1.0.5.
1.0.4Updated the Core dependency to 1.0.4.
1.0.3Updated the Core dependency to 1.0.3.
1.0.2Updated the Core dependency to 1.0.2.
1.0.1Updated the Core dependency to 1.0.1.
1.0.0Replaced implicit session-style lifecycle with explicit image pull, sandbox create/stop/resume/destroy handles; added resource, security, shared-memory, inspection, async-disposal, and browser-runtime support. Studio sandbox exposure is now explicit registration.
1.0.0-rc.9Synchronized Sandbox with the Anvia 1.0 release-candidate train.
0.6.0Added bounded line pagination to session and read_file APIs, including continuation metadata and safe default line/byte limits.
0.5.0Added the interactive/scriptable create-image CLI for composed Node, Bun, Python, artifact, Playwright, apt, npm, and uv images.
0.4.1Added automatic read-only Studio discovery for sandbox-backed agent workspaces.
0.4.0Added loopback-only port publication, managed processes, readiness checks, and opt-in process/preview tools.
0.3.7Simplified internal option construction without changing public behavior.
0.3.6Widened the compatible Core peer range.
0.3.5Moved Core to a peer dependency to avoid duplicate private-type incompatibilities.
0.3.0Added persistent workspaces, lifecycle cleanup, streaming exec, file limits, hooks, language presets, and model-facing tool policies.
0.2.0Introduced Docker-backed ephemeral workspaces.

Upgrade checks ​

  • Confirm Node >=20.12, Docker CLI compatibility, daemon access, and the Core peer range.
  • Migrate old session constructors and automatic Studio discovery to DockerSandboxClient, explicit sandbox handles, and StudioOptions.sandboxes registrations.
  • Test path, size, timeout, process, and command policies against negative cases.
  • When adopting paged reads, handle nextStartLine until it is null instead of assuming one call returns a whole file.
  • Review generated image inputs and pin custom package versions needed for reproducibility.
  • Re-test lifecycle cleanup and persistent volume retention before deploying a new version.

Read the complete Sandbox changelog.

Built for Anvia.