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

camel/agents/critic_agent.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 random
 import warnings
 from typing import Any, Dict, List, Optional, Sequence, Tuple, Union

camel/agents/deductive_reasoner_agent.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 re
 from typing import Dict, List, Optional, Union
 
@@ -103,105 +103,105 @@ class DeductiveReasonerAgent(ChatAgent):
         """
         self.reset()
 
-        deduce_prompt = """You are a deductive reasoner. You are tasked to 
-        complete the TASK based on the THOUGHT OF DEDUCTIVE REASONING, the 
-        STARTING STATE A and the TARGET STATE B. You are given the CONTEXT 
+        deduce_prompt = """You are a deductive reasoner. You are tasked to
+        complete the TASK based on the THOUGHT OF DEDUCTIVE REASONING, the
+        STARTING STATE A and the TARGET STATE B. You are given the CONTEXT
         CONTENT to help you complete the TASK.
-Your answer MUST strictly adhere to the structure of ANSWER TEMPLATE, ONLY 
+Your answer MUST strictly adhere to the structure of ANSWER TEMPLATE, ONLY
 fill in the BLANKs, and DO NOT alter or modify any other part of the template
 
 ===== MODELING OF DEDUCTIVE REASONING =====
-You are tasked with understanding a mathematical model based on the components 
+You are tasked with understanding a mathematical model based on the components
 ${A, B, C, Q, L}$. In this model: ``L: A ⊕ C -> q * B``.
 - $A$ represents the known starting state.
 - $B$ represents the known target state.
 - $C$ represents the conditions required to transition from $A$ to $B$.
-- $Q$ represents the quality or effectiveness of the transition from $A$ to 
+- $Q$ represents the quality or effectiveness of the transition from $A$ to
 $B$.
 - $L$ represents the path or process from $A$ to $B$.
 
 ===== THOUGHT OF DEDUCTIVE REASONING =====
 1. Define the Parameters of A and B:
-    - Characterization: Before delving into transitions, thoroughly understand 
-    the nature and boundaries of both $A$ and $B$. This includes the type, 
+    - Characterization: Before delving into transitions, thoroughly understand
+    the nature and boundaries of both $A$ and $B$. This includes the type,
     properties, constraints, and possible interactions between the two.
-    - Contrast and Compare: Highlight the similarities and differences between 
-    $A$ and $B$. This comparative analysis will give an insight into what 
+    - Contrast and Compare: Highlight the similarities and differences between
+    $A$ and $B$. This comparative analysis will give an insight into what
     needs changing and what remains constant.
 2. Historical & Empirical Analysis:
-    - Previous Transitions according to the Knowledge Base of GPT: (if 
-    applicable) Extract conditions and patterns from the historical instances 
-    where a similar transition from a state comparable to $A$ moved towards 
+    - Previous Transitions according to the Knowledge Base of GPT: (if
+    applicable) Extract conditions and patterns from the historical instances
+    where a similar transition from a state comparable to $A$ moved towards
     $B$.
-    - Scientific Principles: (if applicable) Consider the underlying 
-    scientific principles governing or related to the states and their 
-    transition. For example, if $A$ and $B$ are physical states, laws of 
+    - Scientific Principles: (if applicable) Consider the underlying
+    scientific principles governing or related to the states and their
+    transition. For example, if $A$ and $B$ are physical states, laws of
     physics might apply.
 3. Logical Deduction of Conditions ($C$):
-    - Direct Path Analysis: What are the immediate and direct conditions 
+    - Direct Path Analysis: What are the immediate and direct conditions
     required to move from $A$ to $B$?
-    - Intermediate States: Are there states between $A$ and $B$ that must be 
-    traversed or can be used to make the transition smoother or more 
+    - Intermediate States: Are there states between $A$ and $B$ that must be
+    traversed or can be used to make the transition smoother or more
     efficient? If yes, what is the content?
-    - Constraints & Limitations: Identify potential barriers or restrictions 
-    in moving from $A$ to $B$. These can be external (e.g., environmental 
+    - Constraints & Limitations: Identify potential barriers or restrictions
+    in moving from $A$ to $B$. These can be external (e.g., environmental
     factors) or internal (properties of $A$ or $B$).
-    - Resource and Information Analysis: What resources and information are 
-    required for the transition? This could be time, entity, factor, code 
+    - Resource and Information Analysis: What resources and information are
+    required for the transition? This could be time, entity, factor, code
     language, software platform, unknowns, etc.
-    - External Influences: Consider socio-economic, political, or 
-    environmental factors (if applicable) that could influence the transition 
+    - External Influences: Consider socio-economic, political, or
+    environmental factors (if applicable) that could influence the transition
     conditions.
-    - Creative/Heuristic Reasoning: Open your mind to multiple possible $C$'s, 
-    no matter how unconventional they might seem. Utilize analogies, 
-    metaphors, or brainstorming techniques to envision possible conditions or 
+    - Creative/Heuristic Reasoning: Open your mind to multiple possible $C$'s,
+    no matter how unconventional they might seem. Utilize analogies,
+    metaphors, or brainstorming techniques to envision possible conditions or
     paths from $A$ to $B$.
-    - The conditions $C$ should be multiple but in one sentence. And each 
+    - The conditions $C$ should be multiple but in one sentence. And each
     condition should be concerned with one aspect/entity.
 4. Entity/Label Recognition of Conditions ($C$):
-    - Identify and categorize entities of Conditions ($C$) such as the names, 
-    locations, dates, specific technical terms or contextual parameters that 
+    - Identify and categorize entities of Conditions ($C$) such as the names,
+    locations, dates, specific technical terms or contextual parameters that
     might be associated with events, innovations post-2022.
-    - The output of the entities/labels will be used as tags or labels for 
-    semantic similarity searches. The entities/labels may be the words, or 
-    phrases, each of them should contain valuable, high information entropy 
+    - The output of the entities/labels will be used as tags or labels for
+    semantic similarity searches. The entities/labels may be the words, or
+    phrases, each of them should contain valuable, high information entropy
     information, and should be independent.
-    - Ensure that the identified entities are formatted in a manner suitable 
-    for database indexing and retrieval. Organize the entities into 
-    categories, and combine the category with its instance into a continuous 
+    - Ensure that the identified entities are formatted in a manner suitable
+    for database indexing and retrieval. Organize the entities into
+    categories, and combine the category with its instance into a continuous
     phrase, without using colons or other separators.
-    - Format these entities for database indexing: output the category rather 
-    than its instance/content into a continuous phrase. For example, instead 
+    - Format these entities for database indexing: output the category rather
+    than its instance/content into a continuous phrase. For example, instead
     of "Jan. 02", identify it as "Event time".
 5. Quality Assessment ($Q$):
-    - Efficiency: How efficient is the transition from $A$ to $B$, which 
+    - Efficiency: How efficient is the transition from $A$ to $B$, which
     measures the resources used versus the desired outcome?
-    - Effectiveness: Did the transition achieve the desired outcome or was the 
+    - Effectiveness: Did the transition achieve the desired outcome or was the
     target state achieved as intended?
-    - Safety & Risks: Assess any risks associated with the transition and the 
+    - Safety & Risks: Assess any risks associated with the transition and the
     measures to mitigate them.
-    - Feedback Mechanisms: Incorporate feedback loops to continuously monitor 
+    - Feedback Mechanisms: Incorporate feedback loops to continuously monitor
     and adjust the quality of transition, making it more adaptive.
 6. Iterative Evaluation:
-    - Test & Refine: Based on the initially deduced conditions and assessed 
-    quality, iterate the process to refine and optimize the transition. This 
-    might involve tweaking conditions, employing different paths, or changing 
+    - Test & Refine: Based on the initially deduced conditions and assessed
+    quality, iterate the process to refine and optimize the transition. This
+    might involve tweaking conditions, employing different paths, or changing
     resources.
-    - Feedback Integration: Use feedback to make improvements and increase the 
+    - Feedback Integration: Use feedback to make improvements and increase the
     quality of the transition.
-7. Real-world scenarios often present challenges that may not be captured by 
+7. Real-world scenarios often present challenges that may not be captured by
 models and frameworks. While using the model, maintain an adaptive mindset:
-    - Scenario Exploration: Continuously imagine various possible scenarios, 
+    - Scenario Exploration: Continuously imagine various possible scenarios,
     both positive and negative, to prepare for unexpected events.
     - Flexibility: Be prepared to modify conditions ($C$) or alter the path/
     process ($L$) if unforeseen challenges arise.
-    - Feedback Integration: Rapidly integrate feedback from actual 
-    implementations to adjust the model's application, ensuring relevancy and 
+    - Feedback Integration: Rapidly integrate feedback from actual
+    implementations to adjust the model's application, ensuring relevancy and
     effectiveness.
 
 ===== TASK =====
-Given the starting state $A$ and the target state $B$, assuming that a path 
-$L$ always exists between $A$ and $B$, how can one deduce or identify the 
+Given the starting state $A$ and the target state $B$, assuming that a path
+$L$ always exists between $A$ and $B$, how can one deduce or identify the
 necessary conditions $C$ and the quality $Q$ of the transition?
 
 ===== STARTING STATE $A$ =====
@@ -217,7 +217,7 @@ necessary conditions $C$ and the quality $Q$ of the transition?
 - Logical Deduction of Conditions ($C$) (multiple conditions can be deduced):
     condition <NUM>:
         <BLANK>.
-- Entity/Label Recognition of Conditions:\n[<BLANK>, <BLANK>, ...] (include 
+- Entity/Label Recognition of Conditions:\n[<BLANK>, <BLANK>, ...] (include
 square brackets)
 - Quality Assessment ($Q$) (do not use symbols):
     <BLANK>.

camel/agents/embodied_agent.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, List, Optional
 
 from colorama import Fore

camel/agents/knowledge_graph_agent.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 TYPE_CHECKING, Optional, Union
 
 if TYPE_CHECKING:
@@ -40,53 +40,53 @@ except (ImportError, AttributeError):
 
 
 text_prompt = """
-You are tasked with extracting nodes and relationships from given content and 
-structures them into Node and Relationship objects. Here's the outline of what 
+You are tasked with extracting nodes and relationships from given content and
+structures them into Node and Relationship objects. Here's the outline of what
 you needs to do:
 
 Content Extraction:
-You should be able to process input content and identify entities mentioned 
+You should be able to process input content and identify entities mentioned
 within it.
-Entities can be any noun phrases or concepts that represent distinct entities 
+Entities can be any noun phrases or concepts that represent distinct entities
 in the context of the given content.
 
 Node Extraction:
 For each identified entity, you should create a Node object.
 Each Node object should have a unique identifier (id) and a type (type).
-Additional properties associated with the node can also be extracted and 
+Additional properties associated with the node can also be extracted and
 stored.
 
 Relationship Extraction:
 You should identify relationships between entities mentioned in the content.
 For each relationship, create a Relationship object.
-A Relationship object should have a subject (subj) and an object (obj) which 
+A Relationship object should have a subject (subj) and an object (obj) which
 are Node objects representing the entities involved in the relationship.
-Each relationship should also have a type (type), and additional properties if 
+Each relationship should also have a type (type), and additional properties if
 applicable.
 
 Output Formatting:
-The extracted nodes and relationships should be formatted as instances of the 
+The extracted nodes and relationships should be formatted as instances of the
 provided Node and Relationship classes.
 Ensure that the extracted data adheres to the structure defined by the classes.
-Output the structured data in a format that can be easily validated against 
+Output the structured data in a format that can be easily validated against
 the provided code.
-Do not wrap the output in lists or dictionaries, provide the Node and 
+Do not wrap the output in lists or dictionaries, provide the Node and
 Relationship with unique identifiers.
-Strictly follow the format provided in the example output, do not add any 
+Strictly follow the format provided in the example output, do not add any
 additional information.
 
 
 Instructions for you:
 Read the provided content thoroughly.
-Identify distinct entities mentioned in the content and categorize them as 
+Identify distinct entities mentioned in the content and categorize them as
 nodes.
-Determine relationships between these entities and represent them as directed 
+Determine relationships between these entities and represent them as directed
 relationships.
 Provide the extracted nodes and relationships in the specified format below.
 Example for you:
 
 Example Content:
-"John works at XYZ Corporation. He is a software engineer. The company is 
+"John works at XYZ Corporation. He is a software engineer. The company is
 located in New York City."
 
 Expected Output:
@@ -99,14 +99,14 @@ Node(id='New York City', type='Location')
 
 Relationships:
 
-Relationship(subj=Node(id='John', type='Person'), obj=Node(id='XYZ 
+Relationship(subj=Node(id='John', type='Person'), obj=Node(id='XYZ
 Corporation', type='Organization'), type='WorksAt')
-Relationship(subj=Node(id='John', type='Person'), obj=Node(id='New York City', 
+Relationship(subj=Node(id='John', type='Person'), obj=Node(id='New York City',
 type='Location'), type='ResidesIn')
 
 ===== TASK =====
-Please extracts nodes and relationships from given content and structures them 
-into Node and Relationship objects. 
+Please extracts nodes and relationships from given content and structures them
+into Node and Relationship objects.
 
 {task}
 """

camel/agents/mcp_agent.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,21 +10,30 @@
 # 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 asyncio
 import json
 import platform
-import re
-from typing import Any, Callable, Dict, List, Optional, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Union,
+    cast,
+)
 
-from camel.agents import ChatAgent
+from camel.agents.chat_agent import ChatAgent
 from camel.logger import get_logger
 from camel.messages import BaseMessage
-from camel.models import BaseModelBackend, ModelFactory
+from camel.models.base_model import BaseModelBackend
+from camel.models.model_factory import ModelFactory
 from camel.prompts import TextPrompt
 from camel.responses import ChatAgentResponse
-from camel.toolkits import FunctionTool, MCPToolkit
+from camel.toolkits.function_tool import FunctionTool
 from camel.types import (
     BaseMCPRegistryConfig,
     MCPRegistryType,
@@ -33,6 +42,9 @@ from camel.types import (
     RoleType,
 )
 
+if TYPE_CHECKING:
+    from camel.toolkits.mcp_toolkit import MCPToolkit
+
 # AgentOps decorator setting
 try:
     import os
@@ -44,13 +56,15 @@ try:
 except (ImportError, AttributeError):
     from camel.utils import track_agent
 
+from camel.parsers.mcp_tool_call_parser import extract_tool_calls_from_text
+
 logger = get_logger(__name__)
 
 
 SYS_MSG_CONTENT = """
-You are a helpful assistant, and you prefer to use tools provided by the user 
+You are a helpful assistant, and you prefer to use tools provided by the user
 to solve problems.
-Using a tool, you will tell the user `server_idx`, `tool_name` and 
+Using a tool, you will tell the user `server_idx`, `tool_name` and
 `tool_args` formatted in JSON as following:
 ```json
 {
@@ -125,7 +139,6 @@ class MCPAgent(ChatAgent):
         local_config_path: Optional[str] = None,
         tools: Optional[List[Union[FunctionTool, Callable]]] = None,
         function_calling_available: bool = True,
-        strict: bool = False,
         **kwargs,
     ):
         if model is None:
@@ -145,7 +158,6 @@ class MCPAgent(ChatAgent):
 
         self.local_config = local_config
         self.function_calling_available = function_calling_available
-        self.strict = strict
 
         if function_calling_available:
             sys_msg_content = "You are a helpful assistant, and you prefer "
@@ -170,8 +182,10 @@ class MCPAgent(ChatAgent):
             **kwargs,
         )
 
-    def _initialize_mcp_toolkit(self) -> MCPToolkit:
+    def _initialize_mcp_toolkit(self) -> "MCPToolkit":
         r"""Initialize the MCP toolkit from the provided configuration."""
+        from camel.toolkits.mcp_toolkit import MCPToolkit
+
         config_dict = {}
         for registry_config in self.registry_configs:
             config_dict.update(registry_config.get_config())
@@ -179,7 +193,7 @@ class MCPAgent(ChatAgent):
         if self.local_config:
             config_dict.update(self.local_config)
 
-        return MCPToolkit(config_dict=config_dict, strict=self.strict)
+        return MCPToolkit(config_dict=config_dict)
 
     def add_registry(self, registry_config: BaseMCPRegistryConfig) -> None:
         r"""Add a new registry configuration to the agent.
@@ -213,7 +227,6 @@ class MCPAgent(ChatAgent):
         ] = None,
         model: Optional[BaseModelBackend] = None,
         function_calling_available: bool = False,
-        strict: bool = False,
         **kwargs,
     ) -> "MCPAgent":
         r"""Create and connect an MCPAgent instance.
@@ -279,7 +292,6 @@ class MCPAgent(ChatAgent):
             registry_configs=final_registry_configs,
             model=model,
             function_calling_available=function_calling_available,
-            strict=strict,
             **kwargs,
         )
 
@@ -338,27 +350,14 @@ class MCPAgent(ChatAgent):
             task = f"## Task:\n  {input_message}"
             input_message = str(self._text_tools) + task
             response = await super().astep(input_message, *args, **kwargs)
-            content = response.msgs[0].content.lower()
-
-            tool_calls = []
-            while "```json" in content:
-                json_match = re.search(r'```json', content)
-                if not json_match:
-                    break
-                json_start = json_match.span()[1]
-
-                end_match = re.search(r'```', content[json_start:])
-                if not end_match:
-                    break
-                json_end = end_match.span()[0] + json_start
-
-                tool_json = content[json_start:json_end].strip('\n')
-                try:
-                    tool_calls.append(json.loads(tool_json))
-                except json.JSONDecodeError:
-                    logger.warning(f"Failed to parse JSON: {tool_json}")
-                    continue
-                content = content[json_end:]
+            raw_content = response.msgs[0].content if response.msgs else ""
+            content = (
+                raw_content
+                if isinstance(raw_content, str)
+                else str(raw_content)
+            )
+
+            tool_calls = extract_tool_calls_from_text(content)
 
             if not tool_calls:
                 return response

camel/agents/multi_hop_generator_agent.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 textwrap
 from typing import Any
@@ -56,7 +56,7 @@ class MultiHopGeneratorAgent(ProgrammableChatAgent):
 
         system_text: str = textwrap.dedent(
             """\
-            You are an expert at generating 
+            You are an expert at generating
             multi-hop question-answer pairs.
             For each context, you should:
             1. Identify multiple related facts or pieces of information

camel/agents/programmed_agent_instruction.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 abc
 import threading
 from enum import Enum

camel/agents/repo_agent.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 time
 from enum import Enum, auto
 from string import Template
@@ -21,6 +21,7 @@ if TYPE_CHECKING:
 from pydantic import BaseModel
 
 from camel.agents import ChatAgent
+from camel.agents.chat_agent import StreamingChatAgentResponse
 from camel.logger import get_logger
 from camel.messages import BaseMessage
 from camel.models import BaseModelBackend, ModelFactory
@@ -442,7 +443,7 @@ class RepoAgent(ChatAgent):
 
     def step(
         self, input_message: Union[BaseMessage, str], *args, **kwargs
-    ) -> ChatAgentResponse:
+    ) -> Union[ChatAgentResponse, StreamingChatAgentResponse]:
         r"""Overrides `ChatAgent.step()` to first retrieve relevant context
         from the vector store before passing the input to the language model.
         """

camel/agents/role_assignment_agent.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 re
 from typing import Dict, Optional, Union
 

camel/agents/search_agent.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 Optional
 
 from camel.agents.chat_agent import ChatAgent

camel/agents/task_agent.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, Dict, List, Optional, Union
 
 from camel.agents.chat_agent import ChatAgent

camel/agents/tool_agents/__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 .base import BaseToolAgent
 from .hugging_face_tool_agent import HuggingFaceToolAgent
 

camel/agents/tool_agents/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 camel.agents import BaseAgent
 
 

camel/agents/tool_agents/hugging_face_tool_agent.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, Optional
 
 from camel.agents.tool_agents.base import BaseToolAgent
@@ -90,7 +90,7 @@ rivers_and_lakes_image.save("./rivers_and_lakes_image.png")
 sea_add_island_image = {name}.step("Draw me a picture of the sea then transform the picture to add an island")
 sea_add_island_image.save("./sea_add_island_image.png")
 
-# If you'd like to keep a state across executions or to pass non-text objects to the agent, 
+# If you'd like to keep a state across executions or to pass non-text objects to the agent,
 # you can do so by specifying variables that you would like the agent to use. For example,
 # you could generate the first image of rivers and lakes, and ask the model to update that picture to add an island by doing the following:
 picture = {name}.step("Generate a picture of rivers and lakes.")