deepagents 0.3.7__py3-none-any.whl → 0.3.7a1__py3-none-any.whl

deepagents/middleware/subagents.py

@@ -1,7 +1,7 @@
 """Middleware for providing subagents to an agent via a `task` tool."""
 
 from collections.abc import Awaitable, Callable, Sequence
-from typing import Annotated, Any, NotRequired, TypedDict, cast
+from typing import Any, NotRequired, TypedDict, cast
 
 from langchain.agents import create_agent
 from langchain.agents.middleware import HumanInTheLoopMiddleware, InterruptOnConfig
@@ -73,14 +73,10 @@ class SubAgent(TypedDict):
 class CompiledSubAgent(TypedDict):
     """A pre-compiled agent spec.
 
-    !!! note
-
-        The runnable's state schema must include a 'messages' key.
-
-        This is required for the subagent to communicate results back to the main agent.
-
+    Important: The runnable's state schema must include a 'messages' key.
+    This is required for the subagent to communicate results back to the main agent.
     When the subagent completes, the final message in the 'messages' list will be
-    extracted and returned as a `ToolMessage` to the parent agent.
+    extracted and returned as a ToolMessage to the parent agent.
     """
 
     name: str
@@ -94,8 +90,8 @@ class CompiledSubAgent(TypedDict):
 
     Create a custom agent using either:
 
-    1. LangChain's [`create_agent()`](https://docs.langchain.com/oss/python/langchain/quickstart)
-    2. A custom graph using [`langgraph`](https://docs.langchain.com/oss/python/langgraph/quickstart)
+    1. LangChain's `create_agent()`: https://docs.langchain.com/oss/python/langchain/quickstart
+    2. A custom graph using langgraph: https://docs.langchain.com/oss/python/langgraph/quickstart
 
     If you're creating a custom graph, make sure the state schema includes a 'messages' key.
     This is required for the subagent to communicate results back to the main agent.
@@ -399,11 +395,8 @@ def _create_task_tool(
         task_description = task_description.format(available_agents=subagent_description_str)
 
     def task(
-        description: Annotated[
-            str,
-            "A detailed description of the task for the subagent to perform autonomously. Include all necessary context and specify the expected output format.",  # noqa: E501
-        ],
-        subagent_type: Annotated[str, "The type of subagent to use. Must be one of the available agent types listed in the tool description."],
+        description: str,
+        subagent_type: str,
         runtime: ToolRuntime,
     ) -> str | Command:
         if subagent_type not in subagent_graphs:
@@ -417,11 +410,8 @@ def _create_task_tool(
         return _return_command_with_state_update(result, runtime.tool_call_id)
 
     async def atask(
-        description: Annotated[
-            str,
-            "A detailed description of the task for the subagent to perform autonomously. Include all necessary context and specify the expected output format.",  # noqa: E501
-        ],
-        subagent_type: Annotated[str, "The type of subagent to use. Must be one of the available agent types listed in the tool description."],
+        description: str,
+        subagent_type: str,
         runtime: ToolRuntime,
     ) -> str | Command:
         if subagent_type not in subagent_graphs:
@@ -460,24 +450,18 @@ class SubAgentMiddleware(AgentMiddleware):
 
     Args:
         default_model: The model to use for subagents.
-
-            Can be a `LanguageModelLike` or a dict for `init_chat_model`.
+            Can be a LanguageModelLike or a dict for init_chat_model.
         default_tools: The tools to use for the default general-purpose subagent.
-        default_middleware: Default middleware to apply to all subagents.
-
-            If `None`, no default middleware is applied.
-
-            Pass a list to specify custom middleware.
-        default_interrupt_on: The tool configs to use for the default general-purpose subagent.
-
-            These are also the fallback for any subagents that don't specify their own tool configs.
+        default_middleware: Default middleware to apply to all subagents. If `None` (default),
+            no default middleware is applied. Pass a list to specify custom middleware.
+        default_interrupt_on: The tool configs to use for the default general-purpose subagent. These
+            are also the fallback for any subagents that don't specify their own tool configs.
         subagents: A list of additional subagents to provide to the agent.
         system_prompt: Full system prompt override. When provided, completely replaces
             the agent's system prompt.
-        general_purpose_agent: Whether to include the general-purpose agent.
-        task_description: Custom description for the task tool.
-
-            If `None`, uses the default description template.
+        general_purpose_agent: Whether to include the general-purpose agent. Defaults to `True`.
+        task_description: Custom description for the task tool. If `None`, uses the
+            default description template.
 
     Example:
         ```python
@@ -521,7 +505,7 @@ class SubAgentMiddleware(AgentMiddleware):
         general_purpose_agent: bool = True,
         task_description: str | None = None,
     ) -> None:
-        """Initialize the `SubAgentMiddleware`."""
+        """Initialize the SubAgentMiddleware."""
         super().__init__()
         self.system_prompt = system_prompt
         task_tool = _create_task_tool(

{deepagents-0.3.7.dist-info → deepagents-0.3.7a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.3.7
+Version: 0.3.7a1
 Summary: General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph.
 License: MIT
 Project-URL: Homepage, https://docs.langchain.com/oss/python/deepagents/overview

deepagents-0.3.7a1.dist-info/RECORD

@@ -0,0 +1,21 @@
+deepagents/__init__.py,sha256=LHQm0v_7N9Gd4pmpRjhnlOCMIK2O0jQ4cEU8RiXEI8k,447
+deepagents/graph.py,sha256=Rk1qDzPpjSKGHc1NJ1CQcbFrFoMlPgKIGFm2EWW3--0,9802
+deepagents/backends/__init__.py,sha256=BOKu2cQ1OdMyO_l2rLqZQiXppYFmQbx7OIQb7WYwvZc,457
+deepagents/backends/composite.py,sha256=WZ_dnn63BmrU19ZJ5-m728f99pSa0Uq_CnwZjwmxz1U,26198
+deepagents/backends/filesystem.py,sha256=Okr4zUJkDc_tx01Sya8sHTsYzahsRiDdFWWX2A_G-RQ,24617
+deepagents/backends/protocol.py,sha256=HUmIrwYGduPfDcs_wtOzVU2QPA9kICZuGO-sUwxzz5I,15997
+deepagents/backends/sandbox.py,sha256=PE4-DkVRU5Z3zp4NViHCkNHUHKiFUKh55UAXCicBvRo,10884
+deepagents/backends/state.py,sha256=Qq4uRjKg6POEqLl4tNnWnXzbmLBpu3bZdMkcUROIgHw,7899
+deepagents/backends/store.py,sha256=9gdUQqPWChYgHVoopOUaocUdyUbFBpf-PxhTiXRXCto,18219
+deepagents/backends/utils.py,sha256=CE_HXddNTr954auqFIVgYLLD4Gdsfr9U8b384g07Wuc,13932
+deepagents/middleware/__init__.py,sha256=2smUxjwghA3Eml_wp0kd4dAY-rwLyW-XQPBE3dAoo50,467
+deepagents/middleware/_utils.py,sha256=ojy62kQLASQ2GabevWJaPGLItyccdNxLMPpYV25Lf20,687
+deepagents/middleware/filesystem.py,sha256=z6jrmXuksloebN6ZlNbjKw847AC8IjLS-TYz6ELyXFY,52745
+deepagents/middleware/memory.py,sha256=1w-laeDHCiY0hxf5fURFnwcXvI78FhPo7_mYjvZudWE,15826
+deepagents/middleware/patch_tool_calls.py,sha256=PdNhxPaQqwnFkhEAZEE2kEzadTNAOO3_iJRA30WqpGE,1981
+deepagents/middleware/skills.py,sha256=3UhHWGzVlmX6qubvhFTx14LUhd6-ZK6nhkhxV8XrIMQ,24045
+deepagents/middleware/subagents.py,sha256=jU1a45CTlMNz1D3U9f3V5J2AoWzKMDXOf-55N6PNG00,26596
+deepagents-0.3.7a1.dist-info/METADATA,sha256=P8TN8XaOCgNTfy9R-7VLgVMl7S1WkAggGqJqtmubAj0,19764
+deepagents-0.3.7a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+deepagents-0.3.7a1.dist-info/top_level.txt,sha256=drAzchOzPNePwpb3_pbPuvLuayXkN7SNqeIKMBWJoAo,11
+deepagents-0.3.7a1.dist-info/RECORD,,

{deepagents-0.3.7.dist-info → deepagents-0.3.7a1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any