[Elliot (theelliotm)]

📖 Description

First PR in the WSLC built-in proxy stack (#1625). Updates the WSLC SDK to 3.0.5, which adds the session network, container network, capability and host loopback APIs the later PRs use. The minimum supported WSL runtime is now 3.0.5.

• Pin WSLC_SDK_VERSION and the package SHA-256 to 3.0.5, and regenerate wslcsdk_sys.rs from the 3.0.5 header. WslcNetworkFlags is added as a flags enum.
• Add generate-wslc-bindings.ps1 -Check to the runbook's validation step.
• Update the prerequisite error message and getting-started guide to WSL 3.0.5.
• Replace the vendored 3.0.3 fallback package with 3.0.5.

🔗 References

Refs #1462
Spec: #1625

🔍 Validation

On ARM64 with WSL 3.0.5.0 (e7ef9a88) and WSLC_SDK_PATH set to the local 3.0.5 SDK build:

• cargo build -p wxc --features wslc --release: passed
• cargo build -p mxc-sdk --bin wxc-wslc-daemon --features wslc --release: passed
• cargo test -p mxc-sdk --features wslc --lib wslc (includes the ABI size checks): passed
• cargo fmt --all -- --check: passed
• cargo build -p mxc-sdk --features wslc --lib without WSLC_SDK_PATH: passed. It downloaded the published 3.0.5 package from the MxcDependencies feed and verified its pinned hash. With the feed unreachable, it fell back to the vendored 3.0.5 package and verified the same hash.
• generate-wslc-bindings.ps1 -Check (vendored 3.0.5 package, clang 22.1.3): passed (committed bindings are current)
• cargo test -p mxc-sdk --features wslc --lib prerequisite_error: passed
• cargo clippy -p mxc-sdk --features wslc --all-targets -- -D warnings: passed
• pwsh tests/scripts/run_wslc_all_tests.ps1 (create-and-run, lifecycle, proxy and stdin suites): passed. The two tar-import tests skipped because their local tars weren't present.

Not run: x64.

✅ Checklist

• Signed the Contributor License Agreement
• Linked to an issue
• For features or changes requiring a spec: linked the issue with maintainer-applied feature-accepted
• For implementation: linked the required approved and merged design/API spec, or explained why no spec is required
• Feature issue remains open unless this PR completes all agreed implementation, validation, and documentation
• Updated documentation (if applicable)
• Updated Copilot instructions (if build, architecture, or conventions changed)
• If this PR changes Cargo.lock, the dependency-feed-check check passes (see pull request builds)

📋 Issue Type

• Bug fix
• Feature
• Task

Microsoft Reviewers: Open in CodeFlow

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

🔵 Needs a closer look

The unpublished SDK has no pinned, reproducible artifact, and blocked Windows CI with ARM64-only validation leaves published-artifact ABI consistency and x64 compatibility requiring maintainer confirmation.

No open issues 🎉

What changed in this PR

Updates the WSLC SDK to 3.0.5 as preparation for the built-in networking proxy described in #1625. This adds bindings for later work without changing backend behavior.

Changes:

• Pins SDK 3.0.5 and regenerates bindings for network, capability, and host-loopback APIs.
• Adds -HeaderPath support for generating bindings from unpublished SDK headers.
• Documents the temporary requirement for a local SDK through WSLC_SDK_PATH until 3.0.5 is published.

File	Description
src/​mxc-sdk/​src/​backends/​wslc/​common/​wslcsdk_sys.rs	Regenerates SDK types, layouts, and function bindings for 3.0.5.
src/​mxc-sdk/​build/​wslc_common/​README.md	Updates SDK version and documents local-build requirements.
src/​mxc-sdk/​build/​build_wslc_common.rs	Pins the SDK version to 3.0.5.
scripts/​generate-wslc-bindings.ps1	Supports explicit headers and generates network flags as bitfields.
docs/​development/​build-and-test/​wslc-sdk-bindings.md	Documents binding generation for unpublished SDK versions.
docs/​backends/​wslc/​wslc-state-aware.md	Updates the SDK version cited in the daemon rationale.

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The 3.0.5 SDK bump lacks a pinned SHA-256, so clean WSLC builds and both Windows CI architectures will still fail verification even after publication.

1 open issue

• Pin the SHA-256 for the 3.0.5 WSLC package · New

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

The FFI/ABI update was validated only against an unpublished local ARM64 SDK, leaving published 3.0.5 header/DLL parity and x64 WSLC compatibility dependent on maintainer verification.

1 open issue

• Pin the SHA-256 for the 3.0.5 WSLC package

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

Both Windows native DLLs and ABI sizes change, but live-host validation covers only ARM64, leaving x64 create-and-run and lifecycle compatibility unverified.

No open issues 🎉

1 resolved since last review

• Pin the SHA-256 for the 3.0.5 WSLC package

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

The native SDK update changes FFI layouts and bundles both architectures, but runtime validation covers only ARM64, leaving x64 WSLC execution against the packaged 3.0.5 SDK unverified.

No open issues 🎉

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The guidance incorrectly presents WSL 3.0.5 as a universal SDK requirement, although only proxied mode requires it, potentially directing users with compatible hosts to unnecessary updates or source builds.

1 open issue

• Limit the WSL 3.0.5 minimum to proxied mode · New

_{Review effort: Balanced}

[Elliot (theelliotm)]

This will be a minimum version bump like all other bumps. There is currently no functionality for version-gating features/testing related to the WSLC SDK.