Harrison/cli pluggable

README.md

@@ -109,9 +109,7 @@ By default, `deepagents` uses `"claude-sonnet-4-5-20250929"`. You can customize
 from langchain.chat_models import init_chat_model
 from deepagents import create_deep_agent
 
-model = init_chat_model(
-    model="openai:gpt-5",  
-)
+model = init_chat_model("openai:gpt-4o")
 agent = create_deep_agent(
     model=model,
 )
@@ -296,19 +294,29 @@ 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.
+### `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.backends import (
+    CompositeStateBackendProvider,
+    StoreBackendProvider,
+)
 from langgraph.store.memory import InMemoryStore
 
 store = InMemoryStore()  # Or any other Store object
+
+# Create a hybrid backend: ephemeral files in / and persistent files in /memories/
+backend = CompositeStateBackendProvider(
+    routes={"/memories/": StoreBackendProvider()}
+)
+
 agent = create_deep_agent(
-    store=store,
-    use_longterm_memory=True
+    backend=backend,
+    store=store
 )
 ```
 
@@ -384,15 +392,24 @@ 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 (
+    StateBackendProvider,
+    CompositeStateBackendProvider,
+    StoreBackendProvider,
+)
 
 # FilesystemMiddleware is included by default in create_deep_agent
 # You can customize it if building a custom agent
 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
+            backend=StateBackendProvider(),  # Optional: customize storage backend (defaults to StateBackendProvider)
+            # For persistent memory, use CompositeStateBackendProvider:
+            # backend=CompositeStateBackendProvider(
+            #     routes={"/memories/": StoreBackendProvider()}
+            # )
+            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..."

pyproject.toml

@@ -6,14 +6,23 @@ readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.11,<4.0"
 dependencies = [
+    "tavily-python",
+    "python-dotenv",
+    "requests",
+    "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]
+deepagents = "deepagents.cli:cli_main"
+
 [project.optional-dependencies]
 dev = [
     "pytest",
+    "pytest-recording",
     "pytest-cov",
     "build",
     "twine",
@@ -42,6 +51,7 @@ include = ["deepagents*"]
 
 [tool.setuptools.package-data]
 "*" = ["py.typed"]
+"deepagents" = ["*.md"]
 
 [tool.ruff]
 line-length = 150
@@ -92,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"

src/deepagents/backends/__init__.py

@@ -0,0 +1,18 @@
+"""Memory backends for pluggable file storage."""
+
+from deepagents.backends.composite import CompositeBackend, CompositeStateBackendProvider
+from deepagents.backends.filesystem import FilesystemBackend
+from deepagents.backends.state import StateBackend, StateBackendProvider
+from deepagents.backends.store import StoreBackend, StoreBackendProvider
+from deepagents.backends.protocol import BackendProtocol
+
+__all__ = [
+    "BackendProtocol",
+    "CompositeBackend",
+    "CompositeStateBackendProvider",
+    "FilesystemBackend",
+    "StateBackend",
+    "StateBackendProvider",
+    "StoreBackend",
+    "StoreBackendProvider",
+]