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 'dart:convert';
import 'local_key_value_store.dart';
import 'launch_setup.dart';
import 'permission_modes.dart';
/// Confirmed launch setup and use history, alongside legacy picker preferences.
class AgentPreference {
AgentPreference(this.storage);
final LocalKeyValueStore? storage;
static const _key = 'new_agent_engine';
static const _recentKey = 'new_agent_recent';
static const _launchKey = 'new_harness_preferences_v1';
/// How many agents [recent] keeps: more than the New Harness list shows, so
/// an agent that is chosen again does not push out one used last week.
static const recentCapacity = 8;
String? value;
String? harness;
LaunchSetup? successfulLaunch;
// A non-Git launch leaves the last Git preference alone.
bool? successfulWorktree;
bool advancedOpen = false;
List<String> recentHarnesses = const [];
final _enginesByHarness = <String, String>{};
final _permissionsByEngine = <String, String>{};
String? permissionModeFor(String engine) => _permissionsByEngine[engine];
String? engineFor(String? harnessId) =>
_enginesByHarness[harnessId ?? 'coding'];
/// The agents harnesses were created with, most recent first — what New
/// Harness lists before anything is typed.
List<String> recent = const [];
List<String>? _recentChoices;
/// Actual launch choices, interleaving coding agents and specialized
/// harnesses. A harness's backend is not a second launch by the user.
/// Older preferences recorded the two lists separately; preserve their last
/// known choice first when migrating that history.
List<String> get recentChoices =>
_recentChoices ??
<String>{
?harness ?? value,
...recentHarnesses,
...recent,
}.take(recentCapacity).toList(growable: false);
Future<void>? _loading;
bool _loaded = false;
Future<void> _writes = Future.value();
int _revision = 0;
Future<void> load() =>
_loading ??= _read().whenComplete(() => _loaded = true);
Future<void> _read() async {
final revision = _revision;
try {
final stored = await storage?.read(_key);
if (revision == _revision && revision == 0) {
if (stored?.contains('/') == true) {
harness = stored;
} else {
value = stored;
}
}
} catch (_) {
/* A missing preference never blocks a new agent. */
}
try {
final stored = await storage?.read(_recentKey);
final ids = [
for (final id in (stored ?? '').split('\n'))
if (id.trim().isNotEmpty) id.trim(),
];
// An agent remembered while this was loading is newer than the file:
// it stays first, and the stored ones follow it.
recent = <String>{
...recent,
for (final id in ids)
if (!id.contains('/') && !recent.contains(id)) id,
}.take(recentCapacity).toList(growable: false);
recentHarnesses = <String>{
...recentHarnesses,
if (harness != null && !recentHarnesses.contains(harness)) harness!,
for (final id in ids)
if (id.contains('/') && !recentHarnesses.contains(id)) id,
}.take(recentCapacity).toList(growable: false);
} catch (_) {
/* No history is an empty list, never an error. */
}
try {
final stored = await storage?.read(_launchKey);
if (stored == null || revision != _revision || revision != 0) return;
final data = jsonDecode(stored);
if (data is! Map) return;
List<String> ids(Object? raw, bool packages) => raw is List
? raw
.whereType<String>()
.where((id) => id.isNotEmpty && id.contains('/') == packages)
.toSet()
.take(recentCapacity)
.toList()
: const [];
value =
data['engine'] is String && !(data['engine'] as String).contains('/')
? data['engine'] as String
: value;
harness =
data['harness'] is String && (data['harness'] as String).contains('/')
? data['harness'] as String
: null;
recent = ids(data['agents'], false);
recentHarnesses = ids(data['harnesses'], true);
if (data['choices'] case final List choices) {
_recentChoices = choices
.whereType<String>()
.where((id) => id.isNotEmpty)
.toSet()
.take(recentCapacity)
.toList(growable: false);
}
advancedOpen = data['advancedOpen'] == true;
if (data['permissionsByEngine'] case final Map permissions) {
for (final engine in kEnginePermissionModes.keys) {
final mode = permissions[engine];
if (permissionModesOf(engine).any((item) => item.id == mode)) {
_permissionsByEngine[engine] = mode as String;
}
}
}
if (data['enginesByHarness'] case final Map choices) {
for (final entry in choices.entries) {
if (entry.key is String &&
entry.value is String &&
!(entry.value as String).contains('/')) {
_enginesByHarness[entry.key as String] = entry.value as String;
}
}
}
successfulLaunch = LaunchSetup.fromJson(data['successfulLaunch']);
if (data['successfulWorktree'] case final bool worktree) {
successfulWorktree = worktree;
}
} catch (_) {
/* A malformed preference never blocks launch. */
} finally {
// Older versions persisted dropdown edits as defaults. Only actual
// launch history is suitable for migrating a successful setup.
if (successfulLaunch == null && revision == _revision && revision == 0) {
final choice = _recentChoices
?.where(
(id) =>
id != 'terminal' &&
!isInternalLaunchHarness(id) &&
(id.contains('/')
? recentHarnesses.contains(id)
: recent.contains(id)),
)
.firstOrNull;
final engine = choice != null && !choice.contains('/')
? choice
: recent.where((id) => id != 'terminal').firstOrNull;
if (engine != null) {
successfulLaunch = LaunchSetup(
engine: engine,
harnessId: choice?.contains('/') == true ? choice : null,
);
}
}
}
}
Future<void> select(String engine) async {
_revision++;
if (engine.contains('/')) {
harness = engine;
} else {
value = engine;
harness = null;
}
return _save();
}
/// Legacy picker defaults. Cmd-N uses [successfulLaunch] instead; selecting
/// an option is not a successful launch.
Future<void> selectLaunch(String engine, {String? harnessId}) async {
await load();
_revision++;
value = engine;
harness = harnessId;
_enginesByHarness[harnessId ?? 'coding'] = engine;
await _save();
}
/// [agent] was just used to create a harness: it moves to the front of
/// [recent].
Future<void> remember(
String agent, {
String? harnessId,
LaunchSetup? setup,
bool? worktree,
}) async {
if (!_loaded) await load();
if (agent.contains('/')) {
harnessId = agent;
agent = value ?? '';
}
if (isInternalLaunchHarness(harnessId)) return;
_revision++;
if (agent.isNotEmpty && agent != 'terminal') {
successfulLaunch =
setup ?? LaunchSetup(engine: agent, harnessId: harnessId);
if (worktree != null) successfulWorktree = worktree;
}
final choice = harnessId ?? agent;
_recentChoices = <String>{
if (choice.isNotEmpty) choice,
...recentChoices,
}.take(recentCapacity).toList(growable: false);
harness = harnessId;
if (agent.isNotEmpty) {
value = agent;
_enginesByHarness[harnessId ?? 'coding'] = agent;
}
recent = [
if (agent.isNotEmpty) agent,
...recent.where((id) => id != agent),
].take(recentCapacity).toList(growable: false);
if (harnessId != null) {
recentHarnesses = [
harnessId,
...recentHarnesses.where((id) => id != harnessId),
].take(recentCapacity).toList(growable: false);
}
return _save();
}
Future<void> setAdvanced(bool open) async {
await load();
advancedOpen = open;
_revision++;
await _save();
}
Future<void> selectPermissionMode(String engine, String mode) async {
if (!permissionModesOf(engine).any((item) => item.id == mode)) return;
await load();
_permissionsByEngine[engine] = mode;
_revision++;
await _save();
}
Future<void> _save() {
final snapshot = jsonEncode({
'engine': value,
'harness': harness,
'agents': recent,
'harnesses': recentHarnesses,
'choices': recentChoices,
'enginesByHarness': _enginesByHarness,
'advancedOpen': advancedOpen,
'permissionsByEngine': _permissionsByEngine,
if (successfulLaunch != null)
'successfulLaunch': successfulLaunch!.toJson(),
if (successfulWorktree != null) 'successfulWorktree': successfulWorktree,
});
return _writes = _writes.then((_) async {
try {
await storage?.write(_launchKey, snapshot);
} catch (_) {
/* The list in memory still serves this session. */
}
});
}
}