Added a retrieval context validation agent (#289)

app/MindWork AI Studio/Tools/TargetWindow.cs

@@ -0,0 +1,38 @@
+namespace AIStudio.Tools;
+
+/// <summary>
+/// Represents a target window for the number of items to match a threshold.
+/// </summary>
+/// <param name="NumMinItems">The minimum number of items to match the threshold. Should be at least one and less than targetWindowMin.</param>
+/// <param name="TargetWindowMin">The minimum number of items in the target window. Should be at least 2 and more than numMinItems.</param>
+/// <param name="TargetWindowMax">The maximum number of items in the target window.</param>
+public readonly record struct TargetWindow(int NumMinItems, int TargetWindowMin, int TargetWindowMax, float MinThreshold)
+{
+    /// <summary>
+    /// Determines if the target window is valid.
+    /// </summary>
+    /// <returns>True when the target window is valid; otherwise, false.</returns>
+    public bool IsValid()
+    {
+        if(this.NumMinItems < 1)
+            return false;
+        
+        if(this.TargetWindowMin < this.NumMinItems)
+            return false;
+        
+        if(this.TargetWindowMax < this.TargetWindowMin)
+            return false;
+        
+        if(this.MinThreshold is < 0f or > 1f)
+            return false;
+        
+        return true;
+    }
+
+    /// <summary>
+    /// Determines if the number of items is inside the target window.
+    /// </summary>
+    /// <param name="numItems">The number of items to check.</param>
+    /// <returns>True when the number of items is inside the target window; otherwise, false.</returns>
+    public bool InsideWindow(int numItems) => numItems >= this.TargetWindowMin && numItems <= this.TargetWindowMax;
+}