Tools
Pantalla
La herramienta screen permite que un agente organice la interfaz de control basada en el navegador. Es una
superficie tipada de disposición y navegación, no una herramienta de captura de pantalla ni de
automatización del navegador.
La herramienta se expone únicamente cuando el cliente de origen anuncia la
capacidad ui-commands. Al menos una interfaz de control compatible debe permanecer
conectada cuando se ejecuta la herramienta; de lo contrario, el Gateway devuelve UNAVAILABLE.
Acciones
| Acción | Efecto | Entradas opcionales |
|---|---|---|
split_right |
Divide hacia la derecha el panel de la sesión de destino | sessionKey (el valor predeterminado es la sesión actual) |
split_down |
Divide hacia abajo el panel de la sesión de destino | sessionKey (el valor predeterminado es la sesión actual) |
close_pane |
Cierra el panel de la sesión de destino | sessionKey (el valor predeterminado es la sesión actual) |
focus |
Enfoca el panel de la sesión de destino | sessionKey (el valor predeterminado es la sesión actual) |
navigate |
Abre la sesión de destino | sessionKey (el valor predeterminado es la sesión actual) |
sidebar_show / sidebar_hide |
Muestra u oculta la barra lateral principal | - |
terminal_show / terminal_hide |
Muestra u oculta el panel del terminal del operador | dock (bottom o right) al mostrarlo |
browser_show / browser_hide |
Muestra u oculta el panel del navegador | dock (bottom o right) al mostrarlo |
Un comando correcto devuelve { "ok": true } después de que el Gateway difunde
el evento tipado ui.command.
Enrutamiento y seguridad
El protocolo v1 envía intencionadamente el comando a todas las interfaces de control conectadas que
anuncian ui-commands; no se dirige a una única pestaña del navegador. Esto es importante cuando
el mismo operador tiene abiertos varios paneles de control.
La RPC del Gateway requiere operator.write. La herramienta solo puede cambiar el estado de
presentación: no puede leer píxeles, realizar capturas de pantalla, hacer clic en contenido arbitrario
de la página ni eludir los permisos de los paneles de la sesión y del operador
seleccionados.
