Release do Paperclip · 06 de julho de 2026

Paperclip canary/v2026.706.0-canary.0

Detalhamento editorial da versão, com mudanças publicadas e referência oficial para consulta técnica.

Paperclip canary/v2026.706.0-canary.0

Resumo

O release canary remove a duplicação da lista ADAPTER_AGNOSTIC_KEYS, que preserva chaves de configuração quando um agente troca de adapter. Antes da mudança, servidor e UI mantinham cópias próprias dessa lista, o que podia deixar uma chave preservada em uma superfície e perdida na outra.

A correção move a constante e o tipo AdapterAgnosticKey para packages/shared, atualiza os dois consumidores e adiciona um teste de guarda para impedir nova duplicação.

Novidades

  • Paperclip canary/v2026.706.0-canary.0 — Configuração compartilhada: a constante ADAPTER_AGNOSTIC_KEYS e o tipo AdapterAgnosticKey foram adicionados em packages/shared/src/adapter-agnostic-keys.ts.
  • Paperclip canary/v2026.706.0-canary.0 — Guarda contra divergência: o pacote compartilhado recebeu teste dedicado para conferir o conjunto esperado de chaves e os pontos de importação no servidor e na UI.

Melhorias

  • Paperclip canary/v2026.706.0-canary.0 — Troca de adapter: o servidor e o builder de patch da UI agora importam a mesma definição de chaves preservadas, reduzindo a chance de uma troca de adapter remover configuração que deveria continuar ativa.
  • Paperclip canary/v2026.706.0-canary.0 — Manutenção de configuração: futuras inclusões de chave agnóstica podem ser feitas no pacote compartilhado, sem repetir a lista em server/src/agents.ts e ui/src/lib/agent-config-patch.ts.

Correções

  • Paperclip canary/v2026.706.0-canary.0 — Chaves preservadas: o release fecha a lacuna deixada após a correção de paperclipSkillSync.desiredSkills, consolidando servidor e UI na mesma fonte de importação.

Breaking changes

Nenhuma quebra de compatibilidade foi declarada. A origem descreve a mudança como refatoração que preserva comportamento, com o mesmo conjunto de chaves.

Ponto de Atenção

  • Paperclip canary/v2026.706.0-canary.0 — Troca de adapter: o update altera o ponto de importação de uma constante usada por servidor e UI. Teste sugerido: troque o adapter de um agente com paperclipSkillSync.desiredSkills configurado e confirme que a chave continua presente depois do PATCH.
  • Paperclip canary/v2026.706.0-canary.0 — Guarda de drift: o novo teste precisa falhar se alguém recriar uma lista local de chaves. Teste sugerido: rode pnpm exec vitest run packages/shared/src/adapter-agnostic-keys.test.ts junto dos testes de patch da UI e das rotas de instrução do agente.

Notas da versão

A verificação de origem registrou quinze testes aprovados nos arquivos relacionados e typecheck dos pacotes @paperclipai/shared, @paperclipai/server e @paperclipai/ui. A documentação do release também informa que a documentação relevante ainda não foi atualizada.

Voltar para o changelog do Paperclip

Área pública disponível

Participe da comunidade no Discord

Entre pelo convite oficial, apresente-se à comunidade e acompanhe os avisos e projetos compartilhados entre os encontros.