chore: increment versions for 0.4 branch (#32419)

Co-authored-by: Mason Daugherty <mason@langchain.dev>
Co-authored-by: Eugene Yurtsev <eyurtsev@gmail.com>
Co-authored-by: Mason Daugherty <github@mdrxy.com>
Co-authored-by: Nuno Campos <nuno@langchain.dev>

.devcontainer/README.md

@@ -15,12 +15,12 @@ You may use the button above, or follow these steps to open this repo in a Codes
 1. Click **Create codespace on master**.
 
 For more info, check out the [GitHub documentation](https://docs.github.com/en/free-pro-team@latest/github/developing-online-with-codespaces/creating-a-codespace#creating-a-codespace).
-
+  
 ## VS Code Dev Containers
 
 [![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/langchain-ai/langchain)
 
-> [!NOTE]
+> [!NOTE]  
 > If you click the link above you will open the main repo (`langchain-ai/langchain`) and *not* your local cloned repo. This is fine if you only want to run and test the library, but if you want to contribute you can use the link below and replace with your username and cloned repo name:
 
 ```txt

.devcontainer/docker-compose.yaml

@@ -4,7 +4,7 @@ services:
     build:
       dockerfile: libs/langchain/dev.Dockerfile
       context: ..
-
+    
     networks:
       - langchain-network
 

.github/CODE_OF_CONDUCT.md

@@ -129,4 +129,4 @@ For answers to common questions about this code of conduct, see the FAQ at
 [v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
 [Mozilla CoC]: https://github.com/mozilla/diversity
 [FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations
+[translations]: https://www.contributor-covenant.org/translations

.github/CONTRIBUTING.md

@@ -3,4 +3,8 @@
 Hi there! Thank you for even being interested in contributing to LangChain.
 As an open-source project in a rapidly developing field, we are extremely open to contributions, whether they involve new features, improved infrastructure, better documentation, or bug fixes.
 
-To learn how to contribute to LangChain, please follow the [contribution guide here](https://docs.langchain.com/oss/python/contributing).
+To learn how to contribute to LangChain, please follow the [contribution guide here](https://python.langchain.com/docs/contributing/).
+
+## New features
+
+For new features, please start a new [discussion](https://forum.langchain.com/), where the maintainers will help with scoping out the necessary changes.

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,12 +1,11 @@
 name: "\U0001F41B Bug Report"
 description: Report a bug in LangChain. To report a security issue, please instead use the security option below. For questions, please use the LangChain forum.
 labels: ["bug"]
-type: bug
 body:
   - type: markdown
     attributes:
       value: |
-        Thank you for taking the time to file a bug report.
+        Thank you for taking the time to file a bug report. 
 
         Use this to report BUGS in LangChain. For usage questions, feature requests and general design questions, please use the [LangChain Forum](https://forum.langchain.com/).
 
@@ -14,7 +13,9 @@ body:
         if there's another way to solve your problem:
 
         * [LangChain Forum](https://forum.langchain.com/),
-        * [LangChain documentation with the integrated search](https://docs.langchain.com/oss/python/langchain/overview),
+        * [LangChain Github Issues](https://github.com/langchain-ai/langchain/issues?q=is%3Aissue),
+        * [LangChain documentation with the integrated search](https://python.langchain.com/docs/get_started/introduction),
+        * [LangChain how-to guides](https://python.langchain.com/docs/how_to/),
         * [API Reference](https://python.langchain.com/api_reference/),
         * [LangChain ChatBot](https://chat.langchain.com/)
         * [GitHub search](https://github.com/langchain-ai/langchain),
@@ -24,7 +25,7 @@ body:
       label: Checked other resources
       description: Please confirm and check all the following options.
       options:
-        - label: This is a bug, not a usage question.
+        - label: This is a bug, not a usage question. For questions, please use the LangChain Forum (https://forum.langchain.com/).
           required: true
         - label: I added a clear and descriptive title that summarizes this issue.
           required: true
@@ -34,8 +35,6 @@ body:
           required: true
         - label: The bug is not resolved by updating to the latest stable version of LangChain (or the specific integration package).
           required: true
-        - label: This is not related to the langchain-community package.
-          required: true
         - label: I read what a minimal reproducible example is (https://stackoverflow.com/help/minimal-reproducible-example).
           required: true
         - label: I posted a self-contained, minimal, reproducible example. A maintainer can copy it and run it AS IS.
@@ -51,7 +50,7 @@ body:
 
         If a maintainer can copy it, run it, and see it right away, there's a much higher chance that you'll be able to get help.
 
-        **Important!**
+        **Important!** 
 
         * Avoid screenshots when possible, as they are hard to read and (more importantly) don't allow others to copy-and-paste your code.
         * Reduce your code to the minimum required to reproduce the issue if possible. This makes it much easier for others to help you.
@@ -59,14 +58,14 @@ body:
         * INCLUDE the language label (e.g. `python`) after the first three backticks to enable syntax highlighting. (e.g., ```python rather than ```).
 
       placeholder: |
-        The following code:
+        The following code: 
 
         ```python
         from langchain_core.runnables import RunnableLambda
 
         def bad_code(inputs) -> int:
           raise NotImplementedError('For demo purpose')
-
+          
           chain = RunnableLambda(bad_code)
           chain.invoke('Hello!')
         ```

.github/ISSUE_TEMPLATE/config.yml

@@ -1,9 +1,6 @@
 blank_issues_enabled: false
 version: 2.1
 contact_links:
-  - name: 📚 Documentation
-    url: https://github.com/langchain-ai/docs/issues/new?template=langchain.yml
-    about: Report an issue related to the LangChain documentation
-  - name: 💬 LangChain Forum
-    url:  https://forum.langchain.com/
-    about: General community discussions and support
+  - name: LangChain Forum
+    url: https://forum.langchain.com/
+    about: General community discussions, support, and feature requests

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,59 @@
+name: Documentation
+description: Report an issue related to the LangChain documentation.
+title: "docs: <Please write a comprehensive title after the 'docs: ' prefix>"
+labels: [documentation]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report an issue in the documentation.
+
+        Only report issues with documentation here, explain if there are
+        any missing topics or if you found a mistake in the documentation.
+
+        Do **NOT** use this to ask usage questions or reporting issues with your code.
+
+        If you have usage questions or need help solving some problem, 
+        please use the [LangChain Forum](https://forum.langchain.com/).
+
+        If you're in the wrong place, here are some helpful links to find a better
+        place to ask your question:
+
+        * [LangChain Forum](https://forum.langchain.com/),
+        * [LangChain Github Issues](https://github.com/langchain-ai/langchain/issues?q=is%3Aissue),
+        * [LangChain documentation with the integrated search](https://python.langchain.com/docs/get_started/introduction),
+        * [LangChain how-to guides](https://python.langchain.com/docs/how_to/),
+        * [API Reference](https://python.langchain.com/api_reference/),
+        * [LangChain ChatBot](https://chat.langchain.com/)
+        * [GitHub search](https://github.com/langchain-ai/langchain),
+  - type: input
+    id: url
+    attributes:
+      label: URL
+      description: URL to documentation
+    validations:
+      required: false
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      description: Please confirm and check all the following options.
+      options:
+        - label: I added a very descriptive title to this issue.
+          required: true
+        - label: I included a link to the documentation page I am referring to (if applicable).
+          required: true
+  - type: textarea
+    attributes:
+      label: "Issue with current documentation:"
+      description: >
+        Please make sure to leave a reference to the document/code you're
+        referring to. Feel free to include names of classes, functions, methods
+        or concepts you'd like to see documented more.
+  - type: textarea
+    attributes:
+      label: "Idea or request for content:"
+      description: >
+        Please describe as clearly as possible what topics you think are missing
+        from the current documentation.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,118 +0,0 @@
-name: "✨ Feature Request"
-description: Request a new feature or enhancement for LangChain. For questions, please use the LangChain forum.
-labels: ["feature request"]
-type: feature
-body:
-  - type: markdown
-    attributes:
-      value: |
-        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/).
-
-        Relevant links to check before filing a feature request to see if your request has already been made or
-        if there's another way to achieve what you want:
-
-        * [LangChain Forum](https://forum.langchain.com/),
-        * [LangChain documentation with the integrated search](https://docs.langchain.com/oss/python/langchain/overview),
-        * [API Reference](https://python.langchain.com/api_reference/),
-        * [LangChain ChatBot](https://chat.langchain.com/)
-        * [GitHub search](https://github.com/langchain-ai/langchain),
-  - type: checkboxes
-    id: checks
-    attributes:
-      label: Checked other resources
-      description: Please confirm and check all the following options.
-      options:
-        - label: This is a feature request, not a bug report or usage question.
-          required: true
-        - label: I added a clear and descriptive title that summarizes the feature request.
-          required: true
-        - label: I used the GitHub search to find a similar feature request and didn't find it.
-          required: true
-        - label: I checked the LangChain documentation and API reference to see if this feature already exists.
-          required: true
-        - label: This is not related to the langchain-community package.
-          required: true
-  - type: textarea
-    id: feature-description
-    validations:
-      required: true
-    attributes:
-      label: Feature Description
-      description: |
-        Please provide a clear and concise description of the feature you would like to see added to LangChain.
-
-        What specific functionality are you requesting? Be as detailed as possible.
-      placeholder: |
-        I would like LangChain to support...
-
-        This feature would allow users to...
-  - type: textarea
-    id: use-case
-    validations:
-      required: true
-    attributes:
-      label: Use Case
-      description: |
-        Describe the specific use case or problem this feature would solve.
-
-        Why do you need this feature? What problem does it solve for you or other users?
-      placeholder: |
-        I'm trying to build an application that...
-
-        Currently, I have to work around this by...
-
-        This feature would help me/users to...
-  - type: textarea
-    id: proposed-solution
-    validations:
-      required: false
-    attributes:
-      label: Proposed Solution
-      description: |
-        If you have ideas about how this feature could be implemented, please describe them here.
-
-        This is optional but can be helpful for maintainers to understand your vision.
-      placeholder: |
-        I think this could be implemented by...
-
-        The API could look like...
-
-        ```python
-        # Example of how the feature might work
-        ```
-  - type: textarea
-    id: alternatives
-    validations:
-      required: false
-    attributes:
-      label: Alternatives Considered
-      description: |
-        Have you considered any alternative solutions or workarounds?
-
-        What other approaches have you tried or considered?
-      placeholder: |
-        I've tried using...
-
-        Alternative approaches I considered:
-        1. ...
-        2. ...
-
-        But these don't work because...
-  - type: textarea
-    id: additional-context
-    validations:
-      required: false
-    attributes:
-      label: Additional Context
-      description: |
-        Add any other context, screenshots, examples, or references that would help explain your feature request.
-      placeholder: |
-        Related issues: #...
-
-        Similar features in other libraries:
-        - ...
-
-        Additional context or examples:
-        - ...

.github/ISSUE_TEMPLATE/privileged.yml

@@ -4,7 +4,12 @@ body:
   - type: markdown
     attributes:
       value: |
-        If you are not a LangChain maintainer, employee, or were not asked directly by a maintainer to create an issue, then please start the conversation on the [LangChain Forum](https://forum.langchain.com/) instead.
+        Thanks for your interest in LangChain! 🚀
+
+        If you are not a LangChain maintainer or were not asked directly by a maintainer to create an issue, then please start the conversation on the [LangChain Forum](https://forum.langchain.com/) instead.
+
+        You are a LangChain maintainer if you maintain any of the packages inside of the LangChain repository 
+        or are a regular contributor to LangChain with previous merged pull requests.
   - type: checkboxes
     id: privileged
     attributes:

.github/ISSUE_TEMPLATE/task.yml

@@ -1,91 +0,0 @@
-name: "📋 Task"
-description: Create a task for project management and tracking by LangChain maintainers. If you are not a maintainer, please use other templates or the forum.
-labels: ["task"]
-type: task
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for creating a task to help organize LangChain development.
-
-        This template is for **maintainer tasks** such as project management, development planning, refactoring, documentation updates, and other organizational work.
-
-        If you are not a LangChain maintainer or were not asked directly by a maintainer to create a task, then please start the conversation on the [LangChain Forum](https://forum.langchain.com/) instead or use the appropriate bug report or feature request templates on the previous page.
-  - type: checkboxes
-    id: maintainer
-    attributes:
-      label: Maintainer task
-      description: Confirm that you are allowed to create a task here.
-      options:
-        - label: I am a LangChain maintainer, or was asked directly by a LangChain maintainer to create a task here.
-          required: true
-  - type: textarea
-    id: task-description
-    attributes:
-      label: Task Description
-      description: |
-        Provide a clear and detailed description of the task.
-        
-        What needs to be done? Be specific about the scope and requirements.
-      placeholder: |
-        This task involves...
-        
-        The goal is to...
-        
-        Specific requirements:
-        - ...
-        - ...
-    validations:
-      required: true
-  - type: textarea
-    id: acceptance-criteria
-    attributes:
-      label: Acceptance Criteria
-      description: |
-        Define the criteria that must be met for this task to be considered complete.
-        
-        What are the specific deliverables or outcomes expected?
-      placeholder: |
-        This task will be complete when:
-        - [ ] ...
-        - [ ] ...
-        - [ ] ...
-    validations:
-      required: true
-  - type: textarea
-    id: context
-    attributes:
-      label: Context and Background
-      description: |
-        Provide any relevant context, background information, or links to related issues/PRs.
-        
-        Why is this task needed? What problem does it solve?
-      placeholder: |
-        Background:
-        - ...
-        
-        Related issues/PRs:
-        - #...
-        
-        Additional context:
-        - ...
-    validations:
-      required: false
-  - type: textarea
-    id: dependencies
-    attributes:
-      label: Dependencies
-      description: |
-        List any dependencies or blockers for this task.
-        
-        Are there other tasks, issues, or external factors that need to be completed first?
-      placeholder: |
-        This task depends on:
-        - [ ] Issue #...
-        - [ ] PR #...
-        - [ ] External dependency: ...
-        
-        Blocked by:
-        - ...
-    validations:
-      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,3 @@
-(Replace this entire block of text)
-
 Thank you for contributing to LangChain! Follow these steps to mark your pull request as ready for review. **If any of these steps are not completed, your PR will not be considered for review.**
 
 - [ ] **PR title**: Follows the format: {TYPE}({SCOPE}): {DESCRIPTION}
@@ -11,13 +9,14 @@ Thank you for contributing to LangChain! Follow these steps to mark your pull re
     - feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert, release
   - Allowed `{SCOPE}` values (optional):
     - core, cli, langchain, standard-tests, docs, anthropic, chroma, deepseek, exa, fireworks, groq, huggingface, mistralai, nomic, ollama, openai, perplexity, prompty, qdrant, xai
-  - *Note:* the `{DESCRIPTION}` must not start with an uppercase letter.
+  - Note: the `{DESCRIPTION}` must not start with an uppercase letter.
   - Once you've written the title, please delete this checklist item; do not include it in the PR.
 
 - [ ] **PR message**: ***Delete this entire checklist*** and replace with
   - **Description:** a description of the change. Include a [closing keyword](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword) if applicable to a relevant issue.
   - **Issue:** the issue # it fixes, if applicable (e.g. Fixes #123)
   - **Dependencies:** any dependencies required for this change
+  - **Twitter handle:** if your PR gets announced, and you'd like a mention, we'll gladly shout you out!
 
 - [ ] **Add tests and docs**: If you're adding a new integration, you must include:
   1. A test for the integration, preferably unit tests that do not rely on network access,
@@ -27,7 +26,7 @@ Thank you for contributing to LangChain! Follow these steps to mark your pull re
 
 Additional guidelines:
 
-- Most PRs should not touch more than one package.
-- Please do not add dependencies to `pyproject.toml` files (even optional ones) unless they are **required** for unit tests.
-- Changes should be backwards compatible.
 - Make sure optional dependencies are imported within a function.
+- Please do not add dependencies to `pyproject.toml` files (even optional ones) unless they are **required** for unit tests.
+- Most PRs should not touch more than one package.
+- Changes should be backwards compatible.

.github/actions/people/Dockerfile

@@ -4,4 +4,4 @@ RUN pip install httpx PyGithub "pydantic==2.0.2" pydantic-settings "pyyaml>=5.3.
 
 COPY ./app /app
 
-CMD ["python", "/app/main.py"]
+CMD ["python", "/app/main.py"]

.github/actions/people/action.yml

@@ -1,13 +1,11 @@
 # Adapted from https://github.com/tiangolo/fastapi/blob/master/.github/actions/people/action.yml
-# TODO: fix this, migrate to new docs repo?
-
 name: "Generate LangChain People"
 description: "Generate the data for the LangChain People page"
 author: "Jacob Lee <jacob@langchain.dev>"
 inputs:
   token:
-    description: "User token, to read the GitHub API. Can be passed in using {{ secrets.LANGCHAIN_PEOPLE_GITHUB_TOKEN }}"
+    description: 'User token, to read the GitHub API. Can be passed in using {{ secrets.LANGCHAIN_PEOPLE_GITHUB_TOKEN }}'
     required: true
 runs:
-  using: "docker"
-  image: "Dockerfile"
+  using: 'docker'
+  image: 'Dockerfile'

.github/actions/uv_setup/action.yml

@@ -1,24 +1,12 @@
-# Helper to set up Python and uv with caching
+# TODO: https://docs.astral.sh/uv/guides/integration/github/#caching
 
 name: uv-install
-description: Set up Python and uv with caching
+description: Set up Python and uv
 
 inputs:
   python-version:
     description: Python version, supporting MAJOR.MINOR only
     required: true
-  enable-cache:
-    description: Enable caching for uv dependencies
-    required: false
-    default: "true"
-  cache-suffix:
-    description: Custom cache key suffix for cache invalidation
-    required: false
-    default: ""
-  working-directory:
-    description: Working directory for cache glob scoping
-    required: false
-    default: "**"
 
 env:
   UV_VERSION: "0.5.25"
@@ -27,13 +15,7 @@ runs:
   using: composite
   steps:
     - name: Install uv and set the python version
-      uses: astral-sh/setup-uv@v6
+      uses: astral-sh/setup-uv@v5
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ inputs.python-version }}
-        enable-cache: ${{ inputs.enable-cache }}
-        cache-dependency-glob: |
-          ${{ inputs.working-directory }}/pyproject.toml
-          ${{ inputs.working-directory }}/uv.lock
-          ${{ inputs.working-directory }}/requirements*.txt
-        cache-suffix: ${{ inputs.cache-suffix }}

.github/pr-file-labeler.yml

@@ -1,80 +0,0 @@
-# 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:
-  - changed-files:
-      - any-glob-to-any-file:
-          - "libs/langchain/**/*"
-          - "libs/langchain_v1/**/*"
-
-v1:
-  - 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/**/*"
-
-# Partner integrations
-integration:
-  - changed-files:
-      - any-glob-to-any-file:
-          - "libs/partners/**/*"
-
-# Infrastructure and DevOps
-infra:
-  - changed-files:
-      - any-glob-to-any-file:
-          - ".github/**/*"
-          - "Makefile"
-          - ".pre-commit-config.yaml"
-          - "scripts/**/*"
-          - "docker/**/*"
-          - "Dockerfile*"
-
-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"
-
-# Documentation
-documentation:
-  - changed-files:
-      - any-glob-to-any-file:
-          - "docs/**/*"
-          - "**/*.md"
-          - "**/*.rst"
-          - "**/README*"
-
-# Security related changes
-security:
-  - changed-files:
-      - any-glob-to-any-file:
-          - "**/*security*"
-          - "**/*auth*"
-          - "**/*credential*"
-          - "**/*secret*"
-          - "**/*token*"
-          - ".github/workflows/security*"

.github/pr-title-labeler.yml

@@ -1,41 +0,0 @@
-# PR title labeler config
-#
-# Labels PRs based on conventional commit patterns in titles
-#
-# Format: type(scope): description or type!: description (breaking)
-
-add-missing-labels: true
-clear-prexisting: false
-include-commits: false
-include-title: true
-label-for-breaking-changes: breaking
-
-label-mapping:
-  documentation: ["docs"]
-  feature: ["feat"]
-  fix: ["fix"]
-  infra: ["build", "ci", "chore"]
-  integration:
-    [
-      "anthropic",
-      "chroma",
-      "deepseek",
-      "exa",
-      "fireworks",
-      "groq",
-      "huggingface",
-      "mistralai",
-      "nomic",
-      "ollama",
-      "openai",
-      "perplexity",
-      "prompty",
-      "qdrant",
-      "xai",
-    ]
-  linting: ["style"]
-  performance: ["perf"]
-  refactor: ["refactor"]
-  release: ["release"]
-  revert: ["revert"]
-  tests: ["test"]

.github/scripts/check_diff.py

@@ -1,30 +1,17 @@
-"""Analyze git diffs to determine which directories need to be tested.
-
-Intelligently determines which LangChain packages and directories need to be tested,
-linted, or built based on the changes. Handles dependency relationships between
-packages, maps file changes to appropriate CI job configurations, and outputs JSON
-configurations for GitHub Actions.
-
-- Maps changed files to affected package directories (libs/core, libs/partners/*, etc.)
-- Builds dependency graph to include dependent packages when core components change
-- Generates test matrix configurations with appropriate Python versions
-- Handles special cases for Pydantic version testing and performance benchmarks
-
-Used as part of the check_diffs workflow.
-"""
-
 import glob
 import json
 import os
 import sys
 from collections import defaultdict
-from pathlib import Path
 from typing import Dict, List, Set
-
+from pathlib import Path
 import tomllib
-from get_min_versions import get_min_version_from_toml
+
 from packaging.requirements import Requirement
 
+from get_min_versions import get_min_version_from_toml
+
+
 LANGCHAIN_DIRS = [
     "libs/core",
     "libs/text-splitters",
@@ -32,7 +19,7 @@ LANGCHAIN_DIRS = [
     "libs/langchain_v1",
 ]
 
-# When set to True, we are ignoring core dependents
+# when set to True, we are ignoring core dependents
 # in order to be able to get CI to pass for each individual
 # package that depends on core
 # e.g. if you touch core, we don't then add textsplitters/etc to CI
@@ -51,7 +38,7 @@ IGNORED_PARTNERS = [
 ]
 
 PY_312_MAX_PACKAGES = [
-    "libs/partners/chroma",  # https://github.com/chroma-core/chroma/issues/4382
+    "libs/partners/chroma", # https://github.com/chroma-core/chroma/issues/4382
 ]
 
 
@@ -64,9 +51,9 @@ def all_package_dirs() -> Set[str]:
 
 
 def dependents_graph() -> dict:
-    """Construct a mapping of package -> dependents
-
-    Done such that we can run tests on all dependents of a package when a change is made.
+    """
+    Construct a mapping of package -> dependents, such that we can
+    run tests on all dependents of a package when a change is made.
     """
     dependents = defaultdict(set)
 
@@ -98,9 +85,9 @@ def dependents_graph() -> dict:
                 for depline in extended_deps:
                     if depline.startswith("-e "):
                         # editable dependency
-                        assert depline.startswith("-e ../partners/"), (
-                            "Extended test deps should only editable install partner packages"
-                        )
+                        assert depline.startswith(
+                            "-e ../partners/"
+                        ), "Extended test deps should only editable install partner packages"
                         partner = depline.split("partners/")[1]
                         dep = f"langchain-{partner}"
                     else:
@@ -138,16 +125,15 @@ def _get_configs_for_single_dir(job: str, dir_: str) -> List[Dict[str, str]]:
     elif dir_ == "libs/core":
         py_versions = ["3.9", "3.10", "3.11", "3.12", "3.13"]
     # custom logic for specific directories
+    elif dir_ == "libs/partners/milvus":
+        # milvus doesn't allow 3.12 because they declare deps in funny way
+        py_versions = ["3.9", "3.11"]
 
     elif dir_ in PY_312_MAX_PACKAGES:
         py_versions = ["3.9", "3.12"]
 
     elif dir_ == "libs/langchain" and job == "extended-tests":
         py_versions = ["3.9", "3.13"]
-    elif dir_ == "libs/langchain_v1":
-        py_versions = ["3.10", "3.13"]
-    elif dir_ in {"libs/cli"}:
-        py_versions = ["3.10", "3.13"]
 
     elif dir_ == ".":
         # unable to install with 3.13 because tokenizers doesn't support 3.13 yet
@@ -285,7 +271,7 @@ if __name__ == "__main__":
                     dirs_to_run["extended-test"].add(dir_)
         elif file.startswith("libs/standard-tests"):
             # TODO: update to include all packages that rely on standard-tests (all partner packages)
-            # Note: won't run on external repo partners
+            # note: won't run on external repo partners
             dirs_to_run["lint"].add("libs/standard-tests")
             dirs_to_run["test"].add("libs/standard-tests")
             dirs_to_run["lint"].add("libs/cli")
@@ -299,7 +285,7 @@ if __name__ == "__main__":
         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 [
@@ -317,10 +303,7 @@ if __name__ == "__main__":
                 f"Unknown lib: {file}. check_diff.py likely needs "
                 "an update for this new library!"
             )
-        elif file.startswith("docs/") or file in [
-            "pyproject.toml",
-            "uv.lock",
-        ]:  # docs or root uv files
+        elif file.startswith("docs/") or file in ["pyproject.toml", "uv.lock"]: # docs or root uv files
             docs_edited = True
             dirs_to_run["lint"].add(".")
 

.github/scripts/check_prerelease_dependencies.py

@@ -1,21 +1,19 @@
-"""Check that no dependencies allow prereleases unless we're releasing a prerelease."""
-
 import sys
-
 import tomllib
 
 if __name__ == "__main__":
     # Get the TOML file path from the command line argument
     toml_file = sys.argv[1]
 
+    # read toml file
     with open(toml_file, "rb") as file:
         toml_data = tomllib.load(file)
 
-    # See if we're releasing an rc or dev version
+    # see if we're releasing an rc
     version = toml_data["project"]["version"]
     releasing_rc = "rc" in version or "dev" in version
 
-    # If not, iterate through dependencies and make sure none allow prereleases
+    # if not, iterate through dependencies and make sure none allow prereleases
     if not releasing_rc:
         dependencies = toml_data["project"]["dependencies"]
         for dep_version in dependencies:

.github/scripts/get_min_versions.py

@@ -1,22 +1,24 @@
-"""Get minimum versions of dependencies from a pyproject.toml file."""
-
-import sys
 from collections import defaultdict
+import sys
 from typing import Optional
 
 if sys.version_info >= (3, 11):
     import tomllib
 else:
-    # For Python 3.10 and below, which doesnt have stdlib tomllib
+    # for python 3.10 and below, which doesnt have stdlib tomllib
     import tomli as tomllib
 
-import re
-from typing import List
-
-import requests
 from packaging.requirements import Requirement
 from packaging.specifiers import SpecifierSet
-from packaging.version import Version, parse
+from packaging.version import Version
+
+
+import requests
+from packaging.version import parse
+from typing import List
+
+import re
+
 
 MIN_VERSION_LIBS = [
     "langchain-core",
@@ -36,13 +38,14 @@ SKIP_IF_PULL_REQUEST = [
 
 
 def get_pypi_versions(package_name: str) -> List[str]:
-    """Fetch all available versions for a package from PyPI.
+    """
+    Fetch all available versions for a package from PyPI.
 
     Args:
-        package_name: Name of the package
+        package_name (str): Name of the package
 
     Returns:
-        List of all available versions
+        List[str]: List of all available versions
 
     Raises:
         requests.exceptions.RequestException: If PyPI API request fails
@@ -55,26 +58,25 @@ def get_pypi_versions(package_name: str) -> List[str]:
 
 
 def get_minimum_version(package_name: str, spec_string: str) -> Optional[str]:
-    """Find the minimum published version that satisfies the given constraints.
+    """
+    Find the minimum published version that satisfies the given constraints.
 
     Args:
-        package_name: Name of the package
-        spec_string: Version specification string (e.g., ">=0.2.43,<0.4.0,!=0.3.0")
+        package_name (str): Name of the package
+        spec_string (str): Version specification string (e.g., ">=0.2.43,<0.4.0,!=0.3.0")
 
     Returns:
-        Minimum compatible version or None if no compatible version found
+        Optional[str]: Minimum compatible version or None if no compatible version found
     """
-    # Rewrite occurrences of ^0.0.z to 0.0.z (can be anywhere in constraint string)
+    # rewrite occurrences of ^0.0.z to 0.0.z (can be anywhere in constraint string)
     spec_string = re.sub(r"\^0\.0\.(\d+)", r"0.0.\1", spec_string)
-    # Rewrite occurrences of ^0.y.z to >=0.y.z,<0.y+1 (can be anywhere in constraint string)
+    # rewrite occurrences of ^0.y.z to >=0.y.z,<0.y+1 (can be anywhere in constraint string)
     for y in range(1, 10):
-        spec_string = re.sub(
-            rf"\^0\.{y}\.(\d+)", rf">=0.{y}.\1,<0.{y + 1}", spec_string
-        )
-    # Rewrite occurrences of ^x.y.z to >=x.y.z,<x+1.0.0 (can be anywhere in constraint string)
+        spec_string = re.sub(rf"\^0\.{y}\.(\d+)", rf">=0.{y}.\1,<0.{y+1}", spec_string)
+    # rewrite occurrences of ^x.y.z to >=x.y.z,<x+1.0.0 (can be anywhere in constraint string)
     for x in range(1, 10):
         spec_string = re.sub(
-            rf"\^{x}\.(\d+)\.(\d+)", rf">={x}.\1.\2,<{x + 1}", spec_string
+            rf"\^{x}\.(\d+)\.(\d+)", rf">={x}.\1.\2,<{x+1}", spec_string
         )
 
     spec_set = SpecifierSet(spec_string)
@@ -154,28 +156,25 @@ def get_min_version_from_toml(
 
 
 def check_python_version(version_string, constraint_string):
-    """Check if the given Python version matches the given constraints.
+    """
+    Check if the given Python version matches the given constraints.
 
-    Args:
-        version_string: A string representing the Python version (e.g. "3.8.5").
-        constraint_string: A string representing the package's Python version
-            constraints (e.g. ">=3.6, <4.0").
-
-    Returns:
-        True if the version matches the constraints
+    :param version_string: A string representing the Python version (e.g. "3.8.5").
+    :param constraint_string: A string representing the package's Python version constraints (e.g. ">=3.6, <4.0").
+    :return: True if the version matches the constraints, False otherwise.
     """
 
-    # Rewrite occurrences of ^0.0.z to 0.0.z (can be anywhere in constraint string)
+    # rewrite occurrences of ^0.0.z to 0.0.z (can be anywhere in constraint string)
     constraint_string = re.sub(r"\^0\.0\.(\d+)", r"0.0.\1", constraint_string)
-    # Rewrite occurrences of ^0.y.z to >=0.y.z,<0.y+1.0 (can be anywhere in constraint string)
+    # rewrite occurrences of ^0.y.z to >=0.y.z,<0.y+1.0 (can be anywhere in constraint string)
     for y in range(1, 10):
         constraint_string = re.sub(
-            rf"\^0\.{y}\.(\d+)", rf">=0.{y}.\1,<0.{y + 1}.0", constraint_string
+            rf"\^0\.{y}\.(\d+)", rf">=0.{y}.\1,<0.{y+1}.0", constraint_string
         )
-    # Rewrite occurrences of ^x.y.z to >=x.y.z,<x+1.0.0 (can be anywhere in constraint string)
+    # rewrite occurrences of ^x.y.z to >=x.y.z,<x+1.0.0 (can be anywhere in constraint string)
     for x in range(1, 10):
         constraint_string = re.sub(
-            rf"\^{x}\.0\.(\d+)", rf">={x}.0.\1,<{x + 1}.0.0", constraint_string
+            rf"\^{x}\.0\.(\d+)", rf">={x}.0.\1,<{x+1}.0.0", constraint_string
         )
 
     try:

.github/scripts/prep_api_docs_build.py

@@ -1,19 +1,15 @@
 #!/usr/bin/env python
-"""Sync libraries from various repositories into this monorepo.
-
-Moves cloned partner packages into libs/partners structure.
-"""
+"""Script to sync libraries from various repositories into the main langchain repository."""
 
 import os
 import shutil
-from pathlib import Path
-from typing import Any, Dict
-
 import yaml
+from pathlib import Path
+from typing import Dict, Any
 
 
 def load_packages_yaml() -> Dict[str, Any]:
-    """Load and parse packages.yml."""
+    """Load and parse the packages.yml file."""
     with open("langchain/libs/packages.yml", "r") as f:
         return yaml.safe_load(f)
 
@@ -32,6 +28,7 @@ def get_target_dir(package_name: str) -> Path:
 def clean_target_directories(packages: list) -> None:
     """Remove old directories that will be replaced."""
     for package in packages:
+
         target_dir = get_target_dir(package["name"])
         if target_dir.exists():
             print(f"Removing {target_dir}")
@@ -41,6 +38,7 @@ def clean_target_directories(packages: list) -> None:
 def move_libraries(packages: list) -> None:
     """Move libraries from their source locations to the target directories."""
     for package in packages:
+
         repo_name = package["repo"].split("/")[1]
         source_path = package["path"]
         target_dir = get_target_dir(package["name"])
@@ -64,46 +62,31 @@ def move_libraries(packages: list) -> None:
 
 
 def main():
-    """Orchestrate the library sync process."""
+    """Main function to orchestrate the library sync process."""
     try:
         # Load packages configuration
         package_yaml = load_packages_yaml()
 
-        # Clean/empty target directories in preparation for moving new ones
-        #
-        # Only for packages in the langchain-ai org or explicitly included via
-        # include_in_api_ref, excluding 'langchain' itself and 'langchain-ai21'
-        clean_target_directories(
-            [
-                p
-                for p in package_yaml["packages"]
-                if (
-                    p["repo"].startswith("langchain-ai/") or p.get("include_in_api_ref")
-                )
-                and p["repo"] != "langchain-ai/langchain"
-                and p["name"]
-                != "langchain-ai21"  # Skip AI21 due to dependency conflicts
-            ]
-        )
+        # Clean target directories
+        clean_target_directories([
+            p
+            for p in package_yaml["packages"]
+            if (p["repo"].startswith("langchain-ai/") or p.get("include_in_api_ref"))
+            and p["repo"] != "langchain-ai/langchain"
+            and p["name"] != "langchain-ai21"  # Skip AI21 due to dependency conflicts
+        ])
 
-        # Move cloned libraries to their new locations, only for packages in the
-        # langchain-ai org or explicitly included via include_in_api_ref,
-        # excluding 'langchain' itself and 'langchain-ai21'
-        move_libraries(
-            [
-                p
-                for p in package_yaml["packages"]
-                if not p.get("disabled", False)
-                and (
-                    p["repo"].startswith("langchain-ai/") or p.get("include_in_api_ref")
-                )
-                and p["repo"] != "langchain-ai/langchain"
-                and p["name"]
-                != "langchain-ai21"  # Skip AI21 due to dependency conflicts
-            ]
-        )
+        # Move libraries to their new locations
+        move_libraries([
+            p
+            for p in package_yaml["packages"]
+            if not p.get("disabled", False)
+            and (p["repo"].startswith("langchain-ai/") or p.get("include_in_api_ref"))
+            and p["repo"] != "langchain-ai/langchain"
+            and p["name"] != "langchain-ai21"  # Skip AI21 due to dependency conflicts
+        ])
 
-        # Delete partner packages without a pyproject.toml
+        # Delete ones without a pyproject.toml
         for partner in Path("langchain/libs/partners").iterdir():
             if partner.is_dir() and not (partner / "pyproject.toml").exists():
                 print(f"Removing {partner} as it does not have a pyproject.toml")

.github/tools/git-restore-mtime

@@ -81,93 +81,56 @@ import time
 __version__ = "2022.12+dev"
 
 # Update symlinks only if the platform supports not following them
-UPDATE_SYMLINKS = bool(os.utime in getattr(os, "supports_follow_symlinks", []))
+UPDATE_SYMLINKS = bool(os.utime in getattr(os, 'supports_follow_symlinks', []))
 
 # Call os.path.normpath() only if not in a POSIX platform (Windows)
-NORMALIZE_PATHS = os.path.sep != "/"
+NORMALIZE_PATHS = (os.path.sep != '/')
 
 # How many files to process in each batch when re-trying merge commits
 STEPMISSING = 100
 
 # (Extra) keywords for the os.utime() call performed by touch()
-UTIME_KWS = {} if not UPDATE_SYMLINKS else {"follow_symlinks": False}
+UTIME_KWS = {} if not UPDATE_SYMLINKS else {'follow_symlinks': False}
 
 
 # Command-line interface ######################################################
 
-
 def parse_args():
-    parser = argparse.ArgumentParser(description=__doc__.split("\n---")[0])
+    parser = argparse.ArgumentParser(
+        description=__doc__.split('\n---')[0])
 
     group = parser.add_mutually_exclusive_group()
-    group.add_argument(
-        "--quiet",
-        "-q",
-        dest="loglevel",
-        action="store_const",
-        const=logging.WARNING,
-        default=logging.INFO,
-        help="Suppress informative messages and summary statistics.",
-    )
-    group.add_argument(
-        "--verbose",
-        "-v",
-        action="count",
-        help="""
+    group.add_argument('--quiet', '-q', dest='loglevel',
+        action="store_const", const=logging.WARNING, default=logging.INFO,
+        help="Suppress informative messages and summary statistics.")
+    group.add_argument('--verbose', '-v', action="count", help="""
         Print additional information for each processed file.
         Specify twice to further increase verbosity.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--cwd",
-        "-C",
-        metavar="DIRECTORY",
-        help="""
+    parser.add_argument('--cwd', '-C', metavar="DIRECTORY", help="""
         Run as if %(prog)s was started in directory %(metavar)s.
         This affects how --work-tree, --git-dir and PATHSPEC arguments are handled.
         See 'man 1 git' or 'git --help' for more information.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--git-dir",
-        dest="gitdir",
-        metavar="GITDIR",
-        help="""
+    parser.add_argument('--git-dir', dest='gitdir', metavar="GITDIR", help="""
         Path to the git repository, by default auto-discovered by searching
         the current directory and its parents for a .git/ subdirectory.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--work-tree",
-        dest="workdir",
-        metavar="WORKTREE",
-        help="""
+    parser.add_argument('--work-tree', dest='workdir', metavar="WORKTREE", help="""
         Path to the work tree root, by default the parent of GITDIR if it's
         automatically discovered, or the current directory if GITDIR is set.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--force",
-        "-f",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--force', '-f', default=False, action="store_true", help="""
         Force updating files with uncommitted modifications.
         Untracked files and uncommitted deletions, renames and additions are
         always ignored.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--merge",
-        "-m",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--merge', '-m', default=False, action="store_true", help="""
         Include merge commits.
         Leads to more recent times and more files per commit, thus with the same
         time, which may or may not be what you want.
@@ -175,130 +138,71 @@ def parse_args():
         are found sooner, which can improve performance, sometimes substantially.
         But as merge commits are usually huge, processing them may also take longer.
         By default, merge commits are only used for files missing from regular commits.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--first-parent",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--first-parent', default=False, action="store_true", help="""
         Consider only the first parent, the "main branch", when evaluating merge commits.
         Only effective when merge commits are processed, either when --merge is
         used or when finding missing files after the first regular log search.
         See --skip-missing.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--skip-missing",
-        "-s",
-        dest="missing",
-        default=True,
-        action="store_false",
-        help="""
+    parser.add_argument('--skip-missing', '-s', dest="missing", default=True,
+        action="store_false", help="""
         Do not try to find missing files.
         If merge commits were not evaluated with --merge and some files were
         not found in regular commits, by default %(prog)s searches for these
         files again in the merge commits.
         This option disables this retry, so files found only in merge commits
         will not have their timestamp updated.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--no-directories",
-        "-D",
-        dest="dirs",
-        default=True,
-        action="store_false",
-        help="""
+    parser.add_argument('--no-directories', '-D', dest='dirs', default=True,
+        action="store_false", help="""
         Do not update directory timestamps.
         By default, use the time of its most recently created, renamed or deleted file.
         Note that just modifying a file will NOT update its directory time.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--test",
-        "-t",
-        default=False,
-        action="store_true",
-        help="Test run: do not actually update any file timestamp.",
-    )
+    parser.add_argument('--test', '-t', default=False, action="store_true",
+        help="Test run: do not actually update any file timestamp.")
 
-    parser.add_argument(
-        "--commit-time",
-        "-c",
-        dest="commit_time",
-        default=False,
-        action="store_true",
-        help="Use commit time instead of author time.",
-    )
+    parser.add_argument('--commit-time', '-c', dest='commit_time', default=False,
+        action='store_true', help="Use commit time instead of author time.")
 
-    parser.add_argument(
-        "--oldest-time",
-        "-o",
-        dest="reverse_order",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--oldest-time', '-o', dest='reverse_order', default=False,
+        action='store_true', help="""
         Update times based on the oldest, instead of the most recent commit of a file.
         This reverses the order in which the git log is processed to emulate a
         file "creation" date. Note this will be inaccurate for files deleted and
         re-created at later dates.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--skip-older-than",
-        metavar="SECONDS",
-        type=int,
-        help="""
+    parser.add_argument('--skip-older-than', metavar='SECONDS', type=int, help="""
         Ignore files that are currently older than %(metavar)s.
         Useful in workflows that assume such files already have a correct timestamp,
         as it may improve performance by processing fewer files.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--skip-older-than-commit",
-        "-N",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--skip-older-than-commit', '-N', default=False,
+        action='store_true', help="""
         Ignore files older than the timestamp it would be updated to.
         Such files may be considered "original", likely in the author's repository.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--unique-times",
-        default=False,
-        action="store_true",
-        help="""
+    parser.add_argument('--unique-times', default=False, action="store_true", help="""
         Set the microseconds to a unique value per commit.
         Allows telling apart changes that would otherwise have identical timestamps,
         as git's time accuracy is in seconds.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "pathspec",
-        nargs="*",
-        metavar="PATHSPEC",
-        help="""
+    parser.add_argument('pathspec', nargs='*', metavar='PATHSPEC', help="""
         Only modify paths matching %(metavar)s, relative to current directory.
         By default, update all but untracked files and submodules.
-        """,
-    )
+        """)
 
-    parser.add_argument(
-        "--version",
-        "-V",
-        action="version",
-        version="%(prog)s version {version}".format(version=get_version()),
-    )
+    parser.add_argument('--version', '-V', action='version',
+        version='%(prog)s version {version}'.format(version=get_version()))
 
     args_ = parser.parse_args()
     if args_.verbose:
@@ -308,18 +212,17 @@ def parse_args():
 
 
 def get_version(version=__version__):
-    if not version.endswith("+dev"):
+    if not version.endswith('+dev'):
         return version
     try:
         cwd = os.path.dirname(os.path.realpath(__file__))
-        return Git(cwd=cwd, errors=False).describe().lstrip("v")
+        return Git(cwd=cwd, errors=False).describe().lstrip('v')
     except Git.Error:
-        return "-".join((version, "unknown"))
+        return '-'.join((version, "unknown"))
 
 
 # Helper functions ############################################################
 
-
 def setup_logging():
     """Add TRACE logging level and corresponding method, return the root logger"""
     logging.TRACE = TRACE = logging.DEBUG // 2
@@ -352,13 +255,11 @@ def normalize(path):
     if path and path[0] == '"':
         # Python 2: path = path[1:-1].decode("string-escape")
         # Python 3: https://stackoverflow.com/a/46650050/624066
-        path = (
-            path[1:-1]  # Remove enclosing double quotes
-            .encode("latin1")  # Convert to bytes, required by 'unicode-escape'
-            .decode("unicode-escape")  # Perform the actual octal-escaping decode
-            .encode("latin1")  # 1:1 mapping to bytes, UTF-8 encoded
-            .decode("utf8", "surrogateescape")
-        )  # Decode from UTF-8
+        path = (path[1:-1]                 # Remove enclosing double quotes
+                .encode('latin1')          # Convert to bytes, required by 'unicode-escape'
+                .decode('unicode-escape')  # Perform the actual octal-escaping decode
+                .encode('latin1')          # 1:1 mapping to bytes, UTF-8 encoded
+                .decode('utf8', 'surrogateescape'))  # Decode from UTF-8
     if NORMALIZE_PATHS:
         # Make sure the slash matches the OS; for Windows we need a backslash
         path = os.path.normpath(path)
@@ -381,12 +282,12 @@ def touch_ns(path, mtime_ns):
 
 def isodate(secs: int):
     # time.localtime() accepts floats, but discards fractional part
-    return time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(secs))
+    return time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(secs))
 
 
 def isodate_ns(ns: int):
     # for integers fromtimestamp() is equivalent and ~16% slower than isodate()
-    return datetime.datetime.fromtimestamp(ns / 1000000000).isoformat(sep=" ")
+    return datetime.datetime.fromtimestamp(ns / 1000000000).isoformat(sep=' ')
 
 
 def get_mtime_ns(secs: int, idx: int):
@@ -404,49 +305,35 @@ def get_mtime_path(path):
 
 # Git class and parse_log(), the heart of the script ##########################
 
-
 class Git:
     def __init__(self, workdir=None, gitdir=None, cwd=None, errors=True):
-        self.gitcmd = ["git"]
+        self.gitcmd = ['git']
         self.errors = errors
         self._proc = None
-        if workdir:
-            self.gitcmd.extend(("--work-tree", workdir))
-        if gitdir:
-            self.gitcmd.extend(("--git-dir", gitdir))
-        if cwd:
-            self.gitcmd.extend(("-C", cwd))
+        if workdir: self.gitcmd.extend(('--work-tree', workdir))
+        if gitdir:  self.gitcmd.extend(('--git-dir',   gitdir))
+        if cwd:     self.gitcmd.extend(('-C',          cwd))
         self.workdir, self.gitdir = self._get_repo_dirs()
 
     def ls_files(self, paths: list = None):
-        return (normalize(_) for _ in self._run("ls-files --full-name", paths))
+        return (normalize(_) for _ in self._run('ls-files --full-name', paths))
 
     def ls_dirty(self, force=False):
-        return (
-            normalize(_[3:].split(" -> ", 1)[-1])
-            for _ in self._run("status --porcelain")
-            if _[:2] != "??" and (not force or (_[0] in ("R", "A") or _[1] == "D"))
-        )
+        return (normalize(_[3:].split(' -> ', 1)[-1])
+                for _ in self._run('status --porcelain')
+                if _[:2] != '??' and (not force or (_[0] in ('R', 'A')
+                                                    or _[1] == 'D')))
 
-    def log(
-        self,
-        merge=False,
-        first_parent=False,
-        commit_time=False,
-        reverse_order=False,
-        paths: list = None,
-    ):
-        cmd = "whatchanged --pretty={}".format("%ct" if commit_time else "%at")
-        if merge:
-            cmd += " -m"
-        if first_parent:
-            cmd += " --first-parent"
-        if reverse_order:
-            cmd += " --reverse"
+    def log(self, merge=False, first_parent=False, commit_time=False,
+            reverse_order=False, paths: list = None):
+        cmd = 'whatchanged --pretty={}'.format('%ct' if commit_time else '%at')
+        if merge:         cmd += ' -m'
+        if first_parent:  cmd += ' --first-parent'
+        if reverse_order: cmd += ' --reverse'
         return self._run(cmd, paths)
 
     def describe(self):
-        return self._run("describe --tags", check=True)[0]
+        return self._run('describe --tags', check=True)[0]
 
     def terminate(self):
         if self._proc is None:
@@ -458,22 +345,18 @@ class Git:
             pass
 
     def _get_repo_dirs(self):
-        return (
-            os.path.normpath(_)
-            for _ in self._run(
-                "rev-parse --show-toplevel --absolute-git-dir", check=True
-            )
-        )
+        return (os.path.normpath(_) for _ in
+            self._run('rev-parse --show-toplevel --absolute-git-dir', check=True))
 
     def _run(self, cmdstr: str, paths: list = None, output=True, check=False):
         cmdlist = self.gitcmd + shlex.split(cmdstr)
         if paths:
-            cmdlist.append("--")
+            cmdlist.append('--')
             cmdlist.extend(paths)
-        popen_args = dict(universal_newlines=True, encoding="utf8")
+        popen_args = dict(universal_newlines=True, encoding='utf8')
         if not self.errors:
-            popen_args["stderr"] = subprocess.DEVNULL
-        log.trace("Executing: %s", " ".join(cmdlist))
+            popen_args['stderr'] = subprocess.DEVNULL
+        log.trace("Executing: %s", ' '.join(cmdlist))
         if not output:
             return subprocess.call(cmdlist, **popen_args)
         if check:
@@ -496,26 +379,30 @@ def parse_log(filelist, dirlist, stats, git, merge=False, filterlist=None):
     mtime = 0
     datestr = isodate(0)
     for line in git.log(
-        merge, args.first_parent, args.commit_time, args.reverse_order, filterlist
+            merge,
+            args.first_parent,
+            args.commit_time,
+            args.reverse_order,
+            filterlist
     ):
-        stats["loglines"] += 1
+        stats['loglines'] += 1
 
         # Blank line between Date and list of files
         if not line:
             continue
 
         # Date line
-        if line[0] != ":":  # Faster than `not line.startswith(':')`
-            stats["commits"] += 1
+        if line[0] != ':':  # Faster than `not line.startswith(':')`
+            stats['commits'] += 1
             mtime = int(line)
             if args.unique_times:
-                mtime = get_mtime_ns(mtime, stats["commits"])
+                mtime = get_mtime_ns(mtime, stats['commits'])
             if args.debug:
                 datestr = isodate(mtime)
             continue
 
         # File line: three tokens if it describes a renaming, otherwise two
-        tokens = line.split("\t")
+        tokens = line.split('\t')
 
         # Possible statuses:
         # M: Modified (content changed)
@@ -524,7 +411,7 @@ def parse_log(filelist, dirlist, stats, git, merge=False, filterlist=None):
         # T: Type changed: to/from regular file, symlinks, submodules
         # R099: Renamed (moved), with % of unchanged content. 100 = pure rename
         # Not possible in log: C=Copied, U=Unmerged, X=Unknown, B=pairing Broken
-        status = tokens[0].split(" ")[-1]
+        status = tokens[0].split(' ')[-1]
         file = tokens[-1]
 
         # Handles non-ASCII chars and OS path separator
@@ -532,76 +419,56 @@ def parse_log(filelist, dirlist, stats, git, merge=False, filterlist=None):
 
         def do_file():
             if args.skip_older_than_commit and get_mtime_path(file) <= mtime:
-                stats["skip"] += 1
+                stats['skip'] += 1
                 return
             if args.debug:
-                log.debug(
-                    "%d\t%d\t%d\t%s\t%s",
-                    stats["loglines"],
-                    stats["commits"],
-                    stats["files"],
-                    datestr,
-                    file,
-                )
+                log.debug("%d\t%d\t%d\t%s\t%s",
+                          stats['loglines'], stats['commits'], stats['files'],
+                          datestr, file)
             try:
                 touch(os.path.join(git.workdir, file), mtime)
-                stats["touches"] += 1
+                stats['touches'] += 1
             except Exception as e:
                 log.error("ERROR: %s: %s", e, file)
-                stats["errors"] += 1
+                stats['errors'] += 1
 
         def do_dir():
             if args.debug:
-                log.debug(
-                    "%d\t%d\t-\t%s\t%s",
-                    stats["loglines"],
-                    stats["commits"],
-                    datestr,
-                    "{}/".format(dirname or "."),
-                )
+                log.debug("%d\t%d\t-\t%s\t%s",
+                          stats['loglines'], stats['commits'],
+                          datestr, "{}/".format(dirname or '.'))
             try:
                 touch(os.path.join(git.workdir, dirname), mtime)
-                stats["dirtouches"] += 1
+                stats['dirtouches'] += 1
             except Exception as e:
                 log.error("ERROR: %s: %s", e, dirname)
-                stats["direrrors"] += 1
+                stats['direrrors'] += 1
 
         if file in filelist:
-            stats["files"] -= 1
+            stats['files'] -= 1
             filelist.remove(file)
             do_file()
 
-        if args.dirs and status in ("A", "D"):
+        if args.dirs and status in ('A', 'D'):
             dirname = os.path.dirname(file)
             if dirname in dirlist:
                 dirlist.remove(dirname)
                 do_dir()
 
         # All files done?
-        if not stats["files"]:
+        if not stats['files']:
             git.terminate()
             return
 
 
 # Main Logic ##################################################################
 
-
 def main():
     start = time.time()  # yes, Wall time. CPU time is not realistic for users.
-    stats = {
-        _: 0
-        for _ in (
-            "loglines",
-            "commits",
-            "touches",
-            "skip",
-            "errors",
-            "dirtouches",
-            "direrrors",
-        )
-    }
+    stats = {_: 0 for _ in ('loglines', 'commits', 'touches', 'skip', 'errors',
+                            'dirtouches', 'direrrors')}
 
-    logging.basicConfig(level=args.loglevel, format="%(message)s")
+    logging.basicConfig(level=args.loglevel, format='%(message)s')
     log.trace("Arguments: %s", args)
 
     # First things first: Where and Who are we?
@@ -632,16 +499,13 @@ def main():
 
             # Symlink (to file, to dir or broken - git handles the same way)
             if not UPDATE_SYMLINKS and os.path.islink(fullpath):
-                log.warning(
-                    "WARNING: Skipping symlink, no OS support for updates: %s", path
-                )
+                log.warning("WARNING: Skipping symlink, no OS support for updates: %s",
+                            path)
                 continue
 
             # skip files which are older than given threshold
-            if (
-                args.skip_older_than
-                and start - get_mtime_path(fullpath) > args.skip_older_than
-            ):
+            if (args.skip_older_than
+                    and start - get_mtime_path(fullpath) > args.skip_older_than):
                 continue
 
             # Always add files relative to worktree root
@@ -655,17 +519,15 @@ def main():
     else:
         dirty = set(git.ls_dirty())
         if dirty:
-            log.warning(
-                "WARNING: Modified files in the working directory were ignored."
-                "\nTo include such files, commit your changes or use --force."
-            )
+            log.warning("WARNING: Modified files in the working directory were ignored."
+                "\nTo include such files, commit your changes or use --force.")
             filelist -= dirty
 
     # Build dir list to be processed
     dirlist = set(os.path.dirname(_) for _ in filelist) if args.dirs else set()
 
-    stats["totalfiles"] = stats["files"] = len(filelist)
-    log.info("{0:,} files to be processed in work dir".format(stats["totalfiles"]))
+    stats['totalfiles'] = stats['files'] = len(filelist)
+    log.info("{0:,} files to be processed in work dir".format(stats['totalfiles']))
 
     if not filelist:
         # Nothing to do. Exit silently and without errors, just like git does
@@ -682,18 +544,10 @@ def main():
         if args.missing and not args.merge:
             filterlist = list(filelist)
             missing = len(filterlist)
-            log.info(
-                "{0:,} files not found in log, trying merge commits".format(missing)
-            )
+            log.info("{0:,} files not found in log, trying merge commits".format(missing))
             for i in range(0, missing, STEPMISSING):
-                parse_log(
-                    filelist,
-                    dirlist,
-                    stats,
-                    git,
-                    merge=True,
-                    filterlist=filterlist[i : i + STEPMISSING],
-                )
+                parse_log(filelist, dirlist, stats, git,
+                          merge=True, filterlist=filterlist[i:i + STEPMISSING])
 
         # Still missing some?
         for file in filelist:
@@ -702,33 +556,29 @@ def main():
     # Final statistics
     # Suggestion: use git-log --before=mtime to brag about skipped log entries
     def log_info(msg, *a, width=13):
-        ifmt = "{:%d,}" % (width,)  # not using 'n' for consistency with ffmt
-        ffmt = "{:%d,.2f}" % (width,)
+        ifmt = '{:%d,}'    % (width,)  # not using 'n' for consistency with ffmt
+        ffmt = '{:%d,.2f}' % (width,)
         # %-formatting lacks a thousand separator, must pre-render with .format()
-        log.info(msg.replace("%d", ifmt).replace("%f", ffmt).format(*a))
+        log.info(msg.replace('%d', ifmt).replace('%f', ffmt).format(*a))
 
     log_info(
-        "Statistics:\n%f seconds\n%d log lines processed\n%d commits evaluated",
-        time.time() - start,
-        stats["loglines"],
-        stats["commits"],
-    )
+        "Statistics:\n"
+        "%f seconds\n"
+        "%d log lines processed\n"
+        "%d commits evaluated",
+        time.time() - start, stats['loglines'], stats['commits'])
 
     if args.dirs:
-        if stats["direrrors"]:
-            log_info("%d directory update errors", stats["direrrors"])
-        log_info("%d directories updated", stats["dirtouches"])
+        if stats['direrrors']: log_info("%d directory update errors", stats['direrrors'])
+        log_info("%d directories updated", stats['dirtouches'])
 
-    if stats["touches"] != stats["totalfiles"]:
-        log_info("%d files", stats["totalfiles"])
-    if stats["skip"]:
-        log_info("%d files skipped", stats["skip"])
-    if stats["files"]:
-        log_info("%d files missing", stats["files"])
-    if stats["errors"]:
-        log_info("%d file update errors", stats["errors"])
+    if stats['touches'] != stats['totalfiles']:
+                        log_info("%d files",              stats['totalfiles'])
+    if stats['skip']:   log_info("%d files skipped",      stats['skip'])
+    if stats['files']:  log_info("%d files missing",      stats['files'])
+    if stats['errors']: log_info("%d file update errors", stats['errors'])
 
-    log_info("%d files updated", stats["touches"])
+    log_info("%d files updated", stats['touches'])
 
     if args.test:
         log.info("TEST RUN - No files modified!")

.github/workflows/_compile_integration_test.yml

@@ -1,11 +1,3 @@
-# Validates that a package's integration tests compile without syntax or import errors.
-#
-# (If an integration test fails to compile, it won't run.)
-#
-# Called as part of check_diffs.yml workflow
-#
-# Runs pytest with compile marker to check syntax/imports.
-
 name: '🔗 Compile Integration Tests'
 
 on:
@@ -35,14 +27,12 @@ jobs:
     timeout-minutes: 20
     name: 'Python ${{ inputs.python-version }}'
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: compile-integration-tests-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
 
       - name: '📦 Install Integration Dependencies'
         shell: bash

.github/workflows/_integration_test.yml

@@ -1,10 +1,3 @@
-
-# Runs `make integration_tests` on the specified package.
-#
-# Manually triggered via workflow_dispatch for testing with real APIs.
-#
-# Installs integration test dependencies and executes full test suite.
-
 name: '🚀 Integration Tests'
 run-name: 'Test ${{ inputs.working-directory }} on Python ${{ inputs.python-version }}'
 
@@ -35,14 +28,12 @@ jobs:
     runs-on: ubuntu-latest
     name: 'Python ${{ inputs.python-version }}'
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: integration-tests-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
 
       - name: '📦 Install Integration Dependencies'
         shell: bash
@@ -90,7 +81,7 @@ jobs:
         run: |
           make integration_tests
 
-      - name: 'Ensure testing did not create/modify files'
+      - name: Ensure the tests did not create any additional files
         shell: bash
         run: |
           set -eu

.github/workflows/_lint.yml

@@ -1,11 +1,6 @@
-# Runs linting.
-#
-# Uses the package's Makefile to run the checks, specifically the
-# `lint_package` and `lint_tests` targets.
-#
-# Called as part of check_diffs.yml workflow.
-
-name: '🧹 Linting'
+name: '🧹 Code Linting'
+# Runs code quality checks using ruff, mypy, and other linting tools
+# Checks both package code and test code for consistency
 
 on:
   workflow_call:
@@ -38,16 +33,22 @@ jobs:
     timeout-minutes: 20
     steps:
       - name: '📋 Checkout Code'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: lint-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
 
       - name: '📦 Install Lint & Typing Dependencies'
+        # Also installs dev/lint/test/typing dependencies, to ensure we have
+        # type hints for as many of our libraries as possible.
+        # This helps catch errors that require dependencies to be spotted, for example:
+        # https://github.com/langchain-ai/langchain/pull/10249/files#diff-935185cd488d015f026dcd9e19616ff62863e8cde8c0bee70318d3ccbca98341
+        #
+        # If you change this configuration, make sure to change the `cache-key`
+        # in the `poetry_setup` action above to stop using the old cache.
+        # It doesn't matter how you change it, any change will cause a cache-bust.
         working-directory: ${{ inputs.working-directory }}
         run: |
           uv sync --group lint --group typing
@@ -57,13 +58,20 @@ jobs:
         run: |
           make lint_package
 
-      - name: '📦 Install Test Dependencies (non-partners)'
-        # (For directories NOT starting with libs/partners/)
+      - name: '📦 Install Unit Test Dependencies'
+        # Also installs dev/lint/test/typing dependencies, to ensure we have
+        # type hints for as many of our libraries as possible.
+        # This helps catch errors that require dependencies to be spotted, for example:
+        # https://github.com/langchain-ai/langchain/pull/10249/files#diff-935185cd488d015f026dcd9e19616ff62863e8cde8c0bee70318d3ccbca98341
+        #
+        # If you change this configuration, make sure to change the `cache-key`
+        # in the `poetry_setup` action above to stop using the old cache.
+        # It doesn't matter how you change it, any change will cause a cache-bust.
         if: ${{ ! startsWith(inputs.working-directory, 'libs/partners/') }}
         working-directory: ${{ inputs.working-directory }}
         run: |
           uv sync --inexact --group test
-      - name: '📦 Install Test Dependencies'
+      - name: '📦 Install Unit + Integration Test Dependencies'
         if: ${{ startsWith(inputs.working-directory, 'libs/partners/') }}
         working-directory: ${{ inputs.working-directory }}
         run: |

.github/workflows/_release.yml

@@ -1,9 +1,3 @@
-# Builds and publishes LangChain packages to PyPI.
-#
-# Manually triggered, though can be used as a reusable workflow (workflow_call).
-#
-# Handles version bumping, building, and publishing to PyPI with authentication.
-
 name: '🚀 Package Release'
 run-name: 'Release ${{ inputs.working-directory }} ${{ inputs.release-version }}'
 on:
@@ -49,7 +43,7 @@ jobs:
       version: ${{ steps.check-version.outputs.version }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python + uv
         uses: "./.github/actions/uv_setup"
@@ -58,8 +52,8 @@ jobs:
 
       # We want to keep this build stage *separate* from the release stage,
       # so that there's no sharing of permissions between them.
-      # (Release stage has trusted publishing and GitHub repo contents write access,
-      #
+      # The release stage has trusted publishing and GitHub repo contents write access,
+      # and we want to keep the scope of that access limited just to the release job.
       # Otherwise, a malicious `build` step (e.g. via a compromised dependency)
       # could get access to our GitHub or PyPI credentials.
       #
@@ -98,7 +92,7 @@ jobs:
     outputs:
       release-body: ${{ steps.generate-release-body.outputs.release-body }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           repository: langchain-ai/langchain
           path: langchain
@@ -189,36 +183,13 @@ jobs:
     needs:
       - build
       - release-notes
-    runs-on: ubuntu-latest
-    permissions:
-      # This permission is used for trusted publishing:
-      # https://blog.pypi.org/posts/2023-04-20-introducing-trusted-publishers/
-      #
-      # Trusted publishing has to also be configured on PyPI for each package:
-      # https://docs.pypi.org/trusted-publishers/adding-a-publisher/
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v5
-
-      - uses: actions/download-artifact@v5
-        with:
-          name: dist
-          path: ${{ inputs.working-directory }}/dist/
-
-      - name: Publish to test PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: ${{ inputs.working-directory }}/dist/
-          verbose: true
-          print-hash: true
-          repository-url: https://test.pypi.org/legacy/
-          # We overwrite any existing distributions with the same name and version.
-          # This is *only for CI use* and is *extremely dangerous* otherwise!
-          # https://github.com/pypa/gh-action-pypi-publish#tolerating-release-package-file-duplicates
-          skip-existing: true
-          # Temp workaround since attestations are on by default as of gh-action-pypi-publish v1.11.0
-          attestations: false
+    uses:
+      ./.github/workflows/_test_release.yml
+    permissions: write-all
+    with:
+      working-directory: ${{ inputs.working-directory }}
+      dangerous-nonmaster-release: ${{ inputs.dangerous-nonmaster-release }}
+    secrets: inherit
 
   pre-release-checks:
     needs:
@@ -228,7 +199,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       # We explicitly *don't* set up caching here. This ensures our tests are
       # maximally sensitive to catching breakage.
@@ -249,7 +220,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
@@ -294,19 +265,16 @@ jobs:
         run: |
           VIRTUAL_ENV=.venv uv pip install dist/*.whl
 
-      - name: Check for prerelease versions
-        # Block release if any dependencies allow prerelease versions
-        # (unless this is itself a prerelease version)
-        working-directory: ${{ inputs.working-directory }}
-        run: |
-          uv run python $GITHUB_WORKSPACE/.github/scripts/check_prerelease_dependencies.py pyproject.toml
-
       - name: Run unit tests
         run: make tests
         working-directory: ${{ inputs.working-directory }}
 
+      - name: Check for prerelease versions
+        working-directory: ${{ inputs.working-directory }}
+        run: |
+          uv run python $GITHUB_WORKSPACE/.github/scripts/check_prerelease_dependencies.py pyproject.toml
+
       - name: Get minimum versions
-        # Find the minimum published versions that satisfies the given constraints
         working-directory: ${{ inputs.working-directory }}
         id: min-version
         run: |
@@ -321,8 +289,7 @@ jobs:
         env:
           MIN_VERSIONS: ${{ steps.min-version.outputs.min-versions }}
         run: |
-          VIRTUAL_ENV=.venv uv pip install --force-reinstall --editable .
-          VIRTUAL_ENV=.venv uv pip install --force-reinstall $MIN_VERSIONS
+          VIRTUAL_ENV=.venv uv pip install --force-reinstall $MIN_VERSIONS --editable .
           make tests
         working-directory: ${{ inputs.working-directory }}
 
@@ -331,7 +298,6 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
       - name: Run integration tests
-        # Uses the Makefile's `integration_tests` target for the specified package
         if: ${{ startsWith(inputs.working-directory, 'libs/partners/') }}
         env:
           AI21_API_KEY: ${{ secrets.AI21_API_KEY }}
@@ -372,10 +338,7 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
   # Test select published packages against new core
-  # Done when code changes are made to langchain-core
   test-prior-published-packages-against-new-core:
-    # Installs the new core with old partners: Installs the new unreleased core
-    # alongside the previously published partner packages and runs integration tests
     needs:
       - build
       - release-notes
@@ -399,11 +362,10 @@ jobs:
       AZURE_OPENAI_LLM_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_LLM_DEPLOYMENT_NAME }}
       AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT_NAME: ${{ secrets.AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT_NAME }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       # We implement this conditional as Github Actions does not have good support
       # for conditionally needing steps. https://github.com/actions/runner/issues/491
-      # TODO: this seems to be resolved upstream, so we can probably remove this workaround
       - name: Check if libs/core
         run: |
           if [ "${{ startsWith(inputs.working-directory, 'libs/core') }}" != "true" ]; then
@@ -417,7 +379,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         if: startsWith(inputs.working-directory, 'libs/core')
         with:
           name: dist
@@ -426,12 +388,11 @@ jobs:
       - name: Test against ${{ matrix.partner }}
         if: startsWith(inputs.working-directory, 'libs/core')
         run: |
-          # Identify latest tag, excluding pre-releases
+          # Identify latest tag
           LATEST_PACKAGE_TAG="$(
             git ls-remote --tags origin "langchain-${{ matrix.partner }}*" \
             | awk '{print $2}' \
             | sed 's|refs/tags/||' \
-            | grep -E '==0\.3\.[0-9]+$' \
             | sort -Vr \
             | head -n 1
           )"
@@ -458,7 +419,6 @@ jobs:
           make integration_tests
 
   publish:
-    # Publishes the package to PyPI
     needs:
       - build
       - release-notes
@@ -479,14 +439,14 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python + uv
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
@@ -501,7 +461,6 @@ jobs:
           attestations: false
 
   mark-release:
-    # Marks the GitHub release with the new version tag
     needs:
       - build
       - release-notes
@@ -511,7 +470,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       # This permission is needed by `ncipollo/release-action` to
-      # create the GitHub release/tag
+      # create the GitHub release.
       contents: write
 
     defaults:
@@ -519,14 +478,14 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python + uv
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/

.github/workflows/_test.yml

@@ -1,7 +1,6 @@
-# Runs unit tests with both current and minimum supported dependency versions
-# to ensure compatibility across the supported range.
-
 name: '🧪 Unit Testing'
+# Runs unit tests with both current and minimum supported dependency versions
+# to ensure compatibility across the supported range
 
 on:
   workflow_call:
@@ -33,16 +32,13 @@ jobs:
     name: 'Python ${{ inputs.python-version }}'
     steps:
       - name: '📋 Checkout Code'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         id: setup-python
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: test-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
-
       - name: '📦 Install Test Dependencies'
         shell: bash
         run: uv sync --group test --dev
@@ -83,4 +79,4 @@ 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'
-
+          

.github/workflows/_test_doc_imports.yml

@@ -1,10 +1,3 @@
-# Validates that all import statements in `.ipynb` notebooks are correct and functional.
-#
-# Called as part of check_diffs.yml.
-#
-# Installs test dependencies and LangChain packages in editable mode and
-# runs check_imports.py.
-
 name: '📑 Documentation Import Testing'
 
 on:
@@ -28,14 +21,12 @@ jobs:
     name: '🔍 Check Doc Imports (Python ${{ inputs.python-version }})'
     steps:
       - name: '📋 Checkout Code'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: test-doc-imports-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
 
       - name: '📦 Install Test Dependencies'
         shell: bash

.github/workflows/_test_pydantic.yml

@@ -1,5 +1,3 @@
-# Facilitate unit testing against different Pydantic versions for a provided package.
-
 name: '🐍 Pydantic Version Testing'
 
 on:
@@ -36,14 +34,12 @@ jobs:
     name: 'Pydantic ~=${{ inputs.pydantic-version }}'
     steps:
       - name: '📋 Checkout Code'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ inputs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ inputs.python-version }}
-          cache-suffix: test-pydantic-${{ inputs.working-directory }}
-          working-directory: ${{ inputs.working-directory }}
 
       - name: '📦 Install Test Dependencies'
         shell: bash
@@ -68,4 +64,4 @@ 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'
+          echo "$STATUS" | grep 'nothing to commit, working tree clean'

.github/workflows/_test_release.yml

@@ -0,0 +1,106 @@
+name: '🧪 Test Release Package'
+
+on:
+  workflow_call:
+    inputs:
+      working-directory:
+        required: true
+        type: string
+        description: "From which folder this pipeline executes"
+      dangerous-nonmaster-release:
+        required: false
+        type: boolean
+        default: false
+        description: "Release from a non-master branch (danger!)"
+
+env:
+  PYTHON_VERSION: "3.11"
+  UV_FROZEN: "true"
+
+jobs:
+  build:
+    if: github.ref == 'refs/heads/master' || inputs.dangerous-nonmaster-release
+    runs-on: ubuntu-latest
+
+    outputs:
+      pkg-name: ${{ steps.check-version.outputs.pkg-name }}
+      version: ${{ steps.check-version.outputs.version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: '🐍 Set up Python + UV'
+        uses: "./.github/actions/uv_setup"
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      # We want to keep this build stage *separate* from the release stage,
+      # so that there's no sharing of permissions between them.
+      # The release stage has trusted publishing and GitHub repo contents write access,
+      # and we want to keep the scope of that access limited just to the release job.
+      # Otherwise, a malicious `build` step (e.g. via a compromised dependency)
+      # could get access to our GitHub or PyPI credentials.
+      #
+      # Per the trusted publishing GitHub Action:
+      # > It is strongly advised to separate jobs for building [...]
+      # > from the publish job.
+      # https://github.com/pypa/gh-action-pypi-publish#non-goals
+      - name: '📦 Build Project for Distribution'
+        run: uv build
+        working-directory: ${{ inputs.working-directory }}
+
+      - name: '⬆️ Upload Build Artifacts'
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-dist
+          path: ${{ inputs.working-directory }}/dist/
+
+      - name: '🔍 Extract Version Information'
+        id: check-version
+        shell: python
+        working-directory: ${{ inputs.working-directory }}
+        run: |
+          import os
+          import tomllib
+          with open("pyproject.toml", "rb") as f:
+              data = tomllib.load(f)
+          pkg_name = data["project"]["name"]
+          version = data["project"]["version"]
+          with open(os.environ["GITHUB_OUTPUT"], "a") as f:
+              f.write(f"pkg-name={pkg_name}\n")
+              f.write(f"version={version}\n")
+
+  publish:
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    permissions:
+      # This permission is used for trusted publishing:
+      # https://blog.pypi.org/posts/2023-04-20-introducing-trusted-publishers/
+      #
+      # Trusted publishing has to also be configured on PyPI for each package:
+      # https://docs.pypi.org/trusted-publishers/adding-a-publisher/
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: test-dist
+          path: ${{ inputs.working-directory }}/dist/
+
+      - name: Publish to test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: ${{ inputs.working-directory }}/dist/
+          verbose: true
+          print-hash: true
+          repository-url: https://test.pypi.org/legacy/
+
+          # We overwrite any existing distributions with the same name and version.
+          # This is *only for CI use* and is *extremely dangerous* otherwise!
+          # https://github.com/pypa/gh-action-pypi-publish#tolerating-release-package-file-duplicates
+          skip-existing: true
+          # Temp workaround since attestations are on by default as of gh-action-pypi-publish v1.11.0
+          attestations: false

.github/workflows/api_doc_build.yml

@@ -1,19 +1,11 @@
-# Build the API reference documentation.
-#
-# Runs daily. Can also be triggered manually for immediate updates.
-#
-# Built HTML pushed to langchain-ai/langchain-api-docs-html.
-#
-# Looks for langchain-ai org repos in packages.yml and checks them out.
-# Calls prep_api_docs_build.py.
-
 name: '📚 API Docs'
 run-name: 'Build & Deploy API Reference'
+# Runs daily or can be triggered manually for immediate updates
 
 on:
   workflow_dispatch:
   schedule:
-    - cron:  '0 13 * * *'  # Runs daily at 1PM UTC (9AM EDT/6AM PDT)
+    - cron:  '0 13 * * *'  # Daily at 1PM UTC
 env:
   PYTHON_VERSION: "3.11"
 
@@ -25,10 +17,10 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           path: langchain
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           repository: langchain-ai/langchain-api-docs-html
           path: langchain-api-docs-html
@@ -39,8 +31,6 @@ jobs:
         uses: mikefarah/yq@master
         with:
           cmd: |
-            # Extract repos from packages.yml that are in the langchain-ai org
-            # (excluding 'langchain' itself)
             yq '
               .packages[]
               | select(
@@ -82,36 +72,29 @@ jobs:
           done
 
       - name: '🐍 Setup Python ${{ env.PYTHON_VERSION }}'
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
         id: setup-python
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
-      - name: '📦 Install Initial Python Dependencies using uv'
+      - name: '📦 Install Initial Python Dependencies'
         working-directory: langchain
         run: |
           python -m pip install -U uv
           python -m uv pip install --upgrade --no-cache-dir pip setuptools pyyaml
 
       - name: '📦 Organize Library Directories'
-        # Places cloned partner packages into libs/partners structure
         run: python langchain/.github/scripts/prep_api_docs_build.py
 
-      - name: '🧹 Clear Prior Build'
+      - name: '🧹 Remove Old HTML Files'
         run:
-          # Remove artifacts from prior docs build
           rm -rf langchain-api-docs-html/api_reference_build/html
 
-      - name: '📦 Install Documentation Dependencies using uv'
+      - name: '📦 Install Documentation Dependencies'
         working-directory: langchain
         run: |
-          # Install all partner packages in editable mode with overrides
-          python -m uv pip install $(ls ./libs/partners | xargs -I {} echo "./libs/partners/{}") --overrides ./docs/vercel_overrides.txt --prerelease=allow
-
-          # Install core langchain and other main packages
+          python -m uv pip install $(ls ./libs/partners | xargs -I {} echo "./libs/partners/{}") --overrides ./docs/vercel_overrides.txt
           python -m uv pip install libs/core libs/langchain libs/text-splitters libs/community libs/experimental libs/standard-tests
-
-          # Install Sphinx and related packages for building docs
           python -m uv pip install -r docs/api_reference/requirements.txt
 
       - name: '🔧 Configure Git Settings'
@@ -123,29 +106,14 @@ jobs:
       - name: '📚 Build API Documentation'
         working-directory: langchain
         run: |
-          # Generate the API reference RST files
           python docs/api_reference/create_api_rst.py
-
-          # Build the HTML documentation using Sphinx
-          # -T: show full traceback on exception
-          # -E: don't use cached environment (force rebuild, ignore cached doctrees)
-          # -b html: build HTML docs (vs PDS, etc.)
-          # -d: path for the cached environment (parsed document trees / doctrees)
-          #     - Separate from output dir for faster incremental builds
-          # -c: path to conf.py
-          # -j auto: parallel build using all available CPU cores
           python -m sphinx -T -E -b html -d ../langchain-api-docs-html/_build/doctrees -c docs/api_reference docs/api_reference ../langchain-api-docs-html/api_reference_build/html -j auto
-
-          # Post-process the generated HTML
           python docs/api_reference/scripts/custom_formatter.py ../langchain-api-docs-html/api_reference_build/html
-
           # Default index page is blank so we copy in the actual home page.
           cp ../langchain-api-docs-html/api_reference_build/html/{reference,index}.html
-
-          # Removes Sphinx's intermediate build artifacts after the build is complete.
           rm -rf ../langchain-api-docs-html/_build/
 
-      # Commit and push changes to langchain-api-docs-html repo
+      # https://github.com/marketplace/actions/add-commit
       - uses: EndBug/add-and-commit@v9
         with:
           cwd: langchain-api-docs-html

.github/workflows/check-broken-links.yml

@@ -1,11 +1,9 @@
-# Runs broken link checker in /docs on a daily schedule.
-
 name: '🔗 Check Broken Links'
 
 on:
   workflow_dispatch:
   schedule:
-    - cron:  '0 13 * * *'  # Runs daily at 1PM UTC (9AM EDT/6AM PDT)
+    - cron:  '0 13 * * *'
 
 permissions:
   contents: read
@@ -15,9 +13,9 @@ jobs:
     if: github.repository_owner == 'langchain-ai' || github.event_name != 'schedule'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: '🟢 Setup Node.js 18.x'
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v4
         with:
           node-version: 18.x
           cache: "yarn"

.github/workflows/check_core_versions.yml

@@ -1,8 +1,6 @@
-# Ensures version numbers in pyproject.toml and version.py stay in sync.
-#
-# (Prevents releases with mismatched version numbers)
-
-name: '🔍 Check Version Equality'
+name: '🔍 Check `core` Version Equality'
+# Ensures version numbers in pyproject.toml and version.py stay in sync
+# Prevents releases with mismatched version numbers
 
 on:
   pull_request:
@@ -18,34 +16,19 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: '✅ Verify pyproject.toml & version.py Match'
         run: |
-          # Check core versions
-          CORE_PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]*' libs/core/pyproject.toml)
-          CORE_VERSION_PY_VERSION=$(grep -Po '(?<=^VERSION = ")[^"]*' libs/core/langchain_core/version.py)
+          PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]*' libs/core/pyproject.toml)
+          VERSION_PY_VERSION=$(grep -Po '(?<=^VERSION = ")[^"]*' libs/core/langchain_core/version.py)
 
-          # Compare core versions
-          if [ "$CORE_PYPROJECT_VERSION" != "$CORE_VERSION_PY_VERSION" ]; then
+          # Compare the two versions
+          if [ "$PYPROJECT_VERSION" != "$VERSION_PY_VERSION" ]; then
             echo "langchain-core versions in pyproject.toml and version.py do not match!"
-            echo "pyproject.toml version: $CORE_PYPROJECT_VERSION"
-            echo "version.py version: $CORE_VERSION_PY_VERSION"
+            echo "pyproject.toml version: $PYPROJECT_VERSION"
+            echo "version.py version: $VERSION_PY_VERSION"
             exit 1
           else
-            echo "Core versions match: $CORE_PYPROJECT_VERSION"
-          fi
-
-          # Check langchain_v1 versions
-          LANGCHAIN_PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]*' libs/langchain_v1/pyproject.toml)
-          LANGCHAIN_INIT_PY_VERSION=$(grep -Po '(?<=^__version__ = ")[^"]*' libs/langchain_v1/langchain/__init__.py)
-
-          # Compare langchain_v1 versions
-          if [ "$LANGCHAIN_PYPROJECT_VERSION" != "$LANGCHAIN_INIT_PY_VERSION" ]; then
-            echo "langchain_v1 versions in pyproject.toml and __init__.py do not match!"
-            echo "pyproject.toml version: $LANGCHAIN_PYPROJECT_VERSION"
-            echo "version.py version: $LANGCHAIN_INIT_PY_VERSION"
-            exit 1
-          else
-            echo "Langchain v1 versions match: $LANGCHAIN_PYPROJECT_VERSION"
+            echo "Versions match: $PYPROJECT_VERSION"
           fi

.github/workflows/check_diffs.yml

@@ -1,18 +1,3 @@
-# Primary CI workflow.
-#
-# Only runs against packages that have changed files.
-#
-# Runs:
-# - Linting (_lint.yml)
-# - Unit Tests (_test.yml)
-# - Pydantic compatibility tests (_test_pydantic.yml)
-# - Documentation import tests (_test_doc_imports.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.
-
 name: '🔧 CI'
 
 on:
@@ -26,8 +11,8 @@ on:
 # cancel the earlier run in favor of the next run.
 #
 # There's no point in testing an outdated version of the code. GitHub only allows
-# a limited number of job runners to be active at the same time, so it's better to
-# cancel pointless jobs early so that more useful jobs can run sooner.
+# a limited number of job runners to be active at the same time, so it's better to cancel
+# pointless jobs early so that more useful jobs can run sooner.
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
@@ -45,12 +30,11 @@ jobs:
   build:
     name: 'Detect Changes & Set Matrix'
     runs-on: ubuntu-latest
-    if: ${{ !contains(github.event.pull_request.labels.*.name, 'ci-ignore') }}
     steps:
       - name: '📋 Checkout Code'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
       - name: '🐍 Setup Python 3.11'
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
         with:
           python-version: '3.11'
       - name: '📂 Get Changed Files'
@@ -69,7 +53,6 @@ jobs:
       dependencies: ${{ steps.set-matrix.outputs.dependencies }}
       test-doc-imports: ${{ steps.set-matrix.outputs.test-doc-imports }}
       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 ]
@@ -126,7 +109,6 @@ jobs:
 
   # Verify integration tests compile without actually running them (faster feedback)
   compile-integration-tests:
-    name: 'Compile Integration Tests'
     needs: [ build ]
     if: ${{ needs.build.outputs.compile-integration-tests != '[]' }}
     strategy:
@@ -155,14 +137,12 @@ jobs:
       run:
         working-directory: ${{ matrix.job-configs.working-directory }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: '🐍 Set up Python ${{ matrix.job-configs.python-version }} + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ matrix.job-configs.python-version }}
-          cache-suffix: extended-tests-${{ matrix.job-configs.working-directory }}
-          working-directory: ${{ matrix.job-configs.working-directory }}
 
       - name: '📦 Install Dependencies & Run Extended Tests'
         shell: bash
@@ -185,72 +165,10 @@ 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@v5
-
-      # We have to use 3.12 as 3.13 is not yet supported
-      - name: '📦 Install UV Package Manager'
-        uses: astral-sh/setup-uv@v6
-        with:
-          python-version: "3.12"
-
-      - uses: actions/setup-python@v6
-        with:
-          python-version: "3.12"
-
-      - 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'
-    needs: [build, lint, test, compile-integration-tests, extended-tests, test-doc-imports, test-pydantic, codspeed]
+    needs: [build, lint, test, compile-integration-tests, extended-tests, test-doc-imports, test-pydantic]
     if: |
       always()
     runs-on: ubuntu-latest

.github/workflows/check_new_docs.yml

@@ -1,6 +1,3 @@
-# For integrations, we run check_templates.py to ensure that new docs use the correct
-# templates based on their type. See the script for more details.
-
 name: '📑 Integration Docs Lint'
 
 on:
@@ -25,8 +22,8 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-python@v6
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: '3.10'
       - id: files

.github/workflows/codspeed.yml

@@ -0,0 +1,66 @@
+name: '⚡ CodSpeed'
+
+on:
+  push:
+    branches:
+        - master
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  AZURE_OPENAI_CHAT_DEPLOYMENT_NAME: foo
+  AZURE_OPENAI_LEGACY_CHAT_DEPLOYMENT_NAME: foo
+  DEEPSEEK_API_KEY: foo
+  FIREWORKS_API_KEY: foo
+
+jobs:
+  codspeed:
+    name: 'Benchmark'
+    runs-on: ubuntu-latest
+    if: ${{ !contains(github.event.pull_request.labels.*.name, 'codspeed-ignore') }}
+    strategy:
+      matrix:
+        include:
+          - working-directory: libs/core
+            mode: walltime
+          - working-directory: libs/partners/openai
+          - working-directory: libs/partners/anthropic
+          - working-directory: libs/partners/deepseek
+          - working-directory: libs/partners/fireworks
+          - working-directory: libs/partners/xai
+          - working-directory: libs/partners/mistralai
+          - working-directory: libs/partners/groq
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # We have to use 3.12 as 3.13 is not yet supported
+      - name: '📦 Install UV Package Manager'
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.12"
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: '📦 Install Test Dependencies'
+        run: uv sync --group test
+        working-directory: ${{ matrix.working-directory }}
+
+      - name: '⚡ Run Benchmarks: ${{ matrix.working-directory }}'
+        uses: CodSpeedHQ/action@v3
+        with:
+          token: ${{ secrets.CODSPEED_TOKEN }}
+          run: |
+            cd ${{ matrix.working-directory }}
+            if [ "${{ matrix.working-directory }}" = "libs/core" ]; then
+              uv run --no-sync pytest ./tests/benchmarks --codspeed
+            else
+              uv run --no-sync pytest ./tests/ --codspeed
+            fi
+          mode: ${{ matrix.mode || 'instrumentation' }}

.github/workflows/extract_ignored_words_list.py

@@ -0,0 +1,10 @@
+import toml
+
+pyproject_toml = toml.load("pyproject.toml")
+
+# Extract the ignore words list (adjust the key as per your TOML structure)
+ignore_words_list = (
+    pyproject_toml.get("tool", {}).get("codespell", {}).get("ignore-words-list")
+)
+
+print(f"::set-output name=ignore_words_list::{ignore_words_list}")

.github/workflows/people.yml

@@ -1,11 +1,9 @@
-# Updates the LangChain People data by fetching the latest info from the LangChain Git.
-# TODO: broken/not used
-
 name: '👥 LangChain People'
 run-name: 'Update People Data'
+# This workflow updates the LangChain People data by fetching the latest information from the LangChain Git
 on:
   schedule:
-    - cron: "0 14 1 * *"  # Runs at 14:00 UTC on the 1st of every month (10AM EDT/7AM PDT)
+    - cron: "0 14 1 * *"
   push:
     branches: [jacob/people]
   workflow_dispatch:
@@ -21,7 +19,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       # Ref: https://github.com/actions/runner/issues/2033
       - name: '🔧 Fix Git Safe Directory in Container'
         run: mkdir -p /home/runner/work/_temp/_github_home && printf "[safe]\n\tdirectory = /github/workspace" > /home/runner/work/_temp/_github_home/.gitconfig

.github/workflows/pr_labeler_file.yml

@@ -1,28 +0,0 @@
-# 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, edited]
-
-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

@@ -1,28 +0,0 @@
-# Label PRs based on their titles.
-#
-# See `.github/pr-title-labeler.yml` to see rules for each label/title pattern.
-
-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, synchronize, reopened, 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
-      # Archived repo; latest commit (v0.1.0)
-      uses: grafana/pr-labeler-action@f19222d3ef883d2ca5f04420fdfe8148003763f0
-      with:
-        token: ${{ secrets.GITHUB_TOKEN }}
-        configuration-path: .github/pr-title-labeler.yml

.github/workflows/pr_lint.yml

@@ -1,43 +1,50 @@
-# PR title linting.
+# -----------------------------------------------------------------------------
+# PR Title Lint Workflow
 #
-# FORMAT (Conventional Commits 1.0.0):
+# Purpose:
+#   Enforces Conventional Commits format for pull request titles to maintain a
+#   clear, consistent, and machine-readable change history across our repository.
+#   This helps with automated changelog generation and semantic versioning.
 #
+# Enforced Commit Message Format (Conventional Commits 1.0.0):
 #   <type>[optional scope]: <description>
 #   [optional body]
 #   [optional footer(s)]
 #
-# Examples:
-#     feat(core): add multi‐tenant support
-#     fix(cli): resolve flag parsing error
-#     docs: update API usage examples
-#     docs(openai): update API usage examples
-#
 # Allowed Types:
-#   * feat       — a new feature (MINOR)
-#   * fix        — a bug fix (PATCH)
-#   * docs       — documentation only changes (either in /docs or code comments)
-#   * style      — formatting, linting, etc.; no code change or typing refactors
-#   * refactor   — code change that neither fixes a bug nor adds a feature
-#   * perf       — code change that improves performance
-#   * test       — adding tests or correcting existing
-#   * build      — changes that affect the build system/external dependencies
-#   * ci         — continuous integration/configuration changes
-#   * chore      — other changes that don't modify source or test files
-#   * revert     — reverts a previous commit
-#   * release    — prepare a new release
+#   • feat       — a new feature (MINOR bump)
+#   • fix        — a bug fix (PATCH bump)
+#   • docs       — documentation only changes
+#   • style      — formatting, missing semi-colons, etc.; no code change
+#   • refactor   — code change that neither fixes a bug nor adds a feature
+#   • perf       — code change that improves performance
+#   • test       — adding missing tests or correcting existing tests
+#   • build      — changes that affect the build system or external dependencies
+#   • ci         — continuous integration/configuration changes
+#   • chore      — other changes that don't modify src or test files
+#   • revert     — reverts a previous commit
+#   • release    — prepare a new release
 #
 # Allowed Scopes (optional):
-#   core, cli, langchain, langchain_v1, langchain_legacy, standard-tests,
-#   text-splitters, docs, anthropic, chroma, deepseek, exa, fireworks, groq,
-#   huggingface, mistralai, nomic, ollama, openai, perplexity, prompty, qdrant,
-#   xai, infra
+#   core, cli, langchain, standard-tests, docs, anthropic, chroma, deepseek,
+#   exa, fireworks, groq, huggingface, mistralai, nomic, ollama, openai,
+#   perplexity, prompty, qdrant, xai
 #
-# Rules:
-#   1. The 'Type' must start with a lowercase letter.
-#   2. Breaking changes: append "!" after type/scope (e.g., feat!: drop x support)
+# Rules & Tips for New Committers:
+#   1. Subject (type) must start with a lowercase letter and, if possible, be
+#      followed by a scope wrapped in parenthesis `(scope)`
+#   2. Breaking changes:
+#        – Append "!" after type/scope (e.g., feat!: drop Node 12 support)
+#        – Or include a footer "BREAKING CHANGE: <details>"
+#   3. Example PR titles:
+#        feat(core): add multi‐tenant support
+#        fix(cli): resolve flag parsing error
+#        docs: update API usage examples
+#        docs(openai): update API usage examples
 #
-# Enforces Conventional Commits format for pull request titles to maintain a clear and
-# machine-readable change history.
+# Resources:
+#   • Conventional Commits spec: https://www.conventionalcommits.org/en/v1.0.0/
+# -----------------------------------------------------------------------------
 
 name: '🏷️ PR Title Lint'
 
@@ -49,13 +56,13 @@ on:
     types: [opened, edited, synchronize]
 
 jobs:
-  # Validates that PR title follows Conventional Commits 1.0.0 specification
+  # Validates that PR title follows Conventional Commits specification
   lint-pr-title:
-    name: 'validate format'
+    name: 'Validate PR Title Format'
     runs-on: ubuntu-latest
     steps:
       - name: '✅ Validate Conventional Commits Format'
-        uses: amannn/action-semantic-pull-request@v6
+        uses: amannn/action-semantic-pull-request@v5
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -77,7 +84,6 @@ jobs:
             cli
             langchain
             langchain_v1
-            langchain_legacy
             standard-tests
             text-splitters
             docs

.github/workflows/run_notebooks.yml

@@ -1,5 +1,3 @@
-# Integration tests for documentation notebooks.
-
 name: '📓 Validate Documentation Notebooks'
 run-name: 'Test notebooks in ${{ inputs.working-directory  }}'
 on:
@@ -28,23 +26,21 @@ jobs:
     if: github.repository == 'langchain-ai/langchain' || github.event_name != 'schedule'
     name: '📑 Test Documentation Notebooks'
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: '🐍 Set up Python + UV'
         uses: "./.github/actions/uv_setup"
         with:
           python-version: ${{ github.event.inputs.python_version || '3.11' }}
-          cache-suffix: run-notebooks-${{ github.event.inputs.working-directory || 'all' }}
-          working-directory: ${{ github.event.inputs.working-directory || '**' }}
 
       - name: '🔐 Authenticate to Google Cloud'
         id: 'auth'
-        uses: google-github-actions/auth@v3
+        uses: google-github-actions/auth@v2
         with:
           credentials_json: '${{ secrets.GOOGLE_CREDENTIALS }}'
 
       - name: '🔐 Configure AWS Credentials'
-        uses: aws-actions/configure-aws-credentials@v5
+        uses: aws-actions/configure-aws-credentials@v4
         with:
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

.github/workflows/scheduled_test.yml

@@ -1,14 +1,8 @@
-# Routine integration tests against partner libraries with live API credentials.
-#
-# Uses `make integration_tests` for each library in the matrix.
-#
-# Runs daily. Can also be triggered manually for immediate updates.
-
 name: '⏰ Scheduled Integration Tests'
 run-name: "Run Integration Tests - ${{ inputs.working-directory-force || 'all libs' }} (Python ${{ inputs.python-version-force || '3.9, 3.11' }})"
 
 on:
-  workflow_dispatch:
+  workflow_dispatch:  # Allows maintainers to trigger the workflow manually in GitHub UI
     inputs:
       working-directory-force:
         type: string
@@ -26,7 +20,7 @@ env:
   POETRY_VERSION: "1.8.4"
   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"]'
-  POETRY_LIBS: ("libs/partners/aws")
+  POETRY_LIBS: ("libs/partners/google-vertexai" "libs/partners/google-genai" "libs/partners/aws")
 
 jobs:
   # Generate dynamic test matrix based on input parameters or defaults
@@ -60,13 +54,13 @@ jobs:
           echo $matrix
           echo "matrix=$matrix" >> $GITHUB_OUTPUT
   # Run integration tests against partner libraries with live API credentials
-  # Tests are run with Poetry or UV depending on the library's setup
+  # Tests are run with both Poetry and UV depending on the library's setup
   build:
     if: github.repository_owner == 'langchain-ai' || github.event_name != 'schedule'
     name: '🐍 Python ${{ matrix.python-version }}: ${{ matrix.working-directory }}'
     runs-on: ubuntu-latest
     needs: [compute-matrix]
-    timeout-minutes: 30
+    timeout-minutes: 20
     strategy:
       fail-fast: false
       matrix:
@@ -74,14 +68,14 @@ jobs:
         working-directory: ${{ fromJSON(needs.compute-matrix.outputs.matrix).working-directory }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           path: langchain
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           repository: langchain-ai/langchain-google
           path: langchain-google
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           repository: langchain-ai/langchain-aws
           path: langchain-aws
@@ -112,12 +106,12 @@ jobs:
 
       - name: '🔐 Authenticate to Google Cloud'
         id: 'auth'
-        uses: google-github-actions/auth@v3
+        uses: google-github-actions/auth@v2
         with:
           credentials_json: '${{ secrets.GOOGLE_CREDENTIALS }}'
 
       - name: '🔐 Configure AWS Credentials'
-        uses: aws-actions/configure-aws-credentials@v5
+        uses: aws-actions/configure-aws-credentials@v4
         with:
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
@@ -167,7 +161,7 @@ jobs:
           make integration_tests
 
       - name: '🧹 Clean up External Libraries'
-        # Clean up external libraries to avoid affecting the following git status check
+        # Clean up external libraries to avoid affecting git status check
         run: |
           rm -rf \
             langchain/libs/partners/google-genai \

.github/workflows/v1_changes.md

@@ -1,9 +0,0 @@
-With the deprecation of v0 docs, the following files will need to be migrated/supported
-in the new docs repo:
-
-- run_notebooks.yml: New repo should run Integration tests on code snippets?
-- people.yml: Need to fix and somehow display on the new docs site
-  - Subsequently, `.github/actions/people/`
-- _test_doc_imports.yml
-- check_new_docs.yml
-- check-broken-links.yml

.markdownlint.json

@@ -11,4 +11,4 @@
   "MD046": {
     "style": "fenced"
   }
-}
+}

.pre-commit-config.yaml

@@ -2,104 +2,110 @@ repos:
   - repo: local
     hooks:
       - id: core
-        name: format and lint core
+        name: format core
         language: system
-        entry: make -C libs/core format lint
+        entry: make -C libs/core format
         files: ^libs/core/
         pass_filenames: false
       - id: langchain
-        name: format and lint langchain
+        name: format langchain
         language: system
-        entry: make -C libs/langchain format lint
+        entry: make -C libs/langchain format
         files: ^libs/langchain/
         pass_filenames: false
       - id: standard-tests
-        name: format and lint standard-tests
+        name: format standard-tests
         language: system
-        entry: make -C libs/standard-tests format lint
+        entry: make -C libs/standard-tests format
         files: ^libs/standard-tests/
         pass_filenames: false
       - id: text-splitters
-        name: format and lint text-splitters
+        name: format text-splitters
         language: system
-        entry: make -C libs/text-splitters format lint
+        entry: make -C libs/text-splitters format
         files: ^libs/text-splitters/
         pass_filenames: false
       - id: anthropic
-        name: format and lint partners/anthropic
+        name: format partners/anthropic
         language: system
-        entry: make -C libs/partners/anthropic format lint
+        entry: make -C libs/partners/anthropic format
         files: ^libs/partners/anthropic/
         pass_filenames: false
       - id: chroma
-        name: format and lint partners/chroma
+        name: format partners/chroma
         language: system
-        entry: make -C libs/partners/chroma format lint
+        entry: make -C libs/partners/chroma format
         files: ^libs/partners/chroma/
         pass_filenames: false
-      - id: exa
-        name: format and lint partners/exa
+      - id: couchbase
+        name: format partners/couchbase
         language: system
-        entry: make -C libs/partners/exa format lint
+        entry: make -C libs/partners/couchbase format
+        files: ^libs/partners/couchbase/
+        pass_filenames: false
+      - id: exa
+        name: format partners/exa
+        language: system
+        entry: make -C libs/partners/exa format
         files: ^libs/partners/exa/
         pass_filenames: false
       - id: fireworks
-        name: format and lint partners/fireworks
+        name: format partners/fireworks
         language: system
-        entry: make -C libs/partners/fireworks format lint
+        entry: make -C libs/partners/fireworks format
         files: ^libs/partners/fireworks/
         pass_filenames: false
       - id: groq
-        name: format and lint partners/groq
+        name: format partners/groq
         language: system
-        entry: make -C libs/partners/groq format lint
+        entry: make -C libs/partners/groq format
         files: ^libs/partners/groq/
         pass_filenames: false
       - id: huggingface
-        name: format and lint partners/huggingface
+        name: format partners/huggingface
         language: system
-        entry: make -C libs/partners/huggingface format lint
+        entry: make -C libs/partners/huggingface format
         files: ^libs/partners/huggingface/
         pass_filenames: false
       - id: mistralai
-        name: format and lint partners/mistralai
+        name: format partners/mistralai
         language: system
-        entry: make -C libs/partners/mistralai format lint
+        entry: make -C libs/partners/mistralai format
         files: ^libs/partners/mistralai/
         pass_filenames: false
       - id: nomic
-        name: format and lint partners/nomic
+        name: format partners/nomic
         language: system
-        entry: make -C libs/partners/nomic format lint
+        entry: make -C libs/partners/nomic format
         files: ^libs/partners/nomic/
         pass_filenames: false
       - id: ollama
-        name: format and lint partners/ollama
+        name: format partners/ollama
         language: system
-        entry: make -C libs/partners/ollama format lint
+        entry: make -C libs/partners/ollama format
         files: ^libs/partners/ollama/
         pass_filenames: false
       - id: openai
-        name: format and lint partners/openai
+        name: format partners/openai
         language: system
-        entry: make -C libs/partners/openai format lint
+        entry: make -C libs/partners/openai format
         files: ^libs/partners/openai/
         pass_filenames: false
       - id: prompty
-        name: format and lint partners/prompty
+        name: format partners/prompty
         language: system
-        entry: make -C libs/partners/prompty format lint
+        entry: make -C libs/partners/prompty format
         files: ^libs/partners/prompty/
         pass_filenames: false
       - id: qdrant
-        name: format and lint partners/qdrant
+        name: format partners/qdrant
         language: system
-        entry: make -C libs/partners/qdrant format lint
+        entry: make -C libs/partners/qdrant format
         files: ^libs/partners/qdrant/
         pass_filenames: false
       - id: root
-        name: format and lint docs, cookbook
+        name: format docs, cookbook
         language: system
-        entry: make format lint
+        entry: make format
         files: ^(docs|cookbook)/
         pass_filenames: false

.readthedocs.yaml

@@ -0,0 +1,25 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  commands:
+    - mkdir -p $READTHEDOCS_OUTPUT
+    - cp -r api_reference_build/* $READTHEDOCS_OUTPUT
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/api_reference/conf.py
+
+# If using Sphinx, optionally build your docs in additional formats such as PDF
+formats:
+  - pdf
+
+# Optionally declare the Python requirements required to build your docs
+python:
+  install:
+    - requirements: docs/api_reference/requirements.txt

.vscode/settings.json

@@ -21,7 +21,7 @@
   "[python]": {
     "editor.formatOnSave": true,
     "editor.codeActionsOnSave": {
-      "source.organizeImports.ruff": "explicit",
+      "source.organizeImports": "explicit",
       "source.fixAll": "explicit"
     },
     "editor.defaultFormatter": "charliermarsh.ruff"
@@ -77,11 +77,4 @@
     "editor.tabSize": 2,
     "editor.insertSpaces": true
   },
-  "python.terminal.activateEnvironment": false,
-  "python.defaultInterpreterPath": "./.venv/bin/python",
-  "github.copilot.chat.commitMessageGeneration.instructions": [
-    {
-      "file": ".github/workflows/pr_lint.yml"
-    }
-  ]
 }

AGENTS.md

@@ -1,325 +0,0 @@
-# Global Development Guidelines for LangChain Projects
-
-## Core Development Principles
-
-### 1. Maintain Stable Public Interfaces ⚠️ CRITICAL
-
-**Always attempt to preserve function signatures, argument positions, and names for exported/public methods.**
-
-❌ **Bad - Breaking Change:**
-
-```python
-def get_user(id, verbose=False):  # Changed from `user_id`
-    pass
-```
-
-✅ **Good - Stable Interface:**
-
-```python
-def get_user(user_id: str, verbose: bool = False) -> User:
-    """Retrieve user by ID with optional verbose output."""
-    pass
-```
-
-**Before making ANY changes to public APIs:**
-
-- Check if the function/class is exported in `__init__.py`
-- Look for existing usage patterns in tests and examples
-- Use keyword-only arguments for new parameters: `*, new_param: str = "default"`
-- Mark experimental features clearly with docstring warnings (using reStructuredText, like `.. warning::`)
-
-🧠 *Ask yourself:* "Would this change break someone's code if they used it last week?"
-
-### 2. Code Quality Standards
-
-**All Python code MUST include type hints and return types.**
-
-❌ **Bad:**
-
-```python
-def p(u, d):
-    return [x for x in u if x not in d]
-```
-
-✅ **Good:**
-
-```python
-def filter_unknown_users(users: list[str], known_users: set[str]) -> list[str]:
-    """Filter out users that are not in the known users set.
-
-    Args:
-        users: List of user identifiers to filter.
-        known_users: Set of known/valid user identifiers.
-
-    Returns:
-        List of users that are not in the known_users set.
-    """
-    return [user for user in users if user not in known_users]
-```
-
-**Style Requirements:**
-
-- Use descriptive, **self-explanatory variable names**. Avoid overly short or cryptic identifiers.
-- Attempt to break up complex functions (>20 lines) into smaller, focused functions where it makes sense
-- Avoid unnecessary abstraction or premature optimization
-- Follow existing patterns in the codebase you're modifying
-
-### 3. Testing Requirements
-
-**Every new feature or bugfix MUST be covered by unit tests.**
-
-**Test Organization:**
-
-- Unit tests: `tests/unit_tests/` (no network calls allowed)
-- Integration tests: `tests/integration_tests/` (network calls permitted)
-- Use `pytest` as the testing framework
-
-**Test Quality Checklist:**
-
-- [ ] Tests fail when your new logic is broken
-- [ ] Happy path is covered
-- [ ] Edge cases and error conditions are tested
-- [ ] Use fixtures/mocks for external dependencies
-- [ ] Tests are deterministic (no flaky tests)
-
-Checklist questions:
-
-- [ ] Does the test suite fail if your new logic is broken?
-- [ ] Are all expected behaviors exercised (happy path, invalid input, etc)?
-- [ ] Do tests use fixtures or mocks where needed?
-
-```python
-def test_filter_unknown_users():
-    """Test filtering unknown users from a list."""
-    users = ["alice", "bob", "charlie"]
-    known_users = {"alice", "bob"}
-
-    result = filter_unknown_users(users, known_users)
-
-    assert result == ["charlie"]
-    assert len(result) == 1
-```
-
-### 4. Security and Risk Assessment
-
-**Security Checklist:**
-
-- No `eval()`, `exec()`, or `pickle` on user-controlled input
-- Proper exception handling (no bare `except:`) and use a `msg` variable for error messages
-- Remove unreachable/commented code before committing
-- Race conditions or resource leaks (file handles, sockets, threads).
-- Ensure proper resource cleanup (file handles, connections)
-
-❌ **Bad:**
-
-```python
-def load_config(path):
-    with open(path) as f:
-        return eval(f.read())  # ⚠️ Never eval config
-```
-
-✅ **Good:**
-
-```python
-import json
-
-def load_config(path: str) -> dict:
-    with open(path) as f:
-        return json.load(f)
-```
-
-### 5. Documentation Standards
-
-**Use Google-style docstrings with Args section for all public functions.**
-
-❌ **Insufficient Documentation:**
-
-```python
-def send_email(to, msg):
-    """Send an email to a recipient."""
-```
-
-✅ **Complete Documentation:**
-
-```python
-def send_email(to: str, msg: str, *, priority: str = "normal") -> bool:
-    """
-    Send an email to a recipient with specified priority.
-
-    Args:
-        to: The email address of the recipient.
-        msg: The message body to send.
-        priority: Email priority level (``'low'``, ``'normal'``, ``'high'``).
-
-    Returns:
-        True if email was sent successfully, False otherwise.
-
-    Raises:
-        InvalidEmailError: If the email address format is invalid.
-        SMTPConnectionError: If unable to connect to email server.
-    """
-```
-
-**Documentation Guidelines:**
-
-- Types go in function signatures, NOT in docstrings
-- Focus on "why" rather than "what" in descriptions
-- Document all parameters, return values, and exceptions
-- Keep descriptions concise but clear
-- Use reStructuredText for docstrings to enable rich formatting
-
-📌 *Tip:* Keep descriptions concise but clear. Only document return values if non-obvious.
-
-### 6. Architectural Improvements
-
-**When you encounter code that could be improved, suggest better designs:**
-
-❌ **Poor Design:**
-
-```python
-def process_data(data, db_conn, email_client, logger):
-    # Function doing too many things
-    validated = validate_data(data)
-    result = db_conn.save(validated)
-    email_client.send_notification(result)
-    logger.log(f"Processed {len(data)} items")
-    return result
-```
-
-✅ **Better Design:**
-
-```python
-@dataclass
-class ProcessingResult:
-    """Result of data processing operation."""
-    items_processed: int
-    success: bool
-    errors: List[str] = field(default_factory=list)
-
-class DataProcessor:
-    """Handles data validation, storage, and notification."""
-
-    def __init__(self, db_conn: Database, email_client: EmailClient):
-        self.db = db_conn
-        self.email = email_client
-
-    def process(self, data: List[dict]) -> ProcessingResult:
-        """Process and store data with notifications."""
-        validated = self._validate_data(data)
-        result = self.db.save(validated)
-        self._notify_completion(result)
-        return result
-```
-
-**Design Improvement Areas:**
-
-If there's a **cleaner**, **more scalable**, or **simpler** design, highlight it and suggest improvements that would:
-
-- Reduce code duplication through shared utilities
-- Make unit testing easier
-- Improve separation of concerns (single responsibility)
-- Make unit testing easier through dependency injection
-- Add clarity without adding complexity
-- Prefer dataclasses for structured data
-
-## Development Tools & Commands
-
-### Package Management
-
-```bash
-# Add package
-uv add package-name
-
-# Sync project dependencies
-uv sync
-uv lock
-```
-
-### Testing
-
-```bash
-# Run unit tests (no network)
-make test
-
-# Don't run integration tests, as API keys must be set
-
-# Run specific test file
-uv run --group test pytest tests/unit_tests/test_specific.py
-```
-
-### Code Quality
-
-```bash
-# Lint code
-make lint
-
-# Format code
-make format
-
-# Type checking
-uv run --group lint mypy .
-```
-
-### Dependency Management Patterns
-
-**Local Development Dependencies:**
-
-```toml
-[tool.uv.sources]
-langchain-core = { path = "../core", editable = true }
-langchain-tests = { path = "../standard-tests", editable = true }
-```
-
-**For tools, use the `@tool` decorator from `langchain_core.tools`:**
-
-```python
-from langchain_core.tools import tool
-
-@tool
-def search_database(query: str) -> str:
-    """Search the database for relevant information.
-
-    Args:
-        query: The search query string.
-    """
-    # Implementation here
-    return results
-```
-
-## Commit Standards
-
-**Use Conventional Commits format for PR titles:**
-
-- `feat(core): add multi-tenant support`
-- `fix(cli): resolve flag parsing error`
-- `docs: update API usage examples`
-- `docs(openai): update API usage examples`
-
-## Framework-Specific Guidelines
-
-- Follow the existing patterns in `langchain-core` for base abstractions
-- Use `langchain_core.callbacks` for execution tracking
-- Implement proper streaming support where applicable
-- Avoid deprecated components like legacy `LLMChain`
-
-### Partner Integrations
-
-- Follow the established patterns in existing partner libraries
-- Implement standard interfaces (`BaseChatModel`, `BaseEmbeddings`, etc.)
-- Include comprehensive integration tests
-- Document API key requirements and authentication
-
----
-
-## Quick Reference Checklist
-
-Before submitting code changes:
-
-- [ ] **Breaking Changes**: Verified no public API changes
-- [ ] **Type Hints**: All functions have complete type annotations
-- [ ] **Tests**: New functionality is fully tested
-- [ ] **Security**: No dangerous patterns (eval, silent failures, etc.)
-- [ ] **Documentation**: Google-style docstrings for public functions
-- [ ] **Code Quality**: `make lint` and `make format` pass
-- [ ] **Architecture**: Suggested improvements where applicable
-- [ ] **Commit Message**: Follows Conventional Commits format

Makefile

@@ -1,4 +1,4 @@
-.PHONY: all clean help docs_build docs_clean docs_linkcheck api_docs_build api_docs_clean api_docs_linkcheck lint lint_package lint_tests format format_diff
+.PHONY: all clean help docs_build docs_clean docs_linkcheck api_docs_build api_docs_clean api_docs_linkcheck spell_check spell_fix lint lint_package lint_tests format format_diff
 
 .EXPORT_ALL_VARIABLES:
 UV_FROZEN = true
@@ -78,6 +78,18 @@ api_docs_linkcheck:
 	fi
 	@echo "✅ API link check complete"
 
+## spell_check: Run codespell on the project.
+spell_check:
+	@echo "✏️ Checking spelling across project..."
+	uv run --group codespell codespell --toml pyproject.toml
+	@echo "✅ Spell check complete"
+
+## spell_fix: Run codespell on the project and fix the errors.
+spell_fix:
+	@echo "✏️ Fixing spelling errors across project..."
+	uv run --group codespell codespell --toml pyproject.toml -w
+	@echo "✅ Spelling errors fixed"
+
 ######################
 # LINTING AND FORMATTING
 ######################
@@ -88,7 +100,7 @@ lint lint_package lint_tests:
 	uv run --group lint ruff check docs cookbook
 	uv run --group lint ruff format docs cookbook cookbook --diff
 	git --no-pager grep 'from langchain import' docs cookbook | grep -vE 'from langchain import (hub)' && echo "Error: no importing langchain from root in docs, except for hub" && exit 1 || exit 0
-
+	
 	git --no-pager grep 'api.python.langchain.com' -- docs/docs ':!docs/docs/additional_resources/arxiv_references.mdx' ':!docs/docs/integrations/document_loaders/sitemap.ipynb' || exit 0 && \
 	echo "Error: you should link python.langchain.com/api_reference, not api.python.langchain.com in the docs" && \
 	exit 1

README.md

@@ -1,75 +1,87 @@
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: light)" srcset="docs/static/img/logo-dark.svg">
-    <source media="(prefers-color-scheme: dark)" srcset="docs/static/img/logo-light.svg">
-    <img alt="LangChain Logo" src="docs/static/img/logo-dark.svg" width="80%">
-  </picture>
-</p>
+<picture>
+  <source media="(prefers-color-scheme: light)" srcset="docs/static/img/logo-dark.svg">
+  <source media="(prefers-color-scheme: dark)" srcset="docs/static/img/logo-light.svg">
+  <img alt="LangChain Logo" src="docs/static/img/logo-dark.svg" width="80%">
+</picture>
 
-<p align="center">
-    The platform for reliable agents.
-</p>
+<div>
+<br>
+</div>
 
-<p align="center">
-  <a href="https://opensource.org/licenses/MIT" target="_blank">
-      <img src="https://img.shields.io/pypi/l/langchain-core?style=flat-square" alt="PyPI - License">
-  </a>
-  <a href="https://pypistats.org/packages/langchain-core" target="_blank">
-      <img src="https://img.shields.io/pepy/dt/langchain" alt="PyPI - Downloads">
-  </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&style=flat-square" 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://twitter.com/langchainai" target="_blank">
-      <img src="https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI" alt="Twitter / X">
-  </a>
-</p>
+[![Release Notes](https://img.shields.io/github/release/langchain-ai/langchain?style=flat-square)](https://github.com/langchain-ai/langchain/releases)
+[![CI](https://github.com/langchain-ai/langchain/actions/workflows/check_diffs.yml/badge.svg)](https://github.com/langchain-ai/langchain/actions/workflows/check_diffs.yml)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-core?style=flat-square)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-core?style=flat-square)](https://pypistats.org/packages/langchain-core)
+[![GitHub star chart](https://img.shields.io/github/stars/langchain-ai/langchain?style=flat-square)](https://star-history.com/#langchain-ai/langchain)
+[![Open Issues](https://img.shields.io/github/issues-raw/langchain-ai/langchain?style=flat-square)](https://github.com/langchain-ai/langchain/issues)
+[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode&style=flat-square)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/langchain-ai/langchain)
+[<img src="https://github.com/codespaces/badge.svg" alt="Open in Github Codespace" title="Open in Github Codespace" width="150" height="20">](https://codespaces.new/langchain-ai/langchain)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
+[![CodSpeed Badge](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/langchain-ai/langchain)
 
-LangChain is a framework for building 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).
+
+LangChain is a framework for building 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 -U langchain
 ```
 
----
-
-**Documentation**: To learn more about LangChain, check out [the docs](https://python.langchain.com/docs/introduction/).
-
-If you're looking for more advanced customization or agent orchestration, check out [LangGraph](https://langchain-ai.github.io/langgraph/), our framework for building controllable agent workflows.
-
-> [!NOTE]
-> Looking for the JS/TS library? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
+To learn more about LangChain, check out
+[the docs](https://python.langchain.com/docs/introduction/). If you’re looking for more
+advanced customization or agent orchestration, check out
+[LangGraph](https://langchain-ai.github.io/langgraph/), our framework for building
+controllable agent workflows.
 
 ## Why use LangChain?
 
-LangChain helps developers build applications powered by LLMs through a standard interface for models, embeddings, vector stores, and more.
+LangChain helps developers build applications powered by LLMs through a standard
+interface for models, embeddings, vector stores, and more.
 
 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.
+- **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.
 
 ## LangChain’s ecosystem
 
-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.
+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.
 
 To improve your LLM application development, pair LangChain with:
 
-- [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.
-- [LangGraph](https://langchain-ai.github.io/langgraph/) - 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.
-- [LangGraph Platform](https://docs.langchain.com/langgraph-platform) - 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 [LangGraph Studio](https://langchain-ai.github.io/langgraph/concepts/langgraph_studio/).
+- [LangSmith](http://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.
+- [LangGraph](https://langchain-ai.github.io/langgraph/) - 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.
+- [LangGraph Platform](https://langchain-ai.github.io/langgraph/concepts/langgraph_platform/) - 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
+[LangGraph Studio](https://langchain-ai.github.io/langgraph/concepts/langgraph_studio/).
 
 ## Additional resources
 
-- [Tutorials](https://python.langchain.com/docs/tutorials/): Simple walkthroughs with guided examples on getting started with LangChain.
-- [How-to Guides](https://python.langchain.com/docs/how_to/): Quick, actionable code snippets for topics such as tool calling, RAG use cases, and more.
-- [Conceptual Guides](https://python.langchain.com/docs/concepts/): Explanations of key concepts behind the LangChain framework.
+- [Tutorials](https://python.langchain.com/docs/tutorials/): Simple walkthroughs with
+guided examples on getting started with LangChain.
+- [How-to Guides](https://python.langchain.com/docs/how_to/): Quick, actionable code
+snippets for topics such as tool calling, RAG use cases, and more.
+- [Conceptual Guides](https://python.langchain.com/docs/concepts/): Explanations of key
+concepts behind the LangChain framework.
 - [LangChain Forum](https://forum.langchain.com/): Connect with the community and share all of your technical questions, ideas, and feedback.
-- [API Reference](https://python.langchain.com/api_reference/): Detailed reference on navigating base packages and integrations for LangChain.
-- [Chat LangChain](https://chat.langchain.com/): Ask questions & chat with our documentation.
+- [API Reference](https://python.langchain.com/api_reference/): Detailed reference on
+navigating base packages and integrations for LangChain.

SECURITY.md

@@ -4,9 +4,9 @@ LangChain has a large ecosystem of integrations with various external resources
 
 ## Best practices
 
-When building such applications, developers should remember to follow good security practices:
+When building such applications developers should remember to follow good security practices:
 
-* [**Limit Permissions**](https://en.wikipedia.org/wiki/Principle_of_least_privilege): Scope permissions specifically to the application's need. Granting broad or excessive permissions can introduce significant security vulnerabilities. To avoid such vulnerabilities, consider using read-only credentials, disallowing access to sensitive resources, using sandboxing techniques (such as running inside a container), specifying proxy configurations to control external requests, etc., as appropriate for your application.
+* [**Limit Permissions**](https://en.wikipedia.org/wiki/Principle_of_least_privilege): Scope permissions specifically to the application's need. Granting broad or excessive permissions can introduce significant security vulnerabilities. To avoid such vulnerabilities, consider using read-only credentials, disallowing access to sensitive resources, using sandboxing techniques (such as running inside a container), specifying proxy configurations to control external requests, etc. as appropriate for your application.
 * **Anticipate Potential Misuse**: Just as humans can err, so can Large Language Models (LLMs). Always assume that any system access or credentials may be used in any way allowed by the permissions they are assigned. For example, if a pair of database credentials allows deleting data, it's safest to assume that any LLM able to use those credentials may in fact delete data.
 * [**Defense in Depth**](https://en.wikipedia.org/wiki/Defense_in_depth_(computing)): No security technique is perfect. Fine-tuning and good chain design can reduce, but not eliminate, the odds that a Large Language Model (LLM) may make a mistake. It's best to combine multiple layered security approaches rather than relying on any single layer of defense to ensure security. For example: use both read-only permissions and sandboxing to ensure that LLMs are only able to access data that is explicitly meant for them to use.
 
@@ -22,7 +22,9 @@ Example scenarios with mitigation strategies:
 * A user may ask an agent with write access to an external API to write malicious data to the API, or delete data from that API. To mitigate, give the agent read-only API keys, or limit it to only use endpoints that are already resistant to such misuse.
 * A user may ask an agent with access to a database to drop a table or mutate the schema. To mitigate, scope the credentials to only the tables that the agent needs to access and consider issuing READ-ONLY credentials.
 
-If you're building applications that access external resources like file systems, APIs or databases, consider speaking with your company's security team to determine how to best design and secure your applications.
+If you're building applications that access external resources like file systems, APIs
+or databases, consider speaking with your company's security team to determine how to best
+design and secure your applications.
 
 ## Reporting OSS Vulnerabilities
 
@@ -35,8 +37,10 @@ open source projects at [huntr](https://huntr.com/bounties/disclose/?target=http
 Before reporting a vulnerability, please review:
 
 1) In-Scope Targets and Out-of-Scope Targets below.
-2) The [langchain-ai/langchain](https://docs.langchain.com/oss/python/contributing/code#supporting-packages) monorepo structure.
-3) The [Best Practices](#best-practices) above to understand what we consider to be a security vulnerability vs. developer responsibility.
+2) The [langchain-ai/langchain](https://python.langchain.com/docs/contributing/repo_structure) monorepo structure.
+3) The [Best Practices](#best-practices) above to
+   understand what we consider to be a security vulnerability vs. developer
+   responsibility.
 
 ### In-Scope Targets
 
@@ -63,7 +67,8 @@ All out of scope targets defined by huntr as well as:
     for more details, but generally tools interact with the real world. Developers are
     expected to understand the security implications of their code and are responsible
     for the security of their tools.
-* Code documented with security notices. This will be decided on a case-by-case basis, but likely will not be eligible for a bounty as the code is already
+* Code documented with security notices. This will be decided on a case by
+  case basis, but likely will not be eligible for a bounty as the code is already
   documented with guidelines for developers that should be followed for making their
   application secure.
 * Any LangSmith related repositories or APIs (see [Reporting LangSmith Vulnerabilities](#reporting-langsmith-vulnerabilities)).

cookbook/README.md

@@ -63,5 +63,4 @@ Notebook | Description
 [rag-locally-on-intel-cpu.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/rag-locally-on-intel-cpu.ipynb) | Perform Retrieval-Augmented-Generation (RAG) on locally downloaded open-source models using langchain and open source tools and execute it on Intel Xeon CPU. We showed an example of how to apply RAG on Llama 2 model and enable it to answer the queries related to Intel Q1 2024 earnings release.
 [visual_RAG_vdms.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/visual_RAG_vdms.ipynb) | Performs Visual Retrieval-Augmented-Generation (RAG) using videos and scene descriptions generated by open source models.
 [contextual_rag.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/contextual_rag.ipynb) | Performs contextual retrieval-augmented generation (RAG) prepending chunk-specific explanatory context to each chunk before embedding.
-[rag-agents-locally-on-intel-cpu.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/local_rag_agents_intel_cpu.ipynb) | Build a RAG agent locally with open source models that routes questions through one of two paths to find answers. The agent generates answers based on documents retrieved from either the vector database or retrieved from web search. If the vector database lacks relevant information, the agent opts for web search. Open-source models for LLM and embeddings are used locally on an Intel Xeon CPU to execute this pipeline.
-[rag_mlflow_tracking_evaluation.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/rag_mlflow_tracking_evaluation.ipynb) | Guide on how to create a RAG pipeline and track + evaluate it with MLflow.
+[rag-agents-locally-on-intel-cpu.ipynb](https://github.com/langchain-ai/langchain/tree/master/cookbook/local_rag_agents_intel_cpu.ipynb) | Build a RAG agent locally with open source models that routes questions through one of two paths to find answers. The agent generates answers based on documents retrieved from either the vector database or retrieved from web search. If the vector database lacks relevant information, the agent opts for web search. Open-source models for LLM and embeddings are used locally on an Intel Xeon CPU to execute this pipeline.

cookbook/langgraph_agentic_rag.ipynb

@@ -79,17 +79,6 @@
     "tool_executor = ToolExecutor(tools)"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "168152fc",
-   "metadata": {},
-   "source": [
-    "📘 **Note on `SystemMessage` usage with LangGraph-based agents**\n",
-    "\n",
-    "When constructing the `messages` list for an agent, you *must* manually include any `SystemMessage`s.\n",
-    "Unlike some agent executors in LangChain that set a default, LangGraph requires explicit inclusion."
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "fe6e8f78-1ef7-42ad-b2bf-835ed5850553",

cookbook/oracleai_demo.ipynb

@@ -47,12 +47,10 @@
    "source": [
     "### Prerequisites\n",
     "\n",
-    "You'll need to install `langchain-oracledb` with `python -m pip install -U langchain-oracledb` to use this integration.\n",
-    "\n",
-    "The `python-oracledb` driver is installed automatically as a dependency of langchain-oracledb.\n",
+    "Please install the Oracle Database [python-oracledb driver](https://pypi.org/project/oracledb/) to use LangChain with Oracle AI Vector Search:\n",
     "\n",
     "```\n",
-    "$ python -m pip install -U langchain-oracledb\n",
+    "$ python -m pip install --upgrade oracledb\n",
     "```"
    ]
   },
@@ -219,7 +217,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oracledb.embeddings.oracleai import OracleEmbeddings\n",
+    "from langchain_community.embeddings.oracleai import OracleEmbeddings\n",
     "\n",
     "# please update with your related information\n",
     "# make sure that you have onnx file in the system\n",
@@ -298,7 +296,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oracledb.document_loaders.oracleai import OracleDocLoader\n",
+    "from langchain_community.document_loaders.oracleai import OracleDocLoader\n",
     "from langchain_core.documents import Document\n",
     "\n",
     "# loading from Oracle Database table\n",
@@ -356,7 +354,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oracledb.utilities.oracleai import OracleSummary\n",
+    "from langchain_community.utilities.oracleai import OracleSummary\n",
     "from langchain_core.documents import Document\n",
     "\n",
     "# using 'database' provider\n",
@@ -397,7 +395,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oracledb.document_loaders.oracleai import OracleTextSplitter\n",
+    "from langchain_community.document_loaders.oracleai import OracleTextSplitter\n",
     "from langchain_core.documents import Document\n",
     "\n",
     "# split by default parameters\n",
@@ -454,7 +452,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oracledb.embeddings.oracleai import OracleEmbeddings\n",
+    "from langchain_community.embeddings.oracleai import OracleEmbeddings\n",
     "from langchain_core.documents import Document\n",
     "\n",
     "# using ONNX model loaded to Oracle Database\n",
@@ -500,14 +498,14 @@
     "import sys\n",
     "\n",
     "import oracledb\n",
-    "from langchain_oracledb.document_loaders.oracleai import (\n",
+    "from langchain_community.document_loaders.oracleai import (\n",
     "    OracleDocLoader,\n",
     "    OracleTextSplitter,\n",
     ")\n",
-    "from langchain_oracledb.embeddings.oracleai import OracleEmbeddings\n",
-    "from langchain_oracledb.utilities.oracleai import OracleSummary\n",
-    "from langchain_oracledb.vectorstores import oraclevs\n",
-    "from langchain_oracledb.vectorstores.oraclevs import OracleVS\n",
+    "from langchain_community.embeddings.oracleai import OracleEmbeddings\n",
+    "from langchain_community.utilities.oracleai import OracleSummary\n",
+    "from langchain_community.vectorstores import oraclevs\n",
+    "from langchain_community.vectorstores.oraclevs import OracleVS\n",
     "from langchain_community.vectorstores.utils import DistanceStrategy\n",
     "from langchain_core.documents import Document"
    ]
@@ -679,19 +677,19 @@
    "outputs": [],
    "source": [
     "query = \"What is Oracle AI Vector Store?\"\n",
-    "db_filter = {\"document_id\": \"1\"}\n",
+    "filter = {\"document_id\": [\"1\"]}\n",
     "\n",
     "# Similarity search without a filter\n",
     "print(vectorstore.similarity_search(query, 1))\n",
     "\n",
     "# Similarity search with a filter\n",
-    "print(vectorstore.similarity_search(query, 1, filter=db_filter))\n",
+    "print(vectorstore.similarity_search(query, 1, filter=filter))\n",
     "\n",
     "# Similarity search with relevance score\n",
     "print(vectorstore.similarity_search_with_score(query, 1))\n",
     "\n",
     "# Similarity search with relevance score with filter\n",
-    "print(vectorstore.similarity_search_with_score(query, 1, filter=db_filter))\n",
+    "print(vectorstore.similarity_search_with_score(query, 1, filter=filter))\n",
     "\n",
     "# Max marginal relevance search\n",
     "print(vectorstore.max_marginal_relevance_search(query, 1, fetch_k=20, lambda_mult=0.5))\n",
@@ -699,7 +697,7 @@
     "# Max marginal relevance search with filter\n",
     "print(\n",
     "    vectorstore.max_marginal_relevance_search(\n",
-    "        query, 1, fetch_k=20, lambda_mult=0.5, filter=db_filter\n",
+    "        query, 1, fetch_k=20, lambda_mult=0.5, filter=filter\n",
     "    )\n",
     ")"
    ]

cookbook/rag_mlflow_tracking_evaluation.ipynb

@@ -1,455 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "id": "3716230e",
-   "metadata": {},
-   "source": [
-    "# RAG Pipeline with MLflow Tracking, Tracing & Evaluation\n",
-    "\n",
-    "This notebook demonstrates how to build a complete Retrieval-Augmented Generation (RAG) pipeline using LangChain and integrate it with MLflow for experiment tracking, tracing, and evaluation.\n",
-    "\n",
-    "\n",
-    "- **RAG Pipeline Construction**: Build a complete RAG system using LangChain components\n",
-    "- **MLflow Integration**: Track experiments, parameters, and artifacts\n",
-    "- **Tracing**: Monitor inputs, outputs, retrieved documents, scores, prompts, and timings\n",
-    "- **Evaluation**: Use MLflow's built-in scorers to assess RAG performance\n",
-    "- **Best Practices**: Implement proper configuration management and reproducible experiments\n",
-    "\n",
-    "We'll build a RAG system that can answer questions about academic papers by:\n",
-    "1. Loading and chunking documents from ArXiv\n",
-    "2. Creating embeddings and a vector store\n",
-    "3. Setting up a retrieval-augmented generation chain\n",
-    "4. Tracking all experiments with MLflow\n",
-    "5. Evaluating the system's performance\n",
-    "\n",
-    "![System Diagram](https://miro.medium.com/v2/resize:fit:720/format:webp/1*eiw86PP4hrBBxhjTjP0JUQ.png)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "2f7561c4",
-   "metadata": {},
-   "source": [
-    "#### Setup"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0814ebe9",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "%pip install -U langchain mlflow langchain-community arxiv pymupdf langchain-text-splitters langchain-openai"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "id": "747399b6",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import os\n",
-    "import mlflow\n",
-    "from mlflow.genai.scorers import RelevanceToQuery, Correctness, ExpectationsGuidelines\n",
-    "from langchain_community.document_loaders import ArxivLoader\n",
-    "from langchain.text_splitter import RecursiveCharacterTextSplitter\n",
-    "from langchain_core.vectorstores import InMemoryVectorStore\n",
-    "from langchain_openai import OpenAIEmbeddings, ChatOpenAI\n",
-    "from langchain_core.prompts import ChatPromptTemplate\n",
-    "from langchain_core.runnables import RunnableLambda, RunnablePassthrough\n",
-    "from langchain_core.output_parsers import StrOutputParser"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "4141ee05",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "os.environ[\"OPENAI_API_KEY\"] = \"<YOUR OPENAI API KEY>\"\n",
-    "\n",
-    "mlflow.set_experiment(\"LangChain-RAG-MLflow\")\n",
-    "mlflow.langchain.autolog()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "dd5eb41b",
-   "metadata": {},
-   "source": [
-    "Define all hyperparameters and configuration in a centralized dictionary. This makes it easy to:\n",
-    "- Track different experiment configurations\n",
-    "- Reproduce results\n",
-    "- Perform hyperparameter tuning\n",
-    "\n",
-    "**Key Parameters**:\n",
-    "- `chunk_size`: Size of text chunks for document splitting\n",
-    "- `chunk_overlap`: Overlap between consecutive chunks\n",
-    "- `retriever_k`: Number of documents to retrieve\n",
-    "- `embeddings_model`: OpenAI embedding model\n",
-    "- `llm`: Language model for generation\n",
-    "- `temperature`: Sampling temperature for the LLM"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "id": "6dcdc5d8",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "CONFIG = {\n",
-    "    \"chunk_size\": 400,\n",
-    "    \"chunk_overlap\": 80,\n",
-    "    \"retriever_k\": 3,\n",
-    "    \"embeddings_model\": \"text-embedding-3-small\",\n",
-    "    \"system_prompt\": \"You are a helpful assistant. Use the following context to answer the question. Use three sentences maximum and keep the answer concise.\",\n",
-    "    \"llm\": \"gpt-5-nano\",\n",
-    "    \"temperature\": 0,\n",
-    "}"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "8a2985f1",
-   "metadata": {},
-   "source": [
-    "#### ArXiv Dcoument Loading and Processing"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "id": "1f32aa36",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "{'Published': '2023-08-02', 'Title': 'Attention Is All You Need', 'Authors': 'Ashish Vaswani, Noam Shazeer, Niki Parmar, Jakob Uszkoreit, Llion Jones, Aidan N. Gomez, Lukasz Kaiser, Illia Polosukhin', 'Summary': 'The dominant sequence transduction models are based on complex recurrent or\\nconvolutional neural networks in an encoder-decoder configuration. The best\\nperforming models also connect the encoder and decoder through an attention\\nmechanism. We propose a new simple network architecture, the Transformer, based\\nsolely on attention mechanisms, dispensing with recurrence and convolutions\\nentirely. Experiments on two machine translation tasks show these models to be\\nsuperior in quality while being more parallelizable and requiring significantly\\nless time to train. Our model achieves 28.4 BLEU on the WMT 2014\\nEnglish-to-German translation task, improving over the existing best results,\\nincluding ensembles by over 2 BLEU. On the WMT 2014 English-to-French\\ntranslation task, our model establishes a new single-model state-of-the-art\\nBLEU score of 41.8 after training for 3.5 days on eight GPUs, a small fraction\\nof the training costs of the best models from the literature. We show that the\\nTransformer generalizes well to other tasks by applying it successfully to\\nEnglish constituency parsing both with large and limited training data.'}\n"
-     ]
-    }
-   ],
-   "source": [
-    "# Load documents from ArXiv\n",
-    "loader = ArxivLoader(\n",
-    "    query=\"1706.03762\",\n",
-    "    load_max_docs=1,\n",
-    ")\n",
-    "docs = loader.load()\n",
-    "print(docs[0].metadata)\n",
-    "\n",
-    "# Split documents into chunks\n",
-    "splitter = RecursiveCharacterTextSplitter(\n",
-    "    chunk_size=CONFIG[\"chunk_size\"],\n",
-    "    chunk_overlap=CONFIG[\"chunk_overlap\"],\n",
-    ")\n",
-    "chunks = splitter.split_documents(docs)\n",
-    "\n",
-    "\n",
-    "# Join chunks into a single string\n",
-    "def join_chunks(chunks):\n",
-    "    return \"\\n\\n\".join([chunk.page_content for chunk in chunks])"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "6e194ab4",
-   "metadata": {},
-   "source": [
-    "#### Vector Store and Retriever Setup"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "id": "26dfbeaa",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Create embeddings\n",
-    "embeddings = OpenAIEmbeddings(model=CONFIG[\"embeddings_model\"])\n",
-    "\n",
-    "# Create vector store from documents\n",
-    "vectorstore = InMemoryVectorStore.from_documents(\n",
-    "    chunks,\n",
-    "    embedding=embeddings,\n",
-    ")\n",
-    "\n",
-    "# Create retriever\n",
-    "retriever = vectorstore.as_retriever(search_kwargs={\"k\": CONFIG[\"retriever_k\"]})"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "bc1f181b",
-   "metadata": {},
-   "source": [
-    "#### RAG Chain Construction using [LCEL](https://python.langchain.com/docs/concepts/lcel/)\n",
-    "\n",
-    "Flow:\n",
-    "1. Query → Retriever (finds relevant chunks)\n",
-    "2. Chunks → join_chunks (creates context)\n",
-    "3. Context + Query → Prompt Template\n",
-    "4. Prompt → Language Model → Response\n"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 6,
-   "id": "6a810dc3",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Initialize the language model\n",
-    "llm = ChatOpenAI(model=CONFIG[\"llm\"], temperature=CONFIG[\"temperature\"])\n",
-    "\n",
-    "# Create the prompt template\n",
-    "prompt = ChatPromptTemplate.from_messages(\n",
-    "    [\n",
-    "        (\"system\", CONFIG[\"system_prompt\"] + \"\\n\\nContext:\\n{context}\\n\\n\"),\n",
-    "        (\"human\", \"\\n{question}\\n\"),\n",
-    "    ]\n",
-    ")\n",
-    "\n",
-    "# Construct the RAG chain\n",
-    "rag_chain = (\n",
-    "    {\n",
-    "        \"context\": retriever | RunnableLambda(join_chunks),\n",
-    "        \"question\": RunnablePassthrough(),\n",
-    "    }\n",
-    "    | prompt\n",
-    "    | llm\n",
-    "    | StrOutputParser()\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "c04bd019",
-   "metadata": {},
-   "source": [
-    "#### Prediction Function with MLflow Tracing\n",
-    "\n",
-    "Create a prediction function decorated with `@mlflow.trace` to automatically log:\n",
-    "- Input queries\n",
-    "- Retrieved documents\n",
-    "- Generated responses\n",
-    "- Execution time\n",
-    "- Chain intermediate steps"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "id": "7b45fc04",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Question: What is the main idea of the paper?\n",
-      "Response: The main idea is to replace recurrent/convolutional sequence models with a pure attention-based architecture called the Transformer. It uses self-attention to model dependencies between all positions in the input and output, enabling full parallelization and better handling of long-range relations. This approach achieves strong results on translation and can extend to other modalities.\n"
-     ]
-    }
-   ],
-   "source": [
-    "@mlflow.trace\n",
-    "def predict_fn(question: str) -> str:\n",
-    "    return rag_chain.invoke(question)\n",
-    "\n",
-    "\n",
-    "# Test the prediction function\n",
-    "sample_question = \"What is the main idea of the paper?\"\n",
-    "response = predict_fn(sample_question)\n",
-    "print(f\"Question: {sample_question}\")\n",
-    "print(f\"Response: {response}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "421469de",
-   "metadata": {},
-   "source": [
-    "#### Evaluation Dataset and Scoring\n",
-    "\n",
-    "Define an evaluation dataset and run systematic evaluation using [MLflow's built-in scorers](https://mlflow.org/docs/latest/genai/eval-monitor/scorers/llm-judge/predefined/#available-scorers):\n",
-    "\n",
-    "<u>Evaluation Components:</u>\n",
-    "- **Dataset**: Questions with expected concepts and facts\n",
-    "- **Scorers**: \n",
-    "  - `RelevanceToQuery`: Measures how relevant the response is to the question\n",
-    "  - `Correctness`: Evaluates factual accuracy of the response\n",
-    "  - `ExpectationsGuidelines`: Checks that output matches expectation guidelines\n",
-    "\n",
-    "<u>Best Practices:</u>\n",
-    "- Create diverse test cases covering different query types\n",
-    "- Include expected concepts to guide evaluation\n",
-    "- Use multiple scoring metrics for comprehensive assessment"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 8,
-   "id": "5c1dc4f2",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "2025/08/23 20:14:39 INFO mlflow.models.evaluation.utils.trace: Auto tracing is temporarily enabled during the model evaluation for computing some metrics and debugging. To disable tracing, call `mlflow.autolog(disable=True)`.\n",
-      "2025/08/23 20:14:39 INFO mlflow.genai.utils.data_validation: Testing model prediction with the first sample in the dataset.\n"
-     ]
-    },
-    {
-     "data": {
-      "application/vnd.jupyter.widget-view+json": {
-       "model_id": "2b6c6687efa24796b39c7951d589d481",
-       "version_major": 2,
-       "version_minor": 0
-      },
-      "text/plain": [
-       "Evaluating:   0%|          | 0/3 [Elapsed: 00:00, Remaining: ?] "
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    },
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "\n",
-      "✨ Evaluation completed.\n",
-      "\n",
-      "Metrics and evaluation results are logged to the MLflow run:\n",
-      "  Run name: \u001b[94mbaseline_eval\u001b[0m\n",
-      "  Run ID: \u001b[94ma2218d9f24c9415f8040d3b77af103a9\u001b[0m\n",
-      "\n",
-      "To view the detailed evaluation results with sample-wise scores,\n",
-      "open the \u001b[93m\u001b[1mTraces\u001b[0m tab in the Run page in the MLflow UI.\n",
-      "\n"
-     ]
-    }
-   ],
-   "source": [
-    "# Define evaluation dataset\n",
-    "eval_dataset = [\n",
-    "    {\n",
-    "        \"inputs\": {\"question\": \"What is the main idea of the paper?\"},\n",
-    "        \"expectations\": {\n",
-    "            \"key_concepts\": [\"attention mechanism\", \"transformer\", \"neural network\"],\n",
-    "            \"expected_facts\": [\n",
-    "                \"attention mechanism is a key component of the transformer model\"\n",
-    "            ],\n",
-    "            \"guidelines\": [\"The response must be factual and concise\"],\n",
-    "        },\n",
-    "    },\n",
-    "    {\n",
-    "        \"inputs\": {\n",
-    "            \"question\": \"What's the difference between a transformer and a recurrent neural network?\"\n",
-    "        },\n",
-    "        \"expectations\": {\n",
-    "            \"key_concepts\": [\"sequential\", \"attention mechanism\", \"hidden state\"],\n",
-    "            \"expected_facts\": [\n",
-    "                \"transformer processes data in parallel while RNN processes data sequentially\"\n",
-    "            ],\n",
-    "            \"guidelines\": [\n",
-    "                \"The response must be factual and focus on the difference between the two models\"\n",
-    "            ],\n",
-    "        },\n",
-    "    },\n",
-    "    {\n",
-    "        \"inputs\": {\"question\": \"What does the attention mechanism do?\"},\n",
-    "        \"expectations\": {\n",
-    "            \"key_concepts\": [\"query\", \"key\", \"value\", \"relationship\", \"similarity\"],\n",
-    "            \"expected_facts\": [\n",
-    "                \"attention allows the model to weigh the importance of different parts of the input sequence when processing it\"\n",
-    "            ],\n",
-    "            \"guidelines\": [\n",
-    "                \"The response must be factual and explain the concept of attention\"\n",
-    "            ],\n",
-    "        },\n",
-    "    },\n",
-    "]\n",
-    "\n",
-    "# Run evaluation with MLflow\n",
-    "with mlflow.start_run(run_name=\"baseline_eval\") as run:\n",
-    "    # Log configuration parameters\n",
-    "    mlflow.log_params(CONFIG)\n",
-    "\n",
-    "    # Run evaluation\n",
-    "    results = mlflow.genai.evaluate(\n",
-    "        data=eval_dataset,\n",
-    "        predict_fn=predict_fn,\n",
-    "        scorers=[RelevanceToQuery(), Correctness(), ExpectationsGuidelines()],\n",
-    "    )"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "52b137c7",
-   "metadata": {},
-   "source": [
-    "#### Launch MLflow UI to check out the results\n",
-    "\n",
-    "<u>What you'll see in the UI:</u>\n",
-    "- **Experiments**: Compare different RAG configurations\n",
-    "- **Runs**: Individual experiment runs with metrics and parameters\n",
-    "- **Traces**: Detailed execution traces showing retrieval and generation steps\n",
-    "- **Evaluation Results**: Scoring metrics and detailed comparisons\n",
-    "- **Artifacts**: Saved models, datasets, and other files\n",
-    "\n",
-    "Navigate to `http://localhost:5000` after running the command below."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "817c3799",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "!mlflow ui"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "c75861e3",
-   "metadata": {},
-   "source": [
-    "You should see something like this\n",
-    "\n",
-    "![MLflow UI image](https://miro.medium.com/v2/resize:fit:720/format:webp/1*Cx7MMy53pAP7150x_hvztA.png)"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "venv",
-   "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.13.5"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
-}

docs/README.md

@@ -1,154 +1,3 @@
 # LangChain Documentation
 
-For more information on contributing to our documentation, see the [Documentation Contributing Guide](https://python.langchain.com/docs/contributing/how_to/documentation).
-
-## Structure
-
-The primary documentation is located in the `docs/` directory. This directory contains
-both the source files for the main documentation as well as the API reference doc
-build process.
-
-### API Reference
-
-API reference documentation is located in `docs/api_reference/` and is generated from
-the codebase using Sphinx.
-
-The API reference have additional build steps that differ from the main documentation.
-
-#### Deployment Process
-
-Currently, the build process roughly follows these steps:
-
-1. Using the `api_doc_build.yml` GitHub workflow, the API reference docs are
-    [built](#build-technical-details) and copied to the `langchain-api-docs-html`
-    repository. This workflow is triggered either (1) on a cron routine interval or (2)
-    triggered manually.
-
-    In short, the workflow extracts all `langchain-ai`-org-owned repos defined in
-    `langchain/libs/packages.yml`, clones them locally (in the workflow runner's file
-    system), and then builds the API reference RST files (using `create_api_rst.py`).
-    Following post-processing, the HTML files are pushed to the
-    `langchain-api-docs-html` repository.
-2. After the HTML files are in the `langchain-api-docs-html` repository, they are **not**
-    automatically published to the [live docs site](https://python.langchain.com/api_reference/).
-
-    The docs site is served by Vercel. The Vercel deployment process copies the HTML
-    files from the `langchain-api-docs-html` repository and deploys them to the live
-    site. Deployments are triggered on each new commit pushed to `v0.3`.
-
-#### Build Technical Details
-
-The build process creates a virtual monorepo by syncing multiple repositories, then generates comprehensive API documentation:
-
-1. **Repository Sync Phase:**
-   - `.github/scripts/prep_api_docs_build.py` - Clones external partner repos and organizes them into the `libs/partners/` structure to create a virtual monorepo for documentation building
-
-2. **RST Generation Phase:**
-   - `docs/api_reference/create_api_rst.py` - Main script that **generates RST files** from Python source code
-     - Scans `libs/` directories and extracts classes/functions from each module (using `inspect`)
-     - Creates `.rst` files using specialized templates for different object types
-     - Templates in `docs/api_reference/templates/` (`pydantic.rst`, `runnable_pydantic.rst`, etc.)
-
-3. **HTML Build Phase:**
-   - Sphinx-based, uses `sphinx.ext.autodoc` (auto-extracts docstrings from the codebase)
-     - `docs/api_reference/conf.py` (sphinx config) configures `autodoc` and other extensions
-   - `sphinx-build` processes the generated `.rst` files into HTML using autodoc
-   - `docs/api_reference/scripts/custom_formatter.py` - Post-processes the generated HTML
-   - Copies `reference.html` to `index.html` to create the default landing page (artifact? might not need to do this - just put everyhing in index directly?)
-
-4. **Deployment:**
-   - `.github/workflows/api_doc_build.yml` - Workflow responsible for orchestrating the entire build and deployment process
-   - Built HTML files are committed and pushed to the `langchain-api-docs-html` repository
-
-#### Local Build
-
-For local development and testing of API documentation, use the Makefile targets in the repository root:
-
-```bash
-# Full build
-make api_docs_build
-```
-
-Like the CI process, this target:
-
-- Installs the CLI package in editable mode
-- Generates RST files for all packages using `create_api_rst.py`
-- Builds HTML documentation with Sphinx
-- Post-processes the HTML with `custom_formatter.py`
-- Opens the built documentation (`reference.html`) in your browser
-
-**Quick Preview:**
-
-```bash
-make api_docs_quick_preview API_PKG=openai
-```
-
-- Generates RST files for only the specified package (default: `text-splitters`)
-- Builds and post-processes HTML documentation
-- Opens the preview in your browser
-
-Both targets automatically clean previous builds and handle the complete build pipeline locally, mirroring the CI process but for faster iteration during development.
-
-#### Documentation Standards
-
-**Docstring Format:**
-The API reference uses **Google-style docstrings** with reStructuredText markup. Sphinx processes these through the `sphinx.ext.napoleon` extension to generate documentation.
-
-**Required format:**
-
-```python
-def example_function(param1: str, param2: int = 5) -> bool:
-    """Brief description of the function.
-
-    Longer description can go here. Use reStructuredText syntax for
-    rich formatting like **bold** and *italic*.
-
-    TODO: code: figure out what works?
-
-    Args:
-        param1: Description of the first parameter.
-        param2: Description of the second parameter with default value.
-
-    Returns:
-        Description of the return value.
-
-    Raises:
-        ValueError: When param1 is empty.
-        TypeError: When param2 is not an integer.
-
-    .. warning::
-        This function is experimental and may change.
-    """
-```
-
-**Special Markers:**
-
-- `:private:` in docstrings excludes members from documentation
-- `.. warning::` adds warning admonitions
-
-#### Site Styling and Assets
-
-**Theme and Styling:**
-
-- Uses [**PyData Sphinx Theme**](https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html) (`pydata_sphinx_theme`)
-- Custom CSS in `docs/api_reference/_static/css/custom.css` with LangChain-specific:
-  - Color palette
-  - Inter font family
-  - Custom navbar height and sidebar formatting
-  - Deprecated/beta feature styling
-
-**Static Assets:**
-
-- Logos: `_static/wordmark-api.svg` (light) and `_static/wordmark-api-dark.svg` (dark mode)
-- Favicon: `_static/img/brand/favicon.png`
-- Custom CSS: `_static/css/custom.css`
-
-**Post-Processing:**
-
-- `scripts/custom_formatter.py` cleans up generated HTML:
-  - Shortens TOC entries from `ClassName.method()` to `method()`
-
-**Analytics and Integration:**
-
-- GitHub integration (source links, edit buttons)
-- Example backlinking through custom `ExampleLinksDirective`
+For more information on contributing to our documentation, see the [Documentation Contributing Guide](https://python.langchain.com/docs/contributing/how_to/documentation)

docs/api_reference/_extensions/gallery_directive.py

@@ -50,7 +50,7 @@ class GalleryGridDirective(SphinxDirective):
     individual cards + ["image", "header", "content", "title"].
 
     Danger:
-        This directive can only be used in the context of a MyST documentation page as
+        This directive can only be used in the context of a Myst documentation page as
         the templates use Markdown flavored formatting.
     """
 

docs/api_reference/conf.py

@@ -1,5 +1,7 @@
 """Configuration file for the Sphinx documentation builder."""
 
+# Configuration file for the Sphinx documentation builder.
+#
 # This file only contains a selection of the most common options. For a full
 # list see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
@@ -18,18 +20,16 @@ from docutils.parsers.rst.directives.admonitions import BaseAdmonition
 from docutils.statemachine import StringList
 from sphinx.util.docutils import SphinxDirective
 
-# Add paths to Python import system so Sphinx can import LangChain modules
-# This allows autodoc to introspect and document the actual code
-_DIR = Path(__file__).parent.absolute()
-sys.path.insert(0, os.path.abspath("."))  # Current directory
-sys.path.insert(0, os.path.abspath("../../libs/langchain"))  # LangChain main package
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+
+_DIR = Path(__file__).parent.absolute()
+sys.path.insert(0, os.path.abspath("."))
+sys.path.insert(0, os.path.abspath("../../libs/langchain"))
 
-# Load package metadata from pyproject.toml (for version info, etc.)
 with (_DIR.parents[1] / "libs" / "langchain" / "pyproject.toml").open("r") as f:
     data = toml.load(f)
-
-# Load mapping of classes to example notebooks for backlinking
-# This file is generated by scripts that scan our tutorial/example notebooks
 with (_DIR / "guide_imports.json").open("r") as f:
     imported_classes = json.load(f)
 
@@ -86,7 +86,6 @@ class Beta(BaseAdmonition):
 
 
 def setup(app):
-    """Register custom directives and hooks with Sphinx."""
     app.add_directive("example_links", ExampleLinksDirective)
     app.add_directive("beta", Beta)
     app.connect("autodoc-skip-member", skip_private_members)
@@ -98,7 +97,7 @@ def skip_private_members(app, what, name, obj, skip, options):
     if hasattr(obj, "__doc__") and obj.__doc__ and ":private:" in obj.__doc__:
         return True
     if name == "__init__" and obj.__objclass__ is object:
-        # don't document default init
+        # dont document default init
         return True
     return None
 
@@ -126,7 +125,7 @@ extensions = [
     "sphinx.ext.viewcode",
     "sphinxcontrib.autodoc_pydantic",
     "IPython.sphinxext.ipython_console_highlighting",
-    "myst_parser",  # For generated index.md and reference.md
+    "myst_parser",
     "_extensions.gallery_directive",
     "sphinx_design",
     "sphinx_copybutton",
@@ -259,7 +258,6 @@ html_static_path = ["_static"]
 html_css_files = ["css/custom.css"]
 html_use_index = False
 
-# Only used on the generated index.md and reference.md files
 myst_enable_extensions = ["colon_fence"]
 
 # generate autosummary even if no references
@@ -270,11 +268,11 @@ autosummary_ignore_module_all = False
 html_copy_source = False
 html_show_sourcelink = False
 
-googleanalytics_id = "G-9B66JQQH2F"
-
 # Set canonical URL from the Read the Docs Domain
 html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
 
+googleanalytics_id = "G-9B66JQQH2F"
+
 # Tell Jinja2 templates the build is running on Read the Docs
 if os.environ.get("READTHEDOCS", "") == "True":
     html_context["READTHEDOCS"] = True

docs/api_reference/create_api_rst.py

@@ -1,41 +1,4 @@
-"""Auto-generate API reference documentation (RST files) for LangChain packages.
-
-* Automatically discovers all packages in `libs/` and `libs/partners/`
-* For each package, recursively walks the filesystem to:
-    * Load Python modules using importlib
-    * Extract classes and functions using Python's inspect module
-    * Classify objects by type (Pydantic models, Runnables, TypedDicts, etc.)
-    * Filter out private members (names starting with '_') and deprecated items
-* Creates structured RST files with:
-    * Module-level documentation pages with autosummary tables
-    * Different Sphinx templates based on object type (see templates/ directory)
-    * Proper cross-references and navigation structure
-    * Separation of current vs deprecated APIs
-* Generates a directory tree like:
-    ```
-    docs/api_reference/
-    ├── index.md              # Main landing page with package gallery
-    ├── reference.md          # Package overview and navigation
-    ├── core/                 # langchain-core documentation
-    │   ├── index.rst
-    │   ├── callbacks.rst
-    │   └── ...
-    ├── langchain/            # langchain documentation
-    │   ├── index.rst
-    │   └── ...
-    └── partners/             # Integration packages
-        ├── openai/
-        ├── anthropic/
-        └── ...
-    ```
-
-## Key Features
-
-* Respects privacy markers:
-    * Modules with `:private:` in docstring are excluded entirely
-    * Objects with `:private:` in docstring are filtered out
-    * Names starting with '_' are treated as private
-"""
+"""Script for auto-generating api_reference.rst."""
 
 import importlib
 import inspect
@@ -134,7 +97,7 @@ def _load_module_members(module_path: str, namespace: str) -> ModuleMembers:
             if type(type_) is typing_extensions._TypedDictMeta:  # type: ignore
                 kind: ClassKind = "TypedDict"
             elif type(type_) is typing._TypedDictMeta:  # type: ignore
-                kind = "TypedDict"
+                kind: ClassKind = "TypedDict"
             elif (
                 issubclass(type_, Runnable)
                 and issubclass(type_, BaseModel)
@@ -214,20 +177,19 @@ def _load_package_modules(
     Traversal based on the file system makes it easy to determine which
     of the modules/packages are part of the package vs. 3rd party or built-in.
 
-    Args:
-        package_directory: Path to the package directory.
-        submodule: Optional name of submodule to load.
+    Parameters:
+        package_directory (Union[str, Path]): Path to the package directory.
+        submodule (Optional[str]): Optional name of submodule to load.
 
     Returns:
-        A dictionary where keys are module names and values are `ModuleMembers`
-        objects.
+        Dict[str, ModuleMembers]: A dictionary where keys are module names and values are ModuleMembers objects.
     """
     package_path = (
         Path(package_directory)
         if isinstance(package_directory, str)
         else package_directory
     )
-    modules_by_namespace: Dict[str, ModuleMembers] = {}
+    modules_by_namespace = {}
 
     # Get the high level package name
     package_name = package_path.name
@@ -237,13 +199,12 @@ def _load_package_modules(
         package_path = package_path / submodule
 
     for file_path in package_path.rglob("*.py"):
-        # Skip private modules
         if file_path.name.startswith("_"):
             continue
 
-        # Skip integration_template and project_template directories (for libs/cli)
         if "integration_template" in file_path.parts:
             continue
+
         if "project_template" in file_path.parts:
             continue
 
@@ -254,14 +215,13 @@ def _load_package_modules(
             continue
 
         # Get the full namespace of the module
-        # Example: langchain_core/schema/output_parsers.py ->
-        #          langchain_core.schema.output_parsers
         namespace = str(relative_module_name).replace(".py", "").replace("/", ".")
-
         # Keep only the top level namespace
-        # Example: langchain_core.schema.output_parsers ->
-        #          langchain_core
-        top_namespace = namespace.split(".")[0]
+        # (but make special exception for content_blocks and messages.v1)
+        if namespace == "messages.content_blocks" or namespace == "messages.v1":
+            top_namespace = namespace  # Keep full namespace for content_blocks
+        else:
+            top_namespace = namespace.split(".")[0]
 
         try:
             # If submodule is present, we need to construct the paths in a slightly
@@ -297,16 +257,16 @@ def _construct_doc(
     members_by_namespace: Dict[str, ModuleMembers],
     package_version: str,
 ) -> List[typing.Tuple[str, str]]:
-    """Construct the contents of the `reference.rst` for the given package.
+    """Construct the contents of the reference.rst file for the given package.
 
     Args:
         package_namespace: The package top level namespace
-        members_by_namespace: The members of the package dict organized by top level.
-            Module contains a list of classes and functions inside of the top level
-            namespace.
+        members_by_namespace: The members of the package, dict organized by top level
+                              module contains a list of classes and functions
+                              inside of the top level namespace.
 
     Returns:
-        The string contents of the reference.rst file.
+        The contents of the reference.rst file.
     """
     docs = []
     index_doc = f"""\
@@ -509,13 +469,10 @@ def _construct_doc(
 
 
 def _build_rst_file(package_name: str = "langchain") -> None:
-    """Create a rst file for a given package.
+    """Create a rst file for building of documentation.
 
     Args:
-        package_name: Name of the package to create the rst file for.
-
-    Returns:
-        The rst file is created in the same directory as this script.
+        package_name: Can be either "langchain" or "core" or "experimental".
     """
     package_dir = _package_dir(package_name)
     package_members = _load_package_modules(package_dir)
@@ -534,7 +491,7 @@ def _package_namespace(package_name: str) -> str:
     """Returns the package name used.
 
     Args:
-        package_name: Can be either "langchain" or "core"
+        package_name: Can be either "langchain" or "core" or "experimental".
 
     Returns:
         modified package_name: Can be either "langchain" or "langchain_{package_name}"
@@ -547,10 +504,7 @@ def _package_namespace(package_name: str) -> str:
 
 
 def _package_dir(package_name: str = "langchain") -> Path:
-    """Return the path to the directory containing the documentation.
-
-    Attempts to find the package in `libs/` first, then `libs/partners/`.
-    """
+    """Return the path to the directory containing the documentation."""
     if (ROOT_DIR / "libs" / package_name).exists():
         return ROOT_DIR / "libs" / package_name / _package_namespace(package_name)
     else:
@@ -564,7 +518,7 @@ def _package_dir(package_name: str = "langchain") -> Path:
 
 
 def _get_package_version(package_dir: Path) -> str:
-    """Return the version of the package by reading the `pyproject.toml`."""
+    """Return the version of the package."""
     try:
         with open(package_dir.parent / "pyproject.toml", "r") as f:
             pyproject = toml.load(f)
@@ -590,39 +544,22 @@ def _out_file_path(package_name: str) -> Path:
 
 
 def _build_index(dirs: List[str]) -> None:
-    """Build the index.md file for the API reference.
-
-    Args:
-        dirs: List of package directories to include in the index.
-
-    Returns:
-        The index.md file is created in the same directory as this script.
-    """
-
     custom_names = {
         "aws": "AWS",
         "ai21": "AI21",
         "ibm": "IBM",
     }
-    ordered = [
-        "core",
-        "langchain",
-        "text-splitters",
-        "community",
-        "standard-tests",
-    ]
+    ordered = ["core", "langchain", "text-splitters", "community", "experimental"]
     main_ = [dir_ for dir_ in ordered if dir_ in dirs]
     integrations = sorted(dir_ for dir_ in dirs if dir_ not in main_)
     doc = """# LangChain Python API Reference
 
-Welcome to the LangChain v0.3 Python API reference. This is a reference for all
+Welcome to the LangChain Python API reference. This is a reference for all
 `langchain-x` packages.
 
-These pages refer to the the v0.3 versions of LangChain packages and integrations. To
-visit the documentation for the latest versions of LangChain, visit [https://docs.langchain.com](https://docs.langchain.com)
-and [https://reference.langchain.com/python/](https://reference.langchain.com/python/) (for references.)
+For user guides see [https://python.langchain.com](https://python.langchain.com).
 
-For the legacy API reference (<v0.3) hosted on ReadTheDocs see [https://api.python.langchain.com/](https://api.python.langchain.com/).
+For the legacy API reference hosted on ReadTheDocs see [https://api.python.langchain.com/](https://api.python.langchain.com/).
 """
 
     if main_:
@@ -708,14 +645,9 @@ See the full list of integrations in the Section Navigation.
 {integration_tree}
 ```
 """
-    # Write the reference.md file
     with open(HERE / "reference.md", "w") as f:
         f.write(doc)
 
-    # Write a dummy index.md file that points to reference.md
-    # Sphinx requires an index file to exist in each doc directory
-    # TODO: investigate why we don't just put everything in index.md directly?
-    # if it works it works I guess
     dummy_index = """\
 # API reference
 
@@ -731,11 +663,8 @@ Reference<reference>
 
 
 def main(dirs: Optional[list] = None) -> None:
-    """Generate the `api_reference.rst` file for each package.
-
-    If dirs is None, generate for all packages in `libs/` and `libs/partners/`.
-    Otherwise generate only for the specified package(s).
-    """
+    """Generate the api_reference.rst file for each package."""
+    print("Starting to build API reference files.")
     if not dirs:
         dirs = [
             p.parent.name
@@ -744,17 +673,18 @@ def main(dirs: Optional[list] = None) -> None:
             if p.parent.parent.name in ("libs", "partners")
         ]
     for dir_ in sorted(dirs):
-        # Skip any hidden directories prefixed with a dot
+        # Skip any hidden directories
         # Some of these could be present by mistake in the code base
-        # (e.g., .pytest_cache from running tests from the wrong location)
+        # e.g., .pytest_cache from running tests from the wrong location.
         if dir_.startswith("."):
             print("Skipping dir:", dir_)
             continue
         else:
-            print("Building:", dir_)
+            print("Building package:", dir_)
             _build_rst_file(package_name=dir_)
 
     _build_index(sorted(dirs))
+    print("API reference files built.")
 
 
 if __name__ == "__main__":

docs/api_reference/requirements.txt

@@ -1,12 +1,12 @@
 autodoc_pydantic>=2,<3
 sphinx>=8,<9
+myst-parser>=3
 sphinx-autobuild>=2024
+pydata-sphinx-theme>=0.15
+toml>=0.10.2
+myst-nb>=1.1.1
+pyyaml
 sphinx-design
 sphinx-copybutton
-sphinxcontrib-googleanalytics
-pydata-sphinx-theme>=0.15
-myst-parser>=3
-myst-nb>=1.1.1
-toml>=0.10.2
-pyyaml
 beautifulsoup4
+sphinxcontrib-googleanalytics

docs/api_reference/scripts/custom_formatter.py

@@ -1,10 +1,3 @@
-"""Post-process generated HTML files to clean up table-of-contents headers.
-
-Runs after Sphinx generates the API reference HTML. It finds TOC entries like
-"ClassName.method_name()" and shortens them to just "method_name()" for better
-readability in the sidebar navigation.
-"""
-
 import sys
 from glob import glob
 from pathlib import Path

docs/docs/concepts/async.mdx

@@ -1,4 +1,4 @@
-# Async programming with LangChain
+# Async programming with langchain
 
 :::info Prerequisites
 * [Runnable interface](/docs/concepts/runnables)
@@ -12,7 +12,7 @@ You are expected to be familiar with asynchronous programming in Python before r
 This guide specifically focuses on what you need to know to work with LangChain in an asynchronous context, assuming that you are already familiar with asynchronous programming.
 :::
 
-## LangChain asynchronous APIs
+## Langchain asynchronous APIs
 
 Many LangChain APIs are designed to be asynchronous, allowing you to build efficient and responsive applications.
 

docs/docs/concepts/index.mdx

@@ -31,7 +31,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
 - **[Vector stores](/docs/concepts/vectorstores)**: Storage of and efficient search over vectors and associated metadata.
 - **[Retriever](/docs/concepts/retrievers)**: A component that returns relevant documents from a knowledge base in response to a query.
 - **[Retrieval Augmented Generation (RAG)](/docs/concepts/rag)**: A technique that enhances language models by combining them with external knowledge bases.
-- **[Agents](/docs/concepts/agents)**: Use a [language model](/docs/concepts/chat_models) to choose a sequence of actions to take. Agents can interact with external resources via [tools](/docs/concepts/tools).
+- **[Agents](/docs/concepts/agents)**: Use a [language model](/docs/concepts/chat_models) to choose a sequence of actions to take. Agents can interact with external resources via [tool](/docs/concepts/tools).
 - **[Prompt templates](/docs/concepts/prompt_templates)**: Component for factoring out the static parts of a model "prompt" (usually a sequence of messages). Useful for serializing, versioning, and reusing these static parts.
 - **[Output parsers](/docs/concepts/output_parsers)**: Responsible for taking the output of a model and transforming it into a more suitable format for downstream tasks. Output parsers were primarily useful prior to the general availability of [tool calling](/docs/concepts/tool_calling) and [structured outputs](/docs/concepts/structured_outputs).
 - **[Few-shot prompting](/docs/concepts/few_shot_prompting)**: A technique for improving model performance by providing a few examples of the task to perform in the prompt.
@@ -48,7 +48,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
 - **[AIMessage](/docs/concepts/messages#aimessage)**: Represents a complete response from an AI model.
 - **[astream_events](/docs/concepts/chat_models#key-methods)**: Stream granular information from [LCEL](/docs/concepts/lcel) chains.
 - **[BaseTool](/docs/concepts/tools/#tool-interface)**: The base class for all tools in LangChain.
-- **[batch](/docs/concepts/runnables)**: Used to execute a runnable with batch inputs.
+- **[batch](/docs/concepts/runnables)**: Use to execute a runnable with batch inputs.
 - **[bind_tools](/docs/concepts/tool_calling/#tool-binding)**: Allows models to interact with tools.
 - **[Caching](/docs/concepts/chat_models#caching)**: Storing results to avoid redundant calls to a chat model.
 - **[Chat models](/docs/concepts/multimodality/#multimodality-in-chat-models)**: Chat models that handle multiple data modalities.

docs/docs/concepts/messages.mdx

@@ -147,7 +147,7 @@ An `AIMessage` has the following attributes. The attributes which are **standard
 | `tool_calls`         | Standardized     | Tool calls associated with the message. See [tool calling](/docs/concepts/tool_calling) for details.                                                                                                                    |
 | `invalid_tool_calls` | Standardized     | Tool calls with parsing errors associated with the message. See [tool calling](/docs/concepts/tool_calling) for details.                                                                                                |
 | `usage_metadata`     | Standardized     | Usage metadata for a message, such as [token counts](/docs/concepts/tokens). See [Usage Metadata API Reference](https://python.langchain.com/api_reference/core/messages/langchain_core.messages.ai.UsageMetadata.html). |
-| `id`                 | Standardized     | An optional unique identifier for the message, ideally provided by the provider/model that created the message. See [Message IDs](#message-ids) for details.                                                                                                         |
+| `id`                 | Standardized     | An optional unique identifier for the message, ideally provided by the provider/model that created the message.                                                                                                         |
 | `response_metadata`  | Raw              | Response metadata, e.g., response headers, logprobs, token counts.                                                                                                                                                      |
 
 #### content
@@ -243,37 +243,3 @@ At the moment, the output of the model will be in terms of LangChain messages, s
 need OpenAI format for the output as well.
 
 The [convert_to_openai_messages](https://python.langchain.com/api_reference/core/messages/langchain_core.messages.utils.convert_to_openai_messages.html) utility function can be used to convert from LangChain messages to OpenAI format.
-
-## Message IDs
-
-LangChain messages include an optional `id` field that serves as a unique identifier. Understanding when and how these IDs are assigned can be helpful for debugging, tracing, and working with message history.
-
-### When Messages Get IDs
-
-Messages receive IDs in the following scenarios:
-
-**Automatically assigned by LangChain:**
-- When generated through chat model invocation (`.invoke()`, `.stream()`, `.astream()`) with an active run manager/tracing context
-- IDs follow the format:
-    - `run-$RUN_ID` (e.g., `run-ba48f958-6402-41a5-b461-5e250a4ebd36-0`)
-    - `run-$RUN_ID-$IDX` (e.g., `run-ba48f958-6402-41a5-b461-5e250a4ebd36-1`) when there are multiple generations from a single chat model invocation.
-
-**Provider-assigned IDs (highest priority):**
-- When the model provider assigns its own ID to the message
-- These take precedence over LangChain-generated run IDs
-- Format varies by provider
-
-### When Messages Don't Get IDs
-
-Messages will **not** receive IDs in these situations:
-
-- **Manual message creation**: Messages created directly (e.g., `AIMessage(content="hello")`) without going through chat models
-- **No run manager context**: When there's no active callback/tracing infrastructure
-
-### ID Priority System
-
-LangChain follows a clear precedence system for message IDs:
-
-1. **Provider-assigned IDs** (highest priority): IDs from the model provider
-2. **LangChain run IDs** (medium priority): IDs starting with `run-`
-3. **Manual IDs** (lowest priority): IDs explicitly set by users

docs/docs/concepts/prompt_templates.mdx

@@ -53,29 +53,17 @@ This is how you use MessagesPlaceholder.
 
 ```python
 from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
-from langchain_core.messages import HumanMessage, AIMessage
+from langchain_core.messages import HumanMessage
 
 prompt_template = ChatPromptTemplate([
     ("system", "You are a helpful assistant"),
     MessagesPlaceholder("msgs")
 ])
 
-# Simple example with one message
 prompt_template.invoke({"msgs": [HumanMessage(content="hi!")]})
-
-# More complex example with conversation history
-messages_to_pass = [
-    HumanMessage(content="What's the capital of France?"),
-    AIMessage(content="The capital of France is Paris."),
-    HumanMessage(content="And what about Germany?")
-]
-
-formatted_prompt = prompt_template.invoke({"msgs": messages_to_pass})
-print(formatted_prompt)
 ```
 
-
-This will produce a list of four messages total: the system message plus the three messages we passed in (two HumanMessages and one AIMessage).
+This will produce a list of two messages, the first one being a system message, and the second one being the HumanMessage we passed in.
 If we had passed in 5 messages, then it would have produced 6 messages in total (the system message plus the 5 passed in).
 This is useful for letting a list of messages be slotted into a particular spot.
 

docs/docs/concepts/structured_outputs.mdx

@@ -29,22 +29,6 @@ model_with_structure = model.with_structured_output(schema)
 structured_output = model_with_structure.invoke(user_input)
 ```
 
-:::warning[Tool Order Matters]
-
-When combining structured output with additional tools, bind tools **first**, then apply structured output:
-
-```python
-# Correct
-model_with_tools = model.bind_tools([tool1, tool2])
-structured_model = model_with_tools.with_structured_output(schema)
-
-# Incorrect - will cause tool resolution errors
-structured_model = model.with_structured_output(schema)
-broken_model = structured_model.bind_tools([tool1, tool2])
-```
-
-:::
-
 ## Schema definition
 
 The central concept is that the output structure of model responses needs to be represented in some way.

docs/docs/concepts/tools.mdx

@@ -31,7 +31,7 @@ The key attributes that correspond to the tool's **schema**:
 The key methods to execute the function associated with the **tool**:
 
 - **invoke**: Invokes the tool with the given arguments.
-- **ainvoke**: Invokes the tool with the given arguments, asynchronously. Used for [async programming with LangChain](/docs/concepts/async).
+- **ainvoke**: Invokes the tool with the given arguments, asynchronously. Used for [async programming with Langchain](/docs/concepts/async).
 
 ## Create tools using the `@tool` decorator
 
@@ -171,26 +171,6 @@ Please see the [InjectedState](https://langchain-ai.github.io/langgraph/referenc
 
 Please see the [InjectedStore](https://langchain-ai.github.io/langgraph/reference/prebuilt/#langgraph.prebuilt.tool_node.InjectedStore) documentation for more details.
 
-## Tool Artifacts vs. Injected State
-
-Although similar conceptually, tool artifacts in LangChain and [injected state in LangGraph](https://langchain-ai.github.io/langgraph/reference/agents/#langgraph.prebuilt.tool_node.InjectedState) serve different purposes and operate at different levels of abstraction.
-
-**Tool Artifacts**
-
-- **Purpose:** Store and pass data between tool executions within a single chain/workflow
-- **Scope:** Limited to tool-to-tool communication
-- **Lifecycle:** Tied to individual tool calls and their immediate context
-- **Usage:** Temporary storage for intermediate results that tools need to share
-
-**Injected State (LangGraph)**
-
-- **Purpose:** Maintain persistent state across the entire graph execution
-- **Scope:** Global to the entire graph workflow
-- **Lifecycle:** Persists throughout the entire graph execution and can be saved/restored
-- **Usage:** Long-term state management, conversation memory, user context, workflow checkpointing
-
-Tool artifacts are ephemeral data passed between tools, while injected state is persistent workflow-level state that survives across multiple steps, tool calls, and even execution sessions in LangGraph.
-
 ## Best practices
 
 When designing tools to be used by models, keep the following in mind:

docs/docs/concepts/tracing.mdx

@@ -7,4 +7,4 @@ Traces contain individual steps called `runs`. These can be individual calls fro
 tool, or sub-chains.
 Tracing gives you observability inside your chains and agents, and is vital in diagnosing issues.
 
-For a deeper dive, check out [this LangSmith conceptual guide](https://docs.langchain.com/langsmith/observability-quickstart).
+For a deeper dive, check out [this LangSmith conceptual guide](https://docs.smith.langchain.com/concepts/tracing).

docs/docs/contributing/how_to/code/guidelines.mdx

@@ -3,9 +3,9 @@
 Here are some things to keep in mind for all types of contributions:
 
 - Follow the ["fork and pull request"](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project) workflow.
-- Fill out the checked-in pull request template when opening pull requests. Note related issues.
+- Fill out the checked-in pull request template when opening pull requests. Note related issues and tag relevant maintainers.
 - Ensure your PR passes formatting, linting, and testing checks before requesting a review.
-  - If you would like comments or feedback on your current progress, please open an issue or discussion.
+  - If you would like comments or feedback on your current progress, please open an issue or discussion and tag a maintainer.
   - See the sections on [Testing](setup.mdx#testing) and [Formatting and Linting](setup.mdx#formatting-and-linting) for how to run these checks locally.
 - Backwards compatibility is key. Your changes must not be breaking, except in case of critical bug and security fixes.
 - Look for duplicate PRs or issues that have already been opened before opening a new one.

docs/docs/contributing/how_to/code/setup.mdx

@@ -9,14 +9,6 @@ This project utilizes [uv](https://docs.astral.sh/uv/) v0.5+ as a dependency man
 
 Install `uv`: **[documentation on how to install it](https://docs.astral.sh/uv/getting-started/installation/)**.
 
-### Windows Users
-
-If you're on Windows and don't have `make` installed, you can install it via:
-- **Option 1**: Install via [Chocolatey](https://chocolatey.org/): `choco install make`
-- **Option 2**: Install via [Scoop](https://scoop.sh/): `scoop install make`
-- **Option 3**: Use [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/)
-- **Option 4**: Use the direct `uv` commands shown in the sections below
-
 ## Different packages
 
 This repository contains multiple packages:
@@ -56,11 +48,7 @@ uv sync
 Then verify dependency installation:
 
 ```bash
-# If you have `make` installed:
 make test
-
-# If you don't have `make` (Windows alternative):
-uv run --group test pytest -n auto --disable-socket --allow-unix-socket tests/unit_tests
 ```
 
 ## Testing
@@ -73,11 +61,7 @@ If you add new logic, please add a unit test.
 To run unit tests:
 
 ```bash
-# If you have `make` installed:
 make test
-
-# If you don't have make (Windows alternative):
-uv run --group test pytest -n auto --disable-socket --allow-unix-socket tests/unit_tests
 ```
 
 There are also [integration tests and code-coverage](../testing.mdx) available.
@@ -88,12 +72,7 @@ If you are only developing `langchain_core`, you can simply install the dependen
 
 ```bash
 cd libs/core
-
-# If you have `make` installed:
 make test
-
-# If you don't have `make` (Windows alternative):
-uv run --group test pytest -n auto --disable-socket --allow-unix-socket tests/unit_tests
 ```
 
 ## Formatting and linting
@@ -107,37 +86,20 @@ Formatting for this project is done via [ruff](https://docs.astral.sh/ruff/rules
 To run formatting for docs, cookbook and templates:
 
 ```bash
-# If you have `make` installed:
 make format
-
-# If you don't have make (Windows alternative):
-uv run --all-groups ruff format .
-uv run --all-groups ruff check --fix .
 ```
 
 To run formatting for a library, run the same command from the relevant library directory:
 
 ```bash
 cd libs/{LIBRARY}
-
-# If you have `make` installed:
 make format
-
-# If you don't have make (Windows alternative):
-uv run --all-groups ruff format .
-uv run --all-groups ruff check --fix .
 ```
 
 Additionally, you can run the formatter only on the files that have been modified in your current branch as compared to the master branch using the format_diff command:
 
 ```bash
-# If you have `make` installed:
 make format_diff
-
-# If you don't have `make` (Windows alternative):
-# First, get the list of modified files:
-git diff --relative=libs/langchain --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$' | xargs uv run --all-groups ruff format
-git diff --relative=libs/langchain --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$' | xargs uv run --all-groups ruff check --fix
 ```
 
 This is especially useful when you have made changes to a subset of the project and want to ensure your changes are properly formatted without affecting the rest of the codebase.
@@ -149,89 +111,52 @@ Linting for this project is done via a combination of [ruff](https://docs.astral
 To run linting for docs, cookbook and templates:
 
 ```bash
-# If you have `make` installed:
 make lint
-
-# If you don't have `make` (Windows alternative):
-uv run --all-groups ruff check .
-uv run --all-groups ruff format . --diff
-uv run --all-groups mypy . --cache-dir .mypy_cache
 ```
 
 To run linting for a library, run the same command from the relevant library directory:
 
 ```bash
 cd libs/{LIBRARY}
-
-# If you have `make` installed:
 make lint
-
-# If you don't have `make` (Windows alternative):
-uv run --all-groups ruff check .
-uv run --all-groups ruff format . --diff
-uv run --all-groups mypy . --cache-dir .mypy_cache
 ```
 
 In addition, you can run the linter only on the files that have been modified in your current branch as compared to the master branch using the lint_diff command:
 
 ```bash
-# If you have `make` installed:
 make lint_diff
-
-# If you don't have `make` (Windows alternative):
-# First, get the list of modified files:
-git diff --relative=libs/langchain --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$' | xargs uv run --all-groups ruff check
-git diff --relative=libs/langchain --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$' | xargs uv run --all-groups ruff format --diff
-git diff --relative=libs/langchain --name-only --diff-filter=d master | grep -E '\.py$$|\.ipynb$$' | xargs uv run --all-groups mypy --cache-dir .mypy_cache
 ```
 
 This can be very helpful when you've made changes to only certain parts of the project and want to ensure your changes meet the linting standards without having to check the entire codebase.
 
 We recognize linting can be annoying - if you do not want to do it, please contact a project maintainer, and they can help you with it. We do not want this to be a blocker for good code getting contributed.
 
-### Pre-commit
+### Spellcheck
 
-We use [pre-commit](https://pre-commit.com/) to ensure commits are formatted/linted.
+Spellchecking for this project is done via [codespell](https://github.com/codespell-project/codespell).
+Note that `codespell` finds common typos, so it could have false-positive (correctly spelled but rarely used) and false-negatives (not finding misspelled) words.
 
-#### Installing Pre-commit
-
-First, install pre-commit:
+To check spelling for this project:
 
 ```bash
-# Option 1: Using uv (recommended)
-uv tool install pre-commit
-
-# Option 2: Using Homebrew (globally for macOS/Linux)
-brew install pre-commit
-
-# Option 3: Using pip
-pip install pre-commit
+make spell_check
 ```
 
-Then install the git hook scripts:
+To fix spelling in place:
 
 ```bash
-pre-commit install
+make spell_fix
 ```
 
-#### How Pre-commit Works
+If codespell is incorrectly flagging a word, you can skip spellcheck for that word by adding it to the codespell config in the `pyproject.toml` file.
 
-Once installed, pre-commit will automatically run on every `git commit`. Hooks are specified in `.pre-commit-config.yaml` and will:
-
-- Format code using `ruff` for the specific library/package you're modifying
-- Only run on files that have changed
-- Prevent commits if formatting fails
-
-#### Skipping Pre-commit
-
-In exceptional cases, you can skip pre-commit hooks with:
-
-```bash
-git commit --no-verify
+```python
+[tool.codespell]
+...
+# Add here:
+ignore-words-list = 'momento,collison,ned,foor,reworkd,parth,whats,aapply,mysogyny,unsecure'
 ```
 
-However, this is discouraged as the CI system will still enforce the same formatting rules.
-
 ## Working with optional dependencies
 
 `langchain`, `langchain-community`, and `langchain-experimental` rely on optional dependencies to keep these packages lightweight.

docs/docs/contributing/how_to/documentation/style_guide.mdx

@@ -79,7 +79,7 @@ Here are some high-level tips on writing a good how-to guide:
 
 ### Conceptual guide
 
-LangChain's conceptual guides fall under the **Explanation** quadrant of Diataxis. These guides should cover LangChain terms and concepts
+LangChain's conceptual guide falls under the **Explanation** quadrant of Diataxis. These guides should cover LangChain terms and concepts
 in a more abstract way than how-to guides or tutorials, targeting curious users interested in
 gaining a deeper understanding and insights of the framework. Try to avoid excessively large code examples as the primary goal is to
 provide perspective to the user rather than to finish a practical project. These guides should cover **why** things work the way they do.
@@ -105,7 +105,7 @@ Here are some high-level tips on writing a good conceptual guide:
 ### References
 
 References contain detailed, low-level information that describes exactly what functionality exists and how to use it.
-In LangChain, these are mainly our API reference pages, which are populated from docstrings within code.
+In LangChain, this is mainly our API reference pages, which are populated from docstrings within code.
 References pages are generally not read end-to-end, but are consulted as necessary when a user needs to know
 how to use something specific.
 
@@ -119,7 +119,7 @@ but here are some high-level tips on writing a good docstring:
 - Be concise
 - Discuss special cases and deviations from a user's expectations
 - Go into detail on required inputs and outputs
-- Light details on when one might use the feature are fine, but in-depth details belong in other sections
+- Light details on when one might use the feature are fine, but in-depth details belong in other sections.
 
 Each category serves a distinct purpose and requires a specific approach to writing and structuring the content.
 
@@ -127,17 +127,17 @@ Each category serves a distinct purpose and requires a specific approach to writ
 
 Here are some other guidelines you should think about when writing and organizing documentation.
 
-We generally do not merge new tutorials from outside contributors without an acute need.
+We generally do not merge new tutorials from outside contributors without an actue need.
 We welcome updates as well as new integration docs, how-tos, and references.
 
 ### Avoid duplication
 
 Multiple pages that cover the same material in depth are difficult to maintain and cause confusion. There should
-be only one (very rarely two) canonical pages for a given concept or feature. Instead, you should link to other guides.
+be only one (very rarely two), canonical pages for a given concept or feature. Instead, you should link to other guides.
 
 ### Link to other sections
 
-Because sections of the docs do not exist in a vacuum, it is important to link to other sections frequently
+Because sections of the docs do not exist in a vacuum, it is important to link to other sections frequently,
 to allow a developer to learn more about an unfamiliar topic within the flow of reading.
 
 This includes linking to the API references and conceptual sections!

docs/docs/contributing/tutorials/docs.mdx

@@ -33,7 +33,7 @@ Sometimes you want to make a small change, like fixing a typo, and the easiest w
    - Click the "Commit changes..." button at the top-right corner of the page.
    - Give your commit a title like "Fix typo in X section."
    - Optionally, write an extended commit description.
-   - Click "Propose changes".
+   - Click "Propose changes"
 
 5. **Submit a pull request (PR):**
    - GitHub will redirect you to a page where you can create a pull request.

docs/docs/how_to/chat_models_universal_init.ipynb

@@ -159,7 +159,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 8,
    "id": "321e3036-abd2-4e1f-bcc6-606efd036954",
    "metadata": {
     "execution": {
@@ -183,7 +183,7 @@
    ],
    "source": [
     "configurable_model.invoke(\n",
-    "    \"what's your name\", config={\"configurable\": {\"model\": \"claude-3-5-sonnet-latest\"}}\n",
+    "    \"what's your name\", config={\"configurable\": {\"model\": \"claude-3-5-sonnet-20240620\"}}\n",
     ")"
    ]
   },
@@ -234,7 +234,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 7,
    "id": "6c8755ba-c001-4f5a-a497-be3f1db83244",
    "metadata": {
     "execution": {
@@ -261,7 +261,7 @@
     "    \"what's your name\",\n",
     "    config={\n",
     "        \"configurable\": {\n",
-    "            \"first_model\": \"claude-3-5-sonnet-latest\",\n",
+    "            \"first_model\": \"claude-3-5-sonnet-20240620\",\n",
     "            \"first_temperature\": 0.5,\n",
     "            \"first_max_tokens\": 100,\n",
     "        }\n",
@@ -336,7 +336,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 9,
    "id": "e57dfe9f-cd24-4e37-9ce9-ccf8daf78f89",
    "metadata": {
     "execution": {
@@ -368,14 +368,14 @@
    "source": [
     "llm_with_tools.invoke(\n",
     "    \"what's bigger in 2024 LA or NYC\",\n",
-    "    config={\"configurable\": {\"model\": \"claude-3-5-sonnet-latest\"}},\n",
+    "    config={\"configurable\": {\"model\": \"claude-3-5-sonnet-20240620\"}},\n",
     ").tool_calls"
    ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langchain-monorepo",
+   "display_name": "langchain",
    "language": "python",
    "name": "python3"
   },
@@ -389,7 +389,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.11"
+   "version": "3.10.16"
   }
  },
  "nbformat": 4,

docs/docs/how_to/chat_streaming.ipynb

@@ -24,7 +24,7 @@
     "\n",
     ":::tip\n",
     "\n",
-    "The **default** implementation does **not** provide support for token-by-token streaming, but it ensures that the model can be swapped in for any other model as it supports the same standard interface.\n",
+    "The **default** implementation does **not** provide support for token-by-token streaming, but it ensures that the the model can be swapped in for any other model as it supports the same standard interface.\n",
     "\n",
     ":::\n",
     "\n",

docs/docs/how_to/custom_tools.ipynb

@@ -741,13 +741,13 @@
     "\n",
     "If you're using tools with agents, you will likely need an error handling strategy, so the agent can recover from the error and continue execution.\n",
     "\n",
-    "A simple strategy is to throw a `ToolException` from inside the tool and specify an error handler using `handle_tool_errors`. \n",
+    "A simple strategy is to throw a `ToolException` from inside the tool and specify an error handler using `handle_tool_error`. \n",
     "\n",
     "When the error handler is specified, the exception will be caught and the error handler will decide which output to return from the tool.\n",
     "\n",
-    "You can set `handle_tool_errors` to `True`, a string value, or a function. If it's a function, the function should take a `ToolException` as a parameter and return a value.\n",
+    "You can set `handle_tool_error` to `True`, a string value, or a function. If it's a function, the function should take a `ToolException` as a parameter and return a value.\n",
     "\n",
-    "Please note that only raising a `ToolException` won't be effective. You need to first set the `handle_tool_errors` of the tool because its default value is `False`."
+    "Please note that only raising a `ToolException` won't be effective. You need to first set the `handle_tool_error` of the tool because its default value is `False`."
    ]
   },
   {
@@ -777,7 +777,7 @@
    "id": "9d93b217-1d44-4d31-8956-db9ea680ff4f",
    "metadata": {},
    "source": [
-    "Here's an example with the default `handle_tool_errors=True` behavior."
+    "Here's an example with the default `handle_tool_error=True` behavior."
    ]
   },
   {
@@ -807,7 +807,7 @@
    "source": [
     "get_weather_tool = StructuredTool.from_function(\n",
     "    func=get_weather,\n",
-    "    handle_tool_errors=True,\n",
+    "    handle_tool_error=True,\n",
     ")\n",
     "\n",
     "get_weather_tool.invoke({\"city\": \"foobar\"})"
@@ -818,7 +818,7 @@
    "id": "f91d6dc0-3271-4adc-a155-21f2e62ffa56",
    "metadata": {},
    "source": [
-    "We can set `handle_tool_errors` to a string that will always be returned."
+    "We can set `handle_tool_error` to a string that will always be returned."
    ]
   },
   {
@@ -848,7 +848,7 @@
    "source": [
     "get_weather_tool = StructuredTool.from_function(\n",
     "    func=get_weather,\n",
-    "    handle_tool_errors=\"There is no such city, but it's probably above 0K there!\",\n",
+    "    handle_tool_error=\"There is no such city, but it's probably above 0K there!\",\n",
     ")\n",
     "\n",
     "get_weather_tool.invoke({\"city\": \"foobar\"})"
@@ -893,7 +893,7 @@
     "\n",
     "get_weather_tool = StructuredTool.from_function(\n",
     "    func=get_weather,\n",
-    "    handle_tool_errors=_handle_error,\n",
+    "    handle_tool_error=_handle_error,\n",
     ")\n",
     "\n",
     "get_weather_tool.invoke({\"city\": \"foobar\"})"

docs/docs/how_to/document_loader_pdf.ipynb

@@ -565,7 +565,7 @@
    "id": "3ac2c37a-06a1-40d3-a192-9078eb83994b",
    "metadata": {},
    "source": [
-    "<table><thead><tr><th colspan=\"3\">Table 1: Current layout detection models in the LayoutParser model zoo</th></tr><tr><th>Dataset</th><th>Base Model1</th><th>Large Model Notes</th></tr></thead><tbody><tr><td>PubLayNet [38]</td><td>F/M</td><td>Layouts of modern scientific documents</td></tr><tr><td>PRImA</td><td>M</td><td>Layouts of scanned modern magazines and scientific reports</td></tr><tr><td>Newspaper</td><td>F</td><td>Layouts of scanned US newspapers from the 20th century</td></tr><tr><td>TableBank [18]</td><td>F</td><td>Table region on modern scientific and business document</td></tr><tr><td>HJDataset</td><td>F/M</td><td>Layouts of history Japanese documents</td></tr></tbody></table>"
+    "<table><thead><tr><th colspan=\"3\">able 1. LUllclll 1ayoul actCCLloll 1110AdCs 111 L1C LayoOulralsel 1110U4cl 200</th></tr><tr><th>Dataset</th><th>| Base Model\\'|</th><th>Notes</th></tr></thead><tbody><tr><td>PubLayNet [38]</td><td>F/M</td><td>Layouts of modern scientific documents</td></tr><tr><td>PRImA</td><td>M</td><td>Layouts of scanned modern magazines and scientific reports</td></tr><tr><td>Newspaper</td><td>F</td><td>Layouts of scanned US newspapers from the 20th century</td></tr><tr><td>TableBank [18]</td><td>F</td><td>Table region on modern scientific and business document</td></tr><tr><td>HJDataset</td><td>F/M</td><td>Layouts of history Japanese documents</td></tr></tbody></table>"
    ]
   },
   {

docs/docs/how_to/extraction_long_text.ipynb

@@ -323,7 +323,7 @@
    "source": [
     "## RAG based approach\n",
     "\n",
-    "Another simple idea is to chunk up the text, but instead of extracting information from every chunk, just focus on the most relevant chunks.\n",
+    "Another simple idea is to chunk up the text, but instead of extracting information from every chunk, just focus on the the most relevant chunks.\n",
     "\n",
     ":::caution\n",
     "It can be difficult to identify which chunks are relevant.\n",

docs/docs/how_to/filter_messages.ipynb

@@ -104,7 +104,7 @@
    "source": [
     "## Chaining\n",
     "\n",
-    "`filter_messages` can be used imperatively (like above) or declaratively, making it easy to compose with other components in a chain:"
+    "`filter_messages` can be used in an imperatively (like above) or declaratively, making it easy to compose with other components in a chain:"
    ]
   },
   {

docs/docs/how_to/index.mdx

@@ -5,7 +5,7 @@ sidebar_class_name: hidden
 
 # How-to guides
 
-Here you’ll find answers to "How do I….?" types of questions.
+Here you’ll find answers to “How do I….?” types of questions.
 These guides are *goal-oriented* and *concrete*; they're meant to help you complete a specific task.
 For conceptual explanations see the [Conceptual guide](/docs/concepts/).
 For end-to-end walkthroughs see [Tutorials](/docs/tutorials).
@@ -34,7 +34,7 @@ These are the core building blocks you can use when building applications.
 [Chat Models](/docs/concepts/chat_models) are newer forms of language models that take messages in and output a message.
 See [supported integrations](/docs/integrations/chat/) for details on getting started with chat models from a specific provider.
 
-- [How to: initialize any model in one line](/docs/how_to/chat_models_universal_init/)
+- [How to: init any model in one line](/docs/how_to/chat_models_universal_init/)
 - [How to: work with local models](/docs/how_to/local_llms)
 - [How to: do function/tool calling](/docs/how_to/tool_calling)
 - [How to: get models to return structured output](/docs/how_to/structured_output)
@@ -47,7 +47,7 @@ See [supported integrations](/docs/integrations/chat/) for details on getting st
 - [How to: use chat model to call tools](/docs/how_to/tool_calling)
 - [How to: stream tool calls](/docs/how_to/tool_streaming)
 - [How to: handle rate limits](/docs/how_to/chat_model_rate_limiting)
-- [How to: few-shot prompt tool behavior](/docs/how_to/tools_few_shot)
+- [How to: few shot prompt tool behavior](/docs/how_to/tools_few_shot)
 - [How to: bind model-specific formatted tools](/docs/how_to/tools_model_specific)
 - [How to: force a specific tool call](/docs/how_to/tool_choice)
 - [How to: pass multimodal data directly to models](/docs/how_to/multimodal_inputs/)
@@ -64,15 +64,15 @@ See [supported integrations](/docs/integrations/chat/) for details on getting st
 
 [Prompt Templates](/docs/concepts/prompt_templates) are responsible for formatting user input into a format that can be passed to a language model.
 
-- [How to: use few-shot examples](/docs/how_to/few_shot_examples)
-- [How to: use few-shot examples in chat models](/docs/how_to/few_shot_examples_chat/)
+- [How to: use few shot examples](/docs/how_to/few_shot_examples)
+- [How to: use few shot examples in chat models](/docs/how_to/few_shot_examples_chat/)
 - [How to: partially format prompt templates](/docs/how_to/prompts_partial)
 - [How to: compose prompts together](/docs/how_to/prompts_composition)
 - [How to: use multimodal prompts](/docs/how_to/multimodal_prompts/)
 
 ### Example selectors
 
-[Example Selectors](/docs/concepts/example_selectors) are responsible for selecting the correct few-shot examples to pass to the prompt.
+[Example Selectors](/docs/concepts/example_selectors) are responsible for selecting the correct few shot examples to pass to the prompt.
 
 - [How to: use example selectors](/docs/how_to/example_selectors)
 - [How to: select examples by length](/docs/how_to/example_selectors_length_based)
@@ -178,7 +178,7 @@ LangChain [Tools](/docs/concepts/tools) contain a description of the tool (to pa
 - [How to: use built-in tools and toolkits](/docs/how_to/tools_builtin)
 - [How to: use chat models to call tools](/docs/how_to/tool_calling)
 - [How to: pass tool outputs to chat models](/docs/how_to/tool_results_pass_to_model)
-- [How to: pass runtime values to tools](/docs/how_to/tool_runtime)
+- [How to: pass run time values to tools](/docs/how_to/tool_runtime)
 - [How to: add a human-in-the-loop for tools](/docs/how_to/tools_human)
 - [How to: handle tool errors](/docs/how_to/tools_error)
 - [How to: force models to call a tool](/docs/how_to/tool_choice)
@@ -297,7 +297,7 @@ For a high-level tutorial, check out [this guide](/docs/tutorials/sql_qa/).
 You can use an LLM to do question answering over graph databases.
 For a high-level tutorial, check out [this guide](/docs/tutorials/graph/).
 
-- [How to: add a semantic layer over a database](/docs/how_to/graph_semantic)
+- [How to: add a semantic layer over the database](/docs/how_to/graph_semantic)
 - [How to: construct knowledge graphs](/docs/how_to/graph_constructing)
 
 ### Summarization
@@ -345,7 +345,7 @@ LangGraph is an extension of LangChain aimed at
 building robust and stateful multi-actor applications with LLMs by modeling steps as edges and nodes in a graph.
 
 LangGraph documentation is currently hosted on a separate site.
-You can find the [LangGraph guides here](https://langchain-ai.github.io/langgraph/guides/).
+You can peruse [LangGraph how-to guides here](https://langchain-ai.github.io/langgraph/how-tos/).
 
 ## [LangSmith](https://docs.smith.langchain.com/)
 

docs/docs/how_to/indexing.ipynb

@@ -61,7 +61,7 @@
     "   * document addition by id (`add_documents` method with `ids` argument)\n",
     "   * delete by id (`delete` method with `ids` argument)\n",
     "\n",
-    "Compatible Vectorstores: `AnalyticDB`, `AstraDB`, `AwaDB`, `AzureCosmosDBNoSqlVectorSearch`, `AzureCosmosDBVectorSearch`, `AzureSearch`, `Bagel`, `Cassandra`, `Chroma`, `CouchbaseVectorStore`, `DashVector`, `DatabricksVectorSearch`, `DeepLake`, `Dingo`, `ElasticVectorSearch`, `ElasticsearchStore`, `FAISS`, `HanaDB`, `Milvus`, `MongoDBAtlasVectorSearch`, `MyScale`, `OpenSearchVectorSearch`, `PGVector`, `Pinecone`, `Qdrant`, `Redis`, `Rockset`, `ScaNN`, `SingleStoreDB`, `SupabaseVectorStore`, `SurrealDBStore`, `TimescaleVector`, `Vald`, `VDMS`, `Vearch`, `VespaStore`, `Weaviate`, `Yellowbrick`, `ZepVectorStore`, `TencentVectorDB`, `OpenSearchVectorSearch`.\n",
+    "Compatible Vectorstores: `Aerospike`, `AnalyticDB`, `AstraDB`, `AwaDB`, `AzureCosmosDBNoSqlVectorSearch`, `AzureCosmosDBVectorSearch`, `AzureSearch`, `Bagel`, `Cassandra`, `Chroma`, `CouchbaseVectorStore`, `DashVector`, `DatabricksVectorSearch`, `DeepLake`, `Dingo`, `ElasticVectorSearch`, `ElasticsearchStore`, `FAISS`, `HanaDB`, `Milvus`, `MongoDBAtlasVectorSearch`, `MyScale`, `OpenSearchVectorSearch`, `PGVector`, `Pinecone`, `Qdrant`, `Redis`, `Rockset`, `ScaNN`, `SingleStoreDB`, `SupabaseVectorStore`, `SurrealDBStore`, `TimescaleVector`, `Vald`, `VDMS`, `Vearch`, `VespaStore`, `Weaviate`, `Yellowbrick`, `ZepVectorStore`, `TencentVectorDB`, `OpenSearchVectorSearch`.\n",
     "  \n",
     "## Caution\n",
     "\n",
@@ -199,7 +199,7 @@
    "outputs": [],
    "source": [
     "def _clear():\n",
-    "    \"\"\"Hacky helper method to clear content. See the `full` mode section to understand why it works.\"\"\"\n",
+    "    \"\"\"Hacky helper method to clear content. See the `full` mode section to to understand why it works.\"\"\"\n",
     "    index([], record_manager, vectorstore, cleanup=\"full\", source_id_key=\"source\")"
    ]
   },

docs/docs/how_to/local_llms.ipynb

@@ -46,7 +46,7 @@
     "\n",
     "1. [`llama.cpp`](https://github.com/ggerganov/llama.cpp): C++ implementation of llama inference code with [weight optimization / quantization](https://finbarr.ca/how-is-llama-cpp-possible/)\n",
     "2. [`gpt4all`](https://docs.gpt4all.io/index.html): Optimized C backend for inference\n",
-    "3. [`ollama`](https://github.com/ollama/ollama): Bundles model weights and environment into an app that runs on device and serves the LLM\n",
+    "3. [`Ollama`](https://ollama.ai/): Bundles model weights and environment into an app that runs on device and serves the LLM\n",
     "4. [`llamafile`](https://github.com/Mozilla-Ocho/llamafile): Bundles model weights and everything needed to run the model in a single file, allowing you to run the LLM locally from this file without any additional installation steps\n",
     "\n",
     "In general, these frameworks will do a few things:\n",
@@ -74,12 +74,12 @@
     "\n",
     "## Quickstart\n",
     "\n",
-    "[Ollama](https://ollama.com/) is one way to easily run inference on macOS.\n",
+    "[`Ollama`](https://ollama.ai/) is one way to easily run inference on macOS.\n",
     " \n",
-    "The instructions [here](https://github.com/ollama/ollama?tab=readme-ov-file#ollama) provide details, which we summarize:\n",
+    "The instructions [here](https://github.com/jmorganca/ollama?tab=readme-ov-file#ollama) provide details, which we summarize:\n",
     " \n",
     "* [Download and run](https://ollama.ai/download) the app\n",
-    "* From command line, fetch a model from this [list of options](https://ollama.com/search): e.g., `ollama pull gpt-oss:20b`\n",
+    "* From command line, fetch a model from this [list of options](https://github.com/jmorganca/ollama): e.g., `ollama pull llama3.1:8b`\n",
     "* When the app is running, all models are automatically served on `localhost:11434`\n"
    ]
   },
@@ -95,7 +95,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "86178adb",
    "metadata": {},
    "outputs": [
@@ -111,11 +111,11 @@
     }
    ],
    "source": [
-    "from langchain_ollama import ChatOllama\n",
+    "from langchain_ollama import OllamaLLM\n",
     "\n",
-    "llm = ChatOllama(model=\"gpt-oss:20b\", validate_model_on_init=True)\n",
+    "llm = OllamaLLM(model=\"llama3.1:8b\")\n",
     "\n",
-    "llm.invoke(\"The first man on the moon was ...\").content"
+    "llm.invoke(\"The first man on the moon was ...\")"
    ]
   },
   {
@@ -200,7 +200,7 @@
     "\n",
     "### Running Apple silicon GPU\n",
     "\n",
-    "`ollama` and [`llamafile`](https://github.com/Mozilla-Ocho/llamafile?tab=readme-ov-file#gpu-support) will automatically utilize the GPU on Apple devices.\n",
+    "`Ollama` and [`llamafile`](https://github.com/Mozilla-Ocho/llamafile?tab=readme-ov-file#gpu-support) will automatically utilize the GPU on Apple devices.\n",
     " \n",
     "Other frameworks require the user to set up the environment to utilize the Apple GPU.\n",
     "\n",
@@ -212,15 +212,15 @@
     "\n",
     "In particular, ensure that conda is using the correct virtual environment that you created (`miniforge3`).\n",
     "\n",
-    "e.g., for me:\n",
+    "E.g., for me:\n",
     "\n",
-    "```shell\n",
+    "```\n",
     "conda activate /Users/rlm/miniforge3/envs/llama\n",
     "```\n",
     "\n",
     "With the above confirmed, then:\n",
     "\n",
-    "```shell\n",
+    "```\n",
     "CMAKE_ARGS=\"-DLLAMA_METAL=on\" FORCE_CMAKE=1 pip install -U llama-cpp-python --no-cache-dir\n",
     "```"
    ]
@@ -236,16 +236,20 @@
     "\n",
     "1. [`HuggingFace`](https://huggingface.co/TheBloke) - Many quantized model are available for download and can be run with framework such as [`llama.cpp`](https://github.com/ggerganov/llama.cpp). You can also download models in [`llamafile` format](https://huggingface.co/models?other=llamafile) from HuggingFace.\n",
     "2. [`gpt4all`](https://gpt4all.io/index.html) - The model explorer offers a leaderboard of metrics and associated quantized models available for download \n",
-    "3. [`ollama`](https://github.com/jmorganca/ollama) - Several models can be accessed directly via `pull`\n",
+    "3. [`Ollama`](https://github.com/jmorganca/ollama) - Several models can be accessed directly via `pull`\n",
     "\n",
     "### Ollama\n",
     "\n",
-    "With [Ollama](https://github.com/ollama/ollama), fetch a model via `ollama pull <model family>:<tag>`."
+    "With [Ollama](https://github.com/jmorganca/ollama), fetch a model via `ollama pull <model family>:<tag>`:\n",
+    "\n",
+    "* E.g., for Llama 2 7b: `ollama pull llama2` will download the most basic version of the model (e.g., smallest # parameters and 4 bit quantization)\n",
+    "* We can also specify a particular version from the [model list](https://github.com/jmorganca/ollama?tab=readme-ov-file#model-library), e.g., `ollama pull llama2:13b`\n",
+    "* See the full set of parameters on the [API reference page](https://python.langchain.com/api_reference/community/llms/langchain_community.llms.ollama.Ollama.html)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 42,
    "id": "8ecd2f78",
    "metadata": {},
    "outputs": [
@@ -261,7 +265,7 @@
     }
    ],
    "source": [
-    "llm = ChatOllama(model=\"gpt-oss:20b\")\n",
+    "llm = OllamaLLM(model=\"llama2:13b\")\n",
     "llm.invoke(\"The first man on the moon was ... think step by step\")"
    ]
   },
@@ -690,7 +694,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langchain",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -704,7 +708,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.11"
+   "version": "3.10.5"
   }
  },
  "nbformat": 4,

docs/docs/how_to/merge_message_runs.ipynb

@@ -88,7 +88,7 @@
    "source": [
     "## Chaining\n",
     "\n",
-    "`merge_message_runs` can be used imperatively (like above) or declaratively, making it easy to compose with other components in a chain:"
+    "`merge_message_runs` can be used in an imperatively (like above) or declaratively, making it easy to compose with other components in a chain:"
    ]
   },
   {

docs/docs/how_to/query_high_cardinality.ipynb

@@ -15,7 +15,7 @@
    "id": "f2195672-0cab-4967-ba8a-c6544635547d",
    "metadata": {},
    "source": [
-    "# How to deal with high-cardinality categoricals when doing query analysis\n",
+    "# How deal with high cardinality categoricals when doing query analysis\n",
     "\n",
     "You may want to do query analysis to create a filter on a categorical column. One of the difficulties here is that you usually need to specify the EXACT categorical value. The issue is you need to make sure the LLM generates that categorical value exactly. This can be done relatively easy with prompting when there are only a few values that are valid. When there are a high number of valid values then it becomes more difficult, as those values may not fit in the LLM context, or (if they do) there may be too many for the LLM to properly attend to.\n",
     "\n",

docs/docs/how_to/structured_output.ipynb

@@ -614,7 +614,6 @@
     "    HumanMessage(\"Now about caterpillars\", name=\"example_user\"),\n",
     "    AIMessage(\n",
     "        \"\",\n",
-    "        name=\"example_assistant\",\n",
     "        tool_calls=[\n",
     "            {\n",
     "                \"name\": \"joke\",\n",
@@ -668,7 +667,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 14,
    "id": "df0370e3",
    "metadata": {},
    "outputs": [
@@ -685,7 +684,7 @@
     }
    ],
    "source": [
-    "structured_llm = llm.with_structured_output(None, method=\"json_schema\")\n",
+    "structured_llm = llm.with_structured_output(None, method=\"json_mode\")\n",
     "\n",
     "structured_llm.invoke(\n",
     "    \"Tell me a joke about cats, respond in JSON with `setup` and `punchline` keys\"\n",
@@ -910,7 +909,7 @@
     "        ),\n",
     "        (\"human\", \"{query}\"),\n",
     "    ]\n",
-    ").partial(schema=People.model_json_schema())\n",
+    ").partial(schema=People.schema())\n",
     "\n",
     "\n",
     "# Custom parser\n",
@@ -998,91 +997,6 @@
     "\n",
     "chain.invoke({\"query\": query})"
    ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "xfejabhtn2",
-   "metadata": {},
-   "source": [
-    "## Combining with Additional Tools\n",
-    "\n",
-    "When you need to use both structured output and additional tools (like web search), note the order of operations:\n",
-    "\n",
-    "**Correct Order**:\n",
-    "```python\n",
-    "# 1. Bind tools first\n",
-    "llm_with_tools = llm.bind_tools([web_search_tool, calculator_tool])\n",
-    "\n",
-    "# 2. Apply structured output\n",
-    "structured_llm = llm_with_tools.with_structured_output(MySchema)\n",
-    "```\n",
-    "\n",
-    "**Incorrect Order**:\n",
-    "\n",
-    "```python\n",
-    "# This will fail with \"Tool 'MySchema' not found\" error\n",
-    "structured_llm = llm.with_structured_output(MySchema)\n",
-    "broken_llm = structured_llm.bind_tools([web_search_tool])\n",
-    "```"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "653798ca",
-   "metadata": {},
-   "source": [
-    "**Why Order Matters:**\n",
-    "`with_structured_output()` internally uses tool calling to enforce the schema. When you bind additional tools afterward, it creates a conflict in the tool resolution system."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "1345f4a4",
-   "metadata": {},
-   "source": [
-    "**Complete Example:**"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0835637b",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from pydantic import BaseModel, Field\n",
-    "from langchain_openai import ChatOpenAI\n",
-    "\n",
-    "\n",
-    "class SearchResult(BaseModel):\n",
-    "    \"\"\"Structured search result.\"\"\"\n",
-    "\n",
-    "    query: str = Field(description=\"The search query\")\n",
-    "    findings: str = Field(description=\"Summary of findings\")\n",
-    "\n",
-    "\n",
-    "# Define tools\n",
-    "search_tool = {\n",
-    "    \"type\": \"function\",\n",
-    "    \"function\": {\n",
-    "        \"name\": \"web_search\",\n",
-    "        \"description\": \"Search the web for information\",\n",
-    "        \"parameters\": {\n",
-    "            \"type\": \"object\",\n",
-    "            \"properties\": {\"query\": {\"type\": \"string\", \"description\": \"Search query\"}},\n",
-    "            \"required\": [\"query\"],\n",
-    "        },\n",
-    "    },\n",
-    "}\n",
-    "\n",
-    "# Correct approach\n",
-    "llm = ChatOpenAI()\n",
-    "llm_with_search = llm.bind_tools([search_tool])\n",
-    "structured_search_llm = llm_with_search.with_structured_output(SearchResult)\n",
-    "\n",
-    "# Now you can use both search and get structured output\n",
-    "result = structured_search_llm.invoke(\"Search for latest AI research and summarize\")"
-   ]
   }
  ],
  "metadata": {

docs/docs/how_to/summarize_stuff.ipynb

@@ -39,16 +39,6 @@
     "/>\n"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "ecc06359",
-   "metadata": {},
-   "source": [
-    "See also: [How to summarize through parallelization](/docs/how_to/summarize_map_reduce/) and\n",
-    "[How to summarize through iterative refinement](/docs/how_to/summarize_refine/).\n",
-    "\n"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": 1,

docs/docs/how_to/tool_artifacts.ipynb

@@ -147,7 +147,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 5,
    "id": "74de0286-b003-4b48-9cdd-ecab435515ca",
    "metadata": {},
    "outputs": [],
@@ -157,7 +157,7 @@
     "\n",
     "from langchain_anthropic import ChatAnthropic\n",
     "\n",
-    "llm = ChatAnthropic(model=\"claude-3-5-sonnet-latest\", temperature=0)"
+    "llm = ChatAnthropic(model=\"claude-3-5-sonnet-20240620\", temperature=0)"
    ]
   },
   {

docs/docs/how_to/tool_calling.ipynb

@@ -55,7 +55,7 @@
    "source": [
     "## Defining tool schemas\n",
     "\n",
-    "For a model to be able to call tools, we need to pass in tool schemas that describe what the tool does and what its arguments are. Chat models that support tool calling features implement a `.bind_tools()` method for passing tool schemas to the model. Tool schemas can be passed in as Python functions (with typehints and docstrings), Pydantic models, TypedDict classes, or LangChain [Tool objects](https://python.langchain.com/api_reference/core/tools/langchain_core.tools.base.BaseTool.html#basetool). Subsequent invocations of the model will pass in these tool schemas along with the prompt.\n",
+    "For a model to be able to call tools, we need to pass in tool schemas that describe what the tool does and what it's arguments are. Chat models that support tool calling features implement a `.bind_tools()` method for passing tool schemas to the model. Tool schemas can be passed in as Python functions (with typehints and docstrings), Pydantic models, TypedDict classes, or LangChain [Tool objects](https://python.langchain.com/api_reference/core/tools/langchain_core.tools.base.BaseTool.html#basetool). Subsequent invocations of the model will pass in these tool schemas along with the prompt.\n",
     "\n",
     "### Python functions\n",
     "Our tool schemas can be Python functions:"

docs/docs/how_to/tool_stream_events.ipynb

@@ -38,7 +38,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -53,7 +53,7 @@
     "if \"ANTHROPIC_API_KEY\" not in os.environ:\n",
     "    os.environ[\"ANTHROPIC_API_KEY\"] = getpass()\n",
     "\n",
-    "model = ChatAnthropic(model=\"claude-3-5-sonnet-latest\", temperature=0)"
+    "model = ChatAnthropic(model=\"claude-3-5-sonnet-20240620\", temperature=0)"
    ]
   },
   {

docs/docs/how_to/trim_messages.ipynb

@@ -53,7 +53,7 @@
     "\n",
     "To keep the most recent messages, we set `strategy=\"last\"`.  We'll also set `include_system=True` to include the `SystemMessage`, and `start_on=\"human\"` to make sure the resulting chat history is valid. \n",
     "\n",
-    "This is a good default configuration when using `trim_messages` based on token count. Remember to adjust `token_counter` and `max_tokens` for your use case. Keep in mind that new queries added to the chat history will be included in the token count unless you trim prior to adding the new query.\n",
+    "This is a good default configuration when using `trim_messages` based on token count. Remember to adjust `token_counter` and `max_tokens` for your use case.\n",
     "\n",
     "Notice that for our `token_counter` we can pass in a function (more on that below) or a language model (since language models have a message token counting method). It makes sense to pass in a model when you're trimming your messages to fit into the context window of that specific model:"
    ]
@@ -525,7 +525,7 @@
    "id": "4d91d390-e7f7-467b-ad87-d100411d7a21",
    "metadata": {},
    "source": [
-    "Looking at [the LangSmith trace](https://smith.langchain.com/public/65af12c4-c24d-4824-90f0-6547566e59bb/r) we can see that before the messages are passed to the model they are first trimmed.\n",
+    "Looking at the LangSmith trace we can see that before the messages are passed to the model they are first trimmed: https://smith.langchain.com/public/65af12c4-c24d-4824-90f0-6547566e59bb/r\n",
     "\n",
     "Looking at just the trimmer, we can see that it's a Runnable object that can be invoked like all Runnables:"
    ]
@@ -620,7 +620,7 @@
    "id": "556b7b4c-43cb-41de-94fc-1a41f4ec4d2e",
    "metadata": {},
    "source": [
-    "Looking at [the LangSmith trace](https://smith.langchain.com/public/17dd700b-9994-44ca-930c-116e00997315/r) we can see that we retrieve all of our messages but before the messages are passed to the model they are trimmed to be just the system message and last human message."
+    "Looking at the LangSmith trace we can see that we retrieve all of our messages but before the messages are passed to the model they are trimmed to be just the system message and last human message: https://smith.langchain.com/public/17dd700b-9994-44ca-930c-116e00997315/r"
    ]
   },
   {
@@ -630,7 +630,7 @@
    "source": [
     "## API reference\n",
     "\n",
-    "For a complete description of all arguments head to the [API reference](https://python.langchain.com/api_reference/core/messages/langchain_core.messages.utils.trim_messages.html)."
+    "For a complete description of all arguments head to the API reference: https://python.langchain.com/api_reference/core/messages/langchain_core.messages.utils.trim_messages.html"
    ]
   }
  ],

docs/docs/integrations/callbacks/confident.ipynb

@@ -7,7 +7,10 @@
    "source": [
     "# Confident\n",
     "\n",
-    ">[DeepEval](https://confident-ai.com) package for unit testing LLMs."
+    ">[DeepEval](https://confident-ai.com) package for unit testing LLMs.\n",
+    "> Using Confident, everyone can build robust language models through faster iterations\n",
+    "> using both unit testing and integration testing. We provide support for each step in the iteration\n",
+    "> from synthetic data creation to testing.\n"
    ]
   },
   {
@@ -39,7 +42,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!pip install deepeval langchain langchain-openai"
+    "%pip install --upgrade --quiet  langchain langchain-openai langchain-community deepeval langchain-chroma"
    ]
   },
   {
@@ -61,29 +64,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 11,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">🎉🥳 Congratulations! You've successfully logged in! 🙌 \n",
-       "</pre>\n"
-      ],
-      "text/plain": [
-       "🎉🥳 Congratulations! You've successfully logged in! 🙌 \n"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    }
-   ],
+   "outputs": [],
    "source": [
-    "import os\n",
-    "import deepeval\n",
-    "\n",
-    "api_key = os.getenv(\"DEEPEVAL_API_KEY\")\n",
-    "deepeval.login(api_key)"
+    "!deepeval login"
    ]
   },
   {
@@ -91,9 +76,12 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Setup Confident AI Callback (Modern)\n",
+    "### Setup DeepEval\n",
     "\n",
-    "The previous DeepEvalCallbackHandler and metric tracking are deprecated. Please use the new integration below."
+    "You can, by default, use the `DeepEvalCallbackHandler` to set up the metrics you want to track. However, this has limited support for metrics at the moment (more to be added soon). It currently supports:\n",
+    "- [Answer Relevancy](https://docs.confident-ai.com/docs/measuring_llm_performance/answer_relevancy)\n",
+    "- [Bias](https://docs.confident-ai.com/docs/measuring_llm_performance/debias)\n",
+    "- [Toxicness](https://docs.confident-ai.com/docs/measuring_llm_performance/non_toxic)"
    ]
   },
   {
@@ -102,15 +90,10 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from deepeval.integrations.langchain import CallbackHandler\n",
+    "from deepeval.metrics.answer_relevancy import AnswerRelevancy\n",
     "\n",
-    "handler = CallbackHandler(\n",
-    "    name=\"My Trace\",\n",
-    "    tags=[\"production\", \"v1\"],\n",
-    "    metadata={\"experiment\": \"A/B\"},\n",
-    "    thread_id=\"thread-123\",\n",
-    "    user_id=\"user-456\",\n",
-    ")"
+    "# Here we want to make sure the answer is minimally relevant\n",
+    "answer_relevancy_metric = AnswerRelevancy(minimum_score=0.5)"
    ]
   },
   {
@@ -120,11 +103,186 @@
    "source": [
     "## Get Started"
    ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To use the `DeepEvalCallbackHandler`, we need the `implementation_name`. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain_community.callbacks.confident_callback import DeepEvalCallbackHandler\n",
+    "\n",
+    "deepeval_callback = DeepEvalCallbackHandler(\n",
+    "    implementation_name=\"langchainQuickstart\", metrics=[answer_relevancy_metric]\n",
+    ")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Scenario 1: Feeding into LLM\n",
+    "\n",
+    "You can then feed it into your LLM with OpenAI."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "LLMResult(generations=[[Generation(text='\\n\\nQ: What did the fish say when he hit the wall? \\nA: Dam.', generation_info={'finish_reason': 'stop', 'logprobs': None})], [Generation(text='\\n\\nThe Moon \\n\\nThe moon is high in the midnight sky,\\nSparkling like a star above.\\nThe night so peaceful, so serene,\\nFilling up the air with love.\\n\\nEver changing and renewing,\\nA never-ending light of grace.\\nThe moon remains a constant view,\\nA reminder of life’s gentle pace.\\n\\nThrough time and space it guides us on,\\nA never-fading beacon of hope.\\nThe moon shines down on us all,\\nAs it continues to rise and elope.', generation_info={'finish_reason': 'stop', 'logprobs': None})], [Generation(text='\\n\\nQ. What did one magnet say to the other magnet?\\nA. \"I find you very attractive!\"', generation_info={'finish_reason': 'stop', 'logprobs': None})], [Generation(text=\"\\n\\nThe world is charged with the grandeur of God.\\nIt will flame out, like shining from shook foil;\\nIt gathers to a greatness, like the ooze of oil\\nCrushed. Why do men then now not reck his rod?\\n\\nGenerations have trod, have trod, have trod;\\nAnd all is seared with trade; bleared, smeared with toil;\\nAnd wears man's smudge and shares man's smell: the soil\\nIs bare now, nor can foot feel, being shod.\\n\\nAnd for all this, nature is never spent;\\nThere lives the dearest freshness deep down things;\\nAnd though the last lights off the black West went\\nOh, morning, at the brown brink eastward, springs —\\n\\nBecause the Holy Ghost over the bent\\nWorld broods with warm breast and with ah! bright wings.\\n\\n~Gerard Manley Hopkins\", generation_info={'finish_reason': 'stop', 'logprobs': None})], [Generation(text='\\n\\nQ: What did one ocean say to the other ocean?\\nA: Nothing, they just waved.', generation_info={'finish_reason': 'stop', 'logprobs': None})], [Generation(text=\"\\n\\nA poem for you\\n\\nOn a field of green\\n\\nThe sky so blue\\n\\nA gentle breeze, the sun above\\n\\nA beautiful world, for us to love\\n\\nLife is a journey, full of surprise\\n\\nFull of joy and full of surprise\\n\\nBe brave and take small steps\\n\\nThe future will be revealed with depth\\n\\nIn the morning, when dawn arrives\\n\\nA fresh start, no reason to hide\\n\\nSomewhere down the road, there's a heart that beats\\n\\nBelieve in yourself, you'll always succeed.\", generation_info={'finish_reason': 'stop', 'logprobs': None})]], llm_output={'token_usage': {'completion_tokens': 504, 'total_tokens': 528, 'prompt_tokens': 24}, 'model_name': 'text-davinci-003'})"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "from langchain_openai import OpenAI\n",
+    "\n",
+    "llm = OpenAI(\n",
+    "    temperature=0,\n",
+    "    callbacks=[deepeval_callback],\n",
+    "    verbose=True,\n",
+    "    openai_api_key=\"<YOUR_API_KEY>\",\n",
+    ")\n",
+    "output = llm.generate(\n",
+    "    [\n",
+    "        \"What is the best evaluation tool out there? (no bias at all)\",\n",
+    "    ]\n",
+    ")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can then check the metric if it was successful by calling the `is_successful()` method."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "answer_relevancy_metric.is_successful()\n",
+    "# returns True/False"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Once you have ran that, you should be able to see our dashboard below. \n",
+    "\n",
+    "![Dashboard](https://docs.confident-ai.com/assets/images/dashboard-screenshot-b02db73008213a211b1158ff052d969e.png)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Scenario 2: Tracking an LLM in a chain without callbacks\n",
+    "\n",
+    "To track an LLM in a chain without callbacks, you can plug into it at the end.\n",
+    "\n",
+    "We can start by defining a simple chain as shown below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import requests\n",
+    "from langchain.chains import RetrievalQA\n",
+    "from langchain_chroma import Chroma\n",
+    "from langchain_community.document_loaders import TextLoader\n",
+    "from langchain_openai import OpenAI, OpenAIEmbeddings\n",
+    "from langchain_text_splitters import CharacterTextSplitter\n",
+    "\n",
+    "text_file_url = \"https://raw.githubusercontent.com/hwchase17/chat-your-data/master/state_of_the_union.txt\"\n",
+    "\n",
+    "openai_api_key = \"sk-XXX\"\n",
+    "\n",
+    "with open(\"state_of_the_union.txt\", \"w\") as f:\n",
+    "    response = requests.get(text_file_url)\n",
+    "    f.write(response.text)\n",
+    "\n",
+    "loader = TextLoader(\"state_of_the_union.txt\")\n",
+    "documents = loader.load()\n",
+    "text_splitter = CharacterTextSplitter(chunk_size=1000, chunk_overlap=0)\n",
+    "texts = text_splitter.split_documents(documents)\n",
+    "\n",
+    "embeddings = OpenAIEmbeddings(openai_api_key=openai_api_key)\n",
+    "docsearch = Chroma.from_documents(texts, embeddings)\n",
+    "\n",
+    "qa = RetrievalQA.from_chain_type(\n",
+    "    llm=OpenAI(openai_api_key=openai_api_key),\n",
+    "    chain_type=\"stuff\",\n",
+    "    retriever=docsearch.as_retriever(),\n",
+    ")\n",
+    "\n",
+    "# Providing a new question-answering pipeline\n",
+    "query = \"Who is the president?\"\n",
+    "result = qa.run(query)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "After defining a chain, you can then manually check for answer similarity."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "answer_relevancy_metric.measure(result, query)\n",
+    "answer_relevancy_metric.is_successful()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### What's next?\n",
+    "\n",
+    "You can create your own custom metrics [here](https://docs.confident-ai.com/docs/quickstart/custom-metrics). \n",
+    "\n",
+    "DeepEval also offers other features such as being able to [automatically create unit tests](https://docs.confident-ai.com/docs/quickstart/synthetic-data-creation), [tests for hallucination](https://docs.confident-ai.com/docs/measuring_llm_performance/factual_consistency).\n",
+    "\n",
+    "If you are interested, check out our Github repository here [https://github.com/confident-ai/deepeval](https://github.com/confident-ai/deepeval). We welcome any PRs and discussions on how to improve LLM performance."
+   ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langchain",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -138,7 +296,12 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.11"
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "a53ebf4a859167383b364e7e7521d0add3c2dbbdecce4edf676e8c4634ff3fbb"
+   }
   }
  },
  "nbformat": 4,

docs/docs/integrations/chat/aimlapi.ipynb

@@ -1,288 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "id": "fbeb3f1eb129d115",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "---\n",
-    "sidebar_label: AI/ML API\n",
-    "---"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "6051ba9cfc65a60a",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "# ChatAimlapi\n",
-    "\n",
-    "This page will help you get started with AI/ML API [chat models](/docs/concepts/chat_models.mdx). For detailed documentation of all ChatAimlapi features and configurations, head to the [API reference](https://docs.aimlapi.com/?utm_source=langchain&utm_medium=github&utm_campaign=integration).\n",
-    "\n",
-    "AI/ML API provides access to **300+ models** (Deepseek, Gemini, ChatGPT, etc.) via high-uptime and high-rate API."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "512f94fa4bea2628",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## Overview\n",
-    "### Integration details\n",
-    "\n",
-    "| Class | Package | Local | Serializable | JS support | Package downloads | Package latest |\n",
-    "| :--- | :--- | :---: | :---: | :---: | :---: | :---: |\n",
-    "| ChatAimlapi | langchain-aimlapi | ✅ | beta | ❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-aimlapi?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-aimlapi?style=flat-square&label=%20) |"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "7163684608502d37",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "### Model features\n",
-    "| Tool calling | Structured output | JSON mode | Image input | Audio input | Video input | Token-level streaming | Native async | Token usage | Logprobs |\n",
-    "|:------------:|:-----------------:|:---------:|:-----------:|:-----------:|:-----------:|:---------------------:|:------------:|:-----------:|:--------:|\n",
-    "|      ✅       |         ✅         |     ✅     |      ✅      |      ✅      |      ✅      |           ✅           |      ✅       |      ✅      |    ✅     |\n"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "bb9345d5b24a7741",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## Setup\n",
-    "To access AI/ML API models, sign up at [aimlapi.com](https://aimlapi.com/app/?utm_source=langchain&utm_medium=github&utm_campaign=integration), generate an API key, and set the `AIMLAPI_API_KEY` environment variable:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "id": "b26280519672f194",
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2025-08-07T07:16:58.837623Z",
-     "start_time": "2025-08-07T07:16:55.346214Z"
-    }
-   },
-   "outputs": [],
-   "source": [
-    "import getpass\n",
-    "import os\n",
-    "\n",
-    "if \"AIMLAPI_API_KEY\" not in os.environ:\n",
-    "    os.environ[\"AIMLAPI_API_KEY\"] = getpass.getpass(\"Enter your AI/ML API key: \")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "fa131229e62dfd47",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "### Installation\n",
-    "Install the `langchain-aimlapi` package:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "id": "3777dc00d768299e",
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2025-08-07T07:17:11.195741Z",
-     "start_time": "2025-08-07T07:17:02.288142Z"
-    }
-   },
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Note: you may need to restart the kernel to use updated packages.\n"
-     ]
-    }
-   ],
-   "source": [
-    "%pip install -qU langchain-aimlapi"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "d168108b0c4f9d7",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## Instantiation\n",
-    "Now we can instantiate the `ChatAimlapi` model and generate chat completions:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "id": "f29131e65e47bd16",
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2025-08-07T07:17:23.499746Z",
-     "start_time": "2025-08-07T07:17:11.196747Z"
-    }
-   },
-   "outputs": [],
-   "source": [
-    "from langchain_aimlapi import ChatAimlapi\n",
-    "\n",
-    "llm = ChatAimlapi(\n",
-    "    model=\"meta-llama/Llama-3-70b-chat-hf\",\n",
-    "    temperature=0.7,\n",
-    "    max_tokens=512,\n",
-    "    timeout=30,\n",
-    "    max_retries=3,\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "861b87289f8e146d",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## Invocation\n",
-    "You can invoke the model with a list of messages:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "id": "430b1cff2e6d77b4",
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2025-08-07T07:17:30.586261Z",
-     "start_time": "2025-08-07T07:17:29.074409Z"
-    }
-   },
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "J'adore la programmation.\n"
-     ]
-    }
-   ],
-   "source": [
-    "messages = [\n",
-    "    (\"system\", \"You are a helpful assistant that translates English to French.\"),\n",
-    "    (\"human\", \"I love programming.\"),\n",
-    "]\n",
-    "\n",
-    "ai_msg = llm.invoke(messages)\n",
-    "print(ai_msg.content)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "5463797524a19b2e",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## Chaining\n",
-    "We can chain the model with a prompt template as follows:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "id": "bf6defc12a0c5d78",
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2025-08-07T07:17:36.368436Z",
-     "start_time": "2025-08-07T07:17:34.770581Z"
-    }
-   },
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Ich liebe das Programmieren.\n"
-     ]
-    }
-   ],
-   "source": [
-    "from langchain_core.prompts import ChatPromptTemplate\n",
-    "\n",
-    "prompt = ChatPromptTemplate.from_messages(\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 | llm\n",
-    "response = chain.invoke(\n",
-    "    {\n",
-    "        \"input_language\": \"English\",\n",
-    "        \"output_language\": \"German\",\n",
-    "        \"input\": \"I love programming.\",\n",
-    "    }\n",
-    ")\n",
-    "print(response.content)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "fcf0bf10a872355c",
-   "metadata": {
-    "collapsed": false
-   },
-   "source": [
-    "## API reference\n",
-    "\n",
-    "For detailed documentation of all ChatAimlapi features and configurations, visit the [API Reference](https://docs.aimlapi.com/?utm_source=langchain&utm_medium=github&utm_campaign=integration)."
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 2
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython2",
-   "version": "2.7.6"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
-}

docs/docs/integrations/chat/anthropic.ipynb

@@ -19,7 +19,7 @@
     "\n",
     "This notebook provides a quick overview for getting started with Anthropic [chat models](/docs/concepts/chat_models). For detailed documentation of all ChatAnthropic features and configurations head to the [API reference](https://python.langchain.com/api_reference/anthropic/chat_models/langchain_anthropic.chat_models.ChatAnthropic.html).\n",
     "\n",
-    "Anthropic has several chat models. You can find information about their latest models and their costs, context windows, and supported input types in the [Anthropic docs](https://docs.anthropic.com/en/docs/about-claude/models/overview).\n",
+    "Anthropic has several chat models. You can find information about their latest models and their costs, context windows, and supported input types in the [Anthropic docs](https://docs.anthropic.com/en/docs/models-overview).\n",
     "\n",
     "\n",
     ":::info AWS Bedrock and Google VertexAI\n",
@@ -124,7 +124,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 4,
    "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
    "metadata": {},
    "outputs": [],
@@ -132,7 +132,7 @@
     "from langchain_anthropic import ChatAnthropic\n",
     "\n",
     "llm = ChatAnthropic(\n",
-    "    model=\"claude-3-5-sonnet-latest\",\n",
+    "    model=\"claude-3-5-sonnet-20240620\",\n",
     "    temperature=0,\n",
     "    max_tokens=1024,\n",
     "    timeout=None,\n",
@@ -840,7 +840,7 @@
    "source": [
     "## Token-efficient tool use\n",
     "\n",
-    "Anthropic supports a (beta) [token-efficient tool use](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/token-efficient-tool-use) feature. To use it, specify the relevant beta-headers when instantiating the model."
+    "Anthropic supports a (beta) [token-efficient tool use](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/token-efficient-tool-use) feature. To use it, specify the relevant beta-headers when instantiating the model."
    ]
   },
   {
@@ -970,8 +970,8 @@
    "source": [
     "### In tool results (agentic RAG)\n",
     "\n",
-    ":::info\n",
-    "Requires ``langchain-anthropic>=0.3.17``\n",
+    ":::info Requires ``langchain-anthropic>=0.3.17``\n",
+    "\n",
     ":::\n",
     "\n",
     "Claude supports a [search_result](https://docs.anthropic.com/en/docs/build-with-claude/search-results) content block representing citable results from queries against a knowledge base or other custom source. These content blocks can be passed to claude both top-line (as in the above example) and within a tool result. This allows Claude to cite elements of its response using the result of a tool call.\n",
@@ -998,6 +998,8 @@
     "    ]\n",
     "```\n",
     "\n",
+    "We also need to specify the `search-results-2025-06-09` beta when instantiating ChatAnthropic. You can see an end-to-end example below.\n",
+    "\n",
     "<details>\n",
     "<summary>End to end example with LangGraph</summary>\n",
     "\n",
@@ -1191,40 +1193,6 @@
     "response.content"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "74247a07-b153-444f-9c56-77659aeefc88",
-   "metadata": {},
-   "source": [
-    "## Context management\n",
-    "\n",
-    "Anthropic supports a context editing feature that will automatically manage the model's context window (e.g., by clearing tool results).\n",
-    "\n",
-    "See [Anthropic documentation](https://docs.claude.com/en/docs/build-with-claude/context-editing) for details and configuration options.\n",
-    "\n",
-    ":::info\n",
-    "Requires ``langchain-anthropic>=0.3.21``\n",
-    ":::"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "cbb79c5d-37b5-4212-b36f-f27366192cf9",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_anthropic import ChatAnthropic\n",
-    "\n",
-    "llm = ChatAnthropic(\n",
-    "    model=\"claude-sonnet-4-5-20250929\",\n",
-    "    betas=[\"context-management-2025-06-27\"],\n",
-    "    context_management={\"edits\": [{\"type\": \"clear_tool_uses_20250919\"}]},\n",
-    ")\n",
-    "llm_with_tools = llm.bind_tools([{\"type\": \"web_search_20250305\", \"name\": \"web_search\"}])\n",
-    "response = llm_with_tools.invoke(\"Search for recent developments in AI\")"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "cbfec7a9-d9df-4d12-844e-d922456dd9bf",
@@ -1232,7 +1200,7 @@
    "source": [
     "## Built-in tools\n",
     "\n",
-    "Anthropic supports a variety of [built-in tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/text-editor-tool), which can be bound to the model in the [usual way](/docs/how_to/tool_calling/). Claude will generate tool calls adhering to its internal schema for the tool:"
+    "Anthropic supports a variety of [built-in tools](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/text-editor-tool), which can be bound to the model in the [usual way](/docs/how_to/tool_calling/). Claude will generate tool calls adhering to its internal schema for the tool:"
    ]
   },
   {
@@ -1242,7 +1210,7 @@
    "source": [
     "### Web search\n",
     "\n",
-    "Claude can use a [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool) to run searches and ground its responses with citations."
+    "Claude can use a [web search tool](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool) to run searches and ground its responses with citations."
    ]
   },
   {
@@ -1272,110 +1240,6 @@
     "response = llm_with_tools.invoke(\"How do I update a web app to TypeScript 5.5?\")"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "kloc4rvd1w",
-   "metadata": {},
-   "source": [
-    "#### Web search + structured output\n",
-    "\n",
-    "When combining web search tools with structured output, it's important to **bind the tools first and then apply structured output**:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "rjjergy6ef",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from pydantic import BaseModel, Field\n",
-    "from langchain_anthropic import ChatAnthropic\n",
-    "\n",
-    "\n",
-    "# Define structured output schema\n",
-    "class ResearchResult(BaseModel):\n",
-    "    \"\"\"Structured research result from web search.\"\"\"\n",
-    "\n",
-    "    topic: str = Field(description=\"The research topic\")\n",
-    "    summary: str = Field(description=\"Summary of key findings\")\n",
-    "    key_points: list[str] = Field(description=\"List of important points discovered\")\n",
-    "\n",
-    "\n",
-    "# Configure web search tool\n",
-    "websearch_tools = [\n",
-    "    {\n",
-    "        \"type\": \"web_search_20250305\",\n",
-    "        \"name\": \"web_search\",\n",
-    "        \"max_uses\": 10,\n",
-    "    }\n",
-    "]\n",
-    "\n",
-    "llm = ChatAnthropic(model=\"claude-3-5-sonnet-20241022\")\n",
-    "\n",
-    "# Correct order: bind tools first, then structured output\n",
-    "llm_with_search = llm.bind_tools(websearch_tools)\n",
-    "research_llm = llm_with_search.with_structured_output(ResearchResult)\n",
-    "\n",
-    "# Now you can use both web search and get structured output\n",
-    "result = research_llm.invoke(\"Research the latest developments in quantum computing\")\n",
-    "print(f\"Topic: {result.topic}\")\n",
-    "print(f\"Summary: {result.summary}\")\n",
-    "print(f\"Key Points: {result.key_points}\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "c580c20a",
-   "metadata": {},
-   "source": [
-    "### Web fetching\n",
-    "\n",
-    "Claude can use a [web fetching tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-fetch-tool) to run searches and ground its responses with citations."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "5cf6ad08",
-   "metadata": {},
-   "source": [
-    ":::info\n",
-    "Web search tool is supported since ``langchain-anthropic>=0.3.20``\n",
-    ":::"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "c4804be1",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_anthropic import ChatAnthropic\n",
-    "\n",
-    "llm = ChatAnthropic(\n",
-    "    model=\"claude-3-5-haiku-latest\",\n",
-    "    betas=[\"web-fetch-2025-09-10\"],  # Enable web fetch beta\n",
-    ")\n",
-    "\n",
-    "tool = {\"type\": \"web_fetch_20250910\", \"name\": \"web_fetch\", \"max_uses\": 3}\n",
-    "llm_with_tools = llm.bind_tools([tool])\n",
-    "\n",
-    "response = llm_with_tools.invoke(\n",
-    "    \"Please analyze the content at https://example.com/article\"\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "088c41d0",
-   "metadata": {},
-   "source": [
-    ":::warning\n",
-    "Note: you must add the `'web-fetch-2025-09-10'` beta header to use this tool.\n",
-    ":::"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "1478cdc6-2e52-4870-80f9-b4ddf88f2db2",
@@ -1385,14 +1249,14 @@
     "\n",
     "Claude can use a [code execution tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/code-execution-tool) to execute Python code in a sandboxed environment.\n",
     "\n",
-    ":::info\n",
-    "Code execution is supported since ``langchain-anthropic>=0.3.14``\n",
+    ":::info Code execution is supported since ``langchain-anthropic>=0.3.14``\n",
+    "\n",
     ":::"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "2ce13632-a2da-439f-a429-f66481501630",
    "metadata": {},
    "outputs": [],
@@ -1401,7 +1265,7 @@
     "\n",
     "llm = ChatAnthropic(\n",
     "    model=\"claude-sonnet-4-20250514\",\n",
-    "    betas=[\"code-execution-2025-05-22\"],  # Enable code execution beta\n",
+    "    betas=[\"code-execution-2025-05-22\"],\n",
     ")\n",
     "\n",
     "tool = {\"type\": \"code_execution_20250522\", \"name\": \"code_execution\"}\n",
@@ -1412,16 +1276,6 @@
     ")"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "a6b5e15a",
-   "metadata": {},
-   "source": [
-    ":::warning\n",
-    "Note: you must add the `'code_execution_20250522'` beta header to use this tool.\n",
-    ":::"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "24076f91-3a3d-4e53-9618-429888197061",
@@ -1491,38 +1345,6 @@
     "</details>"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "29405da2-d2ef-415c-b674-6e29073cd05e",
-   "metadata": {},
-   "source": [
-    "### Memory tool\n",
-    "\n",
-    "Claude supports a memory tool for client-side storage and retrieval of context across conversational threads. See docs [here](https://docs.claude.com/en/docs/agents-and-tools/tool-use/memory-tool) for details.\n",
-    "\n",
-    ":::info\n",
-    "Requires ``langchain-anthropic>=0.3.21``\n",
-    ":::"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "bbd76eaa-041f-4fb8-8346-ca8fe0001c01",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_anthropic import ChatAnthropic\n",
-    "\n",
-    "llm = ChatAnthropic(\n",
-    "    model=\"claude-sonnet-4-5-20250929\",\n",
-    "    betas=[\"context-management-2025-06-27\"],\n",
-    ")\n",
-    "llm_with_tools = llm.bind_tools([{\"type\": \"memory_20250818\", \"name\": \"memory\"}])\n",
-    "\n",
-    "response = llm_with_tools.invoke(\"What are my interests?\")"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "040f381a-1768-479a-9a5e-aa2d7d77e0d5",
@@ -1532,14 +1354,14 @@
     "\n",
     "Claude can use a [MCP connector tool](https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector) for model-generated calls to remote MCP servers.\n",
     "\n",
-    ":::info\n",
-    "Remote MCP is supported since ``langchain-anthropic>=0.3.14``\n",
+    ":::info Remote MCP is supported since ``langchain-anthropic>=0.3.14``\n",
+    "\n",
     ":::"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "22fc4a89-e6d8-4615-96cb-2e117349aebf",
    "metadata": {},
    "outputs": [],
@@ -1551,17 +1373,17 @@
     "        \"type\": \"url\",\n",
     "        \"url\": \"https://mcp.deepwiki.com/mcp\",\n",
     "        \"name\": \"deepwiki\",\n",
-    "        \"tool_configuration\": {  # Optional configuration\n",
+    "        \"tool_configuration\": {  # optional configuration\n",
     "            \"enabled\": True,\n",
     "            \"allowed_tools\": [\"ask_question\"],\n",
     "        },\n",
-    "        \"authorization_token\": \"PLACEHOLDER\",  # Optional authorization\n",
+    "        \"authorization_token\": \"PLACEHOLDER\",  # optional authorization\n",
     "    }\n",
     "]\n",
     "\n",
     "llm = ChatAnthropic(\n",
     "    model=\"claude-sonnet-4-20250514\",\n",
-    "    betas=[\"mcp-client-2025-04-04\"],  # Enable MCP beta\n",
+    "    betas=[\"mcp-client-2025-04-04\"],\n",
     "    mcp_servers=mcp_servers,\n",
     ")\n",
     "\n",
@@ -1571,16 +1393,6 @@
     ")"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "0d6d7197",
-   "metadata": {},
-   "source": [
-    ":::warning\n",
-    "Note: you must add the `'mcp-client-2025-04-04'` beta header to use this tool.\n",
-    ":::"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "2fd5d545-a40d-42b1-ad0c-0a79e2536c9b",
@@ -1588,7 +1400,7 @@
    "source": [
     "### Text editor\n",
     "\n",
-    "The text editor tool can be used to view and modify text files. See docs [here](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/text-editor-tool) for details."
+    "The text editor tool can be used to view and modify text files. See docs [here](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/text-editor-tool) for details."
    ]
   },
   {

docs/docs/integrations/chat/bedrock.ipynb

@@ -129,7 +129,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
    "metadata": {},
    "outputs": [],
@@ -137,7 +137,7 @@
     "from langchain_aws import ChatBedrockConverse\n",
     "\n",
     "llm = ChatBedrockConverse(\n",
-    "    model_id=\"anthropic.claude-3-5-sonnet-latest-v1:0\",\n",
+    "    model_id=\"anthropic.claude-3-5-sonnet-20240620-v1:0\",\n",
     "    # region_name=...,\n",
     "    # aws_access_key_id=...,\n",
     "    # aws_secret_access_key=...,\n",

docs/docs/integrations/chat/google_generative_ai.ipynb

@@ -31,7 +31,7 @@
     "\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",
     "\n",
     "### Setup\n",
     "\n",
@@ -653,35 +653,15 @@
     "\n",
     "# Initialize the model\n",
     "llm = ChatGoogleGenerativeAI(model=\"gemini-2.0-flash\", temperature=0)\n",
-    "\n",
-    "# Method 1: Default function calling approach\n",
-    "structured_llm_default = llm.with_structured_output(Person)\n",
-    "\n",
-    "# Method 2: Native JSON mode\n",
-    "structured_llm_json = llm.with_structured_output(Person, method=\"json_mode\")\n",
+    "structured_llm = llm.with_structured_output(Person)\n",
     "\n",
     "# Invoke the model with a query asking for structured information\n",
-    "result = structured_llm_json.invoke(\n",
+    "result = structured_llm.invoke(\n",
     "    \"Who was the 16th president of the USA, and how tall was he in meters?\"\n",
     ")\n",
     "print(result)"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "g9w06ld1ggq",
-   "metadata": {},
-   "source": [
-    "### Structured Output Methods\n",
-    "\n",
-    "Two methods are supported for structured output:\n",
-    "\n",
-    "- **`method=\"function_calling\"` (default)**: Uses tool calling to extract structured data. Compatible with all Gemini models.\n",
-    "- **`method=\"json_mode\"`**: Uses Gemini's native structured output with `responseSchema`. More reliable but requires Gemini 1.5+ models.\n",
-    "\n",
-    "The `json_mode` method is **recommended for better reliability** as it constrains the model's generation process directly rather than relying on post-processing tool calls."
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "90d4725e",

docs/docs/integrations/chat/huggingface.ipynb

@@ -52,7 +52,7 @@
     "\n",
     "| Class | Package | Local | Serializable | JS support | Package downloads | Package latest |\n",
     "| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |\n",
-    "| [ChatHuggingFace](https://python.langchain.com/api_reference/huggingface/chat_models/langchain_huggingface.chat_models.huggingface.ChatHuggingFace.html) | [langchain-huggingface](https://python.langchain.com/api_reference/huggingface/index.html) | ✅ | ❌ | ❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_huggingface?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_huggingface?style=flat-square&label=%20) |\n",
+    "| [ChatHuggingFace](https://python.langchain.com/api_reference/huggingface/chat_models/langchain_huggingface.chat_models.huggingface.ChatHuggingFace.html) | [langchain_huggingface](https://python.langchain.com/api_reference/huggingface/index.html) | ✅ | ❌ | ❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_huggingface?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_huggingface?style=flat-square&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",
@@ -61,7 +61,7 @@
     "\n",
     "## Setup\n",
     "\n",
-    "To access `langchain_huggingface` models you'll need to create a `Hugging Face` account, get an API key, and install the `langchain-huggingface` integration package.\n",
+    "To access `langchain_huggingface` models you'll need to create a/an `Hugging Face` account, get an API key, and install the `langchain_huggingface` integration package.\n",
     "\n",
     "### Credentials\n",
     "\n",

docs/docs/integrations/chat/mistralai.ipynb

@@ -24,7 +24,7 @@
         "\n",
         "| Class | Package | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/chat/mistral) | Package downloads | Package latest |\n",
         "| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |\n",
-        "| [ChatMistralAI](https://python.langchain.com/api_reference/mistralai/chat_models/langchain_mistralai.chat_models.ChatMistralAI.html) | [langchain-mistralai](https://python.langchain.com/api_reference/mistralai/index.html) | ❌ | beta | ✅ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_mistralai?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_mistralai?style=flat-square&label=%20) |\n",
+        "| [ChatMistralAI](https://python.langchain.com/api_reference/mistralai/chat_models/langchain_mistralai.chat_models.ChatMistralAI.html) | [langchain_mistralai](https://python.langchain.com/api_reference/mistralai/index.html) | ❌ | beta | ✅ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_mistralai?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_mistralai?style=flat-square&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",
@@ -34,7 +34,7 @@
         "## Setup\n",
         "\n",
         "\n",
-        "To access `ChatMistralAI` models you'll need to create a Mistral account, get an API key, and install the `langchain-mistralai` integration package.\n",
+        "To access `ChatMistralAI` models you'll need to create a Mistral account, get an API key, and install the `langchain_mistralai` integration package.\n",
         "\n",
         "### Credentials\n",
         "\n",
@@ -80,7 +80,7 @@
       "source": [
         "### Installation\n",
         "\n",
-        "The LangChain Mistral integration lives in the `langchain-mistralai` package:"
+        "The LangChain Mistral integration lives in the `langchain_mistralai` package:"
       ]
     },
     {
@@ -90,7 +90,7 @@
       "metadata": {},
       "outputs": [],
       "source": [
-        "%pip install -qU langchain-mistralai"
+        "%pip install -qU langchain_mistralai"
       ]
     },
     {

docs/docs/integrations/chat/naver.ipynb

@@ -1,651 +1,356 @@
 {
- "cells": [
-  {
-   "cell_type": "raw",
-   "id": "afaf8039",
-   "metadata": {},
-   "source": [
-    "---\n",
-    "sidebar_label: Naver\n",
-    "---"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "c8444f1a-e907-4f07-b8b6-68fbedfb868e",
-   "metadata": {},
-   "source": [
-    "# ChatClovaX\n",
-    "\n",
-    "This notebook provides a quick overview for getting started with Naver’s HyperCLOVA X [chat models](https://python.langchain.com/docs/concepts/chat_models) via CLOVA Studio. For detailed documentation of all ChatClovaX features and configurations head to the [API reference](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain).\n",
-    "\n",
-    "[CLOVA Studio](http://clovastudio.ncloud.com/) has several chat models. You can find information about the latest models, including their costs, context windows, and supported input types, in the CLOVA Studio Guide [documentation](https://guide.ncloud-docs.com/docs/clovastudio-model).\n",
-    "\n",
-    "## Overview\n",
-    "### Integration details\n",
-    "\n",
-    "| Class | Package | Local | Serializable | JS support | Package downloads | Package latest |\n",
-    "| :--- | :--- |:-----:| :---: |:------------------------------------------------------------------------:| :---: | :---: |\n",
-    "| [ChatClovaX](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain#HyperCLOVAX%EB%AA%A8%EB%8D%B8%EC%9D%B4%EC%9A%A9) | [langchain-naver](https://pypi.org/project/langchain-naver/) |   ❌   | ❌ |                                    ❌                                     | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_naver?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_naver?style=flat-square&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",
-    "Before using the chat model, you must go through the four steps below.\n",
-    "\n",
-    "1. Creating [NAVER Cloud Platform](https://www.ncloud.com/) account\n",
-    "2. Apply to use [CLOVA Studio](https://www.ncloud.com/product/aiService/clovaStudio)\n",
-    "3. Create a CLOVA Studio Test App or Service App of a model to use (See [here](https://guide.ncloud-docs.com/docs/clovastudio-playground-testapp).)\n",
-    "4. Issue a Test or Service API key (See [here](https://api.ncloud-docs.com/docs/ai-naver-clovastudio-summary#API%ED%82%A4).)\n",
-    "\n",
-    "### Credentials\n",
-    "\n",
-    "Set the `CLOVASTUDIO_API_KEY` environment variable with your API key.\n",
-    "\n",
-    "You can add them to your environment variables as below:\n",
-    "\n",
-    "``` bash\n",
-    "export CLOVASTUDIO_API_KEY=\"your-api-key-here\"\n",
-    "```"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "id": "2def81b5-b023-4f40-a97b-b2c5ca59d6a9",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import getpass\n",
-    "import os\n",
-    "\n",
-    "if not os.getenv(\"CLOVASTUDIO_API_KEY\"):\n",
-    "    os.environ[\"CLOVASTUDIO_API_KEY\"] = getpass.getpass(\n",
-    "        \"Enter your CLOVA Studio API Key: \"\n",
-    "    )"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "7c695442",
-   "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": "6151aeb6",
-   "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": "17bf9053-90c5-4955-b239-55a35cb07566",
-   "metadata": {},
-   "source": [
-    "### Installation\n",
-    "\n",
-    "The LangChain Naver integration lives in the `langchain-naver` package:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "a15d341e-3e26-4ca3-830b-5aab30ed66de",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# install package\n",
-    "%pip install -qU langchain-naver"
-   ]
-  },
-  {
-   "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:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_naver import ChatClovaX\n",
-    "\n",
-    "chat = ChatClovaX(\n",
-    "    model=\"HCX-005\",\n",
-    "    temperature=0.5,\n",
-    "    max_tokens=None,\n",
-    "    timeout=None,\n",
-    "    max_retries=2,\n",
-    "    # other params...\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "47752b59",
-   "metadata": {},
-   "source": [
-    "## Invocation\n",
-    "\n",
-    "In addition to `invoke` below, `ChatClovaX` also supports batch, stream and their async functionalities."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "id": "62e0dbc3",
-   "metadata": {
-    "tags": []
-   },
-   "outputs": [
+  "cells": [
     {
-     "data": {
-      "text/plain": [
-       "AIMessage(content='네이버 인공지능을 사용하는 것이 정말 좋아요.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 10, 'prompt_tokens': 28, 'total_tokens': 38, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': 'd685424a78d34009a7b07f5b0110a10b', 'service_tier': None, 'finish_reason': 'stop', 'logprobs': None}, id='run--9bd4df90-d88d-4f9a-b208-c41760f107f8-0', usage_metadata={'input_tokens': 28, 'output_tokens': 10, 'total_tokens': 38, 'input_token_details': {}, 'output_token_details': {}})"
+      "cell_type": "raw",
+      "id": "afaf8039",
+      "metadata": {},
+      "source": [
+        "---\n",
+        "sidebar_label: Naver\n",
+        "---"
       ]
-     },
-     "execution_count": 4,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "messages = [\n",
-    "    (\n",
-    "        \"system\",\n",
-    "        \"You are a helpful assistant that translates English to Korean. Translate the user sentence.\",\n",
-    "    ),\n",
-    "    (\"human\", \"I love using NAVER AI.\"),\n",
-    "]\n",
-    "\n",
-    "ai_msg = chat.invoke(messages)\n",
-    "ai_msg"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "id": "24e7377f",
-   "metadata": {},
-   "outputs": [
+    },
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "네이버 인공지능을 사용하는 것이 정말 좋아요.\n"
-     ]
-    }
-   ],
-   "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:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 6,
-   "id": "e197d1d7-a070-4c96-9f8a-a0e86d046e0b",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "AIMessage(content='저는 NAVER AI를 사용하는 것을 좋아합니다.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 11, 'prompt_tokens': 28, 'total_tokens': 39, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': '3918787e422846958cbf995cc93ee7a4', 'service_tier': None, 'finish_reason': 'stop', 'logprobs': None}, id='run--1a78accd-be5d-4a03-ad8b-7753d4d47ffd-0', usage_metadata={'input_tokens': 28, 'output_tokens': 11, 'total_tokens': 39, 'input_token_details': {}, 'output_token_details': {}})"
+      "cell_type": "markdown",
+      "id": "c8444f1a-e907-4f07-b8b6-68fbedfb868e",
+      "metadata": {},
+      "source": [
+        "# ChatClovaX\n",
+        "\n",
+        "This notebook provides a quick overview for getting started with Naver’s HyperCLOVA X [chat models](https://python.langchain.com/docs/concepts/chat_models) via CLOVA Studio. For detailed documentation of all ChatClovaX features and configurations head to the [API reference](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain).\n",
+        "\n",
+        "[CLOVA Studio](http://clovastudio.ncloud.com/) has several chat models. You can find information about latest models and their costs, context windows, and supported input types in the CLOVA Studio Guide [documentation](https://guide.ncloud-docs.com/docs/clovastudio-model).\n",
+        "\n",
+        "## Overview\n",
+        "### Integration details\n",
+        "\n",
+        "| Class | Package | Local | Serializable | JS support | Package downloads | Package latest |\n",
+        "| :--- | :--- |:-----:| :---: |:------------------------------------------------------------------------:| :---: | :---: |\n",
+        "| [ChatClovaX](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain#HyperCLOVAX%EB%AA%A8%EB%8D%B8%EC%9D%B4%EC%9A%A9) | [langchain-naver](https://pypi.org/project/langchain-naver/) |   ❌   | ❌ |                                    ❌                                     | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_naver?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_naver?style=flat-square&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",
+        "Before using the chat model, you must go through the four steps below.\n",
+        "\n",
+        "1. Creating [NAVER Cloud Platform](https://www.ncloud.com/) account\n",
+        "2. Apply to use [CLOVA Studio](https://www.ncloud.com/product/aiService/clovaStudio)\n",
+        "3. Create a CLOVA Studio Test App or Service App of a model to use (See [here](https://guide.ncloud-docs.com/docs/clovastudio-playground-testapp).)\n",
+        "4. Issue a Test or Service API key (See [here](https://api.ncloud-docs.com/docs/ai-naver-clovastudio-summary#API%ED%82%A4).)\n",
+        "\n",
+        "### Credentials\n",
+        "\n",
+        "Set the `CLOVASTUDIO_API_KEY` environment variable with your API key.\n",
+        "\n",
+        "You can add them to your environment variables as below:\n",
+        "\n",
+        "``` bash\n",
+        "export CLOVASTUDIO_API_KEY=\"your-api-key-here\"\n",
+        "```"
       ]
-     },
-     "execution_count": 6,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "from langchain_core.prompts import ChatPromptTemplate\n",
-    "\n",
-    "prompt = ChatPromptTemplate.from_messages(\n",
-    "    [\n",
-    "        (\n",
-    "            \"system\",\n",
-    "            \"You are a helpful assistant that translates {input_language} to {output_language}. Translate the user sentence.\",\n",
-    "        ),\n",
-    "        (\"human\", \"{input}\"),\n",
-    "    ]\n",
-    ")\n",
-    "\n",
-    "chain = prompt | chat\n",
-    "chain.invoke(\n",
-    "    {\n",
-    "        \"input_language\": \"English\",\n",
-    "        \"output_language\": \"Korean\",\n",
-    "        \"input\": \"I love using NAVER AI.\",\n",
-    "    }\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "66e69286",
-   "metadata": {},
-   "source": [
-    "## Streaming"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "id": "2c07af21-dda5-4514-b4de-1f214c2cebcd",
-   "metadata": {},
-   "outputs": [
+    },
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "In Korean, 'Hi' is typically translated as '안녕하세요' (annyeonghaseyo). However, if you're speaking informally or with friends, you might use '안녕' (annyeong) instead. Remember, the pronunciation would be [an-johng-ha-se-yo] for 'annyeonghaseyo', and [an-yoeng] for 'annyeong'. The stress usually falls on the second syllable of each word. Keep practicing!"
-     ]
-    }
-   ],
-   "source": [
-    "system = \"You are a helpful assistant that can teach Korean pronunciation.\"\n",
-    "human = \"Could you let me know how to say '{phrase}' in Korean?\"\n",
-    "prompt = ChatPromptTemplate.from_messages([(\"system\", system), (\"human\", human)])\n",
-    "\n",
-    "chain = prompt | chat\n",
-    "\n",
-    "for chunk in chain.stream({\"phrase\": \"Hi\"}):\n",
-    "    print(chunk.content, end=\"\", flush=True)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "2cbb0e5d",
-   "metadata": {},
-   "source": [
-    "## Tool calling\n",
-    "\n",
-    "CLOVA Studio supports tool calling (also known as \"[function calling](https://api.ncloud-docs.com/docs/clovastudio-chatcompletionsv3-fc)\") that lets you describe tools and their arguments, and have the model return a JSON object with a tool to invoke and the inputs to that tool. It is extremely useful for building tool-using chains and agents, and for getting structured outputs from models more generally.\n",
-    "\n",
-    "**Note**: You should set `max_tokens` larger than 1024 to utilize the tool calling feature in CLOVA Studio. \n",
-    "\n",
-    "### ChatClovaX.bind_tools()\n",
-    "\n",
-    "With `ChatClovaX.bind_tools`, we can easily pass in Pydantic classes, dict schemas, LangChain tools, or even functions as tools to the model. Under the hood these are converted to an OpenAI-compatible tool schemas, which looks like:\n",
-    "\n",
-    "```\n",
-    "{\n",
-    "    \"name\": \"...\",\n",
-    "    \"description\": \"...\",\n",
-    "    \"parameters\": {...}  # JSONSchema\n",
-    "}\n",
-    "```\n",
-    "\n",
-    "and passed in every model invocation."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 8,
-   "id": "3fd50ca3",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_naver import ChatClovaX\n",
-    "\n",
-    "chat = ChatClovaX(\n",
-    "    model=\"HCX-005\",\n",
-    "    max_tokens=1024,  # Set max tokens larger than 1024 to use tool calling\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "963ce9af",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from pydantic import BaseModel, Field\n",
-    "\n",
-    "\n",
-    "class GetWeather(BaseModel):\n",
-    "    \"\"\"Get the current weather in a given location\"\"\"\n",
-    "\n",
-    "    location: str = Field(\n",
-    "        ..., description=\"The city and province, e.g. Seongnam-si, Gyeonggi-do\"\n",
-    "    )\n",
-    "\n",
-    "\n",
-    "chat_with_tools = chat.bind_tools([GetWeather])"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 10,
-   "id": "138bb069",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_EOh69hbtl8p24URrYRl059XT', 'function': {'arguments': '{\"location\":\"Seongnam, Gyeonggi-do\"}', 'name': 'GetWeather'}, 'type': 'function'}], 'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 37, 'prompt_tokens': 16, 'total_tokens': 53, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': '085c74d930a84dc7b7cb59fde476e710', 'service_tier': None, 'finish_reason': 'tool_calls', 'logprobs': None}, id='run--f3b46b02-81fe-4ab3-bcb5-f0a6cb7f2be0-0', tool_calls=[{'name': 'GetWeather', 'args': {'location': 'Seongnam, Gyeonggi-do'}, 'id': 'call_EOh69hbtl8p24URrYRl059XT', 'type': 'tool_call'}], usage_metadata={'input_tokens': 16, 'output_tokens': 37, 'total_tokens': 53, 'input_token_details': {}, 'output_token_details': {}})"
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "2def81b5-b023-4f40-a97b-b2c5ca59d6a9",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "if not os.getenv(\"CLOVASTUDIO_API_KEY\"):\n",
+        "    os.environ[\"CLOVASTUDIO_API_KEY\"] = getpass.getpass(\n",
+        "        \"Enter your CLOVA Studio API Key: \"\n",
+        "    )"
       ]
-     },
-     "execution_count": 10,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "ai_msg = chat_with_tools.invoke(\n",
-    "    \"what is the weather like in Bundang-gu?\",\n",
-    ")\n",
-    "ai_msg"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "11ec57b2",
-   "metadata": {},
-   "source": [
-    "### AIMessage.tool_calls\n",
-    "\n",
-    "Notice that the AIMessage has a `tool_calls` attribute. This contains in a standardized ToolCall format that is model-provider agnostic."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 11,
-   "id": "265605a1",
-   "metadata": {},
-   "outputs": [
+    },
     {
-     "data": {
-      "text/plain": [
-       "[{'name': 'GetWeather',\n",
-       "  'args': {'location': 'Seongnam, Gyeonggi-do'},\n",
-       "  'id': 'call_EOh69hbtl8p24URrYRl059XT',\n",
-       "  'type': 'tool_call'}]"
+      "cell_type": "markdown",
+      "id": "7c695442",
+      "metadata": {},
+      "source": [
+        "To enable automated tracing of your model calls, set your [LangSmith](https://docs.smith.langchain.com/) API key:"
       ]
-     },
-     "execution_count": 11,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "ai_msg.tool_calls"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "5f2d54f2",
-   "metadata": {},
-   "source": [
-    "## Structured Outputs\n",
-    "\n",
-    "For supporting model(s), you can use the [Structured Outputs](https://api.ncloud-docs.com/docs/clovastudio-chatcompletionsv3-so) feature to force the model to generates responses in a specific structure, such as Pydantic model or TypedDict or JSON.\n",
-    "\n",
-    "**Note**: Structured Outputs requires Thinking mode to be disabled. Set `thinking.effort` to `none`."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 12,
-   "id": "2af3730f",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from langchain_naver import ChatClovaX\n",
-    "\n",
-    "chat = ChatClovaX(\n",
-    "    model=\"HCX-007\",\n",
-    "    thinking={\n",
-    "        \"effort\": \"none\"  # Set to \"none\" to disable thinking, as structured outputs are incompatible with thinking\n",
-    "    },\n",
-    ")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 13,
-   "id": "a9ed4514",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from typing import Optional\n",
-    "from pydantic import BaseModel, Field\n",
-    "\n",
-    "\n",
-    "# Pydantic model example\n",
-    "class Weather(BaseModel):\n",
-    "    \"\"\"Virtual weather info to tell user.\"\"\"\n",
-    "\n",
-    "    temp_high_c: int = Field(description=\"The highest temperature in Celsius\")\n",
-    "    temp_low_c: int = Field(description=\"The lowest temperature in Celsius\")\n",
-    "    condition: str = Field(description=\"The weather condition (e.g., sunny, rainy)\")\n",
-    "    precipitation_percent: Optional[int] = Field(\n",
-    "        default=None,\n",
-    "        description=\"The chance of precipitation in percent (optional, can be None)\",\n",
-    "    )"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "690b785f",
-   "metadata": {},
-   "source": [
-    "**Note**: CLOVA Studio supports Structured Outputs with a json schema method. Set `method` to `json_schema`."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 15,
-   "id": "041fcefd",
-   "metadata": {},
-   "outputs": [
+    },
     {
-     "data": {
-      "text/plain": [
-       "Weather(temp_high_c=30, temp_low_c=20, condition='sunny', precipitation_percent=None)"
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "6151aeb6",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# os.environ[\"LANGSMITH_TRACING\"] = \"true\"\n",
+        "# os.environ[\"LANGSMITH_API_KEY\"] = getpass.getpass(\"Enter your LangSmith API key: \")"
       ]
-     },
-     "execution_count": 15,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "structured_chat = chat.with_structured_output(Weather, method=\"json_schema\")\n",
-    "ai_msg = structured_chat.invoke(\n",
-    "    \"what is the weather like in Bundang-gu?\",\n",
-    ")\n",
-    "ai_msg"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "86ac1fed",
-   "metadata": {},
-   "source": [
-    "## Thinking\n",
-    "\n",
-    "For supporting model(s), when [Thinking](https://api.ncloud-docs.com/docs/clovastudio-chatcompletionsv3-thinking) feature is enabled (by default), it will output the step-by-step reasoning process that led to its final answer.\n",
-    "\n",
-    "Specify the `thinking` parameter to control the feature—enable or disable the thinking process and configure its depth."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 18,
-   "id": "42ccba84",
-   "metadata": {},
-   "outputs": [
+    },
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The value of \\(3^3\\) (3 cubed) is calculated as follows:\n",
-      "\n",
-      "\\[\n",
-      "3^3 = 3 \\times 3 \\times 3\n",
-      "\\]\n",
-      "\n",
-      "Breaking it into steps:\n",
-      "1. First multiplication:  \n",
-      "   \\(3 \\times 3 = 9\\)\n",
-      "\n",
-      "2. Second multiplication using the previous result:  \n",
-      "   \\(9 \\times 3 = 27\\)\n",
-      "\n",
-      "Thus, **\\(3^3 = 27\\)**. This represents 3 multiplied by itself three times. Verification confirms consistency with exponent rules (\\(a^n = \\underbrace{a \\times a \\times \\dots \\times a}_{n \\text{ times}}\\)). No ambiguity exists in standard mathematical notation here. Answer: **27**.  \n",
-      "\n",
-      "Final token count: ~500 (within limit).  \n",
-      "Answer: \\boxed{27}\n"
-     ]
-    }
-   ],
-   "source": [
-    "from langchain_naver import ChatClovaX\n",
-    "\n",
-    "chat = ChatClovaX(\n",
-    "    model=\"HCX-007\",\n",
-    "    thinking={\n",
-    "        \"effort\": \"low\"  # 'none' (disabling), 'low' (default), 'medium', or 'high'\n",
-    "    },\n",
-    ")\n",
-    "ai_msg = chat.invoke(\"What is 3^3?\")\n",
-    "print(ai_msg.content)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "2cada4aa",
-   "metadata": {},
-   "source": [
-    "### Accessing the thinking process\n",
-    "\n",
-    "When Thinking mode is enabled, you can access the thinking process through the `thinking_content` attribute in `AIMessage.additional_kwargs`."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 19,
-   "id": "8b23d219",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Okay, let's see. The user asked what 3 cubed is. Hmm, exponentiation basics here. So 3 to the power of 3 means multiplying 3 by itself three times.\n",
-      "\n",
-      "First, I should recall how exponents work. For any number a raised to n, it's a multiplied by itself n-1 more times. In this case, a is 3 and n is 3. \n",
-      "\n",
-      "So breaking it down: 3 × 3 = 9 first. Then take that result and multiply by another 3. That would be 9 × 3. Let me calculate that... 9 times 3 equals 27. Wait, does that make sense? Yeah, because 3 squared is 9, then adding another factor of 3 gives 27. \n",
-      "\n",
-      "I think there's no trick question here. Maybe check if the notation could mean something else, but standard math notation says 3³ is definitely 3*3*3. No parentheses or other operations involved. Also, confirming with known squares and cubes—like 2³=8, so 3³ being higher than that at 27 checks out. Yep, answer must be 27. Shouldn't overcomplicate it. Just straightforward multiplication. Alright, confident now.\n"
-     ]
-    }
-   ],
-   "source": [
-    "print(ai_msg.additional_kwargs[\"thinking_content\"])"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "d1ee55bc-ffc8-4cfa-801c-993953a08cfd",
-   "metadata": {},
-   "source": [
-    "## Additional functionalities\n",
-    "\n",
-    "### Using fine-tuned models\n",
-    "\n",
-    "You can call fine-tuned models by passing the `task_id` to the `model` parameter as: `ft:{task_id}`.\n",
-    "\n",
-    "You can check `task_id` from corresponding Test App or Service App details."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "cb436788",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "AIMessage(content='네이버 인공지능을 사용하는 것을 정말 좋아합니다.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 11, 'prompt_tokens': 28, 'total_tokens': 39, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': '2222d6d411a948c883aac1e03ca6cebe', 'finish_reason': 'stop', 'logprobs': None}, id='run-9696d7e2-7afa-4bb4-9c03-b95fcf678ab8-0', usage_metadata={'input_tokens': 28, 'output_tokens': 11, 'total_tokens': 39, 'input_token_details': {}, 'output_token_details': {}})"
+      "cell_type": "markdown",
+      "id": "17bf9053-90c5-4955-b239-55a35cb07566",
+      "metadata": {},
+      "source": [
+        "### Installation\n",
+        "\n",
+        "The LangChain Naver integration lives in the `langchain-naver` package:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "a15d341e-3e26-4ca3-830b-5aab30ed66de",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "# install package\n",
+        "%pip install -qU langchain-naver"
+      ]
+    },
+    {
+      "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:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 3,
+      "id": "cb09c344-1836-4e0c-acf8-11d13ac1dbae",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from langchain_naver import ChatClovaX\n",
+        "\n",
+        "chat = ChatClovaX(\n",
+        "    model=\"HCX-005\",\n",
+        "    temperature=0.5,\n",
+        "    max_tokens=None,\n",
+        "    timeout=None,\n",
+        "    max_retries=2,\n",
+        "    # other params...\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "47752b59",
+      "metadata": {},
+      "source": [
+        "## Invocation\n",
+        "\n",
+        "In addition to invoke, `ChatClovaX` also support batch and stream functionalities."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 4,
+      "id": "62e0dbc3",
+      "metadata": {
+        "tags": []
+      },
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "AIMessage(content='네이버 인공지능을 사용하는 것을 정말 좋아합니다.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 11, 'prompt_tokens': 28, 'total_tokens': 39, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': 'b70c26671cd247a0864115bacfb5fc12', 'finish_reason': 'stop', 'logprobs': None}, id='run-3faf6a8d-d5da-49ad-9fbb-7b56ed23b484-0', usage_metadata={'input_tokens': 28, 'output_tokens': 11, 'total_tokens': 39, 'input_token_details': {}, 'output_token_details': {}})"
+            ]
+          },
+          "execution_count": 4,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "messages = [\n",
+        "    (\n",
+        "        \"system\",\n",
+        "        \"You are a helpful assistant that translates English to Korean. Translate the user sentence.\",\n",
+        "    ),\n",
+        "    (\"human\", \"I love using NAVER AI.\"),\n",
+        "]\n",
+        "\n",
+        "ai_msg = chat.invoke(messages)\n",
+        "ai_msg"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 5,
+      "id": "24e7377f",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "네이버 인공지능을 사용하는 것을 정말 좋아합니다.\n"
+          ]
+        }
+      ],
+      "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:"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 6,
+      "id": "e197d1d7-a070-4c96-9f8a-a0e86d046e0b",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "AIMessage(content='저는 네이버 인공지능을 사용하는 것을 좋아합니다.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 10, 'prompt_tokens': 28, 'total_tokens': 38, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': 'b7a826d17fcf4fee8386fca2ebc63284', 'finish_reason': 'stop', 'logprobs': None}, id='run-35957816-3325-4d9c-9441-e40704912be6-0', usage_metadata={'input_tokens': 28, 'output_tokens': 10, 'total_tokens': 38, 'input_token_details': {}, 'output_token_details': {}})"
+            ]
+          },
+          "execution_count": 6,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "from langchain_core.prompts import ChatPromptTemplate\n",
+        "\n",
+        "prompt = ChatPromptTemplate.from_messages(\n",
+        "    [\n",
+        "        (\n",
+        "            \"system\",\n",
+        "            \"You are a helpful assistant that translates {input_language} to {output_language}. Translate the user sentence.\",\n",
+        "        ),\n",
+        "        (\"human\", \"{input}\"),\n",
+        "    ]\n",
+        ")\n",
+        "\n",
+        "chain = prompt | chat\n",
+        "chain.invoke(\n",
+        "    {\n",
+        "        \"input_language\": \"English\",\n",
+        "        \"output_language\": \"Korean\",\n",
+        "        \"input\": \"I love using NAVER AI.\",\n",
+        "    }\n",
+        ")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "66e69286",
+      "metadata": {},
+      "source": [
+        "## Streaming"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 7,
+      "id": "2c07af21-dda5-4514-b4de-1f214c2cebcd",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": [
+            "In Korean, the informal way of saying 'hi' is \"안녕\" (annyeong). If you're addressing someone older or showing more respect, you would use \"안녕하세요\" (annjeonghaseyo). Both phrases are used as greetings similar to 'hello'. Remember, pronunciation is key so make sure to pronounce each syllable clearly: 안-녀-엉 (an-nyeo-eong) and 안-녕-하-세-요 (an-nyeong-ha-se-yo)."
+          ]
+        }
+      ],
+      "source": [
+        "system = \"You are a helpful assistant that can teach Korean pronunciation.\"\n",
+        "human = \"Could you let me know how to say '{phrase}' in Korean?\"\n",
+        "prompt = ChatPromptTemplate.from_messages([(\"system\", system), (\"human\", human)])\n",
+        "\n",
+        "chain = prompt | chat\n",
+        "\n",
+        "for chunk in chain.stream({\"phrase\": \"Hi\"}):\n",
+        "    print(chunk.content, end=\"\", flush=True)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "d1ee55bc-ffc8-4cfa-801c-993953a08cfd",
+      "metadata": {},
+      "source": [
+        "## Additional functionalities\n",
+        "\n",
+        "### Using fine-tuned models\n",
+        "\n",
+        "You can call fine-tuned models by passing the `task_id` to the `model` parameter as: `ft:{task_id}`.\n",
+        "\n",
+        "You can check `task_id` from corresponding Test App or Service App details."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "cb436788",
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "AIMessage(content='네이버 인공지능을 사용하는 것을 정말 좋아합니다.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 11, 'prompt_tokens': 28, 'total_tokens': 39, 'completion_tokens_details': None, 'prompt_tokens_details': None}, 'model_name': 'HCX-005', 'system_fingerprint': None, 'id': '2222d6d411a948c883aac1e03ca6cebe', 'finish_reason': 'stop', 'logprobs': None}, id='run-9696d7e2-7afa-4bb4-9c03-b95fcf678ab8-0', usage_metadata={'input_tokens': 28, 'output_tokens': 11, 'total_tokens': 39, 'input_token_details': {}, 'output_token_details': {}})"
+            ]
+          },
+          "execution_count": 10,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "fine_tuned_model = ChatClovaX(\n",
+        "    model=\"ft:a1b2c3d4\",  # set as `ft:{task_id}` with your fine-tuned model's task id\n",
+        "    # other params...\n",
+        ")\n",
+        "\n",
+        "fine_tuned_model.invoke(messages)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "3a5bb5ca-c3ae-4a58-be67-2cd18574b9a3",
+      "metadata": {},
+      "source": [
+        "## API reference\n",
+        "\n",
+        "For detailed documentation of all ChatClovaX features and configurations head to the [API reference](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain)"
       ]
-     },
-     "execution_count": 10,
-     "metadata": {},
-     "output_type": "execute_result"
     }
-   ],
-   "source": [
-    "fine_tuned_model = ChatClovaX(\n",
-    "    model=\"ft:a1b2c3d4\",  # set as `ft:{task_id}` with your fine-tuned model's task id\n",
-    "    # other params...\n",
-    ")\n",
-    "\n",
-    "fine_tuned_model.invoke(messages)"
-   ]
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "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.12.8"
+    }
   },
-  {
-   "cell_type": "markdown",
-   "id": "3a5bb5ca-c3ae-4a58-be67-2cd18574b9a3",
-   "metadata": {},
-   "source": [
-    "## API reference\n",
-    "\n",
-    "For detailed documentation of all ChatClovaX features and configurations head to the [API reference](https://guide.ncloud-docs.com/docs/clovastudio-dev-langchain)"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": ".venv",
-   "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.13.4"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
+  "nbformat": 4,
+  "nbformat_minor": 5
 }

docs/docs/integrations/chat/nvidia_ai_endpoints.ipynb

@@ -41,7 +41,7 @@
         "\n",
         "| Class | Package | Local | Serializable | JS support | Package downloads | Package latest |\n",
         "| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |\n",
-        "| [ChatNVIDIA](https://python.langchain.com/api_reference/nvidia_ai_endpoints/chat_models/langchain_nvidia_ai_endpoints.chat_models.ChatNVIDIA.html) | [langchain-nvidia-ai-endpoints](https://python.langchain.com/api_reference/nvidia_ai_endpoints/index.html) | ✅ | beta | ❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_nvidia_ai_endpoints?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_nvidia_ai_endpoints?style=flat-square&label=%20) |\n",
+        "| [ChatNVIDIA](https://python.langchain.com/api_reference/nvidia_ai_endpoints/chat_models/langchain_nvidia_ai_endpoints.chat_models.ChatNVIDIA.html) | [langchain_nvidia_ai_endpoints](https://python.langchain.com/api_reference/nvidia_ai_endpoints/index.html) | ✅ | beta | ❌ | ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain_nvidia_ai_endpoints?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain_nvidia_ai_endpoints?style=flat-square&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",
@@ -102,7 +102,7 @@
       "source": [
         "### Installation\n",
         "\n",
-        "The LangChain NVIDIA AI Endpoints integration lives in the `langchain-nvidia-ai-endpoints` package:"
+        "The LangChain NVIDIA AI Endpoints integration lives in the `langchain_nvidia_ai_endpoints` package:"
       ]
     },
     {

docs/docs/integrations/chat/oci_generative_ai.ipynb

@@ -17,7 +17,7 @@
    "source": [
     "# ChatOCIGenAI\n",
     "\n",
-    "This notebook provides a quick overview for getting started with OCIGenAI [chat models](/docs/concepts/chat_models). For detailed documentation of all ChatOCIGenAI features and configurations head to the [API reference](https://pypi.org/project/langchain-oci/).\n",
+    "This notebook provides a quick overview for getting started with OCIGenAI [chat models](/docs/concepts/chat_models). For detailed documentation of all ChatOCIGenAI features and configurations head to the [API reference](https://python.langchain.com/api_reference/community/chat_models/langchain_community.chat_models.oci_generative_ai.ChatOCIGenAI.html).\n",
     "\n",
     "Oracle Cloud Infrastructure (OCI) Generative AI is a fully managed service that provides a set of state-of-the-art, customizable large language models (LLMs) that cover a wide range of use cases, and which is available through a single API.\n",
     "Using the OCI Generative AI service you can access ready-to-use pretrained models, or create and host your own fine-tuned custom models based on your own data on dedicated AI clusters. Detailed documentation of the service and API is available __[here](https://docs.oracle.com/en-us/iaas/Content/generative-ai/home.htm)__ and __[here](https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai/20231130/)__.\n",
@@ -26,9 +26,9 @@
     "## Overview\n",
     "### Integration details\n",
     "\n",
-    "| Class | Package                                                                          | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/chat/oci_generative_ai) |\n",
-    "| :--- |:---------------------------------------------------------------------------------| :---: | :---: |  :---: |\n",
-    "| [ChatOCIGenAI](https://python.langchain.com/api_reference/community/chat_models/langchain_community.chat_models.oci_generative_ai.ChatOCIGenAI.html) | [langchain-oci](https://github.com/oracle/langchain-oracle) | ❌ | ❌ | ❌ |\n",
+    "| Class | Package | Local | Serializable | [JS support](https://js.langchain.com/docs/integrations/chat/oci_generative_ai) |\n",
+    "| :--- | :--- | :---: | :---: |  :---: |\n",
+    "| [ChatOCIGenAI](https://python.langchain.com/api_reference/community/chat_models/langchain_community.chat_models.oci_generative_ai.ChatOCIGenAI.html) | [langchain-community](https://python.langchain.com/api_reference/community/index.html) | ❌ | ❌ | ❌ |\n",
     "\n",
     "### Model features\n",
     "| [Tool calling](/docs/how_to/tool_calling/) | [Structured output](/docs/how_to/structured_output/) | [JSON mode](/docs/how_to/structured_output/#advanced-specifying-the-method-for-structuring-outputs) | [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",
@@ -37,7 +37,7 @@
     "\n",
     "## Setup\n",
     "\n",
-    "To access OCIGenAI models you'll need to install the `oci` and `langchain-oci` packages.\n",
+    "To access OCIGenAI models you'll need to install the `oci` and `langchain-community` packages.\n",
     "\n",
     "### Credentials\n",
     "\n",
@@ -53,7 +53,7 @@
    "source": [
     "### Installation\n",
     "\n",
-    "The LangChain OCIGenAI integration lives in the `langchain-oci` package and you will also need to install the `oci` package:"
+    "The LangChain OCIGenAI integration lives in the `langchain-community` package and you will also need to install the `oci` package:"
    ]
   },
   {
@@ -63,7 +63,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%pip install -qU langchain-oci"
+    "%pip install -qU langchain-community oci"
    ]
   },
   {
@@ -83,16 +83,14 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_oci.chat_models import ChatOCIGenAI\n",
+    "from langchain_community.chat_models.oci_generative_ai import ChatOCIGenAI\n",
+    "from langchain_core.messages import AIMessage, HumanMessage, SystemMessage\n",
     "\n",
     "chat = ChatOCIGenAI(\n",
-    "    model_id=\"cohere.command-r-plus-08-2024\",\n",
+    "    model_id=\"cohere.command-r-16k\",\n",
     "    service_endpoint=\"https://inference.generativeai.us-chicago-1.oci.oraclecloud.com\",\n",
-    "    compartment_id=\"compartment_id\",\n",
-    "    model_kwargs={\"temperature\": 0, \"max_tokens\": 500},\n",
-    "    auth_type=\"SECURITY_TOKEN\",\n",
-    "    auth_profile=\"auth_profile_name\",\n",
-    "    auth_file_location=\"auth_file_location\",\n",
+    "    compartment_id=\"MY_OCID\",\n",
+    "    model_kwargs={\"temperature\": 0.7, \"max_tokens\": 500},\n",
     ")"
    ]
   },
@@ -112,7 +110,14 @@
     "tags": []
    },
    "outputs": [],
-   "source": "response = chat.invoke(\"Tell me one fact about Earth\")"
+   "source": [
+    "messages = [\n",
+    "    SystemMessage(content=\"your are an AI assistant.\"),\n",
+    "    AIMessage(content=\"Hi there human!\"),\n",
+    "    HumanMessage(content=\"tell me a joke.\"),\n",
+    "]\n",
+    "response = chat.invoke(messages)"
+   ]
   },
   {
    "cell_type": "code",
@@ -141,22 +146,13 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from langchain_core.prompts import PromptTemplate\n",
-    "from langchain_oci.chat_models import ChatOCIGenAI\n",
+    "from langchain_core.prompts import ChatPromptTemplate\n",
     "\n",
-    "llm = ChatOCIGenAI(\n",
-    "    model_id=\"cohere.command-r-plus-08-2024\",\n",
-    "    service_endpoint=\"https://inference.generativeai.us-chicago-1.oci.oraclecloud.com\",\n",
-    "    compartment_id=\"compartment_id\",\n",
-    "    model_kwargs={\"temperature\": 0, \"max_tokens\": 500},\n",
-    "    auth_type=\"SECURITY_TOKEN\",\n",
-    "    auth_profile=\"auth_profile_name\",\n",
-    "    auth_file_location=\"auth_file_location\",\n",
-    ")\n",
-    "prompt = PromptTemplate(input_variables=[\"query\"], template=\"{query}\")\n",
-    "llm_chain = prompt | llm\n",
-    "response = llm_chain.invoke(\"what is the capital of france?\")\n",
-    "print(response)"
+    "prompt = ChatPromptTemplate.from_template(\"Tell me a joke about {topic}\")\n",
+    "chain = prompt | chat\n",
+    "\n",
+    "response = chain.invoke({\"topic\": \"dogs\"})\n",
+    "print(response.content)"
    ]
   },
   {
@@ -166,7 +162,7 @@
    "source": [
     "## API reference\n",
     "\n",
-    "For detailed documentation of all ChatOCIGenAI features and configurations head to the API reference: https://pypi.org/project/langchain-oci/"
+    "For detailed documentation of all ChatOCIGenAI features and configurations head to the API reference: https://python.langchain.com/api_reference/community/chat_models/langchain_community.chat_models.oci_generative_ai.ChatOCIGenAI.html"
    ]
   }
  ],