Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

fix(cua-driver-rs)(macos): sign release with screen-capture entitlement (#1906)

Francesco Bonacci9f994494e0ae
diff --git a/.github/workflows/cd-rust-cua-driver.yml b/.github/workflows/cd-rust-cua-driver.yml
index a6ce07d1c5..16dd4299cb 100644
--- a/.github/workflows/cd-rust-cua-driver.yml
+++ b/.github/workflows/cd-rust-cua-driver.yml
@@ -264,6 +264,7 @@ jobs:
run: |
IDENTITY="Developer ID Application: ${DEVELOPER_NAME} (${TEAM_ID})"
codesign --force --timestamp --options runtime \
+ --entitlements scripts/CuaDriver.entitlements \
--sign "$IDENTITY" release/universal/cua-driver
codesign --verify --strict --verbose=2 release/universal/cua-driver
- name: Assemble CuaDriver.app bundle
@@ -324,6 +325,7 @@ jobs:
# is essentially a no-op on the binary and a fresh signature
# on the bundle wrapper.
codesign --force --deep --timestamp --options runtime \
+ --entitlements scripts/CuaDriver.entitlements \
--sign "$IDENTITY" release/CuaDriver.app
codesign --verify --strict --verbose=2 release/CuaDriver.app
diff --git a/docs/content/docs/cua-driver/reference/changelog.mdx b/docs/content/docs/cua-driver/reference/changelog.mdx
index f2f534655c..dd5fa3b328 100644
--- a/docs/content/docs/cua-driver/reference/changelog.mdx
+++ b/docs/content/docs/cua-driver/reference/changelog.mdx
@@ -18,6 +18,19 @@ The canonical, always-current source is the
release body is auto-generated per release from the commits touching
`libs/cua-driver/rust`, including SHA256 checksums and install instructions.
+## 0.5.4 (2026-06-15)
+
+- **macOS: fix 0x0 screenshots on macOS 15+ — the release bundle now ships the
+ `com.apple.security.device.screen-capture` entitlement.** The macOS release
+ codesign steps signed the universal binary and `CuaDriver.app` with the
+ hardened runtime but passed no entitlements file, so on macOS 15 Sequoia and
+ later `SCStream.startCapture` failed with "Missing entitlements" even when TCC
+ Screen Recording was granted, and vision capture (`screenshot`,
+ `get_window_state`) returned a 0x0 image. The release pipeline now signs with
+ an entitlements plist granting `com.apple.security.device.screen-capture`
+ (plus `com.apple.security.automation.apple-events`), restoring capture
+ (#1893, #1862).
+
## 0.5.3 (2026-06-11)
- **Linux: background drag and held-button tools + MPX parallel drags** (#1871).
diff --git a/libs/cua-driver/rust/scripts/CuaDriver.entitlements b/libs/cua-driver/rust/scripts/CuaDriver.entitlements
new file mode 100644
index 0000000000..9570bbca32
--- /dev/null
+++ b/libs/cua-driver/rust/scripts/CuaDriver.entitlements
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key>com.apple.security.device.screen-capture</key>
+ <true/>
+ <key>com.apple.security.automation.apple-events</key>
+ <true/>
+</dict>
+</plist>