Espace de travail
L’espace de travail est un document sérialisable ordinaire. Tout ce que la fenêtre affiche en dérive, et tout ce qu’un agent lit en est un résumé borné.
Modèle
interface WorkspaceState {
version: 1;
active: string; // id de l'onglet actif
tabs: Tab[];
pinned: string[] | null; // null = toutes les extensions épinglées
installedExtensions?: string[];
seededCore?: string[];
extensions?: Record<string, unknown>; // état sauvegardé par chaque extension
theme: "dark" | "light" | "transparent";
}
type Mode = "side" | "tiling" | "stack";
interface Tab {
id: string;
name: string;
mode: Mode;
tiles: Tile[];
layouts: Partial<Record<Mode, unknown>>;
focused?: string;
}
interface Tile {
id: string;
type: string;
data: Record<string, string>;
}Tile.datane contient que des chaînes : le document reste sérialisable et borné.extensionsest indexé par identifiant d’extension et contient ce que l’extension a enregistré viaapi.state.save().- Les paquets installés et les sources de dépôt ne sont pas dans l’espace : ils vivent dans
extensions.json.
Trois modes
- Side — les tuiles côte à côte.
- Tiling — disposition libre dockview : glisser un onglet sur un bord divise, au centre regroupe, glisser un séparateur redimensionne.
- Stack — les tuiles empilées verticalement.
Chaque onglet garde une disposition par mode : changer de mode ne recrée jamais une tuile, ce qui compte puisqu’une session terminal meurt avec sa tuile.
Cycle de vie d’une tuile
prepare(data)normalise les données initiales à l’ouverture.dataKeyslimite les clés acceptées.describe(tile, surface)renvoie un résumé d’une ligne pour le brief ; il ne doit pas lever.canClose(tile, closing)peut refuser une fermeture, par exemple pour un document non enregistré.close(tile)libère ce que la tuile détient : session, fichier, écouteur.
Désactiver une extension la retire de installedExtensions mais laisse ses tuiles dans l’espace ; leur vue devient indisponible. La réactivation les restaure avec leurs données.
Journal
src/core/journal.ts garde 512 entrées en mémoire. Chaque entrée porteseq, at, source (human,agent ou system), un kind et éventuellementtabId, tileId et data.
Le journal ne remplace pas l’état : il raconte les changements. Il est borné parsummarize — chaînes coupées à 160 caractères, profondeur 2 — pour qu’une entrée ne transporte jamais un document ou une sortie de terminal.
Un agent reprend depuis un numéro de séquence avec spark_events_since.
Brief
src/core/brief.ts construit un résumé d’un onglet : ses tuiles, leurs titres, leurs lignes describe, les événements récents et les autres onglets. Le texte est plafonné à 1 400 caractères et chaque résumé à 120. Les événements bruyants commetile.focus et tab.reorder sont filtrés.
Persistance
~/Library/Application Support/fr.spark.desktop/
workspace-v1.json onglets, tuiles, dispositions, état, thème
workspace-recovery.json copie écrite lors d'une reprise de format invalide
settings-v1.json { "dev": boolean }
extensions.json paquets installés, versions, sources de dépôt
extensions/<id>/<version>/
markdown-access.json jetons des fichiers Markdown autorisés
explorer-access.json jetons des dossiers autorisés
run/mcp.sock socket MCP
run/tools.json cache de la liste d'outils pour le pont
~/Library/Caches/fr.spark.desktop/pdf/<id>.pdfworkspace-v1.jsonest écrit après un debounce de 180 ms.- Les écritures sont sérialisées : une écriture plus ancienne ne peut jamais écraser une plus récente.
- Sur un format invalide, le runtime repart d’un espace neuf et marque
recovery; la première sauvegarde copie l’ancien fichier dansworkspace-recovery.jsonau lieu de le détruire. - La fermeture de la fenêtre attend
persistence.flush()avant de la détruire. - Le dossier
fr.lab.desktopd’avant le renommage est repris au premier lancement, sans écraser les fichiers existants.
Annuler
⌘Z et ⇧⌘Z annulent et rétablissent les opérations de disposition : déplacements et redimensionnements, y compris ceux qu’un agent a lancés viaspark_tile_move et spark_tile_resize. L’historique est propre à l’onglet et au mode, et ne touche jamais au contenu des tuiles.