For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/modules/task-recovery.md (or send Accept: text/markdown).

API de tareas y recuperación

Recupera un envío incierto sin crear otra tarea.

Preguntar sobre esta guía

Antes de comenzar

Abra su proyecto supastack descargado en Visual Studio Code usando Archivo → Abrir carpeta, luego elija Terminal → Nueva terminal. La raíz del repositorio es la carpeta que contiene package.json, aplicaciones y paquetes. Ejecute el comando a continuación y deje su terminal abierta. Si no se reconoce un comando, finalice la guía de instalación de la herramienta antes de continuar.

Lea primero el tutorial de la plataforma. Un servidor es el proceso de la aplicación que responde a las solicitudes del navegador o del teléfono. La web lee apps/web/.env.local, Expo lee apps/mobile/.env.local y los comandos de migración de bases de datos leen root .env. La demostración sin base de datos/panel de control está separada de las cuentas reales/de autenticación, que necesitan migrar Postgres. Un proceso de pago solo por teléfono o computadora de escritorio necesita un backend web que se ejecute por separado.

corepack pnpm --filter @supastack/web dev

Configuración y ajustes

POST /api/ai/tasks requiere un espacio de trabajo autenticado y un derecho activo. Una solicitud con clave reserva una tarea inmutable antes del despacho. Idempotency-Key acepta entre 16 y 128 caracteres ASCII: letras, dígitos, guiones bajos o guiones.

POST /api/ai/tasks
Idempotency-Key: a-stable-client-submission-key

Recovery body: { "resume": true }
Status: GET /api/ai/tasks/{taskId}

Flujo de implementación

Guarda la clave de recuperación antes del envío. Si el despacho es incierto, reutiliza la misma clave y el cuerpo de reanudación; el servidor carga la entrada original e intenta de nuevo la misma identidad de Trigger con ámbito de tarea. Si la entrada cambia con la misma clave, devuelve 409 idempotencyConflict.

Un HTTP 202 tras un encolado ambiguo significa que el despacho es incierto. No demuestra que Trigger haya aceptado el trabajo. Las tareas en curso o terminales devuelven el estado guardado sin volver a encolarse. La recuperación sigue exigiendo autenticación, propiedad y derechos.

Verificación y solución de problemas

Prueba la pérdida de respuesta, un conflicto por cambio de entrada, una solicitud de otro espacio de trabajo y la restauración al actualizar la página. No hay un despachador de outbox automático ni una garantía integral de ejecución exactamente una vez. No restablezcas a enqueued una tarea en curso sin investigar sus efectos secundarios.