pointer_drag
Drag from one point to another with real intermediate motion, avoiding press-and-teleport. Specify start and end coordinates and optionally dwell before release for reliable drops.
Instructions
Press at one point, travel, release at another. The travel is real intermediate motion, because a press-and-teleport is not a drag to most toolkits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| look | No | What to show you afterwards. Default "auto": wait for the screen to stop changing, measure how much this action changed, and attach a picture of the affected window only if something did change -- so a click that hit nothing costs no tokens and says so. "window" always attaches it, "screen" uses the whole desktop (slower, 6x the tokens), "region" uses look_at, false skips all of it. Use false for the middle of a sequence you are going to check at the end anyway. | auto |
| to_x | Yes | ||
| to_y | Yes | ||
| steps | No | ||
| button | No | left | |
| from_x | Yes | ||
| from_y | Yes | ||
| look_at | No | Rectangle for look:"region", in screen pixels. Object form {x, y, width, height} or array form [x, y, width, height]. | |
| dwell_ms | No | Hover at the destination this long before releasing. Default 0 is the timing measured at 5/5 on a real drop target; a slower variant scored 4/5, so this is NOT a better default. Try ~400 only after a cross-app drop has actually failed (GTK source, Electron target). | |
| settle_max_s | No | How long to wait for the screen to stop changing before looking. Raise it for an app that animates slowly; set it to 0 to capture immediately. | |
| expect_window | No |