Merge branch 'main' into fix/chat-transient-retries

Co-authored-by: speakeasybot <bot@speakeasyapi.dev>
Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>

.genignore

@@ -1 +1,3 @@
-pylintrc
+pylintrc
+docs/docs.json
+docs/overview.mdx

.github/workflows/auto-merge-speakeasy-pr.yaml

@@ -1,11 +1,27 @@
 name: Auto-merge Speakeasy PR
 
-# Speakeasy mode:pr opens PRs (speakeasy-sdk-regen-*) and labels them
-# patch/minor/major. Merge automatically so sdk_publish.yaml can run.
+# Called as a follow-up job after Speakeasy Generate (mode: pr). Merges the
+# regen PR opened/updated in the same workflow run so sdk_publish.yaml can run.
+# Prefer branch_name from Generate logs; fall back to run_started_at heuristics.
+# Uses GH_DOCS_SYNC GitHub App token (not a PAT) so merges trigger downstream push.
 
 on:
-  pull_request:
-    types: [labeled]
+  workflow_call:
+    inputs:
+      run_started_at:
+        description: ISO timestamp when the parent Generate workflow run started
+        required: true
+        type: string
+      branch_name:
+        description: Speakeasy regen branch from the parent Generate run (optional)
+        required: false
+        type: string
+        default: ""
+    secrets:
+      GH_DOCS_SYNC_APP_ID:
+        required: true
+      GH_DOCS_SYNC_APP_PRIVATE_KEY:
+        required: true
 
 permissions:
   contents: write
@@ -17,29 +33,90 @@ concurrency:
 
 jobs:
   auto-merge:
-    if: |
-      github.event.sender.login == 'github-actions[bot]' &&
-      github.event.pull_request.user.login == 'github-actions[bot]' &&
-      startsWith(github.event.pull_request.head.ref, 'speakeasy-sdk-regen-') &&
-      contains(github.event.pull_request.title, '🐝 Update SDK') &&
-      contains(fromJSON('["patch", "minor", "major"]'), github.event.label.name)
     runs-on: ubuntu-latest
     steps:
-      - name: Close superseded Speakeasy PRs
+      - name: Generate GitHub App token
+        id: app-token
+        # actions/create-github-app-token@v3.2.0 (immutable SHA)
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1
+        with:
+          app-id: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+          private-key: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}
+
+      - name: Resolve Speakeasy regen PR
+        id: pr
         env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
         run: |
           set -euo pipefail
-          CURRENT_PR="${{ github.event.pull_request.number }}"
 
-          PRIOR_JSON=$(gh pr list \
-            --repo "${{ github.repository }}" \
+          REPO="${{ github.repository }}"
+          RUN_STARTED="${{ inputs.run_started_at }}"
+          BRANCH="${{ inputs.branch_name }}"
+
+          PR_JSON=$(gh pr list \
+            --repo "$REPO" \
             --state open \
             --search "head:speakeasy-sdk-regen-" \
             --limit 500 \
-            --json number \
-            | jq -r --arg cur "$CURRENT_PR" \
-              '[.[].number | select(tostring != $cur)] | .[]')
+            --json number,updatedAt,title,labels,author,headRefName)
+
+          PR_NUM=""
+          if [ -n "$BRANCH" ]; then
+            CANDIDATE=$(echo "$PR_JSON" | jq -r --arg branch "$BRANCH" \
+              '[.[] | select(.headRefName == $branch)] | .[0] // empty')
+            if [ -n "$CANDIDATE" ] && echo "$CANDIDATE" | jq -e '
+              (.headRefName | startswith("speakeasy-sdk-regen-"))
+              and (.title | contains("🐝 Update SDK"))
+              and ([.labels[].name] | any(. == "patch" or . == "minor" or . == "major"))
+              and (.author.is_bot == true)
+            ' > /dev/null; then
+              PR_NUM=$(echo "$CANDIDATE" | jq -r '.number')
+              echo "Resolved Speakeasy regen PR #$PR_NUM from branch $BRANCH"
+            else
+              echo "::warning::branch_name=$BRANCH did not match a valid open regen PR — falling back to run_started_at"
+            fi
+          fi
+
+          if [ -z "$PR_NUM" ]; then
+            PR_NUM=$(echo "$PR_JSON" | jq -r --arg started "$RUN_STARTED" '
+              [.[]
+                | select(.headRefName | startswith("speakeasy-sdk-regen-"))
+                | select(.title | contains("🐝 Update SDK"))
+                | select([.labels[].name] | any(. == "patch" or . == "minor" or . == "major"))
+                | select(.author.is_bot == true)
+                | select(.updatedAt >= $started)
+              ] | sort_by(.updatedAt) | last | .number // empty')
+          fi
+
+          if [ -z "$PR_NUM" ]; then
+            echo "No Speakeasy regen PR for this Generate run — skipping auto-merge"
+            echo "::notice title=auto-merge-skipped::No qualifying Speakeasy regen PR to merge"
+            {
+              echo "## Auto-merge skipped"
+              echo "No qualifying \`speakeasy-sdk-regen-*\` PR was found."
+              echo "- branch_name input: \`${BRANCH:-<empty>}\`"
+              echo "- run_started_at: \`$RUN_STARTED\`"
+            } >> "$GITHUB_STEP_SUMMARY"
+            echo "pr_num=" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "pr_num=$PR_NUM" >> "$GITHUB_OUTPUT"
+          echo "$PR_JSON" > /tmp/speakeasy_pr_json.json
+
+      - name: Close superseded Speakeasy PRs
+        if: steps.pr.outputs.pr_num != ''
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          set -euo pipefail
+
+          CURRENT_PR="${{ steps.pr.outputs.pr_num }}"
+          PR_JSON=$(cat /tmp/speakeasy_pr_json.json)
+
+          PRIOR_JSON=$(echo "$PR_JSON" | jq -r --arg current_pr "$CURRENT_PR" \
+            '[.[].number | select(tostring != $current_pr)] | .[]')
 
           if [ -z "$PRIOR_JSON" ]; then
             echo "No superseded Speakeasy PRs to close"
@@ -57,30 +134,92 @@ jobs:
           done
 
       - name: Auto-merge Speakeasy PR
+        if: steps.pr.outputs.pr_num != ''
         env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
         run: |
           set -euo pipefail
-          PR_NUM="${{ github.event.pull_request.number }}"
+
+          PR_NUM="${{ steps.pr.outputs.pr_num }}"
           REPO="${{ github.repository }}"
 
+          wait_for_checks() {
+            local pr=$1
+            local timeout=600
+            local interval=15
+            local elapsed=0
+
+            echo "Waiting for PR #$pr checks (timeout ${timeout}s)..."
+            while [ "$elapsed" -lt "$timeout" ]; do
+              TOTAL=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '.statusCheckRollup | length')
+              PENDING=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '[.statusCheckRollup[]? | select(.status != "COMPLETED")] | length')
+              FAILED=$(gh pr view "$pr" --repo "$REPO" --json statusCheckRollup --jq \
+                '[.statusCheckRollup[]? | select(.status == "COMPLETED") | select(.conclusion != "SUCCESS" and .conclusion != "SKIPPED" and .conclusion != "NEUTRAL")] | length')
+
+              if [ "$TOTAL" -eq 0 ]; then
+                # GITHUB_TOKEN-authored regen PRs get no pull_request checks at all,
+                # so TOTAL stays 0 forever. Wait a short grace window in case checks
+                # are merely slow to register, then proceed rather than time out.
+                if [ "$elapsed" -ge 60 ]; then
+                  echo "No checks registered after ${elapsed}s — proceeding (checkless PR)"
+                  return 0
+                fi
+                echo "Checks not yet registered — waiting ${interval}s..."
+                sleep "$interval"
+                elapsed=$((elapsed + interval))
+                continue
+              fi
+
+              if [ "$PENDING" -eq 0 ]; then
+                if [ "$FAILED" -gt 0 ]; then
+                  echo "::error::PR #$pr has failing checks — refusing direct merge"
+                  gh pr checks "$pr" --repo "$REPO" || true
+                  exit 1
+                fi
+                echo "All checks completed"
+                return 0
+              fi
+
+              echo "Checks pending ($PENDING) — waiting ${interval}s..."
+              sleep "$interval"
+              elapsed=$((elapsed + interval))
+            done
+
+            echo "::error::Timed out waiting for PR #$pr checks"
+            exit 1
+          }
+
           STATE=$(gh pr view "$PR_NUM" --repo "$REPO" --json state --jq .state)
           if [ "$STATE" != "OPEN" ]; then
             echo "PR #$PR_NUM is $STATE — skipping merge"
             exit 0
           fi
 
+          MERGE_METHOD=""
           # Prefer GitHub auto-merge when required checks exist; otherwise
-          # squash-merge directly (same pattern as sdk-release-prs.yaml).
+          # squash-merge directly after checks pass (sdk-release-prs.yaml pattern).
           AUTO_MERGE_NOOP_PATTERN='is in clean status|protected branch rules|Branch does not have required protected branch rules'
           if gh pr merge "$PR_NUM" --repo "$REPO" --squash --auto --delete-branch 2> /tmp/gh-merge.err; then
+            MERGE_METHOD="auto-merge queued"
             echo "Auto-merge enabled for Speakeasy PR #$PR_NUM"
           elif grep -qiE "$AUTO_MERGE_NOOP_PATTERN" /tmp/gh-merge.err; then
-            echo "Auto-merge not applicable — merging PR #$PR_NUM directly"
+            echo "Auto-merge not applicable — waiting for checks, then merging PR #$PR_NUM directly"
             cat /tmp/gh-merge.err >&2
+            wait_for_checks "$PR_NUM"
             gh pr merge "$PR_NUM" --repo "$REPO" --squash --delete-branch
+            MERGE_METHOD="direct squash (checks passed)"
           else
             echo "::error::Failed to enable auto-merge on Speakeasy PR #$PR_NUM"
             cat /tmp/gh-merge.err >&2
             exit 1
           fi
+
+          echo "::notice title=auto-merge-pr::Merged Speakeasy PR #$PR_NUM ($MERGE_METHOD)"
+          {
+            echo "## Auto-merge complete"
+            echo "- PR: #$PR_NUM"
+            echo "- Method: $MERGE_METHOD"
+            echo "- Token: GH_DOCS_SYNC GitHub App"
+          } >> "$GITHUB_STEP_SUMMARY"

.github/workflows/docs-nav.yaml

@@ -0,0 +1,32 @@
+name: Docs navigation
+
+permissions:
+  contents: write
+  pull-requests: write
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - "docs/sdks/**"
+      - "scripts/gen-docs-nav.sh"
+      - ".github/workflows/docs-nav.yaml"
+
+jobs:
+  gen-docs-nav:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      # jq is preinstalled on GitHub-hosted ubuntu runners.
+      - name: Regenerate docs navigation
+        run: scripts/gen-docs-nav.sh
+
+      - name: Auto-commit docs.json navigation
+        uses: int128/update-generated-files-action@v2
+        with:
+          commit-message: "Chore: regenerate docs navigation"

.github/workflows/pr-validation.yaml

@@ -0,0 +1,37 @@
+name: PR Validation
+
+on:
+  pull_request:
+    paths-ignore:
+      - .speakeasy/in.openapi.yaml
+
+concurrency:
+  group: pr-validation-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build SDK
+        run: uv build
+
+      - name: Type check (mypy)
+        run: uv run --group dev mypy src
+
+      - name: Type check (pyright)
+        run: uv run --group dev pyright src
+
+      - name: Lint (pylint)
+        run: uv run --group dev pylint src --rcfile pylintrc

.github/workflows/sdk_generation.yaml

@@ -21,6 +21,11 @@ permissions:
     types:
       - labeled
       - unlabeled
+
+concurrency:
+  group: speakeasy-generate
+  cancel-in-progress: false
+
 jobs:
   generate:
     uses: speakeasy-api/sdk-generation-action/.github/workflows/workflow-executor.yaml@v15
@@ -32,3 +37,67 @@ jobs:
       github_access_token: ${{ secrets.GITHUB_TOKEN }}
       pypi_token: ${{ secrets.PYPI_TOKEN }}
       speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
+
+  resolve-branch:
+    needs: generate
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    runs-on: ubuntu-latest
+    outputs:
+      branch_name: ${{ steps.branch.outputs.branch_name }}
+      run_started_at: ${{ steps.branch.outputs.run_started_at }}
+    steps:
+      - name: Extract branch from Generate logs
+        id: branch
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          REPO="${{ github.repository }}"
+          RUN_ID="${{ github.run_id }}"
+
+          RUN_STARTED="${{ github.run_started_at }}"
+          if [ -z "$RUN_STARTED" ]; then
+            RUN_STARTED=$(gh run view "$RUN_ID" --repo "$REPO" --json startedAt --jq '.startedAt')
+            echo "Resolved run_started_at from API: $RUN_STARTED"
+          fi
+          echo "run_started_at=$RUN_STARTED" >> "$GITHUB_OUTPUT"
+
+          # Full-run logs are unavailable while the workflow is in progress;
+          # fetch logs from the completed generate job instead.
+          JOB_ID=$(gh run view "$RUN_ID" --repo "$REPO" --json jobs --jq \
+            '[.jobs[] | select(.name == "generate / Generate Target")] | .[0].databaseId // empty')
+
+          BRANCH=""
+          if [ -z "$JOB_ID" ]; then
+            echo "::warning::Could not find generate job id — auto-merge will use run_started_at fallback"
+          else
+            MAX_ATTEMPTS=12
+            INTERVAL=10
+            for attempt in $(seq 1 "$MAX_ATTEMPTS"); do
+              BRANCH=$(gh run view "$RUN_ID" --repo "$REPO" --job "$JOB_ID" --log 2>/dev/null \
+                | grep -oE 'branch_name=speakeasy-sdk-regen-[0-9]+' | tail -1 | cut -d= -f2 || true)
+              if [ -n "$BRANCH" ]; then
+                echo "Extracted branch_name=$BRANCH (attempt $attempt)"
+                break
+              fi
+              if [ "$attempt" -lt "$MAX_ATTEMPTS" ]; then
+                echo "Job logs not ready — waiting ${INTERVAL}s (attempt $attempt/$MAX_ATTEMPTS)..."
+                sleep "$INTERVAL"
+              fi
+            done
+            if [ -z "$BRANCH" ]; then
+              echo "::warning::Could not extract branch_name from Generate logs after ${MAX_ATTEMPTS} attempts — auto-merge will use run_started_at fallback"
+            fi
+          fi
+          echo "branch_name=$BRANCH" >> "$GITHUB_OUTPUT"
+
+  auto-merge:
+    needs: [generate, resolve-branch]
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    uses: ./.github/workflows/auto-merge-speakeasy-pr.yaml
+    with:
+      run_started_at: ${{ needs.resolve-branch.outputs.run_started_at }}
+      branch_name: ${{ needs.resolve-branch.outputs.branch_name }}
+    secrets:
+      GH_DOCS_SYNC_APP_ID: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+      GH_DOCS_SYNC_APP_PRIVATE_KEY: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}

.github/workflows/sdk_generation_for_spec_change.yaml

@@ -22,6 +22,10 @@ permissions:
     paths:
       - .speakeasy/in.openapi.yaml
 
+concurrency:
+  group: speakeasy-generate-spec-change
+  cancel-in-progress: false
+
 jobs:
   generate:
     if: github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
@@ -34,3 +38,67 @@ jobs:
       github_access_token: ${{ secrets.GITHUB_TOKEN }}
       pypi_token: ${{ secrets.PYPI_TOKEN }}
       speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
+
+  resolve-branch:
+    needs: generate
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    runs-on: ubuntu-latest
+    outputs:
+      branch_name: ${{ steps.branch.outputs.branch_name }}
+      run_started_at: ${{ steps.branch.outputs.run_started_at }}
+    steps:
+      - name: Extract branch from Generate logs
+        id: branch
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          REPO="${{ github.repository }}"
+          RUN_ID="${{ github.run_id }}"
+
+          RUN_STARTED="${{ github.run_started_at }}"
+          if [ -z "$RUN_STARTED" ]; then
+            RUN_STARTED=$(gh run view "$RUN_ID" --repo "$REPO" --json startedAt --jq '.startedAt')
+            echo "Resolved run_started_at from API: $RUN_STARTED"
+          fi
+          echo "run_started_at=$RUN_STARTED" >> "$GITHUB_OUTPUT"
+
+          # Full-run logs are unavailable while the workflow is in progress;
+          # fetch logs from the completed generate job instead.
+          JOB_ID=$(gh run view "$RUN_ID" --repo "$REPO" --json jobs --jq \
+            '[.jobs[] | select(.name == "generate / Generate Target")] | .[0].databaseId // empty')
+
+          BRANCH=""
+          if [ -z "$JOB_ID" ]; then
+            echo "::warning::Could not find generate job id — auto-merge will use run_started_at fallback"
+          else
+            MAX_ATTEMPTS=12
+            INTERVAL=10
+            for attempt in $(seq 1 "$MAX_ATTEMPTS"); do
+              BRANCH=$(gh run view "$RUN_ID" --repo "$REPO" --job "$JOB_ID" --log 2>/dev/null \
+                | grep -oE 'branch_name=speakeasy-sdk-regen-[0-9]+' | tail -1 | cut -d= -f2 || true)
+              if [ -n "$BRANCH" ]; then
+                echo "Extracted branch_name=$BRANCH (attempt $attempt)"
+                break
+              fi
+              if [ "$attempt" -lt "$MAX_ATTEMPTS" ]; then
+                echo "Job logs not ready — waiting ${INTERVAL}s (attempt $attempt/$MAX_ATTEMPTS)..."
+                sleep "$INTERVAL"
+              fi
+            done
+            if [ -z "$BRANCH" ]; then
+              echo "::warning::Could not extract branch_name from Generate logs after ${MAX_ATTEMPTS} attempts — auto-merge will use run_started_at fallback"
+            fi
+          fi
+          echo "branch_name=$BRANCH" >> "$GITHUB_OUTPUT"
+
+  auto-merge:
+    needs: [generate, resolve-branch]
+    if: ${{ !cancelled() && needs.generate.result == 'success' }}
+    uses: ./.github/workflows/auto-merge-speakeasy-pr.yaml
+    with:
+      run_started_at: ${{ needs.resolve-branch.outputs.run_started_at }}
+      branch_name: ${{ needs.resolve-branch.outputs.branch_name }}
+    secrets:
+      GH_DOCS_SYNC_APP_ID: ${{ secrets.GH_DOCS_SYNC_APP_ID }}
+      GH_DOCS_SYNC_APP_PRIVATE_KEY: ${{ secrets.GH_DOCS_SYNC_APP_PRIVATE_KEY }}

.gitignore

@@ -16,7 +16,6 @@ __pycache__/
 # Speakeasy generation artifacts (generated in OSS repo, not here)
 .speakeasy/*.lock
 .speakeasy/*.openapi.yaml
-/docs
 # Environment
 .env
 .env.local

.speakeasy/gen.yaml

@@ -16,6 +16,8 @@ generation:
     requestResponseComponentNamesFeb2024: true
     securityFeb2025: true
     sharedErrorComponentsApr2025: true
+    sharedNestedComponentsJan2026: false
+    nameOverrideFeb2026: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
@@ -25,14 +27,16 @@ generation:
   schemas:
     allOfMergeStrategy: shallowMerge
   requestBodyFieldName: ""
+  versioningStrategy: automatic
   persistentEdits: {}
   tests:
     generateTests: false
     generateNewTests: true
     skipResponseBodyAssertions: false
+  documentation: mintlify
   preApplyUnionDiscriminators: true
 python:
-  version: 0.10.1
+  version: 0.11.33
   additionalDependencies:
     dev: {}
     main: {}
@@ -46,6 +50,7 @@ python:
   authors:
     - OpenRouter
   baseErrorName: OpenRouterError
+  bodyVariantOverloads: false
   clientServerStatusCodesAsErrors: true
   constFieldCasing: upper
   defaultErrorName: OpenRouterDefaultError
@@ -53,12 +58,18 @@ python:
   enableCustomCodeRegions: false
   enumFormat: union
   envVarPrefix: OPENROUTER
+  errorSchemaValidation: true
+  eventStreamClassNames:
+    async: EventStreamAsync
+    sync: EventStream
   fixFlags:
     asyncPaginationSep2025: true
+    conflictResistantModelImportsFeb2026: false
     responseRequiredSep2024: true
   flattenGlobalSecurity: true
   flattenRequests: true
   flatteningOrder: parameters-first
+  forwardCompatibleEnumsByDefault: false
   forwardCompatibleUnionsByDefault: tagged-only
   imports:
     option: openapi
@@ -71,18 +82,25 @@ python:
   inferSSEOverload: true
   inferUnionDiscriminators: true
   inputModelSuffix: input
+  inputTypedDictSuffix: TypedDict
   legacyPyright: false
   license: Apache-2.0
   maxMethodParams: 999
   methodArguments: infer-optional-args
+  methodTimeoutArgument: timeout-ms
+  methodTimeoutUnits: milliseconds
   moduleName: ""
   multipartArrayFormat: legacy
+  optionalDependencies: {}
   outputModelSuffix: output
   packageManager: uv
   packageName: openrouter
   preApplyUnionDiscriminators: false
   pytestFilterWarnings: []
   pytestTimeout: 0
+  rawResponseHelpers: false
   responseFormat: flat
+  responseSchemaValidation: true
   sseFlatResponse: true
   templateVersion: v2
+  useAsyncHooks: false

.speakeasy/overlays/retry-transient-status-codes.overlay.yaml

@@ -0,0 +1,11 @@
+overlay: 1.0.0
+x-speakeasy-jsonpath: rfc9535
+info:
+  title: Retry request-timeout and rate-limit responses
+  version: 0.0.0
+actions:
+  - target: $["x-speakeasy-retries"].statusCodes
+    description: Also retry 408 (request timeout) and 429 (rate limit), not just 5XX
+    update:
+      - "408"
+      - "429"

.speakeasy/workflow.lock

@@ -1,24 +1,23 @@
-speakeasyVersion: 1.680.0
+speakeasyVersion: 1.787.0
 sources:
     OpenRouter API:
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:1e8bbe0cea645a95cb24c3e0061459d903aca98286d2c74de7cb8359b8c3c29d
-        sourceBlobDigest: sha256:42b4b8df42026cfc885ee4b34e7a30aaa906f40dc6ad99ea9e6c65e4bad495de
+        sourceRevisionDigest: sha256:1b18bfafe3a31635470908ce53c1bb12af21a82d371f6f979bb5e8463f52afb3
+        sourceBlobDigest: sha256:506597a9fce25fe757037a95da952e36f33dd702afa16c13d43c2df2d5da1ece
         tags:
             - latest
-            - speakeasy-sdk-regen-1781885111
             - 1.0.0
 targets:
     open-router:
         source: OpenRouter API
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:1e8bbe0cea645a95cb24c3e0061459d903aca98286d2c74de7cb8359b8c3c29d
-        sourceBlobDigest: sha256:42b4b8df42026cfc885ee4b34e7a30aaa906f40dc6ad99ea9e6c65e4bad495de
+        sourceRevisionDigest: sha256:1b18bfafe3a31635470908ce53c1bb12af21a82d371f6f979bb5e8463f52afb3
+        sourceBlobDigest: sha256:506597a9fce25fe757037a95da952e36f33dd702afa16c13d43c2df2d5da1ece
         codeSamplesNamespace: open-router-python-code-samples
-        codeSamplesRevisionDigest: sha256:a16acd4648a2b2c90df0256551f25bb6515c70ea239dba657f07fce770e459d5
+        codeSamplesRevisionDigest: sha256:7ae639df01271894474a52b709810943afd11f8d9acde069336e9a1f8588ec56
 workflow:
     workflowVersion: 1.0.0
-    speakeasyVersion: 1.680.0
+    speakeasyVersion: 1.787.0
     sources:
         OpenRouter API:
             inputs:

.speakeasy/workflow.yaml

@@ -1,5 +1,5 @@
 workflowVersion: 1.0.0
-speakeasyVersion: 1.680.0
+speakeasyVersion: 1.787.0
 sources:
     OpenRouter API:
         inputs:
@@ -11,6 +11,7 @@ sources:
             - location: .speakeasy/overlays/allof-simplify.overlay.yaml
             - location: .speakeasy/overlays/boolean-query-params.overlay.yaml
             - location: .speakeasy/overlays/fix-nullable-pagination.overlay.yaml
+            - location: .speakeasy/overlays/retry-transient-status-codes.overlay.yaml
         output: .speakeasy/out.openapi.yaml
         registry:
             location: registry.speakeasyapi.dev/openrouter/sdk/open-router-chat-completions-api

README-PYPI.md

@@ -55,7 +55,7 @@ It's also possible to write a standalone Python script without needing to set up
 ```python
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.9"
+# requires-python = ">=3.10"
 # dependencies = [
 #     "openrouter",
 # ]
@@ -189,7 +189,7 @@ with OpenRouter(
     api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:
 
-    res = open_router.byok.list()
+    res = open_router.byok.list(offset=0, limit=50)
 
     while res is not None:
         # Handle items
@@ -221,10 +221,10 @@ with OpenRouter(
     api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:
 
-    res = open_router.files.upload(file={
+    res = open_router.stt.create_transcription_multipart(file={
         "file_name": "example.file",
         "content": open("example.file", "rb"),
-    })
+    }, model="openai/whisper-large-v3", language="en")
 
     # Handle response
     print(res)

README.md

@@ -55,7 +55,7 @@ It's also possible to write a standalone Python script without needing to set up
 ```python
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.9"
+# requires-python = ">=3.10"
 # dependencies = [
 #     "openrouter",
 # ]
@@ -189,7 +189,7 @@ with OpenRouter(
     api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:
 
-    res = open_router.byok.list()
+    res = open_router.byok.list(offset=0, limit=50)
 
     while res is not None:
         # Handle items
@@ -221,10 +221,10 @@ with OpenRouter(
     api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:
 
-    res = open_router.files.upload(file={
+    res = open_router.stt.create_transcription_multipart(file={
         "file_name": "example.file",
         "content": open("example.file", "rb"),
-    })
+    }, model="openai/whisper-large-v3", language="en")
 
     # Handle response
     print(res)

RELEASES.md

@@ -30,7 +30,7 @@ Based on:
 ### Releases
 - [PyPI v0.10.0] https://pypi.org/project/openrouter/0.10.0 - .
 
-## 2026-06-22 00:59:00
+## 2026-06-25 21:56:51
 ### Changes
 Based on:
 - OpenAPI Doc  
@@ -38,4 +38,404 @@ Based on:
 ### Generated
 - [python v0.10.1] .
 ### Releases
-- [PyPI v0.10.1] https://pypi.org/project/openrouter/0.10.1 - .
+- [PyPI v0.10.1] https://pypi.org/project/openrouter/0.10.1 - .
+
+## 2026-06-25 22:28:38
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.2] .
+### Releases
+- [PyPI v0.10.2] https://pypi.org/project/openrouter/0.10.2 - .
+
+## 2026-06-26 00:15:50
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.3] .
+### Releases
+- [PyPI v0.10.3] https://pypi.org/project/openrouter/0.10.3 - .
+
+## 2026-06-26 12:06:01
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.4] .
+### Releases
+- [PyPI v0.10.4] https://pypi.org/project/openrouter/0.10.4 - .
+
+## 2026-06-26 14:36:56
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.5] .
+### Releases
+- [PyPI v0.10.5] https://pypi.org/project/openrouter/0.10.5 - .
+
+## 2026-06-26 18:19:11
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.6] .
+### Releases
+- [PyPI v0.10.6] https://pypi.org/project/openrouter/0.10.6 - .
+
+## 2026-06-26 23:43:40
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.7] .
+### Releases
+- [PyPI v0.10.7] https://pypi.org/project/openrouter/0.10.7 - .
+
+## 2026-06-28 15:27:21
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.680.0 (2.788.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.10.8] .
+### Releases
+- [PyPI v0.10.8] https://pypi.org/project/openrouter/0.10.8 - .
+
+## 2026-07-01 16:13:11
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.1] .
+### Releases
+- [PyPI v0.11.1] https://pypi.org/project/openrouter/0.11.1 - .
+
+## 2026-07-03 15:05:16
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.2] .
+### Releases
+- [PyPI v0.11.2] https://pypi.org/project/openrouter/0.11.2 - .
+
+## 2026-07-03 19:54:08
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.3] .
+### Releases
+- [PyPI v0.11.3] https://pypi.org/project/openrouter/0.11.3 - .
+
+## 2026-07-07 14:30:37
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.4] .
+### Releases
+- [PyPI v0.11.4] https://pypi.org/project/openrouter/0.11.4 - .
+
+## 2026-07-07 17:24:44
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.5] .
+### Releases
+- [PyPI v0.11.5] https://pypi.org/project/openrouter/0.11.5 - .
+
+## 2026-07-07 19:09:09
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.6] .
+### Releases
+- [PyPI v0.11.6] https://pypi.org/project/openrouter/0.11.6 - .
+
+## 2026-07-07 21:46:35
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.7] .
+### Releases
+- [PyPI v0.11.7] https://pypi.org/project/openrouter/0.11.7 - .
+
+## 2026-07-08 03:29:04
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.8] .
+### Releases
+- [PyPI v0.11.8] https://pypi.org/project/openrouter/0.11.8 - .
+
+## 2026-07-08 07:00:39
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.9] .
+### Releases
+- [PyPI v0.11.9] https://pypi.org/project/openrouter/0.11.9 - .
+
+## 2026-07-08 09:31:18
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.10] .
+### Releases
+- [PyPI v0.11.10] https://pypi.org/project/openrouter/0.11.10 - .
+
+## 2026-07-08 19:07:22
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.11] .
+### Releases
+- [PyPI v0.11.11] https://pypi.org/project/openrouter/0.11.11 - .
+
+## 2026-07-09 10:13:53
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.12] .
+### Releases
+- [PyPI v0.11.12] https://pypi.org/project/openrouter/0.11.12 - .
+
+## 2026-07-09 17:12:18
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.13] .
+### Releases
+- [PyPI v0.11.13] https://pypi.org/project/openrouter/0.11.13 - .
+
+## 2026-07-09 17:28:34
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.14] .
+### Releases
+- [PyPI v0.11.14] https://pypi.org/project/openrouter/0.11.14 - .
+
+## 2026-07-09 18:16:05
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.15] .
+### Releases
+- [PyPI v0.11.15] https://pypi.org/project/openrouter/0.11.15 - .
+
+## 2026-07-09 19:48:43
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.16] .
+### Releases
+- [PyPI v0.11.16] https://pypi.org/project/openrouter/0.11.16 - .
+
+## 2026-07-09 21:34:56
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.17] .
+### Releases
+- [PyPI v0.11.17] https://pypi.org/project/openrouter/0.11.17 - .
+
+## 2026-07-10 01:18:52
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.18] .
+### Releases
+- [PyPI v0.11.18] https://pypi.org/project/openrouter/0.11.18 - .
+
+## 2026-07-10 15:41:48
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.19] .
+### Releases
+- [PyPI v0.11.19] https://pypi.org/project/openrouter/0.11.19 - .
+
+## 2026-07-10 20:14:59
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.20] .
+### Releases
+- [PyPI v0.11.20] https://pypi.org/project/openrouter/0.11.20 - .
+
+## 2026-07-10 23:01:43
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.21] .
+### Releases
+- [PyPI v0.11.21] https://pypi.org/project/openrouter/0.11.21 - .
+
+## 2026-07-11 03:19:26
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.22] .
+### Releases
+- [PyPI v0.11.22] https://pypi.org/project/openrouter/0.11.22 - .
+
+## 2026-07-12 16:36:57
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.23] .
+### Releases
+- [PyPI v0.11.23] https://pypi.org/project/openrouter/0.11.23 - .
+
+## 2026-07-13 17:54:57
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.24] .
+### Releases
+- [PyPI v0.11.24] https://pypi.org/project/openrouter/0.11.24 - .
+
+## 2026-07-13 19:18:28
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.25] .
+### Releases
+- [PyPI v0.11.25] https://pypi.org/project/openrouter/0.11.25 - .
+
+## 2026-07-13 19:27:34
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.26] .
+### Releases
+- [PyPI v0.11.26] https://pypi.org/project/openrouter/0.11.26 - .
+
+## 2026-07-13 20:42:45
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.27] .
+### Releases
+- [PyPI v0.11.27] https://pypi.org/project/openrouter/0.11.27 - .
+
+## 2026-07-14 05:35:17
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.28] .
+### Releases
+- [PyPI v0.11.28] https://pypi.org/project/openrouter/0.11.28 - .
+
+## 2026-07-14 14:49:30
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.29] .
+### Releases
+- [PyPI v0.11.29] https://pypi.org/project/openrouter/0.11.29 - .
+
+## 2026-07-14 17:49:24
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.30] .
+### Releases
+- [PyPI v0.11.30] https://pypi.org/project/openrouter/0.11.30 - .
+
+## 2026-07-14 21:03:59
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.31] .
+### Releases
+- [PyPI v0.11.31] https://pypi.org/project/openrouter/0.11.31 - .
+
+## 2026-07-14 21:26:36
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.32] .
+### Releases
+- [PyPI v0.11.32] https://pypi.org/project/openrouter/0.11.32 - .
+
+## 2026-07-14 22:07:41
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.11.33] .
+### Releases
+- [PyPI v0.11.33] https://pypi.org/project/openrouter/0.11.33 - .

docs/components/aabenchmarkentry.mdx

@@ -0,0 +1,14 @@
+---
+title: "AABenchmarkEntry"
+---
+
+Artificial Analysis benchmark index scores.
+
+
+## Fields
+
+| Field                                        | Type                                         | Required                                     | Description                                  | Example                                      |
+| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
+| `agentic_index`                              | *Nullable[float]*                            | :heavy_check_mark:                           | Artificial Analysis Agentic Index score      | 55.8                                         |
+| `coding_index`                               | *Nullable[float]*                            | :heavy_check_mark:                           | Artificial Analysis Coding Index score       | 63.2                                         |
+| `intelligence_index`                         | *Nullable[float]*                            | :heavy_check_mark:                           | Artificial Analysis Intelligence Index score | 71.4                                         |

docs/components/action.mdx

@@ -0,0 +1,24 @@
+---
+title: "Action"
+---
+
+## Supported Types
+
+### `components.OutputWebSearchCallItemActionSearch`
+
+```python
+value: components.OutputWebSearchCallItemActionSearch = /* values here */
+```
+
+### `components.ActionOpenPage`
+
+```python
+value: components.ActionOpenPage = /* values here */
+```
+
+### `components.ActionFindInPage`
+
+```python
+value: components.ActionFindInPage = /* values here */
+```
+

docs/components/actionenum.mdx

@@ -0,0 +1,21 @@
+---
+title: "ActionEnum"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import ActionEnum
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: ActionEnum = "read"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"read"`
+- `"write"`
+- `"delete"`

docs/components/actionfindinpage.mdx

@@ -0,0 +1,11 @@
+---
+title: "ActionFindInPage"
+---
+
+## Fields
+
+| Field                                                        | Type                                                         | Required                                                     | Description                                                  |
+| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| `pattern`                                                    | *str*                                                        | :heavy_check_mark:                                           | N/A                                                          |
+| `type`                                                       | [components.TypeFindInPage](../components/typefindinpage.mdx) | :heavy_check_mark:                                           | N/A                                                          |
+| `url`                                                        | *str*                                                        | :heavy_check_mark:                                           | N/A                                                          |

docs/components/actionopenpage.mdx

@@ -0,0 +1,10 @@
+---
+title: "ActionOpenPage"
+---
+
+## Fields
+
+| Field                                                    | Type                                                     | Required                                                 | Description                                              |
+| -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
+| `type`                                                   | [components.TypeOpenPage](../components/typeopenpage.mdx) | :heavy_check_mark:                                       | N/A                                                      |
+| `url`                                                    | *OptionalNullable[str]*                                  | :heavy_minus_sign:                                       | N/A                                                      |

docs/components/actiontypesearch.mdx

@@ -0,0 +1,15 @@
+---
+title: "ActionTypeSearch"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import ActionTypeSearch
+value: ActionTypeSearch = "search"
+```
+
+
+## Values
+
+- `"search"`

docs/components/activityitem.mdx

@@ -1,5 +1,6 @@
-# ActivityItem
-
+---
+title: "ActivityItem"
+---
 
 ## Fields
 

docs/components/activityresponse.mdx

@@ -0,0 +1,9 @@
+---
+title: "ActivityResponse"
+---
+
+## Fields
+
+| Field                                                          | Type                                                           | Required                                                       | Description                                                    |
+| -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
+| `data`                                                         | List[[components.ActivityItem](../components/activityitem.mdx)] | :heavy_check_mark:                                             | List of activity items                                         |

docs/components/additionaltoolsitem.mdx

@@ -0,0 +1,15 @@
+---
+title: "AdditionalToolsItem"
+---
+
+Additional tools made available to the model at this point in the input
+
+
+## Fields
+
+| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `id`                                                                                           | *OptionalNullable[str]*                                                                        | :heavy_minus_sign:                                                                             | N/A                                                                                            |
+| `role`                                                                                         | [components.AdditionalToolsItemRole](../components/additionaltoolsitemrole.mdx)                 | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `tools`                                                                                        | List[[components.AdditionalToolsItemToolUnion](../components/additionaltoolsitemtoolunion.mdx)] | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `type`                                                                                         | [components.TypeAdditionalTools](../components/typeadditionaltools.mdx)                         | :heavy_check_mark:                                                                             | N/A                                                                                            |

docs/components/additionaltoolsitemrole.mdx

@@ -0,0 +1,26 @@
+---
+title: "AdditionalToolsItemRole"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AdditionalToolsItemRole
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AdditionalToolsItemRole = "unknown"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"unknown"`
+- `"user"`
+- `"assistant"`
+- `"system"`
+- `"critic"`
+- `"discriminator"`
+- `"developer"`
+- `"tool"`

docs/components/additionaltoolsitemtool.mdx

@@ -0,0 +1,10 @@
+---
+title: "AdditionalToolsItemTool"
+---
+
+## Fields
+
+| Field                      | Type                       | Required                   | Description                |
+| -------------------------- | -------------------------- | -------------------------- | -------------------------- |
+| `type`                     | *str*                      | :heavy_check_mark:         | N/A                        |
+| `__pydantic_extra__`       | Dict[str, *Nullable[Any]*] | :heavy_minus_sign:         | N/A                        |

docs/components/additionaltoolsitemtoolfunction.mdx

@@ -0,0 +1,16 @@
+---
+title: "AdditionalToolsItemToolFunction"
+---
+
+Function tool definition
+
+
+## Fields
+
+| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `description`                                                                                  | *OptionalNullable[str]*                                                                        | :heavy_minus_sign:                                                                             | N/A                                                                                            |
+| `name`                                                                                         | *str*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `parameters`                                                                                   | Dict[str, *Nullable[Any]*]                                                                     | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `strict`                                                                                       | *OptionalNullable[bool]*                                                                       | :heavy_minus_sign:                                                                             | N/A                                                                                            |
+| `type`                                                                                         | [components.AdditionalToolsItemTypeFunction](../components/additionaltoolsitemtypefunction.mdx) | :heavy_check_mark:                                                                             | N/A                                                                                            |

docs/components/additionaltoolsitemtoolunion.mdx

@@ -0,0 +1,168 @@
+---
+title: "AdditionalToolsItemToolUnion"
+---
+
+## Supported Types
+
+### `components.AdditionalToolsItemToolFunction`
+
+```python
+value: components.AdditionalToolsItemToolFunction = /* values here */
+```
+
+### `components.PreviewWebSearchServerTool`
+
+```python
+value: components.PreviewWebSearchServerTool = /* values here */
+```
+
+### `components.Preview20250311WebSearchServerTool`
+
+```python
+value: components.Preview20250311WebSearchServerTool = /* values here */
+```
+
+### `components.LegacyWebSearchServerTool`
+
+```python
+value: components.LegacyWebSearchServerTool = /* values here */
+```
+
+### `components.WebSearchServerTool`
+
+```python
+value: components.WebSearchServerTool = /* values here */
+```
+
+### `components.FileSearchServerTool`
+
+```python
+value: components.FileSearchServerTool = /* values here */
+```
+
+### `components.ComputerUseServerTool`
+
+```python
+value: components.ComputerUseServerTool = /* values here */
+```
+
+### `components.CodeInterpreterServerTool`
+
+```python
+value: components.CodeInterpreterServerTool = /* values here */
+```
+
+### `components.McpServerTool`
+
+```python
+value: components.McpServerTool = /* values here */
+```
+
+### `components.ImageGenerationServerTool`
+
+```python
+value: components.ImageGenerationServerTool = /* values here */
+```
+
+### `components.CodexLocalShellTool`
+
+```python
+value: components.CodexLocalShellTool = /* values here */
+```
+
+### `components.ShellServerTool`
+
+```python
+value: components.ShellServerTool = /* values here */
+```
+
+### `components.ApplyPatchServerTool`
+
+```python
+value: components.ApplyPatchServerTool = /* values here */
+```
+
+### `components.CustomTool`
+
+```python
+value: components.CustomTool = /* values here */
+```
+
+### `components.AdvisorServerToolOpenRouter`
+
+```python
+value: components.AdvisorServerToolOpenRouter = /* values here */
+```
+
+### `components.SubagentServerToolOpenRouter`
+
+```python
+value: components.SubagentServerToolOpenRouter = /* values here */
+```
+
+### `components.DatetimeServerTool`
+
+```python
+value: components.DatetimeServerTool = /* values here */
+```
+
+### `components.FilesServerTool`
+
+```python
+value: components.FilesServerTool = /* values here */
+```
+
+### `components.FusionServerToolOpenRouter`
+
+```python
+value: components.FusionServerToolOpenRouter = /* values here */
+```
+
+### `components.ImageGenerationServerToolOpenRouter`
+
+```python
+value: components.ImageGenerationServerToolOpenRouter = /* values here */
+```
+
+### `components.SearchModelsServerToolOpenRouter`
+
+```python
+value: components.SearchModelsServerToolOpenRouter = /* values here */
+```
+
+### `components.WebFetchServerTool`
+
+```python
+value: components.WebFetchServerTool = /* values here */
+```
+
+### `components.WebSearchServerToolOpenRouter`
+
+```python
+value: components.WebSearchServerToolOpenRouter = /* values here */
+```
+
+### `components.ApplyPatchServerToolOpenRouter`
+
+```python
+value: components.ApplyPatchServerToolOpenRouter = /* values here */
+```
+
+### `components.BashServerTool`
+
+```python
+value: components.BashServerTool = /* values here */
+```
+
+### `components.ShellServerToolOpenRouter`
+
+```python
+value: components.ShellServerToolOpenRouter = /* values here */
+```
+
+### `components.AdditionalToolsItemTool`
+
+```python
+value: components.AdditionalToolsItemTool = /* values here */
+```
+

docs/components/additionaltoolsitemtypefunction.mdx

@@ -0,0 +1,15 @@
+---
+title: "AdditionalToolsItemTypeFunction"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AdditionalToolsItemTypeFunction
+value: AdditionalToolsItemTypeFunction = "function"
+```
+
+
+## Values
+
+- `"function"`

docs/components/advisornestedtool.mdx

@@ -0,0 +1,14 @@
+---
+title: "AdvisorNestedTool"
+---
+
+A tool made available to the advisor sub-agent. Only OpenRouter server tools (e.g. openrouter:web_search) are supported; function tools are rejected because the advisor has no way to execute them. The advisor tool may not list itself.
+
+
+## Fields
+
+| Field                               | Type                                | Required                            | Description                         | Example                             |
+| ----------------------------------- | ----------------------------------- | ----------------------------------- | ----------------------------------- | ----------------------------------- |
+| `parameters`                        | Dict[str, *Nullable[Any]*]          | :heavy_minus_sign:                  | N/A                                 |                                     |
+| `type`                              | *str*                               | :heavy_check_mark:                  | N/A                                 |                                     |
+| `__pydantic_extra__`                | Dict[str, *Nullable[Any]*]          | :heavy_minus_sign:                  | N/A                                 | \{<br/>"type": "openrouter:web_search"<br/>} |

docs/components/advisorreasoning.mdx

@@ -0,0 +1,13 @@
+---
+title: "AdvisorReasoning"
+---
+
+Reasoning configuration forwarded to the advisor call. Use this to control reasoning effort and token budget for models that support extended thinking.
+
+
+## Fields
+
+| Field                                                                                  | Type                                                                                   | Required                                                                               | Description                                                                            |
+| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `effort`                                                                               | [Optional[components.AdvisorReasoningEffort]](../components/advisorreasoningeffort.mdx) | :heavy_minus_sign:                                                                     | Reasoning effort level for the advisor call.                                           |
+| `max_tokens`                                                                           | *Optional[int]*                                                                        | :heavy_minus_sign:                                                                     | Maximum number of reasoning tokens the advisor may use.                                |

docs/components/advisorreasoningeffort.mdx

@@ -0,0 +1,27 @@
+---
+title: "AdvisorReasoningEffort"
+---
+
+Reasoning effort level for the advisor call.
+
+## Example Usage
+
+```python
+from openrouter.components import AdvisorReasoningEffort
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AdvisorReasoningEffort = "max"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"max"`
+- `"xhigh"`
+- `"high"`
+- `"medium"`
+- `"low"`
+- `"minimal"`
+- `"none"`

docs/components/advisorservertoolconfig.mdx

@@ -0,0 +1,21 @@
+---
+title: "AdvisorServerToolConfig"
+---
+
+Configuration for one openrouter:advisor server tool entry.
+
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                                                | Type                                                                                                                                                                                                                                                                                                                                                                                                                 | Required                                                                                                                                                                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                          | Example                                                                                                                                                                                                                                                                                                                                                                                                              |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forward_transcript`                                                                                                                                                                                                                                                                                                                                                                                                 | *Optional[bool]*                                                                                                                                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | When true, the full parent conversation is forwarded to the advisor so it sees the same context the executor does (and the tool-call `prompt`, if given, is appended as a final user turn). When false or omitted, the advisor receives only the `prompt` the executor passes in the tool call.                                                                                                                      | false                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `instructions`                                                                                                                                                                                                                                                                                                                                                                                                       | *Optional[str]*                                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | System instructions for the advisor sub-agent. When omitted, the advisor responds with no system prompt of its own.                                                                                                                                                                                                                                                                                                  | You are a senior staff engineer. Give a focused, decisive plan.                                                                                                                                                                                                                                                                                                                                                      |
+| `max_completion_tokens`                                                                                                                                                                                                                                                                                                                                                                                              | *Optional[int]*                                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Maximum number of output tokens (including reasoning) the advisor may produce. When omitted, the provider's default applies.                                                                                                                                                                                                                                                                                         | 2048                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `max_tool_calls`                                                                                                                                                                                                                                                                                                                                                                                                     | *Optional[int]*                                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Maximum number of tool-calling steps the advisor sub-agent may take during its agentic loop. Capped at 25. Only relevant when the advisor is given tools.                                                                                                                                                                                                                                                            | 5                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `model`                                                                                                                                                                                                                                                                                                                                                                                                              | *Optional[str]*                                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Slug of the advisor model to consult (any OpenRouter model). When omitted, the executor can choose it via the tool call's `model` argument; if neither is set, the model from the outer API request is used. The advisor tool itself cannot be the advisor model.                                                                                                                                                    | ~anthropic/claude-opus-latest                                                                                                                                                                                                                                                                                                                                                                                        |
+| `name`                                                                                                                                                                                                                                                                                                                                                                                                               | *Optional[str]*                                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Optional name for this advisor. The model sees one tool per named advisor (and one default for an unnamed entry). Names must be unique across advisor entries. Letters, digits, spaces, underscores, and dashes; trimmed; 1–64 chars.                                                                                                                                                                                | reviewer                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `reasoning`                                                                                                                                                                                                                                                                                                                                                                                                          | [Optional[components.AdvisorReasoning]](../components/advisorreasoning.mdx)                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Reasoning configuration forwarded to the advisor call. Use this to control reasoning effort and token budget for models that support extended thinking.                                                                                                                                                                                                                                                              | \{<br/>"effort": "high"<br/>}                                                                                                                                                                                                                                                                                                                                                                                         |
+| `stream`                                                                                                                                                                                                                                                                                                                                                                                                             | *Optional[bool]*                                                                                                                                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | When true, the advisor's advice streams incrementally as it is produced. In the Responses API this emits `response.output_text.delta` events targeting the advisor output item; the final `advice` field is still set on the completed item. Has no effect on the Chat Completions API (where the advice arrives only as the final tool result). When false or omitted, the advice arrives only as the final result. | false                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `temperature`                                                                                                                                                                                                                                                                                                                                                                                                        | *Optional[float]*                                                                                                                                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Sampling temperature forwarded to the advisor call. When omitted, the provider's default applies.                                                                                                                                                                                                                                                                                                                    | 0.7                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `tools`                                                                                                                                                                                                                                                                                                                                                                                                              | List[[components.AdvisorNestedTool](../components/advisornestedtool.mdx)]                                                                                                                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                   | Tools the advisor sub-agent may use while forming its advice. The advisor runs as an agentic sub-agent over these tools, then returns its text. Only OpenRouter server tools are supported — function tools are rejected — and the list must not include the advisor tool itself.                                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                      |

docs/components/advisorservertoolopenrouter.mdx

@@ -0,0 +1,13 @@
+---
+title: "AdvisorServerToolOpenRouter"
+---
+
+OpenRouter built-in server tool: consults a higher-intelligence advisor model (any OpenRouter model) for guidance mid-generation and returns its response. The advisor may run as a sub-agent with its own tools. Include multiple entries to offer several named advisors; at most one entry may omit `name` to act as the default advisor.
+
+
+## Fields
+
+| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    | Example                                                                                        |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `parameters`                                                                                   | [Optional[components.AdvisorServerToolConfig]](../components/advisorservertoolconfig.mdx)       | :heavy_minus_sign:                                                                             | Configuration for one openrouter:advisor server tool entry.                                    | \{<br/>"model": "~anthropic/claude-opus-latest",<br/>"name": "reviewer"<br/>}                   |
+| `type`                                                                                         | [components.AdvisorServerToolOpenRouterType](../components/advisorservertoolopenroutertype.mdx) | :heavy_check_mark:                                                                             | N/A                                                                                            |                                                                                                |

docs/components/advisorservertoolopenroutertype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AdvisorServerToolOpenRouterType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AdvisorServerToolOpenRouterType
+value: AdvisorServerToolOpenRouterType = "openrouter:advisor"
+```
+
+
+## Values
+
+- `"openrouter:advisor"`

docs/components/agent.mdx

@@ -0,0 +1,10 @@
+---
+title: "Agent"
+---
+
+## Fields
+
+| Field                      | Type                       | Required                   | Description                |
+| -------------------------- | -------------------------- | -------------------------- | -------------------------- |
+| `agent_name`               | *str*                      | :heavy_check_mark:         | N/A                        |
+| `__pydantic_extra__`       | Dict[str, *Nullable[Any]*] | :heavy_minus_sign:         | N/A                        |

docs/components/agentmessageitem.mdx

@@ -0,0 +1,18 @@
+---
+title: "AgentMessageItem"
+---
+
+A message routed between agents in a multi-agent session
+
+
+## Fields
+
+| Field                                                                                                                                          | Type                                                                                                                                           | Required                                                                                                                                       | Description                                                                                                                                    | Example                                                                                                                                        |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `agent`                                                                                                                                        | [OptionalNullable[components.Agent]](../components/agent.mdx)                                                                                   | :heavy_minus_sign:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `author`                                                                                                                                       | *str*                                                                                                                                          | :heavy_check_mark:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `content`                                                                                                                                      | List[[components.AgentMessageItemContentUnion](../components/agentmessageitemcontentunion.mdx)]                                                 | :heavy_check_mark:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `id`                                                                                                                                           | *OptionalNullable[str]*                                                                                                                        | :heavy_minus_sign:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `recipient`                                                                                                                                    | *str*                                                                                                                                          | :heavy_check_mark:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `type`                                                                                                                                         | [components.TypeAgentMessage](../components/typeagentmessage.mdx)                                                                               | :heavy_check_mark:                                                                                                                             | N/A                                                                                                                                            |                                                                                                                                                |
+| `__pydantic_extra__`                                                                                                                           | Dict[str, *Nullable[Any]*]                                                                                                                     | :heavy_minus_sign:                                                                                                                             | N/A                                                                                                                                            | \{<br/>"author": "/root/worker",<br/>"content": [<br/>\{<br/>"text": "Task complete.",<br/>"type": "input_text"<br/>}<br/>],<br/>"recipient": "/root",<br/>"type": "agent_message"<br/>} |

docs/components/agentmessageitemcontentinputimage.mdx

@@ -0,0 +1,14 @@
+---
+title: "AgentMessageItemContentInputImage"
+---
+
+Image input content item
+
+
+## Fields
+
+| Field                                                                                        | Type                                                                                         | Required                                                                                     | Description                                                                                  |
+| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `detail`                                                                                     | [components.AgentMessageItemDetail](../components/agentmessageitemdetail.mdx)                 | :heavy_check_mark:                                                                           | N/A                                                                                          |
+| `image_url`                                                                                  | *OptionalNullable[str]*                                                                      | :heavy_minus_sign:                                                                           | N/A                                                                                          |
+| `type`                                                                                       | [components.AgentMessageItemTypeInputImage](../components/agentmessageitemtypeinputimage.mdx) | :heavy_check_mark:                                                                           | N/A                                                                                          |

docs/components/agentmessageitemcontentunion.mdx

@@ -0,0 +1,24 @@
+---
+title: "AgentMessageItemContentUnion"
+---
+
+## Supported Types
+
+### `components.InputText`
+
+```python
+value: components.InputText = /* values here */
+```
+
+### `components.AgentMessageItemContentInputImage`
+
+```python
+value: components.AgentMessageItemContentInputImage = /* values here */
+```
+
+### `components.ContentEncryptedContent`
+
+```python
+value: components.ContentEncryptedContent = /* values here */
+```
+

docs/components/agentmessageitemdetail.mdx

@@ -0,0 +1,22 @@
+---
+title: "AgentMessageItemDetail"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AgentMessageItemDetail
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AgentMessageItemDetail = "auto"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"auto"`
+- `"high"`
+- `"low"`
+- `"original"`

docs/components/agentmessageitemtypeinputimage.mdx

@@ -0,0 +1,15 @@
+---
+title: "AgentMessageItemTypeInputImage"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AgentMessageItemTypeInputImage
+value: AgentMessageItemTypeInputImage = "input_image"
+```
+
+
+## Values
+
+- `"input_image"`

docs/components/allowedtools.mdx

@@ -0,0 +1,10 @@
+---
+title: "AllowedTools"
+---
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `read_only`        | *Optional[bool]*   | :heavy_minus_sign: | N/A                |
+| `tool_names`       | List[*str*]        | :heavy_minus_sign: | N/A                |

docs/components/allowedtoolsunion.mdx

@@ -0,0 +1,24 @@
+---
+title: "AllowedToolsUnion"
+---
+
+## Supported Types
+
+### `List[str]`
+
+```python
+value: List[str] = /* values here */
+```
+
+### `components.AllowedTools`
+
+```python
+value: components.AllowedTools = /* values here */
+```
+
+### `Any`
+
+```python
+value: Any = /* values here */
+```
+

docs/components/always.mdx

@@ -0,0 +1,9 @@
+---
+title: "Always"
+---
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `tool_names`       | List[*str*]        | :heavy_minus_sign: | N/A                |

docs/components/annotationaddedevent.mdx

@@ -0,0 +1,18 @@
+---
+title: "AnnotationAddedEvent"
+---
+
+Event emitted when a text annotation is added to output
+
+
+## Fields
+
+| Field                                                                                               | Type                                                                                                | Required                                                                                            | Description                                                                                         | Example                                                                                             |
+| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `annotation`                                                                                        | [components.OpenAIResponsesAnnotation](../components/openairesponsesannotation.mdx)                  | :heavy_check_mark:                                                                                  | N/A                                                                                                 | \{<br/>"file_id": "file-abc123",<br/>"filename": "research_paper.pdf",<br/>"index": 0,<br/>"type": "file_citation"<br/>} |
+| `annotation_index`                                                                                  | *int*                                                                                               | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |
+| `content_index`                                                                                     | *int*                                                                                               | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |
+| `item_id`                                                                                           | *str*                                                                                               | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |
+| `output_index`                                                                                      | *int*                                                                                               | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |
+| `sequence_number`                                                                                   | *int*                                                                                               | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |
+| `type`                                                                                              | [components.AnnotationAddedEventType](../components/annotationaddedeventtype.mdx)                    | :heavy_check_mark:                                                                                  | N/A                                                                                                 |                                                                                                     |

docs/components/annotationaddedeventtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnnotationAddedEventType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnnotationAddedEventType
+value: AnnotationAddedEventType = "response.output_text.annotation.added"
+```
+
+
+## Values
+
+- `"response.output_text.annotation.added"`

docs/components/anthropicadvisormessageusageiteration.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicAdvisorMessageUsageIteration"
+---
+
+## Fields
+
+| Field                                                                                                              | Type                                                                                                               | Required                                                                                                           | Description                                                                                                        | Example                                                                                                            |
+| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
+| `cache_creation`                                                                                                   | [OptionalNullable[components.AnthropicIterationCacheCreation]](../components/anthropiciterationcachecreation.mdx)   | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                | \{<br/>"ephemeral_1h_input_tokens": 0,<br/>"ephemeral_5m_input_tokens": 0<br/>}                                     |
+| `cache_creation_input_tokens`                                                                                      | *Optional[int]*                                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |                                                                                                                    |
+| `cache_read_input_tokens`                                                                                          | *Optional[int]*                                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |                                                                                                                    |
+| `input_tokens`                                                                                                     | *Optional[int]*                                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |                                                                                                                    |
+| `output_tokens`                                                                                                    | *Optional[int]*                                                                                                    | :heavy_minus_sign:                                                                                                 | N/A                                                                                                                |                                                                                                                    |
+| `model`                                                                                                            | *str*                                                                                                              | :heavy_check_mark:                                                                                                 | N/A                                                                                                                |                                                                                                                    |
+| `type`                                                                                                             | [components.AnthropicAdvisorMessageUsageIterationType](../components/anthropicadvisormessageusageiterationtype.mdx) | :heavy_check_mark:                                                                                                 | N/A                                                                                                                |                                                                                                                    |

docs/components/anthropicadvisormessageusageiterationtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicAdvisorMessageUsageIterationType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicAdvisorMessageUsageIterationType
+value: AnthropicAdvisorMessageUsageIterationType = "advisor_message"
+```
+
+
+## Values
+
+- `"advisor_message"`

docs/components/anthropicallowedcallers.mdx

@@ -0,0 +1,21 @@
+---
+title: "AnthropicAllowedCallers"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicAllowedCallers
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AnthropicAllowedCallers = "direct"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"direct"`
+- `"code_execution_20250825"`
+- `"code_execution_20260120"`

docs/components/anthropicbase64imagesource.mdx

@@ -0,0 +1,11 @@
+---
+title: "AnthropicBase64ImageSource"
+---
+
+## Fields
+
+| Field                                                                                        | Type                                                                                         | Required                                                                                     | Description                                                                                  | Example                                                                                      |
+| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `data`                                                                                       | *str*                                                                                        | :heavy_check_mark:                                                                           | N/A                                                                                          |                                                                                              |
+| `media_type`                                                                                 | [components.AnthropicImageMimeType](../components/anthropicimagemimetype.mdx)                 | :heavy_check_mark:                                                                           | N/A                                                                                          | image/jpeg                                                                                   |
+| `type`                                                                                       | [components.AnthropicBase64ImageSourceType](../components/anthropicbase64imagesourcetype.mdx) | :heavy_check_mark:                                                                           | N/A                                                                                          |                                                                                              |

docs/components/anthropicbase64imagesourcetype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicBase64ImageSourceType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicBase64ImageSourceType
+value: AnthropicBase64ImageSourceType = "base64"
+```
+
+
+## Values
+
+- `"base64"`

docs/components/anthropicbase64pdfsource.mdx

@@ -0,0 +1,11 @@
+---
+title: "AnthropicBase64PdfSource"
+---
+
+## Fields
+
+| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `data`                                                                                             | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `media_type`                                                                                       | [components.AnthropicBase64PdfSourceMediaType](../components/anthropicbase64pdfsourcemediatype.mdx) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `type`                                                                                             | [components.AnthropicBase64PdfSourceType](../components/anthropicbase64pdfsourcetype.mdx)           | :heavy_check_mark:                                                                                 | N/A                                                                                                |

docs/components/anthropicbase64pdfsourcemediatype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicBase64PdfSourceMediaType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicBase64PdfSourceMediaType
+value: AnthropicBase64PdfSourceMediaType = "application/pdf"
+```
+
+
+## Values
+
+- `"application/pdf"`

docs/components/anthropicbase64pdfsourcetype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicBase64PdfSourceType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicBase64PdfSourceType
+value: AnthropicBase64PdfSourceType = "base64"
+```
+
+
+## Values
+
+- `"base64"`

docs/components/anthropiccachecontroldirective.mdx

@@ -0,0 +1,13 @@
+---
+title: "AnthropicCacheControlDirective"
+---
+
+Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. When set on an individual content block, it marks an explicit cache breakpoint; block-level markers also work on OpenAI models that support explicit prompt caching — OpenRouter converts them to the provider's native format.
+
+
+## Fields
+
+| Field                                                                                                | Type                                                                                                 | Required                                                                                             | Description                                                                                          | Example                                                                                              |
+| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `ttl`                                                                                                | [Optional[components.AnthropicCacheControlTTL]](../components/anthropiccachecontrolttl.mdx)           | :heavy_minus_sign:                                                                                   | N/A                                                                                                  | 5m                                                                                                   |
+| `type`                                                                                               | [components.AnthropicCacheControlDirectiveType](../components/anthropiccachecontroldirectivetype.mdx) | :heavy_check_mark:                                                                                   | N/A                                                                                                  |                                                                                                      |

docs/components/anthropiccachecontroldirectivetype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCacheControlDirectiveType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCacheControlDirectiveType
+value: AnthropicCacheControlDirectiveType = "ephemeral"
+```
+
+
+## Values
+
+- `"ephemeral"`

docs/components/anthropiccachecontrolttl.mdx

@@ -0,0 +1,20 @@
+---
+title: "AnthropicCacheControlTTL"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCacheControlTTL
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AnthropicCacheControlTTL = "5m"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"5m"`
+- `"1h"`

docs/components/anthropiccachecreation.mdx

@@ -0,0 +1,10 @@
+---
+title: "AnthropicCacheCreation"
+---
+
+## Fields
+
+| Field                       | Type                        | Required                    | Description                 |
+| --------------------------- | --------------------------- | --------------------------- | --------------------------- |
+| `ephemeral_1h_input_tokens` | *int*                       | :heavy_check_mark:          | N/A                         |
+| `ephemeral_5m_input_tokens` | *int*                       | :heavy_check_mark:          | N/A                         |

docs/components/anthropiccitationcharlocationparam.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicCitationCharLocationParam"
+---
+
+## Fields
+
+| Field                                                                                                        | Type                                                                                                         | Required                                                                                                     | Description                                                                                                  |
+| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `cited_text`                                                                                                 | *str*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `document_index`                                                                                             | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `document_title`                                                                                             | *Nullable[str]*                                                                                              | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `end_char_index`                                                                                             | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `start_char_index`                                                                                           | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `type`                                                                                                       | [components.AnthropicCitationCharLocationParamType](../components/anthropiccitationcharlocationparamtype.mdx) | :heavy_check_mark:                                                                                           | N/A                                                                                                          |

docs/components/anthropiccitationcharlocationparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationCharLocationParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCitationCharLocationParamType
+value: AnthropicCitationCharLocationParamType = "char_location"
+```
+
+
+## Values
+
+- `"char_location"`

docs/components/anthropiccitationcontentblocklocationparam.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicCitationContentBlockLocationParam"
+---
+
+## Fields
+
+| Field                                                                                                                        | Type                                                                                                                         | Required                                                                                                                     | Description                                                                                                                  |
+| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `cited_text`                                                                                                                 | *str*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `document_index`                                                                                                             | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `document_title`                                                                                                             | *Nullable[str]*                                                                                                              | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `end_block_index`                                                                                                            | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `start_block_index`                                                                                                          | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `type`                                                                                                                       | [components.AnthropicCitationContentBlockLocationParamType](../components/anthropiccitationcontentblocklocationparamtype.mdx) | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |

docs/components/anthropiccitationcontentblocklocationparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationContentBlockLocationParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCitationContentBlockLocationParamType
+value: AnthropicCitationContentBlockLocationParamType = "content_block_location"
+```
+
+
+## Values
+
+- `"content_block_location"`

docs/components/anthropiccitationpagelocationparam.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicCitationPageLocationParam"
+---
+
+## Fields
+
+| Field                                                                                                        | Type                                                                                                         | Required                                                                                                     | Description                                                                                                  |
+| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `cited_text`                                                                                                 | *str*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `document_index`                                                                                             | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `document_title`                                                                                             | *Nullable[str]*                                                                                              | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `end_page_number`                                                                                            | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `start_page_number`                                                                                          | *int*                                                                                                        | :heavy_check_mark:                                                                                           | N/A                                                                                                          |
+| `type`                                                                                                       | [components.AnthropicCitationPageLocationParamType](../components/anthropiccitationpagelocationparamtype.mdx) | :heavy_check_mark:                                                                                           | N/A                                                                                                          |

docs/components/anthropiccitationpagelocationparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationPageLocationParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCitationPageLocationParamType
+value: AnthropicCitationPageLocationParamType = "page_location"
+```
+
+
+## Values
+
+- `"page_location"`

docs/components/anthropiccitationsearchresultlocationparam.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationSearchResultLocationParam"
+---
+
+## Fields
+
+| Field                                                                                                                        | Type                                                                                                                         | Required                                                                                                                     | Description                                                                                                                  |
+| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `cited_text`                                                                                                                 | *str*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `end_block_index`                                                                                                            | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `search_result_index`                                                                                                        | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `source`                                                                                                                     | *str*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `start_block_index`                                                                                                          | *int*                                                                                                                        | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `title`                                                                                                                      | *Nullable[str]*                                                                                                              | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |
+| `type`                                                                                                                       | [components.AnthropicCitationSearchResultLocationParamType](../components/anthropiccitationsearchresultlocationparamtype.mdx) | :heavy_check_mark:                                                                                                           | N/A                                                                                                                          |

docs/components/anthropiccitationsearchresultlocationparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationSearchResultLocationParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCitationSearchResultLocationParamType
+value: AnthropicCitationSearchResultLocationParamType = "search_result_location"
+```
+
+
+## Values
+
+- `"search_result_location"`

docs/components/anthropiccitationwebsearchresultlocationparam.mdx

@@ -0,0 +1,13 @@
+---
+title: "AnthropicCitationWebSearchResultLocationParam"
+---
+
+## Fields
+
+| Field                                                                                                                              | Type                                                                                                                               | Required                                                                                                                           | Description                                                                                                                        |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `cited_text`                                                                                                                       | *str*                                                                                                                              | :heavy_check_mark:                                                                                                                 | N/A                                                                                                                                |
+| `encrypted_index`                                                                                                                  | *str*                                                                                                                              | :heavy_check_mark:                                                                                                                 | N/A                                                                                                                                |
+| `title`                                                                                                                            | *Nullable[str]*                                                                                                                    | :heavy_check_mark:                                                                                                                 | N/A                                                                                                                                |
+| `type`                                                                                                                             | [components.AnthropicCitationWebSearchResultLocationParamType](../components/anthropiccitationwebsearchresultlocationparamtype.mdx) | :heavy_check_mark:                                                                                                                 | N/A                                                                                                                                |
+| `url`                                                                                                                              | *str*                                                                                                                              | :heavy_check_mark:                                                                                                                 | N/A                                                                                                                                |

docs/components/anthropiccitationwebsearchresultlocationparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCitationWebSearchResultLocationParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCitationWebSearchResultLocationParamType
+value: AnthropicCitationWebSearchResultLocationParamType = "web_search_result_location"
+```
+
+
+## Values
+
+- `"web_search_result_location"`

docs/components/anthropiccompactionusageiteration.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicCompactionUsageIteration"
+---
+
+## Fields
+
+| Field                                                                                                            | Type                                                                                                             | Required                                                                                                         | Description                                                                                                      | Example                                                                                                          |
+| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `cache_creation`                                                                                                 | [OptionalNullable[components.AnthropicIterationCacheCreation]](../components/anthropiciterationcachecreation.mdx) | :heavy_minus_sign:                                                                                               | N/A                                                                                                              | \{<br/>"ephemeral_1h_input_tokens": 0,<br/>"ephemeral_5m_input_tokens": 0<br/>}                                   |
+| `cache_creation_input_tokens`                                                                                    | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `cache_read_input_tokens`                                                                                        | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `input_tokens`                                                                                                   | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `output_tokens`                                                                                                  | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `type`                                                                                                           | [components.AnthropicCompactionUsageIterationType](../components/anthropiccompactionusageiterationtype.mdx)       | :heavy_check_mark:                                                                                               | N/A                                                                                                              |                                                                                                                  |

docs/components/anthropiccompactionusageiterationtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicCompactionUsageIterationType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicCompactionUsageIterationType
+value: AnthropicCompactionUsageIterationType = "compaction"
+```
+
+
+## Values
+
+- `"compaction"`

docs/components/anthropicdocumentblockparam.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicDocumentBlockParam"
+---
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                      | Type                                                                                                                                                                                                                                                                                                                                                                                       | Required                                                                                                                                                                                                                                                                                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                | Example                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `cache_control`                                                                                                                                                                                                                                                                                                                                                                            | [Optional[components.AnthropicCacheControlDirective]](../components/anthropiccachecontroldirective.mdx)                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. When set on an individual content block, it marks an explicit cache breakpoint; block-level markers also work on OpenAI models that support explicit prompt caching — OpenRouter converts them to the provider's native format. | \{<br/>"type": "ephemeral"<br/>}                                                                                                                                                                                                                                                                                                                                                            |
+| `citations`                                                                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.AnthropicDocumentBlockParamCitations]](../components/anthropicdocumentblockparamcitations.mdx)                                                                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `context`                                                                                                                                                                                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `source`                                                                                                                                                                                                                                                                                                                                                                                   | [components.AnthropicDocumentBlockParamSourceUnion](../components/anthropicdocumentblockparamsourceunion.mdx)                                                                                                                                                                                                                                                                               | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `title`                                                                                                                                                                                                                                                                                                                                                                                    | *OptionalNullable[str]*                                                                                                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `type`                                                                                                                                                                                                                                                                                                                                                                                     | [components.TypeDocument](../components/typedocument.mdx)                                                                                                                                                                                                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |

docs/components/anthropicdocumentblockparamcitations.mdx

@@ -0,0 +1,9 @@
+---
+title: "AnthropicDocumentBlockParamCitations"
+---
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `enabled`          | *Optional[bool]*   | :heavy_minus_sign: | N/A                |

docs/components/anthropicdocumentblockparamcontent1.mdx

@@ -0,0 +1,18 @@
+---
+title: "AnthropicDocumentBlockParamContent1"
+---
+
+## Supported Types
+
+### `components.AnthropicImageBlockParam`
+
+```python
+value: components.AnthropicImageBlockParam = /* values here */
+```
+
+### `components.AnthropicTextBlockParam`
+
+```python
+value: components.AnthropicTextBlockParam = /* values here */
+```
+

docs/components/anthropicdocumentblockparamcontent2.mdx

@@ -0,0 +1,18 @@
+---
+title: "AnthropicDocumentBlockParamContent2"
+---
+
+## Supported Types
+
+### `str`
+
+```python
+value: str = /* values here */
+```
+
+### `List[components.AnthropicDocumentBlockParamContent1]`
+
+```python
+value: List[components.AnthropicDocumentBlockParamContent1] = /* values here */
+```
+

docs/components/anthropicdocumentblockparamsourceunion.mdx

@@ -0,0 +1,36 @@
+---
+title: "AnthropicDocumentBlockParamSourceUnion"
+---
+
+## Supported Types
+
+### `components.AnthropicBase64PdfSource`
+
+```python
+value: components.AnthropicBase64PdfSource = /* values here */
+```
+
+### `components.AnthropicPlainTextSource`
+
+```python
+value: components.AnthropicPlainTextSource = /* values here */
+```
+
+### `components.SourceContent`
+
+```python
+value: components.SourceContent = /* values here */
+```
+
+### `components.AnthropicURLPdfSource`
+
+```python
+value: components.AnthropicURLPdfSource = /* values here */
+```
+
+### `components.AnthropicFileDocumentSource`
+
+```python
+value: components.AnthropicFileDocumentSource = /* values here */
+```
+

docs/components/anthropicfiledocumentsource.mdx

@@ -0,0 +1,10 @@
+---
+title: "AnthropicFileDocumentSource"
+---
+
+## Fields
+
+| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `file_id`                                                                                      | *str*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `type`                                                                                         | [components.AnthropicFileDocumentSourceType](../components/anthropicfiledocumentsourcetype.mdx) | :heavy_check_mark:                                                                             | N/A                                                                                            |

docs/components/anthropicfiledocumentsourcetype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicFileDocumentSourceType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicFileDocumentSourceType
+value: AnthropicFileDocumentSourceType = "file"
+```
+
+
+## Values
+
+- `"file"`

docs/components/anthropicimageblockparam.mdx

@@ -0,0 +1,11 @@
+---
+title: "AnthropicImageBlockParam"
+---
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                      | Type                                                                                                                                                                                                                                                                                                                                                                                       | Required                                                                                                                                                                                                                                                                                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                | Example                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `cache_control`                                                                                                                                                                                                                                                                                                                                                                            | [Optional[components.AnthropicCacheControlDirective]](../components/anthropiccachecontroldirective.mdx)                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. When set on an individual content block, it marks an explicit cache breakpoint; block-level markers also work on OpenAI models that support explicit prompt caching — OpenRouter converts them to the provider's native format. | \{<br/>"type": "ephemeral"<br/>}                                                                                                                                                                                                                                                                                                                                                            |
+| `source`                                                                                                                                                                                                                                                                                                                                                                                   | [components.AnthropicImageBlockParamSource](../components/anthropicimageblockparamsource.mdx)                                                                                                                                                                                                                                                                                               | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `type`                                                                                                                                                                                                                                                                                                                                                                                     | [components.AnthropicImageBlockParamType](../components/anthropicimageblockparamtype.mdx)                                                                                                                                                                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |

docs/components/anthropicimageblockparamsource.mdx

@@ -0,0 +1,18 @@
+---
+title: "AnthropicImageBlockParamSource"
+---
+
+## Supported Types
+
+### `components.AnthropicBase64ImageSource`
+
+```python
+value: components.AnthropicBase64ImageSource = /* values here */
+```
+
+### `components.AnthropicURLImageSource`
+
+```python
+value: components.AnthropicURLImageSource = /* values here */
+```
+

docs/components/anthropicimageblockparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicImageBlockParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicImageBlockParamType
+value: AnthropicImageBlockParamType = "image"
+```
+
+
+## Values
+
+- `"image"`

docs/components/anthropicimagemimetype.mdx

@@ -0,0 +1,22 @@
+---
+title: "AnthropicImageMimeType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicImageMimeType
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AnthropicImageMimeType = "image/jpeg"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"image/jpeg"`
+- `"image/png"`
+- `"image/gif"`
+- `"image/webp"`

docs/components/anthropicinputtokensclearatleast.mdx

@@ -0,0 +1,10 @@
+---
+title: "AnthropicInputTokensClearAtLeast"
+---
+
+## Fields
+
+| Field                                                                                                    | Type                                                                                                     | Required                                                                                                 | Description                                                                                              |
+| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `type`                                                                                                   | [components.AnthropicInputTokensClearAtLeastType](../components/anthropicinputtokensclearatleasttype.mdx) | :heavy_check_mark:                                                                                       | N/A                                                                                                      |
+| `value`                                                                                                  | *int*                                                                                                    | :heavy_check_mark:                                                                                       | N/A                                                                                                      |

docs/components/anthropicinputtokensclearatleasttype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicInputTokensClearAtLeastType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicInputTokensClearAtLeastType
+value: AnthropicInputTokensClearAtLeastType = "input_tokens"
+```
+
+
+## Values
+
+- `"input_tokens"`

docs/components/anthropicinputtokenstrigger.mdx

@@ -0,0 +1,10 @@
+---
+title: "AnthropicInputTokensTrigger"
+---
+
+## Fields
+
+| Field                                                                                          | Type                                                                                           | Required                                                                                       | Description                                                                                    |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `type`                                                                                         | [components.AnthropicInputTokensTriggerType](../components/anthropicinputtokenstriggertype.mdx) | :heavy_check_mark:                                                                             | N/A                                                                                            |
+| `value`                                                                                        | *int*                                                                                          | :heavy_check_mark:                                                                             | N/A                                                                                            |

docs/components/anthropicinputtokenstriggertype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicInputTokensTriggerType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicInputTokensTriggerType
+value: AnthropicInputTokensTriggerType = "input_tokens"
+```
+
+
+## Values
+
+- `"input_tokens"`

docs/components/anthropiciterationcachecreation.mdx

@@ -0,0 +1,10 @@
+---
+title: "AnthropicIterationCacheCreation"
+---
+
+## Fields
+
+| Field                       | Type                        | Required                    | Description                 |
+| --------------------------- | --------------------------- | --------------------------- | --------------------------- |
+| `ephemeral_1h_input_tokens` | *Optional[int]*             | :heavy_minus_sign:          | N/A                         |
+| `ephemeral_5m_input_tokens` | *Optional[int]*             | :heavy_minus_sign:          | N/A                         |

docs/components/anthropicmessageusageiteration.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicMessageUsageIteration"
+---
+
+## Fields
+
+| Field                                                                                                            | Type                                                                                                             | Required                                                                                                         | Description                                                                                                      | Example                                                                                                          |
+| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `cache_creation`                                                                                                 | [OptionalNullable[components.AnthropicIterationCacheCreation]](../components/anthropiciterationcachecreation.mdx) | :heavy_minus_sign:                                                                                               | N/A                                                                                                              | \{<br/>"ephemeral_1h_input_tokens": 0,<br/>"ephemeral_5m_input_tokens": 0<br/>}                                   |
+| `cache_creation_input_tokens`                                                                                    | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `cache_read_input_tokens`                                                                                        | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `input_tokens`                                                                                                   | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `output_tokens`                                                                                                  | *Optional[int]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `model`                                                                                                          | *Optional[str]*                                                                                                  | :heavy_minus_sign:                                                                                               | N/A                                                                                                              |                                                                                                                  |
+| `type`                                                                                                           | [components.AnthropicMessageUsageIterationType](../components/anthropicmessageusageiterationtype.mdx)             | :heavy_check_mark:                                                                                               | N/A                                                                                                              |                                                                                                                  |

docs/components/anthropicmessageusageiterationtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicMessageUsageIterationType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicMessageUsageIterationType
+value: AnthropicMessageUsageIterationType = "message"
+```
+
+
+## Values
+
+- `"message"`

docs/components/anthropicplaintextsource.mdx

@@ -0,0 +1,11 @@
+---
+title: "AnthropicPlainTextSource"
+---
+
+## Fields
+
+| Field                                                                                              | Type                                                                                               | Required                                                                                           | Description                                                                                        |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `data`                                                                                             | *str*                                                                                              | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `media_type`                                                                                       | [components.AnthropicPlainTextSourceMediaType](../components/anthropicplaintextsourcemediatype.mdx) | :heavy_check_mark:                                                                                 | N/A                                                                                                |
+| `type`                                                                                             | [components.AnthropicPlainTextSourceType](../components/anthropicplaintextsourcetype.mdx)           | :heavy_check_mark:                                                                                 | N/A                                                                                                |

docs/components/anthropicplaintextsourcemediatype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicPlainTextSourceMediaType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicPlainTextSourceMediaType
+value: AnthropicPlainTextSourceMediaType = "text/plain"
+```
+
+
+## Values
+
+- `"text/plain"`

docs/components/anthropicplaintextsourcetype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicPlainTextSourceType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicPlainTextSourceType
+value: AnthropicPlainTextSourceType = "text"
+```
+
+
+## Values
+
+- `"text"`

docs/components/anthropicsearchresultblockparam.mdx

@@ -0,0 +1,14 @@
+---
+title: "AnthropicSearchResultBlockParam"
+---
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                      | Type                                                                                                                                                                                                                                                                                                                                                                                       | Required                                                                                                                                                                                                                                                                                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                | Example                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `cache_control`                                                                                                                                                                                                                                                                                                                                                                            | [Optional[components.AnthropicCacheControlDirective]](../components/anthropiccachecontroldirective.mdx)                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. When set on an individual content block, it marks an explicit cache breakpoint; block-level markers also work on OpenAI models that support explicit prompt caching — OpenRouter converts them to the provider's native format. | \{<br/>"type": "ephemeral"<br/>}                                                                                                                                                                                                                                                                                                                                                            |
+| `citations`                                                                                                                                                                                                                                                                                                                                                                                | [Optional[components.AnthropicSearchResultBlockParamCitations]](../components/anthropicsearchresultblockparamcitations.mdx)                                                                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `content`                                                                                                                                                                                                                                                                                                                                                                                  | List[[components.AnthropicTextBlockParam](../components/anthropictextblockparam.mdx)]                                                                                                                                                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `source`                                                                                                                                                                                                                                                                                                                                                                                   | *str*                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `title`                                                                                                                                                                                                                                                                                                                                                                                    | *str*                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `type`                                                                                                                                                                                                                                                                                                                                                                                     | [components.AnthropicSearchResultBlockParamType](../components/anthropicsearchresultblockparamtype.mdx)                                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |

docs/components/anthropicsearchresultblockparamcitations.mdx

@@ -0,0 +1,9 @@
+---
+title: "AnthropicSearchResultBlockParamCitations"
+---
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `enabled`          | *Optional[bool]*   | :heavy_minus_sign: | N/A                |

docs/components/anthropicsearchresultblockparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicSearchResultBlockParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicSearchResultBlockParamType
+value: AnthropicSearchResultBlockParamType = "search_result"
+```
+
+
+## Values
+
+- `"search_result"`

docs/components/anthropicspeed.mdx

@@ -0,0 +1,20 @@
+---
+title: "AnthropicSpeed"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicSpeed
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AnthropicSpeed = "fast"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"fast"`
+- `"standard"`

docs/components/anthropictextblockparam.mdx

@@ -0,0 +1,12 @@
+---
+title: "AnthropicTextBlockParam"
+---
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                      | Type                                                                                                                                                                                                                                                                                                                                                                                       | Required                                                                                                                                                                                                                                                                                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                | Example                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `cache_control`                                                                                                                                                                                                                                                                                                                                                                            | [Optional[components.AnthropicCacheControlDirective]](../components/anthropiccachecontroldirective.mdx)                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. When set on an individual content block, it marks an explicit cache breakpoint; block-level markers also work on OpenAI models that support explicit prompt caching — OpenRouter converts them to the provider's native format. | \{<br/>"type": "ephemeral"<br/>}                                                                                                                                                                                                                                                                                                                                                            |
+| `citations`                                                                                                                                                                                                                                                                                                                                                                                | List[[components.Citation](../components/citation.mdx)]                                                                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `text`                                                                                                                                                                                                                                                                                                                                                                                     | *str*                                                                                                                                                                                                                                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |
+| `type`                                                                                                                                                                                                                                                                                                                                                                                     | [components.AnthropicTextBlockParamType](../components/anthropictextblockparamtype.mdx)                                                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                         | N/A                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                            |

docs/components/anthropictextblockparamtype.mdx

@@ -0,0 +1,15 @@
+---
+title: "AnthropicTextBlockParamType"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicTextBlockParamType
+value: AnthropicTextBlockParamType = "text"
+```
+
+
+## Values
+
+- `"text"`

docs/components/anthropicthinkingdisplay.mdx

@@ -0,0 +1,20 @@
+---
+title: "AnthropicThinkingDisplay"
+---
+
+## Example Usage
+
+```python
+from openrouter.components import AnthropicThinkingDisplay
+
+# Open enum: unrecognized values are captured as UnrecognizedStr
+value: AnthropicThinkingDisplay = "summarized"
+```
+
+
+## Values
+
+This is an open enum. Unrecognized values will not fail type checks.
+
+- `"summarized"`
+- `"omitted"`