fix(ci): restore legacy docs deployment (#1798)

Author: rektdeckard

.github/workflows/publish-docs.yml

@@ -23,29 +23,36 @@ jobs:
 
       - name: Create and activate virtual environment
         run: |
-          python -m venv venv
-          source venv/bin/activate
+          python -m venv .venv
+          source .venv/bin/activate
 
       - name: Install pdoc and other dependencies
         run: |
-          source venv/bin/activate
+          source .venv/bin/activate
           python -m pip install pdoc3 setuptools
 
       - name: Install package
         run: |
-          source venv/bin/activate
+          source .venv/bin/activate
           pip install ./livekit-agents
           ./livekit-plugins/install_local.sh
 
       - name: Build Docs
         run: |
-          source venv/bin/activate
+          source .venv/bin/activate
           python -m pdoc --skip-errors --html livekit --output-dir docs
 
       - name: S3 Upload
         run: |
-          source venv/bin/activate
-          aws s3 cp docs/ s3://livekit-docs/python --recursive
+          source .venv/bin/activate
+          BRANCH="${GITHUB_REF#refs/heads/}"
+          # If branch is main, upload to /v1
+          if [[ $BRANCH == "main" ]]; then
+            aws s3 cp docs/ s3://livekit-docs/python/v1 --recursive
+          # Else, upload to root, preserving the v1 directory
+          else
+            aws s3 sync docs/ s3://livekit-docs/python --exclude "v1/*" --delete
+          fi
         env:
           AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }}
           AWS_SECRET_ACCESS_KEY: ${{ secrets.DOCS_DEPLOY_AWS_API_SECRET }}

livekit-plugins/install_local.sh

@@ -7,20 +7,21 @@ SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 pip install \
   "${SCRIPT_DIR}/livekit-plugins-anthropic" \
   "${SCRIPT_DIR}/livekit-plugins-assemblyai" \
+  "${SCRIPT_DIR}/livekit-plugins-aws" \
   "${SCRIPT_DIR}/livekit-plugins-azure" \
   "${SCRIPT_DIR}/livekit-plugins-cartesia" \
+  "${SCRIPT_DIR}/livekit-plugins-clova" \
   "${SCRIPT_DIR}/livekit-plugins-deepgram" \
   "${SCRIPT_DIR}/livekit-plugins-elevenlabs" \
   "${SCRIPT_DIR}/livekit-plugins-fal" \
   "${SCRIPT_DIR}/livekit-plugins-google" \
   "${SCRIPT_DIR}/livekit-plugins-llama-index" \
+  "${SCRIPT_DIR}/livekit-plugins-neuphonic" \
   "${SCRIPT_DIR}/livekit-plugins-nltk" \
   "${SCRIPT_DIR}/livekit-plugins-openai" \
-  "${SCRIPT_DIR}/livekit-plugins-rag" \
   "${SCRIPT_DIR}/livekit-plugins-playai" \
-  "${SCRIPT_DIR}/livekit-plugins-silero" \
-  "${SCRIPT_DIR}/livekit-plugins-turn-detector" \
+  "${SCRIPT_DIR}/livekit-plugins-rag" \
   "${SCRIPT_DIR}/livekit-plugins-rime" \
-  "${SCRIPT_DIR}/livekit-plugins-aws" \
+  "${SCRIPT_DIR}/livekit-plugins-silero" \
   "${SCRIPT_DIR}/livekit-plugins-speechmatics" \
-  "${SCRIPT_DIR}/livekit-plugins-neuphonic"
+  "${SCRIPT_DIR}/livekit-plugins-turn-detector"