refactor: implement AI Client

pkgs/sdk/server-ai/README.md

@@ -22,7 +22,7 @@ The .NET build tools should automatically load the most appropriate build of the
 
 ## Getting started
 
-Refer to the [SDK documentation](https://docs.launchdarkly.com/sdk/server-side/dotnet#getting-started) for instructions on getting started with using the SDK.
+Refer to the [SDK documentation](TODO) for instructions on getting started with using the SDK.
 
 ## Signing
 

pkgs/sdk/server-ai/src/Adapters/LdClientAdapter.cs

@@ -0,0 +1,32 @@
+using LaunchDarkly.Logging;
+using LaunchDarkly.Sdk.Server.Ai.Interfaces;
+
+namespace LaunchDarkly.Sdk.Server.Ai.Adapters;
+
+/// <summary>
+/// Adapts an <see cref="LdClient"/> to the requirements of <see cref="LdAiClient"/>.
+/// </summary>
+public class LdClientAdapter : ILaunchDarklyClient
+{
+    private readonly LdClient _client;
+
+    /// <summary>
+    /// Constructs the adapter from an existing client.
+    /// </summary>
+    /// <param name="client">the adapter</param>
+    public LdClientAdapter(LdClient client)
+    {
+        _client = client;
+    }
+
+    /// <inheritdoc/>
+    public LdValue JsonVariation(string key, Context context, LdValue defaultValue)
+        => _client.JsonVariation(key, context, defaultValue);
+
+    /// <inheritdoc/>
+    public void Track(string name, Context context, LdValue data, double metricValue)
+        => _client.Track(name, context, data, metricValue);
+
+    /// <inheritdoc/>
+    public ILogger GetLogger() => new LoggerAdapter(_client.GetLogger());
+}

pkgs/sdk/server-ai/src/Adapters/LoggerAdapter.cs

@@ -0,0 +1,28 @@
+using LaunchDarkly.Logging;
+using LaunchDarkly.Sdk.Server.Ai.Interfaces;
+
+namespace LaunchDarkly.Sdk.Server.Ai.Adapters;
+
+/// <summary>
+/// Adapts a <see cref="Logger"/> to the requirements of the <see cref="LdAiClient"/>'s
+/// logger.
+/// </summary>
+internal class LoggerAdapter : ILogger
+{
+    private readonly Logger _logger;
+
+    /// <summary>
+    /// Creates a new adapter.
+    /// </summary>
+    /// <param name="logger">the existing logger</param>
+    public LoggerAdapter(Logger logger)
+    {
+        _logger = logger;
+    }
+
+    /// <inheritdoc/>
+    public void Error(string format, params object[] allParams) => _logger.Error(format, allParams);
+
+    /// <inheritdoc/>
+    public void Warn(string format, params object[] allParams) => _logger.Warn(format, allParams);
+}

pkgs/sdk/server-ai/src/Config/LdAiConfig.cs

@@ -0,0 +1,159 @@
+using System.Collections.Generic;
+using System.Linq;
+using LaunchDarkly.Sdk.Server.Ai.DataModel;
+
+namespace LaunchDarkly.Sdk.Server.Ai.Config;
+
+/// <summary>
+/// Represents an AI configuration, which contains model parameters and prompt messages.
+/// </summary>
+public record LdAiConfig
+{
+
+    /// <summary>
+    /// Represents a single message, which is part of a prompt.
+    /// </summary>
+    public record Message
+    {
+        /// <summary>
+        /// The content of the message, which may contain Mustache templates.
+        /// </summary>
+        public readonly string Content;
+
+        /// <summary>
+        /// The role of the message.
+        /// </summary>
+        public readonly Role Role;
+
+        internal Message(string content, Role role)
+        {
+            Content = content;
+            Role = role;
+        }
+    }
+
+    /// <summary>
+    /// Builder for constructing an LdAiConfig instance, which can be passed as the default
+    /// value to the AI Client's <see cref="LdAiClient.ModelConfig"/> method.
+    /// </summary>
+    public class Builder
+    {
+        private bool _enabled;
+        private readonly List<Message> _prompt;
+        private readonly Dictionary<string, object> _modelParams;
+
+
+        /// <summary>
+        /// Constructs a new builder. By default, the config will be disabled, with no prompt
+        /// messages or model parameters.
+        /// </summary>
+        public Builder()
+        {
+            _enabled = false;
+            _prompt = new List<Message>();
+            _modelParams = new Dictionary<string, object>();
+        }
+
+        /// <summary>
+        /// Adds a prompt message with the given content and role. The default role is <see cref="Role.User"/>.
+        /// </summary>
+        /// <param name="content">the content, which may contain Mustache templates</param>
+        /// <param name="role">the role</param>
+        /// <returns>a new builder</returns>
+        public Builder AddPromptMessage(string content, Role role = Role.User)
+        {
+            _prompt.Add(new Message(content, role));
+            return this;
+        }
+
+        /// <summary>
+        /// Disables the config.
+        /// </summary>
+        /// <returns>the builder</returns>
+        public Builder Disable() => SetEnabled(false);
+
+        /// <summary>
+        /// Enables the config.
+        /// </summary>
+        /// <returns>the builder</returns>
+        public Builder Enable() => SetEnabled(true);
+
+        /// <summary>
+        /// Sets the enabled state of the config based on a boolean.
+        /// </summary>
+        /// <param name="enabled">whether the config is enabled</param>
+        /// <returns>the builder</returns>
+        public Builder SetEnabled(bool enabled)
+        {
+            _enabled = enabled;
+            return this;
+        }
+
+        /// <summary>
+        /// Sets a parameter for the model. The value may be any object.
+        /// </summary>
+        /// <param name="name">the parameter name</param>
+        /// <param name="value">the parameter value</param>
+        /// <returns>the builder</returns>
+        public Builder SetModelParam(string name, object value)
+        {
+            _modelParams[name] = value;
+            return this;
+        }
+
+        /// <summary>
+        /// Builds the LdAiConfig instance.
+        /// </summary>
+        /// <returns>a new LdAiConfig</returns>
+        public LdAiConfig Build()
+        {
+            return new LdAiConfig(_enabled, _prompt, new Meta(), _modelParams);
+        }
+    }
+
+    /// <summary>
+    /// The prompts associated with the config.
+    /// </summary>
+    public readonly IReadOnlyList<Message> Prompt;
+
+    /// <summary>
+    /// The model parameters associated with the config.
+    /// </summary>
+    public readonly IReadOnlyDictionary<string, object> Model;
+
+
+
+    internal LdAiConfig(bool enabled, IEnumerable<Message> prompt, Meta meta, IReadOnlyDictionary<string, object> model)
+    {
+        Model = model ?? new Dictionary<string, object>();
+        Prompt = prompt?.ToList() ?? new List<Message>();
+        VersionKey = meta?.VersionKey ?? "";
+        Enabled = enabled;
+    }
+
+
+    /// <summary>
+    /// Creates a new LdAiConfig builder.
+    /// </summary>
+    /// <returns>a new builder</returns>
+    public static Builder New() => new();
+
+    /// <summary>
+    /// Returns true if the config is enabled.
+    /// </summary>
+    /// <returns>true if enabled</returns>
+    public bool Enabled { get; }
+
+
+    /// <summary>
+    /// This field meant for internal LaunchDarkly usage.
+    /// </summary>
+    public string VersionKey { get; }
+
+    /// <summary>
+    /// Convenient helper that returns a disabled LdAiConfig.
+    /// </summary>
+    public static LdAiConfig Disabled = New().Disable().Build();
+
+
+}

pkgs/sdk/server-ai/src/DataModel/DataModel.cs

@@ -0,0 +1,89 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace  LaunchDarkly.Sdk.Server.Ai.DataModel;
+
+/// <summary>
+/// Represents the role of the prompt message.
+/// </summary>
+public enum Role
+{
+    /// <summary>
+    /// User role.
+    /// </summary>
+    User,
+    /// <summary>
+    /// System role.
+    /// </summary>
+    System,
+    /// <summary>
+    /// Assistant role.
+    /// </summary>
+    Assistant
+}
+
+/// <summary>
+/// Represents the JSON serialization of the Meta field.
+/// </summary>
+public class Meta
+{
+    /// <summary>
+    /// The version key.
+    /// </summary>
+    [JsonPropertyName("versionKey")]
+    public string VersionKey { get; set; }
+
+    /// <summary>
+    /// If the config is enabled.
+    /// </summary>
+
+    [JsonPropertyName("enabled")]
+    public bool Enabled { get; set; }
+}
+
+/// <summary>
+/// Represents the JSON serialization of a Message.
+/// </summary>
+public class Message
+{
+    /// <summary>
+    /// The content.
+    /// </summary>
+    [JsonPropertyName("content")]
+    public string Content { get; set; }
+
+    /// <summary>
+    /// The role.
+    /// </summary>
+    [JsonPropertyName("role")]
+    [JsonConverter(typeof(JsonStringEnumConverter))]
+    public Role Role { get; set; }
+}
+
+
+/// <summary>
+/// Represents the JSON serialization of an AiConfig.
+/// </summary>
+
+public class AiConfig
+{
+    /// <summary>
+    /// The prompt.
+    /// </summary>
+    [JsonPropertyName("prompt")]
+    public List<Message> Prompt { get; set; }
+
+    /// <summary>
+    /// LaunchDarkly metadata.
+    /// </summary>
+
+    [JsonPropertyName("_ldMeta")]
+    public Meta Meta { get; set; }
+
+    /// <summary>
+    /// The model params;
+    /// </summary>
+
+    [JsonPropertyName("model")]
+    public Dictionary<string, object> Model { get; set; }
+}

pkgs/sdk/server-ai/src/Interfaces/ILaunchDarklyClient.cs

@@ -0,0 +1,33 @@
+namespace LaunchDarkly.Sdk.Server.Ai.Interfaces;
+
+/// <summary>
+/// Interface representing capabilities needed by the AI Client. These are usually provided
+/// by the LaunchDarkly Server SDK.
+/// </summary>
+public interface ILaunchDarklyClient
+{
+    /// <summary>
+    /// Returns a JSON variation.
+    /// </summary>
+    /// <param name="key">the flag key</param>
+    /// <param name="context">the context</param>
+    /// <param name="defaultValue">the default value</param>
+    /// <returns>the evaluation result</returns>
+    LdValue JsonVariation(string key, Context context, LdValue defaultValue);
+
+    /// <summary>
+    /// Tracks a metric.
+    /// </summary>
+    /// <param name="name">metric name</param>
+    /// <param name="context">context</param>
+    /// <param name="data">associated data</param>
+    /// <param name="metricValue">metric value</param>
+    void Track(string name, Context context, LdValue data, double metricValue);
+
+    /// <summary>
+    /// Returns a logger.
+    /// </summary>
+    /// <returns>a logger</returns>
+    ILogger GetLogger();
+
+}

pkgs/sdk/server-ai/src/Interfaces/ILogger.cs

@@ -0,0 +1,22 @@
+namespace LaunchDarkly.Sdk.Server.Ai.Interfaces;
+
+/// <summary>
+/// Log interface required by the AI Client.
+/// </summary>
+public interface ILogger
+{
+
+    /// <summary>
+    /// Log an error.
+    /// </summary>
+    /// <param name="format">format string</param>
+    /// <param name="allParams">parameters</param>
+    void Error(string format, params object[] allParams);
+
+    /// <summary>
+    /// Log a warning.
+    /// </summary>
+    /// <param name="format">format string</param>
+    /// <param name="allParams">parameters</param>
+    void Warn(string format, params object[] allParams);
+}

pkgs/sdk/server-ai/src/LaunchDarkly.ServerSdk.Ai.csproj

@@ -15,7 +15,7 @@
     <OutputType>Library</OutputType>
     <PackageId>LaunchDarkly.ServerSdk.Ai</PackageId>
     <RootNamespace>LaunchDarkly.Sdk.Server.Ai</RootNamespace>
-    <LangVersion>7.3</LangVersion>
+    <LangVersion>11</LangVersion>
     <Description>LaunchDarkly Server-Side .NET AI SDK</Description>
     <Authors>LaunchDarkly</Authors>
     <Owners>LaunchDarkly</Owners>
@@ -39,6 +39,7 @@
 
   <ItemGroup>
     <PackageReference Include="LaunchDarkly.ServerSdk" Version="8.*" />
+    <PackageReference Include="Mustache.NETStandard" Version="1.1.0" />
   </ItemGroup>
 
   <PropertyGroup Condition="'$(Configuration)'=='Release'">