deep-agents-memory

Pluggable memory and file backends for Deep Agents with ephemeral, persistent, and hybrid routing options. Short-term (StateBackend) : Persists within a single thread, lost when thread ends Long-term (StoreBackend) : Persists across threads and sessions Hybrid (CompositeBackend) : Route different paths to different backends FilesystemMiddleware provides tools: ls , read_file , write_file , edit_file , glob , grep agent = create_deep_agent() # Default: StateBackend result = agent.invoke({ "messages": [{"role": "user", "content": "Write notes to /draft.txt"}] }, config={"configurable": {"thread_id": "thread-1"}}) store = InMemoryStore() composite_backend = lambda rt: CompositeBackend( default=StateBackend(rt), routes={"/memories/": StoreBackend(rt)} ) agent = create_deep_agent(backend=composite_backend, store=store) config2 = {"configurable": {"thread_id": "thread-2"}} agent.invoke({"messages": [{"role": "user", "content": "Read /memories/style.txt"}]}, config=config2) agent = create_deep_agent( backend=FilesystemBackend(root_dir=".", virtual_mode=True), # Restrict access interrupt_on={"write_file": True, "edit_file": True}, checkpointer=MemorySaver() ) Security: Never use FilesystemBackend in web servers - use StateBackend or sandbox instead. @tool def get_user_preference(key: str, runtime: ToolRuntime) -> str: """Get a user preference from long-term storage.""" store =...