fix type hinting, rename retrieve->all, add retrieve