Hacer persistentes y reintentables las funciones TypeScript con el Workflow SDK

Install

npm install workflow

Para quién

Este skill encaja en quien quiere escribir funciones «persistentes» en TypeScript o JavaScript: el texto oficial dice que guarda el progreso del workflow, reintenta pasos fallidos y ofrece observabilidad integrada. También encaja en quien ya usa Next.js y planea enganchar la envoltura oficial en la configuración.

No encaja en quien solo quiere arrancar un workflow directo en el navegador. El texto fuente limita el lugar de arranque a rutas API, Server Action u otro código de servidor. Si aún no puedes ejecutar npm, o no aceptas una instalación local de paquete, detente en leer la guía.

Tras instalar el paquete, un agente de código puede leer guías alineadas con la versión actual desde node_modules/workflow/docs. El repositorio oficial es

https://github.com/vercel/workflow

Sigue los comandos ya escritos en esa página.

Primera prueba en 3 minutos

Sigue solo el único camino de instalación que escribe el texto oficial.

Requisito: esta máquina puede ejecutar npm y el directorio actual es un proyecto al que se le pueden escribir dependencias. Confirma primero: npm install workflow cambiará la lista de dependencias y descargará un paquete. Si aún no quieres cambiar este proyecto, no lo ejecutes.

Lugar de instalación: abre un terminal en la raíz del proyecto, confirma esos efectos secundarios y luego ejecuta:

npm install workflow

Tarea de bajo riesgo: tras instalar el paquete, no te apresures a arrancar un workflow en una ruta en vivo. Primero pide al agente de código que abra node_modules/workflow/docs en solo lectura, compruebe que se ve una guía local alineada con la versión actual y encuentre la importación que debe usar Next.js. No escribas archivos ni envíes peticiones hacia fuera.

Señal de éxito: el paquete workflow aparece en las dependencias del proyecto, node_modules/workflow/docs se puede abrir en local y el agente puede señalar la importación oficial import { withWorkflow } from 'workflow/next'. Si inventa otro comando de instalación, vuelve al comando oficial de arriba y reintenta.

Casos de uso

Caso 1: enganchar la envoltura oficial a un proyecto Next.js. La importación que da el texto es import { withWorkflow } from 'workflow/next'. Encaja en quien ya tiene un proyecto Next.js y quiere comprobar primero la entrada de configuración. Puedes pedir primero al agente que marque en solo lectura el archivo de configuración a cambiar y escribir tras confirmar. Si el texto no expande un objeto de configuración completo, detente en «usar esa importación»; no inventes opciones que no aparecen.

Caso 2: arrancar un workflow persistente desde el servidor. El texto dice que luego puedes arrancar un workflow desde una ruta API, una Server Action u otro código de servidor. Encaja en quien ya instaló el paquete y tiene una entrada de servidor. La primera vez, pide al agente que señale desde qué entrada de servidor existente arrancarás; no crees una entrada de cliente sin explicar. El progreso se persiste y los pasos fallidos se reintentan; cuántos reintentos y cómo abrir un panel de observabilidad no están escritos — no los inventes.

Límites de uso

Solo hay un comando oficial de instalación escrito: npm install workflow. No pongas un instalador que no aparece en el camino principal. Las capacidades cubren persistencia, reintento de pasos fallidos y observabilidad integrada para funciones TypeScript y JavaScript; no prueban el uso en otros lenguajes.

El lugar de arranque solo está escrito como rutas API, Server Action u otro código de servidor. No arranques directo desde el navegador o un cliente no nombrado. La ruta de docs local es node_modules/workflow/docs, para que un agente de código lea guías alineadas con la versión; no da una lista de clientes, así que no lo trates como exclusivo de unos pocos asistentes.

Secretos, backends de cola y cuentas de observabilidad de producción no se desarrollan. La página oficial es