Honcho

Resumo

Honcho é uma biblioteca de memória para agentes com estado. Ela distingue conclusões explícitas e dedutivas, derivadas de mensagens recebidas, de conclusões indutivas, produzidas pela consolidação periódica de padrões no histórico.

Por que é relevante para Yan

O Hermes Agent usa Honcho como perfil factual do usuário, complementar à memória operacional local: preferências, contexto de trabalho e outros fatos sobre Yan podem ser recuperados para orientar uma sessão sem confundir esse perfil com procedimentos de infraestrutura do agente.

Como funciona

• Deriver: processa mensagens novas e extrai declarações explícitas e deduções diretas.
• Dreamer: revisita conclusões já armazenadas para consolidá-las e identificar padrões entre múltiplas mensagens; suas saídas são conclusões indutivas.
• Dream: é o ciclo de consolidação executado pelo Dreamer. Na configuração automática documentada pelo projeto, um peer precisa acumular ao menos 50 novas conclusões desde o último ciclo e respeitar uma espera mínima de 8 horas. Um dream também pode ser solicitado manualmente, contornando essas condições automáticas.

Priorização de contexto

Confirmado (documentação oficial, 2026-08-27): no modo híbrido do Hermes Agent, o Honcho injeta duas camadas de contexto: a camada-base reúne resumo da sessão, representação do usuário e peer card; a suplementar sintetiza o que importa para o estado atual da conversa. As cadências configuradas controlam quando cada camada é atualizada.

O peer card é a referência rápida para fatos biográficos estáveis — por exemplo, identidade, ocupação, preferências e instruções permanentes. Não é destinado a tópicos recentes, humor transitório ou raciocínio; estes permanecem na representação e nos resumos. Portanto, ele não é uma lista de assuntos “lidos com mais frequência”, mas é deliberadamente preservado como âncora de contexto: se houver limite de tokens, o Hermes corta primeiro o resumo da sessão e depois a representação antes de cortar o card. O Honcho limita o card a 40 fatos e, ao exceder esse teto, mantém as primeiras entradas; os fatos precisam ser concisos e deduplicados.

Uso atual

Confirmado (evidência local, 2026-08-27): o Honcho está integrado ao contexto de trabalho do Hermes para fornecer perfil e contexto factual do usuário. A conversa que originou esta nota relata que a instalação mantém memórias explícitas, conclusões dedutivas e conclusões indutivas; os quantitativos daquele momento não foram registrados aqui porque são estado operacional variável.

Conectividade local do Hermes

Confirmado (evidência local, 2026-08-27): após uma falha de conectividade direta entre o host Windows e o serviço de memória remoto, a integração do Hermes passou a usar um túnel SSH local em loopback. A configuração do Hermes foi apontada para o endpoint local e foi criado um inicializador no logon para restabelecer o túnel.

Essa é uma decisão operacional de resiliência: o Hermes deve consultar o endpoint local, e a disponibilidade do serviço deve ser confirmada pelo endpoint de saúde antes de operações que dependam de memória. Detalhes de rede, nomes de hosts e caminhos locais específicos não são registrados no vault.

Indisponibilidade do túnel após interrupção local

Relatado em evidência local (2026-09-18): uma falha de inicialização do Honcho foi atribuída à ausência do processo SSH que mantém o encaminhamento local. O serviço remoto estava saudável; após reiniciar o inicializador do túnel, a checagem de saúde e as consultas de perfil e busca voltaram a responder.

Confirmado por relato de implementação e teste local (2026-09-18): a recuperação automática foi adicionada em duas camadas. Um daemon iniciado no logon monitora periodicamente a saúde do endpoint local; ao detectar falha, encerra processos SSH obsoletos e recria o encaminhamento. Uma tarefa agendada independente executa verificações periódicas e relança o daemon caso ele próprio não esteja ativo.

No teste relatado, o processo SSH foi encerrado deliberadamente; o daemon detectou a interrupção, restabeleceu o endpoint de saúde em cerca de três segundos e consultas de perfil e busca voltaram a responder. Essa cobertura destina-se a quedas após suspensão, hibernação ou oscilações de rede, sem depender de intervenção manual por sessão.

Para incidentes recorrentes, verificar primeiro o endpoint de saúde local e a existência do processo do túnel; se o serviço remoto estiver saudável, conferir os logs do daemon e a última execução da tarefa agendada antes de depurar a integração do Hermes. Não registrar no vault caminhos locais, portas, nomes de tarefas, hosts ou configurações de acesso.

Diagnóstico de falha de socket no Windows

Relatado em evidência local (2026-08-27): uma tentativa de conexão direta do host Windows ao nó remoto retornou WinError 10013 (WSAEACCES). O erro significa que o acesso ao socket foi proibido por permissões; no caso registrado, a hipótese operacional foi interferência de software de rede/VPN com filtros no tráfego entre os nós, e não uma indisponibilidade do serviço de memória.

O procedimento que restaurou o acesso foi manter o encaminhamento SSH em loopback e fazer o Hermes consumir o endpoint local. Para recorrências, verificar primeiro a saúde do endpoint local e o processo do túnel; só então investigar conflitos de VPN, firewall ou outros filtros de rede. Não registrar configurações de acesso, endereços ou credenciais em logs compartilhados.

Limitações e cuidados

• Conclusões indutivas são sínteses de padrões, não fatos autoevidentes; devem ser tratadas como contexto revisável.
• A cadência automática do Dream depende dos limiares e do histórico de cada peer; não equivale a uma quantidade fixa de execuções por dia.
• Dados sensíveis não devem ser incluídos em mensagens ou memórias sem uma política de minimização e proteção apropriada.
• O túnel local depende do serviço remoto e do cliente SSH; em caso de indisponibilidade, verificar o processo do túnel e a saúde do serviço sem expor configurações ou credenciais em logs compartilhados.

Relações no vault

• Hermes Agent

Fontes

• Honcho — Peer Card, documentação oficial, consultada em 2026-08-27.
• Honcho Memory — Hermes Agent, documentação oficial, consultada em 2026-08-27.
• Honcho — Reasoning, documentação oficial, consultada em 2026-08-27.
• Honcho — Dreaming, documentação oficial, consultada em 2026-08-27.
• Microsoft Learn — Error 10013 when you bind excluded port again, consultada em 2026-08-27.
• Tailscale Docs — Poor performance with internet connections, consultada em 2026-08-27.
• Evidência local: lote de captura batch-653154f95bcb4b969583a5226483ab95, consultado em 2026-08-27.
• Evidência local: lote de captura batch-a4ca10bab71648e580bf70f7b71ed00e, consultado em 2026-08-27 (conectividade local via túnel SSH).
• Evidência local: lote de captura batch-293d68323ce340a58f0541111a2210dd, consultado em 2026-08-27 (diagnóstico reportado de socket e túnel SSH).
• Evidência local: lote de captura batch-88db0f2fc753429b9b1e4d016b0636e9, consultado em 2026-09-18 (interrupção do processo do túnel e recuperação reportada).
• Evidência local: lote de captura batch-bbdf3d426d154e408decda0dcb858a24, consultado em 2026-09-18 (implementação e teste reportados do self-heal do túnel).