docs: add Synoppy tools integration (python)

.deepagents/skills/docs-code-samples/SKILL.md

@@ -150,7 +150,7 @@ Place `:remove-start:` blocks **after** the snippet when you can, so the harness
 # :snippet-start: example-py
 from deepagents import create_deep_agent
 
-agent = create_deep_agent(model="google_genai:gemini-3.5-flash")
+agent = create_deep_agent(model="google_genai:gemini-3.6-flash")
 # :snippet-end:
 
 # :remove-start:

.github/vale/styles/write-good/Illusions.yml

@@ -1,6 +1,7 @@
 extends: repetition
 message: "'%s' is repeated!"
 level: error
+ignorecase: true
 alpha: true
 action:
  name: edit

.github/workflows/check-deprecated.yml

@@ -25,9 +25,11 @@ jobs:
           persist-credentials: false
 
       - name: Check for create_react_agent in diff
+        env:
+          BASE_REF: ${{ github.base_ref }}
         run: |
           # Get the diff of added lines only (lines starting with +, excluding the +++ header)
-          ADDED_LINES=$(git diff origin/${{ github.base_ref }}...HEAD --diff-filter=ACMR -- '*.py' '*.md' '*.mdx' '*.ipynb' | grep -E '^\+' | grep -v '^\+\+\+' || true)
+          ADDED_LINES=$(git diff "origin/$BASE_REF"...HEAD --diff-filter=ACMR -- '*.py' '*.md' '*.mdx' '*.ipynb' | grep -E '^\+' | grep -v '^\+\+\+' || true)
 
           # Check if any added lines contain create_react_agent
           if echo "$ADDED_LINES" | grep -q 'create_react_agent'; then

.github/workflows/check-external-doc-links.yml

@@ -24,9 +24,11 @@ jobs:
           persist-credentials: false
 
       - name: Check for links to js.langchain.com and python.langchain.com
+        env:
+          BASE_REF: ${{ github.base_ref }}
         run: |
           # Get the diff of added lines only (lines starting with +, excluding the +++ header)
-          ADDED_LINES=$(git diff origin/${{ github.base_ref }}...HEAD --diff-filter=ACMR -- '*.md' '*.mdx' | grep -E '^\+' | grep -v '^\+\+\+' || true)
+          ADDED_LINES=$(git diff "origin/$BASE_REF"...HEAD --diff-filter=ACMR -- '*.md' '*.mdx' | grep -E '^\+' | grep -v '^\+\+\+' || true)
 
           # Check if any added lines contain links to the old doc sites
           if echo "$ADDED_LINES" | grep -qE '(js\.langchain\.com|python\.langchain\.com)'; then

.github/workflows/check-removed-pages-redirects.yml

@@ -21,18 +21,23 @@ jobs:
           fetch-depth: 0
 
       - name: Fetch base branch
-        run: git fetch origin "${{ github.base_ref }}"
+        env:
+          BASE_REF: ${{ github.base_ref }}
+        run: git fetch origin "$BASE_REF"
 
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: "3.13"
 
       - name: Get base branch docs.json
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          BASE_REF_NAME: ${{ github.base_ref }}
         run: |
-          BASE_REF="${{ github.event.pull_request.base.sha }}"
+          BASE_REF="$BASE_SHA"
           if [ -z "$BASE_REF" ]; then
-            BASE_REF="origin/${{ github.base_ref }}"
+            BASE_REF="origin/$BASE_REF_NAME"
           fi
           git show "${BASE_REF}:src/docs.json" > base_docs.json
 

.github/workflows/ci.yml

@@ -98,6 +98,22 @@ jobs:
           python-version: "3.13"
       - run: uv sync --group test
       - run: make check-cross-refs
+  check-external-docs-urls:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+      - uses: "./.github/actions/uv_setup"
+        with:
+          python-version: "3.13"
+      - run: uv sync --group test
+      - name: Validate docs_url schemes in integration_external_docs.yaml
+        run: uv run python scripts/refresh_integration_downloads.py --check-docs-urls
   check-generated-files:
     permissions:
       contents: read

.github/workflows/create-preview-branch.yml

@@ -31,14 +31,15 @@ jobs:
           fetch-depth: 0
 
       - name: Delete preview branches for this PR
+        env:
+          SOURCE_BRANCH: ${{ github.event.pull_request.head.ref }}
         run: |
           set -euo pipefail
 
           PR_STATE="${{ github.event.pull_request.merged && 'merged' || 'closed' }}"
           echo "[INFO] Cleaning up preview branches for $PR_STATE PR #${{ github.event.pull_request.number }}"
 
           # Get the source branch name
-          SOURCE_BRANCH="${{ github.event.pull_request.head.ref }}"
           echo "[INFO] Source branch: $SOURCE_BRANCH"
 
           # Generate the safe prefix that would have been used for this branch

.github/workflows/external-integration-pr-comment.yml

@@ -118,6 +118,8 @@ jobs:
               marker,
               `Thanks for contributing a new integration docs page, @${author}!`,
               '',
+              'As of July 28, 2026, we have changed how we accept external integrations submissions. Please review the [new integration submission process](https://docs.langchain.com/oss/python/contributing/publish-langchain#make-your-integration-discoverable) for more information.',
+              '',
               'We receive a large number of PRs and review them as quickly as we can. Please bear with us as we work through the queue.',
               '',
               'If you have already tagged a maintainer on this PR, do not tag them again.',

.github/workflows/lint-prose.yml

@@ -24,7 +24,8 @@ jobs:
       - name: Get changed doc files
         id: changed-files
         run: |
-          BASE="${{ github.event.pull_request.base.sha }}"
+          BASE_REF="${{ github.event.pull_request.base.ref }}"
+          BASE=$(git merge-base HEAD "origin/$BASE_REF")
           FILES=$(git diff --name-only --diff-filter=ACMRTUXB "$BASE" HEAD -- src/ |
             grep -E '\.(md|mdx)$' || true)
           if [ -z "$FILES" ]; then

.github/workflows/refresh-langsmith-openapi.yml

@@ -3,8 +3,8 @@ name: Refresh LangSmith OpenAPI spec
 
 on:
   schedule:
-    # Weekly on Monday at 10:00 AM UTC
-    - cron: "0 10 * * 1"
+    # Daily at 10:00 AM UTC
+    - cron: "0 10 * * *"
   workflow_dispatch: {}
 
 jobs:
@@ -59,7 +59,7 @@ jobs:
             --title "chore: refresh LangSmith platform OpenAPI spec" \
             --body "$(cat <<'EOF'
           ## Summary
-          Automated weekly refresh of the LangSmith Platform API spec.
+          Automated daily refresh of the LangSmith Platform API spec.
 
           ## Details
           - Fetched latest spec from api.smith.langchain.com

.github/workflows/test-code-samples-linear.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Create Linear issue
-        uses: ctriolo/action-create-linear-issue@v1.3
+        uses: ctriolo/action-create-linear-issue@699c7c2f0639181e0eaf5622d2987c6584f48a5a # v0.7
         with:
           linear-api-key: ${{ secrets.LINEAR_API_KEY }}
           linear-team-key: ${{ vars.LINEAR_TEAM_KEY }}

.github/workflows/test-code-samples.yml

@@ -5,10 +5,10 @@ permissions:
   contents: read
 
 on:
-#  pull_request:
-#    paths:
-#      - "src/code-samples/**"
-#      - ".github/workflows/test-code-samples.yml"
+  pull_request:
+    paths:
+      - "src/code-samples/**"
+      - ".github/workflows/test-code-samples.yml"
   workflow_dispatch:
   schedule:
     # Run every Sunday at 00:00 UTC
@@ -47,18 +47,22 @@ jobs:
 
       - name: Get modified code sample paths
         id: files
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          PR_BASE_REF: ${{ github.event.pull_request.base.ref }}
+          BEFORE_SHA: ${{ github.event.before }}
         run: |
-          if [[ "${{ github.event_name }}" == "schedule" || "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+          if [[ "$EVENT_NAME" == "schedule" || "$EVENT_NAME" == "workflow_dispatch" ]]; then
             echo "run_all=true" >> "$GITHUB_OUTPUT"
             echo "Full run: testing all code samples"
           else
             echo "run_all=false" >> "$GITHUB_OUTPUT"
 
-            if [[ "${{ github.event_name }}" == "pull_request" ]]; then
-              git fetch origin "${{ github.event.pull_request.base.ref }}"
-              BASE=$(git merge-base HEAD origin/${{ github.event.pull_request.base.ref }})
+            if [[ "$EVENT_NAME" == "pull_request" ]]; then
+              git fetch origin "$PR_BASE_REF"
+              BASE=$(git merge-base HEAD "origin/$PR_BASE_REF")
             else
-              BASE="${{ github.event.before }}"
+              BASE="$BEFORE_SHA"
             fi
 
             FILES=$(git diff --name-only "$BASE" HEAD -- src/code-samples/ \
@@ -126,19 +130,24 @@ jobs:
         id: test
         env:
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          ANTHROPIC_BASE_URL: ${{ secrets.ANTHROPIC_BASE_URL }}
+          ANTHROPIC_CUSTOM_HEADERS: ${{ secrets.ANTHROPIC_CUSTOM_HEADERS }}
+          LS_GATEWAY_KEY: ${{ secrets.LS_GATEWAY_KEY }}
           LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           POSTGRES_URI: postgresql://postgres:postgres@127.0.0.1:5432/postgres?sslmode=disable
           TAVILY_API_KEY: ${{ secrets.TAVILY_API_KEY }}
           GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
           DAYTONA_API_KEY: ${{ secrets.DAYTONA_API_KEY }}
           DAYTONA_API_URL: ${{ secrets.DAYTONA_API_URL }}
+          RUN_ALL: ${{ steps.files.outputs.run_all }}
+          MODIFIED_FILES: ${{ steps.files.outputs.files }}
         run: |
-          if [[ "${{ steps.files.outputs.run_all }}" == "true" ]]; then
+          if [[ "$RUN_ALL" == "true" ]]; then
             echo "Running all code samples..."
             make test-code-samples
           else
-            FILES="${{ steps.files.outputs.files }}"
+            FILES="$MODIFIED_FILES"
             FILES=$(echo "$FILES" | tr -d '\n' | xargs)
             if [[ -z "$FILES" ]]; then
               echo "No code samples to test"

.github/workflows/update-package-downloads.yml

@@ -11,7 +11,7 @@ jobs:
   generate-downloads:
     name: Generate package download counts
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    timeout-minutes: 60
     permissions:
       contents: read
     steps:
@@ -40,13 +40,33 @@ jobs:
         run: |
           uv run python pipeline/tools/partner_pkg_table.py
 
+      - name: Generate integration download tables
+        run: |
+          uv run python scripts/refresh_integration_downloads.py --write
+
+      - name: Flag external integrations for hosted docs
+        env:
+          LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
+          LINEAR_TEAM_KEY: ${{ vars.LINEAR_TEAM_KEY }}
+        run: |
+          # Creates Linear issues for external-table integrations that now meet
+          # the hosted-docs download threshold (~50k/mo). Dedupes open issues.
+          if [ -z "${LINEAR_API_KEY}" ] || [ -z "${LINEAR_TEAM_KEY}" ]; then
+            echo "LINEAR_API_KEY or LINEAR_TEAM_KEY unset; running dry-run only"
+            uv run python scripts/flag_hosted_docs_candidates.py
+          else
+            uv run python scripts/flag_hosted_docs_candidates.py --create
+          fi
+
       - name: Upload updated files as artifact
         uses: actions/upload-artifact@v6
         with:
           name: packages-yml
           path: |
             packages.yml
             src/oss/python/integrations/providers/overview.mdx
+            src/snippets/oss/*-downloads.mdx
+            src/snippets/oss/*-featured.mdx
           retention-days: 1
 
   commit-downloads:
@@ -75,7 +95,9 @@ jobs:
           git config --global user.email "github-actions[bot]@users.noreply.github.com"
 
           # Check if there are changes
-          if git diff --quiet packages.yml src/oss/python/integrations/providers/overview.mdx; then
+          if git diff --quiet packages.yml \
+            src/oss/python/integrations/providers/overview.mdx \
+            src/snippets/oss; then
             echo "No changes to commit"
             exit 0
           fi
@@ -85,12 +107,15 @@ jobs:
           git checkout -b "$BRANCH_NAME"
 
           # Commit changes
-          git add packages.yml src/oss/python/integrations/providers/overview.mdx
+          git add packages.yml \
+            src/oss/python/integrations/providers/overview.mdx \
+            src/snippets/oss/*-downloads.mdx \
+            src/snippets/oss/*-featured.mdx
           git commit -m "$(cat <<'EOF'
           chore: update package download counts
 
           🤖 Automated update of package download statistics from pepy.tech
-          and regenerated provider overview page
+          and npm, regenerated provider overview and integration tables
 
           Generated with GitHub Actions workflow update-package-downloads.yml
           EOF
@@ -104,11 +129,12 @@ jobs:
             --title "chore: update package download counts" \
             --body "$(cat <<'EOF'
           ## Summary
-          Automated update of package download statistics from pepy.tech
+          Automated update of package download statistics from pepy.tech and npm
 
           ## Details
           - Updates download counts in `packages.yml`
           - Regenerates provider overview page at `src/oss/python/integrations/providers/overview.mdx`
+          - Regenerates integration download tables under `src/snippets/oss/`
           - Generated by GitHub Actions workflow `update-package-downloads.yml`
           - Scheduled to run every Sunday at 11:59 PM UTC
 

.mcp.json

@@ -4,7 +4,7 @@
       "type": "http",
       "url": "https://docs.langchain.com/mcp"
     },
-    "docs-langchain-reference": {
+    "reference-langchain": {
       "type": "http",
       "url": "https://reference.langchain.com/mcp"
     },

.node-version

@@ -0,0 +1 @@
+22

AGENTS.md

@@ -119,6 +119,13 @@ Flat groups (no tabs):
 
 See [Contributing to documentation](/oss/contributing/documentation) for setup instructions.
 
+### Command-line tools
+
+Two distinct binaries drive local work. Do not assume `mint` is the only command just because the `Makefile` targets shell out to it: `docs` is a first-class, preferred entry point installed separately via Python:
+
+- **`docs`**: The primary CLI, a Python console script (`docs = "pipeline.cli:main"` in `pyproject.toml`) installed into the virtualenv by `uv sync` (the first step of `make install`). Provides `docs dev`, `docs build`, `docs migrate`, and `docs mv`. The `make` targets wrap this CLI. If `docs` is not found after `make install`, relaunch your shell (or activate the venv) so `.venv/bin/docs` lands on `PATH`.
+- **`mint`**: Mintlify's CLI, a separate global npm binary (`npm install -g mint@latest`). The build targets shell out to it for `mint dev`, `mint broken-links`, and `mint export`.
+
 ## Frontmatter
 
 Every MDX file requires:
@@ -280,6 +287,22 @@ These are common nouns, not proper nouns. Write them lowercase in prose, includi
 - Spell out "generally available" on first use, then use "GA". GA is always uppercase.
 - Do not change code identifiers, package version identifiers (`1.0.0b1`), or literal CLI output that contains "Beta".
 
+### Product and feature name capitalization
+
+Capitalize a word when it refers to a **product or brand name**. Use lowercase when it refers to a **common noun** — a thing you build, an instance, or a type.
+
+**Capitalize** product and brand names:
+
+- LangChain, LangGraph, LangSmith, Deep Agents, Fleet, Engine
+
+**Lowercase** common nouns (things you create, instances, or types):
+
+- "Create a dashboard" (dashboard = a thing you build, not a product name)
+- "a deep agent created using Deep Agents" (the first "deep agent" is a common noun; "Deep Agents" is the product name)
+- "Run an experiment", "View your traces", "Manage your projects"
+
+When in doubt, ask: is this word the product's proper name, or is it describing a thing the user creates or works with? If the latter, use lowercase.
+
 ## Adding pages
 
 1. Create MDX file with required frontmatter in the correct directory (see navigation map above)

CLAUDE.md

@@ -119,6 +119,13 @@ Flat groups (no tabs):
 
 See [Contributing to documentation](/oss/contributing/documentation) for setup instructions.
 
+### Command-line tools
+
+Two distinct binaries drive local work. Do not assume `mint` is the only command just because the `Makefile` targets shell out to it: `docs` is a first-class, preferred entry point installed separately via Python:
+
+- **`docs`**: The primary CLI, a Python console script (`docs = "pipeline.cli:main"` in `pyproject.toml`) installed into the virtualenv by `uv sync` (the first step of `make install`). Provides `docs dev`, `docs build`, `docs migrate`, and `docs mv`. The `make` targets wrap this CLI. If `docs` is not found after `make install`, relaunch your shell (or activate the venv) so `.venv/bin/docs` lands on `PATH`.
+- **`mint`**: Mintlify's CLI, a separate global npm binary (`npm install -g mint@latest`). The build targets shell out to it for `mint dev`, `mint broken-links`, and `mint export`.
+
 ## Frontmatter
 
 Every MDX file requires:
@@ -280,6 +287,22 @@ These are common nouns, not proper nouns. Write them lowercase in prose, includi
 - Spell out "generally available" on first use, then use "GA". GA is always uppercase.
 - Do not change code identifiers, package version identifiers (`1.0.0b1`), or literal CLI output that contains "Beta".
 
+### Product and feature name capitalization
+
+Capitalize a word when it refers to a **product or brand name**. Use lowercase when it refers to a **common noun** — a thing you build, an instance, or a type.
+
+**Capitalize** product and brand names:
+
+- LangChain, LangGraph, LangSmith, Deep Agents, Fleet, Engine
+
+**Lowercase** common nouns (things you create, instances, or types):
+
+- "Create a dashboard" (dashboard = a thing you build, not a product name)
+- "a deep agent created using Deep Agents" (the first "deep agent" is a common noun; "Deep Agents" is the product name)
+- "Run an experiment", "View your traces", "Manage your projects"
+
+When in doubt, ask: is this word the product's proper name, or is it describing a thing the user creates or works with? If the latter, use lowercase.
+
 ## Adding pages
 
 1. Create MDX file with required frontmatter in the correct directory (see navigation map above)