deepagents 0.1.5rc1__tar.gz → 0.2.0__tar.gz

deepagents-0.1.5rc1/README.md → deepagents-0.2.0/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: deepagents
+Version: 0.2.0
+Summary: General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph.
+License: MIT
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0
+Requires-Dist: langchain<2.0.0,>=1.0.0
+Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Requires-Dist: wcmatch
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: langchain-openai; extra == "dev"
+Dynamic: license-file
+
 # 🧠🤖Deep Agents
 
 Using an LLM to call tools in a loop is the simplest form of an agent. 
@@ -8,7 +28,7 @@ a **planning tool**, **sub agents**, access to a **file system**, and a **detail
 
 <img src="deep_agents.png" alt="deep agent" width="600"/>
 
-`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.
+`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 `deepagents`, 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.**
 
@@ -87,7 +107,7 @@ in the same way you would any LangGraph agent.
 
 **Context Management**
 
- File system tools (`ls`, `read_file`, `write_file`, `edit_file`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
+ File system tools (`ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
 
 **Subagent Spawning**
 
@@ -294,33 +314,6 @@ agent = create_deep_agent(
 )
 ```
 
-### `backend`
-Deep agents come with a local filesystem to offload memory to. By default, this filesystem is stored in state (ephemeral, transient to a single thread).
-
-You can configure persistent long-term memory using a composite backend that routes a path prefix (for example, `/memories/`) to a persistent store.
-
-```python
-from deepagents import create_deep_agent
-from deepagents.backends import build_composite_state_backend, StoreBackend
-from langgraph.store.memory import InMemoryStore
-
-store = InMemoryStore()  # Or any other Store implementation
-
-# Provide a backend factory to the agent/middleware.
-# This builds a state-backed composite at runtime and routes /memories/ to StoreBackend.
-backend_factory = lambda rt: build_composite_state_backend(
-    rt,
-    routes={
-        "/memories/": (lambda r: StoreBackend(r)),
-    },
-)
-
-agent = create_deep_agent(
-    backend=backend_factory,
-    store=store,
-)
-```
-
 ### `interrupt_on`
 A common reality for agents is that some tool operations may be sensitive and require human approval before execution. Deep Agents supports human-in-the-loop workflows through LangGraph’s interrupt capabilities. You can configure which tools require approval using a checkpointer.
 
@@ -393,11 +386,7 @@ Context engineering is one of the main challenges in building effective agents.
 ```python
 from langchain.agents import create_agent
 from deepagents.middleware.filesystem import FilesystemMiddleware
-from deepagents.backends import (
-    StateBackend,
-    CompositeBackend,
-    StoreBackend,
-)
+
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
@@ -405,12 +394,7 @@ agent = create_agent(
     model="anthropic:claude-sonnet-4-20250514",
     middleware=[
         FilesystemMiddleware(
-            backend=lambda rt: StateBackend(rt),  # Optional: customize storage backend (defaults to lambda rt: )
-            # For persistent memory, use CompositeBackend:
-            # backend=CompositeBackend(
-            #     default=lambda rt: StateBackend(rt)
-            #     routes={"/memories/": lambda rt: StoreBackend(rt)}
-            # )
+            backend=..., # Optional: customize storage backend
             system_prompt="Write to the filesystem when...",  # Optional custom system prompt override
             custom_tool_descriptions={
                 "ls": "Use the ls tool when...",

deepagents-0.1.5rc1/PKG-INFO → deepagents-0.2.0/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: deepagents
-Version: 0.1.5rc1
-Summary: General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph.
-License: MIT
-Requires-Python: <4.0,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0
-Requires-Dist: langchain<2.0.0,>=1.0.0
-Requires-Dist: langchain-core<2.0.0,>=1.0.0
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-Requires-Dist: langchain-openai; extra == "dev"
-Requires-Dist: wcmatch; extra == "dev"
-Dynamic: license-file
-
 # 🧠🤖Deep Agents
 
 Using an LLM to call tools in a loop is the simplest form of an agent. 
@@ -28,7 +8,7 @@ a **planning tool**, **sub agents**, access to a **file system**, and a **detail
 
 <img src="deep_agents.png" alt="deep agent" width="600"/>
 
-`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.
+`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 `deepagents`, 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.**
 
@@ -107,7 +87,7 @@ in the same way you would any LangGraph agent.
 
 **Context Management**
 
- File system tools (`ls`, `read_file`, `write_file`, `edit_file`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
+ File system tools (`ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
 
 **Subagent Spawning**
 
@@ -314,33 +294,6 @@ agent = create_deep_agent(
 )
 ```
 
-### `backend`
-Deep agents come with a local filesystem to offload memory to. By default, this filesystem is stored in state (ephemeral, transient to a single thread).
-
-You can configure persistent long-term memory using a composite backend that routes a path prefix (for example, `/memories/`) to a persistent store.
-
-```python
-from deepagents import create_deep_agent
-from deepagents.backends import build_composite_state_backend, StoreBackend
-from langgraph.store.memory import InMemoryStore
-
-store = InMemoryStore()  # Or any other Store implementation
-
-# Provide a backend factory to the agent/middleware.
-# This builds a state-backed composite at runtime and routes /memories/ to StoreBackend.
-backend_factory = lambda rt: build_composite_state_backend(
-    rt,
-    routes={
-        "/memories/": (lambda r: StoreBackend(r)),
-    },
-)
-
-agent = create_deep_agent(
-    backend=backend_factory,
-    store=store,
-)
-```
-
 ### `interrupt_on`
 A common reality for agents is that some tool operations may be sensitive and require human approval before execution. Deep Agents supports human-in-the-loop workflows through LangGraph’s interrupt capabilities. You can configure which tools require approval using a checkpointer.
 
@@ -413,11 +366,7 @@ Context engineering is one of the main challenges in building effective agents.
 ```python
 from langchain.agents import create_agent
 from deepagents.middleware.filesystem import FilesystemMiddleware
-from deepagents.backends import (
-    StateBackend,
-    CompositeBackend,
-    StoreBackend,
-)
+
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
@@ -425,12 +374,7 @@ agent = create_agent(
     model="anthropic:claude-sonnet-4-20250514",
     middleware=[
         FilesystemMiddleware(
-            backend=lambda rt: StateBackend(rt),  # Optional: customize storage backend (defaults to lambda rt: )
-            # For persistent memory, use CompositeBackend:
-            # backend=CompositeBackend(
-            #     default=lambda rt: StateBackend(rt)
-            #     routes={"/memories/": lambda rt: StoreBackend(rt)}
-            # )
+            backend=..., # Optional: customize storage backend
             system_prompt="Write to the filesystem when...",  # Optional custom system prompt override
             custom_tool_descriptions={
                 "ls": "Use the ls tool when...",

{deepagents-0.1.5rc1 → deepagents-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepagents"
-version = "0.1.5rc1"
+version = "0.2.0"
 description = "General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph."
 readme = "README.md"
 license = { text = "MIT" }
@@ -9,6 +9,7 @@ dependencies = [
     "langchain-anthropic>=1.0.0,<2.0.0",
     "langchain>=1.0.0,<2.0.0",
     "langchain-core>=1.0.0,<2.0.0",
+    "wcmatch"
 ]
 
 [project.optional-dependencies]
@@ -18,7 +19,6 @@ dev = [
     "build",
     "twine",
     "langchain-openai",
-    "wcmatch"
 ]
 
 [dependency-groups]

{deepagents-0.1.5rc1 → deepagents-0.2.0}/src/deepagents/backends/__init__.py

@@ -1,6 +1,6 @@
 """Memory backends for pluggable file storage."""
 
-from deepagents.backends.composite import CompositeBackend, build_composite_state_backend
+from deepagents.backends.composite import CompositeBackend
 from deepagents.backends.filesystem import FilesystemBackend
 from deepagents.backends.state import StateBackend
 from deepagents.backends.store import StoreBackend
@@ -9,7 +9,6 @@ from deepagents.backends.protocol import BackendProtocol
 __all__ = [
     "BackendProtocol",
     "CompositeBackend",
-    "build_composite_state_backend",
     "FilesystemBackend",
     "StateBackend",
     "StoreBackend",

{deepagents-0.1.5rc1 → deepagents-0.2.0}/src/deepagents/backends/composite.py

@@ -220,16 +220,4 @@ class CompositeBackend:
         return res
 
 
-def build_composite_state_backend(
-    runtime: ToolRuntime,
-    *,
-    routes: dict[str, BackendProtocol | BackendFactory],
-) -> BackendProtocol:
-    built_routes: dict[str, BackendProtocol] = {}
-    for k, v in routes.items():
-        if isinstance(v, BackendProtocol):
-            built_routes[k] = v
-        else:
-            built_routes[k] = v(runtime)
-    default_state = StateBackend(runtime)
-    return CompositeBackend(default=default_state, routes=built_routes)
+ 

{deepagents-0.1.5rc1 → deepagents-0.2.0}/src/deepagents/middleware/filesystem.py

@@ -657,10 +657,3 @@ class FilesystemMiddleware(AgentMiddleware):
 
         tool_result = await handler(request)
         return self._intercept_large_tool_result(tool_result)
-
-# Back-compat aliases expected by some tests
-def _create_file_data(content: str):
-    return create_file_data(content)
-
-def _update_file_data(file_data: dict, content: str):
-    return update_file_data(file_data, content)

{deepagents-0.1.5rc1 → deepagents-0.2.0}/src/deepagents.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.1.5rc1
+Version: 0.2.0
 Summary: General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph.
 License: MIT
 Requires-Python: <4.0,>=3.11
@@ -9,13 +9,13 @@ License-File: LICENSE
 Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0
 Requires-Dist: langchain<2.0.0,>=1.0.0
 Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Requires-Dist: wcmatch
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: langchain-openai; extra == "dev"
-Requires-Dist: wcmatch; extra == "dev"
 Dynamic: license-file
 
 # 🧠🤖Deep Agents
@@ -28,7 +28,7 @@ a **planning tool**, **sub agents**, access to a **file system**, and a **detail
 
 <img src="deep_agents.png" alt="deep agent" width="600"/>
 
-`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.
+`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 `deepagents`, 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.**
 
@@ -107,7 +107,7 @@ in the same way you would any LangGraph agent.
 
 **Context Management**
 
- File system tools (`ls`, `read_file`, `write_file`, `edit_file`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
+ File system tools (`ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`) allow agents to offload large context to memory, preventing context window overflow and enabling work with variable-length tool results.
 
 **Subagent Spawning**
 
@@ -314,33 +314,6 @@ agent = create_deep_agent(
 )
 ```
 
-### `backend`
-Deep agents come with a local filesystem to offload memory to. By default, this filesystem is stored in state (ephemeral, transient to a single thread).
-
-You can configure persistent long-term memory using a composite backend that routes a path prefix (for example, `/memories/`) to a persistent store.
-
-```python
-from deepagents import create_deep_agent
-from deepagents.backends import build_composite_state_backend, StoreBackend
-from langgraph.store.memory import InMemoryStore
-
-store = InMemoryStore()  # Or any other Store implementation
-
-# Provide a backend factory to the agent/middleware.
-# This builds a state-backed composite at runtime and routes /memories/ to StoreBackend.
-backend_factory = lambda rt: build_composite_state_backend(
-    rt,
-    routes={
-        "/memories/": (lambda r: StoreBackend(r)),
-    },
-)
-
-agent = create_deep_agent(
-    backend=backend_factory,
-    store=store,
-)
-```
-
 ### `interrupt_on`
 A common reality for agents is that some tool operations may be sensitive and require human approval before execution. Deep Agents supports human-in-the-loop workflows through LangGraph’s interrupt capabilities. You can configure which tools require approval using a checkpointer.
 
@@ -413,11 +386,7 @@ Context engineering is one of the main challenges in building effective agents.
 ```python
 from langchain.agents import create_agent
 from deepagents.middleware.filesystem import FilesystemMiddleware
-from deepagents.backends import (
-    StateBackend,
-    CompositeBackend,
-    StoreBackend,
-)
+
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
@@ -425,12 +394,7 @@ agent = create_agent(
     model="anthropic:claude-sonnet-4-20250514",
     middleware=[
         FilesystemMiddleware(
-            backend=lambda rt: StateBackend(rt),  # Optional: customize storage backend (defaults to lambda rt: )
-            # For persistent memory, use CompositeBackend:
-            # backend=CompositeBackend(
-            #     default=lambda rt: StateBackend(rt)
-            #     routes={"/memories/": lambda rt: StoreBackend(rt)}
-            # )
+            backend=..., # Optional: customize storage backend
             system_prompt="Write to the filesystem when...",  # Optional custom system prompt override
             custom_tool_descriptions={
                 "ls": "Use the ls tool when...",

{deepagents-0.1.5rc1 → deepagents-0.2.0}/tests/test_middleware.py

@@ -15,17 +15,25 @@ from deepagents.middleware.filesystem import (
     FILESYSTEM_SYSTEM_PROMPT,
     FileData,
     FilesystemMiddleware,
-    FilesystemState,
-    _create_file_data,
-    _update_file_data,
+    FilesystemState
 )
-from deepagents.backends import StoreBackend, CompositeBackend, build_composite_state_backend
+from deepagents.backends import StoreBackend, CompositeBackend, StateBackend
 
 from deepagents.backends.utils import create_file_data, update_file_data
 from deepagents.middleware.patch_tool_calls import PatchToolCallsMiddleware
 from deepagents.middleware.subagents import DEFAULT_GENERAL_PURPOSE_DESCRIPTION, TASK_SYSTEM_PROMPT, TASK_TOOL_DESCRIPTION, SubAgentMiddleware
 from deepagents.backends.utils import truncate_if_too_long
 
+def build_composite_state_backend(runtime: ToolRuntime, *, routes):
+    built_routes = {}
+    for prefix, backend_or_factory in routes.items():
+        if callable(backend_or_factory):
+            built_routes[prefix] = backend_or_factory(runtime)
+        else:
+            built_routes[prefix] = backend_or_factory
+    default_state = StateBackend(runtime)
+    return CompositeBackend(default=default_state, routes=built_routes)
+
 class TestAddMiddleware:
     def test_filesystem_middleware(self):
         middleware = [FilesystemMiddleware()]

{deepagents-0.1.5rc1 → deepagents-0.2.0}/src/deepagents.egg-info/requires.txt

@@ -1,6 +1,7 @@
 langchain-anthropic<2.0.0,>=1.0.0
 langchain<2.0.0,>=1.0.0
 langchain-core<2.0.0,>=1.0.0
+wcmatch
 
 [dev]
 pytest
@@ -8,4 +9,3 @@ pytest-cov
 build
 twine
 langchain-openai
-wcmatch