# Naia Hermes

Pacote portátil de ferramenta consultiva Jev. Contrato conferido no Hermes 0.19.0 (Python 3.11 a 3.13). Não copia customizações de produção. Não instala hooks automáticos, não altera modelo, esforço, memória, Telegram ou aprovações.

## Instalação

Antes, confira se já existe a ferramenta `jev_decide` em outro plugin. Não duplique integrações. A skill opcional em `skill/jev-decisions` pode ser copiada para a pasta de skills do seu Hermes; ela não ativa hooks.

1. Revise os três arquivos em `naia-jev/`. A chave não está no pacote.
2. Copie a pasta para `${HERMES_HOME:-$HOME/.hermes}/plugins/naia-jev`. Se já existir, pare e compare; não sobrescreva outra instalação.
3. Injete `TYPESAFE_API_KEY` no processo Hermes pelo gerenciador de segredos do seu ambiente. Não coloque o valor no YAML, na skill ou em argumentos.
4. Execute `hermes plugins enable naia-jev`.
5. Execute `hermes tools` e habilite o toolset `jev` nas superfícies que usa. Habilitar o plugin não garante que o catálogo efetivo permita a ferramenta. Preserve as opções existentes.
6. Reinicie somente seu processo Hermes quando puder encerrar a sessão atual. Abra uma nova sessão e confira se `jev_decide` aparece entre as ferramentas disponíveis.
7. Peça uma avaliação sintética em lote. Confira `available`, modelo, latência e respostas. Em `available:false`, o agente deve seguir o fluxo anterior, sem repetir a chamada automaticamente.

Configuração equivalente, caso administre o YAML manualmente: adicionar `naia-jev` em `plugins.enabled`, `jev` em `toolsets` e em `platform_toolsets.<canal>` quando houver lista específica. Faça backup antes e preserve todas as entradas existentes. Não copie um arquivo config completo deste tutorial.

## Primeiro uso

Peça ao agente: “Use jev_decide uma vez para classificar esta mensagem sintética entre acesso, cobrança e outros; avalie na mesma chamada se pede atendimento humano. Não envie mensagens nem altere contas. Mensagem: comprei o curso e não consigo entrar.”

As perguntas aceitam strings nas instruções e critérios. Limites deste pacote: 24 KB de entrada, 16 perguntas, Choice de 2 a 100 opções, Score de 2 a 10 níveis. O modelo é fixo `jev-1.13.0`. O timeout Python é por operação de socket, não um deadline global estrito. Sem cache persistente, retries ou coleta de dados.

A instalação disponibiliza a ferramenta; a decisão de chamá-la pertence ao agente. Para integração automática por evento, implemente hooks separadamente com baseline, deduplicação e calibração. Confidence não permite execução externa.

## Reversão

Desabilite `naia-jev` com `hermes plugins disable naia-jev`, retire somente `jev` das listas em que você o adicionou e reinicie seu processo. Preserve outras configurações. Remova a pasta apenas depois de confirmar que não contém alterações suas.

## Verificação deste pacote

Sintaxe, validação de argumentos e registro com contexto simulado foram conferidos. O contrato de registro foi lido no runtime real. Não instalamos este pacote portátil em uma conta de aluno nem prometemos compatibilidade com toda versão futura.

## English

This is an advisory tool package for Naia Hermes, checked against Hermes 0.19.0. Copy `naia-jev` into `${HERMES_HOME:-$HOME/.hermes}/plugins/` only if that directory does not already exist. Inject `TYPESAFE_API_KEY` into the Hermes process through your secret manager. Run `hermes plugins enable naia-jev`, then `hermes tools` and enable toolset `jev` on each intended surface. Restart your own process and verify that `jev_decide` is present. Plugin enablement alone does not override toolset allowlists.

Use one synthetic batch first. The tool returns `available:false` on missing credentials, invalid input, upstream errors or malformed answers. Preserve the existing flow. It does not install automatic hooks, change permissions, reduce reasoning effort, or send messages. Limits: 24 KB, 16 questions, 2–100 Choice options, 2–10 Score levels. Python's two-second socket timeout is not an absolute pipeline deadline. No persistent cache or automatic retries. Roll back with `hermes plugins disable naia-jev`, remove only your added toolset entries and restart. Validation covered syntax, argument checks and mocked registration; student runtime installation was not performed.

## Español

Paquete de herramienta consultiva para Naia Hermes, contrastado con Hermes 0.19.0. Copia `naia-jev` dentro de `${HERMES_HOME:-$HOME/.hermes}/plugins/` solo si no existe. Inyecta `TYPESAFE_API_KEY` en el proceso mediante tu gestor de secretos. Ejecuta `hermes plugins enable naia-jev`, después `hermes tools` y habilita `jev` en las superficies elegidas. Reinicia tu proceso y comprueba que `jev_decide` aparece. Activar el plugin no evita las listas de herramientas permitidas.

Haz primero una prueba sintética agrupada. Ante `available:false`, conserva el flujo anterior. El paquete no instala hooks automáticos, cambia permisos, reduce razonamiento ni envía mensajes. Límites: 24 KB, 16 preguntas, 2–100 opciones Choice y 2–10 niveles Score. El timeout Python de dos segundos es por socket, no un plazo absoluto. No incluye caché persistente ni reintentos automáticos. Para revertir, ejecuta `hermes plugins disable naia-jev`, elimina solo las entradas añadidas y reinicia. Se verificaron sintaxis, argumentos y registro simulado; no se instaló en el runtime de un alumno.