The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
feat(core,partners): add package version tracking to tracing metadata (#35295)
Mason Daugherty948f6cc58cd3
diff --git a/.github/workflows/check_core_versions.yml b/.github/workflows/check_core_versions.ymldeleted file mode 100644index 4cdbf2a0e1..0000000000--- a/.github/workflows/check_core_versions.yml+++ /dev/null@@ -1,67 +0,0 @@-# Ensures version numbers in pyproject.toml and version.py stay in sync.-#-# (Prevents releases with mismatched version numbers)--name: "π Check Version Equality"--on:- pull_request:- paths:- - "libs/core/pyproject.toml"- - "libs/core/langchain_core/version.py"- - "libs/partners/anthropic/pyproject.toml"- - "libs/partners/anthropic/langchain_anthropic/_version.py"--permissions:- contents: read--jobs:- check_version_equality:- runs-on: ubuntu-latest-- steps:- - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6-- - 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)-- # Compare core versions- if [ "$CORE_PYPROJECT_VERSION" != "$CORE_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"- 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"- fi-- # Check langchain-anthropic versions- ANTHROPIC_PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]*' libs/partners/anthropic/pyproject.toml)- ANTHROPIC_VERSION_PY_VERSION=$(grep -Po '(?<=^__version__ = ")[^"]*' libs/partners/anthropic/langchain_anthropic/_version.py)-- # Compare langchain-anthropic versions- if [ "$ANTHROPIC_PYPROJECT_VERSION" != "$ANTHROPIC_VERSION_PY_VERSION" ]; then- echo "langchain-anthropic versions in pyproject.toml and _version.py do not match!"- echo "pyproject.toml version: $ANTHROPIC_PYPROJECT_VERSION"- echo "_version.py version: $ANTHROPIC_VERSION_PY_VERSION"- exit 1- else- echo "Langchain-anthropic versions match: $ANTHROPIC_PYPROJECT_VERSION"- fidiff --git a/.github/workflows/check_versions.yml b/.github/workflows/check_versions.ymlnew file mode 100644index 0000000000..391b47ac0c--- /dev/null+++ b/.github/workflows/check_versions.yml@@ -0,0 +1,54 @@+# Ensures version numbers in pyproject.toml and _version.py stay in sync.+#+# (Prevents releases with mismatched version numbers)++name: "Check Version Equality"++on:+ pull_request:+ paths:+ - "libs/core/pyproject.toml"+ - "libs/core/langchain_core/version.py"+ - "libs/langchain_v1/pyproject.toml"+ - "libs/langchain_v1/langchain/__init__.py"+ - "libs/partners/*/pyproject.toml"+ - "libs/partners/**/_version.py"++permissions:+ contents: read++jobs:+ check_version_equality:+ runs-on: ubuntu-latest++ steps:+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6++ - uses: astral-sh/setup-uv@0ca8f610542aa7f4acaf39e65cf4eb3c35091883 # v7+ with:+ python-version: "3.12"++ - name: "Verify pyproject.toml & version files match"+ run: |+ FAILED=0++ for dir in libs/core libs/langchain_v1 libs/partners/*; do+ [ -f "$dir/Makefile" ] || continue+ if grep -q '^check_version:' "$dir/Makefile"; then+ echo "--- $dir ---"+ make -C "$dir" check_version || FAILED=1+ elif find "$dir" -maxdepth 2 -name '_version.py' -not -path '*/tests/*' \+ | grep -q .; then+ # A package ships a _version.py but has no way to verify it stays+ # in sync with pyproject.toml. Don't let it pass unchecked.+ echo "--- $dir ---"+ echo "Error: $dir has a _version.py but no 'check_version' Makefile target"+ FAILED=1+ fi+ done++ if [ "$FAILED" -ne 0 ]; then+ echo ""+ echo "One or more version checks failed!"+ exit 1+ fidiff --git a/libs/core/langchain_core/callbacks/base.py b/libs/core/langchain_core/callbacks/base.pyindex 6e4df3dd89..3573dff853 100644--- a/libs/core/langchain_core/callbacks/base.py+++ b/libs/core/langchain_core/callbacks/base.py@@ -1205,9 +1205,15 @@ class BaseCallbackManager(CallbackManagerMixin):metadata: The metadata to add.inherit: Whether to inherit the metadata."""- self.metadata.update(metadata)+ from langchain_core.runnables.config import ( # noqa: PLC0415+ _merge_metadata_dicts,+ )++ self.metadata = _merge_metadata_dicts(self.metadata, metadata)if inherit:- self.inheritable_metadata.update(metadata)+ self.inheritable_metadata = _merge_metadata_dicts(+ self.inheritable_metadata, metadata+ )def remove_metadata(self, keys: list[str]) -> None:"""Remove metadata from the callback manager.diff --git a/libs/core/langchain_core/language_models/base.py b/libs/core/langchain_core/language_models/base.pyindex fb416887e7..2dc0761262 100644--- a/libs/core/langchain_core/language_models/base.py+++ b/libs/core/langchain_core/language_models/base.py@@ -138,6 +138,30 @@ def _get_verbosity() -> bool:return get_verbose()+@cache+def _get_langchain_version() -> str | None:+ """Return the installed `langchain` version, or `None` if not installed.++ Cached because `importlib.metadata.version` performs a filesystem lookup and+ `model_post_init` runs on every `BaseLanguageModel` instantiation. `langchain`+ is an optional sibling package, so its absence is expected and not an error.+ """+ from importlib.metadata import PackageNotFoundError # noqa: PLC0415+ from importlib.metadata import version as pkg_version # noqa: PLC0415++ try:+ return pkg_version("langchain")+ except PackageNotFoundError:+ return None+++# Warm the cache at import time, while we're guaranteed to be on the synchronous+# import path and outside any event loop. Otherwise the first model constructed+# inside async code would run the blocking `os.stat` (via `importlib.metadata`)+# on the event loop, tripping blocking-I/O detectors like blockbuster.+_get_langchain_version()++class BaseLanguageModel(RunnableSerializable[LanguageModelInput, LanguageModelOutputVar], ABC):@@ -179,6 +203,75 @@ class BaseLanguageModel(arbitrary_types_allowed=True,)+ def model_post_init(self, _context: Any, /) -> None:+ """Pydantic V2 lifecycle hook called automatically after `__init__`.++ Seeds `metadata["versions"]` with the installed `langchain-core`+ (and `langchain`, if installed) versions so that every LLM trace+ carries the package versions that produced it.++ Partner packages should **not** override this method. Instead, they+ should define a `@model_validator(mode="after")` that calls+ `_add_version` to append their own version to the same dict.++ !!! warning "Validator naming"++ Each subclass's validator **must** have a unique name. Pydantic+ replaces β rather than chains β same-named `model_validator` methods+ in child classes. For example, a `BaseChatOpenAI` subclass should+ use `_set_<partner>_version`, not `_set_version`, to avoid silently+ dropping the parent's entry.++ Args:+ _context: Pydantic validation context (typically `None`).+ """+ super().model_post_init(_context)+ from langchain_core.version import VERSION # noqa: PLC0415++ self._add_version("langchain-core", VERSION)++ langchain_version = _get_langchain_version()+ if langchain_version is not None:+ self._add_version("langchain", langchain_version)++ def _add_version(self, pkg: str, version: str) -> None:+ """Record a package version in `metadata.versions` for tracing.++ Each layer in the class hierarchy (core -> langchain -> partner)+ calls this so that the resulting metadata dict accumulates *all*+ package versions involved in an invocation.++ Example resulting metadata:++ ```python+ {+ "versions": {+ "langchain-core": "1.x.x",+ "langchain": "1.x.x",+ "langchain-openai": "1.x.x",+ }+ }+ ```++ Args:+ pkg: Package name (e.g., `'langchain-openai'`).+ version: Installed version string.+ """+ if self.metadata is None:+ self.metadata = {}+ existing = self.metadata.get("versions")+ if existing is not None and not isinstance(existing, Mapping):+ warnings.warn(+ f"metadata['versions'] expected a dict, got "+ f"{type(existing).__name__}; overwriting with package version dict",+ stacklevel=2,+ )+ existing = None+ self.metadata["versions"] = {+ **(existing if isinstance(existing, Mapping) else {}),+ pkg: version,+ }+@field_validator("verbose", mode="before")def set_verbose(cls, verbose: bool | None) -> bool: # noqa: FBT001"""If verbose is `None`, set it.diff --git a/libs/core/langchain_core/runnables/config.py b/libs/core/langchain_core/runnables/config.pyindex d94d049fc5..0bb18f002f 100644--- a/libs/core/langchain_core/runnables/config.py+++ b/libs/core/langchain_core/runnables/config.py@@ -7,7 +7,15 @@ import asyncio# Cannot move uuid to TYPE_CHECKING as RunnableConfig is used in Pydantic modelsimport uuid # noqa: TC003import warnings-from collections.abc import Awaitable, Callable, Generator, Iterable, Iterator, Sequence+from collections.abc import (+ Awaitable,+ Callable,+ Generator,+ Iterable,+ Iterator,+ Mapping,+ Sequence,+)from concurrent.futures import Executor, Future, ThreadPoolExecutorfrom contextlib import contextmanagerfrom contextvars import Context, ContextVar, Token, copy_context@@ -388,6 +396,50 @@ def patch_config(return config+def _merge_metadata_dicts(+ base: Mapping[str, Any], incoming: Mapping[str, Any]+) -> dict[str, Any]:+ """Merge two metadata dicts one level deep (not a recursive deep merge).++ If both sides have a `Mapping` value for the same key, the inner mappings+ are merged (last-writer-wins within). Non-mapping values use+ last-writer-wins at the top level. Only one level of depth is merged; values+ nested more deeply are not recursively merged.++ Args:+ base: The base metadata dict.++ Values here are kept unless overridden by `incoming`.+ incoming: The metadata dict to merge on top.++ Its values take precedence on conflict.++ Returns:+ A new merged dict.++ Inputs are not mutated. The returned dict performs shallow copies at+ the top level and one level deep; mutable values nested beyond that+ depth are shared references with the originals.+ """+ merged = {**base}+ for key, value in incoming.items():+ if (+ key in merged+ and isinstance(merged[key], Mapping)+ and isinstance(value, Mapping)+ ):+ merged[key] = {**merged[key], **value}+ elif isinstance(value, Mapping):+ merged[key] = {**value}+ else:+ merged[key] = value+ # Ensure non-overlapping nested mappings are also copies, not shared refs.+ for key in base:+ if key not in incoming and isinstance(merged[key], Mapping):+ merged[key] = {**merged[key]}+ return merged++def merge_configs(*configs: RunnableConfig | None) -> RunnableConfig:"""Merge multiple configs into one.@@ -403,10 +455,10 @@ def merge_configs(*configs: RunnableConfig | None) -> RunnableConfig:for config in (ensure_config(c) for c in configs if c is not None):for key in config:if key == "metadata":- base["metadata"] = {- **base.get("metadata", {}),- **(config.get("metadata") or {}),- }+ base["metadata"] = _merge_metadata_dicts(+ base.get("metadata", {}),+ config.get("metadata") or {},+ )elif key == "tags":base["tags"] = sorted(set(base.get("tags", []) + (config.get("tags") or [])),diff --git a/libs/core/tests/unit_tests/language_models/chat_models/test_base.py b/libs/core/tests/unit_tests/language_models/chat_models/test_base.pyindex 68f401501a..eb8b4a20aa 100644--- a/libs/core/tests/unit_tests/language_models/chat_models/test_base.py+++ b/libs/core/tests/unit_tests/language_models/chat_models/test_base.py@@ -4,6 +4,7 @@ import uuidimport warningsfrom collections.abc import AsyncIterator, Iteratorfrom contextlib import contextmanager+from importlib.metadata import PackageNotFoundErrorfrom typing import TYPE_CHECKING, Any, Literal, get_type_hintsfrom unittest.mock import patch@@ -27,6 +28,7 @@ from langchain_core.language_models._utils import (_filter_invocation_params_for_tracing,_normalize_messages,)+from langchain_core.language_models.base import _get_langchain_versionfrom langchain_core.language_models.chat_models import (SimpleChatModel,_generate_response_from_error,@@ -52,6 +54,7 @@ from langchain_core.tracers.context import collect_runsfrom langchain_core.tracers.event_stream import _AstreamEventsCallbackHandlerfrom langchain_core.tracers.langchain import LangChainTracerfrom langchain_core.tracers.schemas import Run+from langchain_core.version import VERSIONfrom tests.unit_tests.fake.callbacks import (BaseFakeCallbackHandler,FakeAsyncCallbackHandler,@@ -61,6 +64,7 @@ from tests.unit_tests.stubs import _any_id_ai_message, _any_id_ai_message_chunkif TYPE_CHECKING:from langchain_core.outputs.llm_result import LLMResult+ from langchain_core.runnables.config import RunnableConfigdef _content_blocks_equal_ignore_id(@@ -1305,6 +1309,187 @@ def test_get_ls_params() -> None:assert ls_params["ls_stop"] == ["stop"]+class _VersionedFakeModel(FakeListChatModel):+ """Fake model that adds a version via `_add_version`."""++ def model_post_init(self, _context: Any, /) -> None:+ super().model_post_init(_context)+ self._add_version("langchain-fake", "0.1.0")+++def test_user_versions_metadata_survives_merge() -> None:+ """User-provided versions metadata should be deep-merged with model versions.++ Regression test: the `add_metadata` deep-merge in `CallbackManager`+ must preserve both user-provided and model-provided versions dicts.+ """+ llm = _VersionedFakeModel(responses=["hello"])+ user_config: RunnableConfig = {"metadata": {"versions": {"my-app": "2.0"}}}++ with collect_runs() as cb:+ llm.invoke([HumanMessage(content="hi")], config=user_config)+ assert len(cb.traced_runs) == 1+ run_metadata = cb.traced_runs[0].extra["metadata"]+ assert "my-app" in run_metadata["versions"]+ assert run_metadata["versions"]["my-app"] == "2.0"+ assert "langchain-fake" in run_metadata["versions"]+ assert "langchain-core" in run_metadata["versions"]+++async def test_user_versions_metadata_survives_merge_async() -> None:+ """Async variant: user-provided versions metadata deep-merged with model's."""+ llm = _VersionedFakeModel(responses=["hello"])+ user_config: RunnableConfig = {"metadata": {"versions": {"my-app": "2.0"}}}++ with collect_runs() as cb:+ await llm.ainvoke([HumanMessage(content="hi")], config=user_config)+ assert len(cb.traced_runs) == 1+ run_metadata = cb.traced_runs[0].extra["metadata"]+ assert "my-app" in run_metadata["versions"]+ assert "langchain-fake" in run_metadata["versions"]+ assert "langchain-core" in run_metadata["versions"]+++def test_user_versions_metadata_survives_merge_stream() -> None:+ """Stream variant: user-provided versions metadata deep-merged with model's."""+ llm = _VersionedFakeModel(responses=["hello"])+ user_config: RunnableConfig = {"metadata": {"versions": {"my-app": "2.0"}}}++ with collect_runs() as cb:+ for _ in llm.stream([HumanMessage(content="hi")], config=user_config):+ pass+ assert len(cb.traced_runs) == 1+ run_metadata = cb.traced_runs[0].extra["metadata"]+ assert "my-app" in run_metadata["versions"]+ assert "langchain-fake" in run_metadata["versions"]+ assert "langchain-core" in run_metadata["versions"]+++async def test_user_versions_metadata_survives_merge_astream() -> None:+ """Async stream variant: user-provided versions metadata deep-merged."""+ llm = _VersionedFakeModel(responses=["hello"])+ user_config: RunnableConfig = {"metadata": {"versions": {"my-app": "2.0"}}}++ with collect_runs() as cb:+ async for _ in llm.astream([HumanMessage(content="hi")], config=user_config):+ pass+ assert len(cb.traced_runs) == 1+ run_metadata = cb.traced_runs[0].extra["metadata"]+ assert "my-app" in run_metadata["versions"]+ assert "langchain-fake" in run_metadata["versions"]+ assert "langchain-core" in run_metadata["versions"]+++def test_add_version_with_none_metadata() -> None:+ """Model constructed with metadata=None should still get versions."""+ llm = FakeListChatModel(responses=["x"], metadata=None)+ assert llm.metadata is not None+ assert "langchain-core" in llm.metadata["versions"]+++def test_add_version_with_non_dict_versions() -> None:+ """Non-dict `versions` value is silently replaced with a warning."""+ with warnings.catch_warnings(record=True) as w:+ warnings.simplefilter("always")+ llm = FakeListChatModel(responses=["x"], metadata={"versions": "garbage"})+ assert any("expected a dict" in str(warning.message) for warning in w)+ assert llm.metadata is not None+ assert isinstance(llm.metadata["versions"], dict)+ assert "langchain-core" in llm.metadata["versions"]+++def test_langchain_version_in_metadata(monkeypatch: pytest.MonkeyPatch) -> None:+ """When `langchain` is installed, its version appears in metadata."""++ def _fake_version(pkg: str) -> str:+ if pkg == "langchain":+ return "1.2.13"+ raise PackageNotFoundError(pkg)++ monkeypatch.setattr("importlib.metadata.version", _fake_version)+ _get_langchain_version.cache_clear()+ try:+ llm = FakeListChatModel(responses=["x"])+ assert llm.metadata is not None+ assert llm.metadata["versions"]["langchain"] == "1.2.13"+ assert "langchain-core" in llm.metadata["versions"]+ finally:+ _get_langchain_version.cache_clear()+++def test_langchain_version_missing_when_not_installed(+ monkeypatch: pytest.MonkeyPatch,+) -> None:+ """When `langchain` is not installed, metadata.versions has no entry.++ The lookup raises `PackageNotFoundError` (the real not-installed signal), which+ `_get_langchain_version` must swallow without dropping the rest of the dict.+ """++ def _raise_not_found(pkg: str) -> str:+ raise PackageNotFoundError(pkg)++ monkeypatch.setattr("importlib.metadata.version", _raise_not_found)+ _get_langchain_version.cache_clear()+ try:+ llm = FakeListChatModel(responses=["x"])+ assert llm.metadata is not None+ assert "langchain" not in llm.metadata["versions"]+ assert "langchain-core" in llm.metadata["versions"]+ finally:+ _get_langchain_version.cache_clear()+++def test_version_validator_coexists_with_core_seed() -> None:+ """A `model_validator(mode="after")` calling `_add_version` keeps the core seed.++ Mirrors the real partner pattern (a validator, not a `model_post_init`+ override) and confirms the validator-added entry and the core-seeded+ `langchain-core` entry accumulate rather than clobber one another.+ """++ class _ValidatorVersionedModel(FakeListChatModel):+ @model_validator(mode="after")+ def _set_fake_version(self) -> Self:+ self._add_version("langchain-fake", "0.1.0")+ return self++ llm = _ValidatorVersionedModel(responses=["x"])+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert versions["langchain-core"] == VERSION+ assert versions["langchain-fake"] == "0.1.0"+++def test_subclass_unique_validator_names_accumulate() -> None:+ """Parent and child uniquely-named validators must both contribute entries.++ Regression guard for the documented Pydantic footgun: same-named+ `model_validator` methods *replace* rather than chain across a class+ hierarchy. As long as each layer uses a unique validator name, a subclass+ must not silently drop its parent's version entry.+ """++ class _ParentModel(FakeListChatModel):+ @model_validator(mode="after")+ def _set_parent_version(self) -> Self:+ self._add_version("langchain-parent", "1.0.0")+ return self++ class _ChildModel(_ParentModel):+ @model_validator(mode="after")+ def _set_child_version(self) -> Self:+ self._add_version("langchain-child", "2.0.0")+ return self++ llm = _ChildModel(responses=["x"])+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert versions["langchain-core"] == VERSION+ assert versions["langchain-parent"] == "1.0.0"+ assert versions["langchain-child"] == "2.0.0"++def test_model_profiles() -> None:model = GenericFakeChatModel(messages=iter([]))assert model.profile is None@@ -1592,6 +1777,7 @@ def test_invocation_params_passed_to_tracer_metadata() -> None:"ls_temperature": 0.7,"stop": None,"temperature": 0.7,+ "versions": {"langchain-core": VERSION},},"options": {"stop": None},"runtime": run.extra["runtime"],diff --git a/libs/core/tests/unit_tests/runnables/__snapshots__/test_fallbacks.ambr b/libs/core/tests/unit_tests/runnables/__snapshots__/test_fallbacks.ambrindex a5e3dd8231..b92bcbb420 100644--- a/libs/core/tests/unit_tests/runnables/__snapshots__/test_fallbacks.ambr+++ b/libs/core/tests/unit_tests/runnables/__snapshots__/test_fallbacks.ambr@@ -84,7 +84,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['foo'], i=1)",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'], i=1)","name": "FakeListLLM"}},@@ -128,7 +128,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['bar'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['bar'])","name": "FakeListLLM"}},@@ -268,7 +268,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['foo'], i=1)",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'], i=1)","name": "FakeListLLM"},"fallbacks": [@@ -281,7 +281,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['bar'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['bar'])","name": "FakeListLLM"}],@@ -322,7 +322,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['foo'], i=1)",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'], i=1)","name": "FakeListLLM"},"fallbacks": [@@ -335,7 +335,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['baz'], i=1)",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['baz'], i=1)","name": "FakeListLLM"},{@@ -347,7 +347,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['bar'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['bar'])","name": "FakeListLLM"}],diff --git a/libs/core/tests/unit_tests/runnables/__snapshots__/test_runnable.ambr b/libs/core/tests/unit_tests/runnables/__snapshots__/test_runnable.ambrindex 0f04a93366..1e3cbb5d21 100644--- a/libs/core/tests/unit_tests/runnables/__snapshots__/test_runnable.ambr+++ b/libs/core/tests/unit_tests/runnables/__snapshots__/test_runnable.ambr@@ -97,7 +97,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo, bar'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo, bar'])","name": "FakeListChatModel"}],@@ -227,7 +227,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['baz, qux'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['baz, qux'])","name": "FakeListChatModel"}],@@ -346,7 +346,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo, bar'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo, bar'])","name": "FakeListChatModel"},{@@ -457,7 +457,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['baz, qux'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['baz, qux'])","name": "FakeListChatModel"}],@@ -848,7 +848,7 @@"fake","FakeStreamingListLLM"],- "repr": "FakeStreamingListLLM(responses=['first item, second item, third item'])",+ "repr": "FakeStreamingListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['first item, second item, third item'])","name": "FakeStreamingListLLM"},{@@ -884,7 +884,7 @@"fake","FakeStreamingListLLM"],- "repr": "FakeStreamingListLLM(responses=['this', 'is', 'a', 'test'])",+ "repr": "FakeStreamingListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['this', 'is', 'a', 'test'])","name": "FakeStreamingListLLM"}},@@ -1009,7 +1009,7 @@# name: test_prompt_with_chat_model'''ChatPromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, messages=[SystemMessagePromptTemplate(prompt=PromptTemplate(input_variables=[], input_types={}, partial_variables={}, template='You are a nice assistant.'), additional_kwargs={}), HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, template='{question}'), additional_kwargs={})])- | FakeListChatModel(responses=['foo'])+ | FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'])'''# ---# name: test_prompt_with_chat_model.1@@ -1109,7 +1109,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'])","name": "FakeListChatModel"}},@@ -1220,7 +1220,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo, bar'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo, bar'])","name": "FakeListChatModel"}],@@ -1249,7 +1249,7 @@# name: test_prompt_with_chat_model_async'''ChatPromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, messages=[SystemMessagePromptTemplate(prompt=PromptTemplate(input_variables=[], input_types={}, partial_variables={}, template='You are a nice assistant.'), additional_kwargs={}), HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, template='{question}'), additional_kwargs={})])- | FakeListChatModel(responses=['foo'])+ | FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'])'''# ---# name: test_prompt_with_chat_model_async.1@@ -1349,7 +1349,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo'])","name": "FakeListChatModel"}},@@ -1459,7 +1459,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['foo', 'bar'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo', 'bar'])","name": "FakeListLLM"}},@@ -1576,7 +1576,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['foo', 'bar'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo', 'bar'])","name": "FakeListLLM"}],@@ -1699,7 +1699,7 @@"fake","FakeStreamingListLLM"],- "repr": "FakeStreamingListLLM(responses=['bear, dog, cat', 'tomato, lettuce, onion'])",+ "repr": "FakeStreamingListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['bear, dog, cat', 'tomato, lettuce, onion'])","name": "FakeStreamingListLLM"}],@@ -1867,7 +1867,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['4'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['4'])","name": "FakeListLLM"}},@@ -1940,7 +1940,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=['2'])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['2'])","name": "FakeListLLM"}},@@ -13407,7 +13407,7 @@just_to_test_lambda: RunnableLambda(...)}| ChatPromptTemplate(input_variables=['documents', 'question'], input_types={}, partial_variables={}, messages=[SystemMessagePromptTemplate(prompt=PromptTemplate(input_variables=[], input_types={}, partial_variables={}, template='You are a nice assistant.'), additional_kwargs={}), HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['documents', 'question'], input_types={}, partial_variables={}, template='Context:\n{documents}\n\nQuestion:\n{question}'), additional_kwargs={})])- | FakeListChatModel(responses=['foo, bar'])+ | FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo, bar'])| CommaSeparatedListOutputParser()'''# ---@@ -13610,7 +13610,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=['foo, bar'])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=['foo, bar'])","name": "FakeListChatModel"}],@@ -13636,8 +13636,8 @@ChatPromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, messages=[SystemMessagePromptTemplate(prompt=PromptTemplate(input_variables=[], input_types={}, partial_variables={}, template='You are a nice assistant.'), additional_kwargs={}), HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['question'], input_types={}, partial_variables={}, template='{question}'), additional_kwargs={})])| RunnableLambda(...)| {- chat: FakeListChatModel(responses=["i'm a chatbot"]),- llm: FakeListLLM(responses=["i'm a textbot"])+ chat: FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=["i'm a chatbot"]),+ llm: FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=["i'm a textbot"])}'''# ---@@ -13762,7 +13762,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=[\"i'm a chatbot\"])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=[\"i'm a chatbot\"])","name": "FakeListChatModel"},"llm": {@@ -13774,7 +13774,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=[\"i'm a textbot\"])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=[\"i'm a textbot\"])","name": "FakeListLLM"}}@@ -13917,7 +13917,7 @@"fake_chat_models","FakeListChatModel"],- "repr": "FakeListChatModel(responses=[\"i'm a chatbot\"])",+ "repr": "FakeListChatModel(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=[\"i'm a chatbot\"])","name": "FakeListChatModel"},"kwargs": {@@ -13938,7 +13938,7 @@"fake","FakeListLLM"],- "repr": "FakeListLLM(responses=[\"i'm a textbot\"])",+ "repr": "FakeListLLM(metadata={'versions': {'langchain-core': '1.4.5'}}, responses=[\"i'm a textbot\"])","name": "FakeListLLM"},"passthrough": {diff --git a/libs/core/tests/unit_tests/runnables/test_config.py b/libs/core/tests/unit_tests/runnables/test_config.pyindex 5b639111d9..00be7137c0 100644--- a/libs/core/tests/unit_tests/runnables/test_config.py+++ b/libs/core/tests/unit_tests/runnables/test_config.py@@ -17,6 +17,7 @@ from langchain_core.runnables import RunnableBinding, RunnablePassthroughfrom langchain_core.runnables.config import (RunnableConfig,_get_langsmith_inheritable_metadata_from_config,+ _merge_metadata_dicts,_set_config_context,ensure_config,merge_configs,@@ -322,3 +323,90 @@ async def test_run_in_executor() -> None:with pytest.raises(RuntimeError):await run_in_executor(None, raises_stop_iter)+++class TestMergeMetadataDicts:+ """Tests for _merge_metadata_dicts deep-merge behavior."""++ def test_deep_merge_preserves_both_nested_dicts(self) -> None:+ base = {"versions": {"langchain-core": "0.3.1"}, "user_id": "abc"}+ incoming = {"versions": {"langchain-anthropic": "1.3.3"}, "run": "x"}+ result = _merge_metadata_dicts(base, incoming)+ assert result == {+ "versions": {+ "langchain-core": "0.3.1",+ "langchain-anthropic": "1.3.3",+ },+ "user_id": "abc",+ "run": "x",+ }++ def test_last_writer_wins_within_nested_dicts(self) -> None:+ base = {"versions": {"pkg": "1.0"}}+ incoming = {"versions": {"pkg": "2.0"}}+ result = _merge_metadata_dicts(base, incoming)+ assert result == {"versions": {"pkg": "2.0"}}++ def test_non_dict_overwrites_dict(self) -> None:+ base = {"key": {"nested": "value"}}+ incoming = {"key": "flat"}+ result = _merge_metadata_dicts(base, incoming)+ assert result == {"key": "flat"}++ def test_dict_overwrites_non_dict(self) -> None:+ base = {"key": "flat"}+ incoming = {"key": {"nested": "value"}}+ result = _merge_metadata_dicts(base, incoming)+ assert result == {"key": {"nested": "value"}}++ def test_no_mutation_of_inputs(self) -> None:+ base = {"versions": {"a": "1"}}+ incoming = {"versions": {"b": "2"}}+ base_copy = {"versions": {"a": "1"}}+ incoming_copy = {"versions": {"b": "2"}}+ result = _merge_metadata_dicts(base, incoming)+ assert base == base_copy+ assert incoming == incoming_copy+ # Returned nested dicts should not share identity with originals.+ assert result["versions"] is not base["versions"]+ assert result["versions"] is not incoming["versions"]++ def test_non_overlapping_nested_dict_is_copied(self) -> None:+ base = {"versions": {"a": "1"}, "extras": {"x": "y"}}+ incoming = {"versions": {"b": "2"}}+ result = _merge_metadata_dicts(base, incoming)+ # "extras" was not in incoming β result should still be a copy.+ assert result["extras"] is not base["extras"]+ assert result["extras"] == {"x": "y"}++ def test_both_empty(self) -> None:+ assert _merge_metadata_dicts({}, {}) == {}++ def test_empty_base(self) -> None:+ incoming = {"versions": {"pkg": "1.0"}}+ result = _merge_metadata_dicts({}, incoming)+ assert result == {"versions": {"pkg": "1.0"}}+ assert result["versions"] is not incoming["versions"]++ result["versions"]["new"] = "2.0"+ assert incoming == {"versions": {"pkg": "1.0"}}++ def test_empty_incoming(self) -> None:+ result = _merge_metadata_dicts({"versions": {"pkg": "1.0"}}, {})+ assert result == {"versions": {"pkg": "1.0"}}++ def test_merge_configs_with_none_metadata(self) -> None:+ merged = merge_configs(+ cast("RunnableConfig", {"metadata": None}),+ {"metadata": {"versions": {"a": "1"}}},+ )+ assert merged["metadata"] == {"versions": {"a": "1"}}++ def test_three_config_merge_accumulates(self) -> None:+ c1: RunnableConfig = {"metadata": {"versions": {"a": "1"}}}+ c2: RunnableConfig = {"metadata": {"versions": {"b": "2"}}}+ c3: RunnableConfig = {"metadata": {"versions": {"c": "3"}}}+ merged = merge_configs(c1, c2, c3)+ assert merged["metadata"] == {+ "versions": {"a": "1", "b": "2", "c": "3"},+ }diff --git a/libs/core/tests/unit_tests/runnables/test_runnable.py b/libs/core/tests/unit_tests/runnables/test_runnable.pyindex 25da4d3b15..f07a3aa3d5 100644--- a/libs/core/tests/unit_tests/runnables/test_runnable.py+++ b/libs/core/tests/unit_tests/runnables/test_runnable.py@@ -91,6 +91,7 @@ from langchain_core.tracers import (from langchain_core.tracers._compat import pydantic_copyfrom langchain_core.tracers.context import collect_runsfrom langchain_core.utils.pydantic import PYDANTIC_VERSION+from langchain_core.version import VERSIONfrom tests.unit_tests.pydantic_utils import _normalize_schema, _schemafrom tests.unit_tests.stubs import AnyStr, _any_id_ai_message, _any_id_ai_message_chunk@@ -2147,7 +2148,11 @@ async def test_prompt_with_llm("value": {"end_time": None,"final_output": None,- "metadata": {"ls_model_type": "llm", "ls_provider": "fakelist"},+ "metadata": {+ "ls_model_type": "llm",+ "ls_provider": "fakelist",+ "versions": {"langchain-core": VERSION},+ },"name": "FakeListLLM","start_time": "2023-01-01T00:00:00.000+00:00","streamed_output": [],@@ -2361,6 +2366,7 @@ async def test_prompt_with_llm_parser("metadata": {"ls_model_type": "llm","ls_provider": "fakestreaminglist",+ "versions": {"langchain-core": VERSION},},"name": "FakeStreamingListLLM","start_time": "2023-01-01T00:00:00.000+00:00",diff --git a/libs/partners/anthropic/langchain_anthropic/chat_models.py b/libs/partners/anthropic/langchain_anthropic/chat_models.pyindex f706374d7f..c11143f2ac 100644--- a/libs/partners/anthropic/langchain_anthropic/chat_models.py+++ b/libs/partners/anthropic/langchain_anthropic/chat_models.py@@ -56,7 +56,7 @@ from langchain_core.utils.function_calling import (from langchain_core.utils.pydantic import is_basemodel_subclassfrom langchain_core.utils.utils import _build_model_kwargsfrom pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validator-from typing_extensions import NotRequired, TypedDict+from typing_extensions import NotRequired, Self, TypedDictfrom langchain_anthropic import __version__from langchain_anthropic._client_utils import (@@ -1168,6 +1168,12 @@ class ChatAnthropic(BaseChatModel):all_required_field_names = get_pydantic_field_names(cls)return _build_model_kwargs(values, all_required_field_names)+ @model_validator(mode="after")+ def _set_anthropic_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-anthropic", __version__)+ return self+def _resolve_model_profile(self) -> ModelProfile | None:profile = _get_default_model_profile(self.model) or Noneif profile is not None and self.betas and "context-1m-2025-08-07" in self.betas:diff --git a/libs/partners/anthropic/scripts/check_version.py b/libs/partners/anthropic/scripts/check_version.pyindex 163f31644d..fcfcf7dfe0 100644--- a/libs/partners/anthropic/scripts/check_version.py+++ b/libs/partners/anthropic/scripts/check_version.py@@ -2,7 +2,7 @@This script validates that the version defined in pyproject.toml matches the`__version__` variable in `langchain_anthropic/_version.py`. Intended for use as a-pre-commit hook to prevent version mismatches.+CI check to prevent version mismatches."""import rediff --git a/libs/partners/anthropic/tests/unit_tests/test_chat_models.py b/libs/partners/anthropic/tests/unit_tests/test_chat_models.pyindex 0ff727f4ba..175fc66f33 100644--- a/libs/partners/anthropic/tests/unit_tests/test_chat_models.py+++ b/libs/partners/anthropic/tests/unit_tests/test_chat_models.py@@ -23,6 +23,7 @@ from pydantic import BaseModel, Field, SecretStr, ValidationErrorfrom pytest import CaptureFixture, MonkeyPatchfrom langchain_anthropic import ChatAnthropic+from langchain_anthropic._version import __version__from langchain_anthropic.chat_models import (_TOOL_CALL_ID_PATTERN,_create_usage_metadata,@@ -2131,6 +2132,8 @@ def test_anthropic_model_params() -> None:"ls_max_tokens": 64000,"ls_temperature": None,}+ assert llm.metadata is not None+ assert llm.metadata["versions"]["langchain-anthropic"] == __version__ls_params = llm._get_ls_params(model=MODEL_NAME)assert ls_params.get("ls_model_name") == MODEL_NAMEdiff --git a/libs/partners/deepseek/Makefile b/libs/partners/deepseek/Makefileindex a57d25ef23..61077b82e1 100644--- a/libs/partners/deepseek/Makefile+++ b/libs/partners/deepseek/Makefile@@ -55,6 +55,9 @@ format format_diff:check_imports: $(shell find langchain_deepseek -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -62,6 +65,7 @@ check_imports: $(shell find langchain_deepseek -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/deepseek/langchain_deepseek/__init__.py b/libs/partners/deepseek/langchain_deepseek/__init__.pyindex 07fec72805..10ff61a5ad 100644--- a/libs/partners/deepseek/langchain_deepseek/__init__.py+++ b/libs/partners/deepseek/langchain_deepseek/__init__.py@@ -1,16 +1,8 @@"""LangChain DeepSeek integration."""-from importlib import metadata-+from langchain_deepseek._version import __version__from langchain_deepseek.chat_models import ChatDeepSeek-try:- __version__ = metadata.version(__package__)-except metadata.PackageNotFoundError:- # Case where package metadata is not available.- __version__ = ""-del metadata # optional, avoids polluting the results of dir(__package__)-__all__ = ["ChatDeepSeek","__version__",diff --git a/libs/partners/deepseek/langchain_deepseek/_version.py b/libs/partners/deepseek/langchain_deepseek/_version.pynew file mode 100644index 0000000000..685ec56596--- /dev/null+++ b/libs/partners/deepseek/langchain_deepseek/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-deepseek`."""++__version__ = "1.1.0"diff --git a/libs/partners/deepseek/langchain_deepseek/chat_models.py b/libs/partners/deepseek/langchain_deepseek/chat_models.pyindex a56df1474b..91596fb9f0 100644--- a/libs/partners/deepseek/langchain_deepseek/chat_models.py+++ b/libs/partners/deepseek/langchain_deepseek/chat_models.py@@ -27,6 +27,7 @@ from langchain_openai.chat_models.base import BaseChatOpenAIfrom pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_deepseek._version import __version__from langchain_deepseek.data._profiles import _PROFILESDEFAULT_API_BASE = "https://api.deepseek.com/v1"@@ -224,6 +225,16 @@ class ChatDeepSeek(BaseChatOpenAI):ls_params["ls_provider"] = "deepseek"return ls_params+ @model_validator(mode="after")+ def _set_deepseek_version(self) -> Self:+ """Set package version in metadata.++ Named uniquely to avoid shadowing `BaseChatOpenAI._set_openai_chat_version`;+ Pydantic replaces same-named validators rather than chaining them.+ """+ self._add_version("langchain-deepseek", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate necessary environment vars and client params."""diff --git a/libs/partners/deepseek/scripts/check_version.py b/libs/partners/deepseek/scripts/check_version.pynew file mode 100644index 0000000000..9575625f3b--- /dev/null+++ b/libs/partners/deepseek/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_deepseek/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_deepseek" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_deepseek/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_deepseek/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/deepseek/tests/unit_tests/test_chat_models.py b/libs/partners/deepseek/tests/unit_tests/test_chat_models.pyindex db45da4009..a17f60d67d 100644--- a/libs/partners/deepseek/tests/unit_tests/test_chat_models.py+++ b/libs/partners/deepseek/tests/unit_tests/test_chat_models.py@@ -437,3 +437,13 @@ def test_profile() -> None:model = ChatDeepSeek(model="deepseek-reasoner", api_key=SecretStr("test_key"))assert model.profile is not Noneassert model.profile["reasoning_output"]+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatDeepSeek(model=MODEL_NAME, api_key=SecretStr("test_key"))+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-deepseek" in versions+ assert "langchain-openai" in versionsdiff --git a/libs/partners/deepseek/tests/unit_tests/test_imports.py b/libs/partners/deepseek/tests/unit_tests/test_imports.pynew file mode 100644index 0000000000..a7c9b2f3fd--- /dev/null+++ b/libs/partners/deepseek/tests/unit_tests/test_imports.py@@ -0,0 +1,10 @@+"""Test `langchain_deepseek` public API surface."""++from langchain_deepseek import __all__++EXPECTED_ALL = ["__version__", "ChatDeepSeek"]+++def test_all_imports() -> None:+ """Verify that `__all__` exports match the expected public API."""+ assert sorted(EXPECTED_ALL) == sorted(__all__)diff --git a/libs/partners/fireworks/Makefile b/libs/partners/fireworks/Makefileindex 2c41629412..12462f52d9 100644--- a/libs/partners/fireworks/Makefile+++ b/libs/partners/fireworks/Makefile@@ -53,6 +53,9 @@ format format_diff:check_imports: $(shell find langchain_fireworks -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -60,6 +63,7 @@ check_imports: $(shell find langchain_fireworks -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/fireworks/langchain_fireworks/__init__.py b/libs/partners/fireworks/langchain_fireworks/__init__.pyindex 27fdaaee4c..a8608eb0ca 100644--- a/libs/partners/fireworks/langchain_fireworks/__init__.py+++ b/libs/partners/fireworks/langchain_fireworks/__init__.py@@ -1,9 +1,9 @@"""Fireworks AI integration for LangChain."""+from langchain_fireworks._version import __version__from langchain_fireworks.chat_models import ChatFireworksfrom langchain_fireworks.embeddings import FireworksEmbeddingsfrom langchain_fireworks.llms import Fireworks-from langchain_fireworks.version import __version____all__ = ["ChatFireworks",diff --git a/libs/partners/fireworks/langchain_fireworks/_version.py b/libs/partners/fireworks/langchain_fireworks/_version.pynew file mode 100644index 0000000000..0b16a671ed--- /dev/null+++ b/libs/partners/fireworks/langchain_fireworks/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-fireworks`."""++__version__ = "1.4.2"diff --git a/libs/partners/fireworks/langchain_fireworks/chat_models.py b/libs/partners/fireworks/langchain_fireworks/chat_models.pyindex ee2fef10cc..79440a6af7 100644--- a/libs/partners/fireworks/langchain_fireworks/chat_models.py+++ b/libs/partners/fireworks/langchain_fireworks/chat_models.py@@ -100,6 +100,7 @@ from pydantic import (from typing_extensions import Selffrom langchain_fireworks._compat import _convert_from_v1_to_chat_completions+from langchain_fireworks._version import __version__from langchain_fireworks.data._profiles import _PROFILESlogger = logging.getLogger(__name__)@@ -827,6 +828,12 @@ class ChatFireworks(BaseChatModel):all_required_field_names = get_pydantic_field_names(cls)return _build_model_kwargs(values, all_required_field_names)+ @model_validator(mode="after")+ def _set_fireworks_chat_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-fireworks", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that api key and python package exists in environment."""diff --git a/libs/partners/fireworks/langchain_fireworks/llms.py b/libs/partners/fireworks/langchain_fireworks/llms.pyindex 00e76ed6de..02ca864c2b 100644--- a/libs/partners/fireworks/langchain_fireworks/llms.py+++ b/libs/partners/fireworks/langchain_fireworks/llms.py@@ -15,8 +15,9 @@ from langchain_core.language_models.llms import LLMfrom langchain_core.utils import get_pydantic_field_namesfrom langchain_core.utils.utils import _build_model_kwargs, secret_from_envfrom pydantic import ConfigDict, Field, SecretStr, model_validator+from typing_extensions import Self-from langchain_fireworks.version import __version__+from langchain_fireworks._version import __version__logger = logging.getLogger(__name__)@@ -98,6 +99,12 @@ class Fireworks(LLM):all_required_field_names = get_pydantic_field_names(cls)return _build_model_kwargs(values, all_required_field_names)+ @model_validator(mode="after")+ def _set_fireworks_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-fireworks", __version__)+ return self+@propertydef _llm_type(self) -> str:"""Return type of model."""diff --git a/libs/partners/fireworks/langchain_fireworks/version.py b/libs/partners/fireworks/langchain_fireworks/version.pyindex 8d54cafc7e..5dd40a8cde 100644--- a/libs/partners/fireworks/langchain_fireworks/version.py+++ b/libs/partners/fireworks/langchain_fireworks/version.py@@ -1,9 +1,3 @@-"""Main entrypoint into package."""+"""Backwards-compatible re-export from `langchain_fireworks._version`."""-from importlib import metadata--try:- __version__ = metadata.version(__package__)-except metadata.PackageNotFoundError:- # Case where package metadata is not available.- __version__ = ""+from langchain_fireworks._version import __version__ # noqa: F401diff --git a/libs/partners/fireworks/scripts/check_version.py b/libs/partners/fireworks/scripts/check_version.pynew file mode 100644index 0000000000..0876e59c4c--- /dev/null+++ b/libs/partners/fireworks/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_fireworks/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_fireworks" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_fireworks/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_fireworks/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/fireworks/tests/unit_tests/test_chat_models.py b/libs/partners/fireworks/tests/unit_tests/test_chat_models.pyindex 0db2b230d9..80574e67dd 100644--- a/libs/partners/fireworks/tests/unit_tests/test_chat_models.py+++ b/libs/partners/fireworks/tests/unit_tests/test_chat_models.py@@ -2,6 +2,7 @@from __future__ import annotations+import osfrom typing import Anyfrom unittest.mock import MagicMock@@ -116,6 +117,16 @@ def test_convert_dict_to_message_without_reasoning_content() -> None:assert "reasoning_content" not in message.additional_kwargs+def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ os.environ.setdefault("FIREWORKS_API_KEY", "fake-key")+ llm = ChatFireworks(model="accounts/fireworks/models/llama-v3-70b-instruct")+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-fireworks" in versions++def test_format_message_content_passthrough_string() -> None:"""Plain string content is returned unchanged."""assert _format_message_content("hello") == "hello"diff --git a/libs/partners/groq/Makefile b/libs/partners/groq/Makefileindex c4df8ea33f..43d05e3628 100644--- a/libs/partners/groq/Makefile+++ b/libs/partners/groq/Makefile@@ -54,6 +54,9 @@ format format_diff:check_imports: $(shell find langchain_groq -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -61,6 +64,7 @@ check_imports: $(shell find langchain_groq -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/groq/langchain_groq/__init__.py b/libs/partners/groq/langchain_groq/__init__.pyindex 47336d474b..d4d01fc4c0 100644--- a/libs/partners/groq/langchain_groq/__init__.py+++ b/libs/partners/groq/langchain_groq/__init__.py@@ -1,6 +1,9 @@"""Groq integration for LangChain."""+from langchain_groq._version import __version__from langchain_groq.chat_models import ChatGroq-from langchain_groq.version import __version__-__all__ = ["ChatGroq", "__version__"]+__all__ = [+ "ChatGroq",+ "__version__",+]diff --git a/libs/partners/groq/langchain_groq/_version.py b/libs/partners/groq/langchain_groq/_version.pynew file mode 100644index 0000000000..6680704dda--- /dev/null+++ b/libs/partners/groq/langchain_groq/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-groq`."""++__version__ = "1.1.3"diff --git a/libs/partners/groq/langchain_groq/chat_models.py b/libs/partners/groq/langchain_groq/chat_models.pyindex 0ab2fa8a13..9cfaa31042 100644--- a/libs/partners/groq/langchain_groq/chat_models.py+++ b/libs/partners/groq/langchain_groq/chat_models.py@@ -71,8 +71,8 @@ from pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Selffrom langchain_groq._compat import _convert_from_v1_to_groq+from langchain_groq._version import __version__from langchain_groq.data._profiles import _PROFILES-from langchain_groq.version import __version___MODEL_PROFILES = cast("ModelProfileRegistry", _PROFILES)_STRICT_STRUCTURED_OUTPUT_MODELS = frozenset(@@ -543,6 +543,12 @@ class ChatGroq(BaseChatModel):raise ImportError(msg) from excreturn self+ @model_validator(mode="after")+ def _set_groq_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-groq", __version__)+ return self+def _resolve_model_profile(self) -> ModelProfile | None:return _get_default_model_profile(self.model_name) or Nonediff --git a/libs/partners/groq/langchain_groq/version.py b/libs/partners/groq/langchain_groq/version.pyindex 8d54cafc7e..3d228d77ba 100644--- a/libs/partners/groq/langchain_groq/version.py+++ b/libs/partners/groq/langchain_groq/version.py@@ -1,9 +1,3 @@-"""Main entrypoint into package."""+"""Backwards-compatible re-export from `langchain_groq._version`."""-from importlib import metadata--try:- __version__ = metadata.version(__package__)-except metadata.PackageNotFoundError:- # Case where package metadata is not available.- __version__ = ""+from langchain_groq._version import __version__ # noqa: F401diff --git a/libs/partners/groq/scripts/check_version.py b/libs/partners/groq/scripts/check_version.pynew file mode 100644index 0000000000..0bb1e32535--- /dev/null+++ b/libs/partners/groq/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_groq/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_groq" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_groq/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_groq/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/groq/tests/unit_tests/test_chat_models.py b/libs/partners/groq/tests/unit_tests/test_chat_models.pyindex 33f4448bd5..38fcf8dd60 100644--- a/libs/partners/groq/tests/unit_tests/test_chat_models.py+++ b/libs/partners/groq/tests/unit_tests/test_chat_models.py@@ -1095,3 +1095,12 @@ def test_format_message_content_mixed() -> None:{"type": "image_url", "image_url": {"url": "data:image/png;base64,<data>"}},]assert expected == _format_message_content(content)+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatGroq(model="foo") # type: ignore[call-arg]+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-groq" in versionsdiff --git a/libs/partners/huggingface/Makefile b/libs/partners/huggingface/Makefileindex 648e2460e5..c2b03cf4d2 100644--- a/libs/partners/huggingface/Makefile+++ b/libs/partners/huggingface/Makefile@@ -1,4 +1,4 @@-.PHONY: all format lint type test tests integration_tests help extended_tests+.PHONY: all format lint type test tests integration_tests help extended_tests check_version# Default target executed when no arguments are given to make.all: help@@ -55,13 +55,17 @@ format format_diff:check_imports: $(shell find langchain_huggingface -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################help:@echo '----'- @echo 'check_imports - check imports'+ @echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/huggingface/langchain_huggingface/__init__.py b/libs/partners/huggingface/langchain_huggingface/__init__.pyindex a64efaa481..df7dbecaff 100644--- a/libs/partners/huggingface/langchain_huggingface/__init__.py+++ b/libs/partners/huggingface/langchain_huggingface/__init__.py@@ -1,5 +1,6 @@"""Hugging Face integration for LangChain."""+from langchain_huggingface._version import __version__from langchain_huggingface.chat_models import (ChatHuggingFace, # type: ignore[import-not-found])@@ -18,4 +19,5 @@ __all__ = ["HuggingFaceEndpoint","HuggingFaceEndpointEmbeddings","HuggingFacePipeline",+ "__version__",]diff --git a/libs/partners/huggingface/langchain_huggingface/_version.py b/libs/partners/huggingface/langchain_huggingface/_version.pynew file mode 100644index 0000000000..a9914fed92--- /dev/null+++ b/libs/partners/huggingface/langchain_huggingface/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-huggingface`."""++__version__ = "1.2.2"diff --git a/libs/partners/huggingface/langchain_huggingface/chat_models/huggingface.py b/libs/partners/huggingface/langchain_huggingface/chat_models/huggingface.pyindex 52e9df5d34..22fc0a004f 100644--- a/libs/partners/huggingface/langchain_huggingface/chat_models/huggingface.py+++ b/libs/partners/huggingface/langchain_huggingface/chat_models/huggingface.py@@ -69,6 +69,7 @@ from langchain_core.utils.pydantic import is_basemodel_subclassfrom pydantic import BaseModel, Field, model_validatorfrom typing_extensions import Self+from langchain_huggingface._version import __version__from langchain_huggingface.data._profiles import _PROFILESfrom langchain_huggingface.llms.huggingface_endpoint import HuggingFaceEndpointfrom langchain_huggingface.llms.huggingface_pipeline import HuggingFacePipeline@@ -580,6 +581,12 @@ class ChatHuggingFace(BaseChatModel):):self.model_kwargs = self.llm.model_kwargs.copy()+ @model_validator(mode="after")+ def _set_huggingface_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-huggingface", __version__)+ return self+@model_validator(mode="after")def validate_llm(self) -> Self:if (diff --git a/libs/partners/huggingface/langchain_huggingface/llms/huggingface_endpoint.py b/libs/partners/huggingface/langchain_huggingface/llms/huggingface_endpoint.pyindex a3a15b1c67..92c14bb18d 100644--- a/libs/partners/huggingface/langchain_huggingface/llms/huggingface_endpoint.py+++ b/libs/partners/huggingface/langchain_huggingface/llms/huggingface_endpoint.py@@ -17,6 +17,8 @@ from langchain_core.utils import from_env, get_pydantic_field_namesfrom pydantic import ConfigDict, Field, model_validatorfrom typing_extensions import Self+from langchain_huggingface._version import __version__+logger = logging.getLogger(__name__)@@ -249,6 +251,12 @@ class HuggingFaceEndpoint(LLM):raise ValueError(msg)return values+ @model_validator(mode="after")+ def _set_huggingface_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-huggingface", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that package is installed and that the API token is valid."""diff --git a/libs/partners/huggingface/langchain_huggingface/llms/huggingface_pipeline.py b/libs/partners/huggingface/langchain_huggingface/llms/huggingface_pipeline.pyindex ba646f1309..c710997613 100644--- a/libs/partners/huggingface/langchain_huggingface/llms/huggingface_pipeline.py+++ b/libs/partners/huggingface/langchain_huggingface/llms/huggingface_pipeline.py@@ -9,7 +9,9 @@ from langchain_core.callbacks import CallbackManagerForLLMRunfrom langchain_core.language_models.llms import BaseLLMfrom langchain_core.outputs import Generation, GenerationChunk, LLMResultfrom pydantic import ConfigDict, model_validator+from typing_extensions import Self+from langchain_huggingface._version import __version__from langchain_huggingface.utils.import_utils import (IMPORT_ERROR,is_ipex_available,@@ -91,6 +93,12 @@ class HuggingFacePipeline(BaseLLM):extra="forbid",)+ @model_validator(mode="after")+ def _set_huggingface_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-huggingface", __version__)+ return self+@model_validator(mode="before")@classmethoddef pre_init_validator(cls, values: dict[str, Any]) -> dict[str, Any]:diff --git a/libs/partners/huggingface/scripts/check_version.py b/libs/partners/huggingface/scripts/check_version.pynew file mode 100644index 0000000000..8c598b7e94--- /dev/null+++ b/libs/partners/huggingface/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_huggingface/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_huggingface" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_huggingface/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_huggingface/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/huggingface/tests/unit_tests/test_chat_models.py b/libs/partners/huggingface/tests/unit_tests/test_chat_models.pyindex c6de805e98..47ff8e3846 100644--- a/libs/partners/huggingface/tests/unit_tests/test_chat_models.py+++ b/libs/partners/huggingface/tests/unit_tests/test_chat_models.py@@ -329,6 +329,17 @@ def test_inheritance_with_empty_llm() -> None:assert chat.temperature is None+def test_metadata_versions(chat_hugging_face: Any) -> None:+ """Test that metadata reports the correct version info."""+ from langchain_huggingface._version import __version__++ assert chat_hugging_face.metadata is not None+ versions = chat_hugging_face.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-huggingface" in versions+ assert versions["langchain-huggingface"] == __version__++def test_profile() -> None:empty_llm = Mock(spec=HuggingFaceEndpoint)empty_llm.repo_id = "test/model"diff --git a/libs/partners/mistralai/Makefile b/libs/partners/mistralai/Makefileindex 97d56a39d5..d1dd17af90 100644--- a/libs/partners/mistralai/Makefile+++ b/libs/partners/mistralai/Makefile@@ -56,6 +56,9 @@ format format_diff:check_imports: $(shell find langchain_mistralai -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -63,6 +66,7 @@ check_imports: $(shell find langchain_mistralai -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/mistralai/langchain_mistralai/__init__.py b/libs/partners/mistralai/langchain_mistralai/__init__.pyindex 11fa44c371..16e77b85c8 100644--- a/libs/partners/mistralai/langchain_mistralai/__init__.py+++ b/libs/partners/mistralai/langchain_mistralai/__init__.py@@ -1,6 +1,11 @@"""Mistral AI integration for LangChain."""+from langchain_mistralai._version import __version__from langchain_mistralai.chat_models import ChatMistralAIfrom langchain_mistralai.embeddings import MistralAIEmbeddings-__all__ = ["ChatMistralAI", "MistralAIEmbeddings"]+__all__ = [+ "ChatMistralAI",+ "MistralAIEmbeddings",+ "__version__",+]diff --git a/libs/partners/mistralai/langchain_mistralai/_version.py b/libs/partners/mistralai/langchain_mistralai/_version.pynew file mode 100644index 0000000000..b450251c05--- /dev/null+++ b/libs/partners/mistralai/langchain_mistralai/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-mistralai`."""++__version__ = "1.1.5"diff --git a/libs/partners/mistralai/langchain_mistralai/chat_models.py b/libs/partners/mistralai/langchain_mistralai/chat_models.pyindex 615616d3c9..be86042beb 100644--- a/libs/partners/mistralai/langchain_mistralai/chat_models.py+++ b/libs/partners/mistralai/langchain_mistralai/chat_models.py@@ -78,6 +78,7 @@ from pydantic import (from typing_extensions import Selffrom langchain_mistralai._compat import _convert_from_v1_to_mistral+from langchain_mistralai._version import __version__from langchain_mistralai.data._profiles import _PROFILESif TYPE_CHECKING:@@ -661,6 +662,12 @@ class ChatMistralAI(BaseChatModel):overall_token_usage[k] = vreturn {"token_usage": overall_token_usage, "model_name": self.model}+ @model_validator(mode="after")+ def _set_mistralai_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-mistralai", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate api key, python package exists, temperature, and top_p."""diff --git a/libs/partners/mistralai/scripts/check_version.py b/libs/partners/mistralai/scripts/check_version.pynew file mode 100644index 0000000000..fed73474db--- /dev/null+++ b/libs/partners/mistralai/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_mistralai/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_mistralai" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_mistralai/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_mistralai/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/mistralai/tests/unit_tests/test_chat_models.py b/libs/partners/mistralai/tests/unit_tests/test_chat_models.pyindex 2ebc4f6b2b..c68eb8411f 100644--- a/libs/partners/mistralai/tests/unit_tests/test_chat_models.py+++ b/libs/partners/mistralai/tests/unit_tests/test_chat_models.py@@ -653,3 +653,12 @@ def test_no_duplicate_tool_calls_when_multiple_tools() -> None:def test_profile() -> None:model = ChatMistralAI(model="mistral-large-latest") # type: ignore[call-arg]assert model.profile+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatMistralAI(model="foo") # type: ignore[call-arg]+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-mistralai" in versionsdiff --git a/libs/partners/mistralai/tests/unit_tests/test_imports.py b/libs/partners/mistralai/tests/unit_tests/test_imports.pyindex 01c220d64c..63f4ec7f05 100644--- a/libs/partners/mistralai/tests/unit_tests/test_imports.py+++ b/libs/partners/mistralai/tests/unit_tests/test_imports.py@@ -1,6 +1,6 @@from langchain_mistralai import __all__-EXPECTED_ALL = ["ChatMistralAI", "MistralAIEmbeddings"]+EXPECTED_ALL = ["__version__", "ChatMistralAI", "MistralAIEmbeddings"]def test_all_imports() -> None:diff --git a/libs/partners/ollama/Makefile b/libs/partners/ollama/Makefileindex 4fa1cec6fc..6d4031f506 100644--- a/libs/partners/ollama/Makefile+++ b/libs/partners/ollama/Makefile@@ -60,6 +60,9 @@ format format_diff:check_imports: $(shell find langchain_ollama -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -67,6 +70,7 @@ check_imports: $(shell find langchain_ollama -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/ollama/langchain_ollama/__init__.py b/libs/partners/ollama/langchain_ollama/__init__.pyindex 84a267d23c..00cd8b9cf1 100644--- a/libs/partners/ollama/langchain_ollama/__init__.py+++ b/libs/partners/ollama/langchain_ollama/__init__.py@@ -2,39 +2,13 @@Provides infrastructure for interacting with the [Ollama](https://ollama.com/)service.--!!! note- **Newly added in 0.3.4:** `validate_model_on_init` param on all models.- This parameter allows you to validate the model exists in Ollama locally on- initialization. If set to `True`, it will raise an error if the model does not- exist locally. This is useful for ensuring that the model is available before- attempting to use it, especially in environments where models may not be- pre-downloaded.-"""-from importlib import metadata-from importlib.metadata import PackageNotFoundError-from typing import NoReturn-+from langchain_ollama._version import __version__from langchain_ollama.chat_models import ChatOllamafrom langchain_ollama.embeddings import OllamaEmbeddingsfrom langchain_ollama.llms import OllamaLLM--def _raise_package_not_found_error() -> NoReturn:- raise PackageNotFoundError---try:- if __package__ is None:- _raise_package_not_found_error()- __version__ = metadata.version(__package__)-except metadata.PackageNotFoundError:- # Case where package metadata is not available.- __version__ = ""-del metadata # optional, avoids polluting the results of dir(__package__)-__all__ = ["ChatOllama","OllamaEmbeddings",diff --git a/libs/partners/ollama/langchain_ollama/_version.py b/libs/partners/ollama/langchain_ollama/_version.pynew file mode 100644index 0000000000..c50c0e0dfd--- /dev/null+++ b/libs/partners/ollama/langchain_ollama/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-ollama`."""++__version__ = "1.1.0"diff --git a/libs/partners/ollama/langchain_ollama/chat_models.py b/libs/partners/ollama/langchain_ollama/chat_models.pyindex 24c09277e8..bdc7c67fd2 100644--- a/libs/partners/ollama/langchain_ollama/chat_models.py+++ b/libs/partners/ollama/langchain_ollama/chat_models.py@@ -95,6 +95,7 @@ from langchain_ollama._utils import (parse_url_with_auth,validate_model,)+from langchain_ollama._version import __version__log = logging.getLogger(__name__)@@ -921,6 +922,12 @@ class ChatOllama(BaseChatModel):)return schema+ @model_validator(mode="after")+ def _set_ollama_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-ollama", __version__)+ return self+@model_validator(mode="after")def _set_clients(self) -> Self:"""Set clients to use for ollama."""diff --git a/libs/partners/ollama/langchain_ollama/llms.py b/libs/partners/ollama/langchain_ollama/llms.pyindex 7fad56ab06..c2745bd742 100644--- a/libs/partners/ollama/langchain_ollama/llms.py+++ b/libs/partners/ollama/langchain_ollama/llms.py@@ -20,6 +20,7 @@ from langchain_ollama._utils import (parse_url_with_auth,validate_model,)+from langchain_ollama._version import __version__class OllamaLLM(BaseLLM):@@ -319,6 +320,12 @@ class OllamaLLM(BaseLLM):params["ls_max_tokens"] = max_tokensreturn params+ @model_validator(mode="after")+ def _set_ollama_llm_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-ollama", __version__)+ return self+@model_validator(mode="after")def _set_clients(self) -> Self:"""Set clients to use for ollama."""diff --git a/libs/partners/ollama/scripts/check_version.py b/libs/partners/ollama/scripts/check_version.pynew file mode 100644index 0000000000..12aece8ff2--- /dev/null+++ b/libs/partners/ollama/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_ollama/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_ollama" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_ollama/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_ollama/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/ollama/tests/unit_tests/test_chat_models.py b/libs/partners/ollama/tests/unit_tests/test_chat_models.pyindex ca690ac5d4..d499a78522 100644--- a/libs/partners/ollama/tests/unit_tests/test_chat_models.py+++ b/libs/partners/ollama/tests/unit_tests/test_chat_models.py@@ -814,6 +814,15 @@ def test_chat_ollama_ignores_strict_arg() -> None:assert "strict" not in call_kwargs+def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatOllama(model=MODEL_NAME)+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-ollama" in versions++def test_chat_ollama_supports_response_format_json_schema() -> None:"""Test that ChatOllama correctly maps json_schema response_format to format."""with patch("langchain_ollama.chat_models.Client") as mock_client_class:diff --git a/libs/partners/ollama/tests/unit_tests/test_llms.py b/libs/partners/ollama/tests/unit_tests/test_llms.pyindex d561d3e0da..7a63bf6504 100644--- a/libs/partners/ollama/tests/unit_tests/test_llms.py+++ b/libs/partners/ollama/tests/unit_tests/test_llms.py@@ -90,3 +90,12 @@ async def test_acreate_generate_stream_raises_when_client_none() -> None:with pytest.raises(RuntimeError, match="async client is not initialized"):async for _ in llm._acreate_generate_stream("Hello"):pass+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = OllamaLLM(model=MODEL_NAME)+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-ollama" in versionsdiff --git a/libs/partners/openai/Makefile b/libs/partners/openai/Makefileindex c4ffe78aa2..6516bc8813 100644--- a/libs/partners/openai/Makefile+++ b/libs/partners/openai/Makefile@@ -72,6 +72,9 @@ format format_diff:check_imports: $(shell find langchain_openai -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -79,6 +82,7 @@ check_imports: $(shell find langchain_openai -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/openai/langchain_openai/__init__.py b/libs/partners/openai/langchain_openai/__init__.pyindex e55c604256..c70be73487 100644--- a/libs/partners/openai/langchain_openai/__init__.py+++ b/libs/partners/openai/langchain_openai/__init__.py@@ -1,5 +1,6 @@"""Module for OpenAI integrations."""+from langchain_openai._version import __version__from langchain_openai.chat_models import AzureChatOpenAI, ChatOpenAIfrom langchain_openai.chat_models._client_utils import StreamChunkTimeoutErrorfrom langchain_openai.embeddings import AzureOpenAIEmbeddings, OpenAIEmbeddings@@ -14,5 +15,6 @@ __all__ = ["OpenAI","OpenAIEmbeddings","StreamChunkTimeoutError",+ "__version__","custom_tool",]diff --git a/libs/partners/openai/langchain_openai/_version.py b/libs/partners/openai/langchain_openai/_version.pynew file mode 100644index 0000000000..f99b37933c--- /dev/null+++ b/libs/partners/openai/langchain_openai/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-openai`."""++__version__ = "1.3.0"diff --git a/libs/partners/openai/langchain_openai/chat_models/base.py b/libs/partners/openai/langchain_openai/chat_models/base.pyindex 41bb467f6d..35c21dda9a 100644--- a/libs/partners/openai/langchain_openai/chat_models/base.py+++ b/libs/partners/openai/langchain_openai/chat_models/base.py@@ -130,6 +130,7 @@ from pydantic import (from pydantic.v1 import BaseModel as BaseModelV1from typing_extensions import Self+from langchain_openai._version import __version__from langchain_openai.chat_models._client_utils import (_astream_with_chunk_timeout,_build_proxied_async_httpx_client,@@ -1136,6 +1137,20 @@ class BaseChatOpenAI(BaseChatModel):return values+ @model_validator(mode="after")+ def _set_openai_chat_version(self) -> Self:+ """Set package version in metadata.++ Note: Subclasses that inherit from `BaseChatOpenAI` (e.g.+ `ChatDeepSeek`, `ChatXAI`) must use a **unique** validator name+ (e.g. `_set_deepseek_version`) instead of overriding this one. Pydantic+ replaces same-named `model_validator` methods rather than chaining them,+ so reusing `_set_openai_chat_version` would silently drop the parent's+ `langchain-openai` version entry.+ """+ self._add_version("langchain-openai", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that api key and python package exists in environment."""diff --git a/libs/partners/openai/langchain_openai/llms/azure.py b/libs/partners/openai/langchain_openai/llms/azure.pyindex 723bd7e346..3a67dc3b74 100644--- a/libs/partners/openai/langchain_openai/llms/azure.py+++ b/libs/partners/openai/langchain_openai/llms/azure.py@@ -12,6 +12,7 @@ from langchain_core.utils import from_env, secret_from_envfrom pydantic import Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_openai._version import __version__from langchain_openai.llms.base import BaseOpenAIlogger = logging.getLogger(__name__)@@ -117,6 +118,12 @@ class AzureOpenAI(BaseOpenAI):"""Return whether this model can be serialized by LangChain."""return True+ @model_validator(mode="after")+ def _set_azure_openai_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-openai", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that api key and python package exists in environment."""diff --git a/libs/partners/openai/langchain_openai/llms/base.py b/libs/partners/openai/langchain_openai/llms/base.pyindex 79032b57e2..6926301bc7 100644--- a/libs/partners/openai/langchain_openai/llms/base.py+++ b/libs/partners/openai/langchain_openai/llms/base.py@@ -21,6 +21,7 @@ from langchain_core.utils.utils import _build_model_kwargs, from_env, secret_frofrom pydantic import ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_openai._version import __version__from langchain_openai.data._profiles import _PROFILESlogger = logging.getLogger(__name__)@@ -310,6 +311,12 @@ class BaseOpenAI(BaseLLM):all_required_field_names = get_pydantic_field_names(cls)return _build_model_kwargs(values, all_required_field_names)+ @model_validator(mode="after")+ def _set_openai_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-openai", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that api key and python package exists in environment."""diff --git a/libs/partners/openai/scripts/check_version.py b/libs/partners/openai/scripts/check_version.pynew file mode 100644index 0000000000..50f615d0a9--- /dev/null+++ b/libs/partners/openai/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_openai/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_openai" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_openai/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_openai/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/openai/tests/unit_tests/chat_models/test_azure.py b/libs/partners/openai/tests/unit_tests/chat_models/test_azure.pyindex b7e9812ea2..9e07518d13 100644--- a/libs/partners/openai/tests/unit_tests/chat_models/test_azure.py+++ b/libs/partners/openai/tests/unit_tests/chat_models/test_azure.py@@ -269,3 +269,16 @@ def test_max_tokens_converted_to_max_completion_tokens() -> None:assert "max_completion_tokens" in payloadassert payload["max_completion_tokens"] == 1000assert "max_tokens" not in payload+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = AzureChatOpenAI( # type: ignore[call-arg]+ azure_deployment="35-turbo-dev",+ openai_api_version="2023-05-15",+ azure_endpoint="my-base-url",+ )+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-openai" in versionsdiff --git a/libs/partners/openai/tests/unit_tests/chat_models/test_base.py b/libs/partners/openai/tests/unit_tests/chat_models/test_base.pyindex f9ab916905..89808b63aa 100644--- a/libs/partners/openai/tests/unit_tests/chat_models/test_base.py+++ b/libs/partners/openai/tests/unit_tests/chat_models/test_base.py@@ -4077,6 +4077,15 @@ def test_context_overflow_error_backwards_compatibility() -> None:assert isinstance(exc_info.value, ContextOverflowError)+def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatOpenAI()+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-openai" in versions++def test_get_request_payload_responses_api_input_file_blocks_passthrough() -> None:llm = ChatOpenAI(model="gpt-5", use_responses_api=True)payload = llm._get_request_payload(diff --git a/libs/partners/openai/tests/unit_tests/test_check_version.py b/libs/partners/openai/tests/unit_tests/test_check_version.pynew file mode 100644index 0000000000..f8cab7d0ee--- /dev/null+++ b/libs/partners/openai/tests/unit_tests/test_check_version.py@@ -0,0 +1,62 @@+"""Unit tests for `scripts/check_version.py`.++The version-consistency check is duplicated verbatim across partner packages, so+exercising the parsing helpers here covers the shared logic. The script is loaded+by path because `scripts/` is not an importable package.+"""++import importlib.util+from pathlib import Path+from types import ModuleType++import pytest++_SCRIPT_PATH = Path(__file__).parents[2] / "scripts" / "check_version.py"+++def _load_script() -> ModuleType:+ spec = importlib.util.spec_from_file_location("_check_version", _SCRIPT_PATH)+ assert spec is not None+ assert spec.loader is not None+ module = importlib.util.module_from_spec(spec)+ spec.loader.exec_module(module)+ return module+++check_version = _load_script()+++def test_get_pyproject_version_parses_version(tmp_path: Path) -> None:+ pyproject = tmp_path / "pyproject.toml"+ pyproject.write_text('[project]\nname = "x"\nversion = "1.2.3"\n', encoding="utf-8")+ assert check_version.get_pyproject_version(pyproject) == "1.2.3"+++def test_get_pyproject_version_missing_returns_none(tmp_path: Path) -> None:+ pyproject = tmp_path / "pyproject.toml"+ pyproject.write_text('[project]\nname = "x"\n', encoding="utf-8")+ assert check_version.get_pyproject_version(pyproject) is None+++def test_get_version_py_version_parses_version(tmp_path: Path) -> None:+ version_py = tmp_path / "_version.py"+ version_py.write_text('__version__ = "4.5.6"\n', encoding="utf-8")+ assert check_version.get_version_py_version(version_py) == "4.5.6"+++def test_get_version_py_version_missing_returns_none(tmp_path: Path) -> None:+ version_py = tmp_path / "_version.py"+ version_py.write_text('"""No version here."""\n', encoding="utf-8")+ assert check_version.get_version_py_version(version_py) is None+++def test_main_passes_for_real_package() -> None:+ """The shipped `pyproject.toml` and `_version.py` must already agree."""+ assert check_version.main() == 0+++def test_main_reports_mismatch(monkeypatch: pytest.MonkeyPatch) -> None:+ """A version mismatch must fail loudly with a non-zero exit code."""+ monkeypatch.setattr(check_version, "get_pyproject_version", lambda _: "1.0.0")+ monkeypatch.setattr(check_version, "get_version_py_version", lambda _: "2.0.0")+ assert check_version.main() == 1diff --git a/libs/partners/openai/tests/unit_tests/test_imports.py b/libs/partners/openai/tests/unit_tests/test_imports.pyindex 2d3255366b..5999438197 100644--- a/libs/partners/openai/tests/unit_tests/test_imports.py+++ b/libs/partners/openai/tests/unit_tests/test_imports.py@@ -1,6 +1,7 @@from langchain_openai import __all__EXPECTED_ALL = [+ "__version__","OpenAI","ChatOpenAI","OpenAIEmbeddings",diff --git a/libs/partners/openrouter/Makefile b/libs/partners/openrouter/Makefileindex 3259904a97..4dacb32a9d 100644--- a/libs/partners/openrouter/Makefile+++ b/libs/partners/openrouter/Makefile@@ -55,6 +55,9 @@ format format_diff:check_imports: $(shell find langchain_openrouter -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -62,6 +65,7 @@ check_imports: $(shell find langchain_openrouter -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/openrouter/langchain_openrouter/__init__.py b/libs/partners/openrouter/langchain_openrouter/__init__.pyindex ca2c47a43d..9da7a35f81 100644--- a/libs/partners/openrouter/langchain_openrouter/__init__.py+++ b/libs/partners/openrouter/langchain_openrouter/__init__.py@@ -1,7 +1,9 @@"""LangChain OpenRouter integration."""+from langchain_openrouter._version import __version__from langchain_openrouter.chat_models import ChatOpenRouter__all__ = ["ChatOpenRouter",+ "__version__",]diff --git a/libs/partners/openrouter/langchain_openrouter/_version.py b/libs/partners/openrouter/langchain_openrouter/_version.pynew file mode 100644index 0000000000..887d17d321--- /dev/null+++ b/libs/partners/openrouter/langchain_openrouter/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-openrouter`."""++__version__ = "0.2.3"diff --git a/libs/partners/openrouter/langchain_openrouter/chat_models.py b/libs/partners/openrouter/langchain_openrouter/chat_models.pyindex b0ef381fbb..fcc9828485 100644--- a/libs/partners/openrouter/langchain_openrouter/chat_models.py+++ b/libs/partners/openrouter/langchain_openrouter/chat_models.py@@ -69,6 +69,7 @@ from langchain_core.utils.pydantic import is_basemodel_subclassfrom pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_openrouter._version import __version__from langchain_openrouter.data._profiles import _PROFILES_MODEL_PROFILES = cast("ModelProfileRegistry", _PROFILES)@@ -410,6 +411,12 @@ class ChatOpenRouter(BaseChatModel):)return openrouter.OpenRouter(**client_kwargs)+ @model_validator(mode="after")+ def _set_openrouter_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-openrouter", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate configuration and build the SDK client."""diff --git a/libs/partners/openrouter/scripts/check_version.py b/libs/partners/openrouter/scripts/check_version.pynew file mode 100644index 0000000000..88c28a1708--- /dev/null+++ b/libs/partners/openrouter/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_openrouter/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_openrouter" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_openrouter/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_openrouter/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/openrouter/tests/unit_tests/test_chat_models.py b/libs/partners/openrouter/tests/unit_tests/test_chat_models.pyindex 1c6bd7fb74..c4965014e1 100644--- a/libs/partners/openrouter/tests/unit_tests/test_chat_models.py+++ b/libs/partners/openrouter/tests/unit_tests/test_chat_models.py@@ -274,6 +274,14 @@ class TestChatOpenRouterInstantiation:ls_params = model._get_ls_params()assert ls_params["ls_stop"] == ["END", "STOP"]+ def test_metadata_versions(self) -> None:+ """Test that metadata reports the correct version info."""+ model = _make_model()+ assert model.metadata is not None+ versions = model.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-openrouter" in versions+def test_client_created(self) -> None:"""Test that OpenRouter SDK client is created."""model = _make_model()diff --git a/libs/partners/openrouter/tests/unit_tests/test_imports.py b/libs/partners/openrouter/tests/unit_tests/test_imports.pyindex d46ab65340..554989ddba 100644--- a/libs/partners/openrouter/tests/unit_tests/test_imports.py+++ b/libs/partners/openrouter/tests/unit_tests/test_imports.py@@ -3,6 +3,7 @@from langchain_openrouter import __all__EXPECTED_ALL = [+ "__version__","ChatOpenRouter",]diff --git a/libs/partners/perplexity/Makefile b/libs/partners/perplexity/Makefileindex f0dcbbc9ca..16aec97148 100644--- a/libs/partners/perplexity/Makefile+++ b/libs/partners/perplexity/Makefile@@ -1,4 +1,4 @@-.PHONY: all format lint type test tests integration_tests help extended_tests+.PHONY: all format lint type test tests integration_tests help extended_tests check_version# Default target executed when no arguments are given to make.all: help@@ -54,13 +54,17 @@ format format_diff:check_imports: $(shell find langchain_perplexity -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################help:@echo '----'- @echo 'check_imports - check imports'+ @echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/perplexity/langchain_perplexity/__init__.py b/libs/partners/perplexity/langchain_perplexity/__init__.pyindex 22447cfde4..1347c7e645 100644--- a/libs/partners/perplexity/langchain_perplexity/__init__.py+++ b/libs/partners/perplexity/langchain_perplexity/__init__.py@@ -1,5 +1,6 @@"""Perplexity AI integration for LangChain."""+from langchain_perplexity._version import __version__from langchain_perplexity.chat_models import ChatPerplexityfrom langchain_perplexity.embeddings import PerplexityEmbeddingsfrom langchain_perplexity.output_parsers import (@@ -17,6 +18,7 @@ from langchain_perplexity.types import ()__all__ = [+ "__version__","ChatPerplexity","PerplexityEmbeddings","PerplexitySearchRetriever",diff --git a/libs/partners/perplexity/langchain_perplexity/_version.py b/libs/partners/perplexity/langchain_perplexity/_version.pynew file mode 100644index 0000000000..8f43ed3b4c--- /dev/null+++ b/libs/partners/perplexity/langchain_perplexity/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-perplexity`."""++__version__ = "1.4.0"diff --git a/libs/partners/perplexity/langchain_perplexity/chat_models.py b/libs/partners/perplexity/langchain_perplexity/chat_models.pyindex 53f73a81ec..b45853d5a7 100644--- a/libs/partners/perplexity/langchain_perplexity/chat_models.py+++ b/libs/partners/perplexity/langchain_perplexity/chat_models.py@@ -56,6 +56,7 @@ from perplexity import AsyncPerplexity, Perplexityfrom pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_perplexity._version import __version__from langchain_perplexity.data._profiles import _PROFILESfrom langchain_perplexity.output_parsers import (ReasoningJsonOutputParser,@@ -839,6 +840,12 @@ class ChatPerplexity(BaseChatModel):values["model_kwargs"] = extrareturn values+ @model_validator(mode="after")+ def _set_perplexity_version(self) -> Self:+ """Set package version in metadata."""+ self._add_version("langchain-perplexity", __version__)+ return self+@model_validator(mode="after")def validate_environment(self) -> Self:"""Validate that api key and python package exists in environment."""diff --git a/libs/partners/perplexity/scripts/check_version.py b/libs/partners/perplexity/scripts/check_version.pynew file mode 100644index 0000000000..cd8e0d7bc0--- /dev/null+++ b/libs/partners/perplexity/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_perplexity/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_perplexity" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_perplexity/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_perplexity/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/perplexity/tests/unit_tests/test_chat_models.py b/libs/partners/perplexity/tests/unit_tests/test_chat_models.pyindex 6306834121..5706d15e7f 100644--- a/libs/partners/perplexity/tests/unit_tests/test_chat_models.py+++ b/libs/partners/perplexity/tests/unit_tests/test_chat_models.py@@ -223,6 +223,18 @@ def test_perplexity_invoke_includes_num_search_queries(mocker: MockerFixture) ->patcher.assert_called_once()+def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ from langchain_perplexity._version import __version__++ llm = ChatPerplexity(model="test")+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-perplexity" in versions+ assert versions["langchain-perplexity"] == __version__++def test_profile() -> None:model = ChatPerplexity(model="sonar")assert model.profilediff --git a/libs/partners/perplexity/tests/unit_tests/test_imports.py b/libs/partners/perplexity/tests/unit_tests/test_imports.pyindex 57168f50e4..bd99d4bd6e 100644--- a/libs/partners/perplexity/tests/unit_tests/test_imports.py+++ b/libs/partners/perplexity/tests/unit_tests/test_imports.py@@ -1,6 +1,7 @@from langchain_perplexity import __all__EXPECTED_ALL = [+ "__version__","ChatPerplexity","PerplexityEmbeddings","PerplexitySearchRetriever",diff --git a/libs/partners/xai/Makefile b/libs/partners/xai/Makefileindex 3642ccafa6..d56d79d00e 100644--- a/libs/partners/xai/Makefile+++ b/libs/partners/xai/Makefile@@ -53,6 +53,9 @@ format format_diff:check_imports: $(shell find langchain_xai -name '*.py')$(UV_RUN_LINT) python ./scripts/check_imports.py $^+check_version:+ uv run python ./scripts/check_version.py+####################### HELP######################@@ -60,6 +63,7 @@ check_imports: $(shell find langchain_xai -name '*.py')help:@echo '----'@echo 'check_imports - check imports'+ @echo 'check_version - validate version consistency'@echo 'format - run code formatters'@echo 'lint - run linters'@echo 'type - run type checking'diff --git a/libs/partners/xai/langchain_xai/__init__.py b/libs/partners/xai/langchain_xai/__init__.pyindex 3ba202d04d..15f54b2bdc 100644--- a/libs/partners/xai/langchain_xai/__init__.py+++ b/libs/partners/xai/langchain_xai/__init__.py@@ -1,5 +1,9 @@"""LangChain integration with xAI."""+from langchain_xai._version import __version__from langchain_xai.chat_models import ChatXAI-__all__ = ["ChatXAI"]+__all__ = [+ "ChatXAI",+ "__version__",+]diff --git a/libs/partners/xai/langchain_xai/_version.py b/libs/partners/xai/langchain_xai/_version.pynew file mode 100644index 0000000000..949ac42abb--- /dev/null+++ b/libs/partners/xai/langchain_xai/_version.py@@ -0,0 +1,3 @@+"""Version information for `langchain-xai`."""++__version__ = "1.2.2"diff --git a/libs/partners/xai/langchain_xai/chat_models.py b/libs/partners/xai/langchain_xai/chat_models.pyindex 359667376e..aa78391768 100644--- a/libs/partners/xai/langchain_xai/chat_models.py+++ b/libs/partners/xai/langchain_xai/chat_models.py@@ -12,6 +12,7 @@ from langchain_openai.chat_models.base import BaseChatOpenAIfrom pydantic import BaseModel, ConfigDict, Field, SecretStr, model_validatorfrom typing_extensions import Self+from langchain_xai._version import __version__from langchain_xai.data._profiles import _PROFILESif TYPE_CHECKING:@@ -468,6 +469,16 @@ class ChatXAI(BaseChatOpenAI): # type: ignore[override]params["ls_provider"] = "xai"return params+ @model_validator(mode="after")+ def _set_xai_version(self) -> Self:+ """Set package version in metadata.++ Named uniquely to avoid shadowing `BaseChatOpenAI._set_openai_chat_version`;+ Pydantic replaces same-named validators rather than chaining them.+ """+ self._add_version("langchain-xai", __version__)+ return self+@model_validator(mode="after")def _warn_search_parameters_deprecated(self) -> Self:"""Emit deprecation warning if search_parameters (Live Search) is used."""diff --git a/libs/partners/xai/scripts/check_version.py b/libs/partners/xai/scripts/check_version.pynew file mode 100644index 0000000000..c17ebc2bcf--- /dev/null+++ b/libs/partners/xai/scripts/check_version.py@@ -0,0 +1,65 @@+"""Check version consistency between `pyproject.toml` and `_version.py`.++This script validates that the version defined in pyproject.toml matches the+`__version__` variable in `langchain_xai/_version.py`. Intended for use as a+CI check to prevent version mismatches.+"""++import re+import sys+from pathlib import Path+++def get_pyproject_version(pyproject_path: Path) -> str | None:+ """Extract version from `pyproject.toml`."""+ content = pyproject_path.read_text(encoding="utf-8")+ match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def get_version_py_version(version_path: Path) -> str | None:+ """Extract `__version__` from `_version.py`."""+ content = version_path.read_text(encoding="utf-8")+ match = re.search(r'^__version__\s*=\s*"([^"]+)"', content, re.MULTILINE)+ return match.group(1) if match else None+++def main() -> int:+ """Validate version consistency."""+ script_dir = Path(__file__).parent+ package_dir = script_dir.parent++ pyproject_path = package_dir / "pyproject.toml"+ version_path = package_dir / "langchain_xai" / "_version.py"++ if not pyproject_path.exists():+ print(f"Error: {pyproject_path} not found") # noqa: T201+ return 1++ if not version_path.exists():+ print(f"Error: {version_path} not found") # noqa: T201+ return 1++ pyproject_version = get_pyproject_version(pyproject_path)+ version_py_version = get_version_py_version(version_path)++ if pyproject_version is None:+ print("Error: Could not find version in pyproject.toml") # noqa: T201+ return 1++ if version_py_version is None:+ print("Error: Could not find __version__ in langchain_xai/_version.py") # noqa: T201+ return 1++ if pyproject_version != version_py_version:+ print("Error: Version mismatch detected!") # noqa: T201+ print(f" pyproject.toml: {pyproject_version}") # noqa: T201+ print(f" langchain_xai/_version.py: {version_py_version}") # noqa: T201+ return 1++ print(f"Version check passed: {pyproject_version}") # noqa: T201+ return 0+++if __name__ == "__main__":+ sys.exit(main())diff --git a/libs/partners/xai/tests/unit_tests/test_chat_models.py b/libs/partners/xai/tests/unit_tests/test_chat_models.pyindex 1bbdc9d659..e0074b17e7 100644--- a/libs/partners/xai/tests/unit_tests/test_chat_models.py+++ b/libs/partners/xai/tests/unit_tests/test_chat_models.py@@ -161,3 +161,13 @@ def test_stream_usage_metadata() -> None:model = ChatXAI(model=MODEL_NAME, stream_usage=False)assert model.stream_usage is False+++def test_metadata_versions() -> None:+ """Test that metadata reports the correct version info."""+ llm = ChatXAI(model=MODEL_NAME)+ assert llm.metadata is not None+ versions = llm.metadata["versions"]+ assert "langchain-core" in versions+ assert "langchain-xai" in versions+ assert "langchain-openai" in versionsdiff --git a/libs/partners/xai/tests/unit_tests/test_imports.py b/libs/partners/xai/tests/unit_tests/test_imports.pyindex e1a75c6592..1d739d4c84 100644--- a/libs/partners/xai/tests/unit_tests/test_imports.py+++ b/libs/partners/xai/tests/unit_tests/test_imports.py@@ -1,6 +1,6 @@from langchain_xai import __all__-EXPECTED_ALL = ["ChatXAI"]+EXPECTED_ALL = ["__version__", "ChatXAI"]def test_all_imports() -> None: