​

Protocole de prise en main + configuration

​

Composants

• Moteur d’assistant (session partagée + invites + état de prise en main).
• La prise en main via la CLI utilise le même flux d’assistant que les clients UI.
• La Gateway RPC expose des points de terminaison pour l’assistant et le schéma de configuration.
• La prise en main macOS utilise le modèle d’étapes de l’assistant.
• L’interface Web génère des formulaires de configuration à partir de JSON Schema + indices UI.

​

Gateway RPC

• wizard.start params : { mode?: "local"|"remote", workspace?: string }
• wizard.next params : { sessionId, answer?: { stepId, value? } }
• wizard.cancel params : { sessionId }
• wizard.status params : { sessionId }
• config.schema params : {}

• Assistant : { sessionId, done, step?, status?, error? }
• Schéma de configuration : { schema, uiHints, version, generatedAt }

​

Indices UI

• uiHints indexés par chemin ; métadonnées optionnelles (label/aide/groupe/ordre/avancé/sensible/placeholder).
• Les champs sensibles sont rendus comme des champs de mot de passe ; pas de couche de masquage.
• Les nœuds de schéma non pris en charge basculent vers l’éditeur JSON brut.

​

Remarques

• Ce document est l’unique référence pour suivre les refactorisations de protocole liées à la prise en main et à la configuration.