Add coordinate click and file upload actions

[jinxjinxagain]

Summary

Adds two browser interaction capabilities to the HTTP API:

• coordinate-based click support for POST /tabs/:tabId/click
• file upload support through a new POST /tabs/:tabId/upload endpoint

Details

Coordinate click

POST /tabs/:tabId/click now accepts a coordinates object in addition to the existing ref and selector inputs:

{
  "userId": "user-1",
  "coordinates": { "x": 320, "y": 240 }
}

The server validates the coordinate values and dispatches a mouse move/down/up sequence at the requested point. Existing ref and selector click behavior is preserved.

File upload

Adds POST /tabs/:tabId/upload for setting local files on a file input or triggering a file chooser. The endpoint supports:

• filePath for a single local file
• files for multiple local files
• ref, selector, or coordinates to target the file input / upload control

Example:

{
  "userId": "user-1",
  "filePath": "/tmp/avatar.png",
  "selector": "input[type=file]"
}

If the target element is an input[type=file], the endpoint uses setInputFiles. Otherwise it waits for a file chooser after clicking the target and then sets the selected files.

API docs

The new upload endpoint is documented in the generated OpenAPI spec.

Validation

• npm test -- --runTestsByPath tests/unit/openapi.test.js