Skip to content

Computer use for the Pi coding agent — Windows apps, browsers and desktops through native UI trees, screenshots and real input.

docs(runtime): document the released 0.38.0 build and scope

Aleksandr Shpuntenkoabc504588460
diff --git a/docs/bundled-runtime.md b/docs/bundled-runtime.md
index 3c3962d..20d47ee 100644
--- a/docs/bundled-runtime.md
+++ b/docs/bundled-runtime.md
@@ -1,6 +1,6 @@
# Bundled CUA runtime
-The npm package carries one native runtime: Cua Driver 0.37.0 for Windows x64, built from the `pi-computer-use` branch of the [alexshpunt/cua](https://github.com/alexshpunt/cua) fork at source `33c4b82b`. [FORK.md](https://github.com/alexshpunt/cua/blob/pi-computer-use/FORK.md) lists what the fork adds to upstream Cua Driver. It is the qualified `windows-desktop` profile, so a fresh installation gets every native capability without any configuration:
+The npm package carries one native runtime: Cua Driver 0.38.0 for Windows x64, built from source `505d090e` of the [alexshpunt/cua](https://github.com/alexshpunt/cua) fork. [FORK.md](https://github.com/alexshpunt/cua/blob/pi-computer-use/FORK.md) lists the fork's changes. The `windows-desktop` profile needs no separate driver configuration:
```sh
pi install npm:pi-agent-computer-use
@@ -10,7 +10,7 @@ An update installs a new extension version with its exact runtime. Computer use
## Where the files come from
-The files are published as the fork release [`pi-runtime-0.37.0-33c4b82b`](https://github.com/alexshpunt/cua/releases/tag/pi-runtime-0.37.0-33c4b82b): `cua-driver.exe`, `cua-driver-uia.exe`, `cua-cursor-theme.exe`, `LICENSE.md` and `THIRD_PARTY_NOTICES.md`. They are byte-identical to the fork's CI build of that commit.
+The files are published as the fork release [`pi-runtime-0.38.0-505d090e`](https://github.com/alexshpunt/cua/releases/tag/pi-runtime-0.38.0-505d090e): `cua-driver.exe`, `cua-driver-uia.exe`, `cua-cursor-theme.exe`, `LICENSE.md` and `THIRD_PARTY_NOTICES.md`. They were cross-built with Rust 1.97.1, cargo-xwin 0.23.1 and LLVM 18, with a static CRT and canonical Windows manifest resources. They are not copies of a GitHub Actions artifact.
`src/runtime-pins.json` pins the source, the version, the release URL and the SHA-256 of every file. Before packing, `npm pack` runs `scripts/fetch-runtime.mjs`, which downloads the files into `native-runtime/win32-x64/runtime/` and checks each hash. The directory is not committed to Git.
@@ -43,6 +43,8 @@ Computer use owns one MCP child. It disables telemetry and update checks, requir
## System requirements
- The Windows binaries are unsigned. Shipping a UIAccess helper does not grant UIAccess rights or bypass Windows trust policy.
+- UIAccess/trusted-path deployment and UWP or elevated-window targets are not qualified by this runtime profile.
+- Physical multi-monitor, mixed-DPI and negative-origin layouts, and concurrent desktop ownership, need separate qualification.
- WSL needs a working Windows interop endpoint.
- [Native visuals](native-observability.md) require advertised driver capabilities. The adapter alone does not qualify a renderer or establish screenshot exclusion.