Merge branch 'main' into add-api-ref-to-nav

Author: beran-t

.github/workflows/sdk-reference-generator-test.yml

@@ -4,6 +4,11 @@ on:
     pull_request:
         paths:
             - "sdk-reference-generator/**"
+            - ".github/workflows/sdk-reference-sync.yml"
+            - ".github/workflows/sdk-reference-generator-test.yml"
+            - "requirements.txt"
+            - "docs.json"
+            - "docs/sdk-reference/**"
 
 jobs:
     test:

.github/workflows/sdk-reference-sync.yml

@@ -26,6 +26,12 @@ on:
 
   repository_dispatch:
     types: [sdk-release]
+  schedule:
+    - cron: "*/15 * * * *"
+
+permissions:
+  contents: write
+  pull-requests: write
 
 # prevent concurrent runs that could conflict
 concurrency:
@@ -36,13 +42,19 @@ jobs:
   generate:
     runs-on: ubuntu-latest
     timeout-minutes: 30
-    permissions:
-      contents: write
 
     steps:
+      - name: Generate GitHub App installation token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ vars.AUTOFIXER_APP_ID }}
+          private-key: ${{ secrets.AUTOFIXER_APP_SECRET }}
+
       - name: Checkout docs repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
+          token: ${{ steps.app-token.outputs.token }}
           fetch-depth: 0
 
       - name: Setup Node.js
@@ -78,7 +90,7 @@ jobs:
       - name: Install Python dependencies
         run: pip install -r requirements.txt
 
-      - name: Determine SDK and Version
+      - name: Resolve generation inputs from trigger
         id: params
         env:
           EVENT_NAME: ${{ github.event_name }}
@@ -89,23 +101,7 @@ jobs:
           PAYLOAD_SDK: ${{ github.event.client_payload.sdk }}
           PAYLOAD_VERSION: ${{ github.event.client_payload.version }}
           PAYLOAD_LIMIT: ${{ github.event.client_payload.limit }}
-        run: |
-          if [[ "$EVENT_NAME" == "workflow_dispatch" ]]; then
-            SDK="$INPUT_SDK"
-            VERSION="$INPUT_VERSION"
-            LIMIT="$INPUT_LIMIT"
-            FORCE="$INPUT_FORCE"
-          elif [[ "$EVENT_NAME" == "repository_dispatch" ]]; then
-            SDK="$PAYLOAD_SDK"
-            VERSION="${PAYLOAD_VERSION:-latest}"
-            LIMIT="${PAYLOAD_LIMIT:-5}"
-            FORCE="false"
-          fi
-
-          echo "sdk=${SDK:-all}" >> $GITHUB_OUTPUT
-          echo "version=${VERSION:-latest}" >> $GITHUB_OUTPUT
-          echo "limit=${LIMIT:-5}" >> $GITHUB_OUTPUT
-          echo "force=${FORCE:-false}" >> $GITHUB_OUTPUT
+        run: bash scripts/resolve-sdk-reference-sync-params.sh
 
       - name: Generate SDK Reference
         working-directory: sdk-reference-generator
@@ -128,47 +124,92 @@ jobs:
 
           pnpm run generate $ARGS
 
-      - name: Commit and push changes
-        id: commit
-        env:
-          SDK_NAME: ${{ steps.params.outputs.sdk }}
-          SDK_VERSION: ${{ steps.params.outputs.version }}
+      - name: Collect change details
+        id: changes
         run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
+          CHANGED_FILES="$(git status --porcelain -- docs/sdk-reference docs.json | wc -l | tr -d ' ')"
+          TOTAL_MDX_FILES="$(find docs/sdk-reference -type f -name '*.mdx' | wc -l | tr -d ' ')"
 
-          git add docs/sdk-reference/
-          git add docs.json
-
-          if git diff --staged --quiet; then
-            echo "No changes to commit"
+          if [[ "$CHANGED_FILES" == "0" ]]; then
             echo "changes=false" >> $GITHUB_OUTPUT
           else
-            git commit -m "docs: update SDK reference for $SDK_NAME $SDK_VERSION"
-            git push
             echo "changes=true" >> $GITHUB_OUTPUT
           fi
 
+          echo "changed_files=$CHANGED_FILES" >> $GITHUB_OUTPUT
+          echo "total_mdx_files=$TOTAL_MDX_FILES" >> $GITHUB_OUTPUT
+
+      - name: Commit changes and manage pull request
+        if: steps.changes.outputs.changes == 'true'
+        id: pr
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          branch: automation/sdk-reference-sync
+          delete-branch: true
+          add-paths: |
+            docs/sdk-reference
+            docs.json
+          author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
+          committer: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
+          commit-message: "docs: sync SDK reference for ${{ steps.params.outputs.sdk }} ${{ steps.params.outputs.version }}"
+          title: "docs: sync SDK reference for ${{ steps.params.outputs.sdk }} ${{ steps.params.outputs.version }}"
+          body: |
+            ## Summary
+            This automated PR syncs generated SDK reference documentation.
+
+            ## Trigger
+            - Source: `${{ steps.params.outputs.trigger }}`
+            - SDK: `${{ steps.params.outputs.sdk }}`
+            - Version: `${{ steps.params.outputs.version }}`
+            - Limit: `${{ steps.params.outputs.limit_display }}`
+            - Force: `${{ steps.params.outputs.force }}`
+
+            ## Changes
+            - Updates generated reference files under `docs/sdk-reference/**`
+            - Updates `docs.json` navigation when generation changes the docs tree
+            - Changed files detected in this run: `${{ steps.changes.outputs.changed_files }}`
+            - Total tracked MDX reference files after generation: `${{ steps.changes.outputs.total_mdx_files }}`
+
+            ## Run Details
+            - Workflow: `${{ github.workflow }}`
+            - Run: https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
+
       - name: Summary
         env:
+          TRIGGER: ${{ steps.params.outputs.trigger }}
           SDK_NAME: ${{ steps.params.outputs.sdk }}
           SDK_VERSION: ${{ steps.params.outputs.version }}
-          LIMIT: ${{ steps.params.outputs.limit }}
-          CHANGES: ${{ steps.commit.outputs.changes }}
+          LIMIT: ${{ steps.params.outputs.limit_display }}
+          FORCE: ${{ steps.params.outputs.force }}
+          CHANGES: ${{ steps.changes.outputs.changes }}
+          CHANGED_FILES: ${{ steps.changes.outputs.changed_files }}
+          TOTAL_MDX_FILES: ${{ steps.changes.outputs.total_mdx_files }}
+          PR_OPERATION: ${{ steps.pr.outputs.pull-request-operation }}
+          PR_URL: ${{ steps.pr.outputs.pull-request-url }}
         run: |
           echo "## SDK Reference Generation Complete" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "| Parameter | Value |" >> $GITHUB_STEP_SUMMARY
           echo "|-----------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Trigger | $TRIGGER |" >> $GITHUB_STEP_SUMMARY
           echo "| SDK | $SDK_NAME |" >> $GITHUB_STEP_SUMMARY
           echo "| Version | $SDK_VERSION |" >> $GITHUB_STEP_SUMMARY
-          echo "| Limit | ${LIMIT:-No limit} |" >> $GITHUB_STEP_SUMMARY
-          echo "| Changes committed | $CHANGES |" >> $GITHUB_STEP_SUMMARY
+          echo "| Limit | $LIMIT |" >> $GITHUB_STEP_SUMMARY
+          echo "| Force | $FORCE |" >> $GITHUB_STEP_SUMMARY
+          echo "| Changes detected | $CHANGES |" >> $GITHUB_STEP_SUMMARY
+          echo "| Changed files | ${CHANGED_FILES:-0} |" >> $GITHUB_STEP_SUMMARY
+          echo "| PR operation | ${PR_OPERATION:-No PR created} |" >> $GITHUB_STEP_SUMMARY
+          if [[ -n "$PR_URL" ]]; then
+            echo "| Pull request | $PR_URL |" >> $GITHUB_STEP_SUMMARY
+          fi
           echo "" >> $GITHUB_STEP_SUMMARY
 
           if [[ "$CHANGES" == "true" ]]; then
             echo "### Generated Files" >> $GITHUB_STEP_SUMMARY
             echo '```' >> $GITHUB_STEP_SUMMARY
-            echo "Total MDX files: $(find docs/sdk-reference -type f -name '*.mdx' | wc -l)" >> $GITHUB_STEP_SUMMARY
+            echo "Total MDX files: $TOTAL_MDX_FILES" >> $GITHUB_STEP_SUMMARY
             echo '```' >> $GITHUB_STEP_SUMMARY
+          else
+            echo "No SDK reference changes were detected, so no pull request was created." >> $GITHUB_STEP_SUMMARY
           fi

docs.json

@@ -2479,8 +2479,15 @@
             "icon": "python",
             "versions": [
               {
-                "version": "v2.4.1",
+                "version": "v2.5.0",
                 "default": true,
+                "pages": [
+                  "docs/sdk-reference/code-interpreter-python-sdk/v2.5.0/code_interpreter"
+                ]
+              },
+              {
+                "version": "v2.4.1",
+                "default": false,
                 "pages": [
                   "docs/sdk-reference/code-interpreter-python-sdk/v2.4.1/sandbox"
                 ]