deepagents-cli 0.0.2__tar.gz → 0.0.3__tar.gz

{deepagents_cli-0.0.2/src/deepagents_cli.egg-info → deepagents_cli-0.0.3}/PKG-INFO

@@ -1,20 +1,22 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.2
+Version: 0.0.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
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: langchain-anthropic==1.0.0
-Requires-Dist: langchain==1.0.0
-Requires-Dist: langchain-core==1.0.0
 Requires-Dist: tavily-python
 Requires-Dist: python-dotenv
 Requires-Dist: requests
 Requires-Dist: rich>=13.0.0
+Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0
+Requires-Dist: langchain<2.0.0,>=1.0.0
+Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Requires-Dist: wcmatch
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-recording; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
@@ -319,40 +321,30 @@ agent = create_deep_agent(
 )
 ```
 
-### `use_longterm_memory`
-Deep agents come with a local filesystem to offload memory to. This filesystem is stored in state, and is therefore transient to a single thread.
+### `memory_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 extend deep agents with long-term memory by providing a Store and setting use_longterm_memory=True.
+You can configure persistent long-term memory using a CompositeBackend with StoreBackend:
 
 ```python
 from deepagents import create_deep_agent
+from deepagents.memory.backends import StateBackend, StoreBackend, CompositeBackend
 from langgraph.store.memory import InMemoryStore
 
 store = InMemoryStore()  # Or any other Store object
-agent = create_deep_agent(
-    store=store,
-    use_longterm_memory=True
-)
-```
 
-### `use_local_filesystem`
-If you prefer the agent to operate on your machine's filesystem (read/write actual files), enable local mode:
-
-```python
-from deepagents import create_deep_agent
+# Create a hybrid backend: ephemeral files in / and persistent files in /memories/
+backend = CompositeBackend(
+    default=StateBackend(),
+    routes={"/memories/": StoreBackend()}
+)
 
 agent = create_deep_agent(
-    use_local_filesystem=True,   # Tools operate on disk
-    # use_longterm_memory=False  # Must be False when using local filesystem
+    memory_backend=backend,
+    store=store
 )
 ```
 
-Notes:
-- Local filesystem mode injects `ls`, `read_file`, `write_file`, `edit_file`, plus `glob` and `grep` (ripgrep-powered) for discovery/search.
-- Long-term memory is not supported in local mode; attempting to set both `use_local_filesystem=True` and `use_longterm_memory=True` raises a ValueError.
-- Large tool outputs are automatically evicted to the in-memory filesystem state as files under `/large_tool_results/{tool_call_id}`; use `read_file` with `offset`/`limit` to page through results.
-- Be careful when enabling local mode in sensitive environments — tools can read and write files on disk.
-
 ### `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.
 
@@ -416,17 +408,16 @@ agent = create_agent(
 ### FilesystemMiddleware
 
 Context engineering is one of the main challenges in building effective agents. This can be particularly hard when using tools that can return variable length results (ex. web_search, rag), as long ToolResults can quickly fill up your context window.
-**FilesystemMiddleware** provides four tools to your agent to interact with short-term memory (in agent state) and, optionally, long-term memory (via a Store).
+**FilesystemMiddleware** provides four tools to your agent to interact with both short-term and long-term memory.
 - **ls**: List the files in your filesystem
 - **read_file**: Read an entire file, or a certain number of lines from a file
 - **write_file**: Write a new file to your filesystem
 - **edit_file**: Edit an existing file in your filesystem
 
-If you want these tools to operate on your host filesystem instead of the agent state, use `create_deep_agent(..., use_local_filesystem=True)` or attach `LocalFilesystemMiddleware` directly. Local mode also provides `glob` and `grep` helpers for file discovery and content search.
-
 ```python
 from langchain.agents import create_agent
 from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.memory.backends import StateBackend, StoreBackend, CompositeBackend
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
@@ -434,8 +425,13 @@ agent = create_agent(
     model="anthropic:claude-sonnet-4-20250514",
     middleware=[
         FilesystemMiddleware(
-            long_term_memory=False,  # Enables access to long-term memory, defaults to False. You must attach a store to use long-term memory.
-            system_prompt="Write to the filesystem when...",  # Optional custom addition to the system prompt
+            memory_backend=StateBackend(),  # Optional: customize storage backend (defaults to StateBackend)
+            # For persistent memory, use CompositeBackend:
+            # memory_backend=CompositeBackend(
+            #     default=StateBackend(),
+            #     routes={"/memories/": StoreBackend()}
+            # )
+            system_prompt="Write to the filesystem when...",  # Optional custom system prompt override
             custom_tool_descriptions={
                 "ls": "Use the ls tool when...",
                 "read_file": "Use the read_file tool to..."

{deepagents_cli-0.0.2 → deepagents_cli-0.0.3}/README.md

@@ -296,40 +296,30 @@ agent = create_deep_agent(
 )
 ```
 
-### `use_longterm_memory`
-Deep agents come with a local filesystem to offload memory to. This filesystem is stored in state, and is therefore transient to a single thread.
+### `memory_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 extend deep agents with long-term memory by providing a Store and setting use_longterm_memory=True.
+You can configure persistent long-term memory using a CompositeBackend with StoreBackend:
 
 ```python
 from deepagents import create_deep_agent
+from deepagents.memory.backends import StateBackend, StoreBackend, CompositeBackend
 from langgraph.store.memory import InMemoryStore
 
 store = InMemoryStore()  # Or any other Store object
-agent = create_deep_agent(
-    store=store,
-    use_longterm_memory=True
-)
-```
 
-### `use_local_filesystem`
-If you prefer the agent to operate on your machine's filesystem (read/write actual files), enable local mode:
-
-```python
-from deepagents import create_deep_agent
+# Create a hybrid backend: ephemeral files in / and persistent files in /memories/
+backend = CompositeBackend(
+    default=StateBackend(),
+    routes={"/memories/": StoreBackend()}
+)
 
 agent = create_deep_agent(
-    use_local_filesystem=True,   # Tools operate on disk
-    # use_longterm_memory=False  # Must be False when using local filesystem
+    memory_backend=backend,
+    store=store
 )
 ```
 
-Notes:
-- Local filesystem mode injects `ls`, `read_file`, `write_file`, `edit_file`, plus `glob` and `grep` (ripgrep-powered) for discovery/search.
-- Long-term memory is not supported in local mode; attempting to set both `use_local_filesystem=True` and `use_longterm_memory=True` raises a ValueError.
-- Large tool outputs are automatically evicted to the in-memory filesystem state as files under `/large_tool_results/{tool_call_id}`; use `read_file` with `offset`/`limit` to page through results.
-- Be careful when enabling local mode in sensitive environments — tools can read and write files on disk.
-
 ### `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,17 +383,16 @@ agent = create_agent(
 ### FilesystemMiddleware
 
 Context engineering is one of the main challenges in building effective agents. This can be particularly hard when using tools that can return variable length results (ex. web_search, rag), as long ToolResults can quickly fill up your context window.
-**FilesystemMiddleware** provides four tools to your agent to interact with short-term memory (in agent state) and, optionally, long-term memory (via a Store).
+**FilesystemMiddleware** provides four tools to your agent to interact with both short-term and long-term memory.
 - **ls**: List the files in your filesystem
 - **read_file**: Read an entire file, or a certain number of lines from a file
 - **write_file**: Write a new file to your filesystem
 - **edit_file**: Edit an existing file in your filesystem
 
-If you want these tools to operate on your host filesystem instead of the agent state, use `create_deep_agent(..., use_local_filesystem=True)` or attach `LocalFilesystemMiddleware` directly. Local mode also provides `glob` and `grep` helpers for file discovery and content search.
-
 ```python
 from langchain.agents import create_agent
 from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.memory.backends import StateBackend, StoreBackend, CompositeBackend
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
@@ -411,8 +400,13 @@ agent = create_agent(
     model="anthropic:claude-sonnet-4-20250514",
     middleware=[
         FilesystemMiddleware(
-            long_term_memory=False,  # Enables access to long-term memory, defaults to False. You must attach a store to use long-term memory.
-            system_prompt="Write to the filesystem when...",  # Optional custom addition to the system prompt
+            memory_backend=StateBackend(),  # Optional: customize storage backend (defaults to StateBackend)
+            # For persistent memory, use CompositeBackend:
+            # memory_backend=CompositeBackend(
+            #     default=StateBackend(),
+            #     routes={"/memories/": StoreBackend()}
+            # )
+            system_prompt="Write to the filesystem when...",  # Optional custom system prompt override
             custom_tool_descriptions={
                 "ls": "Use the ls tool when...",
                 "read_file": "Use the read_file tool to..."
@@ -529,4 +523,4 @@ async def main():
             chunk["messages"][-1].pretty_print()
 
 asyncio.run(main())
-```
+```

{deepagents_cli-0.0.2 → deepagents_cli-0.0.3}/pyproject.toml

@@ -1,18 +1,19 @@
 [project]
 name = "deepagents-cli"
-version = "0.0.2"
+version = "0.0.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" }
 requires-python = ">=3.11,<4.0"
 dependencies = [
-    "langchain-anthropic==1.0.0",
-    "langchain==1.0.0",
-    "langchain-core==1.0.0",
     "tavily-python",
     "python-dotenv",
     "requests",
-    "rich>=13.0.0"
+    "rich>=13.0.0",
+    "langchain-anthropic>=1.0.0,<2.0.0",
+    "langchain>=1.0.0,<2.0.0",
+    "langchain-core>=1.0.0,<2.0.0",
+    "wcmatch"
 ]
 
 [project.scripts]
@@ -21,6 +22,7 @@ deepagents = "deepagents.cli:cli_main"
 [project.optional-dependencies]
 dev = [
     "pytest",
+    "pytest-recording",
     "pytest-cov",
     "build",
     "twine",
@@ -100,3 +102,9 @@ enable_error_code = ["deprecated"]
 # Optional: reduce strictness if needed
 disallow_any_generics = false
 warn_return_any = false
+
+[tool.pytest.ini_options]
+markers = [
+  "vcr: record/replay HTTP via VCR"
+]
+addopts = "--record-mode=once"

deepagents_cli-0.0.3/src/deepagents/__init__.py

@@ -0,0 +1,7 @@
+"""DeepAgents package."""
+
+from deepagents.graph import create_deep_agent
+from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.middleware.subagents import CompiledSubAgent, SubAgent, SubAgentMiddleware
+
+__all__ = ["CompiledSubAgent", "FilesystemMiddleware", "SubAgent", "SubAgentMiddleware", "create_deep_agent"]