Skip to content

Self-improving AI Employees for everyone

feat: browser node stealth config, Chrome icon, skill, and Windows fixes

trohitg01a93806bf3f
diff --git a/client/src/assets/icons/browser/chrome.svg b/client/src/assets/icons/browser/chrome.svg
new file mode 100644
index 00000000..16dda87b
--- /dev/null
+++ b/client/src/assets/icons/browser/chrome.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="64 64 896 896">
+ <path d="M928 512.3v-.3c0-229.8-186.2-416-416-416S96 282.2 96 512v.4c0 229.8 186.2 416 416 416s416-186.2 416-416v-.3.2zm-6.7-74.6l.6 3.3-.6-3.3zM676.7 638.2c53.5-82.2 52.5-189.4-11.1-263.7l162.4-8.4c20.5 44.4 32 93.8 32 145.9 0 185.2-144.6 336.6-327.1 347.4l143.8-221.2zM512 652.3c-77.5 0-140.2-62.7-140.2-140.2 0-77.7 62.7-140.2 140.2-140.2S652.2 434.5 652.2 512 589.5 652.3 512 652.3zm369.2-331.7l-3-5.7 3 5.7zM512 164c121.3 0 228.2 62.1 290.4 156.2l-263.6-13.9c-97.5-5.7-190.2 49.2-222.3 141.1L227.8 311c63.1-88.9 166.9-147 284.2-147zM102.5 585.8c26 145 127.1 264 261.6 315.1C229.6 850 128.5 731 102.5 585.8zM164 512c0-55.9 13.2-108.7 36.6-155.5l119.7 235.4c44.1 86.7 137.4 139.7 234 121.6l-74 145.1C302.9 842.5 164 693.5 164 512zm324.7 415.4c4 .2 8 .4 12 .5-4-.2-8-.3-12-.5z" fill="#8be9fd"/>
+</svg>
diff --git a/client/src/assets/icons/browser/index.ts b/client/src/assets/icons/browser/index.ts
new file mode 100644
index 00000000..5e1a5b96
--- /dev/null
+++ b/client/src/assets/icons/browser/index.ts
@@ -0,0 +1,17 @@
+// Browser automation icons
+// Chrome icon sourced from @ant-design/icons-svg (ChromeOutlined)
+
+import chromeSvg from './chrome.svg?raw';
+
+const svgToDataUri = (svg: string): string => {
+ const encoded = encodeURIComponent(svg)
+ .replace(/'/g, '%27')
+ .replace(/"/g, '%22');
+ return `data:image/svg+xml,${encoded}`;
+};
+
+export const BROWSER_ICON = svgToDataUri(chromeSvg);
+
+export const BrowserIcons = {
+ chrome: chromeSvg,
+};
diff --git a/client/src/nodeDefinitions/browserNodes.ts b/client/src/nodeDefinitions/browserNodes.ts
index 8fb8a9dc..9f1dbc8d 100644
--- a/client/src/nodeDefinitions/browserNodes.ts
+++ b/client/src/nodeDefinitions/browserNodes.ts
@@ -6,12 +6,13 @@ import {
NodeConnectionType,
} from '../types/INodeProperties';
import { dracula } from '../styles/theme';
+import { BROWSER_ICON } from '../assets/icons/browser';
export const browserNodes: Record<string, INodeTypeDescription> = {
browser: {
displayName: 'Browser',
name: 'browser',
- icon: '🌐',
+ icon: BROWSER_ICON,
group: ['browser', 'tool'],
version: 1,
subtitle: 'Agent Browser',
@@ -174,6 +175,37 @@ export const browserNodes: Record<string, INodeTypeDescription> = {
},
// ===== ADVANCED =====
+ {
+ displayName: 'Show Browser',
+ name: 'headed',
+ type: 'boolean',
+ default: true,
+ description: 'Open browser in visible (headed) mode instead of headless',
+ },
+ {
+ displayName: 'Action Delay (ms)',
+ name: 'actionDelay',
+ type: 'number',
+ default: 0,
+ typeOptions: { minValue: 0, maxValue: 10000 },
+ description: 'Delay before each action in milliseconds. Simulates human pacing. 0 = instant.',
+ },
+ {
+ displayName: 'User Agent',
+ name: 'userAgent',
+ type: 'string',
+ default: '',
+ placeholder: 'Mozilla/5.0 ...',
+ description: 'Custom user agent string. Empty = Chrome default.',
+ },
+ {
+ displayName: 'Proxy',
+ name: 'proxy',
+ type: 'string',
+ default: '',
+ placeholder: 'http://user:pass@host:port',
+ description: 'Proxy server URL for all browser requests.',
+ },
{
displayName: 'Session',
name: 'session',
diff --git a/server/config/model_registry.json b/server/config/model_registry.json
index d46ee147..8f1b844f 100644
--- a/server/config/model_registry.json
+++ b/server/config/model_registry.json
@@ -1,5 +1,5 @@
{
- "_generated": "2026-04-06T14:19:35.867475+00:00",
+ "_generated": "2026-04-07T15:49:55.878461+00:00",
"_source": "openrouter",
"_model_count": 348,
"models": {
@@ -8954,11 +8954,11 @@
"top_p"
]
},
- "inflection/inflection-3-productivity": {
- "id": "inflection/inflection-3-productivity",
- "name": "Inflection: Inflection 3 Productivity",
+ "inflection/inflection-3-pi": {
+ "id": "inflection/inflection-3-pi",
+ "name": "Inflection: Inflection 3 Pi",
"provider": "inflection",
- "local_id": "inflection-3-productivity",
+ "local_id": "inflection-3-pi",
"context_length": 8000,
"max_output_tokens": 1024,
"input_price_per_mtok": 2.5,
@@ -8977,11 +8977,11 @@
"top_p"
]
},
- "inflection/inflection-3-pi": {
- "id": "inflection/inflection-3-pi",
- "name": "Inflection: Inflection 3 Pi",
+ "inflection/inflection-3-productivity": {
+ "id": "inflection/inflection-3-productivity",
+ "name": "Inflection: Inflection 3 Productivity",
"provider": "inflection",
- "local_id": "inflection-3-pi",
+ "local_id": "inflection-3-productivity",
"context_length": 8000,
"max_output_tokens": 1024,
"input_price_per_mtok": 2.5,
@@ -9178,15 +9178,15 @@
"top_p"
]
},
- "cohere/command-r-plus-08-2024": {
- "id": "cohere/command-r-plus-08-2024",
- "name": "Cohere: Command R+ (08-2024)",
+ "cohere/command-r-08-2024": {
+ "id": "cohere/command-r-08-2024",
+ "name": "Cohere: Command R (08-2024)",
"provider": "cohere",
- "local_id": "command-r-plus-08-2024",
+ "local_id": "command-r-08-2024",
"context_length": 128000,
"max_output_tokens": 4000,
- "input_price_per_mtok": 2.5,
- "output_price_per_mtok": 10.0,
+ "input_price_per_mtok": 0.15,
+ "output_price_per_mtok": 0.6,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -9209,15 +9209,15 @@
"top_p"
]
},
- "cohere/command-r-08-2024": {
- "id": "cohere/command-r-08-2024",
- "name": "Cohere: Command R (08-2024)",
+ "cohere/command-r-plus-08-2024": {
+ "id": "cohere/command-r-plus-08-2024",
+ "name": "Cohere: Command R+ (08-2024)",
"provider": "cohere",
- "local_id": "command-r-08-2024",
+ "local_id": "command-r-plus-08-2024",
"context_length": 128000,
"max_output_tokens": 4000,
- "input_price_per_mtok": 0.15,
- "output_price_per_mtok": 0.6,
+ "input_price_per_mtok": 2.5,
+ "output_price_per_mtok": 10.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -9704,15 +9704,15 @@
"top_p"
]
},
- "openai/gpt-4o-2024-05-13": {
- "id": "openai/gpt-4o-2024-05-13",
- "name": "OpenAI: GPT-4o (2024-05-13)",
+ "openai/gpt-4o": {
+ "id": "openai/gpt-4o",
+ "name": "OpenAI: GPT-4o",
"provider": "openai",
- "local_id": "gpt-4o-2024-05-13",
+ "local_id": "gpt-4o",
"context_length": 128000,
- "max_output_tokens": 4096,
- "input_price_per_mtok": 5.0,
- "output_price_per_mtok": 15.0,
+ "max_output_tokens": 16384,
+ "input_price_per_mtok": 2.5,
+ "output_price_per_mtok": 10.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -9738,15 +9738,15 @@
"web_search_options"
]
},
- "openai/gpt-4o": {
- "id": "openai/gpt-4o",
- "name": "OpenAI: GPT-4o",
+ "openai/gpt-4o:extended": {
+ "id": "openai/gpt-4o:extended",
+ "name": "OpenAI: GPT-4o (extended)",
"provider": "openai",
- "local_id": "gpt-4o",
+ "local_id": "gpt-4o:extended",
"context_length": 128000,
- "max_output_tokens": 16384,
- "input_price_per_mtok": 2.5,
- "output_price_per_mtok": 10.0,
+ "max_output_tokens": 64000,
+ "input_price_per_mtok": 6.0,
+ "output_price_per_mtok": 18.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -9772,15 +9772,15 @@
"web_search_options"
]
},
- "openai/gpt-4o:extended": {
- "id": "openai/gpt-4o:extended",
- "name": "OpenAI: GPT-4o (extended)",
+ "openai/gpt-4o-2024-05-13": {
+ "id": "openai/gpt-4o-2024-05-13",
+ "name": "OpenAI: GPT-4o (2024-05-13)",
"provider": "openai",
- "local_id": "gpt-4o:extended",
+ "local_id": "gpt-4o-2024-05-13",
"context_length": 128000,
- "max_output_tokens": 64000,
- "input_price_per_mtok": 6.0,
- "output_price_per_mtok": 18.0,
+ "max_output_tokens": 4096,
+ "input_price_per_mtok": 5.0,
+ "output_price_per_mtok": 15.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10014,15 +10014,15 @@
"top_p"
]
},
- "openai/gpt-4-turbo-preview": {
- "id": "openai/gpt-4-turbo-preview",
- "name": "OpenAI: GPT-4 Turbo Preview",
+ "openai/gpt-3.5-turbo-0613": {
+ "id": "openai/gpt-3.5-turbo-0613",
+ "name": "OpenAI: GPT-3.5 Turbo (older v0613)",
"provider": "openai",
- "local_id": "gpt-4-turbo-preview",
- "context_length": 128000,
+ "local_id": "gpt-3.5-turbo-0613",
+ "context_length": 4095,
"max_output_tokens": 4096,
- "input_price_per_mtok": 10.0,
- "output_price_per_mtok": 30.0,
+ "input_price_per_mtok": 1.0,
+ "output_price_per_mtok": 2.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10047,15 +10047,15 @@
"top_p"
]
},
- "openai/gpt-3.5-turbo-0613": {
- "id": "openai/gpt-3.5-turbo-0613",
- "name": "OpenAI: GPT-3.5 Turbo (older v0613)",
+ "openai/gpt-4-turbo-preview": {
+ "id": "openai/gpt-4-turbo-preview",
+ "name": "OpenAI: GPT-4 Turbo Preview",
"provider": "openai",
- "local_id": "gpt-3.5-turbo-0613",
- "context_length": 4095,
+ "local_id": "gpt-4-turbo-preview",
+ "context_length": 128000,
"max_output_tokens": 4096,
- "input_price_per_mtok": 1.0,
- "output_price_per_mtok": 2.0,
+ "input_price_per_mtok": 10.0,
+ "output_price_per_mtok": 30.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10220,15 +10220,15 @@
"top_p"
]
},
- "openai/gpt-3.5-turbo-instruct": {
- "id": "openai/gpt-3.5-turbo-instruct",
- "name": "OpenAI: GPT-3.5 Turbo Instruct",
- "provider": "openai",
- "local_id": "gpt-3.5-turbo-instruct",
- "context_length": 4095,
- "max_output_tokens": 4096,
- "input_price_per_mtok": 1.5,
- "output_price_per_mtok": 2.0,
+ "mistralai/mistral-7b-instruct-v0.1": {
+ "id": "mistralai/mistral-7b-instruct-v0.1",
+ "name": "Mistral: Mistral 7B Instruct v0.1",
+ "provider": "mistralai",
+ "local_id": "mistral-7b-instruct-v0.1",
+ "context_length": 2824,
+ "max_output_tokens": 0,
+ "input_price_per_mtok": 0.11,
+ "output_price_per_mtok": 0.19,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10238,28 +10238,24 @@
"is_reasoning_model": false,
"supported_parameters": [
"frequency_penalty",
- "logit_bias",
- "logprobs",
"max_tokens",
"presence_penalty",
- "response_format",
+ "repetition_penalty",
"seed",
- "stop",
- "structured_outputs",
"temperature",
- "top_logprobs",
+ "top_k",
"top_p"
]
},
- "mistralai/mistral-7b-instruct-v0.1": {
- "id": "mistralai/mistral-7b-instruct-v0.1",
- "name": "Mistral: Mistral 7B Instruct v0.1",
- "provider": "mistralai",
- "local_id": "mistral-7b-instruct-v0.1",
- "context_length": 2824,
- "max_output_tokens": 0,
- "input_price_per_mtok": 0.11,
- "output_price_per_mtok": 0.19,
+ "openai/gpt-3.5-turbo-instruct": {
+ "id": "openai/gpt-3.5-turbo-instruct",
+ "name": "OpenAI: GPT-3.5 Turbo Instruct",
+ "provider": "openai",
+ "local_id": "gpt-3.5-turbo-instruct",
+ "context_length": 4095,
+ "max_output_tokens": 4096,
+ "input_price_per_mtok": 1.5,
+ "output_price_per_mtok": 2.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10269,12 +10265,16 @@
"is_reasoning_model": false,
"supported_parameters": [
"frequency_penalty",
+ "logit_bias",
+ "logprobs",
"max_tokens",
"presence_penalty",
- "repetition_penalty",
+ "response_format",
"seed",
+ "stop",
+ "structured_outputs",
"temperature",
- "top_k",
+ "top_logprobs",
"top_p"
]
},
@@ -10448,15 +10448,15 @@
"top_p"
]
},
- "openai/gpt-4": {
- "id": "openai/gpt-4",
- "name": "OpenAI: GPT-4",
+ "openai/gpt-3.5-turbo": {
+ "id": "openai/gpt-3.5-turbo",
+ "name": "OpenAI: GPT-3.5 Turbo",
"provider": "openai",
- "local_id": "gpt-4",
- "context_length": 8191,
+ "local_id": "gpt-3.5-turbo",
+ "context_length": 16385,
"max_output_tokens": 4096,
- "input_price_per_mtok": 30.0,
- "output_price_per_mtok": 60.0,
+ "input_price_per_mtok": 0.5,
+ "output_price_per_mtok": 1.5,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10481,15 +10481,15 @@
"top_p"
]
},
- "openai/gpt-3.5-turbo": {
- "id": "openai/gpt-3.5-turbo",
- "name": "OpenAI: GPT-3.5 Turbo",
+ "openai/gpt-4": {
+ "id": "openai/gpt-4",
+ "name": "OpenAI: GPT-4",
"provider": "openai",
- "local_id": "gpt-3.5-turbo",
- "context_length": 16385,
+ "local_id": "gpt-4",
+ "context_length": 8191,
"max_output_tokens": 4096,
- "input_price_per_mtok": 0.5,
- "output_price_per_mtok": 1.5,
+ "input_price_per_mtok": 30.0,
+ "output_price_per_mtok": 60.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
diff --git a/server/services/browser_service.py b/server/services/browser_service.py
index 47188db6..d2ad3fd0 100644
--- a/server/services/browser_service.py
+++ b/server/services/browser_service.py
@@ -7,6 +7,8 @@ The agent-browser daemon manages its own lifecycle (auto-starts, persists betwee
import asyncio
import json
import shutil
+import subprocess
+import sys
from typing import Any, Dict, List, Optional
from core.logging import get_logger
@@ -28,31 +30,31 @@ class BrowserService:
session: str,
timeout: int = 30,
stdin: Optional[bytes] = None,
+ headed: bool = False,
+ user_agent: Optional[str] = None,
+ proxy: Optional[str] = None,
) -> Dict[str, Any]:
- """Execute an agent-browser command and return parsed JSON output."""
- cmd = [self._bin, "--session", session, "--json", *args]
- logger.debug("agent-browser exec", cmd=" ".join(cmd))
-
- proc = await asyncio.create_subprocess_exec(
- *cmd,
- stdin=asyncio.subprocess.PIPE if stdin else None,
- stdout=asyncio.subprocess.PIPE,
- stderr=asyncio.subprocess.PIPE,
+ """Execute an agent-browser command and return parsed JSON output.
+
+ agent-browser outputs JSON on the first stdout line then keeps the
+ daemon process alive. We read just the first line via Popen in a
+ thread, then kill the process β€” never wait for exit.
+ """
+ parts = [self._bin, "--session", session, "--json"]
+ if headed:
+ parts.append("--headed")
+ if user_agent:
+ parts.extend(["--user-agent", user_agent])
+ if proxy:
+ parts.extend(["--proxy", proxy])
+ parts.extend(args)
+
+ logger.debug("agent-browser exec", cmd=" ".join(parts))
+
+ raw = await asyncio.to_thread(
+ self._run_sync, parts, timeout, stdin
)
- try:
- stdout, stderr = await asyncio.wait_for(
- proc.communicate(input=stdin), timeout=timeout
- )
- except asyncio.TimeoutError:
- proc.kill()
- await proc.communicate()
- raise TimeoutError(f"Timed out after {timeout}s")
- if proc.returncode != 0:
- err = stderr.decode(errors="replace").strip()
- raise RuntimeError(err or f"Exit code {proc.returncode}")
-
- raw = stdout.decode(errors="replace").strip()
if len(raw) > _MAX_OUTPUT:
raw = raw[:_MAX_OUTPUT] + "\n...(truncated)"
@@ -61,6 +63,49 @@ class BrowserService:
except json.JSONDecodeError:
return {"output": raw}
+ @staticmethod
+ def _run_sync(
+ parts: List[str],
+ timeout: int,
+ stdin_data: Optional[bytes],
+ ) -> str:
+ """Run agent-browser, read first JSON line, kill process.
+
+ agent-browser daemon keeps stdout open after printing the result.
+ communicate() would hang forever. Instead: readline() + kill().
+ On Windows, shell=True is required (.CMD wrapper).
+ """
+ is_win = sys.platform == "win32"
+ cmd = " ".join(parts) if is_win else parts
+
+ proc = subprocess.Popen(
+ cmd,
+ stdin=subprocess.PIPE if stdin_data else None,
+ stdout=subprocess.PIPE,
+ stderr=subprocess.PIPE,
+ shell=is_win,
+ )
+
+ try:
+ if stdin_data and proc.stdin:
+ proc.stdin.write(stdin_data)
+ proc.stdin.close()
+
+ # Read the first line β€” that's the JSON result.
+ # The daemon keeps the process alive after this, so
+ # we must not call communicate() or wait().
+ line = proc.stdout.readline().decode(errors="replace").strip()
+
+ if not line:
+ # No output β€” check stderr for errors
+ err = proc.stderr.read().decode(errors="replace").strip()
+ raise RuntimeError(err or "agent-browser returned empty output")
+
+ return line
+ finally:
+ proc.kill()
+ proc.wait()
+
# -- Module-level lazy singleton (NodeJSClient pattern) --
diff --git a/server/services/handlers/browser.py b/server/services/handlers/browser.py
index c784de9b..470fd696 100644
--- a/server/services/handlers/browser.py
+++ b/server/services/handlers/browser.py
@@ -22,23 +22,34 @@ async def handle_browser(
if not svc:
return _fail("agent-browser not installed. Run: npm install -g agent-browser && agent-browser install", t0)
- op = parameters.get("operation", "navigate")
+ op = parameters.get("operation") or "navigate"
session = (
- parameters.get("session", "").strip()
+ (parameters.get("session") or "").strip()
or f"machina_{context.get('execution_id', 'default')}"
)
- timeout = int(parameters.get("timeout", 30))
+ timeout = int(parameters.get("timeout") or 30)
+ headed = bool(parameters.get("headed", True))
+ user_agent = (parameters.get("userAgent") or "").strip() or None
+ proxy = (parameters.get("proxy") or "").strip() or None
+ action_delay = int(parameters.get("actionDelay") or 0)
+
+ run_kw = dict(headed=headed, user_agent=user_agent, proxy=proxy)
try:
+ # Native pacing via agent-browser's wait command
+ if action_delay > 0:
+ await svc.run(["wait", str(action_delay)], session, timeout, **run_kw)
+
if op == "batch":
cmds = json.loads(parameters.get("commands", "[]"))
data = await svc.run(
["batch", "--json"], session, timeout,
stdin=json.dumps(cmds).encode(),
+ **run_kw,
)
else:
args = _build_args(op, parameters)
- data = await svc.run(args, session, timeout)
+ data = await svc.run(args, session, timeout, **run_kw)
return {
"success": True,
@@ -51,16 +62,16 @@ async def handle_browser(
def _build_args(op: str, p: Dict[str, Any]) -> list:
"""Map an operation name + parameters to agent-browser CLI arguments."""
- s = p.get("selector", "").strip()
+ s = (p.get("selector") or "").strip()
match op:
case "navigate":
return ["open", _req(p, "url")]
case "click":
return ["click", _req_sel(s)]
case "type":
- return ["type", _req_sel(s), p.get("text", "")]
+ return ["type", _req_sel(s), p.get("text") or ""]
case "fill":
- return ["fill", _req_sel(s), p.get("value", "")]
+ return ["fill", _req_sel(s), p.get("value") or ""]
case "screenshot":
return ["screenshot"] + (["--full"] if p.get("fullPage") else [])
case "snapshot":
@@ -74,15 +85,15 @@ def _build_args(op: str, p: Dict[str, Any]) -> list:
case "wait":
return ["wait", _req_sel(s)]
case "scroll":
- return ["scroll", p.get("direction", "down"), str(p.get("amount", 500))]
+ return ["scroll", p.get("direction") or "down", str(p.get("amount") or 500)]
case "select":
- return ["select", _req_sel(s), p.get("value", "")]
+ return ["select", _req_sel(s), p.get("value") or ""]
case _:
raise ValueError(f"Unknown operation: {op}")
def _req(p: Dict[str, Any], key: str) -> str:
- v = p.get(key, "").strip()
+ v = (p.get(key) or "").strip()
if not v:
raise ValueError(f"{key} is required")
return v
diff --git a/server/skills/web_agent/browser-skill/SKILL.md b/server/skills/web_agent/browser-skill/SKILL.md
new file mode 100644
index 00000000..aca7ffd1
--- /dev/null
+++ b/server/skills/web_agent/browser-skill/SKILL.md
@@ -0,0 +1,131 @@
+---
+name: browser-skill
+description: Interactive browser automation - navigate, click, type, fill forms, take screenshots, get accessibility snapshots.
+allowed-tools: browser
+metadata:
+ author: machina
+ version: "1.0"
+ category: web
+ icon: "🌐"
+ color: "#8be9fd"
+---
+
+# Browser Automation Skill
+
+## Core Workflow
+
+Use the **snapshot -> act -> snapshot** loop:
+
+1. `navigate` to a URL
+2. `snapshot` to see interactive elements (returns `@eN` refs)
+3. `click` / `type` / `fill` / `select` using `@eN` refs as selectors
+4. `snapshot` again to see the result
+5. Repeat until task is complete
+
+## browser Tool
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| operation | string | Yes | One of: navigate, click, type, fill, screenshot, snapshot, get_text, get_html, eval, wait, scroll, select |
+| url | string | navigate | URL to open |
+| selector | string | click/type/fill/get_text/get_html/wait/select | CSS selector or `@eN` ref from snapshot |
+| text | string | type | Text to type keystroke by keystroke |
+| value | string | fill/select | Value to fill or dropdown option to select |
+| expression | string | eval | JavaScript to execute in page context |
+| direction | string | scroll | up, down, left, right (default: down) |
+| amount | int | scroll | Pixels to scroll (default: 500) |
+| fullPage | bool | screenshot | Capture full scrollable page (default: false) |
+
+## Operations
+
+### navigate
+Open a URL in the browser.
+```json
+{"operation": "navigate", "url": "https://example.com"}
+```
+
+### snapshot
+Get the accessibility tree with `@eN` element refs. This is the primary way to see what is on the page.
+```json
+{"operation": "snapshot"}
+```
+Returns interactive elements like:
+```
+- heading "Example Domain" [ref=@e1]
+- link "More information..." [ref=@e2]
+- textbox "Search" [ref=@e3]
+```
+
+### click
+Click an element using its `@eN` ref or CSS selector.
+```json
+{"operation": "click", "selector": "@e2"}
+```
+
+### type
+Type text into an element keystroke by keystroke.
+```json
+{"operation": "type", "selector": "@e3", "text": "search query"}
+```
+
+### fill
+Clear an input field and fill it with a value.
+```json
+{"operation": "fill", "selector": "@e3", "value": "new value"}
+```
+
+### screenshot
+Take a screenshot of the current page.
+```json
+{"operation": "screenshot", "fullPage": true}
+```
+
+### get_text
+Extract text content from an element.
+```json
+{"operation": "get_text", "selector": "@e1"}
+```
+
+### eval
+Execute JavaScript in the page context.
+```json
+{"operation": "eval", "expression": "document.title"}
+```
+
+### wait
+Wait for an element to appear on the page.
+```json
+{"operation": "wait", "selector": "#results"}
+```
+
+### scroll
+Scroll the page.
+```json
+{"operation": "scroll", "direction": "down", "amount": 500}
+```
+
+### select
+Select a dropdown option.
+```json
+{"operation": "select", "selector": "@e5", "value": "option-value"}
+```
+
+## Stealth / Anti-Detection
+
+The browser node supports configurable settings to reduce bot detection:
+
+- **Action Delay**: Set `actionDelay` (ms) in node parameters to add a native wait before each action. Simulates human pacing.
+- **User Agent**: Set `userAgent` to a custom string to override the default Chrome user agent.
+- **Proxy**: Set `proxy` to route all browser traffic through a proxy (e.g. `http://user:pass@host:port`).
+
+These are configured in the node's Advanced section, not as tool arguments.
+
+## Tips
+
+- Always use `snapshot` first to discover element refs before interacting.
+- Prefer `@eN` refs over CSS selectors -- they are stable across the session.
+- Use `fill` for form inputs (clears first), `type` for search boxes (keystroke events).
+- Use `screenshot` to visually verify the page state when uncertain.
+- Use `wait` before interacting with elements that load dynamically.
+- Use `eval` sparingly -- prefer snapshot + click/fill for most tasks.
+- Set `actionDelay` to 500-2000ms when interacting with bot-protected sites.