# Public API contract snapshots

These generated files define **OpenAI-compatible subset v1**:

- `openapi.json` describes public and admin HTTP routes.
- `openai-realtime-client-events.schema.json` validates accepted Realtime events.
- `openai-realtime-server-events.schema.json` validates the common server-event envelope, supported event names, and extension version.

From the repository root, run `make contract-snapshots` after an intentional contract change. The contract
test fails when generated output differs, so snapshot changes must be reviewed
alongside implementation and documentation changes.