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

camel/toolkits/browser_toolkit.py

@@ -47,7 +47,11 @@ from camel.toolkits.base import BaseToolkit
 from camel.toolkits.function_tool import FunctionTool
 from camel.toolkits.video_analysis_toolkit import VideoAnalysisToolkit
 from camel.types import ModelPlatformType, ModelType
-from camel.utils import dependencies_required, retry_on_error
+from camel.utils import (
+    dependencies_required,
+    retry_on_error,
+    sanitize_filename,
+)
 
 logger = get_logger(__name__)
 
@@ -137,7 +141,7 @@ def _get_str(d: Any, k: str) -> str:
     if isinstance(val, str):
         return val
     raise TypeError(
-        f"Expected a string for key '{k}', " f"but got {type(val).__name__}"
+        f"Expected a string for key '{k}', but got {type(val).__name__}"
     )
 
 
@@ -158,7 +162,7 @@ def _get_bool(d: Any, k: str) -> bool:
     if isinstance(val, bool):
         return val
     raise TypeError(
-        f"Expected a boolean for key '{k}', " f"but got {type(val).__name__}"
+        f"Expected a boolean for key '{k}', but got {type(val).__name__}"
     )
 
 
@@ -219,7 +223,7 @@ def _parse_json_output(text: str) -> Dict[str, Any]:
                 return {}
 
 
-def _reload_image(image: Image.Image):
+def _reload_image(image: Image.Image) -> Image.Image:
     buffer = io.BytesIO()
     image.save(buffer, format="PNG")
     buffer.seek(0)
@@ -432,6 +436,7 @@ class BaseBrowser:
         headless=True,
         cache_dir: Optional[str] = None,
         channel: Literal["chrome", "msedge", "chromium"] = "chromium",
+        cookie_json_path: Optional[str] = None,
     ):
         r"""Initialize the WebBrowser instance.
 
@@ -441,6 +446,10 @@ class BaseBrowser:
             channel (Literal["chrome", "msedge", "chromium"]): The browser
                 channel to use. Must be one of "chrome", "msedge", or
                 "chromium".
+            cookie_json_path (Optional[str]): Path to a JSON file containing
+                authentication cookies and browser storage state. If provided
+                and the file exists, the browser will load this state to maintain
+                authenticated sessions without requiring manual login.
 
         Returns:
             None
@@ -455,6 +464,7 @@ class BaseBrowser:
         self._ensure_browser_installed()
         self.playwright = sync_playwright().start()
         self.page_history: list = []  # stores the history of visited pages
+        self.cookie_json_path = cookie_json_path
 
         # Set the cache directory
         self.cache_dir = "tmp/" if cache_dir is None else cache_dir
@@ -479,8 +489,18 @@ class BaseBrowser:
         self.browser = self.playwright.chromium.launch(
             headless=self.headless, channel=self.channel
         )
-        # Create a new context
-        self.context = self.browser.new_context(accept_downloads=True)
+
+        # Check if cookie file exists before using it to maintain
+        # authenticated sessions. This prevents errors when the cookie file
+        # doesn't exist
+        if self.cookie_json_path and os.path.exists(self.cookie_json_path):
+            self.context = self.browser.new_context(
+                accept_downloads=True, storage_state=self.cookie_json_path
+            )
+        else:
+            self.context = self.browser.new_context(
+                accept_downloads=True,
+            )
         # Create a new page
         self.page = self.context.new_page()
 
@@ -550,12 +570,9 @@ class BaseBrowser:
             # Get url name to form a file name
             # Use urlparser for a safer extraction the url name
             parsed_url = urllib.parse.urlparse(self.page_url)
-            url_name = os.path.basename(str(parsed_url.path)) or "index"
-
-            for char in ['\\', '/', ':', '*', '?', '"', '<', '>', '|', '.']:
-                url_name = url_name.replace(char, "_")
-
-            # Get formatted time: mmddhhmmss
+            # Max length is set to 241 as there are 10 characters for the
+            # timestamp and 4 characters for the file extension:
+            url_name = sanitize_filename(str(parsed_url.path), max_length=241)
             timestamp = datetime.datetime.now().strftime("%m%d%H%M%S")
             file_path = os.path.join(
                 self.cache_dir, f"{url_name}_{timestamp}.png"
@@ -663,24 +680,25 @@ class BaseBrowser:
                 directory.
 
         Returns:
-            Tuple[Image.Image, str]: A tuple containing the screenshot image
-                and the path to the image file.
+            Tuple[Image.Image, Union[str, None]]: A tuple containing the screenshot image
+                and an optional path to the image file if saved, otherwise
+                :obj:`None`.
         """
 
         self._wait_for_load()
         screenshot, _ = self.get_screenshot(save_image=False)
         rects = self.get_interactive_elements()
 
-        file_path = None
-        comp, visible_rects, rects_above, rects_below = add_set_of_mark(
+        file_path: str | None = None
+        comp, _, _, _ = add_set_of_mark(
             screenshot,
             rects,  # type: ignore[arg-type]
         )
         if save_image:
             parsed_url = urllib.parse.urlparse(self.page_url)
-            url_name = os.path.basename(str(parsed_url.path)) or "index"
-            for char in ['\\', '/', ':', '*', '?', '"', '<', '>', '|', '.']:
-                url_name = url_name.replace(char, "_")
+            # Max length is set to 241 as there are 10 characters for the
+            # timestamp and 4 characters for the file extension:
+            url_name = sanitize_filename(str(parsed_url.path), max_length=241)
             timestamp = datetime.datetime.now().strftime("%m%d%H%M%S")
             file_path = os.path.join(
                 self.cache_dir, f"{url_name}_{timestamp}.png"
@@ -991,6 +1009,7 @@ class BrowserToolkit(BaseToolkit):
         web_agent_model: Optional[BaseModelBackend] = None,
         planning_agent_model: Optional[BaseModelBackend] = None,
         output_language: str = "en",
+        cookie_json_path: Optional[str] = None,
     ):
         r"""Initialize the BrowserToolkit instance.
 
@@ -1008,10 +1027,18 @@ class BrowserToolkit(BaseToolkit):
                 backend for the planning agent.
             output_language (str): The language to use for output.
                 (default: :obj:`"en`")
+            cookie_json_path (Optional[str]): Path to a JSON file containing
+                authentication cookies and browser storage state. If provided
+                and the file exists, the browser will load this state to maintain
+                authenticated sessions without requiring manual login.
+                (default: :obj:`None`)
         """
 
         self.browser = BaseBrowser(
-            headless=headless, cache_dir=cache_dir, channel=channel
+            headless=headless,
+            cache_dir=cache_dir,
+            channel=channel,
+            cookie_json_path=cookie_json_path,
         )
 
         self.history_window = history_window
@@ -1103,7 +1130,7 @@ Here are the current available browser functions you can use:
 
 Here are the latest {self.history_window} trajectory (at most) you have taken:
 <history>
-{self.history[-self.history_window:]}
+{self.history[-self.history_window :]}
 </history>
 
 Your output should be in json format, including the following fields:
@@ -1322,36 +1349,6 @@ Please find the final answer, or give valuable insights and founds (e.g. if prev
         resp = self.web_agent.step(message)
         return resp.msgs[0].content
 
-    def _make_reflection(self, task_prompt: str) -> str:
-        r"""Make a reflection about the current state and the task prompt."""
-
-        reflection_prompt = f"""
-Now we are working on a complex task that requires multi-step browser interaction. The task is: <task>{task_prompt}</task>
-To achieve this goal, we have made a series of observations, reasonings, and actions. We have also made a reflection on previous states.
-
-Here are the global available browser functions we can use:
-{AVAILABLE_ACTIONS_PROMPT}
-
-Here are the latest {self.history_window} trajectory (at most) we have taken:
-<history>{self.history[-self.history_window:]}</history>
-
-The image provided is the current state of the browser, where we have marked interactive elements. 
-Please carefully examine the requirements of the task, and the current state of the browser, and then make reflections on the previous steps, thinking about whether they are helpful or not, and why, offering detailed feedback and suggestions for the next steps.
-Your output should be in json format, including the following fields:
-- `reflection`: The reflection about the previous steps, thinking about whether they are helpful or not, and why, offering detailed feedback.
-- `suggestion`: The suggestion for the next steps, offering detailed suggestions, including the common solutions to the overall task based on the current state of the browser.
-        """
-        som_image, _ = self.browser.get_som_screenshot()
-        img = _reload_image(som_image)
-
-        message = BaseMessage.make_user_message(
-            role_name='user', content=reflection_prompt, image_list=[img]
-        )
-
-        resp = self.web_agent.step(message)
-
-        return resp.msgs[0].content
-
     def _task_planning(self, task_prompt: str, start_url: str) -> str:
         r"""Plan the task based on the given task prompt."""
 
@@ -1396,7 +1393,7 @@ In order to solve the task, we made a detailed plan previously. Here is the deta
 <detailed plan>{detailed_plan}</detailed plan>
 
 According to the task above, we have made a series of observations, reasonings, and actions. Here are the latest {self.history_window} trajectory (at most) we have taken:
-<history>{self.history[-self.history_window:]}</history>
+<history>{self.history[-self.history_window :]}</history>
 
 However, the task is not completed yet. As the task is partially observable, we may need to replan the task based on the current state of the browser if necessary.
 Now please carefully examine the current task planning schema, and our history actions, and then judge whether the task needs to be fundamentally replanned. If so, please provide a detailed replanned schema (including the restated overall task).
@@ -1422,7 +1419,8 @@ Your output should be in json format, including the following fields:
     def browse_url(
         self, task_prompt: str, start_url: str, round_limit: int = 12
     ) -> str:
-        r"""A powerful toolkit which can simulate the browser interaction to solve the task which needs multi-step actions.
+        r"""A powerful toolkit which can simulate the browser interaction to
+        solve the task which needs multi-step actions.
 
         Args:
             task_prompt (str): The task prompt to solve.
@@ -1480,7 +1478,7 @@ Your output should be in json format, including the following fields:
                 }
                 self.history.append(trajectory_info)
 
-                # replan the task if necessary
+                # Replan the task if necessary
                 if_need_replan, replanned_schema = self._task_replanning(
                     task_prompt, detailed_plan
                 )
@@ -1491,7 +1489,7 @@ Your output should be in json format, including the following fields:
         if not task_completed:
             simulation_result = f"""
                 The task is not completed within the round limit. Please check the last round {self.history_window} information to see if there is any useful information:
-                <history>{self.history[-self.history_window:]}</history>
+                <history>{self.history[-self.history_window :]}</history>
             """
 
         else:

camel/types/enums.py

@@ -105,6 +105,7 @@ class ModelType(UnifiedModelType, Enum):
     TOGETHER_LLAMA_4_SCOUT = "meta-llama/Llama-4-Scout-17B-16E-Instruct"
 
     # PPIO platform models support tool calling
+    PPIO_DEEPSEEK_PROVER_V2_671B = "deepseek/deepseek-prover-v2-671b"
     PPIO_DEEPSEEK_R1_TURBO = "deepseek/deepseek-r1-turbo"
     PPIO_DEEPSEEK_V3_TURBO = "deepseek/deepseek-v3-turbo"
     PPIO_DEEPSEEK_R1_COMMUNITY = "deepseek/deepseek-r1/community"
@@ -212,6 +213,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 +275,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 +340,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 +357,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 +425,7 @@ class ModelType(UnifiedModelType, Enum):
                 self.is_zhipuai,
                 self.is_aiml,
                 self.is_azure_openai,
+                self.is_novita,
             ]
         )
 
@@ -609,6 +690,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
@@ -632,6 +717,7 @@ class ModelType(UnifiedModelType, Enum):
     @property
     def is_ppio(self) -> bool:
         return self in {
+            ModelType.PPIO_DEEPSEEK_PROVER_V2_671B,
             ModelType.PPIO_DEEPSEEK_R1_TURBO,
             ModelType.PPIO_DEEPSEEK_V3_TURBO,
             ModelType.PPIO_DEEPSEEK_R1_COMMUNITY,
@@ -664,6 +750,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 +801,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 +889,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 +913,27 @@ 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.PPIO_DEEPSEEK_PROVER_V2_671B,
+            ModelType.NOVITA_DOLPHIN_MIXTRAL_8X22B,
+        }:
+            return 16_000
         elif self in {
             ModelType.GPT_3_5_TURBO,
             ModelType.YI_LIGHTNING,
@@ -780,11 +947,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 +997,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 +1008,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 +1028,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 +1093,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 +1119,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 +1178,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 +1377,8 @@ class ModelPlatformType(Enum):
     AIML = "aiml"
     VOLCANO = "volcano"
     NETMIND = "netmind"
+    NOVITA = "novita"
+    WATSONX = "watsonx"
 
     @classmethod
     def from_name(cls, name):
@@ -1324,6 +1544,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",
 ]