Skip to content

v0.2.2

Latest

Choose a tag to compare

@github-actions github-actions released this 10 Nov 07:05
d9346bf

What's new in v0.2.2

Box v0.2.2 fixes Codex startup on Linux, improves compatibility with linked tool installations, and adds streaming responses.

  • Codex on Linux: Fix filesystem queries that Codex needs before opening SQLite, and accept valid Docker namespace mounts during executable validation. Codex needs no binary change. #356, #382
  • Bun and Rustup installations: Accept executables with multiple hard links, which are names for the same file, when sandboxed processes cannot write through those names. On Linux, avoid recursive scans when filename and mount checks establish that the names remain protected. #347, #381
  • Interactive terminals: Keep later Box diagnostics from overwriting the agent's screen. Permission details and warnings remain visible at startup, and piped diagnostics remain live. #353
  • Experimental tool grammars: Apply policy to parsed command actions and effects, such as a Git force push. Enable tool-grammars = true under [experimental-features] in Box's box.toml. Grammars bind to the declared command name and executable, including commands resolved through Box CLI tool packs. #327, #352, #358
  • Streaming responses: Deliver HTTP responses progressively while redacting configured credential values, including values split across chunks. #345
  • Model Context Protocol (MCP): Support protocol 2026-07-28 for local tool servers over standard input and output, including input-answer retries. Canceled admitted calls in that protocol still count in policy history. Legacy protocol versions remain supported. #350
  • Policy corrections: Preserve history across restarts for unchanged rules on MCP tool actions when they still validate against the saved tool schema. Fix policy evaluation for arguments such as a string or list of strings, and recover from discovery failures once Box installs a complete policy. #383, #360, #225
  • Linux runs as root: Honor explicit directory write grants when Box starts as root. New output can remain root-owned. #348

Compatibility notes

  • Tool grammars remain experimental and off by default. Enabling a grammar replaces shell:spawn decisions for its bound command. Grammars inspect command lines, not child processes, environment variables, or program configuration. Review the tool grammar guide before enabling them.
  • Streaming retains the 16 MiB request and MCP tool-list capture limits, and the 300-second upstream deadline. Credential redaction can delay small events until more data arrives or the response finishes.
  • Linux filesystem queries return zero capacity and free-space counts. Programs that interpret those values as a full filesystem can reject operations. Container security profiles must permit the Linux interfaces that Box uses to answer these queries. Restrictive profiles can still block Box startup or filesystem queries. See the filesystem-query fix and its limits.
  • For Rust source consumers, EffectAttempt::ResponseRelease in strands-box-egress-gateway no longer includes body_bytes. Remove that field from code that constructs the variant.

This release includes macOS Apple silicon and Amazon Linux 2023 ARM64 packages. Linux x86-64 remains a build artifact and is not a published package.

Full changes since v0.2.1

Download

Download Box Core into a local directory on macOS (Apple silicon):

curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | sh

Pin this exact release:

curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | BOX_VERSION=v0.2.2 sh

The downloader picks a tarball from the assets below, verifies it against SHA256SUMS.txt, and unpacks its files into ./box-core. Nothing is installed: your $PATH and system directories are untouched. Override the directory with BOX_DOWNLOAD_DIR=/some/path. Write a box.toml and a policy, then run the box by path (./box-core/box run --config ./box.toml).

Linux ARM64

Package availability does not establish security acceptance.
For Amazon Linux 2023 ARM64, download box-v0.2.2-linux-arm64.tar.gz and SHA256SUMS.txt from the assets below. In the download directory, run:

awk '$2 == "box-v0.2.2-linux-arm64.tar.gz"' SHA256SUMS.txt > box-linux.sha256 &&
  test -s box-linux.sha256 &&
  sha256sum --check box-linux.sha256 &&
  mkdir -p box-core &&
  tar -C box-core -xzf box-v0.2.2-linux-arm64.tar.gz &&
  ./box-core/box run --config ./box.toml

The Linux build requires glibc 2.34 or newer, libgcc, and a host that permits Box's namespace, mount, and syscall-filter setup.

Assets

The macOS archive contains Box.app, a box launcher, and helper links into its signed and notarized bundle. Keep that directory intact. Linux archives contain box beside its helpers. SHA256SUMS.txt contains each archive's checksum.