Overview

v0.21.3 — The Sign-In Patch. Publicada el 14 de septiembre de 2026. 1,036 commits no de merge · 2,642 archivos modificados (+131,690 / −37,096) · 338 PRs fusionados desde v0.21.2, medido en el commit 9b419a2d3c2657c192008e732149d61170b32c01.

Algunos arreglos solo importan a las instalaciones que nunca ejecutan hermes update a mano. Este tag existe justo para esas: las imágenes Docker, Hermes Cloud y los despliegues gestionados se construyen a partir del tag de release más reciente, así que el trabajo de inicio de sesión del gateway remoto de la última ventana tenía que entrar en un tag estable antes de que los usuarios de la nube pudieran recibirlo. La ventana en sí es amplia — esos mismos ~338 PRs también traen los contratos de cable del gateway, la selección de esfuerzo de razonamiento en cada selector de modelo, el login OpenRouter OAuth PKCE, la decodificación HEIF/HEIC/AVIF y una larga lista de trabajo de plataforma — pero el artículo curado con todo eso llega con v0.22.0, que documentará desde v0.21.0 en adelante. Esta página cubre aquello por lo que se cortó el tag.

---

Highlights

1. Una ráfaga de reactivación del escritorio ya no puede revocar tu sesión

Las sesiones remotas del dashboard solían caducar cuando llegaban varias peticiones a la vez. Las dos rutas de refresh del gateway — la puerta de cookie y la ruta bearer nativa del escritorio — presentaban cada una el mismo refresh token rotatorio; el proveedor de identidad rota un refresh token al usarlo y trata una segunda presentación del valor antiguo como robo de token, lo que revoca la sesión entera. Un despertar del escritorio tras dormir es una ráfaga natural, así que el fallo parecía aleatorio y siempre llegaba en el peor momento (#110061, corrige #55712).

Ahora los refresh concurrentes que llevan el mismo token rotatorio se fusionan: una petición hace la rotación y las demás adoptan su resultado. El refresh además corre fuera del event loop, así que un proveedor de identidad lento ya no congela /api/status mientras espera.

El lado de Portal acompaña este cambio (hermes-portal#1209): un horizonte de inactividad deslizante de 30 días y una ventana de gracia de 5 minutos para un token rotado, para que una carrera genuina en vuelo no se lea como reutilización.

2. Los procesos de larga vida dejan de filtrar handles de escritura duplicados sobre state.db

Una topología sana podía imprimir igualmente el precursor N live SessionDB handles. El gateway, el backend del dashboard/escritorio, la superficie ACP y los lectores de la CLI adjuntaban cada uno su propio escritor, de modo que el contador subía y el diagnóstico acusaba a la instalación justo del problema que debía detectar (#110934, corrige #100896 y #103339).

La forma ahora es explícita: los lectores se adjuntan en solo lectura, y los escritores dentro del proceso comparten el handle del registro en lugar de abrir cada uno el suyo. Menos handles significa menos ocasiones de que un componente cancele los bloqueos de otro — que es la clase de fallo que el parche v0.21.2 cerró con seis PRs.

Also in this window

El tag acumula todo lo fusionado desde v0.21.2, no solo los dos puntos anteriores. Agrupado por área, y dejado a propósito para que las notas de v0.22.0 lo documenten como es debido:

• Contrato del gateway: las peticiones JSON-RPC de servidor→cliente sustituyen a los pares de eventos *.request / *.respond (#110521), y un registro de contratos de cable en Pydantic genera los tipos de TypeScript y OpenRPC (#110522, #110523).
• Modelos y razonamiento: selección de esfuerzo de razonamiento en cada selector de modelo, una píldora en el composer y control de esfuerzo por auxiliar en el escritorio; login OpenRouter OAuth PKCE.
• MCP: los refresh tokens de OAuth quedan vinculados al emisor que los concedió, más un recordatorio diario de re-autenticación en el escritorio.
• Media: decodificación de imágenes HEIF, HEIC y AVIF.
• Providers: Wan 3.0, Kling 3.0 / Kling Image v3, MiniMax H3 Max Turbo, Gemini Omni Flash 1.1 y Meta Muse se suman a los catálogos de FAL; la configuración de peer-model de Honcho se rehízo.
• Plataformas: tablas pegadas en Slack y la Agent Sessions API.
• Almacenamiento y profiles: aislamiento de profiles multiplexados y correcciones de vivacidad del gateway, y la negativa a ejecutar el modo journal WAL en sistemas de archivos entre VMs.

Upgrade

Las instalaciones existentes se actualizan en el sitio:

hermes update

Docker y Hermes Cloud se construyen a partir de este tag:

docker pull nousresearch/hermes-agent:v2026.9.14

El diff completo está en v2026.9.11…v2026.9.14.

← Hermes Agent Changelog