id: wait_for_ui
module: mcp/tools/ui-automation/wait_for_ui
names:
  mcp: wait_for_ui
  cli: wait-for-ui
description: Poll rs/1 runtime UI snapshots until a selector-based UI predicate, selector-free textContains/gone text predicate, or selector-free settled predicate is satisfied, then record the latest snapshot. Prefer this after navigation or layout changes. Select with elementRef, identifier, label, role, or value when a selector is needed.
outputSchema:
  schema: xcodebuildmcp.output.capture-result
  version: '2'
routing:
  stateful: true
annotations:
  title: Wait for UI
  readOnlyHint: true
  destructiveHint: false
  openWorldHint: false
nextSteps:
  - label: Capture a fresh runtime UI snapshot
    toolId: snapshot_ui
    priority: 1
    when: success
  - label: Wait until the UI is settled
    toolId: wait_for_ui
    priority: 2
    when: success