Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

fix/Mkdocs-material-xss · L-260914-74a2a7 (#1201)

Louis Choquele1bd46d324cd
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 17cf9bc30..260a0ff56 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -33,9 +33,6 @@ jobs:
- name: Install dependencies
run: make install
- - name: Install docs dependencies
- run: uv pip install -e ".[docs]"
-
- name: Configure git for mike
run: |
git config --global user.name "github-actions[bot]"
diff --git a/.github/workflows/doc-check.yml b/.github/workflows/doc-check.yml
index 088d26ee3..93959944f 100644
--- a/.github/workflows/doc-check.yml
+++ b/.github/workflows/doc-check.yml
@@ -17,6 +17,9 @@ jobs:
docs:
- 'docs/**'
- 'mkdocs.yml'
+ - 'pyproject.toml'
+ - 'uv.lock'
+ - '.github/workflows/doc-check.yml'
doc-check:
needs: check-changes
@@ -25,16 +28,16 @@ jobs:
steps:
- uses: actions/checkout@v4
- - name: Set up Python
- uses: actions/setup-python@v5
+ - name: Install uv (with cache)
+ uses: astral-sh/setup-uv@v7
with:
python-version: '3.11'
- cache: 'pip'
+ enable-cache: true
+ cache-dependency-glob: "uv.lock"
- - name: Install mkdocs
- run: |
- python -m pip install --upgrade pip
- pip install mkdocs==1.6.1 mkdocs-material==9.6.14 mkdocs-glightbox==0.4.0 mkdocs-meta-manager==1.1.0 mkdocs-redirects==1.2.2 "mkdocs-llmstxt-md>=0.2.0"
+ # The docs toolchain comes from uv.lock, the same resolution the deploy builds with.
+ - name: Install docs dependencies
+ run: uv sync --frozen --no-install-project --extra docs
- name: Check documentation build
- run: mkdocs build --strict
+ run: uv run --no-sync mkdocs build --strict
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3a92451f0..8e2c5f909 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
# Changelog
+## [Unreleased]
+
+### Security
+
+- **Docs site built on mkdocs-material 9.7.7**: the `docs` extra now requires `mkdocs-material>=9.7.7`, which closes a DOM XSS in the theme's search suggestions (GHSA-xvg9-69gf-fjrf) that the published site shipped. The pull-request documentation check now builds from `uv.lock` like the deploy does, instead of from its own hand-pinned theme versions.
+
## [v0.57.0] - 2026-09-07
### Added
diff --git a/docs/under-the-hood/orchestrator-plugins.md b/docs/under-the-hood/orchestrator-plugins.md
index 8fc1a7c07..2638eabf8 100644
--- a/docs/under-the-hood/orchestrator-plugins.md
+++ b/docs/under-the-hood/orchestrator-plugins.md
@@ -26,7 +26,7 @@ An **orchestrator** is what knows how to run a pipe under one token. Core names
The registry is built once at boot from whatever the discovered plugins contributed (`build_registrar` → `OrchestratorRegistry` on the hub). There is no `match orchestration_mode:` anywhere in the bridge — the token set is open, so validation is the registry lookup itself; adding a mode's behavior means registering an orchestrator for its token, nothing in core changes.
-The *port* — `OrchestratorProtocol` and its registry — is kernel-layer, and the registry is set on the `RuntimeHub`. An orchestrator *adapter* is not: constructing one names the method interpreter, so the built-in `direct` one lives in `pipelex/interpreter_plugins/` rather than beside the inference plugins. An out-of-tree plugin makes the same split explicit instead of by directory: it declares its layer through the entry-point group it publishes under, and an orchestrator plugin therefore belongs in `pipelex.plugins.interpreter` ([below](#shipping-it-as-an-out-of-tree-plugin)). See [Hub layering](../contribute/hub-layering.md#where-the-built-in-plugins-split).
+The *port* — `OrchestratorProtocol` and its registry — is kernel-layer, and the registry is set on the `RuntimeHub`. An orchestrator *adapter* is not: constructing one names the method interpreter, so the built-in `direct` one lives in `pipelex/interpreter_plugins/` rather than beside the inference plugins. An out-of-tree plugin makes the same split explicit instead of by directory: it declares its layer through the entry-point group it publishes under, and an orchestrator plugin therefore belongs in `pipelex.plugins.interpreter` ([below](#authoring-an-out-of-tree-orchestrator-plugin)). See [Hub layering](../contribute/hub-layering.md#where-the-built-in-plugins-split).
!!! note "Open seam, closed host-side entry"
Pipelex's own host-side entry — the bridge entry point and `PipeJob` builder, plus the dispatch primitives that decode the boundary payload, scope the per-call library, and deliver results — is **not part of open core**: it backs a Pipelex [commercial capability](https://pipelex.com/products#durable-execution). What stays **open** is the seam you extend to run pipes on an orchestrator of your own: the orchestrator registry, `OrchestratorProtocol`, and the `pipelex.runtime_bridge` modules listed in [The Orchestrator SPI](#the-orchestrator-spi) below.
diff --git a/pyproject.toml b/pyproject.toml
index fde6a5509..09a5b71d6 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -102,7 +102,7 @@ docs = [
"mike>=2.1.3",
"mkdocs>=1.6.1",
"mkdocs-glightbox>=0.4.0",
- "mkdocs-material>=9.6.14",
+ "mkdocs-material>=9.7.7",
"mkdocs-meta-manager>=1.1.0",
"mkdocs-redirects==1.2.2",
"mkdocs-llmstxt-md>=0.2.0",
diff --git a/uv.lock b/uv.lock
index acaa89e87..a101972f6 100644
--- a/uv.lock
+++ b/uv.lock
@@ -2368,7 +2368,7 @@ wheels = [
[[package]]
name = "mkdocs-material"
-version = "9.7.6"
+version = "9.7.7"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "babel" },
@@ -2383,9 +2383,9 @@ dependencies = [
{ name = "pymdown-extensions" },
{ name = "requests" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/45/29/6d2bcf41ae40802c4beda2432396fff97b8456fb496371d1bc7aad6512ec/mkdocs_material-9.7.6.tar.gz", hash = "sha256:00bdde50574f776d328b1862fe65daeaf581ec309bd150f7bff345a098c64a69", size = 4097959, upload-time = "2026-03-19T15:41:58.161Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f1/cd/c05d3a530ba7934f144fb45f7203cd236adc25c7bdcc34673d202f4b0278/mkdocs_material-9.7.7.tar.gz", hash = "sha256:c0649c065b1b0512d60aad8c10f947f8e455284475239b364b610f2deb4d0855", size = 4097923, upload-time = "2026-07-17T16:21:33.156Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/2c/01/bc663630c510822c95c47a66af9fa7a443c295b47d5f041e5e6ae62ef659/mkdocs_material-9.7.6-py3-none-any.whl", hash = "sha256:71b84353921b8ea1ba84fe11c50912cc512da8fe0881038fcc9a0761c0e635ba", size = 9305470, upload-time = "2026-03-19T15:41:55.217Z" },
+ { url = "https://files.pythonhosted.org/packages/ad/21/17c1bc9e6f47c972ad66fb2ac2568f99f90f1207eeb6fc3b34d094dba7b5/mkdocs_material-9.7.7-py3-none-any.whl", hash = "sha256:8ea9bb1737a5b524a5f9dcf2e1b4ebda8274ae3008aa7845720a97083bef708f", size = 9305438, upload-time = "2026-07-17T16:21:30.017Z" },
]
[[package]]
@@ -3468,7 +3468,7 @@ requires-dist = [
{ name = "mkdocs", marker = "extra == 'docs'", specifier = ">=1.6.1" },
{ name = "mkdocs-glightbox", marker = "extra == 'docs'", specifier = ">=0.4.0" },
{ name = "mkdocs-llmstxt-md", marker = "extra == 'docs'", specifier = ">=0.2.0" },
- { name = "mkdocs-material", marker = "extra == 'docs'", specifier = ">=9.6.14" },
+ { name = "mkdocs-material", marker = "extra == 'docs'", specifier = ">=9.7.7" },
{ name = "mkdocs-meta-manager", marker = "extra == 'docs'", specifier = ">=1.1.0" },
{ name = "mkdocs-redirects", marker = "extra == 'docs'", specifier = "==1.2.2" },
{ name = "moto", extras = ["dynamodb", "s3"], marker = "extra == 'dev'", specifier = ">=5.0.0" },