agent-device 0.11.16 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/README.md +2 -2
  2. package/dist/src/155.js +34 -34
  3. package/dist/src/818.js +1 -1
  4. package/dist/src/974.js +2 -2
  5. package/dist/src/artifacts.js +1 -1
  6. package/dist/src/bin.js +30 -31
  7. package/dist/src/daemon.js +15 -15
  8. package/dist/src/finders.d.ts +6 -2
  9. package/dist/src/finders.js +1 -1
  10. package/dist/src/index.d.ts +9 -168
  11. package/dist/src/index.js +2 -2
  12. package/dist/src/install-source.js +1 -1
  13. package/dist/src/selectors.d.ts +1 -1
  14. package/package.json +1 -1
  15. package/skills/agent-device/SKILL.md +1 -1
  16. package/skills/agent-device/references/exploration.md +19 -5
  17. package/skills/agent-device/references/macos-desktop.md +1 -0
package/README.md CHANGED
@@ -52,7 +52,7 @@ In practice, most work follows the same pattern:
52
52
  1. Discover the exact app id with `apps` if the package or bundle name is uncertain.
53
53
  2. `open` a target app or URL.
54
54
  3. `snapshot -i` to inspect the current screen.
55
- 4. `press`, `fill`, `scroll`, `get`, or `wait` using refs or selectors. On iOS and Android, default snapshot text follows the same visible-first contract: refs shown in default output are actionable now, while hidden content is surfaced as scroll/list discovery hints instead of tappable off-screen refs.
55
+ 4. `press`, `fill`, `scroll`, `get`, or `wait` using refs or selectors. On iOS and Android, default snapshot text follows the same visible-first contract: refs shown in default output are actionable now, while hidden content is surfaced as scroll/list discovery hints instead of tappable off-screen refs. If the target only appears in a hidden-content hint, use `scroll <direction>` and re-snapshot.
56
56
  Use `rotate <orientation>` when a flow needs a deterministic portrait or landscape state on mobile targets.
57
57
  5. `diff snapshot` or re-snapshot after UI changes.
58
58
  6. `close` when the session is finished.
@@ -82,7 +82,7 @@ npm install -g agent-device
82
82
 
83
83
  Set `AGENT_DEVICE_NO_UPDATE_NOTIFIER=1` to disable the notice.
84
84
 
85
- On macOS, `agent-device` includes a local `agent-device-macos-helper` source package that is built on demand for desktop permission checks, alert handling, and helper-backed desktop snapshot surfaces. Release distribution should use a signed/notarized helper build; source checkouts fall back to a local Swift build.
85
+ On macOS, `agent-device` includes a local `agent-device-macos-helper` source package that is built on demand for desktop permission checks, alert handling, and helper-backed desktop snapshot surfaces. Release distribution should use a signed/notarized helper build; source checkouts fall back to a local Swift build. Local helper overrides through `AGENT_DEVICE_MACOS_HELPER_BIN` must use an absolute executable path.
86
86
 
87
87
  ## Contributing
88
88