deepagents 0.3.8__py3-none-any.whl → 0.3.10__py3-none-any.whl

deepagents/middleware/skills.py

@@ -155,7 +155,7 @@ class SkillsState(AgentState):
     """State for the skills middleware."""
 
     skills_metadata: NotRequired[Annotated[list[SkillMetadata], PrivateStateAttr]]
-    """List of loaded skill metadata from all configured sources."""
+    """List of loaded skill metadata from configured sources. Not propagated to parent agents."""
 
 
 class SkillsStateUpdate(TypedDict):

deepagents/middleware/subagents.py

@@ -34,11 +34,11 @@ class SubAgent(TypedDict):
         system_prompt: Instructions for the subagent.
 
             Include tool usage guidance and output format requirements.
-        tools: Tools the subagent can use.
-
-            Keep this minimal and include only what's needed.
 
     Optional fields:
+        tools: Tools the subagent can use.
+
+            If not specified, inherits tools from the main agent via `default_tools`.
         model: Override the main agent's model.
 
             Use the format `'provider:model-name'` (e.g., `'openai:gpt-4o'`).
@@ -57,8 +57,8 @@ class SubAgent(TypedDict):
     system_prompt: str
     """Instructions for the subagent."""
 
-    tools: Sequence[BaseTool | Callable | dict[str, Any]]
-    """Tools the subagent can use."""
+    tools: NotRequired[Sequence[BaseTool | Callable | dict[str, Any]]]
+    """Tools the subagent can use. If not specified, inherits from main agent."""
 
     model: NotRequired[str | BaseChatModel]
     """Override the main agent's model. Use `'provider:model-name'` format."""
@@ -108,9 +108,10 @@ DEFAULT_SUBAGENT_PROMPT = "In order to complete the objective that the user asks
 # updates from subagents.
 # When returning updates:
 # 1. The messages key is handled explicitly to ensure only the final message is included
-# 2. The todos and structured_response keys are excluded as they do not have a defined reducer
-#    and no clear meaning for returning them from a subagent to the main agent.
-_EXCLUDED_STATE_KEYS = {"messages", "todos", "structured_response"}
+# 2. The todos, structured_response, and skills_metadata keys are excluded as they do not have
+#    a defined reducer and no clear meaning for returning them from a subagent to the main agent.
+#    Each agent loads its own skills independently based on its middleware configuration.
+_EXCLUDED_STATE_KEYS = {"messages", "todos", "structured_response", "skills_metadata"}
 
 TASK_TOOL_DESCRIPTION = """Launch an ephemeral subagent to handle complex, multi-step independent tasks with isolated context windows.
 
@@ -523,7 +524,20 @@ class SubAgentMiddleware(AgentMiddleware):
     ) -> None:
         """Initialize the `SubAgentMiddleware`."""
         super().__init__()
-        self.system_prompt = system_prompt
+
+        # Build list of available agents for system prompt
+        subagent_descriptions = []
+        if general_purpose_agent:
+            subagent_descriptions.append(f"- general-purpose: {DEFAULT_GENERAL_PURPOSE_DESCRIPTION}")
+        subagent_descriptions.extend(f"- {agent_['name']}: {agent_['description']}" for agent_ in subagents or [])
+
+        # Append available agents to system prompt if we have any
+        if system_prompt is not None and subagent_descriptions:
+            agents_section = "\n\nAvailable subagent types:\n" + "\n".join(subagent_descriptions)
+            self.system_prompt = system_prompt + agents_section
+        else:
+            self.system_prompt = system_prompt
+
         task_tool = _create_task_tool(
             default_model=default_model,
             default_tools=default_tools or [],

deepagents/middleware/summarization.py

@@ -34,6 +34,7 @@ from __future__ import annotations
 
 import logging
 import uuid
+import warnings
 from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Any, cast
 
@@ -658,8 +659,10 @@ A condensed summary follows:
         backend = self._get_backend(state, runtime)
         file_path = self._offload_to_backend(backend, messages_to_summarize)
         if file_path is None:
-            # Offloading failed - don't proceed with summarization to preserve messages
-            return None
+            warnings.warn(
+                "Offloading conversation history to backend failed during summarization.",
+                stacklevel=2,
+            )
 
         # Generate summary
         summary = self._create_summary(messages_to_summarize)
@@ -740,8 +743,10 @@ A condensed summary follows:
         backend = self._get_backend(state, runtime)
         file_path = await self._aoffload_to_backend(backend, messages_to_summarize)
         if file_path is None:
-            # Offloading failed - don't proceed with summarization to preserve messages
-            return None
+            warnings.warn(
+                "Offloading conversation history to backend failed during summarization.",
+                stacklevel=2,
+            )
 
         # Generate summary
         summary = await self._acreate_summary(messages_to_summarize)

deepagents-0.3.10.dist-info/METADATA

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: deepagents
+Version: 0.3.10
+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
+Project-URL: Documentation, https://reference.langchain.com/python/deepagents/
+Project-URL: Repository, https://github.com/langchain-ai/deepagents
+Project-URL: Issues, https://github.com/langchain-ai/deepagents/issues
+Project-URL: Twitter, https://x.com/LangChain
+Project-URL: Slack, https://www.langchain.com/join-community
+Project-URL: Reddit, https://www.reddit.com/r/LangChain/
+Keywords: agents,ai,llm,langgraph,langchain,deep-agent,sub-agents,agentic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core<2.0.0,>=1.2.7
+Requires-Dist: langchain<2.0.0,>=1.2.7
+Requires-Dist: langchain-anthropic<2.0.0,>=1.3.1
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.0
+Requires-Dist: wcmatch
+
+# 🧠🤖 Deep Agents
+
+[![PyPI - Version](https://img.shields.io/pypi/v/deepagents?label=%20)](https://pypi.org/project/deepagents/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/deepagents)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/deepagents)](https://pypistats.org/packages/deepagents)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain)
+
+Looking for the JS/TS version? Check out [Deep Agents.js](https://github.com/langchain-ai/deepagentsjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com).
+LangSmith is a unified developer platform for building, testing, and monitoring LLM applications.
+
+## Quick Install
+
+```bash
+pip install deepagents
+# or
+uv add deepagents
+```
+
+## 🤔 What is this?
+
+Using an LLM to call tools in a loop is the simplest form of an agent. This architecture, however, can yield agents that are "shallow" and fail to plan and act over longer, more complex tasks.
+
+Applications like "Deep Research", "Manus", and "Claude Code" have gotten around this limitation by implementing a combination of four things: a **planning tool**, **sub agents**, access to a **file system**, and a **detailed prompt**.
+
+`deepagents` is a Python package that implements these in a general purpose way so that you can easily create a Deep Agent for your application. For a full overview and quickstart of Deep Agents, the best resource is our [docs](https://docs.langchain.com/oss/python/deepagents/overview).
+
+**Acknowledgements: This project was primarily inspired by Claude Code, and initially was largely an attempt to see what made Claude Code general purpose, and make it even more so.**
+
+## 📖 Resources
+
+- **[Documentation](https://docs.langchain.com/oss/python/deepagents)** — Full documentation
+- **[API Reference](https://reference.langchain.com/python/deepagents/)** — Full SDK reference documentation
+- **[Chat LangChain](https://chat.langchain.com)** - Chat interactively with the docs
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

deepagents-0.3.10.dist-info/RECORD

@@ -0,0 +1,25 @@
+deepagents/__init__.py,sha256=I3SO951ndc3UC8EG4V2Jx4R6N7Y0_viVcvZUNusSifE,511
+deepagents/_version.py,sha256=wJC6K-43C-1aQ53TQtlkummd0uoyDohQSuHv9VnxbMg,90
+deepagents/graph.py,sha256=czbV_e5wMyt7K83LwcpKzKdJq8Tr9Ha7iSmAh32WC_4,10520
+deepagents/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deepagents/backends/__init__.py,sha256=Gd5SJA8Atk9FUyyBkWB_ukul4piJbmgE-0fdKyPrs3g,544
+deepagents/backends/composite.py,sha256=_yPSbhmUOvBRTKxUPBe5-ChEmtAOHNpB6GDGXMf7f7c,26216
+deepagents/backends/filesystem.py,sha256=WxX959tCsV7niiqqAU2XEb83rcu8zEU3K-7xEn9a4L0,26709
+deepagents/backends/local_shell.py,sha256=M88igtVCBj8MWs723JSphrszwvkSn6J8iH-YdEMsra0,12728
+deepagents/backends/protocol.py,sha256=HUmIrwYGduPfDcs_wtOzVU2QPA9kICZuGO-sUwxzz5I,15997
+deepagents/backends/sandbox.py,sha256=Q1Ck_vMivVc8no8iIbK27mpbmJKHs80A4VxqoDeWPjM,26737
+deepagents/backends/state.py,sha256=Qq4uRjKg6POEqLl4tNnWnXzbmLBpu3bZdMkcUROIgHw,7899
+deepagents/backends/store.py,sha256=9gdUQqPWChYgHVoopOUaocUdyUbFBpf-PxhTiXRXCto,18219
+deepagents/backends/utils.py,sha256=6YZjmT2VQRBekQSsnlmS_FhmU12lA2_0irf_YBQWBC4,16033
+deepagents/middleware/__init__.py,sha256=tATwi3JI-90-Wuf3Wg-szWkSBuKO9F2iyc5NoHP9q4g,566
+deepagents/middleware/_utils.py,sha256=ojy62kQLASQ2GabevWJaPGLItyccdNxLMPpYV25Lf20,687
+deepagents/middleware/filesystem.py,sha256=8Xk-u-Qc2BcT8TMAijJs0qz_qhK11kf5TFXSECdSYfw,56722
+deepagents/middleware/memory.py,sha256=D6CNDeh5wUGLuY0CZWubFn_cfW81XuzxEZGJK02vFiU,15860
+deepagents/middleware/patch_tool_calls.py,sha256=PdNhxPaQqwnFkhEAZEE2kEzadTNAOO3_iJRA30WqpGE,1981
+deepagents/middleware/skills.py,sha256=ICQy6ZEGKU55UfJh8qs06m-fKq9nrK0okCO4-BcXkLc,24210
+deepagents/middleware/subagents.py,sha256=kIyV6aOOKt5--nX9CpJmY4d7x4RXGc80rZN9_gLZJ4c,28139
+deepagents/middleware/summarization.py,sha256=y5oXrepdJ0BkGcqdUQ3qO-cNVHb_QKVWjEFRurUF5sM,29127
+deepagents-0.3.10.dist-info/METADATA,sha256=ct0p_mGT-BgJ0hU6sU5JuiIUJa3cyLBqoY5V9zJBxSo,4203
+deepagents-0.3.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+deepagents-0.3.10.dist-info/top_level.txt,sha256=drAzchOzPNePwpb3_pbPuvLuayXkN7SNqeIKMBWJoAo,11
+deepagents-0.3.10.dist-info/RECORD,,

{deepagents-0.3.8.dist-info → deepagents-0.3.10.dist-info}/WHEEL

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