initial implementation of a custom tag cache

2026-09-25 11:52:10 +00:00 · 2025-06-09 16:05:38 +02:00
1334 changed files with 25054 additions and 100305 deletions
@@ -1,48 +0,0 @@
---
-name: write-pr-description
-description: Write a concise, product-focused PR description from the changes and available discussion. Use when asked for a PR summary or description.
---
-
-# Write a PR description
-
-Read the full branch diff and commit history against the PR's base branch, not just the latest commit. Use the PR discussion and linked issues for context when available. The PR's changes are the source of truth for what ships if an issue describes something different.
-
-Write for contributors and reviewers who may not know the area. Lead with what changes, prefer user or product impact when supported, and include implementation details only when they help review. Keep the proposed changes short, using bullets only when useful.
-
-Include relevant validation and screenshots when available. Do not claim checks passed unless they ran. Use only information appropriate for a public repository; do not copy private issue details or customer information into the description.
-
-## Template and changelog
-
-Read `.github/pull_request_template.md` immediately before writing. Preserve its required section names and order. Include `Proposed changes` and `Changelog`; omit `Demo` when there is nothing to show. Add optional `Context` before `Changelog` only when it meets the rule below.
-
-Write a short changelog entry describing what shipped. Use `[Feature]` for user-facing additions or improvements, `[Fix]` for user-facing bug fixes, and `[Chore]` for internal maintenance. For features and fixes, say what users can do or what no longer goes wrong in plain words. Keep chores useful to teammates without inventing user impact. Remove unused examples and placeholders. Usually one entry is enough; use more only for distinct changes. The PR changelog does not replace any changeset required by `AGENTS.md`.
-
-## Optional context
-
-Write `Proposed changes` and `Changelog` first. Add `Context` only when it tells someone unfamiliar with the area something material that the changelog does not. `Problem` names a concrete failure or limitation supported by the PR or discussion. `Outcome` names what this PR delivers at its actual scope. Omit the section if either field would repeat the changelog, describe only implementation, or guess at an impact.
-
-```markdown
-## Context
-
-**Problem:** <concrete failure or limitation>
-
-**Outcome:** <result delivered by this PR>
-```
-
-Keep each field to 1–2 short, non-technical sentences. Prefer user or product impact when supported. For infrastructure changes, explain the failure or limitation they caused. Do not invent an actor, customer segment, ownership, or impact, or force the change into a user story. Do not turn a preparatory change into a claim that the whole workflow is fixed. Keep the roles distinct: `Context` explains why this matters, `Changelog` says what shipped, and `Proposed changes` can explain implementation.
-
-Examples:
-
- A dependency bump with no demonstrated user effect needs no `Context`.
- If creating the first change request leaves the user on an empty screen, say that it now opens after creation. Leave the animation-listener details in `Proposed changes`.
- If a PR indexes links for later checks, describe the indexing result. Do not claim every link has already been checked.
-
-## Writing pass
-
- Use plain words and direct verbs: "use" instead of "leverage", "help" instead of "facilitate". Prefer active voice when the actor is known.
- Name the concrete behavior instead of saying "improves the experience" or "makes it more robust". Support performance claims with measurements.
- Cut filler, promotional language, and generic conclusions. If a sentence could fit almost any PR, make it specific or delete it.
- Keep one idea per sentence and use consistent names. Remove redundant hedging without hiding real uncertainty.
- Avoid "not just X, but Y", forced groups of three, em dashes, decorative emojis, and unnecessary bold text.
-
-Return the description in a Markdown code block unless asked to update the PR. When asked to update it, apply the description with `gh pr edit` using a body file.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix "View activity" disclosure in AI Chat not opening after the Base UI migration.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Scroll to an in-page heading even when the URL hash is unchanged (e.g. clicking the same anchor again).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Force software rendering (SwiftShader) in Playwright Chromium to eliminate image downscaling drift between GPU-equipped local runs and headless CI runs in Argos screenshots.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add `leaveAgentFeedback` and `leaveUserFeedback` assistant tools, reporting documentation findings to the site's team through the same path as the MCP `sendFeedback` tool, and record an `agent_feedback` insights event on both surfaces.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Stop showing previously asked questions as suggestions in the GitBook Assistant
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an assistant tool to rate its own previous response when the user reacts to it.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an assistant tool to submit feedback about the current page on behalf of the user.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Assistant: you can now send follow-up questions while an answer is still being written. Each one appears as your own message with a "Queued" badge (hover for when it will send, × to cancel), and they're sent automatically one at a time as each answer completes.
@@ -0,0 +1,9 @@
+---
+"gitbook": patch
+---
+
+Fix three small visual issues
+
+- Fix sidebar showing on `no-toc` pages in the gradient theme
+- Fix variant selector truncating incorrectly in header when sections are present
+- Fix page cover alignment on `lg` screens without TOC
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Simplify carousel overflow with symmetric edge masks and visible-item paging. Replaces complex negative-margin bleed logic with transparent edge fades and page-by-visible-item scrolling.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep the breadcrumbs from covering the page actions' hit area.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Respect fullWidth and defaultWidth for images
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Include published page descriptions in the page's Markdown output.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Bump Next.js to 16.3.3.
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Add a carousel layout option to cards blocks, rendering them as a horizontally-scrolling, scroll-snapping row instead of a wrapping grid.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix select filters not working on table and cards blocks.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Chunk oversized visitor auth cookies to fix an infinite redirect loop when the visitor token exceeds the browser cookie size limit.
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Fix inline Ask AI buttons opening a configured custom assistant.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+fix nested a tag causing hydration error
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Assistant: the "Explored briefly" activity heading no longer appears when there's nothing to show. It now renders only when the answer is preceded by a real preamble or one or more tool calls, so a simple answer with an empty reasoning step no longer surfaces an empty collapsible.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix ContentKit buttons to size to their content instead of stretching to the full container width.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Stop the built-in cookie banner from flashing on sites using a consent integration such as Osano or OneTrust.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+fix href being empty in TOC
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix navigation between sections/variants when previewing a site in v2
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix breadcrumbs for cross-space page links in grouped sites.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Show the theme toggle in the footer whenever the outline column that hosts the other toggle isn't pinned open, so it stays reachable on laptop-sized screens in wide layouts and while the AI chat is open.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Disable click-to-zoom for inline line sized images.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Give the prompt block a default "Copy prompt" action alongside "Open in Claude", "Open in Codex" and "Open in Cursor", and remember the visitor's last pick across every prompt block.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix host action buttons in the Docs Embed not reaching the assistant.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the docs embed `navigateToPage` API on multi-space sites. Deep-linking to a page in a different space/section (e.g. `navigateToPage('/help-center/integrations')`) previously 404'd because the section base was not placed before `~gitbook/embed/page`. The target is now resolved to its space server-side, so pages in any space resolve correctly. The input accepts the page path, an absolute path, or the full published URL.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the Docs Embed widget rendering with a dark surface when the visitor's OS is in dark mode, even on a light page or a site published with a light theme. The embed script now accepts `?theme=light|dark` to force a scheme.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix suggested question clicks in the embed search not opening the assistant.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix switching from the Search tab to the Docs or Assistant tab in the embed doing nothing.
@@ -1,5 +0,0 @@
---
-"@gitbook/embed": patch
---
-
-Make the Docs Embed widget match the page it is embedded in rather than the visitor's OS: a widget on a light page stays light even when the visitor's system is in dark mode, and the widget's own chrome and the docs inside it always render in the same scheme. Sites published with a single theme impose it on the widget too, since they render in it regardless. The standalone script takes `?theme=light` on its URL, and calling `init` twice now updates the options instead of throwing.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add configurable default visibility to Prompt block
@@ -1,6 +0,0 @@
---
-"@gitbook/colors": patch
-"gitbook": patch
---
-
-A near-white tint color (e.g. a warm `#F5F3EF`) is now taken as the exact page background, mirroring the existing behavior for near-black tints. The tint's exact lightness, hue and chroma are preserved, and the color is anchored to whichever scale step the active theme renders as the background — so it matches exactly on `muted` (which uses the second step) as well as `clean`. This applies only to near-neutral tints that are light enough to read as a background; saturated or merely light-ish colors keep their normal accent scale. The `bold` theme is unaffected: it already uses the tint for the header and stays intentionally two-tone.
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Support external links in published site navigation.
@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Add circular corners and depth styling
@@ -1,7 +0,0 @@
---
-"gitbook": patch
---
-
-Introduce client-side content selection (`select`): a site-wide, recency-ordered list of selected slugs, persisted in localStorage and shareable via `?select=`, applied to `<html>` before first paint so the right variant renders with no flash. All variants stay server-rendered, so pages are byte-identical for every visitor (no cache impact).
-
-Tabs now use it: switching a tab activates its slug, and every tab group offering that slug follows, across pages. Tabs no longer write to the URL fragment (`#` returns to anchors only); deep-links into a tab still activate and scroll to it.
@@ -0,0 +1,5 @@
+---
+'@gitbook/react-openapi': patch
+---
+
+Add authorization header for OAuth2
@@ -1,7 +0,0 @@
---
-"@gitbook/openapi-parser": patch
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Add missing link reference to OpenAPI models
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Skip internal paths (`~gitbook/*`, `.well-known/oauth-protected-resource`, `llms.txt`, `robots.txt`, `sitemap.xml`, `rss.xml`) when building URL lookup alternatives, to avoid resolving URLs that can never match content.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep published search results within the selected site-space scope during local and remote result fusion.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Only advertise RSS feeds on pages with Updates blocks.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix page link titles showing the site section name instead of the target space title.
@@ -0,0 +1,6 @@
+---
+"gitbook-v2": patch
+"gitbook": patch
+---
+
+Adds Columns layout block to GBO
@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Support dark-mode specific page cover image
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve Markdown responses as plain text to OpenAI's ChatGPT Search crawler.
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Update the URL hash when a tab is selected, so a copied link scrolls back to that tab
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep links to GitBook app URLs of spaces in the same site on the site, instead of sending readers to app.gitbook.com. A link to a page that no longer exists now opens its space on the site, and its "Page not found" card says which space it opens.
@@ -0,0 +1,5 @@
+---
+"gitbook-v2": patch
+---
+
+add a force-revalidate api route to force bust the cache in case of errors
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Self-host default Google fonts and inline only the @font-face rules of the fonts a site uses, instead of shipping render-blocking stylesheets covering all 23 families on every page.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Hide heading and expandable anchor links on pages whose layout disables anchors (landing pages).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Hide card fields that render no content, along with their title
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Hide the Intercom launcher while the Assistant panel is open, so it no longer overlaps the message box.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add cover image background mode and masks
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Upgrade react-hotkeys-hook to v5 and use its native `useKey` option so keyboard shortcuts match the produced key on non-QWERTY layouts.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Button blocks now respect the `size` option, so you can render small, medium, or large buttons.
@@ -1,7 +0,0 @@
---
-"@gitbook/browser-types": patch
-"@gitbook/embed": patch
-"gitbook": patch
---
-
-Add an optional `context` property (string, up to 512 characters) to the `confirmation` of custom AI tools, shown above the confirmation dialog to help the user understand what they are approving or rejecting. The `confirmation` can now also be a function that receives the AI-provided input and returns the confirmation, so the context can be derived dynamically from the arguments the tool is about to run with. Available both to integrations (`GitBookIntegrationTool`) and to embed consumers (`GitBookToolDefinition`).
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Keep embed demos and frames on the deployment that served them.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix a hydration mismatch on every page load caused by the AI chat time-based greeting being computed in the server timezone.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Lazy-load the Mermaid code block so pages that have code blocks but no diagram no longer ship its rendering dependencies.
@@ -0,0 +1,6 @@
+---
+"gitbook-v2": patch
+"gitbook": patch
+---
+
+encode customization header
@@ -1,8 +0,0 @@
---
-"@gitbook/react-openapi": major
-"gitbook": patch
---
-
-Lazy load the Scalar API client modal and stop preloading the Scalar runtime. The modal is now code-split into its own chunk, fetched in parallel with the runtime only when a reader clicks "Test it", and a spinner is shown on the button until the client opens.
-
-Breaking: the package no longer ships the modal in its main entry — consumers must serve the emitted `ScalarApiModal` chunk and use a bundler that supports dynamic `import()`, and the Scalar runtime is no longer preloaded on page load. The internal `preloadScalarRuntime` helper is removed.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Stop preloading the zoom-modal variant of every zoomable image at render time; it downloaded each image twice during the initial page load. The modal image still loads on hover or click.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Announce pagination at the top of every part of a multi-part llms-full.txt, with absolute links to the previous and next parts.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve an indexable `X-Robots-Tag` on markdown pages requested by AI agents
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Bump `@gitbook/api` to 0.199.0, and record a markdown request made from the page actions menu as a page action rather than an agent request.
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Add an `askQuestion` tool to the site MCP server. Alongside `searchDocumentation` and `getPage`, MCP clients can now ask a natural-language question and get a synthesized answer with links to the source pages, powered by the same AI search backend as the site's "ask a question" experience. The tool accepts an optional `goal` param so calling agents can attach the intent they're trying to accomplish, which tailors the answer and is tracked in analytics. The tool is only exposed on sites that have AI enabled.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the page-actions dropdown closing before the "Copied" confirmation could be shown when copying the MCP server URL, an MCP install command, or the page as Markdown.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Submit `sendFeedback` MCP tool findings through the dedicated `submitSiteAgentFeedback` API endpoint. The `pageUrl` is now required and an optional `goal` can be provided.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Mermaid diagrams no longer hijack page scrolling: zooming with the wheel now requires holding Ctrl/Cmd inline, while the fullscreen view keeps free wheel zoom.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Migrate the headless UI primitives from Radix and react-aria to Base UI.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Persist content selection (tabs and other `select` blocks) in localStorage only, dropping the `?select=` query parameter from the URL. A tab click still writes the tab's hash, so a copied URL lands on that tab and reactivates it on load.
@@ -0,0 +1,5 @@
+---
+"gitbook-v2": patch
+---
+
+fix ISR on preview env
@@ -0,0 +1,6 @@
+---
+"gitbook-v2": patch
+"gitbook": patch
+---
+
+Fix concurrent execution in Vercel causing pages to not be attached to the proper tags.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve `X-Robots-Tag: noindex` on internal search/assistant URLs (`?q=` / `?ask=`) and stop disallowing them in robots.txt, so Google can crawl the directive and drop them from the index instead of reporting "Indexed, though blocked by robots.txt".
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Missing pages with accented or non-Latin characters in the URL now return 404 instead of an endless redirect.
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Redesign the site OAuth consent screen for published sites MCP and translate its strings
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Drop a column instead of shrinking them all when a section group dropdown runs out of room
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Let a section group dropdown scroll when it is taller than the screen
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the variant switcher linking to the wrong URL for non-default variants of the default section
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Skip the rendering work for off-screen OpenAPI blocks, so pages with many operations stay smooth to scroll.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an "On this page" table of contents on OpenAPI models pages. Each model in a grouped/multi-model "Models" section is now listed as its own section, matching operations and webhooks.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve cookie handling in the OpenAPI "Test it" request proxy.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve the OpenAPI "Test it" request proxy from GitBook's own domain.
@@ -1,6 +0,0 @@
---
-"gitbook": patch
-"@gitbook/react-openapi": minor
---
-
-Keep the OpenAPI renderer out of the initial bundle of pages that have no OpenAPI block, by building its context on the client behind a dynamic boundary.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix OpenAPI webhook payload and schema example panels being clipped instead of scrollable.
@@ -0,0 +1,5 @@
+---
+"gitbook-v2": patch
+---
+
+Generate a llms-full.txt version of the docs site
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Move paragraph block styles behind a single `paragraph` class and drop the `page-cover-background:` gate from the cover-contrast text. The gate combined with the per-paragraph `:not(:has(...))` made every DOM insertion re-style all paragraphs, which froze very long pages.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve Markdown responses to ChatGPT with a `text/plain` Content-Type for compatibility.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Preserve external page destinations returned by published search.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Use one canonical backend-ranked result set for published searches across site sections.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Preserve canonical backend ranking and present page or section context that matches each published search destination.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Align the Previous page navigation button to the left edge and the Next button to the right edge, including when only one of them is present.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Preserve the full site preview path and query parameters when redirecting users to log in.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix pages resolving to "not found" when a root URL lookup resolves to a custom homepage, by no longer using the homepage pathname as a prefix for the requested page path.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep current-space search results inside revision previews.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Prewarm published search caches when readers open the search interface.
--- a/Show More
+++ b/Show More