microsoft-agents-a365-observability-extensions-agent-framework 0.2.1.dev9__tar.gz → 0.2.1.dev13__tar.gz

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-a365-observability-extensions-agent-framework
-Version: 0.2.1.dev9
+Version: 0.2.1.dev13
 Summary: Agent Framework observability and tracing extensions for Microsoft Agent 365
 Author-email: Microsoft <support@microsoft.com>
 License-Expression: MIT
@@ -20,19 +20,19 @@ 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: opentelemetry-api>=1.36.0
-Requires-Dist: opentelemetry-sdk>=1.36.0
-Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Requires-Dist: microsoft-agents-a365-observability-core
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: opentelemetry-instrumentation
 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"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest>=7.0.0; extra == "test"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
 
 # microsoft-agents-a365-observability-extensions-agentframework
 

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13/microsoft_agents_a365/observability/extensions/agentframework/__init__.py

@@ -0,0 +1,10 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+"""Agent Framework observability extensions for Agent365."""
+
+from .trace_instrumentor import AgentFrameworkInstrumentor
+
+__all__ = [
+    "AgentFrameworkInstrumentor",
+]

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13/microsoft_agents_a365/observability/extensions/agentframework/span_enricher.py

@@ -0,0 +1,51 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+from microsoft_agents_a365.observability.core.constants import (
+    EXECUTE_TOOL_OPERATION_NAME,
+    GEN_AI_INPUT_MESSAGES_KEY,
+    GEN_AI_OUTPUT_MESSAGES_KEY,
+    GEN_AI_TOOL_ARGS_KEY,
+    GEN_AI_TOOL_CALL_RESULT_KEY,
+    INVOKE_AGENT_OPERATION_NAME,
+)
+from microsoft_agents_a365.observability.core.exporters.enriched_span import EnrichedReadableSpan
+from opentelemetry.sdk.trace import ReadableSpan
+
+from .utils import extract_input_content, extract_output_content
+
+# Agent Framework specific attribute keys
+AF_TOOL_CALL_ARGUMENTS_KEY = "gen_ai.tool.call.arguments"
+AF_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result"
+
+
+def enrich_agent_framework_span(span: ReadableSpan) -> ReadableSpan:
+    """
+    Enricher function for Agent Framework spans.
+    """
+    extra_attributes = {}
+    attributes = span.attributes or {}
+
+    # Only extract content for invoke_agent spans
+    if span.name.startswith(INVOKE_AGENT_OPERATION_NAME):
+        # Extract all text content from input messages
+        input_messages = attributes.get(GEN_AI_INPUT_MESSAGES_KEY)
+        if input_messages:
+            extra_attributes[GEN_AI_INPUT_MESSAGES_KEY] = extract_input_content(input_messages)
+
+        output_messages = attributes.get(GEN_AI_OUTPUT_MESSAGES_KEY)
+        if output_messages:
+            extra_attributes[GEN_AI_OUTPUT_MESSAGES_KEY] = extract_output_content(output_messages)
+
+    # Map tool attributes for execute_tool spans
+    elif span.name.startswith(EXECUTE_TOOL_OPERATION_NAME):
+        if AF_TOOL_CALL_ARGUMENTS_KEY in attributes:
+            extra_attributes[GEN_AI_TOOL_ARGS_KEY] = attributes[AF_TOOL_CALL_ARGUMENTS_KEY]
+
+        if AF_TOOL_CALL_RESULT_KEY in attributes:
+            extra_attributes[GEN_AI_TOOL_CALL_RESULT_KEY] = attributes[AF_TOOL_CALL_RESULT_KEY]
+
+    if extra_attributes:
+        return EnrichedReadableSpan(span, extra_attributes)
+
+    return span

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/microsoft_agents_a365/observability/extensions/agentframework/span_processor.py

@@ -1,15 +1,12 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
 
-# Custom Span Processor
-
-from opentelemetry.sdk.trace.export import SpanProcessor
-
 from microsoft_agents_a365.observability.core.constants import (
-    GEN_AI_OPERATION_NAME_KEY,
     EXECUTE_TOOL_OPERATION_NAME,
     GEN_AI_EVENT_CONTENT,
+    GEN_AI_OPERATION_NAME_KEY,
 )
+from opentelemetry.sdk.trace.export import SpanProcessor
 
 
 class AgentFrameworkSpanProcessor(SpanProcessor):

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/microsoft_agents_a365/observability/extensions/agentframework/trace_instrumentor.py

@@ -7,8 +7,15 @@ from collections.abc import Collection
 from typing import Any
 
 from microsoft_agents_a365.observability.core.config import get_tracer_provider, is_configured
+from microsoft_agents_a365.observability.core.exporters.enriching_span_processor import (
+    register_span_enricher,
+    unregister_span_enricher,
+)
 from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
 
+from microsoft_agents_a365.observability.extensions.agentframework.span_enricher import (
+    enrich_agent_framework_span,
+)
 from microsoft_agents_a365.observability.extensions.agentframework.span_processor import (
     AgentFrameworkSpanProcessor,
 )
@@ -16,13 +23,12 @@ from microsoft_agents_a365.observability.extensions.agentframework.span_processo
 # -----------------------------
 # 3) The Instrumentor class
 # -----------------------------
-_instruments = ("agent-framework-azure-ai >= 1.0.0b251114",)
+_instruments = ("agent-framework-azure-ai >= 1.0.0",)
 
 
 class AgentFrameworkInstrumentor(BaseInstrumentor):
     """
-    Instruments Agent Framework:
-      • Installs your custom OTel SpanProcessor
+    Instruments Agent Framework with Agent365 observability.
     """
 
     def __init__(self):
@@ -37,13 +43,28 @@ class AgentFrameworkInstrumentor(BaseInstrumentor):
 
     def _instrument(self, **kwargs: Any) -> None:
         """
-        kwargs (all optional):
-        """
+        Instrument Agent Framework.
 
+        Args:
+            **kwargs: Optional configuration parameters.
+        """
         # Ensure we have an SDK TracerProvider
         provider = get_tracer_provider()
+
+        # Add processor for on_start modifications (rename spans, add attributes)
         self._processor = AgentFrameworkSpanProcessor()
         provider.add_span_processor(self._processor)
 
+        # Register enricher for on_end modifications
+        register_span_enricher(enrich_agent_framework_span)
+
     def _uninstrument(self, **kwargs: Any) -> None:
-        pass
+        """
+        Remove Agent Framework instrumentation.
+        """
+        # Unregister the enricher
+        unregister_span_enricher()
+
+        # Shutdown the processor
+        if hasattr(self, "_processor"):
+            self._processor.shutdown()

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13/microsoft_agents_a365/observability/extensions/agentframework/utils.py

@@ -0,0 +1,48 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+"""Utility functions for Agent Framework observability extensions."""
+
+from __future__ import annotations
+
+import json
+
+
+def extract_content_as_string_list(messages_json: str, role_filter: str | None = None) -> str:
+    """Extract content values from messages JSON and return as JSON string list."""
+    try:
+        messages = json.loads(messages_json)
+        if isinstance(messages, list):
+            contents = []
+            for msg in messages:
+                if isinstance(msg, dict):
+                    role = msg.get("role", "")
+
+                    # Filter by role if specified
+                    if role_filter and role != role_filter:
+                        continue
+
+                    # Handle Agent Framework format with "parts"
+                    parts = msg.get("parts")
+                    if parts and isinstance(parts, list):
+                        for part in parts:
+                            if isinstance(part, dict):
+                                part_type = part.get("type", "")
+                                # Only extract text content, not tool_call or tool_call_response
+                                if part_type == "text" and "content" in part:
+                                    contents.append(part["content"])
+            return json.dumps(contents)
+        return messages_json
+    except (json.JSONDecodeError, TypeError):
+        # If parsing fails, return as-is
+        return messages_json
+
+
+def extract_input_content(messages_json: str) -> str:
+    """Extract text content from user messages only."""
+    return extract_content_as_string_list(messages_json, role_filter="user")
+
+
+def extract_output_content(messages_json: str) -> str:
+    """Extract only assistant text content from output messages."""
+    return extract_content_as_string_list(messages_json, role_filter="assistant")

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/microsoft_agents_a365_observability_extensions_agent_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-a365-observability-extensions-agent-framework
-Version: 0.2.1.dev9
+Version: 0.2.1.dev13
 Summary: Agent Framework observability and tracing extensions for Microsoft Agent 365
 Author-email: Microsoft <support@microsoft.com>
 License-Expression: MIT
@@ -20,19 +20,19 @@ 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: opentelemetry-api>=1.36.0
-Requires-Dist: opentelemetry-sdk>=1.36.0
-Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Requires-Dist: microsoft-agents-a365-observability-core
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: opentelemetry-instrumentation
 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"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest>=7.0.0; extra == "test"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
 
 # microsoft-agents-a365-observability-extensions-agentframework
 

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/microsoft_agents_a365_observability_extensions_agent_framework.egg-info/SOURCES.txt

@@ -2,8 +2,10 @@ README.md
 pyproject.toml
 setup.py
 microsoft_agents_a365/observability/extensions/agentframework/__init__.py
+microsoft_agents_a365/observability/extensions/agentframework/span_enricher.py
 microsoft_agents_a365/observability/extensions/agentframework/span_processor.py
 microsoft_agents_a365/observability/extensions/agentframework/trace_instrumentor.py
+microsoft_agents_a365/observability/extensions/agentframework/utils.py
 microsoft_agents_a365_observability_extensions_agent_framework.egg-info/PKG-INFO
 microsoft_agents_a365_observability_extensions_agent_framework.egg-info/SOURCES.txt
 microsoft_agents_a365_observability_extensions_agent_framework.egg-info/dependency_links.txt

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13/microsoft_agents_a365_observability_extensions_agent_framework.egg-info/requires.txt

@@ -0,0 +1,15 @@
+microsoft-agents-a365-observability-core
+opentelemetry-api
+opentelemetry-sdk
+opentelemetry-instrumentation
+
+[dev]
+pytest
+pytest-asyncio
+ruff
+black
+mypy
+
+[test]
+pytest
+pytest-asyncio

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/pyproject.toml

@@ -25,10 +25,10 @@ classifiers = [
 license = "MIT"
 keywords = ["observability", "telemetry", "tracing", "opentelemetry", "agent-framework", "agents", "ai"]
 dependencies = [
-    "microsoft-agents-a365-observability-core >= 0.0.0",
-    "opentelemetry-api >= 1.36.0",
-    "opentelemetry-sdk >= 1.36.0",
-    "opentelemetry-instrumentation >= 0.47b0",
+    "microsoft-agents-a365-observability-core",
+    "opentelemetry-api",
+    "opentelemetry-sdk",
+    "opentelemetry-instrumentation",
 ]
 
 [project.urls]
@@ -39,15 +39,15 @@ Documentation = "https://github.com/microsoft/Agent365-python/tree/main/librarie
 
 [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",
+    "pytest",
+    "pytest-asyncio",
+    "ruff",
+    "black",
+    "mypy",
 ]
 test = [
-    "pytest >= 7.0.0",
-    "pytest-asyncio >= 0.21.0",
+    "pytest",
+    "pytest-asyncio",
 ]
 
 [tool.setuptools.packages.find]

{microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9 → microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev13}/setup.py

@@ -15,14 +15,13 @@ sys.path.insert(0, str(helper_path))
 
 from setup_utils import get_dynamic_dependencies  # noqa: E402
 
-# 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
+# Use exact version matching for internal dependencies:
+# - Internal packages get: == current_version (e.g., == 1.2.3)
+# - Ensures all SDK packages must be at the same version
+# - Prevents incompatibility issues from version mismatches
 setup(
     version=package_version,
     install_requires=get_dynamic_dependencies(
-        use_compatible_release=False,  # No upper bound
-        use_exact_match=False,  # Not exact match
+        use_exact_match=True,
     ),
 )

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9/microsoft_agents_a365/observability/extensions/agentframework/__init__.py

@@ -1,2 +0,0 @@
-# Copyright (c) Microsoft Corporation.
-# Licensed under the MIT License.

microsoft_agents_a365_observability_extensions_agent_framework-0.2.1.dev9/microsoft_agents_a365_observability_extensions_agent_framework.egg-info/requires.txt

@@ -1,15 +0,0 @@
-microsoft-agents-a365-observability-core>=0.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