Function list 

pub async fn list(__arg0: State<AppState>, __arg1: Query<ListQuery>) -> Response

GET /api/v1/fs/list — one page of a directory’s contents.

Paging is by opaque cursor, which encodes the last path returned rather than an offset: entries are ordered by path, so a file added or removed mid-walk shifts every offset but cannot invalidate a path.

The encoding is what makes the token opaque, and it is not decoration. A raw path on the wire passes through form-urlencoded decoding, where + becomes a space — so a file named data+1.csv at a page boundary produced a cursor that decoded to a name sorting before the real entry, and a client looping until next_cursor was None re-fetched the same page forever.