Tools
Pantalla
La herramienta screen permite que un agente organice la interfaz de control basada en el navegador. Es una
superficie tipada de diseño y navegación, no una herramienta de captura de pantalla ni de
automatización del navegador.
La herramienta solo se expone cuando el cliente de origen anuncia la
capacidad ui-commands. Al menos una interfaz de control compatible debe seguir
conectada cuando se ejecute 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 (de forma predeterminada, la sesión actual) |
split_down |
Divide hacia abajo el panel de la sesión de destino | sessionKey (de forma predeterminada, la sesión actual) |
close_pane |
Cierra el panel de la sesión de destino | sessionKey (de forma predeterminada, la sesión actual) |
focus |
Enfoca el panel de la sesión de destino | sessionKey (de forma predeterminada, la sesión actual) |
navigate |
Abre la sesión de destino | sessionKey (de forma predeterminada, 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 transmita
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 sola pestaña del navegador. Esto es importante cuando
el mismo operador tiene abiertos varios paneles.
El RPC del Gateway requiere operator.write. La herramienta solo puede cambiar el estado
de presentación: no puede leer píxeles, tomar capturas de pantalla, hacer clic en contenido
arbitrario de la página ni eludir los permisos de los paneles de sesión y del operador
seleccionados.
