Class AbstractBrowser

java.lang.Object

uno.anahata.asi.agi.tool.ToolContext

uno.anahata.asi.agi.tool.AnahataToolkit

uno.anahata.asi.yam.tools.browser.AbstractBrowser

All Implemented Interfaces:

ContextProvider, PropertyChangeSource, Rebindable

Direct Known Subclasses:

Chrome, Firefox

public abstract class AbstractBrowser
extends AnahataToolkit
implements Rebindable

The abstract base toolkit for all web automation implementations.

This class centralizes all pure Selenium WebDriver interactions (DOM querying, execution, navigation, and screenshots). Concrete implementations (like Chrome or Firefox) must handle the browser-specific launch protocols, DevTools connections, and process management.

Author:

anahata

Field Summary

Fields

Modifier and Type	Field	Description
protected final Map<String, BrowserDrone>	drones	The centralized registry mapping drone IDs to their stateful objects.

Fields inherited from class AnahataToolkit

childrenProviders, propertyChangeSupport

Fields inherited from class ToolContext

toolkit

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractBrowser()	Protected constructor for subclass instantiation.

Method Summary

Modifier and Type	Method	Description
String	clickElement(String droneId, String identifier)	Performs a stateful click by first attempting to locate the element using a multi-strategy search (ID, Name, Link Text, XPath text content).
String	close(String droneId)	Closes the browser session and removes it from the registry.
Object	executeScript(String droneId, String script)	Executes arbitrary JavaScript in the current browser session.
String	fillForm(String droneId, Map<String,String> data)	Fills a web form with the provided data.
abstract org.openqa.selenium.WebDriver	getDriver(String droneId)	Resolves the active WebDriver for the requested drone.
String	getPageSource(String droneId)	Gets the full HTML source of the current page.
String	getPageText(String droneId)	Gets the visible text content of the current page.
String	getScreenshot(String droneId, String name)	Takes a screenshot of the current page and attaches it to the session.
String	getStatus(String droneId)	Gets the current status of the browser driver for a specific drone.
String	goBack(String droneId)	Navigates back in the browser history.
String	goForward(String droneId)	Navigates forward in the browser history.
String	inspectForm(String droneId)	Inspects the current page for input fields and buttons.
abstract String	killAll()	Closes all active browser processes.
abstract List<String>	listTabs(String droneId)	Lists all open tabs/windows in the specified drone.
protected org.openqa.selenium.WebElement	locateElementGracefully(org.openqa.selenium.WebDriver driver, String identifier)	Helper method to safely locate elements using a cascading fallback strategy.
String	navigate(String droneId, String url)	Navigates the specified drone to a new URL.
String	openNewTab(String droneId, String url)
String	refresh(String droneId)	Refreshes the current page.
String	scrollToElement(String droneId, String identifier)	Scrolls the specified element into view.
String	switchToTab(String droneId, int index)	Switches the active tab/window by its index.
String	waitForElement(String droneId, String cssSelector, int timeoutSeconds)	Safely executes a CSS-based visibility check using WebDriverWait.

Methods inherited from class AnahataToolkit

getChildrenProviders, getDescription, getId, getName, getParentProvider, getPropertyChangeSupport, initialize, isEffectivelyProviding, postActivate, rebind

Methods inherited from class ToolContext

addAttachment, addAttachment, addAttachment, error, error, getAgi, getApplicationMap, getAsiContainer, getAsiContainerMap, getCall, getExecutorService, getModelId, getModelMessage, getResourceManager, getResponse, getSessionMap, getThreadSafeLogger, getTool, getToolContext, getToolkit, getToolManager, getTurnMap, isToolExecution, log, peekResponse, runAsync

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ContextProvider

getAgi, getContextPosition, getFlattenedHierarchy, getFullyQualifiedId, getHeader, getIconId, getInstructionsTokenCount, getRagTokenCount, getSystemInstructions, isProviding, populateMessage, setParentProvider, setProviding

Methods inherited from interface Rebindable

rebind

Field Details

drones

protected final Map<String, BrowserDrone> drones

The centralized registry mapping drone IDs to their stateful objects.

Constructor Details

AbstractBrowser

protected AbstractBrowser()

Protected constructor for subclass instantiation.

Method Details

getDriver

public abstract org.openqa.selenium.WebDriver getDriver(String droneId)

Resolves the active WebDriver for the requested drone.

Implementation details: This is an internal lifecycle method. If the connection is lost, concrete implementations should attempt to re-establish it using the cached port and profile data.

Parameters:

droneId - The unique ID of the drone.

Returns:

The active WebDriver, or null if it cannot be resolved.

getStatus

public String getStatus(String droneId)

Gets the current status of the browser driver for a specific drone.

Parameters:

droneId - The ID of the drone.

Returns:

A status report.

killAll

public abstract String killAll()

Closes all active browser processes.

Returns:

A status message describing the cleanup operations.

listTabs

public abstract List<String> listTabs(String droneId)

Lists all open tabs/windows in the specified drone.

Implementations should ideally use native DevTools protocols to avoid forcing window focus and causing screen flickering.

Parameters:

droneId - The ID of the drone.

Returns:

A list of formatted tab titles and URLs.

navigate

public String navigate(String droneId,
 String url)

Navigates the specified drone to a new URL.

Parameters:

droneId - The ID of the drone.

url - The URL to navigate to.

Returns:

A status message.

getScreenshot

public String getScreenshot(String droneId,
 String name)
                     throws Exception

Takes a screenshot of the current page and attaches it to the session.

Parameters:

droneId - The ID of the drone.

name - The name of the screenshot file.

Returns:

A status message.

Throws:

Exception - if screenshot fails.

switchToTab

public String switchToTab(String droneId,
 int index)

Switches the active tab/window by its index.

Parameters:

droneId - The ID of the drone.

index - The index of the tab.

Returns:

A status message.

openNewTab

public String openNewTab(String droneId,
 String url)

goBack

public String goBack(String droneId)

Navigates back in the browser history.

Parameters:

droneId - The ID of the drone.

Returns:

A status message.

goForward

public String goForward(String droneId)

Navigates forward in the browser history.

Parameters:

droneId - The ID of the drone.

Returns:

A status message.

refresh

public String refresh(String droneId)

Refreshes the current page.

Parameters:

droneId - The ID of the drone.

Returns:

A status message.

getPageSource

public String getPageSource(String droneId)

Gets the full HTML source of the current page.

Parameters:

droneId - The ID of the drone.

Returns:

The page source.

getPageText

public String getPageText(String droneId)

Gets the visible text content of the current page.

Parameters:

droneId - The ID of the drone.

Returns:

The page text.

inspectForm

public String inspectForm(String droneId)

Inspects the current page for input fields and buttons.

Parameters:

droneId - The ID of the drone.

Returns:

A summary of found elements.

clickElement

public String clickElement(String droneId,
 String identifier)

Performs a stateful click by first attempting to locate the element using a multi-strategy search (ID, Name, Link Text, XPath text content).

Parameters:

droneId - The ID of the drone.

identifier - The ID, Name, or visible text of the element.

Returns:

A status message indicating success or failure.

scrollToElement

public String scrollToElement(String droneId,
 String identifier)

Scrolls the specified element into view.

Parameters:

droneId - The ID of the drone.

identifier - The element identifier.

Returns:

A status message.

waitForElement

public String waitForElement(String droneId,
 String cssSelector,
 int timeoutSeconds)

Safely executes a CSS-based visibility check using WebDriverWait.

Parameters:

droneId - The ID of the drone.

cssSelector - The CSS selector of the element.

timeoutSeconds - The maximum time to wait in seconds.

Returns:

A status message confirming visibility.

executeScript

public Object executeScript(String droneId,
 String script)

Executes arbitrary JavaScript in the current browser session.

Parameters:

droneId - The ID of the drone.

script - The script.

Returns:

The result.

fillForm

public String fillForm(String droneId,
 Map<String,String> data)

Fills a web form with the provided data.

Parameters:

droneId - The ID of the drone.

data - The form data.

Returns:

A status message.

close

public String close(String droneId)

Closes the browser session and removes it from the registry.

Parameters:

droneId - The ID of the drone.

Returns:

A confirmation message.

locateElementGracefully

protected org.openqa.selenium.WebElement locateElementGracefully(org.openqa.selenium.WebDriver driver,
 String identifier)

Helper method to safely locate elements using a cascading fallback strategy.

Execution order: ID -> Name -> Link Text -> XPath (text contains). This avoids throwing raw NoSuchElementExceptions and allows the caller to handle missing elements gracefully.

Parameters:

driver - The active WebDriver instance.

identifier - The ID, Name, or visible text to search for.

Returns:

The located WebElement, or null if not found.