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