deepagents 0.1.5rc2__py3-none-any.whl → 0.2.1__py3-none-any.whl

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/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/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/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/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/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]"
@@ -37,18 +37,29 @@ class GrepMatch(TypedDict):
     text: str
 
 
+def sanitize_tool_call_id(tool_call_id: str) -> str:
+    """Sanitize tool_call_id to prevent path traversal and separator issues. 
+    
+    Replaces dangerous characters (., /, \) with underscores.
+    """
+    sanitized = tool_call_id.replace(".", "_").replace("/", "_").replace("\\", "_")
+    return sanitized
+
+
 def format_content_with_line_numbers(
     content: str | list[str],
     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 +67,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 +120,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 +140,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/middleware/filesystem.py

@@ -24,11 +24,11 @@ from typing_extensions import TypedDict
 from deepagents.backends.protocol import BackendProtocol, BackendFactory, WriteResult, EditResult
 from deepagents.backends import StateBackend
 from deepagents.backends.utils import (
-    create_file_data,
     update_file_data,
     format_content_with_line_numbers,
     format_grep_matches,
     truncate_if_too_long,
+    sanitize_tool_call_id,
 )
 
 EMPTY_CONTENT_WARNING = "System reminder: File exists but has empty contents"
@@ -227,6 +227,15 @@ All file paths must start with a /.
 
 
 def _get_backend(backend: BACKEND_TYPES, runtime: ToolRuntime) -> BackendProtocol:
+    """Get the resolved backend instance from backend or factory.
+
+    Args:
+        backend: Backend instance or factory function.
+        runtime: The tool runtime context.
+
+    Returns:
+        Resolved backend instance.
+    """
     if callable(backend):
         return backend(runtime)
     return backend
@@ -532,6 +541,19 @@ class FilesystemMiddleware(AgentMiddleware):
 
         self.tools = _get_filesystem_tools(self.backend, custom_tool_descriptions)
 
+    def _get_backend(self, runtime: ToolRuntime) -> BackendProtocol:
+        """Get the resolved backend instance from backend or factory.
+
+        Args:
+            runtime: The tool runtime context.
+
+        Returns:
+            Resolved backend instance.
+        """
+        if callable(self.backend):
+            return self.backend(runtime)
+        return self.backend
+
     def wrap_model_call(
         self,
         request: ModelRequest,
@@ -568,54 +590,70 @@ class FilesystemMiddleware(AgentMiddleware):
             request.system_prompt = request.system_prompt + "\n\n" + self.system_prompt if request.system_prompt else self.system_prompt
         return await handler(request)
 
-    def _intercept_large_tool_result(self, tool_result: ToolMessage | Command) -> ToolMessage | Command:
+    def _process_large_message(
+        self,
+        message: ToolMessage,
+        resolved_backend: BackendProtocol,
+    ) -> tuple[ToolMessage, dict[str, FileData] | None]:
+        content = message.content
+        if not isinstance(content, str) or len(content) <= 4 * self.tool_token_limit_before_evict:
+            return message, None
+
+        sanitized_id = sanitize_tool_call_id(message.tool_call_id)
+        file_path = f"/large_tool_results/{sanitized_id}"
+        result = resolved_backend.write(file_path, content)
+        if result.error:
+            return message, None
+        content_sample = format_content_with_line_numbers(content.splitlines()[:10], start_line=1)
+        processed_message = ToolMessage(
+            TOO_LARGE_TOOL_MSG.format(
+                tool_call_id=message.tool_call_id,
+                file_path=file_path,
+                content_sample=content_sample,
+            ),
+            tool_call_id=message.tool_call_id,
+        )
+        return processed_message, result.files_update
+
+    def _intercept_large_tool_result(self, tool_result: ToolMessage | Command, runtime: ToolRuntime) -> ToolMessage | Command:
         if isinstance(tool_result, ToolMessage) and isinstance(tool_result.content, str):
-            content = tool_result.content
-            if self.tool_token_limit_before_evict and len(content) > 4 * self.tool_token_limit_before_evict:
-                file_path = f"/large_tool_results/{tool_result.tool_call_id}"
-                file_data = create_file_data(content)
-                state_update = {
-                    "messages": [
-                        ToolMessage(
-                            TOO_LARGE_TOOL_MSG.format(
-                                tool_call_id=tool_result.tool_call_id,
-                                file_path=file_path,
-                                content_sample=format_content_with_line_numbers(file_data["content"][:10], start_line=1),
-                            ),
-                            tool_call_id=tool_result.tool_call_id,
-                        )
-                    ],
-                    "files": {file_path: file_data},
-                }
-                return Command(update=state_update)
+            if not (self.tool_token_limit_before_evict and
+                    len(tool_result.content) > 4 * self.tool_token_limit_before_evict):
+                return tool_result
+            resolved_backend = self._get_backend(runtime)
+            processed_message, files_update = self._process_large_message(
+                tool_result,
+                resolved_backend,
+            )
+            return (Command(update={
+                "files": files_update,
+                "messages": [processed_message],
+            }) if files_update is not None else processed_message)
+
         elif isinstance(tool_result, Command):
             update = tool_result.update
             if update is None:
                 return tool_result
-            message_updates = update.get("messages", [])
-            file_updates = update.get("files", {})
-
-            edited_message_updates = []
-            for message in message_updates:
-                if self.tool_token_limit_before_evict and isinstance(message, ToolMessage) and isinstance(message.content, str):
-                    content = message.content
-                    if len(content) > 4 * self.tool_token_limit_before_evict:
-                        file_path = f"/large_tool_results/{message.tool_call_id}"
-                        file_data = create_file_data(content)
-                        edited_message_updates.append(
-                            ToolMessage(
-                                TOO_LARGE_TOOL_MSG.format(
-                                    tool_call_id=message.tool_call_id,
-                                    file_path=file_path,
-                                    content_sample=format_content_with_line_numbers(file_data["content"][:10], start_line=1),
-                                ),
-                                tool_call_id=message.tool_call_id,
-                            )
-                        )
-                        file_updates[file_path] = file_data
-                        continue
-                edited_message_updates.append(message)
-            return Command(update={**update, "messages": edited_message_updates, "files": file_updates})
+            command_messages = update.get("messages", [])
+            accumulated_file_updates = dict(update.get("files", {}))
+            resolved_backend = self._get_backend(runtime)
+            processed_messages = []
+            for message in command_messages:
+                if not (self.tool_token_limit_before_evict and
+                        isinstance(message, ToolMessage) and
+                        isinstance(message.content, str) and
+                        len(message.content) > 4 * self.tool_token_limit_before_evict):
+                    processed_messages.append(message)
+                    continue
+                processed_message, files_update = self._process_large_message(
+                    message,
+                    resolved_backend,
+                )
+                processed_messages.append(processed_message)
+                if files_update is not None:
+                    accumulated_file_updates.update(files_update)
+            return Command(update={**update, "messages": processed_messages, "files": accumulated_file_updates})
+
         return tool_result
 
     def wrap_tool_call(
@@ -636,7 +674,7 @@ class FilesystemMiddleware(AgentMiddleware):
             return handler(request)
 
         tool_result = handler(request)
-        return self._intercept_large_tool_result(tool_result)
+        return self._intercept_large_tool_result(tool_result, request.runtime)
 
     async def awrap_tool_call(
         self,
@@ -656,11 +694,4 @@ class FilesystemMiddleware(AgentMiddleware):
             return await handler(request)
 
         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)
+        return self._intercept_large_tool_result(tool_result, request.runtime)

deepagents/middleware/patch_tool_calls.py

@@ -3,9 +3,9 @@
 from typing import Any
 
 from langchain.agents.middleware import AgentMiddleware, AgentState
-from langchain_core.messages import RemoveMessage, ToolMessage
-from langgraph.graph.message import REMOVE_ALL_MESSAGES
+from langchain_core.messages import ToolMessage
 from langgraph.runtime import Runtime
+from langgraph.types import Overwrite
 
 
 class PatchToolCallsMiddleware(AgentMiddleware):
@@ -41,4 +41,4 @@ class PatchToolCallsMiddleware(AgentMiddleware):
                             )
                         )
 
-        return {"messages": [RemoveMessage(id=REMOVE_ALL_MESSAGES), *patched_messages]}
+        return {"messages": Overwrite(patched_messages)}

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.dist-info → deepagents-0.2.1.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.1.5rc2
+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.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
@@ -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.2.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+deepagents/__init__.py,sha256=9BVNn4lfF5N8l2KY8Ttxi82zO609I-fGqoSIF7DAxiU,342
+deepagents/graph.py,sha256=6hXBwvQDwbUtiF8Tgwf1jbvRHwJGLEJq89fy-DpVez0,6106
+deepagents/backends/__init__.py,sha256=qb2dt2axTQsh8BGqW2EDyJq8GazC8_z87MQYo_VXhBw,457
+deepagents/backends/composite.py,sha256=kyW0H346s1XIxNkRHRbDF9SSR-zeigeEFO8bizn5iFg,8555
+deepagents/backends/filesystem.py,sha256=U9Tmf8BDTqKbw-gQjJkJOYG1nXQo9FhxyfzN97W9Z_8,18470
+deepagents/backends/protocol.py,sha256=fwqJa_Ec6F4BoNYz0bcPHL_fiKksxw2RoyA6x5wr7dc,4181
+deepagents/backends/state.py,sha256=BxMNm1kDpxtgzIzpuF78h1NuYh9VIpXqnUbbETGe4Y4,6584
+deepagents/backends/store.py,sha256=VsPSj6ayABPjkKiN6CcvOGm7YCWKuWP_ltJWvFJ1nF0,13358
+deepagents/backends/utils.py,sha256=vQDMFMjf7pmfKqprpTlF7851FWmswZnMdLj-cezTsBk,14432
+deepagents/middleware/__init__.py,sha256=J7372TNGR27OU4C3uuQMryHHpXOBjFV_4aEZ_AoQ6n0,284
+deepagents/middleware/filesystem.py,sha256=jxtwma6xWE-EQeASs6rtnoiiLqb_HT4c-cxsLFquneE,27882
+deepagents/middleware/patch_tool_calls.py,sha256=PdNhxPaQqwnFkhEAZEE2kEzadTNAOO3_iJRA30WqpGE,1981
+deepagents/middleware/subagents.py,sha256=JxXwZvi41pBKKMguKlyVqwjCoydnZboWEgJGkWOCIY8,23503
+deepagents-0.2.1.dist-info/licenses/LICENSE,sha256=c__BaxUCK69leo2yEKynf8lWndu8iwYwge1CbyqAe-E,1071
+deepagents-0.2.1.dist-info/METADATA,sha256=kXdfjz1KdcYpKWWll_QpeRnFcYpZGnjNSuChET2dp48,18660
+deepagents-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+deepagents-0.2.1.dist-info/top_level.txt,sha256=drAzchOzPNePwpb3_pbPuvLuayXkN7SNqeIKMBWJoAo,11
+deepagents-0.2.1.dist-info/RECORD,,

deepagents-0.1.5rc2.dist-info/RECORD

@@ -1,18 +0,0 @@
-deepagents/__init__.py,sha256=9BVNn4lfF5N8l2KY8Ttxi82zO609I-fGqoSIF7DAxiU,342
-deepagents/graph.py,sha256=6hXBwvQDwbUtiF8Tgwf1jbvRHwJGLEJq89fy-DpVez0,6106
-deepagents/backends/__init__.py,sha256=F2wSsZZcFeLDVb_thia6I7SviPuFmxhFHDn_VzfJ__U,525
-deepagents/backends/composite.py,sha256=ZJBSXcfx07dk97buA013L7u0TK2EAj8aOITpLsvw8OQ,8985
-deepagents/backends/filesystem.py,sha256=oq3oI9W5kfmEXItOqKIGHx_PTKxjQTDh8IqVuV5ZFzw,17067
-deepagents/backends/protocol.py,sha256=fwqJa_Ec6F4BoNYz0bcPHL_fiKksxw2RoyA6x5wr7dc,4181
-deepagents/backends/state.py,sha256=Mm2U5IcTDxvJMhG3K1HGODCW70Qseb2arjPe5JewnO0,5439
-deepagents/backends/store.py,sha256=NuxQK5znhbR5uz1PH6BfiWu9mGHWSk6TcKgb5ZuoJaM,12209
-deepagents/backends/utils.py,sha256=0VK5_NJbolZs4iPzB53I6kyFpDdjgxLYGl4ob8pKYyw,13347
-deepagents/middleware/__init__.py,sha256=J7372TNGR27OU4C3uuQMryHHpXOBjFV_4aEZ_AoQ6n0,284
-deepagents/middleware/filesystem.py,sha256=-h75Rvy6uJtDL8a-zTilNe8bMKLSxaUHsgtP1j7liqE,27120
-deepagents/middleware/patch_tool_calls.py,sha256=Cu8rUpt1GjrYgfMvZG6wOowvnmFeYTCauOJhlltNPmo,2045
-deepagents/middleware/subagents.py,sha256=hYW0cJV36fryu67S3H70VnM3SessiOz_vm3gSScC4a4,23535
-deepagents-0.1.5rc2.dist-info/licenses/LICENSE,sha256=c__BaxUCK69leo2yEKynf8lWndu8iwYwge1CbyqAe-E,1071
-deepagents-0.1.5rc2.dist-info/METADATA,sha256=ajSklItkJktz56K8zozEo3dZEJLakRMSETSugbFvXm8,19808
-deepagents-0.1.5rc2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-deepagents-0.1.5rc2.dist-info/top_level.txt,sha256=drAzchOzPNePwpb3_pbPuvLuayXkN7SNqeIKMBWJoAo,11
-deepagents-0.1.5rc2.dist-info/RECORD,,