Tools
Bildschirm
Mit dem Tool screen kann ein Agent die browserbasierte Control UI anordnen. Es handelt sich um eine
typisierte Layout- und Navigationsoberfläche, nicht um eine Screenshot-Erfassung oder Browser-
automatisierung.
Das Tool wird nur bereitgestellt, wenn der ursprüngliche Client die Funktion
ui-commands bekannt gibt. Beim Ausführen des Tools muss weiterhin mindestens eine kompatible Control UI
verbunden sein; andernfalls gibt das Gateway UNAVAILABLE zurück.
Aktionen
| Aktion | Auswirkung | Optionale Eingaben |
|---|---|---|
split_right |
Teilt den Bereich der Zielsitzung nach rechts | sessionKey (standardmäßig die aktuelle Sitzung) |
split_down |
Teilt den Bereich der Zielsitzung nach unten | sessionKey (standardmäßig die aktuelle Sitzung) |
close_pane |
Schließt den Bereich der Zielsitzung | sessionKey (standardmäßig die aktuelle Sitzung) |
focus |
Fokussiert den Bereich der Zielsitzung | sessionKey (standardmäßig die aktuelle Sitzung) |
navigate |
Öffnet die Zielsitzung | sessionKey (standardmäßig die aktuelle Sitzung) |
sidebar_show / sidebar_hide |
Blendet die Hauptseitenleiste ein oder aus | - |
terminal_show / terminal_hide |
Blendet das Operator-Terminalpanel ein oder aus | dock (bottom oder right) beim Einblenden |
browser_show / browser_hide |
Blendet das Browserpanel ein oder aus | dock (bottom oder right) beim Einblenden |
Ein erfolgreicher Befehl gibt { "ok": true } zurück, nachdem das Gateway
das typisierte Ereignis ui.command übertragen hat.
Routing und Sicherheit
Protokoll v1 sendet den Befehl absichtlich an jede verbundene Control UI, die
ui-commands bekannt gibt; es richtet ihn nicht an einen einzelnen Browser-Tab. Dies ist relevant, wenn
derselbe Operator mehrere Dashboards geöffnet hat.
Der Gateway-RPC erfordert operator.write. Das Tool kann ausschließlich den Darstellungs-
zustand ändern: Es kann keine Pixel auslesen, Screenshots erstellen, beliebige Seiten-
inhalte anklicken oder die Berechtigungen der ausgewählten Sitzungs- und Operator-
panels umgehen.
