Cycle de vie, erreurs et identité
| Code | Signification |
|---|---|
0 | Succès. |
1 | Erreur de validation, configuration ou exécution. |
130 | Annulation. |
Cette table concerne les sessions Débat, Ask et Chat et les catalogues. Relay et son option Mission utilisent leur propre table, avec notamment les codes 2 à 9 : consultez Relay. Branchez Relay sur status et delivery.status, pas seulement sur le code.
Attendez toujours la fermeture du processus. error décrit l'échec métier ; le code confirme l'état final.
Un événement error peut contenir la phase, l'agent, le rôle, le tour, un kind stable, un message et des détails. Les kinds incluent notamment command-not-found, spawn-failed, timeout, idle-timeout, output-too-large, empty-output, non-zero-exit, usage-limit, unsupported-model, model-unavailable, model-pull-failed, http-error et cancelled. Pour un usage-limit, retryAfter est parfois présent : durée en secondes, timestamp ISO ou heure locale HH:mm. Il est best-effort ; branchez la logique sur kind, pas sur le texte du message.
Palabre tente de conserver les réponses dans un export partiel après un échec. Acceptez donc done avec un chemin suivi d'un code non nul. Une annulation doit rester distincte d'une erreur.
Identité du client
PALABRE_CLIENT=mon-integration
PALABRE_CLIENT_VERSION=2.3.0
Le nom est libre. Palabre nettoie ces valeurs et les inscrit avec sa propre version dans les exports. Sans déclaration, la source est direct-cli. Ces champs sont diagnostiques, pas une frontière de sécurité.
Relay a ses propres issues : usage-limit et read-unavailable (2), target-not-open (3), review-failed (9), invalid-request avec error.reason (8). retryAfter peut n’être qu’une heure, sans date ni fuseau : présentez-la telle quelle et attendez une décision humaine, sans renvoi programmé. Les champs de provenance client décrits ici concernent les exports Débat/Ask/Chat ; Relay expose sa propre version de PALABRE.