cross-platform-test.yml

name: Cross-Platform Installation Test

on:
  workflow_dispatch:
    inputs:
      langflow-version:
        description: "Langflow version to test from PyPI (leave empty to test from source)"
        required: false
        type: string
        default: ""
  workflow_call:
    inputs:
      base-artifact-name:
        description: "Name of the base package artifact"
        required: false
        type: string
      core-artifact-name:
        description: "Name of the langflow-core package artifact"
        required: false
        type: string
      main-artifact-name:
        description: "Name of the main package artifact"
        required: false
        type: string
      lfx-artifact-name:
        description: "Name of the LFX package artifact"
        required: false
        type: string
      sdk-artifact-name:
        description: "Name of the langflow-sdk package artifact"
        required: false
        type: string
      bundles-artifact-name:
        description: "Name of the bundles package artifact (contains every src/bundles/*/ wheel)"
        required: false
        type: string
      pre_release:
        description: "Whether this is a pre-release build"
        required: false
        type: boolean
        default: false

jobs:
  build-if-needed:
    name: Build Packages (if no artifacts provided)
    runs-on: ubuntu-latest
    if: inputs.langflow-version == '' && contains(github.workflow_ref, 'cross-platform-test.yml')
    outputs:
      base-artifact-name: ${{ steps.set-names.outputs.base-artifact-name }}
      core-artifact-name: ${{ steps.set-names.outputs.core-artifact-name }}
      main-artifact-name: ${{ steps.set-names.outputs.main-artifact-name }}
      lfx-artifact-name: ${{ steps.set-names.outputs.lfx-artifact-name }}
      sdk-artifact-name: ${{ steps.set-names.outputs.sdk-artifact-name }}
      bundles-artifact-name: ${{ steps.set-names.outputs.bundles-artifact-name }}
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
      - name: Setup Environment
        uses: astral-sh/setup-uv@v6
        with:
          enable-cache: true
          cache-dependency-glob: "uv.lock"
          python-version: "3.13"
      - name: Install the project
        run: uv sync
      - name: Install frontend dependencies
        run: make install_frontendci
      - name: Build frontend
        run: make build_frontend
      - name: Build base package
        run: make build_langflow_base args="--wheel"
      - name: Move base package to correct directory
        run: |
          # Base package builds to dist/ but should be in src/backend/base/dist/
          mkdir -p src/backend/base/dist
          mv dist/langflow_base*.whl src/backend/base/dist/
      - name: Build core package
        run: make build_langflow_core args="--wheel"
      - name: Build LFX package
        run: |
          cd src/lfx
          uv build --wheel --out-dir dist
      - name: Build SDK package
        run: |
          cd src/sdk
          uv build --wheel --out-dir dist
      - name: Build main package
        run: make build_langflow args="--wheel"
      - name: Build bundle wheels
        id: build-bundles
        run: |
          shopt -s nullglob
          bundles=(src/bundles/*/pyproject.toml)
          if [ ${#bundles[@]} -eq 0 ]; then
            echo "No bundles found under src/bundles/*/"
            echo "bundles-found=0" >> $GITHUB_OUTPUT
            exit 0
          fi
          mkdir -p bundles-dist
          BUNDLES_DIST="$PWD/bundles-dist"
          for bundle_pyproject in "${bundles[@]}"; do
            bundle_dir=$(dirname "$bundle_pyproject")
            echo "Building wheel for $bundle_dir"
            (cd "$bundle_dir" && uv build --wheel --out-dir "$BUNDLES_DIST")
          done
          echo "bundles-found=1" >> $GITHUB_OUTPUT
          ls -la bundles-dist/
      - name: Upload lfx artifact
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-lfx
          path: src/lfx/dist
      - name: Upload SDK artifact
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-sdk
          path: src/sdk/dist
      - name: Upload base artifact
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-base
          path: src/backend/base/dist
      - name: Upload core artifact
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-core
          path: src/langflow-core/dist
      - name: Upload main artifact
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-main
          path: dist
      - name: Upload bundles artifact
        if: steps.build-bundles.outputs.bundles-found == '1'
        uses: actions/upload-artifact@v6
        with:
          name: adhoc-dist-bundles
          path: bundles-dist
      - name: Set artifact names
        id: set-names
        run: |
          echo "base-artifact-name=adhoc-dist-base" >> $GITHUB_OUTPUT
          echo "core-artifact-name=adhoc-dist-core" >> $GITHUB_OUTPUT
          echo "main-artifact-name=adhoc-dist-main" >> $GITHUB_OUTPUT
          echo "lfx-artifact-name=adhoc-dist-lfx" >> $GITHUB_OUTPUT
          echo "sdk-artifact-name=adhoc-dist-sdk" >> $GITHUB_OUTPUT
          if [ "${{ steps.build-bundles.outputs.bundles-found }}" = "1" ]; then
            echo "bundles-artifact-name=adhoc-dist-bundles" >> $GITHUB_OUTPUT
          else
            echo "bundles-artifact-name=" >> $GITHUB_OUTPUT
          fi

  test-installation-stable:
    name: Install & Run - ${{ matrix.os }} ${{ matrix.arch }} ${{ matrix.python-version }}
    needs: [build-if-needed]
    if: |
      always() &&
      (needs.build-if-needed.result == 'success' || needs.build-if-needed.result == 'skipped') &&
      (inputs.langflow-version != '' || inputs.main-artifact-name != '' || needs.build-if-needed.outputs.main-artifact-name != '')
    runs-on: ${{ matrix.runner }}
    strategy:
      fail-fast: false
      matrix:
        include:
          # Linux AMD64
          - os: linux
            arch: amd64
            runner: ubuntu-latest
            python-version: "3.10"
          - os: linux
            arch: amd64
            runner: ubuntu-latest
            python-version: "3.12"
          # macOS AMD64 (Intel) - Python 3.12 only for cost optimization
          - os: macos
            arch: amd64
            runner: macos-latest-large
            python-version: "3.12"
          # macOS ARM64 (Apple Silicon)
          - os: macos
            arch: arm64
            runner: macos-latest
            python-version: "3.10"
          - os: macos
            arch: arm64
            runner: macos-latest
            python-version: "3.12"
          # Windows AMD64
          - os: windows
            arch: amd64
            runner: windows-latest
            python-version: "3.10"
          - os: windows
            arch: amd64
            runner: windows-latest
            python-version: "3.12"
          # Python 3.13 - graduated from experimental to stable (blocking).
          # macOS Intel (amd64) is intentionally omitted here: like 3.10/3.12 above
          # it stays on the costly macos-latest-large runner only at 3.12. Intel
          # coverage for newer Python continues (non-blocking) in the experimental
          # 3.14 set below.
          - os: linux
            arch: amd64
            runner: ubuntu-latest
            python-version: "3.13"
          - os: macos
            arch: arm64
            runner: macos-latest
            python-version: "3.13"
          - os: windows
            arch: amd64
            runner: windows-latest
            python-version: "3.13"

    steps:
      - name: Determine install method
        id: install-method
        run: |
          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
            if [ -n "${{ inputs.langflow-version }}" ]; then
              echo "method=pypi" >> $GITHUB_OUTPUT
            else
              echo "method=wheel" >> $GITHUB_OUTPUT
            fi
          else
            # workflow_call always uses wheel method (backward compatibility)
            echo "method=wheel" >> $GITHUB_OUTPUT
          fi
        shell: bash

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ matrix.python-version }}
          architecture: ${{ matrix.arch == 'amd64' && 'x64' || matrix.arch }}

      - name: Setup UV
        uses: astral-sh/setup-uv@v6
        with:
          enable-cache: false
          ignore-empty-workdir: true

      - name: Install Protocol Buffers (macOS AMD64)
        if: matrix.os == 'macos' && matrix.arch == 'amd64'
        run: |
          if ! command -v protoc &> /dev/null; then
            brew install protobuf
          else
            echo "protoc already installed, skipping"
          fi
        shell: bash

      # Download artifacts for wheel installation
      - name: Download langflow-sdk package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.sdk-artifact-name != '' || needs.build-if-needed.outputs.sdk-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.sdk-artifact-name || needs.build-if-needed.outputs.sdk-artifact-name || 'adhoc-dist-sdk' }}
          path: ./sdk-dist

      - name: Download LFX package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.lfx-artifact-name != '' || needs.build-if-needed.outputs.lfx-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.lfx-artifact-name || needs.build-if-needed.outputs.lfx-artifact-name || 'adhoc-dist-lfx' }}
          path: ./lfx-dist

      - name: Download base package artifact
        if: steps.install-method.outputs.method == 'wheel'
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.base-artifact-name || needs.build-if-needed.outputs.base-artifact-name || 'adhoc-dist-base' }}
          path: ./base-dist

      - name: Download main package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.main-artifact-name != '' || needs.build-if-needed.outputs.main-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.main-artifact-name || needs.build-if-needed.outputs.main-artifact-name || 'adhoc-dist-main' }}
          path: ./main-dist

      - name: Download bundles package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.bundles-artifact-name != '' || needs.build-if-needed.outputs.bundles-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.bundles-artifact-name || needs.build-if-needed.outputs.bundles-artifact-name }}
          path: ./bundles-dist

      - name: Create fresh virtual environment
        run: |
          uv venv test-env --seed
        shell: bash

      - name: Install packages from wheel
        if: steps.install-method.outputs.method == 'wheel'
        run: |
          set -eo pipefail
          shopt -s nullglob

          if [ "${{ matrix.os }}" = "windows" ]; then
            PYTHON=./test-env/Scripts/python.exe
          else
            PYTHON=./test-env/bin/python
          fi

          refresh_find_links() {
            FIND_LINKS=()
            for wheel_dir in ./sdk-dist ./lfx-dist ./base-dist ./bundles-dist; do
              if [ -d "$wheel_dir" ]; then
                FIND_LINKS+=(--find-links "$wheel_dir")
              fi
            done
          }

          install_wheels() {
            label="$1"
            shift
            if [ "$#" -eq 0 ]; then
              echo "No $label wheel found"
              exit 1
            fi
            printf 'Installing %s wheel(s):\n' "$label"
            printf '%s\n' "$@"
            refresh_find_links
            # Use `if-necessary-or-explicit` (not `allow`): nightly langflow* wheels
            # are .dev pre-releases so we need to allow them explicitly, but `allow`
            # leaks to transitive deps and resolves pre-release pydantic alphas
            # (e.g. 2.14.0a1) which break langchain-core's module-level
            # `RunnablePassthrough()` call at import time.
            uv pip install --prerelease=if-necessary-or-explicit --python "$PYTHON" "${FIND_LINKS[@]}" "$@"
          }

          SDK_WHEELS=(./sdk-dist/*.whl)
          LFX_WHEELS=(./lfx-dist/*.whl)
          if [ ${#SDK_WHEELS[@]} -gt 0 ] || [ ${#LFX_WHEELS[@]} -gt 0 ]; then
            install_wheels "SDK/LFX" "${SDK_WHEELS[@]}" "${LFX_WHEELS[@]}"
          fi

          BASE_WHEELS=(./base-dist/*.whl)
          install_wheels "base" "${BASE_WHEELS[@]}"

          if [ -d ./bundles-dist ]; then
            BUNDLE_WHEELS=(./bundles-dist/*.whl)
            install_wheels "bundle" "${BUNDLE_WHEELS[@]}"
          fi

          MAIN_WHEELS=()
          while IFS= read -r wheel; do
            MAIN_WHEELS+=("$wheel")
          done < <(find ./main-dist -name "langflow*.whl" ! -name "langflow_base*.whl" -type f | sort)
          if [ ${#MAIN_WHEELS[@]} -ne 1 ]; then
            echo "Expected exactly one langflow wheel in ./main-dist, found ${#MAIN_WHEELS[@]}"
            find ./main-dist -name "*.whl" -type f | sort
            exit 1
          fi
          install_wheels "main" "${MAIN_WHEELS[@]}"
        shell: bash

      # PyPI installation steps
      - name: Install langflow from PyPI (Windows)
        if: steps.install-method.outputs.method == 'pypi' && matrix.os == 'windows'
        run: |
          if [ -n "${{ inputs.langflow-version }}" ]; then
            uv pip install --python ./test-env/Scripts/python.exe langflow==${{ inputs.langflow-version }}
          else
            uv pip install --python ./test-env/Scripts/python.exe langflow
          fi
        shell: bash

      - name: Install langflow from PyPI (Unix)
        if: steps.install-method.outputs.method == 'pypi' && matrix.os != 'windows'
        run: |
          if [ -n "${{ inputs.langflow-version }}" ]; then
            uv pip install --python ./test-env/bin/python langflow==${{ inputs.langflow-version }}
          else
            uv pip install --python ./test-env/bin/python langflow
          fi
        shell: bash

      # Install additional dependencies
      - name: Install additional dependencies (Windows)
        if: matrix.os == 'windows'
        run: |
          uv pip install --python ./test-env/Scripts/python.exe openai
        shell: bash

      - name: Install additional dependencies (Unix)
        if: matrix.os != 'windows'
        run: |
          uv pip install --python ./test-env/bin/python openai
        shell: bash

      # Test steps
      - name: Test CLI help command
        if: matrix.os == 'windows'
        run: |
          uv run --python ./test-env/Scripts/python.exe python -m langflow --help
        shell: cmd

      - name: Test CLI help command (Unix)
        if: matrix.os != 'windows'
        run: |
          uv run --python ./test-env/bin/python python -m langflow --help
        shell: bash

      - name: Test server startup (Windows)
        if: matrix.os == 'windows'
        timeout-minutes: 5
        run: |
          # Start server in background
          $serverProcess = Start-Process -FilePath ".\test-env\Scripts\python.exe" -ArgumentList "-m", "langflow", "run", "--host", "localhost", "--port", "7860", "--backend-only" -PassThru -WindowStyle Hidden

          # Wait for server to be ready (GitHub Actions will timeout after 5 minutes)
          do {
            try {
              $response = Invoke-WebRequest -Uri "http://localhost:7860/health_check" -UseBasicParsing -TimeoutSec 5
              if ($response.StatusCode -eq 200) {
                Write-Host "✅ Server is ready on ${{ matrix.os }}-${{ matrix.arch }}"
                break
              }
            } catch {
              Start-Sleep -Seconds 5
            }
          } while ($true)

          # Stop the server process
          Stop-Process -Id $serverProcess.Id -Force -ErrorAction SilentlyContinue
        shell: powershell

      - name: Test server startup (Unix)
        if: matrix.os != 'windows'
        timeout-minutes: 5
        env:
          OBJC_DISABLE_INITIALIZE_FORK_SAFETY: YES
        run: |
          # Start server in background
          ./test-env/bin/python -m langflow run --host localhost --port 7860 --backend-only &
          SERVER_PID=$!

          # Wait for server to be ready (GitHub Actions will timeout after 5 minutes)
          while true; do
            if curl -f http://localhost:7860/health_check >/dev/null 2>&1; then
              echo "✅ Server is ready on ${{ matrix.os }}-${{ matrix.arch }}"
              break
            fi
            sleep 5
          done

          # Clean shutdown
          kill $SERVER_PID 2>/dev/null || true
          sleep 5
        shell: bash

      - name: Test import in Python (Windows)
        if: matrix.os == 'windows'
        run: |
          test-env\Scripts\python.exe -c "
          try:
              import langflow
              print('✅ langflow import successful on ${{ matrix.os }}-${{ matrix.arch }}')
          except Exception as e:
              print(f'❌ langflow import failed on ${{ matrix.os }}-${{ matrix.arch }}: {e}')
              exit(1)
          "
        shell: cmd

      - name: Test import in Python (Unix)
        if: matrix.os != 'windows'
        run: |
          ./test-env/bin/python -c "
          try:
              import langflow
              print('✅ langflow import successful on ${{ matrix.os }}-${{ matrix.arch }}')
          except Exception as e:
              print(f'❌ langflow import failed on ${{ matrix.os }}-${{ matrix.arch }}: {e}')
              exit(1)
          "
        shell: bash

  test-installation-experimental:
    name: Install & Run - ${{ matrix.os }} ${{ matrix.arch }} ${{ matrix.python-version }} (Experimental)
    needs: [build-if-needed]
    if: |
      always() &&
      (needs.build-if-needed.result == 'success' || needs.build-if-needed.result == 'skipped') &&
      (inputs.langflow-version != '' || inputs.main-artifact-name != '' || needs.build-if-needed.outputs.main-artifact-name != '')
    runs-on: ${{ matrix.runner }}
    continue-on-error: true
    strategy:
      fail-fast: false
      matrix:
        include:
          # Python 3.14 - Experimental (non-blocking) to monitor ecosystem readiness.
          # macOS Intel (x86_64) is intentionally omitted: langflow requires
          # onnxruntime>=1.26 on Python >=3.14 (pyproject.toml), but onnxruntime
          # dropped macOS x86_64 wheels at 1.24 — so macOS Intel + py3.14 is
          # permanently unsatisfiable (older onnxruntime that still ships macOS
          # x86_64 wheels has no cp314 ABI). macOS Intel resolves fine through 3.13;
          # arm64 has cp314 wheels. Running it would only burn the costly
          # macos-latest-large runner on a guaranteed, no-signal failure.
          - os: linux
            arch: amd64
            runner: ubuntu-latest
            python-version: "3.14"
          - os: windows
            arch: amd64
            runner: windows-latest
            python-version: "3.14"
          - os: macos
            arch: arm64
            runner: macos-latest
            python-version: "3.14"

    steps:
      - name: Determine install method
        id: install-method
        run: |
          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
            if [ -n "${{ inputs.langflow-version }}" ]; then
              echo "method=pypi" >> $GITHUB_OUTPUT
            else
              echo "method=wheel" >> $GITHUB_OUTPUT
            fi
          else
            # workflow_call always uses wheel method (backward compatibility)
            echo "method=wheel" >> $GITHUB_OUTPUT
          fi
        shell: bash

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ matrix.python-version }}
          architecture: ${{ matrix.arch == 'amd64' && 'x64' || matrix.arch }}

      - name: Setup UV
        uses: astral-sh/setup-uv@v6
        with:
          enable-cache: false
          ignore-empty-workdir: true

      - name: Install Protocol Buffers (macOS AMD64)
        if: matrix.os == 'macos' && matrix.arch == 'amd64'
        run: |
          if ! command -v protoc &> /dev/null; then
            brew install protobuf
          else
            echo "protoc already installed, skipping"
          fi
        shell: bash

      # Download artifacts for wheel installation
      - name: Download langflow-sdk package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.sdk-artifact-name != '' || needs.build-if-needed.outputs.sdk-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.sdk-artifact-name || needs.build-if-needed.outputs.sdk-artifact-name || 'adhoc-dist-sdk' }}
          path: ./sdk-dist

      - name: Download LFX package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.lfx-artifact-name != '' || needs.build-if-needed.outputs.lfx-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.lfx-artifact-name || needs.build-if-needed.outputs.lfx-artifact-name || 'adhoc-dist-lfx' }}
          path: ./lfx-dist

      - name: Download base package artifact
        if: steps.install-method.outputs.method == 'wheel'
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.base-artifact-name || needs.build-if-needed.outputs.base-artifact-name || 'adhoc-dist-base' }}
          path: ./base-dist

      - name: Download main package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.main-artifact-name != '' || needs.build-if-needed.outputs.main-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.main-artifact-name || needs.build-if-needed.outputs.main-artifact-name || 'adhoc-dist-main' }}
          path: ./main-dist

      - name: Download bundles package artifact
        if: steps.install-method.outputs.method == 'wheel' && (inputs.bundles-artifact-name != '' || needs.build-if-needed.outputs.bundles-artifact-name != '')
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.bundles-artifact-name || needs.build-if-needed.outputs.bundles-artifact-name }}
          path: ./bundles-dist

      - name: Create fresh virtual environment
        run: |
          uv venv test-env --seed
        shell: bash

      - name: Install packages from wheel
        if: steps.install-method.outputs.method == 'wheel'
        run: |
          set -eo pipefail
          shopt -s nullglob

          if [ "${{ matrix.os }}" = "windows" ]; then
            PYTHON=./test-env/Scripts/python.exe
          else
            PYTHON=./test-env/bin/python
          fi

          refresh_find_links() {
            FIND_LINKS=()
            for wheel_dir in ./sdk-dist ./lfx-dist ./base-dist ./bundles-dist; do
              if [ -d "$wheel_dir" ]; then
                FIND_LINKS+=(--find-links "$wheel_dir")
              fi
            done
          }

          install_wheels() {
            label="$1"
            shift
            if [ "$#" -eq 0 ]; then
              echo "No $label wheel found"
              exit 1
            fi
            printf 'Installing %s wheel(s):\n' "$label"
            printf '%s\n' "$@"
            refresh_find_links
            # See stable job above for rationale on --prerelease=if-necessary-or-explicit.
            uv pip install --prerelease=if-necessary-or-explicit --python "$PYTHON" "${FIND_LINKS[@]}" "$@"
          }

          SDK_WHEELS=(./sdk-dist/*.whl)
          LFX_WHEELS=(./lfx-dist/*.whl)
          if [ ${#SDK_WHEELS[@]} -gt 0 ] || [ ${#LFX_WHEELS[@]} -gt 0 ]; then
            install_wheels "SDK/LFX" "${SDK_WHEELS[@]}" "${LFX_WHEELS[@]}"
          fi

          BASE_WHEELS=(./base-dist/*.whl)
          install_wheels "base" "${BASE_WHEELS[@]}"

          if [ -d ./bundles-dist ]; then
            BUNDLE_WHEELS=(./bundles-dist/*.whl)
            install_wheels "bundle" "${BUNDLE_WHEELS[@]}"
          fi

          MAIN_WHEELS=()
          while IFS= read -r wheel; do
            MAIN_WHEELS+=("$wheel")
          done < <(find ./main-dist -name "langflow*.whl" ! -name "langflow_base*.whl" -type f | sort)
          if [ ${#MAIN_WHEELS[@]} -ne 1 ]; then
            echo "Expected exactly one langflow wheel in ./main-dist, found ${#MAIN_WHEELS[@]}"
            find ./main-dist -name "*.whl" -type f | sort
            exit 1
          fi
          install_wheels "main" "${MAIN_WHEELS[@]}"
        shell: bash

      - name: Force reinstall local wheels to prevent downgrades (Windows)
        if: steps.install-method.outputs.method == 'wheel' && matrix.os == 'windows'
        run: |
          # Expose the local wheel dirs so dependency re-resolution (the
          # pre-release path below drops --no-deps) can find the local
          # pre-release lfx/base wheels. Without these, uv re-resolves
          # langflow-base's `lfx>=X.Y.Zrc0` constraint against PyPI only, where
          # the matching rc/dev wheel is not published yet, and fails with
          # "No solution found when resolving dependencies".
          FIND_LINKS=()
          for wheel_dir in ./sdk-dist ./lfx-dist ./base-dist ./bundles-dist; do
            if [ -d "$wheel_dir" ]; then
              FIND_LINKS+=(--find-links "$wheel_dir")
            fi
          done

          # Reinstall LFX if it was provided
          if [ -n "${{ inputs.lfx-artifact-name || needs.build-if-needed.outputs.lfx-artifact-name }}" ]; then
            LFX_WHEEL=$(find ./lfx-dist -name "*.whl" -type f | head -1)
            if [ -n "$LFX_WHEEL" ]; then
              echo "Force reinstalling LFX: $LFX_WHEEL"
              INSTALL_WHEELS=("$LFX_WHEEL")
              SDK_WHEEL=""
              if [ -d ./sdk-dist ]; then
                SDK_WHEEL=$(find ./sdk-dist -name "*.whl" -type f | head -1)
              fi
              if [ -n "$SDK_WHEEL" ]; then
                echo "Force reinstalling langflow-sdk with LFX: $SDK_WHEEL"
                INSTALL_WHEELS=("$SDK_WHEEL" "$LFX_WHEEL")
              fi
              NO_DEPS="--no-deps"
              if [ "${{ inputs.pre_release }}" = "true" ]; then
                NO_DEPS=""
              fi
              uv pip install --force-reinstall $NO_DEPS --prerelease=if-necessary-or-explicit "${FIND_LINKS[@]}" --python ./test-env/Scripts/python.exe "${INSTALL_WHEELS[@]}"
            fi
          fi

          # Reinstall base
          BASE_WHEEL=$(find ./base-dist -name "*.whl" -type f | head -1)
          if [ -n "$BASE_WHEEL" ]; then
            echo "Force reinstalling langflow-base: $BASE_WHEEL"
            INSTALL_WHEELS=("$BASE_WHEEL")
            NO_DEPS="--no-deps"
            if [ "${{ inputs.pre_release }}" = "true" ]; then
              # Keep local pre-release roots explicit while re-resolving deps. uv's
              # if-necessary-or-explicit mode does not allow pre-release transitive
              # deps found only through --find-links, such as langflow-sdk dev wheels.
              NO_DEPS=""
              LOCAL_WHEELS=()
              if [ -d ./sdk-dist ]; then
                SDK_WHEEL=$(find ./sdk-dist -name "*.whl" -type f | head -1)
                if [ -n "$SDK_WHEEL" ]; then
                  LOCAL_WHEELS+=("$SDK_WHEEL")
                fi
              fi
              if [ -d ./lfx-dist ]; then
                LFX_WHEEL=$(find ./lfx-dist -name "*.whl" -type f | head -1)
                if [ -n "$LFX_WHEEL" ]; then
                  LOCAL_WHEELS+=("$LFX_WHEEL")
                fi
              fi
              INSTALL_WHEELS=("${LOCAL_WHEELS[@]}" "$BASE_WHEEL")
            fi
            uv pip install --force-reinstall $NO_DEPS --prerelease=if-necessary-or-explicit "${FIND_LINKS[@]}" --python ./test-env/Scripts/python.exe "${INSTALL_WHEELS[@]}"
          fi
        shell: bash

      - name: Force reinstall local wheels to prevent downgrades (Unix)
        if: steps.install-method.outputs.method == 'wheel' && matrix.os != 'windows'
        run: |
          # Expose the local wheel dirs so dependency re-resolution (the
          # pre-release path below drops --no-deps) can find the local
          # pre-release lfx/base wheels. Without these, uv re-resolves
          # langflow-base's `lfx>=X.Y.Zrc0` constraint against PyPI only, where
          # the matching rc/dev wheel is not published yet, and fails with
          # "No solution found when resolving dependencies".
          FIND_LINKS=()
          for wheel_dir in ./sdk-dist ./lfx-dist ./base-dist ./bundles-dist; do
            if [ -d "$wheel_dir" ]; then
              FIND_LINKS+=(--find-links "$wheel_dir")
            fi
          done

          # Reinstall LFX if it was provided
          if [ -n "${{ inputs.lfx-artifact-name || needs.build-if-needed.outputs.lfx-artifact-name }}" ]; then
            LFX_WHEEL=$(find ./lfx-dist -name "*.whl" -type f | head -1)
            if [ -n "$LFX_WHEEL" ]; then
              echo "Force reinstalling LFX: $LFX_WHEEL"
              INSTALL_WHEELS=("$LFX_WHEEL")
              SDK_WHEEL=""
              if [ -d ./sdk-dist ]; then
                SDK_WHEEL=$(find ./sdk-dist -name "*.whl" -type f | head -1)
              fi
              if [ -n "$SDK_WHEEL" ]; then
                echo "Force reinstalling langflow-sdk with LFX: $SDK_WHEEL"
                INSTALL_WHEELS=("$SDK_WHEEL" "$LFX_WHEEL")
              fi
              NO_DEPS="--no-deps"
              if [ "${{ inputs.pre_release }}" = "true" ]; then
                NO_DEPS=""
              fi
              uv pip install --force-reinstall $NO_DEPS --prerelease=if-necessary-or-explicit "${FIND_LINKS[@]}" --python ./test-env/bin/python "${INSTALL_WHEELS[@]}"
            fi
          fi

          # Reinstall base
          BASE_WHEEL=$(find ./base-dist -name "*.whl" -type f | head -1)
          if [ -n "$BASE_WHEEL" ]; then
            echo "Force reinstalling langflow-base: $BASE_WHEEL"
            INSTALL_WHEELS=("$BASE_WHEEL")
            NO_DEPS="--no-deps"
            if [ "${{ inputs.pre_release }}" = "true" ]; then
              # Keep local pre-release roots explicit while re-resolving deps. uv's
              # if-necessary-or-explicit mode does not allow pre-release transitive
              # deps found only through --find-links, such as langflow-sdk dev wheels.
              NO_DEPS=""
              LOCAL_WHEELS=()
              if [ -d ./sdk-dist ]; then
                SDK_WHEEL=$(find ./sdk-dist -name "*.whl" -type f | head -1)
                if [ -n "$SDK_WHEEL" ]; then
                  LOCAL_WHEELS+=("$SDK_WHEEL")
                fi
              fi
              if [ -d ./lfx-dist ]; then
                LFX_WHEEL=$(find ./lfx-dist -name "*.whl" -type f | head -1)
                if [ -n "$LFX_WHEEL" ]; then
                  LOCAL_WHEELS+=("$LFX_WHEEL")
                fi
              fi
              INSTALL_WHEELS=("${LOCAL_WHEELS[@]}" "$BASE_WHEEL")
            fi
            uv pip install --force-reinstall $NO_DEPS --prerelease=if-necessary-or-explicit "${FIND_LINKS[@]}" --python ./test-env/bin/python "${INSTALL_WHEELS[@]}"
          fi
        shell: bash

      # PyPI installation steps
      - name: Install langflow from PyPI (Windows)
        if: steps.install-method.outputs.method == 'pypi' && matrix.os == 'windows'
        run: |
          if [ -n "${{ inputs.langflow-version }}" ]; then
            uv pip install --python ./test-env/Scripts/python.exe langflow==${{ inputs.langflow-version }}
          else
            uv pip install --python ./test-env/Scripts/python.exe langflow
          fi
        shell: bash

      - name: Install langflow from PyPI (Unix)
        if: steps.install-method.outputs.method == 'pypi' && matrix.os != 'windows'
        run: |
          if [ -n "${{ inputs.langflow-version }}" ]; then
            uv pip install --python ./test-env/bin/python langflow==${{ inputs.langflow-version }}
          else
            uv pip install --python ./test-env/bin/python langflow
          fi
        shell: bash

      # Install additional dependencies
      - name: Install additional dependencies (Windows)
        if: matrix.os == 'windows'
        run: |
          uv pip install --python ./test-env/Scripts/python.exe openai
        shell: bash

      - name: Install additional dependencies (Unix)
        if: matrix.os != 'windows'
        run: |
          uv pip install --python ./test-env/bin/python openai
        shell: bash

      # Test steps
      - name: Test CLI help command (Windows)
        if: matrix.os == 'windows'
        run: |
          uv run --python ./test-env/Scripts/python.exe python -m langflow --help
        shell: cmd

      - name: Test CLI help command (Unix)
        if: matrix.os != 'windows'
        run: |
          uv run --python ./test-env/bin/python python -m langflow --help
        shell: bash

      - name: Test server startup (Windows)
        if: matrix.os == 'windows'
        timeout-minutes: 5
        run: |
          # Start server in background
          $serverProcess = Start-Process -FilePath ".\test-env\Scripts\python.exe" -ArgumentList "-m", "langflow", "run", "--host", "localhost", "--port", "7860", "--backend-only" -PassThru -WindowStyle Hidden

          # Wait for server to be ready (GitHub Actions will timeout after 5 minutes)
          do {
            try {
              $response = Invoke-WebRequest -Uri "http://localhost:7860/health_check" -UseBasicParsing -TimeoutSec 5
              if ($response.StatusCode -eq 200) {
                Write-Host "✅ Server is ready on ${{ matrix.os }}-${{ matrix.arch }}"
                break
              }
            } catch {
              Start-Sleep -Seconds 5
            }
          } while ($true)

          # Stop the server process
          Stop-Process -Id $serverProcess.Id -Force -ErrorAction SilentlyContinue
        shell: powershell

      - name: Test server startup (Unix)
        if: matrix.os != 'windows'
        timeout-minutes: 5
        env:
          OBJC_DISABLE_INITIALIZE_FORK_SAFETY: YES
        run: |
          # Start server in background
          ./test-env/bin/python -m langflow run --host localhost --port 7860 --backend-only &
          SERVER_PID=$!

          # Wait for server to be ready (GitHub Actions will timeout after 5 minutes)
          while true; do
            if curl -f http://localhost:7860/health_check >/dev/null 2>&1; then
              echo "✅ Server is ready on ${{ matrix.os }}-${{ matrix.arch }}"
              break
            fi
            sleep 5
          done

          # Clean shutdown
          kill $SERVER_PID 2>/dev/null || true
          sleep 5
        shell: bash

      - name: Test import in Python (Windows)
        if: matrix.os == 'windows'
        run: |
          test-env\Scripts\python.exe -c "
          try:
              import langflow
              print('✅ langflow import successful on ${{ matrix.os }}-${{ matrix.arch }}')
          except Exception as e:
              print(f'❌ langflow import failed on ${{ matrix.os }}-${{ matrix.arch }}: {e}')
              exit(1)
          "
        shell: cmd

      - name: Test import in Python (Unix)
        if: matrix.os != 'windows'
        run: |
          ./test-env/bin/python -c "
          try:
              import langflow
              print('✅ langflow import successful on ${{ matrix.os }}-${{ matrix.arch }}')
          except Exception as e:
              print(f'❌ langflow import failed on ${{ matrix.os }}-${{ matrix.arch }}: {e}')
              exit(1)
          "
        shell: bash

  test-core-runtime:
    name: Core Distribution Wheel - Linux Python 3.14
    needs: [build-if-needed]
    if: |
      always() &&
      inputs.langflow-version == '' &&
      (needs.build-if-needed.result == 'success' || needs.build-if-needed.result == 'skipped') &&
      (inputs.base-artifact-name != '' || inputs.core-artifact-name != '' ||
       needs.build-if-needed.outputs.base-artifact-name != '' ||
       needs.build-if-needed.outputs.core-artifact-name != '')
    runs-on: ubuntu-latest
    steps:
      - name: Setup UV
        uses: astral-sh/setup-uv@v6
        with:
          enable-cache: false
          python-version: "3.14"

      - name: Download langflow-sdk package artifact
        if: inputs.sdk-artifact-name != '' || needs.build-if-needed.outputs.sdk-artifact-name != ''
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.sdk-artifact-name || needs.build-if-needed.outputs.sdk-artifact-name || 'adhoc-dist-sdk' }}
          path: ./sdk-dist

      - name: Download LFX package artifact
        if: inputs.lfx-artifact-name != '' || needs.build-if-needed.outputs.lfx-artifact-name != ''
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.lfx-artifact-name || needs.build-if-needed.outputs.lfx-artifact-name || 'adhoc-dist-lfx' }}
          path: ./lfx-dist

      - name: Download base package artifact
        if: inputs.base-artifact-name != '' || needs.build-if-needed.outputs.base-artifact-name != ''
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.base-artifact-name || needs.build-if-needed.outputs.base-artifact-name || 'adhoc-dist-base' }}
          path: ./base-dist

      - name: Download langflow-core package artifact
        if: inputs.core-artifact-name != '' || needs.build-if-needed.outputs.core-artifact-name != ''
        uses: actions/download-artifact@v7
        with:
          name: ${{ inputs.core-artifact-name || needs.build-if-needed.outputs.core-artifact-name || 'adhoc-dist-core' }}
          path: ./core-dist

      - name: Install only core wheels
        shell: bash
        run: |
          set -euo pipefail
          shopt -s nullglob

          SDK_WHEELS=(./sdk-dist/*.whl)
          LFX_WHEELS=(./lfx-dist/*.whl)
          BASE_WHEELS=(./base-dist/*.whl)
          CORE_WHEELS=(./core-dist/*.whl)
          [ ${#SDK_WHEELS[@]} -le 1 ] || { echo "Expected at most one SDK wheel, found ${#SDK_WHEELS[@]}"; exit 1; }
          [ ${#LFX_WHEELS[@]} -le 1 ] || { echo "Expected at most one LFX wheel, found ${#LFX_WHEELS[@]}"; exit 1; }
          [ ${#BASE_WHEELS[@]} -le 1 ] || { echo "Expected at most one base wheel, found ${#BASE_WHEELS[@]}"; exit 1; }
          [ ${#CORE_WHEELS[@]} -le 1 ] || { echo "Expected at most one core wheel, found ${#CORE_WHEELS[@]}"; exit 1; }

          FIND_LINKS=()
          for directory in sdk-dist lfx-dist base-dist core-dist; do
            if [ -d "$directory" ]; then
              FIND_LINKS+=(--find-links "./$directory")
            fi
          done
          if [ ${#CORE_WHEELS[@]} -eq 1 ]; then
            INSTALL_ROOTS=("${CORE_WHEELS[0]}")
            echo "EXPECT_LANGFLOW_CORE=true" >> "$GITHUB_ENV"
          elif [ ${#BASE_WHEELS[@]} -eq 1 ]; then
            INSTALL_ROOTS=("${BASE_WHEELS[0]}")
            echo "EXPECT_LANGFLOW_CORE=false" >> "$GITHUB_ENV"
          else
            echo "A base or langflow-core wheel is required for the core runtime test."
            exit 1
          fi

          uv venv core-test-env --seed --python 3.14
          uv pip install --python core-test-env/bin/python \
            --prerelease=if-necessary-or-explicit \
            "${FIND_LINKS[@]}" "${SDK_WHEELS[@]}" "${LFX_WHEELS[@]}" "${INSTALL_ROOTS[@]}"
          uv pip check --python core-test-env/bin/python

      - name: Verify core boundary and indexed imports
        shell: bash
        run: |
          core-test-env/bin/python - <<'PY'
          import importlib
          import os
          import re
          from importlib.metadata import distributions, entry_points

          from lfx.interface.components import _read_component_index

          normalize = lambda value: re.sub(r"[-_.]+", "-", value).lower()
          installed = {normalize(dist.metadata["Name"]) for dist in distributions() if dist.metadata["Name"]}
          assert {"langflow-base", "langflow-sdk", "lfx"} <= installed, installed
          assert "langflow" not in installed, installed
          if os.environ["EXPECT_LANGFLOW_CORE"] == "true":
              assert "langflow-core" in installed, installed
          else:
              assert "langflow-core" not in installed, installed
          extensions = sorted(name for name in installed if name.startswith("lfx-"))
          assert not extensions, f"Extension distributions installed: {extensions}"
          for group in ("lfx.bundles", "langflow.extensions", "langflow.plugins"):
              assert not entry_points(group=group), f"Extension entry points registered in {group}"

          index = _read_component_index()
          assert index is not None, "Installed LFX rejected its bundled component index"
          assert index["metadata"] == {"num_modules": 17, "num_components": 130}
          for category, components in index["entries"]:
              for component_name, component in components.items():
                  module_path = component.get("metadata", {}).get("module")
                  assert module_path, f"{category}.{component_name} has no module"
                  module_name, class_name = module_path.rsplit(".", 1)
                  getattr(importlib.import_module(module_name), class_name)
          PY

      - name: Boot installed core server
        shell: bash
        timeout-minutes: 5
        run: |
          set -euo pipefail
          RUNTIME_DIR=$(mktemp -d)
          export LANGFLOW_CONFIG_DIR="$RUNTIME_DIR/config"
          export LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true
          export LANGFLOW_AUTO_LOGIN=true
          export DO_NOT_TRACK=true
          LOG_FILE="$RUNTIME_DIR/server.log"

          if [ "$EXPECT_LANGFLOW_CORE" = "true" ]; then
            LANGFLOW_CLI=core-test-env/bin/langflow
          else
            LANGFLOW_CLI=core-test-env/bin/langflow-base
          fi
          "$LANGFLOW_CLI" run \
            --host 127.0.0.1 --port 7861 --backend-only --workers 1 >"$LOG_FILE" 2>&1 &
          SERVER_PID=$!
          cleanup() {
            kill "$SERVER_PID" 2>/dev/null || true
            wait "$SERVER_PID" 2>/dev/null || true
          }
          trap cleanup EXIT

          READY=false
          for _ in $(seq 1 90); do
            if curl -fsS http://127.0.0.1:7861/health_check >/dev/null 2>&1; then
              READY=true
              break
            fi
            if ! kill -0 "$SERVER_PID" 2>/dev/null; then
              cat "$LOG_FILE"
              exit 1
            fi
            sleep 2
          done
          if [ "$READY" != true ]; then
            cat "$LOG_FILE"
            exit 1
          fi

          curl -fsS -c "$RUNTIME_DIR/cookies" http://127.0.0.1:7861/api/v1/auto_login >/dev/null
          curl -fsS --compressed -b "$RUNTIME_DIR/cookies" \
            http://127.0.0.1:7861/api/v1/all >"$RUNTIME_DIR/catalog.json"
          jq -e 'del(.component_display_names) | (length == 17 and ([.[] | length] | add) == 130)' \
            "$RUNTIME_DIR/catalog.json"

  test-summary:
    name: Cross-Platform Test Summary
    needs: [test-installation-stable, test-installation-experimental, test-core-runtime]
    runs-on: ubuntu-latest
    if: always()
    steps:
      - name: Check test results
        run: |
          stable_result="${{ needs.test-installation-stable.result }}"
          experimental_result="${{ needs.test-installation-experimental.result }}"
          core_result="${{ needs.test-core-runtime.result }}"

          echo "Stable platforms result: $stable_result"
          echo "Experimental platforms result: $experimental_result"
          echo "Core runtime result: $core_result"

          if [ "$stable_result" = "skipped" ] && [ "$core_result" = "skipped" ]; then
            echo "✅ No Langflow application distribution was selected; package build tests passed"
            exit 0
          fi

          if [ "${{ inputs.langflow-version }}" = "" ] && [ "$core_result" != "success" ]; then
            echo "❌ Core runtime wheel test failed: $core_result"
            exit 1
          fi

          if [ "$stable_result" = "skipped" ] && [ "$core_result" = "success" ]; then
            echo "✅ Core-only wheel installation tests passed"
            exit 0
          fi

          # Stable platforms must succeed, experimental can fail
          if [ "$stable_result" = "success" ]; then
            if [ "$experimental_result" = "success" ]; then
              if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
                if [ -n "${{ inputs.langflow-version }}" ]; then
                  echo "✅ All PyPI installation tests passed (including Python 3.14)"
                else
                  echo "✅ All source build and installation tests passed (including Python 3.14)"
                fi
              else
                echo "✅ All cross-platform tests passed - PyPI upload can proceed"
              fi
            else
              if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
                if [ -n "${{ inputs.langflow-version }}" ]; then
                  echo "✅ PyPI installation tests passed (Python 3.14 experimental failures are acceptable)"
                else
                  echo "✅ Source build and installation tests passed (Python 3.14 experimental failures are acceptable)"
                fi
              else
                echo "✅ Cross-platform tests passed - Python 3.14 experimental failures are acceptable - PyPI upload can proceed"
              fi
            fi
          elif [ "$stable_result" = "failure" ]; then
            echo "❌ Critical platform tests failed - blocking release"
            echo "Stable platforms (Python 3.10, 3.12, 3.13) must pass for release"
            exit 1
          elif [ "$stable_result" = "cancelled" ]; then
            echo "❌ Critical platform tests were cancelled"
            exit 1
          else
            echo "❌ Critical platform tests were skipped unexpectedly"
            exit 1
          fi