microsoft-agents-a365-observability-extensions-semantic-kernel 0.1.0__tar.gz

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-observability-extensions-semantic-kernel
+Version: 0.1.0
+Summary: Semantic Kernel observability and tracing extensions for Microsoft Agent 365
+Author-email: Microsoft <support@microsoft.com>
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-observability-extensions-semantickernel
+Keywords: observability,telemetry,tracing,opentelemetry,semantic-kernel,agents,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-observability-core>=0.0.0
+Requires-Dist: semantic-kernel>=1.0.0
+Requires-Dist: opentelemetry-api>=1.36.0
+Requires-Dist: opentelemetry-sdk>=1.36.0
+Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-observability-extensions-semantickernel
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-observability-extensions-semantickernel?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-observability-extensions-semantickernel?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+
+Observability extensions for Semantic Kernel framework. This package provides OpenTelemetry tracing integration for Semantic Kernel-based applications with automatic instrumentation for kernel functions, plugins, and planners.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-observability-extensions-semantickernel
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Observability documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/README.md

@@ -0,0 +1,33 @@
+# microsoft-agents-a365-observability-extensions-semantickernel
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-observability-extensions-semantickernel?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-observability-extensions-semantickernel?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+
+Observability extensions for Semantic Kernel framework. This package provides OpenTelemetry tracing integration for Semantic Kernel-based applications with automatic instrumentation for kernel functions, plugins, and planners.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-observability-extensions-semantickernel
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Observability documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365/observability/extensions/semantickernel/__init__.py

@@ -0,0 +1 @@
+# Copyright (c) Microsoft. All rights reserved.

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365/observability/extensions/semantickernel/span_processor.py

@@ -0,0 +1,26 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+# Custom Span Processor
+
+from microsoft_agents_a365.observability.core.constants import GEN_AI_OPERATION_NAME_KEY
+from microsoft_agents_a365.observability.core.inference_operation_type import InferenceOperationType
+from microsoft_agents_a365.observability.core.utils import extract_model_name
+from opentelemetry.sdk.trace.export import SpanProcessor
+
+
+class SemanticKernelSpanProcessor(SpanProcessor):
+    """
+    SpanProcessor for SK
+    """
+
+    def __init__(self, service_name: str | None = None):
+        self.service_name = service_name
+
+    def on_start(self, span, parent_context):
+        if span.name.startswith("chat."):
+            span.set_attribute(GEN_AI_OPERATION_NAME_KEY, InferenceOperationType.CHAT.value.lower())
+            model_name = extract_model_name(span.name)
+            span.update_name(f"{InferenceOperationType.CHAT.value.lower()} {model_name}")
+
+    def on_end(self, span):
+        pass

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365/observability/extensions/semantickernel/trace_instrumentor.py

@@ -0,0 +1,49 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from __future__ import annotations
+
+from collections.abc import Collection
+from typing import Any
+
+from microsoft_agents_a365.observability.core.config import get_tracer_provider, is_configured
+from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
+
+from microsoft_agents_a365.observability.extensions.semantickernel.span_processor import (
+    SemanticKernelSpanProcessor,
+)
+
+# -----------------------------
+# 3) The Instrumentor class
+# -----------------------------
+_instruments = ("semantic-kernel >= 1.0.0",)
+
+
+class SemanticKernelInstrumentor(BaseInstrumentor):
+    """
+    Instruments Semantic Kernel:
+      • Installs your custom OTel SpanProcessor
+      • (Optionally) attaches an SK function-invocation filter to enrich spans
+    """
+
+    def __init__(self):
+        if not is_configured():
+            raise RuntimeError(
+                "Microsoft Agent 365 (or your telemetry config) is not initialized. Configure it before instrumenting."
+            )
+        super().__init__()
+
+    def instrumentation_dependencies(self) -> Collection[str]:
+        return _instruments
+
+    def _instrument(self, **kwargs: Any) -> None:
+        """
+        kwargs (all optional):
+        """
+
+        # Ensure we have an SDK TracerProvider
+        provider = get_tracer_provider()
+        self._processor = SemanticKernelSpanProcessor()
+        provider.add_span_processor(self._processor)
+
+    def _uninstrument(self, **kwargs: Any) -> None:
+        pass

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-observability-extensions-semantic-kernel
+Version: 0.1.0
+Summary: Semantic Kernel observability and tracing extensions for Microsoft Agent 365
+Author-email: Microsoft <support@microsoft.com>
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-observability-extensions-semantickernel
+Keywords: observability,telemetry,tracing,opentelemetry,semantic-kernel,agents,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-observability-core>=0.0.0
+Requires-Dist: semantic-kernel>=1.0.0
+Requires-Dist: opentelemetry-api>=1.36.0
+Requires-Dist: opentelemetry-sdk>=1.36.0
+Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-observability-extensions-semantickernel
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-observability-extensions-semantickernel?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-observability-extensions-semantickernel?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-semantickernel)
+
+Observability extensions for Semantic Kernel framework. This package provides OpenTelemetry tracing integration for Semantic Kernel-based applications with automatic instrumentation for kernel functions, plugins, and planners.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-observability-extensions-semantickernel
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Observability documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+setup.py
+microsoft_agents_a365/observability/extensions/semantickernel/__init__.py
+microsoft_agents_a365/observability/extensions/semantickernel/span_processor.py
+microsoft_agents_a365/observability/extensions/semantickernel/trace_instrumentor.py
+microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/PKG-INFO
+microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/SOURCES.txt
+microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/dependency_links.txt
+microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/requires.txt
+microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/top_level.txt

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/requires.txt

@@ -0,0 +1,16 @@
+microsoft-agents-a365-observability-core>=0.0.0
+semantic-kernel>=1.0.0
+opentelemetry-api>=1.36.0
+opentelemetry-sdk>=1.36.0
+opentelemetry-instrumentation>=0.47b0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+ruff>=0.1.0
+black>=23.0.0
+mypy>=1.0.0
+
+[test]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/microsoft_agents_a365_observability_extensions_semantic_kernel.egg-info/top_level.txt

@@ -0,0 +1 @@
+microsoft_agents_a365

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/pyproject.toml

@@ -0,0 +1,78 @@
+[build-system]
+requires = ["setuptools>=68", "wheel", "tzdata"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "microsoft-agents-a365-observability-extensions-semantic-kernel"
+dynamic = ["version"]
+authors = [
+    { name = "Microsoft", email = "support@microsoft.com" },
+]
+description = "Semantic Kernel observability and tracing extensions for Microsoft Agent 365"
+readme = "README.md"
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: System :: Monitoring",
+]
+license = {text = "MIT"}
+keywords = ["observability", "telemetry", "tracing", "opentelemetry", "semantic-kernel", "agents", "ai"]
+# Note: Internal package versions (microsoft-agents-a365-*) are automatically set at build time
+# The placeholder below will be replaced with >= {current_version} by setup.py
+dependencies = [
+    "microsoft-agents-a365-observability-core >= 0.0.0",
+    "semantic-kernel >= 1.0.0",
+    "opentelemetry-api >= 1.36.0",
+    "opentelemetry-sdk >= 1.36.0",
+    "opentelemetry-instrumentation >= 0.47b0",
+]
+
+[project.urls]
+Homepage = "https://github.com/microsoft/Agent365-python"
+Repository = "https://github.com/microsoft/Agent365-python"
+Issues = "https://github.com/microsoft/Agent365-python/issues"
+Documentation = "https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-observability-extensions-semantickernel"
+
+[project.optional-dependencies]
+dev = [
+    "pytest >= 7.0.0",
+    "pytest-asyncio >= 0.21.0",
+    "ruff >= 0.1.0",
+    "black >= 23.0.0",
+    "mypy >= 1.0.0",
+]
+test = [
+    "pytest >= 7.0.0",
+    "pytest-asyncio >= 0.21.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+
+[tool.setuptools]
+license-files = ["../../LICENSE"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["../../LICENSE"]
+
+[tool.black]
+line-length = 100
+target-version = ['py311']
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

microsoft_agents_a365_observability_extensions_semantic_kernel-0.1.0/setup.py

@@ -0,0 +1,28 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+import sys
+from pathlib import Path
+from os import environ
+from setuptools import setup
+
+# Get version from environment variable set by CI/CD
+package_version = environ.get("AGENT365_PYTHON_SDK_PACKAGE_VERSION", "0.0.0")
+
+# Add versioning helper to path
+helper_path = Path(__file__).parent.parent.parent / "versioning" / "helper"
+sys.path.insert(0, str(helper_path))
+
+from setup_utils import get_dynamic_dependencies
+
+# Use minimum version strategy:
+# - Internal packages get: >= current_base_version (e.g., >= 0.1.0)
+# - Automatically updates when you build new versions
+# - Consumers can upgrade to any higher version
+setup(
+    version=package_version,
+    install_requires=get_dynamic_dependencies(
+        use_compatible_release=False,  # No upper bound
+        use_exact_match=False,  # Not exact match
+    ),
+)