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
Commit 88b9ead
Browse filesBrowse the repository at this point in the historyBrowse files
docs(adr): describe the one session conflict predicate for macOS app claims
ADR 0034 rules 5 and 7 state the predicate shared by the new-session
check and open --wait, and the background open now follows the session's
scope. ADR 0007 and ADR 0031 and the macOS command notes match.
- Use `click --button secondary`for context menus on macOS, then run `snapshot -i` again.
349
349
- On `frontmost-app` and `menubar` surfaces, `press` and `click` post synthetic mouse events through the macOS helper (the `desktop` surface inspects only): `--hold-ms` is how long the button stays down (at least 40 ms, 60 ms by default, because AppKit drops a release posted in the same tick as its press), `--count` is that many independent clicks (apps that detect a double-click by timing, such as Finder, still read two clicks at the default interval as one; pass an `--interval-ms` longer than the system double-click time to keep them apart), and `--double-tap` posts each click as a double-click pair. A long schedule such as `--hold-ms 10000 --count 4` is given the time it needs, and a helper stopped mid-hold — by a cancelled request, a dropped client, or its deadline — releases the button before it exits. `--jitter-px` is not applied on these surfaces.
350
350
- With `AGENT_DEVICE_MACOS_APP_BACKEND=native`, macOS app sessions run without XCTest: no Automation Mode overlay, the app can stay behind other windows, and the real pointer stays with you while a drawn pointer shows each action. `click`, `press`, and `fill` use accessibility actions on the element at their target point, which must lie inside one of the app's own on-screen windows and not on its menu bar; `type` inserts at the focused control and falls back to key events sent to the app; `scroll` moves the accessibility scroll bar under the front window's center. Chromium-based apps expose their full tree. The daemon then never starts the Apple runner on macOS: `record`, `prepare`, `back`, `longpress` and `--hold-ms`, `--double-tap`, `--button secondary`, and gestures are refused with `UNSUPPORTED_OPERATION` (`reason: unsupported-device-backend`), as is a click on an element with no accessibility action. Use the default XCTest backend for those. `screenshot` captures only the app's front window, even when other windows cover it.
351
-
- With the native backend, `open <app>` launches or reopens the app without bringing it to the front, and an app session claims only its app, not the whole Mac: sessions in other daemons (separate `AGENT_DEVICE_STATE_DIR`s) or other sessions of the same daemon can drive other apps at the same time, while a second session on the same appgets `DEVICE_IN_USE`. Desktop, `menubar` and `frontmost-app` sessions, XCTest sessions, and opens of a URL alone still claim the whole Mac, which excludes every app claim. An app session cannot reopen another app or surface; close it or use another `--session`. Two copies of one app need distinct bundle ids. Screenshots from all sessions on the Mac are taken one at a time.
351
+
- With the native backend, an app session claims only its app, not the whole Mac, and `open <app>` launches or reopens that app without bringing it to the front: sessions in other daemons (separate `AGENT_DEVICE_STATE_DIR`s) or other sessions of the same daemon can drive other apps at the same time, while a second session on the same app, including a `macos-app` lease session, gets `DEVICE_IN_USE`, or waits for it under `open --wait`. Desktop, `menubar` and `frontmost-app` sessions, XCTest sessions, and opens of a URL alone still claim the whole Mac, which excludes every app claim. An app session cannot reopen another app or surface; close it or use another `--session`. Two copies of one app need distinct bundle ids. Screenshots from all sessions on the Mac are taken one at a time.
352
352
- Mobile-only helpers are unsupported on macOS: `boot`, `shutdown`, `home`, `orientation`, `app-switcher`, `action-button`, `fold`, `install`, `reinstall`, `install-from-source`, and `push`.
0 commit comments