Added detailed plugin information to the plugins page (#1013)

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

app/Tests/Tools/PluginSystem/PluginLastChangedTests.cs

@@ -0,0 +1,122 @@
+using AIStudio.Tools.PluginSystem;
+using AIStudio.Tools.PluginSystem.Assistants;
+
+namespace AIStudio.Tests.Tools.PluginSystem;
+
+/// <summary>
+/// Checks how a plugin states when it was last changed.
+/// </summary>
+/// <remarks>
+/// LAST_CHANGED is optional and always a point in time in UTC, so that the UI can show it in the time
+/// zone of the user. A date alone cannot be converted: whether a day in UTC is the same day locally
+/// depends on the time. A plugin without the field, or with a value of another form, still loads, and
+/// the value then counts as absent. AI Studio writes the field itself whenever it writes a direct chat
+/// launcher, and what it writes has to load back to the same point in time.
+/// </remarks>
+[TestFixture]
+public sealed class PluginLastChangedTests
+{
+    private static readonly Guid PLUGIN_ID = Guid.Parse("3f6a2c8e-9b1d-4e7a-8c5f-2d4b6e8a0c1f");
+
+    private static readonly DateTimeOffset LAST_CHANGED = new(2026, 10, 12, 14, 30, 5, TimeSpan.Zero);
+
+    private const string LAST_CHANGED_LINE = "LAST_CHANGED = \"2026-10-12T14:30:05Z\"";
+
+    [Test]
+    public async Task APointInTimeInUtcIsRead()
+    {
+        using var plugin = await LoadModelPlugin(LAST_CHANGED_LINE);
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(plugin.IsValid, Is.True, string.Join(" ", plugin.Issues));
+            Assert.That(plugin.LastChanged, Is.EqualTo(LAST_CHANGED));
+            Assert.That(plugin.LastChanged?.Offset, Is.EqualTo(TimeSpan.Zero), "The UI converts from UTC, so the value has to be in UTC.");
+        });
+    }
+
+    [Test]
+    public async Task AMissingFieldIsNoIssue()
+    {
+        using var plugin = await LoadModelPlugin(string.Empty);
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(plugin.IsValid, Is.True, string.Join(" ", plugin.Issues));
+            Assert.That(plugin.LastChanged, Is.Null);
+        });
+    }
+
+    [TestCase("\"2026-10-12\"")]
+    [TestCase("\"2026-10-12T14:30:05\"")]
+    [TestCase("\"2026-10-12T16:30:05+02:00\"")]
+    [TestCase("\"2026-13-01T00:00:00Z\"")]
+    [TestCase("\"12.10.2026 14:30:05\"")]
+    [TestCase("20261012")]
+    public async Task AMalformedValueIsIgnoredAndThePluginStillLoads(string luaValue)
+    {
+        using var plugin = await LoadModelPlugin($"LAST_CHANGED = {luaValue}");
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(plugin.IsValid, Is.True, "A malformed LAST_CHANGED is no reason to refuse an otherwise valid plugin.");
+            Assert.That(plugin.LastChanged, Is.Null);
+        });
+    }
+
+    [Test]
+    public void ALocalTimeIsWrittenInUtc()
+    {
+        var localTime = new DateTimeOffset(2026, 10, 12, 16, 30, 5, TimeSpan.FromHours(2));
+
+        Assert.That(PluginBase.FormatLastChanged(localTime), Is.EqualTo("2026-10-12T14:30:05Z"), "The format ends in a literal Z, so a local time must not be written as it is.");
+    }
+
+    [Test]
+    public void TheWriterLeavesTheFieldOutWithoutAPointInTime()
+    {
+        var lua = DirectChatLauncherLuaWriter.Write(CreateLauncherMetadata(null), CreateLauncherDefinition());
+
+        Assert.That(lua, Does.Not.Contain("LAST_CHANGED"));
+    }
+
+    [Test]
+    public async Task WhatTheWriterWritesLoadsBackToTheSamePointInTime()
+    {
+        var lua = DirectChatLauncherLuaWriter.Write(CreateLauncherMetadata(LAST_CHANGED), CreateLauncherDefinition());
+        using var plugin = await PluginFactory.Load(null, lua);
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(lua, Does.Contain(LAST_CHANGED_LINE));
+            Assert.That(plugin.IsValid, Is.True, string.Join(" ", plugin.Issues));
+            Assert.That(plugin.LastChanged, Is.EqualTo(LAST_CHANGED));
+        });
+    }
+
+    /// <summary>
+    /// Loads a model plugin, the plugin type with the fewest fields beyond the ones every plugin has.
+    /// </summary>
+    /// <param name="lastChangedLine">The Lua line which states LAST_CHANGED, or an empty string.</param>
+    private static Task<PluginBase> LoadModelPlugin(string lastChangedLine) => PluginFactory.Load(null, $$"""
+        ID = "{{PLUGIN_ID}}"
+        NAME = "Models for the tests"
+        DESCRIPTION = "A model plugin which declares no models."
+        VERSION = "1.0.0"
+        {{lastChangedLine}}
+        TYPE = "MODEL"
+        AUTHORS = {"MindWork AI"}
+        SUPPORT_CONTACT = "MindWork AI"
+        SOURCE_URL = "https://github.com/MindWorkAI/AI-Studio"
+        CATEGORIES = {"CORE"}
+        TARGET_GROUPS = {"EVERYONE"}
+        IS_MAINTAINED = true
+        DEPRECATION_MESSAGE = ""
+        MODELS = {}
+        """);
+
+    private static DirectChatLauncherPluginMetadata CreateLauncherMetadata(DateTimeOffset? lastChanged) => new(PLUGIN_ID, "1.0.0", lastChanged, ["MindWork AI"], "MindWork AI",
+        "https://github.com/MindWorkAI/AI-Studio", [PluginCategory.CORE], [PluginTargetGroup.EVERYONE], IsMaintained: true, DeprecationMessage: string.Empty, IsAssistantBuilderGenerated: false);
+
+    private static DirectChatLauncherDefinition CreateLauncherDefinition() => new("Launcher for the tests", "Launcher for the tests", "Opens a disappearing chat.", new AssistantChatLaunchConfiguration(string.Empty, null, null, null, null, null));
+}