nvidia-nat-langchain 1.3.0a20251002__py3-none-any.whl → 1.4.0a20251129__py3-none-any.whl

nat/plugins/langchain/embedder.py

@@ -28,7 +28,13 @@ async def azure_openai_langchain(embedder_config: AzureOpenAIEmbedderModelConfig
 
     from langchain_openai import AzureOpenAIEmbeddings
 
-    client = AzureOpenAIEmbeddings(**embedder_config.model_dump(exclude={"type"}, by_alias=True, exclude_none=True))
+    client = AzureOpenAIEmbeddings(
+        **embedder_config.model_dump(exclude={"type", "api_version"},
+                                     by_alias=True,
+                                     exclude_none=True,
+                                     exclude_unset=True),
+        api_version=embedder_config.api_version,
+    )
 
     if isinstance(embedder_config, RetryMixin):
         client = patch_with_retry(client,
@@ -44,7 +50,8 @@ async def nim_langchain(embedder_config: NIMEmbedderModelConfig, builder: Builde
 
     from langchain_nvidia_ai_endpoints import NVIDIAEmbeddings
 
-    client = NVIDIAEmbeddings(**embedder_config.model_dump(exclude={"type"}, by_alias=True, exclude_none=True))
+    client = NVIDIAEmbeddings(
+        **embedder_config.model_dump(exclude={"type"}, by_alias=True, exclude_none=True, exclude_unset=True))
 
     if isinstance(embedder_config, RetryMixin):
         client = patch_with_retry(client,
@@ -60,7 +67,8 @@ async def openai_langchain(embedder_config: OpenAIEmbedderModelConfig, builder:
 
     from langchain_openai import OpenAIEmbeddings
 
-    client = OpenAIEmbeddings(**embedder_config.model_dump(exclude={"type"}, by_alias=True, exclude_none=True))
+    client = OpenAIEmbeddings(
+        **embedder_config.model_dump(exclude={"type"}, by_alias=True, exclude_none=True, exclude_unset=True))
 
     if isinstance(embedder_config, RetryMixin):
         client = patch_with_retry(client,

nat/plugins/langchain/llm.py

@@ -12,13 +12,16 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
+# pylint: disable=unused-argument
 
+import logging
 from collections.abc import Sequence
 from typing import TypeVar
 
 from nat.builder.builder import Builder
 from nat.builder.framework_enum import LLMFrameworkEnum
 from nat.cli.register_workflow import register_llm_client
+from nat.data_models.llm import APITypeEnum
 from nat.data_models.llm import LLMBaseConfig
 from nat.data_models.retry_mixin import RetryMixin
 from nat.data_models.thinking_mixin import ThinkingMixin
@@ -31,8 +34,11 @@ from nat.llm.utils.thinking import BaseThinkingInjector
 from nat.llm.utils.thinking import FunctionArgumentWrapper
 from nat.llm.utils.thinking import patch_with_thinking
 from nat.utils.exception_handlers.automatic_retries import patch_with_retry
+from nat.utils.responses_api import validate_no_responses_api
 from nat.utils.type_utils import override
 
+logger = logging.getLogger(__name__)
+
 ModelType = TypeVar("ModelType")
 
 
@@ -65,20 +71,22 @@ def _patch_llm_based_on_config(client: ModelType, llm_config: LLMBaseConfig) ->
             Raises:
                 ValueError: If the messages are not a valid type for LanguageModelInput.
             """
-            system_message = SystemMessage(content=self.system_prompt)
-            if isinstance(messages, BaseMessage):
-                new_messages = [system_message, messages]
-                return FunctionArgumentWrapper(new_messages, *args, **kwargs)
-            elif isinstance(messages, PromptValue):
-                new_messages = [system_message, *messages.to_messages()]
-                return FunctionArgumentWrapper(new_messages, *args, **kwargs)
+            if isinstance(messages, PromptValue):
+                messages = messages.to_messages()
             elif isinstance(messages, str):
-                new_messages = [system_message, HumanMessage(content=messages)]
-                return FunctionArgumentWrapper(new_messages, *args, **kwargs)
-            elif isinstance(messages, Sequence):
-                if all(isinstance(m, BaseMessage) for m in messages):
-                    new_messages = [system_message, *list(messages)]
-                    return FunctionArgumentWrapper(new_messages, *args, **kwargs)
+                messages = [HumanMessage(content=messages)]
+
+            if isinstance(messages, Sequence) and all(isinstance(m, BaseMessage) for m in messages):
+                for i, message in enumerate(messages):
+                    if isinstance(message, SystemMessage):
+                        if self.system_prompt not in str(message.content):
+                            messages = list(messages)
+                            messages[i] = SystemMessage(content=f"{message.content}\n{self.system_prompt}")
+                        break
+                else:
+                    messages = list(messages)
+                    messages.insert(0, SystemMessage(content=self.system_prompt))
+                return FunctionArgumentWrapper(messages, *args, **kwargs)
             raise ValueError(f"Unsupported message type: {type(messages)}")
 
     if isinstance(llm_config, RetryMixin):
@@ -108,10 +116,13 @@ async def aws_bedrock_langchain(llm_config: AWSBedrockModelConfig, _builder: Bui
 
     from langchain_aws import ChatBedrockConverse
 
+    validate_no_responses_api(llm_config, LLMFrameworkEnum.LANGCHAIN)
+
     client = ChatBedrockConverse(**llm_config.model_dump(
-        exclude={"type", "context_size", "thinking"},
+        exclude={"type", "context_size", "thinking", "api_type"},
         by_alias=True,
         exclude_none=True,
+        exclude_unset=True,
     ))
 
     yield _patch_llm_based_on_config(client, llm_config)
@@ -122,7 +133,15 @@ async def azure_openai_langchain(llm_config: AzureOpenAIModelConfig, _builder: B
 
     from langchain_openai import AzureChatOpenAI
 
-    client = AzureChatOpenAI(**llm_config.model_dump(exclude={"type", "thinking"}, by_alias=True, exclude_none=True))
+    validate_no_responses_api(llm_config, LLMFrameworkEnum.LANGCHAIN)
+
+    client = AzureChatOpenAI(
+        **llm_config.model_dump(exclude={"type", "thinking", "api_type", "api_version"},
+                                by_alias=True,
+                                exclude_none=True,
+                                exclude_unset=True),
+        api_version=llm_config.api_version,
+    )
 
     yield _patch_llm_based_on_config(client, llm_config)
 
@@ -132,9 +151,16 @@ async def nim_langchain(llm_config: NIMModelConfig, _builder: Builder):
 
     from langchain_nvidia_ai_endpoints import ChatNVIDIA
 
+    validate_no_responses_api(llm_config, LLMFrameworkEnum.LANGCHAIN)
+
     # prefer max_completion_tokens over max_tokens
     client = ChatNVIDIA(
-        **llm_config.model_dump(exclude={"type", "max_tokens", "thinking"}, by_alias=True, exclude_none=True),
+        **llm_config.model_dump(
+            exclude={"type", "max_tokens", "thinking", "api_type"},
+            by_alias=True,
+            exclude_none=True,
+            exclude_unset=True,
+        ),
         max_completion_tokens=llm_config.max_tokens,
     )
 
@@ -146,13 +172,25 @@ async def openai_langchain(llm_config: OpenAIModelConfig, _builder: Builder):
 
     from langchain_openai import ChatOpenAI
 
-    # If stream_usage is specified, it will override the default value of True.
-    client = ChatOpenAI(stream_usage=True,
-                        **llm_config.model_dump(
-                            exclude={"type", "thinking"},
-                            by_alias=True,
-                            exclude_none=True,
-                        ))
+    if llm_config.api_type == APITypeEnum.RESPONSES:
+        client = ChatOpenAI(stream_usage=True,
+                            use_responses_api=True,
+                            use_previous_response_id=True,
+                            **llm_config.model_dump(
+                                exclude={"type", "thinking", "api_type"},
+                                by_alias=True,
+                                exclude_none=True,
+                                exclude_unset=True,
+                            ))
+    else:
+        # If stream_usage is specified, it will override the default value of True.
+        client = ChatOpenAI(stream_usage=True,
+                            **llm_config.model_dump(
+                                exclude={"type", "thinking", "api_type"},
+                                by_alias=True,
+                                exclude_none=True,
+                                exclude_unset=True,
+                            ))
 
     yield _patch_llm_based_on_config(client, llm_config)
 
@@ -162,6 +200,9 @@ async def litellm_langchain(llm_config: LiteLlmModelConfig, _builder: Builder):
 
     from langchain_litellm import ChatLiteLLM
 
-    client = ChatLiteLLM(**llm_config.model_dump(exclude={"type", "thinking"}, by_alias=True, exclude_none=True))
+    validate_no_responses_api(llm_config, LLMFrameworkEnum.LANGCHAIN)
+
+    client = ChatLiteLLM(**llm_config.model_dump(
+        exclude={"type", "thinking", "api_type"}, by_alias=True, exclude_none=True, exclude_unset=True))
 
     yield _patch_llm_based_on_config(client, llm_config)

nat/plugins/langchain/tools/tavily_internet_search.py

@@ -13,9 +13,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from pydantic import Field
+
 from nat.builder.builder import Builder
 from nat.builder.function_info import FunctionInfo
 from nat.cli.register_workflow import register_function
+from nat.data_models.common import SerializableSecretStr
+from nat.data_models.common import get_secret_value
 from nat.data_models.function import FunctionBaseConfig
 
 
@@ -26,7 +30,7 @@ class TavilyInternetSearchToolConfig(FunctionBaseConfig, name="tavily_internet_s
     Requires a TAVILY_API_KEY.
     """
     max_results: int = 3
-    api_key: str = ""
+    api_key: SerializableSecretStr = Field(default="", description="The API key for the Tavily service.")
 
 
 @register_function(config_type=TavilyInternetSearchToolConfig)
@@ -36,7 +40,8 @@ async def tavily_internet_search(tool_config: TavilyInternetSearchToolConfig, bu
     from langchain_tavily import TavilySearch
 
     if not os.environ.get("TAVILY_API_KEY"):
-        os.environ["TAVILY_API_KEY"] = tool_config.api_key
+        if tool_config.api_key:
+            os.environ["TAVILY_API_KEY"] = get_secret_value(tool_config.api_key)
     # This tavily tool requires an API Key and it must be set as an environment variable (TAVILY_API_KEY)
     # Refer to create_customize_workflow.md for instructions of getting the API key
 

{nvidia_nat_langchain-1.3.0a20251002.dist-info → nvidia_nat_langchain-1.4.0a20251129.dist-info}/METADATA

@@ -1,7 +1,12 @@
 Metadata-Version: 2.4
 Name: nvidia-nat-langchain
-Version: 1.3.0a20251002
+Version: 1.4.0a20251129
 Summary: Subpackage for LangChain/LangGraph integration in NeMo Agent toolkit
+Author: NVIDIA Corporation
+Maintainer: NVIDIA Corporation
+License: Apache-2.0
+Project-URL: documentation, https://docs.nvidia.com/nemo/agent-toolkit/latest/
+Project-URL: source, https://github.com/NVIDIA/NeMo-Agent-Toolkit
 Keywords: ai,rag,agents
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.11
@@ -9,7 +14,10 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: nvidia-nat==v1.3.0a20251002
+License-File: LICENSE-3rd-party.txt
+License-File: LICENSE.md
+Requires-Dist: nvidia-nat==v1.4.0a20251129
+Requires-Dist: langchain~=0.3.27
 Requires-Dist: langchain-aws~=0.2.31
 Requires-Dist: langchain-core~=0.3.75
 Requires-Dist: langchain-litellm~=0.2.3
@@ -18,6 +26,7 @@ Requires-Dist: langchain-nvidia-ai-endpoints~=0.3.17
 Requires-Dist: langchain-openai~=0.3.32
 Requires-Dist: langchain-tavily~=0.2.11
 Requires-Dist: langgraph~=0.6.7
+Dynamic: license-file
 
 <!--
 SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.

{nvidia_nat_langchain-1.3.0a20251002.dist-info → nvidia_nat_langchain-1.4.0a20251129.dist-info}/RECORD

@@ -1,17 +1,19 @@
 nat/meta/pypi.md,sha256=T_KFtTXVxhFM8Y6K3OlNByA5sTXLQuqqUpHgNOCvZBU,1120
 nat/plugins/langchain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nat/plugins/langchain/embedder.py,sha256=ZSESaazyz7y3F0GSSsWRe_xfvxOe0Mwd45wEAkQ2jJk,3339
-nat/plugins/langchain/llm.py,sha256=vlR_4bMLmmpXTv4kp3xFOB1eFeJ-wX1_DqnsQpPunAo,7110
+nat/plugins/langchain/embedder.py,sha256=Ie-J4N4lvygW0zNKklKZVSYxYFcRW6p_QlRdcz0WxcE,3607
+nat/plugins/langchain/llm.py,sha256=FaEPleu_aBCsQ-6tt3ofr1A2Oa_ta60tMb0yGGhiWSo,8561
 nat/plugins/langchain/register.py,sha256=jgq6wSJoGQIZFJhS8RbUs25cLgNJjCkFu4M6qaWJS_4,906
 nat/plugins/langchain/retriever.py,sha256=SWbXXOezEUuPACnmSSU497NAmEVEMj2SrFJGodkRg34,2644
 nat/plugins/langchain/tool_wrapper.py,sha256=Zgb2_XB4bEhjPPeqS-ZH_OJT_pcQmteX7u03N_qCLfc,2121
 nat/plugins/langchain/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nat/plugins/langchain/tools/code_generation_tool.py,sha256=f5pna0WMOx3QOS4WnaMFKD7tBZ1-tS0PfI0IMYobtTQ,2723
 nat/plugins/langchain/tools/register.py,sha256=uemxqLxcNk1bGX4crV52oMphLTZWonStzkXwTZeG2Rw,889
-nat/plugins/langchain/tools/tavily_internet_search.py,sha256=UFMP1xh_kC3fydMQBeV-oDZ-M7jnLcs5OkMSzgm7mng,2653
+nat/plugins/langchain/tools/tavily_internet_search.py,sha256=W5sdZ9hobPc3xbnWPSbtFBClIn14EM8xT0XUVF2HpWo,2928
 nat/plugins/langchain/tools/wikipedia_search.py,sha256=431YwLsjoC_mdvMZ_gY0Q37Uqaue2ASnAHpwr4jWCaU,2197
-nvidia_nat_langchain-1.3.0a20251002.dist-info/METADATA,sha256=Qn2MSPoBNuK-dXVY1V_7EaO8Z2itHlP2iwUEAIe5hoI,1924
-nvidia_nat_langchain-1.3.0a20251002.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-nvidia_nat_langchain-1.3.0a20251002.dist-info/entry_points.txt,sha256=4deXsMn97I012HhDw0UjoqcZ8eEoZ7BnqaRx5QmzebY,123
-nvidia_nat_langchain-1.3.0a20251002.dist-info/top_level.txt,sha256=8-CJ2cP6-f0ZReXe5Hzqp-5pvzzHz-5Ds5H2bGqh1-U,4
-nvidia_nat_langchain-1.3.0a20251002.dist-info/RECORD,,
+nvidia_nat_langchain-1.4.0a20251129.dist-info/licenses/LICENSE-3rd-party.txt,sha256=fOk5jMmCX9YoKWyYzTtfgl-SUy477audFC5hNY4oP7Q,284609
+nvidia_nat_langchain-1.4.0a20251129.dist-info/licenses/LICENSE.md,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+nvidia_nat_langchain-1.4.0a20251129.dist-info/METADATA,sha256=Xn_gNxlhmgfYGVSOKm3zrEfbrR20kJYpeUoMuzdu0ro,2263
+nvidia_nat_langchain-1.4.0a20251129.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nvidia_nat_langchain-1.4.0a20251129.dist-info/entry_points.txt,sha256=4deXsMn97I012HhDw0UjoqcZ8eEoZ7BnqaRx5QmzebY,123
+nvidia_nat_langchain-1.4.0a20251129.dist-info/top_level.txt,sha256=8-CJ2cP6-f0ZReXe5Hzqp-5pvzzHz-5Ds5H2bGqh1-U,4
+nvidia_nat_langchain-1.4.0a20251129.dist-info/RECORD,,