Get the current page

Return {"action": action, "action_params": {…}}

Custom serialization handling circular references

Add message with token count metadata position: None for last, -1 for second last, etc.

Execute the task with maximum number of steps

Lazy initialization of the browser and related components

Remove last state message from history

Utility function that raises an InterruptedError if the agent is stopped or paused.

Add browser state as human message

Get all messages

Get the current state of the browser

* Puts a payload into the de-dupe queue. * - if we already hold something for the same eventHash … * • keep an existing *submit* unless the n

Get all CDP targets directly using CDP protocol

Close the browser instance

Creates a Pydantic model from registered actions, used by LLM APIs that support tool calling & enforce a schema

Get the index of the action

Get a description of all actions for the prompt If page is provided, only include actions that are available for that page based on their filter_

Check if the agent is done

Execute multiple actions

Create a browser context

Check if a URL is allowed based on the whitelist configuration.

Authenticate with Dolphin Anty API using the API token. Raises: Exception: If authentication fails.

Convert the processed DOM content to HTML.

Close the browser instance

* Highlights an element in the DOM and returns the index of the next element.

Get all actions from history

Main chat session handler.

Switch to a specific tab by its page_id

Extend actions with custom actions

Check if current page URL is allowed and handle if not.

Count tokens in a message using the model's tokenizer

Creates a CSS selector for a DOM element, handling various edge cases and special characters. Args: element: The DOM element to create

Handle all types of errors that can occur during a step

Initialize the browser session

Create and store history item

Add message with metadata to history

Add model output as AI message

Close all resources

Connect to a running browser profile using Playwright. Args: profile_id (str, optional): Profile ID to connect to (defaults to the one set

Get all errors from history, with None for steps without errors

Locates an element on the page using the provided CSS selector.

Stop the agent

Optimized method to click an element using xpath.

Count tokens in a text string

Return (inner_text, tag, input_type).

Handle a second Ctrl+C press by performing cleanup and exiting. This is shared logic used by both sigint_handler and wait_for_resume.

Initialize the browser session