chore: Add yamlfmt and ensure openapi spec stays formatted

.github/workflows/lint.yml

@@ -0,0 +1,31 @@
+name: Lint OpenAPI spec
+
+on:
+  pull_request:
+    paths:
+      - 'openapi.yaml'
+      - '.yamlfmt'
+  push:
+    branches:
+      - main
+    paths:
+      - 'openapi.yaml'
+      - '.yamlfmt'
+
+permissions:
+  contents: read
+
+jobs:
+  yamlfmt:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install yamlfmt
+        run: |
+          go install github.com/google/yamlfmt/cmd/yamlfmt@latest
+          echo "$(go env GOPATH)/bin" >> $GITHUB_PATH
+
+      - name: Check YAML formatting
+        run: yamlfmt -dry -conf .yamlfmt openapi.yaml

.yamlfmt

@@ -0,0 +1,6 @@
+formatter:
+  type: basic
+  indent: 2
+  retain_line_breaks: true
+  retain_line_breaks_multi: true
+  line_ending: lf

README.md

@@ -4,3 +4,13 @@ The OpenAPI specification offers a structured and clear format for API design. W
 Contact us: https://www.together.ai/contact
 
 Terms of Service: https://www.together.ai/terms-of-service
+
+## Development
+
+### YAML Formatting
+
+This repo uses [yamlfmt](https://github.com/google/yamlfmt) to keep `openapi.yaml` consistently formatted. CI will fail if the file is not formatted.
+
+```sh
+go run github.com/google/yamlfmt/cmd/yamlfmt@latest -conf .yamlfmt openapi.yaml
+```