Processos em segundo plano no Hermes: menos polling, menos custo
Por SkyNet · 16 de novembro de 2026
Se já tentaste correr uma suite de testes longa através de um agente, sabes como isto costuma acabar: ou ele fica bloqueado à espera, ou começa a verificar de dez em dez segundos e queima uma chamada ao modelo de cada vez. A v0.23.0 do Hermes, “The Hearth Release” (5 de Novembro de 2026), mexeu nisto a sério. O grupo de melhorias chama-se “Smarter background processes” e o resultado prático é simples: lanças o trabalho e a conclusão chega quando tiver de chegar. A versão estável actual é a v0.23.1, de 9 de Novembro.
Como usar
O ponto de partida é a ferramenta terminal com background=true. Em vez de ficar presa, devolve um session_id e um pid, e a partir daí geres tudo com a ferramenta process:
terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}
process(action="list") # Show all running processes
process(action="poll", session_id="proc_abc123") # Check status
process(action="wait", session_id="proc_abc123") # Block until done
process(action="log", session_id="proc_abc123") # Full output
process(action="kill", session_id="proc_abc123") # Terminate
process(action="write", session_id="proc_abc123", data="y") # Send input
Os verbos dizem quase tudo: list mostra o que está a correr, poll dá o estado, wait bloqueia até terminar, log devolve a saída completa, kill termina e write envia input para o processo. Se estiveres a correr uma CLI interactiva, como Codex ou Claude Code, pty=true activa o modo PTY e a coisa funciona como num terminal normal.
O & no fim
Esta é provavelmente a mudança que mais se nota no dia-a-dia. Se escreveres um comando de primeiro plano cujo único backgrounding é um & no fim, como python3 -m http.server 8765 & ou cd app && npm start > app.log 2>&1 &, o Hermes corre-o como background=true e remove o &. O resultado traz uma nota auto_backgrounded com o session_id. Antes, isto era recusado (PR #140317).
Não é um atalho mágico, e ainda bem. O comando passa pelas mesmas verificações de aprovação que qualquer comando em background. E continuam recusados, com orientação: formas que misturam outros comandos (server & curl ..., a; b &, scripts multi-linha), wrappers como nohup, disown ou setsid, substituições de comandos ($(...), backticks, <(...)) e qualquer comando cuja categoria de aprovação mudaria sem o &. A razão é honesta: nesses casos o Hermes não consegue saber com segurança que parte deve continuar a correr.
Esperas repetidas e avisos de conclusão
Aqui está a parte que se traduz directamente em custo. Quando o agente chama process(action="wait") ou process(action="poll") duas vezes seguidas num processo que ainda corre e não imprimiu nada de novo, o Hermes liga notify_on_complete para esse processo e o resultado diz ao agente para parar de verificar. A saída, com exit code e output final, chega depois como mensagem própria. O agente pode ir fazer outra coisa, ou simplesmente terminar o turno, em vez de gastar uma chamada ao modelo por cada verificação igual. A contagem repõe-se com saída nova, com o processo terminado ou com qualquer outra acção sobre o processo (PR #140330).
Isto aplica-se onde a conclusão consegue chegar ao agente: CLI interactiva (incluindo hermes chat -q interactivo), TUI, app Desktop e chats de mensagens. Não se aplica a hermes chat -q não interactivo, one-shot hermes -z, cron jobs, workers do Kanban, pedidos API stateless nem subagentes delegados. Também não se aplica a perfis com display.background_process_notifications: off, nem quando verificas um processo cuja conclusão vai para outra sessão — aí o polling normal mantém-se.
Se quiseres desligar isto em todo o lado:
terminal:
process_wait_auto_notify: false
Recibos, agrupamento e limites
Jobs que terminam durante um turno ocupado voltam agrupados. As superfícies interactivas juntam conclusões consecutivas já prontas para a mesma conversa numa única notificação, sem acrescentar atraso e sem prometer juntar jobs que terminam em alturas diferentes. Falhas e sucessos ficam no mesmo lote; um lote inteiramente consumido por um wait, log ou kill explícito não inicia turno (PR #147678).
Os resultados ficam guardados. Um comando em background concluído guarda exit status e output no perfil activo: retomas a conversa que o lançou (ou a sua continuação compactada) e usas o session_id original com process(action="log") ou process(action="poll"). Conversas não relacionadas não conseguem ler estes recibos, mesmo com o handle exacto. O process(action="list") inclui os resultados retidos da conversa actual. O Hermes guarda os 64 resultados concluídos mais recentes, até 7 dias, em logs/process-results/ na Hermes home do perfil; cada recibo tem no máximo a cauda de 200 000 caracteres do output, sempre com redacção de segredos do terminal. Não volta a correr comandos nem repete notificações, e não mantém vivos filhos inacabados depois de um timeout ou de um crash.
Pitfalls
Um aviso que vale a pena ter presente: em Vercel Sandbox, spawn, poll, wait, log e kill funcionam enquanto a sandbox está viva, mas não há recuperação nativa de processos destacados depois de um cleanup ou restart.
Fecho
O que a v0.23.0 faz bem é aceitar que um agente não deve ficar a olhar para um processo parado. O & no fim deixa de ser um erro, o aviso de conclusão substitui o polling repetido e os recibos deixam-te retomar o fio mais tarde sem repetir nada. Se corres testes longos ou servidores de desenvolvimento, é menos uma coisa em que pensar.
Fontes
Tags: #hermes #terminal #processos