You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
0.22: ship macOS desktop automation and native helper in a managed plugin #4675
Move macOS desktop automation outside the default core install under #4591 and the platform decision.
Move macOS desktop runtime and the dedicated Swift helper under apple/macos-helper/, including its build, resource discovery, signing/setup and diagnostics ownership where applicable. Resolve the helper from the installed plugin. Map each remaining native path to an actual consumer before moving it.
Use the managed platform contract from 0.22: move web-only runtime out of the mobile-default core package #4597. Preserve app and desktop surfaces, snapshots, input, permissions diagnostics, and cleanup. Core retains macOS host support, shared Apple tools, and the XCTest runner and snapshot bridge used by iOS or tvOS.
Verify a fresh plugins add <macos-desktop-plugin>@<version> --json install and representative --platform macos commands on an authorized host. Prove packed core lacks macOS desktop implementation and helper, preserve packaged iOS/tvOS checks, and report unpacked and download deltas.
Blocked by the reviewed shared platform contract from #4597. The identified helper directory accounts for 115,366 unpacked bytes in the current archive, before JavaScript.
Suggested label:feature (does not look actionable)
The issue proposes moving macOS desktop automation and the Swift helper into a managed plugin, which is planned new behavior rather than a defect. It is explicitly blocked by the platform contract work in #4597, so there is no immediate implementation action available.
Identity: the plugin contributes a leaf claim keyed by family plus OS, { kind: 'platform', family: 'apple', appleOs: 'macos' }. The bundled Apple owner keeps the apple claim for iOS and tvOS and delegates to the installed leaf at its existing isMacOs(device) branches. An absent leaf returns typed plugin-not-installed with the @agent-device/* install hint. platform claim keys gain an optional appleOs part for this; no other family uses it.
Runner: option (a). The plugin owns both macOS app backends (XCTest stays the default for app sessions, native stays opt-in), the ./macos facade, desktop surfaces and command mapping, and apple/macos-helper with its build, discovery, permission diagnostics and cleanup. Core keeps the single Apple XCTest runner (apple/runner, @agent-device/apple-runner), its macOS wire cases (mouseClick, desktopScroll), Swift desktop branches and the Mac signing adapter, and the swift-runner-macos lane. The leaf gets a narrow, host-injected, device-bound runner capability for its XCTest operations.
Package check: packed core must not contain the macOS desktop implementation, the ./macos export or apple/macos-helper. The shared runner's macOS parts listed above are an allowed exception.
Evidence: inventory and runner review (option (b) needs a Swift dispatch split and a plugin-owned build and signing pipeline; option (c) drops the default XCTest backend and loses alternate clicks, double-click, press-and-hold, recording, back and gestures).
Status: not started. Queued after Linux desktop (#4676). Decisions already recorded: design A (leaf claim { kind: 'platform', family: 'apple', appleOs: 'macos' }) and runner option (a): both macOS backends and the Swift helper move to the plugin; the shared XCTest runner with its macOS wire cases stays in core.
Maintainer decision (2026-11-21, recorded for #4933): the host audio sampler moves with the Swift helper into @agent-device/macos. On a macOS host, audio probe for iOS simulator and Android emulator sessions therefore needs that plugin, and without it answers the typed plugin-not-installed outcome with the install hint. Audio probe is a macOS-host-only capability, so it does not belong in the plugin-free mobile core. The help and user docs state this requirement.
Activity
apex-sentinel-staging commentedon Nov 18, 2026
Apex Sentinel · Issue review
Suggested label:
feature(does not look actionable)The issue proposes moving macOS desktop automation and the Swift helper into a managed plugin, which is planned new behavior rather than a defect. It is explicitly blocked by the platform contract work in #4597, so there is no immediate implementation action available.
thymikee commentedon Nov 19, 2026
Decision for the macOS desktop extraction (0.22):
{ kind: 'platform', family: 'apple', appleOs: 'macos' }. The bundled Apple owner keeps theappleclaim for iOS and tvOS and delegates to the installed leaf at its existingisMacOs(device)branches. An absent leaf returns typedplugin-not-installedwith the@agent-device/*install hint.platformclaim keys gain an optionalappleOspart for this; no other family uses it.nativestays opt-in), the./macosfacade, desktop surfaces and command mapping, andapple/macos-helperwith its build, discovery, permission diagnostics and cleanup. Core keeps the single Apple XCTest runner (apple/runner,@agent-device/apple-runner), its macOS wire cases (mouseClick,desktopScroll), Swift desktop branches and the Mac signing adapter, and theswift-runner-macoslane. The leaf gets a narrow, host-injected, device-bound runner capability for its XCTest operations../macosexport orapple/macos-helper. The shared runner's macOS parts listed above are an allowed exception.platformcontribution (0.22: move web-only runtime out of the mobile-default core package #4597 web).Evidence: inventory and runner review (option (b) needs a Swift dispatch split and a plugin-owned build and signing pipeline; option (c) drops the default XCTest backend and loses alternate clicks, double-click, press-and-hold, recording, back and gestures).
thymikee commentedon Nov 20, 2026
Status: not started. Queued after Linux desktop (#4676). Decisions already recorded: design A (leaf claim
{ kind: 'platform', family: 'apple', appleOs: 'macos' }) and runner option (a): both macOS backends and the Swift helper move to the plugin; the shared XCTest runner with its macOS wire cases stays in core.thymikee commentedon Nov 21, 2026
Maintainer decision (2026-11-21, recorded for #4933): the host audio sampler moves with the Swift helper into
@agent-device/macos. On a macOS host,audio probefor iOS simulator and Android emulator sessions therefore needs that plugin, and without it answers the typedplugin-not-installedoutcome with the install hint. Audio probe is a macOS-host-only capability, so it does not belong in the plugin-free mobile core. The help and user docs state this requirement.refactor(macos): ship macOS desktop automation as the managed platfor…