v0.4.0

superradcompany/microsandboxv0.4.0Apr 28, 2026by github-actions[bot]

AI Summary

This release introduces significant updates to microsandbox v0.4.0, including a redesigned TypeScript SDK with builder API and bundled binaries, block-backed OCI rootfs support via VMDK + EROFS, and enhanced network policy management with per-rule direction. The release also adds DNS query interception for TCP/53 and DoT/853, host CA trust inside sandbox guests, and improved volume mounting capabilities.

Key Highlights

  • Redesigned TypeScript SDK with builder API and bundled binaries
  • Block-backed OCI rootfs via VMDK + EROFS fsmeta
  • Network policy schema redesign with per-rule direction and new CLI grammar
  • DNS query interception for TCP/53 and DoT/853 protocols
  • Host CA trust inside sandbox guests (opt-in)

Breaking Changes

  • feat(image)!: block-backed OCI rootfs via VMDK + EROFS fsmeta
  • feat(sdk-node)!: redesign TypeScript SDK with builder API and bundled binaries

New Features

  • execStreamWithConfig for TypeScript SDK
  • AgentdConfig to read env vars once at startup
  • Support custom TLS certs and insecure registries
  • Add sandbox-wide guest rlimits
  • Keyring feature flag
  • Add disk-image volume mounts and unified readonly
  • Add host.microsandbox.internal alias
  • Improve domain & domain suffix rules enforcement
  • Self-heal shims when msb binary is missing
  • Secret Injection options for node-ts SDK
  • Trust host CAs inside sandbox guests (opt-in)
  • DNS nameserver fetching via scdynamicstore on macos
  • Integration test infrastructure
  • Policy + DNS builders with lazy-parse error model

Full Release Notes

## What's Changed
* fix(sdk): self-heal shims when msb binary is missing by @appcypher in https://github.com/superradcompany/microsandbox/pull/575
* execStreamWithConfig for TS SDK by @wellsbunk5 in https://github.com/superradcompany/microsandbox/pull/569
* feat(image)!: block-backed OCI rootfs via VMDK + EROFS fsmeta by @appcypher in https://github.com/superradcompany/microsandbox/pull/548
* fix(runtime): restore VM boot and agentd docker build by @appcypher in https://github.com/superradcompany/microsandbox/pull/579
* feat(agentd): introduce AgentdConfig to read env vars once at startup by @dijdzv in https://github.com/superradcompany/microsandbox/pull/507
* build: use vendored dbus by @Glatzel in https://github.com/superradcompany/microsandbox/pull/562
* Add sandbox-wide guest rlimits by @enricoschaaf in https://github.com/superradcompany/microsandbox/pull/549
* Add keyring feature flag by @enricoschaaf in https://github.com/superradcompany/microsandbox/pull/563
* refactor(agentd): split BootParams out of AgentdConfig by @appcypher in https://github.com/superradcompany/microsandbox/pull/580
* refactor(dns): forward via hickory-client instead of hickory-resolver by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/578
* docs: refresh banner palette and clean up duplicate assets by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/581
* feat(image): support custom TLS certs and insecure registries by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/496
* docs: add recipe for pulling images from local docker registry by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/474
* ci: sync mintlify branch to release commit by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/588
* Adding Secret Injection options similar to the Rust SDK for node-ts sdk. by @wellsbunk5 in https://github.com/superradcompany/microsandbox/pull/586
* feat(network): trust host CAs inside sandbox guests (opt-in) by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/583
* fix(dns): fetch nameservers via scdynamicstore on macos by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/582
* test: add integration test infrastructure by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/547
* feat(dns): intercept tcp/53 and dot/853 queries by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/585
* docs(networking): split into overview, dns, tls, security-model by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/584
* chore(deps): bump rustls-webpki from 0.103.11 to 0.103.13 in the cargo group across 1 directory by @dependabot[bot] in https://github.com/superradcompany/microsandbox/pull/596
* fix(network): improve domain & domain suffix rules enforcement by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/605
* feat(sdk): expose per-sandbox libkrunfw_path override by @appcypher in https://github.com/superradcompany/microsandbox/pull/599
* feat(network): add host.microsandbox.internal alias by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/602
* chore(deps-dev): bump postcss from 8.5.9 to 8.5.10 in /sdk/node-ts in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/superradcompany/microsandbox/pull/614
* feat(volumes): add disk-image volume mounts and unified readonly by @appcypher in https://github.com/superradcompany/microsandbox/pull/609
* feat(network): redesign policy schema with per-rule direction (1/4) by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/618
* feat(network): policy + dns builders with lazy-parse error model by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/619
* Fix command syntax in README examples by @mahmudsudo in https://github.com/superradcompany/microsandbox/pull/622
* feat(cli): --net-rule grammar and flag set rewrite by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/620
* docs(networking): align with new policy, add ts builder by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/616
* feat(sdk-node)!: redesign TypeScript SDK with builder API and bundled binaries by @appcypher in https://github.com/superradcompany/microsandbox/pull/623
* chore: bump version to 0.4.0 by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/627
* fix(ci): pass napi target only to build:native in release by @toksdotdev in https://github.com/superradcompany/microsandbox/pull/629

## New Contributors
* @wellsbunk5 made their first contribution in https://github.com/superradcompany/microsandbox/pull/569
* @Glatzel made their first contribution in https://github.com/superradcompany/microsandbox/pull/562
* @mahmudsudo made their first contribution in https://github.com/superradcompany/microsandbox/pull/622

**Full Changelog**: https://github.com/superradcompany/microsandbox/compare/v0.3.14...v0.4.0