wait_for_screen_change
Wait for a screen transition to complete by detecting a change from a previous fingerprint, used when navigation timing is uncertain.
Instructions
Purpose: Detect that a screen transition has occurred by waiting for the current fingerprint to differ from a previous fingerprint.
Capabilities:
Synchronization for uncertain navigation timing
Detection that something changed on screen
Constraints:
Does not verify correctness of the resulting state
Must not be used alone to confirm action success when an applicable expect_* tool exists
For backend/API activity without a visible UI change, pass the runtime action_type into classify_action_outcome and collect network evidence only if the result remains ambiguous
Recommended Usage:
Capture or define the expected outcome
Call an action tool
Use wait_for_screen_change when transition timing is uncertain
Follow with expect_screen when the expected destination is known
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deviceId | No | Optional device id/udid to target | |
| platform | No | Optional platform override (android|ios) | |
| timeoutMs | No | Timeout in ms to wait for change (default 5000) | |
| pollIntervalMs | No | Polling interval in ms (default 300) | |
| previousFingerprint | Yes | The fingerprint to compare against (required) |