Interact Executable Examples

Interact Executable Examples

Each section provides one runnable baseline call, expected response shape, and one failure example with a concrete fix. Use these as copy/paste starters and then adjust for your page or workflow.

Quick Reference

{
  "tool": "interact",
  "arguments": {
    "what": "highlight"
  }
}

Common Parameters

Parameter	Type	Description
what	string	Action name to execute.
tab_id	number	Optional target browser tab.
telemetry_mode	string	Optional telemetry verbosity: off, auto, full.

Actions

highlight

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "highlight"
  }
}

Expected response shape

{
  "action": "highlight",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "highlight"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. highlight.

subtitle

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "subtitle",
    "text": "Opening checkout flow"
  }
}

Expected response shape

{
  "action": "subtitle",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "subtitle"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "text": "Opening checkout flow"
  }
}

Fix: Use a valid interact action value, e.g. subtitle.

save_state

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "save_state"
  }
}

Expected response shape

{
  "action": "save_state",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "save_state"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. save_state.

load_state

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "load_state"
  }
}

Expected response shape

{
  "action": "load_state",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "load_state"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. load_state.

list_states

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "list_states"
  }
}

Expected response shape

{
  "action": "list_states",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "list_states"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. list_states.

delete_state

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "delete_state"
  }
}

Expected response shape

{
  "action": "delete_state",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "delete_state"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. delete_state.

set_storage

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "set_storage",
    "storage_type": "local",
    "key": "theme",
    "value": "dark"
  }
}

Expected response shape

{
  "action": "set_storage",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "set_storage"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "storage_type": "local",
    "key": "theme",
    "value": "dark"
  }
}

Fix: Use a valid interact action value, e.g. set_storage.

delete_storage

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "delete_storage",
    "storage_type": "local",
    "key": "theme"
  }
}

Expected response shape

{
  "action": "delete_storage",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "delete_storage"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "storage_type": "local",
    "key": "theme"
  }
}

Fix: Use a valid interact action value, e.g. delete_storage.

clear_storage

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "clear_storage"
  }
}

Expected response shape

{
  "action": "clear_storage",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "clear_storage"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. clear_storage.

set_cookie

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "set_cookie",
    "name": "theme",
    "value": "dark",
    "domain": "example.com"
  }
}

Expected response shape

{
  "action": "set_cookie",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "set_cookie"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "name": "theme",
    "value": "dark",
    "domain": "example.com"
  }
}

Fix: Use a valid interact action value, e.g. set_cookie.

delete_cookie

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "delete_cookie",
    "name": "theme",
    "domain": "example.com"
  }
}

Expected response shape

{
  "action": "delete_cookie",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "delete_cookie"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "name": "theme",
    "domain": "example.com"
  }
}

Fix: Use a valid interact action value, e.g. delete_cookie.

execute_js

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "execute_js",
    "script": "document.title"
  }
}

Expected response shape

{
  "action": "execute_js",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "execute_js"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "script": "document.title"
  }
}

Fix: Use a valid interact action value, e.g. execute_js.

navigate

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "navigate",
    "url": "https://example.com"
  }
}

Expected response shape

{
  "action": "navigate",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "navigate"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "navigate",
    "url": 404
  }
}

Fix: Use a fully qualified URL string, e.g. https://example.com.

refresh

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "refresh"
  }
}

Expected response shape

{
  "action": "refresh",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "refresh"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. refresh.

back

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "back"
  }
}

Expected response shape

{
  "action": "back",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "back"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. back.

forward

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "forward"
  }
}

Expected response shape

{
  "action": "forward",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "forward"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. forward.

new_tab

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "new_tab",
    "url": "https://example.com"
  }
}

Expected response shape

{
  "action": "new_tab",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "new_tab"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "new_tab",
    "url": 404
  }
}

Fix: Use a fully qualified URL string, e.g. https://example.com.

switch_tab

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "switch_tab",
    "tab_id": 123
  }
}

Expected response shape

{
  "action": "switch_tab",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "switch_tab"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "switch_tab",
    "tab_id": "123"
  }
}

Fix: Use tab_id as a number, e.g. tab_id: 123.

close_tab

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "close_tab",
    "tab_id": 123
  }
}

Expected response shape

{
  "action": "close_tab",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "close_tab"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "close_tab",
    "tab_id": "123"
  }
}

Fix: Use tab_id as a number, e.g. tab_id: 123.

screenshot

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "screenshot"
  }
}

Expected response shape

{
  "action": "screenshot",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "screenshot"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. screenshot.

click

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "click",
    "selector": "text=Submit"
  }
}

Expected response shape

{
  "action": "click",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "click"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "click",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

type

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "type",
    "selector": "label=Email",
    "text": "user@example.com"
  }
}

Expected response shape

{
  "action": "type",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "type"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "type",
    "selector": 42,
    "text": "user@example.com"
  }
}

Fix: Use selector as a CSS or semantic selector string.

select

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "select",
    "selector": "#country",
    "value": "US"
  }
}

Expected response shape

{
  "action": "select",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "select"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "select",
    "selector": 42,
    "value": "US"
  }
}

Fix: Use selector as a CSS or semantic selector string.

check

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "check",
    "selector": "#terms",
    "checked": true
  }
}

Expected response shape

{
  "action": "check",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "check"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "check",
    "selector": 42,
    "checked": true
  }
}

Fix: Use selector as a CSS or semantic selector string.

get_text

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "get_text",
    "selector": "h1"
  }
}

Expected response shape

{
  "action": "get_text",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "get_text"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "get_text",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

get_value

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "get_value",
    "selector": "input[name=\"email\"]"
  }
}

Expected response shape

{
  "action": "get_value",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "get_value"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "get_value",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

get_attribute

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "get_attribute",
    "selector": "a.primary",
    "name": "href"
  }
}

Expected response shape

{
  "action": "get_attribute",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "get_attribute"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "get_attribute",
    "selector": 42,
    "name": "href"
  }
}

Fix: Use selector as a CSS or semantic selector string.

query

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "query",
    "selector": "button",
    "query_type": "count"
  }
}

Expected response shape

{
  "action": "query",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "query"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "query",
    "selector": 42,
    "query_type": "count"
  }
}

Fix: Use selector as a CSS or semantic selector string.

set_attribute

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "set_attribute",
    "selector": "input[name=\"email\"]",
    "name": "value",
    "value": "user@example.com"
  }
}

Expected response shape

{
  "action": "set_attribute",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "set_attribute"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "set_attribute",
    "selector": 42,
    "name": "value",
    "value": "user@example.com"
  }
}

Fix: Use selector as a CSS or semantic selector string.

focus

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "focus",
    "selector": "#search"
  }
}

Expected response shape

{
  "action": "focus",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "focus"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "focus",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

scroll_to

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "scroll_to",
    "direction": "bottom"
  }
}

Expected response shape

{
  "action": "scroll_to",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "scroll_to"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "direction": "bottom"
  }
}

Fix: Use a valid interact action value, e.g. scroll_to.

wait_for

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "wait_for",
    "selector": "main"
  }
}

Expected response shape

{
  "action": "wait_for",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "wait_for"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "wait_for",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

key_press

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "key_press",
    "text": "Enter"
  }
}

Expected response shape

{
  "action": "key_press",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "key_press"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "text": "Enter"
  }
}

Fix: Use a valid interact action value, e.g. key_press.

paste

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "paste",
    "selector": "textarea",
    "text": "Pasted from automation"
  }
}

Expected response shape

{
  "action": "paste",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "paste"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "paste",
    "selector": 42,
    "text": "Pasted from automation"
  }
}

Fix: Use selector as a CSS or semantic selector string.

open_composer

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "open_composer"
  }
}

Expected response shape

{
  "action": "open_composer",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "open_composer"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. open_composer.

submit_active_composer

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "submit_active_composer"
  }
}

Expected response shape

{
  "action": "submit_active_composer",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "submit_active_composer"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. submit_active_composer.

confirm_top_dialog

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "confirm_top_dialog"
  }
}

Expected response shape

{
  "action": "confirm_top_dialog",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "confirm_top_dialog"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. confirm_top_dialog.

dismiss_top_overlay

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "dismiss_top_overlay"
  }
}

Expected response shape

{
  "action": "dismiss_top_overlay",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "dismiss_top_overlay"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. dismiss_top_overlay.

hover

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "hover",
    "selector": "text=Settings"
  }
}

Expected response shape

{
  "action": "hover",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "hover"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "hover",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

auto_dismiss_overlays

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "auto_dismiss_overlays"
  }
}

Expected response shape

{
  "action": "auto_dismiss_overlays",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "auto_dismiss_overlays"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. auto_dismiss_overlays.

wait_for_stable

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "wait_for_stable"
  }
}

Expected response shape

{
  "action": "wait_for_stable",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "wait_for_stable"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. wait_for_stable.

list_interactive

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "list_interactive"
  }
}

Expected response shape

{
  "action": "list_interactive",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "list_interactive"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. list_interactive.

get_readable

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "get_readable"
  }
}

Expected response shape

{
  "action": "get_readable",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "get_readable"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. get_readable.

get_markdown

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "get_markdown"
  }
}

Expected response shape

{
  "action": "get_markdown",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "get_markdown"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. get_markdown.

navigate_and_wait_for

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "navigate_and_wait_for",
    "url": "https://example.com",
    "wait_for": "main"
  }
}

Expected response shape

{
  "action": "navigate_and_wait_for",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "navigate_and_wait_for"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "navigate_and_wait_for",
    "url": 404,
    "wait_for": "main"
  }
}

Fix: Use a fully qualified URL string, e.g. https://example.com.

navigate_and_document

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "navigate_and_document",
    "url": "https://example.com",
    "include_screenshot": true
  }
}

Expected response shape

{
  "action": "navigate_and_document",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "navigate_and_document"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "navigate_and_document",
    "url": 404,
    "include_screenshot": true
  }
}

Fix: Use a fully qualified URL string, e.g. https://example.com.

fill_form_and_submit

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "fill_form_and_submit",
    "fields": [
      {
        "selector": "input[name=\"email\"]",
        "value": "user@example.com"
      },
      {
        "selector": "input[name=\"password\"]",
        "value": "hunter2"
      }
    ],
    "submit_selector": "button[type=\"submit\"]"
  }
}

Expected response shape

{
  "action": "fill_form_and_submit",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "fill_form_and_submit"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "fields": [
      {
        "selector": "input[name=\"email\"]",
        "value": "user@example.com"
      },
      {
        "selector": "input[name=\"password\"]",
        "value": "hunter2"
      }
    ],
    "submit_selector": "button[type=\"submit\"]"
  }
}

Fix: Use a valid interact action value, e.g. fill_form_and_submit.

fill_form

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "fill_form",
    "fields": [
      {
        "selector": "input[name=\"email\"]",
        "value": "user@example.com"
      }
    ]
  }
}

Expected response shape

{
  "action": "fill_form",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "fill_form"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "fields": [
      {
        "selector": "input[name=\"email\"]",
        "value": "user@example.com"
      }
    ]
  }
}

Fix: Use a valid interact action value, e.g. fill_form.

run_a11y_and_export_sarif

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "run_a11y_and_export_sarif",
    "save_to": ".gasoline/reports/a11y.sarif"
  }
}

Expected response shape

{
  "action": "run_a11y_and_export_sarif",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "run_a11y_and_export_sarif"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "save_to": ".gasoline/reports/a11y.sarif"
  }
}

Fix: Use a valid interact action value, e.g. run_a11y_and_export_sarif.

screen_recording_start

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "screen_recording_start"
  }
}

Expected response shape

{
  "action": "screen_recording_start",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "screen_recording_start"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. screen_recording_start.

screen_recording_stop

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "screen_recording_stop"
  }
}

Expected response shape

{
  "action": "screen_recording_stop",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "screen_recording_stop"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. screen_recording_stop.

upload

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "upload",
    "file_path": "/tmp/example.png",
    "selector": "input[type=\"file\"]"
  }
}

Expected response shape

{
  "action": "upload",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "upload"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "upload",
    "file_path": "/tmp/example.png",
    "selector": 42
  }
}

Fix: Use selector as a CSS or semantic selector string.

draw_mode_start

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "draw_mode_start",
    "annot_session": "checkout-review"
  }
}

Expected response shape

{
  "action": "draw_mode_start",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "draw_mode_start"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "annot_session": "checkout-review"
  }
}

Fix: Use a valid interact action value, e.g. draw_mode_start.

hardware_click

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "hardware_click",
    "x": 640,
    "y": 360
  }
}

Expected response shape

{
  "action": "hardware_click",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "hardware_click"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "x": 640,
    "y": 360
  }
}

Fix: Use a valid interact action value, e.g. hardware_click.

activate_tab

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "activate_tab",
    "tab_id": 123
  }
}

Expected response shape

{
  "action": "activate_tab",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "activate_tab"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "activate_tab",
    "tab_id": "123"
  }
}

Fix: Use tab_id as a number, e.g. tab_id: 123.

explore_page

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "explore_page"
  }
}

Expected response shape

{
  "action": "explore_page",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "explore_page"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. explore_page.

batch

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "batch",
    "steps": [
      {
        "what": "navigate",
        "url": "https://example.com"
      },
      {
        "what": "click",
        "selector": "text=Sign in"
      }
    ]
  }
}

Expected response shape

{
  "action": "batch",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "batch"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "batch",
    "steps": "navigate,click"
  }
}

Fix: Use steps as an array of action objects.

clipboard_read

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "clipboard_read"
  }
}

Expected response shape

{
  "action": "clipboard_read",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "clipboard_read"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid interact action value, e.g. clipboard_read.

clipboard_write

Minimal call

{
  "tool": "interact",
  "arguments": {
    "what": "clipboard_write",
    "text": "Copied by Gasoline"
  }
}

Expected response shape

{
  "action": "clipboard_write",
  "ok": true,
  "url": "https://example.com",
  "result": {
    "summary": "Action completed",
    "mode": "clipboard_write"
  }
}

Failure example and fix

{
  "tool": "interact",
  "arguments": {
    "what": "not_a_real_mode",
    "text": "Copied by Gasoline"
  }
}

Fix: Use a valid interact action value, e.g. clipboard_write.