camel-ai 0.2.76a1__tar.gz → 0.2.76a3__tar.gz

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.76a1
+Version: 0.2.76a3
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel
@@ -448,12 +448,52 @@ Join us ([*Discord*](https://discord.camel-ai.org/) or [*WeChat*](https://ghli.o
 </div>
 
 <div align="center">
-    <img src="docs/images/star.gif" alt="Star" width="186" height="60">
+    <img src="docs/images/stars.gif" alt="Star">
   </a>
 </div>
 
 <br>
 
+<details>
+<summary><kbd>Table of contents</kbd></summary>
+
+<br/>
+
+- [CAMEL Framework Design Principles](#camel-framework-design-principles)
+- [Why Use CAMEL for Your Research?](#why-use-camel-for-your-research)
+- [What Can You Build With CAMEL?](#what-can-you-build-with-camel)
+  - [Data Generation](#1-data-generation)
+  - [Task Automation](#2-task-automation)
+  - [World Simulation](#3-world-simulation)
+- [Quick Start](#quick-start)
+  - [Starting with ChatAgent](#starting-with-chatagent)
+  - [Seeking Help](#seeking-help)
+- [Tech Stack](#tech-stack)
+- [Research](#research)
+- [Synthetic Datasets](#synthetic-datasets)
+- [Cookbooks (Usecases)](#cookbooks-usecases)
+  - [Basic Concepts](#1-basic-concepts)
+  - [Advanced Features](#2-advanced-features)
+  - [Model Training & Data Generation](#3-model-training--data-generation)
+  - [Multi-Agent Systems & Applications](#4-multi-agent-systems--applications)
+  - [Data Processing](#5-data-processing)
+- [Real-World Usecases](#real-world-usecases)
+- [🧱 Built with CAMEL (Real-world Producs & Research)](#-built-with-camel-real-world-producs--research)
+  - [Research Projects](#research-projects)
+  - [Product Projects](#product-projects)
+- [🗓️ Events](#️-events)
+- [Contributing to CAMEL](#contributing-to-camel)
+- [Community & Contact](#community--contact)
+- [Citation](#citation)
+- [Acknowledgment](#acknowledgment)
+- [License](#license)
+
+####
+
+<br/>
+
+</details>
+
 
 ## CAMEL Framework Design Principles
 
@@ -687,6 +727,18 @@ We believe that studying these agents on a large scale offers valuable insights
 
 **Explore our research projects:**
 
+<div align="center">
+  <a href="https://github.com/camel-ai/owl">
+    <img src="docs/images/owl.png" alt="OWL">
+  </a>
+</div>
+
+<div align="center">
+  <a href="https://oasis.camel-ai.org/">
+    <img src="docs/images/oasis.png" alt="OASIS">
+  </a>
+</div>
+
 <div align="center">
   <a href="https://crab.camel-ai.org/">
     <img src="docs/images/crab.png" alt="CRAB">
@@ -694,14 +746,14 @@ We believe that studying these agents on a large scale offers valuable insights
 </div>
 
 <div align="center">
-  <a href="https://agent-trust.camel-ai.org/">
-    <img src="docs/images/agent_trust.png" alt="Agent Trust">
+  <a href="https://github.com/camel-ai/loong">
+    <img src="docs/images/loong.png" alt="Loong">
   </a>
 </div>
 
 <div align="center">
-  <a href="https://oasis.camel-ai.org/">
-    <img src="docs/images/oasis.png" alt="OASIS">
+  <a href="https://agent-trust.camel-ai.org/">
+    <img src="docs/images/agent_trust.png" alt="Agent Trust">
   </a>
 </div>
 
@@ -835,6 +887,31 @@ Real-world usecases demonstrating how CAMEL’s multi-agent framework enables re
 
 <br>
 
+## 🧱 Built with CAMEL (Real-world Producs & Research)
+<div align="left">
+  <a href="https://www.camel-ai.org/">
+    <img src="docs/images/built_with_CAMEL.png" alt="Built with CAMEL" height="40px">
+  </a>
+</div>
+
+### Research Projects
+
+| Name | Description |
+|:---|:---|
+| **[ChatDev](https://github.com/OpenBMB/ChatDev/tree/main/camel)** | Communicative Agents for software Development |
+| **[Paper2Poster](https://github.com/Paper2Poster/Paper2Poster)** | Multimodal poster automation from scientific papers |
+
+### Product Projects
+
+| Name | Description |
+|:---|:---|
+| **[Eigent](https://www.eigent.ai/)** | The World First Multi-agent Workforce |
+| **[EigentBot](https://bot.eigent.ai/)** | One EigentBot,
+Every Code Answer |
+| **[Matrix](https://matrix.eigent.ai/)** | Social Media Simulation |
+| **[AI Geometric](https://www.linkedin.com/posts/aigeometric_ai-interviewpreparation-careerdevelopment-activity-7261428422516555776-MtaK/?utm_source=share&utm_medium=member_desktop&rcm=ACoAAChHluEB9xRwkjiJ6VSAzqM2Y-U4NI2sKGY)** | AI-powered interview copilot |
+| **[Log10](https://github.com/log10-io/log10/blob/main/src/log10/agents/camel.py)** | AI accuracy, delivered |
+
 
 ## 🗓️ Events
 

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/README.md

@@ -51,12 +51,52 @@ Join us ([*Discord*](https://discord.camel-ai.org/) or [*WeChat*](https://ghli.o
 </div>
 
 <div align="center">
-    <img src="docs/images/star.gif" alt="Star" width="186" height="60">
+    <img src="docs/images/stars.gif" alt="Star">
   </a>
 </div>
 
 <br>
 
+<details>
+<summary><kbd>Table of contents</kbd></summary>
+
+<br/>
+
+- [CAMEL Framework Design Principles](#camel-framework-design-principles)
+- [Why Use CAMEL for Your Research?](#why-use-camel-for-your-research)
+- [What Can You Build With CAMEL?](#what-can-you-build-with-camel)
+  - [Data Generation](#1-data-generation)
+  - [Task Automation](#2-task-automation)
+  - [World Simulation](#3-world-simulation)
+- [Quick Start](#quick-start)
+  - [Starting with ChatAgent](#starting-with-chatagent)
+  - [Seeking Help](#seeking-help)
+- [Tech Stack](#tech-stack)
+- [Research](#research)
+- [Synthetic Datasets](#synthetic-datasets)
+- [Cookbooks (Usecases)](#cookbooks-usecases)
+  - [Basic Concepts](#1-basic-concepts)
+  - [Advanced Features](#2-advanced-features)
+  - [Model Training & Data Generation](#3-model-training--data-generation)
+  - [Multi-Agent Systems & Applications](#4-multi-agent-systems--applications)
+  - [Data Processing](#5-data-processing)
+- [Real-World Usecases](#real-world-usecases)
+- [🧱 Built with CAMEL (Real-world Producs & Research)](#-built-with-camel-real-world-producs--research)
+  - [Research Projects](#research-projects)
+  - [Product Projects](#product-projects)
+- [🗓️ Events](#️-events)
+- [Contributing to CAMEL](#contributing-to-camel)
+- [Community & Contact](#community--contact)
+- [Citation](#citation)
+- [Acknowledgment](#acknowledgment)
+- [License](#license)
+
+####
+
+<br/>
+
+</details>
+
 
 ## CAMEL Framework Design Principles
 
@@ -290,6 +330,18 @@ We believe that studying these agents on a large scale offers valuable insights
 
 **Explore our research projects:**
 
+<div align="center">
+  <a href="https://github.com/camel-ai/owl">
+    <img src="docs/images/owl.png" alt="OWL">
+  </a>
+</div>
+
+<div align="center">
+  <a href="https://oasis.camel-ai.org/">
+    <img src="docs/images/oasis.png" alt="OASIS">
+  </a>
+</div>
+
 <div align="center">
   <a href="https://crab.camel-ai.org/">
     <img src="docs/images/crab.png" alt="CRAB">
@@ -297,14 +349,14 @@ We believe that studying these agents on a large scale offers valuable insights
 </div>
 
 <div align="center">
-  <a href="https://agent-trust.camel-ai.org/">
-    <img src="docs/images/agent_trust.png" alt="Agent Trust">
+  <a href="https://github.com/camel-ai/loong">
+    <img src="docs/images/loong.png" alt="Loong">
   </a>
 </div>
 
 <div align="center">
-  <a href="https://oasis.camel-ai.org/">
-    <img src="docs/images/oasis.png" alt="OASIS">
+  <a href="https://agent-trust.camel-ai.org/">
+    <img src="docs/images/agent_trust.png" alt="Agent Trust">
   </a>
 </div>
 
@@ -438,6 +490,31 @@ Real-world usecases demonstrating how CAMEL’s multi-agent framework enables re
 
 <br>
 
+## 🧱 Built with CAMEL (Real-world Producs & Research)
+<div align="left">
+  <a href="https://www.camel-ai.org/">
+    <img src="docs/images/built_with_CAMEL.png" alt="Built with CAMEL" height="40px">
+  </a>
+</div>
+
+### Research Projects
+
+| Name | Description |
+|:---|:---|
+| **[ChatDev](https://github.com/OpenBMB/ChatDev/tree/main/camel)** | Communicative Agents for software Development |
+| **[Paper2Poster](https://github.com/Paper2Poster/Paper2Poster)** | Multimodal poster automation from scientific papers |
+
+### Product Projects
+
+| Name | Description |
+|:---|:---|
+| **[Eigent](https://www.eigent.ai/)** | The World First Multi-agent Workforce |
+| **[EigentBot](https://bot.eigent.ai/)** | One EigentBot,
+Every Code Answer |
+| **[Matrix](https://matrix.eigent.ai/)** | Social Media Simulation |
+| **[AI Geometric](https://www.linkedin.com/posts/aigeometric_ai-interviewpreparation-careerdevelopment-activity-7261428422516555776-MtaK/?utm_source=share&utm_medium=member_desktop&rcm=ACoAAChHluEB9xRwkjiJ6VSAzqM2Y-U4NI2sKGY)** | AI-powered interview copilot |
+| **[Log10](https://github.com/log10-io/log10/blob/main/src/log10/agents/camel.py)** | AI accuracy, delivered |
+
 
 ## 🗓️ Events
 

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/__init__.py

@@ -14,7 +14,7 @@
 
 from camel.logger import disable_logging, enable_logging, set_log_level
 
-__version__ = '0.2.76a1'
+__version__ = '0.2.76a3'
 
 __all__ = [
     '__version__',

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/environments/tic_tac_toe.py

@@ -483,7 +483,7 @@ class TicTacToeEnv(MultiStepEnv):
         # Check all win combinations.
         for a, b, c in TicTacToeEnv.WIN_COMBINATIONS:
             if board[a] != " " and board[a] == board[b] == board[c]:
-                return board[a]
+                return board[a]  # type: ignore[return-value]
         # Check for draw.
         if all(cell != " " for cell in board):
             return "draw"

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/models/base_model.py

@@ -24,6 +24,7 @@ from openai.lib.streaming.chat import (
 )
 from pydantic import BaseModel
 
+from camel.logger import get_logger as camel_get_logger
 from camel.messages import OpenAIMessage
 from camel.types import (
     ChatCompletion,
@@ -34,6 +35,21 @@ from camel.types import (
 )
 from camel.utils import BaseTokenCounter
 
+if os.environ.get("TRACEROOT_ENABLED", "False").lower() == "true":
+    try:
+        from traceroot import get_logger  # type: ignore[import]
+        from traceroot import trace as observe  # type: ignore[import]
+
+        logger = get_logger('base_model')
+    except ImportError:
+        from camel.utils import observe
+
+        logger = camel_get_logger('base_model')
+else:
+    from camel.utils import observe
+
+    logger = camel_get_logger('base_model')
+
 
 class ModelBackendMeta(abc.ABCMeta):
     r"""Metaclass that automatically preprocesses messages in run method.
@@ -364,6 +380,7 @@ class BaseModelBackend(ABC, metaclass=ModelBackendMeta):
         """
         pass
 
+    @observe()
     def run(
         self,
         messages: List[OpenAIMessage],
@@ -403,7 +420,13 @@ class BaseModelBackend(ABC, metaclass=ModelBackendMeta):
         elif not tools:
             tools = None
 
+        logger.info("Running model: %s", self.model_type)
+        logger.info("Messages: %s", messages)
+        logger.info("Response format: %s", response_format)
+        logger.info("Tools: %s", tools)
+
         result = self._run(messages, response_format, tools)
+        logger.info("Result: %s", result)
 
         # Log the response if logging is enabled
         if log_path:
@@ -411,6 +434,7 @@ class BaseModelBackend(ABC, metaclass=ModelBackendMeta):
 
         return result
 
+    @observe()
     async def arun(
         self,
         messages: List[OpenAIMessage],
@@ -448,7 +472,13 @@ class BaseModelBackend(ABC, metaclass=ModelBackendMeta):
         elif not tools:
             tools = None
 
+        logger.info("Running model: %s", self.model_type)
+        logger.info("Messages: %s", messages)
+        logger.info("Response format: %s", response_format)
+        logger.info("Tools: %s", tools)
+
         result = await self._arun(messages, response_format, tools)
+        logger.info("Result: %s", result)
 
         # Log the response if logging is enabled
         if log_path:

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/societies/workforce/workforce.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 import asyncio
 import concurrent.futures
 import json
+import os
 import time
 import uuid
 from collections import deque
@@ -79,7 +80,15 @@ from camel.utils import dependencies_required
 
 from .workforce_logger import WorkforceLogger
 
-logger = get_logger(__name__)
+if os.environ.get("TRACEROOT_ENABLED", "False").lower() == "true":
+    try:
+        import traceroot  # type: ignore[import]
+
+        logger = traceroot.get_logger('camel')
+    except ImportError:
+        logger = get_logger(__name__)
+else:
+    logger = get_logger(__name__)
 
 # Constants for configuration values
 MAX_TASK_RETRIES = 3

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/toolkits/hybrid_browser_toolkit/hybrid_browser_toolkit.py

@@ -25,6 +25,66 @@ class HybridBrowserToolkit(BaseToolkit):
     This wrapper allows users to choose between:
     - 'typescript': WebSocket-based implementation using TypeScript/Node.js
     - 'python': Pure Python implementation using Playwright directly
+
+    Args:
+        mode (Literal["typescript", "python"]): Implementation mode. -
+            'typescript': Uses WebSocket-based TypeScript implementation -
+            'python': Uses pure Python Playwright implementation. Defaults to
+            "typescript".
+        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/".
+        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.
+        log_dir (Optional[str]): Custom directory path for log files.
+            If None, defaults to "browser_log". Defaults to None.
+        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.
+            Defaults to False.
+        connect_over_cdp (bool): Whether to connect to an existing
+            browser via Chrome DevTools Protocol. Defaults to False.
+            (Only supported in TypeScript mode)
+        cdp_url (Optional[str]): WebSocket endpoint URL for CDP
+            connection. Required when connect_over_cdp is True.
+            Defaults to None. (Only supported in TypeScript mode)
+        cdp_keep_current_page (bool): When True and using CDP mode,
+        won't create new pages but use the existing one. Defaults to False.
+            (Only supported in TypeScript mode)
+        full_visual_mode (bool): When True, browser actions like click,
+            browser_open, visit_page, etc. will return 'full visual mode'
+            as snapshot instead of actual page content. The
+            browser_get_page_snapshot method will still return the actual
+            snapshot. Defaults to False.
+        **kwargs: Additional keyword arguments passed to the
+            implementation.
+
+    Returns:
+        HybridBrowserToolkit instance of the specified implementation.
     """
 
     def __new__(

{camel_ai-0.2.76a1 → camel_ai-0.2.76a3}/camel/toolkits/hybrid_browser_toolkit/ws_wrapper.py

@@ -109,6 +109,7 @@ class WebSocketBrowserWrapper:
         self._send_lock = asyncio.Lock()
         self._receive_task = None
         self._pending_responses: Dict[str, asyncio.Future[Dict[str, Any]]] = {}
+        self._browser_opened = False
         self._server_ready_future = None
 
         self.browser_log_to_file = (config or {}).get(
@@ -191,10 +192,14 @@ class WebSocketBrowserWrapper:
         """Start the WebSocket server and connect to it."""
         await self._cleanup_existing_processes()
 
+        import platform
+
+        use_shell = platform.system() == 'Windows'
         npm_check = subprocess.run(
             ['npm', '--version'],
             capture_output=True,
             text=True,
+            shell=use_shell,
         )
         if npm_check.returncode != 0:
             raise RuntimeError(
@@ -207,6 +212,7 @@ class WebSocketBrowserWrapper:
             ['node', '--version'],
             capture_output=True,
             text=True,
+            shell=use_shell,
         )
         if node_check.returncode != 0:
             raise RuntimeError(
@@ -223,6 +229,7 @@ class WebSocketBrowserWrapper:
                 cwd=self.ts_dir,
                 capture_output=True,
                 text=True,
+                shell=use_shell,
             )
             if install_result.returncode != 0:
                 logger.error(f"npm install failed: {install_result.stderr}")
@@ -237,6 +244,7 @@ class WebSocketBrowserWrapper:
             cwd=self.ts_dir,
             capture_output=True,
             text=True,
+            shell=use_shell,
         )
         if build_result.returncode != 0:
             logger.error(f"TypeScript build failed: {build_result.stderr}")
@@ -244,13 +252,16 @@ class WebSocketBrowserWrapper:
                 f"TypeScript build failed: {build_result.stderr}"
             )
 
+        # use_shell already defined above
         self.process = subprocess.Popen(
             ['node', 'websocket-server.js'],
             cwd=self.ts_dir,
             stdout=subprocess.PIPE,
             stderr=subprocess.STDOUT,
             text=True,
+            encoding='utf-8',
             bufsize=1,
+            shell=use_shell,
         )
 
         self._server_ready_future = asyncio.get_running_loop().create_future()
@@ -391,6 +402,9 @@ class WebSocketBrowserWrapper:
 
         await self._send_command('init', self.config)
 
+        if self.config.get('cdpUrl'):
+            self._browser_opened = True
+
     async def stop(self):
         """Stop the WebSocket connection and server."""
         if self.websocket:
@@ -400,11 +414,12 @@ class WebSocketBrowserWrapper:
                     timeout=2.0,
                 )
 
-            # Close websocket connection
             with contextlib.suppress(Exception):
                 await self.websocket.close()
             self.websocket = None
 
+        self._browser_opened = False
+
         # Gracefully stop the Node process before cancelling the log reader
         if self.process:
             try:
@@ -448,12 +463,13 @@ class WebSocketBrowserWrapper:
 
         This is useful for CDP mode where the browser should remain open.
         """
-        # Close websocket connection
         if self.websocket:
             with contextlib.suppress(Exception):
                 await self.websocket.close()
             self.websocket = None
 
+        self._browser_opened = False
+
         # Stop the Node process
         if self.process:
             try:
@@ -709,17 +725,31 @@ class WebSocketBrowserWrapper:
         response = await self._send_command(
             'open_browser', {'startUrl': start_url}
         )
+        self._browser_opened = True
         return response
 
     @action_logger
     async def close_browser(self) -> str:
         """Close browser."""
         response = await self._send_command('close_browser', {})
+        self._browser_opened = False
         return response['message']
 
     @action_logger
     async def visit_page(self, url: str) -> Dict[str, Any]:
-        """Visit a page."""
+        """Visit a page.
+
+        In non-CDP mode, automatically opens browser if not already open.
+        """
+        if not self._browser_opened:
+            is_cdp_mode = bool(self.config.get('cdpUrl'))
+
+            if not is_cdp_mode:
+                logger.info(
+                    "Browser not open, automatically opening browser..."
+                )
+                await self.open_browser()
+
         response = await self._send_command('visit_page', {'url': url})
         return response