fix(docs): pre-generate API docs to speed up documentation builds

The docusaurus-plugin-openapi-docs was regenerating 148 API documentation
files from scratch on every build, generating code samples in 4 languages
for each endpoint. This was leading to extremely long build times.

By pre-generating and committing these files, we can expect a much shorter
build time. This only adds a bit less than 3MB of size to the repo. Files
will be regenerated when specs change to ensure they are kept up-to-date.

Changes:
- Remove API docs directories from .gitignore so they can be tracked
- Add scripts/gen-api-mdx.sh to regenerate API docs from OpenAPI specs
- Add apidocs-codegen pre-commit hook to auto-regenerate when specs change
- Commit 148 generated API documentation files (81 stable, 33 experimental,
  34 deprecated)

🤖 Generated with [Claude Code](https://claude.com/claude-code)
🧒 Self-reviewed by Nathan Weinberg <nweinber@redhat.com>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Signed-off-by: Nathan Weinberg <nweinber@redhat.com>

Author: nathan-weinberg

.gitignore

@@ -32,8 +32,10 @@ CLAUDE.md
 docs/.docusaurus/
 docs/node_modules/
 docs/static/imported-files/
-docs/docs/api-deprecated/
-docs/docs/api-experimental/
-docs/docs/api/
+# Keep only the docusaurus cache and build output ignored
+# API docs are now pre-generated and committed (see scripts/gen-api-mdx.sh)
+# docs/docs/api-deprecated/  # Tracked - pre-generated
+# docs/docs/api-experimental/  # Tracked - pre-generated
+# docs/docs/api/  # Tracked - pre-generated
 tests/integration/client-typescript/node_modules/
 .ts-client-checkout/

.pre-commit-config.yaml

@@ -117,6 +117,13 @@ repos:
         pass_filenames: false
         require_serial: true
         files: ^src/llama_stack_api/.*$
+      - id: apidocs-codegen
+        name: API Docs MDX Codegen
+        entry: bash ./scripts/gen-api-mdx.sh
+        language: system
+        pass_filenames: false
+        require_serial: true
+        files: ^docs/static/.*-spec\.yaml$
       - id: check-workflows-use-hashes
         name: Check GitHub Actions use SHA-pinned actions
         entry: ./scripts/check-workflows-use-hashes.sh

docs/docs/api-deprecated/benchmarks.tag.mdx

@@ -0,0 +1,19 @@
+---
+id: benchmarks
+title: "Benchmarks"
+description: "Benchmarks"
+custom_edit_url: null
+---
+
+
+
+
+
+
+
+```mdx-code-block
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
+```

docs/docs/api-deprecated/datasets.tag.mdx

@@ -0,0 +1,19 @@
+---
+id: datasets
+title: "Datasets"
+description: "Datasets"
+custom_edit_url: null
+---
+
+
+
+
+
+
+
+```mdx-code-block
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
+```

docs/docs/api-deprecated/get-benchmark-v-1-alpha-eval-benchmarks-benchmark-id-get.api.mdx

@@ -0,0 +1,68 @@
+---
+id: get-benchmark-v-1-alpha-eval-benchmarks-benchmark-id-get
+title: "Get a benchmark by its ID."
+description: "Get a benchmark by its ID."
+sidebar_label: "Get a benchmark by its ID."
+hide_title: true
+hide_table_of_contents: true
+api: eJztWM1u20YQfpXBnlqDlpwgQRrdnMgJBCSoYSuHwjGEETkUNyZ36d2hbELgM/TeUx+jz9MX6CsUwx+R+kna9NQA8UXScnbmm5lvhjPeKEc+t8aTV5ONenp2Jh8R+dDpnLU1aqLO4RWZMMnQ3Y1UoEJrmAyLHOZ5qkMUufEnL8Ib5cOEMpRvubM5OdaNah2RYR1rcvKLy5zURHl22qxUoFhzKgezXirYg/HB6PuCoNcDsXXAifbgyNvChQTaQJpihuAZwztVBQJirSNyi05moaMauil/jtXkZh9KFWxPTJGmqrr9jzg4IeiM7wBp7H8uAJetGMyigwjMpmDjHcXACTLYB+N3AYjBxsKhpdAaz2qill1SB9bnIrtvdp5Q75loCwDTByw9LIe8iCjGIt3VXAUqQkZP/A9uTxupo173gW69b1UCWyg8teGnHg3QGtOipuVIIPjQirlFXJhQDhs+MmX+ENI2cAqdw3IA8brRAm+2WvaRvtOeBWNrDzp7A654AS1lU0JU1EJ7WDNiFP9qjkaRlgeYXg5KiV1BW5B2+YlCHqB8393fB9c96NnaWwZGfzdSVXWo19F9oR1FanIzLOFdPu9k+Vi8b3uArwa02+8zfQa3fBO0HVCzgsxGlEJOLrYuQxOSoBbcz451rlcYwRXdF+T5axrXrpIL56yDrk1C7GxW0+38cjaCK1uskrSE2KapffBw9eY1vPjp7MWoidCg/3lGLhrCdYRqTrYx14Zp1TSLVqSXndefwSFZI2LU6VB02pwckdXGs8Tsa/uffMGlKBfuSbSHrPBbN1qMLaRBzusQqn1yVYGiR8zyxtMuPs/OzgZk2Ulg52vbkepjeEAP2qwx1RFYBxmmQg2KOl48fXmY0rm18B5N2en239nxrbDj6cvB2+pIGrcc+cUWkOCagB5DooiiOi0OmSDVmeYRXKaEnoBdCbhCGR2QyXUN5fmxhjIzTM5gCtfk1uSgg/6dPN8CeZ4PW8vnUrkl0LmBwtBjTiFTBFSnyoZh4dy2uWxHnv3ETpsHcNWm9jtF/n8UaVLIuPKiZzuW1MPKbg7eEgMOhpNlCZo9zKYSZ4lyncpZpCZqRbzYCi7WTzDNE1zIANMf+8VAREeLxYrk7Zajw4yYnK8DYzCj4SzdjFZa8OTIyc5o1oyEPYX2p+zDeb5fJXq32MKKeKSOzGoyl1dfq0eSlxEntg1M7SMnaqLGbWDGEphxH5jxZuhuJaNkXZxNRAonZZkw55PxGE15mljPFJ3WG99pvfGNQpvVdj2FhdNc1henXZne3MozbWI7pOy7emO8lvtwnVOo47Y44RSmlDsKUTrA+eXscOSfyyCtfR0Bv3O3DctQeb2stXOz/2jgyB+CLDY2BjJRbrVhD2jqV5d2EFrXNIJIRmEpWBdjSL5RjI4ancJ/6+SFZ48bWcrclNKaHK46hO9lsPajj6a5cnLy52+///XHrzC9uLy6eH0+v5ienEzgHa0wLOtQNEYzLGEpw1hm1xTJ3hsXXDgCyZqM/iP40Kxojd5Mr5pqAUcxOTIhgTVpKaxrr6iJWj+pN2brOcO6O7bF8MVC3EnMpu+3X77VlgrTI4/zFLURyzXTNi1bb1TLVhUo4asK+qIUQkx2SvQ2UEJLubbZLNHTB5dWlRzfF+SEj7eBWqPTTUu72ahIe/keqUmMqacvOPLDVVvxP8K/qOFjjnWrrZHFVrYq+aUCdUflfq+pbqtAJYTy7wuB2YichyHlPLh88C7bqfq3F3NVVX8DpqVUXg==
+sidebar_class_name: "get api-method"
+info_path: docs/api-deprecated/llama-stack-specification-deprecated-apis
+custom_edit_url: null
+---
+
+import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
+import ParamsDetails from "@theme/ParamsDetails";
+import RequestSchema from "@theme/RequestSchema";
+import StatusCodes from "@theme/StatusCodes";
+import OperationTabs from "@theme/OperationTabs";
+import TabItem from "@theme/TabItem";
+import Heading from "@theme/Heading";
+
+<Heading
+  as={"h1"}
+  className={"openapi__heading"}
+  children={"Get a benchmark by its ID."}
+>
+</Heading>
+
+<MethodEndpoint
+  method={"get"}
+  path={"/v1alpha/eval/benchmarks/{benchmark_id}"}
+  context={"endpoint"}
+>
+
+</MethodEndpoint>
+
+
+
+Get a benchmark by its ID.
+
+<Heading
+  id={"request"}
+  as={"h2"}
+  className={"openapi-tabs__heading"}
+  children={"Request"}
+>
+</Heading>
+
+<ParamsDetails
+  parameters={[{"name":"benchmark_id","in":"path","required":true,"schema":{"type":"string","description":"The ID of the benchmark to get.","title":"Benchmark Id"},"description":"The ID of the benchmark to get."}]}
+>
+
+</ParamsDetails>
+
+<RequestSchema
+  title={"Body"}
+  body={undefined}
+>
+
+</RequestSchema>
+
+<StatusCodes
+  id={undefined}
+  label={undefined}
+  responses={{"200":{"description":"A Benchmark.","content":{"application/json":{"schema":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Unique identifier for this resource in llama stack"},"provider_resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unique identifier for this resource in the provider"},"provider_id":{"type":"string","title":"Provider Id","description":"ID of the provider that owns this resource"},"type":{"type":"string","const":"benchmark","title":"Type","description":"The resource type, always benchmark.","default":"benchmark"},"dataset_id":{"type":"string","title":"Dataset Id","description":"Identifier of the dataset to use for the benchmark evaluation."},"scoring_functions":{"items":{"type":"string"},"type":"array","title":"Scoring Functions","description":"List of scoring function identifiers to apply during evaluation."},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Metadata for this evaluation task."}},"type":"object","required":["identifier","provider_id","dataset_id","scoring_functions"],"title":"Benchmark","description":"A benchmark resource for evaluating model performance."}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":400,"title":"Bad Request","detail":"The request was invalid or malformed"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":429,"title":"Too Many Requests","detail":"You have exceeded the rate limit. Please try again later."}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":500,"title":"Internal Server Error","detail":"An unexpected error occurred"}}}},"default":{"description":"Default Response","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"}}}}}}
+>
+
+</StatusCodes>

docs/docs/api-deprecated/get-dataset-v-1-beta-datasets-dataset-id-get.api.mdx

@@ -0,0 +1,68 @@
+---
+id: get-dataset-v-1-beta-datasets-dataset-id-get
+title: "Get a dataset by its ID."
+description: "Get a dataset by its ID."
+sidebar_label: "Get a dataset by its ID."
+hide_title: true
+hide_table_of_contents: true
+api: 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
+sidebar_class_name: "get api-method"
+info_path: docs/api-deprecated/llama-stack-specification-deprecated-apis
+custom_edit_url: null
+---
+
+import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
+import ParamsDetails from "@theme/ParamsDetails";
+import RequestSchema from "@theme/RequestSchema";
+import StatusCodes from "@theme/StatusCodes";
+import OperationTabs from "@theme/OperationTabs";
+import TabItem from "@theme/TabItem";
+import Heading from "@theme/Heading";
+
+<Heading
+  as={"h1"}
+  className={"openapi__heading"}
+  children={"Get a dataset by its ID."}
+>
+</Heading>
+
+<MethodEndpoint
+  method={"get"}
+  path={"/v1beta/datasets/{dataset_id}"}
+  context={"endpoint"}
+>
+
+</MethodEndpoint>
+
+
+
+Get a dataset by its ID.
+
+<Heading
+  id={"request"}
+  as={"h2"}
+  className={"openapi-tabs__heading"}
+  children={"Request"}
+>
+</Heading>
+
+<ParamsDetails
+  parameters={[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","description":"The ID of the dataset to get.","title":"Dataset Id"},"description":"The ID of the dataset to get."}]}
+>
+
+</ParamsDetails>
+
+<RequestSchema
+  title={"Body"}
+  body={undefined}
+>
+
+</RequestSchema>
+
+<StatusCodes
+  id={undefined}
+  label={undefined}
+  responses={{"200":{"description":"The dataset object.","content":{"application/json":{"schema":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Unique identifier for this resource in llama stack"},"provider_resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unique identifier for this resource in the provider"},"provider_id":{"type":"string","title":"Provider Id","description":"ID of the provider that owns this resource"},"type":{"type":"string","const":"dataset","title":"Type","description":"Type of resource, always 'dataset' for datasets","default":"dataset"},"purpose":{"description":"Purpose of the dataset indicating its intended use","type":"string","enum":["post-training/messages","eval/question-answer","eval/messages-answer"],"title":"DatasetPurpose"},"source":{"oneOf":[{"title":"URIDataSource","properties":{"type":{"type":"string","const":"uri","title":"Type","description":"The type of data source.","default":"uri"},"uri":{"type":"string","title":"Uri","description":"The dataset can be obtained from a URI. E.g. \"https://mywebsite.com/mydata.jsonl\", \"lsfs://mydata.jsonl\", \"data:csv;base64,{base64_content}\""}},"type":"object","required":["uri"],"description":"A dataset that can be obtained from a URI."},{"title":"RowsDataSource","properties":{"type":{"type":"string","const":"rows","title":"Type","description":"The type of data source.","default":"rows"},"rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rows","description":"The dataset is stored in rows. E.g. [{\"messages\": [{\"role\": \"user\", \"content\": \"Hello, world!\"}, {\"role\": \"assistant\", \"content\": \"Hello, world!\"}]}]"}},"type":"object","required":["rows"],"description":"A dataset stored in rows."}],"title":"URIDataSource | RowsDataSource","description":"Data source configuration for the dataset","discriminator":{"propertyName":"type","mapping":{"rows":{"properties":{"type":{"type":"string","const":"rows","title":"Type","description":"The type of data source.","default":"rows"},"rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rows","description":"The dataset is stored in rows. E.g. [{\"messages\": [{\"role\": \"user\", \"content\": \"Hello, world!\"}, {\"role\": \"assistant\", \"content\": \"Hello, world!\"}]}]"}},"type":"object","required":["rows"],"title":"RowsDataSource","description":"A dataset stored in rows."},"uri":{"properties":{"type":{"type":"string","const":"uri","title":"Type","description":"The type of data source.","default":"uri"},"uri":{"type":"string","title":"Uri","description":"The dataset can be obtained from a URI. E.g. \"https://mywebsite.com/mydata.jsonl\", \"lsfs://mydata.jsonl\", \"data:csv;base64,{base64_content}\""}},"type":"object","required":["uri"],"title":"URIDataSource","description":"A dataset that can be obtained from a URI."}}}},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Any additional metadata for this dataset"}},"type":"object","required":["identifier","provider_id","purpose","source"],"title":"Dataset","description":"Dataset resource for storing and accessing training or evaluation data."}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":400,"title":"Bad Request","detail":"The request was invalid or malformed"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":429,"title":"Too Many Requests","detail":"You have exceeded the rate limit. Please try again later."}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"},"example":{"status":500,"title":"Internal Server Error","detail":"An unexpected error occurred"}}}},"default":{"description":"Default Response","content":{"application/json":{"schema":{"description":"Error response from the API. Roughly follows RFC 7807.","properties":{"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"detail":{"title":"Detail","type":"string"},"instance":{"anyOf":[{"type":"string"},{"type":"null"}],"nullable":true}},"required":["status","title","detail"],"title":"Error","type":"object"}}}}}}
+>
+
+</StatusCodes>