airbrowser-client 1.13.1 → 1.14.0

package/base.ts

@@ -5,7 +5,7 @@
  * Undetectable Chrome-in-Docker for developers and agents (REST + MCP)
  *
  * The version of the OpenAPI document: 1.0
- * 
+ *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/common.ts

@@ -5,7 +5,7 @@
  * Undetectable Chrome-in-Docker for developers and agents (REST + MCP)
  *
  * The version of the OpenAPI document: 1.0
- * 
+ *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/configuration.ts

@@ -4,7 +4,7 @@
  * Undetectable Chrome-in-Docker for developers and agents (REST + MCP)
  *
  * The version of the OpenAPI document: 1.0
- * 
+ *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api.d.ts

@@ -154,19 +154,131 @@ export interface CreateProfileRequest {
      */
     'name': string;
 }
+export interface DetectCoordinatesData {
+    /**
+     * Element description used
+     */
+    'prompt'?: string;
+    /**
+     * Element bounding box {x, y, width, height}
+     */
+    'bounding_box'?: object;
+    /**
+     * Recommended click point {x, y}
+     */
+    'click_point'?: object;
+    /**
+     * Detection confidence (0.0-1.0)
+     */
+    'confidence'?: number;
+    /**
+     * Machine-readable detect outcome status
+     */
+    'outcome_status'?: string;
+    /**
+     * Machine-readable detect reason code
+     */
+    'reason'?: string;
+    /**
+     * Human-readable reason detail
+     */
+    'reason_detail'?: string;
+    /**
+     * Resolved target details after validation or snapping
+     */
+    'resolved_target'?: object;
+    /**
+     * Validated or snapped click point {x, y}
+     */
+    'resolved_click_point'?: object;
+    /**
+     * Details about any snap candidate that was applied
+     */
+    'snap_result'?: object;
+    /**
+     * Suggested next action for callers
+     */
+    'recommended_next_action'?: string;
+    /**
+     * URL to the screenshot
+     */
+    'screenshot_url'?: string;
+    /**
+     * Original screenshot dimensions
+     */
+    'image_size'?: object;
+    /**
+     * Coordinate transform metadata
+     */
+    'transform_info'?: object;
+    /**
+     * Optional smart-targeting debug details
+     */
+    'debug'?: object;
+}
 export interface DetectCoordinatesRequest {
     /**
-     * prompt
+     * Natural language description of element to find
      */
     'prompt': string;
     /**
-     * fx
+     * Relative X (0..1) within the detected element
      */
     'fx'?: number;
     /**
-     * fy
+     * Relative Y (0..1) within the detected element
      */
     'fy'?: number;
+    /**
+     * Optional vision model override for this request
+     */
+    'model'?: string;
+    /**
+     * Optional vision streaming override for this request
+     */
+    'stream'?: boolean;
+    /**
+     * Detect-time validation mode
+     */
+    'hit_test'?: DetectCoordinatesRequestHitTestEnum;
+    /**
+     * Auto-snap mode for nearby targets
+     */
+    'auto_snap'?: DetectCoordinatesRequestAutoSnapEnum;
+    /**
+     * Maximum snap radius in CSS pixels
+     */
+    'snap_radius'?: number;
+    /**
+     * Include smart-targeting debug details
+     */
+    'include_debug'?: boolean;
+}
+export declare const DetectCoordinatesRequestHitTestEnum: {
+    readonly Off: "off";
+    readonly Warn: "warn";
+    readonly Strict: "strict";
+};
+export type DetectCoordinatesRequestHitTestEnum = typeof DetectCoordinatesRequestHitTestEnum[keyof typeof DetectCoordinatesRequestHitTestEnum];
+export declare const DetectCoordinatesRequestAutoSnapEnum: {
+    readonly Off: "off";
+    readonly NearestClickable: "nearest_clickable";
+    readonly NearestInteractive: "nearest_interactive";
+};
+export type DetectCoordinatesRequestAutoSnapEnum = typeof DetectCoordinatesRequestAutoSnapEnum[keyof typeof DetectCoordinatesRequestAutoSnapEnum];
+export interface DetectCoordinatesResult {
+    /**
+     * Operation success
+     */
+    'success'?: boolean;
+    /**
+     * Success message
+     */
+    'message'?: string;
+    /**
+     * Detect response payload
+     */
+    'data'?: DetectCoordinatesData;
 }
 export interface DialogRequest {
     /**
@@ -274,32 +386,218 @@ export interface GenericResponse {
      */
     'data'?: object;
 }
+export interface GuiClickData {
+    /**
+     * Legacy inner status
+     */
+    'status'?: string;
+    /**
+     * Legacy inner success flag
+     */
+    'success'?: boolean;
+    /**
+     * Legacy inner message
+     */
+    'message'?: string;
+    /**
+     * Requested or resolved screen X coordinate
+     */
+    'x'?: number;
+    /**
+     * Requested or resolved screen Y coordinate
+     */
+    'y'?: number;
+    /**
+     * Machine-readable click outcome status
+     */
+    'outcome_status'?: string;
+    /**
+     * Machine-readable click reason code
+     */
+    'reason'?: string;
+    /**
+     * Human-readable reason detail
+     */
+    'reason_detail'?: string;
+    /**
+     * Pre-click validation details
+     */
+    'precheck'?: object;
+    /**
+     * Click execution details
+     */
+    'execution'?: object;
+    /**
+     * Post-click feedback details
+     */
+    'postcheck'?: object;
+    /**
+     * Suggested next action for callers
+     */
+    'recommended_next_action'?: string;
+    /**
+     * Optional smart-click debug details
+     */
+    'debug'?: object;
+}
 export interface GuiClickRequest {
     /**
-     * selector
+     * Element selector (CSS or XPath)
      */
     'selector'?: string;
     /**
-     * x
+     * Screen X coordinate (coordinate mode)
      */
     'x'?: number;
     /**
-     * y
+     * Screen Y coordinate (coordinate mode)
      */
     'y'?: number;
     /**
-     * timeframe
+     * Mouse move duration (seconds)
      */
     'timeframe'?: number;
     /**
-     * fx
+     * Relative X (0..1) within element to click
      */
     'fx'?: number;
     /**
-     * fy
+     * Relative Y (0..1) within element to click
      */
     'fy'?: number;
+    /**
+     * Pre-click validation mode
+     */
+    'pre_click_validate'?: GuiClickRequestPreClickValidateEnum;
+    /**
+     * Auto-snap mode for nearby targets
+     */
+    'auto_snap'?: GuiClickRequestAutoSnapEnum;
+    /**
+     * Maximum snap radius in CSS pixels
+     */
+    'snap_radius'?: number;
+    /**
+     * Post-click feedback mode
+     */
+    'post_click_feedback'?: GuiClickRequestPostClickFeedbackEnum;
+    /**
+     * Post-click observation timeout in milliseconds
+     */
+    'post_click_timeout_ms'?: number;
+    /**
+     * Include truncated content in post-click feedback
+     */
+    'return_content'?: boolean;
+    /**
+     * Maximum returned content length
+     */
+    'content_limit_chars'?: number;
+    /**
+     * Include smart-click debug diagnostics
+     */
+    'include_debug'?: boolean;
+}
+export declare const GuiClickRequestPreClickValidateEnum: {
+    readonly Off: "off";
+    readonly Warn: "warn";
+    readonly Strict: "strict";
+};
+export type GuiClickRequestPreClickValidateEnum = typeof GuiClickRequestPreClickValidateEnum[keyof typeof GuiClickRequestPreClickValidateEnum];
+export declare const GuiClickRequestAutoSnapEnum: {
+    readonly Off: "off";
+    readonly NearestClickable: "nearest_clickable";
+    readonly NearestInteractive: "nearest_interactive";
+};
+export type GuiClickRequestAutoSnapEnum = typeof GuiClickRequestAutoSnapEnum[keyof typeof GuiClickRequestAutoSnapEnum];
+export declare const GuiClickRequestPostClickFeedbackEnum: {
+    readonly None: "none";
+    readonly Url: "url";
+    readonly Content: "content";
+    readonly Visible: "visible";
+    readonly Auto: "auto";
+};
+export type GuiClickRequestPostClickFeedbackEnum = typeof GuiClickRequestPostClickFeedbackEnum[keyof typeof GuiClickRequestPostClickFeedbackEnum];
+export interface GuiClickResult {
+    /**
+     * Operation success
+     */
+    'success'?: boolean;
+    /**
+     * Success message
+     */
+    'message'?: string;
+    /**
+     * GUI click response payload
+     */
+    'data'?: GuiClickData;
+}
+export interface GuiClickXYRequest {
+    /**
+     * Screen X coordinate
+     */
+    'x': number;
+    /**
+     * Screen Y coordinate
+     */
+    'y': number;
+    /**
+     * Mouse move duration (seconds)
+     */
+    'timeframe'?: number;
+    /**
+     * Pre-click validation mode
+     */
+    'pre_click_validate'?: GuiClickXYRequestPreClickValidateEnum;
+    /**
+     * Auto-snap mode for nearby targets
+     */
+    'auto_snap'?: GuiClickXYRequestAutoSnapEnum;
+    /**
+     * Maximum snap radius in CSS pixels
+     */
+    'snap_radius'?: number;
+    /**
+     * Post-click feedback mode
+     */
+    'post_click_feedback'?: GuiClickXYRequestPostClickFeedbackEnum;
+    /**
+     * Post-click observation timeout in milliseconds
+     */
+    'post_click_timeout_ms'?: number;
+    /**
+     * Include truncated content in post-click feedback
+     */
+    'return_content'?: boolean;
+    /**
+     * Maximum returned content length
+     */
+    'content_limit_chars'?: number;
+    /**
+     * Include smart-click debug diagnostics
+     */
+    'include_debug'?: boolean;
 }
+export declare const GuiClickXYRequestPreClickValidateEnum: {
+    readonly Off: "off";
+    readonly Warn: "warn";
+    readonly Strict: "strict";
+};
+export type GuiClickXYRequestPreClickValidateEnum = typeof GuiClickXYRequestPreClickValidateEnum[keyof typeof GuiClickXYRequestPreClickValidateEnum];
+export declare const GuiClickXYRequestAutoSnapEnum: {
+    readonly Off: "off";
+    readonly NearestClickable: "nearest_clickable";
+    readonly NearestInteractive: "nearest_interactive";
+};
+export type GuiClickXYRequestAutoSnapEnum = typeof GuiClickXYRequestAutoSnapEnum[keyof typeof GuiClickXYRequestAutoSnapEnum];
+export declare const GuiClickXYRequestPostClickFeedbackEnum: {
+    readonly None: "none";
+    readonly Url: "url";
+    readonly Content: "content";
+    readonly Visible: "visible";
+    readonly Auto: "auto";
+};
+export type GuiClickXYRequestPostClickFeedbackEnum = typeof GuiClickXYRequestPostClickFeedbackEnum[keyof typeof GuiClickXYRequestPostClickFeedbackEnum];
 export interface GuiHoverXyRequest {
     /**
      * x
@@ -721,6 +1019,16 @@ export declare const WaitElementRequestUntilEnum: {
     readonly Hidden: "hidden";
 };
 export type WaitElementRequestUntilEnum = typeof WaitElementRequestUntilEnum[keyof typeof WaitElementRequestUntilEnum];
+export interface WhatIsVisibleRequest {
+    /**
+     * model
+     */
+    'model'?: string;
+    /**
+     * stream
+     */
+    'stream'?: boolean;
+}
 /**
  * BrowserApi - axios parameter creator
  */
@@ -788,8 +1096,8 @@ export declare const BrowserApiAxiosParamCreator: (configuration?: Configuration
      */
     createBrowser: (payload: CreateBrowserRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 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.
@@ -878,14 +1186,23 @@ export declare const BrowserApiAxiosParamCreator: (configuration?: Configuration
      */
     getUrl: (browserId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     *
-     * @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.
      * @throws {RequiredError}
      */
     guiClick: (browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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: string, payload: GuiClickXYRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      *
      * @summary GUI hover at coordinates
@@ -1052,10 +1369,11 @@ export declare const BrowserApiAxiosParamCreator: (configuration?: Configuration
      *
      * @summary AI page analysis - what\'s visible
      * @param {string} browserId
+     * @param {WhatIsVisibleRequest} payload
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    whatIsVisible: (browserId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    whatIsVisible: (browserId: string, payload: WhatIsVisibleRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * BrowserApi - functional programming interface
@@ -1124,14 +1442,14 @@ export declare const BrowserApiFp: (configuration?: Configuration) => {
      */
     createBrowser(payload: CreateBrowserRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
     /**
-     * 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.
      * @throws {RequiredError}
      */
-    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
+    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DetectCoordinatesResult>>;
     /**
      *
      * @summary Dialogs: get, accept, dismiss
@@ -1214,14 +1532,23 @@ export declare const BrowserApiFp: (configuration?: Configuration) => {
      */
     getUrl(browserId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
     /**
-     *
-     * @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.
      * @throws {RequiredError}
      */
-    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
+    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GuiClickResult>>;
+    /**
+     * 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: string, payload: GuiClickXYRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GuiClickResult>>;
     /**
      *
      * @summary GUI hover at coordinates
@@ -1388,10 +1715,11 @@ export declare const BrowserApiFp: (configuration?: Configuration) => {
      *
      * @summary AI page analysis - what\'s visible
      * @param {string} browserId
+     * @param {WhatIsVisibleRequest} payload
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    whatIsVisible(browserId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
+    whatIsVisible(browserId: string, payload: WhatIsVisibleRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GenericResponse>>;
 };
 /**
  * BrowserApi - factory interface
@@ -1460,14 +1788,14 @@ export declare const BrowserApiFactory: (configuration?: Configuration, basePath
      */
     createBrowser(payload: CreateBrowserRequest, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
     /**
-     * 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.
      * @throws {RequiredError}
      */
-    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
+    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): AxiosPromise<DetectCoordinatesResult>;
     /**
      *
      * @summary Dialogs: get, accept, dismiss
@@ -1550,14 +1878,23 @@ export declare const BrowserApiFactory: (configuration?: Configuration, basePath
      */
     getUrl(browserId: string, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
     /**
-     *
-     * @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.
      * @throws {RequiredError}
      */
-    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
+    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): AxiosPromise<GuiClickResult>;
+    /**
+     * 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: string, payload: GuiClickXYRequest, options?: RawAxiosRequestConfig): AxiosPromise<GuiClickResult>;
     /**
      *
      * @summary GUI hover at coordinates
@@ -1724,10 +2061,11 @@ export declare const BrowserApiFactory: (configuration?: Configuration, basePath
      *
      * @summary AI page analysis - what\'s visible
      * @param {string} browserId
+     * @param {WhatIsVisibleRequest} payload
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    whatIsVisible(browserId: string, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
+    whatIsVisible(browserId: string, payload: WhatIsVisibleRequest, options?: RawAxiosRequestConfig): AxiosPromise<GenericResponse>;
 };
 /**
  * BrowserApi - object-oriented interface
@@ -1796,14 +2134,14 @@ export declare class BrowserApi extends BaseAPI {
      */
     createBrowser(payload: CreateBrowserRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
     /**
-     * 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.
      * @throws {RequiredError}
      */
-    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
+    detectCoordinates(browserId: string, payload: DetectCoordinatesRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<DetectCoordinatesResult, any, {}>>;
     /**
      *
      * @summary Dialogs: get, accept, dismiss
@@ -1886,14 +2224,23 @@ export declare class BrowserApi extends BaseAPI {
      */
     getUrl(browserId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
     /**
-     *
-     * @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.
      * @throws {RequiredError}
      */
-    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
+    guiClick(browserId: string, payload: GuiClickRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GuiClickResult, any, {}>>;
+    /**
+     * 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: string, payload: GuiClickXYRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GuiClickResult, any, {}>>;
     /**
      *
      * @summary GUI hover at coordinates
@@ -2060,10 +2407,11 @@ export declare 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: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
+    whatIsVisible(browserId: string, payload: WhatIsVisibleRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GenericResponse, any, {}>>;
 }
 /**
  * HealthApi - axios parameter creator