How microsoft/mxc works
MXC is a cross-platform sandboxed code-execution system exposed through Rust, .NET, and Node SDKs. The documented workflow is application request → SDK validation and backend selection → isolated workload; requests carry containment and security policies, and persistent workloads can use a provision/start/execute/stop/deprovision lifecycle. The graph also preserves native FFI, backend-specific lifecycle services, telemetry, and diagnostics. Relationship evidence is limited to the README and the supplied source excerpts/index; unsampled backend wiring is not expanded into guessed calls.
Main entry points: backends Backend selection · mxc-sdk Rust SDK · MxcLifecycle.cs .NET lifecycle API · lib.rs Native C ABI
Components 20
SDK interfaces
- Rust SDK
src/mxc-sdk - .NET lifecycle API
sdk/dotnet/Microsoft.Mxc.Sdk/V1/MxcLifecycle.cs - Node V1 API
sdk/node/src/v1
Runtime engine
- Versioned contracts
src/mxc-sdk/src/core/mxc_contract - Request and policy
src/mxc-sdk/src/core/mxc_common - Backend selection
src/mxc-sdk/src/backends - Native C ABI
src/ffi/mxc_ffi/src/lib.rs - Streaming handles
src/ffi/mxc_ffi/src/streaming.rs - State-aware ABI
src/ffi/mxc_ffi/src/state_aware.rs
Containment backends
- Process container
src/mxc-sdk/src/backends/process_container/common - Bubblewrap backend
src/mxc-sdk/src/backends/bubblewrap/common - Isolation session
src/mxc-sdk/src/backends/isolation_session/common/manager.rs - Windows Sandbox
src/mxc-sdk/src/backends/windows_sandbox/lifecycle - WSLC session manager
src/mxc-sdk/src/bin/wslc_daemon/session_manager.rs - Windows Sandbox daemon
src/mxc-sdk/src/bin/windows_sandbox_daemon/control_server.rs
Operations
- Telemetry and consent
src/mxc-sdk/src/core/mxc_common/telemetry - Diagnostic console
src/tools/mxc_diagnostic_console/src/main.rs - Standalone executor
src/tools/wxc/src/main.rs
Other components
- Application
- Isolated workload
Connections 20
- Application → Rust SDK: calls SDK
README.md - Application → .NET lifecycle API: calls SDK
README.md - Application → Node V1 API: calls SDK
README.md - Rust SDK → Backend selection: selects backend
README.md - .NET lifecycle API → Backend selection: selects backend
README.md - Node V1 API → Backend selection: selects backend
README.md - .NET lifecycle API → Native C ABI: invokes native
sdk/dotnet/Microsoft.Mxc.Sdk/V1/MxcLifecycle.cs - Versioned contracts → Request and policy: defines request
- Backend selection → Process container: runs workload
- Backend selection → Bubblewrap backend: runs workload
- Backend selection → Isolation session: runs workload
src/mxc-sdk/src/backends/isolation_session/common/manager.rs - Backend selection → Windows Sandbox: runs workload
- Backend selection → WSLC session manager: runs workload
- Isolation session → Isolated workload: hosts process
- WSLC session manager → Isolated workload: runs command
- Native C ABI → Streaming handles: exposes streaming
src/ffi/mxc_ffi/src/lib.rs - Native C ABI → State-aware ABI: exposes lifecycle
src/ffi/mxc_ffi/src/lib.rs - Windows Sandbox → Windows Sandbox daemon: uses control service
- Rust SDK → Telemetry and consent: applies consent
- Standalone executor → Isolated workload: launches workload
README.md