nvidia-nat-semantic-kernel 1.2.0a20250813__py3-none-any.whl

nat/meta/pypi.md

@@ -0,0 +1,23 @@
+<!--
+SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+SPDX-License-Identifier: Apache-2.0
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+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.
+-->
+
+![NVIDIA NeMo Agent Toolkit](https://media.githubusercontent.com/media/NVIDIA/NeMo-Agent-Toolkit/refs/heads/main/docs/source/_static/aiqtoolkit_banner.png "NeMo Agent toolkit banner image")
+
+# NVIDIA NeMo Agent Toolkit Subpackage
+This is a subpackage for Semantic-Kernel integration in NeMo Agent toolkit.
+
+For more information about the NVIDIA NeMo Agent toolkit, please visit the [NeMo Agent toolkit GitHub Repo](https://github.com/NVIDIA/NeMo-Agent-Toolkit).

nat/plugins/semantic_kernel/llm.py

@@ -0,0 +1,41 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+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.retry_mixin import RetryMixin
+from nat.llm.openai_llm import OpenAIModelConfig
+from nat.utils.exception_handlers.automatic_retries import patch_with_retry
+
+
+@register_llm_client(config_type=OpenAIModelConfig, wrapper_type=LLMFrameworkEnum.SEMANTIC_KERNEL)
+async def openai_semantic_kernel(llm_config: OpenAIModelConfig, builder: Builder):
+
+    from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion
+
+    config_obj = {
+        **llm_config.model_dump(exclude={"type"}, by_alias=True),
+    }
+
+    llm = OpenAIChatCompletion(ai_model_id=config_obj.get("model"))
+
+    if isinstance(llm_config, RetryMixin):
+        llm = patch_with_retry(llm,
+                               retries=llm_config.num_retries,
+                               retry_codes=llm_config.retry_on_status_codes,
+                               retry_on_messages=llm_config.retry_on_errors)
+
+    yield llm

nat/plugins/semantic_kernel/register.py

@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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-import
+# flake8: noqa
+# isort:skip_file
+
+# Import any providers which need to be automatically registered here
+
+from . import llm
+from . import tool_wrapper

nat/plugins/semantic_kernel/tool_wrapper.py

@@ -0,0 +1,163 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# 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.
+
+import logging
+import types
+from collections.abc import Callable
+from dataclasses import is_dataclass
+from typing import Any
+from typing import Union
+from typing import get_args
+from typing import get_origin
+
+from pydantic import BaseModel
+
+from nat.builder.builder import Builder
+from nat.builder.framework_enum import LLMFrameworkEnum
+from nat.builder.function import Function
+from nat.cli.register_workflow import register_tool_wrapper
+
+logger = logging.getLogger(__name__)
+
+# pylint: disable=consider-alternative-union-syntax)
+
+
+def get_type_info(field_type):
+    origin = get_origin(field_type)
+    if origin is None:
+        # It’s a simple type
+        return getattr(field_type, "__name__", str(field_type))
+
+    # Handle Union types specially
+    if origin in (Union, types.UnionType):
+        # Pick the first type that isn’t NoneType
+        non_none = [arg for arg in get_args(field_type) if arg is not type(None)]
+        if non_none:
+            return getattr(non_none[0], "__name__", str(non_none[0]))
+
+        return 'str'  # fallback if union is only str (unlikely)
+
+    # For other generics, capture both the origin and its parameters
+    return getattr(origin, "__name__", str(origin))
+
+
+def resolve_type(t):
+    origin = get_origin(t)
+    if origin in (Union, types.UnionType):
+        # Pick the first type that isn’t NoneType
+        for arg in get_args(t):
+            if arg is not None:
+                return arg
+
+        return t  # fallback if union is only NoneType (unlikely)
+    return t
+
+
+@register_tool_wrapper(wrapper_type=LLMFrameworkEnum.SEMANTIC_KERNEL)
+def semantic_kernel_tool_wrapper(name: str, fn: Function, builder: Builder):
+
+    async def callable_ainvoke(*args, **kwargs):
+        return await fn.acall_invoke(*args, **kwargs)
+
+    async def callable_astream(*args, **kwargs):
+        async for item in fn.acall_stream(*args, **kwargs):
+            yield item
+
+    def nat_kernel_function(
+        func: Callable[..., object] | None = None,
+        aiq_function: Function | None = None,
+        name: str | None = None,
+        description: str | None = None,
+    ) -> Callable[..., Any]:
+        """
+        Modified version of Semantic Kernel's kernel_function decorator.
+
+        Uses `aiq` Function properties instead of doing type inference on the function's inner
+        """
+
+        def decorator(func: Callable[..., object]) -> Callable[..., object]:
+            """The actual decorator function."""
+            setattr(func, "__kernel_function__", True)
+            setattr(func, "__kernel_function_description__", description or aiq_function.description)
+            setattr(func, "__kernel_function_name__", name or aiq_function.config.type)
+
+            # Always defer to single output schema, if present, for now
+            # No need to check streaming output is present given one of the two is always present
+            has_single = aiq_function.has_single_output
+            has_streaming = aiq_function.has_streaming_output
+            output_schema = aiq_function.single_output_schema if has_single else aiq_function.streaming_output_schema
+            setattr(func, "__kernel_function_streaming__", not aiq_function.has_single_output if has_single else True)
+
+            if has_single and has_streaming:
+                logger.warning("Function has both single and streaming output schemas. "
+                               "Defaulting to single output schema.")
+
+            input_annotations = []
+            for arg_name, annotation in aiq_function.input_schema.model_fields.items():
+                type_obj = resolve_type(annotation.annotation)
+                include_in_choices = True
+                if isinstance(type_obj, type) and (issubclass(type_obj, BaseModel) or is_dataclass(type_obj)):
+                    logger.warning(
+                        "Nested non-native model detected in input schema for parameter: %s. "
+                        "Setting include_in_function_choices to False.",
+                        arg_name)
+                    # Don't error out here
+                    # Just instead avoid showing the tool to the model
+                    include_in_choices = False
+                input_annotations.append({
+                    "is_required": annotation.is_required(),
+                    "name": arg_name,
+                    "type_": get_type_info(annotation.annotation),
+                    "type_object": type_obj,
+                    "include_in_function_choices": include_in_choices
+                })
+
+            setattr(func, "__kernel_function_parameters__", input_annotations)
+
+            return_annotations = []
+            for arg_name, annotation in output_schema.model_fields.items():
+                type_obj = resolve_type(annotation.annotation)
+                include_in_choices = True
+                if isinstance(type_obj, type) and (issubclass(type_obj, BaseModel) or is_dataclass(type_obj)):
+                    logger.warning(
+                        "Nested non-native model detected in output schema for parameter: %s. "
+                        "Setting include_in_function_choices to False.",
+                        arg_name)
+                    include_in_choices = False
+                return_annotations.append({
+                    "is_required": annotation.is_required(),
+                    "name": arg_name,
+                    "type_": get_type_info(annotation.annotation),
+                    "type_object": type_obj,
+                    "include_in_function_choices": include_in_choices
+                })
+            return_annotation = return_annotations[0]
+
+            setattr(func, "__kernel_function_return_type__", return_annotation.get("type_", "None"))
+            setattr(func, "__kernel_function_return_type_object__", return_annotation.get("type_object", None))
+            setattr(func, "__kernel_function_return_description__", return_annotation.get("description", ""))
+            setattr(func, "__kernel_function_return_required__", return_annotation.get("is_required", False))
+            return func
+
+        if func:
+            return decorator(func)
+        return decorator
+
+    if fn.has_streaming_output and not fn.has_single_output:
+        kernel_func = nat_kernel_function(func=callable_astream, aiq_function=fn, name=name, description=fn.description)
+    else:
+        kernel_func = nat_kernel_function(func=callable_ainvoke, aiq_function=fn, name=name, description=fn.description)
+
+    return {name: kernel_func}

nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: nvidia-nat-semantic-kernel
+Version: 1.2.0a20250813
+Summary: Subpackage for Semantic-Kernel integration in NeMo Agent toolkit
+Keywords: ai,rag,agents
+Classifier: Programming Language :: Python
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: nvidia-nat==v1.2.0a20250813
+Requires-Dist: semantic-kernel~=1.24.0
+
+<!--
+SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+SPDX-License-Identifier: Apache-2.0
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+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.
+-->
+
+![NVIDIA NeMo Agent Toolkit](https://media.githubusercontent.com/media/NVIDIA/NeMo-Agent-Toolkit/refs/heads/main/docs/source/_static/aiqtoolkit_banner.png "NeMo Agent toolkit banner image")
+
+# NVIDIA NeMo Agent Toolkit Subpackage
+This is a subpackage for Semantic-Kernel integration in NeMo Agent toolkit.
+
+For more information about the NVIDIA NeMo Agent toolkit, please visit the [NeMo Agent toolkit GitHub Repo](https://github.com/NVIDIA/NeMo-Agent-Toolkit).

nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/RECORD

@@ -0,0 +1,10 @@
+nat/meta/pypi.md,sha256=Ki8bvrAo3d2iW7q6vTszp2AY2fapDP--el1wKuOtWcQ,1127
+nat/plugins/semantic_kernel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nat/plugins/semantic_kernel/llm.py,sha256=C2ISvuCkz_YN0yOgyf1QJPtbJmX_1kgLpQumwpKfcOI,1744
+nat/plugins/semantic_kernel/register.py,sha256=RKXyuaXy4ftA5IL2RrCofIBjpie_-2lP9YZoHAiyPU0,863
+nat/plugins/semantic_kernel/tool_wrapper.py,sha256=reg19DFn6uc5S1RIYJPVOcm-k6uG7h3ao2Sxwj8U-e0,7175
+nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/METADATA,sha256=zkJCtJW_ERDMpvmep1815csur7HzJ2jEb3EQ2l6r7fE,1500
+nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/entry_points.txt,sha256=0jCtQBAn5Ohs9XoVCF34WvNCV33OwAsH8bjFzgw_ByM,76
+nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/top_level.txt,sha256=8-CJ2cP6-f0ZReXe5Hzqp-5pvzzHz-5Ds5H2bGqh1-U,4
+nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/RECORD,,

nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[nat.components]
+nat_semantic_kernel = nat.plugins.semantic_kernel.register

nvidia_nat_semantic_kernel-1.2.0a20250813.dist-info/top_level.txt

@@ -0,0 +1 @@
+nat