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 'support/new_agent_project.dart';
import 'dart:async';
import 'package:file_selector_platform_interface/file_selector_platform_interface.dart';
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:harness/auth/auth_session.dart';
import 'package:harness/core/config.dart';
import 'package:harness/core/engine_availability.dart';
import 'package:harness/core/models.dart';
import 'package:harness/core/local_key_value_store.dart';
import 'package:harness/state/app_state.dart';
import 'package:harness/state/harness_placement.dart';
import 'package:harness/core/project_folder.dart';
import 'package:harness/state/pane_arrangement.dart';
import 'package:harness/state/pane_layout_store.dart';
import 'package:harness/widgets/new_agent_dialog.dart';
import 'package:harness/shared/widgets/app_choice_picker.dart';
import 'package:harness/shared/widgets/app_select_field.dart';
import 'support/agent_picker.dart';
class _Folders extends FileSelectorPlatform {
@override
Future<String?> getDirectoryPath({
String? initialDirectory,
String? confirmButtonText,
}) async => '/work';
}
class _DelayedPreferenceStore implements LocalKeyValueStore {
final preference = Completer<String?>();
@override
Future<String?> read(String key) async =>
key == 'new_agent_engine' ? await preference.future : null;
@override
Future<void> write(String key, String value) async {}
@override
Future<void> delete(String key) async {}
}
/// The visible profile field reports the account used for the next launch.
void expectProfile(WidgetTester tester, String label) {
final field = tester.widget<AppSelectField<String>>(
find.byKey(const Key('new-agent-codex-profile-field')),
);
expect(
field.options.firstWhere((option) => option.value == field.value).label,
contains(label),
);
}
Future<void> refreshProfiles(WidgetTester tester) async {
final field = find.byKey(const Key('new-agent-codex-profile-field'));
await tester.ensureVisible(field);
await tester.tap(field);
await tester.pumpAndSettle();
await tester.ensureVisible(find.text('Refresh profiles'));
await tester.tap(find.text('Refresh profiles'));
}
String _labelFor(String path) =>
path.split('/').where((p) => p.isNotEmpty).last;
/// Stands in for the CLI round trip. `listCodexProfiles`/`linkCodexProfile` are what the harness CLI
/// on [machineId] would answer with — this fake never touches a filesystem, matching how the real
/// data now only ever comes from the machine's own CLI.
class _Notifier extends AppNotifier {
_Notifier([
Iterable<String> initialPaths = const [
'/accounts/codex1',
'/accounts/codex2',
],
LocalKeyValueStore? storage,
]) : paths = {...initialPaths},
super(
config: AppConfig.dev,
authSession: AuthSession(),
configStore: null,
paneLayoutStore: storage == null
? null
: PaneLayoutStore(storage: storage),
);
final Set<String> paths;
final extraPaths = <String>{};
final linkedPaths = <String>[];
Completer<void>? pending;
final calls = <Map<String, Object?>>[];
void replaceAgents(String machineId, List<Agent> agents) {
machineStates[machineId]!.agents = agents;
notifyListeners();
}
@override
Future<void> probeEngines(String machineId, {bool force = false}) async {}
@override
Future<Map<String, dynamic>> listCodexProfiles(
String machineId, {
Set<String> observedPaths = const {},
}) async {
await pending?.future;
return {
'profiles': [
for (final path in {...paths, ...observedPaths, ...extraPaths})
{'path': path, 'label': _labelFor(path)},
],
};
}
@override
Future<Map<String, dynamic>> linkCodexProfile(
String machineId,
String path,
) async {
linkedPaths.add(path);
paths.add(path);
return {
'profile': {'path': path, 'label': _labelFor(path)},
};
}
@override
Future<String?> createAgent(
String machineId, {
required String engine,
required String? folder,
ProjectFolderRequest? projectFolder,
bool bypassPermission = false,
String? permissionMode,
String? codexHome,
String? claudeHome,
String? dsh,
String? swarmRole,
String? swarmSkillMode,
GridModel? model,
String? prompt,
String? name,
String? agent,
String? swarmId,
PaneSplitRequest? split,
AgentCreationAttempt? attempt,
HarnessPlacement? placement,
}) async {
calls.add({'engine': engine, 'codexHome': codexHome, 'folder': folder});
return null;
}
}
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
late FileSelectorPlatform priorFiles;
setUp(() {
priorFiles = FileSelectorPlatform.instance;
FileSelectorPlatform.instance = _Folders();
});
tearDown(() {
FileSelectorPlatform.instance = priorFiles;
});
Future<_Notifier> open(
WidgetTester tester, {
bool local = true,
bool supported = true,
bool revealOptions = true,
Iterable<String>? initialPaths,
_Notifier? notifier,
}) async {
final n =
notifier ??
_Notifier(
initialPaths ?? const ['/accounts/codex1', '/accounts/codex2'],
);
addTearDown(n.dispose);
n.machineStates['machine'] =
MachineState(
const Machine(
machineId: 'machine',
name: 'This Mac',
authMode: MachineAuthMode.remote,
),
)
..localOnly = local
..engines.replace([
EngineAvailability(
engine: 'codex',
installed: true,
supportsCodexHome: supported,
),
]);
await tester.pumpWidget(
MaterialApp(
home: Builder(
builder: (context) => Scaffold(
body: TextButton(
onPressed: () => showNewAgentDialog(
context,
n,
'machine',
source: 'machine_row',
initialFolder: revealOptions ? null : '/work',
),
child: const Text('open'),
),
),
),
),
);
await tester.tap(find.text('open'));
await tester.pumpAndSettle();
if (!revealOptions) return n;
await chooseAgent(tester, 'codex');
await tester.pumpAndSettle();
// The profile lives behind the fold now: it and the bypass flag are the two
// settings most people never touch, so they are off the path of somebody who
// wants neither. Every test below is about the profile, so every one of them
// opens it.
await tester.ensureVisible(find.byKey(const Key('new-agent-advanced')));
await tester.tap(find.byKey(const Key('new-agent-advanced')));
await tester.pumpAndSettle();
return n;
}
Future<void> selectSecond(WidgetTester tester) async {
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.tap(find.byKey(const Key('new-agent-codex-profile-field')));
await tester.pumpAndSettle();
await tester.tap(find.text('codex2').last);
await tester.pumpAndSettle();
}
testWidgets(
'late identical agent preference keeps Create usable and its loaded profile',
(tester) async {
final storage = _DelayedPreferenceStore();
final notifier = _Notifier(const ['/custom/work-login'], storage);
await open(tester, notifier: notifier, revealOptions: false);
final create = find.byKey(const ValueKey('create-agent-submit'));
expect(tester.widget<FilledButton>(create).onPressed, isNotNull);
storage.preference.complete('codex');
await tester.pumpAndSettle();
expect(tester.widget<FilledButton>(create).onPressed, isNotNull);
await tester.tap(create);
await tester.pump(const Duration(milliseconds: 100));
expect(notifier.calls.single['codexHome'], '/custom/work-login');
await tester.pumpWidget(const SizedBox());
expect(tester.takeException(), isNull);
},
);
testWidgets('creation waits for its selected Codex profile', (tester) async {
final pending = Completer<void>();
final notifier = _Notifier()..pending = pending;
await open(tester, notifier: notifier, revealOptions: false);
final create = find.byKey(const ValueKey('create-agent-submit'));
expect(tester.widget<FilledButton>(create).onPressed, isNull);
pending.complete();
await tester.pumpAndSettle();
expect(tester.widget<FilledButton>(create).onPressed, isNotNull);
});
testWidgets('no profiles shows the default launch explicitly', (
tester,
) async {
final notifier = await open(tester, initialPaths: const []);
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expect(find.textContaining('Codex profile:'), findsOneWidget);
expect(find.text('Add'), findsOneWidget);
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], isNull);
});
testWidgets('one profile is selected automatically and remains visible', (
tester,
) async {
final notifier = await open(
tester,
initialPaths: const ['/custom/work-login'],
);
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expect(find.textContaining('Codex profile:'), findsOneWidget);
expectProfile(tester, 'work-login');
expect(find.text('Add'), findsOneWidget);
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], '/custom/work-login');
expect(tester.takeException(), isNull);
});
testWidgets(
'offers Codex profiles for a remote machine too, not only this computer',
(tester) async {
await open(
tester,
local: false,
initialPaths: const ['/custom/work-login'],
);
await tester.pump();
final machineField = tester.widget<AppChoicePicker<String>>(
find.byKey(const Key('new-agent-machine-field')),
);
expect(machineField.options.single.label, 'This Mac');
expect(machineField.options.single.detail, 'Remote');
expect(find.byKey(const ValueKey('create-agent-submit')), findsOneWidget);
expect(find.byKey(const Key('new-agent-project-recent')), findsOneWidget);
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expectProfile(tester, 'work-login');
expect(find.text('Add'), findsOneWidget);
},
);
testWidgets('refresh keeps the selected profile visible as accounts change', (
tester,
) async {
final notifier = await open(
tester,
initialPaths: const ['/accounts/codex1'],
);
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
notifier.paths.add('/accounts/codex2');
await refreshProfiles(tester);
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expectProfile(tester, 'codex1');
await selectSecond(tester);
notifier.paths.remove('/accounts/codex1');
await refreshProfiles(tester);
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expectProfile(tester, 'codex2');
});
testWidgets('creation waits for discovery to select the single account', (
tester,
) async {
final notifier = _Notifier(const ['/custom/work-login'])
..pending = Completer<void>();
await open(tester, notifier: notifier);
final newProject = find.descendant(
of: find.byKey(const Key('new-agent-folder-newProject')),
matching: find.byType(TextButton),
);
final searchFocus = tester.widget<TextButton>(newProject).focusNode!;
searchFocus.requestFocus();
await tester.pump();
final createButton = find.byKey(const ValueKey('create-agent-submit'));
expect(tester.widget<FilledButton>(createButton).onPressed, isNull);
expect(searchFocus.hasPrimaryFocus, isTrue);
expect(notifier.calls, isEmpty);
notifier.pending!.complete();
await tester.pumpAndSettle();
expect(tester.widget<FilledButton>(createButton).onPressed, isNotNull);
expect(
searchFocus.hasPrimaryFocus,
isTrue,
reason: 'A late account lookup must not steal keyboard focus',
);
await tester.tap(createButton);
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], '/custom/work-login');
expect(tester.takeException(), isNull);
});
testWidgets('a missing selection requires an explicit account change', (
tester,
) async {
final notifier = await open(tester);
await selectSecond(tester);
notifier.paths.remove('/accounts/codex2');
await refreshProfiles(tester);
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expectProfile(tester, 'codex2');
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.tap(find.byKey(const Key('new-agent-codex-profile-field')));
await tester.pumpAndSettle();
await tester.tap(find.text('codex1').last);
await tester.pumpAndSettle();
expectProfile(tester, 'codex1');
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], '/accounts/codex1');
});
testWidgets(
'refresh and hiding settings preserve an explicit default launch',
(tester) async {
final notifier = await open(tester);
await selectSecond(tester);
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.tap(find.byKey(const Key('new-agent-codex-profile-field')));
await tester.pumpAndSettle();
await tester.tap(find.text('Default profile').last);
await tester.pumpAndSettle();
final settings = find.byKey(const Key('new-agent-advanced'));
await tester.tap(settings);
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsNothing,
);
await tester.tap(settings);
await tester.pumpAndSettle();
expectProfile(tester, 'Default profile');
notifier.paths.remove('/accounts/codex2');
await refreshProfiles(tester);
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsOneWidget,
);
expectProfile(tester, 'Default profile');
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], isNull);
},
);
testWidgets('creates with the account selected in the profile menu', (
tester,
) async {
final notifier = await open(tester);
await selectSecond(tester);
expectProfile(tester, 'codex2');
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls, [
{'engine': 'codex', 'codexHome': '/accounts/codex2', 'folder': '/work'},
]);
expect(tester.takeException(), isNull);
});
testWidgets(
'discovers newly observed local profiles while ignoring remote machine paths',
(tester) async {
final notifier = await open(tester);
notifier.machineStates['remote'] =
MachineState(
const Machine(
machineId: 'remote',
authMode: MachineAuthMode.remote,
),
)
..agents = [
Agent.fromJson({
'id': 'remote-agent',
'engine': 'codex',
'codexHome': '/remote/private-account',
}),
];
notifier.replaceAgents('machine', [
Agent.fromJson({
'id': 'local-agent',
'engine': 'codex',
'codexHome': '/unusual/location/work-login',
}),
]);
await tester.pumpAndSettle();
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.tap(find.byKey(const Key('new-agent-codex-profile-field')));
await tester.pumpAndSettle();
expect(find.text('work-login'), findsOneWidget);
expect(find.text('private-account'), findsNothing);
await tester.tap(find.text('work-login'));
await tester.pumpAndSettle();
expectProfile(tester, 'work-login');
},
);
testWidgets(
'refresh discovers an added profile and keeps the current selection',
(tester) async {
final notifier = await open(tester);
await selectSecond(tester);
notifier.extraPaths.add('/elsewhere/new-profile');
await refreshProfiles(tester);
await tester.pumpAndSettle();
expectProfile(tester, 'codex2');
await tester.ensureVisible(
find.byKey(const Key('new-agent-codex-profile-field')),
);
await tester.tap(find.byKey(const Key('new-agent-codex-profile-field')));
await tester.pumpAndSettle();
await tester.tap(find.text('new-profile'));
await tester.pumpAndSettle();
expectProfile(tester, 'new-profile');
},
);
testWidgets('changing engines clears the selected account', (tester) async {
final notifier = await open(tester);
await selectSecond(tester);
await chooseAgent(tester, 'claude');
await tester.pumpAndSettle();
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsNothing,
);
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], isNull);
expect(notifier.calls.single['engine'], 'claude');
});
testWidgets(
'an old CLI keeps the normal launch available and explains profile support',
(tester) async {
final notifier = await open(tester, supported: false);
expect(
find.byKey(const Key('new-agent-codex-profile-field')),
findsNothing,
);
expect(
find.text('Update Harness CLI on This Mac to choose a Codex profile.'),
findsOneWidget,
);
await browseNewAgentProject(tester);
await tester.pumpAndSettle();
await tester.tap(find.byKey(const ValueKey('create-agent-submit')));
await tester.pumpAndSettle();
expect(notifier.calls.single['codexHome'], isNull);
},
);
}