chore: better aysnc tool execution support (#3461)

Author: Wendong-Fan

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -26,7 +26,7 @@ body:
     attributes:
       label: What version of camel are you using?
       description: Run command `python3 -c 'print(__import__("camel").__version__)'` in your shell and paste the output here.
-      placeholder: E.g., 0.2.80a3
+      placeholder: E.g., 0.2.80
     validations:
       required: true
 

camel/__init__.py

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

camel/agents/chat_agent.py

@@ -3914,7 +3914,8 @@ async def _aexecute_tool(
 
             else:
                 # Fallback: synchronous call
-                result = tool(**args)
+                loop = asyncio.get_running_loop()
+                result = await loop.run_in_executor(None, lambda: tool(**args))
 
         except Exception as e:
             # Capture the error message to prevent framework crash
@@ -4741,7 +4742,10 @@ async def _aexecute_tool_from_stream_data(
 
                     else:
                         # Fallback: synchronous call
-                        result = tool(**args)
+                        loop = asyncio.get_running_loop()
+                        result = await loop.run_in_executor(
+                            None, lambda: tool(**args)
+                        )
 
                     # Create the tool response message
                     func_msg = FunctionCallingMessage(

camel/toolkits/function_tool.py

@@ -12,10 +12,12 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 import ast
+import asyncio
 import inspect
 import logging
 import textwrap
 import warnings
+from concurrent.futures import ThreadPoolExecutor
 from inspect import Parameter, getsource, signature
 from typing import Any, Callable, Dict, Mapping, Optional, Tuple, Type
 
@@ -31,6 +33,9 @@
 
 logger = logging.getLogger(__name__)
 
+# Shared thread pool for running sync tools without blocking the event loop
+_SYNC_TOOL_EXECUTOR = ThreadPoolExecutor(max_workers=64)
+
 
 def _remove_a_key(d: Dict, remove_key: Any) -> None:
     r"""Remove a key from a dictionary recursively."""
@@ -500,7 +505,11 @@ async def async_call(self, *args: Any, **kwargs: Any) -> Any:
         if self.is_async:
             return await self.func(*args, **kwargs)
         else:
-            return self.func(*args, **kwargs)
+            # Run sync function in executor to avoid blocking event loop
+            loop = asyncio.get_running_loop()
+            return await loop.run_in_executor(
+                _SYNC_TOOL_EXECUTOR, lambda: self.func(*args, **kwargs)
+            )
 
     @property
     def is_async(self) -> bool:

camel/types/enums.py

@@ -49,7 +49,7 @@ class ModelType(UnifiedModelType, Enum):
     O4_MINI = "o4-mini"
     O3 = "o3"
     O3_PRO = "o3-pro"
-    GPT_5_1_Instant = "gpt-5.1"
+    GPT_5_1 = "gpt-5.1"
     GPT_5 = "gpt-5"
     GPT_5_MINI = "gpt-5-mini"
     GPT_5_NANO = "gpt-5-nano"
@@ -603,6 +603,7 @@ def is_openai(self) -> bool:
             ModelType.GPT_5_NANO,
             ModelType.O4_MINI,
             ModelType.O3,
+            ModelType.GPT_5_1,
         }
 
     @property
@@ -1393,9 +1394,6 @@ def token_limit(self) -> int:
             ModelType.O1_PREVIEW,
             ModelType.O1_MINI,
             ModelType.GPT_4_5_PREVIEW,
-            ModelType.GPT_5,
-            ModelType.GPT_5_NANO,
-            ModelType.GPT_5_MINI,
             ModelType.MISTRAL_LARGE,
             ModelType.MISTRAL_NEMO,
             ModelType.MISTRAL_PIXTRAL_12B,
@@ -1561,6 +1559,13 @@ def token_limit(self) -> int:
             ModelType.NETMIND_LLAMA_4_SCOUT_17B_16E_INSTRUCT,
         }:
             return 320_000
+        elif self in {
+            ModelType.GPT_5_1,
+            ModelType.GPT_5_MINI,
+            ModelType.GPT_5_NANO,
+            ModelType.GPT_5,
+        }:
+            return 400_000
         elif self in {
             ModelType.OPENROUTER_LLAMA_4_SCOUT_FREE,
             ModelType.NETMIND_LLAMA_4_MAVERICK_17B_128E_INSTRUCT,

docs/conf.py

@@ -27,7 +27,7 @@
 project = 'CAMEL'
 copyright = '2024, CAMEL-AI.org'
 author = 'CAMEL-AI.org'
-release = '0.2.80a3'
+release = '0.2.80'
 
 html_favicon = (
     'https://raw.githubusercontent.com/camel-ai/camel/master/misc/favicon.png'

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "camel-ai"
-version = "0.2.80a3"
+version = "0.2.80"
 description = "Communicative Agents for AI Society Study"
 authors = [{ name = "CAMEL-AI.org" }]
 requires-python = ">=3.10,<3.15"