Added mailboxes as local data sources (#1022)

app/MindWork AI Studio/Tools/ToolCallingSystem/ToolCatalogItem.cs

@@ -2,12 +2,40 @@ using AIStudio.Provider;
 
 namespace AIStudio.Tools.ToolCallingSystem;
 
+/// <summary>
+/// A tool collection as people see it: one entry of a tool selection, one row of the tool settings.
+/// </summary>
+/// <remarks>
+/// A tool which belongs to no declared collection forms one of its own, so it appears here like any
+/// other entry, with its own name and icon. Whatever somebody decides about an entry applies to all
+/// of its tools, see ToolCollectionDefinition.
+/// </remarks>
 public sealed class ToolCatalogItem
 {
-    public required ToolDefinition Definition { get; init; }
+    /// <summary>
+    /// The ID of the collection, which selections and settings store.
+    /// </summary>
+    public required string Id { get; init; }
 
-    public required IToolImplementation Implementation { get; init; }
+    public required string Icon { get; init; }
 
+    public required string DisplayName { get; init; }
+
+    public required string Description { get; init; }
+
+    /// <summary>
+    /// What the tools of this entry do, written for a model which picks the tools of an assistant.
+    /// </summary>
+    public required string DescriptionForLLM { get; init; }
+
+    /// <summary>
+    /// The tools of the collection which exist here, in the order in which the collection lists them.
+    /// </summary>
+    public required IReadOnlyList<ToolCatalogTool> Tools { get; init; }
+
+    /// <summary>
+    /// Whether the settings of every tool are complete; otherwise the state of the first tool whose settings are not.
+    /// </summary>
     public required ToolConfigurationState ConfigurationState { get; init; }
 
     public bool IsActive { get; init; }