Record proxied sites' markdown, llms.txt and RSS requests under their public URL

[nolannbiron]

Proposed changes

For proxied sites (e.g. gitbook.com/docs), the middleware tracked server-side Insights events (markdown, llms.txt, RSS, ask) with the request URL, which is the proxy's: https://proxy.gitbook.site/sites/site_p4Xo4/changelog. The Agents report then listed Markdown reads as /sites/site_p4Xo4/changelog, while page views, sent from the browser, showed public URLs.

These events now use siteCanonicalURL, the public URL the API resolved for the request, with the request's query string. The path below the site's base is unchanged, and previews keep their request URL.

Validated locally: a markdown request through the proxy (x-gitbook-url: https://proxy.gitbook.site/sites/site_p4Xo4/changelog.md) logs Tracking 1 events at https://gitbook.com/docs/changelog.md.

Events already stored keep the proxy URL; they are not rewritten.

Changelog

• [Fix] Markdown, llms.txt and RSS requests on proxied sites now appear in Insights under the site's public URL instead of an internal /sites/site_… path.

[changeset-bot]

🦋 Changeset detected

Latest commit: f45949d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-4mapmfgul-gitbook.vercel.app	✅
Cloudflare	https://eff5cd9e-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-4mapmfgul-gitbook.vercel.app/url/gitbook.com/docs	https://eff5cd9e-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-4mapmfgul-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://eff5cd9e-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2-cloudflare (Inspect)	👍 Approved by Nolann Biron	9 changed, 2 ignored	Oct 6, 2026, 10:56 AM
customers-v2-vercel (Inspect)	👍 Approved by Nolann Biron	6 changed, 6 ignored	Oct 6, 2026, 10:56 AM
v2-cloudflare (Inspect)	👍 Approved by Nolann Biron	1 changed, 2 ignored	Oct 6, 2026, 10:59 AM
v2-vercel (Inspect)	✅ No changes detected	2 ignored	Oct 6, 2026, 10:56 AM

[github-actions]

Style invalidation on a large API reference

Elements restyled by opening one popup on the Snyk API reference. A share near or above 100% means the insertion restyles the whole document.

interaction	restyled	page	share	budget
openapi-select	5	10,817	0.0%	25%	✅
search	639	10,817	5.9%	125%	✅