fix: preserve full chat text for Tray TTS (#900)

Keep notification previews compact while retaining the complete assistant response for Tray text-to-speech. Add legacy/null/empty fallback coverage at the Tray ownership boundary.

Thanks @ArtLupo for the contribution.

Co-authored-by: Master <artlupo3689@gmail.com>

Author: ArtLupo

src/OpenClaw.Shared/Models.cs

@@ -98,6 +98,7 @@ public class OpenClawNotification
 {
     public string Title { get; set; } = "";
     public string Message { get; set; } = "";
+    public string? FullMessage { get; set; }
     public string Type { get; set; } = "";
     public bool IsChat { get; set; } = false; // True if from chat response
 

src/OpenClaw.Shared/OpenClawGatewayClient.cs

@@ -3248,6 +3248,7 @@ private void EmitChatNotification(string text, string? sessionKey = null)
         var notification = new OpenClawNotification
         {
             Message = displayText,
+            FullMessage = text,
             IsChat = true,
             SessionKey = sessionKey
         };

src/OpenClaw.Tray.WinUI/App.xaml.cs

@@ -2747,6 +2747,8 @@ private void OnGatewayNotificationReceived(object? sender, OpenClawNotification
         // if the user enabled "Read responses aloud".
         if (notification.IsChat && !string.IsNullOrEmpty(notification.Message))
         {
+            var speechText = ChatNotificationSpeechText.Resolve(notification);
+
             // Suppress TTS/voice overlay when the user has aborted the response.
             if (ChatProvider?.IsResponseSuppressed == true)
                 return;
@@ -2767,7 +2769,7 @@ private void OnGatewayNotificationReceived(object? sender, OpenClawNotification
             // TTS: read response aloud whenever the toggle is on (any chat surface).
             if (_settings?.VoiceTtsEnabled == true)
             {
-                _ = (_chatCoordinator?.SpeakResponseAsync(notification.Message) ?? Task.CompletedTask);
+                _ = (_chatCoordinator?.SpeakResponseAsync(speechText) ?? Task.CompletedTask);
             }
         }
 

src/OpenClaw.Tray.WinUI/Services/ChatNotificationSpeechText.cs

@@ -0,0 +1,14 @@
+using OpenClaw.Shared;
+
+namespace OpenClawTray.Services;
+
+internal static class ChatNotificationSpeechText
+{
+    public static string Resolve(OpenClawNotification notification)
+    {
+        ArgumentNullException.ThrowIfNull(notification);
+        return string.IsNullOrEmpty(notification.FullMessage)
+            ? notification.Message
+            : notification.FullMessage;
+    }
+}

tests/OpenClaw.Shared.Tests/OpenClawGatewayClientTests.cs

@@ -990,6 +990,37 @@ public void ProcessRawMessage_SessionMessageAssistantNotification_DependsOnFinal
         }
     }
 
+    [Fact]
+    public void ProcessRawMessage_SessionMessageAssistantNotification_PreservesFullMessage()
+    {
+        var helper = new GatewayClientTestHelper();
+        OpenClawNotification? notification = null;
+        helper.Client.NotificationReceived += (_, value) => notification = value;
+
+        var fullMessage = new string('x', 240);
+
+        helper.ProcessRawMessage($$"""
+        {
+          "type": "event",
+          "event": "session.message",
+          "payload": {
+            "sessionKey": "agent:main:whatsapp:direct:+15551234567",
+            "message": {
+              "role": "assistant",
+              "content": "{{fullMessage}}",
+              "timestamp": 1781631280633
+            },
+            "state": "final"
+          }
+        }
+        """);
+
+        Assert.NotNull(notification);
+        Assert.True(notification!.IsChat);
+        Assert.Equal(fullMessage[..200] + "…", notification.Message);
+        Assert.Equal(fullMessage, notification.FullMessage);
+    }
+
     [Fact]
     public void ProcessRawMessage_AgentEventLogsRawLengthWithoutPayloadContent()
     {

tests/OpenClaw.Tray.Tests/OpenClaw.Tray.Tests.csproj

@@ -73,6 +73,7 @@
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\ToastActivationRouter.cs" Link="Services\ToastActivationRouter.cs" />
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\AppNotificationService.cs" Link="Services\AppNotificationService.cs" />
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\AppNotificationMapper.cs" Link="Services\AppNotificationMapper.cs" />
+    <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\ChatNotificationSpeechText.cs" Link="Services\ChatNotificationSpeechText.cs" />
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\AppNotificationPublisher.cs" Link="Services\AppNotificationPublisher.cs" />
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\ConnectionStatusPresenter.cs" Link="Services\ConnectionStatusPresenter.cs" />
     <Compile Include="..\..\src\OpenClaw.Tray.WinUI\Services\McpRuntimeStatePolicy.cs" Link="Services\McpRuntimeStatePolicy.cs" />

tests/OpenClaw.Tray.Tests/Services/ChatNotificationSpeechTextTests.cs

@@ -0,0 +1,36 @@
+using OpenClaw.Shared;
+using OpenClawTray.Services;
+using Xunit;
+
+namespace OpenClaw.Tray.Tests.Services;
+
+public sealed class ChatNotificationSpeechTextTests
+{
+    [Fact]
+    public void Resolve_UsesFullMessageWhenPreviewWasTruncated()
+    {
+        var fullMessage = new string('x', 240);
+
+        var resolved = ChatNotificationSpeechText.Resolve(new OpenClawNotification
+        {
+            Message = fullMessage[..200] + "…",
+            FullMessage = fullMessage
+        });
+
+        Assert.Equal(fullMessage, resolved);
+    }
+
+    [Theory]
+    [InlineData(null)]
+    [InlineData("")]
+    public void Resolve_FallsBackToPreviewWhenFullMessageIsUnavailable(string? fullMessage)
+    {
+        var resolved = ChatNotificationSpeechText.Resolve(new OpenClawNotification
+        {
+            Message = "Preview",
+            FullMessage = fullMessage
+        });
+
+        Assert.Equal("Preview", resolved);
+    }
+}