Visão Geral

v0.22.2 — a release que a v0.22.1 deveria ter sido. Lançada em 15 de outubro de 2026, cerca de nove horas depois da v0.22.1.

A v0.22.1 foi compilada a partir do commit errado. A tag entregou trabalho de gateway ainda não lançado, e o app da Microsoft Store podia travar em “Connecting.” em vez de concluir a inicialização. A 0.22.2 é compilada a partir da árvore para a qual a tag anterior deveria apontar, mais duas correções próprias: o gateway volta a iniciar depois de um reboot, e turnos longos de modelo local sobrevivem em notebooks. Da v0.22.1 publicada até a v0.22.2 há 11 commits no intervalo de comparação, o último deles Release 0.22.2 from release/0.22.1 with the published v0.22.1 as a parent.

Tudo abaixo é a linha de releases 0.22 desde a v0.22.0 — as correções que a 0.22.1 deveria ter entregado, mais os dois destaques. O trabalho que existe apenas na main sai na v0.23.0.

Problema conhecido: sessions que rodaram sob o gateway 0.22.1 não podem ser excluídas na 0.22.2.

---

Destaques

1. O gateway volta a iniciar depois de um reboot

No Linux, um reboot pode entregar um PID inicial a um processo sem relação com o gateway, e a verificação de liveness podia confundir esse PID reciclado com um gateway ainda em execução. Um gateway supervisionado — systemd, launchd ou Docker — então se recusava a iniciar, porque parecia que outro gateway já ocupava a máquina.

O Hermes agora registra em qual boot ele iniciou e compara o boot registrado com o atual. Quando o registro não pode ser comparado — um registro legado, ou um horário de boot que não pode ser lido — ele para de adivinhar e consulta o host lock, um arquivo de lock que só um gateway ativo consegue manter. A verificação nunca cria o arquivo de lock por conta própria, e a identidade por argv foi removida da checagem de rendezvous, já que um PID reciclado pode coincidir tanto com um horário de início quanto com uma linha de comando. (#138594, corrige #133744)

2. Turnos longos de modelo local sobrevivem em notebooks

Quatro mudanças em uma única correção para quem roda modelos na própria máquina (#138560):

• Requisições locais sempre usam streaming. Enquanto o servidor ainda está lendo um prompt longo, a linha de status informa o progresso da leitura do prompt em vez de exibir um turno que parece travado.
• Temporizadores de stall ignoram o sono. Um notebook que suspende no meio de um turno não conta mais as horas dormindo como tempo que o modelo passou pensando.
• Um servidor recuperado ganha outra tentativa. O circuit breaker reprovava todas as mensagens seguintes depois de um único timeout, mesmo depois de o servidor local ter voltado.
• A compressão para de dar timeout enquanto o servidor está lendo. A compressão de contexto esperava pelo modelo enquanto o modelo ainda estava ingerindo, e desistia cedo.

Em máquinas Windows com memória unificada, a inicialização do modelo e o cache de prompt agora são dimensionados com base na memória livre, e não na memória total.

Também nesta janela

• Model picker: uma lista curada de modelos fica no topo do seletor, o NVIDIA NIM ganha sua lista padrão de modelos, e o Nemotron 3.5 Super VL chega com seus próprios parâmetros padrão.
• Rotas da Mistral: ids de tool compostos são mantidos em par, e ids divididos são reescritos antes que o provider os veja — a Mistral limita ids de tool a nove caracteres.
• Profiles: um novo profile herda o modelo de lançamento custom puro junto com seu endpoint, incluindo providers referenciados por env, e a seed de modelos não descarta mais entradas de destino sem URL ou desabilitadas durante o merge.
• Terminal e busca: as ferramentas do próprio usuário vêm antes das do Hermes no PATH, a busca local de arquivos usa o ripgrep fixado pelo Hermes em vez do primeiro rg da máquina, e o venv de um payload selado é removido do PYTHONPATH dos processos filhos.
• Catalog: chegam os pacotes de idioma para desktop em coreano (hermes-lang-ko) e português do Brasil (hermes-lang-pt-br), junto com novas entradas de catálogo para author-feed, wait-ledger, openinvest, TeamoRouter, Hermes AAC e Agent Mixer.
• Dependências: httpx2/httpcore2 vão para 2.12.0 e os pacotes npm fixados são atualizados para zerar achados de auditoria.

Atualização

• CLI: hermes update
• Docker / Hermes Cloud: nousresearch/hermes-agent:stable
• Desktop: se atualiza sozinho; instalações pela Microsoft Store atualizam pela Store.

Se você instalou a v0.22.1, atualize — aquela tag entregou trabalho que não estava pronto para uma release estável.

Full Changelog: v0.22.1…v0.22.2

← Hermes Agent Changelog