deepagents 0.1.5rc2__tar.gz → 0.2.1__tar.gz

deepagents-0.1.5rc2/README.md → deepagents-0.2.1/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: deepagents
+Version: 0.2.1
+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.2
+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.5rc2/PKG-INFO → deepagents-0.2.1/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: deepagents
-Version: 0.1.5rc2
-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. 
@@ -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.5rc2 → deepagents-0.2.1}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "deepagents"
-version = "0.1.5rc2"
+version = "0.2.1"
 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" }
 requires-python = ">=3.11,<4.0"
 dependencies = [
     "langchain-anthropic>=1.0.0,<2.0.0",
-    "langchain>=1.0.0,<2.0.0",
+    "langchain>=1.0.2,<2.0.0",
     "langchain-core>=1.0.0,<2.0.0",
     "wcmatch"
 ]

{deepagents-0.1.5rc2 → deepagents-0.2.1}/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.5rc2 → deepagents-0.2.1}/src/deepagents/backends/composite.py

@@ -1,13 +1,10 @@
 """CompositeBackend: Route operations to different backends based on path prefix."""
 
-from typing import Any, Literal, Optional, TYPE_CHECKING
+from typing import Optional
 
-from langchain.tools import ToolRuntime
-
-from deepagents.backends.protocol import BackendProtocol, BackendFactory, WriteResult, EditResult
+from deepagents.backends.protocol import BackendProtocol, WriteResult, EditResult
 from deepagents.backends.state import StateBackend
 from deepagents.backends.utils import FileInfo, GrepMatch
-from deepagents.backends.protocol import BackendFactory
 
 
 class CompositeBackend:
@@ -48,13 +45,14 @@ class CompositeBackend:
         return self.default, key
     
     def ls_info(self, path: str) -> list[FileInfo]:
-        """List files from backends, with appropriate prefixes.
-        
+        """List files and directories in the specified directory (non-recursive).
+
         Args:
             path: Absolute path to directory.
-        
+
         Returns:
-            List of FileInfo-like dicts with route prefixes added.
+            List of FileInfo-like dicts with route prefixes added, for files and directories directly in the directory.
+            Directories have a trailing / in their path and is_dir=True.
         """
         # Check if path matches a specific route
         for route_prefix, backend in self.sorted_routes:
@@ -75,11 +73,14 @@ class CompositeBackend:
             results: list[FileInfo] = []
             results.extend(self.default.ls_info(path))
             for route_prefix, backend in self.sorted_routes:
-                infos = backend.ls_info("/")
-                for fi in infos:
-                    fi = dict(fi)
-                    fi["path"] = f"{route_prefix[:-1]}{fi['path']}"
-                    results.append(fi)
+                # Add the route itself as a directory (e.g., /memories/)
+                results.append({
+                    "path": route_prefix,
+                    "is_dir": True,
+                    "size": 0,
+                    "modified_at": "",
+                })
+
             results.sort(key=lambda x: x.get("path", ""))
             return results
 
@@ -220,16 +221,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.5rc2 → deepagents-0.2.1}/src/deepagents/backends/filesystem.py

@@ -13,16 +13,12 @@ import json
 import subprocess
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Optional, TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from langchain.tools import ToolRuntime
+from typing import Optional
 
 from .utils import (
     check_empty_content,
     format_content_with_line_numbers,
     perform_string_replacement,
-    truncate_if_too_long,
 )
 import wcmatch.glob as wcglob
 from deepagents.backends.utils import FileInfo, GrepMatch
@@ -51,7 +47,7 @@ class FilesystemBackend:
                      all file paths will be resolved relative to this directory.
                      If not provided, uses the current working directory.
         """
-        self.cwd = Path(root_dir) if root_dir else Path.cwd()
+        self.cwd = Path(root_dir).resolve() if root_dir else Path.cwd()
         self.virtual_mode = virtual_mode
         self.max_file_size_bytes = max_file_size_mb * 1024 * 1024
 
@@ -77,7 +73,7 @@ class FilesystemBackend:
             try:
                 full.relative_to(self.cwd)
             except ValueError:
-                raise ValueError(f"Path outside root directory: {key}") from None
+                raise ValueError(f"Path:{full} outside root directory: {self.cwd}") from None
             return full
 
         path = Path(key)
@@ -86,13 +82,14 @@ class FilesystemBackend:
         return (self.cwd / path).resolve()
 
     def ls_info(self, path: str) -> list[FileInfo]:
-        """List files from filesystem.
+        """List files and directories in the specified directory (non-recursive).
 
         Args:
             path: Absolute directory path to list files from.
-        
+
         Returns:
-            List of FileInfo-like dicts.
+            List of FileInfo-like dicts for files and directories directly in the directory.
+            Directories have a trailing / in their path and is_dir=True.
         """
         dir_path = self._resolve_path(path)
         if not dir_path.exists() or not dir_path.is_dir():
@@ -105,18 +102,22 @@ class FilesystemBackend:
         if not cwd_str.endswith("/"):
             cwd_str += "/"
 
-        # Walk the directory tree
+        # List only direct children (non-recursive)
         try:
-            for path in dir_path.rglob("*"):
+            for child_path in dir_path.iterdir():
                 try:
-                    is_file = path.is_file()
+                    is_file = child_path.is_file()
+                    is_dir = child_path.is_dir()
                 except OSError:
                     continue
-                if is_file:
-                    abs_path = str(path)
-                    if not self.virtual_mode:
+
+                abs_path = str(child_path)
+
+                if not self.virtual_mode:
+                    # Non-virtual mode: use absolute paths
+                    if is_file:
                         try:
-                            st = path.stat()
+                            st = child_path.stat()
                             results.append({
                                 "path": abs_path,
                                 "is_dir": False,
@@ -125,8 +126,19 @@ class FilesystemBackend:
                             })
                         except OSError:
                             results.append({"path": abs_path, "is_dir": False})
-                        continue
-                    # Strip the cwd prefix if present
+                    elif is_dir:
+                        try:
+                            st = child_path.stat()
+                            results.append({
+                                "path": abs_path + "/",
+                                "is_dir": True,
+                                "size": 0,
+                                "modified_at": datetime.fromtimestamp(st.st_mtime).isoformat(),
+                            })
+                        except OSError:
+                            results.append({"path": abs_path + "/", "is_dir": True})
+                else:
+                    # Virtual mode: strip cwd prefix
                     if abs_path.startswith(cwd_str):
                         relative_path = abs_path[len(cwd_str):]
                     elif abs_path.startswith(str(self.cwd)):
@@ -137,16 +149,29 @@ class FilesystemBackend:
                         relative_path = abs_path
 
                     virt_path = "/" + relative_path
-                    try:
-                        st = path.stat()
-                        results.append({
-                            "path": virt_path,
-                            "is_dir": False,
-                            "size": int(st.st_size),
-                            "modified_at": datetime.fromtimestamp(st.st_mtime).isoformat(),
-                        })
-                    except OSError:
-                        results.append({"path": virt_path, "is_dir": False})
+
+                    if is_file:
+                        try:
+                            st = child_path.stat()
+                            results.append({
+                                "path": virt_path,
+                                "is_dir": False,
+                                "size": int(st.st_size),
+                                "modified_at": datetime.fromtimestamp(st.st_mtime).isoformat(),
+                            })
+                        except OSError:
+                            results.append({"path": virt_path, "is_dir": False})
+                    elif is_dir:
+                        try:
+                            st = child_path.stat()
+                            results.append({
+                                "path": virt_path + "/",
+                                "is_dir": True,
+                                "size": 0,
+                                "modified_at": datetime.fromtimestamp(st.st_mtime).isoformat(),
+                            })
+                        except OSError:
+                            results.append({"path": virt_path + "/", "is_dir": True})
         except (OSError, PermissionError):
             pass
 

{deepagents-0.1.5rc2 → deepagents-0.2.1}/src/deepagents/backends/state.py

@@ -40,19 +40,38 @@ class StateBackend:
         self.runtime = runtime
     
     def ls_info(self, path: str) -> list[FileInfo]:
-        """List files from state.
-        
+        """List files and directories in the specified directory (non-recursive).
+
         Args:
             path: Absolute path to directory.
-        
+
         Returns:
-            List of FileInfo-like dicts.
+            List of FileInfo-like dicts for files and directories directly in the directory.
+            Directories have a trailing / in their path and is_dir=True.
         """
         files = self.runtime.state.get("files", {})
         infos: list[FileInfo] = []
+        subdirs: set[str] = set()
+
+        # Normalize path to have trailing slash for proper prefix matching
+        normalized_path = path if path.endswith("/") else path + "/"
+
         for k, fd in files.items():
-            if not k.startswith(path):
+            # Check if file is in the specified directory or a subdirectory
+            if not k.startswith(normalized_path):
+                continue
+
+            # Get the relative path after the directory
+            relative = k[len(normalized_path):]
+
+            # If relative path contains '/', it's in a subdirectory
+            if "/" in relative:
+                # Extract the immediate subdirectory name
+                subdir_name = relative.split("/")[0]
+                subdirs.add(normalized_path + subdir_name + "/")
                 continue
+
+            # This is a file directly in the current directory
             size = len("\n".join(fd.get("content", [])))
             infos.append({
                 "path": k,
@@ -60,6 +79,16 @@ class StateBackend:
                 "size": int(size),
                 "modified_at": fd.get("modified_at", ""),
             })
+
+        # Add directories to the results
+        for subdir in sorted(subdirs):
+            infos.append({
+                "path": subdir,
+                "is_dir": True,
+                "size": 0,
+                "modified_at": "",
+            })
+
         infos.sort(key=lambda x: x.get("path", ""))
         return infos
 

{deepagents-0.1.5rc2 → deepagents-0.2.1}/src/deepagents/backends/store.py

@@ -179,24 +179,43 @@ class StoreBackend:
         return all_items
     
     def ls_info(self, path: str) -> list[FileInfo]:
-        """List files from store.
-        
+        """List files and directories in the specified directory (non-recursive).
+
         Args:
             path: Absolute path to directory.
-        
+
         Returns:
-            List of FileInfo-like dicts.
+            List of FileInfo-like dicts for files and directories directly in the directory.
+            Directories have a trailing / in their path and is_dir=True.
         """
         store = self._get_store()
         namespace = self._get_namespace()
-        
+
         # Retrieve all items and filter by path prefix locally to avoid
         # coupling to store-specific filter semantics
         items = self._search_store_paginated(store, namespace)
         infos: list[FileInfo] = []
+        subdirs: set[str] = set()
+
+        # Normalize path to have trailing slash for proper prefix matching
+        normalized_path = path if path.endswith("/") else path + "/"
+
         for item in items:
-            if not str(item.key).startswith(path):
+            # Check if file is in the specified directory or a subdirectory
+            if not str(item.key).startswith(normalized_path):
                 continue
+
+            # Get the relative path after the directory
+            relative = str(item.key)[len(normalized_path):]
+
+            # If relative path contains '/', it's in a subdirectory
+            if "/" in relative:
+                # Extract the immediate subdirectory name
+                subdir_name = relative.split("/")[0]
+                subdirs.add(normalized_path + subdir_name + "/")
+                continue
+
+            # This is a file directly in the current directory
             try:
                 fd = self._convert_store_item_to_file_data(item)
             except ValueError:
@@ -208,6 +227,16 @@ class StoreBackend:
                 "size": int(size),
                 "modified_at": fd.get("modified_at", ""),
             })
+
+        # Add directories to the results
+        for subdir in sorted(subdirs):
+            infos.append({
+                "path": subdir,
+                "is_dir": True,
+                "size": 0,
+                "modified_at": "",
+            })
+
         infos.sort(key=lambda x: x.get("path", ""))
         return infos