Errores y recuperación

Cuando un flow falla, el gateway devuelve un error estructurado para que tu agente explique la causa y proponga el siguiente paso. Esto no repara ni modifica automáticamente el código firmado del flow.

Tipos de error

Validación de input fallida (no reintentable): lo que le pediste al flow no encaja con lo que espera — trae la lista exacta de campos que no validaron, para que el agente ajuste los argumentos y lo intente de nuevo.

Fallo durante el flow: un selector puede haber cambiado, la web puede no responder o un paso puede agotar su tiempo. Cuando existe contexto de navegador, el error puede incluir el paso, la URL y un resumen acotado del DOM.

Fallo de infraestructura o acceso: situaciones como worker desconectado, login requerido, autorización de release o autenticación conservan códigos propios. No deben tratarse como si fueran un selector roto ni reintentarse sin revisar la acción sugerida.

Forma del payload

{
  code, message, flow, profile?, step?, url?, retryable,
  suggestedAction?, domSnapshot?, validationErrors?
}

El resumen del DOM

Cuando está disponible, el worker adjunta un resumen acotado de la página. Sirve para diagnosticar el estado observado sin enviar el DOM completo. No debe contener cookies, tokens, campos sensibles ni HTML sin límite.

Qué hace tu agente con esto

El agente puede corregir argumentos inválidos, pedirte que restaures una sesión, comprobar el worker, explicar un fallo transitorio o proponerte otro flow descubierto. Si el sitio cambió y el flow firmado necesita código nuevo, la recuperación correcta es esperar una release actualizada y aprobar su digest cuando el gateway lo solicite; el agente no parchea ese código por su cuenta.