validate_spatial_coordinate
Validate that a target coordinate is not blocked by overlays, modals, or layout shifts before executing a click or hover action.
Instructions
PRE-EXECUTION SAFETY NET. Before clicking or hovering on a coordinate, call this tool to verify that the intended target is actually at those coordinates and is not occluded by an overlay, modal, cookie banner, or layout shift.
Returns: • valid=true → Safe to proceed with click/hover. • valid=false, occluded=true → Another element is blocking the target. The occluder CSS selector is returned so the agent can dismiss it or find an alternative path. • valid=false, occluded=false → Target element is invisible, zero-sized, or out of viewport.
NOTE: atomic_interact already runs spatial validation internally. Use this tool only for explicit pre-flight checks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | X coordinate to validate | |
| y | Yes | Y coordinate to validate | |
| targetBackendNodeId | No | Expected backendNodeId at this coordinate. If omitted, only bounds checking is performed. |