read_file | Read file contents by path. Returns UTF-8 text or base64 for binary with a mimeType hint, plus metadata. Large text files (over ~10 KB) are automatically truncated — use line_start/line_end to paginate through remaining content. Supports negative indices for tailing (e.g., line_start: -50). Use version_id to read a specific historical version without modifying state. |
write_file | Write UTF-8 text or base64-encoded binary to a file. Creates an immutable version automatically. |
create_file | Create a new file (fails if path already exists). Use write_file for upsert behavior. |
append_log | Append log entries to a file without overwriting. Ideal for shared logs across agents, sessions, and machines. |
upload_session | Manage staged binary uploads for large files. Use action ‘start’ to begin, ‘append’ to send chunks, ‘complete’ to finalize, or ‘cancel’ to discard. |
delete_file | Soft-delete a file or directory. Set recursive: true to delete all files under a path. Each file is individually tombstoned and restorable. |
move_file | Move or rename a file or directory. Set recursive: true to move all files under a path. Full audit trail on every path. |
list_files | List files in a directory. Supports recursive listing. Returns up to 1,000 entries per call. |
search_files | Search file contents by plain text pattern. Returns matching file metadata (path, name, size). Supports regex, case-insensitive, and content snippets. |
