Visitar URL original
Backend that stores files in agent state (ephemeral).
Uses LangGraph's state management and checkpointing. Files persist within a conversation thread but not across threads. State is automatically checkpointed after each agent step.
Special handling: Since LangGraph state must be updated via Command objects (not direct mutation), operations return filesUpdate in WriteResult/EditResult for the middleware to apply via Command.
class StateBackendClass identity discriminant for StateBackend.isInstance.
Delete a file or directory from state.
Removes the exact file path plus every nested key under it.
Download multiple files.
Edit a file by replacing string occurrences. Returns EditResult with filesUpdate and occurrences.
Structured glob matching returning FileInfo objects.
Search file contents for a literal text pattern. Binary files are skipped.
List files and directories in the specified directory (non-recursive).
Read file content.
Text files are paginated by line offset/limit. Binary files return full Uint8Array content (offset/limit ignored).
Read file content as raw FileData.
Upload multiple files.
Note: Since LangGraph state must be updated via Command objects, the caller must apply filesUpdate via Command after calling this method.
Write content to a file, creating it or overwriting it if it already exists. Returns WriteResult with filesUpdate to update LangGraph state.
Duck-typed so this survives the plain-object copies adaptBackendProtocol makes — a class check wouldn't.