Comment Spark fonctionne

Spark est une application Tauri 2 : un rendu React, un backend Rust et un pont MCP local. Cette page est la carte. Les suivantes détaillent une partie à la fois.

Trois objets, trois rôles

  • L’espace de travail est le document : onglets, tuiles, une disposition par onglet et par mode, l’onglet actif, le thème. C’est la seule vérité de ce que la fenêtre affiche, et la seule chose persistée.
  • Le registre est ce que le code sait faire à cet instant : types de tuiles, actions, commandes, services et événements apportés par les extensions actives. Il est reconstruit à chaque activation, désactivation ou import.
  • Le gestionnaire d’extensions décide de ce qui est installé et activé. Les paquets installés vivent hors du dépôt, dans le dossier de configuration de l’application.

Couches

CoucheDossierRôle
Contratssrc/sdkManifeste, SparkAPI, définitions de tuiles, actions, services, événements, contrat React.
Domainesrc/coreEspace de travail, journal, brief, registre des contributions, cycle de vie des extensions, persistance, réglages.
Applicationsrc/appDémarrage, découverte, chargement des paquets, marketplace, pont MCP, thème global.
Interfacesrc/uiFenêtre, onglets, dockview, rail, Store, splash, barrières d’erreur.
Extensionssrc/extensionsExtensions intégrées : manifeste, module React, styles, API de coopération, médias.
Natifsrc-tauriStockage disque, paquets importés, fichiers, PTY, PDF, MCP, configuration des agents.
Partagésrc/sharedDesign system, marque, liste d’agents, utilitaires.

Démarrage

main.tsx
  └─ createRuntime()
       ├─ workspace_load / settings_load
       ├─ new TileViews()
       ├─ discoverExtensions(views)
       │    ├─ manifestes et modules intégrés (import.meta.glob)
       │    └─ extension_list → paquets importés
       ├─ seedCoreExtensions()
       ├─ Workspace + persistance
       ├─ Registry
       ├─ ExtensionManager.restore()
       ├─ Marketplace.restore() (en arrière-plan)
       └─ attachMcp()
  └─ SparkShell

Le splash reste visible au moins 1,2 seconde. Le pont MCP est branché avant le rendu de la fenêtre principale, pour qu’un agent ne voie jamais un espace à moitié construit.

Flux de données

Interface ──► Runtime ──► Workspace / Registry / ExtensionManager
                   │                    │
                   │                    ├─ contributions (tuiles, actions, commandes)
                   │                    └─ état par extension
                   ▼
              invoke Tauri ──► Rust ──► fichiers, sockets, PTY, réseau
                   ▲
Agent MCP ──► attachMcp ──► Runtime ──► mêmes primitives, source « agent »

L’interface et les agents passent par les mêmes primitives. Seule la source du journal change :human, agent ou system.

Invariants

  • Une session terminal meurt quand sa tuile est démontée. Le Store est donc un overlay, jamais un remplacement de l’espace.
  • Un onglet ouvert par un agent s’ouvre en arrière-plan et ne vole pas le focus.
  • Une tuile garde son identifiant et ses données quand une extension est désactivée ; seule sa vue devient indisponible.
  • Un résultat d’action, une surface et un brief sont bornés. Le contenu lourd reste dans la tuile.
  • Une extension importée s’exécute avec les privilèges de la fenêtre. Voir le modèle de confiance.

Ensuite

Compiler et lancer pour obtenir une fenêtre, puisEspace de travail et Pont MCPpour les deux moitiés que touchent une extension ou un agent.