Přeskočit na obsah

Přerušená odpověď agentního CLI nesmí ztratit rozpracovaný stav

import { Aside } from ‘@astrojs/starlight/components’;

Agent dokončí část práce a začne připravovat odpověď, ale CLI skončí s návratovým kódem 1. stderr je prázdný, takže orchestrátor zapíše neprůhledný incident, přestože strukturovaný stdout obsahuje přesnou zprávu o přerušeném spojení.

Příbuzná varianta nastane, když stream obsahuje finální assistant/end_turn zprávu popisující dokončené změny, ale CLI už nevydá závěrečnou result událost. Pracovní strom je v takovém případě hotový a rozpracovaný; zopakování implementace by bylo nebezpečné stejně jako jeho automatické zahození.

Některá agentní CLI zapisují API chybu jako závěrečnou událost do streamovaného JSON na stdout, nikoli do stderr. Adaptér, který při nenulovém návratovém kódu čte jen stderr, zahodí jedinou autoritativní diagnostiku. Slepé zopakování původního editačního promptu by navíc mohlo podruhé provést již dokončené změny.

Adaptér při nenulovém návratu parsuje také poslední strukturovanou výslednou událost. Přesně rozpoznaný transportní výpadek obnoví jednou novým promptem, který:

  • zakazuje opakovat práci nebo měnit soubory,
  • dovoluje pouze read-only nástroje,
  • požaduje rekonstrukci aktuálního stavu a výslednou protokolární obálku.

Ostatní nenulové návraty zůstávají fail-closed a v chybě nesou buď stderr, nebo bezpečně vytažený závěrečný text ze stdout.

U varianty bez result události se volný assistant text nikdy nepovažuje za protokolární úspěch. Adaptér smí jednou obnovit tutéž session pouze read-only žádostí o chybějící obálku. Recovery se váže na přesný incident, původní commit a digest neprázdného pracovního stromu; finalizér pak přeskočí kontrolu čistého stromu, spustí bránu nad zachovanou prací a teprve po jejím úspěchu vytvoří commit. Druhé chybějící result už končí strukturovaným blokem, ne opakováním editací.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: simuluj exit 1, prázdný stderr a JSON result s textem Connection closed mid-response.
  • Detection: samostatně simuluj assistant/end_turn, žádnou result událost, exit 1 a neprázdný pracovní strom.
  • Anti-pattern: diagnostika procesu používá výhradně stderr a retry znovu posílá původní mutační prompt.
  • Lepší přístup: klasifikuj známé transportní chyby přes oba streamy, rozlišuj assistant text od protokolární obálky a obnovuj jen read-only finalizaci výsledku s jediným omezeným pokusem.

Sister bugs / související

Sekce “Sister bugs / související”
  • transient-cli-version-probe-restart-loop.md — dočasná chyba při startovní kontrole CLI.
  • implementer-no-go-nesmi-byt-incident.md — věcný NO-GO se nesmí zaměnit za technický incident.
Přidal aiarchitekt.cz · 25. 8. 2026 2:00
Provozuje aiarchitekt.cz