Skip to main content

sandbox_runtime 0.0.85 copy "sandbox_runtime: ^0.0.85" to clipboard
sandbox_runtime: ^0.0.85 copied to clipboard

Dart port of Anthropic Sandbox Runtime (srt) for restricting child process filesystem and network access on macOS, Linux, and Windows with an MXC adapter.

sandbox_runtime #

Dart port of Anthropic Sandbox Runtime, based on v0.0.83 (0bbebed0aa9a8e628dc4df8bc30293550a1988eb).

Provides filesystem and network restrictions for child processes. Import package:sandbox_runtime/sandbox_runtime.dart for the public API, or run dart run sandbox_runtime:srt --help for the CLI.

Platform requirements #

  • macOS: uses the system sandbox-exec command.
  • Linux: requires bubblewrap and socat. The host must permit unprivileged user namespaces. Build optional native helpers with tool/build_spawn_helper.dart and tool/build_seccomp.dart (GCC and libseccomp development files required).
  • Windows: the MXC backend requires an SDK adapter supplied by the embedding application through windowsMxcSdk. No MXC SDK is bundled. The srt-win backend is not supported.
  • The optional Java proxy agent requires a JDK 17 or later to build with tool/build_java_proxy_agent.dart.

This source package does not include prebuilt native helpers. Applications that need them must build and bundle them. Sandbox strength depends on the host platform and configuration; do not assume that unsupported configurations provide isolation.

Example #

Run dart run example/main.dart on macOS or a Linux host that meets the platform requirements. The example validates a restrictive policy and runs a simple command inside the sandbox.

Development #

Run dart pub get, dart analyze, and dart test. For port-fidelity tests, check out the upstream baseline above and set SRT_UPSTREAM to its directory. Some platform and optional-tool tests skip when their prerequisites are absent. CI runs Linux x64/ARM64 and macOS host suites, plus Windows configuration and fake-SDK tests; it does not exercise a real Windows MXC installation.

Releases #

pub.dev publishes from Telosnex/sandbox_runtime_dart, environment pub.dev, tag pattern pub-sandbox_runtime-v{{version}}. Tags use the pubspec version. The shared Telosnex workflow runs analysis, tests and the pana quality gate before publication. Upstream watch checks the pinned upstream commit daily.

License #

Apache-2.0. See LICENSE and NOTICE for attribution.

0
likes
160
points
213
downloads

Documentation

API reference

Publisher

verified publishertelosnex.com

Weekly Downloads

Dart port of Anthropic Sandbox Runtime (srt) for restricting child process filesystem and network access on macOS, Linux, and Windows with an MXC adapter.

Repository (GitHub)
View/report issues

License

Apache-2.0 (license)

Dependencies

args, asn1lib, crypto, ffi, path, pointycastle

More

Packages that depend on sandbox_runtime