Added mailboxes as local data sources (#1022)

app/MindWork AI Studio/Tools/Services/DataSourceEmbeddingStatus.cs

@@ -4,38 +4,49 @@ using AIStudio.Tools.PluginSystem;
 namespace AIStudio.Tools.Services;
 
 /// <remarks>
-/// CurrentFileBlock and CurrentFilePage are null rather than zero while nothing is known about
-/// them: a file which is only about to start has no first block, and not every kind of document
-/// has pages to count. Block numbers start at one, the way the page states them.
+/// Counts documents, whatever a document is for the kind of data source: a file for a folder, a
+/// mail for a mailbox. Which word the user reads is the business of the page showing it.
+///
+/// CurrentDocumentBlock and CurrentDocumentPage are null rather than zero while nothing is known
+/// about them: a document which is only about to start has no first block, and not every kind of
+/// document has pages to count. Block numbers start at one, the way the page states them.
 ///
 /// VectorStoreUnreadable says why a data source failed, not only that it did. The UI needs that
 /// difference to offer the repair for this one case, and it is carried as its own flag so nothing
-/// has to read it back out of the message in LastError.
+/// has to read it back out of the message in LastError. Attention does the same for what the user
+/// has to decide, and PendingRemovalCount is the number a held back removal asks about: agreeing to
+/// it hands that very number back, cf. ApprovePendingMailRemovalAsync.
+///
+/// LastSyncUtc is when the data source was last worked through as a whole, for those which are
+/// synced rather than watched, such as mailboxes. It stays null for the others.
 /// </remarks>
 public sealed record DataSourceEmbeddingStatus(
     string DataSourceId,
     string DataSourceName,
     DataSourceType DataSourceType,
     DataSourceEmbeddingState State,
-    int TotalFiles,
-    int IndexedFiles,
-    int FailedFiles,
-    string CurrentFile,
+    int TotalDocuments,
+    int IndexedDocuments,
+    int FailedDocuments,
+    string CurrentDocument,
     string LastError,
     IReadOnlyList<DataSourceEmbeddingFailure> Failures,
-    int PermanentlySkippedFiles = 0,
-    int? CurrentFileBlock = null,
-    int? CurrentFilePage = null,
-    bool VectorStoreUnreadable = false)
+    int PermanentlySkippedDocuments = 0,
+    int? CurrentDocumentBlock = null,
+    int? CurrentDocumentPage = null,
+    bool VectorStoreUnreadable = false,
+    DataSourceAttention Attention = DataSourceAttention.NONE,
+    int? PendingRemovalCount = null,
+    DateTimeOffset? LastSyncUtc = null)
 {
     private static string TB(string fallbackEN) => I18N.I.T(fallbackEN, typeof(DataSourceEmbeddingStatus).Namespace, nameof(DataSourceEmbeddingStatus));
 
     /// <remarks>
-    /// Files which were skipped for good are done, even though nothing was indexed of them.
+    /// Documents which were skipped for good are done, even though nothing was indexed of them.
     /// Leaving them out would keep the bar short of the end for a data source which has nothing
     /// left to do.
     /// </remarks>
-    public int ProgressPercent => this.TotalFiles <= 0 ? 0 : Math.Clamp((int)Math.Round((this.IndexedFiles + this.PermanentlySkippedFiles) * 100d / this.TotalFiles), 0, 100);
+    public int ProgressPercent => this.TotalDocuments <= 0 ? 0 : Math.Clamp((int)Math.Round((this.IndexedDocuments + this.PermanentlySkippedDocuments) * 100d / this.TotalDocuments), 0, 100);
 
     public string StateLabel => this.State switch
     {