Added a way to read what the AI received from your sources (#1100)

Co-authored-by: Thorsten Sommer <SommerEngineering@users.noreply.github.com>

app/MindWork AI Studio/Tools/SourceDocumentLocationExtensions.cs

@@ -0,0 +1,81 @@
+using AIStudio.Tools.PluginSystem;
+using AIStudio.Tools.Rust;
+using AIStudio.Tools.Services;
+
+namespace AIStudio.Tools;
+
+/// <summary>
+/// What the user can do with the document a source names: open it, or show it in the file manager.
+/// </summary>
+/// <remarks>
+/// The list of sources and the passages of a source both offer it, and a failure reaches the user
+/// the same way from either of them.
+/// </remarks>
+public static class SourceDocumentLocationExtensions
+{
+    private static readonly ILogger LOGGER = Program.LOGGER_FACTORY.CreateLogger(nameof(SourceDocumentLocationExtensions));
+
+    private static string TB(string fallbackEN) => I18N.I.T(fallbackEN, typeof(SourceDocumentLocationExtensions).Namespace, nameof(SourceDocumentLocationExtensions));
+
+    /// <summary>
+    /// Opens the document in the program the system uses for it, at its page.
+    /// </summary>
+    /// <remarks>
+    /// Whether the program can be sent to a page is the runtime's business, and it says afterwards
+    /// whether it managed to. Nothing is shown about that: the document is open, and the page is
+    /// named where the user asked to open it.
+    /// </remarks>
+    /// <param name="document">The document to open, and the page to show.</param>
+    /// <param name="rustService">The runtime, which opens the document.</param>
+    public static async Task OpenAsync(this SourceDocumentLocation document, RustService rustService)
+    {
+        OpenDocumentResponse response;
+        try
+        {
+            response = await rustService.TryOpenDocumentInSystemViewer(document.Path, document.PageNumber);
+        }
+        catch (Exception e)
+        {
+            LOGGER.LogWarning(e, "Could not open a source document.");
+            await MessageBus.INSTANCE.SendError(new(Icons.Material.Filled.Description, TB("Could not open the document.")));
+            return;
+        }
+
+        if (response.Success)
+            return;
+
+        var issue = string.IsNullOrWhiteSpace(response.Issue) ? TB("Unknown error") : response.Issue;
+        await MessageBus.INSTANCE.SendError(new(Icons.Material.Filled.Description, string.Format(TB("Could not open the document: {0}"), issue)));
+    }
+
+    /// <summary>
+    /// Opens the file browser of the system and selects the document in it.
+    /// </summary>
+    /// <remarks>
+    /// The second way out: a document which the system opens in the wrong program, or which the user
+    /// wants to move or send on instead of read, is reached from here without being opened. This is
+    /// the same way out the embeddings page offers for a file it could not read.
+    /// </remarks>
+    /// <param name="document">The document to show.</param>
+    /// <param name="rustService">The runtime, which opens the file browser.</param>
+    public static async Task ShowInFileManagerAsync(this SourceDocumentLocation document, RustService rustService)
+    {
+        OpenPathResponse response;
+        try
+        {
+            response = await rustService.TryOpenPathInRuntimeFileManager(document.Path);
+        }
+        catch (Exception e)
+        {
+            LOGGER.LogWarning(e, "Could not show a source document in the file manager.");
+            await MessageBus.INSTANCE.SendError(new(Icons.Material.Filled.FolderOpen, TB("Could not open the file location.")));
+            return;
+        }
+
+        if (response.Success)
+            return;
+
+        var issue = string.IsNullOrWhiteSpace(response.Issue) ? TB("Unknown error") : response.Issue;
+        await MessageBus.INSTANCE.SendError(new(Icons.Material.Filled.FolderOpen, string.Format(TB("Could not open the file location: {0}"), issue)));
+    }
+}