openharness

import 'dart:math' as math;

import 'package:flutter/material.dart';
import 'package:lucide_icons_flutter/lucide_icons.dart';

import '../core/models.dart';
import '../theme/app_theme.dart';

class EngineIdentity {
  final String id;
  final String label;
  final Color color;
  final String? asset;

  /// The kind of thing it makes, in a word or two — "Code" for every coding
  /// engine, "PCB", "3D design", "Slides" for the harnesses. The picker's
  /// second line under the name, so a name with some character never has to
  /// explain itself.
  final String? category;

  /// Who made the agent — "Anthropic", "OpenAI", "Autonomous" for the org's own
  /// packages, "Jake Fitzgerald" for text-to-cad. The picker shows it beside
  /// the category so the tile says what it makes and whose it is.
  final String? creator;

  /// The vendor's page for it — the store's Website link. Null when there is
  /// no page worth sending someone to.
  final String? homepage;

  /// One sentence for the store card: what it is, whose it is.
  final String? blurb;

  /// A few words in the project's own terms, from its website or repository
  /// — "Advanced physics simulation" — under the name in the agent search.
  /// For a harness, the catalog's `tagline` wins; this is the build's words
  /// for a machine whose CLI does not send one.
  final String? tagline;

  const EngineIdentity({
    required this.id,
    required this.label,
    required this.color,
    this.asset,
    this.category,
    this.creator,
    this.homepage,
    this.blurb,
    this.tagline,
  });

  /// "Code · OpenAI", "CAD · Jake Fitzgerald" — the tile's second line.
  String? get detail {
    final parts = [
      category,
      creator,
    ].whereType<String>().where((s) => s.isNotEmpty);
    return parts.isEmpty ? null : parts.join(' · ');
  }
}

const _engines = <String, EngineIdentity>{
  'claude': EngineIdentity(
    id: 'claude',
    label: 'Claude',
    category: 'Code',
    tagline: 'Work with Claude directly in your codebase',
    creator: 'Anthropic',
    color: Color(0xffcc7c5e),
    homepage: 'https://claude.com/product/claude-code',
    blurb: "Anthropic's agentic coding tool in the terminal: reads the codebase, edits, runs tests, opens pull requests.",
  ),
  'codex': EngineIdentity(
    id: 'codex',
    label: 'Codex',
    category: 'Code',
    tagline: 'Coding agent that runs in your terminal',
    creator: 'OpenAI',
    color: Color(0xff64d2ff),
    asset: 'assets/engine-icons/codex.png',
    homepage: 'https://github.com/openai/codex',
    blurb: "OpenAI's coding agent for the terminal, on the Codex models.",
  ),
  'cursor': EngineIdentity(
    id: 'cursor',
    label: 'Cursor',
    category: 'Code',
    tagline: 'Ship code with agents, right from your terminal',
    creator: 'Anysphere',
    color: Color(0xffc6ff72),
    asset: 'assets/engine-icons/cursor.png',
    homepage: 'https://cursor.com/cli',
    blurb: "Cursor's agent in the terminal — the same agent as in the editor.",
  ),
  'opencode': EngineIdentity(
    id: 'opencode',
    label: 'OpenCode',
    category: 'Code',
    tagline: 'Open source AI coding agent',
    creator: 'Anomaly',
    color: Color(0xfff1ecec),
    asset: 'assets/engine-icons/opencode.png',
    homepage: 'https://opencode.ai',
    blurb: "An open-source coding agent for the terminal that works with any model.",
  ),
  'pi': EngineIdentity(
    id: 'pi',
    label: 'Pi',
    category: 'Code',
    tagline: 'Terminal-based coding agent',
    creator: 'pi.dev',
    color: Colors.white,
    asset: 'assets/engine-icons/pi.png',
    homepage: 'https://pi.dev',
    blurb: "A small, extensible coding agent for the terminal.",
  ),
  'hermes': EngineIdentity(
    id: 'hermes',
    label: 'Hermes',
    category: 'Code',
    tagline: 'Open-source AI agent that grows with you',
    creator: 'Nous Research',
    color: Color(0xff9b8cff),
    asset: 'assets/engine-icons/hermes.png',
    homepage: 'https://github.com/NousResearch/hermes-agent',
    blurb:
        "Nous Research's open agent with memory and skills, in the terminal.",
  ),
  'commandcode': EngineIdentity(
    id: 'commandcode',
    label: 'Command Code',
    category: 'Code',
    tagline: 'Coding agent built for open models',
    creator: 'Command Code',
    color: Color(0xfff5f5f5),
    asset: 'assets/engine-icons/commandcode.png',
    blurb: "Command Code's coding agent for the terminal.",
  ),
  'devin': EngineIdentity(
    id: 'devin',
    label: 'Devin',
    category: 'Code',
    tagline: 'AI software engineer',
    creator: 'Cognition',
    color: Color(0xff8fb8ff),
    asset: 'assets/engine-icons/devin.png',
    homepage: 'https://devin.ai',
    blurb: "Cognition's Devin, as an agent in the terminal.",
  ),
  'muse': EngineIdentity(
    id: 'muse',
    label: 'Muse',
    category: 'Code',
    tagline: 'Coding agent for complex coding workstreams',
    creator: 'Meta',
    color: Color(0xff0082fb),
    asset: 'assets/engine-icons/muse.png',
    blurb: "Meta's coding agent for the terminal.",
  ),
  'amp': EngineIdentity(
    id: 'amp',
    label: 'Amp',
    category: 'Code',
    tagline: 'Coding agent and dev environment',
    creator: 'Sourcegraph',
    color: Color(0xfff34e3f),
    asset: 'assets/engine-icons/amp.png',
    homepage: 'https://ampcode.com',
    blurb: "Sourcegraph's agentic coding tool.",
  ),
  'kilo': EngineIdentity(
    id: 'kilo',
    label: 'Kilo',
    category: 'Code',
    tagline: 'Open source AI coding agent in IDE, CLI and cloud',
    creator: 'Kilo Code',
    color: Color(0xfff8f676),
    asset: 'assets/engine-icons/kilo.png',
    homepage: 'https://kilocode.ai',
    blurb: "Kilo Code's open-source coding agent.",
  ),
  'grok': EngineIdentity(
    id: 'grok',
    label: 'Grok',
    category: 'Code',
    tagline: 'Coding agent that runs right from your terminal',
    creator: 'xAI',
    color: Colors.white,
    asset: 'assets/engine-icons/grok.png',
    homepage: 'https://x.ai',
    blurb: "xAI's Grok as a coding agent in the terminal.",
  ),
  'copilot': EngineIdentity(
    id: 'copilot',
    label: 'Copilot',
    category: 'Code',
    tagline: 'Run a GitHub-native agent in your terminal',
    creator: 'GitHub',
    color: Color(0xff8957e5),
    asset: 'assets/engine-icons/copilot.png',
    homepage: 'https://github.com/github/copilot-cli',
    blurb: "GitHub Copilot's coding agent in the terminal.",
  ),
  'agy': EngineIdentity(
    id: 'agy',
    label: 'Antigravity',
    category: 'Code',
    tagline: 'Next-gen agent platform',
    creator: 'Google',
    color: Color(0xff3287fb),
    asset: 'assets/engine-icons/agy.png',
    homepage: 'https://antigravity.google',
    blurb: "Google's Antigravity agent in the terminal.",
  ),
};

/// The domain-specific harnesses this build has a picture of, keyed by their
/// `owner/name` id — the same id the daemon puts on the wire as `dsh`.
///
/// A SEPARATE map from [_engines], and deliberately not part of [allEngines]:
/// a harness runs ON one of those engines rather than beside them, so it must
/// never be probed as one (`engines_probe`) or offered a bypass flag of its
/// own. It is only a face. A harness absent here still draws — the daemon
/// sends its name, and [engineIdentity] falls back to an initial.
const _harnesses = <String, EngineIdentity>{
  'autonomous/vllm': EngineIdentity(
    id: 'autonomous/vllm',
    tagline:
        'High-performance LLM inference on Apple Silicon using MLX and vLLM',
    label: 'vLLM',
    category: 'Local AI',
    creator: 'OpenHarness contributors',
    color: Color(0xffffc743),
    asset: 'assets/engine-icons/vllm.png',
    homepage: 'https://github.com/vllm-project/vllm-metal',
    blurb: 'Serve models with vLLM Metal and measure concurrent request performance.',
  ),
  'autonomous/mlx-lm': EngineIdentity(
    id: 'autonomous/mlx-lm',
    tagline:
        'Generating text with large language models on Apple silicon with MLX',
    label: 'MLX-LM',
    category: 'Local AI',
    creator: 'OpenHarness contributors',
    color: Color(0xffa9caff),
    asset: 'assets/engine-icons/mlx.png',
    homepage: 'https://github.com/ml-explore/mlx-lm',
    blurb:
        'Run and compare language models directly on Apple Silicon with MLX.',
  ),
  'autonomous/ollama': EngineIdentity(
    id: 'autonomous/ollama',
    tagline: 'Start building with open models.',
    label: 'Ollama',
    category: 'Local AI',
    creator: 'OpenHarness contributors',
    color: Color(0xfff4f6ef),
    asset: 'assets/engine-icons/ollama.png',
    homepage: 'https://ollama.com',
    blurb:
        'Run and benchmark Ollama models on your Mac through natural language.',
  ),
  'local/vllm': EngineIdentity(
    id: 'local/vllm',
    label: 'vLLM',
    category: 'Local AI',
    creator: 'Local',
    color: Color(0xffffc743),
    asset: 'assets/engine-icons/vllm.png',
    homepage: 'https://github.com/vllm-project/vllm-metal',
    blurb: 'Serve models with vLLM Metal and measure concurrent request performance.',
  ),
  'local/mlx-lm': EngineIdentity(
    id: 'local/mlx-lm',
    label: 'MLX-LM',
    category: 'Local AI',
    creator: 'Local',
    color: Color(0xffa9caff),
    asset: 'assets/engine-icons/mlx.png',
    homepage: 'https://github.com/ml-explore/mlx-lm',
    blurb:
        'Run and compare language models directly on Apple Silicon with MLX.',
  ),
  'local/ollama': EngineIdentity(
    id: 'local/ollama',
    label: 'Ollama',
    category: 'Local AI',
    creator: 'Local',
    color: Color(0xfff4f6ef),
    asset: 'assets/engine-icons/ollama.png',
    homepage: 'https://ollama.com',
    blurb:
        'Run and benchmark Ollama models on your Mac through natural language.',
  ),
  // Original creative identities; source vectors ship in each package under brand/.
  'autonomous/voxel-worlds': EngineIdentity(
    id: 'autonomous/voxel-worlds',
    label: 'Voxel Worlds',
    category: 'Games',
    tagline: 'Build original worlds. Keep every piece.',
    creator: 'Autonomous',
    color: Color(0xffaac785),
    asset: 'assets/engine-icons/voxel-worlds.png',
  ),
  'autonomous/generative-art': EngineIdentity(
    id: 'autonomous/generative-art',
    label: 'Generative Art',
    category: 'Original art',
    tagline:
        'Turn a visual brief into editable artwork and complete asset sets',
    creator: 'Autonomous',
    color: Color(0xffce7645),
    asset: 'assets/engine-icons/generative-art.png',
  ),
  'autonomous/music-studio': EngineIdentity(
    id: 'autonomous/music-studio',
    label: 'Music Studio',
    category: 'Audio',
    tagline: 'Compose original music with editable notes, audio and stems for your DAW',
    creator: 'Autonomous',
    color: Color(0xffd6c7e9),
    asset: 'assets/engine-icons/music-studio.png',
  ),
  'autonomous/creative-direction': EngineIdentity(
    id: 'autonomous/creative-direction',
    label: 'Creative Direction',
    category: 'Design',
    tagline: 'Turn your business brief into an editable brand and complete launch kit',
    creator: 'Autonomous',
    color: Color(0xffd89478),
    asset: 'assets/engine-icons/creative-direction.png',
  ),
  'autonomous/drone-pilot': EngineIdentity(
    id: 'autonomous/drone-pilot',
    label: 'Drone Pilot',
    category: 'Simulation',
    tagline: 'Turn your site into a survey plan you can inspect and keep',
    creator: 'Autonomous',
    color: Color(0xffd3eb9c),
    asset: 'assets/engine-icons/drone-pilot.png',
  ),
  'autonomous/game-master': EngineIdentity(
    id: 'autonomous/game-master',
    label: 'Game Master',
    category: 'Games',
    tagline: 'Create a game. Play it. Put it on the table.',
    creator: 'Autonomous',
    color: Color(0xffed9075),
    asset: 'assets/engine-icons/game-master.png',
  ),
  'autonomous/lab-bench': EngineIdentity(
    id: 'autonomous/lab-bench',
    label: 'Lab Bench',
    category: 'Science',
    tagline: 'Turn a question into evidence you can act on',
    creator: 'Autonomous',
    color: Color(0xfff2ca7d),
    asset: 'assets/engine-icons/lab-bench.png',
  ),

  // Jev harnesses; marks are built by store/tools/jev-kit/brand.mjs from brand/icon.svg.
  'autonomous/jev-sheets': EngineIdentity(
    id: 'autonomous/jev-sheets',
    label: 'Jev Sheets',
    category: 'Productivity',
    tagline: 'Drop in any spreadsheet, ask in plain words, get every row answered in seconds',
    creator: 'Autonomous',
    color: Color(0xfffbbf24),
    asset: 'assets/engine-icons/jev-sheets.png',
  ),

  'autonomous/autonomous-circuit': EngineIdentity(
    id: 'autonomous/autonomous-circuit',
    label: 'Autonomous Circuit',
    category: 'PCB',
    tagline: 'Get a verified PCB and a fab packet you can order',
    creator: 'Autonomous',
    color: Color(0xffd98a4a),
    asset: 'assets/engine-icons/autonomous-circuit.png',
  ),
  // KiCad is Autonomous Circuit's second wrapper (its KiCad-native pipeline,
  // #91, renamed): it changes nothing of KiCad, so — as Blender, Typst and Marp
  // do — it carries the wrapped project's name and mark. The icon is KiCad's
  // own application icon (icon_kicad.svg in its source tree) rendered at 256 px.
  'autonomous/kicad': EngineIdentity(
    id: 'autonomous/kicad',
    label: 'KiCad',
    category: 'PCB',
    tagline: 'A real KiCad project: wired schematic, DRC-checked copper, a prototype packet',
    creator: 'KiCad',
    color: Color(0xffff6d00),
    asset: 'assets/engine-icons/kicad.png',
  ),
  // Grid's own mark — the bolt from the Grid app's icon (autonomous-grid-app,
  // branding/app_icon.svg); ours, like Circuit's and Workshop's.
  'autonomous/autonomous-grid': EngineIdentity(
    id: 'autonomous/autonomous-grid',
    label: 'Grid',
    category: 'Local AI',
    tagline: 'Deploy open-weight models across your machines and watch the fleet live',
    creator: 'Autonomous',
    color: Color(0xfff5a623),
    asset: 'assets/engine-icons/autonomous-grid.png',
  ),
  'autonomous/autonomous-workshop': EngineIdentity(
    id: 'autonomous/autonomous-workshop',
    label: 'Autonomous Workshop',
    category: 'CAD',
    tagline: 'AI inventors that make new toys and games',
    creator: 'Autonomous',
    color: Color(0xff5a52d8),
    asset: 'assets/engine-icons/autonomous-workshop.png',
  ),
  'autonomous/marp': EngineIdentity(
    id: 'autonomous/marp',
    label: 'Marp',
    category: 'Slides',
    tagline: 'Create beautiful slide decks using Markdown',
    creator: 'Yuki Hattori',
    color: Color(0xff218cdb),
    asset: 'assets/engine-icons/marp.png',
  ),
  'autonomous/text-to-cad': EngineIdentity(
    id: 'autonomous/text-to-cad',
    label: 'text-to-cad',
    category: 'CAD',
    tagline: 'Library of agent skills for CAD, CAE and CAM',
    creator: 'Jake Fitzgerald',
    color: Color(0xff3aa0e0),
    asset: 'assets/engine-icons/text-to-cad.png',
  ),
  // The store's first wave: open-source projects under their own names, their
  // makers on the tile (store/README.md "Stewardship").
  'autonomous/typst': EngineIdentity(
    id: 'autonomous/typst',
    label: 'Typst',
    category: 'Documents',
    tagline: 'Markup-based typesetting system',
    creator: 'Typst GmbH',
    color: Color(0xff239dad),
    asset: 'assets/engine-icons/typst.png',
  ),
  'autonomous/manim': EngineIdentity(
    id: 'autonomous/manim',
    label: 'Manim',
    category: 'Math animation',
    tagline: 'Python library for creating mathematical animations',
    creator: 'Manim Community',
    color: Color(0xffe0a458),
    asset: 'assets/engine-icons/manim.png',
  ),
  'autonomous/excalidraw': EngineIdentity(
    id: 'autonomous/excalidraw',
    label: 'Excalidraw',
    category: 'Diagrams',
    tagline: 'Collaborative whiteboarding made easy',
    creator: 'Excalidraw',
    color: Color(0xff6965db),
    asset: 'assets/engine-icons/excalidraw.png',
  ),
  'autonomous/marimo': EngineIdentity(
    id: 'autonomous/marimo',
    label: 'marimo',
    category: 'Notebooks',
    tagline: 'Next-generation Python notebook',
    creator: 'marimo',
    color: Color(0xff1c7c54),
    asset: 'assets/engine-icons/marimo.png',
  ),
  'autonomous/remotion': EngineIdentity(
    id: 'autonomous/remotion',
    label: 'Remotion',
    category: 'Video',
    tagline: 'Make videos programmatically',
    creator: 'Remotion',
    color: Color(0xff0b84f3),
    asset: 'assets/engine-icons/remotion.png',
  ),
  'autonomous/blender': EngineIdentity(
    id: 'autonomous/blender',
    label: 'Blender',
    category: '3D',
    tagline: 'Free and open source 3D creation software',
    creator: 'Blender Foundation',
    color: Color(0xffe87d0d),
    asset: 'assets/engine-icons/blender.png',
  ),
  'autonomous/mujoco': EngineIdentity(
    id: 'autonomous/mujoco',
    label: 'MuJoCo',
    category: 'Simulation',
    tagline: 'Advanced physics simulation',
    creator: 'Google DeepMind',
    color: Color(0xff1b2a6b),
    asset: 'assets/engine-icons/mujoco.png',
  ),
  'autonomous/phaser': EngineIdentity(
    id: 'autonomous/phaser',
    label: 'Phaser',
    category: 'Games',
    tagline: 'Open source HTML5 game framework',
    creator: 'Phaser Studio',
    color: Color(0xff2a5bd7),
    asset: 'assets/engine-icons/phaser.png',
  ),
  'autonomous/strudel': EngineIdentity(
    id: 'autonomous/strudel',
    label: 'Strudel',
    category: 'Music',
    tagline: 'Music live coding environment for the browser',
    creator: 'Strudel',
    color: Color(0xffe0577b),
    asset: 'assets/engine-icons/strudel.png',
  ),
  'autonomous/rdkit': EngineIdentity(
    id: 'autonomous/rdkit',
    label: 'RDKit',
    category: 'Chemistry',
    tagline: 'Open-source cheminformatics software',
    creator: 'RDKit',
    color: Color(0xff1d7bb8),
    asset: 'assets/engine-icons/rdkit.png',
  ),
  'autonomous/yosys': EngineIdentity(
    id: 'autonomous/yosys',
    label: 'Yosys',
    category: 'Chips',
    tagline: 'Framework for Verilog RTL synthesis',
    creator: 'YosysHQ',
    color: Color(0xff2f7d5b),
    asset: 'assets/engine-icons/yosys.png',
  ),
  'autonomous/circuitjs': EngineIdentity(
    id: 'autonomous/circuitjs',
    label: 'CircuitJS',
    category: 'Circuits',
    tagline: 'Electronic circuit simulator in the browser',
    creator: 'Paul Falstad',
    color: Color(0xff50fa78),
    asset: 'assets/engine-icons/circuitjs.png',
  ),
  // OpenMontage's own logo (`assets/logo.png` in its repository), trimmed to
  // its outer ring so the play mark reads at tab size.
  'autonomous/openmontage': EngineIdentity(
    id: 'autonomous/openmontage',
    label: 'OpenMontage',
    category: 'Video',
    tagline: 'Open-source agentic video production',
    creator: 'calesthio',
    color: Color(0xffe8894a),
    asset: 'assets/engine-icons/openmontage.png',
  ),
  // Original Harness package marks; Godogen's upstream publishes no logo.
  'autonomous/roundtable': EngineIdentity(
    id: 'autonomous/roundtable',
    label: 'Roundtable',
    category: 'Decisions',
    creator: 'Autonomous',
    color: Color(0xff94b9a5),
    asset: 'assets/engine-icons/roundtable.png',
  ),
  'autonomous/jev-browser': EngineIdentity(
    id: 'autonomous/jev-browser',
    label: 'Jev Browser',
    category: 'Research',
    tagline: 'Name a site, say what you want, and get a spreadsheet',
    creator: 'Autonomous',
    color: Color(0xff8bd3cc),
    asset: 'assets/engine-icons/jev-browser.png',
  ),
  'autonomous/godogen': EngineIdentity(
    id: 'autonomous/godogen',
    label: 'Godogen',
    category: 'Games',
    tagline: 'Autonomous game development',
    creator: 'Alex Ermolov',
    color: Color(0xffb5d9ae),
    asset: 'assets/engine-icons/godogen.png',
  ),
  // Of the eight studios of 2026-09-18, three wear their project's own mark —
  // Comfy's `assets/logo.svg`, Dimensional's favicon, Bonsai's desktop icon
  // from IfcOpenShell. The other five (Ableton AI, autoresearch-mlx,
  // Foam-Agent, JUCE Agent Toolkit, SimSkill) publish no logo of their own,
  // and the marks they sit beside (Ableton, JUCE, OpenFOAM, SUMO) are other
  // companies' trademarks — so they are not here and draw their
  // initial; their words come from the Store's catalog.
  'autonomous/comfy-mcp': EngineIdentity(
    id: 'autonomous/comfy-mcp',
    label: 'Comfy MCP',
    category: 'Generative media',
    tagline: 'Local MCP server for ComfyUI — run ComfyUI from AI agents',
    creator: 'Comfy Org',
    color: Color(0xffe5ff3d),
    asset: 'assets/engine-icons/comfy-mcp.png',
  ),
  'autonomous/dimos': EngineIdentity(
    id: 'autonomous/dimos',
    label: 'DimOS',
    category: 'Robotics',
    tagline: 'The agentic operating system for physical space',
    creator: 'Dimensional',
    color: Color(0xffb0e1f0),
    asset: 'assets/engine-icons/dimos.png',
  ),
  'autonomous/bonsai-mcp': EngineIdentity(
    id: 'autonomous/bonsai-mcp',
    label: 'Bonsai MCP',
    category: 'Architecture',
    tagline: 'MCP server for a live Blender + Bonsai (BlenderBIM) session',
    creator: 'Show2Instruct',
    color: Color(0xff8c6f5e),
    asset: 'assets/engine-icons/bonsai-mcp.png',
  ),
  // Group A: official OpenSCAD / FreeCAD / OrcaSlicer / Godot marks, and
  // original wrapper identities for the studios. Habitat is NOT the Home
  // Assistant trademark. Sources and artwork licenses: store/branding/README.md.
  'autonomous/web-studio': EngineIdentity(
    id: 'autonomous/web-studio',
    label: "Web Studio",
    category: "Web",
    tagline: "Interactive web experiences, live in the pane",
    creator: "OpenHarness contributors",
    color: Color(0xff36876b),
    asset: 'assets/engine-icons/web-studio.png',
  ),
  'autonomous/data-studio': EngineIdentity(
    id: 'autonomous/data-studio',
    label: "Data Studio",
    category: "Data",
    tagline: "Turn your files into answers you can trace, revise and reuse",
    creator: "OpenHarness contributors",
    color: Color(0xff4987ca),
    asset: 'assets/engine-icons/data-studio.png',
  ),
  'autonomous/quantum-studio': EngineIdentity(
    id: 'autonomous/quantum-studio',
    label: "Quantum Studio",
    category: "Science",
    tagline: "Edit circuits and see superposition, phase and entanglement",
    creator: "OpenHarness contributors",
    color: Color(0xff9271cc),
    asset: 'assets/engine-icons/quantum-studio.png',
  ),
  'autonomous/gis': EngineIdentity(
    id: 'autonomous/gis',
    label: "GIS",
    category: "GIS",
    tagline: "An open-source JavaScript library for interactive maps",
    creator: "OpenHarness contributors",
    color: Color(0xff4e947a),
    asset: 'assets/engine-icons/gis.png',
  ),
  'autonomous/openscad': EngineIdentity(
    id: 'autonomous/openscad',
    label: "OpenSCAD",
    category: "CAD",
    tagline: "Your measurements. A family of usable parts.",
    creator: "OpenSCAD",
    color: Color(0xffe2c63d),
    asset: 'assets/engine-icons/openscad.png',
  ),
  'autonomous/freecad': EngineIdentity(
    id: 'autonomous/freecad',
    label: "FreeCAD",
    category: "CAD",
    tagline: "From your measurements to checked, editable custom parts",
    creator: "OpenHarness contributors",
    color: Color(0xff418fde),
    asset: 'assets/engine-icons/freecad.png',
  ),
  'autonomous/orca-slicer': EngineIdentity(
    id: 'autonomous/orca-slicer',
    label: "Orca Slicer",
    category: "Fabrication",
    tagline: "Your mesh. Compared plans. Editable native projects.",
    creator: "OpenHarness contributors",
    color: Color(0xff009789),
    asset: 'assets/engine-icons/orca-slicer.png',
  ),
  'autonomous/firmware-studio': EngineIdentity(
    id: 'autonomous/firmware-studio',
    label: "Firmware Studio",
    category: "Embedded",
    tagline: "Compile firmware and inspect memory, artifacts and build logs",
    creator: "OpenHarness contributors",
    color: Color(0xff4b856b),
    asset: 'assets/engine-icons/firmware-studio.png',
  ),
  'autonomous/godot-studio': EngineIdentity(
    id: 'autonomous/godot-studio',
    label: "Godot Studio",
    category: "Games",
    tagline: "A free and open-source game engine",
    creator: "OpenHarness contributors",
    color: Color(0xff478cbf),
    asset: 'assets/engine-icons/godot-studio.png',
  ),
  'autonomous/home-assistant': EngineIdentity(
    id: 'autonomous/home-assistant',
    label: "Home Assistant",
    category: "Automation",
    tagline: "Home automation ideas → tested YAML, native traces and a real handoff",
    creator: "OpenHarness contributors",
    color: Color(0xffb88159),
    asset: 'assets/engine-icons/home-assistant.png',
  ),
  'autonomous/score': EngineIdentity(
    id: 'autonomous/score',
    label: "Score",
    category: "Music",
    tagline: "Your musical idea, ready to hear and share",
    creator: "OpenHarness contributors",
    color: Color(0xffbd965f),
    asset: 'assets/engine-icons/score.png',
  ),
  'autonomous/sheet-docs': EngineIdentity(
    id: 'autonomous/sheet-docs',
    label: "Sheet & Docs Studio",
    category: "Office",
    tagline: "Editable documents and spreadsheets from structured source",
    creator: "OpenHarness contributors",
    color: Color(0xff528c85),
    asset: 'assets/engine-icons/sheet-docs.png',
  ),
};

/// The base engine each first-party harness runs on, so the Create dialog can
/// say "Runs on Claude Code" — and send the right `engine` — before the machine
/// has answered `dsh_list`. The daemon's catalog is authoritative when present.
const knownHarnessBase = <String, String>{
  'autonomous/roundtable': 'claude',
  'autonomous/jev-browser': 'claude',
  'autonomous/godogen': 'claude',
  'autonomous/ollama': 'codex',
  'autonomous/mlx-lm': 'codex',
  'autonomous/vllm': 'codex',
  'local/ollama': 'codex',
  'local/mlx-lm': 'codex',
  'local/vllm': 'codex',
  'autonomous/voxel-worlds': 'claude',
  'autonomous/generative-art': 'claude',
  'autonomous/music-studio': 'claude',
  'autonomous/creative-direction': 'claude',
  'autonomous/drone-pilot': 'claude',
  'autonomous/game-master': 'claude',
  'autonomous/lab-bench': 'claude',

  'autonomous/jev-sheets': 'claude',

  'autonomous/autonomous-circuit': 'claude',
  'autonomous/kicad': 'claude',
  'autonomous/autonomous-grid': 'codex',
  'autonomous/autonomous-workshop': 'codex',
  'autonomous/marp': 'claude',
  'autonomous/text-to-cad': 'claude',
  'autonomous/typst': 'claude',
  'autonomous/manim': 'claude',
  'autonomous/excalidraw': 'claude',
  'autonomous/marimo': 'claude',
  'autonomous/remotion': 'claude',
  'autonomous/blender': 'claude',
  'autonomous/mujoco': 'claude',
  'autonomous/phaser': 'codex',
  'autonomous/strudel': 'claude',
  'autonomous/rdkit': 'codex',
  'autonomous/yosys': 'claude',
  'autonomous/circuitjs': 'codex',
  'autonomous/openmontage': 'claude',
  'autonomous/comfy-mcp': 'codex',
  'autonomous/dimos': 'codex',
  'autonomous/bonsai-mcp': 'codex',
  'autonomous/web-studio': 'claude',
  'autonomous/data-studio': 'claude',
  'autonomous/quantum-studio': 'claude',
  'autonomous/gis': 'claude',
  'autonomous/openscad': 'claude',
  'autonomous/freecad': 'claude',
  'autonomous/orca-slicer': 'claude',
  'autonomous/firmware-studio': 'claude',
  'autonomous/godot-studio': 'claude',
  'autonomous/home-assistant': 'claude',
  'autonomous/score': 'claude',
  'autonomous/sheet-docs': 'claude',
};

/// The daemon's engine id for a plain shell in a pane (⌘⇧T, New Terminal — and
/// the last row of New Harness's agent list, as [terminalIdentity]).
///
/// Deliberately NOT in [_engines]: [allEngines] is what `engines_probe` asks a
/// machine about and what the Store shelves as an engine, and a terminal is
/// neither installable nor absent — every machine has a shell. New Harness
/// lists it on its own, after the agents. It still has a face, because a tile
/// shows one, and the daemon swaps the tile's engine for whatever gets typed
/// into it, so the face must come and go through the same [engineIdentity]
/// every other mark reads.
const String kTerminalEngine = 'terminal';

const EngineIdentity _terminal = EngineIdentity(
  id: kTerminalEngine,
  label: 'Terminal',
  category: 'Shell',
  tagline: 'Your shell, in a tile',
  blurb:
      'A plain shell on the machine, in a tile beside your agents: no engine, '
      'no first task, nothing to install.',
  color: Color(0xffa8b0b8),
);

/// The terminal's face, for the one list that offers it: New Harness.
EngineIdentity get terminalIdentity => _terminal;

/// Whether [engine] is the shell rather than an agent.
bool isTerminalEngine(String? engine) => engine == kTerminalEngine;

/// All known engines, in declaration order — for the New Agent engine picker.
List<EngineIdentity> get allEngines => _engines.values.toList(growable: false);

/// The harnesses this build ships a face for, in declaration order.
List<EngineIdentity> get knownHarnesses =>
    _harnesses.values.toList(growable: false);

/// Whether [id] names a domain-specific harness rather than an engine. The
/// slash is the tell: engine ids are bare words, harness ids are `owner/name`.
bool isHarnessId(String? id) => id != null && id.contains('/');

EngineIdentity engineIdentity(String? engine, {String? displayName}) {
  final id = engine?.trim().toLowerCase() ?? '';
  final known =
      _engines[id] ??
      _harnesses[id] ??
      (id == kTerminalEngine ? _terminal : null);
  if (known != null) return known;
  final raw = displayName?.trim().isNotEmpty == true
      ? displayName!.trim()
      // An unknown harness reads by its name, never its owner: `someone/robot-arm`
      // is a "Robot-arm" tile, and the owner is a fact for the install screen.
      : isHarnessId(id)
      ? id.substring(id.lastIndexOf('/') + 1)
      : id.isEmpty
      ? 'Agent'
      : id;
  final label = raw.isEmpty ? 'Agent' : raw[0].toUpperCase() + raw.substring(1);
  return EngineIdentity(
    id: id.isEmpty ? 'unknown' : id,
    label: label,
    color: AppColors.mutedStrong,
  );
}

/// What an agent is drawn AS: its harness when it was created from one, else
/// its engine. Every mark that has an [Agent] in hand goes through here, so a
/// Circuit agent is Circuit in the rail, the header, the switcher and the tab
/// alike — and so a new place to draw one cannot quietly show Claude instead.
EngineIdentity agentIdentity(Agent agent) => engineIdentity(
  agent.identityEngine,
  displayName: agent.identityDisplayName,
);

class EngineMark extends StatelessWidget {
  final String? engine;
  final String? displayName;
  final bool enabled;
  final double size;

  const EngineMark({
    super.key,
    required this.engine,
    this.displayName,
    this.enabled = true,
    this.size = 16,
  });

  /// The mark for [agent] — see [agentIdentity].
  EngineMark.forAgent(
    Agent agent, {
    super.key,
    this.enabled = true,
    this.size = 16,
  }) : engine = agent.identityEngine,
       displayName = agent.identityDisplayName;

  @override
  Widget build(BuildContext context) {
    final identity = engineIdentity(engine, displayName: displayName);
    final mark = identity.asset != null
        ? Image.asset(
            identity.asset!,
            key: ValueKey('engine-icon-${identity.id}'),
            width: size,
            height: size,
            fit: BoxFit.contain,
            filterQuality: FilterQuality.high,
            errorBuilder: (_, _, _) => _InitialMark(
              key: ValueKey('engine-fallback-${identity.id}'),
              identity: identity,
              size: size,
            ),
          )
        : identity.id == 'claude'
        ? CustomPaint(
            key: const ValueKey('engine-icon-claude'),
            size: Size.square(size),
            painter: _ClaudeMarkPainter(identity.color),
          )
        : identity.id == kTerminalEngine
        ? Icon(
            LucideIcons.terminal,
            key: const ValueKey('engine-icon-terminal'),
            size: size,
            color: identity.color,
          )
        : _InitialMark(
            key: ValueKey('engine-fallback-${identity.id}'),
            identity: identity,
            size: size,
          );
    // These vendor assets use near-white ink. Give them a stable dark ground
    // so their original shapes stay visible on both light and dark surfaces.
    final needsDarkTile = const {
      'cursor',
      'opencode',
      'autonomous/kicad',
    }.contains(identity.id);
    return Opacity(
      opacity: enabled ? 1 : 0.45,
      child: needsDarkTile
          ? SizedBox.square(
              dimension: size,
              child: DecoratedBox(
                decoration: BoxDecoration(
                  color: const Color(0xff29322f),
                  borderRadius: BorderRadius.circular(size * .2),
                ),
                child: Padding(
                  padding: EdgeInsets.all(size * .08),
                  child: mark,
                ),
              ),
            )
          : mark,
    );
  }
}

class _InitialMark extends StatelessWidget {
  final EngineIdentity identity;
  final double size;

  const _InitialMark({super.key, required this.identity, required this.size});

  @override
  Widget build(BuildContext context) {
    return SizedBox.square(
      dimension: size,
      child: Center(
        child: Text(
          identity.label.characters.first.toUpperCase(),
          // ⚠️ Sized from [size], a FIXED box, not from the type ramp — so it
          // must not take the app's UI scale either. At the top of the range the
          // glyph would grow while its 17px square did not, and the letter would
          // clip out of its own mark.
          textScaler: TextScaler.noScaling,
          style: TextStyle(
            color: identity.color,
            // The app's mono stack, not a literal: `Menlo` names nothing on
            // Linux, so this initial was drawn in the proportional default
            // while every mark beside it was monospaced.
            fontFamily: AppFonts.mono,
            fontFamilyFallback: AppFonts.monoFallback,
            fontSize: size * 0.68,
            height: 1,
            fontWeight: FontWeight.w700,
          ),
        ),
      ),
    );
  }
}

class _ClaudeMarkPainter extends CustomPainter {
  final Color color;
  const _ClaudeMarkPainter(this.color);

  @override
  void paint(Canvas canvas, Size size) {
    final paint = Paint()
      ..color = color
      ..strokeWidth = size.width * 0.098
      ..strokeCap = StrokeCap.round;
    final c = Offset(size.width / 2, size.height / 2);
    final radius = size.width * 0.39;
    for (var i = 0; i < 4; i++) {
      final angle = i * 0.78539816339;
      final dx = radius * math.cos(angle);
      final dy = radius * math.sin(angle);
      canvas.drawLine(c - Offset(dx, dy), c + Offset(dx, dy), paint);
    }
  }

  @override
  bool shouldRepaint(covariant _ClaudeMarkPainter oldDelegate) =>
      oldDelegate.color != color;
}