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.ymlindex 17cf9bc30..260a0ff56 100644--- a/.github/workflows/deploy-docs.yml+++ b/.github/workflows/deploy-docs.yml@@ -33,9 +33,6 @@ jobs:- name: Install dependenciesrun: make install- - name: Install docs dependencies- run: uv pip install -e ".[docs]"-- name: Configure git for mikerun: |git config --global user.name "github-actions[bot]"diff --git a/.github/workflows/doc-check.yml b/.github/workflows/doc-check.ymlindex 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@v7with: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 --strictdiff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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### Addeddiff --git a/docs/under-the-hood/orchestrator-plugins.md b/docs/under-the-hood/orchestrator-plugins.mdindex 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 namesThe 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.tomlindex 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.lockindex 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" },