WaveXisMCP

Run an axe-core accessibility audit on the current page (W9). Injects axe-core and returns violations, passes, incomplete, and inapplicable results. Args: input: Audit parameters (optional URL, session_id). Returns: JSON string with ``violations``, ``passes``, ``incomplete``, ``inapplicable``.

Navigate backward one step in the browser history. Use for history navigation instead of wavexis_navigate when the target is the previous page. Side effects: Changes the active page to the previous history entry; may trigger network requests if that page was not cached. Returns: JSON string with keys: 'status' ('ok'/'error').

List installed browser backends and their versions without launching a browser. Use ``wavexis_browser_version`` instead when you need the version of a specific running session's backend. Side effects: None; queries the local filesystem only. Returns: JSON string with keys: 'status' ('ok'/'error'), 'backends' (dict), 'available' (list[str]).

Block requests matching URL patterns. Args: input: Block parameters (patterns). Returns: JSON string with status ``"ok"`` and ``blocked_patterns``.

Set Bluetooth adapter state (powered on/off). Args: input: Adapter state parameters (session_id, state). Returns: JSON string with status ``"ok"`` and ``state``.

Emulate a Bluetooth device connection. Args: input: Device connect parameters (session_id, name, address). Returns: JSON string with status ``"ok"`` and device info.

Stop Bluetooth emulation. Args: input: Disconnect parameters (session_id). Returns: JSON string with status ``"ok"``.

List Bluetooth devices emulated in this session. Devices are tracked from ``wavexis_bluetooth_device_connect`` calls; CDP does not expose a command to enumerate emulated peripherals. Args: input: List parameters (session_id). Returns: JSON string with ``devices`` list and ``count``.

Close an isolated browser context. Args: input: Context close parameters (session_id, context_id). Returns: JSON string with status ``"ok"``.

Create an isolated browser context within a session. Args: input: Context creation parameters (session_id). Returns: JSON string with ``context_id``.

List all browser contexts in a session. Args: input: List contexts parameters (session_id). Returns: JSON string with ``contexts`` list and ``count``.

Get browser-level log entries. Args: input: Session reference parameters. Returns: JSON string with ``logs`` list and ``count``.

Query the active browser's version string via the selected backend. Use ``wavexis_backends`` instead when you need a list of all installed backends without launching a browser. Side effects: Acquires (and may launch) a browser backend, then releases it. Returns: JSON string with keys: 'status' ('ok'/'error'), 'version' (str), 'backend' (str).

Delete a Cache Storage cache. Args: input: Cache deletion parameters (cache_name). Returns: JSON string with status ``"ok"`` and ``cache_name``.

List entries in a Cache Storage cache. Args: input: Cache entries parameters (cache_name). Returns: JSON string with ``cache_name``, ``entries``, and ``count``.

List all Cache Storage cache names. Args: input: Session reference parameters. Returns: JSON string with ``caches`` list and ``count``.

Capture HAR (HTTP Archive) data for a page load. Args: input: HAR capture parameters (URL, wait, filter). Returns: JSON string with ``har`` data and ``entries`` count.

List available cast sinks. Args: input: List parameters (session_id). Returns: JSON string with ``sinks`` list and ``count``.

Start tab mirroring to a cast sink. Args: input: Cast start parameters (session_id, sink_name). Returns: JSON string with status ``"ok"``.

Stop active cast mirroring. Args: input: Cast stop parameters (session_id). Returns: JSON string with status ``"ok"``.

Check a checkbox or radio button matching a CSS selector. Use wavexis_uncheck to uncheck a checkbox or wavexis_click for generic element activation. Side effects: Clicks the target checkbox/radio, toggling its checked state and firing change events. Returns: JSON string with keys: 'status' ('ok'/'error'), 'checked' (bool, the element's checked state after the action). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Click an element matching a CSS selector. Use wavexis_double_click for double clicks, wavexis_right_click for context menus, or wavexis_nl_click when you only have a text description. Side effects: Triggers a click event on the target element, which may submit forms, toggle controls, or navigate the page. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Close a browser page/tab by target id, or the current page if omitted. This tool mirrors Playwright's API for compatibility; use it to free resources. The session itself remains active for other tabs. Side effects: Closes the specified browser target; destructive and irreversible. Returns: JSON string with keys: 'status' ('ok'/'error'), 'closed' (str).

Close a browser tab by its ID. Use to clean up tabs created with wavexis_new_tab; use wavexis_session_close to terminate the entire session instead. Side effects: Closes the specified tab and discards its page state. Destructive — unsaved data in that tab is lost. Returns: JSON string with keys: 'status' ('ok'/'error').

Clear all buffered console messages for the session. This tool mirrors Playwright's API for compatibility; use it before capturing a fresh set of console logs to avoid stale entries. Side effects: Resets the session's in-memory console message buffer. Returns: JSON string with keys: 'status' ('ok'/'error').

Get console messages with pagination. Args: input: Console messages parameters (level, pagination). Returns: JSON string with paginated ``messages``, ``count``, and ``total``.

Retrieve a single cookie by name (and optional domain/path) from the browser. Use ``wavexis_cookie_list`` instead when you need multiple cookies or broad filtering. Side effects: None; reads cookie state from the browser session. Returns: JSON string with keys: 'status' ('ok'/'error'), 'cookie' (dict|null).

List browser cookies with optional name, domain, and path filters. Use ``wavexis_cookie_get`` instead when you need a single named cookie. Side effects: None; reads cookie state from the browser session. Returns: JSON string with keys: 'status' ('ok'/'error'), 'cookies' (list[dict]), 'count' (int).

Clear all cookies from the browser session. Use ``wavexis_cookies_delete`` to remove a specific cookie, or ``wavexis_cookies_get`` to inspect cookies before clearing. Side effects: uses an existing session backend, destructively removes all cookies from the browser. Returns: JSON string with keys: 'status' ('ok'/'error').

Delete cookies matching a name and domain in the browser. Use ``wavexis_cookies_clear`` to remove all cookies, or ``wavexis_cookies_set`` to add a new cookie. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, destructively removes matching cookies from browser state. Returns: JSON string with keys: 'status' ('ok'/'error').

Retrieve all cookies for the current page context. Use ``wavexis_cookies_set`` to add a cookie, or ``wavexis_cookies_clear`` to remove all cookies at once. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided; read-only with respect to browser state. Returns: JSON string with keys: 'status' ('ok'/'error'), 'cookies' (list[dict]), 'count' (int).

Set a single cookie in the browser for the current page. Use ``wavexis_cookies_get`` to read cookies, or ``wavexis_cookies_delete`` to remove a specific cookie. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, mutates browser cookie state. Returns: JSON string with keys: 'status' ('ok'/'error').

Measure Core Web Vitals (LCP, CLS, INP) with ratings and score. Args: input: CWV parameters (url, observe_ms, budgets). Returns: JSON string with ``metrics``, ``ratings``, ``score``, and optional ``budgets``.

Crawl a website starting from a URL. Args: input: Crawl parameters (start_url, max_depth, max_pages). Returns: JSON string with ``pages`` list and counts.

Get computed styles for an element. Args: input: Computed styles parameters (selector). Returns: JSON string with ``computed`` styles.

Get CSS rules from a specific stylesheet. Args: input: CSS rules parameters (stylesheet_id). Returns: JSON string with ``stylesheet_id``, ``rules``, and ``count``.

Get inline and matched CSS styles for an element. Args: input: CSS styles parameters (selector). Returns: JSON string with ``styles`` data.

List all stylesheets loaded by the page. Args: input: Session reference parameters. Returns: JSON string with ``stylesheets`` list and ``count``.

Get event listeners attached to an element. Args: input: Event listener parameters (selector). Returns: JSON string with ``listeners`` list and ``count``.

Pause script execution. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Remove a breakpoint by ID. Args: input: Breakpoint removal parameters (breakpoint_id). Returns: JSON string with status ``"ok"``.

Resume script execution. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Set a breakpoint by URL and line number. Args: input: Breakpoint parameters (url, line, condition). Returns: JSON string with ``breakpoint_id``.

Set a breakpoint by function name. Args: input: Breakpoint parameters (function_name). Returns: JSON string with ``breakpoint_id``.

Step into in the debugger. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Step out in the debugger. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Step over in the debugger. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Accept a JavaScript dialog (alert, confirm, prompt). Args: input: Dialog accept parameters (prompt_text). Returns: JSON string with status ``"ok"``.

Dismiss a JavaScript dialog. Args: input: Dialog dismiss parameters. Returns: JSON string with status ``"ok"``.

Focus an element matching a CSS selector. Use wavexis_click instead when the intent is to activate a control rather than focus it. Side effects: Mutates DOM focus state; may trigger focus event handlers on the element. Returns: JSON string with keys: 'status' ('ok'/'error').

Retrieve the HTML of an element matching a CSS selector. Use wavexis_dom_query instead when you need element metadata rather than raw HTML. Side effects: None; read-only. May navigate to ``url`` if provided. Returns: JSON string with keys: 'status' ('ok'/'error'), 'html' (str), 'selector' (str).

Read an attribute value from an element matching a CSS selector. Use wavexis_dom_set_attr to write an attribute value. Side effects: None; read-only. Returns: JSON string with keys: 'status' ('ok'/'error'), 'value' (str|None), 'selector' (str), 'name' (str).

Query elements by CSS selector and return paginated metadata. Use wavexis_dom_get instead when you only need the raw HTML of a single element. Side effects: None; read-only. May navigate to ``url`` if provided. Returns: JSON string with keys: 'status' ('ok'/'error'), 'elements' (list[dict]), 'count' (int), 'total' (int).

Remove an element matching a CSS selector from the DOM. Use wavexis_dom_set_attr to hide an element (e.g. ``display:none``) instead of deleting it. Side effects: Destructive; permanently removes the matched element from the live DOM. Returns: JSON string with keys: 'status' ('ok'/'error').

Remove an attribute from an element matching a CSS selector. Use wavexis_dom_set_attr to restore or change an attribute instead of removing it. Side effects: Mutates the DOM by deleting the attribute from the matched element. Returns: JSON string with keys: 'status' ('ok'/'error').

Scroll to an element or by a pixel offset. Use wavexis_dom_get to inspect an element's position before scrolling by offset. Side effects: Changes the page scroll position; may trigger scroll event listeners. Returns: JSON string with keys: 'status' ('ok'/'error').

Set an attribute on an element matching a CSS selector. Use wavexis_dom_get_attr to read the current value before setting. Side effects: Mutates the DOM by writing the attribute on the matched element. Returns: JSON string with keys: 'status' ('ok'/'error').

Capture a full DOM snapshot of the page including iframes and shadow roots. Use wavexis_dom_query for lightweight element metadata instead of a full snapshot. Side effects: None; read-only. Returns: JSON string with keys: 'status' ('ok'/'error'), 'snapshot' (dict), 'documents' (int).

Double-click an element matching a CSS selector. Use wavexis_click for single clicks or wavexis_nl_click when you only have a natural language description of the element. Side effects: Fires two rapid click events on the element, which may open files, edit cells, or trigger application-specific actions. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Drag an element from a source selector to a target selector. Use wavexis_drop when you need to drop arbitrary MIME data or files onto an element rather than dragging an existing DOM element. Side effects: Performs a drag-and-drop operation between two elements, firing drag/dragstart/dragend and drop events. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Drop files or MIME-typed data onto an element via drag events. Use wavexis_set_files for standard ``<input type="file">`` uploads or wavexis_drag for dragging an existing DOM element to another element. Side effects: Dispatches dragEnter, dragOver, and drop events with the supplied data and files onto the target element's coordinates. Returns: JSON string with keys: 'status' ('ok'/'error'), 'selector' (str), 'x' (float), 'y' (float), 'data_types' (list[str]), 'files' (list[str]). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Emulate a specific device (iphone-15, pixel-8, etc.). Args: input: Device emulation parameters. Returns: JSON string with status ``"ok"`` and ``device``.

Evaluate a JavaScript expression in the browser context and return the result. Use ``wavexis_scrape`` when the same expression must run across many pages, or ``wavexis_act`` for natural-language interaction instead of raw JS. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, executes arbitrary JS in the page (may trigger network requests or DOM mutations). Returns: JSON string with keys: 'status' ('ok'/'error'), 'result' (Any), 'type' (str).

Install a browser extension from a .crx or unpacked directory. Args: input: Extension install parameters (path). Returns: JSON string with ``extension_id``.

List installed browser extensions. Args: input: Session reference parameters. Returns: JSON string with ``extensions`` list and ``count``.

Uninstall a browser extension by ID. Args: input: Extension uninstall parameters (extension_id). Returns: JSON string with status ``"ok"``.

Extract structured data from a page using a CSS selector schema. Args: input: Extraction parameters (url, schema, selector). Returns: JSON string with ``data`` list and ``rows`` count.

Fill an input element with a value, replacing existing content. Use wavexis_type for character-by-character typing with key events, or wavexis_fill_form when filling multiple fields in one call. Side effects: Clears the target input/textarea and sets its value to the provided string, firing a single input event. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Fill multiple form fields in one call (convenience composite tool). Use wavexis_fill for a single field or wavexis_type when per-keystroke events are required. Side effects: Clears and sets the value of each field in the provided list, firing input events on every targeted element. Returns: JSON string with keys: 'status' ('ok'/'error'), 'fields_filled' (int, number of fields successfully filled). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Search the accessibility snapshot for nodes matching text or a regex pattern. Use ``wavexis_act`` instead for natural-language element interaction; this tool mirrors Playwright's snapshot search for compatibility. Side effects: None; fetches and searches the a11y tree read-only. Returns: JSON string with keys: 'status' ('ok'/'error'), 'matches' (list[dict]), 'count' (int).

Find element selector(s) by visible text content without interacting. Use this to locate elements before calling wavexis_click or wavexis_fill when you know the visible text but not the CSS selector. Side effects: None — this is a read-only lookup that does not modify the page or interact with any element. Returns: JSON string with keys: 'selector' (str, first match) when all=False, or 'selectors' (list[str]) and 'count' (int) when all=True. On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Navigate forward one step in the browser history. Use after wavexis_back to restore a page; use wavexis_navigate for direct URL navigation instead. Side effects: Changes the active page to the next history entry; may trigger network requests if that page was not cached. Returns: JSON string with keys: 'status' ('ok'/'error').

Generate a robust CSS selector for an element. Uses the backend's ``suggest_locator`` method to produce optimal selectors in priority order: id > data-testid > aria-label > text > tag.classes > nth-of-type chain. Args: input: Locator parameters (selector, description). Returns: JSON string with ``locator`` and ``alternative``.

Return wavexis-mcp server configuration and available browser backends. Use ``wavexis_backends`` instead when you only need the backend list; this tool additionally exposes the server name for introspection. Side effects: None; queries the local filesystem only. Returns: JSON string with keys: 'status' ('ok'/'error'), 'name' (str), 'available_backends' (list[str]), 'backend_versions' (dict).

Get a browser preference value by key. Args: input: Preference parameters (key). Returns: JSON string with ``key`` and ``value``.

Get the body of a network request by ID (W3). Args: input: Request body parameters (session_id, request_id). Returns: JSON string with ``body`` or ``error`` if not available.

Get the body of a network response by ID (W3). Args: input: Response body parameters (session_id, request_id). Returns: JSON string with ``body`` or ``error`` if not available.

Get the page security state. Args: input: Session reference parameters. Returns: JSON string with ``state`` data.

Get the browser window bounds. Args: input: Session reference parameters. Returns: JSON string with window bounds (width, height, x, y).

Grant a browser permission (geolocation, notifications, etc.). Args: input: Permission parameters. Returns: JSON string with status ``"ok"`` and ``permission``.

Hover over an element matching a CSS selector. Use wavexis_click to actually activate an element; hover only moves the cursor without clicking. Side effects: Moves the mouse cursor over the target element, firing mouseover/mouseenter events that may reveal tooltips or menus. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Click an element inside an iframe. Use wavexis_iframe_eval only for custom JS that click/fill cannot express. Side effects: Triggers click handlers and may navigate or mutate the iframe DOM. Returns: JSON string with keys: 'status' ('ok'/'error').

Evaluate a JavaScript expression inside an iframe. Use wavexis_iframe_click or wavexis_iframe_fill for standard interactions instead of raw JS. Side effects: Arbitrary; executes user-supplied JavaScript within the iframe context. Returns: JSON string with keys: 'status' ('ok'/'error'), 'result' (any).

Fill an input element inside an iframe with a value. Use wavexis_iframe_click to submit or activate the field after filling. Side effects: Mutates the input value within the iframe; may trigger input/change events. Returns: JSON string with keys: 'status' ('ok'/'error').

Enable or disable certificate error ignoring. Args: input: Certificate error parameters (ignore). Returns: JSON string with status ``"ok"`` and ``ignore``.

Clear an IndexedDB object store. Args: input: IndexedDB clear parameters (database, store). Returns: JSON string with status ``"ok"``.

Get data from an IndexedDB object store. Args: input: IndexedDB query parameters (database, store, key). Returns: JSON string with ``database``, ``store``, and ``data``.

List all IndexedDB databases and their object stores. Args: input: Session reference parameters. Returns: JSON string with ``databases`` list and ``count``.

Intercept a download matching a URL pattern. Args: input: Download interception parameters (pattern, output_path). Returns: JSON string with file path or base64 data and size.

Register a request interception pattern. Args: input: Interception parameters. Returns: JSON string with status ``"ok"``.

Invoke any wavexis backend method by name, the ultimate escape hatch. Use a dedicated MCP tool (e.g. ``wavexis_act``, ``wavexis_navigate``) instead when one exists for the desired action; this tool exposes the full ``AbstractBackend`` API (e.g. ``page_print_to_pdf``, ``perf_trace``, ``runtime_evaluate``, ``pwa_install``) for methods without a wrapper. Side effects: May launch an ephemeral browser, navigate to a URL, and execute arbitrary backend methods; potentially destructive. Returns: JSON string with keys: 'status' ('ok'/'error'), 'type' (str), and either 'result' (any), 'base64' (str), …

Dispatch a raw keyDown event to the active page via CDP. This tool mirrors Playwright's API for compatibility; use ``wavexis_press_keys`` for typing text and ``wavexis_act`` for natural-language interaction. Side effects: Sends a key-down input event to the browser page. Returns: JSON string with keys: 'status' ('ok'/'error').

Press a single keyboard key on the focused element. Use wavexis_type for typing full strings or wavexis_fill for setting field values without individual key events. Side effects: Dispatches a keydown/keypress/keyup sequence for the given key on whatever element currently has focus. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Dispatch a raw keyUp event to the active page via CDP. This tool mirrors Playwright's API for compatibility; pair with ``wavexis_key_down`` for low-level key control, or use ``wavexis_press_keys`` for simple text entry. Side effects: Sends a key-up input event to the browser page. Returns: JSON string with keys: 'status' ('ok'/'error').

Run a Lighthouse-style audit on a URL. Args: input: Audit parameters (url, categories). Returns: JSON string with ``categories`` dict containing scores per category.

List all open browser tabs in the session. Use to discover tab IDs before calling wavexis_activate_tab or wavexis_close_tab; use wavexis_session_info for session-level metadata instead. Side effects: None — read-only query of the browser's tab list. Returns: JSON string with keys: 'status' ('ok'/'error'), 'tabs' (list[dict]), 'count' (int).

Clear all localStorage entries. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Delete a localStorage key. Args: input: LocalStorage delete parameters. Returns: JSON string with status ``"ok"``.

Get a localStorage value by key. Args: input: LocalStorage get parameters. Returns: JSON string with ``key`` and ``value``.

List all localStorage entries. Args: input: Session reference parameters. Returns: JSON string with ``entries`` dict and ``count``.

Set a localStorage key/value pair. Args: input: LocalStorage set parameters. Returns: JSON string with status ``"ok"``.

Get messages for a specific media player. Args: input: Message parameters (session_id, player_id). Returns: JSON string with ``messages`` list and ``count``.

List all media players on the page. Args: input: List parameters (session_id). Returns: JSON string with ``players`` list and ``count``.

Pause a media player by ID. Args: input: Pause parameters (session_id, player_id). Returns: JSON string with status ``"ok"``.

Play a media player by ID. Args: input: Play parameters (session_id, player_id). Returns: JSON string with status ``"ok"``.

Seek a media player to a specific time. Args: input: Seek parameters (session_id, player_id, time_ms). Returns: JSON string with status ``"ok"`` and ``time_ms``.

Register a mock response for a URL pattern. Args: input: Mock response parameters. Returns: JSON string with status ``"ok"``.

Intercept and modify requests matching a pattern in-flight (W6). Args: input: Modification parameters (pattern, modifications). Returns: JSON string with status ``"ok"``.

Intercept and modify responses matching a pattern in-flight. Args: input: Modification parameters (pattern, modifications). Returns: JSON string with status ``"ok"``.

Click at absolute pixel coordinates (press + release). Args: input: Click parameters (x, y, button, click_count). Returns: JSON string with status ``"ok"`` and coordinates.

Double-click at absolute pixel coordinates. Args: input: Double-click parameters (x, y, button). Returns: JSON string with status ``"ok"`` and coordinates.

Press a mouse button at the given coordinates. Args: input: Mouse down parameters (button, x, y). Returns: JSON string with status ``"ok"``.

Drag the mouse from one screen coordinate to another via CDP mouse events. This tool mirrors Playwright's API for compatibility; use ``wavexis_act`` instead for natural-language drag interactions. Side effects: Dispatches mouseMoved, mousePressed, and mouseReleased events to the browser page; may trigger page interactions. Returns: JSON string with keys: 'status' ('ok'/'error').

Move the mouse to an element matching a CSS selector. Args: input: Mouse move parameters (selector). Returns: JSON string with status ``"ok"`` and ``selector``.

Move the mouse to absolute pixel coordinates. Args: input: Mouse move parameters (x, y). Returns: JSON string with status ``"ok"`` and coordinates.

Release a mouse button at the given coordinates. Args: input: Mouse up parameters (button, x, y). Returns: JSON string with status ``"ok"``.

Simulate a mouse wheel (scroll) event at the given coordinates. Args: input: Mouse wheel parameters (x, y, delta_x, delta_y). Returns: JSON string with status ``"ok"`` and scroll amounts.

Execute multiple actions from a YAML config sequentially. Args: input: Multi-action parameters (YAML config, continue_on_error). Returns: JSON string with ``actions`` count, ``results``, and ``errors``.

Navigate the browser to a URL with a configurable wait strategy. Use for direct URL navigation; use wavexis_back/wavexis_forward for history navigation, or wavexis_act for natural-language interaction instead. Side effects: Issues a network request to the target URL and replaces the current page content; may auto-create a stateless session if session_id is omitted. Returns: JSON string with keys: 'status' ('ok'/'error'), 'url' (str).

Clear the network event log.

Return full details for a single network request by index. Use the index from ``wavexis_network_requests`` with ``mode="events"``.

List network requests since page load with pagination. Args: input: Request listing parameters (filter, pagination, mode). Returns: JSON string with paginated ``requests``, ``count``, and ``total``.

Create a new browser tab, optionally navigating to a URL. Use to open a parallel page without losing the current tab; use wavexis_navigate to change the current tab's URL instead. Side effects: Opens a new browser tab; if a URL is provided, issues a network request to it. Returns: JSON string with keys: 'status' ('ok'/'error'), 'tab_id' (str), 'url' (str).

Click an element described in natural language. Use wavexis_click when you already know the CSS selector, or wavexis_nl_fill to fill a field described in natural language. Side effects: Locates the best-matching element via text/semantic matching and triggers a click event on it. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Fill an element described in natural language with a value. Use wavexis_fill when you already know the CSS selector, or wavexis_nl_click to click an element described in natural language. Side effects: Locates the best-matching element via text/semantic matching, clears it, and sets its value to the provided string. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Clear all overlay highlights. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Highlight an element with a colored overlay. Args: input: Highlight parameters (selector, color). Returns: JSON string with status ``"ok"`` and ``selector``.

Generate a PDF via the low-level Page.printToPDF CDP method. Offers pixel-level control over paper size, margins, and print options beyond ``wavexis_pdf``. Use ``wavexis_pdf`` for simpler high-level PDF generation. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'type' ('pdf'), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Capture the page as MHTML or a plain text document. Use ``wavexis_scrape`` for structured data extraction, or this tool when a full page archive (MHTML) or text dump is required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'format' (str), 'content' (str) or 'path' (str), 'size_bytes' (int).

Generate a PDF document from a web page. Use ``wavexis_screenshot`` for image capture, or ``wavexis_page_pdf`` when pixel-level control over paper size and margins is required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, optionally evaluates ``js``; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Get JavaScript code coverage. Args: input: Session reference parameters. Returns: JSON string with ``coverage`` data and ``scripts`` count.

Get CSS code coverage. Args: input: Session reference parameters. Returns: JSON string with ``coverage`` data.

Capture a heap snapshot. Args: input: Heap snapshot parameters (output_path). Returns: JSON string with ``snapshot`` data or file ``path``.

Get performance metrics (LCP, FCP, CLS, TTFB, DOMNodes, etc.). Args: input: Session reference parameters. Returns: JSON string with ``metrics`` dict.

Capture a CPU profile. Args: input: Profile parameters (duration_ms, output_path). Returns: JSON string with ``profile`` data or file ``path``.

Capture a performance trace. Args: input: Trace parameters (duration_ms, output_path). Returns: JSON string with ``trace`` data or file ``path``.

Type a sequence of characters at the page level without targeting an element. Use ``wavexis_key_down``/``wavexis_key_up`` instead for individual modifier-key control, or ``wavexis_act`` for natural-language typing. Side effects: Dispatches keyDown/keyUp pairs to the browser page; no network requests. Returns: JSON string with keys: 'status' ('ok'/'error'), 'typed' (str).

Send a raw BiDi command (escape hatch). Args: input: Raw BiDi parameters (method, params). Returns: JSON string with raw ``result`` from the BiDi command.

Send a raw CDP command (escape hatch). Args: input: Raw CDP parameters (method, params). Returns: JSON string with raw ``result`` from the CDP command.

Record browser interactions and generate a YAML workflow. Delegates to ``wavexis.actions.record.record_events`` to inject a recording script that captures user interactions (clicks, input, navigation, scroll, keypress) and then converts the captured events to a multi-action YAML workflow using ``wavexis.actions.record.events_to_yaml``. Args: input: Recording parameters (url, duration, headless). Returns: JSON string with ``yaml``, ``events_captured``, and ``duration_s``.

Reload the current page, optionally bypassing the cache. Use to refresh stale content or retry a failed load; use wavexis_navigate to go to a different URL instead. Side effects: Re-issues network requests for the current page and its resources; discards in-memory page state. Returns: JSON string with keys: 'status' ('ok'/'error').

Replay network requests from a HAR file (W7). Args: input: HAR replay parameters (har_path, url_filter, url). Returns: JSON string with status ``"ok"``.

Reset all granted permissions. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Right-click an element matching a CSS selector. Use wavexis_click for standard left clicks or wavexis_double_click for double clicks. Side effects: Fires a contextmenu event on the element, typically opening a context menu in the browser. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Add a network route/mock or header modification rule. If ``status`` or ``body`` is provided, matching requests are fulfilled with a mocked response. Otherwise the request is continued with the supplied header changes.

List all active network routes/mocks.

Scrape data from multiple URLs by evaluating a JS expression on each. Use ``wavexis_eval`` for single-page evaluation, or ``wavexis_scrape`` when the same expression must run across many pages with pagination. Side effects: launches/acquires a browser backend, navigates to each URL in ``urls`` sequentially, evaluates ``expression`` in every page context. Returns: JSON string with keys: 'status' ('ok'/'error'), 'results' (list[dict[str, Any]]), 'format' (str), 'count' (int), 'total' (int).

Capture a frame-by-frame screenshot sequence over a duration. Use ``wavexis_screenshot`` for a single still image, or ``wavexis_screencast`` when animation or time-series capture is needed. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, captures frames for ``duration``; writes frame files to ``output_dir`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'frames' (list[str]) or 'dir' (str), 'count' (int).

Capture a screenshot of a web page or matched element. Use ``wavexis_pdf`` when a print-ready document is needed, or ``wavexis_annotated_screenshot`` when labelled element markers are required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, optionally evaluates ``js``; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'format' (str), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Select an option in a ``<select>`` element by value. Use wavexis_fill for text inputs or wavexis_click for custom dropdown widgets that are not native ``<select>`` elements. Side effects: Changes the selected option of the ``<select>`` element, firing change and input events. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Emulate a service worker with a script URL. Args: input: Emulate parameters (session_id, script_url). Returns: JSON string with status ``"ok"``.

List registered service workers. Args: input: List parameters (session_id). Returns: JSON string with ``workers`` list and ``count``.

Unregister a service worker. Args: input: Unregister parameters (session_id, registration_id). Returns: JSON string with status ``"ok"``.

Trigger an update for a service worker registration. Args: input: Update parameters (session_id, registration_id). Returns: JSON string with status ``"ok"``.

Close a browser session and release all associated resources. Call when the session is no longer needed to free memory and browser processes; use wavexis_close_tab to close individual tabs instead. Side effects: Terminates the browser process (or disconnects from a remote one) and frees session state. Destructive — all unsaved page state is lost. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str).

Query metadata and current URL of an active browser session. Use to inspect session health or retrieve the current page URL; use wavexis_list_tabs for tab-level details instead. Side effects: None — read-only; queries in-memory session state and the browser's current URL. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str), 'backend' (str), 'created_at' (str), 'current_url' (str).

Launch a persistent browser session for multi-step workflows. Call once at the start of a task and reuse the returned session_id for all subsequent calls; use wavexis_navigate with session_id omitted for one-off page fetches instead. Side effects: Launches a browser process (or connects to an existing one) and allocates server-side session state; may open network connections to remote/cloud browsers. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str), 'backend' (str).

Clear all sessionStorage entries. Args: input: Session reference parameters. Returns: JSON string with status ``"ok"``.

Delete a sessionStorage key. Args: input: SessionStorage delete parameters. Returns: JSON string with status ``"ok"``.

Get a sessionStorage value by key. Args: input: SessionStorage get parameters. Returns: JSON string with ``key`` and ``value``.

List all sessionStorage entries. Args: input: Session reference parameters. Returns: JSON string with ``entries`` dict and ``count``.

Set a sessionStorage key/value pair. Args: input: SessionStorage set parameters. Returns: JSON string with status ``"ok"``.

Enable or disable browser cache. Args: input: Cache disable parameters. Returns: JSON string with status ``"ok"`` and ``cache_disabled``.

Enable CPU throttling at a given multiplier. Args: input: CPU throttle parameters (rate). Returns: JSON string with status ``"ok"`` and ``rate``.

Enable or disable dark mode emulation. Args: input: Dark mode parameters. Returns: JSON string with status ``"ok"`` and ``dark_mode``.

Upload files to a file input element (``<input type="file">``). Use wavexis_drop when you need to simulate drag-and-drop of files or MIME data onto a non-file-input element. Side effects: Sets the selected files on the target file input element, firing change events that typically trigger upload logic. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Override the browser geolocation. Args: input: Geolocation parameters (latitude, longitude, accuracy). Returns: JSON string with status ``"ok"`` and coordinates.

Set extra HTTP headers for all subsequent requests. Args: input: Headers parameters. Returns: JSON string with status ``"ok"``.

Override the browser locale. Args: input: Locale parameters. Returns: JSON string with status ``"ok"`` and ``locale``.

Override the browser network state to online or offline. Args: input: Network state parameters. Returns: JSON string with status ``"ok"`` and ``"state"``.

Set a browser preference value. Args: input: Preference parameters (key, value). Returns: JSON string with status ``"ok"``.

Override sensor values (orientation, motion, light, proximity). Args: input: Sensor parameters (sensor_type, values). Returns: JSON string with status ``"ok"``, ``sensor_type``, and ``values``.

Override the browser timezone. Args: input: Timezone parameters. Returns: JSON string with status ``"ok"`` and ``timezone``.

Enable or disable touch event emulation. Args: input: Touch emulation parameters. Returns: JSON string with status ``"ok"`` and ``touch_emulation``.

Set a custom User-Agent string for all subsequent requests. Args: input: User agent parameters. Returns: JSON string with status ``"ok"``.

Set a custom viewport size and scale factor. Args: input: Viewport parameters (width, height, scale factor). Returns: JSON string with status ``"ok"`` and viewport dimensions.

Set the browser window bounds. Args: input: Window bounds parameters (width, height, x, y). Returns: JSON string with status ``"ok"`` and bounds values.

Click an element inside a shadow DOM tree. Pierces shadow boundaries using the provided selector chain. Use wavexis_shadow_eval only for custom JS that click/fill cannot express. Side effects: Triggers click handlers and may navigate or mutate the shadow DOM. Returns: JSON string with keys: 'status' ('ok'/'error').

Evaluate a JavaScript expression inside a shadow DOM tree. Pierces shadow boundaries using the provided selector chain: ``selectors[0]`` is in the main document, ``selectors[1]`` in ``selectors[0].shadowRoot``, and so on. Use wavexis_shadow_click or wavexis_shadow_fill for standard interactions instead of raw JS. Side effects: Arbitrary; executes user-supplied JavaScript within the shadow DOM context. Returns: JSON string with keys: 'status' ('ok'/'error'), 'result' (any).

Fill an input element inside a shadow DOM tree with a value. Pierces shadow boundaries using the provided selector chain. Use wavexis_shadow_click to submit or activate the field after filling. Side effects: Mutates the input value within the shadow DOM; may trigger input/change events. Returns: JSON string with keys: 'status' ('ok'/'error').

Start a combined trace capturing screenshots, network, and console (W8). Args: input: Combined trace start parameters. Returns: JSON string with ``trace_id``.

Stop all pending navigations and resource loads in the session. Use when a page load is hanging or no longer needed; use wavexis_wait to wait for a load to complete instead. Side effects: Aborts in-flight network requests and pending navigations; the page is left in its current partial state. Returns: JSON string with keys: 'status' ('ok'/'error').

Stop a combined trace and return collected data (W8). Args: input: Combined trace stop parameters (trace_id). Returns: JSON string with ``trace`` data including events, screenshots, network, console.

Restore cookies + localStorage + sessionStorage from a JSON file. Args: input: Restore parameters (input_path). Returns: JSON string with status ``"ok"`` and restored entry counts.

Save cookies + localStorage + sessionStorage to a JSON file. Args: input: Save parameters (output_path). Returns: JSON string with ``path`` and entry counts.

Subscribe to real-time browser events (W10). Event types: console, network_request, network_response, dom_mutation, dialog, navigation. Events are buffered per session (last 500) and returned by ``wavexis_unsubscribe_events``. Args: input: Subscription parameters (event_types). Returns: JSON string with ``subscription_id``.

Tap an element matching a CSS selector (touch-emulated click). Use wavexis_click for mouse-based clicking on desktop contexts or wavexis_nl_click when you only have a natural language description. Side effects: Dispatches a touch tap on the target element, which may toggle controls or trigger navigation on mobile-optimised pages. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Throttle network speed to emulate slow connections. Args: input: Throttle parameters (preset or custom values). Returns: JSON string with status ``"ok"``.

Type text into an element character by character with optional delay. Use wavexis_fill instead when you want to set a field's value instantly without per-keystroke delays, or wavexis_fill_form for multiple fields. Side effects: Appends characters to the target input/textarea element, firing keydown/keypress/input/keyup events per character. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Uncheck a checkbox matching a CSS selector by clicking it. Use wavexis_check to check a checkbox or wavexis_click for generic element activation. Side effects: Clicks the target checkbox to toggle it to unchecked, firing change events. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Remove network routes matching a pattern, or all routes.

Unsubscribe from browser events by subscription ID (W10). Args: input: Unsubscribe parameters (subscription_id). Returns: JSON string with status ``"ok"``.

Enable or disable the on-page action overlay for recordings. When enabled, a small fixed badge is injected into the page that flashes the last user action (click, keypress, input) so it is visible in captured screencast frames. Args: input: Overlay parameters (show). Returns: JSON string with status ``"ok"`` and ``show``.

Add a chapter marker to an active recording. Args: input: Chapter parameters (recording_id, title, timestamp_ms). Returns: JSON string with ``status`` and ``chapter`` info.

Start recording a video of the page. Args: input: Recording parameters (output_path, width, height). Returns: JSON string with ``recording_id`` and ``status``.

Stop recording and return the captured frames as an MJPEG stream. The output is a Motion JPEG stream (concatenated JPEG frames) — a format playable by VLC/ffmpeg and encodable to mp4/webm. It is not a containerized mp4/webm. Args: input: Stop parameters (recording_id, output_path). Returns: JSON string with ``base64`` MJPEG data or file ``path``, plus ``duration_ms``, ``size_bytes``, ``frames``, ``format`` and ``chapters``.

Compare a screenshot against a baseline image. Args: input: Visual diff parameters (url, baseline_path, threshold). Returns: JSON string with ``diff_percentage``, ``diff_pixels``, and ``passed``.

Block until a page condition (load, selector, URL, network idle) is met. Use after wavexis_navigate when the wait strategy was 'none', or to wait for dynamic content; use wavexis_stop to cancel a load instead. Side effects: None — read-only polling with no page mutations; blocks the tool call up to the configured timeout. Returns: JSON string with keys: 'status' ('ok'/'error'), 'elapsed_ms' (int).

Capture WebAudio context data. Args: input: Capture parameters (session_id, context_id). Returns: JSON string with ``contexts`` list.

Stop WebAudio capture. Args: input: Stop parameters (session_id). Returns: JSON string with status ``"ok"``.

Add a virtual WebAuthn authenticator for testing. Args: input: Authenticator parameters (session_id, protocol, transport). Returns: JSON string with ``authenticator_id``.

Add a credential to a virtual authenticator. Args: input: Add credential parameters (session_id, authenticator_id, credential). Returns: JSON string with status ``"ok"``.

Get credentials from a virtual authenticator. Args: input: Get credentials parameters (session_id, authenticator_id). Returns: JSON string with ``credentials`` list.

Remove a virtual authenticator. Args: input: Remove authenticator parameters (session_id, authenticator_id). Returns: JSON string with status ``"ok"``.

Capture WebSocket frames on a page. Args: input: WebSocket intercept parameters (url, duration_ms). Returns: JSON string with ``sent``, ``received``, and frame counts.