feat: Support Box AI endpoints (box/box-openapi#416)

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "cb5120c", "specHash": "1698c95", "version": "0.3.0" }
+{ "engineHash": "afd7974", "specHash": "63d1af0", "version": "0.3.0" }

Box.Sdk.Gen/Client/BoxClient.cs

@@ -145,7 +145,9 @@
 
         public IIntegrationMappingsManager IntegrationMappings { get; set; }
 
+        public IAiManager Ai { get; set; }
+
         public BoxClient(IAuthentication auth, NetworkSession networkSession = default) {
             Auth = auth;
             NetworkSession = networkSession ?? new NetworkSession(baseUrls: new BaseUrls());
             Authorization = new AuthorizationManager(networkSession: this.NetworkSession) { Auth = this.Auth };
@@ -216,6 +218,7 @@
             Workflows = new WorkflowsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             SignTemplates = new SignTemplatesManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             IntegrationMappings = new IntegrationMappingsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
+            Ai = new AiManager(networkSession: this.NetworkSession) { Auth = this.Auth };
         }
         /// <summary>
         /// Create a new client to impersonate user with the provided ID. All calls made with the new client will be made in context of the impersonated user, leaving the original client unmodified.

Box.Sdk.Gen/Client/IBoxClient.cs

@@ -143,5 +143,7 @@ public interface IBoxClient {
 
         public IIntegrationMappingsManager IntegrationMappings { get; set; }
 
+        public IAiManager Ai { get; set; }
+
     }
 }

Box.Sdk.Gen/Managers/Ai/AiManager.cs

@@ -0,0 +1,58 @@
+using Unions;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using DictionaryExtensions;
+using Serializer;
+using Fetch;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen;
+
+namespace Box.Sdk.Gen.Managers {
+    public class AiManager : IAiManager {
+        public IAuthentication? Auth { get; set; } = default;
+
+        public NetworkSession NetworkSession { get; set; }
+
+        public AiManager(NetworkSession networkSession = default) {
+            NetworkSession = networkSession ?? new NetworkSession();
+        }
+        /// <summary>
+        /// Sends an AI request to supported LLMs and returns an answer specifically focused on the user's question given the provided context.
+        /// </summary>
+        /// <param name="requestBody">
+        /// Request body of createAiAsk method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of createAiAsk method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<AiResponse> CreateAiAskAsync(AiAsk requestBody, CreateAiAskHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new CreateAiAskHeaders();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() {  }, headers.ExtraHeaders));
+            FetchResponse response = await HttpClientAdapter.FetchAsync(string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/v2/ai/ask"), new FetchOptions(method: "POST", headers: headersMap, data: SimpleJsonSerializer.Serialize(requestBody), contentType: "application/json", responseFormat: "json", auth: this.Auth, networkSession: this.NetworkSession, cancellationToken: cancellationToken)).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<AiResponse>(response.Data);
+        }
+
+        /// <summary>
+        /// Sends an AI request to supported LLMs and returns an answer specifically focused on the creation of new text.
+        /// </summary>
+        /// <param name="requestBody">
+        /// Request body of createAiTextGen method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of createAiTextGen method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<AiResponse> CreateAiTextGenAsync(AiTextGen requestBody, CreateAiTextGenHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new CreateAiTextGenHeaders();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() {  }, headers.ExtraHeaders));
+            FetchResponse response = await HttpClientAdapter.FetchAsync(string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/v2/ai/text_gen"), new FetchOptions(method: "POST", headers: headersMap, data: SimpleJsonSerializer.Serialize(requestBody), contentType: "application/json", responseFormat: "json", auth: this.Auth, networkSession: this.NetworkSession, cancellationToken: cancellationToken)).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<AiResponse>(response.Data);
+        }
+
+    }
+}

Box.Sdk.Gen/Managers/Ai/CreateAiAskHeaders.cs

@@ -0,0 +1,18 @@
+using Unions;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen;
+
+namespace Box.Sdk.Gen.Managers {
+    public class CreateAiAskHeaders {
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; set; }
+
+        public CreateAiAskHeaders(Dictionary<string, string?> extraHeaders = default) {
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/Ai/CreateAiTextGenHeaders.cs

@@ -0,0 +1,18 @@
+using Unions;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen;
+
+namespace Box.Sdk.Gen.Managers {
+    public class CreateAiTextGenHeaders {
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; set; }
+
+        public CreateAiTextGenHeaders(Dictionary<string, string?> extraHeaders = default) {
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/Ai/IAiManager.cs

@@ -0,0 +1,18 @@
+using Unions;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen;
+
+namespace Box.Sdk.Gen.Managers {
+    public interface IAiManager {
+        public IAuthentication? Auth { get; set; }
+
+        public NetworkSession NetworkSession { get; set; }
+
+        public System.Threading.Tasks.Task<AiResponse> CreateAiAskAsync(AiAsk requestBody, CreateAiAskHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null);
+
+        public System.Threading.Tasks.Task<AiResponse> CreateAiTextGenAsync(AiTextGen requestBody, CreateAiTextGenHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null);
+
+    }
+}

Box.Sdk.Gen/Schemas/AiAsk.cs

@@ -0,0 +1,33 @@
+using Unions;
+using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiAsk {
+        /// <summary>
+        /// The mode specifies if this request is for a single or multiple items.
+        /// </summary>
+        [JsonPropertyName("mode")]
+        public AiAskModeField Mode { get; set; }
+
+        /// <summary>
+        /// The prompt provided by the client to be answered by the LLM.
+        /// </summary>
+        [JsonPropertyName("prompt")]
+        public string Prompt { get; set; }
+
+        /// <summary>
+        /// The items to be processed by the LLM, often files.
+        /// </summary>
+        [JsonPropertyName("items")]
+        public IReadOnlyList<AiAskItemsField> Items { get; set; }
+
+        public AiAsk(AiAskModeField mode, string prompt, IReadOnlyList<AiAskItemsField> items) {
+            Mode = mode;
+            Prompt = prompt;
+            Items = items;
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiAskItemsField.cs

@@ -0,0 +1,29 @@
+using Unions;
+using System.Text.Json.Serialization;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiAskItemsField {
+        /// <summary>
+        /// The id of the item
+        /// </summary>
+        [JsonPropertyName("id")]
+        public string Id { get; set; }
+
+        /// <summary>
+        /// The type of the item
+        /// </summary>
+        [JsonPropertyName("type")]
+        public AiAskItemsTypeField Type { get; set; }
+
+        /// <summary>
+        /// The content of the item, often the text representation.
+        /// </summary>
+        [JsonPropertyName("content")]
+        public string? Content { get; set; } = default;
+
+        public AiAskItemsField(string id, AiAskItemsTypeField type = AiAskItemsTypeField.File) {
+            Id = id;
+            Type = type;
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiAskItemsTypeField.cs

@@ -0,0 +1,11 @@
+using System.ComponentModel;
+using Serializer;
+using System.Text.Json.Serialization;
+
+namespace Box.Sdk.Gen.Schemas {
+    [JsonConverter(typeof(StringEnumConverter<AiAskItemsTypeField>))]
+    public enum AiAskItemsTypeField {
+        [Description("file")]
+        File
+    }
+}

Box.Sdk.Gen/Schemas/AiAskModeField.cs

@@ -0,0 +1,13 @@
+using System.ComponentModel;
+using Serializer;
+using System.Text.Json.Serialization;
+
+namespace Box.Sdk.Gen.Schemas {
+    [JsonConverter(typeof(StringEnumConverter<AiAskModeField>))]
+    public enum AiAskModeField {
+        [Description("multiple_item_qa")]
+        MultipleItemQa,
+        [Description("single_item_qa")]
+        SingleItemQa
+    }
+}

Box.Sdk.Gen/Schemas/AiResponse.cs

@@ -0,0 +1,32 @@
+using Unions;
+using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiResponse {
+        /// <summary>
+        /// The answer provided by the LLM.
+        /// </summary>
+        [JsonPropertyName("answer")]
+        public string Answer { get; set; }
+
+        /// <summary>
+        /// The ISO date formatted timestamp of when the answer to the prompt was created.
+        /// </summary>
+        [JsonPropertyName("created_at")]
+        public System.DateTimeOffset CreatedAt { get; set; }
+
+        /// <summary>
+        /// The reason the response finishes.
+        /// </summary>
+        [JsonPropertyName("completion_reason")]
+        public string? CompletionReason { get; set; } = default;
+
+        public AiResponse(string answer, System.DateTimeOffset createdAt) {
+            Answer = answer;
+            CreatedAt = createdAt;
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiTextGen.cs

@@ -0,0 +1,32 @@
+using Unions;
+using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiTextGen {
+        /// <summary>
+        /// The prompt provided by the client to be answered by the LLM.
+        /// </summary>
+        [JsonPropertyName("prompt")]
+        public string Prompt { get; set; }
+
+        /// <summary>
+        /// The items to be processed by the LLM, often files.
+        /// </summary>
+        [JsonPropertyName("items")]
+        public IReadOnlyList<AiTextGenItemsField> Items { get; set; }
+
+        /// <summary>
+        /// The history of prompts and answers previously passed to the LLM. This provides additional context to the LLM in generating the response.
+        /// </summary>
+        [JsonPropertyName("dialogue_history")]
+        public IReadOnlyList<AiTextGenDialogueHistoryField>? DialogueHistory { get; set; } = default;
+
+        public AiTextGen(string prompt, IReadOnlyList<AiTextGenItemsField> items) {
+            Prompt = prompt;
+            Items = items;
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiTextGenDialogueHistoryField.cs

@@ -0,0 +1,31 @@
+using Unions;
+using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiTextGenDialogueHistoryField {
+        /// <summary>
+        /// The prompt previously provided by the client and answered by the LLM.
+        /// </summary>
+        [JsonPropertyName("prompt")]
+        public string? Prompt { get; set; } = default;
+
+        /// <summary>
+        /// The answer previously provided by the LLM.
+        /// </summary>
+        [JsonPropertyName("answer")]
+        public string? Answer { get; set; } = default;
+
+        /// <summary>
+        /// The ISO date formatted timestamp of when the previous answer to the prompt was created.
+        /// </summary>
+        [JsonPropertyName("created_at")]
+        public System.DateTimeOffset? CreatedAt { get; set; } = default;
+
+        public AiTextGenDialogueHistoryField() {
+
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiTextGenItemsField.cs

@@ -0,0 +1,31 @@
+using Unions;
+using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class AiTextGenItemsField {
+        /// <summary>
+        /// The id of the item.
+        /// </summary>
+        [JsonPropertyName("id")]
+        public string? Id { get; set; } = default;
+
+        /// <summary>
+        /// The type of the item.
+        /// </summary>
+        [JsonPropertyName("type")]
+        public AiTextGenItemsTypeField? Type { get; set; } = default;
+
+        /// <summary>
+        /// The content to use as context for generating new text or editing existing text.
+        /// </summary>
+        [JsonPropertyName("content")]
+        public string? Content { get; set; } = default;
+
+        public AiTextGenItemsField() {
+
+        }
+    }
+}

Box.Sdk.Gen/Schemas/AiTextGenItemsTypeField.cs

@@ -0,0 +1,11 @@
+using System.ComponentModel;
+using Serializer;
+using System.Text.Json.Serialization;
+
+namespace Box.Sdk.Gen.Schemas {
+    [JsonConverter(typeof(StringEnumConverter<AiTextGenItemsTypeField>))]
+    public enum AiTextGenItemsTypeField {
+        [Description("file")]
+        File
+    }
+}

Box.Sdk.Gen/Schemas/PostOAuth2Revoke.cs

@@ -1,5 +1,8 @@
 using Unions;
 using System.Text.Json.Serialization;
+using System;
+using System.Collections.ObjectModel;
+using System.Collections.Generic;
 
 namespace Box.Sdk.Gen.Schemas {
     public class PostOAuth2Revoke {