deepagents 0.1.5rc2__tar.gz → 0.2.1rc1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.1.5rc2
+Version: 0.2.1rc1
 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
@@ -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.5rc2 → deepagents-0.2.1rc1}/README.md

@@ -8,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.**
 
@@ -87,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**
 
@@ -294,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.
 
@@ -393,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
@@ -405,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.1rc1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepagents"
-version = "0.1.5rc2"
+version = "0.2.1rc1"
 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" }

{deepagents-0.1.5rc2 → deepagents-0.2.1rc1}/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.1rc1}/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.1rc1}/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.1rc1}/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.1rc1}/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
 

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

@@ -12,7 +12,7 @@ from pathlib import Path
 from typing import Any, Literal, TypedDict, List, Dict
 
 EMPTY_CONTENT_WARNING = "System reminder: File exists but has empty contents"
-MAX_LINE_LENGTH = 2000
+MAX_LINE_LENGTH = 10000
 LINE_NUMBER_WIDTH = 6
 TOOL_RESULT_TOKEN_LIMIT = 20000  # Same threshold as eviction
 TRUNCATION_GUIDANCE = "... [results truncated, try being more specific with your parameters]"
@@ -42,13 +42,15 @@ def format_content_with_line_numbers(
     start_line: int = 1,
 ) -> str:
     """Format file content with line numbers (cat -n style).
-    
+
+    Chunks lines longer than MAX_LINE_LENGTH with continuation markers (e.g., 5.1, 5.2).
+
     Args:
         content: File content as string or list of lines
         start_line: Starting line number (default: 1)
-    
+
     Returns:
-        Formatted content with line numbers
+        Formatted content with line numbers and continuation markers
     """
     if isinstance(content, str):
         lines = content.split("\n")
@@ -56,11 +58,29 @@ def format_content_with_line_numbers(
             lines = lines[:-1]
     else:
         lines = content
-    
-    return "\n".join(
-        f"{i + start_line:{LINE_NUMBER_WIDTH}d}\t{line[:MAX_LINE_LENGTH]}" 
-        for i, line in enumerate(lines)
-    )
+
+    result_lines = []
+    for i, line in enumerate(lines):
+        line_num = i + start_line
+
+        if len(line) <= MAX_LINE_LENGTH:
+            result_lines.append(f"{line_num:{LINE_NUMBER_WIDTH}d}\t{line}")
+        else:
+            # Split long line into chunks with continuation markers
+            num_chunks = (len(line) + MAX_LINE_LENGTH - 1) // MAX_LINE_LENGTH
+            for chunk_idx in range(num_chunks):
+                start = chunk_idx * MAX_LINE_LENGTH
+                end = min(start + MAX_LINE_LENGTH, len(line))
+                chunk = line[start:end]
+                if chunk_idx == 0:
+                    # First chunk: use normal line number
+                    result_lines.append(f"{line_num:{LINE_NUMBER_WIDTH}d}\t{chunk}")
+                else:
+                    # Continuation chunks: use decimal notation (e.g., 5.1, 5.2)
+                    continuation_marker = f"{line_num}.{chunk_idx}"
+                    result_lines.append(f"{continuation_marker:>{LINE_NUMBER_WIDTH}}\t{chunk}")
+
+    return "\n".join(result_lines)
 
 
 def check_empty_content(content: str) -> str | None:
@@ -91,18 +111,17 @@ def file_data_to_string(file_data: dict[str, Any]) -> str:
 
 def create_file_data(content: str, created_at: str | None = None) -> dict[str, Any]:
     """Create a FileData object with timestamps.
-    
+
     Args:
         content: File content as string
         created_at: Optional creation timestamp (ISO format)
-    
+
     Returns:
         FileData dict with content and timestamps
     """
     lines = content.split("\n") if isinstance(content, str) else content
-    lines = [line[i:i+MAX_LINE_LENGTH] for line in lines for i in range(0, len(line) or 1, MAX_LINE_LENGTH)]
     now = datetime.now(UTC).isoformat()
-    
+
     return {
         "content": lines,
         "created_at": created_at or now,
@@ -112,18 +131,17 @@ def create_file_data(content: str, created_at: str | None = None) -> dict[str, A
 
 def update_file_data(file_data: dict[str, Any], content: str) -> dict[str, Any]:
     """Update FileData with new content, preserving creation timestamp.
-    
+
     Args:
         file_data: Existing FileData dict
         content: New content as string
-    
+
     Returns:
         Updated FileData dict
     """
     lines = content.split("\n") if isinstance(content, str) else content
-    lines = [line[i:i+MAX_LINE_LENGTH] for line in lines for i in range(0, len(line) or 1, MAX_LINE_LENGTH)]
     now = datetime.now(UTC).isoformat()
-    
+
     return {
         "content": lines,
         "created_at": file_data["created_at"],

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

@@ -273,7 +273,6 @@ def _get_subagents(
             system_prompt=agent_["system_prompt"],
             tools=_tools,
             middleware=_middleware,
-            checkpointer=False,
         )
     return agents, subagent_descriptions
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.1.5rc2
+Version: 0.2.1rc1
 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
@@ -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.5rc2 → deepagents-0.2.1rc1}/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()]
@@ -160,8 +168,55 @@ class TestFilesystemMiddleware:
                 "runtime": ToolRuntime(state=state, context=None, tool_call_id="", store=None, stream_writer=lambda _: None, config={}),
             }
         )
+        # ls should only return files directly in /pokemon/, not in subdirectories
         assert "/pokemon/test2.txt" in result
         assert "/pokemon/charmander.txt" in result
+        assert "/pokemon/water/squirtle.txt" not in result  # In subdirectory, should NOT be listed
+        # ls should also list subdirectories with trailing /
+        assert "/pokemon/water/" in result
+
+    def test_ls_shortterm_lists_directories(self):
+        """Test that ls lists directories with trailing / for traversal."""
+        state = FilesystemState(
+            messages=[],
+            files={
+                "/test.txt": FileData(
+                    content=["Hello world"],
+                    modified_at="2021-01-01",
+                    created_at="2021-01-01",
+                ),
+                "/pokemon/charmander.txt": FileData(
+                    content=["Ember"],
+                    modified_at="2021-01-01",
+                    created_at="2021-01-01",
+                ),
+                "/pokemon/water/squirtle.txt": FileData(
+                    content=["Water"],
+                    modified_at="2021-01-01",
+                    created_at="2021-01-01",
+                ),
+                "/docs/readme.md": FileData(
+                    content=["Documentation"],
+                    modified_at="2021-01-01",
+                    created_at="2021-01-01",
+                ),
+            },
+        )
+        middleware = FilesystemMiddleware()
+        ls_tool = next(tool for tool in middleware.tools if tool.name == "ls")
+        result = ls_tool.invoke(
+            {
+                "path": "/",
+                "runtime": ToolRuntime(state=state, context=None, tool_call_id="", store=None, stream_writer=lambda _: None, config={}),
+            }
+        )
+        # ls should list both files and directories at root level
+        assert "/test.txt" in result
+        assert "/pokemon/" in result
+        assert "/docs/" in result
+        # But NOT subdirectory files
+        assert "/pokemon/charmander.txt" not in result
+        assert "/pokemon/water/squirtle.txt" not in result
 
     def test_glob_search_shortterm_simple_pattern(self):
         state = FilesystemState(
@@ -641,22 +696,21 @@ class TestFilesystemMiddleware:
         keys = {item.key for item in result}
         assert keys == {f"/file{i}.txt" for i in range(55)}
 
-    def test_create_file_data_splits_long_lines(self):
+    def test_create_file_data_preserves_long_lines(self):
+        """Test that create_file_data stores long lines as-is without splitting."""
         long_line = "a" * 3500
         short_line = "short line"
         content = f"{short_line}\n{long_line}"
 
         file_data = create_file_data(content)
 
-        for line in file_data["content"]:
-            assert len(line) <= 2000
-
-        assert len(file_data["content"]) == 3
+        assert len(file_data["content"]) == 2
         assert file_data["content"][0] == short_line
-        assert file_data["content"][1] == "a" * 2000
-        assert file_data["content"][2] == "a" * 1500
+        assert file_data["content"][1] == long_line
+        assert len(file_data["content"][1]) == 3500
 
-    def test_update_file_data_splits_long_lines(self):
+    def test_update_file_data_preserves_long_lines(self):
+        """Test that update_file_data stores long lines as-is without splitting."""
         initial_file_data = create_file_data("initial content")
 
         long_line = "b" * 5000
@@ -665,17 +719,111 @@ class TestFilesystemMiddleware:
 
         updated_file_data = update_file_data(initial_file_data, new_content)
 
-        for line in updated_file_data["content"]:
-            assert len(line) <= 2000
-
-        assert len(updated_file_data["content"]) == 4
+        assert len(updated_file_data["content"]) == 2
         assert updated_file_data["content"][0] == short_line
-        assert updated_file_data["content"][1] == "b" * 2000
-        assert updated_file_data["content"][2] == "b" * 2000
-        assert updated_file_data["content"][3] == "b" * 1000
+        assert updated_file_data["content"][1] == long_line
+        assert len(updated_file_data["content"][1]) == 5000
 
         assert updated_file_data["created_at"] == initial_file_data["created_at"]
 
+    def test_format_content_with_line_numbers_short_lines(self):
+        """Test that short lines (<=10000 chars) are displayed normally."""
+        from deepagents.backends.utils import format_content_with_line_numbers
+
+        content = ["short line 1", "short line 2", "short line 3"]
+        result = format_content_with_line_numbers(content, start_line=1)
+
+        lines = result.split("\n")
+        assert len(lines) == 3
+        assert "     1\tshort line 1" in lines[0]
+        assert "     2\tshort line 2" in lines[1]
+        assert "     3\tshort line 3" in lines[2]
+
+    def test_format_content_with_line_numbers_long_line_with_continuation(self):
+        """Test that long lines (>10000 chars) are split with continuation markers."""
+        from deepagents.backends.utils import format_content_with_line_numbers
+
+        long_line = "a" * 25000
+        content = ["short line", long_line, "another short line"]
+        result = format_content_with_line_numbers(content, start_line=1)
+
+        lines = result.split("\n")
+        assert len(lines) == 5
+        assert "     1\tshort line" in lines[0]
+        assert "     2\t" in lines[1]
+        assert lines[1].count("a") == 10000
+        assert "   2.1\t" in lines[2]
+        assert lines[2].count("a") == 10000
+        assert "   2.2\t" in lines[3]
+        assert lines[3].count("a") == 5000
+        assert "     3\tanother short line" in lines[4]
+
+    def test_format_content_with_line_numbers_multiple_long_lines(self):
+        """Test multiple long lines in sequence with proper line numbering."""
+        from deepagents.backends.utils import format_content_with_line_numbers
+
+        long_line_1 = "x" * 15000
+        long_line_2 = "y" * 15000
+        content = [long_line_1, "middle", long_line_2]
+        result = format_content_with_line_numbers(content, start_line=5)
+        lines = result.split("\n")
+        assert len(lines) == 5
+        assert "     5\t" in lines[0]
+        assert lines[0].count("x") == 10000
+        assert "   5.1\t" in lines[1]
+        assert lines[1].count("x") == 5000
+        assert "     6\tmiddle" in lines[2]
+        assert "     7\t" in lines[3]
+        assert lines[3].count("y") == 10000
+        assert "   7.1\t" in lines[4]
+        assert lines[4].count("y") == 5000
+
+    def test_format_content_with_line_numbers_exact_limit(self):
+        """Test that a line exactly at the 10000 char limit is not split."""
+        from deepagents.backends.utils import format_content_with_line_numbers
+
+        exact_line = "b" * 10000
+        content = [exact_line]
+        result = format_content_with_line_numbers(content, start_line=1)
+
+        lines = result.split("\n")
+        assert len(lines) == 1
+        assert "     1\t" in lines[0]
+        assert lines[0].count("b") == 10000
+
+    def test_read_file_with_long_lines_shows_continuation_markers(self):
+        """Test that read_file displays long lines with continuation markers."""
+        from deepagents.backends.utils import format_read_response, create_file_data
+
+        long_line = "z" * 15000
+        content = f"first line\n{long_line}\nthird line"
+        file_data = create_file_data(content)
+        result = format_read_response(file_data, offset=0, limit=100)
+        lines = result.split("\n")
+        assert len(lines) == 4
+        assert "     1\tfirst line" in lines[0]
+        assert "     2\t" in lines[1]
+        assert lines[1].count("z") == 10000
+        assert "   2.1\t" in lines[2]
+        assert lines[2].count("z") == 5000
+        assert "     3\tthird line" in lines[3]
+
+    def test_read_file_with_offset_and_long_lines(self):
+        """Test that read_file with offset handles long lines correctly."""
+        from deepagents.backends.utils import format_read_response, create_file_data
+
+        long_line = "m" * 12000
+        content = f"line1\nline2\n{long_line}\nline4"
+        file_data = create_file_data(content)
+        result = format_read_response(file_data, offset=2, limit=10)
+        lines = result.split("\n")
+        assert len(lines) == 3
+        assert "     3\t" in lines[0]
+        assert lines[0].count("m") == 10000
+        assert "   3.1\t" in lines[1]
+        assert lines[1].count("m") == 2000
+        assert "     4\tline4" in lines[2]
+
 
 @pytest.mark.requires("langchain_openai")
 class TestSubagentMiddleware: