deep-agents-memory

1<overview>
2Deep Agents use pluggable backends for file operations and memory:
3 
4**Short-term (StateBackend)**: Persists within a single thread, lost when thread ends
5**Long-term (StoreBackend)**: Persists across threads and sessions
6**Hybrid (CompositeBackend)**: Route different paths to different backends
7 
8FilesystemMiddleware provides tools: `ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`
9</overview>
10 
11<backend-selection>
12 
13| Use Case | Backend | Why |
14|----------|---------|-----|
15| Temporary working files | StateBackend | Default, no setup |
16| Local development CLI | FilesystemBackend | Direct disk access |
17| Cross-session memory | StoreBackend | Persists across threads |
18| Hybrid storage | CompositeBackend | Mix ephemeral + persistent |
19 
20</backend-selection>
21 
22<ex-default-state-backend>
23<python>
24Default StateBackend stores files ephemerally within a thread.
25 
26```python
27from deepagents import create_deep_agent
28 
29agent = create_deep_agent()  # Default: StateBackend
30result = agent.invoke({
31    "messages": [{"role": "user", "content": "Write notes to /draft.txt"}]
32}, config={"configurable": {"thread_id": "thread-1"}})
33# /draft.txt is lost when thread ends
34```
35</python>
36<typescript>
37Default StateBackend stores files ephemerally within a thread.
38 
39```typescript
40import { createDeepAgent } from "deepagents";
41 
42const agent = await createDeepAgent();  // Default: StateBackend
43const result = await agent.invoke({
44…