Notes de version AgentDoc – Avril 2026

Une série courte et dense de corrections a été livrée dans AgentDoc (aussi connu sous le nom de agent doc, agentdocs, docedit) au cours du dernier sprint. Le thème de cette fois est la justesse du moteur de rendu : des cas limites où la sortie d'outil de l'agent était techniquement valide mais où la couche visuelle perdait des informations ou, pire encore, fabriquait des styles que l'agent n'avait pas réellement demandés. Cinq correctifs, tous ciblés, sans modification de l'API.

1. Listes imbriquées : profondeur relative préservée pendant la normalisation

Lorsque l'agent émettait des listes ordonnées/non ordonnées imbriquées avec une indentation mixte, la passe de normalisation du moteur de rendu réduisait les profondeurs au niveau minimum présent dans le markdown – ce qui signifiait qu'une liste de la forme 1. → 1.1. → 1.1.1. s'affichait comme trois éléments du même niveau plutôt que comme une arborescence. Le correctif fait passer le normaliseur du plancher absolu au décalage relatif : les différences de profondeur au sein du bloc sont préservées, seule l'indentation globale est normalisée.

Pourquoi cela compte pour les agents : de nombreux modèles émettent des appels insert_text dont le contenu a été reformaté au niveau du LLM (par exemple un modèle ayant appris l'indentation à 2 espaces alors que le document utilise 4 espaces). Le moteur de rendu doit respecter la structure, et non les espaces bruts.

2. Les classes de décoration se composent désormais au lieu de se remplacer

Auparavant, appeler apply_decoration(target, "decoration-underline") sur un span qui portait déjà decoration-strikethrough écrasait la classe existante. C'est la mauvaise sémantique : les décorations sont orthogonales (vous pouvez souligner et barrer le même token), et notre docstring promettait exactement cela. Le bug provenait d'une unique affectation className = dans le setter de décoration, que nous avons remplacée par une gestion appropriée de classList qui ajoute sans supprimer les frères de la même famille.

3. Les outils apply_* ont désormais une sémantique TOGGLE correcte

La surface d'outils MCP annonçait un comportement de bascule sur apply_bold, apply_italic, apply_underline, etc. – ce qui signifie qu'un second appel sur la même sélection devait retirer la mise en forme, et non l'appliquer en double. L'implémentation, cependant, était toujours en mode activation. Le correctif introduit une vérification d'état sur le span résolu et se ramifie : si la mise en forme est déjà présente et couvre entièrement la sélection, elle est retirée ; si elle est absente ou partielle, elle est appliquée uniformément.

Cela compte plus qu'il n'y paraît. Les flux vocaux s'appuient fortement sur « en fait, annule ça » comme signal de répétition ; l'agent qui traduit cela en un second appel apply_bold fait désormais ce qu'il faut sans avoir besoin d'appeler un outil remove_format distinct. Nous avons supprimé deux allers-retours LLM d'un chemin courant.

4. Échappement du code en ligne à l'intérieur des attributs [text]{.class}

La pré-passe du moteur de rendu pour notre syntaxe d'attributs étendue s'exécutait avant l'étape markdown-vers-HTML, ce qui signifiait que des chaînes comme `[text]{.foo}` apparaissant à l'intérieur de code en ligne délimité par des backticks (c'est-à-dire la documentation littérale de la syntaxe) étaient réécrites en spans stylisés au lieu d'être affichées comme du code. Nous ignorons désormais la réécriture lorsque l'offset se trouve à l'intérieur d'un span de code. Les pages de documentation – y compris celle-ci – s'affichent à nouveau correctement.

5. Les classes decoration-* s'appliquent à n'importe quel élément

Les règles CSS pour .decoration-underline, .decoration-strikethrough etc. étaient cantonnées à span.decoration-*. Cela fonctionnait pour le cas courant mais échouait lorsque l'agent appliquait une décoration à un titre, un élément de liste ou une cellule de tableau. Le correctif retire le qualificateur de nom d'élément, de sorte que les décorations sont désormais orthogonales au type d'élément – cohérent avec le correctif de sémantique de bascule ci-dessus et avec la documentation.

La suite

Le prochain lot de travaux est en file d'attente autour des flux BYOK (apportez votre propre clé API Gemini), ce qui nécessite d'apprendre à la fenêtre modale du frontend et à la pastille d'état du quota à coexister avec les nouveaux modules byok_modal.js et quota_status.js. Ensuite, nous effectuerons une passe ciblée sur le routeur de chat, qui a accumulé des branches.

Si vous souhaitez comprendre le raisonnement technique derrière les décisions de conception d'outils évoquées ci-dessus, l' article sur la granularité des outils présente le cadre que nous utilisons pour décider si un comportement doit être un outil, un argument d'outil, ou poussé dans la couche de raisonnement du LLM.