Workflow SDK agora roda nativamente no Nitro v3
Aprofundamento CEVIU
Aprofundamento
O Workflow SDK agora roda nativamente no Nitro v3, não como um wrapper ou camada de compatibilidade, mas integrado diretamente ao sistema de build e runtime do Nitro. Isso significa que workflows escritos em TypeScript com o SDK são compilados via Rolldown (novo bundler padrão do Nitro v3), transformados em manipuladores HTTP virtuais e executados com menos de 10 kB de bundle, sem dependências externas. A integração é ativada com import { workflow } from 'workflow/nitro' no nitro.config.ts, liberando diretivas como use workflow e use step para definir fluxos suspensíveis, observáveis e retomáveis, essenciais para agentes de IA que precisam manter estado entre chamadas.
O suporte nativo foi anunciado oficialmente no Ship AI, evento da Vercel em novembro de 2025, e está alinhado ao WDK (Workflow Development Kit), que já suporta oito frameworks, incluindo Hono, Express, SvelteKit e Next.js, graças à abstração do Nitro v3 como camada de implantação agnóstica. A versão alpha.0 do Nitro v3 foi lançada em 11 de outubro de 2025 na Vite Conf, seguida pela beta em 11 de março de 2026. Hoje, o Nitro v3 registra ~280 mil downloads semanais e exige Node.js 20+ (Node.js 18 entra em fim de vida em abril de 2025).
Por que isso importa
Isso elimina a necessidade de servidores intermediários, proxies ou configurações manuais de endpoints para workflows. Um desenvolvedor pode escrever um agente de IA em TypeScript, declarar um @step que chama uma API externa e outro que salva dados no KV embutido do Nitro, tudo compilado e implantado automaticamente em Cloudflare Workers, Vercel ou Netlify com zero config. O Hot Module Replacement (HMR) funciona nativamente: alterar um passo do workflow recarrega só aquele módulo, sem reiniciar o servidor inteiro. Isso acelera ciclos de teste de agentes que dependem de execução síncrona, suspensão e retomada, cenário comum em automação jurídica, atendimento com memória de sessão ou fluxos de aprovação com múltiplas etapas.
Impacto para desenvolvedores
Desenvolvedores que usam frameworks leves como Hono ou Express ganham superpoderes de workflow sem abandonar sua stack: o Nitro v3 agrupa os workflows com esbuild, monta endpoints HTTP automáticos e injeta primitivas como caching, cron jobs e armazenamento KV com mais de 20 drivers, tudo acessível via event.context.storage ou event.context.cache. Não há mais necessidade de configurar Redis, gerenciar filas ou escrever handlers manualmente. Para quem já usa Nuxt ou SvelteKit, a atualização é transparente: basta atualizar para Nitro v3 e importar o módulo workflow/nitro. A compatibilidade com Vite v8 e o suporte experimental a canais de rastreamento também permitem depurar workflows com tracing granular, algo crítico para depuração de falhas em cadeias longas de chamadas de LLMs.
Perguntas frequentes
O que significa 'suporte nativo do Workflow SDK no Nitro v3'?
Significa que o Workflow SDK compila e executa workflows diretamente dentro do pipeline de build e runtime do Nitro v3, usando Rolldown, HMR e as primitivas embutidas do Nitro (como KV, cache e cron). Não é uma camada de compatibilidade ou wrapper. Workflows viram manipuladores HTTP virtuais automaticamente, sem configuração manual de rotas ou servidores.
Quando o Nitro v3 foi lançado e qual a versão mínima exigida?
A versão alpha.0 do Nitro v3 foi lançada em 11 de outubro de 2025 na Vite Conf. A versão beta foi anunciada em 11 de março de 2026. A versão mínima requerida é Node.js 18, mas Node.js 20 ou superior é obrigatório a partir de abril de 2025, quando o Node.js 18 atinge fim de vida.
Como habilitar o Workflow SDK no Nitro v3?
Basta instalar o pacote workflow-sdk, importar workflow/nitro no arquivo nitro.config.ts e adicionar a diretiva use workflow nas configurações. Após isso, workflows definidos com @step são automaticamente expostos como endpoints HTTP e gerenciados pelo runtime do Nitro v3.
O Workflow SDK com Nitro v3 funciona em Cloudflare Workers e Vercel?
Sim. O Nitro v3 é projetado como fundação agnóstica de implantação. Ele gera bundles compatíveis com Cloudflare Workers, Vercel, Netlify e servidores tradicionais. A Vercel oferece implantação sem configuração para apps Nitro v3, detectando automaticamente e configurando filas, funções por rota e KV, tudo integrado ao Workflow SDK.
- Categoria
- CEVIU Web Dev
- Publicado
- 13 de junho de 2026
- Fonte
- CEVIU Web Dev
