ACP v2: novo draft padroniza comunicação entre editores e coding agents

ACP v2: novo draft padroniza comunicação entre editores e coding agents

O Agent Client Protocol (ACP) publicou em 20 de julho de 2026 o primeiro draft da versão 2 do protocolo, que define a comunicação entre editores de código (clients) e agentes de IA. Desde o lançamento da v1, mais de 15 RFDs (Request for Discussion) foram incorporadas ao protocolo sem necessidade de migração, mas a equipe identificou que algumas mudanças de ruptura eram necessárias para desbloquear novos casos de uso.

Principais mudanças

Além do turno: Na v1, eventos eram emitidos apenas após uma mensagem iniciada pelo usuário. Na v2, notificações session/update podem fluir livremente a qualquer momento da sessão. O agente pode indicar quando está "idle" (pronto para receber novos inputs) enquanto continua atualizando o estado da sessão em segundo plano. Isso permite filas, steering e atualizações de trabalho não iniciado pelo usuário.

Mensagens e streaming de tool calls: Mensagens de usuário e agente, tool calls e output de terminal agora são atualizados por IDs estáveis com semântica uniforme - campos omitidos permanecem inalterados, null limpa, valores substituem e chunks são concatenados. O padrão de streaming foi estendido ao conteúdo de tool calls, eliminando a necessidade de reenviar o conteúdo inteiro a cada atualização.

Reformulação de diffs: O antigo par oldText/newText foi substituído por mudanças de arquivo estruturadas, que expressam adição, deleção, modificação, movimentação, cópia e casos binários. O agente pode fornecer opcionalmente um git_patch para renderização.

Permissões mais flexíveis: Prompts de permissão agora carregam title e description próprios, com um subject extensível em vez de estar atrelado a um tool call específico. Isso permite pedidos de permissão especiais para comandos de terminal ou outros objetos no futuro.

Compatibilidade futura por padrão: Valores enum-like aceitam variantes desconhecidas com prefixo _ para extensões específicas de implementação, garantindo que novas features não quebrem clients e agents mais antigos.

Status e recomendações

O v2 está em estágio de draft e pode mudar antes da estabilização. A recomendação é que implementadores coloquem o suporte ao v2 atrás de negociação de versão e feature flags, sem ativar por padrão em produção. A v1 continuará sendo suportada por um bom tempo, e implementadores devem manter ambas as versões lado a lado. Um guia de migração com exemplos antes/depois está disponível para quem mantém agents, clients ou SDKs.