Link OpenAPI spec from llms.txt and robots.txt#69
Conversation
- Add src/pages/openapi.yaml.ts endpoint to serve the raw spec at /openapi.yaml - Add optionalLinks to starlight-llms-txt config so llms.txt references the spec - Add Llms-Txt and OpenAPI directives to robots.txt Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
![oz-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
There was a problem hiding this comment.
Overview
This PR adds a prerendered /openapi.yaml endpoint backed by the existing OpenAPI source file, advertises it from llms.txt via optionalLinks, and exposes discovery links in robots.txt. I did not find correctness, documentation-structure, or security issues in the changed lines.
Concerns
- None.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
2 participants
Summary
Makes the Oz Agent API OpenAPI spec discoverable by AI agents, crawlers, and developer tooling by linking it from
llms.txtandrobots.txt.Changes
src/pages/openapi.yaml.ts— New prerendered Astro endpoint serving the raw spec at/openapi.yaml(single source of truth, no file duplication)astro.config.mjs— AddedoptionalLinksto thestarlight-llms-txtplugin config so/llms.txtincludes an## Optionalsection with the spec URLpublic/robots.txt— AddedLlms-Txtdirective (per llmstxt.org recommendation) andOpenAPIdirective pointing to the specContext
Co-Authored-By: Oz oz-agent@warp.dev