From 7bfe633fd5c8b541e26bcfc2b346b6cdbabece92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Pierzcha=C5=82a?= Date: Wed, 18 Feb 2026 14:33:09 +0100 Subject: [PATCH] docs: document XCUITest pasteboard prompt suppression Add Known Limitations page to the website and a brief note in the skills permissions reference covering the iOS "Allow Paste" dialog being suppressed under XCUITest automation. Co-authored-by: Cursor --- skills/agent-device/references/permissions.md | 4 ++++ website/docs/docs/_meta.json | 5 +++++ website/docs/docs/known-limitations.md | 21 +++++++++++++++++++ 3 files changed, 30 insertions(+) create mode 100644 website/docs/docs/known-limitations.md diff --git a/skills/agent-device/references/permissions.md b/skills/agent-device/references/permissions.md index e2f41c6da..441849930 100644 --- a/skills/agent-device/references/permissions.md +++ b/skills/agent-device/references/permissions.md @@ -22,6 +22,10 @@ If daemon startup fails with stale metadata hints, clean stale files and retry: - `~/.agent-device/daemon.json` - `~/.agent-device/daemon.lock` +## iOS: "Allow Paste" dialog + +iOS 16+ shows an "Allow Paste" prompt when an app reads the system pasteboard. Under XCUITest (which `agent-device` uses), this prompt is suppressed by the testing runtime. Use `xcrun simctl pbcopy booted` to set clipboard content directly on the simulator instead. + ## Simulator troubleshooting - If snapshots return 0 nodes, restart Simulator and re-open the app. diff --git a/website/docs/docs/_meta.json b/website/docs/docs/_meta.json index b34ec64e7..a9306d30d 100644 --- a/website/docs/docs/_meta.json +++ b/website/docs/docs/_meta.json @@ -43,5 +43,10 @@ "name": "snapshots", "type": "file", "label": "Snapshots" + }, + { + "name": "known-limitations", + "type": "file", + "label": "Known Limitations" } ] diff --git a/website/docs/docs/known-limitations.md b/website/docs/docs/known-limitations.md new file mode 100644 index 000000000..f20c5d1e2 --- /dev/null +++ b/website/docs/docs/known-limitations.md @@ -0,0 +1,21 @@ +--- +title: Known Limitations +--- + +# Known Limitations + +Platform constraints that affect automation behavior. + +## iOS: "Allow Paste" dialog suppressed under XCUITest + +iOS 16+ shows an "Allow Paste" system prompt when an app reads `UIPasteboard.general` in the foreground. When an app is launched or activated through the XCUITest runner (which `agent-device` uses for iOS), the iOS runtime detects the testing context and silently grants pasteboard access — the prompt never appears. + +This is an Apple platform constraint that affects all XCUITest-based automation tools. + +**Workarounds:** + +- **Pre-fill the pasteboard via simctl** — set clipboard content without triggering the dialog: + ```bash + echo "some text" | xcrun simctl pbcopy booted + ``` +- **Test the dialog manually** — the "Allow Paste" UX cannot be exercised through XCUITest-based automation.