Make sure we always have the AgentId in the ChatResponse

When converting to ChatResponse, the AgentRunResponse.AgentId should be set as an additional property.

Fixes microsoft/agent-framework#1574

Author: kzu

src/Agents/AgentExtensions.cs

@@ -0,0 +1,26 @@
+using System.ComponentModel;
+using System.Runtime.CompilerServices;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+
+namespace Devlooped.Agents.AI;
+
+/// <summary>
+/// Miscenalleous extension methods for agents.
+/// </summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public static class AgentExtensions
+{
+    /// <summary>Ensures the returned <see cref="ChatResponse"/> contains the <see cref="AgentRunResponse.AgentId"/> as an additional property.</summary>
+    /// <devdoc>Change priority to -10 and make EditorBrowsable.Never when https://github.com/microsoft/agent-framework/issues/1574 is fixed.</devdoc>
+    [OverloadResolutionPriority(10)]
+    public static ChatResponse AsChatResponse(this AgentRunResponse response)
+    {
+        var chatResponse = AgentRunResponseExtensions.AsChatResponse(response);
+
+        chatResponse.AdditionalProperties ??= [];
+        chatResponse.AdditionalProperties[nameof(response.AgentId)] = response.AgentId;
+
+        return chatResponse;
+    }
+}

src/Agents/Agents.csproj

@@ -27,6 +27,7 @@
     <PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.0.0-preview.251009.1" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="9.0.9" />
     <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.9" />
+    <PackageReference Include="PolySharp" Version="1.15.0" PrivateAssets="all" />
   </ItemGroup>
 
   <ItemGroup>

src/Tests/ConfigurableAgentTests.cs

@@ -249,5 +249,14 @@ public void CanSetGrokOptions()
         Assert.Equal(ReasoningEffort.High, grok.ReasoningEffort);
         Assert.Equal(GrokSearch.Off, grok.Search);
     }
+
+    [Fact]
+    public void Task()
+    {
+        var agent = new AgentRunResponse() { AgentId = "agent-123" };
+        var chat = agent.AsChatResponse();
+
+        Assert.Equal("agent-123", chat.AdditionalProperties!["AgentId"]);
+    }
 }