airbrowser-client 1.13.1 → 1.14.0

package/dist/esm/api.js

@@ -46,6 +46,16 @@ export const CookiesRequestActionEnum = {
     Delete: 'delete',
     Clear: 'clear',
 };
+export const DetectCoordinatesRequestHitTestEnum = {
+    Off: 'off',
+    Warn: 'warn',
+    Strict: 'strict',
+};
+export const DetectCoordinatesRequestAutoSnapEnum = {
+    Off: 'off',
+    NearestClickable: 'nearest_clickable',
+    NearestInteractive: 'nearest_interactive',
+};
 export const DialogRequestActionEnum = {
     Get: 'get',
     Accept: 'accept',
@@ -56,6 +66,40 @@ export const EmulateRequestActionEnum = {
     Clear: 'clear',
     ListDevices: 'list_devices',
 };
+export const GuiClickRequestPreClickValidateEnum = {
+    Off: 'off',
+    Warn: 'warn',
+    Strict: 'strict',
+};
+export const GuiClickRequestAutoSnapEnum = {
+    Off: 'off',
+    NearestClickable: 'nearest_clickable',
+    NearestInteractive: 'nearest_interactive',
+};
+export const GuiClickRequestPostClickFeedbackEnum = {
+    None: 'none',
+    Url: 'url',
+    Content: 'content',
+    Visible: 'visible',
+    Auto: 'auto',
+};
+export const GuiClickXYRequestPreClickValidateEnum = {
+    Off: 'off',
+    Warn: 'warn',
+    Strict: 'strict',
+};
+export const GuiClickXYRequestAutoSnapEnum = {
+    Off: 'off',
+    NearestClickable: 'nearest_clickable',
+    NearestInteractive: 'nearest_interactive',
+};
+export const GuiClickXYRequestPostClickFeedbackEnum = {
+    None: 'none',
+    Url: 'url',
+    Content: 'content',
+    Visible: 'visible',
+    Auto: 'auto',
+};
 export const HistoryRequestActionEnum = {
     Back: 'back',
     Forward: 'forward',
@@ -341,8 +385,8 @@ export const BrowserApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).
-         * @summary Detect element coordinates using vision
+         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).     model: Optional vision model override for this request.     stream: Optional vision streaming override for this request.     hit_test: Detect-time validation mode: off, warn, or strict.         Recommended for agents: `strict`.     auto_snap: Auto-snap mode: off, nearest_clickable, or nearest_interactive.         Recommended for agents: `nearest_clickable`.     snap_radius: Maximum snap radius in CSS pixels.     include_debug: Include detect debug diagnostics when available.
+         * @summary Detect element coordinates using vision with optional smart targeting
          * @param {string} browserId
          * @param {DetectCoordinatesRequest} payload
          * @param {*} [options] Override http request option.
@@ -691,8 +735,8 @@ export const BrowserApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         *
-         * @summary GUI click by selector or coordinates
+         * Selector mode uses `selector` with optional `fx` / `fy` offsets. Coordinate mode uses `x` / `y` and supports smart targeting knobs such as `pre_click_validate`, `auto_snap`, and `post_click_feedback`.  Recommended agent mode: - `pre_click_validate=\"strict\"` - `auto_snap=\"nearest_clickable\"` - `post_click_feedback=\"auto\"`  MCP keeps `gui_click_xy` as a compatibility alias for coordinate-mode `gui_click`.
+         * @summary GUI click by selector or coordinates with smart validation
          * @param {string} browserId
          * @param {GuiClickRequest} payload
          * @param {*} [options] Override http request option.
@@ -725,6 +769,41 @@ export const BrowserApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * This mirrors coordinate-mode `gui_click`, accepts the same smart-click options, and returns the same response contract.
+         * @summary MCP compatibility alias for coordinate-mode `gui_click`
+         * @param {string} browserId
+         * @param {GuiClickXYRequest} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        guiClickXy: (browserId_1, payload_1, ...args_1) => __awaiter(this, [browserId_1, payload_1, ...args_1], void 0, function* (browserId, payload, options = {}) {
+            // verify required parameter 'browserId' is not null or undefined
+            assertParamExists('guiClickXy', 'browserId', browserId);
+            // verify required parameter 'payload' is not null or undefined
+            assertParamExists('guiClickXy', 'payload', payload);
+            const localVarPath = `/browser/{browser_id}/gui_click_xy`
+                .replace(`{${"browser_id"}}`, encodeURIComponent(String(browserId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(payload, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          *
          * @summary GUI hover at coordinates
@@ -1359,12 +1438,15 @@ export const BrowserApiAxiosParamCreator = function (configuration) {
          *
          * @summary AI page analysis - what\'s visible
          * @param {string} browserId
+         * @param {WhatIsVisibleRequest} payload
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        whatIsVisible: (browserId_1, ...args_1) => __awaiter(this, [browserId_1, ...args_1], void 0, function* (browserId, options = {}) {
+        whatIsVisible: (browserId_1, payload_1, ...args_1) => __awaiter(this, [browserId_1, payload_1, ...args_1], void 0, function* (browserId, payload, options = {}) {
             // verify required parameter 'browserId' is not null or undefined
             assertParamExists('whatIsVisible', 'browserId', browserId);
+            // verify required parameter 'payload' is not null or undefined
+            assertParamExists('whatIsVisible', 'payload', payload);
             const localVarPath = `/browser/{browser_id}/what_is_visible`
                 .replace(`{${"browser_id"}}`, encodeURIComponent(String(browserId)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
@@ -1376,10 +1458,12 @@ export const BrowserApiAxiosParamCreator = function (configuration) {
             const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
             const localVarHeaderParameter = {};
             const localVarQueryParameter = {};
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(payload, localVarRequestOptions, configuration);
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -1512,8 +1596,8 @@ export const BrowserApiFp = function (configuration) {
             });
         },
         /**
-         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).
-         * @summary Detect element coordinates using vision
+         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).     model: Optional vision model override for this request.     stream: Optional vision streaming override for this request.     hit_test: Detect-time validation mode: off, warn, or strict.         Recommended for agents: `strict`.     auto_snap: Auto-snap mode: off, nearest_clickable, or nearest_interactive.         Recommended for agents: `nearest_clickable`.     snap_radius: Maximum snap radius in CSS pixels.     include_debug: Include detect debug diagnostics when available.
+         * @summary Detect element coordinates using vision with optional smart targeting
          * @param {string} browserId
          * @param {DetectCoordinatesRequest} payload
          * @param {*} [options] Override http request option.
@@ -1682,8 +1766,8 @@ export const BrowserApiFp = function (configuration) {
             });
         },
         /**
-         *
-         * @summary GUI click by selector or coordinates
+         * Selector mode uses `selector` with optional `fx` / `fy` offsets. Coordinate mode uses `x` / `y` and supports smart targeting knobs such as `pre_click_validate`, `auto_snap`, and `post_click_feedback`.  Recommended agent mode: - `pre_click_validate=\"strict\"` - `auto_snap=\"nearest_clickable\"` - `post_click_feedback=\"auto\"`  MCP keeps `gui_click_xy` as a compatibility alias for coordinate-mode `gui_click`.
+         * @summary GUI click by selector or coordinates with smart validation
          * @param {string} browserId
          * @param {GuiClickRequest} payload
          * @param {*} [options] Override http request option.
@@ -1698,6 +1782,23 @@ export const BrowserApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * This mirrors coordinate-mode `gui_click`, accepts the same smart-click options, and returns the same response contract.
+         * @summary MCP compatibility alias for coordinate-mode `gui_click`
+         * @param {string} browserId
+         * @param {GuiClickXYRequest} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        guiClickXy(browserId, payload, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.guiClickXy(browserId, payload, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['BrowserApi.guiClickXy']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          *
          * @summary GUI hover at coordinates
@@ -2008,13 +2109,14 @@ export const BrowserApiFp = function (configuration) {
          *
          * @summary AI page analysis - what\'s visible
          * @param {string} browserId
+         * @param {WhatIsVisibleRequest} payload
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        whatIsVisible(browserId, options) {
+        whatIsVisible(browserId, payload, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.whatIsVisible(browserId, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.whatIsVisible(browserId, payload, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['BrowserApi.whatIsVisible']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -2105,8 +2207,8 @@ export const BrowserApiFactory = function (configuration, basePath, axios) {
             return localVarFp.createBrowser(payload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).
-         * @summary Detect element coordinates using vision
+         * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).     model: Optional vision model override for this request.     stream: Optional vision streaming override for this request.     hit_test: Detect-time validation mode: off, warn, or strict.         Recommended for agents: `strict`.     auto_snap: Auto-snap mode: off, nearest_clickable, or nearest_interactive.         Recommended for agents: `nearest_clickable`.     snap_radius: Maximum snap radius in CSS pixels.     include_debug: Include detect debug diagnostics when available.
+         * @summary Detect element coordinates using vision with optional smart targeting
          * @param {string} browserId
          * @param {DetectCoordinatesRequest} payload
          * @param {*} [options] Override http request option.
@@ -2215,8 +2317,8 @@ export const BrowserApiFactory = function (configuration, basePath, axios) {
             return localVarFp.getUrl(browserId, options).then((request) => request(axios, basePath));
         },
         /**
-         *
-         * @summary GUI click by selector or coordinates
+         * Selector mode uses `selector` with optional `fx` / `fy` offsets. Coordinate mode uses `x` / `y` and supports smart targeting knobs such as `pre_click_validate`, `auto_snap`, and `post_click_feedback`.  Recommended agent mode: - `pre_click_validate=\"strict\"` - `auto_snap=\"nearest_clickable\"` - `post_click_feedback=\"auto\"`  MCP keeps `gui_click_xy` as a compatibility alias for coordinate-mode `gui_click`.
+         * @summary GUI click by selector or coordinates with smart validation
          * @param {string} browserId
          * @param {GuiClickRequest} payload
          * @param {*} [options] Override http request option.
@@ -2225,6 +2327,17 @@ export const BrowserApiFactory = function (configuration, basePath, axios) {
         guiClick(browserId, payload, options) {
             return localVarFp.guiClick(browserId, payload, options).then((request) => request(axios, basePath));
         },
+        /**
+         * This mirrors coordinate-mode `gui_click`, accepts the same smart-click options, and returns the same response contract.
+         * @summary MCP compatibility alias for coordinate-mode `gui_click`
+         * @param {string} browserId
+         * @param {GuiClickXYRequest} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        guiClickXy(browserId, payload, options) {
+            return localVarFp.guiClickXy(browserId, payload, options).then((request) => request(axios, basePath));
+        },
         /**
          *
          * @summary GUI hover at coordinates
@@ -2427,11 +2540,12 @@ export const BrowserApiFactory = function (configuration, basePath, axios) {
          *
          * @summary AI page analysis - what\'s visible
          * @param {string} browserId
+         * @param {WhatIsVisibleRequest} payload
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        whatIsVisible(browserId, options) {
-            return localVarFp.whatIsVisible(browserId, options).then((request) => request(axios, basePath));
+        whatIsVisible(browserId, payload, options) {
+            return localVarFp.whatIsVisible(browserId, payload, options).then((request) => request(axios, basePath));
         },
     };
 };
@@ -2516,8 +2630,8 @@ export class BrowserApi extends BaseAPI {
         return BrowserApiFp(this.configuration).createBrowser(payload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).
-     * @summary Detect element coordinates using vision
+     * Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).     model: Optional vision model override for this request.     stream: Optional vision streaming override for this request.     hit_test: Detect-time validation mode: off, warn, or strict.         Recommended for agents: `strict`.     auto_snap: Auto-snap mode: off, nearest_clickable, or nearest_interactive.         Recommended for agents: `nearest_clickable`.     snap_radius: Maximum snap radius in CSS pixels.     include_debug: Include detect debug diagnostics when available.
+     * @summary Detect element coordinates using vision with optional smart targeting
      * @param {string} browserId
      * @param {DetectCoordinatesRequest} payload
      * @param {*} [options] Override http request option.
@@ -2626,8 +2740,8 @@ export class BrowserApi extends BaseAPI {
         return BrowserApiFp(this.configuration).getUrl(browserId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     *
-     * @summary GUI click by selector or coordinates
+     * Selector mode uses `selector` with optional `fx` / `fy` offsets. Coordinate mode uses `x` / `y` and supports smart targeting knobs such as `pre_click_validate`, `auto_snap`, and `post_click_feedback`.  Recommended agent mode: - `pre_click_validate=\"strict\"` - `auto_snap=\"nearest_clickable\"` - `post_click_feedback=\"auto\"`  MCP keeps `gui_click_xy` as a compatibility alias for coordinate-mode `gui_click`.
+     * @summary GUI click by selector or coordinates with smart validation
      * @param {string} browserId
      * @param {GuiClickRequest} payload
      * @param {*} [options] Override http request option.
@@ -2636,6 +2750,17 @@ export class BrowserApi extends BaseAPI {
     guiClick(browserId, payload, options) {
         return BrowserApiFp(this.configuration).guiClick(browserId, payload, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * This mirrors coordinate-mode `gui_click`, accepts the same smart-click options, and returns the same response contract.
+     * @summary MCP compatibility alias for coordinate-mode `gui_click`
+     * @param {string} browserId
+     * @param {GuiClickXYRequest} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    guiClickXy(browserId, payload, options) {
+        return BrowserApiFp(this.configuration).guiClickXy(browserId, payload, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      *
      * @summary GUI hover at coordinates
@@ -2838,11 +2963,12 @@ export class BrowserApi extends BaseAPI {
      *
      * @summary AI page analysis - what\'s visible
      * @param {string} browserId
+     * @param {WhatIsVisibleRequest} payload
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    whatIsVisible(browserId, options) {
-        return BrowserApiFp(this.configuration).whatIsVisible(browserId, options).then((request) => request(this.axios, this.basePath));
+    whatIsVisible(browserId, payload, options) {
+        return BrowserApiFp(this.configuration).whatIsVisible(browserId, payload, options).then((request) => request(this.axios, this.basePath));
     }
 }
 /**

package/docs/BrowserApi.md

@@ -11,7 +11,7 @@ All URIs are relative to */api/v1*
 |[**consoleLogs**](#consolelogs) | **POST** /browser/{browser_id}/console_logs | Console logs: get or clear|
 |[**cookies**](#cookies) | **POST** /browser/{browser_id}/cookies | Manage browser cookies|
 |[**createBrowser**](#createbrowser) | **POST** /browser/create_browser | Create browser instance with optional persistent profile|
-|[**detectCoordinates**](#detectcoordinates) | **POST** /browser/{browser_id}/detect_coordinates | Detect element coordinates using vision|
+|[**detectCoordinates**](#detectcoordinates) | **POST** /browser/{browser_id}/detect_coordinates | Detect element coordinates using vision with optional smart targeting|
 |[**dialog**](#dialog) | **POST** /browser/{browser_id}/dialog | Dialogs: get, accept, dismiss|
 |[**emulate**](#emulate) | **POST** /browser/{browser_id}/emulate | Emulation: set, clear, list_devices|
 |[**executeCdp**](#executecdp) | **POST** /browser/{browser_id}/execute_cdp | Execute a Chrome DevTools Protocol command|
@@ -21,7 +21,8 @@ All URIs are relative to */api/v1*
 |[**getContent**](#getcontent) | **GET** /browser/{browser_id}/get_content | Get page HTML|
 |[**getElementData**](#getelementdata) | **GET** /browser/{browser_id}/get_element_data | Get element text, attribute, or property|
 |[**getUrl**](#geturl) | **GET** /browser/{browser_id}/get_url | Get current URL|
-|[**guiClick**](#guiclick) | **POST** /browser/{browser_id}/gui_click | GUI click by selector or coordinates|
+|[**guiClick**](#guiclick) | **POST** /browser/{browser_id}/gui_click | GUI click by selector or coordinates with smart validation|
+|[**guiClickXy**](#guiclickxy) | **POST** /browser/{browser_id}/gui_click_xy | MCP compatibility alias for coordinate-mode `gui_click`|
 |[**guiHoverXy**](#guihoverxy) | **POST** /browser/{browser_id}/gui_hover_xy | GUI hover at coordinates|
 |[**guiPressKeysXy**](#guipresskeysxy) | **POST** /browser/{browser_id}/gui_press_keys_xy | Press keys at coordinates (click to focus, then send keys)|
 |[**guiTypeXy**](#guitypexy) | **POST** /browser/{browser_id}/gui_type_xy | GUI type at coordinates - clicks then types text|
@@ -418,9 +419,9 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **detectCoordinates**
-> GenericResponse detectCoordinates(payload)
+> DetectCoordinatesResult detectCoordinates(payload)
 
-Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).
+Args:     browser_id: Browser instance identifier     prompt: Natural language description of element to find     fx: Fractional x offset for click point (0.0=left, 0.5=center, 1.0=right).         If None, auto-bias is applied for wide elements (0.25 for aspect ratio > 10).     fy: Fractional y offset for click point (0.0=top, 0.5=center, 1.0=bottom).     model: Optional vision model override for this request.     stream: Optional vision streaming override for this request.     hit_test: Detect-time validation mode: off, warn, or strict.         Recommended for agents: `strict`.     auto_snap: Auto-snap mode: off, nearest_clickable, or nearest_interactive.         Recommended for agents: `nearest_clickable`.     snap_radius: Maximum snap radius in CSS pixels.     include_debug: Include detect debug diagnostics when available.
 
 ### Example
 
@@ -453,7 +454,7 @@ const { status, data } = await apiInstance.detectCoordinates(
 
 ### Return type
 
-**GenericResponse**
+**DetectCoordinatesResult**
 
 ### Authorization
 
@@ -957,8 +958,9 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **guiClick**
-> GenericResponse guiClick(payload)
+> GuiClickResult guiClick(payload)
 
+Selector mode uses `selector` with optional `fx` / `fy` offsets. Coordinate mode uses `x` / `y` and supports smart targeting knobs such as `pre_click_validate`, `auto_snap`, and `post_click_feedback`.  Recommended agent mode: - `pre_click_validate=\"strict\"` - `auto_snap=\"nearest_clickable\"` - `post_click_feedback=\"auto\"`  MCP keeps `gui_click_xy` as a compatibility alias for coordinate-mode `gui_click`.
 
 ### Example
 
@@ -991,7 +993,62 @@ const { status, data } = await apiInstance.guiClick(
 
 ### Return type
 
-**GenericResponse**
+**GuiClickResult**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Success |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **guiClickXy**
+> GuiClickResult guiClickXy(payload)
+
+This mirrors coordinate-mode `gui_click`, accepts the same smart-click options, and returns the same response contract.
+
+### Example
+
+```typescript
+import {
+    BrowserApi,
+    Configuration,
+    GuiClickXYRequest
+} from 'airbrowser-client';
+
+const configuration = new Configuration();
+const apiInstance = new BrowserApi(configuration);
+
+let browserId: string; // (default to undefined)
+let payload: GuiClickXYRequest; //
+
+const { status, data } = await apiInstance.guiClickXy(
+    browserId,
+    payload
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **payload** | **GuiClickXYRequest**|  | |
+| **browserId** | [**string**] |  | defaults to undefined|
+
+
+### Return type
+
+**GuiClickResult**
 
 ### Authorization
 
@@ -1983,7 +2040,7 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **whatIsVisible**
-> GenericResponse whatIsVisible()
+> GenericResponse whatIsVisible(payload)
 
 
 ### Example
@@ -1991,16 +2048,19 @@ No authorization required
 ```typescript
 import {
     BrowserApi,
-    Configuration
+    Configuration,
+    WhatIsVisibleRequest
 } from 'airbrowser-client';
 
 const configuration = new Configuration();
 const apiInstance = new BrowserApi(configuration);
 
 let browserId: string; // (default to undefined)
+let payload: WhatIsVisibleRequest; //
 
 const { status, data } = await apiInstance.whatIsVisible(
-    browserId
+    browserId,
+    payload
 );
 ```
 
@@ -2008,6 +2068,7 @@ const { status, data } = await apiInstance.whatIsVisible(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
+| **payload** | **WhatIsVisibleRequest**|  | |
 | **browserId** | [**string**] |  | defaults to undefined|
 
 
@@ -2021,7 +2082,7 @@ No authorization required
 
 ### HTTP request headers
 
- - **Content-Type**: Not defined
+ - **Content-Type**: application/json
  - **Accept**: application/json
 
 
@@ -2031,4 +2092,3 @@ No authorization required
 |**200** | Success |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-

package/docs/DetectCoordinatesData.md

@@ -0,0 +1,48 @@
+# DetectCoordinatesData
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**prompt** | **string** | Element description used | [optional] [default to undefined]
+**bounding_box** | **object** | Element bounding box {x, y, width, height} | [optional] [default to undefined]
+**click_point** | **object** | Recommended click point {x, y} | [optional] [default to undefined]
+**confidence** | **number** | Detection confidence (0.0-1.0) | [optional] [default to undefined]
+**outcome_status** | **string** | Machine-readable detect outcome status | [optional] [default to undefined]
+**reason** | **string** | Machine-readable detect reason code | [optional] [default to undefined]
+**reason_detail** | **string** | Human-readable reason detail | [optional] [default to undefined]
+**resolved_target** | **object** | Resolved target details after validation or snapping | [optional] [default to undefined]
+**resolved_click_point** | **object** | Validated or snapped click point {x, y} | [optional] [default to undefined]
+**snap_result** | **object** | Details about any snap candidate that was applied | [optional] [default to undefined]
+**recommended_next_action** | **string** | Suggested next action for callers | [optional] [default to undefined]
+**screenshot_url** | **string** | URL to the screenshot | [optional] [default to undefined]
+**image_size** | **object** | Original screenshot dimensions | [optional] [default to undefined]
+**transform_info** | **object** | Coordinate transform metadata | [optional] [default to undefined]
+**debug** | **object** | Optional smart-targeting debug details | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { DetectCoordinatesData } from 'airbrowser-client';
+
+const instance: DetectCoordinatesData = {
+    prompt,
+    bounding_box,
+    click_point,
+    confidence,
+    outcome_status,
+    reason,
+    reason_detail,
+    resolved_target,
+    resolved_click_point,
+    snap_result,
+    recommended_next_action,
+    screenshot_url,
+    image_size,
+    transform_info,
+    debug,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/DetectCoordinatesRequest.md

@@ -5,9 +5,15 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**prompt** | **string** | prompt | [default to undefined]
-**fx** | **number** | fx | [optional] [default to undefined]
-**fy** | **number** | fy | [optional] [default to undefined]
+**prompt** | **string** | Natural language description of element to find | [default to undefined]
+**fx** | **number** | Relative X (0..1) within the detected element | [optional] [default to undefined]
+**fy** | **number** | Relative Y (0..1) within the detected element | [optional] [default to undefined]
+**model** | **string** | Optional vision model override for this request | [optional] [default to undefined]
+**stream** | **boolean** | Optional vision streaming override for this request | [optional] [default to undefined]
+**hit_test** | **string** | Detect-time validation mode | [optional] [default to HitTestEnum_Off]
+**auto_snap** | **string** | Auto-snap mode for nearby targets | [optional] [default to AutoSnapEnum_Off]
+**snap_radius** | **number** | Maximum snap radius in CSS pixels | [optional] [default to undefined]
+**include_debug** | **boolean** | Include smart-targeting debug details | [optional] [default to false]
 
 ## Example
 
@@ -18,6 +24,12 @@ const instance: DetectCoordinatesRequest = {
     prompt,
     fx,
     fy,
+    model,
+    stream,
+    hit_test,
+    auto_snap,
+    snap_radius,
+    include_debug,
 };
 ```
 

package/docs/DetectCoordinatesResult.md

@@ -0,0 +1,24 @@
+# DetectCoordinatesResult
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**success** | **boolean** | Operation success | [optional] [default to undefined]
+**message** | **string** | Success message | [optional] [default to undefined]
+**data** | [**DetectCoordinatesData**](DetectCoordinatesData.md) | Detect response payload | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { DetectCoordinatesResult } from 'airbrowser-client';
+
+const instance: DetectCoordinatesResult = {
+    success,
+    message,
+    data,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/GuiClickData.md

@@ -0,0 +1,44 @@
+# GuiClickData
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | **string** | Legacy inner status | [optional] [default to undefined]
+**success** | **boolean** | Legacy inner success flag | [optional] [default to undefined]
+**message** | **string** | Legacy inner message | [optional] [default to undefined]
+**x** | **number** | Requested or resolved screen X coordinate | [optional] [default to undefined]
+**y** | **number** | Requested or resolved screen Y coordinate | [optional] [default to undefined]
+**outcome_status** | **string** | Machine-readable click outcome status | [optional] [default to undefined]
+**reason** | **string** | Machine-readable click reason code | [optional] [default to undefined]
+**reason_detail** | **string** | Human-readable reason detail | [optional] [default to undefined]
+**precheck** | **object** | Pre-click validation details | [optional] [default to undefined]
+**execution** | **object** | Click execution details | [optional] [default to undefined]
+**postcheck** | **object** | Post-click feedback details | [optional] [default to undefined]
+**recommended_next_action** | **string** | Suggested next action for callers | [optional] [default to undefined]
+**debug** | **object** | Optional smart-click debug details | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { GuiClickData } from 'airbrowser-client';
+
+const instance: GuiClickData = {
+    status,
+    success,
+    message,
+    x,
+    y,
+    outcome_status,
+    reason,
+    reason_detail,
+    precheck,
+    execution,
+    postcheck,
+    recommended_next_action,
+    debug,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)