AgentDoc Patch Notes – April 2026

Eine kurze, dichte Runde an Fixes ist im letzten Sprint in AgentDoc (auch bekannt als agent doc, agentdocs, docedit) gelandet. Das Thema dieses Mal ist Renderer-Korrektheit: Grenzfälle, in denen die Tool-Ausgabe des Agenten technisch gültig war, die visuelle Ebene aber entweder Informationen verlor oder, schlimmer noch, Stile erfand, die der Agent gar nicht angefordert hatte. Fünf Patches, alle gezielt, keine API-Änderungen.

1. Verschachtelte Listen: relative Tiefe bei der Normalisierung erhalten

Wenn der Agent verschachtelte geordnete/ungeordnete Listen mit gemischter Einrückung ausgab, hat der Normalisierungs-Durchlauf des Renderers die Tiefen auf die niedrigste im Markdown vorhandene Ebene reduziert – das bedeutete, dass eine Liste der Form 1. → 1.1. → 1.1.1. als drei Geschwister statt als Baum gerendert wurde. Der Fix ändert den Normalizer von absolutem Boden auf relativen Offset: Tiefenunterschiede innerhalb des Blocks bleiben erhalten, nur die globale Einrückung wird normalisiert.

Warum das für Agenten wichtig ist: Viele Modelle geben insert_text-Aufrufe mit Inhalten aus, die auf der LLM-Ebene umgebrochen wurden (z. B. ein Modell, das Einrückung als 2 Leerzeichen gelernt hat, während das Dokument 4 Leerzeichen verwendet). Der Renderer muss die Struktur respektieren, nicht den rohen Whitespace.

2. Dekorationsklassen werden jetzt komponiert statt ersetzt

Bisher hat ein Aufruf von apply_decoration(target, "decoration-underline") auf einem Span, der bereits decoration-strikethrough trug, die vorhandene Klasse überschrieben. Das ist die falsche Semantik: Dekorationen sind orthogonal (man kann denselben Token unterstreichen und durchstreichen), und genau das hat unser Docstring versprochen. Der Bug kam von einer einzigen className =-Zuweisung im Dekorations-Setter, die wir durch ordentliche classList-Buchführung ersetzt haben, die hinzufügt, ohne Geschwister derselben Familie zu entfernen.

3. apply_*-Tools haben jetzt eine korrekte TOGGLE-Semantik

Die MCP-Tool-Oberfläche hat Toggle-Verhalten bei apply_bold, apply_italic, apply_underline usw. beworben – das heißt, ein zweiter Aufruf auf derselben Auswahl sollte die Formatierung entfernen, nicht doppelt anwenden. Die Implementierung war jedoch immer „set-on". Der Fix führt eine Statusprüfung auf dem aufgelösten Span ein und verzweigt: Ist die Formatierung bereits vorhanden und deckt sie die Auswahl vollständig ab, wird sie entfernt; ist sie abwesend oder nur teilweise vorhanden, wird sie einheitlich angewendet.

Das ist wichtiger, als es klingt. Sprach-Flows setzen stark auf „ach, mach das rückgängig" als Wiederholungssignal; der Agent, der das in einen zweiten apply_bold-Aufruf übersetzt, tut nun das Richtige, ohne ein separates remove_format-Tool aufrufen zu müssen. Wir haben zwei LLM-Roundtrips aus einem häufigen Pfad entfernt.

4. Escaping von Inline-Code innerhalb von [text]{.class}-Attributen

Der Vorab-Durchlauf des Renderers für unsere erweiterte Attribut-Syntax lief vor der Markdown-zu-HTML-Stufe, was bedeutete, dass Zeichenketten wie `[text]{.foo}`, die innerhalb von durch Backticks begrenztem Inline-Code auftauchten (also wörtliche Dokumentation der Syntax), als gestylte Spans umgeschrieben statt als Code angezeigt wurden. Wir überspringen das Umschreiben jetzt, wenn der Offset innerhalb eines Code-Spans liegt. Dokumentationsseiten – einschließlich dieser – rendern wieder korrekt.

5. decoration-*-Klassen gelten für jedes Element

Die CSS-Regeln für .decoration-underline, .decoration-strikethrough usw. waren als span.decoration-* eingeschränkt. Das funktionierte für den häufigen Fall, scheiterte aber, wenn der Agent eine Dekoration auf eine Überschrift, ein Listenelement oder eine Tabellenzelle anwandte. Der Fix entfernt die Element-Namens-Qualifizierung, sodass Dekorationen nun orthogonal zum Elementtyp sind – konsistent mit dem Toggle-Semantik-Fix oben und mit der Dokumentation.

Wie geht es weiter

Die nächste Arbeitsrunde steht rund um BYOK an (Bring-Your-Own-Gemini-API-Key), was erfordert, dem Frontend-Modal und der Kontingent-Status-Pille beizubringen, mit den neuen Modulen byok_modal.js und quota_status.js zu koexistieren. Danach machen wir einen gezielten Durchgang durch den Chat-Router, der einige Branches angesammelt hat.

Wenn du die technischen Überlegungen hinter den oben genannten Tool-Design-Entscheidungen nachvollziehen möchtest, deckt der Beitrag zur Tool-Granularität das Framework ab, mit dem wir entscheiden, ob ein Verhalten ein Tool, ein Tool-Argument oder in die Reasoning-Ebene des LLM verlagert werden sollte.