Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Tabs: Agent Messages on is filled, off an outline; 💬 and × further apart; × the pane's size (#1216)

Deeb10e5197164c
diff --git a/desktop/design/agent-messages-review/01-rest-quiet-dark.png b/desktop/design/agent-messages-review/01-rest-quiet-dark.png
index 3bd5992a9..2eb26f5c3 100644
Binary files a/desktop/design/agent-messages-review/01-rest-quiet-dark.png and b/desktop/design/agent-messages-review/01-rest-quiet-dark.png differ
diff --git a/desktop/design/agent-messages-review/01-rest-quiet-light.png b/desktop/design/agent-messages-review/01-rest-quiet-light.png
index 18ff47a55..61f1f5883 100644
Binary files a/desktop/design/agent-messages-review/01-rest-quiet-light.png and b/desktop/design/agent-messages-review/01-rest-quiet-light.png differ
diff --git a/desktop/design/agent-messages-review/02-rest-messaging-dark.png b/desktop/design/agent-messages-review/02-rest-messaging-dark.png
index dffdfd4eb..9b87c25ee 100644
Binary files a/desktop/design/agent-messages-review/02-rest-messaging-dark.png and b/desktop/design/agent-messages-review/02-rest-messaging-dark.png differ
diff --git a/desktop/design/agent-messages-review/02-rest-messaging-light.png b/desktop/design/agent-messages-review/02-rest-messaging-light.png
index c8f57306c..b395a8603 100644
Binary files a/desktop/design/agent-messages-review/02-rest-messaging-light.png and b/desktop/design/agent-messages-review/02-rest-messaging-light.png differ
diff --git a/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-dark.png b/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-dark.png
index 6d83002cb..146718eca 100644
Binary files a/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-dark.png and b/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-dark.png differ
diff --git a/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-light.png b/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-light.png
index 1357523ee..62b56fa4e 100644
Binary files a/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-light.png and b/desktop/design/agent-messages-review/02b-rest-messaging-next-frame-light.png differ
diff --git a/desktop/design/agent-messages-review/03-hover-off-dark.png b/desktop/design/agent-messages-review/03-hover-off-dark.png
index d4a38185d..e7a016b2f 100644
Binary files a/desktop/design/agent-messages-review/03-hover-off-dark.png and b/desktop/design/agent-messages-review/03-hover-off-dark.png differ
diff --git a/desktop/design/agent-messages-review/03-hover-off-light.png b/desktop/design/agent-messages-review/03-hover-off-light.png
index 83856b1a0..b4d33318c 100644
Binary files a/desktop/design/agent-messages-review/03-hover-off-light.png and b/desktop/design/agent-messages-review/03-hover-off-light.png differ
diff --git a/desktop/design/agent-messages-review/04-hover-on-quiet-dark.png b/desktop/design/agent-messages-review/04-hover-on-quiet-dark.png
index 4e60539bf..c1616ef28 100644
Binary files a/desktop/design/agent-messages-review/04-hover-on-quiet-dark.png and b/desktop/design/agent-messages-review/04-hover-on-quiet-dark.png differ
diff --git a/desktop/design/agent-messages-review/04-hover-on-quiet-light.png b/desktop/design/agent-messages-review/04-hover-on-quiet-light.png
index 5f5f5ca65..08cb320e7 100644
Binary files a/desktop/design/agent-messages-review/04-hover-on-quiet-light.png and b/desktop/design/agent-messages-review/04-hover-on-quiet-light.png differ
diff --git a/desktop/design/agent-messages-review/05-hover-on-messaging-dark.png b/desktop/design/agent-messages-review/05-hover-on-messaging-dark.png
index 77ac5740a..4c9f9030e 100644
Binary files a/desktop/design/agent-messages-review/05-hover-on-messaging-dark.png and b/desktop/design/agent-messages-review/05-hover-on-messaging-dark.png differ
diff --git a/desktop/design/agent-messages-review/05-hover-on-messaging-light.png b/desktop/design/agent-messages-review/05-hover-on-messaging-light.png
index b3cefe9f2..7c9dde6db 100644
Binary files a/desktop/design/agent-messages-review/05-hover-on-messaging-light.png and b/desktop/design/agent-messages-review/05-hover-on-messaging-light.png differ
diff --git a/desktop/design/agent-messages-review/06-pointer-on-arrows-off-dark.png b/desktop/design/agent-messages-review/06-pointer-on-arrows-off-dark.png
index 0ffbba0e5..51c89a386 100644
Binary files a/desktop/design/agent-messages-review/06-pointer-on-arrows-off-dark.png and b/desktop/design/agent-messages-review/06-pointer-on-arrows-off-dark.png differ
diff --git a/desktop/design/agent-messages-review/06-pointer-on-arrows-off-light.png b/desktop/design/agent-messages-review/06-pointer-on-arrows-off-light.png
index 30871f5e7..4839d65f1 100644
Binary files a/desktop/design/agent-messages-review/06-pointer-on-arrows-off-light.png and b/desktop/design/agent-messages-review/06-pointer-on-arrows-off-light.png differ
diff --git a/desktop/design/agent-messages-review/08-crowded-rest-dark.png b/desktop/design/agent-messages-review/08-crowded-rest-dark.png
index 3464b7a9b..088c12b02 100644
Binary files a/desktop/design/agent-messages-review/08-crowded-rest-dark.png and b/desktop/design/agent-messages-review/08-crowded-rest-dark.png differ
diff --git a/desktop/design/agent-messages-review/08-crowded-rest-light.png b/desktop/design/agent-messages-review/08-crowded-rest-light.png
index 8c5573c34..2a51f8a9d 100644
Binary files a/desktop/design/agent-messages-review/08-crowded-rest-light.png and b/desktop/design/agent-messages-review/08-crowded-rest-light.png differ
diff --git a/desktop/design/agent-messages-review/09-crowded-hover-dark.png b/desktop/design/agent-messages-review/09-crowded-hover-dark.png
index 18fa3323d..6cee485ce 100644
Binary files a/desktop/design/agent-messages-review/09-crowded-hover-dark.png and b/desktop/design/agent-messages-review/09-crowded-hover-dark.png differ
diff --git a/desktop/design/agent-messages-review/09-crowded-hover-light.png b/desktop/design/agent-messages-review/09-crowded-hover-light.png
index 4c20de6cf..880f8522c 100644
Binary files a/desktop/design/agent-messages-review/09-crowded-hover-light.png and b/desktop/design/agent-messages-review/09-crowded-hover-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-messaging-0-dark.png b/desktop/design/agent-messages-review/anim/anim-messaging-0-dark.png
index 7eeab9b83..53631f870 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-messaging-0-dark.png and b/desktop/design/agent-messages-review/anim/anim-messaging-0-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-messaging-0-light.png b/desktop/design/agent-messages-review/anim/anim-messaging-0-light.png
index 5cfa810b7..4c67ef8f6 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-messaging-0-light.png and b/desktop/design/agent-messages-review/anim/anim-messaging-0-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-messaging-5-dark.png b/desktop/design/agent-messages-review/anim/anim-messaging-5-dark.png
index 67248b41d..afe59eba7 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-messaging-5-dark.png and b/desktop/design/agent-messages-review/anim/anim-messaging-5-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-messaging-5-light.png b/desktop/design/agent-messages-review/anim/anim-messaging-5-light.png
index 2f3c34857..09848e9ce 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-messaging-5-light.png and b/desktop/design/agent-messages-review/anim/anim-messaging-5-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-0-dark.png b/desktop/design/agent-messages-review/anim/anim-working-0-dark.png
index 2b8a216d7..c62b682f0 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-0-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-0-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-0-light.png b/desktop/design/agent-messages-review/anim/anim-working-0-light.png
index a672f4d2e..913b70c80 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-0-light.png and b/desktop/design/agent-messages-review/anim/anim-working-0-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-1-dark.png b/desktop/design/agent-messages-review/anim/anim-working-1-dark.png
index c0329f8b8..0b5aeb10e 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-1-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-1-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-1-light.png b/desktop/design/agent-messages-review/anim/anim-working-1-light.png
index 12c006c67..c3562082a 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-1-light.png and b/desktop/design/agent-messages-review/anim/anim-working-1-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-2-dark.png b/desktop/design/agent-messages-review/anim/anim-working-2-dark.png
index 6168c1123..8e483527b 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-2-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-2-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-2-light.png b/desktop/design/agent-messages-review/anim/anim-working-2-light.png
index 00b528991..773940ad3 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-2-light.png and b/desktop/design/agent-messages-review/anim/anim-working-2-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-3-dark.png b/desktop/design/agent-messages-review/anim/anim-working-3-dark.png
index 4e8974c92..b9518c377 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-3-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-3-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-3-light.png b/desktop/design/agent-messages-review/anim/anim-working-3-light.png
index 2fbe905d5..2db2c6140 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-3-light.png and b/desktop/design/agent-messages-review/anim/anim-working-3-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-4-dark.png b/desktop/design/agent-messages-review/anim/anim-working-4-dark.png
index 067197737..a0022b8bb 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-4-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-4-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-4-light.png b/desktop/design/agent-messages-review/anim/anim-working-4-light.png
index 94ba873c2..c99ce0a7c 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-4-light.png and b/desktop/design/agent-messages-review/anim/anim-working-4-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-5-dark.png b/desktop/design/agent-messages-review/anim/anim-working-5-dark.png
index 2893ccc11..5a33bc267 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-5-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-5-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-5-light.png b/desktop/design/agent-messages-review/anim/anim-working-5-light.png
index 0e9ba53ee..1f75c0524 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-5-light.png and b/desktop/design/agent-messages-review/anim/anim-working-5-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-6-dark.png b/desktop/design/agent-messages-review/anim/anim-working-6-dark.png
index ec2789257..936e01b26 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-6-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-6-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-6-light.png b/desktop/design/agent-messages-review/anim/anim-working-6-light.png
index 857173ac3..fd42df1fd 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-6-light.png and b/desktop/design/agent-messages-review/anim/anim-working-6-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-7-dark.png b/desktop/design/agent-messages-review/anim/anim-working-7-dark.png
index 27b43d913..1a93abd80 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-7-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-7-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-7-light.png b/desktop/design/agent-messages-review/anim/anim-working-7-light.png
index 2cdf2a37b..8fe29e3cf 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-7-light.png and b/desktop/design/agent-messages-review/anim/anim-working-7-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-8-dark.png b/desktop/design/agent-messages-review/anim/anim-working-8-dark.png
index 68e3b7445..cc0cefb78 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-8-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-8-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-8-light.png b/desktop/design/agent-messages-review/anim/anim-working-8-light.png
index 334343a57..430224552 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-8-light.png and b/desktop/design/agent-messages-review/anim/anim-working-8-light.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-9-dark.png b/desktop/design/agent-messages-review/anim/anim-working-9-dark.png
index 5d6cc8027..6e81dd95e 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-9-dark.png and b/desktop/design/agent-messages-review/anim/anim-working-9-dark.png differ
diff --git a/desktop/design/agent-messages-review/anim/anim-working-9-light.png b/desktop/design/agent-messages-review/anim/anim-working-9-light.png
index ddeb50b0b..a14f78b9a 100644
Binary files a/desktop/design/agent-messages-review/anim/anim-working-9-light.png and b/desktop/design/agent-messages-review/anim/anim-working-9-light.png differ
diff --git a/desktop/lib/shared/theme/app_icons.dart b/desktop/lib/shared/theme/app_icons.dart
index 3b98e7901..8bf93d137 100644
--- a/desktop/lib/shared/theme/app_icons.dart
+++ b/desktop/lib/shared/theme/app_icons.dart
@@ -1,3 +1,4 @@
+import 'package:flutter/material.dart' show Icons;
import 'package:lucide_icons_flutter/lucide_icons.dart';
/// One outline family for app actions, navigation, and status.
@@ -115,6 +116,11 @@ abstract final class AppIcons {
static const messageCircleQuestionMark =
LucideIcons.messageCircleQuestionMark400;
static const messagesSquare = LucideIcons.messagesSquare400;
+
+ /// A tab's Agent Messages on and off: Lucide has no filled chat, and one outline in two tints read alike (owner,
+ /// 2026-10-12). Material's pair is filled and outlined in one drawing, as AppKit's `bubble.left.and.bubble.right`.
+ static const agentMessagesOn = Icons.forum;
+ static const agentMessagesOff = Icons.forum_outlined;
static const messageSquareText = LucideIcons.messageSquareText400;
static const minimize = LucideIcons.minimize400;
static const minus = LucideIcons.minus400;
diff --git a/desktop/lib/widgets/desktop_workspace_tab.dart b/desktop/lib/widgets/desktop_workspace_tab.dart
index 10fde669a..3c75e77a5 100644
--- a/desktop/lib/widgets/desktop_workspace_tab.dart
+++ b/desktop/lib/widgets/desktop_workspace_tab.dart
@@ -65,8 +65,9 @@ class DesktopWorkspaceTab extends StatefulWidget {
// × and, left of it, 💬, inside the tab's curved body, with a dead gap
// between them so a click just off × never toggles 💬. They show only on
- // hover; at rest the name and status have the whole tab.
- static const closeWidth = 16.0, messagesWidth = 16.0, accessoryGap = 3.0;
+ // hover; at rest the name and status have the whole tab. 20pt targets 8pt
+ // apart: 16pt ones 3pt apart were easy to click by mistake (owner, 2026-10-12).
+ static const closeWidth = 20.0, messagesWidth = 20.0, accessoryGap = 8.0;
static const _restingInset = grid.AppDesktop.tabShoulder + 6;
static const _revealedInset =
closeWidth + accessoryGap + messagesWidth + grid.AppDesktop.tabCloseInset;
@@ -321,16 +322,18 @@ class _DesktopWorkspaceTabState extends State<DesktopWorkspaceTab> {
),
state: messages,
onPressed: widget.onToggleAgentMessages,
+ // Filled at full strength while on, a quieter
+ // outline while off (AppKit's SwarmTitlebar too).
style: messagesOn
? _accessoryStyle(
widget.messagesColor ?? foreground,
- MediaQuery.highContrastOf(context)
- ? 1
- : .85,
+ 1,
)
: _accessoryStyle(
foreground,
- quietOpacity,
+ MediaQuery.highContrastOf(context)
+ ? .7
+ : .35,
),
),
),
@@ -419,7 +422,12 @@ class _AgentMessagesButton extends StatelessWidget {
height: 32,
),
style: style,
- icon: const Icon(AppIcons.messagesSquare, size: 13),
+ icon: Icon(
+ state == TabMessagesState.off
+ ? AppIcons.agentMessagesOff
+ : AppIcons.agentMessagesOn,
+ size: 14,
+ ),
),
),
);
diff --git a/desktop/lib/widgets/harness_activity_mark.dart b/desktop/lib/widgets/harness_activity_mark.dart
index 3bad9b1cf..21a7bf6f5 100644
--- a/desktop/lib/widgets/harness_activity_mark.dart
+++ b/desktop/lib/widgets/harness_activity_mark.dart
@@ -298,8 +298,9 @@ class _MessagingMarkState extends State<MessagingMark> {
'messaging-mark:${mirrored ? 'mirrored' : 'plain'}',
),
flipX: mirrored,
+ // Filled, as the tab's 💬 is while Agent Messages is on.
child: Icon(
- AppIcons.messagesSquare,
+ AppIcons.agentMessagesOn,
size: 13,
color: widget.color,
),
diff --git a/desktop/macos/Runner/SwarmTitlebar.swift b/desktop/macos/Runner/SwarmTitlebar.swift
index 16a526abb..7d263c7a1 100644
--- a/desktop/macos/Runner/SwarmTitlebar.swift
+++ b/desktop/macos/Runner/SwarmTitlebar.swift
@@ -2720,12 +2720,14 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
// Mirror AppDesktop.tabCloseInset and DesktopWorkspaceTab: × and, left of
// it, Agent Messages' 💬, as 32pt-tall targets inside the curved tab body,
// with a dead gap between them so a click just off × never toggles 💬. They
- // show only on hover; at rest the name and status have the whole tab.
+ // show only on hover; at rest the name and status have the whole tab. 20pt
+ // targets 8pt apart: 16pt ones 3pt apart were "really easy to click by
+ // mistake" (owner, 2026-10-12).
private static let trailingInset: CGFloat = 8
private static let accessoryHeight: CGFloat = 32
- private static let closeWidth: CGFloat = 16
- private static let accessoryGap: CGFloat = 3
- private static let messagesWidth: CGFloat = 16
+ private static let closeWidth: CGFloat = 20
+ private static let accessoryGap: CGFloat = 8
+ private static let messagesWidth: CGFloat = 20
private static let restingInset: CGFloat = shoulder + 6
private static let revealedInset: CGFloat = trailingInset + closeWidth + accessoryGap + messagesWidth
private static let gap: CGFloat = 6
@@ -2862,8 +2864,9 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
closeButton.title = ""
closeButton.isBordered = false
closeButton.image = HarnessControlSymbols.image("xmark")
- // Match the small visible cross of the pane's 12pt Lucide close mark.
- closeButton.symbolConfiguration = NSImage.SymbolConfiguration(pointSize: 8, weight: .regular)
+ // The pane's close mark, 12pt Lucide x: 7pt across with a 1.07pt stroke. 9pt semibold xmark draws 7.2pt
+ // with 1.04pt (measured); 8pt regular drew 6.2pt with half the stroke, "too small" beside it (owner, 2026-10-12).
+ closeButton.symbolConfiguration = NSImage.SymbolConfiguration(pointSize: 9, weight: .semibold)
closeButton.restingOpacity = 0.45
closeButton.highContrastRestingOpacity = 0.7
closeButton.imagePosition = .imageOnly
@@ -2945,12 +2948,15 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
messagesButton.isHidden = agentMessages == nil || !isRevealed
}
/// The 💬's look, tooltip and accessibility, and the menu rows, for its state:
- /// grey while off, Agent Messages' color while on.
+ /// filled in Agent Messages' color while on, a quiet outline while off. One
+ /// outline in two tints read alike: "really hard to see on/off states"
+ /// (owner, 2026-10-12), who chose filled over a blue pill and a slash.
private func updateMessagesControls() {
for item in messagesItems { item.isHidden = agentMessages == nil }
if let state = agentMessages {
+ messagesButton.image = HarnessControlSymbols.image(state.on ? "bubble.left.and.bubble.right.fill" : "bubble.left.and.bubble.right")
messagesButton.foreground = state.on ? messagesColor : foreground
- messagesButton.restingOpacity = state.on ? 0.85 : 0.45
+ messagesButton.restingOpacity = state.on ? 1 : 0.35
messagesButton.highContrastRestingOpacity = state.on ? 1 : 0.7
messagesButton.toolTip = state.tooltip
messagesButton.setAccessibilityLabel("Agent Messages")
@@ -3143,7 +3149,8 @@ struct SwarmTabMessages: Equatable {
/// half second on the activity clock so the speakers trade sides; still at
/// frame 0 (Reduce Motion).
static func drawMessaging(in rect: NSRect, frame: Int, color: NSColor) {
- guard let symbol = NSImage(systemSymbolName: "bubble.left.and.bubble.right", accessibilityDescription: nil)?
+ // Filled, as the tab's 💬 is while Agent Messages is on, which it is whenever agents message.
+ guard let symbol = NSImage(systemSymbolName: "bubble.left.and.bubble.right.fill", accessibilityDescription: nil)?
.withSymbolConfiguration(NSImage.SymbolConfiguration(pointSize: 10, weight: .medium)) else { return }
let glyph = NSRect(x: rect.midX - symbol.size.width / 2, y: rect.midY - symbol.size.height / 2,
width: symbol.size.width, height: symbol.size.height)
diff --git a/desktop/test/agent_messages_tab_test.dart b/desktop/test/agent_messages_tab_test.dart
index aa205c840..9244eef80 100644
--- a/desktop/test/agent_messages_tab_test.dart
+++ b/desktop/test/agent_messages_tab_test.dart
@@ -71,15 +71,17 @@ Finder _messages(String id) => find.byKey(ValueKey('tab-agent-messages:$id'));
Finder _close(String id) => find.byKey(ValueKey('tab-close:$id'));
Finder _label(String id) => find.byKey(ValueKey('tab-label:$id'));
+Finder _glyphOf(String id) =>
+ find.descendant(of: _messages(id), matching: find.byType(Icon));
+
/// The ink the 💬 glyph is drawn in, while the pointer is not on it.
-Color _glyph(WidgetTester tester, String id) => IconTheme.of(
- tester.element(
- find.descendant(
- of: _messages(id),
- matching: find.byIcon(AppIcons.messagesSquare),
- ),
- ),
-).color!;
+Color _glyph(WidgetTester tester, String id) =>
+ IconTheme.of(tester.element(_glyphOf(id))).color!;
+
+/// Which 💬 is drawn: filled while on, an outline while off (owner, 2026-10-12:
+/// one outline in two tints read alike).
+IconData _drawn(WidgetTester tester, String id) =>
+ tester.widget<Icon>(_glyphOf(id)).icon!;
String _tooltip(WidgetTester tester, String id) => tester
.widget<Tooltip>(
@@ -114,7 +116,8 @@ void main() {
expect(_messages('app').hitTestable(), findsOneWidget);
expect(_close('app').hitTestable(), findsOneWidget);
final grey = _glyph(tester, 'app');
- expect(grey.a, closeTo(.45, .01));
+ expect(grey.a, closeTo(.35, .01));
+ expect(_drawn(tester, 'app'), AppIcons.agentMessagesOff);
expect(
grey.withValues(alpha: 1),
grid.AppTheme.surfacePalette.foreground,
@@ -151,7 +154,8 @@ void main() {
expect(_messages('app').hitTestable(), findsOneWidget);
final ink = _glyph(tester, 'app');
expect(ink.withValues(alpha: 1), _messagesColor);
- expect(ink.a, closeTo(.85, .01));
+ expect(ink.a, closeTo(1, .01));
+ expect(_drawn(tester, 'app'), AppIcons.agentMessagesOn);
expect(_tooltip(tester, 'app'), 'Agent messages on · click to turn off');
expect(
find.byKey(const ValueKey('status:app')),
diff --git a/desktop/tool/swarm_titlebar_checks.swift b/desktop/tool/swarm_titlebar_checks.swift
index 29213ca58..a8198fcfb 100644
--- a/desktop/tool/swarm_titlebar_checks.swift
+++ b/desktop/tool/swarm_titlebar_checks.swift
@@ -462,7 +462,8 @@ private extension SwarmTabButton {
}
func checkHoverClose() throws {
- frame = NSRect(x: 0, y: 0, width: 240, height: 40)
+ // Room for the name beside 20pt targets 8pt apart (they were 16pt and 3pt apart, in 240pt).
+ frame = NSRect(x: 0, y: 0, width: 260, height: 40)
contentCenterY = 20
name = "1: Release planning"
displayLabel = name
@@ -476,8 +477,8 @@ private extension SwarmTabButton {
timestamp: 0, windowNumber: 0, context: nil, eventNumber: 0, clickCount: 0, pressure: 0)!
mouseEntered(with: hover)
try checkTitlebar(!closeButton.isHidden && closeButton.frame.minX > title.maxX &&
- closeButton.frame.size == NSSize(width: 16, height: 32) && closeButton.frame.maxX == bounds.maxX - 8,
- "A hovered tab exposes a separate 16x32pt close target at its right inset")
+ closeButton.frame.size == NSSize(width: 20, height: 32) && closeButton.frame.maxX == bounds.maxX - 8,
+ "A hovered tab exposes a separate 20x32pt close target at its right inset")
try checkTitlebar(accessibilityChildren()?.count == 2 && closeButton.accessibilityLabel() == "Close 1: Release planning",
"The hover close button has the exact custom title as its accessible purpose")
let closeBitmap = closeButton.renderedBitmap()
@@ -490,7 +491,7 @@ private extension SwarmTabButton {
let inkWidth = (closeInk.map(\.x).max() ?? 0) - (closeInk.map(\.x).min() ?? 0) + 1
let inkHeight = (closeInk.map(\.y).max() ?? 0) - (closeInk.map(\.y).min() ?? 0) + 1
try checkTitlebar(!closeInk.isEmpty && inkWidth <= 7 && inkHeight <= 7,
- "The tab close paints a tiny regular cross inside its unchanged target")
+ "The tab close paints the pane's 7pt cross inside its target")
closeButton.performClick(nil)
try checkTitlebar(events == ["close"], "Clicking the close control closes once without selecting the tab")
let hoveredBitmap = renderedBitmap()
@@ -637,7 +638,7 @@ private extension SwarmTabButton {
"Revealed, the title moves only left, and only as far as 💬 and × need")
try checkTitlebar(selectButton.frame == bounds, "Selection and drag retain the whole tab target beneath its accessory")
try checkTitlebar(subviews.count == 3 && closeButton.frame.maxX == bounds.maxX - 8 &&
- closeButton.frame.minX - messagesButton.frame.maxX == 3,
+ closeButton.frame.minX - messagesButton.frame.maxX == 8,
"The close action, and 💬 left of it past a dead gap, stay inset inside the tab's curved body")
}
@@ -657,6 +658,10 @@ private extension SwarmTabButton {
defer { emit = nil }
let hover = NSEvent.mouseEvent(with: .mouseMoved, location: .zero, modifierFlags: [],
timestamp: 0, windowNumber: 0, context: nil, eventNumber: 0, clickCount: 0, pressure: 0)!
+ /// Which symbol the button draws: filled while on, outlined while off (owner, 2026-10-12).
+ func drawn(_ button: NSButton, _ symbol: String) -> Bool {
+ button.image?.tiffRepresentation == HarnessControlSymbols.image(symbol)?.tiffRepresentation
+ }
func hasMessagesInk(_ view: NSView? = nil) -> Bool {
let bitmap = (view ?? self).renderedBitmap()
return (0..<bitmap.pixelsWide).contains { x in
@@ -682,10 +687,10 @@ private extension SwarmTabButton {
let title = titleRect
mouseEntered(with: hover)
try checkTitlebar(!messagesButton.isHidden && !closeButton.isHidden &&
- closeButton.frame.minX - messagesButton.frame.maxX == 3 &&
- messagesButton.foreground == foreground && messagesButton.restingOpacity == 0.45 &&
- !hasMessagesInk(messagesButton),
- "Hovered and off: a grey 💬 just left of ×")
+ closeButton.frame.minX - messagesButton.frame.maxX == 8 &&
+ messagesButton.foreground == foreground && messagesButton.restingOpacity == 0.35 &&
+ drawn(messagesButton, "bubble.left.and.bubble.right") && !hasMessagesInk(messagesButton),
+ "Hovered and off: a quiet outlined 💬, 8pt clear of ×")
let gap = NSPoint(x: closeButton.frame.minX - 1.5, y: closeButton.frame.midY)
try checkTitlebar(!messagesButton.frame.contains(gap) && !closeButton.frame.contains(gap),
"A click between 💬 and × lands on neither")
@@ -705,10 +710,11 @@ private extension SwarmTabButton {
try checkTitlebar(messagesButton.isHidden && !hasMessagesInk(), "On and quiet, a tab at rest shows nothing extra")
mouseEntered(with: hover)
try checkTitlebar(!messagesButton.isHidden && messagesButton.foreground == messagesColor &&
- messagesButton.restingOpacity == 0.85 && hasMessagesInk(messagesButton) && !hasMessagesInk() &&
+ messagesButton.restingOpacity == 1 && drawn(messagesButton, "bubble.left.and.bubble.right.fill") &&
+ hasMessagesInk(messagesButton) && !hasMessagesInk() &&
messagesButton.toolTip == "Agent messages on · click to turn off" &&
messagesButton.accessibilityValue() as? String == "On",
- "Hovered and on: 💬 in Agent Messages' color, which turns it off")
+ "Hovered and on: 💬 filled in Agent Messages' color, which turns it off")
mouseExited(with: hover)
agentMessages = SwarmTabMessages(on: true, flowing: true)
diff --git a/docs/design/2026-10-10-agent-messages.md b/docs/design/2026-10-10-agent-messages.md
index cc755e27d..30fa925c1 100644
--- a/docs/design/2026-10-10-agent-messages.md
+++ b/docs/design/2026-10-10-agent-messages.md
@@ -57,8 +57,8 @@ holding ⌘ changes nothing on them (owner, 2026-10-11).
| State | Not hovered | Hovered | Click 💬 |
|---|---|---|---|
-| Off (default) | `app ✓` | `app ✓ 💬 ×` (💬 grey) | turns on |
-| On, quiet | `app ✓` | `app ✓ 💬 ×` (💬 in color) | turns off |
+| Off (default) | `app ✓` | `app ✓ 💬 ×` (💬 a quiet outline) | turns on |
+| On, quiet | `app ✓` | `app ✓ 💬 ×` (💬 filled, in color) | turns off |
| On, messages flowing | `app 💬` (the status slot, animated) | `app 💬 💬 ×` | turns off |
While agents in the tab message each other, its status slot (where the working spinner, ✓ and ? go)
@@ -70,6 +70,12 @@ clear of the status marks' cyan, green, yellow and red, and the bubbles' shape c
holds it still. At rest a tab gives its name the whole width; when hovered, a name that would run into
💬 and × moves left only as far as they need, then gives up its tail.
+On and off differ in shape as well as color: on, the bubbles are filled, at full strength; off, an outline
+at a third of the text's strength. One outline in two tints read alike ("really hard to see on/off
+states", owner, 2026-10-12, who chose filled over a blue pill and a slash). 💬 and × are 20pt targets 8pt
+apart (16pt, 3pt apart, were easy to click by mistake), and the tab's × is the pane's: 7pt across with a
+1pt stroke (AppKit `xmark` 9pt semibold beside Lucide's 12pt `x`).
+
Tooltips: "Agent messages off · click to turn on", "Agent messages on · click to turn off",
"Agents messaging · click to turn off". The tab's right-click menu and the File menu gain **Agent Messages**
(a checkmark) and **Show Agent Messages**.