.NET: Move SO agent to samples

dotnet/src/Microsoft.Agents.AI/StructuredOutput/AIAgentBuilderExtensions.cs → dotnet/samples/GettingStarted/Agents/Agent_Step05_StructuredOutput/AIAgentBuilderExtensions.cs

@@ -1,16 +1,15 @@
 // Copyright (c) Microsoft. All rights reserved.
 
-using System;
+using Microsoft.Agents.AI;
 using Microsoft.Extensions.AI;
 using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Shared.Diagnostics;
 
-namespace Microsoft.Agents.AI;
+namespace SampleApp;
 
 /// <summary>
 /// Provides extension methods for adding structured output capabilities to <see cref="AIAgentBuilder"/> instances.
 /// </summary>
-public static class AIAgentBuilderExtensions
+internal static class AIAgentBuilderExtensions
 {
     /// <summary>
     /// Adds structured output capabilities to the agent pipeline, enabling conversion of text responses to structured JSON format.
@@ -35,12 +34,16 @@ public static class AIAgentBuilderExtensions
     public static AIAgentBuilder UseStructuredOutput(
         this AIAgentBuilder builder,
         IChatClient? chatClient = null,
-        Func<StructuredOutputAgentOptions>? optionsFactory = null) =>
-        Throw.IfNull(builder).Use((innerAgent, services) =>
+        Func<StructuredOutputAgentOptions>? optionsFactory = null)
+    {
+        ArgumentNullException.ThrowIfNull(builder);
+
+        return builder.Use((innerAgent, services) =>
         {
             chatClient ??= services?.GetService<IChatClient>()
                 ?? throw new InvalidOperationException($"No {nameof(IChatClient)} was provided and none could be resolved from the service provider. Either provide an {nameof(IChatClient)} explicitly or register one in the dependency injection container.");
 
             return new StructuredOutputAgent(innerAgent, chatClient, optionsFactory?.Invoke());
         });
+    }
 }

dotnet/src/Microsoft.Agents.AI/StructuredOutput/StructuredOutputAgent.cs → dotnet/samples/GettingStarted/Agents/Agent_Step05_StructuredOutput/StructuredOutputAgent.cs

@@ -1,13 +1,9 @@
 // Copyright (c) Microsoft. All rights reserved.
 
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
+using Microsoft.Agents.AI;
 using Microsoft.Extensions.AI;
-using Microsoft.Shared.Diagnostics;
 
-namespace Microsoft.Agents.AI;
+namespace SampleApp;
 
 /// <summary>
 /// A delegating AI agent that converts text responses from an inner AI agent into structured output using a chat client.
@@ -37,7 +33,7 @@ internal sealed class StructuredOutputAgent : DelegatingAIAgent
     public StructuredOutputAgent(AIAgent innerAgent, IChatClient chatClient, StructuredOutputAgentOptions? options = null)
         : base(innerAgent)
     {
-        this._chatClient = Throw.IfNull(chatClient);
+        this._chatClient = chatClient ?? throw new ArgumentNullException(nameof(chatClient));
         this._agentOptions = options;
     }
 

dotnet/src/Microsoft.Agents.AI/StructuredOutput/StructuredOutputAgentOptions.cs → dotnet/samples/GettingStarted/Agents/Agent_Step05_StructuredOutput/StructuredOutputAgentOptions.cs

@@ -1,13 +1,16 @@
 // Copyright (c) Microsoft. All rights reserved.
 
+using Microsoft.Agents.AI;
 using Microsoft.Extensions.AI;
 
-namespace Microsoft.Agents.AI;
+namespace SampleApp;
 
 /// <summary>
 /// Represents configuration options for a <see cref="StructuredOutputAgent"/>.
 /// </summary>
-public sealed class StructuredOutputAgentOptions
+#pragma warning disable CA1812 // Instantiated via AIAgentBuilderExtensions.UseStructuredOutput optionsFactory parameter
+internal sealed class StructuredOutputAgentOptions
+#pragma warning restore CA1812
 {
     /// <summary>
     /// Gets or sets the system message to use when invoking the chat client for structured output conversion.

dotnet/src/Microsoft.Agents.AI/StructuredOutput/StructuredOutputAgentResponse.cs → dotnet/samples/GettingStarted/Agents/Agent_Step05_StructuredOutput/StructuredOutputAgentResponse.cs

@@ -1,21 +1,22 @@
 // Copyright (c) Microsoft. All rights reserved.
 
+using Microsoft.Agents.AI;
 using Microsoft.Extensions.AI;
 
-namespace Microsoft.Agents.AI;
+namespace SampleApp;
 
 /// <summary>
 /// Represents an agent response that contains structured output and
 /// the original agent response from which the structured output was generated.
 /// </summary>
-public class StructuredOutputAgentResponse : AgentResponse
+internal sealed class StructuredOutputAgentResponse : AgentResponse
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="StructuredOutputAgentResponse"/> class.
     /// </summary>
     /// <param name="chatResponse">The <see cref="ChatResponse"/> containing the structured output.</param>
     /// <param name="agentResponse">The original <see cref="AgentResponse"/> from the inner agent.</param>
-    internal StructuredOutputAgentResponse(ChatResponse chatResponse, AgentResponse agentResponse) : base(chatResponse)
+    public StructuredOutputAgentResponse(ChatResponse chatResponse, AgentResponse agentResponse) : base(chatResponse)
     {
         this.OriginalResponse = agentResponse;
     }