* Checks the background color of the body element to determine if the page is dark.

* Checks the CSS `color-scheme` property and `<meta name="color-scheme">` tag. * Only "dark"/"only dark" counts as dark; "light dark" is ambiguous an

* Checks if an element is accepted. * * @param {HTMLElement} element - The element to check. * @returns {boolean} Whether the element is accepte

* Checks if an element likely represents a distinct interaction * separate from its parent (if the parent is also interactive). * * @param {HTML

* Heuristically determines if an element should be considered as independently interactive, * even if it's nested inside another interactive contain

* Checks if an element is within the expanded viewport. * * @param {HTMLElement} element - The element to check. * @param {number} viewportExpan

* Check if a dependency name is a page-agent internal package

* Checks the background color of major layout elements (#app, #root, etc.). * Many SPAs render into a container that may have its own dark background

* @edit scrollable element detection * Checks if an element is scrollable. if so, return the scrollable distance on each direction (left right top b

* Checks if the text color on the body is light, which implies a dark background.

* Checks if a text node is visible. * * @param {Text} textNode - The text node to check. * @returns {boolean} Whether the text node is visible.

* Checks if an element is the topmost element at its position. * * @param {HTMLElement} element - The element to check. * @returns {boolean} Whe

* Parses an RGB or RGBA color string and returns an object with r, g, b properties. * @param {string} colorString - e.g., "rgb(34, 34, 34)" or "rgba(

* Push an observation message to the history event stream. * This will be visible in <agent_history> and remain persistent in memory across steps.

* Resolve active tab. * * - `tabs.query({ active: true })` does not work in multi-window scenarios. * - Extension pages (side panel, hub tab) can r

* Extract and parse JSON from a string. * - Treat content between the first `{` and the last `}` as JSON. * - Try to parse that content as JSON and

* Safely parse JSON, return original input if not json.

* Scroll vertically

* Scroll horizontally

* Select dropdown option by index and option text

* Show the visual mask overlay. * Only works after mask is setup.

@note Managed by content script via storage polling.

* Start a task that blocks on `wait`, returning once the tool is executing. * The running promise is wrapped so awaiting this helper does not await t

* Derive a model's OpenRouter id from its brand (a `MODEL_GROUPS` key) and * native model name.

* Update internal package versions in dependencies object * @returns {boolean} Whether any changes were made

* Update DOM tree, returns simplified HTML for LLM. * This is the main method to refresh the page state. * Automatically bypasses mask during DOM

* Validate action against tool schemas. Provides clear error messages * instead of letting the union schema produce unreadable errors. * * Also coe

* Wait until condition becomes true * @returns Returns when condition becomes true, false if timeout * @param timeoutMS Timeout in milliseconds, def

* Retry a function until it succeeds or reaches the maximum number of retries.