fix: Fixed Vectara spec issues.

Author: HavenDV

specs/vectara.yaml

@@ -107,7 +107,7 @@ public static bool IsOneOf(
 
         return
             (schema.OneOf?.Any() ?? false) &&
-            (schema.Properties?.Count ?? 0) == 0; // OneOf with properties is not supported
+            ((schema.Properties?.Count ?? 0) == 0 || HasOnlySharedBaseDiscriminatorWrapperProperty(schema));
     }
 
     public static bool IsAnyOf(
@@ -135,6 +135,41 @@ public static bool IsAllOf(
             (schema.AllOf?.Any() ?? false) &&
             (schema.Properties?.Count ?? 0) == 0; // AllOf with properties is not supported
     }
+
+    // Some specs wrap a shared-base discriminated oneOf in a discriminator-only property bag.
+    // That wrapper should still be treated as a named union instead of collapsing to a base class.
+    private static bool HasOnlySharedBaseDiscriminatorWrapperProperty(IOpenApiSchema schema)
+    {
+        if (schema.Discriminator?.PropertyName is not { Length: > 0 } discriminatorPropertyName ||
+            schema.Properties is not { Count: 1 } properties ||
+            !properties.ContainsKey(discriminatorPropertyName))
+        {
+            return false;
+        }
+
+        var sharedBaseReferenceIds = (schema.OneOf ?? [])
+            .Select(GetSharedBaseReferenceId)
+            .Where(static x => !string.IsNullOrWhiteSpace(x))
+            .Distinct(StringComparer.Ordinal)
+            .ToArray();
+
+        return sharedBaseReferenceIds.Length == 1;
+    }
+
+    private static string? GetSharedBaseReferenceId(IOpenApiSchema schema)
+    {
+        var resolvedSchema = schema.ResolveIfRequired();
+        var baseReferenceIds = (resolvedSchema.AllOf ?? [])
+            .Where(static x => x.IsSchemaReference())
+            .Select(static x => x.GetReferenceId())
+            .Where(static x => !string.IsNullOrWhiteSpace(x))
+            .Distinct(StringComparer.Ordinal)
+            .ToArray();
+
+        return baseReferenceIds.Length == 1
+            ? baseReferenceIds[0]
+            : null;
+    }
 
     public static bool IsArray(
         this IOpenApiSchema schema)
@@ -320,4 +355,4 @@ null or
                    "int32" &&
                schema.Description?.ToUpperInvariant().Contains("UNIX TIMESTAMP") == true);
     }
-}
+}

src/libs/AutoSDK/Extensions/OpenApiSchemaExtensions.cs

@@ -28,7 +28,11 @@ partial void ProcessCreateApiKeyResponseContent(
 
         /// <summary>
         /// Create an API key<br/>
-        /// An API key is to authenticate when calling Vectara APIs.
+        /// The Create API Key API lets you create new API keys, which you can bind to one or multiple corpora. You can also decide whether to designate each key for specific access like personal API keys, only querying (read-only) or both querying and indexing (read-write).<br/>
+        /// This capability is useful in scenarios where you have applications that require different levels of access to corpora data. For example, you might create a read-only API key for an application that only needs to query data.<br/>
+        /// :::note<br/>
+        /// For more information about the different types of API keys, see [API Key Management](/docs/deploy-and-scale/authentication/api-key-management).<br/>
+        /// :::
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>
@@ -266,39 +270,49 @@ partial void ProcessCreateApiKeyResponseContent(
 
         /// <summary>
         /// Create an API key<br/>
-        /// An API key is to authenticate when calling Vectara APIs.
+        /// The Create API Key API lets you create new API keys, which you can bind to one or multiple corpora. You can also decide whether to designate each key for specific access like personal API keys, only querying (read-only) or both querying and indexing (read-write).<br/>
+        /// This capability is useful in scenarios where you have applications that require different levels of access to corpora data. For example, you might create a read-only API key for an application that only needs to query data.<br/>
+        /// :::note<br/>
+        /// For more information about the different types of API keys, see [API Key Management](/docs/deploy-and-scale/authentication/api-key-management).<br/>
+        /// :::
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>
         /// <param name="name">
         /// The human-readable name of the API key.
         /// </param>
+        /// <param name="apiRoles">
+        /// Customer-level roles for this API key.
+        /// </param>
         /// <param name="apiKeyRole">
-        /// Role of the API key. <br/>
-        /// A serving API key can only perform query type requests on its corpora. A serving and<br/>
-        /// indexing key can perform both indexing and query type requests on its corpora.<br/>
+        /// Role of the API key. A serving API key can only perform query type requests on its corpora. A serving and indexing key can perform both indexing and query type requests on its corpora.<br/>
         /// A personal API key has all the same permissions as the creator of the API key.
         /// </param>
-        /// <param name="corpusKeys">
-        /// Corpora this API key has roles on if it is not a Personal API key.<br/>
-        /// This property should be null or missing if this `api_key_role` is<br/>
-        /// `personal`.
+        /// <param name="corpusRoles">
+        /// Corpus-specific role assignments for this API key.
+        /// </param>
+        /// <param name="agentRoles">
+        /// Agent-specific role assignments for this API key.
         /// </param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<global::G.ApiKey> CreateApiKeyAsync(
             string name,
-            global::G.ApiKeyRole apiKeyRole,
             int? requestTimeout = default,
             int? requestTimeoutMillis = default,
-            global::System.Collections.Generic.IList<string>? corpusKeys = default,
+            global::System.Collections.Generic.IList<global::G.ApiRole>? apiRoles = default,
+            global::G.ApiKeyRole? apiKeyRole = default,
+            global::System.Collections.Generic.IList<global::G.CorpusRole>? corpusRoles = default,
+            global::System.Collections.Generic.IList<global::G.AgentRole>? agentRoles = default,
             global::System.Threading.CancellationToken cancellationToken = default)
         {
             var __request = new global::G.CreateApiKeyRequest
             {
                 Name = name,
+                ApiRoles = apiRoles,
                 ApiKeyRole = apiKeyRole,
-                CorpusKeys = corpusKeys,
+                CorpusRoles = corpusRoles,
+                AgentRoles = agentRoles,
             };
 
             return await CreateApiKeyAsync(

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.CreateApiKey.g.verified.cs

@@ -23,7 +23,9 @@ partial void ProcessDeleteApiKeyResponse(
 
         /// <summary>
         /// Delete an API key<br/>
-        /// Delete API keys to help you manage the security and lifecycle of API keys in your application.
+        /// The Delete API Key API lets you delete one or more existing API keys. <br/>
+        /// This capability is useful for managing the lifecycle and security of <br/>
+        /// API keys such as when they are no longer needed or when a key is compromised.
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.DeleteApiKey.g.verified.cs

@@ -28,7 +28,8 @@ partial void ProcessGetApiKeyResponseContent(
 
         /// <summary>
         /// Get an API key<br/>
-        /// Retrieve details of a specific API key by its ID.
+        /// The Get API Key API lists all existing API keys for a customer ID. It also shows what corpora are accessed by these keys and with what permissions.<br/>
+        /// This capability can provide insights into key usage and status and help you manage the lifecycle and security of your API keys.
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.GetApiKey.g.verified.cs

@@ -34,7 +34,7 @@ partial void ProcessListApiKeysResponseContent(
 
         /// <summary>
         /// List API keys<br/>
-        /// Retrieve a list of API keys for the customer account with optional filtering.
+        /// The List API Keys API lists all existing API keys for a customer ID. It also shows what corpora are accessed by these keys and with what permissions. This capability can provide insights into key usage and status and help you manage the lifecycle and security of your API keys.
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>
@@ -47,9 +47,7 @@ partial void ProcessListApiKeysResponseContent(
         /// Example: my-corpus
         /// </param>
         /// <param name="apiKeyRole">
-        /// Role of the API key. <br/>
-        /// A serving API key can only perform query type requests on its corpora. A serving and<br/>
-        /// indexing key can perform both indexing and query type requests on its corpora.<br/>
+        /// Role of the API key. A serving API key can only perform query type requests on its corpora. A serving and indexing key can perform both indexing and query type requests on its corpora.<br/>
         /// A personal API key has all the same permissions as the creator of the API key.
         /// </param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.ListApiKeys.g.verified.cs

@@ -30,7 +30,8 @@ partial void ProcessUpdateApiKeyResponseContent(
 
         /// <summary>
         /// Update an API key<br/>
-        /// Update an API key such as the roles attached to the key.
+        /// The Update API Key API lets you enable or disable specific API keys. You can use this endpoint to temporarily disable access without deleting the key.<br/>
+        /// This capability is useful for scenarios like maintenance windows, or when your team no longer requires access to a specific corpus.
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>
@@ -235,7 +236,8 @@ partial void ProcessUpdateApiKeyResponseContent(
 
         /// <summary>
         /// Update an API key<br/>
-        /// Update an API key such as the roles attached to the key.
+        /// The Update API Key API lets you enable or disable specific API keys. You can use this endpoint to temporarily disable access without deleting the key.<br/>
+        /// This capability is useful for scenarios like maintenance windows, or when your team no longer requires access to a specific corpus.
         /// </summary>
         /// <param name="requestTimeout"></param>
         /// <param name="requestTimeoutMillis"></param>

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.UpdateApiKey.g.verified.cs

@@ -5,7 +5,7 @@
 namespace G
 {
     /// <summary>
-    /// Create, manage, and revoke API keys for secure access to the platform<br/>
+    /// Create, manage, and revoke API keys for secure access to the platform.<br/>
     /// If no httpClient is provided, a new one will be created.<br/>
     /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
     /// </summary>

src/tests/AutoSDK.SnapshotTests/Snapshots/vectara/NewtonsoftJson/_#G.APIKeysClient.g.verified.cs

@@ -0,0 +1,88 @@
+//HintName: G.AgentConnectorsClient.g.cs
+
+#nullable enable
+
+namespace G
+{
+    /// <summary>
+    /// Create and manage connectors that allow agents to receive events from external platforms like Slack.<br/>
+    /// If no httpClient is provided, a new one will be created.<br/>
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
+    public sealed partial class AgentConnectorsClient : global::G.IAgentConnectorsClient, global::System.IDisposable
+    {
+        /// <summary>
+        /// 
+        /// </summary>
+        public const string DefaultBaseUrl = "https://api.vectara.io";
+
+        private bool _disposeHttpClient = true;
+
+        /// <inheritdoc/>
+        public global::System.Net.Http.HttpClient HttpClient { get; }
+
+        /// <inheritdoc/>
+        public System.Uri? BaseUri => HttpClient.BaseAddress;
+
+        /// <inheritdoc/>
+        public global::System.Collections.Generic.List<global::G.EndPointAuthorization> Authorizations { get; }
+
+        /// <inheritdoc/>
+        public bool ReadResponseAsString { get; set; }
+#if DEBUG
+            = true;
+#endif
+        /// <summary>
+        /// 
+        /// </summary>
+        public global::Newtonsoft.Json.JsonSerializerSettings JsonSerializerOptions { get; set; } = new global::Newtonsoft.Json.JsonSerializerSettings();
+
+
+        /// <summary>
+        /// Creates a new instance of the AgentConnectorsClient.
+        /// If no httpClient is provided, a new one will be created.
+        /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+        /// </summary>
+        /// <param name="httpClient">The HttpClient instance. If not provided, a new one will be created.</param>
+        /// <param name="baseUri">The base URL for the API. If not provided, the default baseUri from OpenAPI spec will be used.</param>
+        /// <param name="authorizations">The authorizations to use for the requests.</param>
+        /// <param name="disposeHttpClient">Dispose the HttpClient when the instance is disposed. True by default.</param>
+        public AgentConnectorsClient(
+            global::System.Net.Http.HttpClient? httpClient = null,
+            global::System.Uri? baseUri = null,
+            global::System.Collections.Generic.List<global::G.EndPointAuthorization>? authorizations = null,
+            bool disposeHttpClient = true)
+        {
+            HttpClient = httpClient ?? new global::System.Net.Http.HttpClient();
+            HttpClient.BaseAddress ??= baseUri ?? new global::System.Uri(DefaultBaseUrl);
+            Authorizations = authorizations ?? new global::System.Collections.Generic.List<global::G.EndPointAuthorization>();
+            _disposeHttpClient = disposeHttpClient;
+
+            Initialized(HttpClient);
+        }
+
+        /// <inheritdoc/>
+        public void Dispose()
+        {
+            if (_disposeHttpClient)
+            {
+                HttpClient.Dispose();
+            }
+        }
+
+        partial void Initialized(
+            global::System.Net.Http.HttpClient client);
+        partial void PrepareArguments(
+            global::System.Net.Http.HttpClient client);
+        partial void PrepareRequest(
+            global::System.Net.Http.HttpClient client,
+            global::System.Net.Http.HttpRequestMessage request);
+        partial void ProcessResponse(
+            global::System.Net.Http.HttpClient client,
+            global::System.Net.Http.HttpResponseMessage response);
+        partial void ProcessResponseContent(
+            global::System.Net.Http.HttpClient client,
+            global::System.Net.Http.HttpResponseMessage response,
+            ref string content);
+    }
+}