camel-ai 0.2.23__tar.gz → 0.2.24__tar.gz

{camel_ai-0.2.23 → camel_ai-0.2.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.23
+Version: 0.2.24
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel
@@ -27,7 +27,7 @@ Provides-Extra: all
 Requires-Dist: accelerate<0.27,>=0.26.0; extra == 'all'
 Requires-Dist: agentops<0.4,>=0.3.21; extra == 'all'
 Requires-Dist: aiosqlite<0.21,>=0.20.0; extra == 'all'
-Requires-Dist: anthropic<0.43,>=0.42.0; extra == 'all'
+Requires-Dist: anthropic<0.50.0,>=0.47.0; extra == 'all'
 Requires-Dist: apify-client<2,>=1.8.1; extra == 'all'
 Requires-Dist: arxiv2text<0.2,>=0.1.14; extra == 'all'
 Requires-Dist: arxiv<3,>=2.1.3; extra == 'all'
@@ -43,12 +43,14 @@ Requires-Dist: diffusers<0.26,>=0.25.0; extra == 'all'
 Requires-Dist: discord-py<3,>=2.3.2; extra == 'all'
 Requires-Dist: docker<8,>=7.1.0; extra == 'all'
 Requires-Dist: docx2txt<0.9,>=0.8; extra == 'all'
+Requires-Dist: docx>=0.2.4; extra == 'all'
 Requires-Dist: duckduckgo-search<7,>=6.3.5; extra == 'all'
 Requires-Dist: e2b-code-interpreter<2,>=1.0.3; extra == 'all'
 Requires-Dist: fastapi>=0.115.11; extra == 'all'
 Requires-Dist: ffmpeg-python<0.3,>=0.2.0; extra == 'all'
 Requires-Dist: firecrawl-py<2,>=1.0.0; extra == 'all'
 Requires-Dist: fish-audio-sdk<2025,>=2024.12.5; extra == 'all'
+Requires-Dist: fpdf>=1.7.2; extra == 'all'
 Requires-Dist: google-cloud-storage<3,>=2.18.0; extra == 'all'
 Requires-Dist: googlemaps<5,>=4.10.0; extra == 'all'
 Requires-Dist: gradio<4,>=3; extra == 'all'
@@ -58,6 +60,7 @@ Requires-Dist: ipykernel<7,>=6.0.0; extra == 'all'
 Requires-Dist: jupyter-client<9,>=8.6.2; extra == 'all'
 Requires-Dist: linkup-sdk<0.3,>=0.2.1; extra == 'all'
 Requires-Dist: litellm<2,>=1.38.1; extra == 'all'
+Requires-Dist: mcp>=1.3.0; extra == 'all'
 Requires-Dist: mistralai<2,>=1.1.0; extra == 'all'
 Requires-Dist: mock<6,>=5; extra == 'all'
 Requires-Dist: mypy<2,>=1.5.1; extra == 'all'
@@ -108,6 +111,7 @@ Requires-Dist: torch; extra == 'all'
 Requires-Dist: transformers<5,>=4; extra == 'all'
 Requires-Dist: tree-sitter-python<0.24,>=0.23.6; extra == 'all'
 Requires-Dist: tree-sitter<0.24,>=0.23.2; extra == 'all'
+Requires-Dist: typer>=0.15.2; extra == 'all'
 Requires-Dist: types-colorama<0.5,>=0.4.15; extra == 'all'
 Requires-Dist: types-mock<6,>=5.1.0; extra == 'all'
 Requires-Dist: types-pyyaml<7,>=6.0.12; extra == 'all'
@@ -152,14 +156,17 @@ Requires-Dist: types-pyyaml<7,>=6.0.12; extra == 'dev'
 Requires-Dist: types-requests<3,>=2.31.0; extra == 'dev'
 Requires-Dist: types-setuptools<70,>=69.2.0; extra == 'dev'
 Requires-Dist: types-tqdm<5,>=4.66.0; extra == 'dev'
+Requires-Dist: uv==0.6.5; extra == 'dev'
 Provides-Extra: dev-tools
 Requires-Dist: agentops<0.4,>=0.3.21; extra == 'dev-tools'
 Requires-Dist: docker<8,>=7.1.0; extra == 'dev-tools'
 Requires-Dist: e2b-code-interpreter<2,>=1.0.3; extra == 'dev-tools'
 Requires-Dist: ipykernel<7,>=6.0.0; extra == 'dev-tools'
 Requires-Dist: jupyter-client<9,>=8.6.2; extra == 'dev-tools'
+Requires-Dist: mcp>=1.3.0; extra == 'dev-tools'
 Requires-Dist: tree-sitter-python<0.24,>=0.23.6; extra == 'dev-tools'
 Requires-Dist: tree-sitter<0.24,>=0.23.2; extra == 'dev-tools'
+Requires-Dist: typer>=0.15.2; extra == 'dev-tools'
 Provides-Extra: docs
 Requires-Dist: docutils<0.20.0; extra == 'docs'
 Requires-Dist: myst-parser; extra == 'docs'
@@ -170,6 +177,8 @@ Requires-Dist: sphinxext-rediraffe<0.3,>=0.2.7; extra == 'docs'
 Provides-Extra: document-tools
 Requires-Dist: beautifulsoup4<5,>=4; extra == 'document-tools'
 Requires-Dist: docx2txt<0.9,>=0.8; extra == 'document-tools'
+Requires-Dist: docx>=0.2.4; extra == 'document-tools'
+Requires-Dist: fpdf>=1.7.2; extra == 'document-tools'
 Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'document-tools'
 Requires-Dist: openpyxl>=3.1.5; extra == 'document-tools'
 Requires-Dist: pandasai<3,>=2.3.0; extra == 'document-tools'
@@ -195,7 +204,7 @@ Requires-Dist: pydub<0.26,>=0.25.1; extra == 'media-tools'
 Requires-Dist: scenedetect>=0.6.5.2; extra == 'media-tools'
 Requires-Dist: yt-dlp<2025,>=2024.11.4; extra == 'media-tools'
 Provides-Extra: model-platforms
-Requires-Dist: anthropic<0.43,>=0.42.0; extra == 'model-platforms'
+Requires-Dist: anthropic<0.50.0,>=0.47.0; extra == 'model-platforms'
 Requires-Dist: cohere<6,>=5.11.0; extra == 'model-platforms'
 Requires-Dist: fish-audio-sdk<2025,>=2024.12.5; extra == 'model-platforms'
 Requires-Dist: litellm<2,>=1.38.1; extra == 'model-platforms'

{camel_ai-0.2.23 → camel_ai-0.2.24}/camel/__init__.py

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

{camel_ai-0.2.23 → camel_ai-0.2.24}/camel/configs/anthropic_config.py

@@ -23,23 +23,24 @@ class AnthropicConfig(BaseConfig):
     r"""Defines the parameters for generating chat completions using the
     Anthropic API.
 
-    See: https://docs.anthropic.com/claude/reference/complete_post
+    See: https://docs.anthropic.com/en/api/messages
     Args:
         max_tokens (int, optional): The maximum number of tokens to
             generate before stopping. Note that Anthropic models may stop
             before reaching this maximum. This parameter only specifies the
             absolute maximum number of tokens to generate.
             (default: :obj:`8192`)
-        stop_sequences (List[str], optional): Sequences that will cause the
-            model to stop generating completion text. Anthropic models stop
-            on "\n\nHuman:", and may include additional built-in stop sequences
-            in the future. By providing the stop_sequences parameter, you may
-            include additional strings that will cause the model to stop
-            generating. (default: :obj:`[]`)
+        stop_sequences (List[str], optional): Custom text sequences that will
+            cause the model to stop generating. The models will normally stop
+            when they have naturally completed their turn. If the model
+            encounters one of these custom sequences, the response will be
+            terminated and the stop_reason will be "stop_sequence".
+            (default: :obj:`[]`)
         temperature (float, optional): Amount of randomness injected into the
             response. Defaults to 1. Ranges from 0 to 1. Use temp closer to 0
             for analytical / multiple choice, and closer to 1 for creative
-            and generative tasks. (default: :obj:`1`)
+            and generative tasks. Note that even with temperature of 0.0, the
+            results will not be fully deterministic. (default: :obj:`1`)
         top_p (float, optional): Use nucleus sampling. In nucleus sampling, we
             compute the cumulative distribution over all the options for each
             subsequent token in decreasing probability order and cut it off
@@ -49,9 +50,20 @@ class AnthropicConfig(BaseConfig):
         top_k (int, optional): Only sample from the top K options for each
             subsequent token. Used to remove "long tail" low probability
             responses. (default: :obj:`5`)
-        metadata: An object describing metadata about the request.
         stream (bool, optional): Whether to incrementally stream the response
             using server-sent events. (default: :obj:`False`)
+        metadata (Union[dict, NotGiven], optional): An object describing
+            metadata about the request. Can include user_id as an external
+            identifier for the user associated with the request.
+            (default: :obj:`NotGiven()`)
+        thinking (Union[dict, NotGiven], optional): Configuration for enabling
+            Claude's extended thinking. When enabled, responses include
+            thinking content blocks showing Claude's thinking process.
+            (default: :obj:`NotGiven()`)
+        tool_choice (Union[dict, NotGiven], optional): How the model should
+            use the provided tools. The model can use a specific tool, any
+            available tool, decide by itself, or not use tools at all.
+            (default: :obj:`NotGiven()`)
     """
 
     max_tokens: int = 8192
@@ -60,11 +72,33 @@ class AnthropicConfig(BaseConfig):
     top_p: Union[float, NotGiven] = 0.7
     top_k: Union[int, NotGiven] = 5
     stream: bool = False
+    metadata: Union[dict, NotGiven] = NotGiven()
+    thinking: Union[dict, NotGiven] = NotGiven()
+    tool_choice: Union[dict, NotGiven] = NotGiven()
 
     def as_dict(self) -> dict[str, Any]:
         config_dict = super().as_dict()
-        if "tools" in config_dict:
-            del config_dict["tools"]  # TODO: Support tool calling.
+        # Create a list of keys to remove to avoid modifying dict
+        keys_to_remove = [
+            key
+            for key, value in config_dict.items()
+            if isinstance(value, NotGiven)
+        ]
+
+        for key in keys_to_remove:
+            del config_dict[key]
+
+        # remove some keys if thinking is enabled
+        thinking_enabled = (
+            not isinstance(self.thinking, NotGiven)
+            and self.thinking["type"] == "enabled"
+        )
+        if thinking_enabled:
+            # `top_p`, `top_k`, `temperature` must be unset when thinking is
+            # enabled.
+            config_dict.pop("top_k", None)
+            config_dict.pop("top_p", None)
+            config_dict.pop("temperature", None)
         return config_dict
 
 

{camel_ai-0.2.23 → camel_ai-0.2.24}/camel/models/anthropic_model.py

@@ -84,7 +84,11 @@ class AnthropicModel(BaseModelBackend):
                     index=0,
                     message={
                         "role": "assistant",
-                        "content": response.content[0].text,
+                        "content": next(
+                            content.text
+                            for content in response.content
+                            if content.type == "text"
+                        ),
                     },
                     finish_reason=response.stop_reason,
                 )

{camel_ai-0.2.23 → camel_ai-0.2.24}/camel/societies/role_playing.py

@@ -468,6 +468,42 @@ class RolePlaying:
 
         return init_msg
 
+    async def ainit_chat(
+        self, init_msg_content: Optional[str] = None
+    ) -> BaseMessage:
+        r"""Asynchronously initializes the chat by resetting both of the
+        assistant and user agents. Returns an initial message for the
+        role-playing session.
+
+        Args:
+            init_msg_content (str, optional): A user-specified initial message.
+                Will be sent to the role-playing session as the initial
+                message. (default: :obj:`None`)
+
+        Returns:
+            BaseMessage: A single `BaseMessage` representing the initial
+                message.
+        """
+        # Currently, reset() is synchronous, but if it becomes async in the
+        # future, we can await it here
+        self.assistant_agent.reset()
+        self.user_agent.reset()
+        default_init_msg_content = (
+            "Now start to give me instructions one by one. "
+            "Only reply with Instruction and Input."
+        )
+        if init_msg_content is None:
+            init_msg_content = default_init_msg_content
+
+        # Initialize a message sent by the assistant
+        init_msg = BaseMessage.make_assistant_message(
+            role_name=getattr(self.assistant_sys_msg, 'role_name', None)
+            or "assistant",
+            content=init_msg_content,
+        )
+
+        return init_msg
+
     def step(
         self,
         assistant_msg: BaseMessage,
@@ -549,3 +585,86 @@ class RolePlaying:
                 info=user_response.info,
             ),
         )
+
+    async def astep(
+        self,
+        assistant_msg: BaseMessage,
+    ) -> Tuple[ChatAgentResponse, ChatAgentResponse]:
+        r"""Asynchronously advances the conversation by taking a message from
+        the assistant, processing it using the user agent, and then processing
+        the resulting message using the assistant agent. Returns a tuple
+        containing the resulting assistant message, whether the assistant
+        agent terminated the conversation, and any additional assistant
+        information, as well as a tuple containing the resulting user message,
+        whether the user agent terminated the conversation, and any additional
+        user information.
+
+        Args:
+            assistant_msg: A `BaseMessage` representing the message from the
+                assistant.
+
+        Returns:
+            Tuple[ChatAgentResponse, ChatAgentResponse]: A tuple containing two
+                ChatAgentResponse: the first struct contains the resulting
+                assistant message, whether the assistant agent terminated the
+                conversation, and any additional assistant information; the
+                second struct contains the resulting user message, whether the
+                user agent terminated the conversation, and any additional user
+                information.
+        """
+        user_response = await self.user_agent.astep(assistant_msg)
+        if user_response.terminated or user_response.msgs is None:
+            return (
+                ChatAgentResponse(msgs=[], terminated=False, info={}),
+                ChatAgentResponse(
+                    msgs=[],
+                    terminated=user_response.terminated,
+                    info=user_response.info,
+                ),
+            )
+        user_msg = self._reduce_message_options(user_response.msgs)
+
+        # To prevent recording the same memory more than once (once in chat
+        # step and once in role play), and the model generates only one
+        # response when multi-response support is enabled.
+        if (
+            'n' in self.user_agent.model_backend.model_config_dict.keys()
+            and self.user_agent.model_backend.model_config_dict['n'] > 1
+        ):
+            self.user_agent.record_message(user_msg)
+
+        assistant_response = await self.assistant_agent.astep(user_msg)
+        if assistant_response.terminated or assistant_response.msgs is None:
+            return (
+                ChatAgentResponse(
+                    msgs=[],
+                    terminated=assistant_response.terminated,
+                    info=assistant_response.info,
+                ),
+                ChatAgentResponse(
+                    msgs=[user_msg], terminated=False, info=user_response.info
+                ),
+            )
+        assistant_msg = self._reduce_message_options(assistant_response.msgs)
+
+        # To prevent recording the same memory more than once (once in chat
+        # step and once in role play), and the model generates only one
+        # response when multi-response support is enabled.
+        if (
+            'n' in self.assistant_agent.model_backend.model_config_dict.keys()
+            and self.assistant_agent.model_backend.model_config_dict['n'] > 1
+        ):
+            self.assistant_agent.record_message(assistant_msg)
+
+        return (
+            ChatAgentResponse(
+                msgs=[assistant_msg],
+                terminated=assistant_response.terminated,
+                info=assistant_response.info,
+            ),
+            ChatAgentResponse(
+                msgs=[user_msg],
+                terminated=user_response.terminated,
+                info=user_response.info,
+            ),
+        )

{camel_ai-0.2.23 → camel_ai-0.2.24}/camel/toolkits/__init__.py

@@ -54,7 +54,10 @@ from .audio_analysis_toolkit import AudioAnalysisToolkit
 from .excel_toolkit import ExcelToolkit
 from .video_analysis_toolkit import VideoAnalysisToolkit
 from .image_analysis_toolkit import ImageAnalysisToolkit
+from .mcp_toolkit import MCPToolkit
 from .web_toolkit import WebToolkit
+from .file_write_toolkit import FileWriteToolkit
+from .terminal_toolkit import TerminalToolkit
 
 
 __all__ = [
@@ -93,9 +96,12 @@ __all__ = [
     'ZapierToolkit',
     'SymPyToolkit',
     'MinerUToolkit',
+    'MCPToolkit',
     'AudioAnalysisToolkit',
     'ExcelToolkit',
     'VideoAnalysisToolkit',
     'ImageAnalysisToolkit',
     'WebToolkit',
+    'FileWriteToolkit',
+    'TerminalToolkit',
 ]