camel-ai 0.2.65__py3-none-any.whl → 0.2.83a6__py3-none-any.whl

camel/toolkits/page_script.js

@@ -1,6 +1,6 @@
 var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
     let nextLabel = 10;
-  
+
     let roleMapping = {
         "a": "link",
         "area": "link",
@@ -22,23 +22,23 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         "option": "option",
         "textarea": "textbox"
     };
-  
+
     let getCursor = function(elm) {
         return window.getComputedStyle(elm)["cursor"];
     };
-  
+
     let getInteractiveElements = function() {
-  
+
         let results = []
         let roles = ["scrollbar", "searchbox", "slider", "spinbutton", "switch", "tab", "treeitem", "button", "checkbox", "gridcell", "link", "menuitem", "menuitemcheckbox", "menuitemradio", "option", "progressbar", "radio", "textbox", "combobox", "menu", "tree", "treegrid", "grid", "listbox", "radiogroup", "widget"];
         let inertCursors = ["auto", "default", "none", "text", "vertical-text", "not-allowed", "no-drop"];
-  
+
         // Get the main interactive elements
         let nodeList = document.querySelectorAll("input, select, textarea, button, [href], [onclick], [contenteditable], [tabindex]:not([tabindex='-1'])");
         for (let i=0; i<nodeList.length; i++) { // Copy to something mutable
             results.push(nodeList[i]);
         }
-  
+
         // Anything not already included that has a suitable role
         nodeList = document.querySelectorAll("[role]");
         for (let i=0; i<nodeList.length; i++) { // Copy to something mutable
@@ -49,34 +49,34 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
             }
         }
         }
-  
+
         // Any element that changes the cursor to something implying interactivity
         nodeList = document.querySelectorAll("*");
         for (let i=0; i<nodeList.length; i++) {
            let node = nodeList[i];
-  
+
            // Cursor is default, or does not suggest interactivity
            let cursor = getCursor(node);
            if (inertCursors.indexOf(cursor) >= 0) {
                continue;
            }
-  
+
            // Move up to the first instance of this cursor change
            parent = node.parentNode;
            while (parent && getCursor(parent) == cursor) {
                node = parent;
            parent = node.parentNode;
            }
-  
+
            // Add the node if it is new
            if (results.indexOf(node) == -1) {
                results.push(node);
            }
         }
-  
+
         return results;
     };
-  
+
     let labelElements = function(elements) {
         for (let i=0; i<elements.length; i++) {
             if (!elements[i].hasAttribute("__elementId")) {
@@ -84,22 +84,22 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
             }
         }
     };
-  
+
     let isTopmost = function(element, x, y) {
        let hit = document.elementFromPoint(x, y);
-  
+
        // Hack to handle elements outside the viewport
        if (hit === null) {
-           return true; 
+           return true;
        }
-  
+
        while (hit) {
            if (hit == element) return true;
            hit = hit.parentNode;
        }
        return false;
     };
-  
+
     let getFocusedElementId = function() {
        let elm = document.activeElement;
        while (elm) {
@@ -110,7 +110,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
        }
        return null;
     };
-  
+
     let trimmedInnerText = function(element) {
         if (!element) {
             return "";
@@ -121,7 +121,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         }
         return text.trim();
     };
-  
+
     let getApproximateAriaName = function(element) {
         // Check for aria labels
         if (element.hasAttribute("aria-labelledby")) {
@@ -135,11 +135,11 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
             }
         return buffer.trim();
         }
-  
+
         if (element.hasAttribute("aria-label")) {
         return element.getAttribute("aria-label");
         }
-  
+
         // Check for labels
         if (element.hasAttribute("id")) {
             let label_id = element.getAttribute("id");
@@ -153,29 +153,29 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
                 return label;
             }
         }
-  
+
         if (element.parentElement && element.parentElement.tagName == "LABEL") {
             return element.parentElement.innerText;
         }
-  
+
         // Check for alt text or titles
         if (element.hasAttribute("alt")) {
         return element.getAttribute("alt")
         }
-  
+
         if (element.hasAttribute("title")) {
         return element.getAttribute("title")
         }
-  
+
         return trimmedInnerText(element);
     };
-  
+
     let getApproximateAriaRole = function(element) {
         let tag = element.tagName.toLowerCase();
         if (tag == "input" && element.hasAttribute("type")) {
             tag = tag + ", type=" + element.getAttribute("type");
         }
-  
+
         if (element.hasAttribute("role")) {
             return [element.getAttribute("role"), tag];
         }
@@ -186,20 +186,20 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         return ["", tag];
         }
     };
-  
+
     let getInteractiveRects = function() {
         labelElements(getInteractiveElements());
         let elements = document.querySelectorAll("[__elementId]");
         let results = {};
         let scale = window.devicePixelRatio || 1;
-    
+
         for (let i = 0; i < elements.length; i++) {
             let key = elements[i].getAttribute("__elementId");
             let rects = elements[i].getClientRects();
             let ariaRole = getApproximateAriaRole(elements[i]);
             let ariaName = getApproximateAriaName(elements[i]);
             let vScrollable = elements[i].scrollHeight - elements[i].clientHeight >= 1;
-    
+
             let record = {
                 "tag_name": ariaRole[1],
                 "role": ariaRole[0],
@@ -207,7 +207,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
                 "v-scrollable": vScrollable,
                 "rects": []
             };
-    
+
             for (const rect of rects) {
                 let x = rect.left + rect.width / 2;
                 let y = rect.top + rect.height / 2;
@@ -224,15 +224,15 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
                     });
                 }
             }
-    
+
             if (record["rects"].length > 0) {
                 results[key] = record;
             }
         }
-    
+
         return results;
-    };    
-  
+    };
+
     let getVisualViewport = function() {
         let vv = window.visualViewport;
         let de = document.documentElement;
@@ -250,7 +250,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         "scrollHeight": de ? de.scrollHeight : 0
         };
     };
-  
+
     let _getMetaTags = function() {
         let meta = document.querySelectorAll("meta");
         let results = {};
@@ -271,7 +271,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         }
         return results;
     };
-  
+
     let _getJsonLd = function() {
         let jsonld = [];
         let scripts = document.querySelectorAll('script[type="application/ld+json"]');
@@ -280,13 +280,13 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
         }
         return jsonld;
      };
-  
+
      // From: https://www.stevefenton.co.uk/blog/2022/12/parse-microdata-with-javascript/
      let _getMicrodata = function() {
         function sanitize(input) {
             return input.replace(/\s/gi, ' ').trim();
         }
-  
+
         function addValue(information, name, value) {
             if (information[name]) {
                 if (typeof information[name] === 'array') {
@@ -301,29 +301,29 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
                 information[name] = value;
             }
         }
-  
+
         function traverseItem(item, information) {
            const children = item.children;
-          
+
            for (let i = 0; i < children.length; i++) {
                const child = children[i];
-  
+
                if (child.hasAttribute('itemscope')) {
                    if (child.hasAttribute('itemprop')) {
                        const itemProp = child.getAttribute('itemprop');
                        const itemType = child.getAttribute('itemtype');
-  
+
                        const childInfo = {
                            itemType: itemType
                        };
-  
+
                        traverseItem(child, childInfo);
-  
+
                        itemProp.split(' ').forEach(propName => {
                            addValue(information, propName, childInfo);
                        });
                    }
-  
+
                } else if (child.hasAttribute('itemprop')) {
                    const itemProp = child.getAttribute('itemprop');
                    itemProp.split(' ').forEach(propName => {
@@ -339,9 +339,9 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
                }
            }
         }
-  
+
         const microdata = [];
-  
+
         document.querySelectorAll("[itemscope]").forEach(function(elem, i) {
            const itemType = elem.getAttribute('itemtype');
            const information = {
@@ -350,10 +350,10 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
            traverseItem(elem, information);
            microdata.push(information);
         });
-      
+
         return microdata;
      };
-  
+
      let getPageMetadata = function() {
          let jsonld = _getJsonLd();
          let metaTags = _getMetaTags();
@@ -362,7 +362,7 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
          if (jsonld.length > 0) {
              try {
                  results["jsonld"] = JSON.parse(jsonld);
-             } 
+             }
          catch (e) {
                  results["jsonld"] = jsonld;
          }
@@ -377,8 +377,8 @@ var MultimodalWebSurfer = MultimodalWebSurfer || (function() {
              }
          }
          return results;
-     };	
-  
+     };
+
      return {
          getInteractiveRects: getInteractiveRects,
          getVisualViewport: getVisualViewport,

camel/toolkits/playwright_mcp_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,16 +10,14 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from typing import List, Optional
 
-from camel.toolkits import BaseToolkit, FunctionTool
-
 from .mcp_toolkit import MCPToolkit
 
 
-class PlaywrightMCPToolkit(BaseToolkit):
+class PlaywrightMCPToolkit(MCPToolkit):
     r"""PlaywrightMCPToolkit provides an interface for interacting with web
     browsers using the Playwright automation library through the Model Context
     Protocol (MCP).
@@ -51,32 +49,16 @@ class PlaywrightMCPToolkit(BaseToolkit):
                 `["--cdp-endpoint=http://localhost:9222"]`.
                 (default: :obj:`None`)
         """
-        super().__init__(timeout=timeout)
-
-        self._mcp_toolkit = MCPToolkit(
-            config_dict={
-                "mcpServers": {
-                    "playwright": {
-                        "command": "npx",
-                        "args": ["@playwright/mcp@latest"]
-                        + (additional_args or []),
-                    }
+        # Create config for Playwright MCP server
+        config_dict = {
+            "mcpServers": {
+                "playwright": {
+                    "command": "npx",
+                    "args": ["@playwright/mcp@latest"]
+                    + (additional_args or []),
                 }
             }
-        )
-
-    async def connect(self):
-        r"""Explicitly connect to the Playwright MCP server."""
-        await self._mcp_toolkit.connect()
+        }
 
-    async def disconnect(self):
-        r"""Explicitly disconnect from the Playwright MCP server."""
-        await self._mcp_toolkit.disconnect()
-
-    def get_tools(self) -> List[FunctionTool]:
-        r"""Returns a list of tools provided by the PlaywrightMCPToolkit.
-
-        Returns:
-            List[FunctionTool]: List of available tools.
-        """
-        return self._mcp_toolkit.get_tools()
+        # Initialize parent MCPToolkit with Playwright configuration
+        super().__init__(config_dict=config_dict, timeout=timeout)

camel/toolkits/pptx_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,7 +10,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 
 
 import os
@@ -53,22 +53,35 @@ class PPTXToolkit(BaseToolkit):
 
     def __init__(
         self,
-        output_dir: str = "./",
+        working_directory: Optional[str] = None,
         timeout: Optional[float] = None,
     ) -> None:
         r"""Initialize the PPTXToolkit.
 
         Args:
-            output_dir (str): The default directory for output files.
-                Defaults to the current working directory.
+            working_directory (str, optional): The default directory for
+                output files. If not provided, it will be determined by the
+                `CAMEL_WORKDIR` environment variable (if set). If the
+                environment variable is not set, it defaults to
+                `camel_working_dir`.
             timeout (Optional[float]): The timeout for the toolkit.
-                (default: :obj: `None`)
+                (default: :obj:`None`)
         """
         super().__init__(timeout=timeout)
-        self.output_dir = Path(output_dir).resolve()
-        self.output_dir.mkdir(parents=True, exist_ok=True)
+
+        if working_directory:
+            self.working_directory = Path(working_directory).resolve()
+        else:
+            camel_workdir = os.environ.get("CAMEL_WORKDIR")
+            if camel_workdir:
+                self.working_directory = Path(camel_workdir).resolve()
+            else:
+                self.working_directory = Path("./camel_working_dir").resolve()
+
+        self.working_directory.mkdir(parents=True, exist_ok=True)
         logger.info(
-            f"PPTXToolkit initialized with output directory: {self.output_dir}"
+            f"PPTXToolkit initialized with output directory: "
+            f"{self.working_directory}"
         )
 
     def _resolve_filepath(self, file_path: str) -> Path:
@@ -87,7 +100,7 @@ class PPTXToolkit(BaseToolkit):
         """
         path_obj = Path(file_path)
         if not path_obj.is_absolute():
-            path_obj = self.output_dir / path_obj
+            path_obj = self.working_directory / path_obj
 
         sanitized_filename = self._sanitize_filename(path_obj.name)
         path_obj = path_obj.parent / sanitized_filename
@@ -120,7 +133,7 @@ class PPTXToolkit(BaseToolkit):
             frame_paragraph: The paragraph to format.
             text (str): The text to format.
             set_color_to_white (bool): Whether to set the color to white.
-                (default: :obj: `False`)
+                (default: :obj:`False`)
         """
         from pptx.dml.color import RGBColor
 
@@ -170,7 +183,7 @@ class PPTXToolkit(BaseToolkit):
             flat_items_list (List[Tuple[str, int]]): The list of items to be
                 displayed.
             set_color_to_white (bool): Whether to set the font color to white.
-                (default: :obj: `False`)
+                (default: :obj:`False`)
         """
         if not flat_items_list:
             logger.warning("Empty bullet point list provided")
@@ -260,7 +273,7 @@ class PPTXToolkit(BaseToolkit):
                 provided, the default template will be used. (default: :obj:
                 `None`)
         """
-        import pptx
+        from pptx import Presentation
 
         # Use template if provided, otherwise create new presentation
         if template is not None:
@@ -270,9 +283,9 @@ class PPTXToolkit(BaseToolkit):
                     f"Template file not found: {template_path}, using "
                     "default template"
                 )
-                presentation = pptx.Presentation()
+                presentation = Presentation()
             else:
-                presentation = pptx.Presentation(str(template_path))
+                presentation = Presentation(str(template_path))
                 # Clear all existing slides by removing them from the slide
                 # list
                 while len(presentation.slides) > 0:
@@ -280,7 +293,7 @@ class PPTXToolkit(BaseToolkit):
                     presentation.part.drop_rel(rId)
                     del presentation.slides._sldIdLst[-1]
         else:
-            presentation = pptx.Presentation()
+            presentation = Presentation()
 
         slide_width_inch, slide_height_inch = (
             self._get_slide_width_height_inches(presentation)
@@ -365,10 +378,10 @@ class PPTXToolkit(BaseToolkit):
                     * Table slides: {"heading": str, "table": {"headers": list
                     of str, "rows": list of list of str}}
             filename (str): The name or path of the file. If a relative path is
-                supplied, it is resolved to self.output_dir.
+                supplied, it is resolved to self.working_directory.
             template (Optional[str]): The path to the template PPTX file.
                 Initializes a presentation from a given template file Or PPTX
-                file. (default: :obj: `None`)
+                file. (default: :obj:`None`)
 
         Returns:
             str: A success message indicating the file was created.
@@ -667,8 +680,8 @@ class PPTXToolkit(BaseToolkit):
             slide_width_inch (float): The width of the slide in inches.
             slide_height_inch (float): The height of the slide in inches.
         """
-        import pptx
         from pptx.enum.shapes import MSO_AUTO_SHAPE_TYPE
+        from pptx.enum.text import MSO_ANCHOR, PP_ALIGN
         from pptx.util import Inches, Pt
 
         steps = slide_json['bullet_points']
@@ -697,8 +710,8 @@ class PPTXToolkit(BaseToolkit):
                 text_frame = shape.text_frame
                 text_frame.clear()
                 paragraph = text_frame.paragraphs[0]
-                paragraph.alignment = pptx.enum.text.PP_ALIGN.CENTER
-                text_frame.vertical_anchor = pptx.enum.text.MSO_ANCHOR.MIDDLE
+                paragraph.alignment = PP_ALIGN.CENTER
+                text_frame.vertical_anchor = MSO_ANCHOR.MIDDLE
                 self._format_text(
                     paragraph, step.removeprefix(STEP_BY_STEP_PROCESS_MARKER)
                 )
@@ -719,8 +732,8 @@ class PPTXToolkit(BaseToolkit):
                 text_frame = shape.text_frame
                 text_frame.clear()
                 paragraph = text_frame.paragraphs[0]
-                paragraph.alignment = pptx.enum.text.PP_ALIGN.CENTER
-                text_frame.vertical_anchor = pptx.enum.text.MSO_ANCHOR.MIDDLE
+                paragraph.alignment = PP_ALIGN.CENTER
+                text_frame.vertical_anchor = MSO_ANCHOR.MIDDLE
                 self._format_text(
                     paragraph, step.removeprefix(STEP_BY_STEP_PROCESS_MARKER)
                 )

camel/toolkits/pubmed_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,7 +10,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from typing import Any, Dict, List, Optional, Union, cast
 

camel/toolkits/pulse_mcp_search_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,7 +10,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 from typing import Any, Dict, List, Optional
 
 import requests

camel/toolkits/pyautogui_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,7 +10,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 
 import os
 import time

camel/toolkits/reddit_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,7 +10,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
 
 import os
 import time