Adaptateurs de fournisseurs
Ce qu’un outil en ligne de commande doit satisfaire pour être piloté par Deskworth · documenté sur les trois adaptateurs qui existent, pas sur un quatrième hypothétique.
Livré dans la construction courante. Vous pouvez le faire sur votre machine aujourd’hui.
LimiteQuatre adaptateurs existent : les trois CLI documentés ici, et un endpoint de modèle local, inscrit dans la matrice des fournisseurs. En ajouter un autre est un travail du cœur, pas du site, et cette page n’en décrira pas un avant qu’il existe.
#Le contrat
Un adaptateur répond à cinq questions sur un binaire, et rien d’autre. Il n’interprète jamais la sortie du modèle ; il transforme un flux d’octets en évènements.
| Question | Ce que l’adaptateur fournit |
|---|---|
| Quel binaire ? | Le nom de l’exécutable à chercher dans le chemin. |
| Comment le démarre-t-on ? | La liste exacte d’arguments pour une exécution sans interface, non interactive, dans un atelier donné. |
| Comment lit-on sa sortie ? | Une normalisation du format de flux de l’éditeur vers les phases et les évènements d’outils de Deskworth. |
| Comment l’annule-t-on ? | Un chemin d’arrêt qui termine le processus et libère l’atelier. |
| Que rapporte-t-il de la consommation ? | Ce que le CLI publie, ou rien, ce que l’en-tête dit alors. |
#Normaliser un flux, pas le résumer
Chaque éditeur émet un flux différent. L’adaptateur le ramène à un vocabulaire commun de phases pour qu’une trace se lise pareil quel que soit le CLI qui l’a produite. Ce qu’il ne doit jamais faire, c’est condenser : chaque ligne de trace correspond à un évènement qui a réellement eu lieu, et la sortie brute reste accessible en dessous, entière, avec la ligne de commande exacte.
La ligne de commande est émise avant la première ligne de sortie, délibérément : une carte doit pouvoir se rejouer à la main. Si ce que vous voyez dans la trace ne se reproduit pas en lançant cette commande vous-même, la trace est fausse et l’adaptateur est en tort.
#Le mandat entre par l’entrée, pas par les arguments
Une carte envoie sa consigne sur l’entrée standard du processus et laisse cette entrée ouverte. C’est ce qui permet à une carte de continuer : un second message reprend la même session, contexte intact. Vérifié le 2026-08-26, demander à une carte de retenir un nombre, puis le lui redemander, rend le nombre, avec le flux structuré et le rapport de consommation préservés.
#Ce qu’un adaptateur ne doit jamais faire
- Conserver ou lire une clé d’éditeur. Les identifiants appartiennent au CLI et au trousseau.
- Réécrire la sortie du modèle avant qu’elle n’atteigne la trace.
- Élargir la portée d’un rôle. Les capacités sont vérifiées par le serveur d’outils, pas par l’adaptateur.
- Garder un processus en vie après que sa carte a fini.
- Assembler sa commande par un shell. Aucun interpréteur ne se trouve sur le chemin du registre au processus.
#Détecter n’est pas promettre
La détection est un fait sur la machine : l’application voit qu’un binaire existe et peut être lancé. Savoir si l’abonnement derrière lui est actif n’appartient qu’à l’éditeur, et cela remonte à la première carte qui tourne, d’où des états de connexion qui distinguent « installé » de « connecté » au lieu de les fondre en « utilisable ».
#Sources
- The provider manifest, generated by the coreDeskworthDocument interne, non publié
- Deskworth OS, product state at 0.0.23DeskworthDocument interne, non publié