chore: add our "true" openapi spec to the repo

[awalker4]

This is a version of our spec that generates the Python/Typescript clients. This stuff should eventually roll into the FastAPI generated spec, but for now we should get this version controlled.