ci(api-docs): make API-reference update fire on python-sdk release only

Drop the weekly cron and manual workflow_dispatch triggers; the workflow now runs
solely on a repository_dispatch (event-type: sdk-release) sent by python-sdk's
release workflow after it publishes, carrying the released tag in
client_payload.ref. Resolve the ref from the dispatch payload (with a latest-tag
fallback) and regenerate + PR the reference against that release.

Author: rahlk

.github/workflows/update-api-docs.yml

@@ -1,33 +1,26 @@
 name: Update Python API reference
 
-# Regenerates src/content/docs/reference/python-api/*.md from the python-sdk
-# release and opens a PR when anything changed. This keeps the *source-controlled*
-# API reference matched to the SDK; the deploy workflow regenerates the same docs
+# Regenerates src/content/docs/reference/python-api/*.md from a python-sdk release
+# and opens a PR when anything changed. This keeps the *source-controlled* API
+# reference matched to the SDK; the deploy workflow regenerates the same docs
 # ephemerally for the published build, but never commits them back.
 #
-# Triggers:
-#   - repository_dispatch (sdk-release): fired by python-sdk's release workflow.
-#       Send the released ref in client_payload.ref, e.g. from python-sdk:
-#         - uses: peter-evans/repository-dispatch@v3
-#           with:
-#             token: ${{ secrets.DOCS_DISPATCH_TOKEN }}   # PAT with repo scope on the docs repo
-#             repository: codellm-devkit/docs
-#             event-type: sdk-release
-#             client-payload: '{"ref": "${{ github.ref_name }}"}'
-#   - workflow_dispatch: manual run, with an optional ref (tag/branch/sha).
-#   - schedule: weekly safety net in case a release dispatch is ever missed.
+# Trigger: a python-sdk *release* only. python-sdk's release workflow
+# (.github/workflows/release.yml) sends a repository_dispatch after it publishes,
+# carrying the released tag in client_payload.ref:
+#
+#   - name: Trigger docs API-reference update
+#     uses: peter-evans/repository-dispatch@v3
+#     with:
+#       token: ${{ secrets.DOCS_DISPATCH_TOKEN }}   # PAT/fine-grained token with
+#                                                    # contents:write on codellm-devkit/docs
+#       repository: codellm-devkit/docs
+#       event-type: sdk-release
+#       client-payload: '{"ref": "${{ github.ref_name }}"}'
 
 on:
   repository_dispatch:
     types: [sdk-release]
-  workflow_dispatch:
-    inputs:
-      ref:
-        description: "python-sdk ref to generate from (tag/branch/sha). Defaults to the latest release tag."
-        required: false
-        default: ""
-  schedule:
-    - cron: "0 6 * * 1" # Mondays 06:00 UTC
 
 permissions:
   contents: write
@@ -51,18 +44,19 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Clone python-sdk at the target ref
+      - name: Clone python-sdk at the released tag
         id: sdk
         run: |
           set -euo pipefail
           git clone https://github.com/codellm-devkit/python-sdk.git ../python-sdk
           cd ../python-sdk
-          # Precedence: repository_dispatch payload > workflow_dispatch input > latest release tag.
-          REF="${{ github.event.client_payload.ref || github.event.inputs.ref }}"
+          # The release workflow sends the released tag in client_payload.ref.
+          # Fall back to the latest release tag if a dispatch ever arrives without one.
+          REF="${{ github.event.client_payload.ref }}"
           if [ -z "${REF}" ]; then
             REF=$(git tag --sort=-v:refname | head -n1)
           fi
-          echo "Generating API reference from python-sdk ref: ${REF}"
+          echo "Generating API reference from python-sdk release: ${REF}"
           git checkout "${REF}"
           SDK_VERSION=$(python -c "import tomllib,pathlib; print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
           echo "ref=${REF}" >> "$GITHUB_OUTPUT"
@@ -90,8 +84,8 @@ jobs:
           commit-message: "docs(api): sync Python API reference to python-sdk ${{ steps.sdk.outputs.version }}"
           title: "docs(api): sync Python API reference to python-sdk ${{ steps.sdk.outputs.version }}"
           body: |
-            Automated regeneration of the Python API reference from
-            [`python-sdk`](https://github.com/codellm-devkit/python-sdk) ref
+            Automated regeneration of the Python API reference from the
+            [`python-sdk`](https://github.com/codellm-devkit/python-sdk) release
             `${{ steps.sdk.outputs.ref }}` (version `${{ steps.sdk.outputs.version }}`).
 
             Generated by `scripts/gen_api_docs.py` (griffe). Authored intros above the