ai-dev-browser 0.5.3__py3-none-any.whl

ai_dev_browser/cdp/web_mcp.py

@@ -0,0 +1,219 @@
+# DO NOT EDIT THIS FILE!
+#
+# This file is generated from the CDP specification. If you need to make
+# changes, edit the generator and regenerate all of the modules.
+#
+# CDP domain: WebMCP (experimental)
+
+from __future__ import annotations
+import enum
+import typing
+from dataclasses import dataclass
+from .util import event_class, T_JSON_DICT
+
+from . import dom
+from . import page
+from . import runtime
+
+
+@dataclass
+class Annotation:
+    '''
+    Tool annotations
+    '''
+    #: A hint indicating that the tool does not modify any state.
+    read_only: typing.Optional[bool] = None
+
+    #: If the declarative tool was declared with the autosubmit attribute.
+    autosubmit: typing.Optional[bool] = None
+
+    def to_json(self) -> T_JSON_DICT:
+        json: T_JSON_DICT = dict()
+        if self.read_only is not None:
+            json['readOnly'] = self.read_only
+        if self.autosubmit is not None:
+            json['autosubmit'] = self.autosubmit
+        return json
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> Annotation:
+        return cls(
+            read_only=bool(json['readOnly']) if json.get('readOnly', None) is not None else None,
+            autosubmit=bool(json['autosubmit']) if json.get('autosubmit', None) is not None else None,
+        )
+
+
+class InvocationStatus(enum.Enum):
+    '''
+    Represents the status of a tool invocation.
+    '''
+    SUCCESS = "Success"
+    CANCELED = "Canceled"
+    ERROR = "Error"
+
+    def to_json(self) -> str:
+        return self.value
+
+    @classmethod
+    def from_json(cls, json: str) -> InvocationStatus:
+        return cls(json)
+
+
+@dataclass
+class Tool:
+    '''
+    Definition of a tool that can be invoked.
+    '''
+    #: Tool name.
+    name: str
+
+    #: Tool description.
+    description: str
+
+    #: Frame identifier associated with the tool registration.
+    frame_id: page.FrameId
+
+    #: Schema for the tool's input parameters.
+    input_schema: typing.Optional[dict] = None
+
+    #: Optional annotations for the tool.
+    annotations: typing.Optional[Annotation] = None
+
+    #: Optional node ID for declarative tools.
+    backend_node_id: typing.Optional[dom.BackendNodeId] = None
+
+    #: The stack trace at the time of the registration.
+    stack_trace: typing.Optional[runtime.StackTrace] = None
+
+    def to_json(self) -> T_JSON_DICT:
+        json: T_JSON_DICT = dict()
+        json['name'] = self.name
+        json['description'] = self.description
+        json['frameId'] = self.frame_id.to_json()
+        if self.input_schema is not None:
+            json['inputSchema'] = self.input_schema
+        if self.annotations is not None:
+            json['annotations'] = self.annotations.to_json()
+        if self.backend_node_id is not None:
+            json['backendNodeId'] = self.backend_node_id.to_json()
+        if self.stack_trace is not None:
+            json['stackTrace'] = self.stack_trace.to_json()
+        return json
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> Tool:
+        return cls(
+            name=str(json['name']),
+            description=str(json['description']),
+            frame_id=page.FrameId.from_json(json['frameId']),
+            input_schema=dict(json['inputSchema']) if json.get('inputSchema', None) is not None else None,
+            annotations=Annotation.from_json(json['annotations']) if json.get('annotations', None) is not None else None,
+            backend_node_id=dom.BackendNodeId.from_json(json['backendNodeId']) if json.get('backendNodeId', None) is not None else None,
+            stack_trace=runtime.StackTrace.from_json(json['stackTrace']) if json.get('stackTrace', None) is not None else None,
+        )
+
+
+def enable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
+    '''
+    Enables the WebMCP domain, allowing events to be sent. Enabling the domain will trigger a toolsAdded event for
+    all currently registered tools.
+    '''
+    cmd_dict: T_JSON_DICT = {
+        'method': 'WebMCP.enable',
+    }
+    json = yield cmd_dict
+
+
+def disable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
+    '''
+    Disables the WebMCP domain.
+    '''
+    cmd_dict: T_JSON_DICT = {
+        'method': 'WebMCP.disable',
+    }
+    json = yield cmd_dict
+
+
+@event_class('WebMCP.toolsAdded')
+@dataclass
+class ToolsAdded:
+    '''
+    Event fired when new tools are added.
+    '''
+    #: Array of tools that were added.
+    tools: typing.List[Tool]
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> ToolsAdded:
+        return cls(
+            tools=[Tool.from_json(i) for i in json['tools']]
+        )
+
+
+@event_class('WebMCP.toolsRemoved')
+@dataclass
+class ToolsRemoved:
+    '''
+    Event fired when tools are removed.
+    '''
+    #: Array of tools that were removed.
+    tools: typing.List[Tool]
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> ToolsRemoved:
+        return cls(
+            tools=[Tool.from_json(i) for i in json['tools']]
+        )
+
+
+@event_class('WebMCP.toolInvoked')
+@dataclass
+class ToolInvoked:
+    '''
+    Event fired when a tool invocation starts.
+    '''
+    #: Name of the tool to invoke.
+    tool_name: str
+    #: Frame id
+    frame_id: page.FrameId
+    #: Invocation identifier.
+    invocation_id: str
+    #: The input parameters used for the invocation.
+    input_: str
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> ToolInvoked:
+        return cls(
+            tool_name=str(json['toolName']),
+            frame_id=page.FrameId.from_json(json['frameId']),
+            invocation_id=str(json['invocationId']),
+            input_=str(json['input'])
+        )
+
+
+@event_class('WebMCP.toolResponded')
+@dataclass
+class ToolResponded:
+    '''
+    Event fired when a tool invocation completes or fails.
+    '''
+    #: Invocation identifier.
+    invocation_id: str
+    #: Status of the invocation.
+    status: InvocationStatus
+    #: Output or error delivered as delivered to the agent. Missing if ``status`` is anything other than Success.
+    output: typing.Optional[typing.Any]
+    #: Error text for protocol users.
+    error_text: typing.Optional[str]
+    #: The exception object, if the javascript tool threw an error>
+    exception: typing.Optional[runtime.RemoteObject]
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> ToolResponded:
+        return cls(
+            invocation_id=str(json['invocationId']),
+            status=InvocationStatus.from_json(json['status']),
+            output=json['output'] if json.get('output', None) is not None else None,
+            error_text=str(json['errorText']) if json.get('errorText', None) is not None else None,
+            exception=runtime.RemoteObject.from_json(json['exception']) if json.get('exception', None) is not None else None
+        )

ai_dev_browser/core/__init__.py

@@ -0,0 +1,218 @@
+"""Core browser operations - shared by tools/ and Python package.
+
+This module provides async functions for common browser operations.
+Both CLI tools and Python code can use these functions.
+
+Usage:
+    from ai_dev_browser.core import page_goto, click_by_text, page_discover
+
+    # In async context
+    await page_goto(tab, "https://example.com")
+    await click_by_text(tab, text="Sign in")
+    result = await page_discover(tab, interactable_only=True)
+"""
+
+# Accessibility tree interactions
+# CDP
+# Config (shared constants)
+from .ax import (
+    click_by_ref,
+    drag_by_ref,
+    focus_by_ref,
+    highlight_by_ref,
+    hover_by_ref,
+    html_by_ref,
+    screenshot_by_ref,
+    select_by_ref,
+    type_by_ref,
+    upload_by_ref,
+)
+
+# Browser lifecycle
+from .browser import browser_list, browser_start, browser_stop
+from .cdp import cdp_send
+
+# Chrome detection and launching
+from .chrome import find_chrome, launch_chrome
+
+# Cloudflare
+from .cloudflare import cloudflare_verify
+from .config import (
+    DEFAULT_BASE_DIR,
+    DEFAULT_COOKIES_DIR,
+    DEFAULT_COOKIES_FILE,
+    DEFAULT_DEBUG_HOST,
+    DEFAULT_DEBUG_PORT,
+    DEFAULT_PORT_RANGE,
+    DEFAULT_PROFILE_DIR,
+    DEFAULT_PROFILE_PREFIX,
+    DEFAULT_REUSE_STRATEGY,
+    ReuseStrategy,
+    get_workspace_profile_dir,
+    get_workspace_slug,
+)
+
+# Connection
+from .connection import connect_browser, get_active_tab, graceful_close_browser
+
+# Cookies
+from .cookies import cookies_list, cookies_load, cookies_save
+
+# Dialog (only tool-facing function)
+from .dialog import dialog_respond
+
+# Download
+from .download import download
+
+# Login (human-in-the-loop)
+from .login import login_interactive
+
+# Elements (only tool-facing functions)
+from .elements import (
+    click_by_html_id,
+    click_by_text,
+    click_by_xpath,
+    find_by_html_id,
+    find_by_xpath,
+    page_scroll,
+    page_wait_element,
+    type_by_text,
+)
+
+# Mouse
+from .mouse import mouse_click, mouse_drag, mouse_move
+
+# Navigation (only tool-facing functions)
+from .navigation import (
+    page_goto,
+    page_reload,
+    page_wait_ready,
+    page_wait_url,
+)
+
+# Page info
+from .page import page_html, page_info, js_evaluate, page_screenshot
+
+# Port management
+from .port import (
+    find_debug_chromes,
+    find_workspace_chromes,
+    get_available_port,
+    is_port_in_use,
+)
+
+# Process management
+from .process import get_pid_on_port
+
+# Text matching (only the dataclass is public)
+from .text_match import MatchResult
+
+# Snapshot (AI-friendly accessibility tree) - only tool-facing function
+from .snapshot import page_discover
+
+# Storage
+from .storage import storage_get, storage_set
+
+# Tabs
+from .tabs import tab_close, tab_list, tab_new, tab_switch
+
+# Window
+from .window import page_emulate_focus, window_set
+
+
+__all__ = [
+    # Accessibility tree interactions (by ref)
+    "click_by_ref",
+    "drag_by_ref",
+    "focus_by_ref",
+    "highlight_by_ref",
+    "hover_by_ref",
+    "html_by_ref",
+    "screenshot_by_ref",
+    "select_by_ref",
+    "type_by_ref",
+    "upload_by_ref",
+    # Browser lifecycle
+    "browser_start",
+    "browser_stop",
+    "browser_list",
+    # Config
+    "DEFAULT_BASE_DIR",
+    "DEFAULT_PROFILE_DIR",
+    "DEFAULT_COOKIES_FILE",
+    "DEFAULT_COOKIES_DIR",
+    "DEFAULT_PROFILE_PREFIX",
+    "DEFAULT_DEBUG_HOST",
+    "DEFAULT_DEBUG_PORT",
+    "DEFAULT_PORT_RANGE",
+    "DEFAULT_REUSE_STRATEGY",
+    "ReuseStrategy",
+    "get_workspace_slug",
+    "get_workspace_profile_dir",
+    # Chrome
+    "find_chrome",
+    "launch_chrome",
+    # Cloudflare
+    "cloudflare_verify",
+    # CDP
+    "cdp_send",
+    # Port
+    "is_port_in_use",
+    "find_debug_chromes",
+    "find_workspace_chromes",
+    "get_available_port",
+    # Process
+    "get_pid_on_port",
+    # Connection
+    "connect_browser",
+    "get_active_tab",
+    "graceful_close_browser",
+    # Navigation
+    "page_goto",
+    "page_reload",
+    "page_wait_ready",
+    "page_wait_url",
+    # Elements
+    "click_by_text",
+    "type_by_text",
+    "page_scroll",
+    "page_wait_element",
+    "find_by_html_id",
+    "click_by_html_id",
+    "find_by_xpath",
+    "click_by_xpath",
+    # Text matching
+    "MatchResult",
+    # Snapshot
+    "page_discover",
+    # Tabs
+    "tab_new",
+    "tab_list",
+    "tab_switch",
+    "tab_close",
+    # Page
+    "page_info",
+    "page_html",
+    "js_evaluate",
+    "page_screenshot",
+    # Mouse
+    "mouse_move",
+    "mouse_click",
+    "mouse_drag",
+    # Window
+    "window_set",
+    "page_emulate_focus",
+    # Storage
+    "storage_get",
+    "storage_set",
+    # Download
+    "download",
+    # Dialog
+    "dialog_respond",
+    # Login
+    "login_interactive",
+    # Cookies
+    "cookies_load",
+    "cookies_save",
+    "cookies_list",
+]

ai_dev_browser/core/_case.py

@@ -0,0 +1,38 @@
+"""Case conversion utilities — single source of truth.
+
+CDP wire format uses camelCase (`allowUnsafeEvalBlockedByCSP`); the vendored
+cdp-python module exposes snake_case kwargs (`allow_unsafe_eval_blocked_by_csp`).
+Anywhere we bridge the two we use one tested function so acronym handling stays
+consistent.
+
+The naive `re.sub(r"(?<!^)(?=[A-Z])", "_", name).lower()` shipped before this
+module mishandled trailing/embedded acronyms — `...ByCSP` became
+`..._by_c_s_p` and `getHTML` became `get_h_t_m_l`. Those names don't exist in
+cdp-python, so every CDP command carrying an acronym parameter raised TypeError
+on the retry path of `_transport.send_raw`.
+"""
+
+import re
+
+
+# Two-pass regex handling acronym boundaries:
+#   1. lower/digit → Upper          ("userAgent"            → "user_Agent")
+#   2. acronym end → next word      ("CSPNext", "XMLHttp"   → "CSP_Next", "XML_Http")
+# Then lowercase. Order matters: pass 1 splits the easy cases first so pass 2
+# only has to handle runs of uppercase that precede a capitalized word.
+_LOWER_UPPER = re.compile(r"([a-z0-9])([A-Z])")
+_ACRONYM_WORD = re.compile(r"([A-Z]+)([A-Z][a-z])")
+
+
+def camel_to_snake(name: str) -> str:
+    """Convert a camelCase / PascalCase identifier to snake_case.
+
+    Handles trailing acronyms (`...ByCSP` → `..._by_csp`), embedded acronyms
+    (`XMLHttpRequest` → `xml_http_request`), all-caps (`URL` → `url`), digits
+    (`ipv4Address` → `ipv4_address`), and identifiers already in snake_case.
+
+    Empty string returns empty string.
+    """
+    s = _LOWER_UPPER.sub(r"\1_\2", name)
+    s = _ACRONYM_WORD.sub(r"\1_\2", s)
+    return s.lower()

ai_dev_browser/core/_cf_template.py

@@ -0,0 +1,84 @@
+"""Cloudflare checkbox template image for verify_cf()."""
+
+import base64
+
+_CF_TEMPLATE_B64 = (
+    "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"
+)
+
+
+def get_cf_template() -> bytearray:
+    """Return CF checkbox template image as bytes."""
+    return bytearray(base64.b64decode(_CF_TEMPLATE_B64))