claude-comms 1.0.46 → 2.0.1

package/.agents/tools/chrome-devtools/browsertools.py

@@ -1,839 +0,0 @@
-#!/usr/bin/env -S uv run --quiet --script
-# /// script
-# requires-python = ">=3.11"
-# dependencies = [
-#     "mcp>=1.1.2",
-# ]
-# ///
-"""
-Chrome DevTools MCP wrapper - persistent daemon with Unix socket bridge.
-
-Architecture:
-- Daemon spawns chrome-devtools-mcp once, keeps it running
-- Daemon listens on Unix socket for client commands
-- Multiple CLI invocations connect via socket, share same MCP session
-- State (snapshots, tabs, etc.) persists across all commands
-"""
-
-import asyncio
-import argparse
-import json
-import os
-import signal
-import sys
-import time
-import uuid
-from pathlib import Path
-from typing import Any, Dict, Optional
-
-# State directory
-STATE_DIR = Path.home() / ".browsertools"
-CONFIG_FILE = STATE_DIR / "config.json"
-INACTIVITY_TIMEOUT = 600  # 10 minutes
-
-# Global daemon state
-mcp_proc = None
-mcp_reader = None
-mcp_writer = None
-pending_requests = {}  # msg_id -> response_future
-last_activity_time = time.time()
-current_instance_id = None
-
-
-def generate_instance_id() -> str:
-    """Generate 8-char hex instance ID."""
-    return uuid.uuid4().hex[:8]
-
-
-def get_socket_path(instance_id: str) -> Path:
-    """Get socket path for instance."""
-    return STATE_DIR / f"daemon-{instance_id}.sock"
-
-
-def get_pid_file(instance_id: str) -> Path:
-    """Get PID file path for instance."""
-    return STATE_DIR / f"daemon-{instance_id}.pid"
-
-
-def ensure_state_dir():
-    """Create state directory."""
-    STATE_DIR.mkdir(exist_ok=True)
-
-
-def get_daemon_pid(instance_id: str) -> Optional[int]:
-    """Get PID of running daemon for instance."""
-    pid_file = get_pid_file(instance_id)
-    if not pid_file.exists():
-        return None
-    try:
-        pid = int(pid_file.read_text().strip())
-        os.kill(pid, 0)  # Check if alive
-        return pid
-    except (ProcessLookupError, ValueError):
-        pid_file.unlink(missing_ok=True)
-        return None
-
-
-def is_daemon_running(instance_id: str) -> bool:
-    """Check if daemon is running for instance."""
-    return get_daemon_pid(instance_id) is not None and get_socket_path(instance_id).exists()
-
-
-def get_all_instances() -> list[str]:
-    """Get list of all running instance IDs."""
-    instances = []
-    if not STATE_DIR.exists():
-        return instances
-    for pid_file in STATE_DIR.glob("daemon-*.pid"):
-        instance_id = pid_file.stem.replace("daemon-", "")
-        if is_daemon_running(instance_id):
-            instances.append(instance_id)
-        else:
-            # Clean up stale files
-            pid_file.unlink(missing_ok=True)
-            get_socket_path(instance_id).unlink(missing_ok=True)
-    return instances
-
-
-def load_config() -> Dict[str, Any]:
-    """Load config file or return defaults."""
-    # Try user config first
-    if CONFIG_FILE.exists():
-        try:
-            with open(CONFIG_FILE) as f:
-                return json.load(f)
-        except Exception as e:
-            print(f"Warning: Failed to load user config: {e}", file=sys.stderr)
-
-    # Try repo default config
-    repo_config = Path(__file__).parent / "config.json"
-    if repo_config.exists():
-        try:
-            with open(repo_config) as f:
-                return json.load(f)
-        except Exception as e:
-            print(f"Warning: Failed to load repo config: {e}", file=sys.stderr)
-
-    # Fallback to hardcoded defaults
-    return {
-        "mcp_command": "npx",
-        "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated", "--headless=true"]
-    }
-
-
-def save_default_config():
-    """Save default config file."""
-    ensure_state_dir()
-    config = {
-        "mcp_command": "npx",
-        "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated"],
-        "_comment": "Customize MCP server startup. Examples:",
-        "_example_headless": {
-            "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated", "--headless=true"]
-        },
-        "_example_custom_chrome": {
-            "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated", "--executablePath=/usr/local/bin/chromium-mcp"]
-        },
-        "_example_sandbox": {
-            "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated=true", "--headless=true", "--executablePath=/usr/local/bin/chromium-mcp"]
-        }
-    }
-    with open(CONFIG_FILE, "w") as f:
-        json.dump(config, f, indent=2)
-    print(f"Created config file: {CONFIG_FILE}", file=sys.stderr)
-
-
-# ============================================================================
-# DAEMON MODE - Bridge between Unix socket and MCP stdio
-# ============================================================================
-
-async def read_mcp_responses():
-    """Read responses from MCP stdout and route to clients."""
-    global mcp_reader, pending_requests
-
-    while True:
-        try:
-            # Read line with increased limit for large snapshots
-            line = await mcp_reader.readline()
-            if not line:
-                print("MCP server closed stdout", file=sys.stderr)
-                break
-
-            try:
-                resp = json.loads(line.decode())
-                msg_id = resp.get("id")
-
-                # Route response to waiting client
-                if msg_id and msg_id in pending_requests:
-                    future = pending_requests.pop(msg_id)
-                    future.set_result(resp)
-            except json.JSONDecodeError as e:
-                print(f"Invalid JSON from MCP: {e}", file=sys.stderr)
-                print(f"Line length: {len(line)}", file=sys.stderr)
-
-        except Exception as e:
-            print(f"Error reading MCP: {e}", file=sys.stderr)
-            # Don't break on limit errors, just log and continue
-            if "longer than limit" not in str(e):
-                break
-
-
-async def handle_client(reader: asyncio.StreamReader, writer: asyncio.StreamWriter):
-    """Handle a client connection."""
-    global mcp_writer, pending_requests, last_activity_time
-
-    # Update activity timestamp
-    last_activity_time = time.time()
-
-    try:
-        while True:
-            # Read request from client
-            line = await reader.readline()
-            if not line:
-                break
-
-            try:
-                req = json.loads(line.decode())
-                msg_id = req.get("id")
-
-                # Create future for response
-                response_future = asyncio.Future()
-                pending_requests[msg_id] = response_future
-
-                # Forward to MCP server
-                mcp_writer.write(line)
-                await mcp_writer.drain()
-
-                # Wait for response
-                try:
-                    resp = await asyncio.wait_for(response_future, timeout=30.0)
-                    writer.write(json.dumps(resp).encode() + b'\n')
-                    await writer.drain()
-                except asyncio.TimeoutError:
-                    writer.write(json.dumps({
-                        "jsonrpc": "2.0",
-                        "id": msg_id,
-                        "error": {"code": -1, "message": "Timeout waiting for MCP response"}
-                    }).encode() + b'\n')
-                    await writer.drain()
-                    pending_requests.pop(msg_id, None)
-
-            except json.JSONDecodeError:
-                print(f"Invalid JSON from client: {line}", file=sys.stderr)
-
-    except Exception as e:
-        print(f"Client handler error: {e}", file=sys.stderr)
-    finally:
-        writer.close()
-
-
-async def shutdown_mcp():
-    """Properly shutdown MCP server and all Chrome child processes."""
-    global mcp_proc
-
-    if not mcp_proc:
-        return
-
-    print("Shutting down MCP server and Chrome...", file=sys.stderr)
-
-    try:
-        # Get process group ID
-        pgid = os.getpgid(mcp_proc.pid)
-
-        # Send SIGTERM to entire process group (kills Chrome and all children)
-        os.killpg(pgid, signal.SIGTERM)
-
-        # Wait for graceful shutdown
-        try:
-            await asyncio.wait_for(mcp_proc.wait(), timeout=5.0)
-            print("MCP server stopped gracefully", file=sys.stderr)
-        except asyncio.TimeoutError:
-            # Force kill if still running
-            print("Force killing MCP server...", file=sys.stderr)
-            os.killpg(pgid, signal.SIGKILL)
-            await mcp_proc.wait()
-
-    except ProcessLookupError:
-        # Already dead
-        pass
-    except Exception as e:
-        print(f"Error during shutdown: {e}", file=sys.stderr)
-
-
-async def inactivity_monitor(shutdown_callback):
-    """Monitor for inactivity and trigger shutdown after timeout."""
-    global last_activity_time
-
-    while True:
-        await asyncio.sleep(10)  # Check every 10 seconds for responsive timeout
-        inactive_time = time.time() - last_activity_time
-        if inactive_time > INACTIVITY_TIMEOUT:
-            await shutdown_callback()
-            return
-
-
-async def run_daemon(instance_id: str):
-    """Run the persistent daemon."""
-    global mcp_proc, mcp_reader, mcp_writer, current_instance_id, last_activity_time
-
-    current_instance_id = instance_id
-    last_activity_time = time.time()
-    ensure_state_dir()
-
-    socket_path = get_socket_path(instance_id)
-    pid_file = get_pid_file(instance_id)
-
-    # Clean up old socket if exists
-    if socket_path.exists():
-        socket_path.unlink()
-
-    # Load config
-    config = load_config()
-    mcp_command = config.get("mcp_command", "npx")
-    mcp_args = config.get("mcp_args", ["-y", "chrome-devtools-mcp@latest", "--isolated"])
-
-    print(f"Starting chrome-devtools-mcp...", file=sys.stderr)
-    print(f"Command: {mcp_command} {' '.join(mcp_args)}", file=sys.stderr)
-
-    # Start MCP server as subprocess in new process group
-    # This ensures we can kill Chrome and all its children together
-    mcp_proc = await asyncio.create_subprocess_exec(
-        mcp_command, *mcp_args,
-        stdin=asyncio.subprocess.PIPE,
-        stdout=asyncio.subprocess.PIPE,
-        stderr=sys.stderr,
-        start_new_session=True,  # Creates new process group
-        limit=1024 * 1024 * 10,  # 10MB limit for large snapshots
-    )
-
-    mcp_reader = mcp_proc.stdout
-    mcp_writer = mcp_proc.stdin
-
-    # Write PID file
-    pid_file.write_text(str(os.getpid()))
-
-    print(f"Starting Unix socket server at {socket_path}...", file=sys.stderr)
-
-    # Start Unix socket server
-    server = await asyncio.start_unix_server(
-        handle_client,
-        path=str(socket_path)
-    )
-
-    print(f"Daemon ready. Instance: {instance_id} PID: {os.getpid()}", file=sys.stderr)
-
-    # Output instance ID to stdout for capture (all other output goes to stderr)
-    print(instance_id)
-
-    # Setup signal handlers for graceful shutdown
-    loop = asyncio.get_event_loop()
-    shutdown_triggered = asyncio.Event()
-
-    async def handle_shutdown(sig=None):
-        if shutdown_triggered.is_set():
-            return
-        shutdown_triggered.set()
-        if sig:
-            print(f"\nReceived {sig.name}, shutting down...", file=sys.stderr)
-        await shutdown_mcp()
-        server.close()
-        await server.wait_closed()
-        socket_path.unlink(missing_ok=True)
-        pid_file.unlink(missing_ok=True)
-        # Exit cleanly instead of stopping loop (avoids RuntimeError)
-        os._exit(0)
-
-    for sig in (signal.SIGTERM, signal.SIGINT):
-        loop.add_signal_handler(
-            sig,
-            lambda s=sig: asyncio.create_task(handle_shutdown(s))
-        )
-
-    # Run socket server, MCP response reader, and inactivity monitor
-    try:
-        await asyncio.gather(
-            server.serve_forever(),
-            read_mcp_responses(),
-            inactivity_monitor(handle_shutdown),
-        )
-    except KeyboardInterrupt:
-        print("\nShutting down daemon...", file=sys.stderr)
-    finally:
-        # Cleanup
-        if not shutdown_triggered.is_set():
-            await shutdown_mcp()
-            server.close()
-            await server.wait_closed()
-            socket_path.unlink(missing_ok=True)
-            pid_file.unlink(missing_ok=True)
-
-
-# ============================================================================
-# CLIENT MODE - Connect to daemon and send commands
-# ============================================================================
-
-async def send_command(instance_id: str, tool_name: str, args: Dict[str, Any]) -> Any:
-    """Send a command to the daemon via socket."""
-    if not is_daemon_running(instance_id):
-        raise RuntimeError(f"Daemon instance '{instance_id}' not running. Start with: browsertools.py daemon start")
-
-    socket_path = get_socket_path(instance_id)
-
-    # Connect to daemon's Unix socket with increased limit for large responses
-    reader, writer = await asyncio.open_unix_connection(
-        str(socket_path),
-        limit=1024 * 1024 * 10  # 10MB limit for large snapshots
-    )
-
-    try:
-        # Create JSON-RPC request
-        msg_id = os.urandom(8).hex()
-        request = {
-            "jsonrpc": "2.0",
-            "method": "tools/call",
-            "params": {
-                "name": tool_name,
-                "arguments": args
-            },
-            "id": msg_id
-        }
-
-        # Send request
-        writer.write(json.dumps(request).encode() + b'\n')
-        await writer.drain()
-
-        # Read response
-        line = await reader.readline()
-        response = json.loads(line.decode())
-
-        if "error" in response:
-            raise RuntimeError(f"MCP error: {response['error']}")
-
-        return response.get("result")
-
-    finally:
-        writer.close()
-        await writer.wait_closed()
-
-
-def clean_output(result: Any) -> str:
-    """Extract clean text from MCP result."""
-    if isinstance(result, dict):
-        if "content" in result:
-            content = result["content"]
-            if isinstance(content, list):
-                texts = []
-                for item in content:
-                    if isinstance(item, dict):
-                        if "text" in item:
-                            texts.append(item["text"])
-                        elif item.get("type") == "image" and "data" in item:
-                            # Return base64 image data
-                            mime = item.get("mimeType", "image/png")
-                            b64_data = item["data"]
-                            texts.append(f"\n## Base64 Image ({mime})")
-                            texts.append(b64_data)
-
-                return "\n".join(texts) if texts else str(content)
-        elif "text" in result:
-            return result["text"]
-    return str(result)
-
-
-async def execute_command(instance_id: str, cmd: str, cmd_args: Dict[str, Any]):
-    """Execute a single command via daemon."""
-
-    # Map commands to MCP tools
-    tool_name = None
-    tool_args = {}
-
-    if cmd == "nav":
-        tool_name = "navigate_page"
-        tool_args = {"url": cmd_args["url"]}
-        if "timeout" in cmd_args:
-            tool_args["timeout"] = cmd_args["timeout"]
-    elif cmd == "snap":
-        tool_name = "take_snapshot"
-    elif cmd == "click":
-        tool_name = "click"
-        tool_args = {"uid": cmd_args["uid"]}
-    elif cmd == "fill":
-        tool_name = "fill"
-        tool_args = {"uid": cmd_args["uid"], "value": cmd_args["value"]}
-    elif cmd == "shot":
-        tool_name = "take_screenshot"
-        if "path" in cmd_args:
-            tool_args["filePath"] = cmd_args["path"]
-    elif cmd == "wait":
-        tool_name = "wait_for"
-        tool_args = {"text": cmd_args["text"]}
-        if "timeout" in cmd_args:
-            tool_args["timeout"] = cmd_args["timeout"]
-    elif cmd == "eval":
-        tool_name = "evaluate_script"
-        tool_args = {"function": cmd_args["function"]}
-        if "args" in cmd_args:
-            tool_args["args"] = cmd_args["args"]
-    elif cmd == "key":
-        tool_name = "press_key"
-        tool_args = {"key": cmd_args["key"]}
-    elif cmd == "hover":
-        tool_name = "hover"
-        tool_args = {"uid": cmd_args["uid"]}
-    elif cmd == "netlist":
-        tool_name = "list_network_requests"
-        if "resource_types" in cmd_args:
-            tool_args["resourceTypes"] = cmd_args["resource_types"]
-        if "page_size" in cmd_args:
-            tool_args["pageSize"] = cmd_args["page_size"]
-    elif cmd == "netget":
-        tool_name = "get_network_request"
-        if "reqid" in cmd_args:
-            tool_args["reqid"] = cmd_args["reqid"]
-    elif cmd == "conslist":
-        tool_name = "list_console_messages"
-        if "types" in cmd_args:
-            tool_args["types"] = cmd_args["types"]
-        if "page_size" in cmd_args:
-            tool_args["pageSize"] = cmd_args["page_size"]
-    elif cmd == "consget":
-        tool_name = "get_console_message"
-        tool_args = {"msgid": cmd_args["msgid"]}
-    elif cmd == "resize":
-        tool_name = "resize_page"
-        tool_args = {"width": cmd_args["width"], "height": cmd_args["height"]}
-    elif cmd == "dialog":
-        tool_name = "handle_dialog"
-        tool_args = {"action": cmd_args["action"]}
-        if "prompt_text" in cmd_args:
-            tool_args["promptText"] = cmd_args["prompt_text"]
-    elif cmd == "upload":
-        tool_name = "upload_file"
-        tool_args = {"uid": cmd_args["uid"], "filePath": cmd_args["file_path"]}
-    elif cmd == "drag":
-        tool_name = "drag"
-        tool_args = {"from_uid": cmd_args["from_uid"], "to_uid": cmd_args["to_uid"]}
-    elif cmd == "fillform":
-        tool_name = "fill_form"
-        tool_args = {"elements": cmd_args["elements"]}
-    else:
-        raise ValueError(f"Unknown command: {cmd}")
-
-    # Send to daemon
-    result = await send_command(instance_id, tool_name, tool_args)
-    return clean_output(result)
-
-
-# ============================================================================
-# CLI INTERFACE
-# ============================================================================
-
-async def main():
-    parser = argparse.ArgumentParser(
-        prog="browsertools.py",
-        description="Chrome DevTools MCP wrapper - multi-instance daemon mode",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog=r"""
-browsertools.py - Chrome DevTools automation tool
-
-Usage: uv run .agents/tools/chrome-devtools/browsertools.py <command>
-
-DAEMON MANAGEMENT:
-  daemon start          Start new daemon instance
-                        Returns: "browsertools daemon started. Instance ID: <id>"
-  daemon stop <id>      Stop daemon. kill chrome cleanly.
-  daemon config         Create config file
-
-ALL OTHER COMMANDS REQUIRE --instance <id>:
-  --instance <id>       Required for all browser commands
-
-NAVIGATION:
-  nav <url>             Navigate to URL
-    --timeout <ms>      Max wait time in milliseconds
-  wait <text>           Wait for text to appear
-    --timeout <ms>      Max wait time in milliseconds
-
-INSPECTION:
-  snap                  Take a11y tree snapshot (get element UIDs)
-                        IMPORTANT: Always use latest snapshot for UIDs
-  shot [path]           Screenshot viewport (optional: save to path)
-  eval <js>             Execute JavaScript, returns JSON
-    --args <json>       JSON array of element references (advanced)
-
-INTERACTION:
-  click <uid>           Click element by UID from snapshot
-  fill <uid> <value>    Fill input/textarea or select option
-  key <key>             Press key or combo (e.g., "Enter", "Tab", "Control+A")
-  hover <uid>           Hover over element
-  drag <from> <to>      Drag element from UID to target UID
-  fillform <json>       Fill multiple form fields
-
-DEBUGGING:
-  conslist              List console messages (--types, --size)
-  consget <msgid>       Get console message details
-  netlist               List network requests (--types, --size)
-  netget [reqid]        Get request details
-
-PAGE MANIPULATION:
-  resize <w> <h>        Resize viewport
-  dialog <action>       Handle alert/confirm/prompt (accept|dismiss)
-  upload <uid> <path>   Upload file
-
-USAGE TIPS:
-**Snapshots** are verbose. Always try to pipe grep first
-    - Default pattern: snap | grep -iC5 "search term"
-    - **Interaction commands** return updated page state snapshots: click, fill, key, hover, drag, wait return updated page state
-        - Pipe to grep with context. eg. click 1_7 | grep -iC5 "dashboard\|home"
-    - No grep hits? Run explicit snap to see full page
-
-Limit output for **debugging** commands
-    - Network: netlist --size 10 --types fetch
-    - Console: conslist --size 5 --types error
-
-EXAMPLES:
-  # Start daemon (backgrounds automatically, prints instance ID)
-  uv run .agents/tools/chrome-devtools/browsertools.py daemon start
-  # Output: browsertools daemon started. Instance ID: a3f7b2c1
-
-  # Use instance for all commands
-  uv run .agents/tools/chrome-devtools/browsertools.py --instance a3f7b2c1 nav http://app.com/login
-  uv run .agents/tools/chrome-devtools/browsertools.py --instance a3f7b2c1 snap | grep -iC5 "email\|username\|login"
-  uv run .agents/tools/chrome-devtools/browsertools.py --instance a3f7b2c1 fill 1_23 user@example.com
-  uv run .agents/tools/chrome-devtools/browsertools.py --instance a3f7b2c1 snap | grep -iC5 "button.*(submit|login|sign.?in)"
-  uv run .agents/tools/chrome-devtools/browsertools.py --instance a3f7b2c1 click 1_25 | grep -iC5 "dashboard\|home\|welcome"
-
-  # Stop when finished to clean up resources
-  uv run .agents/tools/chrome-devtools/browsertools.py daemon stop a3f7b2c1
-        """
-    )
-
-    # Global --instance argument
-    parser.add_argument("--instance", "-i", help="Daemon instance ID (required for browser commands)")
-
-    subparsers = parser.add_subparsers(dest="cmd", required=True)
-
-    # Daemon management
-    daemon = subparsers.add_parser("daemon", help="Manage daemon")
-    daemon_sub = daemon.add_subparsers(dest="daemon_cmd", required=True)
-    daemon_sub.add_parser("start", help="Start new daemon instance (returns instance ID)")
-    stop_parser = daemon_sub.add_parser("stop", help="Stop daemon instance")
-    stop_parser.add_argument("instance_id", nargs="?", help="Instance ID to stop")
-    stop_parser.add_argument("--all", dest="stop_all", action="store_true", help=argparse.SUPPRESS)  # Hidden
-    daemon_sub.add_parser("config", help="Create default config file")
-
-    # Browser commands
-    nav = subparsers.add_parser("nav", help="Navigate to URL")
-    nav.add_argument("url", help="URL to navigate to")
-    nav.add_argument("--timeout", type=int, help="Max wait time in milliseconds")
-
-    subparsers.add_parser("snap", help="Take page snapshot")
-
-    shot = subparsers.add_parser("shot", help="Take screenshot")
-    shot.add_argument("path", nargs="?", help="Save path (optional)")
-
-    click = subparsers.add_parser("click", help="Click element")
-    click.add_argument("uid", help="Element UID from snapshot")
-
-    fill = subparsers.add_parser("fill", help="Fill input")
-    fill.add_argument("uid", help="Element UID")
-    fill.add_argument("value", help="Value to fill")
-
-    wait = subparsers.add_parser("wait", help="Wait for text")
-    wait.add_argument("text", help="Text to wait for")
-    wait.add_argument("--timeout", type=int, help="Max wait time in milliseconds")
-
-    eval_parser = subparsers.add_parser("eval", help="Execute JavaScript")
-    eval_parser.add_argument("function", help="JS function to execute")
-    eval_parser.add_argument("--args", help="JSON array of element UIDs to pass as arguments")
-
-    # Keyboard & mouse
-    key = subparsers.add_parser("key", help="Press keyboard key")
-    key.add_argument("key", help="Key to press (e.g., 'Enter', 'Tab', 'Escape')")
-
-    hover_parser = subparsers.add_parser("hover", help="Hover over element")
-    hover_parser.add_argument("uid", help="Element UID from snapshot")
-
-    # Network debugging
-    netlist = subparsers.add_parser("netlist", help="List network requests")
-    netlist.add_argument("--types", nargs="+", help="Filter by resource types")
-    netlist.add_argument("--size", type=int, help="Max requests to return")
-
-    netget = subparsers.add_parser("netget", help="Get network request details")
-    netget.add_argument("reqid", nargs="?", type=int, help="Request ID (omit for latest)")
-
-    # Console debugging
-    conslist = subparsers.add_parser("conslist", help="List console messages")
-    conslist.add_argument("--types", nargs="+", help="Filter by types (log, error, warn)")
-    conslist.add_argument("--size", type=int, help="Max messages to return")
-
-    consget = subparsers.add_parser("consget", help="Get console message details")
-    consget.add_argument("msgid", type=int, help="Message ID")
-
-    # Page manipulation
-    resize = subparsers.add_parser("resize", help="Resize page viewport")
-    resize.add_argument("width", type=int, help="Width in pixels")
-    resize.add_argument("height", type=int, help="Height in pixels")
-
-    dialog = subparsers.add_parser("dialog", help="Handle browser dialog (alert/confirm/prompt)")
-    dialog.add_argument("action", choices=["accept", "dismiss"], help="Accept or dismiss dialog")
-    dialog.add_argument("--text", dest="prompt_text", help="Text for prompt dialog")
-
-    upload = subparsers.add_parser("upload", help="Upload file through element")
-    upload.add_argument("uid", help="File input element UID")
-    upload.add_argument("file_path", help="Local file path to upload")
-
-    # Advanced interaction
-    drag_parser = subparsers.add_parser("drag", help="Drag element to target")
-    drag_parser.add_argument("from_uid", help="Source element UID")
-    drag_parser.add_argument("to_uid", help="Target element UID")
-
-    fillform_parser = subparsers.add_parser("fillform", help="Fill multiple form fields")
-    fillform_parser.add_argument("elements", help="JSON array: [{'uid':'1_1','value':'text'}]")
-
-    args = parser.parse_args()
-
-    # Handle daemon commands
-    if args.cmd == "daemon":
-        if args.daemon_cmd == "start":
-            # Generate new instance ID
-            instance_id = generate_instance_id()
-
-            # Fork to background
-            pid = os.fork()
-
-            if pid > 0:
-                # Parent process - print result and exit
-                # Give child a moment to start
-                time.sleep(0.5)
-                print(f"browsertools daemon started. Instance ID: {instance_id}")
-                return  # Exit from async main, let asyncio.run() clean up
-            else:
-                # Child process - detach and run daemon
-                os.setsid()  # Create new session, detach from terminal
-
-                # Redirect stdin/stdout/stderr to /dev/null (daemon runs silently)
-                devnull_r = os.open(os.devnull, os.O_RDONLY)
-                devnull_w = os.open(os.devnull, os.O_WRONLY)
-                os.dup2(devnull_r, sys.stdin.fileno())
-                os.dup2(devnull_w, sys.stdout.fileno())
-                os.dup2(devnull_w, sys.stderr.fileno())
-                os.close(devnull_r)
-                os.close(devnull_w)
-
-                # Create fresh event loop for child (parent's loop is unusable after fork)
-                asyncio.set_event_loop(asyncio.new_event_loop())
-
-                # Run the daemon in the new event loop (this blocks until shutdown)
-                asyncio.run(run_daemon(instance_id))
-                os._exit(0)
-
-        elif args.daemon_cmd == "stop":
-            if args.stop_all:
-                # Hidden --all flag: stop all running instances
-                instances = get_all_instances()
-                if not instances:
-                    print("No running instances", file=sys.stderr)
-                    sys.exit(1)
-                for inst_id in instances:
-                    pid = get_daemon_pid(inst_id)
-                    if pid:
-                        os.kill(pid, signal.SIGTERM)
-                        print(f"Stopped instance {inst_id} (PID {pid})", file=sys.stderr)
-            elif args.instance_id:
-                # Stop specific instance
-                pid = get_daemon_pid(args.instance_id)
-                if not pid:
-                    print(f"Instance '{args.instance_id}' not running", file=sys.stderr)
-                    sys.exit(1)
-                os.kill(pid, signal.SIGTERM)
-                print(f"Stopped instance {args.instance_id} (PID {pid})", file=sys.stderr)
-            else:
-                print("Error: instance_id required. Usage: daemon stop <instance_id>", file=sys.stderr)
-                sys.exit(1)
-
-        elif args.daemon_cmd == "config":
-            save_default_config()
-            print(f"\nEdit {CONFIG_FILE} to customize MCP server settings.", file=sys.stderr)
-            print("\nExamples:", file=sys.stderr)
-            print("  Headless mode: --headless=true", file=sys.stderr)
-            print("  Custom Chrome: --executablePath=/path/to/chrome", file=sys.stderr)
-
-        return
-
-    # Execute browser command - requires --instance
-    if not args.instance:
-        print("Error: --instance <id> is required for browser commands", file=sys.stderr)
-        print("Start a daemon first: uv run browsertools.py daemon start", file=sys.stderr)
-        sys.exit(1)
-
-    if not is_daemon_running(args.instance):
-        print(f"Error: Instance '{args.instance}' is not running", file=sys.stderr)
-        sys.exit(1)
-
-    try:
-        cmd_args_dict = {}
-
-        if args.cmd == "nav":
-            cmd_args_dict["url"] = args.url
-            if args.timeout:
-                cmd_args_dict["timeout"] = args.timeout
-        elif args.cmd == "click":
-            cmd_args_dict["uid"] = args.uid
-        elif args.cmd == "fill":
-            cmd_args_dict["uid"] = args.uid
-            cmd_args_dict["value"] = args.value
-        elif args.cmd == "shot" and args.path:
-            cmd_args_dict["path"] = args.path
-        elif args.cmd == "wait":
-            cmd_args_dict["text"] = args.text
-            if args.timeout:
-                cmd_args_dict["timeout"] = args.timeout
-        elif args.cmd == "eval":
-            cmd_args_dict["function"] = args.function
-            if args.args:
-                cmd_args_dict["args"] = json.loads(args.args)
-        elif args.cmd == "key":
-            cmd_args_dict["key"] = args.key
-        elif args.cmd == "hover":
-            cmd_args_dict["uid"] = args.uid
-        elif args.cmd == "netlist":
-            if args.types:
-                cmd_args_dict["resource_types"] = args.types
-            if args.size:
-                cmd_args_dict["page_size"] = args.size
-        elif args.cmd == "netget":
-            if args.reqid:
-                cmd_args_dict["reqid"] = args.reqid
-        elif args.cmd == "conslist":
-            if args.types:
-                cmd_args_dict["types"] = args.types
-            if args.size:
-                cmd_args_dict["page_size"] = args.size
-        elif args.cmd == "consget":
-            cmd_args_dict["msgid"] = args.msgid
-        elif args.cmd == "resize":
-            cmd_args_dict["width"] = args.width
-            cmd_args_dict["height"] = args.height
-        elif args.cmd == "dialog":
-            cmd_args_dict["action"] = args.action
-            if args.prompt_text:
-                cmd_args_dict["prompt_text"] = args.prompt_text
-        elif args.cmd == "upload":
-            cmd_args_dict["uid"] = args.uid
-            cmd_args_dict["file_path"] = args.file_path
-        elif args.cmd == "drag":
-            cmd_args_dict["from_uid"] = args.from_uid
-            cmd_args_dict["to_uid"] = args.to_uid
-        elif args.cmd == "fillform":
-            cmd_args_dict["elements"] = json.loads(args.elements)
-
-        output = await execute_command(args.instance, args.cmd, cmd_args_dict)
-        print(output)
-
-    except Exception as e:
-        print(f"Error: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    asyncio.run(main())