Register a new handler. * @param {RegExp} hostPattern – tested against location.hostname * @param {Function} initFn – called if the patte

Register signal handlers for SIGINT and SIGTERM.

Rerun a saved history of actions with error handling and retry logic. Args: history: The history to replay max_retries: Maximum number o

Reset state after resuming.

Write a JSON file shaped like

Get all screenshots from history

Overwrite the index of the action

SIGINT (Ctrl+C) handler. First Ctrl+C: Cancel current step and pause. Second Ctrl+C: Exit immediately if exit_on_second_int is True.

SIGTERM handler. Always exits the program completely.

Start a browser profile on Dolphin Anty. Args: profile_id (str, optional): Profile ID to start (defaults to the one set in the environment

Stop a browser profile on Dolphin Anty. Args: profile_id (str, optional): Profile ID to stop (defaults to the one set in the environment).

Generate a function name from the ultimate goal. This is a placeholder - in practice you would call OpenAI API here.

Get total duration of all steps in seconds

Get total tokens used across all steps. Note: These are from the approximate token counting of the message manager. For accurate token counting

Unregister signal handlers and restore original handlers if possible.

Wait for user input to resume or exit. This method should be called after handling the first Ctrl+C. It temporarily restores default signal ha

Execute one step of the task

Execute one step of the task

Read *jsonl_path*, extract the `next_goal` from each line's `reply`, and write the list of next goals to *out_path* (as a JSON array). Return

Async context manager entry

Async context manager exit

Cleanup when object is destroyed

Async cleanup when object is destroyed

Clean up resources when the DolphinBrowser instance is deleted.

Initialize configuration with environment variables.

Initialize the signal handler. Args: loop: The asyncio event loop to use. Defaults to current event loop. pause_callback: Function to call

Initialize the DolphinBrowser instance. Args: headless (bool): Run browser in headless mode (default: False). keep_open (bool): Keep

Representation of the AgentHistoryList object

Map a single `input-change` event to canonical actions. Supports: • <input type=text|search|password|email|number|tel|url|date|datetim

Convert one submit-form event (new JSON shape) into canonical actions and extend *plan*. Handles these control kinds ---------------

Decorator for registering custom actions @param description: Describe the LLM what the function does (better description == better function calling

Decorator for registering actions

Get all action names from history

Add model output as AI message

Close the browser connection and clean up resources. Args: force (bool): If True, forcefully stop the associated profile (default: False).

Close the current tab

Create a new tab and optionally navigate to a given URL. Args: url (str, optional): URL to navigate to after creating the tab. Defaults to