feat:Unify and simplify Cohere API schema definitions and update code examples

src/libs/Cohere/Generated/Cohere..JsonSerializerContext.g.cs

@@ -15,8 +15,8 @@ namespace Cohere
         { 
             typeof(global::Cohere.JsonConverters.CitationTypeJsonConverter),
             typeof(global::Cohere.JsonConverters.CitationTypeNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.ChatTextContentTypeJsonConverter),
-            typeof(global::Cohere.JsonConverters.ChatTextContentTypeNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.TextContentTypeJsonConverter),
+            typeof(global::Cohere.JsonConverters.TextContentTypeNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.AssistantMessageContentVariant2ItemDiscriminatorTypeJsonConverter),
             typeof(global::Cohere.JsonConverters.AssistantMessageContentVariant2ItemDiscriminatorTypeNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.AssistantMessageRoleJsonConverter),
@@ -51,14 +51,14 @@ namespace Cohere
             typeof(global::Cohere.JsonConverters.ImageUrlDetailNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.ContentTypeJsonConverter),
             typeof(global::Cohere.JsonConverters.ContentTypeNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.MessageContentDiscriminatorTypeJsonConverter),
-            typeof(global::Cohere.JsonConverters.MessageContentDiscriminatorTypeNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.UserMessageV2RoleJsonConverter),
-            typeof(global::Cohere.JsonConverters.UserMessageV2RoleNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.SystemMessageV2ContentVariant2ItemDiscriminatorTypeJsonConverter),
-            typeof(global::Cohere.JsonConverters.SystemMessageV2ContentVariant2ItemDiscriminatorTypeNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.SystemMessageV2RoleJsonConverter),
-            typeof(global::Cohere.JsonConverters.SystemMessageV2RoleNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.ContentDiscriminatorTypeJsonConverter),
+            typeof(global::Cohere.JsonConverters.ContentDiscriminatorTypeNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.UserMessageRoleJsonConverter),
+            typeof(global::Cohere.JsonConverters.UserMessageRoleNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.SystemMessageContentVariant2ItemDiscriminatorTypeJsonConverter),
+            typeof(global::Cohere.JsonConverters.SystemMessageContentVariant2ItemDiscriminatorTypeNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.SystemMessageRoleJsonConverter),
+            typeof(global::Cohere.JsonConverters.SystemMessageRoleNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.DocumentContentTypeJsonConverter),
             typeof(global::Cohere.JsonConverters.DocumentContentTypeNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.ToolContentDiscriminatorTypeJsonConverter),
@@ -73,10 +73,6 @@ namespace Cohere
             typeof(global::Cohere.JsonConverters.MessageDiscriminatorRoleNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.FinishReasonJsonConverter),
             typeof(global::Cohere.JsonConverters.FinishReasonNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.ResponseFormatTypeJsonConverter),
-            typeof(global::Cohere.JsonConverters.ResponseFormatTypeNullableJsonConverter),
-            typeof(global::Cohere.JsonConverters.ResponseFormatTypeV2JsonConverter),
-            typeof(global::Cohere.JsonConverters.ResponseFormatTypeV2NullableJsonConverter),
             typeof(global::Cohere.JsonConverters.CitationOptionsModeJsonConverter),
             typeof(global::Cohere.JsonConverters.CitationOptionsModeNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.CompatibleEndpointJsonConverter),
@@ -115,6 +111,10 @@ namespace Cohere
             typeof(global::Cohere.JsonConverters.GenerateStreamedResponseDiscriminatorEventTypeNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.GetClusterJobResponseStatusJsonConverter),
             typeof(global::Cohere.JsonConverters.GetClusterJobResponseStatusNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.ResponseFormatTypeJsonConverter),
+            typeof(global::Cohere.JsonConverters.ResponseFormatTypeNullableJsonConverter),
+            typeof(global::Cohere.JsonConverters.ResponseFormatTypeV2JsonConverter),
+            typeof(global::Cohere.JsonConverters.ResponseFormatTypeV2NullableJsonConverter),
             typeof(global::Cohere.JsonConverters.ReasoningEffortJsonConverter),
             typeof(global::Cohere.JsonConverters.ReasoningEffortNullableJsonConverter),
             typeof(global::Cohere.JsonConverters.ResponseFormatDiscriminatorTypeJsonConverter),
@@ -172,7 +172,7 @@ namespace Cohere
             typeof(global::Cohere.JsonConverters.ChatMessageEndEventJsonConverter),
             typeof(global::Cohere.JsonConverters.ChatMessageStartEventJsonConverter),
             typeof(global::Cohere.JsonConverters.ChatMessageV2JsonConverter),
-            typeof(global::Cohere.JsonConverters.MessageContentJsonConverter),
+            typeof(global::Cohere.JsonConverters.Content2JsonConverter),
             typeof(global::Cohere.JsonConverters.ContentVariant2Item2JsonConverter),
             typeof(global::Cohere.JsonConverters.ToolContentJsonConverter),
             typeof(global::Cohere.JsonConverters.ChatSearchQueriesGenerationEventJsonConverter),
@@ -200,7 +200,7 @@ namespace Cohere
             typeof(global::Cohere.JsonConverters.StreamedChatResponseV2JsonConverter),
             typeof(global::Cohere.JsonConverters.EmbedResponseJsonConverter),
             typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::System.Collections.Generic.IList<global::Cohere.ContentVariant2Item>>),
-            typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::System.Collections.Generic.IList<global::Cohere.MessageContent>>),
+            typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::System.Collections.Generic.IList<global::Cohere.Content2>>),
             typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::System.Collections.Generic.IList<global::Cohere.ContentVariant2Item2>>),
             typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::System.Collections.Generic.IList<global::Cohere.ToolContent>>),
             typeof(global::Cohere.JsonConverters.OneOfJsonConverter<string, global::Cohere.RerankDocument>),

src/libs/Cohere/Generated/Cohere.CohereClient.Chat.g.cs

@@ -26,7 +26,7 @@ partial void ProcessChatResponseContent(
             ref string content);
 
         /// <summary>
-        /// Chat<br/>
+        /// Chat V1 API<br/>
         /// Generates a text response to a user message.<br/>
         /// To learn how to use the Chat API and RAG follow our [Text Generation guides](https://docs.cohere.com/docs/chat-api).
         /// </summary>
@@ -526,7 +526,7 @@ partial void ProcessChatResponseContent(
         }
 
         /// <summary>
-        /// Chat<br/>
+        /// Chat V1 API<br/>
         /// Generates a text response to a user message.<br/>
         /// To learn how to use the Chat API and RAG follow our [Text Generation guides](https://docs.cohere.com/docs/chat-api).
         /// </summary>

src/libs/Cohere/Generated/Cohere.CohereClient.Chatv2.g.cs

@@ -24,7 +24,7 @@ partial void ProcessChatv2ResponseContent(
             ref string content);
 
         /// <summary>
-        /// Chat with the model<br/>
+        /// Chat V2 API<br/>
         /// Generates a text response to a user message and streams it down, token by token. To learn how to use the Chat API with streaming follow our [Text Generation guides](https://docs.cohere.com/v2/docs/chat-api).<br/>
         /// Follow the [Migration Guide](https://docs.cohere.com/v2/docs/migrating-v1-to-v2) for instructions on moving from API v1 to API v2.
         /// </summary>
@@ -516,7 +516,7 @@ partial void ProcessChatv2ResponseContent(
         }
 
         /// <summary>
-        /// Chat with the model<br/>
+        /// Chat V2 API<br/>
         /// Generates a text response to a user message and streams it down, token by token. To learn how to use the Chat API with streaming follow our [Text Generation guides](https://docs.cohere.com/v2/docs/chat-api).<br/>
         /// Follow the [Migration Guide](https://docs.cohere.com/v2/docs/migrating-v1-to-v2) for instructions on moving from API v1 to API v2.
         /// </summary>

src/libs/Cohere/Generated/Cohere.CohereClient.Embed.g.cs

@@ -24,7 +24,7 @@ partial void ProcessEmbedResponseContent(
             ref string content);
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V1 API<br/>
         /// This endpoint returns text and image embeddings. An embedding is a list of floating point numbers that captures semantic information about the content that it represents.<br/>
         /// Embeddings can be used to create classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).
@@ -517,7 +517,7 @@ partial void ProcessEmbedResponseContent(
         }
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V1 API<br/>
         /// This endpoint returns text and image embeddings. An embedding is a list of floating point numbers that captures semantic information about the content that it represents.<br/>
         /// Embeddings can be used to create classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).

src/libs/Cohere/Generated/Cohere.CohereClient.Embedv2.g.cs

@@ -24,7 +24,7 @@ partial void ProcessEmbedv2ResponseContent(
             ref string content);
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V2 API<br/>
         /// This endpoint returns text embeddings. An embedding is a list of floating point numbers that captures semantic information about the text that it represents.<br/>
         /// Embeddings can be used to create text classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).
@@ -517,7 +517,7 @@ partial void ProcessEmbedv2ResponseContent(
         }
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V2 API<br/>
         /// This endpoint returns text embeddings. An embedding is a list of floating point numbers that captures semantic information about the text that it represents.<br/>
         /// Embeddings can be used to create text classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).

src/libs/Cohere/Generated/Cohere.CohereClient.Rerank.g.cs

@@ -24,7 +24,7 @@ partial void ProcessRerankResponseContent(
             ref string content);
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V1 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>
@@ -515,7 +515,7 @@ partial void ProcessRerankResponseContent(
         }
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V1 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>

src/libs/Cohere/Generated/Cohere.CohereClient.Rerankv2.g.cs

@@ -24,7 +24,7 @@ partial void ProcessRerankv2ResponseContent(
             ref string content);
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V2 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>
@@ -515,7 +515,7 @@ partial void ProcessRerankv2ResponseContent(
         }
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V2 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>

src/libs/Cohere/Generated/Cohere.ICohereClient.Chat.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Chat<br/>
+        /// Chat V1 API<br/>
         /// Generates a text response to a user message.<br/>
         /// To learn how to use the Chat API and RAG follow our [Text Generation guides](https://docs.cohere.com/docs/chat-api).
         /// </summary>
@@ -21,7 +21,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Chat<br/>
+        /// Chat V1 API<br/>
         /// Generates a text response to a user message.<br/>
         /// To learn how to use the Chat API and RAG follow our [Text Generation guides](https://docs.cohere.com/docs/chat-api).
         /// </summary>

src/libs/Cohere/Generated/Cohere.ICohereClient.Chatv2.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Chat with the model<br/>
+        /// Chat V2 API<br/>
         /// Generates a text response to a user message and streams it down, token by token. To learn how to use the Chat API with streaming follow our [Text Generation guides](https://docs.cohere.com/v2/docs/chat-api).<br/>
         /// Follow the [Migration Guide](https://docs.cohere.com/v2/docs/migrating-v1-to-v2) for instructions on moving from API v1 to API v2.
         /// </summary>
@@ -19,7 +19,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Chat with the model<br/>
+        /// Chat V2 API<br/>
         /// Generates a text response to a user message and streams it down, token by token. To learn how to use the Chat API with streaming follow our [Text Generation guides](https://docs.cohere.com/v2/docs/chat-api).<br/>
         /// Follow the [Migration Guide](https://docs.cohere.com/v2/docs/migrating-v1-to-v2) for instructions on moving from API v1 to API v2.
         /// </summary>

src/libs/Cohere/Generated/Cohere.ICohereClient.Embed.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Embed<br/>
+        /// Embed V1 API<br/>
         /// This endpoint returns text and image embeddings. An embedding is a list of floating point numbers that captures semantic information about the content that it represents.<br/>
         /// Embeddings can be used to create classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).
@@ -20,7 +20,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V1 API<br/>
         /// This endpoint returns text and image embeddings. An embedding is a list of floating point numbers that captures semantic information about the content that it represents.<br/>
         /// Embeddings can be used to create classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).

src/libs/Cohere/Generated/Cohere.ICohereClient.Embedv2.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Embed<br/>
+        /// Embed V2 API<br/>
         /// This endpoint returns text embeddings. An embedding is a list of floating point numbers that captures semantic information about the text that it represents.<br/>
         /// Embeddings can be used to create text classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).
@@ -20,7 +20,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Embed<br/>
+        /// Embed V2 API<br/>
         /// This endpoint returns text embeddings. An embedding is a list of floating point numbers that captures semantic information about the text that it represents.<br/>
         /// Embeddings can be used to create text classifiers as well as empower semantic search. To learn more about embeddings, see the embedding page.<br/>
         /// If you want to learn more how to use the embedding model, have a look at the [Semantic Search Guide](https://docs.cohere.com/docs/semantic-search).

src/libs/Cohere/Generated/Cohere.ICohereClient.Rerank.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V1 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>
@@ -18,7 +18,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V1 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>

src/libs/Cohere/Generated/Cohere.ICohereClient.Rerankv2.g.cs

@@ -5,7 +5,7 @@ namespace Cohere
     public partial interface ICohereClient
     {
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V2 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>
@@ -18,7 +18,7 @@ public partial interface ICohereClient
             global::System.Threading.CancellationToken cancellationToken = default);
 
         /// <summary>
-        /// Rerank<br/>
+        /// Rerank V2 API<br/>
         /// This endpoint takes in a query and a list of texts and produces an ordered array with each text assigned a relevance score.
         /// </summary>
         /// <param name="xClientName"></param>