Migrate to new generator (Azure#55464)

* Migrate to new generator

* newline

* api

* inv

* inv

* regen

* api

* regen

* add missing convenience methods

* add missing convenience methods

Author: JoshLove-msft

doc/GeneratorMigration/Library_Inventory.md

@@ -20,8 +20,8 @@
   - Old TypeSpec: 1
 - Data Plane (DPG): 144
   - Autorest/Swagger: 58
-  - New Emitter (TypeSpec): 30
-  - Old TypeSpec: 8
+  - New Emitter (TypeSpec): 31
+  - Old TypeSpec: 7
 - Provisioning: 31
   - Custom reflection-based generator: 31
 - No generator: 48
@@ -31,7 +31,7 @@
 
 Libraries that provide client APIs for Azure services and have been migrated to the new TypeSpec emitter.
 
-**Migration Status**: 30 / 38 (78.9%)
+**Migration Status**: 31 / 38 (81.6%)
 
 | Service | Library | New Emitter |
 | ------- | ------- | ----------- |
@@ -41,7 +41,7 @@ Libraries that provide client APIs for Azure services and have been migrated to
 | anomalydetector | Azure.AI.AnomalyDetector |  |
 | appconfiguration | Azure.Data.AppConfiguration | ✅ |
 | batch | Azure.Compute.Batch | ✅ |
-| cognitivelanguage | Azure.AI.Language.Conversations |  |
+| cognitivelanguage | Azure.AI.Language.Conversations | ✅ |
 | cognitivelanguage | Azure.AI.Language.Conversations.Authoring |  |
 | cognitivelanguage | Azure.AI.Language.QuestionAnswering.Authoring | ✅ |
 | cognitivelanguage | Azure.AI.Language.QuestionAnswering.Inference | ✅ |

sdk/cognitivelanguage/Azure.AI.Language.Conversations/api/Azure.AI.Language.Conversations.net10.0.cs

@@ -0,0 +1,3 @@
+{
+  "apiVersion": "2025-11-15-preview"
+}

sdk/cognitivelanguage/Azure.AI.Language.Conversations/api/Azure.AI.Language.Conversations.net8.0.cs

@@ -9,7 +9,6 @@
     <TargetFrameworks>$(RequiredTargetFrameworks)</TargetFrameworks>
     <IncludeOperationsSharedSource>true</IncludeOperationsSharedSource>
     <NoWarn>$(NoWarn);AZC0034;AZC0035</NoWarn>
-    <IncludeAutorestDependency>true</IncludeAutorestDependency>
   </PropertyGroup>
 
   <ItemGroup>

sdk/cognitivelanguage/Azure.AI.Language.Conversations/api/Azure.AI.Language.Conversations.netstandard2.0.cs

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
 using System;
@@ -7,39 +7,21 @@
 using Azure.AI.Language.Conversations.Models;
 using Azure.Core;
 using Azure.Core.Pipeline;
+using Microsoft.TypeSpec.Generator.Customizations;
 
 namespace Azure.AI.Language.Conversations
 {
+    /// <summary>
+    /// The <see cref="ConversationAnalysisClient"/> allows for the analysis of conversations.
+    /// </summary>
+    [CodeGenType("ConversationAnalysis")]
     public partial class ConversationAnalysisClient
     {
         /// <summary>
         /// Gets the service endpoint for this client.
         /// </summary>
         public virtual Uri Endpoint => _endpoint;
 
-        private readonly TokenCredential _tokenCredential;
-
-        /// <summary> Initializes a new instance of ConversationAnalysisClient. </summary>
-        /// <param name="endpoint"> Supported Cognitive Services endpoint (e.g., https://&lt;resource-name&gt;.cognitiveservices.azure.com). </param>
-        /// <param name="credential"> A credential used to authenticate to an Azure Service. </param>
-        /// <param name="options"> The options for configuring the client. </param>
-        /// <exception cref="ArgumentNullException"> <paramref name="endpoint"/> or <paramref name="credential"/> is null. </exception>
-        public ConversationAnalysisClient(Uri endpoint, TokenCredential credential, ConversationsClientOptions options)
-        {
-            Argument.AssertNotNull(endpoint, nameof(endpoint));
-            Argument.AssertNotNull(credential, nameof(credential));
-            options ??= new ConversationsClientOptions();
-
-            var authorizationScope = $"{(string.IsNullOrEmpty(options.Audience?.ToString()) ? ConversationsAudience.AzurePublicCloud : options.Audience)}/.default";
-
-            _tokenCredential = credential;
-
-            ClientDiagnostics = new ClientDiagnostics(options, true);
-            _pipeline = HttpPipelineBuilder.Build(options, new HttpPipelinePolicy[] { new BearerTokenAuthenticationPolicy(credential, authorizationScope) }, Array.Empty<HttpPipelinePolicy>(), new ResponseClassifier());
-            _endpoint = endpoint;
-            _apiVersion = options.Version;
-        }
-
         /// <summary>
         /// Convenience method to submit an analysis long running operation for conversations and return the response once processed.
         /// <param name="analyzeConversationOperationInput"> The input for the analyze conversations operation. </param>
@@ -52,12 +34,12 @@ public virtual Response<AnalyzeConversationOperationState> AnalyzeConversations(
         {
             Argument.AssertNotNull(analyzeConversationOperationInput, nameof(analyzeConversationOperationInput));
 
-            using RequestContent content = analyzeConversationOperationInput.ToRequestContent();
-            RequestContext context = FromCancellationToken(cancellationToken);
+            using RequestContent content = analyzeConversationOperationInput;
+            RequestContext context = cancellationToken.ToRequestContext();
 
             Operation<BinaryData> operation = AnalyzeConversations(WaitUntil.Completed, content, context);
             Response response = operation.GetRawResponse();
-            return Response.FromValue(AnalyzeConversationOperationState.FromResponse(response), response);
+            return Response.FromValue((AnalyzeConversationOperationState)response, response);
         }
 
         /// <summary>
@@ -72,44 +54,34 @@ public virtual async Task<Response<AnalyzeConversationOperationState>> AnalyzeCo
         {
             Argument.AssertNotNull(analyzeConversationOperationInput, nameof(analyzeConversationOperationInput));
 
-            using RequestContent content = analyzeConversationOperationInput.ToRequestContent();
-            RequestContext context = FromCancellationToken(cancellationToken);
+            using RequestContent content = analyzeConversationOperationInput;
+            RequestContext context = cancellationToken.ToRequestContext();
 
             Operation<BinaryData> operation = await AnalyzeConversationsAsync(WaitUntil.Completed, content, context).ConfigureAwait(false);
             Response response = operation.GetRawResponse();
-            return Response.FromValue(AnalyzeConversationOperationState.FromResponse(response), response);
+            return Response.FromValue((AnalyzeConversationOperationState)response, response);
         }
 
         /// <summary>
         /// [Protocol Method] Submits an analysis long running operation for conversations and return the response once processed.
-        /// <list type="bullet">
-        /// <item>
-        /// <description>
-        /// This <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/ProtocolMethods.md">protocol method</see> allows explicit creation of the request and processing of the response for advanced scenarios.
-        /// </description>
-        /// </item>
-        /// <item>
-        /// <description>
-        /// Please try the simpler <see cref="AnalyzeConversations(AnalyzeConversationOperationInput,CancellationToken)"/> convenience overload with strongly typed models first.
-        /// </description>
-        /// </item>
-        /// </list>
         /// </summary>
-        /// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
+        /// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. </param>
         /// <param name="content"> The content to send as the body of the request. </param>
         /// <param name="context"> The request context, which can override default behaviors of the client pipeline on a per-call basis. </param>
         /// <exception cref="ArgumentNullException"> <paramref name="content"/> is null. </exception>
         /// <exception cref="RequestFailedException"> Service returned a non-success status code. </exception>
-        /// <returns> The <see cref="Operation"/> representing an asynchronous operation on the service. </returns>
+        /// <returns> The <see cref="Operation{T}"/> representing an asynchronous operation on the service. </returns>
         public virtual Operation<BinaryData> AnalyzeConversations(WaitUntil waitUntil, RequestContent content, RequestContext context = default)
         {
             using DiagnosticScope scope = ClientDiagnostics.CreateScope("ConversationAnalysisClient.AnalyzeConversations");
             scope.Start();
 
             try
             {
+                Argument.AssertNotNull(content, nameof(content));
+
                 using HttpMessage message = CreateAnalyzeConversationSubmitOperationRequest(content, context);
-                return ProtocolOperationHelpers.ProcessMessage(_pipeline, message, ClientDiagnostics, "ConversationAnalysisClient.AnalyzeConversations", OperationFinalStateVia.OperationLocation, context, WaitUntil.Completed);
+                return ProtocolOperationHelpers.ProcessMessage(Pipeline, message, ClientDiagnostics, "ConversationAnalysisClient.AnalyzeConversations", OperationFinalStateVia.OperationLocation, context, waitUntil);
             }
             catch (Exception e)
             {
@@ -120,34 +92,24 @@ public virtual Operation<BinaryData> AnalyzeConversations(WaitUntil waitUntil, R
 
         /// <summary>
         /// [Protocol Method] Submits an analysis long running operation for conversations and return the response once processed.
-        /// <list type="bullet">
-        /// <item>
-        /// <description>
-        /// This <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/ProtocolMethods.md">protocol method</see> allows explicit creation of the request and processing of the response for advanced scenarios.
-        /// </description>
-        /// </item>
-        /// <item>
-        /// <description>
-        /// Please try the simpler <see cref="AnalyzeConversationsAsync(AnalyzeConversationOperationInput,CancellationToken)"/> convenience overload with strongly typed models first.
-        /// </description>
-        /// </item>
-        /// </list>
         /// </summary>
-        /// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. For more information on long-running operations, please see <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/LongRunningOperations.md"> Azure.Core Long-Running Operation samples</see>. </param>
+        /// <param name="waitUntil"> <see cref="WaitUntil.Completed"/> if the method should wait to return until the long-running operation has completed on the service; <see cref="WaitUntil.Started"/> if it should return after starting the operation. </param>
         /// <param name="content"> The content to send as the body of the request. </param>
         /// <param name="context"> The request context, which can override default behaviors of the client pipeline on a per-call basis. </param>
         /// <exception cref="ArgumentNullException"> <paramref name="content"/> is null. </exception>
         /// <exception cref="RequestFailedException"> Service returned a non-success status code. </exception>
-        /// <returns> The <see cref="Operation"/> representing an asynchronous operation on the service. </returns>
+        /// <returns> The <see cref="Operation{T}"/> representing an asynchronous operation on the service. </returns>
         public virtual async Task<Operation<BinaryData>> AnalyzeConversationsAsync(WaitUntil waitUntil, RequestContent content, RequestContext context = default)
         {
             using DiagnosticScope scope = ClientDiagnostics.CreateScope("ConversationAnalysisClient.AnalyzeConversations");
             scope.Start();
 
             try
             {
+                Argument.AssertNotNull(content, nameof(content));
+
                 using HttpMessage message = CreateAnalyzeConversationSubmitOperationRequest(content, context);
-                return await ProtocolOperationHelpers.ProcessMessageAsync(_pipeline, message, ClientDiagnostics, "ConversationAnalysisClient.AnalyzeConversations", OperationFinalStateVia.OperationLocation, context, WaitUntil.Completed).ConfigureAwait(false);
+                return await ProtocolOperationHelpers.ProcessMessageAsync(Pipeline, message, ClientDiagnostics, "ConversationAnalysisClient.AnalyzeConversations", OperationFinalStateVia.OperationLocation, context, waitUntil).ConfigureAwait(false);
             }
             catch (Exception e)
             {

sdk/cognitivelanguage/Azure.AI.Language.Conversations/metadata.json

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
 using System;
@@ -7,10 +7,14 @@
 using Azure.AI.Language.Conversations.Authoring;
 using Azure.Core;
 using Azure.Core.Extensions;
+using Microsoft.TypeSpec.Generator.Customizations;
 
 namespace Microsoft.Extensions.Azure
 {
-    [CodeGenModel("AILanguageConversationsClientBuilderExtensions")]
+    /// <summary>
+    /// Extension methods to add <see cref="ConversationAnalysisClient"/> to the Azure client builder.
+    /// </summary>
+    [CodeGenType("LanguageConversationsClientBuilderExtensions")]
     public static partial class ConversationAnalysisClientExtensions
     {
         /// <summary> Registers a <see cref="ConversationAuthoringClient"/> instance. </summary>

sdk/cognitivelanguage/Azure.AI.Language.Conversations/src/Azure.AI.Language.Conversations.csproj

@@ -1,11 +1,15 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
 using Azure.Core;
+using Microsoft.TypeSpec.Generator.Customizations;
 
 namespace Azure.AI.Language.Conversations
 {
-    [CodeGenModel("ConversationAnalysisClientOptions")]
+    /// <summary>
+    /// Client options for <see cref="ConversationAnalysisClient"/>.
+    /// </summary>
+    [CodeGenType("ConversationAnalysisClientOptions")]
     public partial class ConversationsClientOptions : ClientOptions
     {
         /// <summary>

sdk/cognitivelanguage/Azure.AI.Language.Conversations/src/ConversationAnalysisClient.cs

@@ -1,11 +1,15 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
 using Azure.Core;
+using Microsoft.TypeSpec.Generator.Customizations;
 
 namespace Azure.AI.Language.Conversations
 {
-    [CodeGenModel("AILanguageConversationsModelFactory")]
+    /// <summary>
+    /// Model factory for read-only models in the Conversations namespace.
+    /// </summary>
+    [CodeGenType("LanguageConversationsModelFactory")]
     public static partial class ConversationsModelFactory
     {
     }