Skip to content

armgit / camel

Public Imported from GitHub
0

🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

Auto-update documentation after merge [skip ci]

camel-docs-botf984b3e3993d
diff --git a/docs/mintlify/docs.json b/docs/mintlify/docs.json
index 40ac06e9e..6456cdff2 100644
--- a/docs/mintlify/docs.json
+++ b/docs/mintlify/docs.json
@@ -541,6 +541,7 @@
"reference/camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit",
"reference/camel.toolkits.hybrid_browser_toolkit.snapshot",
"reference/camel.toolkits.hybrid_browser_toolkit.stealth_config",
+ "reference/camel.toolkits.hybrid_browser_toolkit.ws_wrapper",
"reference/camel.toolkits.non_visual_browser_toolkit.actions",
"reference/camel.toolkits.non_visual_browser_toolkit.agent",
"reference/camel.toolkits.non_visual_browser_toolkit.browser_non_visual_toolkit",
diff --git a/docs/mintlify/reference/camel.agents.chat_agent.mdx b/docs/mintlify/reference/camel.agents.chat_agent.mdx
index f26e6f22a..5b4125f92 100644
--- a/docs/mintlify/reference/camel.agents.chat_agent.mdx
+++ b/docs/mintlify/reference/camel.agents.chat_agent.mdx
@@ -1208,8 +1208,11 @@ configuration.
def _clone_tools(self):
```
-Clone tools for new agent instance,
-handling stateful toolkits properly.
+**Returns:**
+
+ Tuple containing:
+- List of cloned tools/functions
+- List of RegisteredAgentToolkit instances need registration
<a id="camel.agents.chat_agent.ChatAgent.__repr__"></a>
diff --git a/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.config_loader.mdx b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.config_loader.mdx
index 3644914d9..339f8f45d 100644
--- a/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.config_loader.mdx
+++ b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.config_loader.mdx
@@ -1,10 +1,5 @@
<a id="camel.toolkits.hybrid_browser_toolkit.config_loader"></a>
-Configuration for browser automation including stealth mode and timeouts.
-
-This module contains all the configuration needed to make the browser
-appear as a regular user browser and configure action timeouts.
-
<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig"></a>
## BrowserConfig
@@ -13,236 +8,17 @@ appear as a regular user browser and configure action timeouts.
class BrowserConfig:
```
-Configuration class for browser settings including stealth mode and
-timeouts.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_timeout_config"></a>
-
-### get_timeout_config
-
-```python
-def get_timeout_config():
-```
-
-**Returns:**
-
- Dict[str, int]: Timeout configuration in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_action_limits"></a>
-
-### get_action_limits
-
-```python
-def get_action_limits():
-```
-
-**Returns:**
-
- Dict[str, int]: Action limits configuration.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_action_timeout"></a>
-
-### get_action_timeout
-
-```python
-def get_action_timeout(override: Optional[int] = None):
-```
-
-Get action timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_short_timeout"></a>
-
-### get_short_timeout
-
-```python
-def get_short_timeout(override: Optional[int] = None):
-```
-
-Get short timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_navigation_timeout"></a>
-
-### get_navigation_timeout
-
-```python
-def get_navigation_timeout(override: Optional[int] = None):
-```
-
-Get navigation timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_network_idle_timeout"></a>
-
-### get_network_idle_timeout
-
-```python
-def get_network_idle_timeout(override: Optional[int] = None):
-```
-
-Get network idle timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_max_scroll_amount"></a>
-
-### get_max_scroll_amount
-
-```python
-def get_max_scroll_amount(override: Optional[int] = None):
-```
-
-Get maximum scroll amount with optional override.
-
-**Parameters:**
-
-- **override**: Optional scroll amount override value in pixels.
-
-**Returns:**
-
- int: Maximum scroll amount in pixels.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_screenshot_timeout"></a>
-
-### get_screenshot_timeout
-
-```python
-def get_screenshot_timeout(override: Optional[int] = None):
-```
-
-Get screenshot timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
+Browser configuration settings.
- int: Timeout value in milliseconds.
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ToolkitConfig"></a>
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_page_stability_timeout"></a>
-
-### get_page_stability_timeout
+## ToolkitConfig
```python
-def get_page_stability_timeout(override: Optional[int] = None):
+class ToolkitConfig:
```
-Get page stability timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_dom_content_loaded_timeout"></a>
-
-### get_dom_content_loaded_timeout
-
-```python
-def get_dom_content_loaded_timeout(override: Optional[int] = None):
-```
-
-Get DOM content loaded timeout with optional override.
-
-**Parameters:**
-
-- **override**: Optional timeout override value in milliseconds.
-
-**Returns:**
-
- int: Timeout value in milliseconds.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_launch_args"></a>
-
-### get_launch_args
-
-```python
-def get_launch_args():
-```
-
-**Returns:**
-
- List[str]: Chrome command line arguments to avoid detection.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_context_options"></a>
-
-### get_context_options
-
-```python
-def get_context_options():
-```
-
-**Returns:**
-
- Dict[str, Any]: Browser context configuration options.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_http_headers"></a>
-
-### get_http_headers
-
-```python
-def get_http_headers():
-```
-
-**Returns:**
-
- Dict[str, str]: HTTP headers to appear more like a real browser.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_stealth_config"></a>
-
-### get_stealth_config
-
-```python
-def get_stealth_config():
-```
-
-**Returns:**
-
- Dict[str, Any]: Complete stealth configuration.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.BrowserConfig.get_all_config"></a>
-
-### get_all_config
-
-```python
-def get_all_config():
-```
-
-**Returns:**
-
- Dict[str, Any]: Complete browser configuration.
+Toolkit-specific configuration.
<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader"></a>
@@ -252,225 +28,86 @@ def get_all_config():
class ConfigLoader:
```
-Legacy wrapper for BrowserConfig - maintained for backward
-compatibility.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_browser_config"></a>
-
-### get_browser_config
-
-```python
-def get_browser_config(cls):
-```
-
-Get the BrowserConfig class.
+Configuration loader for HybridBrowserToolkit.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_stealth_config"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.__init__"></a>
-### get_stealth_config
+### __init__
```python
-def get_stealth_config(cls):
+def __init__(
+ self,
+ browser_config: Optional[BrowserConfig] = None,
+ toolkit_config: Optional[ToolkitConfig] = None
+):
```
-Get the StealthConfig class (alias).
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.from_kwargs"></a>
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_timeout_config"></a>
-
-### get_timeout_config
+### from_kwargs
```python
-def get_timeout_config(cls):
+def from_kwargs(cls, **kwargs):
```
-Get timeout configuration.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_action_timeout"></a>
+Create ConfigLoader from keyword arguments.
-### get_action_timeout
-
-```python
-def get_action_timeout(cls, override: Optional[int] = None):
-```
-
-Get action timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_short_timeout"></a>
-
-### get_short_timeout
-
-```python
-def get_short_timeout(cls, override: Optional[int] = None):
-```
-
-Get short timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_navigation_timeout"></a>
-
-### get_navigation_timeout
-
-```python
-def get_navigation_timeout(cls, override: Optional[int] = None):
-```
-
-Get navigation timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_network_idle_timeout"></a>
-
-### get_network_idle_timeout
-
-```python
-def get_network_idle_timeout(cls, override: Optional[int] = None):
-```
-
-Get network idle timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_max_scroll_amount"></a>
-
-### get_max_scroll_amount
-
-```python
-def get_max_scroll_amount(cls, override: Optional[int] = None):
-```
-
-Get maximum scroll amount with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_screenshot_timeout"></a>
-
-### get_screenshot_timeout
-
-```python
-def get_screenshot_timeout(cls, override: Optional[int] = None):
-```
-
-Get screenshot timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_page_stability_timeout"></a>
-
-### get_page_stability_timeout
-
-```python
-def get_page_stability_timeout(cls, override: Optional[int] = None):
-```
-
-Get page stability timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_dom_content_loaded_timeout"></a>
-
-### get_dom_content_loaded_timeout
-
-```python
-def get_dom_content_loaded_timeout(cls, override: Optional[int] = None):
-```
-
-Get DOM content loaded timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_browser_config"></a>
-
-## get_browser_config
-
-```python
-def get_browser_config():
-```
-
-Get BrowserConfig class.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_stealth_config"></a>
-
-## get_stealth_config
-
-```python
-def get_stealth_config():
-```
-
-Get StealthConfig class.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_timeout_config"></a>
-
-## get_timeout_config
-
-```python
-def get_timeout_config():
-```
-
-Get timeout configuration.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_action_timeout"></a>
-
-## get_action_timeout
-
-```python
-def get_action_timeout(override: Optional[int] = None):
-```
-
-Get action timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_short_timeout"></a>
-
-## get_short_timeout
-
-```python
-def get_short_timeout(override: Optional[int] = None):
-```
-
-Get short timeout with optional override.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_navigation_timeout"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_browser_config"></a>
-## get_navigation_timeout
+### get_browser_config
```python
-def get_navigation_timeout(override: Optional[int] = None):
+def get_browser_config(self):
```
-Get navigation timeout with optional override.
+Get browser configuration.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_network_idle_timeout"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_toolkit_config"></a>
-## get_network_idle_timeout
+### get_toolkit_config
```python
-def get_network_idle_timeout(override: Optional[int] = None):
+def get_toolkit_config(self):
```
-Get network idle timeout with optional override.
+Get toolkit configuration.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_max_scroll_amount"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.to_ws_config"></a>
-## get_max_scroll_amount
+### to_ws_config
```python
-def get_max_scroll_amount(override: Optional[int] = None):
+def to_ws_config(self):
```
-Get maximum scroll amount with optional override.
+Convert to WebSocket wrapper configuration format.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_screenshot_timeout"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.get_timeout_config"></a>
-## get_screenshot_timeout
+### get_timeout_config
```python
-def get_screenshot_timeout(override: Optional[int] = None):
+def get_timeout_config(self):
```
-Get screenshot timeout with optional override.
+Get all timeout configurations.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_page_stability_timeout"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.update_browser_config"></a>
-## get_page_stability_timeout
+### update_browser_config
```python
-def get_page_stability_timeout(override: Optional[int] = None):
+def update_browser_config(self, **kwargs):
```
-Get page stability timeout with optional override.
+Update browser configuration.
-<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.get_dom_content_loaded_timeout"></a>
+<a id="camel.toolkits.hybrid_browser_toolkit.config_loader.ConfigLoader.update_toolkit_config"></a>
-## get_dom_content_loaded_timeout
+### update_toolkit_config
```python
-def get_dom_content_loaded_timeout(override: Optional[int] = None):
+def update_toolkit_config(self, **kwargs):
```
-Get DOM content loaded timeout with optional override.
+Update toolkit configuration.
diff --git a/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.mdx b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.mdx
index b14f2d2a0..9abd90849 100644
--- a/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.mdx
+++ b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.mdx
@@ -5,17 +5,14 @@
## HybridBrowserToolkit
```python
-class HybridBrowserToolkit(BaseToolkit):
+class HybridBrowserToolkit(BaseToolkit, RegisteredAgentToolkit):
```
A hybrid browser toolkit that combines non-visual, DOM-based browser
automation with visual, screenshot-based capabilities.
-This toolkit exposes a set of actions as CAMEL FunctionTools for agents
-to interact with web pages. It can operate in headless mode and supports
-both programmatic control of browser actions (like clicking and typing)
-and visual analysis of the page layout through screenshots with marked
-interactive elements.
+This toolkit now uses TypeScript implementation with Playwright's
+_snapshotForAI functionality for enhanced AI integration.
<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.__init__"></a>
@@ -29,22 +26,33 @@ Initialize the HybridBrowserToolkit.
**Parameters:**
-- **headless** (bool): Whether to run the browser in headless mode. Defaults to `True`.
-- **user_data_dir** (Optional[str]): Path to a directory for storing browser data like cookies and local storage. Useful for maintaining sessions across runs. Defaults to `None` (a temporary directory is used).
-- **stealth** (bool): Whether to run the browser in stealth mode to avoid bot detection. When enabled, hides WebDriver characteristics, spoofs navigator properties, and implements various anti-detection measures. Highly recommended for production use and when accessing sites with bot detection. Defaults to `False`.
-- **web_agent_model** (Optional[BaseModelBackend]): The language model backend to use for the high-level `solve_task` agent. This is required only if you plan to use `solve_task`. Defaults to `None`.
-- **cache_dir** (str): The directory to store cached files, such as screenshots. Defaults to `"tmp/"`.
-- **enabled_tools** (Optional[List[str]]): List of tool names to enable. If None, uses DEFAULT_TOOLS. Available tools: open_browser, close_browser, visit_page, back, forward, get_page_snapshot, get_som_screenshot, get_page_links, click, type, select, scroll, enter, wait_user, solve_task. Defaults to `None`.
-- **browser_log_to_file** (bool): Whether to save detailed browser action logs to file. When enabled, logs action inputs/outputs, execution times, and page loading times. Logs are saved to an auto-generated timestamped file. Defaults to `False`.
-- **session_id** (Optional[str]): A unique identifier for this browser session. When multiple HybridBrowserToolkit instances are used concurrently, different session IDs prevent them from sharing the same browser session and causing conflicts. If None, a default session will be used. Defaults to `None`.
-- **default_start_url** (str): The default URL to navigate to when open_browser() is called without a start_url parameter or with None. Defaults to `"https://google.com/"`.
-- **default_timeout** (Optional[int]): Default timeout in milliseconds for browser actions. If None, uses environment variable HYBRID_BROWSER_DEFAULT_TIMEOUT or defaults to 3000ms. Defaults to `None`.
-- **short_timeout** (Optional[int]): Short timeout in milliseconds for quick browser actions. If None, uses environment variable HYBRID_BROWSER_SHORT_TIMEOUT or defaults to 1000ms. Defaults to `None`.
-- **navigation_timeout** (Optional[int]): Custom navigation timeout in milliseconds. If None, uses environment variable HYBRID_BROWSER_NAVIGATION_TIMEOUT or defaults to 10000ms. Defaults to `None`.
-- **network_idle_timeout** (Optional[int]): Custom network idle timeout in milliseconds. If None, uses environment variable HYBRID_BROWSER_NETWORK_IDLE_TIMEOUT or defaults to 5000ms. Defaults to `None`.
-- **screenshot_timeout** (Optional[int]): Custom screenshot timeout in milliseconds. If None, uses environment variable HYBRID_BROWSER_SCREENSHOT_TIMEOUT or defaults to 15000ms. Defaults to `None`.
-- **page_stability_timeout** (Optional[int]): Custom page stability timeout in milliseconds. If None, uses environment variable HYBRID_BROWSER_PAGE_STABILITY_TIMEOUT or defaults to 1500ms. Defaults to `None`.
-- **dom_content_loaded_timeout** (Optional[int]): Custom DOM content loaded timeout in milliseconds. If None, uses environment variable HYBRID_BROWSER_DOM_CONTENT_LOADED_TIMEOUT or defaults to 5000ms. Defaults to `None`.
+- **headless** (bool): Whether to run browser in headless mode. Defaults to True.
+- **user_data_dir** (Optional[str]): Directory for user data persistence. Defaults to None.
+- **stealth** (bool): Whether to enable stealth mode. Defaults to False.
+- **web_agent_model** (Optional[BaseModelBackend]): Model for web agent operations. Defaults to None.
+- **cache_dir** (str): Directory for caching. Defaults to "tmp/". (default: `"tmp/"`)
+- **enabled_tools** (Optional[List[str]]): List of enabled tools. Defaults to None.
+- **browser_log_to_file** (bool): Whether to log browser actions to file. Defaults to False.
+- **session_id** (Optional[str]): Session identifier. Defaults to None.
+- **default_start_url** (str): Default URL to start with. Defaults to "https://google.com/".
+- **default_timeout** (Optional[int]): Default timeout in milliseconds. Defaults to None.
+- **short_timeout** (Optional[int]): Short timeout in milliseconds. Defaults to None.
+- **navigation_timeout** (Optional[int]): Navigation timeout in milliseconds. Defaults to None.
+- **network_idle_timeout** (Optional[int]): Network idle timeout in milliseconds. Defaults to None.
+- **screenshot_timeout** (Optional[int]): Screenshot timeout in milliseconds. Defaults to None.
+- **page_stability_timeout** (Optional[int]): Page stability timeout in milliseconds. Defaults to None.
+- **dom_content_loaded_timeout** (Optional[int]): DOM content loaded timeout in milliseconds. Defaults to None.
+- **viewport_limit** (bool): Whether to filter page snapshot elements to only those visible in the current viewport. When True, only elements within the current viewport bounds will be included in snapshots. When False (default), all elements on the page are included. Defaults to False.
+
+<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.__del__"></a>
+
+### __del__
+
+```python
+def __del__(self):
+```
+
+Cleanup browser resources on garbage collection.
<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.web_agent_model"></a>
@@ -76,127 +84,6 @@ def cache_dir(self):
Get the cache directory.
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.__del__"></a>
-
-### __del__
-
-```python
-def __del__(self):
-```
-
-Cleanup browser resources on garbage collection.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._load_unified_analyzer"></a>
-
-### _load_unified_analyzer
-
-```python
-def _load_unified_analyzer(self):
-```
-
-Load the unified analyzer JavaScript script.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._validate_ref"></a>
-
-### _validate_ref
-
-```python
-def _validate_ref(self, ref: str, method_name: str):
-```
-
-Validate ref parameter.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._truncate_if_needed"></a>
-
-### _truncate_if_needed
-
-```python
-def _truncate_if_needed(self, content: Any):
-```
-
-Truncate content if max_log_length is set.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.action_logger"></a>
-
-### action_logger
-
-```python
-def action_logger(func: Callable[..., Any]):
-```
-
-Decorator to add logging to action methods.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._convert_analysis_to_rects"></a>
-
-### _convert_analysis_to_rects
-
-```python
-def _convert_analysis_to_rects(self, analysis_data: Dict[str, Any]):
-```
-
-Convert analysis data to rect format for visual marking.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._add_set_of_mark"></a>
-
-### _add_set_of_mark
-
-```python
-def _add_set_of_mark(self, image, rects):
-```
-
-Add visual marks to the image.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._format_snapshot_from_analysis"></a>
-
-### _format_snapshot_from_analysis
-
-```python
-def _format_snapshot_from_analysis(self, analysis_data: Dict[str, Any]):
-```
-
-Format analysis data into snapshot string.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit._ensure_agent"></a>
-
-### _ensure_agent
-
-```python
-def _ensure_agent(self):
-```
-
-Create PlaywrightLLMAgent on first use.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.get_log_summary"></a>
-
-### get_log_summary
-
-```python
-def get_log_summary(self):
-```
-
-Get a summary of logged actions.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.clear_logs"></a>
-
-### clear_logs
-
-```python
-def clear_logs(self):
-```
-
-Clear the log buffer.
-
-<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.get_tools"></a>
-
-### get_tools
-
-```python
-def get_tools(self):
-```
-
-Get available function tools
-based on enabled_tools configuration.
-
<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.clone_for_new_session"></a>
### clone_for_new_session
@@ -216,3 +103,14 @@ session.
A new HybridBrowserToolkit instance with the same configuration
but a different session.
+
+<a id="camel.toolkits.hybrid_browser_toolkit.hybrid_browser_toolkit.HybridBrowserToolkit.get_tools"></a>
+
+### get_tools
+
+```python
+def get_tools(self):
+```
+
+Get available function tools based
+on enabled_tools configuration.
diff --git a/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.ws_wrapper.mdx b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.ws_wrapper.mdx
new file mode 100644
index 000000000..c337b80fd
--- /dev/null
+++ b/docs/mintlify/reference/camel.toolkits.hybrid_browser_toolkit.ws_wrapper.mdx
@@ -0,0 +1,36 @@
+<a id="camel.toolkits.hybrid_browser_toolkit.ws_wrapper"></a>
+
+<a id="camel.toolkits.hybrid_browser_toolkit.ws_wrapper.action_logger"></a>
+
+## action_logger
+
+```python
+def action_logger(func):
+```
+
+Decorator to add logging to action methods.
+
+<a id="camel.toolkits.hybrid_browser_toolkit.ws_wrapper.WebSocketBrowserWrapper"></a>
+
+## WebSocketBrowserWrapper
+
+```python
+class WebSocketBrowserWrapper:
+```
+
+Python wrapper for the TypeScript hybrid browser
+toolkit implementation using WebSocket.
+
+<a id="camel.toolkits.hybrid_browser_toolkit.ws_wrapper.WebSocketBrowserWrapper.__init__"></a>
+
+### __init__
+
+```python
+def __init__(self, config: Optional[Dict[str, Any]] = None):
+```
+
+Initialize the wrapper.
+
+**Parameters:**
+
+- **config**: Configuration dictionary for the browser toolkit