turingpulse-sdk-semantic-kernel 1.0.0__tar.gz

turingpulse_sdk_semantic_kernel-1.0.0/.gitignore

@@ -0,0 +1,42 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Database files
+*.db
+*.sqlite3
+
+# Environment variables
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Logs
+*.log
+logs/
+
+# OS files
+.DS_Store
+Thumbs.db

turingpulse_sdk_semantic_kernel-1.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: turingpulse-sdk-semantic-kernel
+Version: 1.0.0
+Summary: TuringPulse SDK integration for Microsoft Semantic Kernel
+License-Expression: Apache-2.0
+Requires-Python: >=3.11
+Requires-Dist: semantic-kernel>=1.1.1
+Requires-Dist: turingpulse-sdk>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'

turingpulse_sdk_semantic_kernel-1.0.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "turingpulse-sdk-semantic-kernel"
+version = "1.0.0"
+description = "TuringPulse SDK integration for Microsoft Semantic Kernel"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+dependencies = [
+    "turingpulse-sdk>=1.0.0",
+    "semantic-kernel>=1.1.1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23"]

turingpulse_sdk_semantic_kernel-1.0.0/turingpulse_sdk_semantic_kernel/__init__.py

@@ -0,0 +1,6 @@
+"""TuringPulse SDK integration for Microsoft Semantic Kernel."""
+
+from ._wrapper import instrument_semantic_kernel
+
+__version__ = "0.1.0"
+__all__ = ["instrument_semantic_kernel"]

turingpulse_sdk_semantic_kernel-1.0.0/turingpulse_sdk_semantic_kernel/_wrapper.py

@@ -0,0 +1,73 @@
+"""Semantic Kernel instrumentation for TuringPulse.
+
+Wraps ``semantic_kernel.Kernel.invoke()`` / ``invoke_stream()``
+to capture plugin/function calls, model usage, and planner steps.
+"""
+
+from __future__ import annotations
+
+import logging
+from contextvars import ContextVar
+from typing import Any, Dict, Optional, Sequence
+
+from turingpulse_sdk import instrument, GovernanceDirective
+from turingpulse_sdk.config import MAX_FIELD_SIZE
+from turingpulse_sdk.context import current_context
+
+logger = logging.getLogger("turingpulse.sdk.semantic_kernel")
+
+_INSTRUMENTING: ContextVar[bool] = ContextVar("_tp_sk_instrumenting", default=False)
+
+
+def instrument_semantic_kernel(
+    kernel,
+    function,
+    *,
+    name: str,
+    governance: Optional[GovernanceDirective] = None,
+    model: Optional[str] = None,
+    provider: str = "openai",
+    kpis: Optional[Sequence["KPIConfig"]] = None,
+    metadata: Optional[Dict[str, str]] = None,
+):
+    """Wrap a Semantic Kernel function invocation for TuringPulse observability.
+
+    Returns an async callable that instruments ``kernel.invoke(function, ...)``.
+
+    Args:
+        kernel: A ``semantic_kernel.Kernel`` instance.
+        function: The KernelFunction to invoke.
+        name: Workflow display name.
+        governance: Optional governance directive.
+        model: LLM model name override.
+        provider: LLM provider name.
+
+    Returns:
+        An async callable wrapping ``kernel.invoke()``.
+    """
+
+    @instrument(name=name, governance=governance, kpis=kpis, metadata=metadata or {})
+    async def _run(**kwargs: Any) -> Any:
+        token = _INSTRUMENTING.set(True)
+        try:
+            result = await kernel.invoke(function, **kwargs)
+
+            ctx = current_context()
+            if ctx:
+                ctx.framework = "semantic-kernel"
+                ctx.node_type = "workflow"
+
+                result_str = str(result) if result else ""
+                ctx.set_io(
+                    input_data=str(kwargs)[:MAX_FIELD_SIZE],
+                    output_data=result_str[:MAX_FIELD_SIZE],
+                )
+
+                if model:
+                    ctx.set_model(model, provider)
+
+            return result
+        finally:
+            _INSTRUMENTING.reset(token)
+
+    return _run