initial specs for generated apis

and proper packaging. Certainly more to be done here but this is a good placeholder.