camel-ai 0.2.49__py3-none-any.whl → 0.2.50__py3-none-any.whl

camel/types/enums.py

@@ -212,6 +212,10 @@ class ModelType(UnifiedModelType, Enum):
     QWEN_MAX = "qwen-max"
     QWEN_PLUS = "qwen-plus"
     QWEN_TURBO = "qwen-turbo"
+    QWEN_PLUS_LATEST = "qwen-plus-latest"
+    QWEN_PLUS_2025_04_28 = "qwen-plus-2025-04-28"
+    QWEN_TURBO_LATEST = "qwen-turbo-latest"
+    QWEN_TURBO_2025_04_28 = "qwen-turbo-2025-04-28"
     QWEN_LONG = "qwen-long"
     QWEN_VL_MAX = "qwen-vl-max"
     QWEN_VL_PLUS = "qwen-vl-plus"
@@ -270,6 +274,63 @@ class ModelType(UnifiedModelType, Enum):
     AIML_MIXTRAL_8X7B = "mistralai/Mixtral-8x7B-Instruct-v0.1"
     AIML_MISTRAL_7B_INSTRUCT = "mistralai/Mistral-7B-Instruct-v0.1"
 
+    # Novita platform models support tool calling
+    NOVITA_LLAMA_4_MAVERICK_17B = (
+        "meta-llama/llama-4-maverick-17b-128e-instruct-fp8"
+    )
+    NOVITA_LLAMA_4_SCOUT_17B = "meta-llama/llama-4-scout-17b-16e-instruct"
+    NOVITA_DEEPSEEK_V3_0324 = "deepseek/deepseek-v3-0324"
+    NOVITA_QWEN_2_5_V1_72B = "qwen/qwen2.5-vl-72b-instruct"
+    NOVITA_DEEPSEEK_V3_TURBO = "deepseek/deepseek-v3-turbo"
+    NOVITA_DEEPSEEK_R1_TURBO = "deepseek/deepseek-r1-turbo"
+    NOVITA_GEMMA_3_27B_IT = "google/gemma-3-27b-it"
+    NOVITA_QWEN_32B = "qwen/qwq-32b"
+    NOVITA_L3_8B_STHENO_V3_2 = "Sao10K/L3-8B-Stheno-v3.2"
+    NOVITA_MYTHOMAX_L2_13B = "gryphe/mythomax-l2-13b"
+    NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_8B = (
+        "deepseek/deepseek-r1-distill-llama-8b"
+    )
+    NOVITA_DEEPSEEK_V3 = "deepseek/deepseek_v3"
+    NOVITA_LLAMA_3_1_8B = "meta-llama/llama-3.1-8b-instruct"
+    NOVITA_DEEPSEEK_R1_DISTILL_QWEN_14B = (
+        "deepseek/deepseek-r1-distill-qwen-14b"
+    )
+    NOVITA_LLAMA_3_3_70B = "meta-llama/llama-3.3-70b-instruct"
+    NOVITA_QWEN_2_5_72B = "qwen/qwen-2.5-72b-instruct"
+    NOVITA_MISTRAL_NEMO = "mistralai/mistral-nemo"
+    NOVITA_DEEPSEEK_R1_DISTILL_QWEN_32B = (
+        "deepseek/deepseek-r1-distill-qwen-32b"
+    )
+    NOVITA_LLAMA_3_8B = "meta-llama/llama-3-8b-instruct"
+    NOVITA_WIZARDLM_2_8X22B = "microsoft/wizardlm-2-8x22b"
+    NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_70B = (
+        "deepseek/deepseek-r1-distill-llama-70b"
+    )
+    NOVITA_LLAMA_3_1_70B = "meta-llama/llama-3.1-70b-instruct"
+    NOVITA_GEMMA_2_9B_IT = "google/gemma-2-9b-it"
+    NOVITA_MISTRAL_7B = "mistralai/mistral-7b-instruct"
+    NOVITA_LLAMA_3_70B = "meta-llama/llama-3-70b-instruct"
+    NOVITA_DEEPSEEK_R1 = "deepseek/deepseek-r1"
+    NOVITA_HERMES_2_PRO_LLAMA_3_8B = "nousresearch/hermes-2-pro-llama-3-8b"
+    NOVITA_L3_70B_EURYALE_V2_1 = "sao10k/l3-70b-euryale-v2.1"
+    NOVITA_DOLPHIN_MIXTRAL_8X22B = (
+        "cognitivecomputations/dolphin-mixtral-8x22b"
+    )
+    NOVITA_AIROBOROS_L2_70B = "jondurbin/airoboros-l2-70b"
+    NOVITA_MIDNIGHT_ROSE_70B = "sophosympatheia/midnight-rose-70b"
+    NOVITA_L3_8B_LUNARIS = "sao10k/l3-8b-lunaris"
+    NOVITA_GLM_4_9B_0414 = "thudm/glm-4-9b-0414"
+    NOVITA_GLM_Z1_9B_0414 = "thudm/glm-z1-9b-0414"
+    NOVITA_GLM_Z1_32B_0414 = "thudm/glm-z1-32b-0414"
+    NOVITA_GLM_4_32B_0414 = "thudm/glm-4-32b-0414"
+    NOVITA_GLM_Z1_RUMINATION_32B_0414 = "thudm/glm-z1-rumination-32b-0414"
+    NOVITA_QWEN_2_5_7B = "qwen/qwen2.5-7b-instruct"
+    NOVITA_LLAMA_3_2_1B = "meta-llama/llama-3.2-1b-instruct"
+    NOVITA_LLAMA_3_2_11B_VISION = "meta-llama/llama-3.2-11b-vision-instruct"
+    NOVITA_LLAMA_3_2_3B = "meta-llama/llama-3.2-3b-instruct"
+    NOVITA_LLAMA_3_1_8B_BF16 = "meta-llama/llama-3.1-8b-instruct-bf16"
+    NOVITA_L31_70B_EURYALE_V2_2 = "sao10k/l31-70b-euryale-v2.2"
+
     # ModelScope models support tool calling
     MODELSCOPE_QWEN_2_5_7B_INSTRUCT = "Qwen/Qwen2.5-7B-Instruct"
     MODELSCOPE_QWEN_2_5_14B_INSTRUCT = "Qwen/Qwen2.5-14B-Instruct"
@@ -278,6 +339,8 @@ class ModelType(UnifiedModelType, Enum):
     MODELSCOPE_QWEN_2_5_CODER_7B_INSTRUCT = "Qwen/Qwen2.5-Coder-7B-Instruct"
     MODELSCOPE_QWEN_2_5_CODER_14B_INSTRUCT = "Qwen/Qwen2.5-Coder-14B-Instruct"
     MODELSCOPE_QWEN_2_5_CODER_32B_INSTRUCT = "Qwen/Qwen2.5-Coder-32B-Instruct"
+    MODELSCOPE_QWEN_3_235B_A22B = "Qwen/Qwen3-235B-A22B"
+    MODELSCOPE_QWEN_3_32B = "Qwen/Qwen3-32B"
     MODELSCOPE_QWQ_32B = "Qwen/QwQ-32B"
     MODELSCOPE_QWQ_32B_PREVIEW = "Qwen/QwQ-32B-Preview"
     MODELSCOPE_LLAMA_3_1_8B_INSTRUCT = (
@@ -293,6 +356,22 @@ class ModelType(UnifiedModelType, Enum):
     MODELSCOPE_MINISTRAL_8B_INSTRUCT = "mistralai/Ministral-8B-Instruct-2410"
     MODELSCOPE_DEEPSEEK_V3_0324 = "deepseek-ai/DeepSeek-V3-0324"
 
+    # WatsonX models
+    WATSONX_GRANITE_3_8B_INSTRUCT = "ibm/granite-3-8b-instruct"
+    WATSONX_LLAMA_3_3_70B_INSTRUCT = "meta-llama/llama-3-3-70b-instruct"
+    WATSONX_LLAMA_3_2_1B_INSTRUCT = "meta-llama/llama-3-2-1b-instruct"
+    WATSONX_LLAMA_3_2_3B_INSTRUCT = "meta-llama/llama-3-2-3b-instruct"
+    WATSONX_LLAMA_3_2_11B_VISION_INSTRUCT = (
+        "meta-llama/llama-3-2-11b-vision-instruct"
+    )
+    WATSONX_LLAMA_3_2_90B_VISION_INSTRUCT = (
+        "meta-llama/llama-3-2-90b-vision-instruct"
+    )
+    WATSONX_LLAMA_GUARD_3_11B_VISION_INSTRUCT = (
+        "meta-llama/llama-guard-3-11b-vision-instruct"
+    )
+    WATSONX_MISTRAL_LARGE = "mistralai/mistral-large"
+
     def __str__(self):
         return self.value
 
@@ -345,6 +424,7 @@ class ModelType(UnifiedModelType, Enum):
                 self.is_zhipuai,
                 self.is_aiml,
                 self.is_azure_openai,
+                self.is_novita,
             ]
         )
 
@@ -609,6 +689,10 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.QWEN_QWQ_32B,
             ModelType.QWEN_QVQ_72B,
             ModelType.QWEN_QWQ_PLUS,
+            ModelType.QWEN_PLUS_LATEST,
+            ModelType.QWEN_PLUS_2025_04_28,
+            ModelType.QWEN_TURBO_LATEST,
+            ModelType.QWEN_TURBO_2025_04_28,
         }
 
     @property
@@ -664,6 +748,8 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.MODELSCOPE_QWEN_2_5_CODER_7B_INSTRUCT,
             ModelType.MODELSCOPE_QWEN_2_5_CODER_14B_INSTRUCT,
             ModelType.MODELSCOPE_QWEN_2_5_CODER_32B_INSTRUCT,
+            ModelType.MODELSCOPE_QWEN_3_235B_A22B,
+            ModelType.MODELSCOPE_QWEN_3_32B,
             ModelType.MODELSCOPE_QWQ_32B,
             ModelType.MODELSCOPE_QWQ_32B_PREVIEW,
             ModelType.MODELSCOPE_LLAMA_3_1_8B_INSTRUCT,
@@ -713,6 +799,67 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.SILICONFLOW_PRO_THUDM_GLM_4_9B_CHAT,
         }
 
+    @property
+    def is_watsonx(self) -> bool:
+        return self in {
+            ModelType.WATSONX_GRANITE_3_8B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_3_70B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_1B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_3B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_11B_VISION_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_90B_VISION_INSTRUCT,
+            ModelType.WATSONX_LLAMA_GUARD_3_11B_VISION_INSTRUCT,
+            ModelType.WATSONX_MISTRAL_LARGE,
+        }
+
+    @property
+    def is_novita(self) -> bool:
+        return self in {
+            ModelType.NOVITA_LLAMA_4_MAVERICK_17B,
+            ModelType.NOVITA_LLAMA_4_SCOUT_17B,
+            ModelType.NOVITA_DEEPSEEK_V3_0324,
+            ModelType.NOVITA_QWEN_2_5_V1_72B,
+            ModelType.NOVITA_DEEPSEEK_V3_TURBO,
+            ModelType.NOVITA_DEEPSEEK_R1_TURBO,
+            ModelType.NOVITA_GEMMA_3_27B_IT,
+            ModelType.NOVITA_QWEN_32B,
+            ModelType.NOVITA_L3_8B_STHENO_V3_2,
+            ModelType.NOVITA_MYTHOMAX_L2_13B,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_8B,
+            ModelType.NOVITA_DEEPSEEK_V3,
+            ModelType.NOVITA_LLAMA_3_1_8B,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_QWEN_14B,
+            ModelType.NOVITA_LLAMA_3_3_70B,
+            ModelType.NOVITA_QWEN_2_5_72B,
+            ModelType.NOVITA_MISTRAL_NEMO,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_QWEN_32B,
+            ModelType.NOVITA_LLAMA_3_8B,
+            ModelType.NOVITA_WIZARDLM_2_8X22B,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_70B,
+            ModelType.NOVITA_LLAMA_3_1_70B,
+            ModelType.NOVITA_GEMMA_2_9B_IT,
+            ModelType.NOVITA_MISTRAL_7B,
+            ModelType.NOVITA_LLAMA_3_70B,
+            ModelType.NOVITA_DEEPSEEK_R1,
+            ModelType.NOVITA_HERMES_2_PRO_LLAMA_3_8B,
+            ModelType.NOVITA_L3_70B_EURYALE_V2_1,
+            ModelType.NOVITA_DOLPHIN_MIXTRAL_8X22B,
+            ModelType.NOVITA_AIROBOROS_L2_70B,
+            ModelType.NOVITA_MIDNIGHT_ROSE_70B,
+            ModelType.NOVITA_L3_8B_LUNARIS,
+            ModelType.NOVITA_GLM_4_9B_0414,
+            ModelType.NOVITA_GLM_Z1_9B_0414,
+            ModelType.NOVITA_GLM_Z1_32B_0414,
+            ModelType.NOVITA_GLM_4_32B_0414,
+            ModelType.NOVITA_GLM_Z1_RUMINATION_32B_0414,
+            ModelType.NOVITA_QWEN_2_5_7B,
+            ModelType.NOVITA_LLAMA_3_2_1B,
+            ModelType.NOVITA_LLAMA_3_2_11B_VISION,
+            ModelType.NOVITA_LLAMA_3_2_3B,
+            ModelType.NOVITA_LLAMA_3_1_8B_BF16,
+            ModelType.NOVITA_L31_70B_EURYALE_V2_2,
+        }
+
     @property
     def is_aiml(self) -> bool:
         return self in {
@@ -740,6 +887,9 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.COHERE_COMMAND_LIGHT,
             ModelType.NVIDIA_NEMOTRON_340B_INSTRUCT,
             ModelType.NVIDIA_NEMOTRON_340B_REWARD,
+            ModelType.NOVITA_MYTHOMAX_L2_13B,
+            ModelType.NOVITA_AIROBOROS_L2_70B,
+            ModelType.NOVITA_MIDNIGHT_ROSE_70B,
         }:
             return 4_096
         elif self in {
@@ -761,12 +911,26 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.LMSTUDIO_GEMMA_3_4B,
             ModelType.LMSTUDIO_GEMMA_3_12B,
             ModelType.LMSTUDIO_GEMMA_3_27B,
+            ModelType.WATSONX_GRANITE_3_8B_INSTRUCT,
+            ModelType.NOVITA_L3_8B_STHENO_V3_2,
+            ModelType.NOVITA_LLAMA_3_8B,
+            ModelType.NOVITA_GEMMA_2_9B_IT,
+            ModelType.NOVITA_LLAMA_3_70B,
+            ModelType.NOVITA_HERMES_2_PRO_LLAMA_3_8B,
+            ModelType.NOVITA_L3_70B_EURYALE_V2_1,
+            ModelType.NOVITA_L3_8B_LUNARIS,
+            ModelType.NOVITA_LLAMA_3_1_8B_BF16,
+            ModelType.NOVITA_L31_70B_EURYALE_V2_2,
         }:
             return 8_192
         elif self in {
             ModelType.PPIO_BAICHUAN_2_13B_CHAT,
         }:
             return 14_336
+        elif self in {
+            ModelType.NOVITA_DOLPHIN_MIXTRAL_8X22B,
+        }:
+            return 16_000
         elif self in {
             ModelType.GPT_3_5_TURBO,
             ModelType.YI_LIGHTNING,
@@ -780,11 +944,21 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.GLM_4V_PLUS_0111,
             ModelType.GLM_ZERO_PREVIEW,
             ModelType.PPIO_YI_1_5_34B_CHAT,
+            ModelType.NOVITA_LLAMA_3_1_8B,
         }:
             return 16_384
-
         elif self in {
             ModelType.NETMIND_DOUBAO_1_5_PRO,
+            ModelType.NOVITA_GEMMA_3_27B_IT,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_8B,
+            ModelType.NOVITA_QWEN_2_5_72B,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_LLAMA_70B,
+            ModelType.NOVITA_GLM_4_9B_0414,
+            ModelType.NOVITA_GLM_Z1_9B_0414,
+            ModelType.NOVITA_GLM_Z1_32B_0414,
+            ModelType.NOVITA_GLM_4_32B_0414,
+            ModelType.NOVITA_GLM_Z1_RUMINATION_32B_0414,
+            ModelType.NOVITA_QWEN_2_5_7B,
         }:
             return 32_000
         elif self in {
@@ -820,6 +994,8 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.MODELSCOPE_QWEN_2_5_CODER_7B_INSTRUCT,
             ModelType.MODELSCOPE_QWEN_2_5_CODER_14B_INSTRUCT,
             ModelType.MODELSCOPE_QWEN_2_5_CODER_32B_INSTRUCT,
+            ModelType.MODELSCOPE_QWEN_3_235B_A22B,
+            ModelType.MODELSCOPE_QWEN_3_32B,
             ModelType.MODELSCOPE_QWQ_32B,
             ModelType.MODELSCOPE_QWQ_32B_PREVIEW,
             ModelType.MODELSCOPE_LLAMA_3_1_8B_INSTRUCT,
@@ -829,6 +1005,12 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.MODELSCOPE_MINISTRAL_8B_INSTRUCT,
             ModelType.MODELSCOPE_DEEPSEEK_V3_0324,
             ModelType.OPENROUTER_LLAMA_3_1_405B,
+            ModelType.WATSONX_MISTRAL_LARGE,
+            ModelType.NOVITA_QWEN_32B,
+            ModelType.NOVITA_LLAMA_3_1_70B,
+            ModelType.NOVITA_MISTRAL_7B,
+            ModelType.NOVITA_LLAMA_3_2_11B_VISION,
+            ModelType.NOVITA_LLAMA_3_2_3B,
         }:
             return 32_768
         elif self in {
@@ -843,8 +1025,22 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.PPIO_DEEPSEEK_V3,
             ModelType.AWS_DEEPSEEK_R1,
             ModelType.NETMIND_QWQ_32B,
+            ModelType.NOVITA_DEEPSEEK_V3_TURBO,
+            ModelType.NOVITA_DEEPSEEK_R1_TURBO,
+            ModelType.NOVITA_DEEPSEEK_V3,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_QWEN_14B,
+            ModelType.NOVITA_DEEPSEEK_R1_DISTILL_QWEN_32B,
+            ModelType.NOVITA_DEEPSEEK_R1,
         }:
             return 64_000
+        elif self in {
+            ModelType.NOVITA_WIZARDLM_2_8X22B,
+        }:
+            return 65_535
+        elif self in {
+            ModelType.NOVITA_QWEN_2_5_V1_72B,
+        }:
+            return 96_000
         elif self in {
             ModelType.CLAUDE_2_0,
             ModelType.CLAUDE_INSTANT_1_2,
@@ -894,13 +1090,22 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.AWS_LLAMA_3_2_11B_INSTRUCT,
             ModelType.NETMIND_DEEPSEEK_R1,
             ModelType.NETMIND_DEEPSEEK_V3,
+            ModelType.NOVITA_DEEPSEEK_V3_0324,
         }:
             return 128_000
+        elif self in {
+            ModelType.NOVITA_LLAMA_3_2_1B,
+        }:
+            return 131_000
         elif self in {
             ModelType.GROQ_LLAMA_3_1_8B,
             ModelType.QWEN_PLUS,
             ModelType.QWEN_TURBO,
             ModelType.QWEN_CODER_TURBO,
+            ModelType.QWEN_PLUS_LATEST,
+            ModelType.QWEN_PLUS_2025_04_28,
+            ModelType.QWEN_TURBO_LATEST,
+            ModelType.QWEN_TURBO_2025_04_28,
             ModelType.TOGETHER_LLAMA_3_1_8B,
             ModelType.TOGETHER_LLAMA_3_1_70B,
             ModelType.TOGETHER_LLAMA_3_1_405B,
@@ -911,6 +1116,15 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.OPENROUTER_LLAMA_3_1_70B,
             ModelType.PPIO_LLAMA_3_3_70B,
             ModelType.OPENROUTER_LLAMA_4_SCOUT,
+            ModelType.WATSONX_LLAMA_3_3_70B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_1B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_3B_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_11B_VISION_INSTRUCT,
+            ModelType.WATSONX_LLAMA_3_2_90B_VISION_INSTRUCT,
+            ModelType.WATSONX_LLAMA_GUARD_3_11B_VISION_INSTRUCT,
+            ModelType.NOVITA_LLAMA_4_SCOUT_17B,
+            ModelType.NOVITA_LLAMA_3_3_70B,
+            ModelType.NOVITA_MISTRAL_NEMO,
         }:
             return 131_072
         elif self in {
@@ -961,6 +1175,7 @@ class ModelType(UnifiedModelType, Enum):
             ModelType.GPT_4_1,
             ModelType.GPT_4_1_MINI,
             ModelType.GPT_4_1_NANO,
+            ModelType.NOVITA_LLAMA_4_MAVERICK_17B,
         }:
             return 1_048_576
         elif self in {
@@ -1159,6 +1374,8 @@ class ModelPlatformType(Enum):
     AIML = "aiml"
     VOLCANO = "volcano"
     NETMIND = "netmind"
+    NOVITA = "novita"
+    WATSONX = "watsonx"
 
     @classmethod
     def from_name(cls, name):
@@ -1324,6 +1541,11 @@ class ModelPlatformType(Enum):
         r"""Returns whether this platform is volcano."""
         return self is ModelPlatformType.VOLCANO
 
+    @property
+    def is_novita(self) -> bool:
+        r"""Returns whether this platform is Novita."""
+        return self is ModelPlatformType.NOVITA
+
 
 class AudioModelType(Enum):
     TTS_1 = "tts-1"

camel/types/unified_model_type.py

@@ -153,6 +153,16 @@ class UnifiedModelType(str):
         r"""Returns whether this platform is Moonshot model."""
         return True
 
+    @property
+    def is_novita(self) -> bool:
+        r"""Returns whether the model is a Novita served model."""
+        return True
+
+    @property
+    def is_watsonx(self) -> bool:
+        r"""Returns whether the model is a WatsonX served model."""
+        return True
+
     @property
     def support_native_structured_output(self) -> bool:
         r"""Returns whether the model supports native structured output."""

camel/utils/__init__.py

@@ -41,6 +41,7 @@ from .commons import (
 )
 from .constants import Constants
 from .deduplication import DeduplicationResult, deduplicate_internally
+from .filename import sanitize_filename
 from .mcp import MCPServer
 from .response_format import get_pydantic_model
 from .token_counting import (
@@ -90,4 +91,5 @@ __all__ = [
     "BatchProcessor",
     "with_timeout",
     "MCPServer",
+    "sanitize_filename",
 ]

camel/utils/filename.py

@@ -0,0 +1,80 @@
+# ========= Copyright 2023-2024 @ 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
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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. =========
+import platform
+import re
+import unicodedata
+
+MAX_FILENAME_LENGTH = 255
+WINDOWS_RESERVED = {
+    'CON',
+    'PRN',
+    'AUX',
+    'NUL',
+    'COM1',
+    'COM2',
+    'COM3',
+    'COM4',
+    'LPT1',
+    'LPT2',
+    'LPT3',
+}
+
+
+def sanitize_filename(
+    url_name: str,
+    default: str = "index",
+    max_length: int = MAX_FILENAME_LENGTH,
+) -> str:
+    r"""Sanitize a URL path into a safe filename that is safe for
+    most platforms.
+
+    Args:
+        url_name (str): The URL path to sanitize.
+        default (str): Default name if sanitization results in empty string.
+            (default: :obj:`"index"`)
+        max_length (int): Maximum length of the filename.
+            (default: :obj:`MAX_FILENAME_LENGTH`)
+
+    Returns:
+        str: A sanitized filename safe for most platforms.
+    """
+    if max_length < 1:
+        raise ValueError(
+            f"`max_length` must be greater than " f"0, got {max_length}"
+        )
+
+    if not url_name:
+        return default
+
+    # Normalize Unicode characters by removing characters
+    # such as accents and special characters:
+    # café☕.txt -> cafe.txt
+    url_name = unicodedata.normalize('NFKD', url_name)
+    url_name = url_name.encode('ASCII', 'ignore').decode('ASCII')
+
+    # Replace special characters such as:
+    # Separators: my/file:name*.txt -> my_file_name.txt etc.
+    url_name = re.sub(r'[\\/:*?"<>|.]', '_', url_name)
+    url_name = re.sub(r'_+', '_', url_name)  # Collapse multiple underscores
+    url_name = url_name.strip('_')  # Remove leading/trailing underscores
+
+    # Handle empty result if all characters are invalid:
+    if not url_name:
+        return default
+
+    # Handle Windows reserved names
+    if platform.system() == "Windows" and url_name.upper() in WINDOWS_RESERVED:
+        url_name = f"_{url_name}"
+
+    return url_name[:max_length]

camel/verifiers/__init__.py

@@ -14,6 +14,7 @@
 from .base import BaseVerifier
 from .math_verifier import MathVerifier
 from .models import VerificationOutcome
+from .physics_verifier import PhysicsVerifier
 from .python_verifier import PythonVerifier
 
 __all__ = [
@@ -21,4 +22,5 @@ __all__ = [
     "VerificationOutcome",
     "PythonVerifier",
     "MathVerifier",
+    "PhysicsVerifier",
 ]