hermes-extension

%s Call this FIRST whenever the user mentions an open browser, a tab, or a logged-in page. If nothing is attached yet but the bridge is up, this AUTO-ATTACHES the user's currently focused tab — do NOT ask them to use the sidepanel. To pick a different tab, call browser_tabs(action='list') then brows…

%s Attach the debugger so other live_browser tools can drive a tab. - No args: attach the user's currently focused tab. - tabId: attach that tab (from browser_tabs list). - url / title: attach the first tab whose url/title contains the substring. NEVER ask the user to click Attach in the sidepanel —…

%s Navigate the attached tab to url, wait for the load (wait='load') or only domcontentloaded, and return {url, title}. Auto-attaches the focused tab if nothing is attached yet.

%s Capture the accessibility tree of the attached tab as compact text with element refs ([eN] — clickable/typeable elements only). The default caps at 80 items (full=True -> 400). ALWAYS re-snapshot after navigation or a DOM mutation; old refs fail with STALE_REF (that is the contract). Returns the …

%s Find elements by text or CSS selector without a full snapshot. Returns up to max_results matches with refs ([eN]) — cheaper than browser_snapshot when you only need one element.

%s Click an element. target = a snapshot ref ('e5'), a unique CSS selector, or viewport coordinates '350,120' (canvas, charts, maps). double_click=True for a double click. Stale refs fail with STALE_REF — re-snapshot and retry.

%s Drag from `source` to `target`: slider thumbs (range sliders, volume, price filters), custom drag-and-drop UIs (sortable lists, kanban cards, map panning). Each endpoint = a snapshot ref ('e5'), a unique CSS selector, or viewport coordinates '350,120'. Holds the mouse at source, moves in `steps` …

%s Type text into an element (appends; use browser_fill to replace). submit=True presses Enter after typing. SECURITY: typing into a password field requires confirm='user_approved' — otherwise ask the user to type credentials themselves.

%s Replace an element's value (clear + type; React/Vue-safe native setter). SECURITY: password fields require confirm='user_approved'.

%s Press a keyboard key: a single character ('a', '3'), a name — enter, tab, escape, backspace, delete, space, up/down/left/right, home, end, pageup, pagedown — or a combo with ctrl/shift/alt/meta held ('ctrl+a', 'shift+tab', 'alt+f').

%s Hover an element (moves the mouse to its center).

%s Scroll, three ways: - page: direction up/down/left/right by amount px (direction defaults to 'down' when omitted); - target only: scroll that element into view; - target + direction: mouse-wheel scroll INSIDE the element's nearest scrollable container (dropdown lists, modal bodies, side panels). …

%s Select option(s) of a <select> element by value or label (React/Vue-safe native setter + change event). values = list of strings.

%s Check a checkbox/radio (no-op if already checked).

%s Uncheck a checkbox (no-op if already unchecked).

%s Go back one history entry; returns {url, title}.

%s Go forward one history entry; returns {url, title}.

%s Evaluate JavaScript in the attached tab and return the JSON value. Use ONLY when snapshot/click/type can't do the job — this runs with the user's real session; never touch credentials or payments.

%s Wait for: 'load' (document complete), 'visible' (target ref/selector has a box), 'text' (body contains text), 'text_gone' (body no longer contains text), or 'idle' (load + 0.5s settle). Raises on timeout.

%s Screenshot the attached tab — scope: 'viewport' (visible area), 'full' (whole page), 'element' (needs target ref/selector). Saves to disk and returns the path (@image:/MEDIA: lines render inline in Hermes). Prefer browser_snapshot for reading content; screenshots are for visuals (canvas, charts, …

%s Manage REAL browser tabs. YOU attach tabs — never ask the user to click Attach in the sidepanel.

%s Set files on a file-input element (ref from browser_snapshot, or a CSS selector). paths = absolute local filesystem paths the browser can read. Uses CDP DOM.setFileInputFiles — the browser-protocol path that bypasses the page-JS FileList read-only restriction (browser_evaluate cannot assign input…

%s Buffered console messages of the attached tab (newest last, capped at 200). level = 'error', 'warning', or 'info' (minimum severity to show); since_seq = seq of the last message you saw (0 = everything buffered).

%s Buffered network responses of the attached tab (newest last, capped at 200): {url, status, mime}. filter = substring URLs must contain; since_seq = seq of the last entry you saw (0 = everything buffered).