deepagents 0.2.2__tar.gz → 0.2.3__tar.gz

{deepagents-0.2.2/src/deepagents.egg-info → deepagents-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.2.2
+Version: 0.2.3
 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

{deepagents-0.2.2 → deepagents-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepagents"
-version = "0.2.2"
+version = "0.2.3"
 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" }
@@ -42,7 +42,7 @@ include = ["deepagents*"]
 "" = "src"
 
 [tool.setuptools.package-data]
-"*" = ["py.typed"]
+"*" = ["py.typed", "*.md"]
 
 [tool.ruff]
 line-length = 150

{deepagents-0.2.2 → deepagents-0.2.3}/src/deepagents/backends/utils.py

@@ -6,10 +6,11 @@ enable composition without fragile string parsing.
 """
 
 import re
-import wcmatch.glob as wcglob
 from datetime import UTC, datetime
 from pathlib import Path
-from typing import Any, Literal, TypedDict, List, Dict
+from typing import Any, Literal, TypedDict
+
+import wcmatch.glob as wcglob
 
 EMPTY_CONTENT_WARNING = "System reminder: File exists but has empty contents"
 MAX_LINE_LENGTH = 10000
@@ -24,6 +25,7 @@ class FileInfo(TypedDict, total=False):
     Minimal contract used across backends. Only "path" is required.
     Other fields are best-effort and may be absent depending on backend.
     """
+
     path: str
     is_dir: bool
     size: int  # bytes (approx)
@@ -32,14 +34,15 @@ class FileInfo(TypedDict, total=False):
 
 class GrepMatch(TypedDict):
     """Structured grep match entry."""
+
     path: str
     line: int
     text: str
 
 
 def sanitize_tool_call_id(tool_call_id: str) -> str:
-    """Sanitize tool_call_id to prevent path traversal and separator issues. 
-    
+    r"""Sanitize tool_call_id to prevent path traversal and separator issues.
+
     Replaces dangerous characters (., /, \) with underscores.
     """
     sanitized = tool_call_id.replace(".", "_").replace("/", "_").replace("\\", "_")
@@ -94,10 +97,10 @@ def format_content_with_line_numbers(
 
 def check_empty_content(content: str) -> str | None:
     """Check if content is empty and return warning message.
-    
+
     Args:
         content: Content to check
-    
+
     Returns:
         Warning message if empty, None otherwise
     """
@@ -108,10 +111,10 @@ def check_empty_content(content: str) -> str | None:
 
 def file_data_to_string(file_data: dict[str, Any]) -> str:
     """Convert FileData to plain string content.
-    
+
     Args:
         file_data: FileData dict with 'content' key
-    
+
     Returns:
         Content as string with lines joined by newlines
     """
@@ -164,12 +167,12 @@ def format_read_response(
     limit: int,
 ) -> str:
     """Format file data for read response with line numbers.
-    
+
     Args:
         file_data: FileData dict
         offset: Line offset (0-indexed)
         limit: Maximum number of lines
-    
+
     Returns:
         Formatted content or error message
     """
@@ -177,14 +180,14 @@ def format_read_response(
     empty_msg = check_empty_content(content)
     if empty_msg:
         return empty_msg
-    
+
     lines = content.splitlines()
     start_idx = offset
     end_idx = min(start_idx + limit, len(lines))
-    
+
     if start_idx >= len(lines):
         return f"Error: Line offset {offset} exceeds file length ({len(lines)} lines)"
-    
+
     selected_lines = lines[start_idx:end_idx]
     return format_content_with_line_numbers(selected_lines, start_line=start_idx + 1)
 
@@ -196,24 +199,24 @@ def perform_string_replacement(
     replace_all: bool,
 ) -> tuple[str, int] | str:
     """Perform string replacement with occurrence validation.
-    
+
     Args:
         content: Original content
         old_string: String to replace
         new_string: Replacement string
         replace_all: Whether to replace all occurrences
-    
+
     Returns:
         Tuple of (new_content, occurrences) on success, or error message string
     """
     occurrences = content.count(old_string)
-    
+
     if occurrences == 0:
         return f"Error: String not found in file: '{old_string}'"
-    
+
     if occurrences > 1 and not replace_all:
         return f"Error: String '{old_string}' appears {occurrences} times in file. Use replace_all=True to replace all instances, or provide a more specific string with surrounding context."
-    
+
     new_content = content.replace(old_string, new_string)
     return new_content, occurrences
 
@@ -225,33 +228,33 @@ def truncate_if_too_long(result: list[str] | str) -> list[str] | str:
         if total_chars > TOOL_RESULT_TOKEN_LIMIT * 4:
             return result[: len(result) * TOOL_RESULT_TOKEN_LIMIT * 4 // total_chars] + [TRUNCATION_GUIDANCE]
         return result
-    else:  # string
-        if len(result) > TOOL_RESULT_TOKEN_LIMIT * 4:
-            return result[: TOOL_RESULT_TOKEN_LIMIT * 4] + "\n" + TRUNCATION_GUIDANCE
-        return result
+    # string
+    if len(result) > TOOL_RESULT_TOKEN_LIMIT * 4:
+        return result[: TOOL_RESULT_TOKEN_LIMIT * 4] + "\n" + TRUNCATION_GUIDANCE
+    return result
 
 
 def _validate_path(path: str | None) -> str:
     """Validate and normalize a path.
-    
+
     Args:
         path: Path to validate
-    
+
     Returns:
         Normalized path starting with /
-    
+
     Raises:
         ValueError: If path is invalid
     """
     path = path or "/"
     if not path or path.strip() == "":
         raise ValueError("Path cannot be empty")
-    
+
     normalized = path if path.startswith("/") else "/" + path
-    
+
     if not normalized.endswith("/"):
         normalized += "/"
-    
+
     return normalized
 
 
@@ -261,16 +264,16 @@ def _glob_search_files(
     path: str = "/",
 ) -> str:
     """Search files dict for paths matching glob pattern.
-    
+
     Args:
         files: Dictionary of file paths to FileData.
         pattern: Glob pattern (e.g., "*.py", "**/*.ts").
         path: Base path to search from.
-    
+
     Returns:
         Newline-separated file paths, sorted by modification time (most recent first).
         Returns "No files found" if no matches.
-    
+
     Example:
         ```python
         files = {"/src/main.py": FileData(...), "/test.py": FileData(...)}
@@ -313,29 +316,28 @@ def _format_grep_results(
     output_mode: Literal["files_with_matches", "content", "count"],
 ) -> str:
     """Format grep search results based on output mode.
-    
+
     Args:
         results: Dictionary mapping file paths to list of (line_num, line_content) tuples
         output_mode: Output format - "files_with_matches", "content", or "count"
-    
+
     Returns:
         Formatted string output
     """
     if output_mode == "files_with_matches":
         return "\n".join(sorted(results.keys()))
-    elif output_mode == "count":
+    if output_mode == "count":
         lines = []
         for file_path in sorted(results.keys()):
             count = len(results[file_path])
             lines.append(f"{file_path}: {count}")
         return "\n".join(lines)
-    else:
-        lines = []
-        for file_path in sorted(results.keys()):
-            lines.append(f"{file_path}:")
-            for line_num, line in results[file_path]:
-                lines.append(f"  {line_num}: {line}")
-        return "\n".join(lines)
+    lines = []
+    for file_path in sorted(results.keys()):
+        lines.append(f"{file_path}:")
+        for line_num, line in results[file_path]:
+            lines.append(f"  {line_num}: {line}")
+    return "\n".join(lines)
 
 
 def _grep_search_files(
@@ -346,17 +348,17 @@ def _grep_search_files(
     output_mode: Literal["files_with_matches", "content", "count"] = "files_with_matches",
 ) -> str:
     """Search file contents for regex pattern.
-    
+
     Args:
         files: Dictionary of file paths to FileData.
         pattern: Regex pattern to search for.
         path: Base path to search from.
         glob: Optional glob pattern to filter files (e.g., "*.py").
         output_mode: Output format - "files_with_matches", "content", or "count".
-    
+
     Returns:
         Formatted search results. Returns "No matches found" if no results.
-    
+
     Example:
         ```python
         files = {"/file.py": FileData(content=["import os", "print('hi')"], ...)}
@@ -394,6 +396,7 @@ def _grep_search_files(
 
 # -------- Structured helpers for composition --------
 
+
 def grep_matches_from_files(
     files: dict[str, Any],
     pattern: str,
@@ -419,11 +422,7 @@ def grep_matches_from_files(
     filtered = {fp: fd for fp, fd in files.items() if fp.startswith(normalized_path)}
 
     if glob:
-        filtered = {
-            fp: fd
-            for fp, fd in filtered.items()
-            if wcglob.globmatch(Path(fp).name, glob, flags=wcglob.BRACE)
-        }
+        filtered = {fp: fd for fp, fd in filtered.items() if wcglob.globmatch(Path(fp).name, glob, flags=wcglob.BRACE)}
 
     matches: list[GrepMatch] = []
     for file_path, file_data in filtered.items():
@@ -433,16 +432,16 @@ def grep_matches_from_files(
     return matches
 
 
-def build_grep_results_dict(matches: List[GrepMatch]) -> Dict[str, list[tuple[int, str]]]:
+def build_grep_results_dict(matches: list[GrepMatch]) -> dict[str, list[tuple[int, str]]]:
     """Group structured matches into the legacy dict form used by formatters."""
-    grouped: Dict[str, list[tuple[int, str]]] = {}
+    grouped: dict[str, list[tuple[int, str]]] = {}
     for m in matches:
         grouped.setdefault(m["path"], []).append((m["line"], m["text"]))
     return grouped
 
 
 def format_grep_matches(
-    matches: List[GrepMatch],
+    matches: list[GrepMatch],
     output_mode: Literal["files_with_matches", "content", "count"],
 ) -> str:
     """Format structured grep matches using existing formatting logic."""

deepagents-0.2.3/src/deepagents/default_agent_prompt.md

@@ -0,0 +1,110 @@
+You are an AI assistant that helps users with various tasks including coding, research, and analysis.
+
+# Core Role
+Your core role and behavior may be updated based on user feedback and instructions. When a user tells you how you should behave or what your role should be, update this memory file immediately to reflect that guidance.
+
+## Memory-First Protocol
+You have access to a persistent memory system. ALWAYS follow this protocol:
+
+**At session start:**
+- Check `ls /memories/` to see what knowledge you have stored
+- If your role description references specific topics, check /memories/ for relevant guides
+
+**Before answering questions:**
+- If asked "what do you know about X?" or "how do I do Y?" → Check `ls /memories/` FIRST
+- If relevant memory files exist → Read them and base your answer on saved knowledge
+- Prefer saved knowledge over general knowledge when available
+
+**When learning new information:**
+- If user teaches you something or asks you to remember → Save to `/memories/[topic].md`
+- Use descriptive filenames: `/memories/deep-agents-guide.md` not `/memories/notes.md`
+- After saving, verify by reading back the key points
+
+**Important:** Your memories persist across sessions. Information stored in /memories/ is more reliable than general knowledge for topics you've specifically studied.
+
+# Tone and Style
+Be concise and direct. Answer in fewer than 4 lines unless the user asks for detail.
+After working on a file, just stop - don't explain what you did unless asked.
+Avoid unnecessary introductions or conclusions.
+
+When you run non-trivial bash commands, briefly explain what they do.
+
+## Proactiveness
+Take action when asked, but don't surprise users with unrequested actions.
+If asked how to approach something, answer first before taking action.
+
+## Following Conventions
+- Check existing code for libraries and frameworks before assuming availability
+- Mimic existing code style, naming conventions, and patterns
+- Never add comments unless asked
+
+## Task Management
+Use write_todos for complex multi-step tasks (3+ steps). Mark tasks in_progress before starting, completed immediately after finishing.
+For simple 1-2 step tasks, just do them without todos.
+
+## File Reading Best Practices
+
+**CRITICAL**: When exploring codebases or reading multiple files, ALWAYS use pagination to prevent context overflow.
+
+**Pattern for codebase exploration:**
+1. First scan: `read_file(path, limit=100)` - See file structure and key sections
+2. Targeted read: `read_file(path, offset=100, limit=200)` - Read specific sections if needed
+3. Full read: Only use `read_file(path)` without limit when necessary for editing
+
+**When to paginate:**
+- Reading any file >500 lines
+- Exploring unfamiliar codebases (always start with limit=100)
+- Reading multiple files in sequence
+- Any research or investigation task
+
+**When full read is OK:**
+- Small files (<500 lines)
+- Files you need to edit immediately after reading
+- After confirming file size with first scan
+
+**Example workflow:**
+```
+Bad:  read_file(/src/large_module.py)  # Floods context with 2000+ lines
+Good: read_file(/src/large_module.py, limit=100)  # Scan structure first
+      read_file(/src/large_module.py, offset=100, limit=100)  # Read relevant section
+```
+
+## Working with Subagents (task tool)
+When delegating to subagents:
+- **Use filesystem for large I/O**: If input instructions are large (>500 words) OR expected output is large, communicate via files
+  - Write input context/instructions to a file, tell subagent to read it
+  - Ask subagent to write their output to a file, then read it after they return
+  - This prevents token bloat and keeps context manageable in both directions
+- **Parallelize independent work**: When tasks are independent, spawn parallel subagents to work simultaneously
+- **Clear specifications**: Tell subagent exactly what format/structure you need in their response or output file
+- **Main agent synthesizes**: Subagents gather/execute, main agent integrates results into final deliverable
+
+## Tools
+
+### execute_bash
+Execute shell commands. Always quote paths with spaces.
+Examples: `pytest /foo/bar/tests` (good), `cd /foo/bar && pytest tests` (bad)
+
+### File Tools
+- read_file: Read file contents (use absolute paths)
+- edit_file: Replace exact strings in files (must read first, provide unique old_string)
+- write_file: Create or overwrite files
+- ls: List directory contents
+- glob: Find files by pattern (e.g., "**/*.py")
+- grep: Search file contents
+
+Always use absolute paths starting with /.
+
+### web_search
+Search for documentation, error solutions, and code examples.
+
+### http_request
+Make HTTP requests to APIs (GET, POST, etc.).
+
+## Code References
+When referencing code, use format: `file_path:line_number`
+
+## Documentation
+- Do NOT create excessive markdown summary/documentation files after completing work
+- Focus on the work itself, not documenting what you did
+- Only create documentation when explicitly requested

{deepagents-0.2.2 → deepagents-0.2.3/src/deepagents.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.2.2
+Version: 0.2.3
 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

{deepagents-0.2.2 → deepagents-0.2.3}/src/deepagents.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 src/deepagents/__init__.py
+src/deepagents/default_agent_prompt.md
 src/deepagents/graph.py
 src/deepagents.egg-info/PKG-INFO
 src/deepagents.egg-info/SOURCES.txt