Initial commit

src/PowderCoating.Application/Interfaces/IAiHelpService.cs

@@ -0,0 +1,23 @@
+namespace PowderCoating.Application.Interfaces;
+
+public interface IAiHelpService
+{
+    /// <summary>
+    /// Send a message to the AI help assistant and get a response.
+    /// </summary>
+    /// <param name="conversationHistory">Prior turns: alternating user/assistant messages.</param>
+    /// <param name="userMessage">The current user message.</param>
+    /// <param name="tenantContext">Read-only context about the current user and company.</param>
+    Task<string> SendMessageAsync(
+        List<AiHelpMessage> conversationHistory,
+        string userMessage,
+        string systemPrompt);
+}
+
+public record AiHelpMessage(string Role, string Content);
+
+public record AiHelpTenantContext(
+    string CompanyName,
+    string UserRole,
+    string UserName,
+    string? SubscriptionPlan);