Intensivo Gratis 21–22.11Intensivo gratuito de 2 días en Vibecoding (21–22 nov, 16:00 MSK) · Cohorte 3 inicia 23.11Registrarse gratis →Cohorte 3 (23.11)
LanzamientoAnálisis · En radarHabr AI→ original

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
Un autómata finito en un hook impide que un agente de IA bloquee Bash: las 122 pruebas superadas
Fuente: Habr AI. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalHabr AI ↗
Editor jefe
La cadena dir "C\" es segura en PowerShell, pero bloquea Bash
Dato clave #2La v3.0 dejaba pasar los heredoc completos; en la v3.1 el cuerpo se enmascara con espacios
Dato clave #3Las 122 pruebas en Python y Node.js pasan, incluidas las adversariales

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.

Historia

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.

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Unified AI Workspace · Nomad

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.

Try Nomad AI →Launch Nomad Agent
¿Qué te parece?
Cargando comentarios…