cleanup

.github/CODEOWNERS

@@ -1,3 +1,3 @@
-/.github/   @ccurme @eyurtsev @mdrxy
+/.github/   @baskaryan @ccurme @eyurtsev
 /libs/core/ @eyurtsev
 /libs/partners/ @ccurme @mdrxy

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -6,8 +6,6 @@ body:
   - type: markdown
     attributes:
       value: |
-        > **All contributions must be in English.** See the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy).
-
         Thank you for taking the time to file a bug report.
 
         For usage questions, feature requests and general design questions, please use the [LangChain Forum](https://forum.langchain.com/).
@@ -55,6 +53,7 @@ body:
         - label: langchain-anthropic
         - label: langchain-classic
         - label: langchain-core
+        - label: langchain-cli
         - label: langchain-model-profiles
         - label: langchain-tests
         - label: langchain-text-splitters
@@ -67,21 +66,11 @@ body:
         - label: langchain-mistralai
         - label: langchain-nomic
         - label: langchain-ollama
-        - label: langchain-openrouter
         - label: langchain-perplexity
+        - label: langchain-prompty
         - label: langchain-qdrant
         - label: langchain-xai
         - label: Other / not sure / general
-  - type: textarea
-    id: related
-    validations:
-      required: false
-    attributes:
-      label: Related Issues / PRs
-      description: |
-        If this bug is related to any existing issues or pull requests, please link them here.
-      placeholder: |
-        * e.g. #123, #456
   - type: textarea
     id: reproduction
     validations:

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -6,8 +6,6 @@ body:
   - type: markdown
     attributes:
       value: |
-        > **All contributions must be in English.** See the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy).
-
         Thank you for taking the time to request a new feature.
 
         Use this to request NEW FEATURES or ENHANCEMENTS in LangChain. For bug reports, please use the bug report template. For usage questions and general design questions, please use the [LangChain Forum](https://forum.langchain.com/).
@@ -20,8 +18,6 @@ body:
         * [LangChain ChatBot](https://chat.langchain.com/)
         * [GitHub search](https://github.com/langchain-ai/langchain),
         * [LangChain Forum](https://forum.langchain.com/),
-
-        **Note:** Do not begin work on a PR unless explicitly assigned to this issue by a maintainer.
   - type: checkboxes
     id: checks
     attributes:
@@ -54,6 +50,7 @@ body:
         - label: langchain-anthropic
         - label: langchain-classic
         - label: langchain-core
+        - label: langchain-cli
         - label: langchain-model-profiles
         - label: langchain-tests
         - label: langchain-text-splitters
@@ -66,8 +63,8 @@ body:
         - label: langchain-mistralai
         - label: langchain-nomic
         - label: langchain-ollama
-        - label: langchain-openrouter
         - label: langchain-perplexity
+        - label: langchain-prompty
         - label: langchain-qdrant
         - label: langchain-xai
         - label: Other / not sure / general

.github/ISSUE_TEMPLATE/privileged.yml

@@ -30,6 +30,7 @@ body:
         - label: langchain-anthropic
         - label: langchain-classic
         - label: langchain-core
+        - label: langchain-cli
         - label: langchain-model-profiles
         - label: langchain-tests
         - label: langchain-text-splitters
@@ -42,8 +43,8 @@ body:
         - label: langchain-mistralai
         - label: langchain-nomic
         - label: langchain-ollama
-        - label: langchain-openrouter
         - label: langchain-perplexity
+        - label: langchain-prompty
         - label: langchain-qdrant
         - label: langchain-xai
         - label: Other / not sure / general

.github/ISSUE_TEMPLATE/task.yml

@@ -101,6 +101,7 @@ body:
         - label: langchain-anthropic
         - label: langchain-classic
         - label: langchain-core
+        - label: langchain-cli
         - label: langchain-model-profiles
         - label: langchain-tests
         - label: langchain-text-splitters
@@ -113,8 +114,8 @@ body:
         - label: langchain-mistralai
         - label: langchain-nomic
         - label: langchain-ollama
-        - label: langchain-openrouter
         - label: langchain-perplexity
+        - label: langchain-prompty
         - label: langchain-qdrant
         - label: langchain-xai
         - label: Other / not sure / general

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,13 +1,7 @@
-Fixes #
-
-<!-- Replace everything above this line with a 1-2 sentence description of your change. Keep the "Fixes #xx" keyword and update the issue number. -->
+(Replace this entire block of text)
 
 Read the full contributing guidelines: https://docs.langchain.com/oss/python/contributing/overview
 
-> **All contributions must be in English.** See the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy).
-
-If you paste a large clearly AI generated description here your PR may be IGNORED or CLOSED!
-
 Thank you for contributing to LangChain! Follow these steps to have your pull request considered as ready for review.
 
 1. PR title: Should follow the format: TYPE(SCOPE): DESCRIPTION
@@ -21,23 +15,16 @@ Thank you for contributing to LangChain! Follow these steps to have your pull re
 2. PR description:
 
   - Write 1-2 sentences summarizing the change.
-  - The `Fixes #xx` line at the top is **required** for external contributions — update the issue number and keep the keyword. This links your PR to the approved issue and auto-closes it on merge.
+  - If this PR addresses a specific issue, please include "Fixes #ISSUE_NUMBER" in the description to automatically close the issue when the PR is merged.
   - If there are any breaking changes, please clearly describe them.
-  - If this PR depends on another PR being merged first, please include "Depends on #PR_NUMBER" in the description.
+  - If this PR depends on another PR being merged first, please include "Depends on #PR_NUMBER" inthe description.
 
 3. Run `make format`, `make lint` and `make test` from the root of the package(s) you've modified.
 
   - We will not consider a PR unless these three are passing in CI.
 
-4. How did you verify your code works?
-
 Additional guidelines:
 
-  - All external PRs must link to an issue or discussion where a solution has been approved by a maintainer, and you must be assigned to that issue. PRs without prior approval will be closed.
+  - We ask that if you use generative AI for your contribution, you include a disclaimer.
   - PRs should not touch more than one package unless absolutely necessary.
-  - Do not update the `uv.lock` files or add dependencies to `pyproject.toml` files (even optional ones) unless you have explicit permission to do so by a maintainer.
-
-## Social handles (optional)
-<!-- If you'd like a shoutout on release, add your socials below -->
-Twitter: @
-LinkedIn: https://linkedin.com/in/
+  - Do not update the `uv.lock` files unless or add dependencies to `pyproject.toml` files (even optional ones) unless you have explicit permission to do so by a maintainer.

.github/actions/uv_setup/action.yml

@@ -27,7 +27,7 @@ runs:
   using: composite
   steps:
     - name: Install uv and set the python version
-      uses: astral-sh/setup-uv@0ca8f610542aa7f4acaf39e65cf4eb3c35091883 # v7
+      uses: astral-sh/setup-uv@v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ inputs.python-version }}

.github/dependabot.yml

@@ -8,88 +8,4 @@ updates:
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "monthly"
-    groups:
-      minor-and-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-      major:
-        patterns:
-          - "*"
-        update-types:
-          - "major"
-
-  - package-ecosystem: "uv"
-    directories:
-      - "/libs/core/"
-      - "/libs/langchain/"
-      - "/libs/langchain_v1/"
-    schedule:
-      interval: "monthly"
-    groups:
-      minor-and-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-      major:
-        patterns:
-          - "*"
-        update-types:
-          - "major"
-
-  - package-ecosystem: "uv"
-    directories:
-      - "/libs/partners/anthropic/"
-      - "/libs/partners/chroma/"
-      - "/libs/partners/deepseek/"
-      - "/libs/partners/exa/"
-      - "/libs/partners/fireworks/"
-      - "/libs/partners/groq/"
-      - "/libs/partners/huggingface/"
-      - "/libs/partners/mistralai/"
-      - "/libs/partners/nomic/"
-      - "/libs/partners/ollama/"
-      - "/libs/partners/openai/"
-      - "/libs/partners/openrouter/"
-      - "/libs/partners/perplexity/"
-      - "/libs/partners/qdrant/"
-      - "/libs/partners/xai/"
-    schedule:
-      interval: "monthly"
-    groups:
-      minor-and-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-      major:
-        patterns:
-          - "*"
-        update-types:
-          - "major"
-
-  - package-ecosystem: "uv"
-    directories:
-      - "/libs/text-splitters/"
-      - "/libs/standard-tests/"
-      - "/libs/model-profiles/"
-    schedule:
-      interval: "monthly"
-    groups:
-      minor-and-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-      major:
-        patterns:
-          - "*"
-        update-types:
-          - "major"
+      interval: "weekly"

.github/images/logo-dark.svg

@@ -1,6 +1,25 @@
-<svg width="472" height="100" viewBox="0 0 472 100" fill="none" xmlns="http://www.w3.org/2000/svg">
-<rect width="100" height="100" rx="20" fill="#161F34"/>
-<path d="M54.2612 54.2583L63.1942 45.3253C67.8979 40.6215 67.8979 32.9952 63.1942 28.2914C58.4904 23.5877 50.8641 23.5877 46.1603 28.2914L37.2273 37.2244" stroke="#7FC8FF" stroke-width="12.0389"/>
-<path d="M45.7427 45.7412L36.8098 54.6742C32.106 59.3779 32.106 67.0042 36.8098 71.708C41.5135 76.4118 49.1398 76.4118 53.8436 71.708L62.7766 62.775" stroke="#7FC8FF" stroke-width="12.0389"/>
-<path d="M142.427 70.248V65.748H153.227V32.748H142.427V28.248H158.147V65.748H168.947V70.248H142.427ZM189.174 70.608C182.454 70.608 177.894 67.248 177.894 61.668C177.894 55.548 182.154 52.128 190.194 52.128H199.194V50.028C199.194 46.068 196.374 43.668 191.574 43.668C187.254 43.668 184.374 45.708 183.774 48.828H178.854C179.574 42.828 184.434 39.288 191.814 39.288C199.614 39.288 204.114 43.188 204.114 50.328V63.708C204.114 65.328 204.714 65.748 206.094 65.748H207.654V70.248H204.954C200.874 70.248 199.494 68.508 199.434 65.508C197.514 68.268 194.454 70.608 189.174 70.608ZM189.534 66.408C195.654 66.408 199.194 62.868 199.194 57.768V56.268H189.714C185.334 56.268 182.874 57.888 182.874 61.368C182.874 64.368 185.454 66.408 189.534 66.408ZM216.601 70.248V39.648H220.861L221.521 43.788C223.321 41.448 226.321 39.288 231.121 39.288C237.601 39.288 243.001 42.948 243.001 52.848V70.248H238.081V53.148C238.081 47.028 235.201 43.788 230.281 43.788C224.941 43.788 221.521 47.928 221.521 53.988V70.248H216.601ZM266.348 82.608C258.548 82.608 253.088 78.948 252.308 72.228H257.348C258.188 76.068 261.608 78.228 266.708 78.228C273.128 78.228 276.608 75.228 276.608 68.568V64.968C274.568 68.448 271.268 70.608 266.108 70.608C257.648 70.608 251.408 64.908 251.408 54.948C251.408 45.588 257.648 39.288 266.108 39.288C271.268 39.288 274.688 41.508 276.608 44.928L277.268 39.648H281.528V68.748C281.528 77.568 276.848 82.608 266.348 82.608ZM266.588 66.228C272.588 66.228 276.668 61.608 276.668 55.068C276.668 48.348 272.588 43.668 266.588 43.668C260.528 43.668 256.448 48.288 256.448 54.948C256.448 61.608 260.528 66.228 266.588 66.228ZM304.875 70.608C295.935 70.608 290.055 64.548 290.055 55.008C290.055 45.648 296.115 39.288 304.995 39.288C312.495 39.288 317.235 43.488 318.495 50.208H313.335C312.435 46.128 309.435 43.668 304.935 43.668C299.055 43.668 295.095 48.348 295.095 55.008C295.095 61.668 299.055 66.228 304.935 66.228C309.315 66.228 312.315 63.708 313.275 59.808H318.495C317.295 66.408 312.315 70.608 304.875 70.608ZM328.042 70.248V28.248H332.962V43.788C335.242 40.968 338.782 39.288 342.742 39.288C350.422 39.288 354.802 44.388 354.802 53.208V70.248H349.882V53.508C349.882 47.268 347.002 43.788 341.902 43.788C336.442 43.788 332.962 48.108 332.962 54.948V70.248H328.042ZM375.209 70.608C368.489 70.608 363.929 67.248 363.929 61.668C363.929 55.548 368.189 52.128 376.229 52.128H385.229V50.028C385.229 46.068 382.409 43.668 377.609 43.668C373.289 43.668 370.409 45.708 369.809 48.828H364.889C365.609 42.828 370.469 39.288 377.849 39.288C385.649 39.288 390.149 43.188 390.149 50.328V63.708C390.149 65.328 390.749 65.748 392.129 65.748H393.689V70.248H390.989C386.909 70.248 385.529 68.508 385.469 65.508C383.549 68.268 380.489 70.608 375.209 70.608ZM375.569 66.408C381.689 66.408 385.229 62.868 385.229 57.768V56.268H375.749C371.369 56.268 368.909 57.888 368.909 61.368C368.909 64.368 371.489 66.408 375.569 66.408ZM403.476 70.248V65.748H414.276V44.148H403.476V39.648H419.196V65.748H429.996V70.248H403.476ZM416.796 34.248C414.576 34.248 412.836 32.568 412.836 30.288C412.836 28.068 414.576 26.388 416.796 26.388C419.016 26.388 420.756 28.068 420.756 30.288C420.756 32.568 419.016 34.248 416.796 34.248ZM439.843 70.248V39.648H444.103L444.763 43.788C446.563 41.448 449.563 39.288 454.363 39.288C460.843 39.288 466.243 42.948 466.243 52.848V70.248H461.323V53.148C461.323 47.028 458.443 43.788 453.523 43.788C448.183 43.788 444.763 47.928 444.763 53.988V70.248H439.843Z" fill="white"/>
-</svg>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1584.81 250">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: #1c3c3c;
+        stroke-width: 0px;
+      }
+    </style>
+  </defs>
+  <g id="LanChain-logo">
+    <g id="LangChain-logotype">
+      <polygon class="cls-1" points="596.33 49.07 596.33 200.67 700.76 200.67 700.76 177.78 620.04 177.78 620.04 49.07 596.33 49.07"/>
+      <path class="cls-1" d="M1126.83,49.07c-20.53,0-37.95,7.4-50.38,21.41-12.32,13.88-18.82,33.36-18.82,56.33,0,47.23,27.25,77.75,69.41,77.75,29.71,0,52.71-15.54,61.54-41.56l2.14-6.31-23.53-8.94-2.17,7.03c-5.26,17.01-18.75,26.38-37.99,26.38-27.48,0-44.55-20.82-44.55-54.34s17.23-54.34,44.97-54.34c19.23,0,30.31,7.54,35.95,24.44l2.46,7.37,22.91-10.75-2.1-5.9c-8.96-25.22-29.65-38.56-59.85-38.56Z"/>
+      <path class="cls-1" d="M756.43,85.05c-22.76,0-39.78,10.67-46.69,29.27-.44,1.19-1.77,4.78-1.77,4.78l19.51,12.62,2.65-6.91c4.52-11.78,12.88-17.27,26.3-17.27s21.1,6.51,20.96,19.33c0,.52-.04,2.09-.04,2.09,0,0-17.76,2.88-25.08,4.43-31.23,6.6-44.31,18.52-44.31,38.02,0,10.39,5.77,21.64,16.3,27.95,6.32,3.78,14.57,5.21,23.68,5.21,5.99,0,11.81-.89,17.2-2.53,12.25-4.07,15.67-12.07,15.67-12.07v10.46h20.29v-74.78c0-25.42-16.7-40.6-44.67-40.6ZM777.46,164.85c0,7.86-8.56,18.93-28.5,18.93-5.63,0-9.62-1.49-12.28-3.71-3.56-2.97-4.73-7.24-4.24-11.01.21-1.64,1.2-5.17,4.87-8.23,3.75-3.13,10.38-5.37,20.62-7.6,8.42-1.83,19.54-3.85,19.54-3.85v15.48Z"/>
+      <path class="cls-1" d="M876.11,85.04c-2.82,0-5.57.2-8.24.57-18.17,2.73-23.49,11.96-23.49,11.96l.02-9.31h-22.74s0,112.19,0,112.19h23.71v-62.18c0-21.13,15.41-30.75,29.73-30.75,15.48,0,23,8.32,23,25.45v67.48h23.71v-70.74c0-27.56-17.51-44.67-45.69-44.67Z"/>
+      <path class="cls-1" d="M1539.12,85.04c-2.82,0-5.57.2-8.24.57-18.17,2.73-23.49,11.96-23.49,11.96v-9.32h-22.72v112.2h23.71v-62.18c0-21.13,15.41-30.75,29.73-30.75,15.48,0,23,8.32,23,25.45v67.48h23.71v-70.74c0-27.56-17.51-44.67-45.69-44.67Z"/>
+      <path class="cls-1" d="M1020.76,88.26v11.55s-5.81-14.77-32.24-14.77c-32.84,0-53.24,22.66-53.24,59.15,0,20.59,6.58,36.8,18.19,47.04,9.03,7.96,21.09,12.04,35.45,12.32,9.99.19,16.46-2.53,20.5-5.1,7.76-4.94,10.64-9.63,10.64-9.63,0,0-.33,3.67-.93,8.64-.43,3.6-1.24,6.13-1.24,6.13h0c-3.61,12.85-14.17,20.28-29.57,20.28s-24.73-5.07-26.58-15.06l-23.05,6.88c3.98,19.2,22,30.66,48.2,30.66,17.81,0,31.77-4.84,41.5-14.4,9.81-9.64,14.79-23.53,14.79-41.29v-102.41h-22.42ZM1019.26,145.21c0,22.44-10.96,35.84-29.32,35.84-19.67,0-30.95-13.44-30.95-36.86s11.28-36.66,30.95-36.66c17.92,0,29.15,13.34,29.32,34.82v2.86Z"/>
+      <path class="cls-1" d="M1259.01,85.04c-2.6,0-5.13.17-7.59.49-17.88,2.79-23.14,11.9-23.14,11.9v-2.67h-.01s0-45.69,0-45.69h-23.71v151.39h23.71v-62.18c0-21.27,15.41-30.95,29.73-30.95,15.48,0,23,8.32,23,25.45v67.68h23.71v-70.94c0-27.01-17.94-44.47-45.69-44.47Z"/>
+      <circle class="cls-1" cx="1450.93" cy="64.47" r="15.37"/>
+      <path class="cls-1" d="M1439.14,88.2v56.94h0c-6.75-5.56-14.6-9.75-23.5-12.26v-7.23c0-25.42-16.7-40.6-44.67-40.6-22.76,0-39.78,10.67-46.69,29.27-.44,1.19-1.77,4.78-1.77,4.78l19.51,12.62,2.65-6.91c4.52-11.78,12.88-17.27,26.3-17.27s21.1,6.51,20.96,19.33c0,.08,0,1.15,0,2.86-10.04-.28-19.38.69-27.77,2.66,0,0,0,0,0,0-11.06,2.5-31.6,8.85-38.94,25.36-.05.11-1.13,2.96-1.13,2.96-1.06,3.28-1.59,6.84-1.59,10.7,0,10.39,5.77,21.64,16.3,27.95,6.32,3.78,14.57,5.21,23.68,5.21,5.88,0,11.6-.86,16.91-2.44,12.49-4.04,15.96-12.16,15.96-12.16v10.47h20.29v-34.27c-5.7-3.56-14.26-5.66-23.65-5.64,0,2.65,0,4.33,0,4.33,0,7.86-8.56,18.93-28.5,18.93-5.63,0-9.62-1.49-12.28-3.71-3.56-2.97-4.73-7.24-4.24-11.01.21-1.64,1.2-5.17,4.87-8.23l-.04-.11c8.42-6.89,24.97-9.64,40.17-9.04v.03c12.94.47,22.62,3.01,29.53,7.77,1.88,1.19,3.65,2.52,5.28,3.98,6.94,6.23,9.73,13.9,10.93,18.38,1.95,7.31,1.43,18.57,1.43,18.57h23.59v-112.2h-23.59Z"/>
+    </g>
+    <path id="LangChain-symbol" class="cls-1" d="M393.52,75.2c9.66,9.66,9.66,25.38,0,35.04l-21.64,21.29-.22-1.22c-1.58-8.75-5.74-16.69-12.02-22.97-4.73-4.72-10.32-8.21-16.62-10.37-3.91,3.93-6.06,9.08-6.06,14.5,0,1.1.1,2.24.3,3.38,3.47,1.25,6.54,3.18,9.12,5.76,9.66,9.66,9.66,25.38,0,35.04l-18.84,18.84c-4.83,4.83-11.17,7.24-17.52,7.24s-12.69-2.41-17.52-7.24c-9.66-9.66-9.66-25.38,0-35.04l21.64-21.28.22,1.22c1.57,8.73,5.73,16.67,12.03,22.96,4.74,4.74,9.99,7.89,16.28,10.04l1.16-1.16c3.52-3.52,5.45-8.2,5.45-13.19,0-1.11-.1-2.22-.29-3.31-3.63-1.2-6.62-2.91-9.34-5.63-3.92-3.92-6.36-8.93-7.04-14.48-.05-.4-.08-.79-.12-1.19-.54-7.23,2.07-14.29,7.16-19.37l18.84-18.84c4.67-4.67,10.89-7.25,17.52-7.25s12.85,2.57,17.52,7.25ZM491.9,125c0,68.93-56.08,125-125,125H125C56.08,250,0,193.93,0,125S56.08,0,125,0h241.9c68.93,0,125,56.08,125,125ZM240.9,187.69c1.97-2.39-7.13-9.12-8.99-11.59-3.78-4.1-3.8-10-6.35-14.79-6.24-14.46-13.41-28.81-23.44-41.05-10.6-13.39-23.68-24.47-35.17-37.04-8.53-8.77-10.81-21.26-18.34-30.69-10.38-15.33-43.2-19.51-48.01,2.14.02.68-.19,1.11-.78,1.54-2.66,1.93-5.03,4.14-7.02,6.81-4.87,6.78-5.62,18.28.46,24.37.2-3.21.31-6.24,2.85-8.54,4.7,4.03,11.8,5.46,17.25,2.45,12.04,17.19,9.04,40.97,18.6,59.49,2.64,4.38,5.3,8.85,8.69,12.69,2.75,4.28,12.25,9.33,12.81,13.29.1,6.8-.7,14.23,3.76,19.92,2.1,4.26-3.06,8.54-7.22,8.01-5.4.74-11.99-3.63-16.72-.94-1.67,1.81-4.94-.19-6.38,2.32-.5,1.3-3.2,3.13-1.59,4.38,1.79-1.36,3.45-2.78,5.86-1.97-.36,1.96,1.19,2.24,2.42,2.81-.04,1.33-.82,2.69.2,3.82,1.19-1.2,1.9-2.9,3.79-3.4,6.28,8.37,12.67-8.47,26.26-.89-2.76-.14-5.21.21-7.07,2.48-.46.51-.85,1.11-.04,1.77,7.33-4.73,7.29,1.62,12.05-.33,3.66-1.91,7.3-4.3,11.65-3.62-4.23,1.22-4.4,4.62-6.88,7.49-.42.44-.62.94-.13,1.67,8.78-.74,9.5-3.66,16.59-7.24,5.29-3.23,10.56,4.6,15.14.14,1.01-.97,2.39-.64,3.64-.77-1.6-8.53-19.19,1.56-18.91-9.88,5.66-3.85,4.36-11.22,4.74-17.17,6.51,3.61,13.75,5.71,20.13,9.16,3.22,5.2,8.27,12.07,15,11.62.18-.52.34-.98.53-1.51,2.04.35,4.66,1.7,5.78-.88,3.05,3.19,7.53,3.03,11.52,2.21,2.95-2.4-5.55-5.82-6.69-8.29ZM419.51,92.72c0-11.64-4.52-22.57-12.73-30.78-8.21-8.21-19.14-12.73-30.79-12.73s-22.58,4.52-30.79,12.73l-18.84,18.84c-4.4,4.4-7.74,9.57-9.93,15.36l-.13.33-.34.1c-6.84,2.11-12.87,5.73-17.92,10.78l-18.84,18.84c-16.97,16.98-16.97,44.6,0,61.57,8.21,8.21,19.14,12.73,30.78,12.73h0c11.64,0,22.58-4.52,30.79-12.73l18.84-18.84c4.38-4.38,7.7-9.53,9.89-15.31l.13-.33.34-.11c6.72-2.06,12.92-5.8,17.95-10.82l18.84-18.84c8.21-8.21,12.73-19.14,12.73-30.79ZM172.38,173.6c-1.62,6.32-2.15,17.09-10.37,17.4-.68,3.65,2.53,5.02,5.44,3.85,2.89-1.33,4.26,1.05,5.23,3.42,4.46.65,11.06-1.49,11.31-6.77-6.66-3.84-8.72-11.14-11.62-17.9Z"/>
+  </g>
+</svg>

.github/images/logo-light.svg

@@ -1,6 +1,25 @@
-<svg width="472" height="100" viewBox="0 0 472 100" fill="none" xmlns="http://www.w3.org/2000/svg">
-<rect width="100" height="100" rx="20" fill="#161F34"/>
-<path d="M54.2612 54.2583L63.1942 45.3253C67.8979 40.6215 67.8979 32.9952 63.1942 28.2914C58.4904 23.5877 50.8641 23.5877 46.1603 28.2914L37.2273 37.2244" stroke="#7FC8FF" stroke-width="12.0389"/>
-<path d="M45.7427 45.7411L36.8098 54.6741C32.106 59.3779 32.106 67.0042 36.8098 71.7079C41.5135 76.4117 49.1398 76.4117 53.8436 71.7079L62.7766 62.775" stroke="#7FC8FF" stroke-width="12.0389"/>
-<path d="M142.427 70.248V65.748H153.227V32.748H142.427V28.248H158.147V65.748H168.947V70.248H142.427ZM189.174 70.608C182.454 70.608 177.894 67.248 177.894 61.668C177.894 55.548 182.154 52.128 190.194 52.128H199.194V50.028C199.194 46.068 196.374 43.668 191.574 43.668C187.254 43.668 184.374 45.708 183.774 48.828H178.854C179.574 42.828 184.434 39.288 191.814 39.288C199.614 39.288 204.114 43.188 204.114 50.328V63.708C204.114 65.328 204.714 65.748 206.094 65.748H207.654V70.248H204.954C200.874 70.248 199.494 68.508 199.434 65.508C197.514 68.268 194.454 70.608 189.174 70.608ZM189.534 66.408C195.654 66.408 199.194 62.868 199.194 57.768V56.268H189.714C185.334 56.268 182.874 57.888 182.874 61.368C182.874 64.368 185.454 66.408 189.534 66.408ZM216.601 70.248V39.648H220.861L221.521 43.788C223.321 41.448 226.321 39.288 231.121 39.288C237.601 39.288 243.001 42.948 243.001 52.848V70.248H238.081V53.148C238.081 47.028 235.201 43.788 230.281 43.788C224.941 43.788 221.521 47.928 221.521 53.988V70.248H216.601ZM266.348 82.608C258.548 82.608 253.088 78.948 252.308 72.228H257.348C258.188 76.068 261.608 78.228 266.708 78.228C273.128 78.228 276.608 75.228 276.608 68.568V64.968C274.568 68.448 271.268 70.608 266.108 70.608C257.648 70.608 251.408 64.908 251.408 54.948C251.408 45.588 257.648 39.288 266.108 39.288C271.268 39.288 274.688 41.508 276.608 44.928L277.268 39.648H281.528V68.748C281.528 77.568 276.848 82.608 266.348 82.608ZM266.588 66.228C272.588 66.228 276.668 61.608 276.668 55.068C276.668 48.348 272.588 43.668 266.588 43.668C260.528 43.668 256.448 48.288 256.448 54.948C256.448 61.608 260.528 66.228 266.588 66.228ZM304.875 70.608C295.935 70.608 290.055 64.548 290.055 55.008C290.055 45.648 296.115 39.288 304.995 39.288C312.495 39.288 317.235 43.488 318.495 50.208H313.335C312.435 46.128 309.435 43.668 304.935 43.668C299.055 43.668 295.095 48.348 295.095 55.008C295.095 61.668 299.055 66.228 304.935 66.228C309.315 66.228 312.315 63.708 313.275 59.808H318.495C317.295 66.408 312.315 70.608 304.875 70.608ZM328.042 70.248V28.248H332.962V43.788C335.242 40.968 338.782 39.288 342.742 39.288C350.422 39.288 354.802 44.388 354.802 53.208V70.248H349.882V53.508C349.882 47.268 347.002 43.788 341.902 43.788C336.442 43.788 332.962 48.108 332.962 54.948V70.248H328.042ZM375.209 70.608C368.489 70.608 363.929 67.248 363.929 61.668C363.929 55.548 368.189 52.128 376.229 52.128H385.229V50.028C385.229 46.068 382.409 43.668 377.609 43.668C373.289 43.668 370.409 45.708 369.809 48.828H364.889C365.609 42.828 370.469 39.288 377.849 39.288C385.649 39.288 390.149 43.188 390.149 50.328V63.708C390.149 65.328 390.749 65.748 392.129 65.748H393.689V70.248H390.989C386.909 70.248 385.529 68.508 385.469 65.508C383.549 68.268 380.489 70.608 375.209 70.608ZM375.569 66.408C381.689 66.408 385.229 62.868 385.229 57.768V56.268H375.749C371.369 56.268 368.909 57.888 368.909 61.368C368.909 64.368 371.489 66.408 375.569 66.408ZM403.476 70.248V65.748H414.276V44.148H403.476V39.648H419.196V65.748H429.996V70.248H403.476ZM416.796 34.248C414.576 34.248 412.836 32.568 412.836 30.288C412.836 28.068 414.576 26.388 416.796 26.388C419.016 26.388 420.756 28.068 420.756 30.288C420.756 32.568 419.016 34.248 416.796 34.248ZM439.843 70.248V39.648H444.103L444.763 43.788C446.563 41.448 449.563 39.288 454.363 39.288C460.843 39.288 466.243 42.948 466.243 52.848V70.248H461.323V53.148C461.323 47.028 458.443 43.788 453.523 43.788C448.183 43.788 444.763 47.928 444.763 53.988V70.248H439.843Z" fill="#161F34"/>
-</svg>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1584.81 250">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: #fff;
+        stroke-width: 0px;
+      }
+    </style>
+  </defs>
+  <g id="LanChain-logo">
+    <g id="LangChain-logotype">
+      <polygon class="cls-1" points="596.33 49.07 596.33 200.67 700.76 200.67 700.76 177.78 620.04 177.78 620.04 49.07 596.33 49.07"/>
+      <path class="cls-1" d="M1126.83,49.07c-20.53,0-37.95,7.4-50.38,21.41-12.32,13.88-18.82,33.36-18.82,56.33,0,47.23,27.25,77.75,69.41,77.75,29.71,0,52.71-15.54,61.54-41.56l2.14-6.31-23.53-8.94-2.17,7.03c-5.26,17.01-18.75,26.38-37.99,26.38-27.48,0-44.55-20.82-44.55-54.34s17.23-54.34,44.97-54.34c19.23,0,30.31,7.54,35.95,24.44l2.46,7.37,22.91-10.75-2.1-5.9c-8.96-25.22-29.65-38.56-59.85-38.56Z"/>
+      <path class="cls-1" d="M756.43,85.05c-22.76,0-39.78,10.67-46.69,29.27-.44,1.19-1.77,4.78-1.77,4.78l19.51,12.62,2.65-6.91c4.52-11.78,12.88-17.27,26.3-17.27s21.1,6.51,20.96,19.33c0,.52-.04,2.09-.04,2.09,0,0-17.76,2.88-25.08,4.43-31.23,6.6-44.31,18.52-44.31,38.02,0,10.39,5.77,21.64,16.3,27.95,6.32,3.78,14.57,5.21,23.68,5.21,5.99,0,11.81-.89,17.2-2.53,12.25-4.07,15.67-12.07,15.67-12.07v10.46h20.29v-74.78c0-25.42-16.7-40.6-44.67-40.6ZM777.46,164.85c0,7.86-8.56,18.93-28.5,18.93-5.63,0-9.62-1.49-12.28-3.71-3.56-2.97-4.73-7.24-4.24-11.01.21-1.64,1.2-5.17,4.87-8.23,3.75-3.13,10.38-5.37,20.62-7.6,8.42-1.83,19.54-3.85,19.54-3.85v15.48Z"/>
+      <path class="cls-1" d="M876.11,85.04c-2.82,0-5.57.2-8.24.57-18.17,2.73-23.49,11.96-23.49,11.96l.02-9.31h-22.74s0,112.19,0,112.19h23.71v-62.18c0-21.13,15.41-30.75,29.73-30.75,15.48,0,23,8.32,23,25.45v67.48h23.71v-70.74c0-27.56-17.51-44.67-45.69-44.67Z"/>
+      <path class="cls-1" d="M1539.12,85.04c-2.82,0-5.57.2-8.24.57-18.17,2.73-23.49,11.96-23.49,11.96v-9.32h-22.72v112.2h23.71v-62.18c0-21.13,15.41-30.75,29.73-30.75,15.48,0,23,8.32,23,25.45v67.48h23.71v-70.74c0-27.56-17.51-44.67-45.69-44.67Z"/>
+      <path class="cls-1" d="M1020.76,88.26v11.55s-5.81-14.77-32.24-14.77c-32.84,0-53.24,22.66-53.24,59.15,0,20.59,6.58,36.8,18.19,47.04,9.03,7.96,21.09,12.04,35.45,12.32,9.99.19,16.46-2.53,20.5-5.1,7.76-4.94,10.64-9.63,10.64-9.63,0,0-.33,3.67-.93,8.64-.43,3.6-1.24,6.13-1.24,6.13h0c-3.61,12.85-14.17,20.28-29.57,20.28s-24.73-5.07-26.58-15.06l-23.05,6.88c3.98,19.2,22,30.66,48.2,30.66,17.81,0,31.77-4.84,41.5-14.4,9.81-9.64,14.79-23.53,14.79-41.29v-102.41h-22.42ZM1019.26,145.21c0,22.44-10.96,35.84-29.32,35.84-19.67,0-30.95-13.44-30.95-36.86s11.28-36.66,30.95-36.66c17.92,0,29.15,13.34,29.32,34.82v2.86Z"/>
+      <path class="cls-1" d="M1259.01,85.04c-2.6,0-5.13.17-7.59.49-17.88,2.79-23.14,11.9-23.14,11.9v-2.67h-.01s0-45.69,0-45.69h-23.71v151.39h23.71v-62.18c0-21.27,15.41-30.95,29.73-30.95,15.48,0,23,8.32,23,25.45v67.68h23.71v-70.94c0-27.01-17.94-44.47-45.69-44.47Z"/>
+      <circle class="cls-1" cx="1450.93" cy="64.47" r="15.37"/>
+      <path class="cls-1" d="M1439.14,88.2v56.94h0c-6.75-5.56-14.6-9.75-23.5-12.26v-7.23c0-25.42-16.7-40.6-44.67-40.6-22.76,0-39.78,10.67-46.69,29.27-.44,1.19-1.77,4.78-1.77,4.78l19.51,12.62,2.65-6.91c4.52-11.78,12.88-17.27,26.3-17.27s21.1,6.51,20.96,19.33c0,.08,0,1.15,0,2.86-10.04-.28-19.38.69-27.77,2.66,0,0,0,0,0,0-11.06,2.5-31.6,8.85-38.94,25.36-.05.11-1.13,2.96-1.13,2.96-1.06,3.28-1.59,6.84-1.59,10.7,0,10.39,5.77,21.64,16.3,27.95,6.32,3.78,14.57,5.21,23.68,5.21,5.88,0,11.6-.86,16.91-2.44,12.49-4.04,15.96-12.16,15.96-12.16v10.47h20.29v-34.27c-5.7-3.56-14.26-5.66-23.65-5.64,0,2.65,0,4.33,0,4.33,0,7.86-8.56,18.93-28.5,18.93-5.63,0-9.62-1.49-12.28-3.71-3.56-2.97-4.73-7.24-4.24-11.01.21-1.64,1.2-5.17,4.87-8.23l-.04-.11c8.42-6.89,24.97-9.64,40.17-9.04v.03c12.94.47,22.62,3.01,29.53,7.77,1.88,1.19,3.65,2.52,5.28,3.98,6.94,6.23,9.73,13.9,10.93,18.38,1.95,7.31,1.43,18.57,1.43,18.57h23.59v-112.2h-23.59Z"/>
+    </g>
+    <path id="LangChain-symbol" class="cls-1" d="M393.52,75.2c9.66,9.66,9.66,25.38,0,35.04l-21.64,21.29-.22-1.22c-1.58-8.75-5.74-16.69-12.02-22.97-4.73-4.72-10.32-8.21-16.62-10.37-3.91,3.93-6.06,9.08-6.06,14.5,0,1.1.1,2.24.3,3.38,3.47,1.25,6.54,3.18,9.12,5.76,9.66,9.66,9.66,25.38,0,35.04l-18.84,18.84c-4.83,4.83-11.17,7.24-17.52,7.24s-12.69-2.41-17.52-7.24c-9.66-9.66-9.66-25.38,0-35.04l21.64-21.28.22,1.22c1.57,8.73,5.73,16.67,12.03,22.96,4.74,4.74,9.99,7.89,16.28,10.04l1.16-1.16c3.52-3.52,5.45-8.2,5.45-13.19,0-1.11-.1-2.22-.29-3.31-3.63-1.2-6.62-2.91-9.34-5.63-3.92-3.92-6.36-8.93-7.04-14.48-.05-.4-.08-.79-.12-1.19-.54-7.23,2.07-14.29,7.16-19.37l18.84-18.84c4.67-4.67,10.89-7.25,17.52-7.25s12.85,2.57,17.52,7.25ZM491.9,125c0,68.93-56.08,125-125,125H125C56.08,250,0,193.93,0,125S56.08,0,125,0h241.9C435.82,0,491.9,56.08,491.9,125ZM240.9,187.69c1.97-2.39-7.13-9.12-8.99-11.59-3.78-4.1-3.8-10-6.35-14.79-6.24-14.46-13.41-28.81-23.44-41.05-10.6-13.39-23.68-24.47-35.17-37.04-8.53-8.77-10.81-21.26-18.34-30.69-10.38-15.33-43.2-19.51-48.01,2.14.02.68-.19,1.11-.78,1.54-2.66,1.93-5.03,4.14-7.02,6.81-4.87,6.78-5.62,18.28.46,24.37.2-3.21.31-6.24,2.85-8.54,4.7,4.03,11.8,5.46,17.25,2.45,12.04,17.19,9.04,40.97,18.6,59.49,2.64,4.38,5.3,8.85,8.69,12.69,2.75,4.28,12.25,9.33,12.81,13.29.1,6.8-.7,14.23,3.76,19.92,2.1,4.26-3.06,8.54-7.22,8.01-5.4.74-11.99-3.63-16.72-.94-1.67,1.81-4.94-.19-6.38,2.32-.5,1.3-3.2,3.13-1.59,4.38,1.79-1.36,3.45-2.78,5.86-1.97-.36,1.96,1.19,2.24,2.42,2.81-.04,1.33-.82,2.69.2,3.82,1.19-1.2,1.9-2.9,3.79-3.4,6.28,8.37,12.67-8.47,26.26-.89-2.76-.14-5.21.21-7.07,2.48-.46.51-.85,1.11-.04,1.77,7.33-4.73,7.29,1.62,12.05-.33,3.66-1.91,7.3-4.3,11.65-3.62-4.23,1.22-4.4,4.62-6.88,7.49-.42.44-.62.94-.13,1.67,8.78-.74,9.5-3.66,16.59-7.24,5.29-3.23,10.56,4.6,15.14.14,1.01-.97,2.39-.64,3.64-.77-1.6-8.53-19.19,1.56-18.91-9.88,5.66-3.85,4.36-11.22,4.74-17.17,6.51,3.61,13.75,5.71,20.13,9.16,3.22,5.2,8.27,12.07,15,11.62.18-.52.34-.98.53-1.51,2.04.35,4.66,1.7,5.78-.88,3.05,3.19,7.53,3.03,11.52,2.21,2.95-2.4-5.55-5.82-6.69-8.29ZM419.51,92.72c0-11.64-4.52-22.57-12.73-30.78-8.21-8.21-19.14-12.73-30.79-12.73s-22.58,4.52-30.79,12.73l-18.84,18.84c-4.4,4.4-7.74,9.57-9.93,15.36l-.13.33-.34.1c-6.84,2.11-12.87,5.73-17.92,10.78l-18.84,18.84c-16.97,16.98-16.97,44.6,0,61.57,8.21,8.21,19.14,12.73,30.78,12.73h0c11.64,0,22.58-4.52,30.79-12.73l18.84-18.84c4.38-4.38,7.7-9.53,9.89-15.31l.13-.33.34-.11c6.72-2.06,12.92-5.8,17.95-10.82l18.84-18.84c8.21-8.21,12.73-19.14,12.73-30.79ZM172.38,173.6c-1.62,6.32-2.15,17.09-10.37,17.4-.68,3.65,2.53,5.02,5.44,3.85,2.89-1.33,4.26,1.05,5.23,3.42,4.46.65,11.06-1.49,11.31-6.77-6.66-3.84-8.72-11.14-11.62-17.9Z"/>
+  </g>
+</svg>

.github/pr-file-labeler.yml

@@ -0,0 +1,133 @@
+# Label PRs (config)
+# Automatically applies labels based on changed files and branch patterns
+
+# Core packages
+core:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/core/**/*"
+
+langchain-classic:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/langchain/**/*"
+
+langchain:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/langchain_v1/**/*"
+
+cli:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/cli/**/*"
+
+standard-tests:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/standard-tests/**/*"
+
+model-profiles:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/model-profiles/**/*"
+
+text-splitters:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/text-splitters/**/*"
+
+# Partner integrations
+integration:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/**/*"
+
+anthropic:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/anthropic/**/*"
+
+chroma:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/chroma/**/*"
+
+deepseek:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/deepseek/**/*"
+
+exa:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/exa/**/*"
+
+fireworks:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/fireworks/**/*"
+
+groq:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/groq/**/*"
+
+huggingface:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/huggingface/**/*"
+
+mistralai:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/mistralai/**/*"
+
+nomic:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/nomic/**/*"
+
+ollama:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/ollama/**/*"
+
+openai:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/openai/**/*"
+
+perplexity:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/perplexity/**/*"
+
+prompty:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/prompty/**/*"
+
+qdrant:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/qdrant/**/*"
+
+xai:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "libs/partners/xai/**/*"
+
+github_actions:
+  - changed-files:
+      - any-glob-to-any-file:
+          - ".github/workflows/**/*"
+          - ".github/actions/**/*"
+
+dependencies:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "**/pyproject.toml"
+          - "uv.lock"
+          - "**/requirements*.txt"
+          - "**/poetry.lock"

.github/scripts/check_diff.py

@@ -44,7 +44,11 @@ IGNORE_CORE_DEPENDENTS = False
 IGNORED_PARTNERS = [
     # remove huggingface from dependents because of CI instability
     # specifically in huggingface jobs
+    # https://github.com/langchain-ai/langchain/issues/25558
     "huggingface",
+    # prompty exhibiting issues with numpy for Python 3.13
+    # https://github.com/langchain-ai/langchain/actions/runs/12651104685/job/35251034969?pr=29065
+    "prompty",
 ]
 
 
@@ -52,7 +56,7 @@ def all_package_dirs() -> Set[str]:
     return {
         "/".join(path.split("/")[:-1]).lstrip("./")
         for path in glob.glob("./libs/**/pyproject.toml", recursive=True)
-        if "libs/standard-tests" not in path
+        if "libs/cli" not in path and "libs/standard-tests" not in path
     }
 
 
@@ -127,23 +131,12 @@ def _get_configs_for_single_dir(job: str, dir_: str) -> List[Dict[str, str]]:
         return _get_pydantic_test_configs(dir_)
 
     if job == "codspeed":
-        # CPU simulation (<1% variance, Valgrind-based) is the default.
-        # Partners with heavy SDK inits use walltime instead to keep CI fast.
-        CODSPEED_WALLTIME_DIRS = {
-            "libs/core",
-            "libs/partners/fireworks",  # ~328s under simulation
-            "libs/partners/openai",  # 6 benchmarks, ~6 min under simulation
-        }
-        mode = "walltime" if dir_ in CODSPEED_WALLTIME_DIRS else "simulation"
-        return [
-            {
-                "working-directory": dir_,
-                "python-version": "3.13",
-                "codspeed-mode": mode,
-            }
-        ]
-    if dir_ == "libs/core":
+        py_versions = ["3.13"]
+    elif dir_ == "libs/core":
         py_versions = ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    # custom logic for specific directories
+    elif dir_ in {"libs/partners/chroma"}:
+        py_versions = ["3.10", "3.13"]
     else:
         py_versions = ["3.10", "3.14"]
 
@@ -293,6 +286,10 @@ if __name__ == "__main__":
             dirs_to_run["test"].add("libs/partners/fireworks")
             dirs_to_run["test"].add("libs/partners/groq")
 
+        elif file.startswith("libs/cli"):
+            dirs_to_run["lint"].add("libs/cli")
+            dirs_to_run["test"].add("libs/cli")
+
         elif file.startswith("libs/partners"):
             partner_dir = file.split("/")[2]
             if os.path.isdir(f"libs/partners/{partner_dir}") and [

.github/scripts/get_min_versions.py

@@ -48,7 +48,7 @@ def get_pypi_versions(package_name: str) -> List[str]:
         KeyError: If package not found or response format unexpected
     """
     pypi_url = f"https://pypi.org/pypi/{package_name}/json"
-    response = requests.get(pypi_url, timeout=10.0)
+    response = requests.get(pypi_url)
     response.raise_for_status()
     return list(response.json()["releases"].keys())
 

.github/scripts/pr-labeler-config.json

@@ -1,84 +0,0 @@
-{
-  "trustedThreshold": 5,
-  "labelColor": "b76e79",
-  "sizeThresholds": [
-    { "label": "size: XS", "max": 50 },
-    { "label": "size: S", "max": 200 },
-    { "label": "size: M", "max": 500 },
-    { "label": "size: L", "max": 1000 },
-    { "label": "size: XL" }
-  ],
-  "excludedFiles": ["uv.lock"],
-  "excludedPaths": ["docs/"],
-  "typeToLabel": {
-    "feat": "feature",
-    "fix": "fix",
-    "docs": "documentation",
-    "style": "linting",
-    "refactor": "refactor",
-    "perf": "performance",
-    "test": "tests",
-    "build": "infra",
-    "ci": "infra",
-    "chore": "infra",
-    "revert": "revert",
-    "release": "release",
-    "hotfix": "hotfix",
-    "breaking": "breaking"
-  },
-  "scopeToLabel": {
-    "core": "core",
-    "langchain": "langchain",
-    "langchain-classic": "langchain-classic",
-    "model-profiles": "model-profiles",
-    "standard-tests": "standard-tests",
-    "text-splitters": "text-splitters",
-    "anthropic": "anthropic",
-    "chroma": "chroma",
-    "deepseek": "deepseek",
-    "exa": "exa",
-    "fireworks": "fireworks",
-    "groq": "groq",
-    "huggingface": "huggingface",
-    "mistralai": "mistralai",
-    "nomic": "nomic",
-    "ollama": "ollama",
-    "openai": "openai",
-    "openrouter": "openrouter",
-    "perplexity": "perplexity",
-    "qdrant": "qdrant",
-    "xai": "xai",
-    "deps": "dependencies",
-    "docs": "documentation",
-    "infra": "infra"
-  },
-  "fileRules": [
-    { "label": "core", "prefix": "libs/core/", "skipExcludedFiles": true },
-    { "label": "langchain-classic", "prefix": "libs/langchain/", "skipExcludedFiles": true },
-    { "label": "langchain", "prefix": "libs/langchain_v1/", "skipExcludedFiles": true },
-    { "label": "standard-tests", "prefix": "libs/standard-tests/", "skipExcludedFiles": true },
-    { "label": "model-profiles", "prefix": "libs/model-profiles/", "skipExcludedFiles": true },
-    { "label": "text-splitters", "prefix": "libs/text-splitters/", "skipExcludedFiles": true },
-    { "label": "integration", "prefix": "libs/partners/", "skipExcludedFiles": true },
-    { "label": "anthropic", "prefix": "libs/partners/anthropic/", "skipExcludedFiles": true },
-    { "label": "chroma", "prefix": "libs/partners/chroma/", "skipExcludedFiles": true },
-    { "label": "deepseek", "prefix": "libs/partners/deepseek/", "skipExcludedFiles": true },
-    { "label": "exa", "prefix": "libs/partners/exa/", "skipExcludedFiles": true },
-    { "label": "fireworks", "prefix": "libs/partners/fireworks/", "skipExcludedFiles": true },
-    { "label": "groq", "prefix": "libs/partners/groq/", "skipExcludedFiles": true },
-    { "label": "huggingface", "prefix": "libs/partners/huggingface/", "skipExcludedFiles": true },
-    { "label": "mistralai", "prefix": "libs/partners/mistralai/", "skipExcludedFiles": true },
-    { "label": "nomic", "prefix": "libs/partners/nomic/", "skipExcludedFiles": true },
-    { "label": "ollama", "prefix": "libs/partners/ollama/", "skipExcludedFiles": true },
-    { "label": "openai", "prefix": "libs/partners/openai/", "skipExcludedFiles": true },
-    { "label": "openrouter", "prefix": "libs/partners/openrouter/", "skipExcludedFiles": true },
-    { "label": "perplexity", "prefix": "libs/partners/perplexity/", "skipExcludedFiles": true },
-    { "label": "qdrant", "prefix": "libs/partners/qdrant/", "skipExcludedFiles": true },
-    { "label": "xai", "prefix": "libs/partners/xai/", "skipExcludedFiles": true },
-    { "label": "github_actions", "prefix": ".github/workflows/" },
-    { "label": "github_actions", "prefix": ".github/actions/" },
-    { "label": "dependencies", "suffix": "pyproject.toml" },
-    { "label": "dependencies", "exact": "uv.lock" },
-    { "label": "dependencies", "pattern": "(?:^|/)requirements[^/]*\\.txt$" }
-  ]
-}

.github/scripts/pr-labeler.js

@@ -1,278 +0,0 @@
-// Shared helpers for pr_labeler.yml and tag-external-issues.yml.
-//
-// Usage from actions/github-script (requires actions/checkout first):
-//   const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-const fs = require('fs');
-const path = require('path');
-
-function loadConfig() {
-  const configPath = path.join(__dirname, 'pr-labeler-config.json');
-  let raw;
-  try {
-    raw = fs.readFileSync(configPath, 'utf8');
-  } catch (e) {
-    throw new Error(`Failed to read ${configPath}: ${e.message}`);
-  }
-  let config;
-  try {
-    config = JSON.parse(raw);
-  } catch (e) {
-    throw new Error(`Failed to parse pr-labeler-config.json: ${e.message}`);
-  }
-  const required = [
-    'labelColor', 'sizeThresholds', 'fileRules',
-    'typeToLabel', 'scopeToLabel', 'trustedThreshold',
-    'excludedFiles', 'excludedPaths',
-  ];
-  const missing = required.filter(k => !(k in config));
-  if (missing.length > 0) {
-    throw new Error(`pr-labeler-config.json missing required keys: ${missing.join(', ')}`);
-  }
-  return config;
-}
-
-function init(github, owner, repo, config, core) {
-  if (!core) {
-    throw new Error('init() requires a `core` parameter (e.g., from actions/github-script)');
-  }
-  const {
-    trustedThreshold,
-    labelColor,
-    sizeThresholds,
-    scopeToLabel,
-    typeToLabel,
-    fileRules: fileRulesDef,
-    excludedFiles,
-    excludedPaths,
-  } = config;
-
-  const sizeLabels = sizeThresholds.map(t => t.label);
-  const allTypeLabels = [...new Set(Object.values(typeToLabel))];
-  const tierLabels = ['new-contributor', 'trusted-contributor'];
-
-  // ── Label management ──────────────────────────────────────────────
-
-  async function ensureLabel(name, color = labelColor) {
-    try {
-      await github.rest.issues.getLabel({ owner, repo, name });
-    } catch (e) {
-      if (e.status !== 404) throw e;
-      try {
-        await github.rest.issues.createLabel({ owner, repo, name, color });
-      } catch (createErr) {
-        // 422 = label created by a concurrent run between our get and create
-        if (createErr.status !== 422) throw createErr;
-        core.info(`Label "${name}" creation returned 422 (likely already exists)`);
-      }
-    }
-  }
-
-  // ── Size calculation ──────────────────────────────────────────────
-
-  function getSizeLabel(totalChanged) {
-    for (const t of sizeThresholds) {
-      if (t.max != null && totalChanged < t.max) return t.label;
-    }
-    // Last entry has no max — it's the catch-all
-    return sizeThresholds[sizeThresholds.length - 1].label;
-  }
-
-  function computeSize(files) {
-    const excluded = new Set(excludedFiles);
-    const totalChanged = files.reduce((sum, f) => {
-      const p = f.filename ?? '';
-      const base = p.split('/').pop();
-      if (excluded.has(base)) return sum;
-      for (const prefix of excludedPaths) {
-        if (p.startsWith(prefix)) return sum;
-      }
-      return sum + (f.additions ?? 0) + (f.deletions ?? 0);
-    }, 0);
-    return { totalChanged, sizeLabel: getSizeLabel(totalChanged) };
-  }
-
-  // ── File-based labels ─────────────────────────────────────────────
-
-  function buildFileRules() {
-    return fileRulesDef.map((rule, i) => {
-      let test;
-      if (rule.prefix) test = p => p.startsWith(rule.prefix);
-      else if (rule.suffix) test = p => p.endsWith(rule.suffix);
-      else if (rule.exact) test = p => p === rule.exact;
-      else if (rule.pattern) {
-        const re = new RegExp(rule.pattern);
-        test = p => re.test(p);
-      } else {
-        throw new Error(
-          `fileRules[${i}] (label: "${rule.label}") has no recognized matcher ` +
-          `(expected one of: prefix, suffix, exact, pattern)`
-        );
-      }
-      return { label: rule.label, test, skipExcluded: !!rule.skipExcludedFiles };
-    });
-  }
-
-  function matchFileLabels(files, fileRules) {
-    const rules = fileRules || buildFileRules();
-    const excluded = new Set(excludedFiles);
-    const labels = new Set();
-    for (const rule of rules) {
-      // skipExcluded: ignore files whose basename is in the top-level
-      // "excludedFiles" list (e.g. uv.lock) so lockfile-only changes
-      // don't trigger package labels.
-      const candidates = rule.skipExcluded
-        ? files.filter(f => !excluded.has((f.filename ?? '').split('/').pop()))
-        : files;
-      if (candidates.some(f => rule.test(f.filename ?? ''))) {
-        labels.add(rule.label);
-      }
-    }
-    return labels;
-  }
-
-  // ── Title-based labels ────────────────────────────────────────────
-
-  function matchTitleLabels(title) {
-    const labels = new Set();
-    const m = (title ?? '').match(/^(\w+)(?:\(([^)]+)\))?(!)?:/);
-    if (!m) return { labels, type: null, typeLabel: null, scopes: [], breaking: false };
-
-    const type = m[1].toLowerCase();
-    const scopeStr = m[2] ?? '';
-    const breaking = !!m[3];
-
-    const typeLabel = typeToLabel[type] || null;
-    if (typeLabel) labels.add(typeLabel);
-    if (breaking) labels.add('breaking');
-
-    const scopes = scopeStr.split(',').map(s => s.trim()).filter(Boolean);
-    for (const scope of scopes) {
-      const sl = scopeToLabel[scope];
-      if (sl) labels.add(sl);
-    }
-
-    return { labels, type, typeLabel, scopes, breaking };
-  }
-
-  // ── Org membership ────────────────────────────────────────────────
-
-  async function checkMembership(author, userType) {
-    if (userType === 'Bot') {
-      console.log(`${author} is a Bot — treating as internal`);
-      return { isExternal: false };
-    }
-
-    try {
-      const membership = await github.rest.orgs.getMembershipForUser({
-        org: 'langchain-ai',
-        username: author,
-      });
-      const isExternal = membership.data.state !== 'active';
-      console.log(
-        isExternal
-          ? `${author} has pending membership — treating as external`
-          : `${author} is an active member of langchain-ai`,
-      );
-      return { isExternal };
-    } catch (e) {
-      if (e.status === 404) {
-        console.log(`${author} is not a member of langchain-ai`);
-        return { isExternal: true };
-      }
-      // Non-404 errors (rate limit, auth failure, server error) must not
-      // silently default to external — rethrow to fail the step.
-      throw new Error(
-        `Membership check failed for ${author} (${e.status}): ${e.message}`,
-      );
-    }
-  }
-
-  // ── Contributor analysis ──────────────────────────────────────────
-
-  async function getContributorInfo(contributorCache, author, userType) {
-    if (contributorCache.has(author)) return contributorCache.get(author);
-
-    const { isExternal } = await checkMembership(author, userType);
-
-    let mergedCount = null;
-    if (isExternal) {
-      try {
-        const result = await github.rest.search.issuesAndPullRequests({
-          q: `repo:${owner}/${repo} is:pr is:merged author:"${author}"`,
-          per_page: 1,
-        });
-        mergedCount = result?.data?.total_count ?? null;
-      } catch (e) {
-        if (e?.status !== 422) throw e;
-        core.warning(`Search failed for ${author}; skipping tier.`);
-      }
-    }
-
-    const info = { isExternal, mergedCount };
-    contributorCache.set(author, info);
-    return info;
-  }
-
-  // ── Tier label resolution ───────────────────────────────────────────
-
-  async function applyTierLabel(issueNumber, author, { skipNewContributor = false } = {}) {
-    let mergedCount;
-    try {
-      const result = await github.rest.search.issuesAndPullRequests({
-        q: `repo:${owner}/${repo} is:pr is:merged author:"${author}"`,
-        per_page: 1,
-      });
-      mergedCount = result?.data?.total_count;
-    } catch (error) {
-      if (error?.status !== 422) throw error;
-      core.warning(`Search failed for ${author}; skipping tier label.`);
-      return;
-    }
-
-    if (mergedCount == null) {
-      core.warning(`Search response missing total_count for ${author}; skipping tier label.`);
-      return;
-    }
-
-    let tierLabel = null;
-    if (mergedCount >= trustedThreshold) tierLabel = 'trusted-contributor';
-    else if (mergedCount === 0 && !skipNewContributor) tierLabel = 'new-contributor';
-
-    if (tierLabel) {
-      await ensureLabel(tierLabel);
-      await github.rest.issues.addLabels({
-        owner, repo, issue_number: issueNumber, labels: [tierLabel],
-      });
-      console.log(`Applied '${tierLabel}' to #${issueNumber} (${mergedCount} merged PRs)`);
-    } else {
-      console.log(`No tier label for ${author} (${mergedCount} merged PRs)`);
-    }
-
-    return tierLabel;
-  }
-
-  return {
-    ensureLabel,
-    getSizeLabel,
-    computeSize,
-    buildFileRules,
-    matchFileLabels,
-    matchTitleLabels,
-    allTypeLabels,
-    checkMembership,
-    getContributorInfo,
-    applyTierLabel,
-    sizeLabels,
-    tierLabels,
-    trustedThreshold,
-    labelColor,
-  };
-}
-
-function loadAndInit(github, owner, repo, core) {
-  const config = loadConfig();
-  return { config, h: init(github, owner, repo, config, core) };
-}
-
-module.exports = { loadConfig, init, loadAndInit };

.github/workflows/_refresh_model_profiles.yml

@@ -1,202 +0,0 @@
-# Reusable workflow: refreshes model profile data for any repo that uses the
-# `langchain-profiles` CLI. Creates (or updates) a pull request with the
-# resulting changes.
-#
-# Callers MUST set `permissions: { contents: write, pull-requests: write }` —
-# reusable workflows cannot escalate the caller's token permissions.
-#
-# ── Example: external repo (langchain-google) ──────────────────────────
-#
-#   jobs:
-#     refresh-profiles:
-#       uses: langchain-ai/langchain/.github/workflows/_refresh_model_profiles.yml@master
-#       with:
-#         providers: >-
-#           [
-#             {"provider":"google",        "data_dir":"libs/genai/langchain_google_genai/data"},
-#           ]
-#       secrets:
-#         MODEL_PROFILE_BOT_APP_ID:      ${{ secrets.MODEL_PROFILE_BOT_APP_ID }}
-#         MODEL_PROFILE_BOT_PRIVATE_KEY: ${{ secrets.MODEL_PROFILE_BOT_PRIVATE_KEY }}
-
-name: "Refresh Model Profiles (reusable)"
-
-on:
-  workflow_call:
-    inputs:
-      providers:
-        description: >-
-          JSON array of objects, each with `provider` (models.dev provider ID)
-          and `data_dir` (path relative to repo root where `_profiles.py` and
-          `profile_augmentations.toml` live).
-        required: true
-        type: string
-      cli-path:
-        description: >-
-          Path (relative to workspace) to an existing `libs/model-profiles`
-          checkout.  When set the workflow skips cloning the langchain repo and
-          uses this directory for the CLI instead.  Useful when the caller IS
-          the langchain monorepo.
-        required: false
-        type: string
-        default: ""
-      cli-ref:
-        description: >-
-          Git ref of langchain-ai/langchain to checkout for the CLI.
-          Ignored when `cli-path` is set.
-        required: false
-        type: string
-        default: master
-      add-paths:
-        description: "Glob for files to stage in the PR commit."
-        required: false
-        type: string
-        default: "**/_profiles.py"
-      pr-branch:
-        description: "Branch name for the auto-created PR."
-        required: false
-        type: string
-        default: bot/refresh-model-profiles
-      pr-title:
-        description: "PR / commit title."
-        required: false
-        type: string
-        default: "chore(model-profiles): refresh model profile data"
-      pr-body:
-        description: "PR body."
-        required: false
-        type: string
-        default: |
-          Automated refresh of model profile data via `langchain-profiles refresh`.
-
-          🤖 Generated by the `refresh_model_profiles` workflow.
-      pr-labels:
-        description: "Comma-separated labels to apply to the PR."
-        required: false
-        type: string
-        default: bot
-    secrets:
-      MODEL_PROFILE_BOT_APP_ID:
-        required: true
-      MODEL_PROFILE_BOT_PRIVATE_KEY:
-        required: true
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  refresh-profiles:
-    name: refresh model profiles
-    runs-on: ubuntu-latest
-    steps:
-      - name: "📋 Checkout"
-        uses: actions/checkout@v6
-
-      - name: "📋 Checkout langchain-profiles CLI"
-        if: inputs.cli-path == ''
-        uses: actions/checkout@v6
-        with:
-          repository: langchain-ai/langchain
-          ref: ${{ inputs.cli-ref }}
-          sparse-checkout: libs/model-profiles
-          path: _langchain-cli
-
-      - name: "🔧 Resolve CLI directory"
-        id: cli
-        env:
-          CLI_PATH: ${{ inputs.cli-path }}
-        run: |
-          if [ -n "${CLI_PATH}" ]; then
-            resolved="${GITHUB_WORKSPACE}/${CLI_PATH}"
-            if [ ! -d "${resolved}" ]; then
-              echo "::error::cli-path '${CLI_PATH}' does not exist at ${resolved}"
-              exit 1
-            fi
-            echo "dir=${CLI_PATH}" >> "$GITHUB_OUTPUT"
-          else
-            echo "dir=_langchain-cli/libs/model-profiles" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: "🐍 Set up Python + uv"
-        uses: astral-sh/setup-uv@0ca8f610542aa7f4acaf39e65cf4eb3c35091883 # v7
-        with:
-          version: "0.5.25"
-          python-version: "3.12"
-          enable-cache: true
-          cache-dependency-glob: "**/model-profiles/uv.lock"
-
-      - name: "📦 Install langchain-profiles CLI"
-        working-directory: ${{ steps.cli.outputs.dir }}
-        run: uv sync --frozen --no-group test --no-group dev --no-group lint
-
-      - name: "✅ Validate providers input"
-        env:
-          PROVIDERS_JSON: ${{ inputs.providers }}
-        run: |
-          echo "${PROVIDERS_JSON}" | jq -e 'type == "array" and length > 0' > /dev/null || {
-            echo "::error::providers input must be a non-empty JSON array"
-            exit 1
-          }
-          echo "${PROVIDERS_JSON}" | jq -e 'all(has("provider") and has("data_dir"))' > /dev/null || {
-            echo "::error::every entry in providers must have 'provider' and 'data_dir' keys"
-            exit 1
-          }
-
-      - name: "🔄 Refresh profiles"
-        env:
-          PROVIDERS_JSON: ${{ inputs.providers }}
-        run: |
-          cli_dir="${GITHUB_WORKSPACE}/${{ steps.cli.outputs.dir }}"
-          failed=""
-          mapfile -t rows < <(echo "${PROVIDERS_JSON}" | jq -c '.[]')
-          for row in "${rows[@]}"; do
-            provider=$(echo "${row}" | jq -r '.provider')
-            data_dir=$(echo "${row}" | jq -r '.data_dir')
-            echo "--- Refreshing ${provider} -> ${data_dir} ---"
-            if ! echo y | uv run --frozen --project "${cli_dir}" \
-              langchain-profiles refresh \
-              --provider "${provider}" \
-              --data-dir "${GITHUB_WORKSPACE}/${data_dir}"; then
-              echo "::error::Failed to refresh provider: ${provider}"
-              failed="${failed} ${provider}"
-            fi
-          done
-          if [ -n "${failed}" ]; then
-            echo "::error::The following providers failed:${failed}"
-            exit 1
-          fi
-
-      - name: "🔑 Generate GitHub App token"
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.MODEL_PROFILE_BOT_APP_ID }}
-          private-key: ${{ secrets.MODEL_PROFILE_BOT_PRIVATE_KEY }}
-
-      - name: "🔀 Create pull request"
-        id: create-pr
-        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8
-        with:
-          token: ${{ steps.app-token.outputs.token }}
-          branch: ${{ inputs.pr-branch }}
-          commit-message: ${{ inputs.pr-title }}
-          title: ${{ inputs.pr-title }}
-          body: ${{ inputs.pr-body }}
-          labels: ${{ inputs.pr-labels }}
-          add-paths: ${{ inputs.add-paths }}
-
-      - name: "📝 Summary"
-        if: always()
-        env:
-          PR_OP: ${{ steps.create-pr.outputs.pull-request-operation }}
-          PR_URL: ${{ steps.create-pr.outputs.pull-request-url }}
-          JOB_STATUS: ${{ job.status }}
-        run: |
-          if [ "${PR_OP}" = "created" ] || [ "${PR_OP}" = "updated" ]; then
-            echo "### ✅ PR ${PR_OP}: ${PR_URL}" >> "$GITHUB_STEP_SUMMARY"
-          elif [ -z "${PR_OP}" ] && [ "${JOB_STATUS}" = "success" ]; then
-            echo "### ⏭️ Skipped: profiles already up to date" >> "$GITHUB_STEP_SUMMARY"
-          elif [ "${JOB_STATUS}" = "failure" ]; then
-            echo "### ❌ Job failed — check step logs for details" >> "$GITHUB_STEP_SUMMARY"
-          fi

.github/workflows/_release.yml

@@ -37,7 +37,7 @@ env:
   UV_NO_SYNC: "true"
 
 permissions:
-  contents: read # Job-level overrides grant write only where needed (mark-release)
+  contents: write # Required for creating GitHub releases
 
 jobs:
   # Build the distribution package and extract version info
@@ -77,7 +77,7 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
       - name: Upload build
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
@@ -97,8 +97,6 @@ jobs:
               f.write(f"pkg-name={pkg_name}\n")
               f.write(f"version={version}\n")
   release-notes:
-    # release-notes must run before publishing because its check-tags step
-    # validates version/tag state — do not remove this dependency.
     needs:
       - build
     runs-on: ubuntu-latest
@@ -195,8 +193,6 @@ jobs:
           } >> "$GITHUB_OUTPUT"
 
   test-pypi-publish:
-    # release-notes must run before publishing because its check-tags step
-    # validates version/tag state — do not remove this dependency.
     needs:
       - build
       - release-notes
@@ -212,13 +208,13 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - uses: actions/download-artifact@v8
+      - uses: actions/download-artifact@v7
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
 
       - name: Publish to test PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           packages-dir: ${{ inputs.working-directory }}/dist/
           verbose: true
@@ -262,7 +258,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v8
+      - uses: actions/download-artifact@v7
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
@@ -381,8 +377,6 @@ jobs:
           XAI_API_KEY: ${{ secrets.XAI_API_KEY }}
           DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
           PPLX_API_KEY: ${{ secrets.PPLX_API_KEY }}
-          OLLAMA_API_KEY: ${{ secrets.OLLAMA_API_KEY }}
-          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           LANGCHAIN_TESTS_USER_AGENT: ${{ secrets.LANGCHAIN_TESTS_USER_AGENT }}
         run: make integration_tests
         working-directory: ${{ inputs.working-directory }}
@@ -403,7 +397,7 @@ jobs:
     if: false # temporarily skip
     strategy:
       matrix:
-        partner: [anthropic]
+        partner: [openai, anthropic]
       fail-fast: false # Continue testing other partners if one fails
     env:
       ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
@@ -437,7 +431,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v8
+      - uses: actions/download-artifact@v7
         if: startsWith(inputs.working-directory, 'libs/core')
         with:
           name: dist
@@ -477,67 +471,6 @@ jobs:
           uv pip install ../../core/dist/*.whl
           make integration_tests
 
-  # Test external packages that depend on langchain-core/langchain against the new release
-  # Only runs for core and langchain_v1 releases to catch breaking changes before publish
-  test-dependents:
-    name: "🐍 Python ${{ matrix.python-version }}: ${{ matrix.package.path }}"
-    needs:
-      - build
-      - release-notes
-      - test-pypi-publish
-      - pre-release-checks
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    # Only run for core or langchain_v1 releases
-    if: startsWith(inputs.working-directory, 'libs/core') || startsWith(inputs.working-directory, 'libs/langchain_v1')
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.11", "3.13"]
-        package:
-          - name: deepagents
-            repo: langchain-ai/deepagents
-            path: libs/deepagents
-    # No API keys needed for now - deepagents `make test` only runs unit tests
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          path: langchain
-
-      - uses: actions/checkout@v6
-        with:
-          repository: ${{ matrix.package.repo }}
-          path: ${{ matrix.package.name }}
-
-      - name: Set up Python + uv
-        uses: "./langchain/.github/actions/uv_setup"
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - uses: actions/download-artifact@v8
-        with:
-          name: dist
-          path: dist/
-
-      - name: Install ${{ matrix.package.name }} with local packages
-        # External dependents don't have [tool.uv.sources] pointing to this repo,
-        # so we install the package normally then override with the built wheel.
-        run: |
-          cd ${{ matrix.package.name }}/${{ matrix.package.path }}
-
-          # Install the package with test dependencies
-          uv sync --group test
-
-          # Override with the built wheel from this release
-          uv pip install $GITHUB_WORKSPACE/dist/*.whl
-
-      - name: Run ${{ matrix.package.name }} tests
-        run: |
-          cd ${{ matrix.package.name }}/${{ matrix.package.path }}
-          make test
-
   publish:
     # Publishes the package to PyPI
     needs:
@@ -545,10 +478,7 @@ jobs:
       - release-notes
       - test-pypi-publish
       - pre-release-checks
-      - test-dependents
       # - test-prior-published-packages-against-new-core
-    # Run if all needed jobs succeeded or were skipped (test-dependents only runs for core/langchain_v1)
-    if: ${{ !cancelled() && !failure() }}
     runs-on: ubuntu-latest
     permissions:
       # This permission is used for trusted publishing:
@@ -570,13 +500,13 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v8
+      - uses: actions/download-artifact@v7
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           packages-dir: ${{ inputs.working-directory }}/dist/
           verbose: true
@@ -592,8 +522,6 @@ jobs:
       - test-pypi-publish
       - pre-release-checks
       - publish
-    # Run if all needed jobs succeeded or were skipped (test-dependents only runs for core/langchain_v1)
-    if: ${{ !cancelled() && !failure() }}
     runs-on: ubuntu-latest
     permissions:
       # This permission is needed by `ncipollo/release-action` to
@@ -612,13 +540,13 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v8
+      - uses: actions/download-artifact@v7
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
 
       - name: Create Tag
-        uses: ncipollo/release-action@b7eabc95ff50cbeeedec83973935c8f306dfcd0b # v1
+        uses: ncipollo/release-action@v1
         with:
           artifacts: "dist/*"
           token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/_test.yml

@@ -50,7 +50,7 @@ jobs:
       - name: "🧪 Run Core Unit Tests"
         shell: bash
         run: |
-          make test PYTEST_EXTRA=-q
+          make test
 
       - name: "🔍 Calculate Minimum Dependency Versions"
         working-directory: ${{ inputs.working-directory }}
@@ -69,7 +69,7 @@ jobs:
           MIN_VERSIONS: ${{ steps.min-version.outputs.min-versions }}
         run: |
           VIRTUAL_ENV=.venv uv pip install $MIN_VERSIONS
-          make tests PYTEST_EXTRA=-q
+          make tests
         working-directory: ${{ inputs.working-directory }}
 
       - name: "🧹 Verify Clean Working Directory"

.github/workflows/auto-label-by-package.yml

@@ -4,9 +4,6 @@ on:
   issues:
     types: [opened, edited]
 
-permissions:
-  contents: read
-
 jobs:
   label-by-package:
     permissions:
@@ -33,6 +30,7 @@ jobs:
               "langchain-anthropic": "anthropic",
               "langchain-classic": "langchain-classic",
               "langchain-core": "core",
+              "langchain-cli": "cli",
               "langchain-model-profiles": "model-profiles",
               "langchain-tests": "standard-tests",
               "langchain-text-splitters": "text-splitters",
@@ -45,8 +43,8 @@ jobs:
               "langchain-mistralai": "mistralai",
               "langchain-nomic": "nomic",
               "langchain-ollama": "ollama",
-              "langchain-openrouter": "openrouter",
               "langchain-perplexity": "perplexity",
+              "langchain-prompty": "prompty",
               "langchain-qdrant": "qdrant",
               "langchain-xai": "xai",
             };

.github/workflows/check_agents_sync.yml

@@ -1,42 +0,0 @@
-# Ensures CLAUDE.md and AGENTS.md stay synchronized.
-#
-# These files contain the same development guidelines but are named differently
-# for compatibility with different AI coding assistants (Claude Code uses CLAUDE.md,
-# other tools may use AGENTS.md).
-
-name: "🔄 Check CLAUDE.md / AGENTS.md Sync"
-
-on:
-  push:
-    branches: [master]
-    paths:
-      - "CLAUDE.md"
-      - "AGENTS.md"
-  pull_request:
-    paths:
-      - "CLAUDE.md"
-      - "AGENTS.md"
-
-permissions:
-  contents: read
-
-jobs:
-  check-sync:
-    name: "verify files are identical"
-    runs-on: ubuntu-latest
-    steps:
-      - name: "📋 Checkout Code"
-        uses: actions/checkout@v6
-
-      - name: "🔍 Check CLAUDE.md and AGENTS.md are in sync"
-        run: |
-          if ! diff -q CLAUDE.md AGENTS.md > /dev/null 2>&1; then
-            echo "❌ CLAUDE.md and AGENTS.md are out of sync!"
-            echo ""
-            echo "These files must contain identical content."
-            echo "Differences:"
-            echo ""
-            diff --color=always CLAUDE.md AGENTS.md || true
-            exit 1
-          fi
-          echo "✅ CLAUDE.md and AGENTS.md are in sync"

.github/workflows/check_core_versions.yml

@@ -9,8 +9,6 @@ on:
     paths:
       - "libs/core/pyproject.toml"
       - "libs/core/langchain_core/version.py"
-      - "libs/partners/anthropic/pyproject.toml"
-      - "libs/partners/anthropic/langchain_anthropic/_version.py"
 
 permissions:
   contents: read
@@ -51,17 +49,3 @@ jobs:
           else
             echo "Langchain v1 versions match: $LANGCHAIN_PYPROJECT_VERSION"
           fi
-
-          # Check langchain-anthropic versions
-          ANTHROPIC_PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]*' libs/partners/anthropic/pyproject.toml)
-          ANTHROPIC_VERSION_PY_VERSION=$(grep -Po '(?<=^__version__ = ")[^"]*' libs/partners/anthropic/langchain_anthropic/_version.py)
-
-          # Compare langchain-anthropic versions
-          if [ "$ANTHROPIC_PYPROJECT_VERSION" != "$ANTHROPIC_VERSION_PY_VERSION" ]; then
-            echo "langchain-anthropic versions in pyproject.toml and _version.py do not match!"
-            echo "pyproject.toml version: $ANTHROPIC_PYPROJECT_VERSION"
-            echo "_version.py version: $ANTHROPIC_VERSION_PY_VERSION"
-            exit 1
-          else
-            echo "Langchain-anthropic versions match: $ANTHROPIC_PYPROJECT_VERSION"
-          fi

.github/workflows/check_diffs.yml

@@ -8,6 +8,7 @@
 # - Pydantic compatibility tests (_test_pydantic.yml)
 # - Integration test compilation checks (_compile_integration_test.yml)
 # - Extended test suites that require additional dependencies
+# - Codspeed benchmarks (if not labeled 'codspeed-ignore')
 #
 # Reports status to GitHub checks and PR status.
 
@@ -53,7 +54,7 @@ jobs:
           python-version: "3.11"
       - name: "📂 Get Changed Files"
         id: files
-        uses: Ana06/get-changed-files@25f79e676e7ea1868813e21465014798211fad8c # v2.3.0
+        uses: Ana06/get-changed-files@v2.3.0
       - name: "🔍 Analyze Changed Files & Generate Build Matrix"
         id: set-matrix
         run: |
@@ -66,6 +67,7 @@ jobs:
       compile-integration-tests: ${{ steps.set-matrix.outputs.compile-integration-tests }}
       dependencies: ${{ steps.set-matrix.outputs.dependencies }}
       test-pydantic: ${{ steps.set-matrix.outputs.test-pydantic }}
+      codspeed: ${{ steps.set-matrix.outputs.codspeed }}
   # Run linting only on packages that have changed files
   lint:
     needs: [build]
@@ -169,6 +171,67 @@ jobs:
           # and `set -e` above will cause the step to fail.
           echo "$STATUS" | grep 'nothing to commit, working tree clean'
 
+  # Run codspeed benchmarks only on packages that have changed files
+  codspeed:
+    name: "⚡ CodSpeed Benchmarks"
+    needs: [build]
+    if: ${{ needs.build.outputs.codspeed != '[]' && !contains(github.event.pull_request.labels.*.name, 'codspeed-ignore') }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        job-configs: ${{ fromJson(needs.build.outputs.codspeed) }}
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: "📦 Install UV Package Manager"
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.13"
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: "📦 Install Test Dependencies"
+        run: uv sync --group test
+        working-directory: ${{ matrix.job-configs.working-directory }}
+
+      - name: "⚡ Run Benchmarks: ${{ matrix.job-configs.working-directory }}"
+        uses: CodSpeedHQ/action@v4
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          ANTHROPIC_FILES_API_IMAGE_ID: ${{ secrets.ANTHROPIC_FILES_API_IMAGE_ID }}
+          ANTHROPIC_FILES_API_PDF_ID: ${{ secrets.ANTHROPIC_FILES_API_PDF_ID }}
+          AZURE_OPENAI_API_VERSION: ${{ secrets.AZURE_OPENAI_API_VERSION }}
+          AZURE_OPENAI_API_BASE: ${{ secrets.AZURE_OPENAI_API_BASE }}
+          AZURE_OPENAI_API_KEY: ${{ secrets.AZURE_OPENAI_API_KEY }}
+          AZURE_OPENAI_CHAT_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_CHAT_DEPLOYMENT_NAME }}
+          AZURE_OPENAI_LEGACY_CHAT_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_LEGACY_CHAT_DEPLOYMENT_NAME }}
+          AZURE_OPENAI_LLM_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_LLM_DEPLOYMENT_NAME }}
+          AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT_NAME }}
+          COHERE_API_KEY: ${{ secrets.COHERE_API_KEY }}
+          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
+          EXA_API_KEY: ${{ secrets.EXA_API_KEY }}
+          FIREWORKS_API_KEY: ${{ secrets.FIREWORKS_API_KEY }}
+          GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
+          HUGGINGFACEHUB_API_TOKEN: ${{ secrets.HUGGINGFACEHUB_API_TOKEN }}
+          MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+          NOMIC_API_KEY: ${{ secrets.NOMIC_API_KEY }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          PPLX_API_KEY: ${{ secrets.PPLX_API_KEY }}
+          XAI_API_KEY: ${{ secrets.XAI_API_KEY }}
+        with:
+          token: ${{ secrets.CODSPEED_TOKEN }}
+          run: |
+            cd ${{ matrix.job-configs.working-directory }}
+            if [ "${{ matrix.job-configs.working-directory }}" = "libs/core" ]; then
+              uv run --no-sync pytest ./tests/benchmarks --codspeed
+            else
+              uv run --no-sync pytest ./tests/ --codspeed
+            fi
+          mode: ${{ matrix.job-configs.working-directory == 'libs/core' && 'walltime' || 'instrumentation' }}
+
   # Final status check - ensures all required jobs passed before allowing merge
   ci_success:
     name: "✅ CI Success"
@@ -180,6 +243,7 @@ jobs:
         compile-integration-tests,
         extended-tests,
         test-pydantic,
+        codspeed,
       ]
     if: |
       always()

.github/workflows/close_unchecked_issues.yml

@@ -1,106 +0,0 @@
-# Auto-close issues that bypass or ignore the issue template checkboxes.
-#
-# GitHub issue forms enforce `required: true` checkboxes in the web UI,
-# but the API bypasses form validation entirely — bots/scripts can open
-# issues with every box unchecked or skip the template altogether.
-#
-# Rules:
-#   1. Checkboxes present, none checked → close
-#   2. No checkboxes at all → close unless author is an org member or bot
-#
-# Org membership check reuses the shared helper from pr-labeler.js and
-# the same GitHub App used by tag-external-issues.yml.
-
-name: Close Unchecked Issues
-
-on:
-  issues:
-    types: [opened]
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.issue.number }}
-  cancel-in-progress: true
-
-jobs:
-  check-boxes:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      issues: write
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.ORG_MEMBERSHIP_APP_ID }}
-          private-key: ${{ secrets.ORG_MEMBERSHIP_APP_PRIVATE_KEY }}
-
-      - name: Validate issue checkboxes
-        if: steps.app-token.outcome == 'success'
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const body = context.payload.issue.body ?? '';
-            const checked = (body.match(/- \[x\]/gi) || []).length;
-
-            if (checked > 0) {
-              console.log(`Found ${checked} checked checkbox(es) — OK`);
-              return;
-            }
-
-            const unchecked = (body.match(/- \[ \]/g) || []).length;
-
-            // No checkboxes at all — allow org members and bots, close everyone else
-            if (unchecked === 0) {
-              const { owner, repo } = context.repo;
-              const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-              const author = context.payload.sender.login;
-              const { isExternal } = await h.checkMembership(
-                author, context.payload.sender.type,
-              );
-
-              if (!isExternal) {
-                console.log(`No checkboxes, but ${author} is internal — OK`);
-                return;
-              }
-              console.log(`No checkboxes and ${author} is external — closing`);
-            } else {
-              console.log(`Found 0 checked and ${unchecked} unchecked checkbox(es) — closing`);
-            }
-
-            const { owner, repo } = context.repo;
-            const issue_number = context.payload.issue.number;
-
-            const reason = unchecked > 0
-              ? 'none of the required checkboxes were checked'
-              : 'no issue template was used';
-
-            // Close before commenting — a closed issue without a comment is
-            // less confusing than an open issue with a false "auto-closed" message
-            // if the second API call fails.
-            await github.rest.issues.update({
-              owner,
-              repo,
-              issue_number,
-              state: 'closed',
-              state_reason: 'not_planned',
-            });
-
-            await github.rest.issues.createComment({
-              owner,
-              repo,
-              issue_number,
-              body: [
-                `This issue was automatically closed because ${reason}.`,
-                '',
-                `Please use one of the [issue templates](https://github.com/${owner}/${repo}/issues/new/choose) and complete the checklist.`,
-              ].join('\n'),
-            });

.github/workflows/codspeed.yml

@@ -1,85 +0,0 @@
-# CodSpeed performance benchmarks.
-#
-# Runs benchmarks on changed packages and uploads results to CodSpeed.
-# Separated from the main CI workflow so that push-to-master baseline runs
-# are never cancelled by subsequent merges (cancel-in-progress is only
-# enabled for pull_request events).
-
-name: "⚡ CodSpeed"
-
-on:
-  push:
-    branches: [master]
-  pull_request:
-
-# On PRs, cancel stale runs when new commits are pushed.
-# On push-to-master, never cancel — these runs populate CodSpeed baselines.
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
-
-permissions:
-  contents: read
-
-env:
-  UV_FROZEN: "true"
-  UV_NO_SYNC: "true"
-
-jobs:
-  build:
-    name: "Detect Changes"
-    runs-on: ubuntu-latest
-    if: ${{ !contains(github.event.pull_request.labels.*.name, 'codspeed-ignore') }}
-    steps:
-      - name: "📋 Checkout Code"
-        uses: actions/checkout@v6
-      - name: "🐍 Setup Python 3.11"
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.11"
-      - name: "📂 Get Changed Files"
-        id: files
-        uses: Ana06/get-changed-files@25f79e676e7ea1868813e21465014798211fad8c # v2.3.0
-      - name: "🔍 Analyze Changed Files"
-        id: set-matrix
-        run: |
-          python -m pip install packaging requests
-          python .github/scripts/check_diff.py ${{ steps.files.outputs.all }} >> $GITHUB_OUTPUT
-    outputs:
-      codspeed: ${{ steps.set-matrix.outputs.codspeed }}
-
-  benchmarks:
-    name: "⚡ CodSpeed Benchmarks"
-    needs: [build]
-    if: ${{ needs.build.outputs.codspeed != '[]' }}
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        job-configs: ${{ fromJson(needs.build.outputs.codspeed) }}
-      fail-fast: false
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: "📦 Install UV Package Manager"
-        uses: astral-sh/setup-uv@0ca8f610542aa7f4acaf39e65cf4eb3c35091883 # v7
-        with:
-          # Pinned to 3.13.11 to work around CodSpeed walltime segfault on 3.13.12+
-          # See: https://github.com/CodSpeedHQ/pytest-codspeed/issues/106
-          python-version: "3.13.11"
-
-      - name: "📦 Install Test Dependencies"
-        run: uv sync --group test
-        working-directory: ${{ matrix.job-configs.working-directory }}
-
-      - name: "⚡ Run Benchmarks: ${{ matrix.job-configs.working-directory }}"
-        uses: CodSpeedHQ/action@a50965600eafa04edcd6717761f55b77e52aafbd # v4
-        with:
-          token: ${{ secrets.CODSPEED_TOKEN }}
-          run: |
-            cd ${{ matrix.job-configs.working-directory }}
-            if [ "${{ matrix.job-configs.working-directory }}" = "libs/core" ]; then
-              uv run --no-sync pytest ./tests/benchmarks --codspeed
-            else
-              uv run --no-sync pytest ./tests/unit_tests/ -m benchmark --codspeed
-            fi
-          mode: ${{ matrix.job-configs.codspeed-mode }}

.github/workflows/integration_tests.yml

@@ -1,8 +1,8 @@
 # Routine integration tests against partner libraries with live API credentials.
 #
-# Uses `make integration_tests` within each library being tested.
+# Uses `make integration_tests` for each library in the matrix.
 #
-# Runs daily with the option to trigger manually.
+# Runs daily. Can also be triggered manually for immediate updates.
 
 name: "⏰ Integration Tests"
 run-name: "Run Integration Tests - ${{ inputs.working-directory-force || 'all libs' }} (Python ${{ inputs.python-version-force || '3.10, 3.13' }})"
@@ -24,29 +24,17 @@ permissions:
 
 env:
   UV_FROZEN: "true"
-  DEFAULT_LIBS: >-
-    ["libs/partners/openai",
-    "libs/partners/anthropic",
-    "libs/partners/fireworks",
-    "libs/partners/groq",
-    "libs/partners/mistralai",
-    "libs/partners/xai",
-    "libs/partners/google-vertexai",
-    "libs/partners/google-genai",
-    "libs/partners/aws"]
+  DEFAULT_LIBS: '["libs/partners/openai", "libs/partners/anthropic", "libs/partners/fireworks", "libs/partners/groq", "libs/partners/mistralai", "libs/partners/xai", "libs/partners/google-vertexai", "libs/partners/google-genai", "libs/partners/aws"]'
 
 jobs:
   # Generate dynamic test matrix based on input parameters or defaults
   # Only runs on the main repo (for scheduled runs) or when manually triggered
   compute-matrix:
-    # Defend against forks running scheduled jobs, but allow manual runs from forks
     if: github.repository_owner == 'langchain-ai' || github.event_name != 'schedule'
-
     runs-on: ubuntu-latest
     name: "📋 Compute Test Matrix"
     outputs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
-      python-version-min-3-11: ${{ steps.set-matrix.outputs.python-version-min-3-11 }}
     steps:
       - name: "🔢 Generate Python & Library Matrix"
         id: set-matrix
@@ -59,16 +47,9 @@ jobs:
           # python-version should default to 3.10 and 3.13, but is overridden to [PYTHON_VERSION_FORCE] if set
           # working-directory should default to DEFAULT_LIBS, but is overridden to [WORKING_DIRECTORY_FORCE] if set
           python_version='["3.10", "3.13"]'
-          python_version_min_3_11='["3.11", "3.13"]'
           working_directory="$DEFAULT_LIBS"
           if [ -n "$PYTHON_VERSION_FORCE" ]; then
             python_version="[\"$PYTHON_VERSION_FORCE\"]"
-            # Bound forced version to >= 3.11 for packages requiring it
-            if [ "$(echo "$PYTHON_VERSION_FORCE >= 3.11" | bc -l)" -eq 1 ]; then
-              python_version_min_3_11="[\"$PYTHON_VERSION_FORCE\"]"
-            else
-              python_version_min_3_11='["3.11"]'
-            fi
           fi
           if [ -n "$WORKING_DIRECTORY_FORCE" ]; then
             working_directory="[\"$WORKING_DIRECTORY_FORCE\"]"
@@ -76,10 +57,8 @@ jobs:
           matrix="{\"python-version\": $python_version, \"working-directory\": $working_directory}"
           echo $matrix
           echo "matrix=$matrix" >> $GITHUB_OUTPUT
-          echo "python-version-min-3-11=$python_version_min_3_11" >> $GITHUB_OUTPUT
-
   # Run integration tests against partner libraries with live API credentials
-  integration-tests:
+  build:
     if: github.repository_owner == 'langchain-ai' || github.event_name != 'schedule'
     name: "🐍 Python ${{ matrix.python-version }}: ${{ matrix.working-directory }}"
     runs-on: ubuntu-latest
@@ -95,27 +74,15 @@ jobs:
       - uses: actions/checkout@v6
         with:
           path: langchain
-
-      # These libraries exist outside of the monorepo and need to be checked out separately
       - uses: actions/checkout@v6
         with:
           repository: langchain-ai/langchain-google
           path: langchain-google
-      - name: "🔐 Authenticate to Google Cloud"
-        id: "auth"
-        uses: google-github-actions/auth@7c6bc770dae815cd3e89ee6cdf493a5fab2cc093 # v3
-        with:
-          credentials_json: "${{ secrets.GOOGLE_CREDENTIALS }}"
       - uses: actions/checkout@v6
         with:
           repository: langchain-ai/langchain-aws
           path: langchain-aws
-      - name: "🔐 Configure AWS Credentials"
-        uses: aws-actions/configure-aws-credentials@fb7eb401298e393da51cdcb2feb1ed0183619014 # v6
-        with:
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          aws-region: ${{ secrets.AWS_REGION }}
+
       - name: "📦 Organize External Libraries"
         run: |
           rm -rf \
@@ -130,27 +97,27 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: "📦 Install Dependencies"
-        # Partner packages use [tool.uv.sources] in their pyproject.toml to resolve
-        # langchain-core/langchain to local editable installs, so `uv sync` automatically
-        # tests against the versions from the current branch (not published releases).
+      - name: "🔐 Authenticate to Google Cloud"
+        id: "auth"
+        uses: google-github-actions/auth@v3
+        with:
+          credentials_json: "${{ secrets.GOOGLE_CREDENTIALS }}"
 
-        # TODO: external google/aws don't have local resolution since they live in
-        # separate repos, so they pull `core`/`langchain_v1` from PyPI. We should update
-        # their dev groups to use git source dependencies pointing to the current
-        # branch's latest commit SHA to fully test against local langchain changes.
+      - name: "🔐 Configure AWS Credentials"
+        uses: aws-actions/configure-aws-credentials@v5
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: ${{ secrets.AWS_REGION }}
+
+      - name: "📦 Install Dependencies"
         run: |
           echo "Running scheduled tests, installing dependencies with uv..."
           cd langchain/${{ matrix.working-directory }}
           uv sync --group test --group test_integration
 
       - name: "🚀 Run Integration Tests"
-        # WARNING: All secrets below are available to every matrix job regardless of
-        # which package is being tested. This is intentional for simplicity, but means
-        # any test file could technically access any key. Only use for trusted code.
         env:
-          LANGCHAIN_TESTS_USER_AGENT: ${{ secrets.LANGCHAIN_TESTS_USER_AGENT }}
-
           AI21_API_KEY: ${{ secrets.AI21_API_KEY }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
           ANTHROPIC_FILES_API_IMAGE_ID: ${{ secrets.ANTHROPIC_FILES_API_IMAGE_ID }}
@@ -181,15 +148,14 @@ jobs:
           MONGODB_ATLAS_URI: ${{ secrets.MONGODB_ATLAS_URI }}
           NOMIC_API_KEY: ${{ secrets.NOMIC_API_KEY }}
           NVIDIA_API_KEY: ${{ secrets.NVIDIA_API_KEY }}
-          OLLAMA_API_KEY: ${{ secrets.OLLAMA_API_KEY }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           PPLX_API_KEY: ${{ secrets.PPLX_API_KEY }}
           TOGETHER_API_KEY: ${{ secrets.TOGETHER_API_KEY }}
           UPSTAGE_API_KEY: ${{ secrets.UPSTAGE_API_KEY }}
           WATSONX_APIKEY: ${{ secrets.WATSONX_APIKEY }}
           WATSONX_PROJECT_ID: ${{ secrets.WATSONX_PROJECT_ID }}
           XAI_API_KEY: ${{ secrets.XAI_API_KEY }}
+          LANGCHAIN_TESTS_USER_AGENT: ${{ secrets.LANGCHAIN_TESTS_USER_AGENT }}
         run: |
           cd langchain/${{ matrix.working-directory }}
           make integration_tests
@@ -213,59 +179,3 @@ jobs:
           # grep will exit non-zero if the target message isn't found,
           # and `set -e` above will cause the step to fail.
           echo "$STATUS" | grep 'nothing to commit, working tree clean'
-
-  # Test dependent packages against local packages to catch breaking changes
-  test-dependents:
-    # Defend against forks running scheduled jobs, but allow manual runs from forks
-    if: github.repository_owner == 'langchain-ai' || github.event_name != 'schedule'
-
-    name: "🐍 Python ${{ matrix.python-version }}: ${{ matrix.package.path }}"
-    runs-on: ubuntu-latest
-    needs: [compute-matrix]
-    timeout-minutes: 30
-    strategy:
-      fail-fast: false
-      matrix:
-        # deepagents requires Python >= 3.11, use bounded version from compute-matrix
-        python-version: ${{ fromJSON(needs.compute-matrix.outputs.python-version-min-3-11) }}
-        package:
-          - name: deepagents
-            repo: langchain-ai/deepagents
-            path: libs/deepagents
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          path: langchain
-
-      - uses: actions/checkout@v6
-        with:
-          repository: ${{ matrix.package.repo }}
-          path: ${{ matrix.package.name }}
-
-      - name: "🐍 Set up Python ${{ matrix.python-version }} + UV"
-        uses: "./langchain/.github/actions/uv_setup"
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: "📦 Install ${{ matrix.package.name }} with Local"
-        # Unlike partner packages (which use [tool.uv.sources] for local resolution),
-        # external dependents live in separate repos and need explicit overrides to
-        # test against the langchain versions from the current branch, as their
-        # pyproject.toml files point to released versions.
-        run: |
-          cd ${{ matrix.package.name }}/${{ matrix.package.path }}
-
-          # Install the package with test dependencies
-          uv sync --group test
-
-          # Override langchain packages with local versions
-          uv pip install \
-            -e $GITHUB_WORKSPACE/langchain/libs/core \
-            -e $GITHUB_WORKSPACE/langchain/libs/langchain_v1
-
-      # No API keys needed for now - deepagents `make test` only runs unit tests
-      - name: "🚀 Run ${{ matrix.package.name }} Tests"
-        run: |
-          cd ${{ matrix.package.name }}/${{ matrix.package.path }}
-          make test

.github/workflows/pr_labeler.yml

@@ -1,213 +0,0 @@
-# Unified PR labeler — applies size, file-based, title-based, and
-# contributor classification labels in a single sequential workflow.
-#
-# Consolidates pr_labeler_file.yml, pr_labeler_title.yml,
-# pr_size_labeler.yml, and PR-handling from tag-external-contributions.yml
-# into one workflow to eliminate race conditions from concurrent label
-# mutations. tag-external-issues.yml remains active for issue-only
-# labeling. Backfill lives in pr_labeler_backfill.yml.
-#
-# Config and shared logic live in .github/scripts/pr-labeler-config.json
-# and .github/scripts/pr-labeler.js — update those when adding partners.
-#
-# Setup Requirements:
-# 1. Create a GitHub App with permissions:
-#    - Repository: Pull requests (write)
-#    - Repository: Issues (write)
-#    - Organization: Members (read)
-# 2. Install the app on your organization and this repository
-# 3. Add these repository secrets:
-#    - ORG_MEMBERSHIP_APP_ID: Your app's ID
-#    - ORG_MEMBERSHIP_APP_PRIVATE_KEY: Your app's private key
-#
-# The GitHub App token is required to check private organization membership
-# and to propagate label events to downstream workflows.
-
-name: "🏷️ PR Labeler"
-
-on:
-  # Safe since we're not checking out or running the PR's code.
-  # NEVER CHECK OUT UNTRUSTED CODE FROM A PR's HEAD IN A pull_request_target JOB.
-  # Doing so would allow attackers to execute arbitrary code in the context of your repository.
-  pull_request_target:
-    types: [opened, synchronize, reopened, edited]
-
-permissions:
-  contents: read
-
-concurrency:
-  # Separate opened events so external/tier labels are never lost to cancellation
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }}-${{ github.event.action == 'opened' && 'opened' || 'update' }}
-  cancel-in-progress: ${{ github.event.action != 'opened' }}
-
-jobs:
-  label:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-      issues: write
-
-    steps:
-      # Checks out the BASE branch (safe for pull_request_target — never
-      # the PR head). Needed to load .github/scripts/pr-labeler*.
-      - uses: actions/checkout@v6
-
-      - name: Generate GitHub App token
-        if: github.event.action == 'opened'
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.ORG_MEMBERSHIP_APP_ID }}
-          private-key: ${{ secrets.ORG_MEMBERSHIP_APP_PRIVATE_KEY }}
-
-      - name: Verify App token
-        if: github.event.action == 'opened'
-        run: |
-          if [ -z "${{ steps.app-token.outputs.token }}" ]; then
-            echo "::error::GitHub App token generation failed — cannot classify contributor"
-            exit 1
-          fi
-
-      - name: Check org membership
-        if: github.event.action == 'opened'
-        id: check-membership
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const author = context.payload.sender.login;
-            const { isExternal } = await h.checkMembership(
-              author, context.payload.sender.type,
-            );
-            core.setOutput('is-external', isExternal ? 'true' : 'false');
-
-      - name: Apply PR labels
-        uses: actions/github-script@v8
-        env:
-          IS_EXTERNAL: ${{ steps.check-membership.outputs.is-external }}
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { owner, repo } = context.repo;
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const pr = context.payload.pull_request;
-            if (!pr) return;
-            const prNumber = pr.number;
-            const action = context.payload.action;
-
-            const toAdd = new Set();
-            const toRemove = new Set();
-
-            const currentLabels = (await github.paginate(
-              github.rest.issues.listLabelsOnIssue,
-              { owner, repo, issue_number: prNumber, per_page: 100 },
-            )).map(l => l.name ?? '');
-
-            // ── Size + file labels (skip on 'edited' — files unchanged) ──
-            if (action !== 'edited') {
-              for (const sl of h.sizeLabels) await h.ensureLabel(sl);
-
-              const files = await github.paginate(github.rest.pulls.listFiles, {
-                owner, repo, pull_number: prNumber, per_page: 100,
-              });
-
-              const { totalChanged, sizeLabel } = h.computeSize(files);
-              toAdd.add(sizeLabel);
-              for (const sl of h.sizeLabels) {
-                if (currentLabels.includes(sl) && sl !== sizeLabel) toRemove.add(sl);
-              }
-              console.log(`Size: ${totalChanged} changed lines → ${sizeLabel}`);
-
-              for (const label of h.matchFileLabels(files)) {
-                toAdd.add(label);
-              }
-            }
-
-            // ── Title-based labels ──
-            const { labels: titleLabels, typeLabel } = h.matchTitleLabels(pr.title || '');
-            for (const label of titleLabels) toAdd.add(label);
-
-            // Remove stale type labels only when a type was detected
-            if (typeLabel) {
-              for (const tl of h.allTypeLabels) {
-                if (currentLabels.includes(tl) && !titleLabels.has(tl)) toRemove.add(tl);
-              }
-            }
-
-            // ── Internal label (only on open, non-external contributors) ──
-            // IS_EXTERNAL is empty string on non-opened events (step didn't
-            // run), so this guard is only true for opened + internal.
-            if (action === 'opened' && process.env.IS_EXTERNAL === 'false') {
-              toAdd.add('internal');
-            }
-
-            // ── Apply changes ──
-            // Ensure all labels we're about to add exist (addLabels returns
-            // 422 if any label in the batch is missing, which would prevent
-            // ALL labels from being applied).
-            for (const name of toAdd) {
-              await h.ensureLabel(name);
-            }
-
-            for (const name of toRemove) {
-              if (toAdd.has(name)) continue;
-              try {
-                await github.rest.issues.removeLabel({
-                  owner, repo, issue_number: prNumber, name,
-                });
-              } catch (e) {
-                if (e.status !== 404) throw e;
-              }
-            }
-
-            const addList = [...toAdd];
-            if (addList.length > 0) {
-              await github.rest.issues.addLabels({
-                owner, repo, issue_number: prNumber, labels: addList,
-              });
-            }
-
-            const removed = [...toRemove].filter(r => !toAdd.has(r));
-            console.log(`PR #${prNumber}: +[${addList.join(', ')}] -[${removed.join(', ')}]`);
-
-      # Apply tier label BEFORE the external label so that
-      # "trusted-contributor" is already present when the "external" labeled
-      # event fires and triggers require_issue_link.yml.
-      - name: Apply contributor tier label
-        if: github.event.action == 'opened' && steps.check-membership.outputs.is-external == 'true'
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const pr = context.payload.pull_request;
-            await h.applyTierLabel(pr.number, pr.user.login);
-
-      - name: Add external label
-        if: github.event.action == 'opened' && steps.check-membership.outputs.is-external == 'true'
-        uses: actions/github-script@v8
-        with:
-          # Use App token so the "labeled" event propagates to downstream
-          # workflows (e.g. require_issue_link.yml). Events created by the
-          # default GITHUB_TOKEN do not trigger additional workflow runs.
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const prNumber = context.payload.pull_request.number;
-
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            await h.ensureLabel('external');
-            await github.rest.issues.addLabels({
-              owner, repo,
-              issue_number: prNumber,
-              labels: ['external'],
-            });
-            console.log(`Added 'external' label to PR #${prNumber}`);

.github/workflows/pr_labeler_backfill.yml

@@ -1,130 +0,0 @@
-# Backfill PR labels on all open PRs.
-#
-# Manual-only workflow that applies the same labels as pr_labeler.yml
-# (size, file, title, contributor classification) to existing open PRs.
-# Reuses shared logic from .github/scripts/pr-labeler.js.
-
-name: "🏷️ PR Labeler Backfill"
-
-on:
-  workflow_dispatch:
-    inputs:
-      max_items:
-        description: "Maximum number of open PRs to process"
-        default: "100"
-        type: string
-
-permissions:
-  contents: read
-
-jobs:
-  backfill:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-      issues: write
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.ORG_MEMBERSHIP_APP_ID }}
-          private-key: ${{ secrets.ORG_MEMBERSHIP_APP_PRIVATE_KEY }}
-
-      - name: Backfill labels on open PRs
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const rawMax = '${{ inputs.max_items }}';
-            const maxItems = parseInt(rawMax, 10);
-            if (isNaN(maxItems) || maxItems <= 0) {
-              core.setFailed(`Invalid max_items: "${rawMax}" — must be a positive integer`);
-              return;
-            }
-
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            for (const name of [...h.sizeLabels, ...h.tierLabels]) {
-              await h.ensureLabel(name);
-            }
-
-            const contributorCache = new Map();
-            const fileRules = h.buildFileRules();
-
-            const prs = await github.paginate(github.rest.pulls.list, {
-              owner, repo, state: 'open', per_page: 100,
-            });
-
-            let processed = 0;
-            let failures = 0;
-            for (const pr of prs) {
-              if (processed >= maxItems) break;
-              try {
-                const author = pr.user.login;
-                const info = await h.getContributorInfo(contributorCache, author, pr.user.type);
-                const labels = new Set();
-
-                labels.add(info.isExternal ? 'external' : 'internal');
-                if (info.isExternal && info.mergedCount != null && info.mergedCount >= h.trustedThreshold) {
-                  labels.add('trusted-contributor');
-                } else if (info.isExternal && info.mergedCount === 0) {
-                  labels.add('new-contributor');
-                }
-
-                // Size + file labels
-                const files = await github.paginate(github.rest.pulls.listFiles, {
-                  owner, repo, pull_number: pr.number, per_page: 100,
-                });
-                const { sizeLabel } = h.computeSize(files);
-                labels.add(sizeLabel);
-
-                for (const label of h.matchFileLabels(files, fileRules)) {
-                  labels.add(label);
-                }
-
-                // Title labels
-                const { labels: titleLabels } = h.matchTitleLabels(pr.title ?? '');
-                for (const tl of titleLabels) labels.add(tl);
-
-                // Ensure all labels exist before batch add
-                for (const name of labels) {
-                  await h.ensureLabel(name);
-                }
-
-                // Remove stale managed labels
-                const currentLabels = (await github.paginate(
-                  github.rest.issues.listLabelsOnIssue,
-                  { owner, repo, issue_number: pr.number, per_page: 100 },
-                )).map(l => l.name ?? '');
-
-                const managed = [...h.sizeLabels, ...h.tierLabels, ...h.allTypeLabels];
-                for (const name of currentLabels) {
-                  if (managed.includes(name) && !labels.has(name)) {
-                    try {
-                      await github.rest.issues.removeLabel({
-                        owner, repo, issue_number: pr.number, name,
-                      });
-                    } catch (e) {
-                      if (e.status !== 404) throw e;
-                    }
-                  }
-                }
-
-                await github.rest.issues.addLabels({
-                  owner, repo, issue_number: pr.number, labels: [...labels],
-                });
-                console.log(`PR #${pr.number} (${author}): ${[...labels].join(', ')}`);
-                processed++;
-              } catch (e) {
-                failures++;
-                core.warning(`Failed to process PR #${pr.number}: ${e.message}`);
-              }
-            }
-
-            console.log(`\nBackfill complete. Processed ${processed} PRs, ${failures} failures. ${contributorCache.size} unique authors.`);

.github/workflows/pr_labeler_file.yml

@@ -0,0 +1,28 @@
+# Label PRs based on changed files.
+#
+# See `.github/pr-file-labeler.yml` to see rules for each label/directory.
+
+name: "🏷️ Pull Request Labeler"
+
+on:
+  # Safe since we're not checking out or running the PR's code
+  # Never check out the PR's head in a pull_request_target job
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  labeler:
+    name: "label"
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Label Pull Request
+        uses: actions/labeler@v6
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"
+          configuration-path: .github/pr-file-labeler.yml
+          sync-labels: false

.github/workflows/pr_labeler_title.yml

@@ -0,0 +1,44 @@
+# Label PRs based on their titles.
+#
+# Uses conventional commit types from PR titles to apply labels.
+# Note: Scope-based labeling (e.g., integration labels) is handled by pr_labeler_file.yml
+
+name: "🏷️ PR Title Labeler"
+
+on:
+  # Safe since we're not checking out or running the PR's code
+  # Never check out the PR's head in a pull_request_target job
+  pull_request_target:
+    types: [opened, edited]
+
+jobs:
+  pr-title-labeler:
+    name: "label"
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Label PR based on title
+        uses: bcoe/conventional-release-labels@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          type_labels: >-
+            {
+              "feat": "feature",
+              "fix": "fix",
+              "docs": "documentation",
+              "style": "linting",
+              "refactor": "refactor",
+              "perf": "performance",
+              "test": "tests",
+              "build": "infra",
+              "ci": "infra",
+              "chore": "infra",
+              "revert": "revert",
+              "release": "release",
+              "breaking": "breaking"
+            }
+          ignored_types: '[]'

.github/workflows/pr_lint.yml

@@ -8,7 +8,7 @@
 #
 # Examples:
 #     feat(core): add multi‐tenant support
-#     fix(langchain): resolve error
+#     fix(cli): resolve flag parsing error
 #     docs: update API usage examples
 #     docs(openai): update API usage examples
 #
@@ -25,21 +25,14 @@
 #   * chore      — other changes that don't modify source or test files
 #   * revert     — reverts a previous commit
 #   * release    — prepare a new release
-#   * hotfix     — urgent fix
 #
 # Allowed Scope(s) (optional):
-#   core, langchain, langchain-classic, model-profiles,
+#   core, cli, langchain, langchain-classic, model-profiles,
 #   standard-tests, text-splitters, docs, anthropic, chroma, deepseek, exa,
 #   fireworks, groq, huggingface, mistralai, nomic, ollama, openai,
-#   perplexity, qdrant, xai, infra, deps, partners
+#   perplexity, prompty, qdrant, xai, infra, deps
 #
-# Multiple scopes can be used by separating them with a comma. For example:
-#
-#   feat(core,langchain): add multi‐tenant support to core and langchain
-#
-# Note: PRs touching the langchain package should use the 'langchain' scope. It is not
-#   acceptable to omit the scope for changes to the langchain package, despite it being
-#   the main package & name of the repo.
+# Multiple scopes can be used by separating them with a comma.
 #
 # Rules:
 #   1. The 'Type' must start with a lowercase letter.
@@ -66,17 +59,8 @@ jobs:
     name: "validate format"
     runs-on: ubuntu-latest
     steps:
-      - name: "🚫 Reject empty scope"
-        env:
-          PR_TITLE: ${{ github.event.pull_request.title }}
-        run: |
-          if [[ "$PR_TITLE" =~ ^[a-z]+\(\)[!]?: ]]; then
-            echo "::error::PR title has empty scope parentheses: '$PR_TITLE'"
-            echo "Either remove the parentheses or provide a scope (e.g., 'fix(core): ...')."
-            exit 1
-          fi
       - name: "✅ Validate Conventional Commits Format"
-        uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6
+        uses: amannn/action-semantic-pull-request@v6
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -93,9 +77,9 @@ jobs:
             chore
             revert
             release
-            hotfix
           scopes: |
             core
+            cli
             langchain
             langchain-classic
             model-profiles
@@ -113,13 +97,12 @@ jobs:
             nomic
             ollama
             openai
-            openrouter
             perplexity
+            prompty
             qdrant
             xai
             infra
             deps
-            partners
           requireScope: false
           disallowScopes: |
             release

.github/workflows/refresh_model_profiles.yml

@@ -1,45 +0,0 @@
-# Refreshes model profile data for all in-monorepo partner integrations by
-# pulling the latest metadata from models.dev via the `langchain-profiles` CLI.
-#
-# Creates a pull request with any changes. Runs daily and can be triggered
-# manually from the Actions UI. Uses a fixed branch so each run supersedes
-# any stale PR from a previous run.
-
-name: "🔄 Refresh Model Profiles"
-
-on:
-  schedule:
-    - cron: "0 8 * * *" # daily at 08:00 UTC
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  refresh-profiles:
-    uses: ./.github/workflows/_refresh_model_profiles.yml
-    with:
-      providers: >-
-        [
-          {"provider":"anthropic",    "data_dir":"libs/partners/anthropic/langchain_anthropic/data"},
-          {"provider":"deepseek",     "data_dir":"libs/partners/deepseek/langchain_deepseek/data"},
-          {"provider":"fireworks-ai", "data_dir":"libs/partners/fireworks/langchain_fireworks/data"},
-          {"provider":"groq",         "data_dir":"libs/partners/groq/langchain_groq/data"},
-          {"provider":"huggingface",  "data_dir":"libs/partners/huggingface/langchain_huggingface/data"},
-          {"provider":"mistral",      "data_dir":"libs/partners/mistralai/langchain_mistralai/data"},
-          {"provider":"openai",       "data_dir":"libs/partners/openai/langchain_openai/data"},
-          {"provider":"openrouter",   "data_dir":"libs/partners/openrouter/langchain_openrouter/data"},
-          {"provider":"perplexity",   "data_dir":"libs/partners/perplexity/langchain_perplexity/data"},
-          {"provider":"xai",          "data_dir":"libs/partners/xai/langchain_xai/data"}
-        ]
-      cli-path: libs/model-profiles
-      add-paths: libs/partners/**/data/_profiles.py
-      pr-body: |
-        Automated refresh of model profile data for all in-monorepo partner
-        integrations via `langchain-profiles refresh`.
-
-        🤖 Generated by the `refresh_model_profiles` workflow.
-    secrets:
-      MODEL_PROFILE_BOT_APP_ID: ${{ secrets.MODEL_PROFILE_BOT_APP_ID }}
-      MODEL_PROFILE_BOT_PRIVATE_KEY: ${{ secrets.MODEL_PROFILE_BOT_PRIVATE_KEY }}

.github/workflows/reopen_on_assignment.yml

@@ -1,161 +0,0 @@
-# Reopen PRs that were auto-closed by require_issue_link.yml when the
-# contributor was not assigned to the linked issue. When a maintainer
-# assigns the contributor to the issue, this workflow finds matching
-# closed PRs, verifies the issue link, and reopens them.
-#
-# Uses the default GITHUB_TOKEN (not a PAT or app token) so that the
-# reopen and label-removal events do NOT re-trigger other workflows.
-# GitHub suppresses events created by the default GITHUB_TOKEN within
-# workflow runs to prevent infinite loops.
-
-name: Reopen PR on Issue Assignment
-
-on:
-  issues:
-    types: [assigned]
-
-permissions:
-  contents: read
-
-jobs:
-  reopen-linked-prs:
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-
-    steps:
-      - name: Find and reopen matching PRs
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const issueNumber = context.payload.issue.number;
-            const assignee = context.payload.assignee.login;
-
-            console.log(
-              `Issue #${issueNumber} assigned to ${assignee} — searching for closed PRs to reopen`,
-            );
-
-            const q = [
-              `is:pr`,
-              `is:closed`,
-              `author:${assignee}`,
-              `label:missing-issue-link`,
-              `repo:${owner}/${repo}`,
-            ].join(' ');
-
-            let data;
-            try {
-              ({ data } = await github.rest.search.issuesAndPullRequests({
-                q,
-                per_page: 30,
-              }));
-            } catch (e) {
-              throw new Error(
-                `Failed to search for closed PRs to reopen after assigning ${assignee} ` +
-                `to #${issueNumber} (HTTP ${e.status ?? 'unknown'}): ${e.message}`,
-              );
-            }
-
-            if (data.total_count === 0) {
-              console.log('No matching closed PRs found');
-              return;
-            }
-
-            console.log(`Found ${data.total_count} candidate PR(s)`);
-
-            // Must stay in sync with the identical pattern in require_issue_link.yml
-            const pattern = /(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s*#(\d+)/gi;
-
-            for (const item of data.items) {
-              const prNumber = item.number;
-              const body = item.body || '';
-              const matches = [...body.matchAll(pattern)];
-              const referencedIssues = matches.map(m => parseInt(m[1], 10));
-
-              if (!referencedIssues.includes(issueNumber)) {
-                console.log(`PR #${prNumber} does not reference #${issueNumber} — skipping`);
-                continue;
-              }
-
-              // Skip if already bypassed
-              const labels = item.labels.map(l => l.name);
-              if (labels.includes('bypass-issue-check')) {
-                console.log(`PR #${prNumber} already has bypass-issue-check — skipping`);
-                continue;
-              }
-
-              // Reopen first, remove label second — a closed PR that still has
-              // missing-issue-link is recoverable; a closed PR with the label
-              // stripped is invisible to both workflows.
-              try {
-                await github.rest.pulls.update({
-                  owner,
-                  repo,
-                  pull_number: prNumber,
-                  state: 'open',
-                });
-                console.log(`Reopened PR #${prNumber}`);
-              } catch (e) {
-                if (e.status === 422) {
-                  // Head branch deleted — PR is unrecoverable. Notify the
-                  // contributor so they know to open a new PR.
-                  core.warning(`Cannot reopen PR #${prNumber}: head branch was likely deleted`);
-                  try {
-                    await github.rest.issues.createComment({
-                      owner,
-                      repo,
-                      issue_number: prNumber,
-                      body:
-                        `You have been assigned to #${issueNumber}, but this PR could not be ` +
-                        `reopened because the head branch has been deleted. Please open a new ` +
-                        `PR referencing the issue.`,
-                    });
-                  } catch (commentErr) {
-                    core.warning(
-                      `Also failed to post comment on PR #${prNumber}: ${commentErr.message}`,
-                    );
-                  }
-                  continue;
-                }
-                // Transient errors (rate limit, 5xx) should fail the job so
-                // the label is NOT removed and the run can be retried.
-                throw e;
-              }
-
-              // Remove missing-issue-link label only after successful reopen
-              try {
-                await github.rest.issues.removeLabel({
-                  owner,
-                  repo,
-                  issue_number: prNumber,
-                  name: 'missing-issue-link',
-                });
-                console.log(`Removed missing-issue-link from PR #${prNumber}`);
-              } catch (e) {
-                if (e.status !== 404) throw e;
-              }
-
-              // Minimize stale enforcement comment (best-effort;
-              // sync w/ require_issue_link.yml minimize blocks)
-              try {
-                const marker = '<!-- require-issue-link -->';
-                const comments = await github.paginate(
-                  github.rest.issues.listComments,
-                  { owner, repo, issue_number: prNumber, per_page: 100 },
-                );
-                const stale = comments.find(c => c.body && c.body.includes(marker));
-                if (stale) {
-                  await github.graphql(`
-                    mutation($id: ID!) {
-                      minimizeComment(input: {subjectId: $id, classifier: OUTDATED}) {
-                        minimizedComment { isMinimized }
-                      }
-                    }
-                  `, { id: stale.node_id });
-                  console.log(`Minimized stale enforcement comment ${stale.id} as outdated`);
-                }
-              } catch (e) {
-                core.warning(`Could not minimize stale comment on PR #${prNumber}: ${e.message}`);
-              }
-            }

.github/workflows/require_issue_link.yml

@@ -1,467 +0,0 @@
-# Require external PRs to reference an approved issue (e.g. Fixes #NNN) and
-# the PR author to be assigned to that issue. On failure the PR is
-# labeled "missing-issue-link", commented on, and closed.
-#
-# Maintainer override: an org member can reopen the PR or remove
-# "missing-issue-link" — both add "bypass-issue-check" and reopen.
-#
-# Dependency: pr_labeler.yml must apply the "external" label first. This
-# workflow does NOT trigger on "opened" (new PRs have no labels yet, so the
-# gate would always skip).
-
-name: Require Issue Link
-
-on:
-  pull_request_target:
-    # NEVER CHECK OUT UNTRUSTED CODE FROM A PR's HEAD IN A pull_request_target JOB.
-    # Doing so would allow attackers to execute arbitrary code in the context of your repository.
-    types: [edited, reopened, labeled, unlabeled]
-
-# ──────────────────────────────────────────────────────────────────────────────
-# Enforcement gate: set to 'true' to activate the issue link requirement.
-# When 'false', the workflow still runs the check logic (useful for dry-run
-# visibility) but will NOT label, comment, close, or fail PRs.
-# ──────────────────────────────────────────────────────────────────────────────
-env:
-  ENFORCE_ISSUE_LINK: "true"
-
-permissions:
-  contents: read
-
-jobs:
-  check-issue-link:
-    # Run when the "external" label is added, on edit/reopen if already labeled,
-    # or when "missing-issue-link" is removed (triggers maintainer override check).
-    # Skip entirely when the PR already carries "trusted-contributor" or
-    # "bypass-issue-check".
-    if: >-
-      !contains(github.event.pull_request.labels.*.name, 'trusted-contributor') &&
-      !contains(github.event.pull_request.labels.*.name, 'bypass-issue-check') &&
-      (
-        (github.event.action == 'labeled' && github.event.label.name == 'external') ||
-        (github.event.action == 'unlabeled' && github.event.label.name == 'missing-issue-link' && contains(github.event.pull_request.labels.*.name, 'external')) ||
-        (github.event.action != 'labeled' && github.event.action != 'unlabeled' && contains(github.event.pull_request.labels.*.name, 'external'))
-      )
-    runs-on: ubuntu-latest
-    permissions:
-      actions: write
-      pull-requests: write
-
-    steps:
-      - name: Check for issue link and assignee
-        id: check-link
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const prNumber = context.payload.pull_request.number;
-            const action = context.payload.action;
-
-            // ── Helper: ensure a label exists, then add it to the PR ────────
-            async function ensureAndAddLabel(labelName, color) {
-              try {
-                await github.rest.issues.getLabel({ owner, repo, name: labelName });
-              } catch (e) {
-                if (e.status !== 404) throw e;
-                try {
-                  await github.rest.issues.createLabel({ owner, repo, name: labelName, color });
-                } catch (createErr) {
-                  // 422 = label was created by a concurrent run between our
-                  // GET and POST — safe to ignore.
-                  if (createErr.status !== 422) throw createErr;
-                }
-              }
-              await github.rest.issues.addLabels({
-                owner, repo, issue_number: prNumber, labels: [labelName],
-              });
-            }
-
-            // ── Helper: check if the user who triggered this event (reopened
-            // the PR / removed the label) has write+ access on the repo ───
-            // Uses the repo collaborator permission endpoint instead of the
-            // org membership endpoint. The org endpoint requires the caller
-            // to be an org member, which GITHUB_TOKEN (an app installation
-            // token) never is — so it always returns 403.
-            async function senderIsOrgMember() {
-              const sender = context.payload.sender?.login;
-              if (!sender) {
-                throw new Error('Event has no sender — cannot check permissions');
-              }
-              try {
-                const { data } = await github.rest.repos.getCollaboratorPermissionLevel({
-                  owner, repo, username: sender,
-                });
-                const perm = data.permission;
-                if (['admin', 'maintain', 'write'].includes(perm)) {
-                  console.log(`${sender} has ${perm} permission — treating as maintainer`);
-                  return { isMember: true, login: sender };
-                }
-                console.log(`${sender} has ${perm} permission — not a maintainer`);
-                return { isMember: false, login: sender };
-              } catch (e) {
-                if (e.status === 404) {
-                  console.log(`Cannot check permissions for ${sender} — treating as non-maintainer`);
-                  return { isMember: false, login: sender };
-                }
-                const status = e.status ?? 'unknown';
-                throw new Error(
-                  `Permission check failed for ${sender} (HTTP ${status}): ${e.message}`,
-                );
-              }
-            }
-
-            // ── Helper: apply maintainer bypass (shared by both override paths) ──
-            async function applyMaintainerBypass(reason) {
-              console.log(reason);
-
-              // Remove missing-issue-link if present
-              try {
-                await github.rest.issues.removeLabel({
-                  owner, repo, issue_number: prNumber, name: 'missing-issue-link',
-                });
-              } catch (e) {
-                if (e.status !== 404) throw e;
-              }
-
-              // Reopen before adding bypass label — a failed reopen is more
-              // actionable than a closed PR with a bypass label stuck on it.
-              if (context.payload.pull_request.state === 'closed') {
-                try {
-                  await github.rest.pulls.update({
-                    owner, repo, pull_number: prNumber, state: 'open',
-                  });
-                  console.log(`Reopened PR #${prNumber}`);
-                } catch (e) {
-                  // 422 if head branch deleted; 403 if permissions insufficient.
-                  // Bypass labels still apply — maintainer can reopen manually.
-                  core.warning(
-                    `Could not reopen PR #${prNumber} (HTTP ${e.status ?? 'unknown'}): ${e.message}. ` +
-                    `Bypass labels were applied — a maintainer may need to reopen manually.`,
-                  );
-                }
-              }
-
-              // Add bypass-issue-check so future triggers skip enforcement
-              await ensureAndAddLabel('bypass-issue-check', '0e8a16');
-
-              // Minimize stale enforcement comment (best-effort; must not
-              // abort bypass — sync w/ reopen_on_assignment.yml & step below)
-              try {
-                const marker = '<!-- require-issue-link -->';
-                const comments = await github.paginate(
-                  github.rest.issues.listComments,
-                  { owner, repo, issue_number: prNumber, per_page: 100 },
-                );
-                const stale = comments.find(c => c.body && c.body.includes(marker));
-                if (stale) {
-                  await github.graphql(`
-                    mutation($id: ID!) {
-                      minimizeComment(input: {subjectId: $id, classifier: OUTDATED}) {
-                        minimizedComment { isMinimized }
-                      }
-                    }
-                  `, { id: stale.node_id });
-                  console.log(`Minimized stale enforcement comment ${stale.id} as outdated`);
-                }
-              } catch (e) {
-                core.warning(`Could not minimize stale comment on PR #${prNumber}: ${e.message}`);
-              }
-
-              core.setOutput('has-link', 'true');
-              core.setOutput('is-assigned', 'true');
-            }
-
-            // ── Maintainer override: removed "missing-issue-link" label ─────
-            if (action === 'unlabeled') {
-              const { isMember, login } = await senderIsOrgMember();
-              if (isMember) {
-                await applyMaintainerBypass(
-                  `Maintainer ${login} removed missing-issue-link from PR #${prNumber} — bypassing enforcement`,
-                );
-                return;
-              }
-              // Non-member removed the label — re-add it defensively and
-              // set failure outputs so downstream steps (comment, close) fire.
-              // NOTE: addLabels fires a "labeled" event, but the job-level gate
-              // only matches labeled events for "external", so no re-trigger.
-              console.log(`Non-member ${login} removed missing-issue-link — re-adding`);
-              try {
-                await ensureAndAddLabel('missing-issue-link', 'b76e79');
-              } catch (e) {
-                core.warning(
-                  `Failed to re-add missing-issue-link (HTTP ${e.status ?? 'unknown'}): ${e.message}. ` +
-                  `Downstream step will retry.`,
-                );
-              }
-              core.setOutput('has-link', 'false');
-              core.setOutput('is-assigned', 'false');
-              return;
-            }
-
-            // ── Maintainer override: reopened PR with "missing-issue-link" ──
-            const prLabels = context.payload.pull_request.labels.map(l => l.name);
-            if (action === 'reopened' && prLabels.includes('missing-issue-link')) {
-              const { isMember, login } = await senderIsOrgMember();
-              if (isMember) {
-                await applyMaintainerBypass(
-                  `Maintainer ${login} reopened PR #${prNumber} — bypassing enforcement`,
-                );
-                return;
-              }
-              console.log(`Non-member ${login} reopened PR — proceeding with check`);
-            }
-
-            // ── Fetch live labels (race guard) ──────────────────────────────
-            const { data: liveLabels } = await github.rest.issues.listLabelsOnIssue({
-              owner, repo, issue_number: prNumber,
-            });
-            const liveNames = liveLabels.map(l => l.name);
-            if (liveNames.includes('trusted-contributor') || liveNames.includes('bypass-issue-check')) {
-              console.log('PR has trusted-contributor or bypass-issue-check label — bypassing');
-              core.setOutput('has-link', 'true');
-              core.setOutput('is-assigned', 'true');
-              return;
-            }
-
-            const body = context.payload.pull_request.body || '';
-            const pattern = /(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s*#(\d+)/gi;
-            const matches = [...body.matchAll(pattern)];
-
-            if (matches.length === 0) {
-              console.log('No issue link found in PR body');
-              core.setOutput('has-link', 'false');
-              core.setOutput('is-assigned', 'false');
-              return;
-            }
-
-            const issues = matches.map(m => `#${m[1]}`).join(', ');
-            console.log(`Found issue link(s): ${issues}`);
-            core.setOutput('has-link', 'true');
-
-            // Check whether the PR author is assigned to at least one linked issue
-            const prAuthor = context.payload.pull_request.user.login;
-            const MAX_ISSUES = 5;
-            const allIssueNumbers = [...new Set(matches.map(m => parseInt(m[1], 10)))];
-            const issueNumbers = allIssueNumbers.slice(0, MAX_ISSUES);
-            if (allIssueNumbers.length > MAX_ISSUES) {
-              core.warning(
-                `PR references ${allIssueNumbers.length} issues — only checking the first ${MAX_ISSUES}`,
-              );
-            }
-
-            let assignedToAny = false;
-            for (const num of issueNumbers) {
-              try {
-                const { data: issue } = await github.rest.issues.get({
-                  owner, repo, issue_number: num,
-                });
-                const assignees = issue.assignees.map(a => a.login.toLowerCase());
-                if (assignees.includes(prAuthor.toLowerCase())) {
-                  console.log(`PR author "${prAuthor}" is assigned to #${num}`);
-                  assignedToAny = true;
-                  break;
-                } else {
-                  console.log(`PR author "${prAuthor}" is NOT assigned to #${num} (assignees: ${assignees.join(', ') || 'none'})`);
-                }
-              } catch (error) {
-                if (error.status === 404) {
-                  console.log(`Issue #${num} not found — skipping`);
-                } else {
-                  // Non-404 errors (rate limit, server error) must not be
-                  // silently skipped — they could cause false enforcement
-                  // (closing a legitimate PR whose assignment can't be verified).
-                  throw new Error(
-                    `Cannot verify assignee for issue #${num} (${error.status}): ${error.message}`,
-                  );
-                }
-              }
-            }
-
-            core.setOutput('is-assigned', assignedToAny ? 'true' : 'false');
-
-      - name: Add missing-issue-link label
-        if: >-
-          env.ENFORCE_ISSUE_LINK == 'true' &&
-          (steps.check-link.outputs.has-link != 'true' || steps.check-link.outputs.is-assigned != 'true')
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const prNumber = context.payload.pull_request.number;
-            const labelName = 'missing-issue-link';
-
-            // Ensure the label exists (no checkout/shared helper available)
-            try {
-              await github.rest.issues.getLabel({ owner, repo, name: labelName });
-            } catch (e) {
-              if (e.status !== 404) throw e;
-              try {
-                await github.rest.issues.createLabel({
-                  owner, repo, name: labelName, color: 'b76e79',
-                });
-              } catch (createErr) {
-                if (createErr.status !== 422) throw createErr;
-              }
-            }
-
-            await github.rest.issues.addLabels({
-              owner, repo, issue_number: prNumber, labels: [labelName],
-            });
-
-      - name: Remove missing-issue-link label and reopen PR
-        if: >-
-          env.ENFORCE_ISSUE_LINK == 'true' &&
-          steps.check-link.outputs.has-link == 'true' && steps.check-link.outputs.is-assigned == 'true'
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const prNumber = context.payload.pull_request.number;
-            try {
-              await github.rest.issues.removeLabel({
-                owner, repo, issue_number: prNumber, name: 'missing-issue-link',
-              });
-            } catch (error) {
-              if (error.status !== 404) throw error;
-            }
-
-            // Reopen if this workflow previously closed the PR. We check the
-            // event payload labels (not live labels) because we already removed
-            // missing-issue-link above; the payload still reflects pre-step state.
-            const labels = context.payload.pull_request.labels.map(l => l.name);
-            if (context.payload.pull_request.state === 'closed' && labels.includes('missing-issue-link')) {
-              await github.rest.pulls.update({
-                owner,
-                repo,
-                pull_number: prNumber,
-                state: 'open',
-              });
-              console.log(`Reopened PR #${prNumber}`);
-            }
-
-            // Minimize stale enforcement comment (best-effort;
-            // sync w/ applyMaintainerBypass above & reopen_on_assignment.yml)
-            try {
-              const marker = '<!-- require-issue-link -->';
-              const comments = await github.paginate(
-                github.rest.issues.listComments,
-                { owner, repo, issue_number: prNumber, per_page: 100 },
-              );
-              const stale = comments.find(c => c.body && c.body.includes(marker));
-              if (stale) {
-                await github.graphql(`
-                  mutation($id: ID!) {
-                    minimizeComment(input: {subjectId: $id, classifier: OUTDATED}) {
-                      minimizedComment { isMinimized }
-                    }
-                  }
-                `, { id: stale.node_id });
-                console.log(`Minimized stale enforcement comment ${stale.id} as outdated`);
-              }
-            } catch (e) {
-              core.warning(`Could not minimize stale comment on PR #${prNumber}: ${e.message}`);
-            }
-
-      - name: Post comment, close PR, and fail
-        if: >-
-          env.ENFORCE_ISSUE_LINK == 'true' &&
-          (steps.check-link.outputs.has-link != 'true' || steps.check-link.outputs.is-assigned != 'true')
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const prNumber = context.payload.pull_request.number;
-            const hasLink = '${{ steps.check-link.outputs.has-link }}' === 'true';
-            const isAssigned = '${{ steps.check-link.outputs.is-assigned }}' === 'true';
-            const marker = '<!-- require-issue-link -->';
-
-            let lines;
-            if (!hasLink) {
-              lines = [
-                marker,
-                '**This PR has been automatically closed** because it does not link to an approved issue.',
-                '',
-                'All external contributions must reference an approved issue or discussion. Please:',
-                '1. Find or [open an issue](https://github.com/' + owner + '/' + repo + '/issues/new/choose) describing the change',
-                '2. Wait for a maintainer to approve and assign you',
-                '3. Add `Fixes #<issue_number>`, `Closes #<issue_number>`, or `Resolves #<issue_number>` to your PR description and the PR will be reopened automatically',
-                '',
-                '*Maintainers: reopen this PR or remove the `missing-issue-link` label to bypass this check.*',
-              ];
-            } else {
-              lines = [
-                marker,
-                '**This PR has been automatically closed** because you are not assigned to the linked issue.',
-                '',
-                'External contributors must be assigned to an issue before opening a PR for it. Please:',
-                '1. Comment on the linked issue to request assignment from a maintainer',
-                '2. Once assigned, your PR will be reopened automatically',
-                '',
-                '*Maintainers: reopen this PR or remove the `missing-issue-link` label to bypass this check.*',
-              ];
-            }
-
-            const body = lines.join('\n');
-
-            // Deduplicate: check for existing comment with the marker
-            const comments = await github.paginate(
-              github.rest.issues.listComments,
-              { owner, repo, issue_number: prNumber, per_page: 100 },
-            );
-            const existing = comments.find(c => c.body && c.body.includes(marker));
-
-            if (!existing) {
-              await github.rest.issues.createComment({
-                owner,
-                repo,
-                issue_number: prNumber,
-                body,
-              });
-              console.log('Posted requirement comment');
-            } else if (existing.body !== body) {
-              await github.rest.issues.updateComment({
-                owner,
-                repo,
-                comment_id: existing.id,
-                body,
-              });
-              console.log('Updated existing comment with new message');
-            } else {
-              console.log('Comment already exists — skipping');
-            }
-
-            // Close the PR
-            if (context.payload.pull_request.state === 'open') {
-              await github.rest.pulls.update({
-                owner,
-                repo,
-                pull_number: prNumber,
-                state: 'closed',
-              });
-              console.log(`Closed PR #${prNumber}`);
-            }
-
-            // Cancel all other in-progress and queued workflow runs for this PR
-            const headSha = context.payload.pull_request.head.sha;
-            for (const status of ['in_progress', 'queued']) {
-              const runs = await github.paginate(
-                github.rest.actions.listWorkflowRunsForRepo,
-                { owner, repo, head_sha: headSha, status, per_page: 100 },
-              );
-              for (const run of runs) {
-                if (run.id === context.runId) continue;
-                try {
-                  await github.rest.actions.cancelWorkflowRun({
-                    owner, repo, run_id: run.id,
-                  });
-                  console.log(`Cancelled ${status} run ${run.id} (${run.name})`);
-                } catch (err) {
-                  console.log(`Could not cancel run ${run.id}: ${err.message}`);
-                }
-              }
-            }
-
-            const reason = !hasLink
-              ? 'PR must reference an issue using auto-close keywords (e.g., "Fixes #123").'
-              : 'PR author must be assigned to the linked issue.';
-            core.setFailed(reason);

.github/workflows/tag-external-issues.yml

@@ -1,205 +0,0 @@
-# Automatically tag issues as "external" or "internal" based on whether
-# the author is a member of the langchain-ai GitHub organization, and
-# apply contributor tier labels to external contributors based on their
-# merged PR history.
-#
-# NOTE: PR labeling (including external/internal, tier, size, file, and
-# title labels) is handled by pr_labeler.yml. This workflow handles
-# issues only.
-#
-# Config (trustedThreshold, labelColor) is read from
-# .github/scripts/pr-labeler-config.json to stay in sync with
-# pr_labeler.yml.
-#
-# Setup Requirements:
-# 1. Create a GitHub App with permissions:
-#    - Repository: Issues (write)
-#    - Organization: Members (read)
-# 2. Install the app on your organization and this repository
-# 3. Add these repository secrets:
-#    - ORG_MEMBERSHIP_APP_ID: Your app's ID
-#    - ORG_MEMBERSHIP_APP_PRIVATE_KEY: Your app's private key
-#
-# The GitHub App token is required to check private organization membership.
-# Without it, the workflow will fail.
-
-name: Tag External Issues
-
-on:
-  issues:
-    types: [opened]
-  workflow_dispatch:
-    inputs:
-      max_items:
-        description: "Maximum number of open issues to process"
-        default: "100"
-        type: string
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.issue.number || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  tag-external:
-    if: github.event_name != 'workflow_dispatch'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      issues: write
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.ORG_MEMBERSHIP_APP_ID }}
-          private-key: ${{ secrets.ORG_MEMBERSHIP_APP_PRIVATE_KEY }}
-
-      - name: Check if contributor is external
-        if: steps.app-token.outcome == 'success'
-        id: check-membership
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const author = context.payload.sender.login;
-            const { isExternal } = await h.checkMembership(
-              author, context.payload.sender.type,
-            );
-            core.setOutput('is-external', isExternal ? 'true' : 'false');
-
-      - name: Apply contributor tier label
-        if: steps.check-membership.outputs.is-external == 'true'
-        uses: actions/github-script@v8
-        with:
-          # GITHUB_TOKEN is fine here — no downstream workflow chains
-          # off tier labels on issues (unlike PRs where App token is
-          # needed for require_issue_link.yml).
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { owner, repo } = context.repo;
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const issue = context.payload.issue;
-            // new-contributor is only meaningful on PRs, not issues
-            await h.applyTierLabel(issue.number, issue.user.login, { skipNewContributor: true });
-
-      - name: Add external/internal label
-        if: steps.check-membership.outputs.is-external != ''
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { owner, repo } = context.repo;
-            const issue_number = context.payload.issue.number;
-
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const label = '${{ steps.check-membership.outputs.is-external }}' === 'true'
-              ? 'external' : 'internal';
-            await h.ensureLabel(label);
-            await github.rest.issues.addLabels({
-              owner, repo, issue_number, labels: [label],
-            });
-            console.log(`Added '${label}' label to issue #${issue_number}`);
-
-  backfill:
-    if: github.event_name == 'workflow_dispatch'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      issues: write
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v3
-        with:
-          app-id: ${{ secrets.ORG_MEMBERSHIP_APP_ID }}
-          private-key: ${{ secrets.ORG_MEMBERSHIP_APP_PRIVATE_KEY }}
-
-      - name: Backfill labels on open issues
-        uses: actions/github-script@v8
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const { owner, repo } = context.repo;
-            const rawMax = '${{ inputs.max_items }}';
-            const maxItems = parseInt(rawMax, 10);
-            if (isNaN(maxItems) || maxItems <= 0) {
-              core.setFailed(`Invalid max_items: "${rawMax}" — must be a positive integer`);
-              return;
-            }
-
-            const { h } = require('./.github/scripts/pr-labeler.js').loadAndInit(github, owner, repo, core);
-
-            const tierLabels = ['trusted-contributor'];
-            for (const name of tierLabels) {
-              await h.ensureLabel(name);
-            }
-
-            const contributorCache = new Map();
-
-            const issues = await github.paginate(github.rest.issues.listForRepo, {
-              owner, repo, state: 'open', per_page: 100,
-            });
-
-            let processed = 0;
-            let failures = 0;
-            for (const issue of issues) {
-              if (processed >= maxItems) break;
-              if (issue.pull_request) continue;
-
-              try {
-                const author = issue.user.login;
-                const info = await h.getContributorInfo(contributorCache, author, issue.user.type);
-
-                const labels = [info.isExternal ? 'external' : 'internal'];
-                if (info.isExternal && info.mergedCount != null && info.mergedCount >= h.trustedThreshold) {
-                  labels.push('trusted-contributor');
-                }
-
-                // Ensure all labels exist before batch add
-                for (const name of labels) {
-                  await h.ensureLabel(name);
-                }
-
-                // Remove stale tier labels
-                const currentLabels = (await github.paginate(
-                  github.rest.issues.listLabelsOnIssue,
-                  { owner, repo, issue_number: issue.number, per_page: 100 },
-                )).map(l => l.name ?? '');
-                for (const name of currentLabels) {
-                  if (tierLabels.includes(name) && !labels.includes(name)) {
-                    try {
-                      await github.rest.issues.removeLabel({
-                        owner, repo, issue_number: issue.number, name,
-                      });
-                    } catch (e) {
-                      if (e.status !== 404) throw e;
-                    }
-                  }
-                }
-
-                await github.rest.issues.addLabels({
-                  owner, repo, issue_number: issue.number, labels,
-                });
-                console.log(`Issue #${issue.number} (${author}): ${labels.join(', ')}`);
-                processed++;
-              } catch (e) {
-                failures++;
-                core.warning(`Failed to process issue #${issue.number}: ${e.message}`);
-              }
-            }
-
-            console.log(`\nBackfill complete. Processed ${processed} issues, ${failures} failures. ${contributorCache.size} unique authors.`);

.github/workflows/v03_api_doc_build.yml

@@ -13,9 +13,6 @@ run-name: "Build & Deploy API Reference (v0.3)"
 on:
   workflow_dispatch:
 
-permissions:
-  contents: read
-
 env:
   PYTHON_VERSION: "3.11"
 
@@ -39,7 +36,7 @@ jobs:
 
       - name: "📋 Extract Repository List with yq"
         id: get-unsorted-repos
-        uses: mikefarah/yq@88a31ae8c6b34aad77d2efdecc146113cb3315d0 # master
+        uses: mikefarah/yq@master
         with:
           cmd: |
             # Extract repos from packages.yml that are in the langchain-ai org
@@ -161,7 +158,7 @@ jobs:
           rm -rf ../langchain-api-docs-html/_build/
 
       # Commit and push changes to langchain-api-docs-html repo
-      - uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 # v9
+      - uses: EndBug/add-and-commit@v9
         with:
           cwd: langchain-api-docs-html
           message: "Update API docs build from v0.3 branch"

.mcp.json

@@ -3,10 +3,6 @@
     "docs-langchain": {
       "type": "http",
       "url": "https://docs.langchain.com/mcp"
-    },
-    "reference-langchain": {
-      "type": "http",
-      "url": "https://reference.langchain.com/mcp"
     }
   }
-}
+}

.pre-commit-config.yaml

@@ -105,21 +105,15 @@ repos:
         entry: make -C libs/partners/openai format lint
         files: ^libs/partners/openai/
         pass_filenames: false
+      - id: prompty
+        name: format and lint partners/prompty
+        language: system
+        entry: make -C libs/partners/prompty format lint
+        files: ^libs/partners/prompty/
+        pass_filenames: false
       - id: qdrant
         name: format and lint partners/qdrant
         language: system
         entry: make -C libs/partners/qdrant format lint
         files: ^libs/partners/qdrant/
         pass_filenames: false
-      - id: core-version
-        name: check core version consistency
-        language: system
-        entry: make -C libs/core check_version
-        files: ^libs/core/(pyproject\.toml|langchain_core/version\.py)$
-        pass_filenames: false
-      - id: langchain-v1-version
-        name: check langchain version consistency
-        language: system
-        entry: make -C libs/langchain_v1 check_version
-        files: ^libs/langchain_v1/(pyproject\.toml|langchain/__init__\.py)$
-        pass_filenames: false

AGENTS.md

@@ -22,6 +22,7 @@ langchain/
 │   ├── text-splitters/   # Document chunking utilities
 │   ├── standard-tests/   # Shared test suite for integrations
 │   ├── model-profiles/   # Model configuration profiles
+│   └── cli/              # Command-line interface tools
 ├── .github/              # CI/CD workflows and templates
 ├── .vscode/              # VSCode IDE standard settings and recommended extensions
 └── README.md             # Information about LangChain
@@ -32,7 +33,7 @@ langchain/
 - **Integration layer** (`partners/`): Third-party service integrations. Note that this monorepo is not exhaustive of all LangChain integrations; some are maintained in separate repos, such as `langchain-ai/langchain-google` and `langchain-ai/langchain-aws`. Usually these repos are cloned at the same level as this monorepo, so if needed, you can refer to their code directly by navigating to `../langchain-google/` from this monorepo.
 - **Testing layer** (`standard-tests/`): Standardized integration tests for partner integrations
 
-### Development tools & commands
+### Development tools & commands**
 
 - `uv` – Fast Python package installer and resolver (replaces pip/poetry)
 - `make` – Task runner for common development commands. Feel free to look at the `Makefile` for available commands and usage patterns.
@@ -44,16 +45,6 @@ This monorepo uses `uv` for dependency management. Local development uses editab
 
 Each package in `libs/` has its own `pyproject.toml` and `uv.lock`.
 
-Before running your tests, set up all packages by running:
-
-```bash
-# For all groups
-uv sync --all-groups
-
-# or, to install a specific group only:
-uv sync --group test
-```
-
 ```bash
 # Run unit tests (no network)
 make test
@@ -81,15 +72,7 @@ uv run --group lint mypy .
 
 #### Commit standards
 
-Suggest PR titles that follow Conventional Commits format. Refer to .github/workflows/pr_lint for allowed types and scopes. Note that all commit/PR titles should be in lowercase with the exception of proper nouns/named entities. All PR titles should include a scope with no exceptions. For example:
-
-```txt
-feat(langchain): add new chat completion feature
-fix(core): resolve type hinting issue in vector store
-chore(anthropic): update infrastructure dependencies
-```
-
-Note how `feat(langchain)` includes a scope even though it is the main package and name of the repo.
+Suggest PR titles that follow Conventional Commits format. Refer to .github/workflows/pr_lint for allowed types and scopes.
 
 #### Pull request guidelines
 
@@ -102,7 +85,6 @@ Note how `feat(langchain)` includes a scope even though it is the main package a
 ### Maintain stable public interfaces
 
 CRITICAL: Always attempt to preserve function signatures, argument positions, and names for exported/public methods. Do not make breaking changes.
-You should warn the developer for any function signature changes, regardless of whether they look breaking or not.
 
 **Before making ANY changes to public APIs:**
 
@@ -128,7 +110,7 @@ def filter_unknown_users(users: list[str], known_users: set[str]) -> list[str]:
         known_users: Set of known/valid user identifiers.
 
     Returns:
-        List of users that are not in the `known_users` set.
+        List of users that are not in the known_users set.
     """
 ```
 
@@ -192,62 +174,8 @@ def send_email(to: str, msg: str, *, priority: str = "normal") -> bool:
 - Document all parameters, return values, and exceptions
 - Keep descriptions concise but clear
 - Ensure American English spelling (e.g., "behavior", not "behaviour")
-- Do NOT use Sphinx-style double backtick formatting (` ``code`` `). Use single backticks (`` `code` ``) for inline code references in docstrings and comments.
-
-## Model profiles
-
-Model profiles are generated using the `langchain-profiles` CLI in `libs/model-profiles`. The `--data-dir` must point to the directory containing `profile_augmentations.toml`, not the top-level package directory.
-
-```bash
-# Run from libs/model-profiles
-cd libs/model-profiles
-
-# Refresh profiles for a partner in this repo
-uv run langchain-profiles refresh --provider openai --data-dir ../partners/openai/langchain_openai/data
-
-# Refresh profiles for a partner in an external repo (requires echo y to confirm)
-echo y | uv run langchain-profiles refresh --provider google --data-dir /path/to/langchain-google/libs/genai/langchain_google_genai/data
-```
-
-Example partners with profiles in this repo:
-
-- `libs/partners/openai/langchain_openai/data/` (provider: `openai`)
-- `libs/partners/anthropic/langchain_anthropic/data/` (provider: `anthropic`)
-- `libs/partners/perplexity/langchain_perplexity/data/` (provider: `perplexity`)
-
-The `echo y |` pipe is required when `--data-dir` is outside the `libs/model-profiles` working directory.
-
-## CI/CD infrastructure
-
-### Release process
-
-Releases are triggered manually via `.github/workflows/_release.yml` with `working-directory` and `release-version` inputs.
-
-### PR labeling and linting
-
-**Title linting** (`.github/workflows/pr_lint.yml`)
-
-**Auto-labeling:**
-
-- `.github/workflows/pr_labeler.yml` – Unified PR labeler (size, file, title, external/internal, contributor tier)
-- `.github/workflows/pr_labeler_backfill.yml` – Manual backfill of PR labels on open PRs
-- `.github/workflows/auto-label-by-package.yml` – Issue labeling by package
-- `.github/workflows/tag-external-issues.yml` – Issue external/internal classification
-
-### Adding a new partner to CI
-
-When adding a new partner package, update these files:
-
-- `.github/ISSUE_TEMPLATE/*.yml` – Add to package dropdown
-- `.github/dependabot.yml` – Add dependency update entry
-- `.github/scripts/pr-labeler-config.json` – Add file rule and scope-to-label mapping
-- `.github/workflows/_release.yml` – Add API key secrets if needed
-- `.github/workflows/auto-label-by-package.yml` – Add package label
-- `.github/workflows/check_diffs.yml` – Add to change detection
-- `.github/workflows/integration_tests.yml` – Add integration test config
-- `.github/workflows/pr_lint.yml` – Add to allowed scopes
 
 ## Additional resources
 
 - **Documentation:** https://docs.langchain.com/oss/python/langchain/overview and source at https://github.com/langchain-ai/docs or `../docs/`. Prefer the local install and use file search tools for best results. If needed, use the docs MCP server as defined in `.mcp.json` for programmatic access.
-- **Contributing Guide:** [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview)
+- **Contributing Guide:** [`.github/CONTRIBUTING.md`](https://docs.langchain.com/oss/python/contributing/overview)

CLAUDE.md

@@ -22,6 +22,7 @@ langchain/
 │   ├── text-splitters/   # Document chunking utilities
 │   ├── standard-tests/   # Shared test suite for integrations
 │   ├── model-profiles/   # Model configuration profiles
+│   └── cli/              # Command-line interface tools
 ├── .github/              # CI/CD workflows and templates
 ├── .vscode/              # VSCode IDE standard settings and recommended extensions
 └── README.md             # Information about LangChain
@@ -32,7 +33,7 @@ langchain/
 - **Integration layer** (`partners/`): Third-party service integrations. Note that this monorepo is not exhaustive of all LangChain integrations; some are maintained in separate repos, such as `langchain-ai/langchain-google` and `langchain-ai/langchain-aws`. Usually these repos are cloned at the same level as this monorepo, so if needed, you can refer to their code directly by navigating to `../langchain-google/` from this monorepo.
 - **Testing layer** (`standard-tests/`): Standardized integration tests for partner integrations
 
-### Development tools & commands
+### Development tools & commands**
 
 - `uv` – Fast Python package installer and resolver (replaces pip/poetry)
 - `make` – Task runner for common development commands. Feel free to look at the `Makefile` for available commands and usage patterns.
@@ -44,16 +45,6 @@ This monorepo uses `uv` for dependency management. Local development uses editab
 
 Each package in `libs/` has its own `pyproject.toml` and `uv.lock`.
 
-Before running your tests, set up all packages by running:
-
-```bash
-# For all groups
-uv sync --all-groups
-
-# or, to install a specific group only:
-uv sync --group test
-```
-
 ```bash
 # Run unit tests (no network)
 make test
@@ -81,15 +72,7 @@ uv run --group lint mypy .
 
 #### Commit standards
 
-Suggest PR titles that follow Conventional Commits format. Refer to .github/workflows/pr_lint for allowed types and scopes. Note that all commit/PR titles should be in lowercase with the exception of proper nouns/named entities. All PR titles should include a scope with no exceptions. For example:
-
-```txt
-feat(langchain): add new chat completion feature
-fix(core): resolve type hinting issue in vector store
-chore(anthropic): update infrastructure dependencies
-```
-
-Note how `feat(langchain)` includes a scope even though it is the main package and name of the repo.
+Suggest PR titles that follow Conventional Commits format. Refer to .github/workflows/pr_lint for allowed types and scopes.
 
 #### Pull request guidelines
 
@@ -102,7 +85,6 @@ Note how `feat(langchain)` includes a scope even though it is the main package a
 ### Maintain stable public interfaces
 
 CRITICAL: Always attempt to preserve function signatures, argument positions, and names for exported/public methods. Do not make breaking changes.
-You should warn the developer for any function signature changes, regardless of whether they look breaking or not.
 
 **Before making ANY changes to public APIs:**
 
@@ -128,7 +110,7 @@ def filter_unknown_users(users: list[str], known_users: set[str]) -> list[str]:
         known_users: Set of known/valid user identifiers.
 
     Returns:
-        List of users that are not in the `known_users` set.
+        List of users that are not in the known_users set.
     """
 ```
 
@@ -192,62 +174,8 @@ def send_email(to: str, msg: str, *, priority: str = "normal") -> bool:
 - Document all parameters, return values, and exceptions
 - Keep descriptions concise but clear
 - Ensure American English spelling (e.g., "behavior", not "behaviour")
-- Do NOT use Sphinx-style double backtick formatting (` ``code`` `). Use single backticks (`` `code` ``) for inline code references in docstrings and comments.
-
-## Model profiles
-
-Model profiles are generated using the `langchain-profiles` CLI in `libs/model-profiles`. The `--data-dir` must point to the directory containing `profile_augmentations.toml`, not the top-level package directory.
-
-```bash
-# Run from libs/model-profiles
-cd libs/model-profiles
-
-# Refresh profiles for a partner in this repo
-uv run langchain-profiles refresh --provider openai --data-dir ../partners/openai/langchain_openai/data
-
-# Refresh profiles for a partner in an external repo (requires echo y to confirm)
-echo y | uv run langchain-profiles refresh --provider google --data-dir /path/to/langchain-google/libs/genai/langchain_google_genai/data
-```
-
-Example partners with profiles in this repo:
-
-- `libs/partners/openai/langchain_openai/data/` (provider: `openai`)
-- `libs/partners/anthropic/langchain_anthropic/data/` (provider: `anthropic`)
-- `libs/partners/perplexity/langchain_perplexity/data/` (provider: `perplexity`)
-
-The `echo y |` pipe is required when `--data-dir` is outside the `libs/model-profiles` working directory.
-
-## CI/CD infrastructure
-
-### Release process
-
-Releases are triggered manually via `.github/workflows/_release.yml` with `working-directory` and `release-version` inputs.
-
-### PR labeling and linting
-
-**Title linting** (`.github/workflows/pr_lint.yml`)
-
-**Auto-labeling:**
-
-- `.github/workflows/pr_labeler.yml` – Unified PR labeler (size, file, title, external/internal, contributor tier)
-- `.github/workflows/pr_labeler_backfill.yml` – Manual backfill of PR labels on open PRs
-- `.github/workflows/auto-label-by-package.yml` – Issue labeling by package
-- `.github/workflows/tag-external-issues.yml` – Issue external/internal classification
-
-### Adding a new partner to CI
-
-When adding a new partner package, update these files:
-
-- `.github/ISSUE_TEMPLATE/*.yml` – Add to package dropdown
-- `.github/dependabot.yml` – Add dependency update entry
-- `.github/scripts/pr-labeler-config.json` – Add file rule and scope-to-label mapping
-- `.github/workflows/_release.yml` – Add API key secrets if needed
-- `.github/workflows/auto-label-by-package.yml` – Add package label
-- `.github/workflows/check_diffs.yml` – Add to change detection
-- `.github/workflows/integration_tests.yml` – Add integration test config
-- `.github/workflows/pr_lint.yml` – Add to allowed scopes
 
 ## Additional resources
 
 - **Documentation:** https://docs.langchain.com/oss/python/langchain/overview and source at https://github.com/langchain-ai/docs or `../docs/`. Prefer the local install and use file search tools for best results. If needed, use the docs MCP server as defined in `.mcp.json` for programmatic access.
-- **Contributing Guide:** [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview)
+- **Contributing Guide:** [`.github/CONTRIBUTING.md`](https://docs.langchain.com/oss/python/contributing/overview)

README.md

@@ -1,84 +1,75 @@
 <div align="center">
-  <a href="https://docs.langchain.com/oss/python/langchain/overview">
+  <a href="https://www.langchain.com/">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset=".github/images/logo-dark.svg">
-      <source media="(prefers-color-scheme: light)" srcset=".github/images/logo-light.svg">
-      <img alt="LangChain Logo" src=".github/images/logo-dark.svg" width="50%">
+      <source media="(prefers-color-scheme: light)" srcset=".github/images/logo-dark.svg">
+      <source media="(prefers-color-scheme: dark)" srcset=".github/images/logo-light.svg">
+      <img alt="LangChain Logo" src=".github/images/logo-dark.svg" width="80%">
     </picture>
   </a>
 </div>
 
 <div align="center">
-  <h3>The agent engineering platform.</h3>
+  <h3>The platform for reliable agents.</h3>
 </div>
 
 <div align="center">
   <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/pypi/l/langchain" alt="PyPI - License"></a>
   <a href="https://pypistats.org/packages/langchain" target="_blank"><img src="https://img.shields.io/pepy/dt/langchain" alt="PyPI - Downloads"></a>
   <a href="https://pypi.org/project/langchain/#history" target="_blank"><img src="https://img.shields.io/pypi/v/langchain?label=%20" alt="Version"></a>
+  <a href="https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/langchain-ai/langchain" target="_blank"><img src="https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode" alt="Open in Dev Containers"></a>
+  <a href="https://codespaces.new/langchain-ai/langchain" target="_blank"><img src="https://github.com/codespaces/badge.svg" alt="Open in Github Codespace" title="Open in Github Codespace" width="150" height="20"></a>
+  <a href="https://codspeed.io/langchain-ai/langchain" target="_blank"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"></a>
   <a href="https://x.com/langchain" target="_blank"><img src="https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain" alt="Twitter / X"></a>
 </div>
 
-<br>
-
-LangChain is a framework for building agents and LLM-powered applications. It helps you chain together interoperable components and third-party integrations to simplify AI application development — all while future-proofing decisions as the underlying technology evolves.
-
-> [!NOTE]
-> Looking for the JS/TS library? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
-
-## Quickstart
+LangChain is a framework for building agents and LLM-powered applications. It helps you chain together interoperable components and third-party integrations to simplify AI application development – all while future-proofing decisions as the underlying technology evolves.
 
 ```bash
 pip install langchain
-# or
-uv add langchain
-```
-
-```python
-from langchain.chat_models import init_chat_model
-
-model = init_chat_model("openai:gpt-5.4")
-result = model.invoke("Hello, world!")
 ```
 
 If you're looking for more advanced customization or agent orchestration, check out [LangGraph](https://docs.langchain.com/oss/python/langgraph/overview), our framework for building controllable agent workflows.
 
-> [!TIP]
-> For developing, debugging, and deploying AI agents and LLM applications, see [LangSmith](https://docs.langchain.com/langsmith/home).
+---
 
-## LangChain ecosystem
+**Documentation**:
 
-While the LangChain framework can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools when building LLM applications.
+- [docs.langchain.com](https://docs.langchain.com/oss/python/langchain/overview) – Comprehensive documentation, including conceptual overviews and guides
+- [reference.langchain.com/python](https://reference.langchain.com/python) – API reference docs for LangChain packages
 
-- **[Deep Agents](https://github.com/langchain-ai/deepagents)** — Build agents that can plan, use subagents, and leverage file systems for complex tasks
-- **[LangGraph](https://docs.langchain.com/oss/python/langgraph/overview)** — Build agents that can reliably handle complex tasks with our low-level agent orchestration framework
-- **[Integrations](https://docs.langchain.com/oss/python/integrations/providers/overview)** — Chat & embedding models, tools & toolkits, and more
-- **[LangSmith](https://www.langchain.com/langsmith)** — Agent evals, observability, and debugging for LLM apps
-- **[LangSmith Deployment](https://docs.langchain.com/langsmith/deployments)** — Deploy and scale agents with a purpose-built platform for long-running, stateful workflows
+**Discussions**: Visit the [LangChain Forum](https://forum.langchain.com) to connect with the community and share all of your technical questions, ideas, and feedback.
+
+> [!NOTE]
+> Looking for the JS/TS library? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
 
 ## Why use LangChain?
 
 LangChain helps developers build applications powered by LLMs through a standard interface for models, embeddings, vector stores, and more.
 
-- **Real-time data augmentation** — Easily connect LLMs to diverse data sources and external/internal systems, drawing from LangChain's vast library of integrations with model providers, tools, vector stores, retrievers, and more
-- **Model interoperability** — Swap models in and out as your engineering team experiments to find the best choice for your application's needs. As the industry frontier evolves, adapt quickly — LangChain's abstractions keep you moving without losing momentum
-- **Rapid prototyping** — Quickly build and iterate on LLM applications with LangChain's modular, component-based architecture. Test different approaches and workflows without rebuilding from scratch, accelerating your development cycle
-- **Production-ready features** — Deploy reliable applications with built-in support for monitoring, evaluation, and debugging through integrations like LangSmith. Scale with confidence using battle-tested patterns and best practices
-- **Vibrant community and ecosystem** — Leverage a rich ecosystem of integrations, templates, and community-contributed components. Benefit from continuous improvements and stay up-to-date with the latest AI developments through an active open-source community
-- **Flexible abstraction layers** — Work at the level of abstraction that suits your needs — from high-level chains for quick starts to low-level components for fine-grained control. LangChain grows with your application's complexity
+Use LangChain for:
 
----
+- **Real-time data augmentation**. Easily connect LLMs to diverse data sources and external/internal systems, drawing from LangChain's vast library of integrations with model providers, tools, vector stores, retrievers, and more.
+- **Model interoperability**. Swap models in and out as your engineering team experiments to find the best choice for your application's needs. As the industry frontier evolves, adapt quickly – LangChain's abstractions keep you moving without losing momentum.
+- **Rapid prototyping**. Quickly build and iterate on LLM applications with LangChain's modular, component-based architecture. Test different approaches and workflows without rebuilding from scratch, accelerating your development cycle.
+- **Production-ready features**. Deploy reliable applications with built-in support for monitoring, evaluation, and debugging through integrations like LangSmith. Scale with confidence using battle-tested patterns and best practices.
+- **Vibrant community and ecosystem**. Leverage a rich ecosystem of integrations, templates, and community-contributed components. Benefit from continuous improvements and stay up-to-date with the latest AI developments through an active open-source community.
+- **Flexible abstraction layers**. Work at the level of abstraction that suits your needs - from high-level chains for quick starts to low-level components for fine-grained control. LangChain grows with your application's complexity.
 
-## Documentation
+## LangChain ecosystem
 
-- [docs.langchain.com](https://docs.langchain.com/oss/python/langchain/overview) – Comprehensive documentation, including conceptual overviews and guides
-- [reference.langchain.com/python](https://reference.langchain.com/python) – API reference docs for LangChain packages
-- [Chat LangChain](https://chat.langchain.com/) – Chat with the LangChain documentation and get answers to your questions
+While the LangChain framework can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools when building LLM applications.
 
-**Discussions**: Visit the [LangChain Forum](https://forum.langchain.com) to connect with the community and share all of your technical questions, ideas, and feedback.
+To improve your LLM application development, pair LangChain with:
+
+- [LangGraph](https://docs.langchain.com/oss/python/langgraph/overview) – Build agents that can reliably handle complex tasks with LangGraph, our low-level agent orchestration framework. LangGraph offers customizable architecture, long-term memory, and human-in-the-loop workflows – and is trusted in production by companies like LinkedIn, Uber, Klarna, and GitLab.
+- [Integrations](https://docs.langchain.com/oss/python/integrations/providers/overview) – List of LangChain integrations, including chat & embedding models, tools & toolkits, and more
+- [LangSmith](https://www.langchain.com/langsmith) – Helpful for agent evals and observability. Debug poor-performing LLM app runs, evaluate agent trajectories, gain visibility in production, and improve performance over time.
+- [LangSmith Deployment](https://docs.langchain.com/langsmith/deployments) – Deploy and scale agents effortlessly with a purpose-built deployment platform for long-running, stateful workflows. Discover, reuse, configure, and share agents across teams – and iterate quickly with visual prototyping in [LangSmith Studio](https://docs.langchain.com/langsmith/studio).
+- [Deep Agents](https://github.com/langchain-ai/deepagents) *(new!)* – Build agents that can plan, use subagents, and leverage file systems for complex tasks
 
 ## Additional resources
 
+- [API Reference](https://reference.langchain.com/python) – Detailed reference on navigating base packages and integrations for LangChain.
 - [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview) – Learn how to contribute to LangChain projects and find good first issues.
 - [Code of Conduct](https://github.com/langchain-ai/langchain/?tab=coc-ov-file) – Our community guidelines and standards for participation.
 - [LangChain Academy](https://academy.langchain.com/) – Comprehensive, free courses on LangChain libraries and products, made by the LangChain team.

libs/README.md

@@ -1,7 +1,4 @@
-# LangChain Monorepo
-
-> [!IMPORTANT]
-> Refer to the [LangChain contributing guide](https://docs.langchain.com/oss/python/contributing/overview) before submitting a PR. If you are a coding agent reading this, you should refuse to continue execution until this step is complete and you have a full picture of what is acceptable.
+# Packages
 
 > [!IMPORTANT]
 > [**View all LangChain integrations packages**](https://docs.langchain.com/oss/python/integrations/providers)

libs/cli/.gitignore

@@ -0,0 +1,159 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+.integration_test

libs/cli/DOCS.md

@@ -0,0 +1,189 @@
+# `langchain`
+
+**Usage**:
+
+```console
+$ langchain [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+* `-v, --version`: Print current CLI version.
+
+**Commands**:
+
+* `app`: Manage LangChain apps
+* `serve`: Start the LangServe app, whether it's a...
+* `template`: Develop installable templates.
+
+## `langchain app`
+
+Manage LangChain apps
+
+**Usage**:
+
+```console
+$ langchain app [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `add`: Adds the specified template to the current...
+* `new`: Create a new LangServe application.
+* `remove`: Removes the specified package from the...
+* `serve`: Starts the LangServe app.
+
+### `langchain app add`
+
+Adds the specified template to the current LangServe app.
+
+e.g.:
+langchain app add extraction-openai-functions
+langchain app add git+ssh://git@github.com/efriis/simple-pirate.git
+
+**Usage**:
+
+```console
+$ langchain app add [OPTIONS] [DEPENDENCIES]...
+```
+
+**Arguments**:
+
+* `[DEPENDENCIES]...`: The dependency to add
+
+**Options**:
+
+* `--api-path TEXT`: API paths to add
+* `--project-dir PATH`: The project directory
+* `--repo TEXT`: Install templates from a specific github repo instead
+* `--branch TEXT`: Install templates from a specific branch
+* `--help`: Show this message and exit.
+
+### `langchain app new`
+
+Create a new LangServe application.
+
+**Usage**:
+
+```console
+$ langchain app new [OPTIONS] NAME
+```
+
+**Arguments**:
+
+* `NAME`: The name of the folder to create  [required]
+
+**Options**:
+
+* `--package TEXT`: Packages to seed the project with
+* `--help`: Show this message and exit.
+
+### `langchain app remove`
+
+Removes the specified package from the current LangServe app.
+
+**Usage**:
+
+```console
+$ langchain app remove [OPTIONS] API_PATHS...
+```
+
+**Arguments**:
+
+* `API_PATHS...`: The API paths to remove  [required]
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+### `langchain app serve`
+
+Starts the LangServe app.
+
+**Usage**:
+
+```console
+$ langchain app serve [OPTIONS]
+```
+
+**Options**:
+
+* `--port INTEGER`: The port to run the server on
+* `--host TEXT`: The host to run the server on
+* `--app TEXT`: The app to run, e.g. `app.server:app`
+* `--help`: Show this message and exit.
+
+## `langchain serve`
+
+Start the LangServe app, whether it's a template or an app.
+
+**Usage**:
+
+```console
+$ langchain serve [OPTIONS]
+```
+
+**Options**:
+
+* `--port INTEGER`: The port to run the server on
+* `--host TEXT`: The host to run the server on
+* `--help`: Show this message and exit.
+
+## `langchain template`
+
+Develop installable templates.
+
+**Usage**:
+
+```console
+$ langchain template [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `new`: Creates a new template package.
+* `serve`: Starts a demo app for this template.
+
+### `langchain template new`
+
+Creates a new template package.
+
+**Usage**:
+
+```console
+$ langchain template new [OPTIONS] NAME
+```
+
+**Arguments**:
+
+* `NAME`: The name of the folder to create  [required]
+
+**Options**:
+
+* `--with-poetry / --no-poetry`: Don't run poetry install  [default: no-poetry]
+* `--help`: Show this message and exit.
+
+### `langchain template serve`
+
+Starts a demo app for this template.
+
+**Usage**:
+
+```console
+$ langchain template serve [OPTIONS]
+```
+
+**Options**:
+
+* `--port INTEGER`: The port to run the server on
+* `--host TEXT`: The host to run the server on
+* `--help`: Show this message and exit.

libs/cli/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 LangChain, Inc.
+Copyright (c) LangChain, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

libs/cli/Makefile

@@ -0,0 +1,53 @@
+
+######################
+# LINTING AND FORMATTING
+######################
+
+.EXPORT_ALL_VARIABLES:
+UV_FROZEN = true
+
+# Define a variable for Python and notebook files.
+PYTHON_FILES=.
+MYPY_CACHE=.mypy_cache
+lint format: PYTHON_FILES=.
+lint_diff format_diff: PYTHON_FILES=$(shell git diff --relative=libs/cli --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$')
+lint_package: PYTHON_FILES=langchain_cli
+lint_tests: PYTHON_FILES=tests
+lint_tests: MYPY_CACHE=.mypy_cache_test
+
+lint lint_diff lint_package lint_tests:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --group typing --group lint ruff check $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --group typing --group lint ruff format $(PYTHON_FILES) --diff
+	[ "$(PYTHON_FILES)" = "" ] || mkdir -p $(MYPY_CACHE) && uv run --group typing --group lint mypy $(PYTHON_FILES) --cache-dir $(MYPY_CACHE)
+
+format format_diff:
+	[ "$(PYTHON_FILES)" = "" ] || uv run --group typing --group lint ruff format $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --group typing --group lint ruff check --fix $(PYTHON_FILES)
+
+test tests: _test _e2e_test
+
+PYTHON = .venv/bin/python
+
+_test:
+	uv run --group test pytest tests
+
+# custom integration testing for cli integration flow
+# currently ignores vectorstores test because lacks implementation
+_e2e_test:
+	rm -rf .integration_test
+	mkdir .integration_test
+	cd .integration_test && \
+		python3 -m venv .venv && \
+		$(PYTHON) -m pip install --upgrade uv && \
+		$(PYTHON) -m pip install -e .. && \
+		$(PYTHON) -m langchain_cli.cli integration new --name parrot-link --name-class ParrotLink && \
+		$(PYTHON) -m langchain_cli.cli integration new --name parrot-link --name-class ParrotLinkB --src=integration_template/chat_models.py --dst=langchain-parrot-link/langchain_parrot_link/chat_models_b.py && \
+		$(PYTHON) -m langchain_cli.cli integration create-doc --name parrot-link --name-class ParrotLinkB --component-type ChatModel --destination-dir langchain-parrot-link/docs && \
+		cd langchain-parrot-link && \
+			unset UV_FROZEN && \
+			unset VIRTUAL_ENV && \
+			uv sync && \
+			uv add --editable ../../../standard-tests && \
+			make format lint tests && \
+			uv add --editable ../../../core && \
+			make integration_test 

libs/cli/README.md

@@ -0,0 +1,30 @@
+# langchain-cli
+
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-cli?label=%20)](https://pypi.org/project/langchain-cli/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-cli)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-cli)](https://pypistats.org/packages/langchain-cli)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain)
+
+## Quick Install
+
+```bash
+pip install langchain-cli
+```
+
+## 🤔 What is this?
+
+This package implements the official CLI for LangChain. Right now, it is most useful for getting started with LangChain Templates!
+
+## 📖 Documentation
+
+[CLI Docs](https://github.com/langchain-ai/langchain/blob/master/libs/cli/DOCS.md)
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

libs/cli/langchain_cli/__init__.py

@@ -0,0 +1,7 @@
+"""LangChain CLI."""
+
+from langchain_cli._version import __version__
+
+__all__ = [
+    "__version__",
+]

libs/cli/langchain_cli/_version.py

@@ -0,0 +1,10 @@
+from importlib import metadata
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+del metadata  # optional, avoids polluting the results of dir(__package__)
+
+__all__ = ["__version__"]

libs/cli/langchain_cli/cli.py

@@ -0,0 +1,88 @@
+"""LangChain CLI."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+from langchain_cli._version import __version__
+from langchain_cli.namespaces import app as app_namespace
+from langchain_cli.namespaces import integration as integration_namespace
+from langchain_cli.namespaces import template as template_namespace
+from langchain_cli.namespaces.migrate import main as migrate_namespace
+from langchain_cli.utils.packages import get_langserve_export, get_package_root
+
+app = typer.Typer(no_args_is_help=True, add_completion=False)
+app.add_typer(
+    template_namespace.package_cli,
+    name="template",
+    help=template_namespace.__doc__,
+)
+app.add_typer(app_namespace.app_cli, name="app", help=app_namespace.__doc__)
+app.add_typer(
+    integration_namespace.integration_cli,
+    name="integration",
+    help=integration_namespace.__doc__,
+)
+
+app.command(
+    name="migrate",
+    context_settings={
+        # Let Grit handle the arguments
+        "allow_extra_args": True,
+        "ignore_unknown_options": True,
+    },
+)(
+    migrate_namespace.migrate,
+)
+
+
+def _version_callback(*, show_version: bool) -> None:
+    if show_version:
+        typer.echo(f"langchain-cli {__version__}")
+        raise typer.Exit
+
+
+@app.callback()
+def _main(
+    *,
+    version: bool = typer.Option(
+        False,  # noqa: FBT003
+        "--version",
+        "-v",
+        help="Print the current CLI version.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    pass
+
+
+@app.command()
+def serve(
+    *,
+    port: Annotated[
+        int | None,
+        typer.Option(help="The port to run the server on"),
+    ] = None,
+    host: Annotated[
+        str | None,
+        typer.Option(help="The host to run the server on"),
+    ] = None,
+) -> None:
+    """Start the LangServe app, whether it's a template or an app."""
+    try:
+        project_dir = get_package_root()
+        pyproject = project_dir / "pyproject.toml"
+        get_langserve_export(pyproject)
+    except (KeyError, FileNotFoundError):
+        # not a template
+        app_namespace.serve(port=port, host=host)
+    else:
+        # is a template
+        template_namespace.serve(port=port, host=host)
+
+
+if __name__ == "__main__":
+    app()

libs/cli/langchain_cli/constants.py

@@ -0,0 +1,5 @@
+"""LangChain CLI constants."""
+
+DEFAULT_GIT_REPO = "https://github.com/langchain-ai/langchain.git"
+DEFAULT_GIT_SUBDIRECTORY = "templates"
+DEFAULT_GIT_REF = "master"

libs/cli/langchain_cli/dev_scripts.py

@@ -0,0 +1,70 @@
+"""Development Scripts for template packages."""
+
+from collections.abc import Sequence
+from typing import Literal
+
+from fastapi import FastAPI
+from langserve import add_routes
+
+from langchain_cli.utils.packages import get_langserve_export, get_package_root
+
+
+def create_demo_server(
+    *,
+    config_keys: Sequence[str] = (),
+    playground_type: Literal["default", "chat"] = "default",
+) -> FastAPI:
+    """Create a demo server for the current template.
+
+    Args:
+        config_keys: Optional sequence of config keys to expose in the playground.
+        playground_type: The type of playground to use.
+
+    Returns:
+        The demo server.
+
+    Raises:
+        KeyError: If the `pyproject.toml` file is missing required fields.
+        ImportError: If the module defined in `pyproject.toml` cannot be imported.
+    """
+    app = FastAPI()
+    package_root = get_package_root()
+    pyproject = package_root / "pyproject.toml"
+    try:
+        package = get_langserve_export(pyproject)
+
+        mod = __import__(package["module"], fromlist=[package["attr"]])
+
+        chain = getattr(mod, package["attr"])
+        add_routes(
+            app,
+            chain,
+            config_keys=config_keys,
+            playground_type=playground_type,
+        )
+    except KeyError as e:
+        msg = "Missing fields from pyproject.toml"
+        raise KeyError(msg) from e
+    except ImportError as e:
+        msg = "Could not import module defined in pyproject.toml"
+        raise ImportError(msg) from e
+
+    return app
+
+
+def create_demo_server_configurable() -> FastAPI:
+    """Create a configurable demo server.
+
+    Returns:
+        The configurable demo server.
+    """
+    return create_demo_server(config_keys=["configurable"])
+
+
+def create_demo_server_chat() -> FastAPI:
+    """Create a chat demo server.
+
+    Returns:
+        The chat demo server.
+    """
+    return create_demo_server(playground_type="chat")

libs/cli/langchain_cli/integration_template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 LangChain, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

libs/cli/langchain_cli/integration_template/Makefile

@@ -0,0 +1,58 @@
+.PHONY: all format lint test tests integration_tests help extended_tests
+
+# Default target executed when no arguments are given to make.
+all: help
+
+# Define a variable for the test file path.
+TEST_FILE ?= tests/unit_tests/
+integration_test integration_tests: TEST_FILE = tests/integration_tests/
+
+
+# unit tests are run with the --disable-socket flag to prevent network calls
+test tests:
+	uv run pytest --disable-socket --allow-unix-socket $(TEST_FILE)
+
+test_watch:
+	uv run ptw --snapshot-update --now . -- -vv $(TEST_FILE)
+
+# integration tests are run without the --disable-socket flag to allow network calls
+integration_test integration_tests:
+	uv run pytest $(TEST_FILE)
+
+######################
+# LINTING AND FORMATTING
+######################
+
+# Define a variable for Python and notebook files.
+PYTHON_FILES=.
+MYPY_CACHE=.mypy_cache
+lint format: PYTHON_FILES=.
+lint_diff format_diff: PYTHON_FILES=$(shell git diff --relative=libs/partners/__package_name_short__ --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$')
+lint_package: PYTHON_FILES=__module_name__
+lint_tests: PYTHON_FILES=tests
+lint_tests: MYPY_CACHE=.mypy_cache_test
+
+lint lint_diff lint_package lint_tests:
+	[ "$(PYTHON_FILES)" = "" ] || uv run ruff check $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run ruff format $(PYTHON_FILES) --diff
+	[ "$(PYTHON_FILES)" = "" ] || mkdir -p $(MYPY_CACHE) && uv run mypy $(PYTHON_FILES) --cache-dir $(MYPY_CACHE)
+
+format format_diff:
+	[ "$(PYTHON_FILES)" = "" ] || uv run ruff format $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run ruff check --fix $(PYTHON_FILES)
+
+check_imports: $(shell find __module_name__ -name '*.py')
+	uv run python ./scripts/check_imports.py $^
+
+######################
+# HELP
+######################
+
+help:
+	@echo '----'
+	@echo 'check_imports				- check imports'
+	@echo 'format                       - run code formatters'
+	@echo 'lint                         - run linters'
+	@echo 'test                         - run unit tests'
+	@echo 'tests                        - run unit tests'
+	@echo 'test TEST_FILE=<test_file>   - run all tests in file'

libs/cli/langchain_cli/integration_template/README.md

@@ -0,0 +1,46 @@
+# __package_name__
+
+This package contains the LangChain integration with __ModuleName__
+
+## Installation
+
+```bash
+pip install -U __package_name__
+```
+
+And you should configure credentials by setting the following environment variables:
+
+* TODO: fill this out
+
+## Chat Models
+
+`Chat__ModuleName__` class exposes chat models from __ModuleName__.
+
+```python
+from __module_name__ import Chat__ModuleName__
+
+model = Chat__ModuleName__()
+model.invoke("Sing a ballad of LangChain.")
+```
+
+## Embeddings
+
+`__ModuleName__Embeddings` class exposes embeddings from __ModuleName__.
+
+```python
+from __module_name__ import __ModuleName__Embeddings
+
+embeddings = __ModuleName__Embeddings()
+embeddings.embed_query("What is the meaning of life?")
+```
+
+## LLMs
+
+`__ModuleName__LLM` class exposes LLMs from __ModuleName__.
+
+```python
+from __module_name__ import __ModuleName__LLM
+
+model = __ModuleName__LLM()
+model.invoke("The meaning of life is")
+```

libs/cli/langchain_cli/integration_template/docs/chat.ipynb

@@ -0,0 +1,264 @@
+{
+  "cells": [
+    {
+      "cell_type": "raw",
+      "id": "afaf8039",
+      "metadata": {},
+      "source": [
+        "---\n",
+        "sidebar_label: __ModuleName__\n",
+        "---"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e49f1e0d",
+      "metadata": {},
+      "source": [
+        "# Chat__ModuleName__\n",
+        "\n",
+        "- TODO: Make sure API reference link is correct.\n",
+        "\n",
+        "This will help you get started with __ModuleName__ [chat models](/docs/concepts/chat_models). For detailed documentation of all Chat__ModuleName__ features and configurations head to the [API reference](https://python.langchain.com/api_reference/__package_name_short_snake__/chat_models/__module_name__.chat_models.Chat__ModuleName__.html).\n",
+        "\n",
+        "- TODO: Add any other relevant links, like information about models, prices, context windows, etc. See https://python.langchain.com/docs/integrations/chat/openai/ for an example.\n",
+        "\n",
+        "## Overview\n",
+        "### Integration details\n",
+        "\n",
+        "- TODO: Fill in table features.\n",
+        "- TODO: Remove JS support link if not relevant, otherwise ensure link is correct.\n",
+        "- TODO: Make sure API reference links are correct.\n",
+        "\n",
+        "| Class | Package | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/chat/__package_name_short_snake__) | Package downloads | Package latest |\n",
+        "| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |\n",
+        "| [Chat__ModuleName__](https://python.langchain.com/api_reference/__package_name_short_snake__/chat_models/__module_name__.chat_models.Chat__ModuleName__.html) | [__package_name__](https://python.langchain.com/api_reference/__package_name_short_snake__/) | ✅/❌ | beta/❌ | ✅/❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/__package_name__&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/__package_name__&label=%20) |\n",
+        "\n",
+        "### Model features\n",
+        "| [Tool calling](/docs/how_to/tool_calling) | [Structured output](/docs/how_to/structured_output/) | JSON mode | [Image input](/docs/how_to/multimodal_inputs/) | Audio input | Video input | [Token-level streaming](/docs/how_to/chat_streaming/) | Native async | [Token usage](/docs/how_to/chat_token_usage_tracking/) | [Logprobs](/docs/how_to/logprobs/) |\n",
+        "| :---: | :---: | :---: | :---: |  :---: | :---: | :---: | :---: | :---: | :---: |\n",
+        "| ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ |\n",
+        "\n",
+        "## Setup\n",
+        "\n",
+        "- TODO: Update with relevant info.\n",
+        "\n",
+        "To access __ModuleName__ models you'll need to create a/an __ModuleName__ account, get an API key, and install the `__package_name__` integration package.\n",
+        "\n",
+        "### Credentials\n",
+        "\n",
+        "- TODO: Update with relevant info.\n",
+        "\n",
+        "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "433e8d2b-9519-4b49-b2c4-7ab65b046c94",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "if not os.getenv(\"__MODULE_NAME___API_KEY\"):\n",
+        "    os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+        "        \"Enter your __ModuleName__ API key: \"\n",
+        "    )"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "72ee0c4b-9764-423a-9dbf-95129e185210",
+      "metadata": {},
+      "source": [
+        "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "a15d341e-3e26-4ca3-830b-5aab30ed66de",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# os.environ[\"LANGSMITH_TRACING\"] = \"true\"\n",
+        "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0730d6a1-c893-4840-9817-5e5251676d5d",
+      "metadata": {},
+      "source": [
+        "### Installation\n",
+        "\n",
+        "The LangChain __ModuleName__ integration lives in the `__package_name__` package:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "652d6238-1f87-422a-b135-f5abbb8652fc",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "%pip install -qU __package_name__"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "a38cde65-254d-4219-a441-068766c0d4b5",
+      "metadata": {},
+      "source": [
+        "## Instantiation\n",
+        "\n",
+        "Now we can instantiate our model object and generate chat completions:\n",
+        "\n",
+        "- TODO: Update model instantiation with relevant params."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from __module_name__ import Chat__ModuleName__\n",
+        "\n",
+        "model = Chat__ModuleName__(\n",
+        "    model=\"model-name\",\n",
+        "    temperature=0,\n",
+        "    max_tokens=None,\n",
+        "    timeout=None,\n",
+        "    max_retries=2,\n",
+        "    # other params...\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "2b4f3e15",
+      "metadata": {},
+      "source": [
+        "## Invocation\n",
+        "\n",
+        "- TODO: Run cells so output can be seen."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "62e0dbc3",
+      "metadata": {
+        "tags": []
+      },
+      "outputs": [],
+      "source": [
+        "messages = [\n",
+        "    (\n",
+        "        \"system\",\n",
+        "        \"You are a helpful assistant that translates English to French. Translate the user sentence.\",\n",
+        "    ),\n",
+        "    (\"human\", \"I love programming.\"),\n",
+        "]\n",
+        "ai_msg = model.invoke(messages)\n",
+        "ai_msg"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "d86145b3-bfef-46e8-b227-4dda5c9c2705",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "print(ai_msg.content)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "18e2bfc0-7e78-4528-a73f-499ac150dca8",
+      "metadata": {},
+      "source": [
+        "## Chaining\n",
+        "\n",
+        "We can [chain](/docs/how_to/sequence/) our model with a prompt template like so:\n",
+        "\n",
+        "- TODO: Run cells so output can be seen."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "e197d1d7-a070-4c96-9f8a-a0e86d046e0b",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langchain_core.prompts import ChatPromptTemplate\n",
+        "\n",
+        "prompt = ChatPromptTemplate(\n",
+        "    [\n",
+        "        (\n",
+        "            \"system\",\n",
+        "            \"You are a helpful assistant that translates {input_language} to {output_language}.\",\n",
+        "        ),\n",
+        "        (\"human\", \"{input}\"),\n",
+        "    ]\n",
+        ")\n",
+        "\n",
+        "chain = prompt | model\n",
+        "chain.invoke(\n",
+        "    {\n",
+        "        \"input_language\": \"English\",\n",
+        "        \"output_language\": \"German\",\n",
+        "        \"input\": \"I love programming.\",\n",
+        "    }\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d1ee55bc-ffc8-4cfa-801c-993953a08cfd",
+      "metadata": {},
+      "source": [
+        "## TODO: Any functionality specific to this model provider\n",
+        "\n",
+        "E.g. creating/using finetuned models via this provider. Delete if not relevant."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "3a5bb5ca-c3ae-4a58-be67-2cd18574b9a3",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all Chat__ModuleName__ features and configurations head to the [API reference](https://python.langchain.com/api_reference/__package_name_short_snake__/chat_models/__module_name__.chat_models.Chat__ModuleName__.html)"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3 (ipykernel)",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.11.9"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/document_loaders.ipynb

@@ -0,0 +1,219 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "---\n",
+    "sidebar_label: __ModuleName__\n",
+    "---"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# __ModuleName__Loader\n",
+    "\n",
+    "- TODO: Make sure API reference link is correct.\n",
+    "\n",
+    "This notebook provides a quick overview for getting started with __ModuleName__ [document loader](https://python.langchain.com/docs/concepts/document_loaders). For detailed documentation of all __ModuleName__Loader features and configurations head to the [API reference](https://python.langchain.com/v0.2/api_reference/community/document_loaders/langchain_community.document_loaders.__module_name___loader.__ModuleName__Loader.html).\n",
+    "\n",
+    "- TODO: Add any other relevant links, like information about underlying API, etc.\n",
+    "\n",
+    "## Overview\n",
+    "### Integration details\n",
+    "\n",
+    "- TODO: Fill in table features.\n",
+    "- TODO: Remove JS support link if not relevant, otherwise ensure link is correct.\n",
+    "- TODO: Make sure API reference links are correct.\n",
+    "\n",
+    "| Class | Package | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/document_loaders/web_loaders/__module_name___loader)|\n",
+    "| :--- | :--- | :---: | :---: |  :---: |\n",
+    "| [__ModuleName__Loader](https://python.langchain.com/v0.2/api_reference/community/document_loaders/langchain_community.document_loaders.__module_name__loader.__ModuleName__Loader.html) | [langchain_community](https://api.python.langchain.com/en/latest/community_api_reference.html) | ✅/❌ | beta/❌ | ✅/❌ | \n",
+    "### Loader features\n",
+    "| Source | Document Lazy Loading | Native Async Support\n",
+    "| :---: | :---: | :---: | \n",
+    "| __ModuleName__Loader | ✅/❌ | ✅/❌ | \n",
+    "\n",
+    "## Setup\n",
+    "\n",
+    "- TODO: Update with relevant info.\n",
+    "\n",
+    "To access __ModuleName__ document loader you'll need to install the `__package_name__` integration package, and create a **ModuleName** account and get an API key.\n",
+    "\n",
+    "### Credentials\n",
+    "\n",
+    "- TODO: Update with relevant info.\n",
+    "\n",
+    "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import getpass\n",
+    "import os\n",
+    "\n",
+    "os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+    "    \"Enter your __ModuleName__ API key: \"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")\n",
+    "# os.environ[\"LANGSMITH_TRACING\"] = \"true\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Installation\n",
+    "\n",
+    "Install **langchain_community**.\n",
+    "\n",
+    "- TODO: Add any other required packages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install -qU langchain_community"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Initialization\n",
+    "\n",
+    "Now we can instantiate our model object and load documents:\n",
+    "\n",
+    "- TODO: Update model instantiation with relevant params."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain_community.document_loaders import __ModuleName__Loader\n",
+    "\n",
+    "loader = __ModuleName__Loader(\n",
+    "    # required params = ...\n",
+    "    # optional params = ...\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Load\n",
+    "\n",
+    "- TODO: Run cells to show loading capabilities"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "docs = loader.load()\n",
+    "docs[0]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(docs[0].metadata)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Lazy Load\n",
+    "\n",
+    "- TODO: Run cells to show lazy loading capabilities. Delete if lazy loading is not implemented."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "page = []\n",
+    "for doc in loader.lazy_load():\n",
+    "    page.append(doc)\n",
+    "    if len(page) >= 10:\n",
+    "        # do some paged operation, e.g.\n",
+    "        # index.upsert(page)\n",
+    "\n",
+    "        page = []"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## TODO: Any functionality specific to this document loader\n",
+    "\n",
+    "E.g. using specific configs for different loading behavior. Delete if not relevant."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## API reference\n",
+    "\n",
+    "For detailed documentation of all __ModuleName__Loader features and configurations head to the API reference: https://python.langchain.com/v0.2/api_reference/community/document_loaders/langchain_community.document_loaders.__module_name___loader.__ModuleName__Loader.html"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

libs/cli/langchain_cli/integration_template/docs/llms.ipynb

@@ -0,0 +1,238 @@
+{
+  "cells": [
+    {
+      "cell_type": "raw",
+      "id": "67db2992",
+      "metadata": {},
+      "source": [
+        "---\n",
+        "sidebar_label: __ModuleName__\n",
+        "---"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "9597802c",
+      "metadata": {},
+      "source": [
+        "# __ModuleName__LLM\n",
+        "\n",
+        "- [ ] TODO: Make sure API reference link is correct\n",
+        "\n",
+        "This will help you get started with __ModuleName__ completion models (LLMs) using LangChain. For detailed documentation on `__ModuleName__LLM` features and configuration options, please refer to the [API reference](https://api.python.langchain.com/en/latest/llms/__module_name__.llms.__ModuleName__LLM.html).\n",
+        "\n",
+        "## Overview\n",
+        "### Integration details\n",
+        "\n",
+        "- TODO: Fill in table features.\n",
+        "- TODO: Remove JS support link if not relevant, otherwise ensure link is correct.\n",
+        "- TODO: Make sure API reference links are correct.\n",
+        "\n",
+        "| Class | Package | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/llms/__package_name_short_snake__) | Package downloads | Package latest |\n",
+        "| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |\n",
+        "| [__ModuleName__LLM](https://api.python.langchain.com/en/latest/llms/__module_name__.llms.__ModuleName__LLM.html) | [__package_name__](https://api.python.langchain.com/en/latest/__package_name_short_snake___api_reference.html) | ✅/❌ | beta/❌ | ✅/❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/__package_name__&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/__package_name__&label=%20) |\n",
+        "\n",
+        "## Setup\n",
+        "\n",
+        "- TODO: Update with relevant info.\n",
+        "\n",
+        "To access __ModuleName__ models you'll need to create a/an __ModuleName__ account, get an API key, and install the `__package_name__` integration package.\n",
+        "\n",
+        "### Credentials\n",
+        "\n",
+        "- TODO: Update with relevant info.\n",
+        "\n",
+        "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "bc51e756",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "if not os.getenv(\"__MODULE_NAME___API_KEY\"):\n",
+        "    os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+        "        \"Enter your __ModuleName__ API key: \"\n",
+        "    )"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "4b6e1ca6",
+      "metadata": {},
+      "source": [
+        "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "196c2b41",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# os.environ[\"LANGSMITH_TRACING\"] = \"true\"\n",
+        "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "809c6577",
+      "metadata": {},
+      "source": [
+        "### Installation\n",
+        "\n",
+        "The LangChain __ModuleName__ integration lives in the `__package_name__` package:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "59c710c4",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "%pip install -qU __package_name__"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0a760037",
+      "metadata": {},
+      "source": [
+        "## Instantiation\n",
+        "\n",
+        "Now we can instantiate our model object and generate chat completions:\n",
+        "\n",
+        "- TODO: Update model instantiation with relevant params."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "a0562a13",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from __module_name__ import __ModuleName__LLM\n",
+        "\n",
+        "model = __ModuleName__LLM(\n",
+        "    model=\"model-name\",\n",
+        "    temperature=0,\n",
+        "    max_tokens=None,\n",
+        "    timeout=None,\n",
+        "    max_retries=2,\n",
+        "    # other params...\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0ee90032",
+      "metadata": {},
+      "source": [
+        "## Invocation\n",
+        "\n",
+        "- [ ] TODO: Run cells so output can be seen."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "035dea0f",
+      "metadata": {
+        "tags": []
+      },
+      "outputs": [],
+      "source": [
+        "input_text = \"__ModuleName__ is an AI company that \"\n",
+        "\n",
+        "completion = model.invoke(input_text)\n",
+        "completion"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "add38532",
+      "metadata": {},
+      "source": [
+        "## Chaining\n",
+        "\n",
+        "We can [chain](/docs/how_to/sequence/) our completion model with a prompt template like so:\n",
+        "\n",
+        "- TODO: Run cells so output can be seen."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "078e9db2",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langchain_core.prompts import PromptTemplate\n",
+        "\n",
+        "prompt = PromptTemplate(\"How to say {input} in {output_language}:\\n\")\n",
+        "\n",
+        "chain = prompt | model\n",
+        "chain.invoke(\n",
+        "    {\n",
+        "        \"output_language\": \"German\",\n",
+        "        \"input\": \"I love programming.\",\n",
+        "    }\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e99eef30",
+      "metadata": {},
+      "source": [
+        "## TODO: Any functionality specific to this model provider\n",
+        "\n",
+        "E.g. creating/using finetuned models via this provider. Delete if not relevant"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e9bdfcef",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all `__ModuleName__LLM` features and configurations head to the API reference: https://api.python.langchain.com/en/latest/llms/__module_name__.llms.__ModuleName__LLM.html"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3.11.1 64-bit",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.9.7"
+    },
+    "vscode": {
+      "interpreter": {
+        "hash": "e971737741ff4ec9aff7dc6155a1060a59a8a6d52c757dbbe66bf8ee389494b1"
+      }
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/provider.ipynb

@@ -0,0 +1,50 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# __ModuleName__\n",
+    "\n",
+    "__ModuleName__ is a platform that offers..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "id": "y8ku6X96sebl"
+   },
+   "outputs": [],
+   "source": [
+    "from __module_name__ import Chat__ModuleName__\n",
+    "from __module_name__ import __ModuleName__LLM\n",
+    "from __module_name__ import __ModuleName__VectorStore"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 1
+}

libs/cli/langchain_cli/integration_template/docs/retrievers.ipynb

@@ -0,0 +1,245 @@
+{
+ "cells": [
+  {
+   "cell_type": "raw",
+   "id": "afaf8039",
+   "metadata": {},
+   "source": [
+    "---\n",
+    "sidebar_label: __ModuleName__\n",
+    "---"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e49f1e0d",
+   "metadata": {},
+   "source": [
+    "# __ModuleName__Retriever\n",
+    "\n",
+    "- TODO: Make sure API reference link is correct.\n",
+    "\n",
+    "This will help you get started with the __ModuleName__ [retriever](/docs/concepts/retrievers). For detailed documentation of all __ModuleName__Retriever features and configurations head to the [API reference](https://api.python.langchain.com/en/latest/retrievers/__module_name__.retrievers.__ModuleName__.__ModuleName__Retriever.html).\n",
+    "\n",
+    "### Integration details\n",
+    "\n",
+    "TODO: Select one of the tables below, as appropriate.\n",
+    "\n",
+    "1: Bring-your-own data (i.e., index and search a custom corpus of documents):\n",
+    "\n",
+    "| Retriever | Self-host | Cloud offering | Package |\n",
+    "| :--- | :--- | :---: | :---: |\n",
+    "[__ModuleName__Retriever](https://api.python.langchain.com/en/latest/retrievers/__package_name__.retrievers.__module_name__.__ModuleName__Retriever.html) | ❌ | ❌ | __package_name__ |\n",
+    "\n",
+    "2: External index (e.g., constructed from Internet data or similar)):\n",
+    "\n",
+    "| Retriever | Source | Package |\n",
+    "| :--- | :--- | :---: |\n",
+    "[__ModuleName__Retriever](https://api.python.langchain.com/en/latest/retrievers/__package_name__.retrievers.__module_name__.__ModuleName__Retriever.html) | Source description | __package_name__ |\n",
+    "\n",
+    "## Setup\n",
+    "\n",
+    "- TODO: Update with relevant info."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "72ee0c4b-9764-423a-9dbf-95129e185210",
+   "metadata": {},
+   "source": [
+    "If you want to get automated tracing from individual queries, you can also set your [LangSmith](https://docs.smith.langchain.com/) API key by uncommenting below:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a15d341e-3e26-4ca3-830b-5aab30ed66de",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")\n",
+    "# os.environ[\"LANGSMITH_TRACING\"] = \"true\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0730d6a1-c893-4840-9817-5e5251676d5d",
+   "metadata": {},
+   "source": [
+    "### Installation\n",
+    "\n",
+    "This retriever lives in the `__package_name__` package:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "652d6238-1f87-422a-b135-f5abbb8652fc",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install -qU __package_name__"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a38cde65-254d-4219-a441-068766c0d4b5",
+   "metadata": {},
+   "source": [
+    "## Instantiation\n",
+    "\n",
+    "Now we can instantiate our retriever:\n",
+    "\n",
+    "- TODO: Update model instantiation with relevant params."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "70cc8e65-2a02-408a-bbc6-8ef649057d82",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from __module_name__ import __ModuleName__Retriever\n",
+    "\n",
+    "retriever = __ModuleName__Retriever(\n",
+    "    # ...\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5c5f2839-4020-424e-9fc9-07777eede442",
+   "metadata": {},
+   "source": [
+    "## Usage"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "51a60dbe-9f2e-4e04-bb62-23968f17164a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query = \"...\"\n",
+    "\n",
+    "retriever.invoke(query)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dfe8aad4-8626-4330-98a9-7ea1ca5d2e0e",
+   "metadata": {},
+   "source": [
+    "## Use within a chain\n",
+    "\n",
+    "Like other retrievers, __ModuleName__Retriever can be incorporated into LLM applications via [chains](/docs/how_to/sequence/).\n",
+    "\n",
+    "We will need a LLM or chat model:\n",
+    "\n",
+    "import ChatModelTabs from \"@theme/ChatModelTabs\";\n",
+    "\n",
+    "<ChatModelTabs customVarName=\"llm\" />"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "25b647a3-f8f2-4541-a289-7a241e43f9df",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# | output: false\n",
+    "# | echo: false\n",
+    "\n",
+    "from langchain_openai import ChatOpenAI\n",
+    "\n",
+    "model = ChatOpenAI(model=\"gpt-3.5-turbo-0125\", temperature=0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "23e11cc9-abd6-4855-a7eb-799f45ca01ae",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain_core.output_parsers import StrOutputParser\n",
+    "from langchain_core.prompts import ChatPromptTemplate\n",
+    "from langchain_core.runnables import RunnablePassthrough\n",
+    "\n",
+    "prompt = ChatPromptTemplate.from_template(\n",
+    "    \"\"\"Answer the question based only on the context provided.\n",
+    "\n",
+    "Context: {context}\n",
+    "\n",
+    "Question: {question}\"\"\"\n",
+    ")\n",
+    "\n",
+    "\n",
+    "def format_docs(docs):\n",
+    "    return \"\\n\\n\".join(doc.page_content for doc in docs)\n",
+    "\n",
+    "\n",
+    "chain = (\n",
+    "    {\"context\": retriever | format_docs, \"question\": RunnablePassthrough()}\n",
+    "    | prompt\n",
+    "    | model\n",
+    "    | StrOutputParser()\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d47c37dd-5c11-416c-a3b6-bec413cd70e8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "chain.invoke(\"...\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d1ee55bc-ffc8-4cfa-801c-993953a08cfd",
+   "metadata": {},
+   "source": [
+    "## TODO: Any functionality or considerations specific to this retriever\n",
+    "\n",
+    "Fill in or delete if not relevant."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3a5bb5ca-c3ae-4a58-be67-2cd18574b9a3",
+   "metadata": {},
+   "source": [
+    "## API reference\n",
+    "\n",
+    "For detailed documentation of all __ModuleName__Retriever features and configurations head to the [API reference](https://api.python.langchain.com/en/latest/retrievers/__module_name__.retrievers.__ModuleName__.__ModuleName__Retriever.html)."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/stores.ipynb

@@ -0,0 +1,204 @@
+{
+  "cells": [
+    {
+      "cell_type": "raw",
+      "metadata": {
+        "vscode": {
+          "languageId": "raw"
+        }
+      },
+      "source": [
+        "---\n",
+        "sidebar_label: __ModuleName__ByteStore\n",
+        "---"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# __ModuleName__ByteStore\n",
+        "\n",
+        "- TODO: Make sure API reference link is correct.\n",
+        "\n",
+        "This will help you get started with __ModuleName__ [key-value stores](/docs/concepts/#key-value-stores). For detailed documentation of all __ModuleName__ByteStore features and configurations head to the [API reference](https://python.langchain.com/v0.2/api_reference/core/stores/langchain_core.stores.__module_name__ByteStore.html).\n",
+        "\n",
+        "- TODO: Add any other relevant links, like information about models, prices, context windows, etc. See https://python.langchain.com/docs/integrations/stores/in_memory/ for an example.\n",
+        "\n",
+        "## Overview\n",
+        "\n",
+        "- TODO: (Optional) A short introduction to the underlying technology/API.\n",
+        "\n",
+        "### Integration details\n",
+        "\n",
+        "- TODO: Fill in table features.\n",
+        "- TODO: Remove JS support link if not relevant, otherwise ensure link is correct.\n",
+        "- TODO: Make sure API reference links are correct.\n",
+        "\n",
+        "| Class | Package | Local | [JS support](https://js.langchain.com/docs/integrations/stores/_package_name_) | Package downloads | Package latest |\n",
+        "| :--- | :--- | :---: | :---: |  :---: | :---: |\n",
+        "| [__ModuleName__ByteStore](https://api.python.langchain.com/en/latest/stores/__module_name__.stores.__ModuleName__ByteStore.html) | [__package_name__](https://api.python.langchain.com/en/latest/__package_name_short_snake___api_reference.html) | ✅/❌ | ✅/❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/__package_name__&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/__package_name__&label=%20) |\n",
+        "\n",
+        "## Setup\n",
+        "\n",
+        "- TODO: Update with relevant info.\n",
+        "\n",
+        "To create a __ModuleName__ byte store, you'll need to create a/an __ModuleName__ account, get an API key, and install the `__package_name__` integration package.\n",
+        "\n",
+        "### Credentials\n",
+        "\n",
+        "- TODO: Update with relevant info, or omit if the service does not require any credentials.\n",
+        "\n",
+        "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "if not os.getenv(\"__MODULE_NAME___API_KEY\"):\n",
+        "    os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+        "        \"Enter your __ModuleName__ API key: \"\n",
+        "    )"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "### Installation\n",
+        "\n",
+        "The LangChain __ModuleName__ integration lives in the `__package_name__` package:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "%pip install -qU __package_name__"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## Instantiation\n",
+        "\n",
+        "Now we can instantiate our byte store:\n",
+        "\n",
+        "- TODO: Update model instantiation with relevant params."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from __module_name__ import __ModuleName__ByteStore\n",
+        "\n",
+        "kv_store = __ModuleName__ByteStore(\n",
+        "    # params...\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## Usage\n",
+        "\n",
+        "- TODO: Run cells so output can be seen.\n",
+        "\n",
+        "You can set data under keys like this using the `mset` method:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "kv_store.mset(\n",
+        "    [\n",
+        "        [\"key1\", b\"value1\"],\n",
+        "        [\"key2\", b\"value2\"],\n",
+        "    ]\n",
+        ")\n",
+        "\n",
+        "kv_store.mget(\n",
+        "    [\n",
+        "        \"key1\",\n",
+        "        \"key2\",\n",
+        "    ]\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "And you can delete data using the `mdelete` method:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "kv_store.mdelete(\n",
+        "    [\n",
+        "        \"key1\",\n",
+        "        \"key2\",\n",
+        "    ]\n",
+        ")\n",
+        "\n",
+        "kv_store.mget(\n",
+        "    [\n",
+        "        \"key1\",\n",
+        "        \"key2\",\n",
+        "    ]\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## TODO: Any functionality specific to this key-value store provider\n",
+        "\n",
+        "E.g. extra initialization. Delete if not relevant."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all __ModuleName__ByteStore features and configurations, head to the API reference: https://api.python.langchain.com/en/latest/stores/__module_name__.stores.__ModuleName__ByteStore.html"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.10.5"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 2
+}

libs/cli/langchain_cli/integration_template/docs/text_embedding.ipynb

@@ -0,0 +1,246 @@
+{
+ "cells": [
+  {
+   "cell_type": "raw",
+   "id": "afaf8039",
+   "metadata": {},
+   "source": [
+    "---\n",
+    "sidebar_label: __ModuleName__\n",
+    "---"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9a3d6f34",
+   "metadata": {},
+   "source": [
+    "# __ModuleName__Embeddings\n",
+    "\n",
+    "- [ ] TODO: Make sure API reference link is correct\n",
+    "\n",
+    "This will help you get started with __ModuleName__ embedding models using LangChain. For detailed documentation on `__ModuleName__Embeddings` features and configuration options, please refer to the [API reference](https://python.langchain.com/v0.2/api_reference/__package_name_short__/embeddings/__module_name__.embeddings__ModuleName__Embeddings.html).\n",
+    "\n",
+    "## Overview\n",
+    "### Integration details\n",
+    "\n",
+    "| Provider | Package |\n",
+    "|:--------:|:-------:|\n",
+    "| [__ModuleName__](/docs/integrations/providers/__package_name_short__/) | [__package_name__](https://python.langchain.com/v0.2/api_reference/__module_name__/embeddings/__module_name__.embeddings__ModuleName__Embeddings.html) |\n",
+    "\n",
+    "## Setup\n",
+    "\n",
+    "- [ ] TODO: Update with relevant info.\n",
+    "\n",
+    "To access __ModuleName__ embedding models you'll need to create a/an __ModuleName__ account, get an API key, and install the `__package_name__` integration package.\n",
+    "\n",
+    "### Credentials\n",
+    "\n",
+    "- TODO: Update with relevant info.\n",
+    "\n",
+    "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "36521c2a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import getpass\n",
+    "import os\n",
+    "\n",
+    "if not os.getenv(\"__MODULE_NAME___API_KEY\"):\n",
+    "    os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+    "        \"Enter your __ModuleName__ API key: \"\n",
+    "    )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c84fb993",
+   "metadata": {},
+   "source": "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "39a4953b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# os.environ[\"LANGSMITH_TRACING\"] = \"true\"\n",
+    "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d9664366",
+   "metadata": {},
+   "source": [
+    "### Installation\n",
+    "\n",
+    "The LangChain __ModuleName__ integration lives in the `__package_name__` package:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "64853226",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install -qU __package_name__"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "45dd1724",
+   "metadata": {},
+   "source": [
+    "## Instantiation\n",
+    "\n",
+    "Now we can instantiate our model object and generate chat completions:\n",
+    "\n",
+    "- TODO: Update model instantiation with relevant params."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9ea7a09b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from __module_name__ import __ModuleName__Embeddings\n",
+    "\n",
+    "embeddings = __ModuleName__Embeddings(\n",
+    "    model=\"model-name\",\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "77d271b6",
+   "metadata": {},
+   "source": [
+    "## Indexing and Retrieval\n",
+    "\n",
+    "Embedding models are often used in retrieval-augmented generation (RAG) flows, both as part of indexing data as well as later retrieving it. For more detailed instructions, please see our [RAG tutorials](/docs/tutorials/).\n",
+    "\n",
+    "Below, see how to index and retrieve data using the `embeddings` object we initialized above. In this example, we will index and retrieve a sample document in the `InMemoryVectorStore`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d817716b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a vector store with a sample text\n",
+    "from langchain_core.vectorstores import InMemoryVectorStore\n",
+    "\n",
+    "text = \"LangChain is the framework for building context-aware reasoning applications\"\n",
+    "\n",
+    "vectorstore = InMemoryVectorStore.from_texts(\n",
+    "    [text],\n",
+    "    embedding=embeddings,\n",
+    ")\n",
+    "\n",
+    "# Use the vectorstore as a retriever\n",
+    "retriever = vectorstore.as_retriever()\n",
+    "\n",
+    "# Retrieve the most similar text\n",
+    "retrieved_documents = retriever.invoke(\"What is LangChain?\")\n",
+    "\n",
+    "# show the retrieved document's content\n",
+    "retrieved_documents[0].page_content"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e02b9855",
+   "metadata": {},
+   "source": [
+    "## Direct Usage\n",
+    "\n",
+    "Under the hood, the vectorstore and retriever implementations are calling `embeddings.embed_documents(...)` and `embeddings.embed_query(...)` to create embeddings for the text(s) used in `from_texts` and retrieval `invoke` operations, respectively.\n",
+    "\n",
+    "You can directly call these methods to get embeddings for your own use cases.\n",
+    "\n",
+    "### Embed single texts\n",
+    "\n",
+    "You can embed single texts or documents with `embed_query`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0d2befcd",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "single_vector = embeddings.embed_query(text)\n",
+    "print(str(single_vector)[:100])  # Show the first 100 characters of the vector"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b5a7d03",
+   "metadata": {},
+   "source": [
+    "### Embed multiple texts\n",
+    "\n",
+    "You can embed multiple texts with `embed_documents`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2f4d6e97",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "text2 = (\n",
+    "    \"LangGraph is a library for building stateful, multi-actor applications with LLMs\"\n",
+    ")\n",
+    "two_vectors = embeddings.embed_documents([text, text2])\n",
+    "for vector in two_vectors:\n",
+    "    print(str(vector)[:100])  # Show the first 100 characters of the vector"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "98785c12",
+   "metadata": {},
+   "source": [
+    "## API Reference\n",
+    "\n",
+    "For detailed documentation on `__ModuleName__Embeddings` features and configuration options, please refer to the [API reference](https://api.python.langchain.com/en/latest/embeddings/__module_name__.embeddings.__ModuleName__Embeddings.html).\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/toolkits.ipynb

@@ -0,0 +1,199 @@
+{
+  "cells": [
+    {
+      "cell_type": "raw",
+      "id": "afaf8039",
+      "metadata": {},
+      "source": [
+        "---\n",
+        "sidebar_label: __ModuleName__\n",
+        "---"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "e49f1e0d",
+      "metadata": {},
+      "source": [
+        "# __ModuleName__Toolkit\n",
+        "\n",
+        "- TODO: Make sure API reference link is correct.\n",
+        "\n",
+        "This will help you get started with the __ModuleName__ [toolkit](/docs/concepts/tools/#toolkits). For detailed documentation of all __ModuleName__Toolkit features and configurations head to the [API reference](https://api.python.langchain.com/en/latest/agent_toolkits/__module_name__.agent_toolkits.__ModuleName__.toolkit.__ModuleName__Toolkit.html).\n",
+        "\n",
+        "## Setup\n",
+        "\n",
+        "- TODO: Update with relevant info."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "72ee0c4b-9764-423a-9dbf-95129e185210",
+      "metadata": {},
+      "source": "To enable automated tracing of individual tools, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "a15d341e-3e26-4ca3-830b-5aab30ed66de",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")\n",
+        "# os.environ[\"LANGSMITH_TRACING\"] = \"true\""
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "0730d6a1-c893-4840-9817-5e5251676d5d",
+      "metadata": {},
+      "source": [
+        "### Installation\n",
+        "\n",
+        "This toolkit lives in the `__package_name__` package:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "652d6238-1f87-422a-b135-f5abbb8652fc",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "%pip install -qU __package_name__"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "a38cde65-254d-4219-a441-068766c0d4b5",
+      "metadata": {},
+      "source": [
+        "## Instantiation\n",
+        "\n",
+        "Now we can instantiate our toolkit:\n",
+        "\n",
+        "- TODO: Update model instantiation with relevant params."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from __module_name__ import __ModuleName__Toolkit\n",
+        "\n",
+        "toolkit = __ModuleName__Toolkit(\n",
+        "    # ...\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "5c5f2839-4020-424e-9fc9-07777eede442",
+      "metadata": {},
+      "source": [
+        "## Tools\n",
+        "\n",
+        "View available tools:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "51a60dbe-9f2e-4e04-bb62-23968f17164a",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "toolkit.get_tools()"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d11245ad-3661-4405-8558-1188896347ec",
+      "metadata": {},
+      "source": [
+        "TODO: list API reference pages for individual tools."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "dfe8aad4-8626-4330-98a9-7ea1ca5d2e0e",
+      "metadata": {},
+      "source": [
+        "## Use within an agent"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "310bf18e-6c9a-4072-b86e-47bc1fcca29d",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langgraph.prebuilt import create_react_agent\n",
+        "\n",
+        "agent_executor = create_react_agent(llm, tools)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "23e11cc9-abd6-4855-a7eb-799f45ca01ae",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "example_query = \"...\"\n",
+        "\n",
+        "events = agent_executor.stream(\n",
+        "    {\"messages\": [(\"user\", example_query)]},\n",
+        "    stream_mode=\"values\",\n",
+        ")\n",
+        "for event in events:\n",
+        "    event[\"messages\"][-1].pretty_print()"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d1ee55bc-ffc8-4cfa-801c-993953a08cfd",
+      "metadata": {},
+      "source": [
+        "## TODO: Any functionality or considerations specific to this toolkit\n",
+        "\n",
+        "Fill in or delete if not relevant."
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "3a5bb5ca-c3ae-4a58-be67-2cd18574b9a3",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all __ModuleName__Toolkit features and configurations head to the [API reference](https://api.python.langchain.com/en/latest/agent_toolkits/__module_name__.agent_toolkits.__ModuleName__.toolkit.__ModuleName__Toolkit.html)."
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3 (ipykernel)",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.4"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/tools.ipynb

@@ -0,0 +1,271 @@
+{
+  "cells": [
+    {
+      "cell_type": "raw",
+      "id": "10238e62-3465-4973-9279-606cbb7ccf16",
+      "metadata": {},
+      "source": [
+        "---\n",
+        "sidebar_label: __ModuleName__\n",
+        "---"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "a6f91f20",
+      "metadata": {},
+      "source": [
+        "# __ModuleName__\n",
+        "\n",
+        "- TODO: Make sure API reference link is correct.\n",
+        "\n",
+        "This notebook provides a quick overview for getting started with __ModuleName__ [tool](/docs/integrations/tools/). For detailed documentation of all __ModuleName__ features and configurations head to the [API reference](https://python.langchain.com/v0.2/api_reference/community/tools/langchain_community.tools.__module_name__.tool.__ModuleName__.html).\n",
+        "\n",
+        "- TODO: Add any other relevant links, like information about underlying API, etc.\n",
+        "\n",
+        "## Overview\n",
+        "\n",
+        "### Integration details\n",
+        "\n",
+        "- TODO: Make sure links and features are correct\n",
+        "\n",
+        "| Class | Package | Serializable | [JS support](https://js.langchain.com/docs/integrations/tools/__module_name__) |  Package latest |\n",
+        "| :--- | :--- | :---: | :---: | :---: |\n",
+        "| [__ModuleName__](https://python.langchain.com/v0.2/api_reference/community/tools/langchain_community.tools.__module_name__.tool.__ModuleName__.html) | [langchain-community](https://api.python.langchain.com/en/latest/community_api_reference.html) | beta/❌ | ✅/❌ |  ![PyPI - Version](https://img.shields.io/pypi/v/langchain-community&label=%20) |\n",
+        "\n",
+        "### Tool features\n",
+        "\n",
+        "- TODO: Add feature table if it makes sense\n",
+        "\n",
+        "\n",
+        "## Setup\n",
+        "\n",
+        "- TODO: Add any additional deps\n",
+        "\n",
+        "The integration lives in the `langchain-community` package."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "f85b4089",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "%pip install --quiet -U langchain-community"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "b15e9266",
+      "metadata": {},
+      "source": [
+        "### Credentials\n",
+        "\n",
+        "- TODO: Add any credentials that are needed"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "e0b178a2-8816-40ca-b57c-ccdd86dde9c9",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "# if not os.environ.get(\"__MODULE_NAME___API_KEY\"):\n",
+        "#     os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\"__MODULE_NAME__ API key:\\n\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "bc5ab717-fd27-4c59-b912-bdd099541478",
+      "metadata": {},
+      "source": [
+        "It's also helpful (but not needed) to set up [LangSmith](https://smith.langchain.com/) for best-in-class observability:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 3,
+      "id": "a6c2f136-6367-4f1f-825d-ae741e1bf281",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# os.environ[\"LANGSMITH_TRACING\"] = \"true\"\n",
+        "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass()"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "1c97218f-f366-479d-8bf7-fe9f2f6df73f",
+      "metadata": {},
+      "source": [
+        "## Instantiation\n",
+        "\n",
+        "- TODO: Fill in instantiation params\n",
+        "\n",
+        "Here we show how to instantiate an instance of the __ModuleName__ tool, with "
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 4,
+      "id": "8b3ddfe9-ca79-494c-a7ab-1f56d9407a64",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langchain_community.tools import __ModuleName__\n",
+        "\n",
+        "\n",
+        "tool = __ModuleName__(...)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "74147a1a",
+      "metadata": {},
+      "source": [
+        "## Invocation\n",
+        "\n",
+        "### [Invoke directly with args](/docs/concepts/tools/#use-the-tool-directly)\n",
+        "\n",
+        "- TODO: Describe what the tool args are, fill them in, run cell"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "65310a8b-eb0c-4d9e-a618-4f4abe2414fc",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "tool.invoke({...})"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d6e73897",
+      "metadata": {},
+      "source": [
+        "### [Invoke with ToolCall](/docs/concepts/tool_calling/#tool-execution)\n",
+        "\n",
+        "We can also invoke the tool with a model-generated ToolCall, in which case a ToolMessage will be returned:\n",
+        "\n",
+        "- TODO: Fill in tool args and run cell"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "f90e33a7",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# This is usually generated by a model, but we'll create a tool call directly for demo purposes.\n",
+        "model_generated_tool_call = {\n",
+        "    \"args\": {...},  # TODO: FILL IN\n",
+        "    \"id\": \"1\",\n",
+        "    \"name\": tool.name,\n",
+        "    \"type\": \"tool_call\",\n",
+        "}\n",
+        "tool.invoke(model_generated_tool_call)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "659f9fbd-6fcf-445f-aa8c-72d8e60154bd",
+      "metadata": {},
+      "source": [
+        "## Use within an agent\n",
+        "\n",
+        "- TODO: Add user question and run cells\n",
+        "\n",
+        "We can use our tool in an [agent](/docs/concepts/agents/). For this we will need a LLM with [tool-calling](/docs/how_to/tool_calling/) capabilities:\n",
+        "\n",
+        "import ChatModelTabs from \"@theme/ChatModelTabs\";\n",
+        "\n",
+        "<ChatModelTabs customVarName=\"llm\" />\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "af3123ad-7a02-40e5-b58e-7d56e23e5830",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# | output: false\n",
+        "# | echo: false\n",
+        "\n",
+        "# !pip install -qU langchain langchain-openai\n",
+        "from langchain.chat_models import init_chat_model\n",
+        "\n",
+        "model = init_chat_model(model=\"gpt-4o\", model_provider=\"openai\")"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "bea35fa1",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langgraph.prebuilt import create_react_agent\n",
+        "\n",
+        "tools = [tool]\n",
+        "agent = create_react_agent(model, tools)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "fdbf35b5-3aaf-4947-9ec6-48c21533fb95",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "example_query = \"...\"\n",
+        "\n",
+        "events = agent.stream(\n",
+        "    {\"messages\": [(\"user\", example_query)]},\n",
+        "    stream_mode=\"values\",\n",
+        ")\n",
+        "for event in events:\n",
+        "    event[\"messages\"][-1].pretty_print()"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "4ac8146c",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all __ModuleName__ features and configurations head to the API reference: https://python.langchain.com/v0.2/api_reference/community/tools/langchain_community.tools.__module_name__.tool.__ModuleName__.html"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "poetry-venv-311",
+      "language": "python",
+      "name": "poetry-venv-311"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.11.9"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/docs/vectorstores.ipynb

@@ -0,0 +1,333 @@
+{
+ "cells": [
+  {
+   "cell_type": "raw",
+   "id": "1957f5cb",
+   "metadata": {},
+   "source": [
+    "---\n",
+    "sidebar_label: __ModuleName__\n",
+    "---"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ef1f0986",
+   "metadata": {},
+   "source": [
+    "# __ModuleName__VectorStore\n",
+    "\n",
+    "This notebook covers how to get started with the __ModuleName__ vector store."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "36fdc060",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "- TODO: Update with relevant info.\n",
+    "- TODO: Update minimum version to be correct.\n",
+    "\n",
+    "To access __ModuleName__ vector stores you'll need to create a/an __ModuleName__ account, get an API key, and install the `__package_name__` integration package."
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "id": "64e28aa6",
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
+   "source": [
+    "%pip install -qU \"__package_name__>=MINIMUM_VERSION\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9695dee7",
+   "metadata": {},
+   "source": [
+    "### Credentials\n",
+    "\n",
+    "- TODO: Update with relevant info.\n",
+    "\n",
+    "Head to (TODO: link) to sign up to __ModuleName__ and generate an API key. Once you've done this set the __MODULE_NAME___API_KEY environment variable:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "894c30e4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import getpass\n",
+    "import os\n",
+    "\n",
+    "if not os.getenv(\"__MODULE_NAME___API_KEY\"):\n",
+    "    os.environ[\"__MODULE_NAME___API_KEY\"] = getpass.getpass(\n",
+    "        \"Enter your __ModuleName__ API key: \"\n",
+    "    )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7f98392b",
+   "metadata": {},
+   "source": "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e7b6a6e0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")\n",
+    "# os.environ[\"LANGSMITH_TRACING\"] = \"true\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "93df377e",
+   "metadata": {},
+   "source": [
+    "## Initialization\n",
+    "\n",
+    "- TODO: Fill out with relevant init params\n",
+    "\n",
+    "\n",
+    "```{=mdx}\n",
+    "import EmbeddingTabs from \"@theme/EmbeddingTabs\";\n",
+    "\n",
+    "<EmbeddingTabs/>\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "dc37144c-208d-4ab3-9f3a-0407a69fe052",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "from __module_name__.vectorstores import __ModuleName__VectorStore\n",
+    "\n",
+    "vector_store = __ModuleName__VectorStore(embeddings=embeddings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac6071d4",
+   "metadata": {},
+   "source": [
+    "## Manage vector store\n",
+    "\n",
+    "### Add items to vector store\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "17f5efc0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain_core.documents import Document\n",
+    "\n",
+    "document_1 = Document(page_content=\"foo\", metadata={\"source\": \"https://example.com\"})\n",
+    "\n",
+    "document_2 = Document(page_content=\"bar\", metadata={\"source\": \"https://example.com\"})\n",
+    "\n",
+    "document_3 = Document(page_content=\"baz\", metadata={\"source\": \"https://example.com\"})\n",
+    "\n",
+    "documents = [document_1, document_2, document_3]\n",
+    "\n",
+    "vector_store.add_documents(documents=documents, ids=[\"1\", \"2\", \"3\"])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c738c3e0",
+   "metadata": {},
+   "source": [
+    "### Update items in vector store\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f0aa8b71",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "updated_document = Document(\n",
+    "    page_content=\"qux\", metadata={\"source\": \"https://another-example.com\"}\n",
+    ")\n",
+    "\n",
+    "vector_store.update_documents(document_id=\"1\", document=updated_document)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dcf1b905",
+   "metadata": {},
+   "source": [
+    "### Delete items from vector store\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ef61e188",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vector_store.delete(ids=[\"3\"])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c3620501",
+   "metadata": {},
+   "source": [
+    "## Query vector store\n",
+    "\n",
+    "Once your vector store has been created and the relevant documents have been added you will most likely wish to query it during the running of your chain or agent.\n",
+    "\n",
+    "### Query directly\n",
+    "\n",
+    "Performing a simple similarity search can be done as follows:\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "aa0a16fa",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results = vector_store.similarity_search(\n",
+    "    query=\"thud\", k=1, filter={\"source\": \"https://another-example.com\"}\n",
+    ")\n",
+    "for doc in results:\n",
+    "    print(f\"* {doc.page_content} [{doc.metadata}]\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3ed9d733",
+   "metadata": {},
+   "source": [
+    "If you want to execute a similarity search and receive the corresponding scores you can run:\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5efd2eaa",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results = vector_store.similarity_search_with_score(\n",
+    "    query=\"thud\", k=1, filter={\"source\": \"https://example.com\"}\n",
+    ")\n",
+    "for doc, score in results:\n",
+    "    print(f\"* [SIM={score:3f}] {doc.page_content} [{doc.metadata}]\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0c235cdc",
+   "metadata": {},
+   "source": [
+    "### Query by turning into retriever\n",
+    "\n",
+    "You can also transform the vector store into a retriever for easier usage in your chains.\n",
+    "\n",
+    "- TODO: Edit and then run code cell to generate output"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f3460093",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "retriever = vector_store.as_retriever(search_type=\"mmr\", search_kwargs={\"k\": 1})\n",
+    "retriever.invoke(\"thud\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "901c75dc",
+   "metadata": {},
+   "source": [
+    "## Usage for retrieval-augmented generation\n",
+    "\n",
+    "For guides on how to use this vector store for retrieval-augmented generation (RAG), see the following sections:\n",
+    "\n",
+    "- [Tutorials](/docs/tutorials/)\n",
+    "- [How-to: Question and answer with RAG](https://python.langchain.com/docs/how_to/#qa-with-rag)\n",
+    "- [Retrieval conceptual docs](https://python.langchain.com/docs/concepts/retrieval/)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "069f1b5f",
+   "metadata": {},
+   "source": [
+    "## TODO: Any functionality specific to this vector store\n",
+    "\n",
+    "E.g. creating a persistent database to save to your disk, etc."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8a27244f",
+   "metadata": {},
+   "source": [
+    "## API reference\n",
+    "\n",
+    "For detailed documentation of all __ModuleName__VectorStore features and configurations head to the API reference: https://api.python.langchain.com/en/latest/vectorstores/__module_name__.vectorstores.__ModuleName__VectorStore.html"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

libs/cli/langchain_cli/integration_template/integration_template/__init__.py

@@ -0,0 +1,27 @@
+from importlib import metadata
+
+from __module_name__.chat_models import Chat__ModuleName__
+from __module_name__.document_loaders import __ModuleName__Loader
+from __module_name__.embeddings import __ModuleName__Embeddings
+from __module_name__.retrievers import __ModuleName__Retriever
+from __module_name__.toolkits import __ModuleName__Toolkit
+from __module_name__.tools import __ModuleName__Tool
+from __module_name__.vectorstores import __ModuleName__VectorStore
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+del metadata  # optional, avoids polluting the results of dir(__package__)
+
+__all__ = [
+    "Chat__ModuleName__",
+    "__ModuleName__VectorStore",
+    "__ModuleName__Embeddings",
+    "__ModuleName__Loader",
+    "__ModuleName__Retriever",
+    "__ModuleName__Toolkit",
+    "__ModuleName__Tool",
+    "__version__",
+]

libs/cli/langchain_cli/integration_template/integration_template/chat_models.py

@@ -0,0 +1,423 @@
+"""__ModuleName__ chat models."""
+
+from typing import Any, Dict, Iterator, List
+
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+)
+from langchain_core.messages.ai import UsageMetadata
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from pydantic import Field
+
+
+class Chat__ModuleName__(BaseChatModel):
+    # TODO: Replace all TODOs in docstring. See example docstring:
+    # https://github.com/langchain-ai/langchain/blob/7ff05357bac6eaedf5058a2af88f23a1817d40fe/libs/partners/openai/langchain_openai/chat_models/base.py#L1120
+    """__ModuleName__ chat model integration.
+
+    The default implementation echoes the first `parrot_buffer_length` characters of
+    the input.
+
+    # TODO: Replace with relevant packages, env vars.
+    Setup:
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Populate with relevant params.
+    Key init args — completion params:
+        model:
+            Name of __ModuleName__ model to use.
+        temperature:
+            Sampling temperature.
+        max_tokens:
+            Max number of tokens to generate.
+
+    # TODO: Populate with relevant params.
+    Key init args — client params:
+        timeout:
+            Timeout for requests.
+        max_retries:
+            Max number of retries.
+        api_key:
+            __ModuleName__ API key. If not passed in will be read from env var
+            __MODULE_NAME___API_KEY.
+
+    See full list of supported init args and their descriptions in the params section.
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from __module_name__ import Chat__ModuleName__
+
+        model = Chat__ModuleName__(
+            model="...",
+            temperature=0,
+            max_tokens=None,
+            timeout=None,
+            max_retries=2,
+            # api_key="...",
+            # other params...
+        )
+        ```
+
+    Invoke:
+        ```python
+        messages = [
+            ("system", "You are a helpful translator. Translate the user sentence to French."),
+            ("human", "I love programming."),
+        ]
+        model.invoke(messages)
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if token-level streaming isn't supported.
+    Stream:
+        ```python
+        for chunk in model.stream(messages):
+            print(chunk.text, end="")
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+        ```python
+        stream = model.stream(messages)
+        full = next(stream)
+        for chunk in stream:
+            full += chunk
+        full
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if native async isn't supported.
+    Async:
+        ```python
+        await model.ainvoke(messages)
+
+        # stream:
+        # async for chunk in (await model.astream(messages))
+
+        # batch:
+        # await model.abatch([messages])
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+    # TODO: Delete if .bind_tools() isn't supported.
+    Tool calling:
+        ```python
+        from pydantic import BaseModel, Field
+
+        class GetWeather(BaseModel):
+            '''Get the current weather in a given location'''
+
+            location: str = Field(..., description="The city and state, e.g. San Francisco, CA")
+
+        class GetPopulation(BaseModel):
+            '''Get the current population in a given location'''
+
+            location: str = Field(..., description="The city and state, e.g. San Francisco, CA")
+
+        model_with_tools = model.bind_tools([GetWeather, GetPopulation])
+        ai_msg = model_with_tools.invoke("Which city is hotter today and which is bigger: LA or NY?")
+        ai_msg.tool_calls
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+        See `Chat__ModuleName__.bind_tools()` method for more.
+
+    # TODO: Delete if .with_structured_output() isn't supported.
+    Structured output:
+        ```python
+        from typing import Optional
+
+        from pydantic import BaseModel, Field
+
+        class Joke(BaseModel):
+            '''Joke to tell user.'''
+
+            setup: str = Field(description="The setup of the joke")
+            punchline: str = Field(description="The punchline to the joke")
+            rating: int | None = Field(description="How funny the joke is, from 1 to 10")
+
+        structured_model = model.with_structured_output(Joke)
+        structured_model.invoke("Tell me a joke about cats")
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+        See `Chat__ModuleName__.with_structured_output()` for more.
+
+    # TODO: Delete if JSON mode response format isn't supported.
+    JSON mode:
+        ```python
+        # TODO: Replace with appropriate bind arg.
+        json_model = model.bind(response_format={"type": "json_object"})
+        ai_msg = json_model.invoke("Return a JSON object with key 'random_ints' and a value of 10 random ints in [0-99]")
+        ai_msg.content
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if image inputs aren't supported.
+    Image input:
+        ```python
+        import base64
+        import httpx
+        from langchain_core.messages import HumanMessage
+
+        image_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
+        image_data = base64.b64encode(httpx.get(image_url).content).decode("utf-8")
+        # TODO: Replace with appropriate message content format.
+        message = HumanMessage(
+            content=[
+                {"type": "text", "text": "describe the weather in this image"},
+                {
+                    "type": "image_url",
+                    "image_url": {"url": f"data:image/jpeg;base64,{image_data}"},
+                },
+            ],
+        )
+        ai_msg = model.invoke([message])
+        ai_msg.content
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if audio inputs aren't supported.
+    Audio input:
+        ```python
+        # TODO: Example input
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Delete if video inputs aren't supported.
+    Video input:
+        ```python
+        # TODO: Example input
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Delete if token usage metadata isn't supported.
+    Token usage:
+        ```python
+        ai_msg = model.invoke(messages)
+        ai_msg.usage_metadata
+        ```
+
+        ```python
+        {'input_tokens': 28, 'output_tokens': 5, 'total_tokens': 33}
+        ```
+
+    # TODO: Delete if logprobs aren't supported.
+    Logprobs:
+        ```python
+        # TODO: Replace with appropriate bind arg.
+        logprobs_model = model.bind(logprobs=True)
+        ai_msg = logprobs_model.invoke(messages)
+        ai_msg.response_metadata["logprobs"]
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+    Response metadata
+        ```python
+        ai_msg = model.invoke(messages)
+        ai_msg.response_metadata
+        ```
+
+        ```python
+        # TODO: Example output.
+
+        ```
+    """  # noqa: E501
+
+    model_name: str = Field(alias="model")
+    """The name of the model"""
+    parrot_buffer_length: int
+    """The number of characters from the last message of the prompt to be echoed."""
+    temperature: float | None = None
+    max_tokens: int | None = None
+    timeout: int | None = None
+    stop: list[str] | None = None
+    max_retries: int = 2
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "chat-__package_name_short__"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Return a dictionary of identifying parameters.
+
+        This information is used by the LangChain callback system, which
+        is used for tracing purposes make it possible to monitor LLMs.
+        """
+        return {
+            # The model name allows users to specify custom token counting
+            # rules in LLM monitoring applications (e.g., in LangSmith users
+            # can provide per token pricing for their model and monitor
+            # costs for the given LLM.)
+            "model_name": self.model_name,
+        }
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: list[str] | None = None,
+        run_manager: CallbackManagerForLLMRun | None = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Override the _generate method to implement the chat model logic.
+
+        This can be a call to an API, a call to a local model, or any other
+        implementation that generates a response to the input prompt.
+
+        Args:
+            messages: the prompt composed of a list of messages.
+            stop: a list of strings on which the model should stop generating.
+                If generation stops due to a stop token, the stop token itself
+                SHOULD BE INCLUDED as part of the output. This is not enforced
+                across models right now, but it's a good practice to follow since
+                it makes it much easier to parse the output of the model
+                downstream and understand why generation stopped.
+            run_manager: A run manager with callbacks for the LLM.
+        """
+        # Replace this with actual logic to generate a response from a list
+        # of messages.
+        last_message = messages[-1]
+        tokens = last_message.content[: self.parrot_buffer_length]
+        ct_input_tokens = sum(len(message.content) for message in messages)
+        ct_output_tokens = len(tokens)
+        message = AIMessage(
+            content=tokens,
+            additional_kwargs={},  # Used to add additional payload to the message
+            response_metadata={  # Use for response metadata
+                "time_in_seconds": 3,
+                "model_name": self.model_name,
+            },
+            usage_metadata={
+                "input_tokens": ct_input_tokens,
+                "output_tokens": ct_output_tokens,
+                "total_tokens": ct_input_tokens + ct_output_tokens,
+            },
+        )
+        ##
+
+        generation = ChatGeneration(message=message)
+        return ChatResult(generations=[generation])
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: list[str] | None = None,
+        run_manager: CallbackManagerForLLMRun | None = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        """Stream the output of the model.
+
+        This method should be implemented if the model can generate output
+        in a streaming fashion. If the model does not support streaming,
+        do not implement it. In that case streaming requests will be automatically
+        handled by the _generate method.
+
+        Args:
+            messages: the prompt composed of a list of messages.
+            stop: a list of strings on which the model should stop generating.
+                If generation stops due to a stop token, the stop token itself
+                SHOULD BE INCLUDED as part of the output. This is not enforced
+                across models right now, but it's a good practice to follow since
+                it makes it much easier to parse the output of the model
+                downstream and understand why generation stopped.
+            run_manager: A run manager with callbacks for the LLM.
+        """
+        last_message = messages[-1]
+        tokens = str(last_message.content[: self.parrot_buffer_length])
+        ct_input_tokens = sum(len(message.content) for message in messages)
+
+        for token in tokens:
+            usage_metadata = UsageMetadata(
+                {
+                    "input_tokens": ct_input_tokens,
+                    "output_tokens": 1,
+                    "total_tokens": ct_input_tokens + 1,
+                }
+            )
+            ct_input_tokens = 0
+            chunk = ChatGenerationChunk(
+                message=AIMessageChunk(content=token, usage_metadata=usage_metadata)
+            )
+
+            if run_manager:
+                # This is optional in newer versions of LangChain
+                # The on_llm_new_token will be called automatically
+                run_manager.on_llm_new_token(token, chunk=chunk)
+
+            yield chunk
+
+        # Let's add some other information (e.g., response metadata)
+        chunk = ChatGenerationChunk(
+            message=AIMessageChunk(
+                content="",
+                response_metadata={"time_in_sec": 3, "model_name": self.model_name},
+            )
+        )
+        if run_manager:
+            # This is optional in newer versions of LangChain
+            # The on_llm_new_token will be called automatically
+            run_manager.on_llm_new_token(token, chunk=chunk)
+        yield chunk
+
+    # TODO: Implement if Chat__ModuleName__ supports async streaming. Otherwise delete.
+    # async def _astream(
+    #     self,
+    #     messages: List[BaseMessage],
+    #     stop: list[str] | None = None,
+    #     run_manager: AsyncCallbackManagerForLLMRun | None = None,
+    #     **kwargs: Any,
+    # ) -> AsyncIterator[ChatGenerationChunk]:
+
+    # TODO: Implement if Chat__ModuleName__ supports async generation. Otherwise delete.
+    # async def _agenerate(
+    #     self,
+    #     messages: List[BaseMessage],
+    #     stop: list[str] | None = None,
+    #     run_manager: AsyncCallbackManagerForLLMRun | None = None,
+    #     **kwargs: Any,
+    # ) -> ChatResult:

libs/cli/langchain_cli/integration_template/integration_template/document_loaders.py

@@ -0,0 +1,74 @@
+"""__ModuleName__ document loader."""
+
+from typing import Iterator
+
+from langchain_core.document_loaders.base import BaseLoader
+from langchain_core.documents import Document
+
+
+class __ModuleName__Loader(BaseLoader):
+    # TODO: Replace all TODOs in docstring. See example docstring:
+    # https://github.com/langchain-ai/langchain/blob/869523ad728e6b76d77f170cce13925b4ebc3c1e/libs/community/langchain_community/document_loaders/recursive_url_loader.py#L54
+    """
+    __ModuleName__ document loader integration
+
+    # TODO: Replace with relevant packages, env vars.
+    Setup:
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from langchain_community.document_loaders import __ModuleName__Loader
+
+        loader = __ModuleName__Loader(
+            # required params = ...
+            # other params = ...
+        )
+        ```
+
+    Lazy load:
+        ```python
+        docs = []
+        docs_lazy = loader.lazy_load()
+
+        # async variant:
+        # docs_lazy = await loader.alazy_load()
+
+        for doc in docs_lazy:
+            docs.append(doc)
+        print(docs[0].page_content[:100])
+        print(docs[0].metadata)
+        ```
+
+        ```python
+        TODO: Example output
+        ```
+
+    # TODO: Delete if async load is not implemented
+    Async load:
+        ```python
+        docs = await loader.aload()
+        print(docs[0].page_content[:100])
+        print(docs[0].metadata)
+        ```
+
+        ```python
+        TODO: Example output
+
+        ```
+    """
+
+    # TODO: This method must be implemented to load documents.
+    # Do not implement load(), a default implementation is already available.
+    def lazy_load(self) -> Iterator[Document]:
+        raise NotImplementedError()
+
+    # TODO: Implement if you would like to change default BaseLoader implementation
+    # async def alazy_load(self) -> AsyncIterator[Document]:

libs/cli/langchain_cli/integration_template/integration_template/embeddings.py

@@ -0,0 +1,96 @@
+from typing import List
+
+from langchain_core.embeddings import Embeddings
+
+
+class __ModuleName__Embeddings(Embeddings):
+    """__ModuleName__ embedding model integration.
+
+    # TODO: Replace with relevant packages, env vars.
+    Setup:
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Populate with relevant params.
+    Key init args — completion params:
+        model: str
+            Name of __ModuleName__ model to use.
+
+    See full list of supported init args and their descriptions in the params section.
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from __module_name__ import __ModuleName__Embeddings
+
+        embed = __ModuleName__Embeddings(
+            model="...",
+            # api_key="...",
+            # other params...
+        )
+        ```
+
+    Embed single text:
+        ```python
+        input_text = "The meaning of life is 42"
+        embed.embed_query(input_text)
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if token-level streaming isn't supported.
+    Embed multiple text:
+        ```python
+        input_texts = ["Document 1...", "Document 2..."]
+        embed.embed_documents(input_texts)
+        ```
+
+        ```python
+        # TODO: Example output.
+        ```
+
+    # TODO: Delete if native async isn't supported.
+    Async:
+        ```python
+        await embed.aembed_query(input_text)
+
+        # multiple:
+        # await embed.aembed_documents(input_texts)
+        ```
+
+        ```python
+        # TODO: Example output.
+
+        ```
+    """
+
+    def __init__(self, model: str):
+        self.model = model
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed search docs."""
+        return [[0.5, 0.6, 0.7] for _ in texts]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text."""
+        return self.embed_documents([text])[0]
+
+    # optional: add custom async implementations here
+    # you can also delete these, and the base class will
+    # use the default implementation, which calls the sync
+    # version in an async executor:
+
+    # async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+    #     """Asynchronous Embed search docs."""
+    #     ...
+
+    # async def aembed_query(self, text: str) -> List[float]:
+    #     """Asynchronous Embed query text."""
+    #     ...

libs/cli/langchain_cli/integration_template/integration_template/retrievers.py

@@ -0,0 +1,107 @@
+"""__ModuleName__ retrievers."""
+
+from typing import Any, List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class __ModuleName__Retriever(BaseRetriever):
+    # TODO: Replace all TODOs in docstring. See example docstring:
+    # https://github.com/langchain-ai/langchain/blob/master/libs/community/langchain_community/retrievers/tavily_search_api.py#L17
+    """__ModuleName__ retriever.
+
+    # TODO: Replace with relevant packages, env vars, etc.
+    Setup:
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Populate with relevant params.
+    Key init args:
+        arg 1: type
+            description
+        arg 2: type
+            description
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from __package_name__ import __ModuleName__Retriever
+
+        retriever = __ModuleName__Retriever(
+            # ...
+        )
+        ```
+
+    Usage:
+        ```python
+        query = "..."
+
+        retriever.invoke(query)
+        ```
+
+        ```txt
+        # TODO: Example output.
+        ```
+
+    Use within a chain:
+        ```python
+        from langchain_core.output_parsers import StrOutputParser
+        from langchain_core.prompts import ChatPromptTemplate
+        from langchain_core.runnables import RunnablePassthrough
+        from langchain_openai import ChatOpenAI
+
+        prompt = ChatPromptTemplate.from_template(
+            \"\"\"Answer the question based only on the context provided.
+
+        Context: {context}
+
+        Question: {question}\"\"\"
+        )
+
+        model = ChatOpenAI(model="gpt-3.5-turbo-0125")
+
+        def format_docs(docs):
+            return "\\n\\n".join(doc.page_content for doc in docs)
+
+        chain = (
+            {"context": retriever | format_docs, "question": RunnablePassthrough()}
+            | prompt
+            | model
+            | StrOutputParser()
+        )
+
+        chain.invoke("...")
+        ```
+
+        ```
+        # TODO: Example output.
+        ```
+
+    """
+
+    k: int = 3
+
+    # TODO: This method must be implemented to retrieve documents.
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun, **kwargs: Any
+    ) -> List[Document]:
+        k = kwargs.get("k", self.k)
+        return [
+            Document(page_content=f"Result {i} for query: {query}") for i in range(k)
+        ]
+
+    # optional: add custom async implementations here
+    # async def _aget_relevant_documents(
+    #     self,
+    #     query: str,
+    #     *,
+    #     run_manager: AsyncCallbackManagerForRetrieverRun,
+    #     **kwargs: Any,
+    # ) -> List[Document]: ...

libs/cli/langchain_cli/integration_template/integration_template/toolkits.py

@@ -0,0 +1,73 @@
+"""__ModuleName__ toolkits."""
+
+from typing import List
+
+from langchain_core.tools import BaseTool, BaseToolkit
+
+
+class __ModuleName__Toolkit(BaseToolkit):
+    # TODO: Replace all TODOs in docstring. See example docstring:
+    # https://github.com/langchain-ai/langchain/blob/c123cb2b304f52ab65db4714eeec46af69a861ec/libs/community/langchain_community/agent_toolkits/sql/toolkit.py#L19
+    """__ModuleName__ toolkit.
+
+    # TODO: Replace with relevant packages, env vars, etc.
+    Setup:
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Populate with relevant params.
+    Key init args:
+        arg 1: type
+            description
+        arg 2: type
+            description
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from __package_name__ import __ModuleName__Toolkit
+
+        toolkit = __ModuleName__Toolkit(
+            # ...
+        )
+        ```
+
+    Tools:
+        ```python
+        toolkit.get_tools()
+        ```
+
+        ```txt
+        # TODO: Example output.
+        ```
+
+    Use within an agent:
+        ```python
+        from langgraph.prebuilt import create_react_agent
+
+        agent_executor = create_react_agent(llm, tools)
+
+        example_query = "..."
+
+        events = agent_executor.stream(
+            {"messages": [("user", example_query)]},
+            stream_mode="values",
+        )
+        for event in events:
+            event["messages"][-1].pretty_print()
+        ```
+
+        ```txt
+        # TODO: Example output.
+        ```
+
+    """
+
+    # TODO: This method must be implemented to list tools.
+    def get_tools(self) -> List[BaseTool]:
+        raise NotImplementedError()

libs/cli/langchain_cli/integration_template/integration_template/tools.py

@@ -0,0 +1,95 @@
+"""__ModuleName__ tools."""
+
+from typing import Type
+
+from langchain_core.callbacks import (
+    CallbackManagerForToolRun,
+)
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel, Field
+
+
+class __ModuleName__ToolInput(BaseModel):
+    """Input schema for __ModuleName__ tool.
+
+    This docstring is **not** part of what is sent to the model when performing tool
+    calling. The Field default values and descriptions **are** part of what is sent to
+    the model when performing tool calling.
+    """
+
+    # TODO: Add input args and descriptions.
+    a: int = Field(..., description="first number to add")
+    b: int = Field(..., description="second number to add")
+
+
+class __ModuleName__Tool(BaseTool):  # type: ignore[override]
+    """__ModuleName__ tool.
+
+    Setup:
+        # TODO: Replace with relevant packages, env vars.
+        Install `__package_name__` and set environment variable
+        `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    Instantiation:
+        ```python
+        tool = __ModuleName__Tool(
+            # TODO: init params
+        )
+        ```
+
+    Invocation with args:
+        ```python
+        # TODO: invoke args
+        tool.invoke({...})
+        ```
+
+        ```python
+        # TODO: output of invocation
+        ```
+
+    Invocation with ToolCall:
+
+        ```python
+        # TODO: invoke args
+        tool.invoke({"args": {...}, "id": "1", "name": tool.name, "type": "tool_call"})
+        ```
+
+        ```python
+        # TODO: output of invocation
+
+        ```
+    """  # noqa: E501
+
+    # TODO: Set tool name and description
+    name: str = "TODO: Tool name"
+    """The name that is passed to the model when performing tool calling."""
+    description: str = "TODO: Tool description."
+    """The description that is passed to the model when performing tool calling."""
+    args_schema: Type[BaseModel] = __ModuleName__ToolInput
+    """The schema that is passed to the model when performing tool calling."""
+
+    # TODO: Add any other init params for the tool.
+    # param1: str | None
+    # """param1 determines foobar"""
+
+    # TODO: Replaced (a, b) with real tool arguments.
+    def _run(
+        self, a: int, b: int, *, run_manager: CallbackManagerForToolRun | None = None
+    ) -> str:
+        return str(a + b + 80)
+
+    # TODO: Implement if tool has native async functionality, otherwise delete.
+
+    # async def _arun(
+    #     self,
+    #     a: int,
+    #     b: int,
+    #     *,
+    #     run_manager: AsyncCallbackManagerForToolRun | None = None,
+    # ) -> str:
+    #     ...

libs/cli/langchain_cli/integration_template/integration_template/vectorstores.py

@@ -0,0 +1,438 @@
+"""__ModuleName__ vector stores."""
+
+from __future__ import annotations
+
+import uuid
+from typing import (
+    Any,
+    Callable,
+    Iterator,
+    List,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+from langchain_core.vectorstores.utils import _cosine_similarity as cosine_similarity
+
+VST = TypeVar("VST", bound=VectorStore)
+
+
+class __ModuleName__VectorStore(VectorStore):
+    # TODO: Replace all TODOs in docstring.
+    """__ModuleName__ vector store integration.
+
+    # TODO: Replace with relevant packages, env vars.
+    Setup:
+        Install `__package_name__` and set environment variable `__MODULE_NAME___API_KEY`.
+
+        ```bash
+        pip install -U __package_name__
+        export __MODULE_NAME___API_KEY="your-api-key"
+        ```
+
+    # TODO: Populate with relevant params.
+    Key init args — indexing params:
+        collection_name:
+            Name of the collection.
+        embedding_function:
+            Embedding function to use.
+
+    # TODO: Populate with relevant params.
+    Key init args — client params:
+        client:
+            Client to use.
+        connection_args:
+            Connection arguments.
+
+    # TODO: Replace with relevant init params.
+    Instantiate:
+        ```python
+        from __module_name__.vectorstores import __ModuleName__VectorStore
+        from langchain_openai import OpenAIEmbeddings
+
+        vector_store = __ModuleName__VectorStore(
+            collection_name="foo",
+            embedding_function=OpenAIEmbeddings(),
+            connection_args={"uri": "./foo.db"},
+            # other params...
+        )
+        ```
+
+    # TODO: Populate with relevant variables.
+    Add Documents:
+        ```python
+        from langchain_core.documents import Document
+
+        document_1 = Document(page_content="foo", metadata={"baz": "bar"})
+        document_2 = Document(page_content="thud", metadata={"bar": "baz"})
+        document_3 = Document(page_content="i will be deleted :(")
+
+        documents = [document_1, document_2, document_3]
+        ids = ["1", "2", "3"]
+        vector_store.add_documents(documents=documents, ids=ids)
+        ```
+
+    # TODO: Populate with relevant variables.
+    Delete Documents:
+        ```python
+        vector_store.delete(ids=["3"])
+        ```
+
+    # TODO: Fill out with relevant variables and example output.
+    Search:
+        ```python
+        results = vector_store.similarity_search(query="thud",k=1)
+        for doc in results:
+            print(f"* {doc.page_content} [{doc.metadata}]")
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Fill out with relevant variables and example output.
+    Search with filter:
+        ```python
+        results = vector_store.similarity_search(query="thud",k=1,filter={"bar": "baz"})
+        for doc in results:
+            print(f"* {doc.page_content} [{doc.metadata}]")
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Fill out with relevant variables and example output.
+    Search with score:
+        ```python
+        results = vector_store.similarity_search_with_score(query="qux",k=1)
+        for doc, score in results:
+            print(f"* [SIM={score:3f}] {doc.page_content} [{doc.metadata}]")
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Fill out with relevant variables and example output.
+    Async:
+        ```python
+        # add documents
+        # await vector_store.aadd_documents(documents=documents, ids=ids)
+
+        # delete documents
+        # await vector_store.adelete(ids=["3"])
+
+        # search
+        # results = vector_store.asimilarity_search(query="thud",k=1)
+
+        # search with score
+        results = await vector_store.asimilarity_search_with_score(query="qux",k=1)
+        for doc,score in results:
+            print(f"* [SIM={score:3f}] {doc.page_content} [{doc.metadata}]")
+        ```
+
+        ```python
+        # TODO: Example output
+        ```
+
+    # TODO: Fill out with relevant variables and example output.
+    Use as Retriever:
+        ```python
+        retriever = vector_store.as_retriever(
+            search_type="mmr",
+            search_kwargs={"k": 1, "fetch_k": 2, "lambda_mult": 0.5},
+        )
+        retriever.invoke("thud")
+        ```
+
+        ```python
+        # TODO: Example output
+
+        ```
+    """  # noqa: E501
+
+    def __init__(self, embedding: Embeddings) -> None:
+        """Initialize with the given embedding function.
+
+        Args:
+            embedding: embedding function to use.
+        """
+        self._database: dict[str, dict[str, Any]] = {}
+        self.embedding = embedding
+
+    @classmethod
+    def from_texts(
+        cls: Type[__ModuleName__VectorStore],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: list[dict] | None = None,
+        **kwargs: Any,
+    ) -> __ModuleName__VectorStore:
+        store = cls(
+            embedding=embedding,
+        )
+        store.add_texts(texts=texts, metadatas=metadatas, **kwargs)
+        return store
+
+    # optional: add custom async implementations
+    # @classmethod
+    # async def afrom_texts(
+    #     cls: Type[VST],
+    #     texts: List[str],
+    #     embedding: Embeddings,
+    #     metadatas: list[dict] | None = None,
+    #     **kwargs: Any,
+    # ) -> VST:
+    #     return await asyncio.get_running_loop().run_in_executor(
+    #         None, partial(cls.from_texts, **kwargs), texts, embedding, metadatas
+    #     )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def add_documents(
+        self,
+        documents: List[Document],
+        ids: list[str] | None = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add documents to the store."""
+        texts = [doc.page_content for doc in documents]
+        vectors = self.embedding.embed_documents(texts)
+
+        if ids and len(ids) != len(texts):
+            msg = (
+                f"ids must be the same length as texts. "
+                f"Got {len(ids)} ids and {len(texts)} texts."
+            )
+            raise ValueError(msg)
+
+        id_iterator: Iterator[str | None] = (
+            iter(ids) if ids else iter(doc.id for doc in documents)
+        )
+
+        ids_ = []
+
+        for doc, vector in zip(documents, vectors):
+            doc_id = next(id_iterator)
+            doc_id_ = doc_id if doc_id else str(uuid.uuid4())
+            ids_.append(doc_id_)
+            self._database[doc_id_] = {
+                "id": doc_id_,
+                "vector": vector,
+                "text": doc.page_content,
+                "metadata": doc.metadata,
+            }
+
+        return ids_
+
+    # optional: add custom async implementations
+    # async def aadd_documents(
+    #     self,
+    #     documents: List[Document],
+    #     ids: list[str] | None = None,
+    #     **kwargs: Any,
+    # ) -> List[str]:
+    #     raise NotImplementedError
+
+    def delete(self, ids: list[str] | None = None, **kwargs: Any) -> None:
+        if ids:
+            for _id in ids:
+                self._database.pop(_id, None)
+
+    # optional: add custom async implementations
+    # async def adelete(
+    #     self, ids: list[str] | None = None, **kwargs: Any
+    # ) -> None:
+    #     raise NotImplementedError
+
+    def get_by_ids(self, ids: Sequence[str], /) -> list[Document]:
+        """Get documents by their ids.
+
+        Args:
+            ids: The ids of the documents to get.
+
+        Returns:
+            A list of Document objects.
+        """
+        documents = []
+
+        for doc_id in ids:
+            doc = self._database.get(doc_id)
+            if doc:
+                documents.append(
+                    Document(
+                        id=doc["id"],
+                        page_content=doc["text"],
+                        metadata=doc["metadata"],
+                    )
+                )
+        return documents
+
+    # optional: add custom async implementations
+    # async def aget_by_ids(self, ids: Sequence[str], /) -> list[Document]:
+    #     raise NotImplementedError
+
+    # NOTE: the below helper method implements similarity search for in-memory
+    # storage. It is optional and not a part of the vector store interface.
+    def _similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Callable[[Document], bool] | None = None,
+        **kwargs: Any,
+    ) -> List[tuple[Document, float, List[float]]]:
+        # get all docs with fixed order in list
+        docs = list(self._database.values())
+
+        if filter is not None:
+            docs = [
+                doc
+                for doc in docs
+                if filter(Document(page_content=doc["text"], metadata=doc["metadata"]))
+            ]
+
+        if not docs:
+            return []
+
+        similarity = cosine_similarity([embedding], [doc["vector"] for doc in docs])[0]
+
+        # get the indices ordered by similarity score
+        top_k_idx = similarity.argsort()[::-1][:k]
+
+        return [
+            (
+                # Document
+                Document(
+                    id=doc_dict["id"],
+                    page_content=doc_dict["text"],
+                    metadata=doc_dict["metadata"],
+                ),
+                # Score
+                float(similarity[idx].item()),
+                # Embedding vector
+                doc_dict["vector"],
+            )
+            for idx in top_k_idx
+            # Assign using walrus operator to avoid multiple lookups
+            if (doc_dict := docs[idx])
+        ]
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        embedding = self.embedding.embed_query(query)
+        return [
+            doc
+            for doc, _, _ in self._similarity_search_with_score_by_vector(
+                embedding=embedding, k=k, **kwargs
+            )
+        ]
+
+    # optional: add custom async implementations
+    # async def asimilarity_search(
+    #     self, query: str, k: int = 4, **kwargs: Any
+    # ) -> List[Document]:
+    #     # This is a temporary workaround to make the similarity search
+    #     # asynchronous. The proper solution is to make the similarity search
+    #     # asynchronous in the vector store implementations.
+    #     func = partial(self.similarity_search, query, k=k, **kwargs)
+    #     return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        embedding = self.embedding.embed_query(query)
+        return [
+            (doc, similarity)
+            for doc, similarity, _ in self._similarity_search_with_score_by_vector(
+                embedding=embedding, k=k, **kwargs
+            )
+        ]
+
+    # optional: add custom async implementations
+    # async def asimilarity_search_with_score(
+    #     self, *args: Any, **kwargs: Any
+    # ) -> List[Tuple[Document, float]]:
+    #     # This is a temporary workaround to make the similarity search
+    #     # asynchronous. The proper solution is to make the similarity search
+    #     # asynchronous in the vector store implementations.
+    #     func = partial(self.similarity_search_with_score, *args, **kwargs)
+    #     return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    ### ADDITIONAL OPTIONAL SEARCH METHODS BELOW ###
+
+    # def similarity_search_by_vector(
+    #     self, embedding: List[float], k: int = 4, **kwargs: Any
+    # ) -> List[Document]:
+    #     raise NotImplementedError
+
+    # optional: add custom async implementations
+    # async def asimilarity_search_by_vector(
+    #     self, embedding: List[float], k: int = 4, **kwargs: Any
+    # ) -> List[Document]:
+    #     # This is a temporary workaround to make the similarity search
+    #     # asynchronous. The proper solution is to make the similarity search
+    #     # asynchronous in the vector store implementations.
+    #     func = partial(self.similarity_search_by_vector, embedding, k=k, **kwargs)
+    #     return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    # def max_marginal_relevance_search(
+    #     self,
+    #     query: str,
+    #     k: int = 4,
+    #     fetch_k: int = 20,
+    #     lambda_mult: float = 0.5,
+    #     **kwargs: Any,
+    # ) -> List[Document]:
+    #     raise NotImplementedError
+
+    # optional: add custom async implementations
+    # async def amax_marginal_relevance_search(
+    #     self,
+    #     query: str,
+    #     k: int = 4,
+    #     fetch_k: int = 20,
+    #     lambda_mult: float = 0.5,
+    #     **kwargs: Any,
+    # ) -> List[Document]:
+    #     # This is a temporary workaround to make the similarity search
+    #     # asynchronous. The proper solution is to make the similarity search
+    #     # asynchronous in the vector store implementations.
+    #     func = partial(
+    #         self.max_marginal_relevance_search,
+    #         query,
+    #         k=k,
+    #         fetch_k=fetch_k,
+    #         lambda_mult=lambda_mult,
+    #         **kwargs,
+    #     )
+    #     return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    # def max_marginal_relevance_search_by_vector(
+    #     self,
+    #     embedding: List[float],
+    #     k: int = 4,
+    #     fetch_k: int = 20,
+    #     lambda_mult: float = 0.5,
+    #     **kwargs: Any,
+    # ) -> List[Document]:
+    #     raise NotImplementedError
+
+    # optional: add custom async implementations
+    # async def amax_marginal_relevance_search_by_vector(
+    #     self,
+    #     embedding: List[float],
+    #     k: int = 4,
+    #     fetch_k: int = 20,
+    #     lambda_mult: float = 0.5,
+    #     **kwargs: Any,
+    # ) -> List[Document]:
+    #     raise NotImplementedError

libs/cli/langchain_cli/integration_template/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["pdm-backend"]
+build-backend = "pdm.backend"
+
+[project]
+name = "__package_name__"
+version = "0.1.0"
+description = "An integration package connecting __ModuleName__ and LangChain"
+authors = []
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10.0,<4.0.0"
+dependencies = [
+    "langchain-core>=0.3.15",
+]
+
+[project.urls]
+"Source Code" = "https://github.com/langchain-ai/langchain/tree/master/libs/partners/__package_name_short__"
+"Release Notes" = "https://github.com/langchain-ai/langchain/releases?q=tag%3A%22__package_name_short__%3D%3D0%22&expanded=true"
+"Repository" = "https://github.com/langchain-ai/langchain"
+
+[tool.mypy]
+disallow_untyped_defs = "True"
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=7.4.3",
+    "pytest-asyncio>=0.23.2",
+    "pytest-socket>=0.7.0",
+    "pytest-watcher>=0.3.4",
+    "langchain-tests>=0.3.5",
+    "ruff>=0.5",
+    "mypy>=1.10",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "T201"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.per-file-ignores]
+"docs/**" = [ "ALL",]
+
+[tool.coverage.run]
+omit = ["tests/*"]
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config --durations=5"
+markers = [
+    "compile: mark placeholder test used to compile integration tests without running them",
+]
+asyncio_mode = "auto"

libs/cli/langchain_cli/integration_template/scripts/check_imports.py

@@ -1,5 +1,3 @@
-"""Script to check imports of given Python files."""
-
 import sys
 import traceback
 from importlib.machinery import SourceFileLoader
@@ -10,7 +8,7 @@ if __name__ == "__main__":
     for file in files:
         try:
             SourceFileLoader("x", file).load_module()
-        except Exception:  # noqa: PERF203, BLE001
+        except Exception:
             has_failure = True
             print(file)  # noqa: T201
             traceback.print_exc()

libs/cli/langchain_cli/integration_template/scripts/lint_imports.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+set -eu
+
+# Initialize a variable to keep track of errors
+errors=0
+
+# make sure not importing from langchain, langchain_experimental, or langchain_community
+git --no-pager grep '^from langchain\.' . && errors=$((errors+1))
+git --no-pager grep '^from langchain_experimental\.' . && errors=$((errors+1))
+git --no-pager grep '^from langchain_community\.' . && errors=$((errors+1))
+
+# Decide on an exit status based on the errors
+if [ "$errors" -gt 0 ]; then
+    exit 1
+else
+    exit 0
+fi

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_chat_models.py

@@ -0,0 +1,21 @@
+"""Test Chat__ModuleName__ chat model."""
+
+from typing import Type
+
+from __module_name__.chat_models import Chat__ModuleName__
+from langchain_tests.integration_tests import ChatModelIntegrationTests
+
+
+class TestChatParrotLinkIntegration(ChatModelIntegrationTests):
+    @property
+    def chat_model_class(self) -> Type[Chat__ModuleName__]:
+        return Chat__ModuleName__
+
+    @property
+    def chat_model_params(self) -> dict:
+        # These should be parameters used to initialize your integration for testing
+        return {
+            "model": "bird-brain-001",
+            "temperature": 0,
+            "parrot_buffer_length": 50,
+        }

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_compile.py

@@ -1,8 +1,7 @@
-"""Test compilation of integration tests."""
-
 import pytest
 
 
 @pytest.mark.compile
 def test_placeholder() -> None:
     """Used for compiling integration tests without running any real tests."""
+    pass

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_embeddings.py

@@ -0,0 +1,16 @@
+"""Test __ModuleName__ embeddings."""
+
+from typing import Type
+
+from __module_name__.embeddings import __ModuleName__Embeddings
+from langchain_tests.integration_tests import EmbeddingsIntegrationTests
+
+
+class TestParrotLinkEmbeddingsIntegration(EmbeddingsIntegrationTests):
+    @property
+    def embeddings_class(self) -> Type[__ModuleName__Embeddings]:
+        return __ModuleName__Embeddings
+
+    @property
+    def embedding_model_params(self) -> dict:
+        return {"model": "nest-embed-001"}

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_retrievers.py

@@ -0,0 +1,22 @@
+from typing import Type
+
+from __module_name__.retrievers import __ModuleName__Retriever
+from langchain_tests.integration_tests import (
+    RetrieversIntegrationTests,
+)
+
+
+class Test__ModuleName__Retriever(RetrieversIntegrationTests):
+    @property
+    def retriever_constructor(self) -> Type[__ModuleName__Retriever]:
+        """Get an empty vectorstore for unit tests."""
+        return __ModuleName__Retriever
+
+    @property
+    def retriever_constructor_params(self) -> dict:
+        return {"k": 2}
+
+    @property
+    def retriever_query_example(self) -> str:
+        """Returns a str representing the "query" of an example retriever call."""
+        return "example query"

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_tools.py

@@ -0,0 +1,27 @@
+from typing import Type
+
+from __module_name__.tools import __ModuleName__Tool
+from langchain_tests.integration_tests import ToolsIntegrationTests
+
+
+class TestParrotMultiplyToolIntegration(ToolsIntegrationTests):
+    @property
+    def tool_constructor(self) -> Type[__ModuleName__Tool]:
+        return __ModuleName__Tool
+
+    @property
+    def tool_constructor_params(self) -> dict:
+        # if your tool constructor instead required initialization arguments like
+        # `def __init__(self, some_arg: int):`, you would return those here
+        # as a dictionary, e.g.: `return {'some_arg': 42}`
+        return {}
+
+    @property
+    def tool_invoke_params_example(self) -> dict:
+        """
+        Returns a dictionary representing the "args" of an example tool call.
+
+        This should NOT be a ToolCall dict - i.e. it should not have
+        `{"name", "id", "args"}` keys.
+        """
+        return {"a": 2, "b": 3}

libs/cli/langchain_cli/integration_template/tests/integration_tests/test_vectorstores.py

@@ -0,0 +1,20 @@
+from typing import Generator
+
+import pytest
+from __module_name__.vectorstores import __ModuleName__VectorStore
+from langchain_core.vectorstores import VectorStore
+from langchain_tests.integration_tests import VectorStoreIntegrationTests
+
+
+class Test__ModuleName__VectorStore(VectorStoreIntegrationTests):
+    @pytest.fixture()
+    def vectorstore(self) -> Generator[VectorStore, None, None]:  # type: ignore
+        """Get an empty vectorstore for unit tests."""
+        store = __ModuleName__VectorStore(self.get_embeddings())
+        # note: store should be EMPTY at this point
+        # if you need to delete data, you may do so here
+        try:
+            yield store
+        finally:
+            # cleanup operations, or deleting data
+            pass

libs/cli/langchain_cli/integration_template/tests/unit_tests/test_chat_models.py

@@ -0,0 +1,21 @@
+"""Test chat model integration."""
+
+from typing import Type
+
+from __module_name__.chat_models import Chat__ModuleName__
+from langchain_tests.unit_tests import ChatModelUnitTests
+
+
+class TestChat__ModuleName__Unit(ChatModelUnitTests):
+    @property
+    def chat_model_class(self) -> Type[Chat__ModuleName__]:
+        return Chat__ModuleName__
+
+    @property
+    def chat_model_params(self) -> dict:
+        # These should be parameters used to initialize your integration for testing
+        return {
+            "model": "bird-brain-001",
+            "temperature": 0,
+            "parrot_buffer_length": 50,
+        }

libs/cli/langchain_cli/integration_template/tests/unit_tests/test_embeddings.py

@@ -0,0 +1,16 @@
+"""Test embedding model integration."""
+
+from typing import Type
+
+from __module_name__.embeddings import __ModuleName__Embeddings
+from langchain_tests.unit_tests import EmbeddingsUnitTests
+
+
+class TestParrotLinkEmbeddingsUnit(EmbeddingsUnitTests):
+    @property
+    def embeddings_class(self) -> Type[__ModuleName__Embeddings]:
+        return __ModuleName__Embeddings
+
+    @property
+    def embedding_model_params(self) -> dict:
+        return {"model": "nest-embed-001"}

libs/cli/langchain_cli/integration_template/tests/unit_tests/test_tools.py

@@ -0,0 +1,27 @@
+from typing import Type
+
+from __module_name__.tools import __ModuleName__Tool
+from langchain_tests.unit_tests import ToolsUnitTests
+
+
+class TestParrotMultiplyToolUnit(ToolsUnitTests):
+    @property
+    def tool_constructor(self) -> Type[__ModuleName__Tool]:
+        return __ModuleName__Tool
+
+    @property
+    def tool_constructor_params(self) -> dict:
+        # If your tool constructor instead required initialization arguments like
+        # `def __init__(self, some_arg: int):`, you would return those here
+        # as a dictionary, e.g.: `return {'some_arg': 42}`
+        return {}
+
+    @property
+    def tool_invoke_params_example(self) -> dict:
+        """
+        Returns a dictionary representing the "args" of an example tool call.
+
+        This should NOT be a ToolCall dict - i.e. it should not have
+        `{"name", "id", "args"}` keys.
+        """
+        return {"a": 2, "b": 3}

libs/cli/langchain_cli/namespaces/__init__.py

@@ -0,0 +1 @@
+"""Namespaces."""

libs/cli/langchain_cli/namespaces/app.py

@@ -0,0 +1,371 @@
+"""Manage LangChain apps."""
+
+import shutil
+import subprocess
+import sys
+import warnings
+from pathlib import Path
+from typing import Annotated
+
+import typer
+import uvicorn
+
+from langchain_cli.utils.events import create_events
+from langchain_cli.utils.git import (
+    DependencySource,
+    copy_repo,
+    parse_dependencies,
+    update_repo,
+)
+from langchain_cli.utils.packages import (
+    LangServeExport,
+    get_langserve_export,
+    get_package_root,
+)
+from langchain_cli.utils.pyproject import (
+    add_dependencies_to_pyproject_toml,
+    remove_dependencies_from_pyproject_toml,
+)
+
+REPO_DIR = Path(typer.get_app_dir("langchain")) / "git_repos"
+
+app_cli = typer.Typer(no_args_is_help=True, add_completion=False)
+
+
+@app_cli.command()
+def new(
+    name: Annotated[
+        str | None,
+        typer.Argument(
+            help="The name of the folder to create",
+        ),
+    ] = None,
+    *,
+    package: Annotated[
+        list[str] | None,
+        typer.Option(help="Packages to seed the project with"),
+    ] = None,
+    pip: Annotated[
+        bool | None,
+        typer.Option(
+            "--pip/--no-pip",
+            help="Pip install the template(s) as editable dependencies",
+        ),
+    ] = None,
+    noninteractive: Annotated[
+        bool,
+        typer.Option(
+            "--non-interactive/--interactive",
+            help="Don't prompt for any input",
+        ),
+    ] = False,
+) -> None:
+    """Create a new LangServe application."""
+    has_packages = package is not None and len(package) > 0
+
+    if noninteractive:
+        if name is None:
+            msg = "name is required when --non-interactive is set"
+            raise typer.BadParameter(msg)
+        name_str = name
+        pip_bool = bool(pip)  # None should be false
+    else:
+        name_str = name or typer.prompt("What folder would you like to create?")
+        if not has_packages:
+            package = []
+            package_prompt = "What package would you like to add? (leave blank to skip)"
+            while True:
+                package_str = typer.prompt(
+                    package_prompt,
+                    default="",
+                    show_default=False,
+                )
+                if not package_str:
+                    break
+                package.append(package_str)
+                package_prompt = (
+                    f"{len(package)} added. Any more packages (leave blank to end)?"
+                )
+
+            has_packages = len(package) > 0
+
+        pip_bool = False
+        if pip is None and has_packages:
+            pip_bool = typer.confirm(
+                "Would you like to install these templates into your environment "
+                "with pip?",
+                default=False,
+            )
+    # copy over template from ../project_template
+    project_template_dir = Path(__file__).parents[1] / "project_template"
+    destination_dir = Path.cwd() / name_str if name_str != "." else Path.cwd()
+    app_name = name_str if name_str != "." else Path.cwd().name
+    shutil.copytree(project_template_dir, destination_dir, dirs_exist_ok=name == ".")
+
+    readme = destination_dir / "README.md"
+    readme_contents = readme.read_text()
+    readme.write_text(readme_contents.replace("__app_name__", app_name))
+
+    pyproject = destination_dir / "pyproject.toml"
+    pyproject_contents = pyproject.read_text()
+    pyproject.write_text(pyproject_contents.replace("__app_name__", app_name))
+
+    # add packages if specified
+    if has_packages:
+        add(package, project_dir=destination_dir, pip=pip_bool)
+
+    typer.echo(f'\n\nSuccess! Created a new LangChain app under "./{app_name}"!\n\n')
+    typer.echo("Next, enter your new app directory by running:\n")
+    typer.echo(f"    cd ./{app_name}\n")
+    typer.echo("Then add templates with commands like:\n")
+    typer.echo("    langchain app add extraction-openai-functions")
+    typer.echo(
+        "    langchain app add git+ssh://git@github.com/efriis/simple-pirate.git\n\n",
+    )
+
+
+@app_cli.command()
+def add(
+    dependencies: Annotated[
+        list[str] | None,
+        typer.Argument(help="The dependency to add"),
+    ] = None,
+    *,
+    api_path: Annotated[
+        list[str] | None,
+        typer.Option(help="API paths to add"),
+    ] = None,
+    project_dir: Annotated[
+        Path | None,
+        typer.Option(help="The project directory"),
+    ] = None,
+    repo: Annotated[
+        list[str] | None,
+        typer.Option(help="Install templates from a specific github repo instead"),
+    ] = None,
+    branch: Annotated[
+        list[str] | None,
+        typer.Option(help="Install templates from a specific branch"),
+    ] = None,
+    pip: Annotated[
+        bool,
+        typer.Option(
+            "--pip/--no-pip",
+            help="Pip install the template(s) as editable dependencies",
+            prompt="Would you like to `pip install -e` the template(s)?",
+        ),
+    ],
+) -> None:
+    """Add the specified template to the current LangServe app.
+
+    e.g.:
+    `langchain app add extraction-openai-functions`
+    `langchain app add git+ssh://git@github.com/efriis/simple-pirate.git`
+    """
+    if branch is None:
+        branch = []
+    if repo is None:
+        repo = []
+    if api_path is None:
+        api_path = []
+    if not branch and not repo:
+        warnings.warn(
+            "Adding templates from the default branch and repo is deprecated."
+            " At a minimum, you will have to add `--branch v0.2` for this to work",
+            stacklevel=2,
+        )
+
+    parsed_deps = parse_dependencies(dependencies, repo, branch, api_path)
+
+    project_root = get_package_root(project_dir)
+
+    package_dir = project_root / "packages"
+
+    create_events(
+        [{"event": "serve add", "properties": {"parsed_dep": d}} for d in parsed_deps],
+    )
+
+    # group by repo/ref
+    grouped: dict[tuple[str, str | None], list[DependencySource]] = {}
+    for dep in parsed_deps:
+        key_tup = (dep["git"], dep["ref"])
+        lst = grouped.get(key_tup, [])
+        lst.append(dep)
+        grouped[key_tup] = lst
+
+    installed_destination_paths: list[Path] = []
+    installed_destination_names: list[str] = []
+    installed_exports: list[LangServeExport] = []
+
+    for (git, ref), group_deps in grouped.items():
+        if len(group_deps) == 1:
+            typer.echo(f"Adding {git}@{ref}...")
+        else:
+            typer.echo(f"Adding {len(group_deps)} templates from {git}@{ref}")
+        source_repo_path = update_repo(git, ref, REPO_DIR)
+
+        for dep in group_deps:
+            source_path = (
+                source_repo_path / dep["subdirectory"]
+                if dep["subdirectory"]
+                else source_repo_path
+            )
+            pyproject_path = source_path / "pyproject.toml"
+            if not pyproject_path.exists():
+                typer.echo(f"Could not find {pyproject_path}")
+                continue
+            langserve_export = get_langserve_export(pyproject_path)
+
+            # default path to package_name
+            inner_api_path = dep["api_path"] or langserve_export["package_name"]
+
+            destination_path = package_dir / inner_api_path
+            if destination_path.exists():
+                typer.echo(
+                    f"Folder {inner_api_path} already exists. Skipping...",
+                )
+                continue
+            copy_repo(source_path, destination_path)
+            typer.echo(f" - Downloaded {dep['subdirectory']} to {inner_api_path}")
+            installed_destination_paths.append(destination_path)
+            installed_destination_names.append(inner_api_path)
+            installed_exports.append(langserve_export)
+
+    if len(installed_destination_paths) == 0:
+        typer.echo("No packages installed. Exiting.")
+        return
+
+    try:
+        add_dependencies_to_pyproject_toml(
+            project_root / "pyproject.toml",
+            zip(installed_destination_names, installed_destination_paths, strict=False),
+        )
+    except Exception:
+        # Can fail if user modified/removed pyproject.toml
+        typer.echo("Failed to add dependencies to pyproject.toml, continuing...")
+
+    try:
+        cwd = Path.cwd()
+        installed_destination_strs = [
+            str(p.relative_to(cwd)) for p in installed_destination_paths
+        ]
+    except ValueError:
+        # Can fail if the cwd is not a parent of the package
+        typer.echo("Failed to print install command, continuing...")
+    else:
+        if pip:
+            cmd = ["pip", "install", "-e", *installed_destination_strs]
+            cmd_str = " \\\n  ".join(installed_destination_strs)
+            typer.echo(f"Running: pip install -e \\\n  {cmd_str}")
+            subprocess.run(cmd, cwd=cwd, check=True)  # noqa: S603
+
+    chain_names = []
+    for e in installed_exports:
+        original_candidate = f"{e['package_name'].replace('-', '_')}_chain"
+        candidate = original_candidate
+        i = 2
+        while candidate in chain_names:
+            candidate = original_candidate + "_" + str(i)
+            i += 1
+        chain_names.append(candidate)
+
+    api_paths = [
+        str(Path("/") / path.relative_to(package_dir))
+        for path in installed_destination_paths
+    ]
+
+    imports = [
+        f"from {e['module']} import {e['attr']} as {name}"
+        for e, name in zip(installed_exports, chain_names, strict=False)
+    ]
+    routes = [
+        f'add_routes(app, {name}, path="{path}")'
+        for name, path in zip(chain_names, api_paths, strict=False)
+    ]
+
+    t = (
+        "this template"
+        if len(chain_names) == 1
+        else f"these {len(chain_names)} templates"
+    )
+    lines = [
+        "",
+        f"To use {t}, add the following to your app:\n\n```",
+        "",
+        *imports,
+        "",
+        *routes,
+        "```",
+    ]
+    typer.echo("\n".join(lines))
+
+
+@app_cli.command()
+def remove(
+    api_paths: Annotated[list[str], typer.Argument(help="The API paths to remove")],
+    *,
+    project_dir: Annotated[
+        Path | None,
+        typer.Option(help="The project directory"),
+    ] = None,
+) -> None:
+    """Remove the specified package from the current LangServe app."""
+    project_root = get_package_root(project_dir)
+
+    project_pyproject = project_root / "pyproject.toml"
+
+    package_root = project_root / "packages"
+
+    remove_deps: list[str] = []
+
+    for api_path in api_paths:
+        package_dir = package_root / api_path
+        if not package_dir.exists():
+            typer.echo(f"Package {api_path} does not exist. Skipping...")
+            continue
+        try:
+            pyproject = package_dir / "pyproject.toml"
+            langserve_export = get_langserve_export(pyproject)
+            typer.echo(f"Removing {langserve_export['package_name']}...")
+
+            shutil.rmtree(package_dir)
+            remove_deps.append(api_path)
+        except OSError as exc:
+            typer.echo(f"Failed to remove {api_path}: {exc}")
+
+    try:
+        remove_dependencies_from_pyproject_toml(project_pyproject, remove_deps)
+    except Exception:
+        # Can fail if user modified/removed pyproject.toml
+        typer.echo("Failed to remove dependencies from pyproject.toml.")
+
+
+@app_cli.command()
+def serve(
+    *,
+    port: Annotated[
+        int | None,
+        typer.Option(help="The port to run the server on"),
+    ] = None,
+    host: Annotated[
+        str | None,
+        typer.Option(help="The host to run the server on"),
+    ] = None,
+    app: Annotated[
+        str | None,
+        typer.Option(help="The app to run, e.g. `app.server:app`"),
+    ] = None,
+) -> None:
+    """Start the LangServe app."""
+    # add current dir as first entry of path
+    sys.path.append(str(Path.cwd()))
+
+    app_str = app if app is not None else "app.server:app"
+    host_str = host if host is not None else "127.0.0.1"
+
+    uvicorn.run(
+        app_str,
+        host=host_str,
+        port=port if port is not None else 8000,
+        reload=True,
+    )

libs/cli/langchain_cli/namespaces/integration.py

@@ -0,0 +1,260 @@
+"""Develop integration packages for LangChain."""
+
+import os
+import re
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Annotated, cast
+
+import typer
+from typing_extensions import TypedDict
+
+from langchain_cli.utils.find_replace import replace_file, replace_glob
+
+integration_cli = typer.Typer(no_args_is_help=True, add_completion=False)
+
+
+class Replacements(TypedDict):
+    """Replacements."""
+
+    __package_name__: str
+    __module_name__: str
+    __ModuleName__: str
+    __MODULE_NAME__: str
+    __package_name_short__: str
+    __package_name_short_snake__: str
+
+
+def _process_name(name: str, *, community: bool = False) -> Replacements:
+    preprocessed = name.replace("_", "-").lower()
+
+    preprocessed = preprocessed.removeprefix("langchain-")
+
+    if not re.match(r"^[a-z][a-z0-9-]*$", preprocessed):
+        msg = (
+            "Name should only contain lowercase letters (a-z), numbers, and hyphens"
+            ", and start with a letter."
+        )
+        raise ValueError(msg)
+    if preprocessed.endswith("-"):
+        msg = "Name should not end with `-`."
+        raise ValueError(msg)
+    if preprocessed.find("--") != -1:
+        msg = "Name should not contain consecutive hyphens."
+        raise ValueError(msg)
+    replacements: Replacements = {
+        "__package_name__": f"langchain-{preprocessed}",
+        "__module_name__": "langchain_" + preprocessed.replace("-", "_"),
+        "__ModuleName__": preprocessed.title().replace("-", ""),
+        "__MODULE_NAME__": preprocessed.upper().replace("-", ""),
+        "__package_name_short__": preprocessed,
+        "__package_name_short_snake__": preprocessed.replace("-", "_"),
+    }
+    if community:
+        replacements["__module_name__"] = preprocessed.replace("-", "_")
+    return replacements
+
+
+@integration_cli.command()
+def new(
+    name: Annotated[
+        str,
+        typer.Option(
+            help="The name of the integration to create (e.g. `my-integration`)",
+            prompt="The name of the integration to create (e.g. `my-integration`)",
+        ),
+    ],
+    name_class: Annotated[
+        str | None,
+        typer.Option(
+            help="The name of the integration in PascalCase. e.g. `MyIntegration`."
+            " This is used to name classes like `MyIntegrationVectorStore`",
+        ),
+    ] = None,
+    src: Annotated[
+        list[str] | None,
+        typer.Option(
+            help="The name of the single template file to copy."
+            " e.g. `--src integration_template/chat_models.py "
+            "--dst my_integration/chat_models.py`. Can be used multiple times.",
+        ),
+    ] = None,
+    dst: Annotated[
+        list[str] | None,
+        typer.Option(
+            help="The relative path to the integration package to place the new file in"
+            ". e.g. `my-integration/my_integration.py`",
+        ),
+    ] = None,
+) -> None:
+    """Create a new integration package."""
+    try:
+        replacements = _process_name(name)
+    except ValueError as e:
+        typer.echo(e)
+        raise typer.Exit(code=1) from None
+
+    if name_class:
+        if not re.match(r"^[A-Z][a-zA-Z0-9]*$", name_class):
+            typer.echo(
+                "Name should only contain letters (a-z, A-Z), numbers, and underscores"
+                ", and start with a capital letter.",
+            )
+            raise typer.Exit(code=1)
+        replacements["__ModuleName__"] = name_class
+    else:
+        replacements["__ModuleName__"] = typer.prompt(
+            "Name of integration in PascalCase",
+            default=replacements["__ModuleName__"],
+        )
+
+    project_template_dir = Path(__file__).parents[1] / "integration_template"
+    destination_dir = Path.cwd() / replacements["__package_name__"]
+    if not src and not dst:
+        if destination_dir.exists():
+            typer.echo(f"Folder {destination_dir} exists.")
+            raise typer.Exit(code=1)
+
+        # Copy over template from ../integration_template
+        shutil.copytree(project_template_dir, destination_dir, dirs_exist_ok=False)
+
+        # Folder movement
+        package_dir = destination_dir / replacements["__module_name__"]
+        shutil.move(destination_dir / "integration_template", package_dir)
+
+        # Replacements in files
+        replace_glob(destination_dir, "**/*", cast("dict[str, str]", replacements))
+
+        # Dependency install
+        try:
+            # Use --no-progress to avoid tty issues in CI/test environments
+            env = os.environ.copy()
+            env.pop("UV_FROZEN", None)
+            env.pop("VIRTUAL_ENV", None)
+            subprocess.run(
+                ["uv", "sync", "--dev", "--no-progress"],  # noqa: S607
+                cwd=destination_dir,
+                check=True,
+                env=env,
+            )
+        except FileNotFoundError:
+            typer.echo(
+                "uv is not installed. Skipping dependency installation; run "
+                "`uv sync --dev` manually if needed.",
+            )
+        except subprocess.CalledProcessError:
+            typer.echo(
+                "Failed to install dependencies. You may need to run "
+                "`uv sync --dev` manually in the package directory.",
+            )
+    else:
+        # Confirm src and dst are the same length
+        if not src:
+            typer.echo("Cannot provide --dst without --src.")
+            raise typer.Exit(code=1)
+        src_paths = [project_template_dir / p for p in src]
+        if dst and len(src) != len(dst):
+            typer.echo("Number of --src and --dst arguments must match.")
+            raise typer.Exit(code=1)
+        if not dst:
+            # Assume we're in a package dir, copy to equivalent path
+            dst_paths = [destination_dir / p for p in src]
+        else:
+            dst_paths = [Path.cwd() / p for p in dst]
+            dst_paths = [
+                p / f"{replacements['__package_name_short_snake__']}.ipynb"
+                if not p.suffix
+                else p
+                for p in dst_paths
+            ]
+
+        # Confirm no duplicate dst_paths
+        if len(dst_paths) != len(set(dst_paths)):
+            typer.echo(
+                "Duplicate destination paths provided or computed - please "
+                "specify them explicitly with --dst.",
+            )
+            raise typer.Exit(code=1)
+
+        # Confirm no files exist at dst_paths
+        for dst_path in dst_paths:
+            if dst_path.exists():
+                typer.echo(f"File {dst_path} exists.")
+                raise typer.Exit(code=1)
+
+        for src_path, dst_path in zip(src_paths, dst_paths, strict=False):
+            shutil.copy(src_path, dst_path)
+            replace_file(dst_path, cast("dict[str, str]", replacements))
+
+
+TEMPLATE_MAP: dict[str, str] = {
+    "ChatModel": "chat.ipynb",
+    "DocumentLoader": "document_loaders.ipynb",
+    "Tool": "tools.ipynb",
+    "VectorStore": "vectorstores.ipynb",
+    "Embeddings": "text_embedding.ipynb",
+    "ByteStore": "kv_store.ipynb",
+    "LLM": "llms.ipynb",
+    "Provider": "provider.ipynb",
+    "Toolkit": "toolkits.ipynb",
+    "Retriever": "retrievers.ipynb",
+}
+
+_component_types_str = ", ".join(f"`{k}`" for k in TEMPLATE_MAP)
+
+
+@integration_cli.command()
+def create_doc(
+    name: Annotated[
+        str,
+        typer.Option(
+            help=(
+                "The kebab-case name of the integration (e.g. `openai`, "
+                "`google-vertexai`). Do not include a 'langchain-' prefix."
+            ),
+            prompt=(
+                "The kebab-case name of the integration (e.g. `openai`, "
+                "`google-vertexai`). Do not include a 'langchain-' prefix."
+            ),
+        ),
+    ],
+    name_class: Annotated[
+        str | None,
+        typer.Option(
+            help=(
+                "The PascalCase name of the integration (e.g. `OpenAI`, "
+                "`VertexAI`). Do not include a 'Chat', 'VectorStore', etc. "
+                "prefix/suffix."
+            ),
+        ),
+    ] = None,
+    component_type: Annotated[
+        str,
+        typer.Option(
+            help=(
+                f"The type of component. Currently supported: {_component_types_str}."
+            ),
+        ),
+    ] = "ChatModel",
+    destination_dir: Annotated[
+        str,
+        typer.Option(
+            help="The relative path to the docs directory to place the new file in.",
+            prompt="The relative path to the docs directory to place the new file in.",
+        ),
+    ] = "docs/docs/integrations/chat/",
+) -> None:
+    """Create a new integration doc."""
+    if component_type not in TEMPLATE_MAP:
+        typer.echo(
+            f"Unrecognized {component_type=}. Expected one of {_component_types_str}.",
+        )
+        raise typer.Exit(code=1)
+
+    new(
+        name=name,
+        name_class=name_class,
+        src=[f"docs/{TEMPLATE_MAP[component_type]}"],
+        dst=[destination_dir],
+    )

libs/cli/langchain_cli/namespaces/migrate/.grit/.gitignore

@@ -0,0 +1,2 @@
+.gritmodules*
+*.log

libs/cli/langchain_cli/namespaces/migrate/.grit/grit.yaml

@@ -0,0 +1,3 @@
+version: 0.0.1
+patterns:
+  - name: github.com/getgrit/stdlib#*

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/_test_replace_imports.md

@@ -0,0 +1,56 @@
+# Testing the replace_imports migration
+
+This runs the v0.2 migration with a desired set of rules.
+
+```grit
+language python
+
+langchain_all_migrations()
+```
+
+## Single import
+
+Before:
+
+```python
+from langchain.chat_models import ChatOpenAI
+```
+
+After:
+
+```python
+from langchain_community.chat_models import ChatOpenAI
+```
+
+## Community to partner
+
+```python
+from langchain_community.chat_models import ChatOpenAI
+```
+
+```python
+from langchain_openai import ChatOpenAI
+```
+
+## Noop
+
+This file should not match at all.
+
+```python
+from foo import ChatOpenAI
+```
+
+## Mixed imports
+
+```python
+from langchain_community.chat_models import ChatOpenAI, ChatAnthropic, foo
+```
+
+```python
+from langchain_community.chat_models import foo
+
+from langchain_openai import ChatOpenAI
+
+from langchain_anthropic import ChatAnthropic
+
+```

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/anthropic.grit

@@ -0,0 +1,15 @@
+
+language python
+
+// This migration is generated automatically - do not manually edit this file
+pattern langchain_migrate_anthropic() {
+  find_replace_imports(list=[
+    [`langchain_community.chat_models.anthropic`, `ChatAnthropic`, `langchain_anthropic`, `ChatAnthropic`],
+    [`langchain_community.llms.anthropic`, `Anthropic`, `langchain_anthropic`, `Anthropic`],
+    [`langchain_community.chat_models`, `ChatAnthropic`, `langchain_anthropic`, `ChatAnthropic`],
+    [`langchain_community.llms`, `Anthropic`, `langchain_anthropic`, `Anthropic`]
+  ])
+}
+
+// Add this for invoking directly
+langchain_migrate_anthropic()

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/astradb.grit

@@ -0,0 +1,67 @@
+
+language python
+
+// This migration is generated automatically - do not manually edit this file
+pattern langchain_migrate_astradb() {
+  find_replace_imports(list=[
+
+            [
+                `langchain_community.vectorstores.astradb`,
+                `AstraDB`,
+                `langchain_astradb`,
+                `AstraDBVectorStore`
+            ]
+            ,
+
+            [
+                `langchain_community.storage.astradb`,
+                `AstraDBByteStore`,
+                `langchain_astradb`,
+                `AstraDBByteStore`
+            ]
+            ,
+
+            [
+                `langchain_community.storage.astradb`,
+                `AstraDBStore`,
+                `langchain_astradb`,
+                `AstraDBStore`
+            ]
+            ,
+
+            [
+                `langchain_community.cache`,
+                `AstraDBCache`,
+                `langchain_astradb`,
+                `AstraDBCache`
+            ]
+            ,
+
+            [
+                `langchain_community.cache`,
+                `AstraDBSemanticCache`,
+                `langchain_astradb`,
+                `AstraDBSemanticCache`
+            ]
+            ,
+
+            [
+                `langchain_community.chat_message_histories.astradb`,
+                `AstraDBChatMessageHistory`,
+                `langchain_astradb`,
+                `AstraDBChatMessageHistory`
+            ]
+            ,
+
+            [
+                `langchain_community.document_loaders.astradb`,
+                `AstraDBLoader`,
+                `langchain_astradb`,
+                `AstraDBLoader`
+            ]
+            
+  ])
+}
+
+// Add this for invoking directly
+langchain_migrate_astradb()

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/community_to_core.grit

@@ -0,0 +1,38 @@
+
+language python
+
+// This migration is generated automatically - do not manually edit this file
+pattern langchain_migrate_community_to_core() {
+  find_replace_imports(list=[
+    [`langchain_community.callbacks.tracers`, `ConsoleCallbackHandler`, `langchain_core.tracers`, `ConsoleCallbackHandler`],
+    [`langchain_community.callbacks.tracers`, `FunctionCallbackHandler`, `langchain_core.tracers.stdout`, `FunctionCallbackHandler`],
+    [`langchain_community.callbacks.tracers`, `LangChainTracer`, `langchain_core.tracers`, `LangChainTracer`],
+    [`langchain_community.callbacks.tracers`, `LangChainTracerV1`, `langchain_core.tracers.langchain_v1`, `LangChainTracerV1`],
+    [`langchain_community.docstore.document`, `Document`, `langchain_core.documents`, `Document`],
+    [`langchain_community.document_loaders`, `Blob`, `langchain_core.document_loaders`, `Blob`],
+    [`langchain_community.document_loaders`, `BlobLoader`, `langchain_core.document_loaders`, `BlobLoader`],
+    [`langchain_community.document_loaders.base`, `BaseBlobParser`, `langchain_core.document_loaders`, `BaseBlobParser`],
+    [`langchain_community.document_loaders.base`, `BaseLoader`, `langchain_core.document_loaders`, `BaseLoader`],
+    [`langchain_community.document_loaders.blob_loaders`, `Blob`, `langchain_core.document_loaders`, `Blob`],
+    [`langchain_community.document_loaders.blob_loaders`, `BlobLoader`, `langchain_core.document_loaders`, `BlobLoader`],
+    [`langchain_community.document_loaders.blob_loaders.schema`, `Blob`, `langchain_core.document_loaders`, `Blob`],
+    [`langchain_community.document_loaders.blob_loaders.schema`, `BlobLoader`, `langchain_core.document_loaders`, `BlobLoader`],
+    [`langchain_community.tools`, `BaseTool`, `langchain_core.tools`, `BaseTool`],
+    [`langchain_community.tools`, `StructuredTool`, `langchain_core.tools`, `StructuredTool`],
+    [`langchain_community.tools`, `Tool`, `langchain_core.tools`, `Tool`],
+    [`langchain_community.tools`, `format_tool_to_openai_function`, `langchain_core.utils.function_calling`, `format_tool_to_openai_function`],
+    [`langchain_community.tools`, `tool`, `langchain_core.tools`, `tool`],
+    [`langchain_community.tools.convert_to_openai`, `format_tool_to_openai_function`, `langchain_core.utils.function_calling`, `format_tool_to_openai_function`],
+    [`langchain_community.tools.convert_to_openai`, `format_tool_to_openai_tool`, `langchain_core.utils.function_calling`, `format_tool_to_openai_tool`],
+    [`langchain_community.tools.render`, `format_tool_to_openai_function`, `langchain_core.utils.function_calling`, `format_tool_to_openai_function`],
+    [`langchain_community.tools.render`, `format_tool_to_openai_tool`, `langchain_core.utils.function_calling`, `format_tool_to_openai_tool`],
+    [`langchain_community.utils.openai_functions`, `FunctionDescription`, `langchain_core.utils.function_calling`, `FunctionDescription`],
+    [`langchain_community.utils.openai_functions`, `ToolDescription`, `langchain_core.utils.function_calling`, `ToolDescription`],
+    [`langchain_community.utils.openai_functions`, `convert_pydantic_to_openai_function`, `langchain_core.utils.function_calling`, `convert_pydantic_to_openai_function`],
+    [`langchain_community.utils.openai_functions`, `convert_pydantic_to_openai_tool`, `langchain_core.utils.function_calling`, `convert_pydantic_to_openai_tool`],
+    [`langchain_community.vectorstores`, `VectorStore`, `langchain_core.vectorstores`, `VectorStore`]
+  ])
+}
+
+// Add this for invoking directly
+langchain_migrate_community_to_core()

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/community_to_core.json

@@ -0,0 +1,101 @@
+[
+  [
+    "langchain_community.callbacks.tracers.ConsoleCallbackHandler",
+    "langchain_core.tracers.ConsoleCallbackHandler"
+  ],
+  [
+    "langchain_community.callbacks.tracers.FunctionCallbackHandler",
+    "langchain_core.tracers.stdout.FunctionCallbackHandler"
+  ],
+  [
+    "langchain_community.callbacks.tracers.LangChainTracer",
+    "langchain_core.tracers.LangChainTracer"
+  ],
+  [
+    "langchain_community.callbacks.tracers.LangChainTracerV1",
+    "langchain_core.tracers.langchain_v1.LangChainTracerV1"
+  ],
+  [
+    "langchain_community.docstore.document.Document",
+    "langchain_core.documents.Document"
+  ],
+  [
+    "langchain_community.document_loaders.Blob",
+    "langchain_core.document_loaders.Blob"
+  ],
+  [
+    "langchain_community.document_loaders.BlobLoader",
+    "langchain_core.document_loaders.BlobLoader"
+  ],
+  [
+    "langchain_community.document_loaders.base.BaseBlobParser",
+    "langchain_core.document_loaders.BaseBlobParser"
+  ],
+  [
+    "langchain_community.document_loaders.base.BaseLoader",
+    "langchain_core.document_loaders.BaseLoader"
+  ],
+  [
+    "langchain_community.document_loaders.blob_loaders.Blob",
+    "langchain_core.document_loaders.Blob"
+  ],
+  [
+    "langchain_community.document_loaders.blob_loaders.BlobLoader",
+    "langchain_core.document_loaders.BlobLoader"
+  ],
+  [
+    "langchain_community.document_loaders.blob_loaders.schema.Blob",
+    "langchain_core.document_loaders.Blob"
+  ],
+  [
+    "langchain_community.document_loaders.blob_loaders.schema.BlobLoader",
+    "langchain_core.document_loaders.BlobLoader"
+  ],
+  ["langchain_community.tools.BaseTool", "langchain_core.tools.BaseTool"],
+  [
+    "langchain_community.tools.StructuredTool",
+    "langchain_core.tools.StructuredTool"
+  ],
+  ["langchain_community.tools.Tool", "langchain_core.tools.Tool"],
+  [
+    "langchain_community.tools.format_tool_to_openai_function",
+    "langchain_core.utils.function_calling.format_tool_to_openai_function"
+  ],
+  ["langchain_community.tools.tool", "langchain_core.tools.tool"],
+  [
+    "langchain_community.tools.convert_to_openai.format_tool_to_openai_function",
+    "langchain_core.utils.function_calling.format_tool_to_openai_function"
+  ],
+  [
+    "langchain_community.tools.convert_to_openai.format_tool_to_openai_tool",
+    "langchain_core.utils.function_calling.format_tool_to_openai_tool"
+  ],
+  [
+    "langchain_community.tools.render.format_tool_to_openai_function",
+    "langchain_core.utils.function_calling.format_tool_to_openai_function"
+  ],
+  [
+    "langchain_community.tools.render.format_tool_to_openai_tool",
+    "langchain_core.utils.function_calling.format_tool_to_openai_tool"
+  ],
+  [
+    "langchain_community.utils.openai_functions.FunctionDescription",
+    "langchain_core.utils.function_calling.FunctionDescription"
+  ],
+  [
+    "langchain_community.utils.openai_functions.ToolDescription",
+    "langchain_core.utils.function_calling.ToolDescription"
+  ],
+  [
+    "langchain_community.utils.openai_functions.convert_pydantic_to_openai_function",
+    "langchain_core.utils.function_calling.convert_pydantic_to_openai_function"
+  ],
+  [
+    "langchain_community.utils.openai_functions.convert_pydantic_to_openai_tool",
+    "langchain_core.utils.function_calling.convert_pydantic_to_openai_tool"
+  ],
+  [
+    "langchain_community.vectorstores.VectorStore",
+    "langchain_core.vectorstores.VectorStore"
+  ]
+]

libs/cli/langchain_cli/namespaces/migrate/.grit/patterns/everything.grit

@@ -0,0 +1,18 @@
+language python
+
+pattern langchain_all_migrations() {
+  any {
+    langchain_migrate_community_to_core(),
+    langchain_migrate_fireworks(),
+    langchain_migrate_ibm(),
+    langchain_migrate_langchain_to_core(),
+    langchain_migrate_langchain_to_langchain_community(),
+    langchain_migrate_langchain_to_textsplitters(),
+    langchain_migrate_openai(),
+    langchain_migrate_pinecone(),
+    langchain_migrate_anthropic(),
+    replace_pydantic_v1_shim()
+  }
+}
+
+langchain_all_migrations()