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
/// [name] without the quantization its file name ends in, which a row's Quant
/// says: `Qwen3.8-27B-UD-Q4_K_M` is `Qwen3.8-27B`, `qwen3:4b-instruct-2507-q4_k_m`
/// is `qwen3:4b-instruct-2507` — hn's `without_quant`, so a model reads the same
/// in both, and the same on the machine running it as on one it is shared with.
/// A name that is all quant stays.
String withoutQuant(String name) {
final quant = RegExp(
r'[-_.](?:ud[-_])?(?:(?:iq|q|mxfp)\d[a-z0-9_]*|bf16|fp16|f16)$',
caseSensitive: false,
).firstMatch(name);
return quant == null || quant.start == 0
? name
: name.substring(0, quant.start);
}
/// The local daemon reports lifecycle and measured telemetry. Unknown values
/// stay absent; a weights file's size is never relabelled as memory use.
class LocalModel {
const LocalModel({
required this.id,
required this.name,
this.state = 'available',
this.sizeBytes,
this.quant,
this.recommended = false,
this.canStart = false,
this.canStop = false,
this.tokensPerSecond,
this.requests,
this.windowSeconds,
this.operation,
this.gridAsleep = false,
this.contextWindow,
this.estTokS,
this.paramsB,
this.app,
this.servedAs = const [],
this.servedOnGrids = const [],
});
final String id, name, state;
/// The names the grid lists this model under while it runs here (`servedAs`; empty from an older
/// daemon). A catalog model runs under its file's name (`Qwen3.8-27B-UD-Q4_K_M`), not the catalog's
/// (`Qwen3.8-27B`), so its grid listing is matched to it by these.
final List<String> servedAs;
/// Every grid this machine serves it on now (`servedOn`'s names; empty from an older daemon): the account's own,
/// and a Swarm's that it runs for (docs/plans/2026-10-23-swarm-local-models.md).
final List<String> servedOnGrids;
/// Whether it runs for the Swarm whose grid is [grid].
bool servedOn(String grid) => servedOnGrids.contains(grid);
/// Whether the grid's [modelId] is this model: its id, its name, or a name it is served under.
bool answersTo(String modelId) {
final id = modelId.toLowerCase();
return this.id.toLowerCase() == id ||
name.toLowerCase() == id ||
servedAs.any((served) => served.toLowerCase() == id);
}
/// The app this model was downloaded with and starts in (`Ollama`, `LM Studio`, `llama.cpp`): one found
/// in that app's folder. Null for Grid's own models, and from an older daemon.
final String? app;
final String? quant;
final double? sizeBytes, tokensPerSecond, requests, windowSeconds;
final bool recommended, canStart, canStop;
final LocalModelOperation? operation;
/// What the grid catalog expects of this model on its machine, for choosing before a download:
/// the window it is given, its estimated speed, and its size in billions of parameters. Absent
/// for weights found on disk, which the catalog never sized, and from an older daemon.
final double? contextWindow, estTokS, paramsB;
/// Running here, parked while the account's own grid sleeps (`gridAsleep`). It answers again by
/// itself on the next message, so the row says so rather than reading as a plain `running`. An
/// older daemon never sends it.
final bool gridAsleep;
bool get running => state == 'running';
/// Running, and resting until somebody sends a message — see [gridAsleep].
bool get resting => running && gridAsleep;
bool get downloaded => state == 'downloaded' || running;
/// Imported weights can omit `quant`, but their filename still names the
/// exact variant. Never infer quantization from size or model family.
String? get quantization {
if (quant?.trim().isNotEmpty == true) return quant!.trim();
return RegExp(
r'(?:^|[^a-z0-9])(IQ\d+[a-z0-9_]*|Q\d+[a-z0-9_]*|MXFP\d+(?:_[a-z0-9]+)*|BF16|FP16|F16)(?=[^a-z0-9_]|$)',
caseSensitive: false,
).firstMatch(id)?.group(1)?.toUpperCase();
}
/// Its name as shown: without the quant its file name ends in ([withoutQuant]).
String get shownName => withoutQuant(name);
/// [shownName] with its quant beside it: what tells two downloads of one
/// model apart.
String get displayName {
final shown = shownName;
final variant = quantization;
if (variant == null || variant.isEmpty) return shown;
final present = RegExp(
'(^|[^a-z0-9])${RegExp.escape(variant.toLowerCase())}([^a-z0-9]|\$)',
).hasMatch(shown.toLowerCase());
return present ? shown : '$shown · $variant';
}
factory LocalModel.fromJson(Map<String, dynamic> data) => LocalModel(
id: data['id'] as String? ?? '',
name: data['name'] as String? ?? '',
state: data['state'] as String? ?? 'available',
sizeBytes: _number(data['sizeBytes']),
quant: data['quant'] as String?,
recommended: data['recommended'] == true,
canStart: data['canStart'] == true,
canStop: data['canStop'] == true,
tokensPerSecond: _number(data['tokensPerSecond']),
requests: _number(data['requests']),
windowSeconds: _number(data['windowSeconds']),
operation: LocalModelOperation.parse(data['operation']),
gridAsleep: data['gridAsleep'] == true,
contextWindow: _number(data['contextWindow']),
estTokS: _number(data['estTokS']),
paramsB: _number(data['paramsB']),
app: switch (data['app']) {
final String app when app.trim().isNotEmpty => app.trim(),
_ => null,
},
servedAs: switch (data['servedAs']) {
final List<dynamic> names => names.whereType<String>().toList(),
_ => const [],
},
servedOnGrids: switch (data['servedOn']) {
final List<dynamic> grids => [
for (final grid in grids)
if (grid is Map && grid['grid'] is String) grid['grid'] as String,
],
_ => const [],
},
);
}
class LocalModelOperation {
const LocalModelOperation({
required this.id,
required this.modelId,
required this.action,
required this.stage,
required this.phase,
this.progress,
this.error,
});
final String id, modelId, action, stage, phase;
final double? progress;
final String? error;
bool get active => phase == 'running';
bool get failed => phase == 'failed';
bool get started => phase == 'done' && action == 'start';
String get label => switch (stage) {
'downloading' => 'Downloading',
'updating' => 'Updating engine',
'starting' => 'Starting',
'verifying' => 'Testing',
'stopping' => 'Stopping',
_ => 'Checking',
};
static LocalModelOperation? parse(Object? raw) {
if (raw is! Map<String, dynamic> ||
raw['id'] is! String ||
raw['modelId'] is! String ||
!['download', 'start', 'stop'].contains(raw['action']) ||
![
'checking',
'downloading',
'updating',
'starting',
'verifying',
'stopping',
].contains(raw['stage']) ||
!['running', 'done', 'failed'].contains(raw['phase'])) {
return null;
}
return LocalModelOperation(
id: raw['id'] as String,
modelId: raw['modelId'] as String,
action: raw['action'] as String,
stage: raw['stage'] as String,
phase: raw['phase'] as String,
progress: _number(raw['progress'])?.clamp(0, 1),
error: raw['error'] as String?,
);
}
}
double? _number(Object? value) =>
value is num && value.isFinite && value >= 0 ? value.toDouble() : null;