TanStack AI chega à versão 1.0 e mantém a liberdade de escolher provedor e framework

O TanStack AI 1.0 é, segundo o blog do projeto, o compromisso formal com as APIs do core: chat, tools, mídia, MCP, persistência e sandboxes ficam estáveis e prontas para produção. O projeto começou como uma função chat() com quatro provedores e hoje reúne 23 adapters de provedor e oito frameworks de UI. Segundo o texto, 143 pessoas já contribuíram com código, e a equipe é de três mantenedores.

A migração não traz conceitos novos. Todas as APIs marcadas como deprecated na 0.x foram removidas, e cada substituta já existia. Os pontos práticos: atualizar juntos todos os pacotes estáveis @tanstack/ai* (um client 1.0 exige um server 1.0), rodar o codemod via jscodeshift e passar o type checker. body virou forwardedProps, conversationId virou threadId, e o threadId agora é obrigatório no browser e no servidor, e o codemod não consegue adicioná-lo. O addToolApprovalResponse() saiu: a aprovação passa por interrupts e resolveInterrupt. Quem usa ai-react-ui, ai-solid-ui ou ai-vue-ui precisa migrar para createChatHook, porque esses três pacotes não têm versão 1.0. Servidores próprios devem parar de enviar data: [DONE] e encerrar com um evento RUN_FINISHED. Dados salvos de chats, runs e arquivos exigem passos próprios do guia antes do deploy.

O @tanstack/ai-harness é a novidade experimental. Ele mantém sessões duráveis, esperas que sobrevivem a reinícios, agentes tipados e plugins. Os pacotes do harness seguem na 0.x e podem mudar em versão minor. O exemplo usa persistência em memória, e a fonte admite limites de recuperação, como esperas de agentes filhos que não retomam entre hosts.

Para quem já mantém TanStack AI em produção, a leitura é de migração previsível: se você acompanhou os avisos de deprecation, o trabalho é mais mecânico que conceitual. O ponto de atenção é o threadId, que exige decidir de onde vêm os IDs de conversa. Já o harness, por ser experimental, serve mais para testar do que para sustentar produto.