From b22d3813ac41dbe79eeee973e76dc5c966193841 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 24 Apr 2026 20:46:36 +0000
Subject: [PATCH 1/2] Initial plan


From 872e4cbd21bccfec142ab3c8e949f3edb8d38d6c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 24 Apr 2026 20:48:58 +0000
Subject: [PATCH 2/2] Fix broken cross-reference links in message_mapper.py
 docstrings

Agent-Logs-Url: https://github.com/microsoft/Agent365-python/sessions/87826ea9-9bc3-47b2-9b3b-b03fb3f647c6

Co-authored-by: JimDaly <6353736+JimDaly@users.noreply.github.com>
---
 .../extensions/agentframework/message_mapper.py           | 8 ++++----
 .../observability/extensions/openai/message_mapper.py     | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/libraries/microsoft-agents-a365-observability-extensions-agentframework/microsoft_agents_a365/observability/extensions/agentframework/message_mapper.py b/libraries/microsoft-agents-a365-observability-extensions-agentframework/microsoft_agents_a365/observability/extensions/agentframework/message_mapper.py
index e5e8c161..79f3d580 100644
--- a/libraries/microsoft-agents-a365-observability-extensions-agentframework/microsoft_agents_a365/observability/extensions/agentframework/message_mapper.py
+++ b/libraries/microsoft-agents-a365-observability-extensions-agentframework/microsoft_agents_a365/observability/extensions/agentframework/message_mapper.py
@@ -5,7 +5,7 @@
 
 Agent Framework sets ``gen_ai.input.messages`` / ``gen_ai.output.messages`` as span
 tags containing JSON arrays of ``{role, parts[{type, content}], finish_reason?}``.
-This mapper converts them to :class:`InputMessages` / :class:`OutputMessages`.
+This mapper converts them to ``InputMessages`` / ``OutputMessages``.
 """
 
 from __future__ import annotations
@@ -49,7 +49,7 @@ def map_input_messages(messages_json: str) -> str | None:
         messages_json: The raw JSON string from the span attribute.
 
     Returns:
-        Serialized :class:`InputMessages` JSON string, or ``None`` if the
+        Serialized ``InputMessages`` JSON string, or ``None`` if the
         input is empty or cannot be parsed.
     """
     try:
@@ -83,7 +83,7 @@ def map_output_messages(messages_json: str) -> str | None:
         messages_json: The raw JSON string from the span attribute.
 
     Returns:
-        Serialized :class:`OutputMessages` JSON string, or ``None`` if the
+        Serialized ``OutputMessages`` JSON string, or ``None`` if the
         input is empty or cannot be parsed.
     """
     try:
@@ -119,7 +119,7 @@ def map_output_messages(messages_json: str) -> str | None:
 
 
 def _map_role(role: str | None, default: MessageRole) -> MessageRole:
-    """Map a raw role string to a :class:`MessageRole` enum."""
+    """Map a raw role string to a ``MessageRole`` enum."""
     if not role:
         return default
     return _ROLE_MAP.get(role.lower(), default)
diff --git a/libraries/microsoft-agents-a365-observability-extensions-openai/microsoft_agents_a365/observability/extensions/openai/message_mapper.py b/libraries/microsoft-agents-a365-observability-extensions-openai/microsoft_agents_a365/observability/extensions/openai/message_mapper.py
index 6cd5ea49..515fdadc 100644
--- a/libraries/microsoft-agents-a365-observability-extensions-openai/microsoft_agents_a365/observability/extensions/openai/message_mapper.py
+++ b/libraries/microsoft-agents-a365-observability-extensions-openai/microsoft_agents_a365/observability/extensions/openai/message_mapper.py
@@ -56,7 +56,7 @@ def map_input_messages(messages_json: str) -> str | None:
         messages_json: The raw JSON string from the span attribute.
 
     Returns:
-        Serialized :class:`InputMessages` JSON string, or ``None`` if the
+        Serialized ``InputMessages`` JSON string, or ``None`` if the
         input is empty or cannot be parsed.
     """
     if not messages_json:
@@ -82,7 +82,7 @@ def map_output_messages(messages_json: str) -> str | None:
         messages_json: The raw JSON string from the span attribute.
 
     Returns:
-        Serialized :class:`OutputMessages` JSON string, or ``None`` if the
+        Serialized ``OutputMessages`` JSON string, or ``None`` if the
         input is empty or cannot be parsed.
     """
     if not messages_json: