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.

Add macOS notification menu and faster workspace tooltips (#495)

Deeab3661d5b379
diff --git a/desktop/README.md b/desktop/README.md
index 39b3a6961..e8d431bcb 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -181,14 +181,25 @@ upstream package upgrade without preserving the local rendering and IME fixes.
## Harness manager
-The terminal icon to the left of Harness Store opens a compact list across your
+On macOS, the Harness portrait symbol follows the system menu bar's appearance and
+carries a small circular unread badge at its bottom-right corner,
+only when notifications are unread (`99+` above 99; the tooltip keeps the exact count). Open it for
+sessions with unread results or questions, grouped
+by project and marked with blue dots. Read sessions disappear from the list;
+an empty inbox says “No unread notifications.” The menu also offers New Harness,
+Clear All Notifications, Open Harness, Settings, and Quit. Selecting a
+conversation reuses its existing pane and
+brings the window forward. Clear All dismisses the displayed notifications
+without answering pending questions or clearing newer arrivals. Linux and the
+browser keep the in-window notification bell.
+
+The search icon to the left of Harness Store opens a compact list across your
machines. Each harness shows its agent and name, followed by its machine, project,
branch, and last activity (`5m`, `1h`, `2d`). Search matches names, machines,
projects, branches, and pending questions. Filter All, Needs input, Running, or
Paused; sort by recently active, name, machine, or project.
-Needs input replaces the separate bell. A red count badge at the terminal icon’s
-top-right corner appears only when harnesses need input. An amber help action
+The Needs input filter remains available independently of read notifications. An amber help action
opens the waiting harness; its question appears on a third line in the Needs input
view. The same view opens with **⌘⇧I**. Questions update live and stale actions
cannot redirect you after a question is answered or replaced elsewhere.
diff --git a/desktop/design/images/notification-toolbar-dark.png b/desktop/design/images/notification-toolbar-dark.png
new file mode 100644
index 000000000..7da840c39
Binary files /dev/null and b/desktop/design/images/notification-toolbar-dark.png differ
diff --git a/desktop/design/images/notification-toolbar-light.png b/desktop/design/images/notification-toolbar-light.png
new file mode 100644
index 000000000..88be8070e
Binary files /dev/null and b/desktop/design/images/notification-toolbar-light.png differ
diff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.md
index 05356f4c2..e0bce261e 100644
--- a/desktop/design/terminal-workspace.md
+++ b/desktop/design/terminal-workspace.md
@@ -5,6 +5,9 @@ the panes. It replaces this document's former fixed-cell and text-only rules
for welcome pages, forms, dialogs, pickers, menus, and buttons. Historical
screenshots show prior iterations and are not a presentation specification.
+Use the [product terminology](../../docs/terminology.md): a tab groups harnesses;
+a harness is one running agent session.
+
## Preserve the terminal
Terminal output, direct keyboard input, the in-pane composer, and in-pane find
@@ -22,6 +25,10 @@ Tabs remain compact and content-sized, adding one at a time until the row fills.
Preserve Command-number navigation and established working/question/done/failure
marks. Idle does not need a mark. Motion represents actual work and respects
Reduce Motion. Keep the top global actions compact and the Store button familiar.
+Leave an 8-point control gap before Store. On macOS, notifications live in the
+system menu bar; the window keeps Search and Store. Linux and browser bars
+retain their notification bell. Show a count badge only when something is unread.
+Tooltips explain icon actions and resolve shortcuts from the live keymap.
The footer shows remaining subscription usage on the left. Its right-hand context follows the focused pane: machine, project, branch, and PR
at the right. Each pane header shows its model immediately before an always-visible
diff --git a/desktop/design/workspace-status-bar.md b/desktop/design/workspace-status-bar.md
index 10afb82db..b9bc37990 100644
--- a/desktop/design/workspace-status-bar.md
+++ b/desktop/design/workspace-status-bar.md
@@ -1,5 +1,8 @@
# Workspace status bar
+Use the [product terminology](../../docs/terminology.md): a tab groups harnesses;
+a harness is one running agent session.
+
A navigation row above the panes and a 37.5 pt status row below them. Tabs use
system type; status fields use the selected workspace monospace face.
Follow the [desktop design system](desktop-design-system.md) and
@@ -47,7 +50,7 @@ shortcut replaces the status beside the name without changing the tab width.
Hover never moves the title. Cmd-W, remapped shortcuts, native menu access,
and middle-click closing remain available.
Preserve reorder, rename, keyboard focus, and terminal sessions. Cmd-T opens a
-swarm. Cmd-O opens the shared picker with `#` for projects; Cmd-P opens it directly
+tab. Cmd-O opens the shared picker with `#` for projects; Cmd-P opens it directly
on harnesses. Cmd-Shift-P opens commands (`>`). The projects list has
no New Project/Open Folder row. Projects with an open pane in any tab come first;
each group is alphabetical. Pane focus and navigation history do not change that
@@ -93,7 +96,7 @@ explain each symbol.
| `\|\|` | Paused | Muted foreground |
| `⊘` | Offline | Muted foreground |
-A swarm shows its most urgent member in the order above, counting a harness and
+A tab shows its most urgent member in the order above, counting a harness and
its viewers once. For an individual harness, offline/paused/launch state takes
precedence; a current question takes precedence over working. A new turn masks
old results. Seeing a completion clears its unread check, but viewing a failed
@@ -175,7 +178,7 @@ A model update must repaint the label without reopening or retargeting the pane.
The observed subscription model does not select a Local row in the picker.
Zoom and Stop remain keyboard/menu actions. Cmd-Shift-W closes the focused pane
-view, Cmd-W closes the swarm, and Cmd-Enter toggles pane zoom. Closing a view
+view, Cmd-W closes the tab, and Cmd-Enter toggles pane zoom. Closing a view
keeps its harness running; Stop Harness remains a separate command with its
existing confirmation. Preserve explicit user keymap overrides.
@@ -206,7 +209,30 @@ follow a dependent viewer's owner.
## Notifications
-A small bell sits in the top row between the search icon and the Harness Store button. Reserve four bar cells on both native macOS and Flutter; counts
+On macOS, the Harness menu bar uses the team's portrait symbol,
+stored as vector paths and rendered as a monochrome template. A small circular
+count badge sits at the bottom-right corner when notifications are unread.
+At zero, only the portrait icon is shown, with no number or badge circle. The badge
+sits slightly outside the mark so both remain legible. The combined template
+adapts to the menu bar's light, dark, and selected appearances. It keeps a fixed size, showing `99+`
+above 99 with the exact count in its tooltip and accessibility
+value. Its native menu lists only harnesses with unread
+notifications, grouped by project, adding machine names when more than one
+machine is represented. Read sessions disappear; an empty inbox says “No unread
+notifications.” Blue dots mark unread rows. Long titles truncate with
+their full text and context in tooltips; unavailable rows are disabled. Rows
+stay in place while the menu is open. New Harness, Clear All Notifications,
+Open Harness, Settings, and Quit follow the conversations. The window's titlebar
+has search and Store without a duplicate bell.
+
+Clear All acknowledges only the notifications in the displayed snapshot. Newer
+results and replacement questions stay unread. Opening a conversation restores
+its existing pane before bringing the window forward. Reading a question clears
+its notification, while the question itself remains pending until answered.
+The menu uses AppKit's standard keyboard navigation and accessibility.
+
+On Linux and the web, a small bell sits in the top row between the search icon
+and the Harness Store button. Reserve four bar cells in Flutter; counts
never move the other controls. Put the count at the bell's upper-right corner,
hide it at zero, show `99+` above 99, and keep the exact count in accessibility text.
The bell has no background or button well, including on hover and keyboard
@@ -417,7 +443,9 @@ References: [Zsh prompt parameters](https://zsh.sourceforge.io/Doc/Release/Param
[Powerlevel10k](https://github.com/romkatv/powerlevel10k).
Pane headers keep task identity, model selection and an always-visible close action. The top bar
-contains tabs, New Tab, a plain search icon, the bell, and the Harness Store button.
+contains tabs, New Tab, a plain search icon, and the Harness Store button. Linux
+and browser bars also retain the notification bell. Leave an 8-point control gap
+before Store; macOS notifications live in the system menu bar.
Search opens the existing unified picker; Store opens the existing Store tab.
The Store restores its earlier rounded pill, colorful polymath mark, and quiet
tinted fill. Its label is `Harness Store`, without brackets. Keep the full name
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 1bcd69196..8ac0a9ef4 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -42,6 +42,7 @@ import '../shortcuts/keymap_native.dart';
import '../shortcuts/keymap_settings.dart';
import '../state/app_state.dart';
import '../state/notification_inbox.dart';
+import '../state/status_menu.dart';
import '../widgets/linux_menu_bar.dart'
show LinuxTitleBar, linuxTitleBarActions;
import '../widgets/notification_inbox.dart';
@@ -251,7 +252,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
SwarmProjectStore(storage: kUnderTest ? null : HarnessFileStore.shared);
StreamSubscription<SpokenTaskRequest>? _spokenTasks;
StreamSubscription<void>? _modelsRequests;
- final _shellFocus = FocusNode(debugLabel: 'Swarm shell');
+ final _shellFocus = FocusNode(debugLabel: 'Tab shell');
/// Where the keyboard waits after the active tab closes
/// ([AppNotifier.tabStripFocused]): the strip drawn here, or the native one
@@ -384,7 +385,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
app.resolveCommandBar(request, cancelToken: cancel),
)..addListener(_commandChanged);
final _canvasFocus = FocusNode(
- debugLabel: 'Swarm canvas',
+ debugLabel: 'Tab canvas',
canRequestFocus: false,
skipTraversal: true,
);
@@ -1189,7 +1190,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
int get _attention => _sessions.where((row) => row.needsInput).length;
- /// The bell and its list count the same current questions and unread results.
+ /// The notification surfaces count the same questions and unread results.
int get _unread => notificationInbox(app).length;
/// Whose window this is, or null while a signed-in window still waits for
@@ -1482,7 +1483,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
void _unreadChanged() {
if (!mounted) return;
setState(() {});
- // The native titlebar draws its own badge, and its state is pushed from
+ // The macOS menu bar draws its own count, and its state is pushed from
// `_syncNative` — which is subscribed to the APP, not to this notifier. A
// mark that only called setState redrew a tab strip the native window does
// not use, and the badge a person can actually see never moved.
@@ -1720,6 +1721,11 @@ class _SwarmScreenState extends State<SwarmScreen> {
terminal?.session?.engineId;
}
+ String _commandTooltip(String label, String command) => [
+ label,
+ if (widget.chrome?.showsKeyHints != false) ?_keymap.hint(command),
+ ].join(' · ');
+
void _syncNative() {
_syncMachines();
final focused = WorkspacePaneContext.focused(app);
@@ -1738,9 +1744,8 @@ class _SwarmScreenState extends State<SwarmScreen> {
'enabled': _routeIsCurrent && !_dialogOpen && !_spokenPaletteOpen,
'reduceMotion': _reduceMotion,
'activeId': app.activeSwarmId,
- 'searchTooltip':
- 'Search harnesses ${_keymap.hint('harnesses.list') ?? ''}',
- 'storeTooltip': 'Harness Store ${_keymap.hint('app.store') ?? ''}',
+ 'searchTooltip': _commandTooltip('Search harnesses', 'harnesses.list'),
+ 'storeTooltip': _commandTooltip('Explore Harness Store', 'app.store'),
// The selected tab is drawn with keyboard focus: ⏎ goes into it.
'tabsFocused': app.tabStripFocused && _tabStripFocus.hasPrimaryFocus,
// Only once the slot is shown: until then (and whenever daemons are
@@ -1862,7 +1867,8 @@ class _SwarmScreenState extends State<SwarmScreen> {
},
],
'attention': _attention,
- // The native bell uses the same inbox count as its Flutter counterpart.
+ if (_native) 'statusMenuEntries': statusMenuEntries(app),
+ // The fallback bell and the macOS menu use the same unread ledger.
'unread': _unread,
'sessionsOpen': _harnessesVisible,
'machinesOpen': _machinesVisible,
@@ -2370,6 +2376,12 @@ class _SwarmScreenState extends State<SwarmScreen> {
unawaited(_notifications());
case 'notificationInbox':
unawaited(_showNotificationInbox());
+ case 'openStatusHarness':
+ await _openStatusHarness(args);
+ case 'clearStatusNotifications':
+ if (args['receipts'] case final List receipts) {
+ clearStatusMenuNotifications(app, receipts);
+ }
case 'settings':
await _settings();
case 'addPhone':
@@ -2387,6 +2399,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
'commands',
'notifications',
'notificationInbox',
+ 'openStatusHarness',
'addAgent',
'newAgent',
'newTerminal',
@@ -5620,7 +5633,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
}
if (_newHarness case final box?) {
if (box.busy || box.checking) {
- box.warn('Check the pending creation before opening another swarm.');
+ box.warn('Check the pending creation before opening another tab.');
return false;
}
if (!box.requestDismiss()) return false;
@@ -5647,6 +5660,47 @@ class _SwarmScreenState extends State<SwarmScreen> {
_toggleSessions(filter: SessionFilter.needsInput);
}
+ Future<void> _openStatusHarness(Map receipt) async {
+ if (!statusMenuReceiptIsCurrent(app, receipt)) return;
+ final machineId = receipt['machineId'] as String;
+ final agentId = receipt['agentId'] as String;
+ final row = statusMenuEntries(app)
+ .where(
+ (row) => row['machineId'] == machineId && row['agentId'] == agentId,
+ )
+ .firstOrNull;
+ if (row == null || row['unavailable'] != null) return;
+ final destination = swarmDestinations(app)
+ .where((item) => item.machineId == machineId && item.agentId == agentId)
+ .firstOrNull;
+ if (destination == null || _newHarness?.requestDismiss() == false) return;
+ _closeNewHarness(restoreFocus: false);
+ _closeSearch(restoreFocus: false);
+ _closeCommandBar(restoreFocus: false);
+ _preparePaneFocus();
+ try {
+ final opened = await activateSwarmDestination(
+ app,
+ destination,
+ destinationSwarmId: app.activeSwarmId,
+ );
+ if (!mounted) return;
+ if (opened &&
+ receipt['unread'] == true &&
+ statusMenuReceiptIsCurrent(app, receipt)) {
+ app.readAgentNotification(
+ machineId,
+ agentId,
+ readToken: receipt['readToken'] as String?,
+ );
+ }
+ } on SwarmResumeFailure catch (failure) {
+ if (mounted) _showResumeFailure(failure, target: app.activeSwarmId);
+ } finally {
+ if (mounted) await revealWindow();
+ }
+ }
+
Future<void> _showNotificationInbox() => _dialog(() async {
await showNotificationInbox(
context,
@@ -6305,10 +6359,11 @@ class _SwarmScreenState extends State<SwarmScreen> {
children: [
_searchButton(theme),
_notificationsButton(theme),
+ const SizedBox(width: DesktopChrome.controlGap),
WorkspaceStoreButton(
key: const ValueKey('swarm-store-button'),
width: WorkspaceStoreButton.widthOf(context),
- tooltip: 'Harness Store ${_keymap.hint('app.store') ?? ''}',
+ tooltip: _commandTooltip('Explore Harness Store', 'app.store'),
onPressed: _shortcutsEnabled ? _openStore : null,
),
],
@@ -6961,7 +7016,9 @@ class _SwarmScreenState extends State<SwarmScreen> {
);
// Store, search and notifications — none of it here when the title bar
// holds them.
- final actionsWidth = _titleBarActions ? 0.0 : storeWidth + cell.width * 8;
+ final actionsWidth = _titleBarActions
+ ? 0.0
+ : storeWidth + cell.width * 8 + DesktopChrome.controlGap;
final leadingWidth = chrome?.leadingWidth(context) ?? 0.0;
final tabBudget = math.max(
0.0,
@@ -7124,16 +7181,20 @@ class _SwarmScreenState extends State<SwarmScreen> {
AppIcons.plus,
Size(cell.width * 3, toolHeight),
theme,
- tooltip: 'New Tab ${_keymap.hint('swarm.new') ?? ''}',
+ tooltip: _commandTooltip('New Tab', 'swarm.new'),
),
const Spacer(),
if (!_titleBarActions) ...[
_searchButton(theme),
_notificationsButton(theme),
+ const SizedBox(width: DesktopChrome.controlGap),
WorkspaceStoreButton(
key: const ValueKey('swarm-store-button'),
width: storeWidth,
- tooltip: 'Harness Store ${_keymap.hint('app.store') ?? ''}',
+ tooltip: _commandTooltip(
+ 'Explore Harness Store',
+ 'app.store',
+ ),
onPressed: _shortcutsEnabled ? _openStore : null,
),
],
@@ -7166,7 +7227,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
Widget _searchButton(TerminalTheme theme) => WorkspaceBarControl(
key: const ValueKey('swarm-search-button'),
label: 'Search harnesses',
- tooltip: 'Search harnesses ${_keymap.hint('harnesses.list') ?? ''}',
+ tooltip: _commandTooltip('Search harnesses', 'harnesses.list'),
onPressed: _shortcutsEnabled ? _toggleSessions : null,
builder: (context, emphasized) => SizedBox(
width: workspaceBarCellSizeOf(context).width * 4,
diff --git a/desktop/lib/settings/sections/experimental_section.dart b/desktop/lib/settings/sections/experimental_section.dart
index bce79b0f7..9aecdb0c8 100644
--- a/desktop/lib/settings/sections/experimental_section.dart
+++ b/desktop/lib/settings/sections/experimental_section.dart
@@ -133,12 +133,12 @@ class _SwarmCollaborationSetting extends StatelessWidget {
? 'Loading…'
: null;
return SettingRow(
- title: 'Swarm collaboration',
+ title: 'Tab collaboration',
detail:
- 'Let agents automatically consult only peers in the same swarm. '
+ 'Let agents automatically consult only peers in the same tab. '
'Off by default.',
control: Semantics(
- label: 'Swarm collaboration',
+ label: 'Tab collaboration',
child: Align(
alignment: Alignment.centerLeft,
child: Switch(
@@ -156,7 +156,7 @@ class _SwarmCollaborationSetting extends StatelessWidget {
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text(
- 'Use “Swarm conversation” in the command palette to inspect '
+ 'Use “Tab conversation” in the command palette to inspect '
'their questions and replies.',
),
if (status != null) ...[
diff --git a/desktop/lib/shortcuts/app_keymap.dart b/desktop/lib/shortcuts/app_keymap.dart
index fda2bf197..e5d0a0ca7 100644
--- a/desktop/lib/shortcuts/app_keymap.dart
+++ b/desktop/lib/shortcuts/app_keymap.dart
@@ -238,7 +238,7 @@ List<ShortcutRow> effectiveShortcutRows(
),
if (defaultDigits)
ShortcutRow(
- label: 'Select swarms 1–9',
+ label: 'Select tabs 1–9',
chords: [
[workspaceKeyLabel, '1 – 9'],
],
diff --git a/desktop/lib/shortcuts/app_shortcuts.dart b/desktop/lib/shortcuts/app_shortcuts.dart
index 94fbf3fe9..eb78207cd 100644
--- a/desktop/lib/shortcuts/app_shortcuts.dart
+++ b/desktop/lib/shortcuts/app_shortcuts.dart
@@ -232,7 +232,7 @@ const List<AppShortcut> kAppShortcuts = [
meta: true,
shift: true,
),
- label: 'Move this pane to another swarm',
+ label: 'Move this pane to another tab',
group: ShortcutGroup.panes,
),
@@ -544,7 +544,7 @@ const kSwarmShortcuts = [
meta: true,
shift: true,
),
- label: 'Next Swarm',
+ label: 'Next Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
@@ -554,13 +554,13 @@ const kSwarmShortcuts = [
meta: true,
shift: true,
),
- label: 'Previous Swarm',
+ label: 'Previous Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
action: ShortcutAction.nextSwarm,
activator: SingleActivator(LogicalKeyboardKey.tab, control: true),
- label: 'Next Swarm',
+ label: 'Next Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
@@ -570,7 +570,7 @@ const kSwarmShortcuts = [
control: true,
shift: true,
),
- label: 'Previous Swarm',
+ label: 'Previous Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
@@ -671,7 +671,7 @@ List<ShortcutRow> shortcutRows() {
// The digits are not in [kAppShortcuts] — nine near-identical rows would bury
// everything around them — so they join here, at the end of their group.
final digits = ShortcutRow(
- label: 'Select swarms 1–9',
+ label: 'Select tabs 1–9',
chords: [
[workspaceKeyLabel, '1 – $kTabDigitCount'],
],
diff --git a/desktop/lib/shortcuts/keyboard_practice.dart b/desktop/lib/shortcuts/keyboard_practice.dart
index b0394df80..366d80e2b 100644
--- a/desktop/lib/shortcuts/keyboard_practice.dart
+++ b/desktop/lib/shortcuts/keyboard_practice.dart
@@ -40,13 +40,13 @@ class KeyboardLesson {
String get result => switch (command) {
'swarm.new' => '[work] [new tab]\nFind a harness, or create one',
'agent.open' ||
- 'agent.add' => '[agent 1] │ [agent 2]\nBoth agents share this tab.',
+ 'agent.add' => '[harness 1] │ [harness 2]\nBoth harnesses share this tab.',
'agent.new' => 'Codex · This Mac · payments\nHarness anything (optional)\nNew harness is selected. Return starts with these settings; Tab reaches each control. Model, approvals, and Codex profile are below the message.',
- 'pane.zoom' => '[agent 2 — full workspace]\nPress the same key to restore the other panes.',
+ 'pane.zoom' => '[harness 2 — full workspace]\nPress the same key to restore the other panes.',
'pane.close' =>
'[harness 1]\nThe second view closes. Its harness keeps running.',
'swarm.close' =>
- '[previous swarm]\nThe view closes. Its harnesses keep running.',
+ '[previous tab]\nThe view closes. Its harnesses keep running.',
'navigation.commands' => '>rename\nRename Harness\nRename Tab',
'terminal.find' => 'find > timeout\n1/3 matches in this terminal’s output',
'picker.complete' => 'project ~/work/payments\nTab completes the current argument; Enter accepts it.',
diff --git a/desktop/lib/shortcuts/keymap_commands.dart b/desktop/lib/shortcuts/keymap_commands.dart
index bced3211d..22dab60ac 100644
--- a/desktop/lib/shortcuts/keymap_commands.dart
+++ b/desktop/lib/shortcuts/keymap_commands.dart
@@ -115,7 +115,7 @@ final harnessCommands = <HarnessCommand>[
// key of their own in keybindings.jsonc.
const HarnessCommand(
'swarm.reopen',
- 'Reopen closed swarm or pane',
+ 'Reopen closed tab or pane',
ShortcutGroup.navigate,
action: ShortcutAction.reopenClosedSwarm,
nativeAction: 'reopen',
@@ -123,7 +123,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'swarm.next',
- 'Next Swarm',
+ 'Next Tab',
ShortcutGroup.navigate,
action: ShortcutAction.nextSwarm,
nativeAction: 'next',
@@ -132,7 +132,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'swarm.previous',
- 'Previous Swarm',
+ 'Previous Tab',
ShortcutGroup.navigate,
action: ShortcutAction.previousSwarm,
nativeAction: 'previous',
@@ -180,7 +180,7 @@ final harnessCommands = <HarnessCommand>[
for (var i = 1; i <= 9; i++)
HarnessCommand(
'swarm.select_$i',
- 'Select swarm $i',
+ 'Select tab $i',
ShortcutGroup.navigate,
keywords: const ['tab'],
extraKeys: ['cmd+$i'],
@@ -245,7 +245,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'pane.move_to_tab',
- 'Move the pane to another swarm',
+ 'Move the pane to another tab',
ShortcutGroup.panes,
action: ShortcutAction.movePaneToTab,
nativeAction: 'movePaneToTab',
@@ -484,7 +484,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'team.open',
- 'Swarm conversation: view this swarm’s collaboration',
+ 'Tab conversation: view this tab’s collaboration',
ShortcutGroup.actions,
action: ShortcutAction.team,
keywords: [
@@ -494,6 +494,7 @@ final harnessCommands = <HarnessCommand>[
'question',
'reply',
'inbox',
+ 'tab',
'swarm',
'channel',
],
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index 611b8e1eb..c5693b6d0 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -1083,7 +1083,7 @@ class AppNotifier extends ChangeNotifier {
final gateway = channelGateway(localMachineState?.machine.machineId);
if (gateway == null) {
throw const TeamRequestError(
- 'Connect one of your machines to configure swarm collaboration.',
+ 'Connect one of your machines to configure tab collaboration.',
);
}
return teamRequest(gateway, payload);
@@ -1120,7 +1120,7 @@ class AppNotifier extends ChangeNotifier {
channelGateway(gatewayMachineId);
if (machineId == null) {
throw const TeamRequestError(
- 'Connect one of your machines to use swarm collaboration.',
+ 'Connect one of your machines to use tab collaboration.',
);
}
return teamRequest(machineId, payload);
@@ -8532,12 +8532,12 @@ class AppNotifier extends ChangeNotifier {
return 'The layout changed. Close this dialog and split the pane again.';
}
final target = swarms.where((s) => s.id == targetId).firstOrNull;
- if (target == null) return 'This swarm was closed';
+ if (target == null) return 'This tab was closed';
if (placement != null && (target.isUtility || target.isOrchestrator)) {
- return 'Open a new swarm to add a harness.';
+ return 'Open a new tab to add a harness.';
}
if (target.panes.length >= maxPanes) {
- return 'This swarm is full. Open a new swarm to start a harness.';
+ return 'This tab is full. Open a new tab to start a harness.';
}
return null;
}
@@ -8902,7 +8902,7 @@ class AppNotifier extends ChangeNotifier {
if (_creationPlacementError(targetId, split, placement: placement) !=
null) {
_lastError =
- 'The harness started, but its original swarm or layout changed. '
+ 'The harness started, but its original tab or layout changed. '
'Use New Pane to find it.';
_lastErrorRetryable = false;
notifyListeners();
@@ -10070,10 +10070,10 @@ class AppNotifier extends ChangeNotifier {
String? notice;
if (target == null || !swarms.contains(target)) {
notice =
- 'Fork created. Its original swarm closed; use New Pane to open it.';
+ 'Fork created. Its original tab closed; use New Pane to open it.';
} else if (target.panes.length >= maxPanes && !keepFocus) {
notice =
- 'Fork created. Its original swarm is full; use New Tab to open it.';
+ 'Fork created. Its original tab is full; use New Tab to open it.';
} else {
if (target.panes.length >= maxPanes) {
newSwarm(name: fork.name);
@@ -10801,7 +10801,7 @@ class AppNotifier extends ChangeNotifier {
existing == null &&
targetPanes.length >= maxPanes) {
_lastError =
- 'This swarm holds $maxPanes harnesses. Open another swarm to add more.';
+ 'This tab holds $maxPanes harnesses. Open another tab to add more.';
_lastErrorRetryable = false;
notifyListeners();
return;
@@ -11394,7 +11394,7 @@ class AppNotifier extends ChangeNotifier {
.firstOrNull;
if (twin == null && target.panes.length >= maxPanes) {
_lastError =
- 'That swarm holds $maxPanes harnesses. Close one there to move this in.';
+ 'That tab holds $maxPanes harnesses. Close one there to move this in.';
_lastErrorRetryable = false;
notifyListeners();
return false;
diff --git a/desktop/lib/state/command_bar_catalog.dart b/desktop/lib/state/command_bar_catalog.dart
index dfdbf8615..1427c371d 100644
--- a/desktop/lib/state/command_bar_catalog.dart
+++ b/desktop/lib/state/command_bar_catalog.dart
@@ -8,16 +8,16 @@ import '../widgets/engine_identity.dart' show isTerminalEngine;
const commandBarCommands = {
'navigation.needs_input':
'Find live questions and harnesses waiting for your input.',
- 'navigation.history': 'Return to previously opened harnesses and swarms.',
+ 'navigation.history': 'Return to previously opened harnesses and tabs.',
'app.settings':
'Change preferences, appearance, account or connection settings.',
'machines.manage': 'Open Machine Monitor, the harness that links, names and retires your computers.',
'machines.list': 'See connected computers and their link state.',
'machine.link': 'Open the setup dialog to connect another computer.',
- 'swarm.new': 'Choose an existing harness or create one in a new swarm.',
- 'swarm.reopen': 'Reopen the most recently closed swarm or pane.',
+ 'swarm.new': 'Choose an existing harness or create one in a new tab.',
+ 'swarm.reopen': 'Reopen the most recently closed tab or pane.',
'agent.add':
- 'Choose an existing harness or create one in a new pane in this swarm.',
+ 'Choose an existing harness or create one in a new pane in this tab.',
'project.add': 'Choose a project folder to add to the workspace.',
'pane.layout': 'Open the workspace layout chooser.',
'pane.zoom': 'Toggle the focused pane between full size and the grid.',
@@ -57,6 +57,8 @@ const _commandPhrases = {
'open a fresh tab',
],
'swarm.reopen': [
+ 'reopen last tab',
+ 'reopen the last tab',
'reopen last swarm',
'reopen the last swarm',
'reopen last harness',
@@ -317,7 +319,7 @@ List<CommandBarAction> buildCommandBarCatalog(
destinationSwarmId: app.activeSwarmId,
)
? null
- : 'That swarm is no longer available.',
+ : 'That tab is no longer available.',
),
);
}
diff --git a/desktop/lib/state/harness_placement.dart b/desktop/lib/state/harness_placement.dart
index 71cf121a3..76b73fe97 100644
--- a/desktop/lib/state/harness_placement.dart
+++ b/desktop/lib/state/harness_placement.dart
@@ -6,7 +6,7 @@ enum HarnessPlacement {
String get title => this == newTab ? 'New Tab' : 'New Pane';
String get action =>
- this == newTab ? 'Open in new swarm' : 'Add to this swarm';
+ this == newTab ? 'Open in new tab' : 'Add to this tab';
String get createAction =>
- this == newTab ? 'Create in new swarm' : 'Create in this swarm';
+ this == newTab ? 'Create in new tab' : 'Create in this tab';
}
diff --git a/desktop/lib/state/status_menu.dart b/desktop/lib/state/status_menu.dart
new file mode 100644
index 000000000..b71ad77ea
--- /dev/null
+++ b/desktop/lib/state/status_menu.dart
@@ -0,0 +1,54 @@
+import 'app_state.dart';
+import 'notification_inbox.dart';
+
+/// The macOS menu lists only harnesses with an unread notification.
+/// Receipts travel with each row so a menu left open cannot clear newer news.
+List<Map<String, Object?>> statusMenuEntries(AppNotifier app) => [
+ for (final notification in notificationInbox(app)) _entry(app, notification),
+];
+
+Map<String, Object?> _entry(AppNotifier app, InboxNotification notification) {
+ final machineId = notification.machineId;
+ final agentId = notification.agentId;
+ final machine = app.stateOf(machineId);
+ final agent = machine?.agents.where((a) => a.id == agentId).firstOrNull;
+ final project = agent == null ? null : machine?.projectOf(agent);
+ return {
+ 'machineId': machineId,
+ 'agentId': agentId,
+ 'title': notification.title,
+ 'machineName': machine?.machine.displayName ?? 'Unavailable machine',
+ 'project': project?.label ?? 'No Project',
+ 'detail': notification.detail,
+ 'unavailable': notification.unavailable,
+ 'unread': true,
+ 'label': notification.label,
+ 'readToken': app.agentUnread.readTokenFor(machineId, agentId),
+ 'questionId': app.questionFor(machineId, agentId)?.requestId,
+ };
+}
+
+bool statusMenuReceiptIsCurrent(AppNotifier app, Map receipt) {
+ final machineId = receipt['machineId'], agentId = receipt['agentId'];
+ return machineId is String &&
+ agentId is String &&
+ receipt['readToken'] ==
+ app.agentUnread.readTokenFor(machineId, agentId) &&
+ receipt['questionId'] == app.questionFor(machineId, agentId)?.requestId;
+}
+
+/// Dismiss the exact notifications displayed when Clear All was selected.
+/// A pending question remains pending; a newer notification remains unread.
+void clearStatusMenuNotifications(AppNotifier app, List receipts) {
+ for (final receipt in receipts.whereType<Map>()) {
+ if (receipt['unread'] != true ||
+ !statusMenuReceiptIsCurrent(app, receipt)) {
+ continue;
+ }
+ app.readAgentNotification(
+ receipt['machineId'] as String,
+ receipt['agentId'] as String,
+ readToken: receipt['readToken'] as String?,
+ );
+ }
+}
diff --git a/desktop/lib/state/swarm.dart b/desktop/lib/state/swarm.dart
index dab4b15a7..2e787a9f7 100644
--- a/desktop/lib/state/swarm.dart
+++ b/desktop/lib/state/swarm.dart
@@ -47,12 +47,13 @@ class Swarm {
static const defaultName = 'New Tab';
// 'New Harness' was the default until 2026-09-15, 'New Agent' for a day
// after, and 'Untitled Tab' until 2026-09-24; a layout saved then still
- // carries one, and it must read as the same fresh swarm. Explicit custom
+ // carries one, as do builds that called tabs swarms. They all display the
+ // current placeholder. Explicit custom
// names bypass this normalization in the constructor.
static String normalizeName(String name) =>
const {
- 'New swarm',
'New Swarm',
+ 'New swarm',
'New tab',
'New Tab',
'New Harness',
diff --git a/desktop/lib/state/swarm_navigation.dart b/desktop/lib/state/swarm_navigation.dart
index 944d3be65..0cc336208 100644
--- a/desktop/lib/state/swarm_navigation.dart
+++ b/desktop/lib/state/swarm_navigation.dart
@@ -1312,7 +1312,7 @@ List<SwarmDestination> swarmDestinations(
detail: [
// Project and machine rows name their kind; a tab beside them
// without one read as some fourth, unnamed thing.
- if (!swarm.isStore) 'Swarm',
+ if (!swarm.isStore) 'Tab',
_countLabel(members.length, 'harness'),
if (projects.isNotEmpty) _countLabel(projects.length, 'project'),
if (machines.isNotEmpty) _countLabel(machines.length, 'machine'),
diff --git a/desktop/lib/state/swarm_search.dart b/desktop/lib/state/swarm_search.dart
index 69cbaa562..85dfde91f 100644
--- a/desktop/lib/state/swarm_search.dart
+++ b/desktop/lib/state/swarm_search.dart
@@ -2162,7 +2162,7 @@ class SwarmSearchController extends ChangeNotifier {
: row.closedId != null
? 'Reopen'
: row.isSwarm && !row.isStore && row.members.length != 1
- ? 'Go to Swarm'
+ ? 'Go to Tab'
: 'Open Harness';
@override
diff --git a/desktop/lib/teams/swarm_settings_controller.dart b/desktop/lib/teams/swarm_settings_controller.dart
index 4ba8a3b84..5b38b60a6 100644
--- a/desktop/lib/teams/swarm_settings_controller.dart
+++ b/desktop/lib/teams/swarm_settings_controller.dart
@@ -26,7 +26,7 @@ class SwarmSettingsController extends ChangeNotifier {
}
if (result['enabled'] is! bool || result['revision'] is! num) {
throw const TeamRequestError(
- 'Update Harness to configure swarm collaboration.',
+ 'Update Harness to configure tab collaboration.',
);
}
return result;
diff --git a/desktop/lib/teams/team_controller.dart b/desktop/lib/teams/team_controller.dart
index f4577a91e..515d27c94 100644
--- a/desktop/lib/teams/team_controller.dart
+++ b/desktop/lib/teams/team_controller.dart
@@ -206,7 +206,7 @@ class TeamController extends ChangeNotifier {
}
Future<String> _consult(String machineId, String agentId, String key) async {
- if (channelTabId == null) return 'Choose a swarm first.';
+ if (channelTabId == null) return 'Choose a tab first.';
final attempt = _consultAttempts.putIfAbsent(
key,
() => {
@@ -218,12 +218,12 @@ class TeamController extends ChangeNotifier {
);
try {
final result = await _call(attempt);
- if (_disposed) return 'Swarm instruction sent.';
+ if (_disposed) return 'Tab instruction sent.';
_consultAttempts.remove(key);
error = null;
final receipt = (result['consultation'] as Map?)?['receipt'] as Map?;
_notify();
- return 'Consult swarm · ${teamDeliveryLabel(receipt?.cast<String, dynamic>())}';
+ return 'Consult tab · ${teamDeliveryLabel(receipt?.cast<String, dynamic>())}';
} catch (e) {
if (e is TeamRequestError && !e.uncertain) _consultAttempts.remove(key);
final message =
diff --git a/desktop/lib/teams/team_workspace.dart b/desktop/lib/teams/team_workspace.dart
index e031a8820..45b55546c 100644
--- a/desktop/lib/teams/team_workspace.dart
+++ b/desktop/lib/teams/team_workspace.dart
@@ -547,7 +547,7 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
controller: _rosterScroll,
children: [
Text(
- model.isChannel ? 'Agents in this swarm' : 'Teammates',
+ model.isChannel ? 'Agents in this tab' : 'Teammates',
style: DesktopChrome.control(medium: true),
),
_gap(.5),
@@ -947,14 +947,11 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
- 'Agents consult relevant peers in this swarm and continue their work.',
+ 'Agents consult relevant peers in this tab and continue their work.',
style: style,
),
_gap(),
- Text(
- 'This tab is your swarm. Add another agent pane to include it.',
- style: faint,
- ),
+ Text('Add another agent pane to include it in this tab.', style: faint),
for (final instruction in teamRows(
model.team?['consultations'],
).reversed.take(5)) ...[
@@ -1025,7 +1022,7 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
children: [
if (model.selectedId != null && !_creating) ...[
Text(
- '${model.isChannel ? 'Swarm conversation · ' : ''}${model.members.where((m) => m['enabled'] != false).length} agents · ${model.isChannel ? 'This tab only · ' : ''}${model.team?['state'] ?? 'Connecting'}',
+ '${model.isChannel ? 'Tab conversation · ' : ''}${model.members.where((m) => m['enabled'] != false).length} agents · ${model.isChannel ? 'This tab only · ' : ''}${model.team?['state'] ?? 'Connecting'}',
style: faint,
),
_gap(.5),
@@ -1105,7 +1102,7 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
_loadingRows()
else
_action(
- model.isChannel ? 'Retry reading swarm' : 'Retry reading team',
+ model.isChannel ? 'Retry reading tab' : 'Retry reading team',
() => unawaited(model.refresh()),
),
],
@@ -1127,7 +1124,7 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
children: [
_summary(),
Text(
- model.isChannel ? 'Agents in this swarm' : 'Teammates',
+ model.isChannel ? 'Agents in this tab' : 'Teammates',
style: DesktopChrome.control(medium: true),
),
_gap(.5),
@@ -1210,9 +1207,9 @@ class _TeamWorkspaceState extends State<TeamWorkspace> {
final title = _creating
? 'Connect a team'
: model.team?['name'] as String? ??
- (model.isChannel ? 'Swarm conversation' : 'Team');
+ (model.isChannel ? 'Tab conversation' : 'Team');
final hint =
- '${terminalPromptHint(context, 'picker.complete', 'Tab')} move · ${terminalPromptHint(context, 'picker.cancel', 'Esc')} close · conversations stay with the ${model.isChannel ? 'swarm' : 'team'}';
+ '${terminalPromptHint(context, 'picker.complete', 'Tab')} move · ${terminalPromptHint(context, 'picker.cancel', 'Esc')} close · conversations stay with the ${model.isChannel ? 'tab' : 'team'}';
return TerminalPromptKeys(
cancel: widget.onClose,
refresh: () => unawaited(model.refresh()),
diff --git a/desktop/lib/widgets/daemon_slot.dart b/desktop/lib/widgets/daemon_slot.dart
index 018515b54..1711f6bcd 100644
--- a/desktop/lib/widgets/daemon_slot.dart
+++ b/desktop/lib/widgets/daemon_slot.dart
@@ -805,6 +805,8 @@ class _DaemonDetailNoticeState extends State<DaemonDetailNotice> {
WorkspaceBarControl(
key: const ValueKey('daemon-detail-toggle'),
label: _open ? 'Hide the detail' : 'Show the detail',
+ tooltip:
+ '${_open ? 'Hide' : 'Show'} details · ${widget.title}',
onPressed: () => setState(() => _open = !_open),
builder: (context, emphasized) => SizedBox(
height: workspaceBarControlHeight(context),
diff --git a/desktop/lib/widgets/grid_model_picker.dart b/desktop/lib/widgets/grid_model_picker.dart
index cb67fa5c7..a93e16bb6 100644
--- a/desktop/lib/widgets/grid_model_picker.dart
+++ b/desktop/lib/widgets/grid_model_picker.dart
@@ -597,7 +597,7 @@ class _GridModelPickerState extends State<GridModelPicker> {
if (widget.enabled) 'Switch model · Subscription or local models',
?sentence,
].join('\n'),
- waitDuration: const Duration(milliseconds: 700),
+ waitDuration: const Duration(milliseconds: 500),
child: MouseRegion(
// Stated rather than inherited. The pane header sits over a terminal, and the cursor a
// person sees while hovering this was whatever the surface underneath asked for — so a
diff --git a/desktop/lib/widgets/harness_session_manager.dart b/desktop/lib/widgets/harness_session_manager.dart
index 3ff8afd45..023d1ce0e 100644
--- a/desktop/lib/widgets/harness_session_manager.dart
+++ b/desktop/lib/widgets/harness_session_manager.dart
@@ -870,9 +870,10 @@ class _SessionRow extends StatelessWidget {
key: ValueKey(
'session-unread-${unread!.name}:${row.id}',
),
- tooltip: unread == AlertKind.failed
- ? 'Failed'
- : 'Finished',
+ tooltip: [
+ if (canOpen) 'Open harness',
+ unread == AlertKind.failed ? 'Failed' : 'Finished',
+ ].join(' · '),
onPressed: canOpen ? onOpen : null,
style: actionStyle(
statusInk(
diff --git a/desktop/lib/widgets/new_harness_help.dart b/desktop/lib/widgets/new_harness_help.dart
index c7a04da7a..915aeea77 100644
--- a/desktop/lib/widgets/new_harness_help.dart
+++ b/desktop/lib/widgets/new_harness_help.dart
@@ -102,7 +102,7 @@ class _HarnessHelpDialogState extends State<_HarnessHelpDialog> {
'What would you like to make?',
'Choose an agent such as Codex or Claude Code, or a specialized harness '
'with tools for your craft. Starting either creates a harness '
- 'with its own conversation. Group harnesses in a swarm.',
+ 'with its own conversation. Group harnesses in a tab.',
),
HarnessHelpTopic.machine => (
'Where would you like to work?',
diff --git a/desktop/lib/widgets/pane_grid.dart b/desktop/lib/widgets/pane_grid.dart
index ffa1a6b3b..05e1e1ffe 100644
--- a/desktop/lib/widgets/pane_grid.dart
+++ b/desktop/lib/widgets/pane_grid.dart
@@ -268,7 +268,7 @@ class _SwarmCanvasState extends State<_SwarmCanvas> {
final _offsets = <String, Offset>{};
final _inputLayers = <int, GlobalKey<_PaneLayerState>>{};
final _idleFocus = FocusNode(
- debugLabel: 'Swarm navigation',
+ debugLabel: 'Tab navigation',
skipTraversal: true,
);
late Object _lastInputDestination;
diff --git a/desktop/lib/widgets/pane_resize_handle.dart b/desktop/lib/widgets/pane_resize_handle.dart
index e65bb1913..f48426b35 100644
--- a/desktop/lib/widgets/pane_resize_handle.dart
+++ b/desktop/lib/widgets/pane_resize_handle.dart
@@ -128,94 +128,97 @@ class _PaneResizeHandleState extends State<PaneResizeHandle> {
}
@override
- Widget build(BuildContext context) => Semantics(
- label: _horizontal ? 'Resize pane columns' : 'Resize pane rows',
- value: _value(widget.arrangement),
- increasedValue: _value(_resized(.02)),
- decreasedValue: _value(_resized(-.02)),
- hint:
- 'Arrow keys resize. Double-click balances. Escape returns to the pane.',
- slider: true,
- onIncrease: () => _step(.02),
- onDecrease: () => _step(-.02),
- child: Focus(
- focusNode: _focus,
- onFocusChange: (value) => setState(() => _focused = value),
- onKeyEvent: (_, event) {
- if (event is! KeyDownEvent && event is! KeyRepeatEvent) {
- return KeyEventResult.ignored;
- }
- final keyboard = HardwareKeyboard.instance;
- if (keyboard.isMetaPressed ||
- keyboard.isControlPressed ||
- keyboard.isAltPressed) {
- return KeyEventResult.ignored;
- }
- if (event.logicalKey == LogicalKeyboardKey.escape) {
- _cancel();
- widget.onLeave();
+ Widget build(BuildContext context) => Tooltip(
+ message: 'Drag to resize panes · Double-click to balance',
+ excludeFromSemantics: true,
+ child: Semantics(
+ label: _horizontal ? 'Resize pane columns' : 'Resize pane rows',
+ value: _value(widget.arrangement),
+ increasedValue: _value(_resized(.02)),
+ decreasedValue: _value(_resized(-.02)),
+ hint: 'Arrow keys resize. Double-click balances. Escape returns to the pane.',
+ slider: true,
+ onIncrease: () => _step(.02),
+ onDecrease: () => _step(-.02),
+ child: Focus(
+ focusNode: _focus,
+ onFocusChange: (value) => setState(() => _focused = value),
+ onKeyEvent: (_, event) {
+ if (event is! KeyDownEvent && event is! KeyRepeatEvent) {
+ return KeyEventResult.ignored;
+ }
+ final keyboard = HardwareKeyboard.instance;
+ if (keyboard.isMetaPressed ||
+ keyboard.isControlPressed ||
+ keyboard.isAltPressed) {
+ return KeyEventResult.ignored;
+ }
+ if (event.logicalKey == LogicalKeyboardKey.escape) {
+ _cancel();
+ widget.onLeave();
+ return KeyEventResult.handled;
+ }
+ final decrease = _horizontal
+ ? LogicalKeyboardKey.arrowLeft
+ : LogicalKeyboardKey.arrowUp;
+ final increase = _horizontal
+ ? LogicalKeyboardKey.arrowRight
+ : LogicalKeyboardKey.arrowDown;
+ if (event.logicalKey != decrease && event.logicalKey != increase) {
+ return KeyEventResult.ignored;
+ }
+ _step(
+ (event.logicalKey == decrease ? -1 : 1) *
+ (keyboard.isShiftPressed ? .1 : .02),
+ );
return KeyEventResult.handled;
- }
- final decrease = _horizontal
- ? LogicalKeyboardKey.arrowLeft
- : LogicalKeyboardKey.arrowUp;
- final increase = _horizontal
- ? LogicalKeyboardKey.arrowRight
- : LogicalKeyboardKey.arrowDown;
- if (event.logicalKey != decrease && event.logicalKey != increase) {
- return KeyEventResult.ignored;
- }
- _step(
- (event.logicalKey == decrease ? -1 : 1) *
- (keyboard.isShiftPressed ? .1 : .02),
- );
- return KeyEventResult.handled;
- },
- child: MouseRegion(
- cursor: _horizontal
- ? SystemMouseCursors.resizeColumn
- : SystemMouseCursors.resizeRow,
- onEnter: (_) => setState(() => _hover = true),
- onExit: (_) => setState(() => _hover = false),
- child: GestureDetector(
- behavior: HitTestBehavior.opaque,
- dragStartBehavior: DragStartBehavior.down,
- onDoubleTap: _balance,
- onHorizontalDragStart: _horizontal ? _begin : null,
- onHorizontalDragUpdate: _horizontal ? _drag : null,
- onHorizontalDragEnd: _horizontal ? _end : null,
- onHorizontalDragCancel: _horizontal ? _cancel : null,
- onVerticalDragStart: _horizontal ? null : _begin,
- onVerticalDragUpdate: _horizontal ? null : _drag,
- onVerticalDragEnd: _horizontal ? null : _end,
- onVerticalDragCancel: _horizontal ? null : _cancel,
- child: Stack(
- alignment: Alignment.center,
- children: [
- if (_hover || _focused || _start != null)
- Center(
- child: Container(
- width: _horizontal ? 1 : double.infinity,
- height: _horizontal ? double.infinity : 1,
- color: grid.AppPalette.swarmAccent.withValues(alpha: .35),
+ },
+ child: MouseRegion(
+ cursor: _horizontal
+ ? SystemMouseCursors.resizeColumn
+ : SystemMouseCursors.resizeRow,
+ onEnter: (_) => setState(() => _hover = true),
+ onExit: (_) => setState(() => _hover = false),
+ child: GestureDetector(
+ behavior: HitTestBehavior.opaque,
+ dragStartBehavior: DragStartBehavior.down,
+ onDoubleTap: _balance,
+ onHorizontalDragStart: _horizontal ? _begin : null,
+ onHorizontalDragUpdate: _horizontal ? _drag : null,
+ onHorizontalDragEnd: _horizontal ? _end : null,
+ onHorizontalDragCancel: _horizontal ? _cancel : null,
+ onVerticalDragStart: _horizontal ? null : _begin,
+ onVerticalDragUpdate: _horizontal ? null : _drag,
+ onVerticalDragEnd: _horizontal ? null : _end,
+ onVerticalDragCancel: _horizontal ? null : _cancel,
+ child: Stack(
+ alignment: Alignment.center,
+ children: [
+ if (_hover || _focused || _start != null)
+ Center(
+ child: Container(
+ width: _horizontal ? 1 : double.infinity,
+ height: _horizontal ? double.infinity : 1,
+ color: grid.AppPalette.swarmAccent.withValues(alpha: .35),
+ ),
),
- ),
- Center(
- child: AnimatedContainer(
- duration: MediaQuery.disableAnimationsOf(context)
- ? Duration.zero
- : grid.AppMotion.hover,
- width: _horizontal ? 3 : 36,
- height: _horizontal ? 36 : 3,
- decoration: BoxDecoration(
- borderRadius: BorderRadius.circular(2),
- color: _hover || _focused || _start != null
- ? grid.AppPalette.swarmAccent
- : Colors.transparent,
+ Center(
+ child: AnimatedContainer(
+ duration: MediaQuery.disableAnimationsOf(context)
+ ? Duration.zero
+ : grid.AppMotion.hover,
+ width: _horizontal ? 3 : 36,
+ height: _horizontal ? 36 : 3,
+ decoration: BoxDecoration(
+ borderRadius: BorderRadius.circular(2),
+ color: _hover || _focused || _start != null
+ ? grid.AppPalette.swarmAccent
+ : Colors.transparent,
+ ),
),
),
- ),
- ],
+ ],
+ ),
),
),
),
diff --git a/desktop/lib/widgets/swarm_dialogs.dart b/desktop/lib/widgets/swarm_dialogs.dart
index 8af2ebc55..624e17d7a 100644
--- a/desktop/lib/widgets/swarm_dialogs.dart
+++ b/desktop/lib/widgets/swarm_dialogs.dart
@@ -31,7 +31,7 @@ Future<String?> showSwarmRenameDialog(
title: 'Rename Tab',
name: name,
fieldKey: const Key('tab-rename-input'),
- fieldLabel: 'Swarm name',
+ fieldLabel: 'Tab name',
maxLength: 80,
),
);
diff --git a/desktop/lib/widgets/terminal_panel.dart b/desktop/lib/widgets/terminal_panel.dart
index dbb47dcc5..ac8486783 100644
--- a/desktop/lib/widgets/terminal_panel.dart
+++ b/desktop/lib/widgets/terminal_panel.dart
@@ -2789,7 +2789,7 @@ class _TerminalHeader extends StatelessWidget {
Flexible(
child: Tooltip(
message: identityDetail,
- waitDuration: const Duration(milliseconds: 700),
+ waitDuration: const Duration(milliseconds: 500),
child: GestureDetector(
behavior: HitTestBehavior.opaque,
onDoubleTap: () => unawaited(
@@ -2915,12 +2915,15 @@ class _TerminalHeader extends StatelessWidget {
else if (!compact)
Padding(
padding: const EdgeInsets.all(4),
- child: Container(
- width: 8,
- height: 8,
- decoration: BoxDecoration(
- shape: BoxShape.circle,
- color: color,
+ child: Tooltip(
+ message: 'Terminal connected',
+ child: Container(
+ width: 8,
+ height: 8,
+ decoration: BoxDecoration(
+ shape: BoxShape.circle,
+ color: color,
+ ),
),
),
),
diff --git a/desktop/lib/widgets/web_pane_panel.dart b/desktop/lib/widgets/web_pane_panel.dart
index 2fbe6c6ed..245064d6b 100644
--- a/desktop/lib/widgets/web_pane_panel.dart
+++ b/desktop/lib/widgets/web_pane_panel.dart
@@ -287,7 +287,7 @@ class _WebPanePanelState extends State<WebPanePanel> {
Expanded(
child: Tooltip(
message: [widget.ownerName, ?widget.pane.url].join('\n'),
- waitDuration: const Duration(milliseconds: 700),
+ waitDuration: const Duration(milliseconds: 500),
child: Row(
children: [
Flexible(
diff --git a/desktop/lib/widgets/workspace_bar_control.dart b/desktop/lib/widgets/workspace_bar_control.dart
index 235fe72aa..2885ced48 100644
--- a/desktop/lib/widgets/workspace_bar_control.dart
+++ b/desktop/lib/widgets/workspace_bar_control.dart
@@ -92,7 +92,7 @@ class _WorkspaceBarControlState extends State<WorkspaceBarControl> {
: Tooltip(
message: hint,
excludeFromSemantics: true,
- waitDuration: const Duration(milliseconds: 700),
+ waitDuration: const Duration(milliseconds: 500),
child: control,
);
}
diff --git a/desktop/lib/widgets/workspace_quick_start.dart b/desktop/lib/widgets/workspace_quick_start.dart
index 4ab2b23b6..92123fbdd 100644
--- a/desktop/lib/widgets/workspace_quick_start.dart
+++ b/desktop/lib/widgets/workspace_quick_start.dart
@@ -25,7 +25,7 @@ class WorkspaceQuickStart extends StatelessWidget {
WorkspaceLesson.agent => ('swarm.new', 'Open your first harness'),
WorkspaceLesson.pane => (
'agent.open',
- 'Add a second harness to this swarm',
+ 'Add a second harness to this tab',
),
WorkspaceLesson.zoom => ('pane.zoom', 'Zoom the focused pane'),
WorkspaceLesson.commands => (
diff --git a/desktop/macos/Runner.xcodeproj/project.pbxproj b/desktop/macos/Runner.xcodeproj/project.pbxproj
index 476420bb7..c9d953ca1 100644
--- a/desktop/macos/Runner.xcodeproj/project.pbxproj
+++ b/desktop/macos/Runner.xcodeproj/project.pbxproj
@@ -24,6 +24,7 @@
B20100000000000000000001 /* SwarmTitlebar.swift in Sources */ = {isa = PBXBuildFile; fileRef = B20100000000000000000002 /* SwarmTitlebar.swift */; };
B20100000000000000000003 /* HarnessKeymap.swift in Sources */ = {isa = PBXBuildFile; fileRef = B20100000000000000000004 /* HarnessKeymap.swift */; };
B20100000000000000000A01 /* HarnessNotifications.swift in Sources */ = {isa = PBXBuildFile; fileRef = B20100000000000000000A02 /* HarnessNotifications.swift */; };
+ B20100000000000000000B01 /* HarnessStatusMenu.swift in Sources */ = {isa = PBXBuildFile; fileRef = B20100000000000000000B02 /* HarnessStatusMenu.swift */; };
331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C80D7294CF71000263BE5 /* RunnerTests.swift */; };
335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */ = {isa = PBXBuildFile; fileRef = 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */; };
33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC10F02044A3C60003C045 /* AppDelegate.swift */; };
@@ -68,6 +69,7 @@
B20100000000000000000002 /* SwarmTitlebar.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SwarmTitlebar.swift; sourceTree = "<group>"; };
B20100000000000000000004 /* HarnessKeymap.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HarnessKeymap.swift; sourceTree = "<group>"; };
B20100000000000000000A02 /* HarnessNotifications.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HarnessNotifications.swift; sourceTree = "<group>"; };
+ B20100000000000000000B02 /* HarnessStatusMenu.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HarnessStatusMenu.swift; sourceTree = "<group>"; };
331C80D5294CF71000263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
331C80D7294CF71000263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = "<group>"; };
333000ED22D3DE5D00554162 /* Warnings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Warnings.xcconfig; sourceTree = "<group>"; };
@@ -180,6 +182,7 @@
B20100000000000000000002 /* SwarmTitlebar.swift */,
B20100000000000000000004 /* HarnessKeymap.swift */,
B20100000000000000000A02 /* HarnessNotifications.swift */,
+ B20100000000000000000B02 /* HarnessStatusMenu.swift */,
33E51913231747F40026EE4D /* DebugProfile.entitlements */,
33E51914231749380026EE4D /* Release.entitlements */,
33CC11242044D66E0003C045 /* Resources */,
@@ -371,6 +374,7 @@
B20100000000000000000001 /* SwarmTitlebar.swift in Sources */,
B20100000000000000000003 /* HarnessKeymap.swift in Sources */,
B20100000000000000000A01 /* HarnessNotifications.swift in Sources */,
+ B20100000000000000000B01 /* HarnessStatusMenu.swift in Sources */,
33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */,
335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */,
);
diff --git a/desktop/macos/Runner/AppDelegate.swift b/desktop/macos/Runner/AppDelegate.swift
index b3c176141..9c3e327d5 100644
--- a/desktop/macos/Runner/AppDelegate.swift
+++ b/desktop/macos/Runner/AppDelegate.swift
@@ -3,6 +3,13 @@ import FlutterMacOS
@main
class AppDelegate: FlutterAppDelegate {
+ override init() {
+ super.init()
+ // AppKit reads this app-scoped preference in milliseconds. Registering a
+ // default keeps native help tags while respecting an explicit user override.
+ UserDefaults.standard.register(defaults: ["NSInitialToolTipDelay": 500])
+ }
+
override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
return true
}
diff --git a/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/Contents.json b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/Contents.json
new file mode 100644
index 000000000..87115bc74
--- /dev/null
+++ b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/Contents.json
@@ -0,0 +1,26 @@
+{
+ "images" : [
+ {
+ "filename" : "HarnessStatusIcon.svg",
+ "idiom" : "mac"
+ },
+ {
+ "appearances" : [
+ {
+ "appearance" : "luminosity",
+ "value" : "dark"
+ }
+ ],
+ "filename" : "HarnessStatusIconDark.svg",
+ "idiom" : "mac"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ },
+ "properties" : {
+ "preserves-vector-representation" : true,
+ "template-rendering-intent" : "template"
+ }
+}
diff --git a/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIcon.svg b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIcon.svg
new file mode 100644
index 000000000..36c24b62e
--- /dev/null
+++ b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIcon.svg
@@ -0,0 +1,3 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M28.9989 0C35.0738 0 39.9997 4.92452 40 10.9993V28.9989L39.9858 29.5651C39.701 35.1901 35.1901 39.701 29.5651 39.9858L28.9989 40H10.9993L10.4331 39.9858C4.62142 39.6909 0 34.8839 0 28.9989V10.9993C0.000287163 4.9247 4.9247 0.000282489 10.9993 0H28.9989ZM10.9993 0.905994C5.42507 0.906277 0.906281 5.42507 0.905994 10.9993V28.9989C0.905994 29.4305 0.93482 29.8556 0.987392 30.2729C3.07683 30.5503 5.10195 31.2905 7.22318 32.8653C4.75472 33.3376 3.67895 33.4547 1.44039 32.2424C2.79138 36.2259 6.55969 39.0938 10.9993 39.094H28.9989C33.4732 39.094 37.264 36.1805 38.5879 32.1486C38.017 32.3802 37.4084 32.6715 36.7388 33.0387C36.4605 33.1912 35.4694 33.4007 35.0984 33.5076C33.3997 33.9974 32.1274 34.3373 31.0002 35.8027C31.5468 36.5825 32.0606 37.0002 32.7697 37.6165C31.5926 37.3416 30.3314 37.0796 29.2254 36.5972L28.7883 35.7885C26.6058 35.7782 25.2518 35.7095 23.117 35.2842C25.8576 34.3919 28.2572 34.8809 30.9294 34.5021L31.9098 33.4935C30.0362 32.5766 28.3462 32.0672 26.4101 30.9914L26.7888 32.9361C25.5258 31.4794 25.4809 29.184 25.4722 27.3143C25.4665 26.0743 25.4813 24.8264 25.4899 23.5859C24.7651 24.4981 23.6376 25.6475 22.6445 26.2561C21.8886 26.7185 20.2304 26.9373 19.6771 27.6417C19.535 28.2605 19.9932 30.0019 20.2875 30.5826C18.7709 33.0208 17.7918 29.005 17.0051 28.6078L16.8635 28.7671C16.844 30.7383 17.9267 33.7153 18.3977 35.7461L18.4366 35.923C16.0465 34.8994 13.5962 35.4162 10.6737 34.5127C10.585 34.3272 10.6239 34.4302 10.5499 34.1907C9.80655 33.6594 8.69121 33.1202 7.86198 32.6883C9.36525 31.8982 11.0001 31.2044 12.5601 30.5366C12.2856 30.3072 12.2153 29.1939 11.992 28.898C11.948 28.3138 11.9413 27.4808 11.2064 27.493C10.7576 27.7451 10.58 28.0564 10.4012 28.53C10.4952 28.9668 10.9345 29.9655 11.263 30.4941L11.1144 30.618C10.241 30.7386 9.36635 29.2993 8.87768 28.5123C8.1723 27.3748 9.17609 26.9661 9.38907 26.1004C9.06062 25.6605 8.82097 25.595 8.28135 25.6563C7.48578 25.7468 6.42097 25.3282 6.04999 24.5415C5.40339 23.1652 6.98518 22.1181 7.22318 21.4342C7.01239 21.3043 6.87029 21.2404 6.71887 21.0396C7.10332 20.3781 6.23072 20.3524 6.54015 19.4523C6.61255 19.241 6.64272 19.0984 6.66932 18.8737L6.53661 18.7817C5.39057 19.0071 5.78721 19.9544 5.86596 20.6715L5.74917 20.7211C5.63234 20.6594 5.53534 20.59 5.44304 20.4928C5.02545 20.0516 4.84998 19.4825 4.87503 18.8737C4.99853 15.9064 7.6431 16.8113 8.27781 16.069C8.4203 15.9014 8.50642 15.6019 8.45831 15.3842C8.42086 15.2369 7.59718 15.0489 7.40367 14.9224C7.35696 14.8913 7.30873 14.858 7.26211 14.8268C7.21424 14.7949 7.16516 14.7609 7.11701 14.7295L7.01261 14.6622L6.89582 14.7684C6.83141 15.137 6.9846 15.5156 7.09047 15.885L7.01969 15.9841C6.0062 15.4443 5.71843 13.9928 5.8695 12.9122C6.00676 11.9387 7.17353 11.1294 8.14864 11.463L8.1858 11.5691C7.82038 11.7565 7.56277 11.8512 7.29396 12.1584C7.20509 12.4994 7.18765 12.3488 7.30458 12.6485C7.89762 13.1736 9.09517 13.0797 9.27228 12.1654C9.32736 11.8704 8.9935 11.4826 8.82106 11.2435C9.17349 10.8361 9.87123 9.76769 10.0951 9.27936C9.06969 9.06847 8.97633 10.0489 8.75735 10.649C8.21552 10.0097 8.22757 9.38106 8.85291 8.77151C9.70789 7.93884 10.2013 7.9195 11.3037 7.94338L11.3426 7.8549C12.1937 5.8071 12.7283 5.08419 14.8357 4.19022C15.7496 3.80267 17.1772 3.39507 18.1323 3.81685C18.1181 4.03805 17.9109 4.03597 17.582 4.16545C16.1874 4.71605 15.5358 5.05349 14.5278 6.16147C15.0971 5.8504 16.504 5.23368 17.113 5.57576C16.7131 5.75116 16.5785 5.77683 16.2778 6.08007C16.4114 6.48047 16.9945 6.21972 17.4775 6.78965L17.3785 6.87459C14.8634 7.22466 14.6366 8.3527 14.4216 10.5711C14.1644 10.7923 14.0211 10.8921 13.8235 11.1763L13.9102 11.2435C15.4404 10.3967 14.7707 7.55341 17.3855 7.70626C18.0222 7.74407 19.0287 8.09832 19.47 8.55032C19.3058 9.20207 17.6324 8.92657 17.1343 9.74829C17.0785 10.3917 17.5654 10.9178 17.9429 11.4523C17.2997 11.9864 16.7549 12.6353 16.0336 13.2307C17.7587 13.2575 17.6372 13.33 19.1834 13.8146C19.4128 13.726 19.5531 13.6403 19.7939 13.6819C19.9208 14.4394 19.7484 16.5067 19.8328 17.4333C19.8671 17.8179 19.653 18.2293 19.7762 18.7852C20.3591 19.4247 20.8552 18.788 21.5899 19.0843C21.732 19.3306 21.6889 19.2003 21.6572 19.5213C21.2012 20.1928 20.7417 19.3144 20.5424 20.6432L20.4999 20.7919L20.8202 20.8414C21.5086 21.1739 22.1313 21.2263 22.6622 21.5439C22.7766 21.8938 22.7877 21.7382 22.7083 22.0411C21.624 21.9079 20.3032 21.7211 19.2294 21.8536L19.1834 21.981C19.6978 22.2261 21.1833 22.1065 21.3882 22.4747L21.2502 22.9684C20.8026 23.3284 19.8041 23.1853 19.0648 23.5859C18.7182 24.0514 19.0555 24.3668 19.4736 24.637C19.7828 24.6056 19.7556 24.5283 20.0416 24.2442C21.0759 23.9674 20.5378 25.8914 22.6622 24.7149C25.6189 23.0767 25.7153 22.8769 25.8722 19.3603C25.2531 19.7158 25.0742 19.8614 24.5273 20.3265C25.0956 17.6498 26.6729 18.71 26.0261 15.2763C23.9929 16.2311 24.8163 15.3372 24.0655 15.2126C23.8457 15.6735 23.8845 15.6511 23.4833 15.9274L23.3276 16.0301C23.5155 16.2522 23.5377 16.275 23.6709 16.5309C23.0441 17.0916 22.0265 16.3635 21.5156 15.9628C21.3504 16.0073 21.345 16.0435 21.2183 16.1575C20.9362 15.5903 20.4487 14.0131 20.5954 13.4023L20.7211 13.3634C22.3665 14.1449 22.9761 12.4035 25.5218 13.9987C25.116 12.8446 24.973 12.4945 25.2086 11.2683C24.7722 10.2202 24.5928 9.95917 23.9204 9.04048C24.0506 8.78357 24.1683 8.76015 24.4247 8.63703C24.9978 8.36338 25.4138 9.81303 26.0473 10.1393L26.1677 10.0102C26.4299 8.50547 24.9235 7.86208 24.9042 7.08162L25.0741 6.95598C26.5269 6.86745 26.7154 7.52542 27.332 8.70427C27.2581 8.35416 27.2282 8.09895 27.1869 7.74165L27.2789 7.7098C27.5412 7.94925 27.6579 8.30622 27.8222 8.65118C28.0381 8.64776 27.9309 8.6724 28.1354 8.46892C28.3663 7.47171 27.8829 6.88325 27.1267 6.38443C26.5266 6.3393 25.8509 6.32702 25.244 6.30303C25.8582 5.90402 26.2974 5.60682 27.0524 5.61115C28.4259 5.61978 29.2665 6.79511 29.2077 8.13979L29.0838 8.2495L28.7105 8.08317L28.6184 8.13271C28.6804 8.64664 29.1115 8.93441 29.2572 9.37846C29.5665 10.333 29.2203 11.2895 30.7171 11.0577C31.0377 11.0078 31.1583 10.8435 31.3205 10.557C31.3396 10.229 31.3425 10.1979 31.186 9.91462L31.1011 9.75182L31.0285 9.62442C31.1813 9.57077 31.2933 9.54772 31.4373 9.67397C33.3312 11.3556 31.5116 12.0456 30.9825 12.9016C31.5145 13.8669 31.1269 13.5511 31.0745 14.3154C31.0036 15.3942 33.4318 14.9676 33.9942 16.2C34.3675 17.023 34.5409 17.3685 34.3605 18.3446C34.2652 18.9805 33.4289 20.0802 32.7308 19.9319L32.6583 19.8151C33.572 18.7965 33.7354 17.8068 32.1911 17.3395L32.1079 17.4174C32.5256 18.7785 32.2442 19.0632 31.3524 20.0823C31.6754 20.5978 31.9835 21.187 32.5379 21.4307L32.6476 21.3634C32.7005 21.0775 32.7628 20.7896 32.8299 20.507L32.9608 20.5034C34.5562 22.4861 32.5519 25.457 31.2533 24.8334C31.1455 24.5342 31.6996 24.412 31.9487 23.7894C31.8908 23.3814 31.9688 23.5525 31.7045 23.2462C30.2181 22.6746 30.776 24.5891 30.1703 25.244C30.0294 25.3945 29.9557 25.5825 29.9456 25.7854C30.3535 26.2382 30.8515 25.8611 31.2037 25.5678C31.3575 26.1276 31.5732 27.0447 31.4196 27.5957C31.0904 28.7638 29.9697 29.5696 28.8025 29.2643L28.7494 29.1334C29.192 28.8373 29.7533 28.665 29.8076 28.1035C29.5657 27.7206 29.0394 27.6615 28.6326 27.6169C27.9974 27.5474 28.3521 28.4126 28.2238 28.806C28.1437 29.0513 27.909 30.3425 27.7408 30.5295C29.3424 31.2985 31.1271 32.0425 32.7768 32.8193C35.3529 31.3319 37.1573 30.5813 39.0091 30.2765C39.062 29.8579 39.094 29.4319 39.094 28.9989V10.9993C39.0937 5.42489 34.5734 0.905994 28.9989 0.905994H10.9993ZM16.8741 28.6998L16.9485 28.5831L16.9343 28.576L16.8741 28.6998ZM7.48507 23.3524C6.50874 24.2861 7.01969 24.8257 8.02831 25.2847C8.50574 24.5029 8.27073 23.7942 7.48507 23.3524ZM27.6204 18.1783C27.4573 18.5076 27.3879 18.7156 27.109 18.9516C26.8568 18.9949 26.7979 18.9986 26.541 18.9993C26.2028 19.3377 26.2135 19.5939 26.0686 20.1106C26.3327 20.1518 26.5823 20.2452 26.8206 20.0646C27.2534 19.7351 27.6405 18.7012 27.6204 18.1783ZM15.1418 16.2672C15.0636 16.7898 15.0003 17.0778 15.3435 17.5182C15.8292 18.1405 16.3543 18.7262 16.906 19.286C17.1644 19.1299 17.2869 18.8883 17.4599 18.6295C17.7431 17.5394 17.2016 17.6562 17.9819 16.5061C16.6815 16.7692 16.3699 16.838 15.1418 16.2672ZM28.4079 11.6434C27.9179 11.8176 27.5235 11.8216 27.0135 11.8505C27.519 12.2296 28.1264 12.3564 28.4893 12.76L28.3902 12.9122C27.9929 12.9546 27.6635 12.6737 27.2046 12.5317C26.9183 13.4201 28.379 13.6503 28.9511 13.7244L28.537 14.979C28.8548 15.2896 29.3851 15.9061 29.7545 15.9628C29.8395 15.6667 29.8071 15.6997 29.7793 15.3736C31.1563 15.8003 31.5764 15.8972 32.9821 16.0761C31.7025 15.2697 31.0536 15.6246 29.8394 14.6445C29.9796 13.6517 29.8622 13.6345 30.5419 12.9865C30.2878 12.6847 29.8786 12.8172 29.6094 12.7052C29.3636 12.6003 28.6501 11.6817 28.4079 11.6434Z" fill="black"/>
+</svg>
diff --git a/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIconDark.svg b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIconDark.svg
new file mode 100644
index 000000000..d0ae9ef23
--- /dev/null
+++ b/desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIconDark.svg
@@ -0,0 +1,9 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M29.0909 0C35.1158 0 40 4.88417 40 10.9091V29.0909C40 29.4504 39.9808 29.8057 39.9467 30.1563C37.7411 30.3474 35.7861 31.0806 32.7805 32.8161C31.1307 32.0392 29.3467 31.2946 27.745 30.5256C27.9132 30.3385 28.1479 29.0483 28.228 28.8033C28.3567 28.4101 28.0009 27.5441 28.6364 27.6136C29.0433 27.6582 29.5699 27.7171 29.8118 28.1001C29.7576 28.6618 29.1962 28.8339 28.7536 29.13L28.8068 29.2614C29.9742 29.5667 31.0948 28.7606 31.424 27.5923C31.5776 27.0413 31.3612 26.1245 31.2074 25.5646C30.8551 25.858 30.3583 26.2345 29.9503 25.7813C29.9604 25.5783 30.0331 25.392 30.174 25.2415C30.7808 24.5873 30.2211 22.6704 31.7081 23.2422C31.9732 23.5495 31.8952 23.3771 31.9531 23.7855C31.7041 24.4087 31.1493 24.5302 31.2571 24.8295C32.5558 25.4542 34.5609 22.4836 32.9652 20.5007L32.8338 20.5043C32.7667 20.7869 32.7055 21.0741 32.6527 21.3601L32.5426 21.4276C31.9876 21.1839 31.6798 20.594 31.3565 20.0781C32.2484 19.059 32.5306 18.776 32.1129 17.4148L32.1946 17.3366C33.7395 17.8039 33.5772 18.7931 32.6634 19.8118L32.7344 19.929C33.4326 20.078 34.2691 18.9776 34.3643 18.3416C34.5449 17.3651 34.3719 17.02 33.9986 16.1967C33.4361 14.9637 31.0071 15.3913 31.0795 14.3111C31.1319 13.5467 31.5193 13.8632 30.9872 12.8977C31.5163 12.0417 33.3361 11.3516 31.4418 9.66974C31.2978 9.5435 31.1861 9.56637 31.0334 9.62003L31.1044 9.74787L31.1896 9.91122C31.3463 10.1948 31.3438 10.2254 31.3246 10.554C31.1622 10.8408 31.0419 11.0049 30.7209 11.0547C29.224 11.2864 29.5707 10.3296 29.2614 9.375C29.1156 8.93069 28.6838 8.64298 28.6222 8.12855L28.7145 8.07884L29.0874 8.24574L29.2116 8.13565C29.2704 6.7908 28.4298 5.61561 27.0561 5.60724C26.3011 5.60292 25.8629 5.9007 25.2486 6.29972C25.8555 6.3237 26.5305 6.33627 27.1307 6.38139C27.8871 6.88033 28.3705 7.4683 28.1392 8.46591C27.9347 8.66945 28.0427 8.64359 27.8267 8.64702C27.6624 8.30203 27.5457 7.94543 27.2834 7.70597L27.1911 7.73793C27.2324 8.09536 27.2627 8.35009 27.3366 8.70028C26.7201 7.52138 26.5311 6.86454 25.0781 6.95313L24.9077 7.07741C24.926 7.8583 26.4345 8.50158 26.1719 10.0071L26.0511 10.1349C25.4175 9.80859 25.0014 8.35877 24.4283 8.63281C24.1716 8.75608 24.0544 8.77999 23.924 9.03764C24.5965 9.95641 24.7767 10.2161 25.2131 11.2642C24.9773 12.491 25.1197 12.8407 25.5256 13.995C22.9794 12.3996 22.3706 14.1419 20.7244 13.3594L20.6001 13.3984C20.453 14.0087 20.9394 15.5867 21.2216 16.1541C21.3489 16.0397 21.3541 16.0034 21.5199 15.9588C22.0309 16.3595 23.0486 17.0886 23.6754 16.527C23.5421 16.2709 23.5194 16.2489 23.331 16.0263L23.4872 15.9233C23.8884 15.6469 23.8498 15.6706 24.0696 15.2095C24.8205 15.3341 23.9965 16.2283 26.0298 15.2734C26.6767 18.7074 25.0995 17.6463 24.5313 20.3232C25.0784 19.8578 25.2576 19.713 25.8771 19.3572C25.7202 22.874 25.6237 23.0742 22.6669 24.7124C20.5422 25.8891 21.0805 23.9633 20.0462 24.2401C19.7594 24.5247 19.7875 24.6028 19.478 24.6342C19.0596 24.364 18.7228 24.0488 19.0696 23.5831C19.8089 23.1824 20.806 23.3253 21.2536 22.9652L21.392 22.4716C21.1874 22.1032 19.7009 22.2234 19.1868 21.978L19.233 21.8501C20.3071 21.7176 21.6285 21.905 22.7131 22.0384C22.7926 21.7349 22.7813 21.8914 22.6669 21.5412C22.1357 21.2232 21.5127 21.1708 20.8239 20.8381L20.5043 20.7884L20.5469 20.6392C20.7463 19.3097 21.2058 20.1904 21.6619 19.517C21.6937 19.1959 21.7367 19.327 21.5945 19.0803C20.8596 18.7837 20.3629 19.4218 19.7798 18.782C19.6565 18.2255 19.8714 17.8138 19.8366 17.429C19.7522 16.5023 19.9246 14.4364 19.7976 13.679C19.5567 13.6373 19.4164 13.7217 19.1868 13.8104C17.6404 13.3257 17.7627 13.2548 16.0369 13.228C16.7587 12.6323 17.3038 11.9832 17.9474 11.4489C17.5698 10.9141 17.0817 10.3881 17.1378 9.74432C17.6359 8.92254 19.3103 9.19948 19.4744 8.54759C19.0334 8.09529 18.0269 7.74024 17.3899 7.70242C14.7745 7.54929 15.4441 10.3927 13.9134 11.2393L13.8281 11.1719C14.0258 10.8877 14.1675 10.7894 14.4247 10.5682C14.6398 8.3492 14.8672 7.22152 17.3828 6.87145L17.4822 6.78622C16.9989 6.2155 16.4153 6.47721 16.282 6.07599C16.5827 5.77274 16.7165 5.74716 17.1165 5.57173C16.5073 5.22959 15.1004 5.84665 14.5313 6.15767C15.5394 5.04956 16.1905 4.71257 17.5852 4.16193C17.9147 4.03215 18.1215 4.03539 18.1357 3.81392C17.1806 3.39213 15.7542 3.79923 14.8402 4.18679C12.7323 5.08092 12.1971 5.80325 11.3459 7.85156L11.3068 7.94034C10.2044 7.91647 9.71156 7.93502 8.85653 8.76776C8.23106 9.37739 8.21862 10.007 8.76065 10.6463C8.97991 10.0462 9.07314 9.06429 10.0994 9.27557C9.87576 9.7637 9.17711 10.8318 8.82457 11.2393C8.99703 11.4786 9.33146 11.8672 9.27557 12.1626C9.09852 13.077 7.90129 13.1708 7.30824 12.6456C7.19111 12.3452 7.20865 12.4968 7.29759 12.1555C7.56658 11.848 7.82326 11.7536 8.18892 11.5661L8.15341 11.4595C7.17812 11.1252 6.01088 11.9346 5.87358 12.9084C5.72236 13.9891 6.01032 15.4404 7.02415 15.9801L7.09517 15.8807C6.98929 15.5113 6.8354 15.1342 6.89986 14.7656L7.01705 14.6591L7.12003 14.7266C7.16831 14.758 7.21762 14.7904 7.26563 14.8224C7.31247 14.8538 7.36072 14.8871 7.40767 14.9183C7.60074 15.0449 8.42489 15.2326 8.46236 15.38C8.51088 15.5978 8.42397 15.8975 8.28125 16.0653C7.6466 16.8078 5.00252 15.9028 4.87926 18.8707C4.85417 19.4799 5.0294 20.0487 5.44744 20.4901C5.53976 20.5872 5.63598 20.6556 5.75284 20.7173L5.87003 20.6676C5.79127 19.9503 5.39433 19.0036 6.54119 18.7784L6.67259 18.8707C6.64597 19.0957 6.61726 19.238 6.54474 19.4496C6.2351 20.3501 7.10788 20.3747 6.7223 21.0369C6.87375 21.2378 7.01575 21.3012 7.22656 21.4311C6.98865 22.1151 5.40742 23.1617 6.05469 24.5384C6.42563 25.3252 7.48919 25.7439 8.2848 25.6534C8.8248 25.5921 9.06419 25.6572 9.39276 26.0973C9.17983 26.963 8.17597 27.3709 8.88139 28.5085C9.37008 29.2956 10.245 30.7354 11.1186 30.6143L11.2678 30.4901C10.9391 29.9612 10.4985 28.9628 10.4048 28.5263C10.5836 28.0525 10.7616 27.7414 11.2109 27.4893C11.9462 27.4771 11.9516 28.3114 11.9957 28.8956C12.219 29.1914 12.2894 30.3033 12.5639 30.5327C11.0039 31.2005 9.36912 31.8945 7.86577 32.6847C8.69505 33.1165 9.81054 33.6555 10.554 34.1868C10.6284 34.4274 10.589 34.3235 10.6783 34.5099C13.6009 35.4134 16.0508 34.8959 18.4411 35.9197L18.402 35.7422C17.931 33.7113 16.8484 30.7355 16.8679 28.7642L17.0099 28.6044C17.7967 29.0015 18.7744 33.0176 20.2912 30.5788C19.9968 29.9981 19.5382 28.2573 19.6804 27.6385C20.2334 26.9338 21.8931 26.716 22.6491 26.2536C23.6422 25.6448 24.7688 24.4953 25.4936 23.5831C25.4849 24.8239 25.4701 26.0715 25.4759 27.3118C25.4845 29.1817 25.5299 31.4765 26.7933 32.9332L26.4134 30.9872C28.35 32.0635 30.04 32.5737 31.9141 33.4908L30.9339 34.4993C28.2616 34.8781 25.8621 34.3881 23.1214 35.2805C25.2563 35.7058 26.61 35.7744 28.7926 35.7848L29.2294 36.5945C30.3354 37.0768 31.5962 37.3388 32.7734 37.6136C32.0643 36.9973 31.5516 36.5789 31.005 35.799C32.1322 34.3335 33.4041 33.9948 35.103 33.505C35.4741 33.3981 36.4655 33.1887 36.7436 33.0362C37.8385 32.4358 38.7642 32.0252 39.6413 31.7756C39.7019 31.5532 39.7552 31.3284 39.8011 31.1009L39.7514 31.4098C38.6881 36.3203 34.3197 40 29.0909 40H10.9091C4.88455 40 0.000620525 35.1153 0 29.0909V10.9091C0 4.88417 4.88417 1.75724e-07 10.9091 0H29.0909ZM0.0745739 30.1776C0.138184 30.7253 0.252495 31.2592 0.394176 31.7791C0.722332 31.886 1.04988 32.024 1.37429 32.2017C3.66089 33.4547 4.73238 33.3395 7.22656 32.8622C4.79669 31.0583 2.49331 30.3503 0.0745739 30.1776Z" fill="white"/>
+<path d="M39.9183 30.4119C39.9286 30.327 39.9384 30.2418 39.9467 30.1563H39.9609C39.9512 30.2418 39.9304 30.3271 39.9183 30.4119Z" fill="white"/>
+<path d="M16.9531 28.5795L16.8786 28.6967L16.9389 28.5724L16.9531 28.5795Z" fill="white"/>
+<path d="M7.48935 23.3487C8.27505 23.7906 8.51012 24.4987 8.03267 25.2805C7.02385 24.8215 6.51246 24.2827 7.48935 23.3487Z" fill="white"/>
+<path d="M27.6243 18.1747C27.6444 18.6975 27.2582 19.7308 26.8253 20.0604C26.5867 20.2418 26.337 20.1478 26.0724 20.1065C26.2174 19.5897 26.2062 19.3335 26.5447 18.995C26.802 18.9943 26.8605 18.9923 27.1129 18.9489C27.3922 18.7127 27.4611 18.5043 27.6243 18.1747Z" fill="white"/>
+<path d="M15.1456 16.2642C16.374 16.8352 16.6856 16.7653 17.9865 16.5021C17.2056 17.653 17.7478 17.5354 17.4645 18.6257C17.2913 18.8847 17.1691 19.1265 16.9105 19.2827C16.3586 18.7227 15.8338 18.1366 15.348 17.5142C15.0047 17.0737 15.0675 16.7869 15.1456 16.2642Z" fill="white"/>
+<path d="M28.4126 11.6406C28.6549 11.6788 29.3671 12.5976 29.6129 12.7024C29.8822 12.8147 30.2927 12.6806 30.5469 12.983C29.8665 13.6315 29.984 13.648 29.8438 14.6413C31.058 15.6215 31.7069 15.266 32.9865 16.0724C31.5805 15.8935 31.1608 15.7961 29.7834 15.3693C29.8113 15.6964 29.8437 15.6624 29.7585 15.9588C29.3889 15.9021 28.8581 15.2855 28.5405 14.9751L28.956 13.7216C28.3843 13.6476 26.9222 13.4173 27.2088 12.5284C27.668 12.6704 27.9973 12.9512 28.3949 12.9084L28.4943 12.7557C28.1313 12.352 27.5227 12.226 27.017 11.8466C27.5275 11.8177 27.9223 11.815 28.4126 11.6406Z" fill="white"/>
+</svg>
diff --git a/desktop/macos/Runner/HarnessStatusMenu.swift b/desktop/macos/Runner/HarnessStatusMenu.swift
new file mode 100644
index 000000000..f5d96222c
--- /dev/null
+++ b/desktop/macos/Runner/HarnessStatusMenu.swift
@@ -0,0 +1,219 @@
+import Cocoa
+import CoreText
+
+/// Unread conversations in the system menu bar. Dart owns the
+/// unread ledger and navigation; AppKit only presents a snapshot and its receipts.
+final class HarnessStatusMenu: NSObject, NSMenuDelegate {
+ let menu = NSMenu(title: "Harness")
+ private(set) var statusItem: NSStatusItem?
+ private var entries: [[String: Any]] = []
+ private var enabled = false
+ private var workspaceAvailable = false
+ private var tracking = false
+ private var dirty = true
+ private let showWindow: () -> Void
+ private let emit: (String, Any?) -> Void
+
+ init(installStatusItem: Bool = true, showWindow: @escaping () -> Void,
+ emit: @escaping (String, Any?) -> Void) {
+ self.showWindow = showWindow
+ self.emit = emit
+ super.init()
+ menu.autoenablesItems = false
+ menu.delegate = self
+ if installStatusItem {
+ let item = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
+ statusItem = item
+ item.menu = menu
+ item.button?.imagePosition = .imageOnly
+ item.button?.setAccessibilityLabel("Harness notifications")
+ }
+ update([:])
+ }
+
+ deinit {
+ if let statusItem { NSStatusBar.system.removeStatusItem(statusItem) }
+ }
+
+ func update(_ state: [String: Any]) {
+ let nextEnabled = state["enabled"] as? Bool == true
+ let nextAvailable = state["statusMenuEntries"] != nil
+ let nextEntries = (state["statusMenuEntries"] as? [[String: Any]] ?? [])
+ .filter { $0["unread"] as? Bool == true }
+ guard dirty || enabled != nextEnabled || workspaceAvailable != nextAvailable ||
+ !NSArray(array: entries).isEqual(to: nextEntries) else { return }
+ enabled = nextEnabled
+ workspaceAvailable = nextAvailable
+ entries = nextEntries
+ let count = entries.count
+ statusItem?.button?.image = Self.badgeImage(logo: NSImage(named: "HarnessStatusIcon"),
+ count: workspaceAvailable ? count : nil)
+ statusItem?.button?.toolTip = workspaceAvailable ? "Harness · \(count) unread" : "Harness"
+ statusItem?.button?.setAccessibilityValue("\(count) unread")
+ dirty = true
+ // Never move a conversation out from under the pointer. Stale actions are
+ // revalidated against `entries`, even while the displayed menu stays still.
+ if !tracking { rebuild() }
+ if !workspaceAvailable { menu.cancelTracking() }
+ }
+
+ func menuNeedsUpdate(_ menu: NSMenu) {
+ if !tracking && dirty { rebuild() }
+ }
+
+ func menuWillOpen(_ menu: NSMenu) {
+ if dirty { rebuild() }
+ tracking = true
+ }
+
+ func menuDidClose(_ menu: NSMenu) {
+ tracking = false
+ // AppKit dispatches the selected item after closing. Rebuild on next open
+ // or update so its receipt remains the snapshot the person selected.
+ }
+
+ private func rebuild() {
+ dirty = false
+ menu.removeAllItems()
+ if entries.isEmpty {
+ let empty = NSMenuItem(title: workspaceAvailable ? "No unread notifications" : "Open Harness to get started",
+ action: nil, keyEquivalent: "")
+ empty.isEnabled = false
+ menu.addItem(empty)
+ } else {
+ // First occurrence preserves newest-first ordering across project groups.
+ var groups: [String] = []
+ var grouped: [String: [[String: Any]]] = [:]
+ let machines = Set(entries.compactMap { $0["machineId"] as? String })
+ for entry in entries {
+ let project = entry["project"] as? String ?? "No Project"
+ let machine = entry["machineId"] as? String ?? ""
+ let group = machine + "\u{0}" + project
+ if grouped[group] == nil { groups.append(group) }
+ grouped[group, default: []].append(entry)
+ }
+ for (index, group) in groups.enumerated() {
+ if index > 0 { menu.addItem(.separator()) }
+ let rows = grouped[group]!
+ let first = rows[0]
+ var title = first["project"] as? String ?? "No Project"
+ if machines.count > 1 { title += " · " + (first["machineName"] as? String ?? "") }
+ let heading = NSMenuItem(title: compact(title), action: nil, keyEquivalent: "")
+ heading.isEnabled = false
+ heading.toolTip = title
+ menu.addItem(heading)
+ for entry in rows {
+ let title = entry["title"] as? String ?? "Unavailable harness"
+ let row = add(compact(title), "openStatusHarness", enabled: enabled && entry["unavailable"] as? String == nil)
+ row.representedObject = entry
+ row.indentationLevel = 1
+ row.state = .on
+ row.onStateImage = Self.unreadDot
+ let status = entry["unavailable"] as? String ?? entry["label"] as? String
+ row.toolTip = [title, entry["detail"] as? String, status].compactMap { $0 }.joined(separator: " · ")
+ row.setAccessibilityLabel([title, status, "Unread"]
+ .compactMap { $0 }.joined(separator: ", "))
+ }
+ }
+ }
+ menu.addItem(.separator())
+ add("New Harness…", "newAgent", enabled: enabled)
+ let clear = add("Clear All Notifications", "clearStatusNotifications",
+ enabled: enabled && !entries.isEmpty)
+ clear.representedObject = entries
+ menu.addItem(.separator())
+ add("Open Harness", "openWindow")
+ add("Settings…", "settings", enabled: enabled)
+ menu.addItem(.separator())
+ add("Quit Harness", "quit")
+ }
+
+ @discardableResult private func add(_ title: String, _ action: String, enabled: Bool = true) -> NSMenuItem {
+ let item = NSMenuItem(title: title, action: #selector(selected(_:)), keyEquivalent: "")
+ item.identifier = NSUserInterfaceItemIdentifier(action)
+ item.target = self
+ item.isEnabled = enabled
+ menu.addItem(item)
+ return item
+ }
+
+ @objc private func selected(_ item: NSMenuItem) {
+ guard item.isEnabled, let action = item.identifier?.rawValue else { return }
+ switch action {
+ case "openWindow": showWindow()
+ case "quit": NSApp.terminate(nil)
+ case "openStatusHarness":
+ guard enabled, let receipt = item.representedObject as? [String: Any],
+ entries.contains(where: { sameReceipt($0, receipt) && $0["unavailable"] as? String == nil }) else { return }
+ // Dart opens the destination before revealing the window, so activating
+ // the previously selected tab cannot acknowledge the wrong notification.
+ emit(action, receipt)
+ case "clearStatusNotifications":
+ guard enabled, let receipts = item.representedObject as? [[String: Any]] else { return }
+ emit(action, ["receipts": receipts])
+ default:
+ guard enabled else { return }
+ showWindow()
+ emit(action, nil)
+ }
+ }
+
+ private func sameReceipt(_ current: [String: Any], _ displayed: [String: Any]) -> Bool {
+ ["machineId", "agentId", "readToken", "questionId"].allSatisfy {
+ current[$0] as? String == displayed[$0] as? String
+ }
+ }
+
+ private func compact(_ text: String) -> String {
+ let line = text.components(separatedBy: .newlines).joined(separator: " ")
+ return line.count > 56 ? String(line.prefix(55)) + "…" : line
+ }
+
+ /// A single template mask lets AppKit tint the logo and badge together for
+ /// the menu bar's appearance and selection. Clear digits and a small halo
+ /// keep the overlapping badge legible without painting a fixed background.
+ private static func badgeImage(logo: NSImage?, count: Int?) -> NSImage {
+ let label: String
+ if let count, count > 0 {
+ label = count > 99 ? "99+" : String(count)
+ } else {
+ label = ""
+ }
+ let image = NSImage(size: NSSize(width: 28, height: 22), flipped: false) { bounds in
+ // Balance the portrait's fine cutouts against neighboring system symbols.
+ logo?.draw(in: NSRect(x: label.isEmpty ? (bounds.width - 17) / 2 : 2, y: label.isEmpty ? 2.5 : 4,
+ width: 17, height: 17))
+ if !label.isEmpty, let context = NSGraphicsContext.current?.cgContext {
+ let badge = NSRect(x: bounds.maxX - 15, y: 0.5, width: 12.5, height: 12.5)
+ context.saveGState()
+ context.setBlendMode(.clear)
+ context.fillEllipse(in: badge.insetBy(dx: -0.75, dy: -0.75))
+ context.restoreGState()
+ NSColor.black.setFill()
+ NSBezierPath(ovalIn: badge).fill()
+ let size: CGFloat = label.count == 1 ? 9.5 : label.count == 2 ? 8.5 : 6.5
+ let text = NSAttributedString(string: label, attributes: [
+ .font: NSFont.monospacedDigitSystemFont(ofSize: size, weight: .medium),
+ .foregroundColor: NSColor.black,
+ ])
+ let line = CTLineCreateWithAttributedString(text)
+ let ink = CTLineGetBoundsWithOptions(line, .useGlyphPathBounds)
+ context.saveGState()
+ context.setBlendMode(.destinationOut)
+ context.textPosition = NSPoint(x: badge.midX - ink.midX, y: badge.midY - ink.midY)
+ CTLineDraw(line, context)
+ context.restoreGState()
+ }
+ return true
+ }
+ image.isTemplate = true
+ image.accessibilityDescription = count.map { "\($0) unread" } ?? "Harness"
+ return image
+ }
+
+ private static let unreadDot = NSImage(size: NSSize(width: 12, height: 12), flipped: false) { _ in
+ NSColor.systemBlue.setFill()
+ NSBezierPath(ovalIn: NSRect(x: 3, y: 3, width: 6, height: 6)).fill()
+ return true
+ }
+}
diff --git a/desktop/macos/Runner/SwarmTitlebar.swift b/desktop/macos/Runner/SwarmTitlebar.swift
index d6496e0d0..34a972245 100644
--- a/desktop/macos/Runner/SwarmTitlebar.swift
+++ b/desktop/macos/Runner/SwarmTitlebar.swift
@@ -20,6 +20,7 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
private let channel: FlutterMethodChannel
private let accessory = NSTitlebarAccessoryViewController()
private let strip = SwarmTabStrip(frame: NSRect(x: 0, y: 0, width: 900, height: 40))
+ private var statusMenu: HarnessStatusMenu?
private var statusBarHeight: NSLayoutConstraint?
private var observers: [NSObjectProtocol] = []
private var configured = false
@@ -41,10 +42,17 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
private var flutterKeyContext = "workspace"
private var tabActionGeneration = 0
- init(window: NSWindow, messenger: FlutterBinaryMessenger) {
+ init(window: NSWindow, messenger: FlutterBinaryMessenger, installStatusItem: Bool = true) {
self.window = window
channel = FlutterMethodChannel(name: "harness/swarm_tabs", binaryMessenger: messenger)
super.init()
+ statusMenu = HarnessStatusMenu(installStatusItem: installStatusItem, showWindow: { [weak window] in
+ NSApp.activate(ignoringOtherApps: true)
+ if window?.isMiniaturized == true { window?.deminiaturize(nil) }
+ window?.makeKeyAndOrderFront(nil)
+ }, emit: { [weak self] method, args in
+ self?.sendTabAction(method, arguments: args)
+ })
strip.emit = { [weak self] method, args in
guard let self else { return }
self.sendTabAction(method, arguments: args)
@@ -67,6 +75,7 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
self.canGoForward = state["canGoForward"] as? Bool == true
self.updateHistory(state["history"] as? [[String: Any]] ?? [], closed: state["closedHistory"] as? [[String: Any]] ?? [])
self.strip.update(state)
+ self.statusMenu?.update(state)
self.statusBarHeight?.constant = self.strip.preferredStatusBarHeight
self.window?.backgroundColor = self.strip.palette.tabBar
result(nil)
@@ -119,7 +128,7 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
}
private func sendTabAction(_ method: String, arguments: Any?) {
- guard ["daemon", "subscriptions", "focusedContext", "harnessControls", "machineControls", "modelControls", "select", "close", "new", "rename", "commands", "notifications", "notificationInbox", "store", "sessions", "models", "addAgent", "newAgent", "newTerminal", "cloneAgent", "restartAgent", "shareAgent", "toggleViewer", "toggleComposer", "movePaneToTab", "runLocalModel", "splitRight", "splitDown", "zoomPane", "pinPane", "machineDestination", "machineAgent", "manageMachines", "machineList"].contains(method) else {
+ guard ["daemon", "subscriptions", "focusedContext", "harnessControls", "machineControls", "modelControls", "select", "close", "new", "rename", "commands", "notifications", "notificationInbox", "openStatusHarness", "store", "sessions", "models", "addAgent", "newAgent", "newTerminal", "cloneAgent", "restartAgent", "shareAgent", "toggleViewer", "toggleComposer", "movePaneToTab", "runLocalModel", "splitRight", "splitDown", "zoomPane", "pinPane", "machineDestination", "machineAgent", "manageMachines", "machineList"].contains(method) else {
channel.invokeMethod(method, arguments: arguments)
return
}
@@ -162,7 +171,9 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
private func setKeymap(_ map: HarnessNativeKeymap) {
keymap = map
// Mouse controls teach the effective shortcuts, including user remaps.
- strip.newButton.toolTip = "New Tab " + (map.hint(for: "swarm.new", context: "workspace") ?? "")
+ strip.newButton.toolTip = ["New Tab", map.hint(for: "swarm.new", context: "workspace")]
+ .compactMap { $0 }.joined(separator: " · ")
+ strip.newButton.setAccessibilityHelp(strip.newButton.toolTip)
if let main = NSApp.mainMenu, let window {
let menu = main as? HarnessKeymapMenu ?? HarnessKeymapMenu.replacing(main)
if NSApp.mainMenu !== menu { NSApp.mainMenu = menu }
@@ -895,6 +906,7 @@ private struct SwarmNativePalette: Equatable {
/// Generic native icon controls retain their rounded hover wells.
private class SwarmIconButton: NSButton {
+ private var hoverTracking: NSTrackingArea?
private(set) var hovered = false
private(set) var hasKeyboardFocus = false
var showsHoverFill: Bool { true }
@@ -909,9 +921,13 @@ private class SwarmIconButton: NSButton {
override func updateTrackingAreas() {
super.updateTrackingAreas()
- trackingAreas.forEach(removeTrackingArea)
- addTrackingArea(NSTrackingArea(rect: .zero,
- options: [.mouseEnteredAndExited, .activeAlways, .inVisibleRect], owner: self))
+ // AppKit owns a separate tracking area for tooltips. Replacing all areas
+ // leaves the tooltip string intact but prevents it from ever appearing.
+ if let hoverTracking { removeTrackingArea(hoverTracking) }
+ let area = NSTrackingArea(rect: .zero,
+ options: [.mouseEnteredAndExited, .activeAlways, .inVisibleRect], owner: self)
+ addTrackingArea(area)
+ hoverTracking = area
}
override func mouseEntered(with event: NSEvent) { hovered = true; needsDisplay = true }
override func mouseExited(with event: NSEvent) { hovered = false; needsDisplay = true }
@@ -969,7 +985,7 @@ private class SwarmPlainIconButton: SwarmIconButton {
override func draw(_ dirtyRect: NSRect) {
let emphasized = isEnabled && (hovered || hasKeyboardFocus || isHighlighted)
// Draw only the glyph: AppKit can paint a hover bezel even on a borderless
- // NSButton. Emphasis belongs to the bell, never a background around it.
+ // NSButton. Emphasis belongs to the glyph, never a background around it.
if let symbol = image?.withSymbolConfiguration(symbolConfiguration ?? HarnessControlSymbols.configuration) {
let rect = NSRect(x: (bounds.width - symbol.size.width) / 2,
y: (bounds.height - symbol.size.height) / 2,
@@ -985,24 +1001,6 @@ private class SwarmPlainIconButton: SwarmIconButton {
}
}
-/// A fixed-width bell with the same unread count as the Flutter popup.
-private final class SwarmNotificationButton: SwarmPlainIconButton {
- var count = 0 { didSet { needsDisplay = true } }
- override func draw(_ dirtyRect: NSRect) {
- super.draw(dirtyRect)
- guard count > 0 else { return }
- let label = NSAttributedString(string: count > 99 ? "99+" : "\(count)", attributes: [
- .font: NSFont.systemFont(ofSize: 9, weight: .semibold), .foregroundColor: NSColor.white,
- ])
- let width = max(13, ceil(label.size().width) + 6)
- let badge = NSRect(x: bounds.maxX - width,
- y: isFlipped ? bounds.minY : bounds.maxY - 13, width: width, height: 13)
- NSColor(srgbRed: 207.0 / 255, green: 64.0 / 255, blue: 56.0 / 255, alpha: 1).setFill()
- NSBezierPath(roundedRect: badge, xRadius: 6.5, yRadius: 6.5).fill()
- label.draw(at: NSPoint(x: badge.midX - label.size().width / 2, y: badge.midY - label.size().height / 2))
- }
-}
-
/// A quiet filled pill, with the Store's colorful mark as its focal point.
/// Drawing the content keeps the same spacing across AppKit button styles.
private final class SwarmStoreButton: SwarmIconButton {
@@ -1746,7 +1744,6 @@ private final class SwarmTabStrip: NSView {
private var subscriptionUsageState: [String: Any]?
fileprivate let pullRequestButton = SwarmContextButton()
fileprivate let shareButton = SwarmShareButton()
- fileprivate let notificationsButton = SwarmNotificationButton()
fileprivate let searchButton = SwarmPlainIconButton()
fileprivate let storeButton = SwarmStoreButton()
private var shareTarget: [String: Any]?
@@ -1792,7 +1789,7 @@ private final class SwarmTabStrip: NSView {
addSubview(newButton)
newButton.setAccessibilityLabel("New Tab")
newButton.isEnabled = false
- newButton.toolTip = "New Tab ⌘T"
+ newButton.toolTip = "New Tab"
newButton.image = HarnessControlSymbols.image("plus")
newButton.title = ""
newButton.imagePosition = .imageOnly
@@ -1839,16 +1836,6 @@ private final class SwarmTabStrip: NSView {
}
daemonButton.onExit = { [weak self] in self?.setDaemonHover(false) }
statusBar.addSubview(daemonButton)
- notificationsButton.isBordered = false
- notificationsButton.focusRingType = .none
- notificationsButton.title = ""
- notificationsButton.image = HarnessControlSymbols.image("bell")
- notificationsButton.imagePosition = .imageOnly
- notificationsButton.target = self
- notificationsButton.action = #selector(openNotifications)
- notificationsButton.isEnabled = false
- notificationsButton.setAccessibilityLabel("Notifications")
- addSubview(notificationsButton)
searchButton.isBordered = false
searchButton.focusRingType = .none
searchButton.title = ""
@@ -1885,7 +1872,7 @@ private final class SwarmTabStrip: NSView {
statusBar.setAccessibilityRole(.group)
statusBar.setAccessibilityLabel("Focused pane status")
statusBar.setAccessibilityParent(self)
- setAccessibilityChildren([scroll, newButton, searchButton, notificationsButton, storeButton, statusBar])
+ setAccessibilityChildren([scroll, newButton, searchButton, storeButton, statusBar])
statusBar.setAccessibilityChildren([subscriptionUsageButton, daemonButton, shareButton, voiceLabel, contextButton, pullRequestButton])
registerForDraggedTypes([swarmPasteboardType])
scroll.contentView.postsBoundsChangedNotifications = true
@@ -2005,7 +1992,7 @@ private final class SwarmTabStrip: NSView {
let passiveFooter = state["footerPassive"] as? Bool == true
statusBar.setAccessibilityHidden(passiveFooter || statusBar.isHidden)
setAccessibilityChildren(
- [scroll, newButton, searchButton, notificationsButton, storeButton] +
+ [scroll, newButton, searchButton, storeButton] +
(statusBar.isHidden || passiveFooter ? [] : [statusBar]))
reduceMotion = state["reduceMotion"] as? Bool == true
if let style = state["barStyle"] as? [String: Any] {
@@ -2025,7 +2012,9 @@ private final class SwarmTabStrip: NSView {
searchButton.foreground = palette.navigationForeground
searchButton.isEnabled = actionsEnabled
searchButton.toolTip = state["searchTooltip"] as? String ?? "Search harnesses"
- storeButton.toolTip = state["storeTooltip"] as? String ?? "Harness Store"
+ searchButton.setAccessibilityHelp(searchButton.toolTip)
+ storeButton.toolTip = state["storeTooltip"] as? String ?? "Explore Harness Store"
+ storeButton.setAccessibilityHelp(storeButton.toolTip)
subscriptionUsageButton.font = barFont
subscriptionUsageButton.foreground = terminalForeground
subscriptionUsageButton.contentPadding = ("m" as NSString).size(withAttributes: [.font: barFont]).width
@@ -2049,12 +2038,6 @@ private final class SwarmTabStrip: NSView {
shareButton.setAccessibilityLabel(shareTarget?["label"] as? String ?? "Share")
shareButton.setAccessibilityHelp(shareButton.toolTip)
hasPullRequest = state["pullRequest"] != nil
- notificationsButton.count = max(0, state["unread"] as? Int ?? 0)
- notificationsButton.foreground = palette.navigationForeground
- notificationsButton.isEnabled = actionsEnabled
- notificationsButton.toolTip = notificationsButton.count == 0
- ? "Notifications" : "Notifications · \(notificationsButton.count) unread"
- notificationsButton.setAccessibilityValue("\(notificationsButton.count) unread")
daemonButton.font = barFont
daemonButton.foreground = terminalForeground
voiceLabel.font = barFont
@@ -2238,9 +2221,7 @@ private final class SwarmTabStrip: NSView {
storeButton.frame = NSRect(x: bounds.width - trailing - storeWidth,
y: (bounds.height - toolHeight) / 2, width: storeWidth, height: toolHeight)
let iconWidth = cell * 4
- notificationsButton.frame = NSRect(x: storeButton.frame.minX - iconWidth,
- y: (bounds.height - toolHeight) / 2, width: iconWidth, height: toolHeight)
- searchButton.frame = NSRect(x: notificationsButton.frame.minX - iconWidth,
+ searchButton.frame = NSRect(x: storeButton.frame.minX - iconWidth - 8,
y: (bounds.height - toolHeight) / 2, width: iconWidth, height: toolHeight)
// Only navigation actions share the tab row. Context has the full footer.
let tabBudget = max(0, searchButton.frame.minX - cell * 6)
@@ -2338,9 +2319,6 @@ private final class SwarmTabStrip: NSView {
setDaemonHover(false)
if actionsEnabled && daemonButton.isEnabled { emit?("daemon", nil) }
}
- @objc private func openNotifications() {
- if actionsEnabled && notificationsButton.isEnabled { emit?("notificationInbox", nil) }
- }
@objc private func openSearch() {
if actionsEnabled && searchButton.isEnabled { emit?("sessions", nil) }
}
diff --git a/desktop/test/agent_creation_recovery_test.dart b/desktop/test/agent_creation_recovery_test.dart
index 821d7cd75..eb549bea4 100644
--- a/desktop/test/agent_creation_recovery_test.dart
+++ b/desktop/test/agent_creation_recovery_test.dart
@@ -95,7 +95,7 @@ void main() {
'new pane',
'shortcut',
'search shortcut',
- 'new swarm',
+ 'new tab',
]) {
for (final dismissal in ['outside', 'escape']) {
testWidgets('$entry creation dismisses once on $dismissal', (
@@ -116,7 +116,7 @@ void main() {
await tester.sendKeyEvent(LogicalKeyboardKey.enter);
expect(find.byType(AlertDialog), findsNothing);
await chord(tester, LogicalKeyboardKey.keyN);
- case 'new swarm':
+ case 'new tab':
await chord(tester, LogicalKeyboardKey.keyT);
await chord(tester, LogicalKeyboardKey.keyN);
case 'search shortcut':
@@ -141,7 +141,7 @@ void main() {
await tester.pumpAndSettle();
expect(find.byType(AlertDialog), findsNothing);
expect(find.byType(SwarmSearchResults), findsNothing);
- if (entry == 'new swarm') {
+ if (entry == 'new tab') {
expect(app.swarms, hasLength(2));
expect(app.panes, isEmpty);
await chord(tester, LogicalKeyboardKey.keyW);
@@ -408,7 +408,7 @@ void main() {
});
test(
- 'lost creation reply recovers into the original swarm and counts once',
+ 'lost creation reply recovers into the original tab and counts once',
() async {
final connection = _Connection();
final app = createApp(connectionForTest: (_) => connection);
@@ -597,7 +597,7 @@ void main() {
);
}
- test('closing the original swarm does not block recovery or add into a different swarm', () async {
+ test('closing the original tab does not block recovery or add into a different tab', () async {
final connection = _Connection();
final app = createApp(connectionForTest: (_) => connection);
addTearDown(app.dispose);
diff --git a/desktop/test/attach_intent_test.dart b/desktop/test/attach_intent_test.dart
index 89f76cc2c..b5ce0bbd6 100644
--- a/desktop/test/attach_intent_test.dart
+++ b/desktop/test/attach_intent_test.dart
@@ -548,7 +548,7 @@ void main() {
expect(
asked.every((o) => o['takeover'] == false),
isTrue,
- reason: 'but it watches: the person is on another swarm',
+ reason: 'but it watches: the person is on another tab',
);
await finish(tester);
});
diff --git a/desktop/test/benchmarks/swarm_benchmark.dart b/desktop/test/benchmarks/swarm_benchmark.dart
index c55a13ce6..7b2626e56 100644
--- a/desktop/test/benchmarks/swarm_benchmark.dart
+++ b/desktop/test/benchmarks/swarm_benchmark.dart
@@ -366,7 +366,7 @@ void main() {
final swarmCount = scenario.swarms;
final chrome = scenario.native ? 'native bridge' : 'Flutter tabs';
testWidgets(
- 'tab-switch CPU benchmark with $swarmCount retained swarms ($chrome)',
+ 'tab-switch CPU benchmark with $swarmCount retained tabs ($chrome)',
(tester) async {
final app = createApp();
app.machineStates['m']!.nodeOnline = true;
diff --git a/desktop/test/boot_flow_widget_test.dart b/desktop/test/boot_flow_widget_test.dart
index 79f275d7e..e9f93466b 100644
--- a/desktop/test/boot_flow_widget_test.dart
+++ b/desktop/test/boot_flow_widget_test.dart
@@ -1020,7 +1020,7 @@ void main() {
});
testWidgets(
- 'offline selected agent retains its Swarm view with an offline message',
+ 'offline selected agent retains its Tab view with an offline message',
(tester) async {
final app = makeNotifier(AppStatus.authenticated);
const machine = Machine(
diff --git a/desktop/test/channel_controller_test.dart b/desktop/test/channel_controller_test.dart
index 86d55c7b1..ae36397f4 100644
--- a/desktop/test/channel_controller_test.dart
+++ b/desktop/test/channel_controller_test.dart
@@ -77,7 +77,7 @@ void main() {
ids.add(p['id'] as String);
return {
'error': 'NO_PEERS',
- 'detail': 'Add another agent to this swarm.',
+ 'detail': 'Add another agent to this tab.',
};
},
);
diff --git a/desktop/test/channel_shortcut_test.dart b/desktop/test/channel_shortcut_test.dart
index c47ae7fca..4a71f239f 100644
--- a/desktop/test/channel_shortcut_test.dart
+++ b/desktop/test/channel_shortcut_test.dart
@@ -45,7 +45,7 @@ class ChannelConnection extends WsConn {
void main() {
for (final shared in [true, false]) {
test(
- 'swarm reads use an owned available gateway when preferred is ${shared ? 'shared' : 'offline'}',
+ 'tab reads use an owned available gateway when preferred is ${shared ? 'shared' : 'offline'}',
() async {
final connection = ChannelConnection();
final gateways = <String>[];
@@ -86,7 +86,7 @@ void main() {
);
}
- testWidgets('Cmd+Shift+A does not start cross-swarm work', (tester) async {
+ testWidgets('Cmd+Shift+A does not start cross-tab work', (tester) async {
final connection = ChannelConnection();
final app = createApp(connectionForTest: (_) => connection, connected: true)
..status = AppStatus.authenticated;
diff --git a/desktop/test/channel_workspace_test.dart b/desktop/test/channel_workspace_test.dart
index 74159f2ea..09abb5e53 100644
--- a/desktop/test/channel_workspace_test.dart
+++ b/desktop/test/channel_workspace_test.dart
@@ -278,7 +278,7 @@ void main() {
error: 'The owner is unavailable. ' * 20,
);
expect(find.text('No teams yet. Start with two sessions.'), findsNothing);
- final retry = find.widgetWithText(TextButton, 'Retry reading swarm');
+ final retry = find.widgetWithText(TextButton, 'Retry reading tab');
await tester.ensureVisible(retry);
await tester.pumpAndSettle();
expect(retry.hitTestable(), findsOneWidget);
diff --git a/desktop/test/dial_desk_test.dart b/desktop/test/dial_desk_test.dart
index bae86a5ff..8ceabd14d 100644
--- a/desktop/test/dial_desk_test.dart
+++ b/desktop/test/dial_desk_test.dart
@@ -181,7 +181,7 @@ void main() {
);
test(
- 'a dial-selected agent adds a view without replacing swarm membership',
+ 'a dial-selected agent adds a view without replacing tab membership',
() async {
// The carousel cannot reach this agent any more, but the pull-down switcher still names it and the
// window is still told. What happens then is ordinary selection — the focused tile becomes it —
@@ -316,7 +316,7 @@ void main() {
});
test(
- 'a dial_swarm frame switches the swarm, and an unknown id is ignored',
+ 'a dial_swarm frame switches the tab, and an unknown id is ignored',
() async {
// The dial's swarm line. It sends the id it was given; the switch is the ordinary one, so the desk
// it re-describes is the other swarm's panes — which is what the dial's carousel then walks.
@@ -348,7 +348,7 @@ void main() {
'payload': {'swarmId': second},
});
expect(app.activeSwarmId, second);
- expect(_desk(app), isEmpty, reason: 'the new swarm has no panes yet');
+ expect(_desk(app), isEmpty, reason: 'the new tab has no panes yet');
app.dispose();
},
);
diff --git a/desktop/test/harness_placement_test.dart b/desktop/test/harness_placement_test.dart
index 4c1630b8c..b95b1e3a2 100644
--- a/desktop/test/harness_placement_test.dart
+++ b/desktop/test/harness_placement_test.dart
@@ -578,7 +578,7 @@ void main() {
expect(tab.selected!.id, selected);
expect(tab.capacity, AppNotifier.maxPanes);
expect(tab.canCreate, isTrue);
- expect(tab.actionLabel(tab.selected), 'Open in new swarm');
+ expect(tab.actionLabel(tab.selected), 'Open in new tab');
});
test(
diff --git a/desktop/test/keymap_dispatch_test.dart b/desktop/test/keymap_dispatch_test.dart
index e42e10831..774eb65e1 100644
--- a/desktop/test/keymap_dispatch_test.dart
+++ b/desktop/test/keymap_dispatch_test.dart
@@ -143,7 +143,7 @@ void main() {
expect(press('ctrl+space', phase: KeymapKeyPhase.up).handled, isTrue);
});
- test('repeat cannot create swarms or advance a sequence; directional commands can repeat', () {
+ test('repeat cannot create tabs or advance a sequence; directional commands can repeat', () {
expect(press('cmd+t').command, 'swarm.new');
expect(press('cmd+t', phase: KeymapKeyPhase.repeat).handled, isTrue);
expect(press('cmd+t', phase: KeymapKeyPhase.repeat).command, isNull);
diff --git a/desktop/test/pane_preset_test.dart b/desktop/test/pane_preset_test.dart
index f8ba084cc..93c291323 100644
--- a/desktop/test/pane_preset_test.dart
+++ b/desktop/test/pane_preset_test.dart
@@ -86,7 +86,7 @@ void _expectShape(List<Rect> actual, List<Rect> want) {
void main() {
testWidgets(
- 'automatic Swarm layouts match the prior geometry at narrow and wide sizes',
+ 'automatic Tab layouts match the prior geometry at narrow and wide sizes',
(tester) async {
for (final size in [const Size(880, 600), const Size(1800, 900)]) {
for (final count in [6, 17]) {
diff --git a/desktop/test/search_workspace_test.dart b/desktop/test/search_workspace_test.dart
index 568b63cb1..b050c5c0d 100644
--- a/desktop/test/search_workspace_test.dart
+++ b/desktop/test/search_workspace_test.dart
@@ -1,6 +1,7 @@
import 'support/open_harness.dart';
import 'package:flutter/foundation.dart';
+import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
@@ -14,6 +15,93 @@ import 'swarm_state_test.dart' show createApp;
void main() {
for (final native in [false, true]) {
+ testWidgets(
+ 'toolbar tooltips follow live shortcut remaps and unbinding (native=$native)',
+ (tester) async {
+ debugDefaultTargetPlatformOverride = TargetPlatform.macOS;
+ addTearDown(() => debugDefaultTargetPlatformOverride = null);
+ const channel = MethodChannel('harness/swarm_tabs');
+ final calls = <MethodCall>[];
+ tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
+ channel,
+ (call) async {
+ calls.add(call);
+ return null;
+ },
+ );
+ addTearDown(
+ () => tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
+ channel,
+ null,
+ ),
+ );
+ final map = MemoryKeymap();
+ final app = createApp();
+ final input = <TerminalBinaryFrame>[];
+ final pane = app.adoptSessionForTest(terminal('a0', input));
+ await mount(tester, app, map, native: native);
+ final session = pane.session;
+ final focus = FocusManager.instance.primaryFocus;
+ final mouse = await tester.createGesture(kind: PointerDeviceKind.mouse);
+ await mouse.addPointer(location: Offset.zero);
+ var firstHover = true;
+
+ Future<void> checkHints(String search, String store) async {
+ if (native) {
+ final payload =
+ calls.lastWhere((call) => call.method == 'update').arguments
+ as Map;
+ expect(payload['searchTooltip'], search);
+ expect(payload['storeTooltip'], store);
+ } else {
+ for (final (key, text) in [
+ ('swarm-search-button', search),
+ ('swarm-store-button', store),
+ ]) {
+ await mouse.moveTo(Offset.zero);
+ await tester.pump(const Duration(milliseconds: 300));
+ await mouse.moveTo(tester.getCenter(find.byKey(ValueKey(key))));
+ await tester.pump(const Duration(milliseconds: 499));
+ // The first hint waits half a second; adjacent hints may use
+ // Flutter's immediate follow-on behavior while exploring controls.
+ if (firstHover) expect(find.text(text), findsNothing);
+ firstHover = false;
+ await tester.pump(const Duration(milliseconds: 1));
+ await tester.pump(const Duration(milliseconds: 200));
+ expect(find.text(text), findsOneWidget);
+ }
+ }
+ expect(pane.session, same(session));
+ expect(FocusManager.instance.primaryFocus, same(focus));
+ expect(input, isEmpty);
+ }
+
+ await checkHints('Search harnesses · ⌘P', 'Explore Harness Store · ⌘S');
+ map.apply('''{"bindings":[
+ {"keys":"cmd+p","command":null},
+ {"keys":"cmd+s","command":null},
+ {"keys":"cmd+k","command":"harnesses.list"},
+ {"keys":"cmd+shift+s","command":"app.store"}
+ ]}''');
+ await tester.pump();
+ await checkHints(
+ 'Search harnesses · ⌘K',
+ 'Explore Harness Store · ⇧⌘S',
+ );
+ map.apply('''{"bindings":[
+ {"keys":"cmd+p","command":null},
+ {"keys":"cmd+s","command":null}
+ ]}''');
+ await tester.pump();
+ await checkHints('Search harnesses', 'Explore Harness Store');
+ await mouse.removePointer();
+ await tester.pumpWidget(const SizedBox());
+ app.dispose();
+ map.dispose();
+ debugDefaultTargetPlatformOverride = null;
+ },
+ );
+
testWidgets(
'command and Add pickers keep editing ownership with session previews (native=$native)',
(tester) async {
diff --git a/desktop/test/shortcuts_test.dart b/desktop/test/shortcuts_test.dart
index 784883875..76edda7bb 100644
--- a/desktop/test/shortcuts_test.dart
+++ b/desktop/test/shortcuts_test.dart
@@ -241,7 +241,7 @@ void main() {
expect(chordsFor(ShortcutAction.movePaneRight), ['⇧⌘→']);
});
- test('brackets walk agents, and Shift walks swarms', () {
+ test('brackets walk agents, and Shift walks tabs', () {
// They used to carry three verbs told apart only by modifiers: ⌘[ ] walked
// panes, ⇧⌘[ ] walked agents, ⌥⌘[ ] moved panes. Panes use arrows, so
// the brackets keep the one job a bracket is good at.
@@ -298,7 +298,7 @@ void main() {
['⌘', '→'],
]);
- final next = rows.firstWhere((row) => row.label == 'Next Swarm');
+ final next = rows.firstWhere((row) => row.label == 'Next Tab');
expect(next.chords, [
['⇧', '⌘', ']'],
['⌃', '⇥'],
@@ -319,7 +319,7 @@ void main() {
test('the digits are one row, at the end of their own group', () {
final rows = shortcutRows();
- final digits = rows.indexWhere((row) => row.label == 'Select swarms 1–9');
+ final digits = rows.indexWhere((row) => row.label == 'Select tabs 1–9');
expect(digits, isNot(-1));
expect(rows[digits].chords, [
['⌘', '1 – 9'],
diff --git a/desktop/test/status_menu_test.dart b/desktop/test/status_menu_test.dart
new file mode 100644
index 000000000..3e17bed7f
--- /dev/null
+++ b/desktop/test/status_menu_test.dart
@@ -0,0 +1,171 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:harness/notify/alert_sounds.dart';
+import 'package:harness/state/notification_inbox.dart';
+import 'package:harness/state/status_menu.dart';
+
+import 'swarm_attention_test.dart' show waitingQuestion;
+import 'swarm_screen_test.dart' show mount, terminal;
+import 'swarm_state_test.dart' show createApp;
+
+void main() {
+ test('lists every unread harness and excludes recent sessions without notifications', () {
+ final app = createApp(connected: true);
+ addTearDown(app.dispose);
+ for (var i = 0; i < 30; i++) {
+ app.rememberOpenedHarness('m', 'a$i');
+ if (i >= 10) app.agentUnread.mark('m', 'a$i', AlertKind.done);
+ }
+ final entries = statusMenuEntries(app);
+ expect(entries, hasLength(20));
+ expect(entries.every((r) => r['unread'] == true), isTrue);
+ expect(entries.any((r) => r['agentId'] == 'a0'), isFalse);
+ expect(entries.map((r) => r['agentId']).toSet(), hasLength(entries.length));
+ expect(entries.first['agentId'], 'a29');
+ expect(entries.first['project'], 'No Project');
+ expect(entries.first['machineName'], 'Test host');
+ expect(entries.first['unavailable'], isNull);
+ app.stateOf('m')!.nodeOnline = false;
+ expect(statusMenuEntries(app).first['unavailable'], 'Offline');
+ clearStatusMenuNotifications(app, entries);
+ expect(
+ statusMenuEntries(app),
+ isEmpty,
+ reason: 'read conversations never fill an empty notification menu',
+ );
+ });
+
+ test(
+ 'clear acknowledges displayed news, never answers or clears newer news',
+ () {
+ final app = createApp(connected: true);
+ addTearDown(app.dispose);
+ final machine = app.stateOf('m')!;
+ app.agentUnread.mark('m', 'a0', AlertKind.done);
+ machine.blockedAgents['a1'] = waitingQuestion('a1');
+ app.agentUnread.mark('m', 'a1', AlertKind.needsYou);
+ app.rememberOpenedHarness('m', 'a2');
+ machine.blockedAgents['a2'] = waitingQuestion('a2', requestId: 'old');
+ final displayed = statusMenuEntries(app);
+ expect(displayed.where((r) => r['unread'] == true), hasLength(3));
+
+ app.agentUnread.mark('m', 'a0', AlertKind.done, fresh: true);
+ app.agentUnread.mark('m', 'a3', AlertKind.failed);
+ machine.blockedAgents['a2'] = waitingQuestion('a2', requestId: 'new');
+ clearStatusMenuNotifications(app, displayed);
+
+ expect(notificationInbox(app).map((r) => r.agentId).toSet(), {
+ 'a0',
+ 'a2',
+ 'a3',
+ });
+ expect(app.questionFor('m', 'a1'), isNotNull);
+ expect(app.questionNotificationRead('m', 'a1'), isTrue);
+ clearStatusMenuNotifications(app, statusMenuEntries(app));
+ expect(notificationInbox(app), isEmpty);
+ expect(machine.blockedAgents.keys, containsAll(['a1', 'a2']));
+ },
+ );
+
+ testWidgets(
+ 'native menu reuses panes, rejects stale clicks and clears its snapshot',
+ (tester) async {
+ const channel = MethodChannel('harness/swarm_tabs');
+ const windowChannel = MethodChannel('window_manager');
+ final updates = <Map>[];
+ final windowActions = <String>[];
+ final messenger = tester.binding.defaultBinaryMessenger;
+ messenger.setMockMethodCallHandler(channel, (call) async {
+ if (call.method == 'update') updates.add(call.arguments as Map);
+ return true;
+ });
+ addTearDown(() => messenger.setMockMethodCallHandler(channel, null));
+ messenger.setMockMethodCallHandler(windowChannel, (call) async {
+ windowActions.add(call.method);
+ return call.method == 'isMinimized' ? true : null;
+ });
+ addTearDown(
+ () => messenger.setMockMethodCallHandler(windowChannel, null),
+ );
+ final app = createApp(connected: true)..watchedAgents = () => const [];
+ final resultTab = app.activeSwarmId;
+ final result = app.adoptSessionForTest(terminal('a8', []));
+ app.newSwarm(name: 'Desktop');
+ app.adoptSessionForTest(terminal('a0', []));
+ final originalTab = app.activeSwarmId;
+ app.agentUnread.mark('m', 'a8', AlertKind.done);
+ app.stateOf('m')!.blockedAgents['a9'] = waitingQuestion('a9');
+ app.agentUnread.mark('m', 'a9', AlertKind.needsYou);
+ await mount(tester, app, nativeTabs: true);
+ await tester.pumpAndSettle();
+ List<Map> rows() =>
+ (updates.last['statusMenuEntries'] as List).cast<Map>();
+ Future<void> select(String method, Map args) async {
+ final done = Completer<void>();
+ messenger.handlePlatformMessage(
+ channel.name,
+ const StandardMethodCodec().encodeMethodCall(
+ MethodCall(method, args),
+ ),
+ (_) => done.complete(),
+ );
+ // Native focus handoff replies after the destination's next frame.
+ for (var i = 0; i < 8 && !done.isCompleted; i++) {
+ await tester.pump(const Duration(milliseconds: 50));
+ }
+ await tester.pumpAndSettle();
+ expect(done.isCompleted, isTrue);
+ }
+
+ expect(
+ find.byKey(const ValueKey('workspace-notifications-button')),
+ findsNothing,
+ );
+ expect(rows(), hasLength(2));
+ expect(updates.last['unread'], rows().length);
+ final stale = rows().singleWhere((r) => r['agentId'] == 'a8');
+ app.agentUnread.mark('m', 'a8', AlertKind.failed, fresh: true);
+ await tester.pump();
+ await select('openStatusHarness', stale);
+ expect(app.activeSwarmId, originalTab);
+ expect(app.agentUnread.kindFor('m', 'a8'), AlertKind.failed);
+
+ await select(
+ 'openStatusHarness',
+ rows().singleWhere((r) => r['agentId'] == 'a8'),
+ );
+ expect(app.activeSwarmId, resultTab);
+ expect(app.focusedPane, same(result));
+ expect(app.allPanes.where((p) => p.agentId == 'a8'), hasLength(1));
+ expect(app.agentUnread.kindFor('m', 'a8'), isNull);
+ expect(rows().single['agentId'], 'a9');
+ expect(updates.last['unread'], 1);
+ expect(
+ windowActions,
+ containsAllInOrder(['isMinimized', 'restore', 'show', 'focus']),
+ );
+
+ final displayed = rows();
+ app.agentUnread.mark('m', 'a7', AlertKind.done);
+ await tester.pump();
+ await select('clearStatusNotifications', {'receipts': displayed});
+ expect(app.questionFor('m', 'a9'), isNotNull);
+ expect(app.questionNotificationRead('m', 'a9'), isTrue);
+ expect(notificationInbox(app).single.agentId, 'a7');
+ expect(rows().single['agentId'], 'a7');
+ expect(app.focusedPane, same(result), reason: 'clearing never navigates');
+ await select('clearStatusNotifications', {'receipts': rows()});
+ expect(rows(), isEmpty);
+ expect(updates.last['unread'], 0);
+
+ await tester.pump(const Duration(milliseconds: 350));
+ await tester.pumpWidget(const SizedBox());
+ expect(updates.last['enabled'], isFalse);
+ expect(updates.last['statusMenuEntries'], isNull);
+ app.dispose();
+ },
+ );
+}
diff --git a/desktop/test/store_open_draft_test.dart b/desktop/test/store_open_draft_test.dart
index f8940148d..c3ffce51d 100644
--- a/desktop/test/store_open_draft_test.dart
+++ b/desktop/test/store_open_draft_test.dart
@@ -63,7 +63,7 @@ void main() {
findsOneWidget,
reason: 'New Harness is open',
);
- expect(app.swarms.length, tabsBefore + 1, reason: 'in a new swarm');
+ expect(app.swarms.length, tabsBefore + 1, reason: 'in a new tab');
await tester.sendKeyEvent(LogicalKeyboardKey.escape);
await tester.pumpAndSettle();
diff --git a/desktop/test/swarm_add_agent_test.dart b/desktop/test/swarm_add_agent_test.dart
index 90814bd51..f0d79eada 100644
--- a/desktop/test/swarm_add_agent_test.dart
+++ b/desktop/test/swarm_add_agent_test.dart
@@ -97,7 +97,7 @@ void main() {
}
test(
- 'adding a group uses this swarm, skips duplicates and keeps the source',
+ 'adding a group uses this tab, skips duplicates and keeps the source',
() async {
final app = createApp();
addTearDown(app.dispose);
diff --git a/desktop/test/swarm_canvas_test.dart b/desktop/test/swarm_canvas_test.dart
index 38538dd30..30b74e63e 100644
--- a/desktop/test/swarm_canvas_test.dart
+++ b/desktop/test/swarm_canvas_test.dart
@@ -105,7 +105,7 @@ void main() {
);
testWidgets(
- 'both scroll positions restore on the first frame across different Swarm sizes',
+ 'both scroll positions restore on the first frame across different Tab sizes',
(tester) async {
final app = createApp();
app.machineStates['m']!.nodeOnline = true;
diff --git a/desktop/test/swarm_closed_agents_test.dart b/desktop/test/swarm_closed_agents_test.dart
index 0b626d1a8..671e7b2c3 100644
--- a/desktop/test/swarm_closed_agents_test.dart
+++ b/desktop/test/swarm_closed_agents_test.dart
@@ -17,7 +17,7 @@ import 'swarm_state_test.dart' show createApp, MemoryStore;
void main() {
test(
- 'History interleaves closed agents and swarms with captured identities',
+ 'History interleaves closed agents and tabs with captured identities',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -87,7 +87,7 @@ void main() {
);
test(
- 'a closed parent gets a swarm when its agent alone is reopened',
+ 'a closed parent gets a tab when its agent alone is reopened',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -114,7 +114,7 @@ void main() {
},
);
- test('swarm recovery keeps newer choices and shared live sessions', () async {
+ test('tab recovery keeps newer choices and shared live sessions', () async {
final store = MemoryStore();
final app = createApp(store: store);
addTearDown(app.dispose);
@@ -177,7 +177,7 @@ void main() {
});
test(
- 'swarm recovery fits among many tabs without duplicating agents',
+ 'tab recovery fits among many tabs without duplicating agents',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -206,7 +206,7 @@ void main() {
);
test(
- 'a full partial swarm keeps its recovery until every view fits',
+ 'a full partial tab keeps its recovery until every view fits',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -382,7 +382,7 @@ void main() {
app.dispose();
});
- testWidgets('keyboard swarm recovery returns input to its existing view', (
+ testWidgets('keyboard tab recovery returns input to its existing view', (
tester,
) async {
final app = createApp();
diff --git a/desktop/test/swarm_entry_picker_test.dart b/desktop/test/swarm_entry_picker_test.dart
index e554b9b8a..9c41e4ccf 100644
--- a/desktop/test/swarm_entry_picker_test.dart
+++ b/desktop/test/swarm_entry_picker_test.dart
@@ -80,7 +80,7 @@ void main() {
findsOneWidget,
);
expect(
- find.descendant(of: selected, matching: find.text('Add to this swarm')),
+ find.descendant(of: selected, matching: find.text('Add to this tab')),
findsOneWidget,
);
await tester.sendKeyEvent(LogicalKeyboardKey.enter);
diff --git a/desktop/test/swarm_history_test.dart b/desktop/test/swarm_history_test.dart
index 51cd00bdf..4696f58a8 100644
--- a/desktop/test/swarm_history_test.dart
+++ b/desktop/test/swarm_history_test.dart
@@ -109,7 +109,7 @@ void main() {
});
test(
- 'swarm History counts distinct machines, including offline and closed work',
+ 'tab History counts distinct machines, including offline and closed work',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -338,7 +338,7 @@ void main() {
});
test(
- 'a chosen closed Swarm restores independently and stale tokens stay inert',
+ 'a chosen closed Tab restores independently and stale tokens stay inert',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -381,13 +381,13 @@ void main() {
const Agent(id: 'a0', name: 'Renamed agent', terminalAvailable: true),
const Agent(id: 'a1', name: 'Agent 1', terminalAvailable: true),
];
- app.renameSwarm(app.activeSwarmId, 'Renamed Swarm');
+ app.renameSwarm(app.activeSwarmId, 'Renamed Tab');
final renamed = history.menuDestinations(app);
expect(
renamed.firstWhere((e) => e.agentId == 'a0').title,
'Renamed agent',
);
- expect(renamed.firstWhere((e) => e.isSwarm).title, 'Renamed Swarm');
+ expect(renamed.firstWhere((e) => e.isSwarm).title, 'Renamed Tab');
app.machineStates['m']!.nodeOnline = false;
expect(history.menuDestinations(app).first.detail, contains('Offline'));
await app.closePane(first.id);
diff --git a/desktop/test/swarm_immediate_input_test.dart b/desktop/test/swarm_immediate_input_test.dart
index 0a27c6366..5c7227197 100644
--- a/desktop/test/swarm_immediate_input_test.dart
+++ b/desktop/test/swarm_immediate_input_test.dart
@@ -36,7 +36,7 @@ void main() {
'close pane',
if (nativeEntry) 'close pane menu',
'close tab',
- 'new swarm',
+ 'new tab',
]) {
testWidgets(
'$action owns immediate input before a frame (native=$nativeEntry)',
@@ -106,7 +106,7 @@ void main() {
}
await tester.pump(const Duration(milliseconds: 10));
expect(secondInput, isEmpty, reason: 'The old agent owns no input');
- if (action == 'new swarm') {
+ if (action == 'new tab') {
expect(app.panes, isEmpty);
expect(app.swarms.first.panes, [first, second]);
expect(app.swarms, hasLength(2));
diff --git a/desktop/test/swarm_interactions_test.dart b/desktop/test/swarm_interactions_test.dart
index 6a75626ff..6ddbb2dd9 100644
--- a/desktop/test/swarm_interactions_test.dart
+++ b/desktop/test/swarm_interactions_test.dart
@@ -446,7 +446,7 @@ void main() {
},
);
- testWidgets('native Swarm commands cannot mutate the view behind Settings', (
+ testWidgets('native Tab commands cannot mutate the view behind Settings', (
tester,
) async {
const channel = MethodChannel('harness/swarm_tabs');
diff --git a/desktop/test/swarm_navigation_test.dart b/desktop/test/swarm_navigation_test.dart
index 2e26b45e9..775566076 100644
--- a/desktop/test/swarm_navigation_test.dart
+++ b/desktop/test/swarm_navigation_test.dart
@@ -338,7 +338,7 @@ void main() {
);
}
- test('opening a swarm restores its saved focus and zoom', () async {
+ test('opening a tab restores its saved focus and zoom', () async {
final app = createApp();
addTearDown(app.dispose);
app.adoptSessionForTest(terminal('a0', []));
diff --git a/desktop/test/swarm_navigator_test.dart b/desktop/test/swarm_navigator_test.dart
index aa9db3293..2df3d7861 100644
--- a/desktop/test/swarm_navigator_test.dart
+++ b/desktop/test/swarm_navigator_test.dart
@@ -40,7 +40,7 @@ void main() {
expect(
app.activeSwarmId,
second.id,
- reason: 'The active swarm also contains this harness',
+ reason: 'The active tab also contains this harness',
);
expect(app.focusedPane, same(pane));
expect(first.panes, [pane]);
@@ -66,7 +66,7 @@ void main() {
expect(search.submit(), isNull);
});
- test('location search uses only its own swarm context and output reuses the catalog', () async {
+ test('location search uses only its own tab context and output reuses the catalog', () async {
final app = createApp();
addTearDown(app.dispose);
final session = terminal('a0', []);
diff --git a/desktop/test/swarm_reopen_test.dart b/desktop/test/swarm_reopen_test.dart
index 716a00fb3..7e6326169 100644
--- a/desktop/test/swarm_reopen_test.dart
+++ b/desktop/test/swarm_reopen_test.dart
@@ -24,7 +24,7 @@ class _NoopLogin extends CliLogin {
}
void main() {
- test('recently closed agents and swarms do not survive sign-out', () async {
+ test('recently closed agents and tabs do not survive sign-out', () async {
final login = _NoopLogin();
final app = AppNotifier(
config: AppConfig.dev,
diff --git a/desktop/test/swarm_screen_test.dart b/desktop/test/swarm_screen_test.dart
index b9c9179b2..7de4a187f 100644
--- a/desktop/test/swarm_screen_test.dart
+++ b/desktop/test/swarm_screen_test.dart
@@ -757,7 +757,7 @@ void main() {
);
testWidgets(
- 'attention shortcut opens current questions in Harnesses and their originating swarm',
+ 'attention shortcut opens current questions in Harnesses and their originating tab',
(tester) async {
final app = createApp();
app.machineStates['m']!
diff --git a/desktop/test/swarm_search_identity_test.dart b/desktop/test/swarm_search_identity_test.dart
index 83d82eb6e..fad7cdab2 100644
--- a/desktop/test/swarm_search_identity_test.dart
+++ b/desktop/test/swarm_search_identity_test.dart
@@ -279,7 +279,7 @@ void main() {
var rows = cache.read(app, []);
expect(
rows.singleWhere((row) => row.isSwarm).detail,
- 'Swarm · 2 harnesses · 1 project · 2 machines',
+ 'Tab · 2 harnesses · 1 project · 2 machines',
);
expect(rows.where((row) => row.agentId == 'a0'), hasLength(2));
expect(rows.singleWhere((row) => row.isSwarm).title, 'Release work');
@@ -287,7 +287,7 @@ void main() {
rows = cache.read(app, []);
expect(
rows.singleWhere((row) => row.isSwarm).detail,
- 'Swarm · 3 harnesses · 2 projects · 2 machines',
+ 'Tab · 3 harnesses · 2 projects · 2 machines',
);
app.newSwarm();
@@ -335,11 +335,11 @@ void main() {
final cache = SwarmSearchCatalog();
expect(
cache.read(app, projects).singleWhere((row) => row.isSwarm).detail,
- 'Swarm · 2 harnesses · 1 project · 1 machine',
+ 'Tab · 2 harnesses · 1 project · 1 machine',
);
expect(
cache.read(app, []).singleWhere((row) => row.isSwarm).detail,
- 'Swarm · 2 harnesses · 1 machine',
+ 'Tab · 2 harnesses · 1 machine',
);
},
);
diff --git a/desktop/test/swarm_search_render_test.dart b/desktop/test/swarm_search_render_test.dart
index ee652efb3..8ae145a23 100644
--- a/desktop/test/swarm_search_render_test.dart
+++ b/desktop/test/swarm_search_render_test.dart
@@ -91,7 +91,7 @@ void main() {
...machine.agents.where((agent) => agent.id != original.id),
];
machine.nodeOnline = false;
- app.renameSwarm(source.id, 'Renamed swarm');
+ app.renameSwarm(source.id, 'Renamed tab');
await tester.pump();
await open();
await tester.enterText(field, 'after-branch');
@@ -114,7 +114,7 @@ void main() {
});
expect(
rows.singleWhere((row) => row.swarmId == source.id).swarmName,
- 'Renamed swarm',
+ 'Renamed tab',
);
}
await tester.enterText(field, 'before-branch');
diff --git a/desktop/test/swarm_search_test.dart b/desktop/test/swarm_search_test.dart
index 1b6c028f5..75c35bd85 100644
--- a/desktop/test/swarm_search_test.dart
+++ b/desktop/test/swarm_search_test.dart
@@ -161,7 +161,7 @@ void main() {
});
test(
- 'Add here reuses the exact terminal and refuses a closed destination swarm',
+ 'Add here reuses the exact terminal and refuses a closed destination tab',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -201,7 +201,7 @@ void main() {
);
test(
- 'a machine result opens its agents in the empty swarm and reuses it',
+ 'a machine result opens its agents in the empty tab and reuses it',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -244,7 +244,7 @@ void main() {
);
test(
- 'opening a group from an occupied swarm keeps its work intact',
+ 'opening a group from an occupied tab keeps its work intact',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -272,7 +272,7 @@ void main() {
);
test(
- 'removed group members and oversized groups cannot create a partial swarm',
+ 'removed group members and oversized groups cannot create a partial tab',
() async {
final app = createApp();
addTearDown(app.dispose);
diff --git a/desktop/test/swarm_state_test.dart b/desktop/test/swarm_state_test.dart
index 473a04773..0e251acef 100644
--- a/desktop/test/swarm_state_test.dart
+++ b/desktop/test/swarm_state_test.dart
@@ -130,6 +130,7 @@ void main() {
}
for (final legacy in [
+ 'New Swarm',
'New swarm',
'New Tab',
'New tab',
@@ -165,40 +166,36 @@ void main() {
);
}
- test(
- 'explicit names matching an old placeholder survive a restore',
- () async {
+ for (final customName in ['New Tab', 'New Swarm']) {
+ test('explicit name $customName survives a restore', () async {
final store = MemoryStore();
final original = createApp(store: store);
- original.renameSwarm(original.activeSwarmId, 'New Tab');
+ original.renameSwarm(original.activeSwarmId, customName);
await original.flushPaneLayout();
original.dispose();
final restored = createApp(store: store);
addTearDown(restored.dispose);
await restored.restorePaneLayoutForTest();
- expect(restored.activeSwarm.name, 'New Tab');
+ expect(restored.activeSwarm.name, customName);
expect(restored.activeSwarm.nameIsCustom, isTrue);
- },
- );
+ });
+ }
- test(
- 'first agent names a swarm and survives closing and reopening',
- () async {
- final app = createApp();
- addTearDown(app.dispose);
- await app.addAgentToSwarm('m', 'a0');
- expect(app.activeSwarm.name, 'Agent 0');
- await app.addAgentToSwarm('m', 'a1');
- expect(app.activeSwarm.name, 'Agent 0');
- expect(app.activeSwarm.toJson()['name'], 'Agent 0');
- await app.closeSwarm(app.activeSwarmId);
- app.reopenClosedSwarm();
- expect(app.activeSwarm.name, 'Agent 0');
- },
- );
+ test('first agent names a tab and survives closing and reopening', () async {
+ final app = createApp();
+ addTearDown(app.dispose);
+ await app.addAgentToSwarm('m', 'a0');
+ expect(app.activeSwarm.name, 'Agent 0');
+ await app.addAgentToSwarm('m', 'a1');
+ expect(app.activeSwarm.name, 'Agent 0');
+ expect(app.activeSwarm.toJson()['name'], 'Agent 0');
+ await app.closeSwarm(app.activeSwarmId);
+ app.reopenClosedSwarm();
+ expect(app.activeSwarm.name, 'Agent 0');
+ });
test(
- 'first agent preserves custom names and names the requested swarm',
+ 'first agent preserves custom names and names the requested tab',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -275,7 +272,7 @@ void main() {
},
);
- test('replacement and pinning cannot change another swarm', () async {
+ test('replacement and pinning cannot change another tab', () async {
final app = createApp();
await app.addAgentToSwarm('m', 'a0');
await app.addAgentToSwarm('m', 'a1');
@@ -324,14 +321,14 @@ void main() {
for (var i = 0; i < 70; i++) (machineId: 'm', agentId: 'a$i'),
]);
expect(app.panes.length, AppNotifier.maxPanes);
- expect(app.lastError, contains('Open another swarm'));
+ expect(app.lastError, contains('Open another tab'));
expect(app.panes.first.agentId, 'a0');
app.dispose();
},
);
test(
- 'all swarm intent, focus, zoom and shared identity restore offline',
+ 'all tab intent, focus, zoom and shared identity restore offline',
() async {
final storage = MemoryStore();
final app = createApp(store: storage);
diff --git a/desktop/test/swarm_terminal_routing_test.dart b/desktop/test/swarm_terminal_routing_test.dart
index 903a02b55..be1b7dcb5 100644
--- a/desktop/test/swarm_terminal_routing_test.dart
+++ b/desktop/test/swarm_terminal_routing_test.dart
@@ -105,7 +105,7 @@ void main() {
);
test(
- 'reordering swarms between incoming frames preserves stream order',
+ 'reordering tabs between incoming frames preserves stream order',
() async {
final app = createApp();
addTearDown(app.dispose);
diff --git a/desktop/test/terminal_initial_output_test.dart b/desktop/test/terminal_initial_output_test.dart
index 16de77f98..2e877145f 100644
--- a/desktop/test/terminal_initial_output_test.dart
+++ b/desktop/test/terminal_initial_output_test.dart
@@ -154,7 +154,7 @@ void main() {
);
}
testWidgets(
- 'a fresh hidden terminal follows its keyframe when its swarm is opened',
+ 'a fresh hidden terminal follows its keyframe when its tab is opened',
(tester) async {
final app = createApp();
final session = terminal('a0', []);
diff --git a/desktop/test/terminal_panel_activity_test.dart b/desktop/test/terminal_panel_activity_test.dart
index c9302ef46..1a20bd9a2 100644
--- a/desktop/test/terminal_panel_activity_test.dart
+++ b/desktop/test/terminal_panel_activity_test.dart
@@ -9,7 +9,7 @@ import 'swarm_screen_test.dart' show terminal;
import 'swarm_state_test.dart' show createApp;
void main() {
- testWidgets('retained Swarms run only the focused terminal cursor clock', (
+ testWidgets('retained Tabs run only the focused terminal cursor clock', (
tester,
) async {
final probe = PeriodicTimerProbe();
diff --git a/desktop/test/web/browser_workspace_test.dart b/desktop/test/web/browser_workspace_test.dart
index ef5a268a4..44b5e7237 100644
--- a/desktop/test/web/browser_workspace_test.dart
+++ b/desktop/test/web/browser_workspace_test.dart
@@ -278,7 +278,7 @@ void main() {
await tester.pump(const Duration(milliseconds: 200));
expect(find.byKey(const ValueKey('swarm-search-input')), findsOneWidget);
expect(find.textContaining('No harnesses yet.'), findsOneWidget);
- expect(find.textContaining('This swarm is full'), findsNothing);
+ expect(find.textContaining('This tab is full'), findsNothing);
expect(tester.takeException(), isNull);
tester.view.physicalSize = const Size(390, 844);
await tester.pump(const Duration(milliseconds: 100));
diff --git a/desktop/tool/check_swarm_titlebar.sh b/desktop/tool/check_swarm_titlebar.sh
index ac83022b1..1d26c5842 100644
--- a/desktop/tool/check_swarm_titlebar.sh
+++ b/desktop/tool/check_swarm_titlebar.sh
@@ -30,11 +30,14 @@ fi
if [[ "${2:-}" == "--status-preview" ]]; then
check_source="$desktop_dir/tool/status_theme_preview.swift"
fi
+if [[ "${2:-}" == "--status-menu" ]]; then
+ check_source="$desktop_dir/tool/status_menu_checks.swift"
+fi
cat "$desktop_dir/macos/Runner/HarnessKeymap.swift" > "$check_dir/main.swift"
# The title bar shares menu ordering with the window. Include that production
# helper without booting the Flutter window or its account/runtime services.
sed -n '/^enum HarnessAppMenu {/,$p' "$desktop_dir/macos/Runner/MainFlutterWindow.swift" >> "$check_dir/main.swift"
-cat "$desktop_dir/macos/Runner/SwarmTitlebar.swift" "$check_source" >> "$check_dir/main.swift"
+cat "$desktop_dir/macos/Runner/HarnessStatusMenu.swift" "$desktop_dir/macos/Runner/SwarmTitlebar.swift" "$check_source" >> "$check_dir/main.swift"
xcrun swiftc -swift-version 5 "${optimization[@]}" -module-cache-path "$check_dir/module-cache" \
-F "$framework_dir" -framework FlutterMacOS \
-Xlinker -rpath -Xlinker "$framework_dir" \
diff --git a/desktop/tool/history_menu_checks.swift b/desktop/tool/history_menu_checks.swift
index f4baefe61..e6c3394a7 100644
--- a/desktop/tool/history_menu_checks.swift
+++ b/desktop/tool/history_menu_checks.swift
@@ -163,7 +163,7 @@ let historyCheckWindow = NSWindow(contentRect: NSRect(x: 0, y: 0, width: 1280, h
styleMask: [.titled, .closable, .resizable], backing: .buffered, defer: false)
historyCheckWindow.isReleasedWhenClosed = false
private let historyCheckMessenger = HistoryCheckMessenger()
-let historyCheckTitlebar = SwarmTitlebar(window: historyCheckWindow, messenger: historyCheckMessenger)
+let historyCheckTitlebar = SwarmTitlebar(window: historyCheckWindow, messenger: historyCheckMessenger, installStatusItem: false)
do {
if CommandLine.arguments.contains("--history-performance") {
try historyCheckTitlebar.benchmarkHistoryUpdates()
diff --git a/desktop/tool/status_menu_checks.swift b/desktop/tool/status_menu_checks.swift
new file mode 100644
index 000000000..7553b099e
--- /dev/null
+++ b/desktop/tool/status_menu_checks.swift
@@ -0,0 +1,137 @@
+// Appended to the production AppKit source by check_swarm_titlebar.sh --status-menu.
+private struct StatusMenuFailure: Error { let message: String }
+private var checks = 0
+private func check(_ value: @autoclosure () -> Bool, _ message: String) throws {
+ guard value() else { throw StatusMenuFailure(message: message) }
+ checks += 1
+}
+
+private func renderedStatusPixels(_ image: NSImage) -> Data {
+ let bitmap = NSBitmapImageRep(bitmapDataPlanes: nil,
+ pixelsWide: Int(image.size.width * 2), pixelsHigh: Int(image.size.height * 2),
+ bitsPerSample: 8, samplesPerPixel: 4, hasAlpha: true, isPlanar: false,
+ colorSpaceName: .deviceRGB, bytesPerRow: 0, bitsPerPixel: 0)!
+ bitmap.size = image.size
+ NSGraphicsContext.saveGraphicsState()
+ NSGraphicsContext.current = NSGraphicsContext(bitmapImageRep: bitmap)
+ image.draw(in: NSRect(origin: .zero, size: image.size), from: .zero, operation: .copy, fraction: 1)
+ NSGraphicsContext.restoreGraphicsState()
+ return Data(bytes: bitmap.bitmapData!, count: bitmap.bytesPerRow * bitmap.pixelsHigh)
+}
+
+private func fixture(_ agent: String, project: String = "autonomous-harness",
+ unread: Bool = true, token: String = "first", offline: Bool = false) -> [String: Any] {
+ var row: [String: Any] = ["machineId": "office", "machineName": "Office Mac",
+ "agentId": agent, "title": agent, "project": project, "unread": unread,
+ "detail": "Office Mac · \(project)"]
+ if unread { row["readToken"] = token; row["label"] = "Finished" }
+ if offline { row["unavailable"] = "Offline" }
+ return row
+}
+
+private extension HarnessStatusMenu {
+ func item(_ action: String) -> NSMenuItem {
+ menu.items.first { $0.identifier?.rawValue == action }!
+ }
+ func row(_ agent: String) -> NSMenuItem {
+ menu.items.first { ($0.representedObject as? [String: Any])?["agentId"] as? String == agent }!
+ }
+ func click(_ item: NSMenuItem) { menu.performActionForItem(at: menu.index(of: item)) }
+}
+
+_ = NSApplication.shared
+var emitted: [(String, Any?)] = []
+var reveals = 0
+let status = HarnessStatusMenu(installStatusItem: false, showWindow: { reveals += 1 },
+ emit: { emitted.append(($0, $1)) })
+do {
+ var rows = [fixture("General chat conversation"),
+ fixture("DeepSeek model", project: "No Project", unread: false),
+ fixture("Math addition inquiry", project: "No Project", offline: true)]
+ status.update(["enabled": true, "statusMenuEntries": rows])
+ try check(status.menu.items.filter { $0.state == .on }.count == 2, "Unread rows have dots")
+ try check(status.row("General chat conversation").onStateImage != nil, "A blue dot replaces the checkmark")
+ try check(status.menu.items.contains { $0.title == "No Project" && !$0.isEnabled }, "Projects use native section headings")
+ try check(!status.row("Math addition inquiry").isEnabled, "Offline conversations stay visible but disabled")
+ try check(status.row("Math addition inquiry").toolTip?.contains("Offline") == true, "Unavailable state is explained")
+ try check(!status.menu.items.contains { $0.title == "DeepSeek model" }, "Read conversations are absent from the notification menu")
+ status.click(status.row("General chat conversation"))
+ try check(emitted.last?.0 == "openStatusHarness" && reveals == 0, "Navigation is sent before revealing the window")
+ status.click(status.item("newAgent"))
+ status.click(status.item("settings"))
+ try check(emitted.suffix(2).map { $0.0 } == ["newAgent", "settings"] && reveals == 2,
+ "New Harness and Settings reveal the window and reuse existing actions")
+
+ status.menuWillOpen(status.menu)
+ let selected = status.row("General chat conversation")
+ let before = emitted.count
+ rows[0] = fixture("General chat conversation", token: "newer")
+ rows.append(fixture("New result", project: "website"))
+ status.update(["enabled": true, "statusMenuEntries": rows])
+ try check(status.row("General chat conversation") === selected &&
+ !status.menu.items.contains { $0.title == "website" }, "Arrivals do not move open-menu rows")
+ status.click(selected)
+ try check(emitted.count == before, "A replaced notification cannot dispatch an old click")
+ status.click(status.item("clearStatusNotifications"))
+ let receipt = emitted.last?.1 as? [String: Any]
+ let cleared = receipt?["receipts"] as? [[String: Any]]
+ try check(emitted.last?.0 == "clearStatusNotifications" && cleared?.count == 2 &&
+ cleared?.first?["readToken"] as? String == "first", "Clear sends only displayed receipts, never new arrivals")
+ status.menuDidClose(status.menu)
+ status.menuNeedsUpdate(status.menu)
+ try check(status.menu.items.contains { $0.title == "website" }, "The next opening shows new arrivals")
+
+ status.update(["enabled": false, "statusMenuEntries": rows])
+ try check(!status.item("newAgent").isEnabled && !status.item("settings").isEnabled &&
+ !status.item("clearStatusNotifications").isEnabled, "A modal disables workspace actions")
+ status.click(status.item("openWindow"))
+ try check(reveals == 3, "Open Harness remains available during a modal")
+ status.update(["enabled": true, "statusMenuEntries": []])
+ try check(status.menu.items.first?.title == "No unread notifications" &&
+ !status.item("clearStatusNotifications").isEnabled, "An empty inbox is explicit and cannot be cleared")
+ status.update([:])
+ try check(!status.menu.items.contains { $0.identifier?.rawValue == "openStatusHarness" }, "Sign-out removes all conversation data")
+ try check(status.item("openWindow").isEnabled && status.item("quit").isEnabled,
+ "The signed-out menu still offers Open and Quit")
+ // Exercise the actual AppKit status button: the displayed number must agree
+ // with the notification rows, with a bare icon after the last read.
+ func checkCounter() throws {
+ let assets = URL(fileURLWithPath: ProcessInfo.processInfo.environment["HARNESS_TITLEBAR_ASSETS"]!)
+ let logo = NSImage(contentsOf: assets.deletingLastPathComponent().appendingPathComponent(
+ "macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/HarnessStatusIcon.svg"))
+ try check(logo != nil, "The menu bar template loads from the Harness artwork")
+ logo?.setName("HarnessStatusIcon")
+ let indicator = HarnessStatusMenu(showWindow: {}, emit: { _, _ in })
+ indicator.update(["enabled": true, "statusMenuEntries": rows])
+ try check(indicator.statusItem?.button?.title == "" &&
+ indicator.statusItem?.button?.image?.accessibilityDescription == "3 unread" &&
+ indicator.statusItem?.button?.image?.isTemplate == true &&
+ indicator.statusItem?.button?.accessibilityValue() as? String == "3 unread",
+ "The monochrome Harness template carries the count badge without a separate text label")
+ let unreadPixels = renderedStatusPixels(indicator.statusItem!.button!.image!)
+ indicator.update(["enabled": true, "statusMenuEntries": []])
+ try check(indicator.statusItem?.button?.image?.accessibilityDescription == "0 unread" &&
+ indicator.statusItem?.button?.toolTip == "Harness · 0 unread" &&
+ indicator.statusItem?.button?.accessibilityValue() as? String == "0 unread",
+ "An empty inbox keeps its exact count in the tooltip and accessibility value")
+ let zeroPixels = renderedStatusPixels(indicator.statusItem!.button!.image!)
+ let badgeSize = indicator.statusItem?.button?.image?.size
+ indicator.update(["enabled": true, "statusMenuEntries": (0..<101).map { fixture("Task \($0)") }])
+ try check(indicator.statusItem?.button?.image?.size == badgeSize &&
+ indicator.statusItem?.button?.accessibilityValue() as? String == "101 unread",
+ "Large counts keep the logo and badge footprint and expose the exact value to accessibility")
+ indicator.update([:])
+ try check(indicator.statusItem?.button?.image?.accessibilityDescription == "Harness",
+ "Sign-out clears the account's counter")
+ let plainPixels = renderedStatusPixels(indicator.statusItem!.button!.image!)
+ try check(zeroPixels == plainPixels,
+ "Zero notifications render only the plain icon, without a number or badge circle")
+ try check(unreadPixels != plainPixels,
+ "Unread notifications add a visible badge to the icon")
+ }
+ try checkCounter()
+ print("Harness status menu passed \(checks) checks")
+} catch {
+ fputs("Harness status menu failed: \(error)\n", stderr)
+ exit(1)
+}
diff --git a/desktop/tool/swarm_titlebar_checks.swift b/desktop/tool/swarm_titlebar_checks.swift
index 36734d629..800a4db12 100644
--- a/desktop/tool/swarm_titlebar_checks.swift
+++ b/desktop/tool/swarm_titlebar_checks.swift
@@ -77,6 +77,20 @@ private extension NSView {
}
}
+private func checkIconTooltipTracking() throws {
+ let button = SwarmIconButton(frame: NSRect(x: 0, y: 0, width: 40, height: 28))
+ button.toolTip = "Search harnesses · ⌘P"
+ let tooltipAreas = button.trackingAreas
+ try checkTitlebar(!tooltipAreas.isEmpty, "AppKit installs tooltip tracking for an icon button")
+ for _ in 0..<3 {
+ button.updateTrackingAreas()
+ try checkTitlebar(tooltipAreas.allSatisfy { area in button.trackingAreas.contains { $0 === area } },
+ "Updating icon hover preserves AppKit's tooltip tracking")
+ try checkTitlebar(button.trackingAreas.count == tooltipAreas.count + 1,
+ "Repeated layout keeps exactly one custom hover area")
+ }
+}
+
private extension SwarmTabStrip {
func checkActivityMarks() throws {
func payload(_ mark: String, _ label: String, working: Bool = false) -> [String: Any] {
@@ -1059,8 +1073,9 @@ private extension SwarmTabStrip {
"Workspace teardown hides the daemon")
}
- func checkNotifications() throws {
- var state: [String: Any] = ["enabled": true, "unread": 9,
+ func checkTopActions() throws {
+ var state: [String: Any] = ["enabled": true,
+ "searchTooltip": "Search harnesses · ⌘P", "storeTooltip": "Explore Harness Store · ⌘S",
"tabs": [["id": "work", "name": "Desktop"]], "activeId": "work",
"focusedContext": ["text": "Office project", "segments": [["text": "Office project"]]]]
var calls: [String] = []
@@ -1068,38 +1083,33 @@ private extension SwarmTabStrip {
for width in [CGFloat(360), CGFloat(640), CGFloat(1280)] {
setFrameSize(NSSize(width: width, height: 40))
update(state)
- try checkTitlebar(notificationsButton.isEnabled && notificationsButton.frame.width > 0 &&
- notificationsButton.frame.maxX <= bounds.width &&
- searchButton.frame.maxX <= notificationsButton.frame.minX &&
- notificationsButton.frame.maxX <= storeButton.frame.minX &&
+ try checkTitlebar(searchButton.isEnabled && searchButton.frame.width > 0 &&
+ searchButton.frame.maxX < storeButton.frame.minX &&
storeButton.frame.maxX <= bounds.width &&
newButton.frame.maxX < searchButton.frame.minX &&
contextButton.superview === statusBar,
- "Search, bell and Store stay visible after the tabs at width \(width)")
- let frame = notificationsButton.frame
- state["unread"] = 101
- update(state)
- try checkTitlebar(notificationsButton.frame == frame,
- "Unread count changes do not move the native toolbar")
+ "Search and Store stay adjacent after the tabs at width \(width)")
+ try checkTitlebar(!subviews.contains { $0.accessibilityLabel() == "Notifications" },
+ "Notifications live in the macOS menu bar, with no duplicate titlebar bell")
+ try checkTitlebar(searchButton.toolTip == state["searchTooltip"] as? String &&
+ searchButton.accessibilityHelp() == searchButton.toolTip &&
+ storeButton.toolTip == state["storeTooltip"] as? String &&
+ storeButton.accessibilityHelp() == storeButton.toolTip,
+ "Top actions retain supplied shortcut hints and accessible help after layout")
}
- try checkTitlebar(notificationsButton.accessibilityLabel() == "Notifications" &&
- notificationsButton.accessibilityValue() as? String == "101 unread",
- "The native bell exposes its exact count even when its badge reads 99+")
- notificationsButton.performClick(nil)
searchButton.performClick(nil)
storeButton.performClick(nil)
- try checkTitlebar(calls == ["notificationInbox", "sessions", "store"],
- "Top actions open the existing notifications, search and Store surfaces")
+ try checkTitlebar(calls == ["sessions", "store"],
+ "Top actions open the existing search and Store surfaces")
state["enabled"] = false
update(state)
- notificationsButton.performClick(nil)
searchButton.performClick(nil)
storeButton.performClick(nil)
- try checkTitlebar(!notificationsButton.isEnabled && !searchButton.isEnabled && !storeButton.isEnabled && calls.count == 3,
- "A modal prevents the bell from dispatching another action")
+ try checkTitlebar(!searchButton.isEnabled && !storeButton.isEnabled && calls.count == 2,
+ "A modal prevents toolbar actions")
update([:])
- try checkTitlebar(notificationsButton.count == 0 && !notificationsButton.isEnabled,
- "Teardown clears the unread badge and disables the bell")
+ try checkTitlebar(!searchButton.isEnabled && !storeButton.isEnabled,
+ "Teardown disables the toolbar")
}
func checkShareAction() throws {
@@ -1202,6 +1212,12 @@ private extension SwarmTabStrip {
func checkTabPresentationAndCapture() throws {
setFrameSize(NSSize(width: 900, height: 40))
+ if let root = ProcessInfo.processInfo.environment["HARNESS_TITLEBAR_ASSETS"] {
+ let assets = URL(fileURLWithPath: root)
+ storeButton.image = SwarmHistoryIcons(assetURL: { asset in
+ assets.appendingPathComponent(String(asset.dropFirst("assets/".count)))
+ }).image(engine: "store", asset: "assets/store/polymath.png")
+ }
let rows: [[String: Any]] = [
["id": "new", "name": "New Tab", "label": "New Tab", "shortcutHint": "⌘1"],
["id": "work", "name": "Desktop", "label": "Desktop", "shortcutHint": "⌘2",
@@ -1224,8 +1240,8 @@ private extension SwarmTabStrip {
let hover = NSEvent.mouseEvent(with: .mouseMoved, location: .zero, modifierFlags: [],
timestamp: 0, windowNumber: 0, context: nil, eventNumber: 0, clickCount: 0, pressure: 0)!
for (name, values) in [
- ("dark", ["workspace": Int64(0xff282828), "tabBar": Int64(0xff1c1c1c)]),
- ("light", ["workspace": Int64(0xfff0f2f5), "tabBar": Int64(0xffe4e6e9)]),
+ ("dark", ["workspace": Int64(0xff282828), "tabBar": Int64(0xff1c1c1c), "accent": Int64(0xffbdcbdc)]),
+ ("light", ["workspace": Int64(0xfff0f2f5), "tabBar": Int64(0xffe4e6e9), "accent": Int64(0xff3d5a8a)]),
] {
statusChanged["palette"] = values
update(statusChanged)
@@ -1255,8 +1271,8 @@ private extension SwarmTabStrip {
}
setFrameSize(NSSize(width: 1440, height: 40))
for (name, values) in [
- ("dark", ["workspace": Int64(0xff282828), "tabBar": Int64(0xff1c1c1c)]),
- ("light", ["workspace": Int64(0xfff0f2f5), "tabBar": Int64(0xffe4e6e9)]),
+ ("dark", ["workspace": Int64(0xff282828), "tabBar": Int64(0xff1c1c1c), "accent": Int64(0xffbdcbdc)]),
+ ("light", ["workspace": Int64(0xfff0f2f5), "tabBar": Int64(0xffe4e6e9), "accent": Int64(0xff3d5a8a)]),
] {
update(["enabled": true, "activeId": "dense-1", "tabs": crowdedRows, "palette": values])
try captureTabPresentation("native-tabs-eight-\(name)-rest")
@@ -1295,12 +1311,14 @@ private extension SwarmTabStrip {
tab.drawWithHoverControl()
NSGraphicsContext.restoreGraphicsState()
}
- NSGraphicsContext.saveGraphicsState()
- let transform = NSAffineTransform()
- transform.translateX(by: newButton.frame.minX, yBy: newButton.frame.minY + 40)
- transform.concat()
- newButton.draw(newButton.bounds)
- NSGraphicsContext.restoreGraphicsState()
+ for control in [newButton, searchButton, storeButton] {
+ NSGraphicsContext.saveGraphicsState()
+ let transform = NSAffineTransform()
+ transform.translateX(by: control.frame.minX, yBy: control.frame.minY + 40)
+ transform.concat()
+ control.draw(control.bounds)
+ NSGraphicsContext.restoreGraphicsState()
+ }
NSGraphicsContext.restoreGraphicsState()
let destination = URL(fileURLWithPath: directory)
try FileManager.default.createDirectory(at: destination, withIntermediateDirectories: true)
@@ -1340,7 +1358,7 @@ private extension SwarmTabStrip {
}
func runChecks() throws {
- let rows = (0..<24).map { ["id": "swarm-\($0)", "name": "Swarm \($0)", "label": "\($0 + 1):code"] }
+ let rows = (0..<24).map { ["id": "swarm-\($0)", "name": "Tab \($0)", "label": "\($0 + 1):code"] }
var events: [String] = []
emit = { method, _ in events.append(method) }
func state(_ rows: [[String: String]], active: String, enabled: Bool = true) -> [String: Any] {
@@ -1521,10 +1539,10 @@ private extension SwarmTabStrip {
try tabs[0].checkDoubleClickIsolation()
try checkTitlebar(tabs.count == 24 && newButton.isEnabled, "All overflow tabs and New Tab remain available")
try checkTitlebar(scroll.frame.maxX <= newButton.frame.minX &&
- newButton.frame.maxX < searchButton.frame.minX, "Tabs precede the search, bell and Store controls")
+ newButton.frame.maxX < searchButton.frame.minX, "Tabs precede the search and Store controls")
try checkTitlebar(tabs[0].frame.width < 136 && tabs[0].displayLabel == "code",
"Overflow tabs keep readable names without persistent number prefixes")
- try checkTitlebar(subviews.count == 5 && statusBar.subviews.count == 6 && pullRequestButton.isHidden && subscriptionUsageButton.isHidden && daemonButton.isHidden && voiceLabel.isHidden && shareButton.isHidden,
+ try checkTitlebar(subviews.count == 4 && statusBar.subviews.count == 6 && pullRequestButton.isHidden && subscriptionUsageButton.isHidden && daemonButton.isHidden && voiceLabel.isHidden && shareButton.isHidden,
"Navigation lives in the titlebar and focused context lives in the footer")
let controls = [newButton]
for control in controls {
@@ -1552,7 +1570,7 @@ private extension SwarmTabStrip {
try checkTitlebar(contextButton.accessibilityValue() as? String == "OpenAI M2:~/code/harness (main)",
"The full focused context is accessible")
for (index, tab) in tabs.enumerated() {
- try tab.checkAccessibility(expectedName: "Swarm \(index)", active: index == 11)
+ try tab.checkAccessibility(expectedName: "Tab \(index)", active: index == 11)
}
try checkActiveVisible()
let hover = NSEvent.mouseEvent(with: .mouseMoved, location: .zero, modifierFlags: [],
@@ -1586,7 +1604,7 @@ private extension SwarmTabStrip {
try checkTitlebar(tabs[0] === original && original.displayLabel == "blender",
"Type changes update the existing tab without renaming its saved workspace")
try original.checkAccessibility(expectedName: "Custom name", active: true)
- try checkTitlebar(newButton.toolTip == "New Tab ⌘T", "New Tab retains its keyboard hint")
+ try checkTitlebar(newButton.toolTip == "New Tab", "New Tab has a label before its keymap arrives")
events.removeAll()
contextButton.performClick(nil)
newButton.performClick(nil)
@@ -1624,7 +1642,7 @@ private extension SwarmTabStrip {
try tab.checkCenteredLabel()
try checkTitlebar(scroll.documentVisibleRect.contains(tab.frame),
"Keyboard focus reveals the entire overflowed tab")
- try checkTitlebar(activeId == "keyboard-23", "Focusing a tab control does not activate its swarm")
+ try checkTitlebar(activeId == "keyboard-23", "Focusing a tab control does not activate its tab")
let before = messenger.calls.count
messenger.holdReplies = true
button.performClick(nil)
@@ -1880,9 +1898,13 @@ private extension SwarmTitlebar {
HarnessNativeKeymap.contexts.map { ($0, [["keys": ["cmd+k", "n"], "command": "swarm.new",
"hint": "⌘K N", "repeatable": false, "menuAction": "new"]]) })])!
setKeymap(onlySequence)
+ try checkTitlebar(strip.newButton.toolTip == "New Tab · ⌘K N",
+ "The plus tooltip teaches the current shortcut sequence")
try checkTitlebar(newSwarm.keyEquivalent.isEmpty && newSwarm.toolTip == nil,
"Sequences add no hover hints or misleading first-key menu shortcut")
setKeymap(HarnessNativeKeymap(["version": 1, "contexts": ["workspace": [], "terminal": [], "picker": [], "project": []]])!)
+ try checkTitlebar(strip.newButton.toolTip == "New Tab",
+ "Unbinding removes the plus tooltip's shortcut without leaving a separator")
try checkTitlebar(newSwarm.keyEquivalent.isEmpty && newSwarm.toolTip == nil,
"Unbinding clears the old native shortcut and hint")
try checkTitlebar(models.keyEquivalent.isEmpty,
@@ -1903,7 +1925,7 @@ private extension SwarmTitlebar {
"The menu yields the remapped search shortcut to Flutter")
try checkTitlebar(!main.performKeyEquivalent(with: open), "Menu equivalents defer before input dispatch")
setKeymap(defaults)
- try checkTitlebar(strip.newButton.toolTip == "New Tab ⌘T", "Keymap reload restores the current New Tab hint")
+ try checkTitlebar(strip.newButton.toolTip == "New Tab · ⌘T", "Keymap reload restores the current New Tab hint")
try checkTitlebar(strip.newButton.accessibilityLabel() == "New Tab", "The plus announces New Tab")
try checkTitlebar(main.defersToInput(event("n", 45, .command)) && main.defersToInput(event("t", 17, .command)),
"Command-N and Command-T reach creation and New Tab")
@@ -2034,7 +2056,7 @@ private extension SwarmTitlebar {
try checkTitlebar(strip.palette == startupPalette && window.titlebarAccessoryViewControllers.count == 1,
"Repeated configuration preserves the saved palette and one titlebar accessory")
_ = try messenger.receive("update", arguments: [
- "tabs": [["id": "startup-check", "name": "Synthetic swarm"]],
+ "tabs": [["id": "startup-check", "name": "Synthetic tab"]],
"activeId": "startup-check", "enabled": true, "palette": startupColors,
])
window.contentView?.layoutSubtreeIfNeeded()
@@ -2125,9 +2147,9 @@ private extension SwarmTitlebar {
let reopen = historyMenu.items.first(where: { $0.representedObject as? String == "reopen" })!
actionsEnabled = true
canReopen = false
- try checkTitlebar(!validateMenuItem(reopen), "Closed-Swarm recovery is disabled with an empty history")
+ try checkTitlebar(!validateMenuItem(reopen), "Closed-Tab recovery is disabled with an empty history")
canReopen = true
- try checkTitlebar(validateMenuItem(reopen), "Closed-Swarm recovery becomes available")
+ try checkTitlebar(validateMenuItem(reopen), "Closed-Tab recovery becomes available")
let closePane = agent.items.first(where: { $0.representedObject as? String == "closePane" })!
canClosePane = false
try checkTitlebar(!validateMenuItem(closePane), "Remove Agent is disabled in New Tab")
@@ -2158,7 +2180,7 @@ private extension SwarmTitlebar {
"detail": "Project \(index)", "machineName": "M2", "current": index == 0,
"engine": index == 0 ? "claude" : "codex"]
}
- recentRows.append(["id": "swarm:recent", "title": "Recent Swarm", "swarm": true])
+ recentRows.append(["id": "swarm:recent", "title": "Recent Tab", "swarm": true])
let closedRows: [[String: Any]] = (0..<14).map {
["id": "closed-\($0)", "title": "Closed Tab \($0)", "detail": "3 agents", "swarm": true, "canReopen": true]
}
@@ -2193,7 +2215,7 @@ private extension SwarmTitlebar {
try checkTitlebar(recent.state == .on && recent.toolTip == nil, "History adds no hover hints")
updateHistory(recentRows, closed: closedRows)
try checkTitlebar(historyMenu.items.contains(where: { $0 === recent }), "Unchanged history retains native menu items")
- try checkTitlebar(validateMenuItem(closed), "A specific closed Swarm can be restored")
+ try checkTitlebar(validateMenuItem(closed), "A specific closed Tab can be restored")
canReopen = false
try checkTitlebar(validateMenuItem(closed), "A chosen closure uses its own capacity, independently of the latest closure")
var unavailableRows = closedRows
@@ -2231,7 +2253,7 @@ private extension SwarmTitlebar {
}, "Multiple-agent agents retain the group icon")
updateHistory([])
try checkTitlebar(!validateMenuItem(recent), "A stale recent menu item cannot dispatch after its view disappears")
- try checkTitlebar(!validateMenuItem(closed), "A stale closed entry cannot restore another Swarm")
+ try checkTitlebar(!validateMenuItem(closed), "A stale closed entry cannot restore another Tab")
try checkTitlebar(historyMenu.items.first(where: { $0.title == "No Recent Visits" })?.isEnabled == false, "An empty history is an inert placeholder")
guard let menu = main.items.first(where: { $0.title == "View" })?.submenu,
let attention = menu.items.first(where: { $0.representedObject as? String == "notifications" }) else {
@@ -2245,8 +2267,8 @@ private extension SwarmTitlebar {
actionsEnabled = true
try checkTitlebar(validateMenuItem(attention), "Native attention shortcut returns when the modal closes")
try checkTitlebar(main.items.compactMap(\.submenu).flatMap(\.items).allSatisfy {
- !["Next Swarm", "Previous Swarm"].contains($0.title)
- }, "Next and Previous Swarm have no redundant menu rows")
+ !["Next Tab", "Previous Tab"].contains($0.title)
+ }, "Next and Previous Tab have no redundant menu rows")
try checkTitlebar(main.item(withTitle: "Models") == nil,
"Models has no duplicate top-level menu")
let openModels = menu.items.first(where: { $0.representedObject as? String == "models" })!
@@ -2293,7 +2315,7 @@ private extension SwarmTitlebar {
}
strip.update([
"enabled": true, "activeId": "swarm-11",
- "tabs": (0..<12).map { ["id": "swarm-\($0)", "name": "Swarm \($0)"] },
+ "tabs": (0..<12).map { ["id": "swarm-\($0)", "name": "Tab \($0)"] },
])
for width in [880.0, 1280.0, 1920.0] {
window.setContentSize(NSSize(width: width, height: 700))
@@ -2389,10 +2411,10 @@ do {
let longRow = SwarmHistoryEntry(["id": "long", "title": String(repeating: "Long title ", count: 100), "machineName": "Mac"])!
try checkTitlebar(longRow.menuTitle().string.contains("…\tMac") && longRow.menuTitle().size().width < 380,
"Long titles truncate before the machine column without widening the menu")
- let swarmRow = SwarmHistoryEntry(["id": "swarm", "title": "My swarm", "swarm": true])!
- try checkTitlebar(swarmRow.menuTitle().string == "My swarm", "Empty swarm rows have no invented machine label")
+ let swarmRow = SwarmHistoryEntry(["id": "swarm", "title": "My tab", "swarm": true])!
+ try checkTitlebar(swarmRow.menuTitle().string == "My tab", "Empty tab rows have no invented machine label")
let sharedSwarm = SwarmHistoryEntry(["id": "shared", "title": "Workshop", "swarm": true, "machineName": "2 machines"])!
- try checkTitlebar(sharedSwarm.menuTitle().string == "Workshop\t2 machines", "Swarm machine counts use the same trailing column as agent machines")
+ try checkTitlebar(sharedSwarm.menuTitle().string == "Workshop\t2 machines", "Tab machine counts use the same trailing column as agent machines")
for button in [SwarmIconButton()] {
button.frame = NSRect(x: 0, y: 0, width: 28, height: 28)
button.image = NSImage(systemSymbolName: "plus", accessibilityDescription: nil)
@@ -2440,7 +2462,8 @@ do {
try strip.checkAgentIdentity()
try strip.checkSharedTypography()
try strip.checkShareAction()
- try strip.checkNotifications()
+ try strip.checkTopActions()
+ try checkIconTooltipTracking()
try strip.checkActivityMarks()
try SwarmTabButton(id: "close-shortcuts").checkHoverCloseAndShortcutHints()
try strip.checkTabPresentationAndCapture()
@@ -2458,7 +2481,7 @@ do {
content.view = TitlebarCheckContentView(frame: NSRect(x: 0, y: 0, width: 1280, height: 700))
window.contentViewController = content
let messenger = TitlebarCheckMessenger()
- let titlebar = SwarmTitlebar(window: window, messenger: messenger)
+ let titlebar = SwarmTitlebar(window: window, messenger: messenger, installStatusItem: false)
if let path = ProcessInfo.processInfo.environment["HARNESS_TITLEBAR_KEYMAP_FIXTURE"] {
let fixture = try JSONSerialization.jsonObject(with: Data(contentsOf: URL(fileURLWithPath: path))) as! [String: [String: Any]]
let before = titlebarCheckCount
@@ -2471,12 +2494,12 @@ do {
try titlebar.checkKeymapRuntime(fixture, messenger: messenger)
}
window.close()
- print("AppKit Swarm titlebar: \(titlebarCheckCount) checks passed, including native window layout; no windows displayed.")
+ print("AppKit Tab titlebar: \(titlebarCheckCount) checks passed, including native window layout; no windows displayed.")
} else {
- print("AppKit Swarm titlebar: \(titlebarCheckCount) checks passed; no windows opened.")
+ print("AppKit Tab titlebar: \(titlebarCheckCount) checks passed; no windows opened.")
}
} catch {
let message = (error as? TitlebarCheckFailure)?.message ?? String(describing: error)
- FileHandle.standardError.write(Data("AppKit Swarm titlebar failed: \(message)\n".utf8))
+ FileHandle.standardError.write(Data("AppKit Tab titlebar failed: \(message)\n".utf8))
exit(1)
}
diff --git a/desktop/tool/window_zoom_checks.swift b/desktop/tool/window_zoom_checks.swift
index bf6b6fc94..ec6075209 100644
--- a/desktop/tool/window_zoom_checks.swift
+++ b/desktop/tool/window_zoom_checks.swift
@@ -131,7 +131,7 @@ do {
styleMask: [.titled, .closable, .miniaturizable, .resizable], backing: .buffered, defer: false)
window.isReleasedWhenClosed = false
defer { window.close() }
- let titlebar = SwarmTitlebar(window: window, messenger: WindowZoomCheckMessenger())
+ let titlebar = SwarmTitlebar(window: window, messenger: WindowZoomCheckMessenger(), installStatusItem: false)
try titlebar.checkWindowGestures(window)
print("AppKit window zoom: \(windowZoomCheckCount) checks passed; no windows displayed.")
} catch {
diff --git a/docs/branding/app-logo/README.md b/docs/branding/app-logo/README.md
index 5ce677176..ea412c460 100644
--- a/docs/branding/app-logo/README.md
+++ b/docs/branding/app-logo/README.md
@@ -8,6 +8,38 @@ below the circle and square fade to a faint line and the figure carries the icon
Unlike the rounds before it this revision carries no clip path: its own rounded
tile is the first element and nothing is drawn outside it.
+The macOS menu bar uses the team's updated September 30 portrait symbols from
+`team-symbols-2026-09-30/Symbol Harness_Lightmode.svg` and
+`team-symbols-2026-09-30/Symbol Harness_Darkmode.svg`, drawn at 17pt in a 28 × 22pt
+footprint. The light variant has an outlined tile and the dark variant has a
+filled tile; both preserve the supplied vector paths and transparent cutouts.
+Their shipping copies live in
+`desktop/macos/Runner/Assets.xcassets/HarnessStatusIcon.imageset/` as light and
+dark appearance variants. AppKit tints the template for the menu bar and
+composes the unread badge at runtime, overlapping the lower-right corner.
+The badge is absent at zero, and its footprint stays stable as the count changes.
+
+Four app icon proposals reuse the Departure Mono `hn`, with green, graphite,
+and light backgrounds. [Review them in Dock mockups](hn-dock-options/dock-options.png);
+the proposed icon is under the Harness label and the current app icon is at the
+right. These are preview assets. Regenerate them on a Mac with Visual Studio Code
+installed, from the repository root:
+
+```sh
+swift docs/branding/app-logo/render-hn-dock-options.swift
+```
+
+The team's initial September 30 portrait symbols are preserved alongside the
+updated sources in `team-symbols-2026-09-30/`. [Review the original symbols in the
+Dock and menu bar](team-symbols-2026-09-30/team-icons-preview.png). These earlier
+preview assets keep the original transparent cutouts; the Dock background shows
+through the face. Their menu bar examples use the previous 20pt size. Regenerate
+these archived previews from the repository root on a Mac with Xcode installed:
+
+```sh
+swift docs/branding/app-logo/render-team-symbols.swift
+```
+
Earlier rounds, kept for reference:
- `harness-logo-3.svg`: the untouched SVG supplied on 2026-09-22, which shipped
diff --git a/docs/branding/app-logo/hn-dock-options/a-green.png b/docs/branding/app-logo/hn-dock-options/a-green.png
new file mode 100644
index 000000000..c8c81cc51
Binary files /dev/null and b/docs/branding/app-logo/hn-dock-options/a-green.png differ
diff --git a/docs/branding/app-logo/hn-dock-options/a-green.svg b/docs/branding/app-logo/hn-dock-options/a-green.svg
new file mode 100644
index 000000000..c75293085
--- /dev/null
+++ b/docs/branding/app-logo/hn-dock-options/a-green.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <defs><linearGradient id="tile" x1="0" y1="0" x2="0" y2="1">
+ <stop stop-color="#56FF40"/><stop offset="1" stop-color="#39DE24"/>
+ </linearGradient></defs>
+ <rect x="54" y="54" width="916" height="916" rx="205" fill="url(#tile)"/>
+ <path transform="translate(195.333333 178.666667) scale(33.333333)" fill="#10130F" d="M0.5000 4.0000 L0.5000 16.0000 L2.0000 16.0000 L2.0000 10.0000 L3.5000 10.0000 L3.5000 8.5000 L2.0000 8.5000 L2.0000 4.0000 Z M6.5000 8.5000 L6.5000 16.0000 L8.0000 16.0000 L8.0000 8.5000 Z M3.5000 7.0000 L3.5000 8.5000 L6.5000 8.5000 L6.5000 7.0000 Z M11.0000 7.0000 L11.0000 16.0000 L12.5000 16.0000 L12.5000 10.0000 L14.0000 10.0000 L14.0000 8.5000 L12.5000 8.5000 L12.5000 7.0000 Z M14.0000 7.0000 L14.0000 8.5000 L17.0000 8.5000 L17.0000 7.0000 Z M17.0000 8.5000 L17.0000 16.0000 L18.5000 16.0000 L18.5000 8.5000 Z"/>
+</svg>
\ No newline at end of file
diff --git a/docs/branding/app-logo/hn-dock-options/b-terminal.png b/docs/branding/app-logo/hn-dock-options/b-terminal.png
new file mode 100644
index 000000000..56458e058
Binary files /dev/null and b/docs/branding/app-logo/hn-dock-options/b-terminal.png differ
diff --git a/docs/branding/app-logo/hn-dock-options/b-terminal.svg b/docs/branding/app-logo/hn-dock-options/b-terminal.svg
new file mode 100644
index 000000000..4b5e70c9f
--- /dev/null
+++ b/docs/branding/app-logo/hn-dock-options/b-terminal.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <defs><linearGradient id="tile" x1="0" y1="0" x2="0" y2="1">
+ <stop stop-color="#303533"/><stop offset="1" stop-color="#111513"/>
+ </linearGradient></defs>
+ <rect x="54" y="54" width="916" height="916" rx="205" fill="url(#tile)"/>
+ <path transform="translate(195.333333 178.666667) scale(33.333333)" fill="#65F747" d="M0.5000 4.0000 L0.5000 16.0000 L2.0000 16.0000 L2.0000 10.0000 L3.5000 10.0000 L3.5000 8.5000 L2.0000 8.5000 L2.0000 4.0000 Z M6.5000 8.5000 L6.5000 16.0000 L8.0000 16.0000 L8.0000 8.5000 Z M3.5000 7.0000 L3.5000 8.5000 L6.5000 8.5000 L6.5000 7.0000 Z M11.0000 7.0000 L11.0000 16.0000 L12.5000 16.0000 L12.5000 10.0000 L14.0000 10.0000 L14.0000 8.5000 L12.5000 8.5000 L12.5000 7.0000 Z M14.0000 7.0000 L14.0000 8.5000 L17.0000 8.5000 L17.0000 7.0000 Z M17.0000 8.5000 L17.0000 16.0000 L18.5000 16.0000 L18.5000 8.5000 Z"/>
+</svg>
\ No newline at end of file
diff --git a/docs/branding/app-logo/hn-dock-options/c-light.png b/docs/branding/app-logo/hn-dock-options/c-light.png
new file mode 100644
index 000000000..2f1cc4ba4
Binary files /dev/null and b/docs/branding/app-logo/hn-dock-options/c-light.png differ
diff --git a/docs/branding/app-logo/hn-dock-options/c-light.svg b/docs/branding/app-logo/hn-dock-options/c-light.svg
new file mode 100644
index 000000000..6a27fe00d
--- /dev/null
+++ b/docs/branding/app-logo/hn-dock-options/c-light.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <defs><linearGradient id="tile" x1="0" y1="0" x2="0" y2="1">
+ <stop stop-color="#FFFFFF"/><stop offset="1" stop-color="#E9ECE7"/>
+ </linearGradient></defs>
+ <rect x="54" y="54" width="916" height="916" rx="205" fill="url(#tile)"/>
+ <path transform="translate(195.333333 178.666667) scale(33.333333)" fill="#161B17" d="M0.5000 4.0000 L0.5000 16.0000 L2.0000 16.0000 L2.0000 10.0000 L3.5000 10.0000 L3.5000 8.5000 L2.0000 8.5000 L2.0000 4.0000 Z M6.5000 8.5000 L6.5000 16.0000 L8.0000 16.0000 L8.0000 8.5000 Z M3.5000 7.0000 L3.5000 8.5000 L6.5000 8.5000 L6.5000 7.0000 Z M11.0000 7.0000 L11.0000 16.0000 L12.5000 16.0000 L12.5000 10.0000 L14.0000 10.0000 L14.0000 8.5000 L12.5000 8.5000 L12.5000 7.0000 Z M14.0000 7.0000 L14.0000 8.5000 L17.0000 8.5000 L17.0000 7.0000 Z M17.0000 8.5000 L17.0000 16.0000 L18.5000 16.0000 L18.5000 8.5000 Z"/>
+</svg>
\ No newline at end of file
diff --git a/docs/branding/app-logo/hn-dock-options/d-dark.png b/docs/branding/app-logo/hn-dock-options/d-dark.png
new file mode 100644
index 000000000..c99efac61
Binary files /dev/null and b/docs/branding/app-logo/hn-dock-options/d-dark.png differ
diff --git a/docs/branding/app-logo/hn-dock-options/d-dark.svg b/docs/branding/app-logo/hn-dock-options/d-dark.svg
new file mode 100644
index 000000000..3514e7fa7
--- /dev/null
+++ b/docs/branding/app-logo/hn-dock-options/d-dark.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <defs><linearGradient id="tile" x1="0" y1="0" x2="0" y2="1">
+ <stop stop-color="#303533"/><stop offset="1" stop-color="#111513"/>
+ </linearGradient></defs>
+ <rect x="54" y="54" width="916" height="916" rx="205" fill="url(#tile)"/>
+ <path transform="translate(195.333333 178.666667) scale(33.333333)" fill="#F5F8F2" d="M0.5000 4.0000 L0.5000 16.0000 L2.0000 16.0000 L2.0000 10.0000 L3.5000 10.0000 L3.5000 8.5000 L2.0000 8.5000 L2.0000 4.0000 Z M6.5000 8.5000 L6.5000 16.0000 L8.0000 16.0000 L8.0000 8.5000 Z M3.5000 7.0000 L3.5000 8.5000 L6.5000 8.5000 L6.5000 7.0000 Z M11.0000 7.0000 L11.0000 16.0000 L12.5000 16.0000 L12.5000 10.0000 L14.0000 10.0000 L14.0000 8.5000 L12.5000 8.5000 L12.5000 7.0000 Z M14.0000 7.0000 L14.0000 8.5000 L17.0000 8.5000 L17.0000 7.0000 Z M17.0000 8.5000 L17.0000 16.0000 L18.5000 16.0000 L18.5000 8.5000 Z"/>
+</svg>
\ No newline at end of file
diff --git a/docs/branding/app-logo/hn-dock-options/dock-options.png b/docs/branding/app-logo/hn-dock-options/dock-options.png
new file mode 100644
index 000000000..eca405c1d
Binary files /dev/null and b/docs/branding/app-logo/hn-dock-options/dock-options.png differ
diff --git a/docs/branding/app-logo/hn-dock-options/hn.svg b/docs/branding/app-logo/hn-dock-options/hn.svg
new file mode 100644
index 000000000..b47b56a6f
--- /dev/null
+++ b/docs/branding/app-logo/hn-dock-options/hn.svg
@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <path fill="#000" d="M0.5000 4.0000 L0.5000 16.0000 L2.0000 16.0000 L2.0000 10.0000 L3.5000 10.0000 L3.5000 8.5000 L2.0000 8.5000 L2.0000 4.0000 Z M6.5000 8.5000 L6.5000 16.0000 L8.0000 16.0000 L8.0000 8.5000 Z M3.5000 7.0000 L3.5000 8.5000 L6.5000 8.5000 L6.5000 7.0000 Z M11.0000 7.0000 L11.0000 16.0000 L12.5000 16.0000 L12.5000 10.0000 L14.0000 10.0000 L14.0000 8.5000 L12.5000 8.5000 L12.5000 7.0000 Z M14.0000 7.0000 L14.0000 8.5000 L17.0000 8.5000 L17.0000 7.0000 Z M17.0000 8.5000 L17.0000 16.0000 L18.5000 16.0000 L18.5000 8.5000 Z"/>
+</svg>
diff --git a/docs/branding/app-logo/render-hn-dock-options.swift b/docs/branding/app-logo/render-hn-dock-options.swift
new file mode 100644
index 000000000..da658a170
--- /dev/null
+++ b/docs/branding/app-logo/render-hn-dock-options.swift
@@ -0,0 +1,152 @@
+// Preview app icons using the original Departure Mono lettermark.
+// Run from the repository root on macOS:
+// swift docs/branding/app-logo/render-hn-dock-options.swift
+// Writes review SVGs, PNGs, and Dock mockups; does not replace shipping app icons.
+import AppKit
+
+_ = NSApplication.shared
+let root = URL(fileURLWithPath: FileManager.default.currentDirectoryPath)
+let folder = root.appendingPathComponent("docs/branding/app-logo/hn-dock-options")
+try FileManager.default.createDirectory(at: folder, withIntermediateDirectories: true)
+let source = folder.appendingPathComponent("hn.svg")
+let document = try XMLDocument(contentsOf: source, options: [])
+let glyph = (try document.nodes(forXPath: "//*[local-name()='path']").first as! XMLElement)
+ .attribute(forName: "d")!.stringValue!
+
+struct Option {
+ let file: String
+ let name: String
+ let subtitle: String
+ let top: String
+ let bottom: String
+ let ink: String
+}
+let options = [
+ Option(file: "a-green", name: "A Green", subtitle: "Harness green · black letters", top: "#56FF40", bottom: "#39DE24", ink: "#10130F"),
+ Option(file: "b-terminal", name: "B Terminal", subtitle: "Graphite · green letters", top: "#303533", bottom: "#111513", ink: "#65F747"),
+ Option(file: "c-light", name: "C Light", subtitle: "Soft white · black letters", top: "#FFFFFF", bottom: "#E9ECE7", ink: "#161B17"),
+ Option(file: "d-dark", name: "D Dark", subtitle: "Graphite · white letters", top: "#303533", bottom: "#111513", ink: "#F5F8F2"),
+]
+
+func renderPNG(_ image: NSImage, size: NSSize, scale: CGFloat = 2, to url: URL) throws {
+ let rep = NSBitmapImageRep(bitmapDataPlanes: nil, pixelsWide: Int(size.width * scale),
+ pixelsHigh: Int(size.height * scale), bitsPerSample: 8, samplesPerPixel: 4,
+ hasAlpha: true, isPlanar: false, colorSpaceName: .deviceRGB, bytesPerRow: 0, bitsPerPixel: 0)!
+ rep.size = size
+ NSGraphicsContext.saveGraphicsState()
+ NSGraphicsContext.current = NSGraphicsContext(bitmapImageRep: rep)
+ image.draw(in: NSRect(origin: .zero, size: size), from: .zero, operation: .copy, fraction: 1)
+ NSGraphicsContext.restoreGraphicsState()
+ try rep.representation(using: .png, properties: [:])!.write(to: url)
+}
+
+var icons: [NSImage] = []
+for option in options {
+ let svg = """
+ <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+ <!-- hn outlined from Departure Mono Regular 1.500 by Helena Zhang (SIL OFL 1.1). -->
+ <defs><linearGradient id="tile" x1="0" y1="0" x2="0" y2="1">
+ <stop stop-color="\(option.top)"/><stop offset="1" stop-color="\(option.bottom)"/>
+ </linearGradient></defs>
+ <rect x="54" y="54" width="916" height="916" rx="205" fill="url(#tile)"/>
+ <path transform="translate(195.333333 178.666667) scale(33.333333)" fill="\(option.ink)" d="\(glyph)"/>
+ </svg>
+ """
+ let url = folder.appendingPathComponent(option.file + ".svg")
+ try svg.write(to: url, atomically: true, encoding: .utf8)
+ let icon = NSImage(contentsOf: url)!
+ icons.append(icon)
+ try renderPNG(icon, size: NSSize(width: 1024, height: 1024), scale: 1,
+ to: folder.appendingPathComponent(option.file + ".png"))
+}
+
+let codeIcon = NSImage(contentsOfFile: "/Applications/Visual Studio Code.app/Contents/Resources/Code.icns")!
+let terminalIcon = NSImage(contentsOfFile: "/System/Applications/Utilities/Terminal.app/Contents/Resources/Terminal.icns")!
+let currentIcon = NSImage(contentsOf: root.appendingPathComponent("desktop/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png"))!
+let canvas = NSSize(width: 1120, height: 850)
+
+func text(_ value: String, at point: NSPoint, size: CGFloat, color: NSColor,
+ weight: NSFont.Weight = .regular, mono: Bool = false) {
+ (value as NSString).draw(at: point, withAttributes: [
+ .font: mono ? NSFont.monospacedSystemFont(ofSize: size, weight: weight) : NSFont.systemFont(ofSize: size, weight: weight),
+ .foregroundColor: color,
+ ])
+}
+
+func drawIcon(_ icon: NSImage, in rect: NSRect) {
+ NSGraphicsContext.saveGraphicsState()
+ let shadow = NSShadow()
+ shadow.shadowColor = NSColor.black.withAlphaComponent(0.32)
+ shadow.shadowBlurRadius = 6
+ shadow.shadowOffset = NSSize(width: 0, height: -3)
+ shadow.set()
+ icon.draw(in: rect)
+ NSGraphicsContext.restoreGraphicsState()
+}
+
+func dockScene(option: Option, icon: NSImage, at origin: NSPoint) {
+ let scene = NSRect(x: origin.x, y: origin.y, width: 524, height: 264)
+ NSGraphicsContext.saveGraphicsState()
+ NSBezierPath(roundedRect: scene, xRadius: 14, yRadius: 14).addClip()
+ NSColor(white: 0.095, alpha: 1).setFill()
+ scene.fill()
+ NSColor(white: 0.25, alpha: 1).setFill()
+ NSRect(x: scene.minX, y: scene.minY + 83, width: 243, height: 181).fill()
+ NSColor(white: 0.35, alpha: 1).setFill()
+ NSRect(x: scene.minX + 249, y: scene.minY + 83, width: 1, height: 181).fill()
+ text("harness / workspace", at: NSPoint(x: scene.minX + 16, y: scene.minY + 238),
+ size: 12, color: NSColor(white: 0.65, alpha: 1), mono: true)
+ text("$ hn", at: NSPoint(x: scene.minX + 272, y: scene.minY + 238),
+ size: 12, color: NSColor(white: 0.75, alpha: 1), mono: true)
+
+ // A translucent macOS-style Dock, with the proposed icon magnified as on hover.
+ let dock = NSRect(x: scene.minX + 8, y: scene.minY + 12, width: 508, height: 127)
+ let dockPath = NSBezierPath(roundedRect: dock, xRadius: 23, yRadius: 23)
+ NSGradient(starting: NSColor(white: 0.66, alpha: 0.56), ending: NSColor(white: 0.47, alpha: 0.72))!
+ .draw(in: dockPath, angle: 90)
+ NSColor(white: 0.92, alpha: 0.33).setStroke()
+ dockPath.lineWidth = 0.75
+ dockPath.stroke()
+ let placements: [(NSImage, CGFloat, CGFloat)] = [
+ (terminalIcon, 64, 88), (codeIcon, 184, 112), (icon, 330, 146), (currentIcon, 465, 100),
+ ]
+ for (appIcon, center, size) in placements {
+ drawIcon(appIcon, in: NSRect(x: scene.minX + center - size / 2,
+ y: scene.minY + 32, width: size, height: size))
+ NSColor(white: 0.07, alpha: 1).setFill()
+ NSBezierPath(ovalIn: NSRect(x: scene.minX + center - 2, y: scene.minY + 21, width: 4, height: 4)).fill()
+ }
+ // Hover label anchors the new icon in each comparison, like the reference Dock.
+ let tooltip = NSRect(x: scene.minX + 286, y: scene.minY + 196, width: 88, height: 29)
+ let tip = NSBezierPath()
+ tip.move(to: NSPoint(x: tooltip.midX - 8, y: tooltip.minY + 1))
+ tip.line(to: NSPoint(x: tooltip.midX, y: tooltip.minY - 7))
+ tip.line(to: NSPoint(x: tooltip.midX + 8, y: tooltip.minY + 1))
+ tip.close()
+ NSColor(white: 0.79, alpha: 1).setFill()
+ tip.fill()
+ NSBezierPath(roundedRect: tooltip, xRadius: 14, yRadius: 14).fill()
+ text("Harness", at: NSPoint(x: tooltip.minX + 14, y: tooltip.minY + 6),
+ size: 15, color: NSColor(white: 0.13, alpha: 1))
+ NSGraphicsContext.restoreGraphicsState()
+}
+
+let sheet = NSImage(size: canvas, flipped: false) { _ in
+ NSColor(white: 0.065, alpha: 1).setFill()
+ NSRect(origin: .zero, size: canvas).fill()
+ text("hn / in the Dock", at: NSPoint(x: 24, y: 794), size: 29, color: .white, weight: .semibold)
+ text("Departure Mono · four app icon treatments", at: NSPoint(x: 24, y: 768), size: 14, color: .lightGray)
+ for (index, option) in options.enumerated() {
+ let x: CGFloat = index % 2 == 0 ? 24 : 572
+ let y: CGFloat = index < 2 ? 419 : 63
+ text(option.name, at: NSPoint(x: x, y: y + 298), size: 19, color: .white, weight: .semibold)
+ text(option.subtitle, at: NSPoint(x: x, y: y + 277), size: 12, color: .lightGray)
+ dockScene(option: option, icon: icons[index], at: NSPoint(x: x, y: y))
+ }
+ text("Dock mockups · proposed icon under the Harness label · current app icon at the right for comparison",
+ at: NSPoint(x: 24, y: 24), size: 11.5, color: .gray)
+ return true
+}
+let output = folder.appendingPathComponent("dock-options.png")
+try renderPNG(sheet, size: canvas, to: output)
+print(output.path)
diff --git a/docs/branding/app-logo/render-team-symbols.swift b/docs/branding/app-logo/render-team-symbols.swift
new file mode 100644
index 000000000..2509519d5
--- /dev/null
+++ b/docs/branding/app-logo/render-team-symbols.swift
@@ -0,0 +1,189 @@
+// Preview the team's September 30 symbols in the Dock and menu bar.
+// Run from the repository root on macOS, with Xcode installed:
+// swift docs/branding/app-logo/render-team-symbols.swift
+// The supplied SVGs keep their colors and transparent cutouts.
+import AppKit
+import CoreText
+
+_ = NSApplication.shared
+let root = URL(fileURLWithPath: FileManager.default.currentDirectoryPath)
+let folder = root.appendingPathComponent("docs/branding/app-logo/team-symbols-2026-09-30")
+let names = ["dark", "light"]
+let symbols = names.map { NSImage(contentsOf: folder.appendingPathComponent("Symbol Harness_" + $0 + ".svg"))! }
+
+func renderPNG(_ image: NSImage, size: NSSize, scale: CGFloat = 2, to url: URL) throws {
+ let rep = NSBitmapImageRep(bitmapDataPlanes: nil, pixelsWide: Int(size.width * scale),
+ pixelsHigh: Int(size.height * scale), bitsPerSample: 8, samplesPerPixel: 4,
+ hasAlpha: true, isPlanar: false, colorSpaceName: .deviceRGB, bytesPerRow: 0, bitsPerPixel: 0)!
+ rep.size = size
+ NSGraphicsContext.saveGraphicsState()
+ NSGraphicsContext.current = NSGraphicsContext(bitmapImageRep: rep)
+ image.draw(in: NSRect(origin: .zero, size: size), from: .zero, operation: .copy, fraction: 1)
+ NSGraphicsContext.restoreGraphicsState()
+ try rep.representation(using: .png, properties: [:])!.write(to: url)
+}
+
+var icons: [NSImage] = []
+for (index, name) in names.enumerated() {
+ let icon = NSImage(size: NSSize(width: 1024, height: 1024), flipped: false) { _ in
+ // Use the same outer margin as the shipping macOS app icon.
+ symbols[index].draw(in: NSRect(x: 54, y: 54, width: 916, height: 916))
+ return true
+ }
+ icons.append(icon)
+ try renderPNG(icon, size: NSSize(width: 1024, height: 1024), scale: 1,
+ to: folder.appendingPathComponent("dock-" + name + ".png"))
+}
+
+let codeIcon = NSImage(contentsOfFile: "/Applications/Xcode.app/Contents/Resources/Xcode.icns")!
+let terminalIcon = NSImage(contentsOfFile: "/System/Applications/Utilities/Terminal.app/Contents/Resources/Terminal.icns")!
+let currentIcon = NSImage(contentsOf: root.appendingPathComponent("desktop/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png"))!
+
+func text(_ value: String, at point: NSPoint, size: CGFloat, color: NSColor,
+ weight: NSFont.Weight = .regular, mono: Bool = false) {
+ (value as NSString).draw(at: point, withAttributes: [
+ .font: mono ? NSFont.monospacedSystemFont(ofSize: size, weight: weight) : NSFont.systemFont(ofSize: size, weight: weight),
+ .foregroundColor: color,
+ ])
+}
+
+func drawIcon(_ icon: NSImage, in rect: NSRect) {
+ NSGraphicsContext.saveGraphicsState()
+ let shadow = NSShadow()
+ shadow.shadowColor = NSColor.black.withAlphaComponent(0.32)
+ shadow.shadowBlurRadius = 6
+ shadow.shadowOffset = NSSize(width: 0, height: -3)
+ shadow.set()
+ icon.draw(in: rect)
+ NSGraphicsContext.restoreGraphicsState()
+}
+
+func dockScene(icon: NSImage, at origin: NSPoint) {
+ let scene = NSRect(x: origin.x, y: origin.y, width: 524, height: 264)
+ NSGraphicsContext.saveGraphicsState()
+ NSBezierPath(roundedRect: scene, xRadius: 14, yRadius: 14).addClip()
+ NSColor(white: 0.095, alpha: 1).setFill()
+ scene.fill()
+ NSColor(white: 0.25, alpha: 1).setFill()
+ NSRect(x: scene.minX, y: scene.minY + 83, width: 243, height: 181).fill()
+ NSColor(white: 0.35, alpha: 1).setFill()
+ NSRect(x: scene.minX + 249, y: scene.minY + 83, width: 1, height: 181).fill()
+ text("harness / workspace", at: NSPoint(x: scene.minX + 16, y: scene.minY + 238),
+ size: 12, color: NSColor(white: 0.65, alpha: 1), mono: true)
+ text("$ hn", at: NSPoint(x: scene.minX + 272, y: scene.minY + 238),
+ size: 12, color: NSColor(white: 0.75, alpha: 1), mono: true)
+ let dock = NSRect(x: scene.minX + 8, y: scene.minY + 12, width: 508, height: 127)
+ let dockPath = NSBezierPath(roundedRect: dock, xRadius: 23, yRadius: 23)
+ NSGradient(starting: NSColor(white: 0.66, alpha: 0.56), ending: NSColor(white: 0.47, alpha: 0.72))!
+ .draw(in: dockPath, angle: 90)
+ NSColor(white: 0.92, alpha: 0.33).setStroke()
+ dockPath.lineWidth = 0.75
+ dockPath.stroke()
+ let placements: [(NSImage, CGFloat, CGFloat)] = [
+ (terminalIcon, 64, 88), (codeIcon, 184, 112), (icon, 330, 146), (currentIcon, 465, 100),
+ ]
+ for (appIcon, center, size) in placements {
+ drawIcon(appIcon, in: NSRect(x: scene.minX + center - size / 2,
+ y: scene.minY + 32, width: size, height: size))
+ NSColor(white: 0.07, alpha: 1).setFill()
+ NSBezierPath(ovalIn: NSRect(x: scene.minX + center - 2, y: scene.minY + 21, width: 4, height: 4)).fill()
+ }
+ let tooltip = NSRect(x: scene.minX + 286, y: scene.minY + 196, width: 88, height: 29)
+ let tip = NSBezierPath()
+ tip.move(to: NSPoint(x: tooltip.midX - 8, y: tooltip.minY + 1))
+ tip.line(to: NSPoint(x: tooltip.midX, y: tooltip.minY - 7))
+ tip.line(to: NSPoint(x: tooltip.midX + 8, y: tooltip.minY + 1))
+ tip.close()
+ NSColor(white: 0.79, alpha: 1).setFill()
+ tip.fill()
+ NSBezierPath(roundedRect: tooltip, xRadius: 14, yRadius: 14).fill()
+ text("Harness", at: NSPoint(x: tooltip.minX + 14, y: tooltip.minY + 6),
+ size: 15, color: NSColor(white: 0.13, alpha: 1))
+ NSGraphicsContext.restoreGraphicsState()
+}
+
+// Preserve this original proposal's 20pt artwork and lower-right count badge.
+func statusImage(logo: NSImage, count: Int?) -> NSImage {
+ NSImage(size: NSSize(width: 32, height: 22), flipped: false) { bounds in
+ let hasBadge = (count ?? 0) > 0
+ logo.draw(in: NSRect(x: hasBadge ? 0 : 6, y: hasBadge ? 2 : 1, width: 20, height: 20))
+ if hasBadge, let count, let context = NSGraphicsContext.current?.cgContext {
+ let badge = NSRect(x: bounds.maxX - 13, y: 0.5, width: 12.5, height: 12.5)
+ context.saveGState()
+ context.setBlendMode(.clear)
+ context.fillEllipse(in: badge.insetBy(dx: -0.75, dy: -0.75))
+ context.restoreGState()
+ NSColor.black.setFill()
+ NSBezierPath(ovalIn: badge).fill()
+ let label = String(count)
+ let attributed = NSAttributedString(string: label, attributes: [
+ .font: NSFont.monospacedDigitSystemFont(ofSize: label.count == 1 ? 9.5 : 8.5, weight: .medium),
+ .foregroundColor: NSColor.black,
+ ])
+ let line = CTLineCreateWithAttributedString(attributed)
+ let ink = CTLineGetBoundsWithOptions(line, .useGlyphPathBounds)
+ context.saveGState()
+ context.setBlendMode(.destinationOut)
+ context.textPosition = NSPoint(x: badge.midX - ink.midX, y: badge.midY - ink.midY)
+ CTLineDraw(line, context)
+ context.restoreGState()
+ }
+ return true
+ }
+}
+
+func drawTemplate(_ image: NSImage, in rect: NSRect, color: NSColor) {
+ let context = NSGraphicsContext.current!.cgContext
+ let mask = CGContext(data: nil, width: Int(rect.width * 2), height: Int(rect.height * 2),
+ bitsPerComponent: 8, bytesPerRow: 0, space: CGColorSpaceCreateDeviceRGB(),
+ bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue)!
+ mask.scaleBy(x: 2, y: 2)
+ NSGraphicsContext.saveGraphicsState()
+ NSGraphicsContext.current = NSGraphicsContext(cgContext: mask, flipped: false)
+ image.draw(in: NSRect(origin: .zero, size: rect.size))
+ NSGraphicsContext.restoreGraphicsState()
+ context.saveGState()
+ context.clip(to: rect, mask: mask.makeImage()!)
+ context.setFillColor(color.cgColor)
+ context.fill(rect)
+ context.restoreGState()
+}
+
+let canvas = NSSize(width: 1120, height: 730)
+let sheet = NSImage(size: canvas, flipped: false) { _ in
+ NSColor(white: 0.065, alpha: 1).setFill()
+ NSRect(origin: .zero, size: canvas).fill()
+ text("Harness / team symbols", at: NSPoint(x: 24, y: 677), size: 29, color: .white, weight: .semibold)
+ text("The supplied SVGs, shown in the Dock and as menu bar templates", at: NSPoint(x: 24, y: 650), size: 14, color: .lightGray)
+ for index in 0..<2 {
+ let x: CGFloat = index == 0 ? 24 : 572
+ text(index == 0 ? "Dark symbol" : "Light symbol", at: NSPoint(x: x, y: 610), size: 19, color: .white, weight: .semibold)
+ text(index == 0 ? "Symbol Harness_dark.svg" : "Symbol Harness_light.svg", at: NSPoint(x: x, y: 586), size: 12, color: .lightGray)
+ dockScene(icon: icons[index], at: NSPoint(x: x, y: 300))
+ }
+ text("Menu bar", at: NSPoint(x: 24, y: 260), size: 19, color: .white, weight: .semibold)
+ text("Enlarged at left · actual-size previews at right", at: NSPoint(x: 24, y: 239), size: 12, color: .lightGray)
+ for (index, dark) in [true, false].enumerated() {
+ let x: CGFloat = index == 0 ? 24 : 572
+ let color: NSColor = dark ? .white : .black
+ (dark ? NSColor.black : NSColor(white: 0.94, alpha: 1)).setFill()
+ NSBezierPath(roundedRect: NSRect(x: x, y: 54, width: 524, height: 160), xRadius: 12, yRadius: 12).fill()
+ text(dark ? "Dark menu bar" : "Light menu bar", at: NSPoint(x: x + 16, y: 182), size: 13, color: color, weight: .medium)
+ let logo = symbols[dark ? 1 : 0]
+ drawTemplate(statusImage(logo: logo, count: 3), in: NSRect(x: x + 24, y: 102, width: 96, height: 66), color: color)
+ text("3×", at: NSPoint(x: x + 62, y: 78), size: 10, color: color.withAlphaComponent(0.5))
+ let counts: [Int?] = [nil, 0, 3, 12]
+ for (column, count) in counts.enumerated() {
+ let left = x + 178 + CGFloat(column) * 82
+ drawTemplate(statusImage(logo: logo, count: count), in: NSRect(x: left, y: 122, width: 32, height: 22), color: color)
+ text(count.map { String($0) } ?? "none", at: NSPoint(x: left + (count == nil ? 4 : 11), y: 96),
+ size: 10, color: color.withAlphaComponent(0.5))
+ }
+ }
+ text("Dock mockups · original transparency retained · current green icon at right · menu bar footprint 32 × 22pt",
+ at: NSPoint(x: 24, y: 23), size: 11.5, color: .gray)
+ return true
+}
+let output = folder.appendingPathComponent("team-icons-preview.png")
+try renderPNG(sheet, size: canvas, to: output)
+print(output.path)
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Darkmode.svg b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Darkmode.svg
new file mode 100644
index 000000000..d0ae9ef23
--- /dev/null
+++ b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Darkmode.svg
@@ -0,0 +1,9 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M29.0909 0C35.1158 0 40 4.88417 40 10.9091V29.0909C40 29.4504 39.9808 29.8057 39.9467 30.1563C37.7411 30.3474 35.7861 31.0806 32.7805 32.8161C31.1307 32.0392 29.3467 31.2946 27.745 30.5256C27.9132 30.3385 28.1479 29.0483 28.228 28.8033C28.3567 28.4101 28.0009 27.5441 28.6364 27.6136C29.0433 27.6582 29.5699 27.7171 29.8118 28.1001C29.7576 28.6618 29.1962 28.8339 28.7536 29.13L28.8068 29.2614C29.9742 29.5667 31.0948 28.7606 31.424 27.5923C31.5776 27.0413 31.3612 26.1245 31.2074 25.5646C30.8551 25.858 30.3583 26.2345 29.9503 25.7813C29.9604 25.5783 30.0331 25.392 30.174 25.2415C30.7808 24.5873 30.2211 22.6704 31.7081 23.2422C31.9732 23.5495 31.8952 23.3771 31.9531 23.7855C31.7041 24.4087 31.1493 24.5302 31.2571 24.8295C32.5558 25.4542 34.5609 22.4836 32.9652 20.5007L32.8338 20.5043C32.7667 20.7869 32.7055 21.0741 32.6527 21.3601L32.5426 21.4276C31.9876 21.1839 31.6798 20.594 31.3565 20.0781C32.2484 19.059 32.5306 18.776 32.1129 17.4148L32.1946 17.3366C33.7395 17.8039 33.5772 18.7931 32.6634 19.8118L32.7344 19.929C33.4326 20.078 34.2691 18.9776 34.3643 18.3416C34.5449 17.3651 34.3719 17.02 33.9986 16.1967C33.4361 14.9637 31.0071 15.3913 31.0795 14.3111C31.1319 13.5467 31.5193 13.8632 30.9872 12.8977C31.5163 12.0417 33.3361 11.3516 31.4418 9.66974C31.2978 9.5435 31.1861 9.56637 31.0334 9.62003L31.1044 9.74787L31.1896 9.91122C31.3463 10.1948 31.3438 10.2254 31.3246 10.554C31.1622 10.8408 31.0419 11.0049 30.7209 11.0547C29.224 11.2864 29.5707 10.3296 29.2614 9.375C29.1156 8.93069 28.6838 8.64298 28.6222 8.12855L28.7145 8.07884L29.0874 8.24574L29.2116 8.13565C29.2704 6.7908 28.4298 5.61561 27.0561 5.60724C26.3011 5.60292 25.8629 5.9007 25.2486 6.29972C25.8555 6.3237 26.5305 6.33627 27.1307 6.38139C27.8871 6.88033 28.3705 7.4683 28.1392 8.46591C27.9347 8.66945 28.0427 8.64359 27.8267 8.64702C27.6624 8.30203 27.5457 7.94543 27.2834 7.70597L27.1911 7.73793C27.2324 8.09536 27.2627 8.35009 27.3366 8.70028C26.7201 7.52138 26.5311 6.86454 25.0781 6.95313L24.9077 7.07741C24.926 7.8583 26.4345 8.50158 26.1719 10.0071L26.0511 10.1349C25.4175 9.80859 25.0014 8.35877 24.4283 8.63281C24.1716 8.75608 24.0544 8.77999 23.924 9.03764C24.5965 9.95641 24.7767 10.2161 25.2131 11.2642C24.9773 12.491 25.1197 12.8407 25.5256 13.995C22.9794 12.3996 22.3706 14.1419 20.7244 13.3594L20.6001 13.3984C20.453 14.0087 20.9394 15.5867 21.2216 16.1541C21.3489 16.0397 21.3541 16.0034 21.5199 15.9588C22.0309 16.3595 23.0486 17.0886 23.6754 16.527C23.5421 16.2709 23.5194 16.2489 23.331 16.0263L23.4872 15.9233C23.8884 15.6469 23.8498 15.6706 24.0696 15.2095C24.8205 15.3341 23.9965 16.2283 26.0298 15.2734C26.6767 18.7074 25.0995 17.6463 24.5313 20.3232C25.0784 19.8578 25.2576 19.713 25.8771 19.3572C25.7202 22.874 25.6237 23.0742 22.6669 24.7124C20.5422 25.8891 21.0805 23.9633 20.0462 24.2401C19.7594 24.5247 19.7875 24.6028 19.478 24.6342C19.0596 24.364 18.7228 24.0488 19.0696 23.5831C19.8089 23.1824 20.806 23.3253 21.2536 22.9652L21.392 22.4716C21.1874 22.1032 19.7009 22.2234 19.1868 21.978L19.233 21.8501C20.3071 21.7176 21.6285 21.905 22.7131 22.0384C22.7926 21.7349 22.7813 21.8914 22.6669 21.5412C22.1357 21.2232 21.5127 21.1708 20.8239 20.8381L20.5043 20.7884L20.5469 20.6392C20.7463 19.3097 21.2058 20.1904 21.6619 19.517C21.6937 19.1959 21.7367 19.327 21.5945 19.0803C20.8596 18.7837 20.3629 19.4218 19.7798 18.782C19.6565 18.2255 19.8714 17.8138 19.8366 17.429C19.7522 16.5023 19.9246 14.4364 19.7976 13.679C19.5567 13.6373 19.4164 13.7217 19.1868 13.8104C17.6404 13.3257 17.7627 13.2548 16.0369 13.228C16.7587 12.6323 17.3038 11.9832 17.9474 11.4489C17.5698 10.9141 17.0817 10.3881 17.1378 9.74432C17.6359 8.92254 19.3103 9.19948 19.4744 8.54759C19.0334 8.09529 18.0269 7.74024 17.3899 7.70242C14.7745 7.54929 15.4441 10.3927 13.9134 11.2393L13.8281 11.1719C14.0258 10.8877 14.1675 10.7894 14.4247 10.5682C14.6398 8.3492 14.8672 7.22152 17.3828 6.87145L17.4822 6.78622C16.9989 6.2155 16.4153 6.47721 16.282 6.07599C16.5827 5.77274 16.7165 5.74716 17.1165 5.57173C16.5073 5.22959 15.1004 5.84665 14.5313 6.15767C15.5394 5.04956 16.1905 4.71257 17.5852 4.16193C17.9147 4.03215 18.1215 4.03539 18.1357 3.81392C17.1806 3.39213 15.7542 3.79923 14.8402 4.18679C12.7323 5.08092 12.1971 5.80325 11.3459 7.85156L11.3068 7.94034C10.2044 7.91647 9.71156 7.93502 8.85653 8.76776C8.23106 9.37739 8.21862 10.007 8.76065 10.6463C8.97991 10.0462 9.07314 9.06429 10.0994 9.27557C9.87576 9.7637 9.17711 10.8318 8.82457 11.2393C8.99703 11.4786 9.33146 11.8672 9.27557 12.1626C9.09852 13.077 7.90129 13.1708 7.30824 12.6456C7.19111 12.3452 7.20865 12.4968 7.29759 12.1555C7.56658 11.848 7.82326 11.7536 8.18892 11.5661L8.15341 11.4595C7.17812 11.1252 6.01088 11.9346 5.87358 12.9084C5.72236 13.9891 6.01032 15.4404 7.02415 15.9801L7.09517 15.8807C6.98929 15.5113 6.8354 15.1342 6.89986 14.7656L7.01705 14.6591L7.12003 14.7266C7.16831 14.758 7.21762 14.7904 7.26563 14.8224C7.31247 14.8538 7.36072 14.8871 7.40767 14.9183C7.60074 15.0449 8.42489 15.2326 8.46236 15.38C8.51088 15.5978 8.42397 15.8975 8.28125 16.0653C7.6466 16.8078 5.00252 15.9028 4.87926 18.8707C4.85417 19.4799 5.0294 20.0487 5.44744 20.4901C5.53976 20.5872 5.63598 20.6556 5.75284 20.7173L5.87003 20.6676C5.79127 19.9503 5.39433 19.0036 6.54119 18.7784L6.67259 18.8707C6.64597 19.0957 6.61726 19.238 6.54474 19.4496C6.2351 20.3501 7.10788 20.3747 6.7223 21.0369C6.87375 21.2378 7.01575 21.3012 7.22656 21.4311C6.98865 22.1151 5.40742 23.1617 6.05469 24.5384C6.42563 25.3252 7.48919 25.7439 8.2848 25.6534C8.8248 25.5921 9.06419 25.6572 9.39276 26.0973C9.17983 26.963 8.17597 27.3709 8.88139 28.5085C9.37008 29.2956 10.245 30.7354 11.1186 30.6143L11.2678 30.4901C10.9391 29.9612 10.4985 28.9628 10.4048 28.5263C10.5836 28.0525 10.7616 27.7414 11.2109 27.4893C11.9462 27.4771 11.9516 28.3114 11.9957 28.8956C12.219 29.1914 12.2894 30.3033 12.5639 30.5327C11.0039 31.2005 9.36912 31.8945 7.86577 32.6847C8.69505 33.1165 9.81054 33.6555 10.554 34.1868C10.6284 34.4274 10.589 34.3235 10.6783 34.5099C13.6009 35.4134 16.0508 34.8959 18.4411 35.9197L18.402 35.7422C17.931 33.7113 16.8484 30.7355 16.8679 28.7642L17.0099 28.6044C17.7967 29.0015 18.7744 33.0176 20.2912 30.5788C19.9968 29.9981 19.5382 28.2573 19.6804 27.6385C20.2334 26.9338 21.8931 26.716 22.6491 26.2536C23.6422 25.6448 24.7688 24.4953 25.4936 23.5831C25.4849 24.8239 25.4701 26.0715 25.4759 27.3118C25.4845 29.1817 25.5299 31.4765 26.7933 32.9332L26.4134 30.9872C28.35 32.0635 30.04 32.5737 31.9141 33.4908L30.9339 34.4993C28.2616 34.8781 25.8621 34.3881 23.1214 35.2805C25.2563 35.7058 26.61 35.7744 28.7926 35.7848L29.2294 36.5945C30.3354 37.0768 31.5962 37.3388 32.7734 37.6136C32.0643 36.9973 31.5516 36.5789 31.005 35.799C32.1322 34.3335 33.4041 33.9948 35.103 33.505C35.4741 33.3981 36.4655 33.1887 36.7436 33.0362C37.8385 32.4358 38.7642 32.0252 39.6413 31.7756C39.7019 31.5532 39.7552 31.3284 39.8011 31.1009L39.7514 31.4098C38.6881 36.3203 34.3197 40 29.0909 40H10.9091C4.88455 40 0.000620525 35.1153 0 29.0909V10.9091C0 4.88417 4.88417 1.75724e-07 10.9091 0H29.0909ZM0.0745739 30.1776C0.138184 30.7253 0.252495 31.2592 0.394176 31.7791C0.722332 31.886 1.04988 32.024 1.37429 32.2017C3.66089 33.4547 4.73238 33.3395 7.22656 32.8622C4.79669 31.0583 2.49331 30.3503 0.0745739 30.1776Z" fill="white"/>
+<path d="M39.9183 30.4119C39.9286 30.327 39.9384 30.2418 39.9467 30.1563H39.9609C39.9512 30.2418 39.9304 30.3271 39.9183 30.4119Z" fill="white"/>
+<path d="M16.9531 28.5795L16.8786 28.6967L16.9389 28.5724L16.9531 28.5795Z" fill="white"/>
+<path d="M7.48935 23.3487C8.27505 23.7906 8.51012 24.4987 8.03267 25.2805C7.02385 24.8215 6.51246 24.2827 7.48935 23.3487Z" fill="white"/>
+<path d="M27.6243 18.1747C27.6444 18.6975 27.2582 19.7308 26.8253 20.0604C26.5867 20.2418 26.337 20.1478 26.0724 20.1065C26.2174 19.5897 26.2062 19.3335 26.5447 18.995C26.802 18.9943 26.8605 18.9923 27.1129 18.9489C27.3922 18.7127 27.4611 18.5043 27.6243 18.1747Z" fill="white"/>
+<path d="M15.1456 16.2642C16.374 16.8352 16.6856 16.7653 17.9865 16.5021C17.2056 17.653 17.7478 17.5354 17.4645 18.6257C17.2913 18.8847 17.1691 19.1265 16.9105 19.2827C16.3586 18.7227 15.8338 18.1366 15.348 17.5142C15.0047 17.0737 15.0675 16.7869 15.1456 16.2642Z" fill="white"/>
+<path d="M28.4126 11.6406C28.6549 11.6788 29.3671 12.5976 29.6129 12.7024C29.8822 12.8147 30.2927 12.6806 30.5469 12.983C29.8665 13.6315 29.984 13.648 29.8438 14.6413C31.058 15.6215 31.7069 15.266 32.9865 16.0724C31.5805 15.8935 31.1608 15.7961 29.7834 15.3693C29.8113 15.6964 29.8437 15.6624 29.7585 15.9588C29.3889 15.9021 28.8581 15.2855 28.5405 14.9751L28.956 13.7216C28.3843 13.6476 26.9222 13.4173 27.2088 12.5284C27.668 12.6704 27.9973 12.9512 28.3949 12.9084L28.4943 12.7557C28.1313 12.352 27.5227 12.226 27.017 11.8466C27.5275 11.8177 27.9223 11.815 28.4126 11.6406Z" fill="white"/>
+</svg>
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Lightmode.svg b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Lightmode.svg
new file mode 100644
index 000000000..36c24b62e
--- /dev/null
+++ b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_Lightmode.svg
@@ -0,0 +1,3 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M28.9989 0C35.0738 0 39.9997 4.92452 40 10.9993V28.9989L39.9858 29.5651C39.701 35.1901 35.1901 39.701 29.5651 39.9858L28.9989 40H10.9993L10.4331 39.9858C4.62142 39.6909 0 34.8839 0 28.9989V10.9993C0.000287163 4.9247 4.9247 0.000282489 10.9993 0H28.9989ZM10.9993 0.905994C5.42507 0.906277 0.906281 5.42507 0.905994 10.9993V28.9989C0.905994 29.4305 0.93482 29.8556 0.987392 30.2729C3.07683 30.5503 5.10195 31.2905 7.22318 32.8653C4.75472 33.3376 3.67895 33.4547 1.44039 32.2424C2.79138 36.2259 6.55969 39.0938 10.9993 39.094H28.9989C33.4732 39.094 37.264 36.1805 38.5879 32.1486C38.017 32.3802 37.4084 32.6715 36.7388 33.0387C36.4605 33.1912 35.4694 33.4007 35.0984 33.5076C33.3997 33.9974 32.1274 34.3373 31.0002 35.8027C31.5468 36.5825 32.0606 37.0002 32.7697 37.6165C31.5926 37.3416 30.3314 37.0796 29.2254 36.5972L28.7883 35.7885C26.6058 35.7782 25.2518 35.7095 23.117 35.2842C25.8576 34.3919 28.2572 34.8809 30.9294 34.5021L31.9098 33.4935C30.0362 32.5766 28.3462 32.0672 26.4101 30.9914L26.7888 32.9361C25.5258 31.4794 25.4809 29.184 25.4722 27.3143C25.4665 26.0743 25.4813 24.8264 25.4899 23.5859C24.7651 24.4981 23.6376 25.6475 22.6445 26.2561C21.8886 26.7185 20.2304 26.9373 19.6771 27.6417C19.535 28.2605 19.9932 30.0019 20.2875 30.5826C18.7709 33.0208 17.7918 29.005 17.0051 28.6078L16.8635 28.7671C16.844 30.7383 17.9267 33.7153 18.3977 35.7461L18.4366 35.923C16.0465 34.8994 13.5962 35.4162 10.6737 34.5127C10.585 34.3272 10.6239 34.4302 10.5499 34.1907C9.80655 33.6594 8.69121 33.1202 7.86198 32.6883C9.36525 31.8982 11.0001 31.2044 12.5601 30.5366C12.2856 30.3072 12.2153 29.1939 11.992 28.898C11.948 28.3138 11.9413 27.4808 11.2064 27.493C10.7576 27.7451 10.58 28.0564 10.4012 28.53C10.4952 28.9668 10.9345 29.9655 11.263 30.4941L11.1144 30.618C10.241 30.7386 9.36635 29.2993 8.87768 28.5123C8.1723 27.3748 9.17609 26.9661 9.38907 26.1004C9.06062 25.6605 8.82097 25.595 8.28135 25.6563C7.48578 25.7468 6.42097 25.3282 6.04999 24.5415C5.40339 23.1652 6.98518 22.1181 7.22318 21.4342C7.01239 21.3043 6.87029 21.2404 6.71887 21.0396C7.10332 20.3781 6.23072 20.3524 6.54015 19.4523C6.61255 19.241 6.64272 19.0984 6.66932 18.8737L6.53661 18.7817C5.39057 19.0071 5.78721 19.9544 5.86596 20.6715L5.74917 20.7211C5.63234 20.6594 5.53534 20.59 5.44304 20.4928C5.02545 20.0516 4.84998 19.4825 4.87503 18.8737C4.99853 15.9064 7.6431 16.8113 8.27781 16.069C8.4203 15.9014 8.50642 15.6019 8.45831 15.3842C8.42086 15.2369 7.59718 15.0489 7.40367 14.9224C7.35696 14.8913 7.30873 14.858 7.26211 14.8268C7.21424 14.7949 7.16516 14.7609 7.11701 14.7295L7.01261 14.6622L6.89582 14.7684C6.83141 15.137 6.9846 15.5156 7.09047 15.885L7.01969 15.9841C6.0062 15.4443 5.71843 13.9928 5.8695 12.9122C6.00676 11.9387 7.17353 11.1294 8.14864 11.463L8.1858 11.5691C7.82038 11.7565 7.56277 11.8512 7.29396 12.1584C7.20509 12.4994 7.18765 12.3488 7.30458 12.6485C7.89762 13.1736 9.09517 13.0797 9.27228 12.1654C9.32736 11.8704 8.9935 11.4826 8.82106 11.2435C9.17349 10.8361 9.87123 9.76769 10.0951 9.27936C9.06969 9.06847 8.97633 10.0489 8.75735 10.649C8.21552 10.0097 8.22757 9.38106 8.85291 8.77151C9.70789 7.93884 10.2013 7.9195 11.3037 7.94338L11.3426 7.8549C12.1937 5.8071 12.7283 5.08419 14.8357 4.19022C15.7496 3.80267 17.1772 3.39507 18.1323 3.81685C18.1181 4.03805 17.9109 4.03597 17.582 4.16545C16.1874 4.71605 15.5358 5.05349 14.5278 6.16147C15.0971 5.8504 16.504 5.23368 17.113 5.57576C16.7131 5.75116 16.5785 5.77683 16.2778 6.08007C16.4114 6.48047 16.9945 6.21972 17.4775 6.78965L17.3785 6.87459C14.8634 7.22466 14.6366 8.3527 14.4216 10.5711C14.1644 10.7923 14.0211 10.8921 13.8235 11.1763L13.9102 11.2435C15.4404 10.3967 14.7707 7.55341 17.3855 7.70626C18.0222 7.74407 19.0287 8.09832 19.47 8.55032C19.3058 9.20207 17.6324 8.92657 17.1343 9.74829C17.0785 10.3917 17.5654 10.9178 17.9429 11.4523C17.2997 11.9864 16.7549 12.6353 16.0336 13.2307C17.7587 13.2575 17.6372 13.33 19.1834 13.8146C19.4128 13.726 19.5531 13.6403 19.7939 13.6819C19.9208 14.4394 19.7484 16.5067 19.8328 17.4333C19.8671 17.8179 19.653 18.2293 19.7762 18.7852C20.3591 19.4247 20.8552 18.788 21.5899 19.0843C21.732 19.3306 21.6889 19.2003 21.6572 19.5213C21.2012 20.1928 20.7417 19.3144 20.5424 20.6432L20.4999 20.7919L20.8202 20.8414C21.5086 21.1739 22.1313 21.2263 22.6622 21.5439C22.7766 21.8938 22.7877 21.7382 22.7083 22.0411C21.624 21.9079 20.3032 21.7211 19.2294 21.8536L19.1834 21.981C19.6978 22.2261 21.1833 22.1065 21.3882 22.4747L21.2502 22.9684C20.8026 23.3284 19.8041 23.1853 19.0648 23.5859C18.7182 24.0514 19.0555 24.3668 19.4736 24.637C19.7828 24.6056 19.7556 24.5283 20.0416 24.2442C21.0759 23.9674 20.5378 25.8914 22.6622 24.7149C25.6189 23.0767 25.7153 22.8769 25.8722 19.3603C25.2531 19.7158 25.0742 19.8614 24.5273 20.3265C25.0956 17.6498 26.6729 18.71 26.0261 15.2763C23.9929 16.2311 24.8163 15.3372 24.0655 15.2126C23.8457 15.6735 23.8845 15.6511 23.4833 15.9274L23.3276 16.0301C23.5155 16.2522 23.5377 16.275 23.6709 16.5309C23.0441 17.0916 22.0265 16.3635 21.5156 15.9628C21.3504 16.0073 21.345 16.0435 21.2183 16.1575C20.9362 15.5903 20.4487 14.0131 20.5954 13.4023L20.7211 13.3634C22.3665 14.1449 22.9761 12.4035 25.5218 13.9987C25.116 12.8446 24.973 12.4945 25.2086 11.2683C24.7722 10.2202 24.5928 9.95917 23.9204 9.04048C24.0506 8.78357 24.1683 8.76015 24.4247 8.63703C24.9978 8.36338 25.4138 9.81303 26.0473 10.1393L26.1677 10.0102C26.4299 8.50547 24.9235 7.86208 24.9042 7.08162L25.0741 6.95598C26.5269 6.86745 26.7154 7.52542 27.332 8.70427C27.2581 8.35416 27.2282 8.09895 27.1869 7.74165L27.2789 7.7098C27.5412 7.94925 27.6579 8.30622 27.8222 8.65118C28.0381 8.64776 27.9309 8.6724 28.1354 8.46892C28.3663 7.47171 27.8829 6.88325 27.1267 6.38443C26.5266 6.3393 25.8509 6.32702 25.244 6.30303C25.8582 5.90402 26.2974 5.60682 27.0524 5.61115C28.4259 5.61978 29.2665 6.79511 29.2077 8.13979L29.0838 8.2495L28.7105 8.08317L28.6184 8.13271C28.6804 8.64664 29.1115 8.93441 29.2572 9.37846C29.5665 10.333 29.2203 11.2895 30.7171 11.0577C31.0377 11.0078 31.1583 10.8435 31.3205 10.557C31.3396 10.229 31.3425 10.1979 31.186 9.91462L31.1011 9.75182L31.0285 9.62442C31.1813 9.57077 31.2933 9.54772 31.4373 9.67397C33.3312 11.3556 31.5116 12.0456 30.9825 12.9016C31.5145 13.8669 31.1269 13.5511 31.0745 14.3154C31.0036 15.3942 33.4318 14.9676 33.9942 16.2C34.3675 17.023 34.5409 17.3685 34.3605 18.3446C34.2652 18.9805 33.4289 20.0802 32.7308 19.9319L32.6583 19.8151C33.572 18.7965 33.7354 17.8068 32.1911 17.3395L32.1079 17.4174C32.5256 18.7785 32.2442 19.0632 31.3524 20.0823C31.6754 20.5978 31.9835 21.187 32.5379 21.4307L32.6476 21.3634C32.7005 21.0775 32.7628 20.7896 32.8299 20.507L32.9608 20.5034C34.5562 22.4861 32.5519 25.457 31.2533 24.8334C31.1455 24.5342 31.6996 24.412 31.9487 23.7894C31.8908 23.3814 31.9688 23.5525 31.7045 23.2462C30.2181 22.6746 30.776 24.5891 30.1703 25.244C30.0294 25.3945 29.9557 25.5825 29.9456 25.7854C30.3535 26.2382 30.8515 25.8611 31.2037 25.5678C31.3575 26.1276 31.5732 27.0447 31.4196 27.5957C31.0904 28.7638 29.9697 29.5696 28.8025 29.2643L28.7494 29.1334C29.192 28.8373 29.7533 28.665 29.8076 28.1035C29.5657 27.7206 29.0394 27.6615 28.6326 27.6169C27.9974 27.5474 28.3521 28.4126 28.2238 28.806C28.1437 29.0513 27.909 30.3425 27.7408 30.5295C29.3424 31.2985 31.1271 32.0425 32.7768 32.8193C35.3529 31.3319 37.1573 30.5813 39.0091 30.2765C39.062 29.8579 39.094 29.4319 39.094 28.9989V10.9993C39.0937 5.42489 34.5734 0.905994 28.9989 0.905994H10.9993ZM16.8741 28.6998L16.9485 28.5831L16.9343 28.576L16.8741 28.6998ZM7.48507 23.3524C6.50874 24.2861 7.01969 24.8257 8.02831 25.2847C8.50574 24.5029 8.27073 23.7942 7.48507 23.3524ZM27.6204 18.1783C27.4573 18.5076 27.3879 18.7156 27.109 18.9516C26.8568 18.9949 26.7979 18.9986 26.541 18.9993C26.2028 19.3377 26.2135 19.5939 26.0686 20.1106C26.3327 20.1518 26.5823 20.2452 26.8206 20.0646C27.2534 19.7351 27.6405 18.7012 27.6204 18.1783ZM15.1418 16.2672C15.0636 16.7898 15.0003 17.0778 15.3435 17.5182C15.8292 18.1405 16.3543 18.7262 16.906 19.286C17.1644 19.1299 17.2869 18.8883 17.4599 18.6295C17.7431 17.5394 17.2016 17.6562 17.9819 16.5061C16.6815 16.7692 16.3699 16.838 15.1418 16.2672ZM28.4079 11.6434C27.9179 11.8176 27.5235 11.8216 27.0135 11.8505C27.519 12.2296 28.1264 12.3564 28.4893 12.76L28.3902 12.9122C27.9929 12.9546 27.6635 12.6737 27.2046 12.5317C26.9183 13.4201 28.379 13.6503 28.9511 13.7244L28.537 14.979C28.8548 15.2896 29.3851 15.9061 29.7545 15.9628C29.8395 15.6667 29.8071 15.6997 29.7793 15.3736C31.1563 15.8003 31.5764 15.8972 32.9821 16.0761C31.7025 15.2697 31.0536 15.6246 29.8394 14.6445C29.9796 13.6517 29.8622 13.6345 30.5419 12.9865C30.2878 12.6847 29.8786 12.8172 29.6094 12.7052C29.3636 12.6003 28.6501 11.6817 28.4079 11.6434Z" fill="black"/>
+</svg>
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_dark.svg b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_dark.svg
new file mode 100644
index 000000000..58fdf82f1
--- /dev/null
+++ b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_dark.svg
@@ -0,0 +1,9 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M29.0909 0C35.1158 0 40 4.88417 40 10.9091V29.0909C40 29.4504 39.9808 29.8057 39.9467 30.1563C37.7411 30.3474 35.7861 31.0806 32.7805 32.8161C31.1307 32.0392 29.3467 31.2946 27.745 30.5256C27.9132 30.3385 28.1479 29.0483 28.228 28.8033C28.3567 28.4101 28.0009 27.5441 28.6364 27.6136C29.0433 27.6582 29.5699 27.7171 29.8118 28.1001C29.7576 28.6618 29.1962 28.8339 28.7536 29.13L28.8068 29.2614C29.9742 29.5667 31.0948 28.7606 31.424 27.5923C31.5776 27.0413 31.3612 26.1245 31.2074 25.5646C30.8551 25.858 30.3583 26.2345 29.9503 25.7813C29.9604 25.5783 30.0331 25.392 30.174 25.2415C30.7808 24.5873 30.2211 22.6704 31.7081 23.2422C31.9732 23.5495 31.8952 23.3771 31.9531 23.7855C31.7041 24.4087 31.1493 24.5302 31.2571 24.8295C32.5558 25.4542 34.5609 22.4836 32.9652 20.5007L32.8338 20.5043C32.7667 20.7869 32.7055 21.0741 32.6527 21.3601L32.5426 21.4276C31.9876 21.1839 31.6798 20.594 31.3565 20.0781C32.2484 19.059 32.5306 18.776 32.1129 17.4148L32.1946 17.3366C33.7395 17.8039 33.5772 18.7931 32.6634 19.8118L32.7344 19.929C33.4326 20.078 34.2691 18.9776 34.3643 18.3416C34.5449 17.3651 34.3719 17.02 33.9986 16.1967C33.4361 14.9637 31.0071 15.3913 31.0795 14.3111C31.1319 13.5467 31.5193 13.8632 30.9872 12.8977C31.5163 12.0417 33.3361 11.3516 31.4418 9.66974C31.2978 9.5435 31.1861 9.56637 31.0334 9.62003L31.1044 9.74787L31.1896 9.91122C31.3463 10.1948 31.3438 10.2254 31.3246 10.554C31.1622 10.8408 31.0419 11.0049 30.7209 11.0547C29.224 11.2864 29.5707 10.3296 29.2614 9.375C29.1156 8.93069 28.6838 8.64298 28.6222 8.12855L28.7145 8.07884L29.0874 8.24574L29.2116 8.13565C29.2704 6.7908 28.4298 5.61561 27.0561 5.60724C26.3011 5.60292 25.8629 5.9007 25.2486 6.29972C25.8555 6.3237 26.5305 6.33627 27.1307 6.38139C27.8871 6.88033 28.3705 7.4683 28.1392 8.46591C27.9347 8.66945 28.0427 8.64359 27.8267 8.64702C27.6624 8.30203 27.5457 7.94543 27.2834 7.70597L27.1911 7.73793C27.2324 8.09536 27.2627 8.35009 27.3366 8.70028C26.7201 7.52138 26.5311 6.86454 25.0781 6.95313L24.9077 7.07741C24.926 7.8583 26.4345 8.50158 26.1719 10.0071L26.0511 10.1349C25.4175 9.80859 25.0014 8.35877 24.4283 8.63281C24.1716 8.75608 24.0544 8.77999 23.924 9.03764C24.5965 9.95641 24.7767 10.2161 25.2131 11.2642C24.9773 12.491 25.1197 12.8407 25.5256 13.995C22.9794 12.3996 22.3706 14.1419 20.7244 13.3594L20.6001 13.3984C20.453 14.0087 20.9394 15.5867 21.2216 16.1541C21.3489 16.0397 21.3541 16.0034 21.5199 15.9588C22.0309 16.3595 23.0486 17.0886 23.6754 16.527C23.5421 16.2709 23.5194 16.2489 23.331 16.0263L23.4872 15.9233C23.8884 15.6469 23.8498 15.6706 24.0696 15.2095C24.8205 15.3341 23.9965 16.2283 26.0298 15.2734C26.6767 18.7074 25.0995 17.6463 24.5313 20.3232C25.0784 19.8578 25.2576 19.713 25.8771 19.3572C25.7202 22.874 25.6237 23.0742 22.6669 24.7124C20.5422 25.8891 21.0805 23.9633 20.0462 24.2401C19.7594 24.5247 19.7875 24.6028 19.478 24.6342C19.0596 24.364 18.7228 24.0488 19.0696 23.5831C19.8089 23.1824 20.806 23.3253 21.2536 22.9652L21.392 22.4716C21.1874 22.1032 19.7009 22.2234 19.1868 21.978L19.233 21.8501C20.3071 21.7176 21.6285 21.905 22.7131 22.0384C22.7926 21.7349 22.7813 21.8914 22.6669 21.5412C22.1357 21.2232 21.5127 21.1708 20.8239 20.8381L20.5043 20.7884L20.5469 20.6392C20.7463 19.3097 21.2058 20.1904 21.6619 19.517C21.6937 19.1959 21.7367 19.327 21.5945 19.0803C20.8596 18.7837 20.3629 19.4218 19.7798 18.782C19.6565 18.2255 19.8714 17.8138 19.8366 17.429C19.7522 16.5023 19.9246 14.4364 19.7976 13.679C19.5567 13.6373 19.4164 13.7217 19.1868 13.8104C17.6404 13.3257 17.7627 13.2548 16.0369 13.228C16.7587 12.6323 17.3038 11.9832 17.9474 11.4489C17.5698 10.9141 17.0817 10.3881 17.1378 9.74432C17.6359 8.92254 19.3103 9.19948 19.4744 8.54759C19.0334 8.09529 18.0269 7.74024 17.3899 7.70242C14.7745 7.54929 15.4441 10.3927 13.9134 11.2393L13.8281 11.1719C14.0258 10.8877 14.1675 10.7894 14.4247 10.5682C14.6398 8.3492 14.8672 7.22152 17.3828 6.87145L17.4822 6.78622C16.9989 6.2155 16.4153 6.47721 16.282 6.07599C16.5827 5.77274 16.7165 5.74716 17.1165 5.57173C16.5073 5.22959 15.1004 5.84665 14.5313 6.15767C15.5394 5.04956 16.1905 4.71257 17.5852 4.16193C17.9147 4.03215 18.1215 4.03539 18.1357 3.81392C17.1806 3.39213 15.7542 3.79923 14.8402 4.18679C12.7323 5.08092 12.1971 5.80325 11.3459 7.85156L11.3068 7.94034C10.2044 7.91647 9.71156 7.93502 8.85653 8.76776C8.23106 9.37739 8.21862 10.007 8.76065 10.6463C8.97991 10.0462 9.07314 9.06429 10.0994 9.27557C9.87576 9.7637 9.17711 10.8318 8.82457 11.2393C8.99703 11.4786 9.33146 11.8672 9.27557 12.1626C9.09852 13.077 7.90129 13.1708 7.30824 12.6456C7.19111 12.3452 7.20865 12.4968 7.29759 12.1555C7.56658 11.848 7.82326 11.7536 8.18892 11.5661L8.15341 11.4595C7.17812 11.1252 6.01088 11.9346 5.87358 12.9084C5.72236 13.9891 6.01032 15.4404 7.02415 15.9801L7.09517 15.8807C6.98929 15.5113 6.8354 15.1342 6.89986 14.7656L7.01705 14.6591L7.12003 14.7266C7.16831 14.758 7.21762 14.7904 7.26563 14.8224C7.31247 14.8538 7.36072 14.8871 7.40767 14.9183C7.60074 15.0449 8.42489 15.2326 8.46236 15.38C8.51088 15.5978 8.42397 15.8975 8.28125 16.0653C7.6466 16.8078 5.00252 15.9028 4.87926 18.8707C4.85417 19.4799 5.0294 20.0487 5.44744 20.4901C5.53976 20.5872 5.63598 20.6556 5.75284 20.7173L5.87003 20.6676C5.79127 19.9503 5.39433 19.0036 6.54119 18.7784L6.67259 18.8707C6.64597 19.0957 6.61726 19.238 6.54474 19.4496C6.2351 20.3501 7.10788 20.3747 6.7223 21.0369C6.87375 21.2378 7.01575 21.3012 7.22656 21.4311C6.98865 22.1151 5.40742 23.1617 6.05469 24.5384C6.42563 25.3252 7.48919 25.7439 8.2848 25.6534C8.8248 25.5921 9.06419 25.6572 9.39276 26.0973C9.17983 26.963 8.17597 27.3709 8.88139 28.5085C9.37008 29.2956 10.245 30.7354 11.1186 30.6143L11.2678 30.4901C10.9391 29.9612 10.4985 28.9628 10.4048 28.5263C10.5836 28.0525 10.7616 27.7414 11.2109 27.4893C11.9462 27.4771 11.9516 28.3114 11.9957 28.8956C12.219 29.1914 12.2894 30.3033 12.5639 30.5327C11.0039 31.2005 9.36912 31.8945 7.86577 32.6847C8.69505 33.1165 9.81054 33.6555 10.554 34.1868C10.6284 34.4274 10.589 34.3235 10.6783 34.5099C13.6009 35.4134 16.0508 34.8959 18.4411 35.9197L18.402 35.7422C17.931 33.7113 16.8484 30.7355 16.8679 28.7642L17.0099 28.6044C17.7967 29.0015 18.7744 33.0176 20.2912 30.5788C19.9968 29.9981 19.5382 28.2573 19.6804 27.6385C20.2334 26.9338 21.8931 26.716 22.6491 26.2536C23.6422 25.6448 24.7688 24.4953 25.4936 23.5831C25.4849 24.8239 25.4701 26.0715 25.4759 27.3118C25.4845 29.1817 25.5299 31.4765 26.7933 32.9332L26.4134 30.9872C28.35 32.0635 30.04 32.5737 31.9141 33.4908L30.9339 34.4993C28.2616 34.8781 25.8621 34.3881 23.1214 35.2805C25.2563 35.7058 26.61 35.7744 28.7926 35.7848L29.2294 36.5945C30.3354 37.0768 31.5962 37.3388 32.7734 37.6136C32.0643 36.9973 31.5516 36.5789 31.005 35.799C32.1322 34.3335 33.4041 33.9948 35.103 33.505C35.4741 33.3981 36.4655 33.1887 36.7436 33.0362C37.8385 32.4358 38.7642 32.0252 39.6413 31.7756C39.7019 31.5532 39.7552 31.3284 39.8011 31.1009L39.7514 31.4098C38.6881 36.3203 34.3197 40 29.0909 40H10.9091C4.88455 40 0.000620525 35.1153 0 29.0909V10.9091C0 4.88417 4.88417 1.75724e-07 10.9091 0H29.0909ZM0.0745739 30.1776C0.138184 30.7253 0.252495 31.2592 0.394176 31.7791C0.722332 31.886 1.04988 32.024 1.37429 32.2017C3.66089 33.4547 4.73238 33.3395 7.22656 32.8622C4.79669 31.0583 2.49331 30.3503 0.0745739 30.1776Z" fill="#0A0A0A"/>
+<path d="M39.9183 30.4119C39.9286 30.327 39.9384 30.2418 39.9467 30.1563H39.9609C39.9512 30.2418 39.9304 30.3271 39.9183 30.4119Z" fill="#0A0A0A"/>
+<path d="M16.9531 28.5795L16.8786 28.6967L16.9389 28.5724L16.9531 28.5795Z" fill="#0A0A0A"/>
+<path d="M7.48935 23.3487C8.27505 23.7906 8.51012 24.4987 8.03267 25.2805C7.02385 24.8215 6.51246 24.2827 7.48935 23.3487Z" fill="#0A0A0A"/>
+<path d="M27.6243 18.1747C27.6444 18.6975 27.2582 19.7308 26.8253 20.0604C26.5867 20.2418 26.337 20.1478 26.0724 20.1065C26.2174 19.5897 26.2062 19.3335 26.5447 18.995C26.802 18.9943 26.8605 18.9923 27.1129 18.9489C27.3922 18.7127 27.4611 18.5043 27.6243 18.1747Z" fill="#0A0A0A"/>
+<path d="M15.1456 16.2642C16.374 16.8352 16.6856 16.7653 17.9865 16.5021C17.2056 17.653 17.7478 17.5354 17.4645 18.6257C17.2913 18.8847 17.1691 19.1265 16.9105 19.2827C16.3586 18.7227 15.8338 18.1366 15.348 17.5142C15.0047 17.0737 15.0675 16.7869 15.1456 16.2642Z" fill="#0A0A0A"/>
+<path d="M28.4126 11.6406C28.6549 11.6788 29.3671 12.5976 29.6129 12.7024C29.8822 12.8147 30.2927 12.6806 30.5469 12.983C29.8665 13.6315 29.984 13.648 29.8438 14.6413C31.058 15.6215 31.7069 15.266 32.9865 16.0724C31.5805 15.8935 31.1608 15.7961 29.7834 15.3693C29.8113 15.6964 29.8437 15.6624 29.7585 15.9588C29.3889 15.9021 28.8581 15.2855 28.5405 14.9751L28.956 13.7216C28.3843 13.6476 26.9222 13.4173 27.2088 12.5284C27.668 12.6704 27.9973 12.9512 28.3949 12.9084L28.4943 12.7557C28.1313 12.352 27.5227 12.226 27.017 11.8466C27.5275 11.8177 27.9223 11.815 28.4126 11.6406Z" fill="#0A0A0A"/>
+</svg>
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_light.svg b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_light.svg
new file mode 100644
index 000000000..d0ae9ef23
--- /dev/null
+++ b/docs/branding/app-logo/team-symbols-2026-09-30/Symbol Harness_light.svg
@@ -0,0 +1,9 @@
+<svg width="40" height="40" viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M29.0909 0C35.1158 0 40 4.88417 40 10.9091V29.0909C40 29.4504 39.9808 29.8057 39.9467 30.1563C37.7411 30.3474 35.7861 31.0806 32.7805 32.8161C31.1307 32.0392 29.3467 31.2946 27.745 30.5256C27.9132 30.3385 28.1479 29.0483 28.228 28.8033C28.3567 28.4101 28.0009 27.5441 28.6364 27.6136C29.0433 27.6582 29.5699 27.7171 29.8118 28.1001C29.7576 28.6618 29.1962 28.8339 28.7536 29.13L28.8068 29.2614C29.9742 29.5667 31.0948 28.7606 31.424 27.5923C31.5776 27.0413 31.3612 26.1245 31.2074 25.5646C30.8551 25.858 30.3583 26.2345 29.9503 25.7813C29.9604 25.5783 30.0331 25.392 30.174 25.2415C30.7808 24.5873 30.2211 22.6704 31.7081 23.2422C31.9732 23.5495 31.8952 23.3771 31.9531 23.7855C31.7041 24.4087 31.1493 24.5302 31.2571 24.8295C32.5558 25.4542 34.5609 22.4836 32.9652 20.5007L32.8338 20.5043C32.7667 20.7869 32.7055 21.0741 32.6527 21.3601L32.5426 21.4276C31.9876 21.1839 31.6798 20.594 31.3565 20.0781C32.2484 19.059 32.5306 18.776 32.1129 17.4148L32.1946 17.3366C33.7395 17.8039 33.5772 18.7931 32.6634 19.8118L32.7344 19.929C33.4326 20.078 34.2691 18.9776 34.3643 18.3416C34.5449 17.3651 34.3719 17.02 33.9986 16.1967C33.4361 14.9637 31.0071 15.3913 31.0795 14.3111C31.1319 13.5467 31.5193 13.8632 30.9872 12.8977C31.5163 12.0417 33.3361 11.3516 31.4418 9.66974C31.2978 9.5435 31.1861 9.56637 31.0334 9.62003L31.1044 9.74787L31.1896 9.91122C31.3463 10.1948 31.3438 10.2254 31.3246 10.554C31.1622 10.8408 31.0419 11.0049 30.7209 11.0547C29.224 11.2864 29.5707 10.3296 29.2614 9.375C29.1156 8.93069 28.6838 8.64298 28.6222 8.12855L28.7145 8.07884L29.0874 8.24574L29.2116 8.13565C29.2704 6.7908 28.4298 5.61561 27.0561 5.60724C26.3011 5.60292 25.8629 5.9007 25.2486 6.29972C25.8555 6.3237 26.5305 6.33627 27.1307 6.38139C27.8871 6.88033 28.3705 7.4683 28.1392 8.46591C27.9347 8.66945 28.0427 8.64359 27.8267 8.64702C27.6624 8.30203 27.5457 7.94543 27.2834 7.70597L27.1911 7.73793C27.2324 8.09536 27.2627 8.35009 27.3366 8.70028C26.7201 7.52138 26.5311 6.86454 25.0781 6.95313L24.9077 7.07741C24.926 7.8583 26.4345 8.50158 26.1719 10.0071L26.0511 10.1349C25.4175 9.80859 25.0014 8.35877 24.4283 8.63281C24.1716 8.75608 24.0544 8.77999 23.924 9.03764C24.5965 9.95641 24.7767 10.2161 25.2131 11.2642C24.9773 12.491 25.1197 12.8407 25.5256 13.995C22.9794 12.3996 22.3706 14.1419 20.7244 13.3594L20.6001 13.3984C20.453 14.0087 20.9394 15.5867 21.2216 16.1541C21.3489 16.0397 21.3541 16.0034 21.5199 15.9588C22.0309 16.3595 23.0486 17.0886 23.6754 16.527C23.5421 16.2709 23.5194 16.2489 23.331 16.0263L23.4872 15.9233C23.8884 15.6469 23.8498 15.6706 24.0696 15.2095C24.8205 15.3341 23.9965 16.2283 26.0298 15.2734C26.6767 18.7074 25.0995 17.6463 24.5313 20.3232C25.0784 19.8578 25.2576 19.713 25.8771 19.3572C25.7202 22.874 25.6237 23.0742 22.6669 24.7124C20.5422 25.8891 21.0805 23.9633 20.0462 24.2401C19.7594 24.5247 19.7875 24.6028 19.478 24.6342C19.0596 24.364 18.7228 24.0488 19.0696 23.5831C19.8089 23.1824 20.806 23.3253 21.2536 22.9652L21.392 22.4716C21.1874 22.1032 19.7009 22.2234 19.1868 21.978L19.233 21.8501C20.3071 21.7176 21.6285 21.905 22.7131 22.0384C22.7926 21.7349 22.7813 21.8914 22.6669 21.5412C22.1357 21.2232 21.5127 21.1708 20.8239 20.8381L20.5043 20.7884L20.5469 20.6392C20.7463 19.3097 21.2058 20.1904 21.6619 19.517C21.6937 19.1959 21.7367 19.327 21.5945 19.0803C20.8596 18.7837 20.3629 19.4218 19.7798 18.782C19.6565 18.2255 19.8714 17.8138 19.8366 17.429C19.7522 16.5023 19.9246 14.4364 19.7976 13.679C19.5567 13.6373 19.4164 13.7217 19.1868 13.8104C17.6404 13.3257 17.7627 13.2548 16.0369 13.228C16.7587 12.6323 17.3038 11.9832 17.9474 11.4489C17.5698 10.9141 17.0817 10.3881 17.1378 9.74432C17.6359 8.92254 19.3103 9.19948 19.4744 8.54759C19.0334 8.09529 18.0269 7.74024 17.3899 7.70242C14.7745 7.54929 15.4441 10.3927 13.9134 11.2393L13.8281 11.1719C14.0258 10.8877 14.1675 10.7894 14.4247 10.5682C14.6398 8.3492 14.8672 7.22152 17.3828 6.87145L17.4822 6.78622C16.9989 6.2155 16.4153 6.47721 16.282 6.07599C16.5827 5.77274 16.7165 5.74716 17.1165 5.57173C16.5073 5.22959 15.1004 5.84665 14.5313 6.15767C15.5394 5.04956 16.1905 4.71257 17.5852 4.16193C17.9147 4.03215 18.1215 4.03539 18.1357 3.81392C17.1806 3.39213 15.7542 3.79923 14.8402 4.18679C12.7323 5.08092 12.1971 5.80325 11.3459 7.85156L11.3068 7.94034C10.2044 7.91647 9.71156 7.93502 8.85653 8.76776C8.23106 9.37739 8.21862 10.007 8.76065 10.6463C8.97991 10.0462 9.07314 9.06429 10.0994 9.27557C9.87576 9.7637 9.17711 10.8318 8.82457 11.2393C8.99703 11.4786 9.33146 11.8672 9.27557 12.1626C9.09852 13.077 7.90129 13.1708 7.30824 12.6456C7.19111 12.3452 7.20865 12.4968 7.29759 12.1555C7.56658 11.848 7.82326 11.7536 8.18892 11.5661L8.15341 11.4595C7.17812 11.1252 6.01088 11.9346 5.87358 12.9084C5.72236 13.9891 6.01032 15.4404 7.02415 15.9801L7.09517 15.8807C6.98929 15.5113 6.8354 15.1342 6.89986 14.7656L7.01705 14.6591L7.12003 14.7266C7.16831 14.758 7.21762 14.7904 7.26563 14.8224C7.31247 14.8538 7.36072 14.8871 7.40767 14.9183C7.60074 15.0449 8.42489 15.2326 8.46236 15.38C8.51088 15.5978 8.42397 15.8975 8.28125 16.0653C7.6466 16.8078 5.00252 15.9028 4.87926 18.8707C4.85417 19.4799 5.0294 20.0487 5.44744 20.4901C5.53976 20.5872 5.63598 20.6556 5.75284 20.7173L5.87003 20.6676C5.79127 19.9503 5.39433 19.0036 6.54119 18.7784L6.67259 18.8707C6.64597 19.0957 6.61726 19.238 6.54474 19.4496C6.2351 20.3501 7.10788 20.3747 6.7223 21.0369C6.87375 21.2378 7.01575 21.3012 7.22656 21.4311C6.98865 22.1151 5.40742 23.1617 6.05469 24.5384C6.42563 25.3252 7.48919 25.7439 8.2848 25.6534C8.8248 25.5921 9.06419 25.6572 9.39276 26.0973C9.17983 26.963 8.17597 27.3709 8.88139 28.5085C9.37008 29.2956 10.245 30.7354 11.1186 30.6143L11.2678 30.4901C10.9391 29.9612 10.4985 28.9628 10.4048 28.5263C10.5836 28.0525 10.7616 27.7414 11.2109 27.4893C11.9462 27.4771 11.9516 28.3114 11.9957 28.8956C12.219 29.1914 12.2894 30.3033 12.5639 30.5327C11.0039 31.2005 9.36912 31.8945 7.86577 32.6847C8.69505 33.1165 9.81054 33.6555 10.554 34.1868C10.6284 34.4274 10.589 34.3235 10.6783 34.5099C13.6009 35.4134 16.0508 34.8959 18.4411 35.9197L18.402 35.7422C17.931 33.7113 16.8484 30.7355 16.8679 28.7642L17.0099 28.6044C17.7967 29.0015 18.7744 33.0176 20.2912 30.5788C19.9968 29.9981 19.5382 28.2573 19.6804 27.6385C20.2334 26.9338 21.8931 26.716 22.6491 26.2536C23.6422 25.6448 24.7688 24.4953 25.4936 23.5831C25.4849 24.8239 25.4701 26.0715 25.4759 27.3118C25.4845 29.1817 25.5299 31.4765 26.7933 32.9332L26.4134 30.9872C28.35 32.0635 30.04 32.5737 31.9141 33.4908L30.9339 34.4993C28.2616 34.8781 25.8621 34.3881 23.1214 35.2805C25.2563 35.7058 26.61 35.7744 28.7926 35.7848L29.2294 36.5945C30.3354 37.0768 31.5962 37.3388 32.7734 37.6136C32.0643 36.9973 31.5516 36.5789 31.005 35.799C32.1322 34.3335 33.4041 33.9948 35.103 33.505C35.4741 33.3981 36.4655 33.1887 36.7436 33.0362C37.8385 32.4358 38.7642 32.0252 39.6413 31.7756C39.7019 31.5532 39.7552 31.3284 39.8011 31.1009L39.7514 31.4098C38.6881 36.3203 34.3197 40 29.0909 40H10.9091C4.88455 40 0.000620525 35.1153 0 29.0909V10.9091C0 4.88417 4.88417 1.75724e-07 10.9091 0H29.0909ZM0.0745739 30.1776C0.138184 30.7253 0.252495 31.2592 0.394176 31.7791C0.722332 31.886 1.04988 32.024 1.37429 32.2017C3.66089 33.4547 4.73238 33.3395 7.22656 32.8622C4.79669 31.0583 2.49331 30.3503 0.0745739 30.1776Z" fill="white"/>
+<path d="M39.9183 30.4119C39.9286 30.327 39.9384 30.2418 39.9467 30.1563H39.9609C39.9512 30.2418 39.9304 30.3271 39.9183 30.4119Z" fill="white"/>
+<path d="M16.9531 28.5795L16.8786 28.6967L16.9389 28.5724L16.9531 28.5795Z" fill="white"/>
+<path d="M7.48935 23.3487C8.27505 23.7906 8.51012 24.4987 8.03267 25.2805C7.02385 24.8215 6.51246 24.2827 7.48935 23.3487Z" fill="white"/>
+<path d="M27.6243 18.1747C27.6444 18.6975 27.2582 19.7308 26.8253 20.0604C26.5867 20.2418 26.337 20.1478 26.0724 20.1065C26.2174 19.5897 26.2062 19.3335 26.5447 18.995C26.802 18.9943 26.8605 18.9923 27.1129 18.9489C27.3922 18.7127 27.4611 18.5043 27.6243 18.1747Z" fill="white"/>
+<path d="M15.1456 16.2642C16.374 16.8352 16.6856 16.7653 17.9865 16.5021C17.2056 17.653 17.7478 17.5354 17.4645 18.6257C17.2913 18.8847 17.1691 19.1265 16.9105 19.2827C16.3586 18.7227 15.8338 18.1366 15.348 17.5142C15.0047 17.0737 15.0675 16.7869 15.1456 16.2642Z" fill="white"/>
+<path d="M28.4126 11.6406C28.6549 11.6788 29.3671 12.5976 29.6129 12.7024C29.8822 12.8147 30.2927 12.6806 30.5469 12.983C29.8665 13.6315 29.984 13.648 29.8438 14.6413C31.058 15.6215 31.7069 15.266 32.9865 16.0724C31.5805 15.8935 31.1608 15.7961 29.7834 15.3693C29.8113 15.6964 29.8437 15.6624 29.7585 15.9588C29.3889 15.9021 28.8581 15.2855 28.5405 14.9751L28.956 13.7216C28.3843 13.6476 26.9222 13.4173 27.2088 12.5284C27.668 12.6704 27.9973 12.9512 28.3949 12.9084L28.4943 12.7557C28.1313 12.352 27.5227 12.226 27.017 11.8466C27.5275 11.8177 27.9223 11.815 28.4126 11.6406Z" fill="white"/>
+</svg>
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/dock-dark.png b/docs/branding/app-logo/team-symbols-2026-09-30/dock-dark.png
new file mode 100644
index 000000000..d49c1bb6e
Binary files /dev/null and b/docs/branding/app-logo/team-symbols-2026-09-30/dock-dark.png differ
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/dock-light.png b/docs/branding/app-logo/team-symbols-2026-09-30/dock-light.png
new file mode 100644
index 000000000..6ed86f4b0
Binary files /dev/null and b/docs/branding/app-logo/team-symbols-2026-09-30/dock-light.png differ
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/menu-bar-17pt.png b/docs/branding/app-logo/team-symbols-2026-09-30/menu-bar-17pt.png
new file mode 100644
index 000000000..335b58bca
Binary files /dev/null and b/docs/branding/app-logo/team-symbols-2026-09-30/menu-bar-17pt.png differ
diff --git a/docs/branding/app-logo/team-symbols-2026-09-30/team-icons-preview.png b/docs/branding/app-logo/team-symbols-2026-09-30/team-icons-preview.png
new file mode 100644
index 000000000..9593316ce
Binary files /dev/null and b/docs/branding/app-logo/team-symbols-2026-09-30/team-icons-preview.png differ
diff --git a/docs/terminology.md b/docs/terminology.md
index e530646d8..7eea166f6 100644
--- a/docs/terminology.md
+++ b/docs/terminology.md
@@ -7,23 +7,23 @@ labels, notifications, errors, onboarding, and user documentation.
| --- | --- | --- |
| Agent | The coding agent you choose, or the AI doing the work | Codex, Claude Code, Grok |
| Harness | A reusable agent setup in the Store, or a running agent session in the workspace with its own conversation and working context | Install the Blender harness; start three Codex harnesses |
-| Swarm | A group of harnesses, presented together in the workspace | Frontend, Backend |
+| Tab | A workspace tab that groups harnesses | Frontend, Backend |
| Pane | A view of a harness or its viewer | Split right; close pane |
Use *harness* in both contexts. The screen and action make the meaning clear:
install or update a harness in the Store; start, pause, or stop a harness in the
workspace.
-**New Harness** starts a harness. **New Swarm** opens a group. Add harnesses to a
-swarm to include them; no separate team setup is needed. With **Settings →
-Experimental → Swarm collaboration** enabled, agents can consult peers in the
-same swarm. Collaboration is off by default. Closing a pane or swarm closes its
+**New Harness** starts a harness. **New Tab** opens a tab. Add harnesses to a
+tab to include them; no separate team setup is needed. With **Settings →
+Experimental → Tab collaboration** enabled, agents can consult peers in the
+same tab. Collaboration is off by default. Closing a pane or tab closes its
views; **Stop Harness** ends the running harness.
-Use **Rename Swarm**, **Close Swarm**, **Next Swarm**, and **Previous Swarm** for
+Use **Rename Tab**, **Close Tab**, **Next Tab**, and **Previous Tab** for
group actions, and **Rename Harness**, **Pause Harness**, **Resume Harness**, and
**Restart Harness** for a running session. Use **Create Harness** for authoring
-a reusable package in the Store. Body copy uses lowercase *harness* and *swarm*;
+a reusable package in the Store. Body copy uses lowercase *harness* and *tab*;
**Harness** remains the product name.
Use *agent* when choosing Codex or Claude or describing the AI's actions. Use
@@ -31,12 +31,13 @@ Use *agent* when choosing Codex or Claude or describing the AI's actions. Use
native **conversations**, which can also be started outside
Harness. A recorded Store demonstration is a **recorded run**.
-*Tab* remains correct for the keyboard key, browser tabs, and ordinary section
-tabs inside a screen. It is not the product name for a swarm. Authentication,
+Use **Tab** for the workspace group in all visible copy for now. The word also
+names the keyboard key, browser tabs, and section tabs. Authentication,
encryption, tmux, and native engine sessions retain their technical meanings.
These are product names, not a protocol migration. Existing command IDs, API
-fields, CLI flags, manifests, and stored keys (including `Agent`, `sessionId`,
-`tabId`, `DeskTab`, `channel`, and `--tab`) remain compatible. Search may accept
-older wording as an alias. Saved automatic names such as `New Tab` and
-`Untitled Tab` display as **New Swarm**; explicit custom names stay unchanged.
+fields, CLI flags, manifests, and stored keys (including `Swarm`, `swarm.new`,
+`swarms`, `Agent`, `sessionId`, `tabId`, `DeskTab`, `channel`, and `--tab`) remain
+compatible. Search may accept
+older wording as an alias. Saved automatic names such as `New Swarm` and
+`Untitled Tab` display as **New Tab**; explicit custom names stay unchanged.