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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
import 'package:window_manager/window_manager.dart';
import 'package:flutter/services.dart';
import 'runtime_platform.dart';
import '../shared/theme/color_palette.dart';
import 'build_identity.dart';
import '../measurement/speed_marks.dart';
/// Whether this build runs inside a window the app is allowed to manage.
///
/// `window_manager` ships implementations for macOS, Windows and Linux only.
/// Its Dart surface still compiles everywhere, so on any other platform the
/// calls below are not a compile error — they are a `MissingPluginException` at
/// runtime, thrown from `main` before the first frame. The guard therefore has
/// to live here rather than being left to each call site to remember.
bool get hasManagedWindow =>
RuntimePlatform.isMacOS || RuntimePlatform.isWindows || RuntimePlatform.isLinux;
/// Configures the native window before the first Flutter frame.
///
/// On macOS, AppKit places Swarm tabs beside the system traffic lights in a
/// compact unified title bar. Flutter starts below that row. On Windows the
/// system caption is hidden: the workspace tab strip is the title row, with the
/// window's minimise, restore and close buttons at its end and the empty space
/// dragging the window (`widgets/window_chrome.dart`,
/// `desktop/design/windows-app-menu.md`). Linux keeps its native caption and
/// the Flutter Swarm-tab fallback.
Future<void> configureDesktopWindow({
HarnessPalette palette = HarnessPalette.graphite,
}) async {
if (!hasManagedWindow) return;
await windowManager.ensureInitialized();
speedMarks.launch('window manager ready');
final options = WindowOptions(
size: const Size(1280, 800),
minimumSize: const Size(880, 560),
title: desktopAppName,
center: true,
// Windows: no system caption. window_manager keeps the resize border and
// the windows 11 maximised inset through WM_NCCALCSIZE; the app draws the
// caption row itself.
titleBarStyle: RuntimePlatform.isWindows
? TitleBarStyle.hidden
: TitleBarStyle.normal,
);
// The plugin's optional callback is a VoidCallback: an async callback would
// return before native setup finishes and detach any error from this future.
await windowManager.waitUntilReadyToShow(options);
speedMarks.launch('window ready to show');
if (RuntimePlatform.isMacOS) {
await const MethodChannel('harness/swarm_tabs').invokeMethod('configure', {
'palette': palette.nativeColors,
});
speedMarks.launch('titlebar configured');
}
// Always open filling the screen (owner, 2026-09-15): the tabs, a viewer
// beside its terminal and the rail all want the width. The options above
// stay the frame the green button returns to.
//
// Maximise AFTER show: a maximise asked of a window that has not been shown
// is dropped on Windows, which left the app opening at the 1280x800 default.
await windowManager.show();
speedMarks.launch('window shown');
// macOS: the window manager's maximize is AppKit's animated zoom, which
// blocks the main thread for ~400-500 ms before the first frame (task #3559).
// The native channel zooms the same way without the animation.
if (RuntimePlatform.isMacOS) {
await const MethodChannel('harness/swarm_tabs').invokeMethod('maximize');
} else {
await windowManager.maximize();
}
speedMarks.launch('window maximized');
await windowManager.focus();
}
int _nativePickers = 0;
/// Whether a native file chooser is on screen right now.
///
/// macOS draws `getDirectoryPath` as a SHEET attached to our window (the
/// `file_selector_macos` plugin calls `beginSheetModal` whenever the registrar
/// has a window). A sheet is modal to that window: nothing behind it takes a
/// click, and no Flutter route pushed underneath it can be reached. So anything
/// here that raises, re-orders or draws over the window has to ask first,
/// rather than fighting a stack the person is already standing in.
bool get nativePickerOpen => _nativePickers > 0;
/// Runs [open] — a native chooser — with [nativePickerOpen] held.
///
/// The count is raised and lowered here rather than at the call sites because
/// their own "already picking" flags live in `State` objects and stop being
/// updated the moment the dialog unmounts; this one must come back down even
/// then, or the app would believe a chooser was open forever.
Future<T> whileNativePicker<T>(Future<T> Function() open) async {
_nativePickers++;
try {
return await open();
} finally {
_nativePickers--;
}
}
/// Bring the window to the front, wherever it was.
///
/// For work that STARTS somewhere else. Speaking into the dial opens the task palette here, and a
/// palette behind another app — or on a window the person minimised an hour ago — is a question nobody
/// is being asked: the dial shows its sending overlay, the words go nowhere, and the only clue is on a
/// screen that never came forward.
///
/// [windowManager.show] alone is not enough on macOS: a minimised or hidden window needs it, a
/// backgrounded one needs the focus call, and which of the two applies is not knowable from here — so
/// both run, in that order. Failures are swallowed on purpose: the plugin throws on a platform without a
/// window server (a headless test host), and losing the palette is worse than losing the raise.
///
/// A raise is SKIPPED while [nativePickerOpen]: the person is already at this
/// window, answering a modal sheet, and re-ordering the window under it buys
/// nothing — whatever wanted the front has to wait for the answer anyway.
Future<void> revealWindow() async {
if (!hasManagedWindow || nativePickerOpen) return;
try {
if (await windowManager.isMinimized()) await windowManager.restore();
await windowManager.show();
await windowManager.focus();
} catch (_) {
// No window server, or a platform that will not raise on demand. The palette still opens.
}
}