From 37c8a5059faa0a1ea9bb08d55f264e795b033166 Mon Sep 17 00:00:00 2001
From: Nick Hollon <nick.hollon@langchain.dev>
Date: Fri, 1 May 2026 15:06:22 -0400
Subject: [PATCH] ci(infra): opt-in `allow-prereleases` flag for wheel-install
 steps (#37141)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Summary

The release pipeline's two \`uv pip install dist/*.whl\` calls fail when
the released package depends on a langgraph alpha that itself has
transitive prerelease deps. uv's default \`if-necessary-or-explicit\`
mode allows prereleases for first-party explicit markers (the wheel's
own deps) but rejects transitive ones, so the install fails on the wheel
— even when the wheel itself names an explicit prerelease for the
immediate dependency.

Add a workflow input \`allow-prereleases\` (default \`false\`, on both
\`workflow_call\` and \`workflow_dispatch\` triggers). When true, both
install steps pass \`--prerelease=allow\`. When false (the default),
behavior is unchanged.

The existing \`check_prerelease_dependencies.py\` step still gates
stable releases against accidentally-pinned prerelease deps.
---
 .github/workflows/_release.yml | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/_release.yml b/.github/workflows/_release.yml
index 94fe0e35559..dee8d7f83c4 100644
--- a/.github/workflows/_release.yml
+++ b/.github/workflows/_release.yml
@@ -26,6 +26,14 @@ on:
         required: true
         type: string
         description: "From which folder this pipeline executes"
+      allow-prereleases:
+        required: false
+        type: boolean
+        default: false
+        description: "Pass `--prerelease=allow` to wheel-install steps so
+          transitive prerelease deps (e.g. langgraph-checkpoint>=4.1.0a3 pulled
+          in by an alpha langgraph) resolve. Use only when the release itself
+          is a prerelease and at least one dep is also a prerelease."
   workflow_dispatch:
     inputs:
       working-directory:
@@ -74,6 +82,14 @@ on:
         type: boolean
         default: false
         description: "Release from a non-master branch (danger!) - Only use for hotfixes"
+      allow-prereleases:
+        required: false
+        type: boolean
+        default: false
+        description: "Pass `--prerelease=allow` to wheel-install steps so
+          transitive prerelease deps (e.g. langgraph-checkpoint>=4.1.0a3 pulled
+          in by an alpha langgraph) resolve. Use only when the release itself
+          is a prerelease and at least one dep is also a prerelease."
 
 env:
   PYTHON_VERSION: "3.11"
@@ -333,10 +349,15 @@ jobs:
         env:
           PKG_NAME: ${{ needs.build.outputs.pkg-name }}
           VERSION: ${{ needs.build.outputs.version }}
-        # Install directly from the locally-built wheel (no index resolution needed)
+          PRERELEASE_FLAG: ${{ inputs.allow-prereleases && '--prerelease=allow' || '' }}
+        # Install directly from the locally-built wheel (no index resolution needed).
+        # `PRERELEASE_FLAG` is empty by default; opt-in via the `allow-prereleases`
+        # workflow input lets transitive prerelease deps resolve during alpha
+        # release cycles. Stable-release safety is still enforced by the
+        # `Check for prerelease versions` step below.
         run: |
           uv venv
-          VIRTUAL_ENV=.venv uv pip install dist/*.whl
+          VIRTUAL_ENV=.venv uv pip install $PRERELEASE_FLAG dist/*.whl
 
           # Replace all dashes in the package name with underscores,
           # since that's how Python imports packages with dashes in the name.
@@ -356,8 +377,9 @@ jobs:
         env:
           PKG_NAME: ${{ needs.build.outputs.pkg-name }}
           VERSION: ${{ needs.build.outputs.version }}
+          PRERELEASE_FLAG: ${{ inputs.allow-prereleases && '--prerelease=allow' || '' }}
         run: |
-          VIRTUAL_ENV=.venv uv pip install dist/*.whl
+          VIRTUAL_ENV=.venv uv pip install $PRERELEASE_FLAG dist/*.whl
 
       - name: Check for prerelease versions
         # Block release if any dependencies allow prerelease versions