Files
AI-Studio/app/MindWork AI Studio/Tools/ToolCallingSystem/ToolCallingImplementations/Mailboxes/MailConditions.cs
T

45 lines
2.5 KiB
C#

using AIStudio.Tools.Databases.IndexStore;
using AIStudio.Tools.Mail;
namespace AIStudio.Tools.ToolCallingSystem.ToolCallingImplementations.Mailboxes;
/// <summary>
/// The conditions a model set for the mails a tool searches or counts.
/// </summary>
/// <remarks>
/// The folder stays a name until a mailbox is searched: every mailbox has folders of its own, and
/// only its own list can tell which of them the name means. The same holds for the folder of the
/// sent mails or of the drafts, which every server names differently.
/// </remarks>
/// <param name="Filter">The conditions apart from the folder.</param>
/// <param name="Folder">The full path of the folder the mails have to lie in, as the model wrote it, or null for any folder.</param>
/// <param name="SpecialFolder">What the folder the mails have to lie in is for, SENT or DRAFTS, or null for any folder. Never set together with Folder.</param>
internal sealed record MailConditions(MailFilter Filter, string? Folder, MailFolderSpecialUse? SpecialFolder)
{
/// <summary>
/// Whether the conditions name a folder, by its path or by what it is for.
/// </summary>
public bool NamesFolder => this.Folder is not null || this.SpecialFolder is not null;
/// <summary>
/// The conditions for one mailbox, with the folder turned into the paths it stands for there.
/// </summary>
/// <remarks>
/// A folder is found by its full path, regardless of case, since a model writes "Inbox" as
/// readily as "INBOX". The folder of the sent mails or of the drafts is found by what the server
/// marks it as, whatever its name. Subfolders are not included: they are folders of their own,
/// and the model can name them. In a mailbox without such a folder, the condition matches no
/// mail at all, never every mail.
/// </remarks>
/// <param name="folders">The folders of the mailbox.</param>
/// <returns>The conditions for that mailbox.</returns>
public MailFilter ForMailbox(IReadOnlyList<MailFolderRecord> folders)
{
if (this.SpecialFolder is { } specialFolder)
return this.Filter with { FolderPaths = folders.Where(folder => folder.SpecialUse == specialFolder).Select(folder => folder.Path).ToList() };
return this.Folder is null
? this.Filter
: this.Filter with { FolderPaths = folders.Where(folder => string.Equals(folder.Path, this.Folder, StringComparison.OrdinalIgnoreCase)).Select(folder => folder.Path).ToList() };
}
}