PowderCoatingLogix/src/PowderCoating.Application/Interfaces/ICustomFormulaAiService.cs

using PowderCoating.Application.DTOs.Company;

namespace PowderCoating.Application.Interfaces;

public interface ICustomFormulaAiService
{
    /// <summary>
    /// Generates a NCalc formula, field list, and notes from a natural-language description
    /// and an optional diagram image. Returns a <see cref="GenerateFormulaFromAiResponse"/>
    /// ready to pre-fill the template editor.
    /// </summary>
    Task<GenerateFormulaFromAiResponse> GenerateFormulaAsync(
        GenerateFormulaFromAiRequest request,
        byte[]? imageBytes = null,
        string? imageContentType = null);

    /// <summary>
    /// Evaluates a NCalc formula with the supplied variable map and returns the numeric result.
    /// Safe server-side only — no user-controlled code execution.
    /// </summary>
    EvaluateFormulaResponse EvaluateFormula(EvaluateFormulaRequest request);
}