Repository navigation
MXC SDK v1.1.0 adds experimental MicroVM and Windows 365 for Agents backends, development JSON APIs, and Seatbelt Learning Mode.
- Crates.io: https://crates.io/crates/mxc-sdk/1.1.0
- NPM: https://www.npmjs.com/package/@microsoft/mxc-sdk/v/1.1.0
- NuGet: Microsoft.Mxc.Sdk 1.1.0
See the Assets section for mxc-release-binaries.zip, which contains release binaries that can be useful for testing.
What's Changed
Experimental features
-
MicroVM (NVX) Backend: Run Linux workloads in a MicroVM on Windows x64, with captured output, live stdout/stderr, and container lifecycle operations. Requires Windows Hypervisor Platform and the complete NVX runtime bundle; writable stdin and PTY are not supported. See the NVX guide for setup, optional Node/.NET runtime packages, policy support, and limitations.
Needed optional packages: -
Windows 365 for Agents Backend: Check out a Cloud PC, wait for readiness, execute commands with captured output or live pipes, and explicitly release the reservation. Rust, .NET, and Node callers can use the Dev JSON APIs from Windows, Linux, or macOS. Requires an authorized pool and service credentials. This backend supports container lifecycle operations, not create-and-run execution. See the Windows 365 for Agents guide.
-
Dev JSON APIs: Use JSON requests to run workloads, manage container lifecycles, and validate configuration through Rust
mxc_sdk::v1::dev, .NETMicrosoft.Mxc.Sdk.V1.Dev, or Node@microsoft/mxc-sdk/v1/dev. Experimental backends require explicit invocation opt-in, independently of the JSON version. See the API references for Rust, .NET, and Node. -
Seatbelt Learning Mode:
seatbelt.captureDenialsrecords accesses blocked by the macOS sandbox to help author policy. The defaultblockmode preserves enforcement;allowmode permits accesses otherwise blocked by default while retaining explicit denies. Requires the1.1.0development contract through the executor or Dev JSON APIs. See Learning Mode.
W365A availability: MXC's experimental W365A backend currently works only with a Microsoft test tenant. We are working to enable it for all W365A-enabled tenants. For general service information, see Windows 365 for Agents in Agent 365.
Use the V1.Dev JSON APIs for development-contract features and experimental backends. Typed V1 SDK APIs target the stable contract for production-ready functionality. See the SDK API reference for available operations.
Behavior changes
-
ProcessContainer: Removed the legacy filesystem-broker and host-permission fallbacks because they were unreliable and could require administrator privileges and permission changes on the host's system drive. Execution and denial capture now require native PSEC support; unsupported hosts or policies are rejected before workload launch.
-
WSLC sessions and networking: Adds explicit session lifecycle operations in the development contract and a built-in filtering proxy for create-and-run TCP/IPv4 egress. Update the installed WSL runtime to 3.0.5 or later. See the WSLC guide for supported modes and restrictions.
-
Bubblewrap: An always-on seccomp filter restricts socket address families and
io_uring. -
SDK standard I/O: Extended spawn options can attach a workload to the caller's existing stdin, stdout, and stderr on ProcessContainer, Bubblewrap, and Seatbelt, without allocating replacement pipes or a PTY.
-
.NET: The SDK now targets both .NET 8 and .NET 10; .NET 9 applications use the .NET 8 assembly. Building the SDK from source requires the .NET 10 SDK.
-
Executor diagnostics: Errors and warnings are emitted as structured JSON diagnostics on stderr so callers can inspect codes instead of matching prose.
-
Windows diagnostic data: Supported routed Windows builds collect four Required diagnostic events across all supported request contracts, including typed V1 requests. Request telemetry settings, consent withdrawal, and administrative policy do not disable these events; other events are excluded for these contracts. Telemetry remains unavailable on Linux and macOS. See diagnostic data and compatibility.
What's Changed
- Codify MXC agent and code-review guidance by Branden Bonaby (@bbonaby) in #1519
- [WSLC] (2/4) Hold multiple sessions in the lifecycle daemon by Soham Das (@SohamDas2021) in #1489
- [WSLC] (3/4) Add the session lifecycle phases and dispatch routing by Soham Das (@SohamDas2021) in #1503
- Removing CAP_NET_RAW and adding ping group range to keep ping. by Darren Hoehna (@dhoehna) in #1457
- [Hyperlight] Fetch images over native-tls instead of rustls by adpa-ms in #1536
- Restrict default Seatbelt PTY access to workload terminals by Elliot (@theelliotm) in #1530
- [WSLC] (4/4) Expose explicit session lifecycle by Soham Das (@SohamDas2021) in #1512
- feat: NVX integration design doc by Huzaifa Danish (@huzaifa-d) in #1448
- Remove the Electron Playground by Gudge (@MGudgin) in #1546
- test: scope host loopback coverage to direct connections test: fix ARM64 by Branden Bonaby (@bbonaby) in #1553
- [WSLC] Bump WSLc SDK to 3.0.3 by Soham Das (@SohamDas2021) in #1550
- test: serialize IsolationSession integration tests by Branden Bonaby (@bbonaby) in #1557
- IsolationSession test bundle: ship test_scripts/lib/LoopbackAnchor.ps1 by Dan Legg (@danlegg) in #1501
- [IsolationSession] Keep async exec exit codes under Windows PowerShell 5.1 by adpa-ms in #1561
- [Bubblewrap] Fix terminal isolation and startup cancellation by Soham Das (@SohamDas2021) in #1541
- Remove the unused Node subprocess spawn helper by Gudge (@MGudgin) in #1547
- [Bubblewrap] Restrict socket address families and io_uring with an always-on seccomp filter by Soham Das (@SohamDas2021) in #1529
- Remove Tier2 and Tier3 ProcessContainer fallbacks by Gudge (@MGudgin) in #1558
- Add a relay to enable a loopback proxy in LXC by Darren Hoehna (@dhoehna) in #1554
- Remove dead code left by the ProcessContainer fallbacks by Gudge (@MGudgin) in #1559
- [Seatbelt] Fix symlink and parent-traversal policy enforcement by Elliot (@theelliotm) in #1531
- [CI] Upload only test logs from the Windows validation jobs by adpa-ms in #1570
- chore(deps): bump fast-uri from 3.1.8 to 3.1.9 in /scripts/versioning by Dependabot (@dependabot)[bot] in #1571
- [CI] Fix RHEL io_uring and arm64 cold-start nightly test failures by Elliot (@theelliotm) in #1569
- [WSLC] (1/2) Forward host stdin to state-aware exec by Soham Das (@SohamDas2021) in #1562
- [WSLC] (2/2) Forward host stdin to create-and-run execution by Soham Das (@SohamDas2021) in #1564
- Define the feature contribution and spec review process by Branden Bonaby (@bbonaby) in #1534
- Document how MXC is managed by Branden Bonaby (@bbonaby) in #1593
- Cover Node filesystem discovery edge cases by Gudge (@MGudgin) in #1574
- Add denied-path precedence regression coverage by Gudge (@MGudgin) in #1567
- NVX Phase 1: Minimal Signed MicroVM integration by Huzaifa Danish (@huzaifa-d) in #1528
- Restrict PowerShell discovery to scoped filesystem grants by Gudge (@MGudgin) in #1590
- [Bubblewrap] Keep host resolver sockets out of sandboxes by Soham Das (@SohamDas2021) in #1568
- [Bubblewrap] Fork bwrap from a process-lifetime thread by Keith Mattix II (@keithmattix) in #1526
- Complete V1.Dev exact-JSON SDK APIs by Gudge (@MGudgin) in #1412
- Auto-generated baselines by 1ES Pipeline Templates by @microsoft-github-policy-service[bot] in #1601
- Emit errors and warnings as structured ScriptResponse JSON by Elliot (@theelliotm) in #1482
- chore(deps): bump zip from 2.4.2 to 9.0.5 in /src by Dependabot (@dependabot)[bot] in #1612
- Fix stale and inaccessible rustdoc links by Gudge (@MGudgin) in #1616
- Fix .NET captured execution timeout cleanup by Gudge (@MGudgin) in #1613
- fix(bubblewrap): make denied directory masks read-only by Carlos Alexandro Becker (@caarlos0) in #1602
- [Bubblewrap] Find host tools in standard system directories when PATH omits them by Soham Das (@SohamDas2021) in #1578
- [WSLC] Always warn when a stdin flood may have lost a command's output by Soham Das (@SohamDas2021) in #1620
- Bound filesystem policy probes during sandbox startup by Soham Das (@SohamDas2021) in #1604
- [WSLC] Stdin work follow-up by Soham Das (@SohamDas2021) in #1597
- NVX Phase 2: Policy Support and Image Selection by Huzaifa Danish (@huzaifa-d) in #1538
- [Bubblewrap] Avoid redundant namespace probe on launch by Carlos Alexandro Becker (@caarlos0) in #1618
- CI: Use host CPU profiles for MicroVMs by Huzaifa Danish (@huzaifa-d) in #1626
- [Bubblewrap] Recreate merged-/usr directory symlinks in the sandbox by Soham Das (@SohamDas2021) in #1624
- Improve MXC execution telemetry and lifecycle correlation by Richie Gomez (@richiemsft) in #1575
- Add .NET 10 support while retaining .NET 8 compatibility by Gudge (@MGudgin) in #1563
- [Seatbelt] Proposal: Learning Mode by Elliot (@theelliotm) in #1609
- CI: upgrade ESRP signing tasks to Node20 by Dan Legg (@danlegg) in #1663
- Extract the .NET package smoke test into a shared script by Gudge (@MGudgin) in #1655
- Remove the node-gyp devDependency from the Node SDK by adpa-ms in #1677
- [Seatbelt] Cleanup Detached Descendants and Document Cleanup Behavior by Elliot (@theelliotm) in #1646
- Fix stdin relay for pipes in IsoSession by Dom Giandinoto (@daamenik) in #1450
- docs: propose Windows 365 for Agents backend design by tbyfield in #1619
- Load telemetry routing metadata from a signed component DLL; remove admin registry policy by Richie Gomez (@richiemsft) in #1673
- Use conntrack for Linux firewall state matching by Darren Hoehna (@dhoehna) in #1674
- [WSLC] Reject unsupported targetOs values by Soham Das (@SohamDas2021) in #1664
- [Hyperlight] Bump hyperlight-unikraft to v0.21.0 by Dan Chiarlone (@danbugs) in #1687
- [Bubblewrap] Mount symlinked grants at their real paths by Soham Das (@SohamDas2021) in #1638
- Document ProcessContainer filesystem access baseline by Gudge (@MGudgin) in #1598
- Guard more effectively against stdout truncation by Dom Giandinoto (@daamenik) in #1520
- NVX Phase 3: Streaming and Container Lifecycle by Huzaifa Danish (@huzaifa-d) in #1539
- NVX: Replace native DLL handling with aci_edge_sandboxes crate by Huzaifa Danish (@huzaifa-d) in #1672
- docs: propose caller-owned policy preparation by Ross Nichols (@rossnichols) in #1635
- [Seatbelt] Add learning mode (captureDenials) by Elliot (@theelliotm) in #1668
- NVX: Reuse registered images across create-and-run requests by Pedro Henrique Penna (@ppenna) in #1691
- Add W365 Agents Phase 1 development request contract by tbyfield in #1697
- Reject embedded NULL in containerID by Safet Hrbinic (@safmswork) in #1556
- [WSLC] (1/2) Set operation and nativeCode on container lifecycle errors by Soham Das (@SohamDas2021) in #1671
- [WSLC] Proxy Pt. 1: Update SDK to 3.0.5 by Elliot (@theelliotm) in #1679
- Update NVX runtime bundle to 0.2.0 by Huzaifa Danish (@huzaifa-d) in #1724
- Fix Linux CI packages and test Ubuntu 24.04 and 26.04 by Branden Bonaby (@bbonaby) in #1748
- Implement W365 Agents Phase 2 checkout and release lifecycle by tbyfield in #1723
- [WSLC] Proxy Pt. 3: Add runtimeConfig to WSLC provision contract by Elliot (@theelliotm) in #1717
- [WSLC] Proxy Pt. 4: Apply the cooperative proxy in the daemon by Elliot (@theelliotm) in #1719
- NVX: skip MXC runtime bundle validation by Enrique Saurez (@esaurez) in #1755
- NVX: enable platform snapshots for create-and-run and lifecycle starts by Enrique Saurez (@esaurez) in #1749
- [Bubblewrap] Prevent workloads after failed network setup by Soham Das (@SohamDas2021) in #1716
- Extend Required-only telemetry to all supported contracts by Richie Gomez (@richiemsft) in #1733
- Fix W365 contract test compilation after telemetry attribution change by Richie Gomez (@richiemsft) in #1771
- Fix learning-mode trace fallback when network sources are unsupported by Richie Gomez (@richiemsft) in #1769
- fix(bubblewrap): prepare missing deny mountpoints privately by Carlos Alexandro Becker (@caarlos0) in #1742
- [WSLC] Proxy Pt. 5: Gateway binary and image by Elliot (@theelliotm) in #1740
- [IsolationSession] Drive the concurrent one-shot test over stdin by adpa-ms in #1766
- [WSLC] Proxy Pt. 6: Proxied egress for create-and-run by Elliot (@theelliotm) in #1753
- Add spawn_with_extended_options with inherited stdio for ProcessContainer, Bubblewrap, and Seatbelt by Soham Das (@SohamDas2021) in #1761
- Phase 4: Add Node and .NET NVX SDK support with some Rust plumbing by Huzaifa Danish (@huzaifa-d) in #1752
- Fix ADO build and SDK integration pipelines by Branden Bonaby (@bbonaby) in #1774
- [WSLC] Give spawn a writable stdin and remove the WithStdin APIs by Soham Das (@SohamDas2021) in #1762
- Bump SDK versions to 1.1.0 by Branden Bonaby (@bbonaby) in #1776
- Implement W365 Agents Phase 3 readiness and execution by tbyfield in #1756
- Fix ADO npm caching and package releases by Branden Bonaby (@bbonaby) in #1777
- Fix macOS W365 Node TLS test by Branden Bonaby (@bbonaby) in #1778
- Fix NuGet release SBOM generation by Branden Bonaby (@bbonaby) in #1779
New Contributors
- Keith Mattix II (@keithmattix) made their first contribution in #1526
- tbyfield made their first contribution in #1619
- Safet Hrbinic (@safmswork) made their first contribution in #1556
- Enrique Saurez (@esaurez) made their first contribution in #1755
Full Changelog: v1.0.1...v1.1.0