contribuiçõescontribuições

investigaçãoissue #96982 · corrigida

ao observar arquivos por intervalos, o Next.js podia deixar de perceber mudanças rápidas. reproduzi a falha: 3 de 25 edições não apareceram na página, mesmo depois de gravadas em disco; o modo normal percebeu as 25.

o que aconteceu depoispubliquei o teste e o relato para que a falha pudesse ser investigada. a equipe atualizou a biblioteca responsável por observar os arquivos, adicionou um teste para o caso e encerrou a issue. a implementação da correção é da equipe do Next.js.

edições que sumiam durante o desenvolvimento

reprodução publicadaver o teste e os resultados da comparação

correção da equipe do Next.jsver o PR #98737 que implementou a correção

mergeado#21067+457−49

para o agente conseguir procurar dentro dos seus documentos, cada pedaço de texto precisa virar número primeiro, e isso é um pedido pago para um serviço de fora. O Mastra mandava um pedido por documento, um de cada vez, mesmo tendo o código de mandar em lote pronto e desligado por engano. Agora vão todos na mesma viagem. Indexar uma base grande deixou de ser centenas de idas e voltas e virou um punhado.

o que foi verificado500 documentos: 500 chamadas antes, 2 depois

perf(core): batch Workspace search embedding on the eager path

mergeado#23080+209−13

as ferramentas de um agente podem vir da memória, do navegador, de fluxos ou da própria aplicação. ao reunir essas fontes para uma chamada, o Mastra consultava novamente qual modelo estava ativo, chegando a repetir a consulta para cada ferramenta. a mudança compartilha uma única resposta dentro dessa etapa de conversão e não consulta o modelo quando não há ferramenta.

o que foi verificado3 origens compartilharam 1 resolução por conversão; sem ferramentas, 0; override coberto em generate e stream

fix(core): resolve dynamic models once across tool sources

diagnóstico publicadoabri a issue #23017 com a medição do problema antes de propor a correção

crédito no commita mensagem do commit mergeado inclui “Co-Authored-By: DenisCDev” no histórico do projeto

mergeado#21199+108−19

existia um botão de "qualidade da tradução" na documentação, no tipo e na tela de configuração. a opção não alterava o resultado: "qualidade" e "velocidade" executavam o mesmo fluxo, sem aviso. removi a opção da tela de configuração, mantive o campo aceito por compatibilidade e indiquei o ajuste que realmente muda o comportamento.

o que foi verificadoa opção era gravada e nunca lida: nenhuma leitura na classe inteira

fix(core): stop advertising LanguageDetector's translationQuality, which does nothing

validado#23370+157−37

quando o agente continua uma conversa, ele precisa das últimas mensagens. no postgres, o Mastra lia o histórico inteiro e ainda contava cada linha, mesmo querendo só as dez mais recentes. enviei a leitura pelo índice. o mantenedor confirmou o diagnóstico e o projeto incorporou essa correção por outro PR.

o que foi verificadoPGlite, 20 mil mensagens na mesma conversa: o plano antigo lia 20 mil linhas; o plano pelo índice lê 10

fix(pg): last-N memory reads use the thread/createdAt index

diagnóstico publicadoabri a issue #23359 com a medição do problema antes de propor a correção

validado#23377+126−24

depois da correção pelo índice, o postgres ainda conta todas as mensagens da conversa a cada turno do agente, mesmo o histórico só precisando das últimas. enviei a leitura sem essa contagem: o banco devolve só o pedaço pedido e olha uma linha a mais para saber se existe página seguinte. o projeto incorporou essa correção por outro PR.

o que foi verificadopedido de 10: a query não conta a conversa; lê 11 para saber se tem mais

fix(pg): skip unused totals on agent last-N reads

diagnóstico publicadoabri a issue #23376 com a medição do problema antes de propor a correção

mergeado#7060+53−11

dez controles definem quantos atributos, eventos e links podem ser guardados e até onde valores de texto podem crescer. o valor zero é permitido, mas a configuração o confundia com “não informado” e restaurava os limites padrão. corrigi o mapeamento dos dez controles e provei, num teste de regressão, que o zero chega intacto ao modelo usado para iniciar o SDK.

o que foi verificado10 variáveis cobertas; o teste recebia o padrão 128 antes e passou a receber 0

fix(configuration): preserve zero-valued limits

validado#90043+746−109

toda vez que o agente abre um arquivo pra ler, ele precisa pedir ajuda ao sistema, e no Windows cada pedido desses custa abrir um programa inteiro do zero, uns 53 milésimos de segundo. O Hermes abria cinco por leitura. Juntei tudo em dois. Quem mantém o projeto repetiu o teste em outra máquina e confirmou o ganho. O Hermes seguiu com uma versão mais ampla, que faz a leitura em uma execução e também reduz o trabalho na escrita. Em 20 de setembro, o projeto encerrou minha issue como corrigida no código principal e registrou que fui o primeiro a propor juntar essas leituras.

o que foi verificadoteste do mantenedor: arquivo pequeno caiu de 5 execuções / 210 ms para 2 / 110 ms

fix(tools): coalesce read_file into two Git Bash execs

diagnóstico publicadoabri a issue #90039 com a medição do problema antes de propor a correção

resultado reproduzidoquem mantém o Hermes Agent repetiu a medição em outra máquina e confirmou o ganho

crédito registradoo PR #101599, que substitui esta proposta, cita o #90043 e meu usuário ao explicar de onde veio o trabalho

incorporado ao projetoquem mantém o Hermes Agent encerrou a issue como corrigida no código principal e registrou que esta contribuição abriu o caminho

aberto#37297+31−6

a função util.format monta o texto usado em muitos registros de execução. no Bun, ela acessava componentes internos por um caminho indireto que impedia uma otimização do motor. substituí esse acesso pelo caminho direto, reduzindo o tempo para formatar mensagens.

o que foi verificadoaté 5,2x mais rápido em util.format, medido nos dois builds no mesmo hardware

perf(util): drop bound-function dispatch from primordials uncurryThis (up to 5x faster util.format)

aberto#37298+2−2

dois pacotes travados no repositório do Bun apontavam para um servidor interno de outra empresa em vez do endereço público oficial. Quem rodasse aquela pasta tentaria baixar de um lugar que não devia, e que pode simplesmente sumir. Devolvi os dois para o endereço oficial.

o que foi verificadoduas linhas de endereço corrigidas em bench/bun.lock

bench: point two bun.lock tarball URLs back at registry.npmjs.org

crédito de autoriao bun me creditou como co-autor no #39483, que leva a mesma correção