blume@1.6.2
·
3 commits
to main
since this release
Patch Changes
- abd8daf: Every site now serves a read-only JSON docs API — the REST twin of the MCP tools, over the same page snapshot — described by an OpenAPI 3.1 document at
/openapi.json./api/docs/pages.jsonlists every page with its route, title, description, content type, locale, facets, and the URLs of its rendered, Markdown, and JSON forms;/api/docs/pages/{route}.jsonreturns one page as JSON with its agent Markdown;/api/docs/navigation.jsonreturns the navigation tree. All three are prerendered, so static sites serve them as files. Under server output,/api/docs/search?q=runs the same full-text search as the MCPsearch_docstool, with the samelimit,contentTypes,locale,version, andfilters[key]scoping, and any/api/…URL no endpoint answers gets a 404 problem document instead of the HTML page. Errors everywhere are RFC 9457 problem details (application/problem+json) with a stablecode, adetail, and aresolutionhint. The OpenAPI document is generated per build from config — oneoperationId, typed parameters, and response schemas per operation — and also documents the.mdmirrors,llms.txt,llms-full.txt,agent-readability.json, and the MCP endpoint, so function-calling frameworks that ingest OpenAPI get the same reach an MCP client has. It's linked from the RFC 9727 API catalog,agent-readability.json,llms.txt, and the homepageLinkheader asrel="service-desc". The default 404 page gains a JSON twin at/404.jsonalongside its Markdown one, wired into Vercel server builds for requests that sendAccept: application/jsonor ask for a.jsonURL no file backs. Setai.api: falseto publish none of it; apublic/openapi.jsonyou ship yourself takes over that route.