Allow the Rust SDK to bundle the native runtime without the Node CLI

[dmytrostruk]

Summary

Consumers that provide their own Node CLI currently have to embed a second copy to retain the Rust SDK's bundled native runtime. Add an opt-in bundled-runtime feature that downloads and embeds the native wrapper and required assets without downloading or embedding the full Node CLI archive:

github-copilot-sdk = { version = "1", default-features = false, features = ["bundled-runtime"] }

install_bundled_runtime() and managed native startup retain their existing behavior. HAS_BUNDLED_RUNTIME reports whether native assets are embedded; HAS_BUNDLED_CLI is false and install_bundled_cli() returns None in the new mode. Add in-process to include the native runtime library.

The default remains bundled-cli, which still embeds both artifacts. Cargo features remain additive, so enabling bundled-cli anywhere restores the full bundle. Existing local-runtime and download opt-outs are preserved. No dependency pins, other language SDKs, or release workflows change.

Standalone SDK CI now runs the native-only resolution suite on Windows, macOS, Linux and Alpine, with additional in-process coverage on macOS, Linux and Alpine. The test helper clears prepared-runtime overrides so it exercises actual bundling. Nested development checkouts retain their existing artifact-based tests. Startup error guidance also includes the native-only feature and extraction failures.

Release coordination

As described in the contributor guide, this change must also be reconciled into the canonical SDK source before release so subsequent SDK snapshots preserve it.

Validation

Validated on macOS ARM64 with Rust 1.94.0 and runtime pin 1.0.90-6.

Latest review fixes: the exact CI helper passed 7 native-only and 8 native-only plus in-process resolution tests with conflicting CI path/download/transport overrides deliberately set. Nightly formatting, workflow YAML parsing, shell syntax and whitespace checks passed.

Validation of the initial implementation (before the workflow/error-guidance follow-up):

• cli_resolution_test: 7 passed with native-only bundling, 7 with defaults, and 8 with native-only bundling plus in-process. Covers clean extraction, real runtime startup/ping/shutdown, full CLI version probing in default mode, and absence of the CLI payload in native-only mode.
• Embedded installer unit tests with --all-features: 33 passed.
• Clippy across all targets for native-only bundling and --all-features, with warnings denied: passed.
• Nightly Rust formatting and git diff --check: passed.

Windows and Linux execution have not been validated locally.

[Copilot]

Copilot review overview

🟡 Changes recommended

CI does not exercise the new bundled-runtime configurations, and the resolution error guidance remains misleading.

Review effort: Balanced
Findings: 2

Open (2)

• Update BinaryNotFound hint for native-only bundled-runtime mode · New
• Add CI coverage for bundled-runtime native-only configurations · New

What changed in this PR

Adds opt-in Rust native-runtime bundling without embedding the full Node CLI.

Changes:

• Introduces the additive bundled-runtime feature.
• Separates runtime and CLI build artifacts and resolution.
• Adds documentation and runtime-only tests.

File	Description
rust/​Cargo.toml	Defines the new feature hierarchy.
rust/​build/​in_process.rs	Separates runtime and CLI embedding.
rust/​src/​embeddedcli.rs	Supports independent runtime extraction.
rust/​src/​lib.rs	Exposes runtime availability and installation.
rust/​src/​resolve.rs	Resolves bundled runtime independently.
rust/​tests/​cli_resolution_test.rs	Tests runtime-only bundling and startup.
rust/​README.md	Documents feature configurations.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.