deepagents built-in filesystem tool schemas and error strings (state backend)
deepagents 0.7.38, default StateBackend (files live in graph state under the 'files' key). Tool args: ls(path), read_file(file_path, offset=0, limit=100), write_file(file_path, content), edit_file(file_path, old_string, new_string, replace_all=False), delete(file_path), glob(pattern, path=None), grep(pattern, path=None, glob=None, output_mode='files_with_matches'|'content'|'count', max_count=None) where grep is a literal string match, not regex. Observed results: write_file -> 'Updated file /a.txt' (it silently OVERWRITES an existing file, no error); read_file -> '@@ lines 1-2 of 2 @@' header then the lines; missing file -> 'Error: File '/nope.txt' not found'; edit_file with absent text -> 'Error: String not found in file: 'zzz''; read_file offset past the end -> 'Error: Line offset 5 exceeds file length (3 lines)'; ls -> a Python-list-looking string like '['/a.txt']'; grep with nothing found -> 'No matches found'. A relative path like 'rel.txt' is normalised to '/rel.txt'. Errors are returned as tool message text, not raised.