Skip to content

MXC SDK v1.1.0

Latest

Choose a tag to compare

@bbonaby bbonaby released this 15 Nov 05:28
c662018

MXC SDK v1.1.0 adds experimental MicroVM and Windows 365 for Agents backends, development JSON APIs, and Seatbelt Learning Mode.

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, .NET Microsoft.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.captureDenials records accesses blocked by the macOS sandbox to help author policy. The default block mode preserves enforcement; allow mode permits accesses otherwise blocked by default while retaining explicit denies. Requires the 1.1.0 development 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

New Contributors

Full Changelog: v1.0.1...v1.1.0