741d9bb3d96cdocs/react-server.config.mjs+13 -0docs/react-server.wrangler.toml+20 -11docs/src/pages/(content-negotiation).middleware.mjs+15 -11packages/react-server/adapters/core.mjs+4 -0packages/react-server/lib/plugins/file-router/plugin.mjs+8 -0| 54 | 54 | accept: "application/json", | |
| 55 | 55 | }, | |
| 56 | 56 | }, | |
| 57 | + | // Prerender the agent-skills SKILL.md to a real static asset. The | |
| 58 | + | // `(agent-discovery).middleware.mjs` dispatcher serves it dynamically in | |
| 59 | + | // dev, but in production the Cloudflare adapter excludes `.md` from | |
| 60 | + | // `run_worker_first` so ASSETS-only handles `.md` requests — the file | |
| 61 | + | // must exist on disk for SKILL.md to be reachable. | |
| 62 | + | { | |
| 63 | + | path: "/.well-known/agent-skills/react-server/SKILL.md", | |
| 64 | + | filename: ".well-known/agent-skills/react-server/SKILL.md", | |
| 65 | + | method: "GET", | |
| 66 | + | headers: { | |
| 67 | + | accept: "text/markdown", | |
| 68 | + | }, | |
| 69 | + | }, | |
| 57 | 70 | ]; | |
| 58 | 71 | }, | |
| 59 | 72 | }; |
| 8 | 8 | # default assets-first router would short-circuit pre-rendered HTML before | |
| 9 | 9 | # the middleware ever runs. | |
| 10 | 10 | # | |
| 11 | - | # Pattern form (vs the simpler `true`) excludes paths the worker has nothing | |
| 12 | - | # to do for: bundled assets, client modules, and any path with a static-file | |
| 13 | - | # extension. Those bypass the worker entirely and Cloudflare's `_headers` | |
| 14 | - | # rules still apply directly. URLs without an extension (`/`, | |
| 15 | - | # `/router/file-router`, `/.well-known/*`, `/mcp`, …) fall through to the | |
| 16 | - | # worker so content negotiation, the agent-discovery middleware, and SSR | |
| 17 | - | # routes keep working. | |
| 11 | + | # Pattern form (vs the simpler `true`) bypasses the worker for paths that | |
| 12 | + | # are unambiguously served by ASSETS: bundled binary/font assets, the | |
| 13 | + | # prerendered `*.md` siblings of every page (worker has no route for | |
| 14 | + | # them), and `*.txt` files like `robots.txt` / `llms.txt`. We deliberately | |
| 15 | + | # do NOT exclude `.json`, `.html`, or `.xml`: the agent-discovery | |
| 16 | + | # middleware serves dynamic `.json` endpoints under `/.well-known/` whose | |
| 17 | + | # paths are never on disk, and the content-negotiation middleware needs | |
| 18 | + | # the worker to run for HTML requests with `Accept: text/markdown`. For | |
| 19 | + | # the real static `.json` assets (e.g. `/schema.json`) and `.xml` | |
| 20 | + | # (`/sitemap.xml`), the worker's edge handler proxies the request to | |
| 21 | + | # `env.ASSETS.fetch()` and only falls through to SSR on a genuine 404, so | |
| 22 | + | # worker-first costs one cheap proxy hop and Cloudflare's `_headers` rules | |
| 23 | + | # still apply (worker-proxied, not worker-generated). | |
| 24 | + | # | |
| 25 | + | # Any dynamic endpoint that *must* be served at an excluded extension | |
| 26 | + | # (e.g. `.well-known/agent-skills/react-server/SKILL.md`) has to be | |
| 27 | + | # materialized into the static-assets directory at build time so the | |
| 28 | + | # ASSETS-only path can serve it. The agent-discovery middleware is then | |
| 29 | + | # only the dev-mode fallback. | |
| 18 | 30 | [assets] | |
| 19 | 31 | run_worker_first = [ | |
| 20 | 32 | "/*", |
| 30 | 42 | "!/*.css", | |
| 31 | 43 | "!/*.js", | |
| 32 | 44 | "!/*.mjs", | |
| 33 | - | "!/*.json", | |
| 34 | - | "!/*.xml", | |
| 35 | - | "!/*.txt", | |
| 36 | 45 | "!/*.woff", | |
| 37 | 46 | "!/*.woff2", | |
| 38 | 47 | "!/*.ttf", | |
| 39 | 48 | "!/*.eot", | |
| 40 | - | "!/*.html", | |
| 49 | + | "!/*.txt", | |
| 41 | 50 | "!/*.md", | |
| 42 | 51 | ] |
| 40 | 40 | return; | |
| 41 | 41 | } | |
| 42 | 42 | | |
| 43 | + | // Skip machine-only endpoints — they have their own response shape. | |
| 44 | + | // This MUST run before the `.md` rewrite below: `/.well-known/` paths can | |
| 45 | + | // legitimately end in `.md` (e.g. the agent-skills SKILL.md endpoint), and | |
| 46 | + | // those are served by the agent-discovery middleware / prerender pipeline, | |
| 47 | + | // not the page-markdown handler. | |
| 48 | + | if ( | |
| 49 | + | pathname === "/sitemap.xml" || | |
| 50 | + | pathname === "/schema.json" || | |
| 51 | + | pathname === "/mcp" || | |
| 52 | + | pathname.startsWith("/mcp/") || | |
| 53 | + | pathname.startsWith("/.well-known/") | |
| 54 | + | ) { | |
| 55 | + | return; | |
| 56 | + | } | |
| 57 | + | | |
| 43 | 58 | // Explicit `.md` URLs route through the dynamic `/md/[...slug]` handler. | |
| 44 | 59 | // Build-time pre-rendering relies on this rewrite to capture each page's | |
| 45 | 60 | // markdown into a static asset; without it the export step writes empty |
| 53 | 68 | return; | |
| 54 | 69 | } | |
| 55 | 70 | | |
| 56 | - | // Skip machine-only endpoints — they have their own response shape. | |
| 57 | - | if ( | |
| 58 | - | pathname === "/sitemap.xml" || | |
| 59 | - | pathname === "/schema.json" || | |
| 60 | - | pathname === "/mcp" || | |
| 61 | - | pathname.startsWith("/mcp/") || | |
| 62 | - | pathname.startsWith("/.well-known/") | |
| 63 | - | ) { | |
| 64 | - | return; | |
| 65 | - | } | |
| 66 | - | | |
| 67 | 71 | if (!prefersMarkdown(useRequest().headers.get("accept") ?? "")) { | |
| 68 | 72 | return; | |
| 69 | 73 | } |
| 118 | 118 | export async function getFiles(pattern, srcDir = cwd) { | |
| 119 | 119 | return glob(pattern, { | |
| 120 | 120 | onlyFiles: true, | |
| 121 | + | // Include dot-prefixed entries (e.g. `.well-known/...`). Without this, | |
| 122 | + | // `fast-glob` silently excludes any path under a dot-directory from the | |
| 123 | + | // adapter copy step — even when the prerender wrote a real file there. | |
| 124 | + | dot: true, | |
| 121 | 125 | cwd: srcDir, | |
| 122 | 126 | }); | |
| 123 | 127 | } |
| 1424 | 1424 | { | |
| 1425 | 1425 | cwd: join(cwd, root), | |
| 1426 | 1426 | absolute: true, | |
| 1427 | + | // Walk into dot-prefixed directories (e.g. `.well-known/`) so | |
| 1428 | + | // route files under public-by-convention paths are picked up. | |
| 1429 | + | // fast-glob defaults to `dot: false`. | |
| 1430 | + | dot: true, | |
| 1427 | 1431 | } | |
| 1428 | 1432 | ); | |
| 1429 | 1433 | |
| 1501 | 1505 | { | |
| 1502 | 1506 | cwd: join(cwd, root), | |
| 1503 | 1507 | absolute: true, | |
| 1508 | + | // Match the dev `watch()` below and the build glob above: | |
| 1509 | + | // pick up route files under dot-prefixed directories like | |
| 1510 | + | // `.well-known/`. fast-glob defaults to `dot: false`. | |
| 1511 | + | dot: true, | |
| 1504 | 1512 | } | |
| 1505 | 1513 | ) | |
| 1506 | 1514 | ); |