Skip to content

Commit 7f9772f

Browse files
thymikeeclaude
andcommitted
docs(open): scope the post-open settle to opens that report a verdict
Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent b595eb8 commit 7f9772f

2 files changed

Lines changed: 6 additions & 5 deletions

File tree

‎src/daemon/deferred-interaction-outcome.ts‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -109,10 +109,11 @@ function markPostGestureStabilization(
109109
}
110110

111111
/**
112-
* Called once an app open has published its session. Any defined verdict other than `observable`
113-
* means the open returned on a fixed delay without reading the app, so nothing proved the layout at
114-
* rest and the next capture runs the quiet-window loop (#3354, #3367). No baseline: the pre-open
115-
* tree is a different surface, so the open is never reported as having no effect.
112+
* Called once an app open has published its session. Any verdict other than `observable` means the
113+
* open returned on a fixed delay without reading the app, so nothing proved the layout at rest and
114+
* the next capture runs the quiet-window loop (#3354, #3367). An open without a verdict launched no
115+
* app the owner could watch (a URL-only open, a physical device), so it does not mark. No baseline:
116+
* the pre-open tree is a different surface, so the open is never reported as having no effect.
116117
*/
117118
export function markPostOpenStabilization(
118119
session: SessionState,

‎website/docs/docs/commands.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ agent-device fold open
9393
- Android: `shutdown --platform android --device <avd-name>` stops a running emulator.
9494
- `open [app|url] [url]` boots and activates the selected target when needed.
9595
- `open <app> --wait <ms>` waits up to that budget for a device another session is holding instead of failing at once, then fails with `DEVICE_IN_USE` if the budget runs out. Only session contention is waited for: a device claim held by another workspace's daemon is never retriable and returns its recovery command immediately. The wait extends the command's timeout envelope, so a long budget does not need a longer `--timeout`. See [Sessions](/docs/sessions#wait-for-a-slow-or-busy-device) for queuing behavior.
96-
- On an iOS Simulator, `open` tries to read the launched app before it returns. When it could not (`timing.postOpenObservation` is anything other than `"observable"`), the next command that reads the screen keeps reading until two reads in a row agree, within a short bounded wait, before it acts. A `click` right after such an open then targets where the element comes to rest, not where it was mid-launch. If the screen is still moving after that wait, the command proceeds and its response warns that the surface was still changing after `open`. After an `observable` open, the next command reads the screen once.
96+
- On an iOS Simulator, an `open` that launches an app tries to read it before returning, and reports the result as `timing.postOpenObservation`. When that value is present and is not `"observable"`, the next command that reads the screen keeps reading until two reads in a row agree, within a short bounded wait, before it acts. A `click` right after such an open then targets where the element comes to rest, not where it was mid-launch. If the screen is still moving after that wait, the command proceeds and its response warns that the surface was still changing after `open`. After an `observable` open, or an open that reports no `postOpenObservation`, the next command reads the screen once.
9797
- `open <url>` deep links are supported on Android and iOS.
9898
- On an iOS Simulator, handing the URL to the device is one bounded `simctl openurl`: when CoreSimulator never answers it, the open fails within 20 seconds with `details.reason: ios-simulator-openurl-timeout` and kills the child, instead of the request being cancelled around a still-running `openurl`. The Simulator may still have received the URL, so retry the open or answer the prompt with `alert accept`.
9999
- `open <app> <url>` opens a deep link on iOS.

0 commit comments

Comments
 (0)