code, title y message, además de un mapa fields en un 422. Los códigos son NRY- y cuatro dígitos. Cita el código cuando reportes un problema. La descripción general de la API del host describe el transporte por el que llegan estas respuestas.
{ "code": "<code>", "title": "<title>", "message": "<message>" }
Códigos que responde el host
El
message siempre nombra lo específico que falló. Léelo antes de actuar según la fila siguiente.
| Código | Estado HTTP | Cuándo lo responde el host | Qué hacer |
|---|---|---|---|
| NRY-0000 | 400 | La solicitud está mal formada. El cuerpo no es JSON válido, o un valor no se vincula a su tipo declarado. | Corrige la codificación de la solicitud. El mensaje nombra la parte que no se pudo vincular. |
| NRY-0001 | 422 | El cuerpo de una solicitud falló la validación. | Corrige las propiedades que nombra el mapa fields, y vuelve a enviar la solicitud. |
| NRY-0002 | 404 | Ninguna sesión de este host tiene el sessionId de la solicitud. | Lista las sesiones para obtener un id válido. |
| NRY-0003 | 409 | La sesión objetivo está archivada. Una sesión archivada no acepta trabajo nuevo. | Bifurca la sesión en una entrada para continuar desde su transcripción, o dirígete a una sesión activa. |
| NRY-0004 | 409 | La sesión o el carril objetivo no puede aceptar la solicitud en su estado actual. | Espera a que termine el trabajo en curso, o interrúmpelo, y vuelve a enviar la solicitud. |
| NRY-0006 | 409 | Dos paquetes reclaman el mismo slot reemplazable. No se instaló nada. Un trabajo de paquete que falla de esta manera lleva el código en su campo error. | Elimina o deshabilita a uno de los reclamantes, y vuelve a instalar. El mensaje nombra a ambos. |
| NRY-0007 | 409 | Falló la compilación de un paquete. El binario que ya estaba en servicio permanece intacto. Un trabajo de paquete que falla de esta manera lleva el código en su campo error. | Lee el error del trabajo, corrige o elimina el paquete, y vuelve a instalar. |
| NRY-0009 | 404 | La sesión par a la que se dirigió ya no está en este host. | Lista los pares para actualizar el conjunto de sesiones direccionables, y vuelve a enviar el mensaje. |
| NRY-0010 | 422 | Un script de workflow falló la validación antes de que empezara la ejecución. | Corrige los errores del script que nombra el mensaje, y vuelve a iniciar la ejecución. |
| NRY-0012 | 500 | El almacén local no está disponible, o falló su verificación de integridad. El host rechaza las escrituras en lugar de trabajar sobre un almacén dañado. | Verifica el espacio en disco y la integridad del almacén, corrige la causa, y reinicia el host. |
| NRY-0015 | 404 | El recurso indicado no existe en este host. Los paquetes, los trabajos de paquete, las recetas de agente, las skills, los comandos, los carriles, los monitores, los proveedores, las programaciones, las ejecuciones de workflow, las solicitudes entre sesiones y las entradas de transcripción responden con este código. | Lista la colección a la que pertenece el recurso, y usa un nombre o id de ella. |
| NRY-0016 | 409 | Ya hay un paquete instalado con este nombre. | Elimina primero el paquete instalado, o instala con otro nombre. |
| NRY-0017 | 409 | Una habilitación o una deshabilitación intercambió el binario, y luego no pudo confirmar la fila del paquete. | El cambio ya se aplica al binario que se ejecuta ahora. Vuelve a enviar la solicitud, o reinicia el host para que la sincronización de inicio actualice la fila. |
| NRY-0020 | 412 | Una escritura condicional llevaba un ifMatchesSha256 al que el valor almacenado ya no genera el mismo hash. Otro cliente escribió la fila primero, y no se escribió nada. | Vuelve a leer el recurso para ver qué contiene ahora. Un cliente que borra un borrador que envió puede tratar esto como un éxito. |
| NRY-0021 | 500 | El host no pudo hacer la solicitud en esta máquina. Un proceso que debía iniciar no se inició, o una operación falló por una razón que no tiene un código más exacto. | Nada de la solicitud estaba mal, así que vuelve a enviarla. El log del host lleva la causa, que el mensaje omite. |
| NRY-0022 | 500 | Un rewind que restaura archivos indicados se detuvo a mitad de camino. Algunos archivos volvieron y el resto quedó sin tocar. | Lee el mensaje para ver los archivos que se movieron. El árbol de trabajo tal como estaba antes del intento se conserva como punto de restauración. |
| NRY-0023 | 500 | Un rewind de la conversación y los archivos bifurcó la conversación, y luego no pudo restaurar los archivos. La bifurcación es real. | Continúa en la sesión que nombra el mensaje, y luego haz un rewind de los archivos solos desde la sesión original en el mismo momento. |
| NRY-0024 | 413 | La importación de una transcripción superó un límite de tamaño. | Lee el mensaje para ver el límite que nombra, y envía una transcripción más pequeña. |
| NRY-0025 | 409 | Se rechazó una solicitud bloqueante entre sesiones, porque concederla cerraría un bucle de sesiones que se esperan entre sí. | Responde o deja que expire la solicitud ya en curso, o envía en su lugar un mensaje de una sola vía. El mensaje nombra ambas sesiones. |
| NRY-0026 | 409 | Un stream se reanudó desde un Last-Event-ID que nombra un evento más reciente que cualquiera que tenga este almacén. | Reanuda sin Last-Event-ID, y luego vuelve a leer el estado a través de las operaciones GET. El mismo cursor se rechaza de forma idéntica cada vez. |
| NRY-0027 | 413 | Los archivos de un mensaje pesan, en conjunto, más de lo que puede llevar una solicitud al proveedor. No se escribió nada. | Envía menos archivos en el mensaje, o archivos más pequeños. El mensaje nombra el límite en bytes. |
Códigos que lleva un turno fallido
Un turno que falla termina con un evento
turn-finished. Su payload.error lleva el mismo envelope que un error HTTP. Tres códigos llegan de esa manera, y el host nunca los responde como un estado HTTP.
| Código | Evento | Cuándo lo escribe el host | Qué hacer |
|---|---|---|---|
| NRY-0008 | turn-finished | El proveedor de modelo que necesitaba el turno no tiene una credencial utilizable. Falta, está vencida o fue rechazada, o el keyring no está disponible. | Inicia sesión con narya auth login <provider>, y vuelve a enviar el mensaje. El mensaje nombra el remedio que corresponde. |
| NRY-0018 | turn-finished | El turno no pudo comunicarse con ningún proveedor de modelo. La sesión no nombra ningún proveedor, o nombra uno del que este host no tiene registro. | Inicia sesión con narya auth login <provider>, o define default_model en el config.toml del host, y vuelve a enviar el mensaje. narya providers muestra lo que puede usar esta máquina. |
| NRY-0019 | turn-finished | El turno falló por una razón que no tiene un código más específico. El mensaje lleva la causa. Narya elimina de él las formas de credencial conocidas y los secretos de URL, y reemplaza tu directorio home con ~. Las rutas del host fuera de tu home permanecen. | Lee el mensaje. El log del host lleva la misma falla sin la redacción. |