wait

waitTOOL

Wait until another lease on the iPhone ends, then acquire it. Use only after acquire said it is busy and you decided to wait

Prints the lease id like acquire. Retries every second (no queue order).

Run acquire first and read who holds the iPhone and why. Wait only when your task can wait; otherwise give up or tell the user the iPhone is busy.
On timeout it fails with the current lease's label and reason. Do not loop on wait.
After wait, take a screenshot first: someone else used the phone.

CLI flags in this text are arguments: --reason = reason, --label = label, --idle-timeout = idleTimeoutSeconds, --device = device, --timeout = timeout

Examples (arguments): {"device":"7EF219AD-69B4-423E-B8C4-4F4A6140822F","label":"ses_123","reason":"reply to Anna in Messages","timeout":600}

Parameters

device?string

Device id or name from list (default: the only iPhone)

idleTimeoutSeconds?number

End the lease this long after its last call (default: 600)

label?string

Display text, e.g. your agent session id, shown to others

mac?string

Mac slug from list, e.g. "studio". Needed when several Macs are online

reason *string

Required. The task you need the iPhone for, e.g. "reply to Anna in Messages"

timeout?number

Give up after this many seconds, 1-3600 (default: 600)

Request example

{
  "method": "tools/call",
  "params": {
    "name": "wait",
    "arguments": {
      "device": "string",
      "idleTimeoutSeconds": 0,
      "label": "string",
      "mac": "string",
      "reason": "string",
      "timeout": 0
    }
  }
}