Dispose the agent (terminal, cannot be reused)

Execute a task

* Ensure the tree has been indexed before any index-based operation. * Throws if updateTree() hasn't been called yet.

Stop the current task (agent remains reusable)

* Show input area

* Gets the cached computed style for an element. * * @param {HTMLElement} element - The element to get the computed style for. * @returns {CSSSt

* Emit activity event - for transient UI feedback * @param activity - Current agent activity

Emit historychange event

* Clean up all element highlights

@returns {Promise<void>}

* Hide input area

Remove temporary question cards (only direct children for safety)

* Render history directly from agent.history * * Renders: * 1. Task (first item, from agent.task) * 2. Reflection cards (evaluation, memory, n

* Execute arbitrary JavaScript on the page. * The optional `signal` is exposed to the script scope so cooperative code * can abort promptly when t

* Gets the cached bounding rect for an element. * * @param {HTMLElement} element - The element to get the bounding rect for. * @returns {DOMRect

* Calculates the perceived luminance (0-255) of a CSS color string. * @param {string} colorString - e.g., "rgb(50, 50, 50)" or "rgba(0, 0, 0, 0.5)"

* Initialize mask asynchronously (dynamic import to avoid CSS loading in Node)

* Determines if a color is "dark" based on its calculated luminance. * @param {string} colorString - The CSS color string (e.g., "rgb(50, 50, 50)").

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

* Checks if an element is interactive. * * lots of comments, and uncommented code - to show the logic of what we already tried * * One of the

* Pull the window's tabs from the background. * Pulling is better than pushing. Long-lived ports are stateful troublemakers.

* Animate text change with fade out/in effect

* Ask for user input (internal, called by agent via onAskUser). * Rejects when `signal` aborts (task stopped or disposed), cleaning up the * quest

* Check if header needs update and trigger animation if not currently animating

Create cards for an action

Create cards for a history event

Emit statuschange event

* Get instructions from config

* Get system prompt, dynamically replace language settings based on configured language

* Action button handler: stop when running, close (dispose) when idle

* Handle agent activity - transient state for immediate UI feedback * Activity events are NOT persisted in history, only used for header bar updates

Handle agent history change - re-render history list from agent.history

* Generate system observations before each step * @todo loop detection * @todo console error

Handle agent status change

* Handle user answer

@param {import('ws').WebSocket} ws

* Merge all tools into a single MacroTool with the following input: * - thinking: string * - evaluation_previous_goal: string * - memory: string

Update status and emit event