Skip to content

fix(desktop): weak-link ScreenCaptureKit so the Computer Use helper loads on macOS 14 and 15 #9978

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 1 commit into from
Nov 13, 2026
Merged

fix(desktop): weak-link ScreenCaptureKit so the Computer Use helper loads on macOS 14 and 15 #9978

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions apps/desktop/scripts/build-native.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ function compileComputerUse(): void {
try {
execFileSync('xcrun', ['lipo', binary, '-verify_arch', 'arm64', 'x86_64'])
execFileSync('codesign', ['--verify', '--strict', bundle])
assertWeakScreenCaptureKit(binary)
return
} catch {
rmSync(bundle, { recursive: true, force: true })
Expand All @@ -108,6 +109,11 @@ function compileComputerUse(): void {
'-O',
'-target',
`${arch}-apple-macosx14.0`,
// The macOS 26 screenshot classes do not exist on 14/15; a strong reference stops the helper loading there.
'-Xlinker',
'-weak_framework',
'-Xlinker',
'ScreenCaptureKit',
'native/computer-use/ComputerUse.swift',
'-o',
output,
Expand All @@ -118,9 +124,27 @@ function compileComputerUse(): void {
}
execFileSync('xcrun', ['lipo', '-create', ...parts, '-output', binary], { stdio: 'inherit' })
for (const part of parts) rmSync(part)
assertWeakScreenCaptureKit(binary)
execFileSync('codesign', ['--force', '--sign', '-', bundle], { stdio: 'inherit' })
recordNativeBuild('computer-use', outputs)
logger.info('Compiled native macOS Computer Use helper')
}

/**
* The helper targets macOS 14 but uses ScreenCaptureKit classes added later behind `#available`.
* Runners build on the newest macOS, where a strong reference still loads, so this is the only
* place a helper that dyld would refuse on older macOS is caught before it ships.
*/
function assertWeakScreenCaptureKit(binary: string) {
const strong = execFileSync('nm', ['-m', binary], { encoding: 'utf8' })
.split('\n')
.filter(
(line) => line.includes('(undefined) external') && line.includes('(from ScreenCaptureKit)')
)
if (strong.length > 0)
throw new Error(
`The Computer Use helper links ScreenCaptureKit strongly and would not load on macOS 14/15:\n${strong.join('\n')}`
)
}

if (args.includes('--computer-use')) compileComputerUse()
Loading