Provider session limit zapsaný jako obecný incident
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Implementační agent ukončil CLI s návratovým kódem 1 a zprávou, že dosáhl limitu relace. Orchestrátor událost uložil jako obecný INCIDENT, i když poslední věcný výsledek i pracovní strom zůstaly beze změny. Standardní budget recovery pak operaci odmítla, protože podporovala jen stav BLOCKED_ON_BUDGET.
Root cause
Sekce “Root cause”Adapter sloučil dvě odlišné třídy selhání do stejného výsledku:
provider usage/session limit -> rc 1 -> generic adapter incidentarbitrary adapter failure -> rc 1 -> generic adapter incidentTím se ztratila informace, že první větev je bezpečně obnovitelná rotací agentní relace. Obecné obnovení každého rc 1 by naopak bylo nebezpečné, protože neznámý výsledek mohl nastat po částečném efektu.
Fix
Sekce “Fix”Recovery přijímá jen hash konkrétní journal události a úzký normalizovaný tvar provider hlášky. Dále ověří, že incident vznikl přímo z implementační fáze, že neexistuje novější incident a že databáze stále odpovídá přesné verzi blokace.
INCIDENT(version=N, source=IMPLEMENTING) + exact journal SHA + recognized provider session-limit message + no newer failure -> atomic CAS to IMPLEMENTING(version=N+1) -> fresh operation-scoped session, initialized=falsePřed změnou databáze se durabilně zapíše recovery intent. Po atomické změně fáze a session bindingu se zapíše výsledek, takže opakované spuštění je idempotentní. Jakýkoli jiný adapter error zůstává fail-closed.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Hledej obecné větve
rc != 0 -> INCIDENT, které nezkoumají strojově rozpoznatelné provider limity. - Anti-pattern: Recovery podle volného textu bez vazby na journal hash, verzi stavu a původní fázi.
- Lepší přístup: Klasifikuj limit co nejblíže adapteru; recovery dělej jako úzký compare-and-swap s novým session ID, durable intentem a regresním testem pro odmítnutí nesouvisejícího
rc 1.
Sister bugs / související
Sekce “Sister bugs / související”Příbuzná je ztráta finální agentní obálky po úspěšné assistant zprávě. Tam je vhodná reconciliation stejné relace; zde je správná rotace relace, protože provider výslovně ukončil její dostupný rozpočet.