camel-ai 0.2.65__py3-none-any.whl → 0.2.82__py3-none-any.whl

camel/runtimes/docker_runtime.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 import io
 import json
 import logging
@@ -45,7 +45,7 @@ class DockerRuntime(BaseRuntime):
         port (int): The port number to use for the runtime API. (default: :obj:
             `8000`)
         remove (bool): Whether to remove the container after stopping it. '
-            (default: :obj: `True`)
+            (default: :obj:`True`)
         kwargs (dict): Additional keyword arguments to pass to the
             Docker client.
     """
@@ -170,7 +170,7 @@ class DockerRuntime(BaseRuntime):
 
         Args:
             time_out (int): The number of seconds to wait for the container to
-                start. (default: :obj: `15`)
+                start. (default: :obj:`15`)
 
         Returns:
             DockerRuntime: The DockerRuntime instance.
@@ -259,9 +259,9 @@ class DockerRuntime(BaseRuntime):
                 list of functions to add.
             entrypoint (str): The entrypoint for the function.
             redirect_stdout (bool): Whether to return the stdout of
-                the function. (default: :obj: `False`)
+                the function. (default: :obj:`False`)
             arguments (Optional[Dict[str, Any]]): The arguments for the
-                function. (default: :obj: `None`)
+                function. (default: :obj:`None`)
 
         Returns:
             DockerRuntime: The DockerRuntime instance.
@@ -295,14 +295,14 @@ class DockerRuntime(BaseRuntime):
                 )
                 if resp.status_code != 200:
                     logger.error(
-                        f"""ailed to execute function: 
-                        {func.get_function_name()}, 
-                        status code: {resp.status_code}, 
+                        f"""ailed to execute function:
+                        {func.get_function_name()},
+                        status code: {resp.status_code},
                         response: {resp.text}"""
                     )
                     return {
                         "error": f"""Failed to execute function:
-                        {func.get_function_name()}, 
+                        {func.get_function_name()},
                         response: {resp.text}"""
                     }
                 data = resp.json()
@@ -330,7 +330,7 @@ class DockerRuntime(BaseRuntime):
 
         Args:
             remove (Optional[bool]): Whether to remove the container
-                after stopping it. (default: :obj: `None`)
+                after stopping it. (default: :obj:`None`)
 
         Returns:
             DockerRuntime: The DockerRuntime instance.
@@ -366,7 +366,7 @@ class DockerRuntime(BaseRuntime):
         r"""Wait for the API Server to be ready.
 
         Args:
-            timeout (int): The number of seconds to wait. (default: :obj: `10`)
+            timeout (int): The number of seconds to wait. (default: :obj:`10`)
 
         Returns:
             bool: Whether the API Server is ready.

camel/runtimes/llm_guard_runtime.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 import json
 import logging
 from functools import wraps
@@ -26,37 +26,37 @@ from camel.types import ModelPlatformType, ModelType
 
 logger = logging.getLogger(__name__)
 
-GUARDPROMPT = """You are a function safety evaluator tasked with assessing the 
-potential risk level of a given function based on both its description 
-and parameters. Your goal is to determine if the function may pose any 
-harm to the user's environment, such as deleting files, executing 
-arbitrary code, or accessing sensitive information. Pay special attention 
-to the provided parameters — even if a function has the potential to be 
-dangerous, its actual parameters may indicate harmless behavior, and the 
-risk level should be adjusted accordingly. Use the `function_risk` tool to 
+GUARDPROMPT = """You are a function safety evaluator tasked with assessing the
+potential risk level of a given function based on both its description
+and parameters. Your goal is to determine if the function may pose any
+harm to the user's environment, such as deleting files, executing
+arbitrary code, or accessing sensitive information. Pay special attention
+to the provided parameters — even if a function has the potential to be
+dangerous, its actual parameters may indicate harmless behavior, and the
+risk level should be adjusted accordingly. Use the `function_risk` tool to
 assign a risk score to the function, based on the following criteria:
 
-- **Score 1**: No harm. This includes simple operations like mathematical 
-    calculations, content searches, or data retrievals that do not impact 
-    the user's environment or access sensitive resources. This also 
-    includes functions with potentially dangerous capabilities that have 
+- **Score 1**: No harm. This includes simple operations like mathematical
+    calculations, content searches, or data retrievals that do not impact
+    the user's environment or access sensitive resources. This also
+    includes functions with potentially dangerous capabilities that have
     harmless, controlled parameters that ensure safe execution.
-- **Score 2**: Minimal harm. The function might read user files, retrieve 
-    non-sensitive data, or access other low-risk resources, 
+- **Score 2**: Minimal harm. The function might read user files, retrieve
+    non-sensitive data, or access other low-risk resources,
     posing little risk to the user.
-- **Score 3**: Risk present. The function might delete files, modify the 
-    file system, execute arbitrary code, or access sensitive data, which 
-    could negatively impact the user's environment. However, if the 
-    actual parameters provided clearly indicate safe and restricted 
+- **Score 3**: Risk present. The function might delete files, modify the
+    file system, execute arbitrary code, or access sensitive data, which
+    could negatively impact the user's environment. However, if the
+    actual parameters provided clearly indicate safe and restricted
     usage, this risk should be downgraded accordingly.
 
-When evaluating, always consider both the function's description and its 
-specific parameters. If the function appears risky due to its design but 
-the provided parameters indicate a safe and non-impactful operation, 
-adjust the risk score to reflect this. Assign an appropriate risk score 
-and provide a brief explanation of your reasoning based on the function's 
+When evaluating, always consider both the function's description and its
+specific parameters. If the function appears risky due to its design but
+the provided parameters indicate a safe and non-impactful operation,
+adjust the risk score to reflect this. Assign an appropriate risk score
+and provide a brief explanation of your reasoning based on the function's
 description and the actual parameters given.
-YOU MUST USE THE `function_risk` TOOL TO ASSESS THE RISK 
+YOU MUST USE THE `function_risk` TOOL TO ASSESS THE RISK
 LEVEL OF EACH FUNCTION.
 """
 

camel/runtimes/remote_http_runtime.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 import atexit
 import json
 import logging
@@ -36,9 +36,9 @@ class RemoteHttpRuntime(BaseRuntime):
 
     Args:
         host (str): The host of the remote server.
-        port (int): The port of the remote server. (default: :obj: `8000`)
+        port (int): The port of the remote server. (default: :obj:`8000`)
         python_exec (str): The python executable to run the API server.
-            (default: :obj: `python3`)
+            (default: :obj:`python3`)
     """
 
     def __init__(
@@ -90,9 +90,9 @@ class RemoteHttpRuntime(BaseRuntime):
                 list of functions to add.
             entrypoint (str): The entrypoint for the function.
             redirect_stdout (bool): Whether to return the stdout of
-                the function. (default: :obj: `False`)
+                the function. (default: :obj:`False`)
             arguments (Optional[Dict[str, Any]]): The arguments for the
-                function. (default: :obj: `None`)
+                function. (default: :obj:`None`)
 
         Returns:
             RemoteHttpRuntime: The current runtime.
@@ -124,14 +124,14 @@ class RemoteHttpRuntime(BaseRuntime):
                 )
                 if resp.status_code != 200:
                     logger.error(
-                        f"""ailed to execute function: 
-                        {func.get_function_name()}, 
-                        status code: {resp.status_code}, 
+                        f"""ailed to execute function:
+                        {func.get_function_name()},
+                        status code: {resp.status_code},
                         response: {resp.text}"""
                     )
                     return {
                         "error": f"""Failed to execute function:
-                        {func.get_function_name()}, 
+                        {func.get_function_name()},
                         response: {resp.text}"""
                     }
                 data = resp.json()
@@ -162,7 +162,7 @@ class RemoteHttpRuntime(BaseRuntime):
         r"""Wait for the API Server to be ready.
 
         Args:
-            timeout (int): The number of seconds to wait. (default: :obj: `10`)
+            timeout (int): The number of seconds to wait. (default: :obj:`10`)
 
         Returns:
             bool: Whether the API Server is ready.

camel/runtimes/ubuntu_docker_runtime.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 
 import logging
 import sys

camel/runtimes/utils/__init__.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 from .function_risk_toolkit import FunctionRiskToolkit
 from .ignore_risk_toolkit import IgnoreRiskToolkit
 

camel/runtimes/utils/function_risk_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 from typing import List, Optional
 
 from camel.toolkits import FunctionTool

camel/runtimes/utils/ignore_risk_toolkit.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 from typing import Dict, List, Optional
 
 from camel.toolkits import FunctionTool

camel/schemas/__init__.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from .openai_converter import OpenAISchemaConverter
 from .outlines_converter import OutlinesConverter

camel/schemas/base.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from abc import ABC, abstractmethod
 from typing import Any, Dict

camel/schemas/openai_converter.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 
 import os
 from typing import Any, Callable, Dict, Optional, Type, Union
@@ -28,7 +28,7 @@ from camel.utils import (
 from .base import BaseConverter
 
 DEFAULT_CONVERTER_PROMPTS = """
-    Extract key entities and attributes from the user 
+    Extract key entities and attributes from the user
     provided text, and convert them into a structured JSON format.
 """
 

camel/schemas/outlines_converter.py

@@ -1,4 +1,4 @@
-# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# ========= Copyright 2023-2025 @ 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-2025 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from typing import Any, Callable, List, Literal, Type, Union