Workflow SDK agora oferece suporte para cancelamento em tempo de execução

O suporte a cancelamento em tempo de execução no Workflow SDK da Vercel, introduzido na versão @workflow/[email protected], lançada em 5 de junho de 2026, é uma evolução técnica concreta do modelo de execução durável. Ele se baseia nas APIs nativas do navegador AbortController e AbortSignal, agora estendidas para funcionar de forma confiável entre etapas, suspensões e replays determinísticos. Isso significa que um sinal de cancelamento criado dentro de um workflow persiste mesmo após pausas, falhas ou reinícios, e é reconhecido por cada etapa que o recebe, desde que ela inspecione o sinal ou o passe para uma API compatível (como fetch). Não é um kill forçado: é um mecanismo cooperativo, alinhado com padrões web consolidados.

O recurso foi projetado para cenários reais de produção: interromper uma etapa lenta quando um timeout durável vence uma corrida, encerrar requisições paralelas após a primeira resposta bem-sucedida, ou abortar todo um pipeline ao detectar uma mudança externa, como a revogação de permissão por um usuário ou a falha de um serviço dependente. A documentação oficial destaca que o cancelamento é tratado como um AbortError serializado, considerado um erro fatal entre reinos (cross-realm), garantindo que não seja ignorado acidentalmente durante o replay.

Cancelamento em tempo de execução resolve um problema antigo em workflows duráveis: a inércia. Antes, uma etapa iniciada, especialmente em operações de longa duração como processamento de documentos, chamadas a LLMs ou automação de navegador, continuava rodando mesmo após a condição que a disparou deixar de ser válida. Isso gerava desperdício de recursos, custos desnecessários e riscos de inconsistência. Com essa atualização, equipes Pro e Enterprise podem agora desenhar fluxos mais responsivos e seguros, especialmente com o aumento do limite de execução das Vercel Functions para até 30 minutos (desde 15 de junho de 2026). É um passo crítico para agentes de IA duráveis construídos com o Vercel AI SDK v7, onde o WorkflowAgent já marca cada chamada de ferramenta como etapa durável, e agora pode ser interrompido de forma limpa, sem deixar estados órfãos ou ações pendentes.

Para desenvolvedores, o cancelamento não exige novas abstrações: basta instanciar um AbortController no workflow, passar seu signal para as etapas relevantes e chamar controller.abort() quando necessário. O sinal sobrevive a suspensões e é reconhecido mesmo em invocações separadas, graças à serialização e ao replay determinístico do SDK. A integração nativa com Nitro v3 (em beta desde 13 de junho de 2026) reforça isso: etapas executam no mesmo runtime do aplicativo, tornando o uso do AbortSignal ainda mais natural e eficiente. Além disso, o painel de observabilidade integrado permite acompanhar visualmente quando um cancelamento ocorreu, em qual etapa e por qual motivo, sem precisar de instrumentação adicional. O Python SDK em beta público também já suporta esse padrão, alinhando a experiência entre linguagens.