camel-ai 0.2.26__py3-none-any.whl → 0.2.28__py3-none-any.whl

camel/toolkits/mcp_toolkit.py

@@ -12,10 +12,13 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 import inspect
+import json
+import os
 from contextlib import AsyncExitStack, asynccontextmanager
 from typing import (
     TYPE_CHECKING,
     Any,
+    AsyncGenerator,
     Callable,
     Dict,
     List,
@@ -28,13 +31,16 @@ from urllib.parse import urlparse
 if TYPE_CHECKING:
     from mcp import ListToolsResult, Tool
 
+from camel.logger import get_logger
 from camel.toolkits import BaseToolkit, FunctionTool
 
+logger = get_logger(__name__)
 
-class MCPToolkit(BaseToolkit):
-    r"""MCPToolkit provides an abstraction layer to interact with external
-    tools using the Model Context Protocol (MCP). It supports two modes of
-    connection:
+
+class _MCPServer(BaseToolkit):
+    r"""Internal class that provides an abstraction layer to interact with
+    external tools using the Model Context Protocol (MCP). It supports two
+    modes of connection:
 
     1. stdio mode: Connects via standard input/output streams for local
        command-line interactions.
@@ -73,20 +79,20 @@ class MCPToolkit(BaseToolkit):
         self._exit_stack = AsyncExitStack()
         self._is_connected = False
 
-    @asynccontextmanager
-    async def connection(self):
-        r"""Async context manager for establishing and managing the connection
-        with the MCP server. Automatically selects SSE or stdio mode based
-        on the provided `command_or_url`.
+    async def connect(self):
+        r"""Explicitly connect to the MCP server.
 
-        Yields:
-            MCPToolkit: Instance with active connection ready for tool
-                interaction.
+        Returns:
+            _MCPServer: The connected server instance
         """
         from mcp.client.session import ClientSession
         from mcp.client.sse import sse_client
         from mcp.client.stdio import StdioServerParameters, stdio_client
 
+        if self._is_connected:
+            logger.warning("Server is already connected")
+            return self
+
         try:
             if urlparse(self.command_or_url).scheme in ("http", "https"):
                 (
@@ -113,12 +119,33 @@ class MCPToolkit(BaseToolkit):
             list_tools_result = await self.list_mcp_tools()
             self._mcp_tools = list_tools_result.tools
             self._is_connected = True
-            yield self
+            return self
+        except Exception as e:
+            # Ensure resources are cleaned up on connection failure
+            await self.disconnect()
+            logger.error(f"Failed to connect to MCP server: {e}")
 
+    async def disconnect(self):
+        r"""Explicitly disconnect from the MCP server."""
+        self._is_connected = False
+        await self._exit_stack.aclose()
+        self._session = None
+
+    @asynccontextmanager
+    async def connection(self):
+        r"""Async context manager for establishing and managing the connection
+        with the MCP server. Automatically selects SSE or stdio mode based
+        on the provided `command_or_url`.
+
+        Yields:
+            _MCPServer: Instance with active connection ready for tool
+                interaction.
+        """
+        try:
+            await self.connect()
+            yield self
         finally:
-            self._is_connected = False
-            await self._exit_stack.aclose()
-            self._session = None
+            await self.disconnect()
 
     async def list_mcp_tools(self) -> Union[str, "ListToolsResult"]:
         r"""Retrieves the list of available tools from the connected MCP
@@ -188,34 +215,53 @@ class MCPToolkit(BaseToolkit):
                 kwargs.keys()
             )
             if missing_params:
-                raise ValueError(
+                logger.warning(
                     f"Missing required parameters: {missing_params}"
                 )
+                return "Missing required parameters."
 
-            result: CallToolResult = await self._session.call_tool(
-                func_name, kwargs
-            )
+            if not self._session:
+                logger.error(
+                    "MCP Client is not connected. Call `connection()` first."
+                )
+                return (
+                    "MCP Client is not connected. Call `connection()` first."
+                )
 
-            if not result.content:
+            try:
+                result: CallToolResult = await self._session.call_tool(
+                    func_name, kwargs
+                )
+            except Exception as e:
+                logger.error(f"Failed to call MCP tool '{func_name}': {e!s}")
+                return f"Failed to call MCP tool '{func_name}': {e!s}"
+
+            if not result.content or len(result.content) == 0:
                 return "No data available for this request."
 
             # Handle different content types
-            content = result.content[0]
-            if content.type == "text":
-                return content.text
-            elif content.type == "image":
-                # Return image URL or data URI if available
-                if hasattr(content, "url") and content.url:
-                    return f"Image available at: {content.url}"
-                return "Image content received (data URI not shown)"
-            elif content.type == "embedded_resource":
-                # Return resource information if available
-                if hasattr(content, "name") and content.name:
-                    return f"Embedded resource: {content.name}"
-                return "Embedded resource received"
-            else:
-                msg = f"Received content of type '{content.type}'"
-                return f"{msg} which is not fully supported yet."
+            try:
+                content = result.content[0]
+                if content.type == "text":
+                    return content.text
+                elif content.type == "image":
+                    # Return image URL or data URI if available
+                    if hasattr(content, "url") and content.url:
+                        return f"Image available at: {content.url}"
+                    return "Image content received (data URI not shown)"
+                elif content.type == "embedded_resource":
+                    # Return resource information if available
+                    if hasattr(content, "name") and content.name:
+                        return f"Embedded resource: {content.name}"
+                    return "Embedded resource received"
+                else:
+                    msg = f"Received content of type '{content.type}'"
+                    return f"{msg} which is not fully supported yet."
+            except (IndexError, AttributeError) as e:
+                logger.error(
+                    f"Error processing content from MCP tool response: {e!s}"
+                )
+                return "Error processing content from MCP tool response"
 
         dynamic_function.__name__ = func_name
         dynamic_function.__doc__ = func_desc
@@ -236,6 +282,27 @@ class MCPToolkit(BaseToolkit):
 
         return dynamic_function
 
+    def _build_tool_schema(self, mcp_tool: "Tool") -> Dict[str, Any]:
+        input_schema = mcp_tool.inputSchema
+        properties = input_schema.get("properties", {})
+        required = input_schema.get("required", [])
+
+        parameters = {
+            "type": "object",
+            "properties": properties,
+            "required": required,
+        }
+
+        return {
+            "type": "function",
+            "function": {
+                "name": mcp_tool.name,
+                "description": mcp_tool.description
+                or "No description provided.",
+                "parameters": parameters,
+            },
+        }
+
     def get_tools(self) -> List[FunctionTool]:
         r"""Returns a list of FunctionTool objects representing the
         functions in the toolkit. Each function is dynamically generated
@@ -246,6 +313,197 @@ class MCPToolkit(BaseToolkit):
                 representing the functions in the toolkit.
         """
         return [
-            FunctionTool(self.generate_function_from_mcp_tool(mcp_tool))
+            FunctionTool(
+                self.generate_function_from_mcp_tool(mcp_tool),
+                openai_tool_schema=self._build_tool_schema(mcp_tool),
+            )
             for mcp_tool in self._mcp_tools
         ]
+
+
+class MCPToolkit(BaseToolkit):
+    r"""MCPToolkit provides a unified interface for managing multiple
+    MCP server connections and their tools.
+
+    This class handles the lifecycle of multiple MCP server connections and
+    offers a centralized configuration mechanism for both local and remote
+    MCP services.
+
+    Args:
+        servers (Optional[List[_MCPServer]]): List of _MCPServer
+            instances to manage.
+        config_path (Optional[str]): Path to a JSON configuration file
+            defining MCP servers.
+
+    Note:
+        Either `servers` or `config_path` must be provided. If both are
+        provided, servers from both sources will be combined.
+
+    Attributes:
+        servers (List[_MCPServer]): List of _MCPServer instances being managed.
+    """
+
+    def __init__(
+        self,
+        servers: Optional[List[_MCPServer]] = None,
+        config_path: Optional[str] = None,
+    ):
+        super().__init__()
+
+        if servers and config_path:
+            logger.warning(
+                "Both servers and config_path are provided. "
+                "Servers from both sources will be combined."
+            )
+
+        self.servers = servers or []
+
+        if config_path:
+            self.servers.extend(self._load_servers_from_config(config_path))
+
+        self._exit_stack = AsyncExitStack()
+        self._connected = False
+
+    def _load_servers_from_config(self, config_path: str) -> List[_MCPServer]:
+        r"""Loads MCP server configurations from a JSON file.
+
+        Args:
+            config_path (str): Path to the JSON configuration file.
+
+        Returns:
+            List[_MCPServer]: List of configured _MCPServer instances.
+        """
+        try:
+            with open(config_path, "r", encoding="utf-8") as f:
+                try:
+                    data = json.load(f)
+                except json.JSONDecodeError as e:
+                    logger.warning(
+                        f"Invalid JSON in config file '{config_path}': {e!s}"
+                    )
+                    return []
+        except FileNotFoundError:
+            logger.warning(f"Config file not found: '{config_path}'")
+            return []
+
+        all_servers = []
+
+        # Process local MCP servers
+        mcp_servers = data.get("mcpServers", {})
+        if not isinstance(mcp_servers, dict):
+            logger.warning("'mcpServers' is not a dictionary, skipping...")
+            mcp_servers = {}
+
+        for name, cfg in mcp_servers.items():
+            if not isinstance(cfg, dict):
+                logger.warning(
+                    f"Configuration for server '{name}' must be a dictionary"
+                )
+                continue
+
+            if "command" not in cfg:
+                logger.warning(
+                    f"Missing required 'command' field for server '{name}'"
+                )
+                continue
+
+            server = _MCPServer(
+                command_or_url=cfg["command"],
+                args=cfg.get("args", []),
+                env={**os.environ, **cfg.get("env", {})},
+                timeout=cfg.get("timeout", None),
+            )
+            all_servers.append(server)
+
+        # Process remote MCP web servers
+        mcp_web_servers = data.get("mcpWebServers", {})
+        if not isinstance(mcp_web_servers, dict):
+            logger.warning("'mcpWebServers' is not a dictionary, skipping...")
+            mcp_web_servers = {}
+
+        for name, cfg in mcp_web_servers.items():
+            if not isinstance(cfg, dict):
+                logger.warning(
+                    f"Configuration for web server '{name}' must"
+                    "be a dictionary"
+                )
+                continue
+
+            if "url" not in cfg:
+                logger.warning(
+                    f"Missing required 'url' field for web server '{name}'"
+                )
+                continue
+
+            server = _MCPServer(
+                command_or_url=cfg["url"],
+                timeout=cfg.get("timeout", None),
+            )
+            all_servers.append(server)
+
+        return all_servers
+
+    async def connect(self):
+        r"""Explicitly connect to all MCP servers.
+
+        Returns:
+            MCPToolkit: The connected toolkit instance
+        """
+        if self._connected:
+            logger.warning("MCPToolkit is already connected")
+            return self
+
+        self._exit_stack = AsyncExitStack()
+        try:
+            # Sequentially connect to each server
+            for server in self.servers:
+                await server.connect()
+            self._connected = True
+            return self
+        except Exception as e:
+            # Ensure resources are cleaned up on connection failure
+            await self.disconnect()
+            logger.error(f"Failed to connect to one or more MCP servers: {e}")
+
+    async def disconnect(self):
+        r"""Explicitly disconnect from all MCP servers."""
+        if not self._connected:
+            return
+
+        for server in self.servers:
+            await server.disconnect()
+        self._connected = False
+        await self._exit_stack.aclose()
+
+    @asynccontextmanager
+    async def connection(self) -> AsyncGenerator["MCPToolkit", None]:
+        r"""Async context manager that simultaneously establishes connections
+        to all managed MCP server instances.
+
+        Yields:
+            MCPToolkit: Self with all servers connected.
+        """
+        try:
+            await self.connect()
+            yield self
+        finally:
+            await self.disconnect()
+
+    def is_connected(self) -> bool:
+        r"""Checks if all the managed servers are connected.
+
+        Returns:
+            bool: True if connected, False otherwise.
+        """
+        return self._connected
+
+    def get_tools(self) -> List[FunctionTool]:
+        r"""Aggregates all tools from the managed MCP server instances.
+
+        Returns:
+            List[FunctionTool]: Combined list of all available function tools.
+        """
+        all_tools = []
+        for server in self.servers:
+            all_tools.extend(server.get_tools())
+        return all_tools

camel/toolkits/search_toolkit.py

@@ -704,6 +704,68 @@ class SearchToolkit(BaseToolkit):
         except Exception as e:
             return [{"error": f"An unexpected error occurred: {e!s}"}]
 
+    @api_keys_required([(None, 'BOCHA_API_KEY')])
+    def search_bocha(
+        self,
+        query: str,
+        freshness: str = "noLimit",
+        summary: bool = False,
+        count: int = 10,
+        page: int = 1,
+    ) -> Dict[str, Any]:
+        r"""Query the Bocha AI search API and return search results.
+
+        Args:
+            query (str): The search query.
+            freshness (str): Time frame filter for search results. Default
+                is "noLimit". Options include:
+                - 'noLimit': no limit (default).
+                - 'oneDay': past day.
+                - 'oneWeek': past week.
+                - 'oneMonth': past month.
+                - 'oneYear': past year.
+            summary (bool): Whether to include text summaries in results.
+                Default is False.
+            count (int): Number of results to return (1-50). Default is 10.
+            page (int): Page number of results. Default is 1.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing search results, including
+                web pages, images, and videos if available. The structure
+                follows the Bocha AI search API response format.
+        """
+        import json
+
+        BOCHA_API_KEY = os.getenv("BOCHA_API_KEY")
+
+        url = "https://api.bochaai.com/v1/web-search"
+        headers = {
+            "Authorization": f"Bearer {BOCHA_API_KEY}",
+            "Content-Type": "application/json",
+        }
+
+        payload = json.dumps(
+            {
+                "query": query,
+                "freshness": freshness,
+                "summary": summary,
+                "count": count,
+                "page": page,
+            }
+        )
+        try:
+            response = requests.post(url, headers=headers, data=payload)
+            if response.status_code != 200:
+                return {
+                    "error": (
+                        f"Bocha API failed with {response.status_code}: "
+                        f"{response.text}"
+                    )
+                }
+            return response.json()["data"]
+        except requests.exceptions.RequestException as e:
+            return {"error": f"Bocha AI search failed: {e!s}"}
+
     def get_tools(self) -> List[FunctionTool]:
         r"""Returns a list of FunctionTool objects representing the
         functions in the toolkit.
@@ -720,4 +782,5 @@ class SearchToolkit(BaseToolkit):
             FunctionTool(self.query_wolfram_alpha),
             FunctionTool(self.tavily_search),
             FunctionTool(self.search_brave),
+            FunctionTool(self.search_bocha),
         ]

camel/types/enums.py

@@ -249,6 +249,7 @@ class ModelType(UnifiedModelType, Enum):
                 self.is_siliconflow,
                 self.is_zhipuai,
                 self.is_aiml,
+                self.is_azure_openai,
             ]
         )
 
@@ -889,6 +890,7 @@ class ModelPlatformType(Enum):
     MOONSHOT = "moonshot"
     SILICONFLOW = "siliconflow"
     AIML = "aiml"
+    VOLCANO = "volcano"
 
     @property
     def is_openai(self) -> bool:
@@ -1011,6 +1013,11 @@ class ModelPlatformType(Enum):
         r"""Returns whether this platform is AIML."""
         return self is ModelPlatformType.AIML
 
+    @property
+    def is_volcano(self) -> bool:
+        r"""Returns whether this platform is volcano."""
+        return self is ModelPlatformType.VOLCANO
+
 
 class AudioModelType(Enum):
     TTS_1 = "tts-1"

{camel_ai-0.2.26.dist-info → camel_ai-0.2.28.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.26
+Version: 0.2.28
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel

{camel_ai-0.2.26.dist-info → camel_ai-0.2.28.dist-info}/RECORD

@@ -1,4 +1,4 @@
-camel/__init__.py,sha256=vUQIqmv9Y3SKQSw2mOa58Ppfzinc5zLe5psIFxbYhSI,912
+camel/__init__.py,sha256=cKkedYUg0x2fhS1OE-zLWTVrZa2yHjvkSYZ6n0mamWA,912
 camel/generators.py,sha256=JRqj9_m1PF4qT6UtybzTQ-KBT9MJQt18OAAYvQ_fr2o,13844
 camel/human.py,sha256=9X09UmxI2JqQnhrFfnZ3B9EzFmVfdSWQcjLWTIXKXe0,4962
 camel/logger.py,sha256=j6mPsLJyKOn16o6Um57882mHsURQ8h-jia6Jd_34wRA,4239
@@ -134,11 +134,11 @@ camel/messages/conversion/sharegpt/__init__.py,sha256=oWUuHV5w85kxqhz_hoElLmCfzL
 camel/messages/conversion/sharegpt/function_call_formatter.py,sha256=cn7e7CfmxEVFlfOqhjhNuA8nuWvWD6hXYn-3okXNxxQ,1832
 camel/messages/conversion/sharegpt/hermes/__init__.py,sha256=mxuMSm-neaTgInIjYXuIVdC310E6jKJzM3IdtaJ4qY4,812
 camel/messages/conversion/sharegpt/hermes/hermes_function_formatter.py,sha256=-9TT8iOQ-ieKSKR_PmJSA5Bi0uBx-qR7WQ6vxuFkorM,4639
-camel/models/__init__.py,sha256=30gJOmde3TS-j5I4m0hrxI5BJDd2H3UA1hxQD9TQzGE,2637
+camel/models/__init__.py,sha256=iNZ1LcesJ3YaAbNRxHTA-sUaxfjn6gUQ-EQArll21KQ,2769
 camel/models/_utils.py,sha256=hob1ehnS5xZitMCdYToHVgaTB55JnaP4_DSWnTEfVsg,2045
 camel/models/aiml_model.py,sha256=4FW66DxmVMPWAJckh4UjMM6eD1QNyrAPAPtrpmWxzjc,6524
 camel/models/anthropic_model.py,sha256=8XAj9sVaN1X0hvrL9a-qsmkAFWoGe1Ozj5XZsXYe1UI,5894
-camel/models/azure_openai_model.py,sha256=WBxnR-UNnBw49zyLxqF_d-7VKWTjBPnNR_xMvhWrggI,7471
+camel/models/azure_openai_model.py,sha256=l8hqhRQyxtkPR9mUq6fzbeL3ARjGxE8aht_GhiWC-r4,10383
 camel/models/base_audio_model.py,sha256=QkLqh0v-5kcE_jwFB5xAgvztAqB2Bot4_iG9sZdcl8A,2986
 camel/models/base_model.py,sha256=RolL8fRwVpfz8g9lpb_71h0mYTNl-U63f8KBy6hc3E0,10679
 camel/models/cohere_model.py,sha256=RAYHCyppDQxQ7BOR-e314AagB09vRxoScoHc-FtL6Bc,13355
@@ -149,23 +149,24 @@ camel/models/groq_model.py,sha256=FgXOHmIKAxGFASUmmk5tK49bPcXsr7diB3zRFGg9XDA,73
 camel/models/internlm_model.py,sha256=4nr5LXhxBfOjm-0i65pXyaS0_sT5oAXKXaUfkijAGmQ,5612
 camel/models/litellm_model.py,sha256=xi4kDd0FKuznKtox8ArsB39u40ueOhcb-CpWv4bcbXw,5544
 camel/models/mistral_model.py,sha256=OB948fRVnXikVIDO3PqxV0zb_qpwwta0DIW1bbX3SYI,11666
-camel/models/model_factory.py,sha256=1PgJdifxYYqQ9VnZRrEER7nKjz2X07uHwPMxg454Alk,6732
+camel/models/model_factory.py,sha256=GdjGCxslqe04oWvpfiOdPl0ZGzuGooeA9M8ppby6hFo,6863
 camel/models/model_manager.py,sha256=gfpL-WUxuTXgNeCkIVg8Y0zRvxMqRLX8JGt0XEAPQ8Y,9214
 camel/models/moonshot_model.py,sha256=DNZzDYz0AWU1q6pIvbPALqesejoawwuKzeP0_ZbjDSg,6149
 camel/models/nemotron_model.py,sha256=jJrW8tpTlEJDT1FjflB9krhgEQhD5KBeLmyUIcZvWPk,3886
 camel/models/nvidia_model.py,sha256=lqp1iPwVDq6zSQ9B0SyBZ48Z3J5WbXwPshwlhj1ogZ8,6711
 camel/models/ollama_model.py,sha256=byJ0YbMlilEFRKJZIot-MPUcojwMHLIaBES0a1SURtg,10604
 camel/models/openai_audio_models.py,sha256=fYpxFvxT8p93KVb5BYODTuI5wdNXV9pu_bvxfARgVYk,13193
-camel/models/openai_compatible_model.py,sha256=9fzV3EtcE5YFZ5-rYYMoWVmqjjcGfC7rDml5Ngoz6Fs,5299
+camel/models/openai_compatible_model.py,sha256=Nmps04Fo0ILmynE8wbKVzTrQ0VDyOrDR1ICD1nGrjd0,8142
 camel/models/openai_model.py,sha256=CbfD9yVtAltyqdFpjnLXncFnmaGPDZq8JhJDaSfG0pc,10186
 camel/models/qwen_model.py,sha256=_LeeB0yrXRMI-gZOEEOHg0bWNOJpuQHf2G7u40--3r8,7064
 camel/models/reka_model.py,sha256=15DscZf3lbqsIzm6kzjzDrhblBt1_0xlphT4isuQMu0,10146
 camel/models/samba_model.py,sha256=i2k1qEbMMMhYDY5MWG3dqyy2oeDi43o35JZXLvDmvI0,22476
-camel/models/sglang_model.py,sha256=LsuilXBPCs48pVRW862T3QCiOVcFACBqiFxbWPiHbeg,13750
+camel/models/sglang_model.py,sha256=lAxWpArP74lQ3E2IG-tEtBbs5ZRQPwKMfThvWSq1nFg,13782
 camel/models/siliconflow_model.py,sha256=c5vk4zAhZVf8pDF1uh-iSa_v8d0QoPLuIN27EemdMGE,5659
 camel/models/stub_model.py,sha256=dygYoxemnWWaxEX21L8QyKe-c75ti2CK9HnTuyHL5vs,5160
 camel/models/togetherai_model.py,sha256=-YwZV1S1bkrX8jGguQI5dbtIHVuqhv96MoAcl33ptPo,6657
-camel/models/vllm_model.py,sha256=dzH4rYr2Se7cejk2hobblaW-s483uxPxb8976RQE8x0,6884
+camel/models/vllm_model.py,sha256=xhZ2NbPCtgDCxu4QpJ2-Q8klqsqOKfJvFEatmZDwdQY,7706
+camel/models/volcano_model.py,sha256=inYDiKOfGvq8o3XW4KVQIrXiZOhXQfB4HfCHGCWHPKs,3792
 camel/models/yi_model.py,sha256=V4sc9n8MAKVfjGO-NU0I8W4lGKdORSCbMV020SHT3R0,6180
 camel/models/zhipuai_model.py,sha256=o3uoTY30p1yUIklvoRMyr8JX39xZ5mLVKSTtUknW8nE,6517
 camel/models/reward/__init__.py,sha256=MqPN6wXh7Y1SoeNoFlYaMG6xHzLG0CYsv_3kB2atIQk,984
@@ -233,7 +234,7 @@ camel/storages/graph_storages/__init__.py,sha256=G29BNn651C0WTOpjCl4QnVM-4B9tcNh
 camel/storages/graph_storages/base.py,sha256=uSe9jWuLudfm5jtfo6E-L_kNzITwK1_Ef-6L4HWw-JM,2852
 camel/storages/graph_storages/graph_element.py,sha256=X_2orbQOMaQd00xxzAoJLfEcrVNE1mgCqMJv0orMAKA,2733
 camel/storages/graph_storages/nebula_graph.py,sha256=iLcHrIgd5U59GXlcLtLBAI8vNFpqHHLHHFmHTceVVLc,22816
-camel/storages/graph_storages/neo4j_graph.py,sha256=FBOH19VvEU3vXcM1Kuel88hVb2v1K_AKAZob4NmG9m0,30713
+camel/storages/graph_storages/neo4j_graph.py,sha256=Ng7fLCUrWhdFAd4d6UEpuAB6B6QgxbHmv8d8XDNOVJc,30773
 camel/storages/key_value_storages/__init__.py,sha256=le_hl7MYoQvaiYaJHwomy8c0cvTemicZbmwxgCJUpOs,962
 camel/storages/key_value_storages/base.py,sha256=FSfxeLuG7SPvn-Mg-OQxtRKPtQBnRkB7lYeDaFOefpk,2177
 camel/storages/key_value_storages/in_memory.py,sha256=k04Nx53lYxD5MoqDtBEgZrQYkAQ-zIuU6tqnoNqiHws,1949
@@ -255,11 +256,12 @@ camel/terminators/__init__.py,sha256=t8uqrkUnXEOYMXQDgaBkMFJ0EXFKI0kmx4cUimli3Ls
 camel/terminators/base.py,sha256=xmJzERX7GdSXcxZjAHHODa0rOxRChMSRboDCNHWSscs,1511
 camel/terminators/response_terminator.py,sha256=n3G5KP6Oj7-7WlRN0yFcrtLpqAJKaKS0bmhrWlFfCgQ,4982
 camel/terminators/token_limit_terminator.py,sha256=YWv6ZR8R9yI2Qnf_3xES5bEE_O5bb2CxQ0EUXfMh34c,2118
-camel/toolkits/__init__.py,sha256=1MKp0Md0TtpI55l5EjX6vQg6nq7nUa996ARMLh2HEHc,3687
+camel/toolkits/__init__.py,sha256=qFCITSR1oSHHsE37XVh9Rq0V74Wj3NNAH1HhBBLuRSA,3724
 camel/toolkits/arxiv_toolkit.py,sha256=d0Zn8LQGENhtlZ0BHlDr1pUV8xHOc6TOenAaKgbelu8,6279
 camel/toolkits/ask_news_toolkit.py,sha256=PAxio8I2eTau9TgOu1jyFC9fsHhvGb-aLIkroWPtwx4,23268
 camel/toolkits/audio_analysis_toolkit.py,sha256=LC0C6SEIwko8HqkT-C3ub6Ila2PfuIbKLBOEjrrF6BE,8552
 camel/toolkits/base.py,sha256=7WRovKrz380b25lYdwT-2FCXzS3dkllOjT53hmmCg_I,1999
+camel/toolkits/browser_toolkit.py,sha256=Pbw7CoiHPtbFQagmXvCUiVHihCXwaN6uUbwCAfC-jso,51016
 camel/toolkits/code_execution.py,sha256=seqTtjulBZXH4qd5m2YAXQaxyL2_n2ekmqsYB-wBxvw,4547
 camel/toolkits/dalle_toolkit.py,sha256=Usmw3JiJErLQgWSB1qKq_bOACNwbUTQPFc_EsVzTrGo,5115
 camel/toolkits/dappier_toolkit.py,sha256=_69IAmXE2QSbwGxnSEycaV2XrrkiM5wKI6heM7-4MfU,8175
@@ -274,7 +276,7 @@ camel/toolkits/human_toolkit.py,sha256=9CjB1flGXIx7mzkIliDjcwXATUvZNdrRCKWyEgR9E
 camel/toolkits/image_analysis_toolkit.py,sha256=dpvT8n49s8B8AhJ8aFdy4OONb8E8r_Cwxpx-ByFruy8,7209
 camel/toolkits/linkedin_toolkit.py,sha256=9e7R6YXTeW5aM5o_eOv3YbnJE1ifw5HgaM-pMA-9rqU,7996
 camel/toolkits/math_toolkit.py,sha256=5yVF0bKuwkZIV01uICd3TOfktXlTERjKt4DrFyz_oaE,3639
-camel/toolkits/mcp_toolkit.py,sha256=bgLUDjH0uwXeqOoU8mac97kb6f7eP2DHnGCbaCyBqKU,9112
+camel/toolkits/mcp_toolkit.py,sha256=emglu4H4Kg_CGku9_8xKUqUwCzjXCIlgilGT-v7qlPE,17647
 camel/toolkits/meshy_toolkit.py,sha256=Fd6sQV2JtduxyvHxCBA0_zl2OCgJRAlvDEe58hX8gRg,6463
 camel/toolkits/mineru_toolkit.py,sha256=vRX9LholLNkpbJ6axfEN4pTG85aWb0PDmlVy3rAAXhg,6868
 camel/toolkits/networkx_toolkit.py,sha256=zsP95kst12Q-knafxixlSXdXr3sXjehCXZn7330bsEo,8483
@@ -285,7 +287,7 @@ camel/toolkits/page_script.js,sha256=gypbuQ_gn_oa3rQDoCN_q-kJ0jND1eSvY-30PufPZmQ
 camel/toolkits/pubmed_toolkit.py,sha256=vrd5GIhSYt9Z8EHaWkFb0x9i6_TP7pQZc7jlLHSol04,12180
 camel/toolkits/reddit_toolkit.py,sha256=cTqEq1CRaLq9XxUHkHCmd09tRzb5Mz_bUs2JV58ewrs,8012
 camel/toolkits/retrieval_toolkit.py,sha256=y_mQtknrSIDDXSyQb-4FY6ahV_mOxkBhDkA2eMIVnz0,3801
-camel/toolkits/search_toolkit.py,sha256=4yTYkook3E3Yb-EOaio2O6FBcvzIXlVVC4WOvNSaYcw,29881
+camel/toolkits/search_toolkit.py,sha256=KxJMB8tz37uyqlzHSK9X28hSZZMK793aOwkYT8jBnGc,32131
 camel/toolkits/semantic_scholar_toolkit.py,sha256=Kp-5rz99rkeUsUmk5ShQdNKJRGVs78hQvCNg-NQMFDk,11547
 camel/toolkits/slack_toolkit.py,sha256=n8cn3kZIc27B-2KMTRK6Nsdan37SwMqBiBi1PMtuUvQ,10744
 camel/toolkits/stripe_toolkit.py,sha256=1sCywkpo8mh4E_KwxFKLhAb-G5uZ47NXXQvcddThjqg,9781
@@ -295,7 +297,6 @@ camel/toolkits/twitter_toolkit.py,sha256=a2OLSJSW2wY7pOwOApb1qchZPXzH22Rbgm9Yd7-
 camel/toolkits/video_analysis_toolkit.py,sha256=lDAY6YP1zXykSxt8Qanf0WZR3l1p8c4akKPkaF5R3wU,15064
 camel/toolkits/video_download_toolkit.py,sha256=XjZICJTOG4dmKxfkHxYxmBMFESsOX51GvTeQXAQslMU,7104
 camel/toolkits/weather_toolkit.py,sha256=qHAMD56zqd5GWnEWiaA_0aBDwvgacdx0pAHScinY4GY,6965
-camel/toolkits/web_toolkit.py,sha256=DapiYYP95EFMVB1hU38a052nUPs4L5WdE25o_74h1Cw,48407
 camel/toolkits/whatsapp_toolkit.py,sha256=MBY92WLLptkXxnl4Ky5erGwI415XLFFGu9i2q6_b0oQ,5736
 camel/toolkits/zapier_toolkit.py,sha256=mgYxRGPw7_VZVj0xU9XwHewqFcV49eUjvuum_IHfuNs,6854
 camel/toolkits/open_api_specs/security_config.py,sha256=ZVnBa_zEifaE_ao2xsvV5majuJHpn2Tn7feMDOnj-eo,898
@@ -324,7 +325,7 @@ camel/toolkits/open_api_specs/web_scraper/openapi.yaml,sha256=u_WalQ01e8W1D27VnZ
 camel/toolkits/open_api_specs/web_scraper/paths/__init__.py,sha256=OKCZrQCDwaWtXIN_2rA9FSqEvgpQRieRoHh7Ek6N16A,702
 camel/toolkits/open_api_specs/web_scraper/paths/scraper.py,sha256=aWy1_ppV4NVVEZfnbN3tu9XA9yAPAC9bRStJ5JuXMRU,1117
 camel/types/__init__.py,sha256=VLWhAt857IFct3XepY5BNOIhyhDhfmODTezr9jhO_TI,2251
-camel/types/enums.py,sha256=h5UFYF6l2o1ITHClfAB79WU9GhbqFwHPTb3Lx3VYAgQ,34126
+camel/types/enums.py,sha256=b3KZqTbenkWSxC7QrgR_rYO1bV8tpcmTczwofOiByJA,34343
 camel/types/openai_types.py,sha256=8ZFzLe-zGmKNPfuVZFzxlxAX98lGf18gtrPhOgMmzus,2104
 camel/types/unified_model_type.py,sha256=GP5GYtA3RfvLsqnk1c4UcOaRKMFhjDgZrLr0ln6JFw8,4253
 camel/types/agents/__init__.py,sha256=cbvVkogPoZgcwZrgxLH6EtpGXk0kavF79nOic0Dc1vg,786
@@ -340,7 +341,7 @@ camel/verifiers/__init__.py,sha256=p6UEyvaOlwUQaFACGB4C07fL1xSnpTouElt19YRuneQ,9
 camel/verifiers/base.py,sha256=efWZV9g58IHzJ24U4zr109y34CaAi8tV9WZPMCzP3YI,12017
 camel/verifiers/models.py,sha256=hC6m_YxEX-mqi_tkCNZHZWLBWf04ZTyv5vfKR-BEyU4,2818
 camel/verifiers/python_verifier.py,sha256=bj-UGxeJTZzxVVa3a8IEQ1lNOpSaaW3JdGnUEoPeQD0,7519
-camel_ai-0.2.26.dist-info/METADATA,sha256=md1wlHHOxnVY3b-m7kkN8AbotAoAioTx8SshfLOm5BI,37992
-camel_ai-0.2.26.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-camel_ai-0.2.26.dist-info/licenses/LICENSE,sha256=id0nB2my5kG0xXeimIu5zZrbHLS6EQvxvkKkzIHaT2k,11343
-camel_ai-0.2.26.dist-info/RECORD,,
+camel_ai-0.2.28.dist-info/METADATA,sha256=Osjure3q4QVC_wQGuxycpqgoLipQVkwyOu_AudKOrkU,37992
+camel_ai-0.2.28.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+camel_ai-0.2.28.dist-info/licenses/LICENSE,sha256=id0nB2my5kG0xXeimIu5zZrbHLS6EQvxvkKkzIHaT2k,11343
+camel_ai-0.2.28.dist-info/RECORD,,