Un autómata finito en un hook impide que un agente de IA bloquee Bash: las 122 pruebas superadas
Si un agente de IA pierde la comilla de cierre, Bash espera que la entrada continúe y el agente se queda colgado hasta agotar el tiempo de espera. Quote Guard sustituye las expresiones regulares por un autómata finito (FSM): lee el comando carácter a carácter según las reglas de la shell directamente en el hook PreToolUse, antes de la ejecución. Cuando Bash y PowerShell discrepan, el agente recibe una indicación y corrige la llamada por sí mismo. La protección contra bloqueos conviene mantenerla en la infraestructura, no en el prompt.
Procesado por IA desde Habr AI; editado por Hamidun News
Imagine: un agente autónomo arma un comando para la terminal y pierde la comilla de cierre. Para un texto es una errata; para Bash, es motivo para detenerse y esperar. La shell decide que la entrada continuará en la línea siguiente, muestra el prompt «>>» y se queda en silencio.
Si el agente lee el proceso de forma síncrona, el fin de la salida (EOF) nunca llega, el proceso no termina, la sesión se agota por tiempo de espera y el agente falla. El autor del proyecto Quote Guard describió en Habr cómo cerrar este agujero sin pedirlo en el prompt. Colocó un autómata finito (FSM) antes de ejecutar el comando: un pequeño programa que lee la cadena carácter a carácter y en cada momento sabe dónde está: en texto normal, dentro de comillas o tras un carácter de escape.
Está integrado en el hook PreToolUse, un interceptor que se activa antes de que el agente entregue el comando al sistema operativo. La fiabilidad la respaldan 122 comprobaciones automáticas, y todas pasan.
Por qué no funcionan las expresiones regulares
La primera idea es verificar la paridad de las comillas, por ejemplo count % 2 == 0. Pero la misma cadena se interpreta de forma distinta según la shell. Tomemos dir "C:\". En PowerShell, la barra invertida es un separador de ruta normal: la comilla se abre, ve C:\, se cierra y el comando queda listo. En Bash, esa misma barra escapa la comilla siguiente, esta deja de ser de cierre y la shell espera una continuación que nunca llegará.
El segundo ejemplo tiene la misma lógica: en echo "a"b"`, el acento grave en PowerShell es un carácter de escape, mientras que en Bash inicia una sustitución de comandos; la shell busca el acento grave de cierre y vuelve a entrar en modo multilínea. No se puede deducir la shell a partir del sistema operativo del host: en contenedores Windows puede haber Bash, en WSL puede haber PowerShell, y el agente ejecuta scripts multiplataforma. Un validador ingenuo dejará pasar el bloqueo en Linux o bloqueará una ruta legítima de Windows. Tras el primer falso positivo, el ingeniero simplemente desactivará la protección.
Autómata finito y «doble cerradura»
El autor sustituyó las expresiones regulares por un autómata determinista con tres gramáticas aisladas: posix, powershell y cmd. Cambia de estado (texto normal, comillas dobles, comillas simples, escape) de forma estricta según las reglas del entorno de destino.
Para herramientas desconocidas, por ejemplo un plugin de terceros o un agente personalizado, funciona el modo Strict Intersect. El comando se comprueba a la vez con dos gramáticas, posix y powershell:
- es seguro en ambas: se deja pasar;
- lleva al bloqueo en ambas: se bloquea;
- las evaluaciones discrepan, como en el caso de
dir "C:\": la ejecución se interrumpe con el código Exit 2.
En lugar de un bloqueo silencioso, el modelo recibe un rechazo legible por máquina: herramienta desconocida, la cadena es segura en PowerShell pero bloquea POSIX, y una sugerencia de definir la variable QUOTE_GUARD_MAP=MyTool=powershell. El agente lee la instrucción y, desde el segundo intento, envía una llamada correcta. Así se ahorran tiempo de sesión y tokens en reintentos tras un tiempo de espera.
La historia del heredoc y las 122 pruebas
Lo más útil del material es el análisis honesto del error. Un heredoc es un bloque de texto en Bash delimitado por marcadores como <<EOF y EOF. En la versión v3.0, el hook veía el marcador <<EOF, asumía que dentro las comillas eran «crudas» y dejaba pasar todo el comando. La prueba reveló el agujero: el modelo generó cat <<EOF … EOF seguido de echo "unclosed. El hook vio el marcador y lo dejó pasar todo, y la comilla sin cerrar tras el bloque colgó la shell.
En la v3.1 se añadió el enmascaramiento del cuerpo del heredoc: el contenido se sustituye por espacios manteniendo los desplazamientos para no alterar el parser, y el autómata revisa lo que hay antes y después. Si el propio terminador EOF no se cierra, el hook registra el estado HEREDOC y bloquea la ejecución. Ahora cat <<EOF con un script dentro pasa, mientras que EOF seguido de echo "broken no.
El proyecto se verifica con un conjunto transversal compartido, cases.jsonl, con 31 casos gramaticales. En total hay 122 comprobaciones: 46 por cada implementación del lexer en Python y Node.js (deben comportarse exactamente igual, byte a byte), 25 de integración del hook PreToolUse y 5 de autoprueba del detector de duplicados. Todas pasan. Las pruebas son adversariales: incluyen intentos de salir de las comillas, construcciones anidadas, inyecciones multilínea y elusiones del hook.
Qué significa en la práctica
Para quienes construyen agentes con acceso a la shell, la conclusión es sencilla: la generación probabilística debe protegerse con una puerta determinista. Además, es positivo que el rechazo vuelva al modelo como una instrucción, no como silencio.
El autor reconoce las limitaciones. La garantía solo se mantiene si el hook está instalado en el host y las variables de entorno no han sido manipuladas. Se cubren tres gramáticas; otras shells, como fish o zsh con extensiones especiales, habrá que describirlas por separado. Los resultados de las pruebas solo están confirmados en el repositorio del proyecto, sin auditoría independiente. Aun así, como plantilla para el runtime de agentes, el enfoque funciona: autómata en lugar de expresiones regulares, rechazo estructurado en lugar de bloqueo y una prueba obligatoria para cada agujero encontrado.
- 8 nov 2026Un agente de IA híbrido reduce el coste de una conversación a 3,8 rublos
- 21 oct 2026TARSphere evalúa robots con cerebro MLLM en 360 episodios y 30 escenas
- 27 oct 2026Pi 1.0 conecta MCP mediante Codemode: el agente escribe código JS en lugar de hacer llamadas aisladas
- 18 nov 2026Análisis de 99 compactaciones de Claude Code: el 35% de los detalles que el agente necesitaba no llegó al contexto
Preguntas frecuentes sobre la noticia
¿Qué se sabe sobre Por qué no funcionan las expresiones regulares?
La primera idea es verificar la paridad de las comillas, por ejemplo count % 2 == 0. Pero la misma cadena se interpreta de forma distinta según la shell. Tomemos dir "C:\". En PowerShell, la barra invertida es un separador de ruta normal: la comilla se abre, ve C:\, se cierra y el comando queda listo. En Bash, esa misma barra escapa la comilla siguiente, esta deja de ser de cierre y la shell espera una continuación que nunca llegará.
¿Qué se sabe sobre Autómata finito y «doble cerradura»?
El autor sustituyó las expresiones regulares por un autómata determinista con tres gramáticas aisladas: posix, powershell y cmd. Cambia de estado (texto normal, comillas dobles, comillas simples, escape) de forma estricta según las reglas del entorno de destino. Para herramientas desconocidas, por ejemplo un plugin de terceros o un agente personalizado, funciona el modo Strict Intersect.
¿Qué se sabe sobre La historia del heredoc y las 122 pruebas?
Lo más útil del material es el análisis honesto del error. Un heredoc es un bloque de texto en Bash delimitado por marcadores como <<EOF y EOF. En la versión v3.0, el hook veía el marcador <<EOF, asumía que dentro las comillas eran «crudas» y dejaba pasar todo el comando. La prueba reveló el agujero: el modelo generó cat <<EOF … EOF seguido de echo "unclosed. El hook vio el marcador y lo dejó pasar todo, y la comilla sin cerrar tras el bloque colgó la shell.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
Lo esencial de la IA — una vez por semana
Siete historias que de verdad importaron, elegidas a mano. Sin ruido ni notas de prensa.
¡Listo! Revisa tu correo para la confirmación.