docs/api/openapi-v1.json rather than parallel handwritten definitions.
API overview
Compatibility, base URL, and contract rules.
Authentication
Bearer credentials, freshness, signed runners, and dedicated schemes.
TypeScript client
Typed calls with correlation, idempotency, retries, and rate-limit metadata.
Errors
Stable error envelope and retry decisions.