.Net Agents: Update experimental meta-data for graduation

dotnet/src/Agents/Abstractions/Agent.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
@@ -64,7 +65,10 @@ public abstract class Agent
     /// For example, two OpenAI Assistant agents each targeting a different Azure OpenAI endpoint
     /// would require their own channel. In this case, the endpoint could be expressed as an additional key.
     /// </remarks>
+    [Experimental("SKEXP0110")]
+#pragma warning disable CA1024 // Use properties where appropriate
     protected internal abstract IEnumerable<string> GetChannelKeys();
+#pragma warning restore CA1024 // Use properties where appropriate
 
     /// <summary>
     /// Produce an <see cref="AgentChannel"/> appropriate for the agent type.
@@ -75,6 +79,7 @@ public abstract class Agent
     /// Every agent conversation, or <see cref="AgentChat"/>, will establish one or more <see cref="AgentChannel"/>
     /// objects according to the specific <see cref="Agent"/> type.
     /// </remarks>
+    [Experimental("SKEXP0110")]
     protected internal abstract Task<AgentChannel> CreateChannelAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -87,6 +92,7 @@ public abstract class Agent
     /// Every agent conversation, or <see cref="AgentChat"/>, will establish one or more <see cref="AgentChannel"/>
     /// objects according to the specific <see cref="Agent"/> type.
     /// </remarks>
+    [Experimental("SKEXP0110")]
     protected internal abstract Task<AgentChannel> RestoreChannelAsync(string channelState, CancellationToken cancellationToken);
 
     private ILogger? _logger;

dotnet/src/Agents/Abstractions/AgentChannel.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
@@ -13,6 +14,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// <remarks>
 /// An agent provides it own <see cref="AgentChannel"/> via <see cref="Agent.CreateChannelAsync"/>.
 /// </remarks>
+[Experimental("SKEXP0110")]
 public abstract class AgentChannel
 {
     /// <summary>
@@ -83,6 +85,7 @@ protected internal abstract IAsyncEnumerable<StreamingChatMessageContent> Invoke
 /// An agent provides it own <see cref="AgentChannel"/> via <see cref="Agent.CreateChannelAsync"/>.
 /// This class is a convenience upcast to an agent for <see cref="AgentChannel{TAgent}.InvokeAsync(TAgent, CancellationToken)"/>.
 /// </remarks>
+[Experimental("SKEXP0110")]
 public abstract class AgentChannel<TAgent> : AgentChannel where TAgent : Agent
 {
     /// <summary>

dotnet/src/Agents/Abstractions/AgentChat.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.CompilerServices;
 using System.Text.Json;
@@ -21,6 +22,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// <see cref="AgentChat" /> instances don't support concurrent invocation and
 /// will throw an exception if concurrent activity is attempted for any public method.
 /// </remarks>
+[Experimental("SKEXP0110")]
 public abstract class AgentChat
 {
     private readonly BroadcastQueue _broadcastQueue;

dotnet/src/Agents/Abstractions/AgentChatSerializer.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Text.Json;
 using System.Text.Json.Serialization;
@@ -11,6 +12,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// <summary>
 /// Serializes and deserializes an <see cref="AgentChat"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 public sealed class AgentChatSerializer
 {
     private readonly AgentChatState _state;

dotnet/src/Agents/Abstractions/Agents.Abstractions.csproj

@@ -1,12 +1,12 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <!-- THIS PROPERTY GROUP MUST COME FIRST -->
     <AssemblyName>Microsoft.SemanticKernel.Agents.Abstractions</AssemblyName>
     <RootNamespace>Microsoft.SemanticKernel.Agents</RootNamespace>
     <TargetFrameworks>net8.0;netstandard2.0</TargetFrameworks>
     <EnablePackageValidation>false</EnablePackageValidation>
-    <VersionSuffix>alpha</VersionSuffix>
+    <VersionSuffix>rc</VersionSuffix>
   </PropertyGroup>
 
   <Import Project="$(RepoRoot)/dotnet/nuget/nuget-package.props" />

dotnet/src/Agents/Abstractions/AggregatorAgent.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Text.Json;
 using System.Threading;
 using System.Threading.Tasks;
@@ -12,6 +13,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// Defines the relationship between the internal aggregated chat and the chat
 /// with which <see cref="AggregatorAgent"/> is participating.
 /// </summary>
+[Experimental("SKEXP0110")]
 public enum AggregatorMode
 {
     /// <summary>
@@ -29,6 +31,7 @@ public enum AggregatorMode
 /// Allows an <see cref="AgentChat"/> to participate in another <see cref="AgentChat"/> as an <see cref="Agent"/>.
 /// </summary>
 /// <param name="chatProvider">A factory method that produces a new <see cref="AgentChat"/> instance.</param>
+[Experimental("SKEXP0110")]
 public sealed class AggregatorAgent(Func<AgentChat> chatProvider) : Agent
 {
     /// <summary>

dotnet/src/Agents/Abstractions/AggregatorChannel.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.CompilerServices;
 using System.Text.Json;
@@ -11,6 +12,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// <summary>
 /// Adapt channel contract to underlying <see cref="AgentChat"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 internal sealed class AggregatorChannel(AgentChat chat) : AgentChannel<AggregatorAgent>
 {
     private readonly AgentChat _chat = chat;

dotnet/src/Agents/Abstractions/Internal/BroadcastQueue.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using ChannelQueue = System.Collections.Generic.Queue<System.Collections.Generic.IReadOnlyList<Microsoft.SemanticKernel.ChatMessageContent>>;
@@ -21,6 +22,7 @@ namespace Microsoft.SemanticKernel.Agents.Internal;
 /// <see cref="BroadcastQueue"/> is never invoked concurrently, which eliminates
 /// race conditions over the queue dictionary.
 /// </remarks>
+[Experimental("SKEXP0110")]
 internal sealed class BroadcastQueue
 {
     private readonly Dictionary<string, QueueReference> _queues = [];

dotnet/src/Agents/Abstractions/Internal/ChannelReference.cs

@@ -1,9 +1,12 @@
 // Copyright (c) Microsoft. All rights reserved.
+using System.Diagnostics.CodeAnalysis;
+
 namespace Microsoft.SemanticKernel.Agents.Internal;
 
 /// <summary>
 /// Tracks channel along with its hashed key.
 /// </summary>
+[Experimental("SKEXP0110")]
 internal readonly struct ChannelReference(AgentChannel channel, string hash)
 {
     /// <summary>

dotnet/src/Agents/Abstractions/Logging/AggregatorAgentLogMessages.cs

@@ -15,6 +15,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// generate logging code at compile time to achieve optimized code.
 /// </remarks>
 [ExcludeFromCodeCoverage]
+[Experimental("SKEXP0110")]
 internal static partial class AggregatorAgentLogMessages
 {
     /// <summary>

dotnet/src/Agents/Abstractions/Serialization/ChatMessageReference.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text.Json.Serialization;
 using Microsoft.SemanticKernel.ChatCompletion;
@@ -10,6 +11,7 @@ namespace Microsoft.SemanticKernel.Agents.Serialization;
 /// Represents a <see cref="ChatMessageContent"/> for serialization without metadata.
 /// </summary>
 /// <param name="message">The referenced message</param>
+[Experimental("SKEXP0110")]
 public sealed class ChatMessageReference(ChatMessageContent message)
 {
     /// <summary>

dotnet/src/Agents/AzureAI/Agents.AzureAI.csproj

@@ -7,7 +7,7 @@
     <TargetFrameworks>net8.0;netstandard2.0</TargetFrameworks>
     <NoWarn>$(NoWarn);SKEXP0110</NoWarn>
     <EnablePackageValidation>false</EnablePackageValidation>
-    <VersionSuffix>alpha</VersionSuffix>
+    <VersionSuffix>preview</VersionSuffix>
   </PropertyGroup>
 
   <Import Project="$(RepoRoot)/dotnet/nuget/nuget-package.props" />

dotnet/src/Agents/Core/AgentGroupChat.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.CompilerServices;
 using System.Threading;
@@ -15,6 +16,7 @@ namespace Microsoft.SemanticKernel.Agents;
 /// <summary>
 /// Represents an <see cref="AgentChat"/> that supports multi-turn interactions.
 /// </summary>
+[Experimental("SKEXP0110")]
 public sealed class AgentGroupChat : AgentChat
 {
     private readonly HashSet<string> _agentIds; // Efficient existence test O(1) vs O(n) for list.

dotnet/src/Agents/Core/Agents.Core.csproj

@@ -1,13 +1,12 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <!-- THIS PROPERTY GROUP MUST COME FIRST -->
     <AssemblyName>Microsoft.SemanticKernel.Agents.Core</AssemblyName>
     <RootNamespace>Microsoft.SemanticKernel.Agents</RootNamespace>
     <TargetFrameworks>net8.0;netstandard2.0</TargetFrameworks>
-    <NoWarn>$(NoWarn);SKEXP0110</NoWarn>
     <EnablePackageValidation>false</EnablePackageValidation>
-    <VersionSuffix>alpha</VersionSuffix>
+    <VersionSuffix>rc</VersionSuffix>
   </PropertyGroup>
 
   <Import Project="$(RepoRoot)/dotnet/nuget/nuget-package.props" />

dotnet/src/Agents/Core/Chat/AgentGroupChatSettings.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -11,6 +12,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// <remarks>
 /// The default behavior results in no agent selection.
 /// </remarks>
+[Experimental("SKEXP0110")]
 public class AgentGroupChatSettings
 {
     /// <summary>

dotnet/src/Agents/Core/Chat/AggregatorTerminationStrategy.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -9,6 +10,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// <summary>
 /// Defines aggregation behavior for <see cref="AggregatorTerminationStrategy"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 public enum AggregateTerminationCondition
 {
     /// <summary>
@@ -26,6 +28,7 @@ public enum AggregateTerminationCondition
 /// Provides methods to aggregate a set of <see cref="TerminationStrategy"/> objects.
 /// </summary>
 /// <param name="strategies">The set of strategies upon which to aggregate.</param>
+[Experimental("SKEXP0110")]
 public sealed class AggregatorTerminationStrategy(params TerminationStrategy[] strategies) : TerminationStrategy
 {
     private readonly TerminationStrategy[] _strategies = strategies;

dotnet/src/Agents/Core/Chat/KernelFunctionSelectionStrategy.cs

@@ -2,6 +2,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -15,6 +16,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// </summary>
 /// <param name="function">A <see cref="KernelFunction"/> used for selection criteria.</param>
 /// <param name="kernel">A kernel instance with services for function execution.</param>
+[Experimental("SKEXP0110")]
 public class KernelFunctionSelectionStrategy(KernelFunction function, Kernel kernel) : SelectionStrategy
 {
     /// <summary>

dotnet/src/Agents/Core/Chat/KernelFunctionTerminationStrategy.cs

@@ -2,6 +2,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -15,6 +16,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// </summary>
 /// <param name="function">A <see cref="KernelFunction"/> used for termination criteria.</param>
 /// <param name="kernel">A kernel instance with services for function execution.</param>
+[Experimental("SKEXP0110")]
 public class KernelFunctionTerminationStrategy(KernelFunction function, Kernel kernel) : TerminationStrategy
 {
     /// <summary>

dotnet/src/Agents/Core/Chat/RegExTerminationStrategy.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text.RegularExpressions;
 using System.Threading;
@@ -11,6 +12,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// Signals termination when the most recent message matches against the defined regular expressions
 /// for the specified agent (if provided).
 /// </summary>
+[Experimental("SKEXP0110")]
 public sealed class RegexTerminationStrategy : TerminationStrategy
 {
     private readonly Regex[] _expressions;

dotnet/src/Agents/Core/Chat/SelectionStrategy.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
@@ -10,6 +11,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// <summary>
 /// Provides a base strategy class for selecting the next agent for an <see cref="AgentGroupChat"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 public abstract class SelectionStrategy
 {
     /// <summary>

dotnet/src/Agents/Core/Chat/SequentialSelectionStrategy.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.SemanticKernel.Agents.Extensions;
@@ -10,6 +11,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// Represents a round-robin turn-taking strategy. Agent order is based on the order
 /// in which they joined <see cref="AgentGroupChat"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 public sealed class SequentialSelectionStrategy : SelectionStrategy
 {
     private int _index = -1;

dotnet/src/Agents/Core/Chat/TerminationStrategy.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -12,6 +13,7 @@ namespace Microsoft.SemanticKernel.Agents.Chat;
 /// <summary>
 /// Provides a base strategy class for defining termination criteria for an <see cref="AgentGroupChat"/>.
 /// </summary>
+[Experimental("SKEXP0110")]
 public abstract class TerminationStrategy
 {
     /// <summary>