OCSB_DISPLAY: agent windows on the desktop through the Wayland socket

Off by default. With OCSB_DISPLAY=1 the sandbox gets only the Wayland socket and /dev/dri: the agent's windows (e.g. a Playwright browser) appear on the desktop, but a Wayland client cannot read other windows or inject input into them. X11 and the X cookie are never passed in.

README.ru.md

@@ -123,6 +123,7 @@ squid.conf.
 | `OCSB_PLUGINS` | skill-compact-resurrect | файлы плагинов из `plugins/` (или абсолютные пути) |
 | `OCSB_PANEL` | `1` | панель «Токены» в веб-интерфейсе |
 | `OCSB_NOTIFICATIONS` | `1` | уведомления через фильтрующий прокси D-Bus |
+| `OCSB_DISPLAY` | `0` | `1` — окна агента (например, браузер Playwright) на вашем экране через сокет Wayland |
 | `OCSB_TMP` | `private` | `private` — свой `/tmp` агента в каталоге состояния; `shared` — `/tmp` хоста |
 | `OCSB_SANDBOX` | `1` | `0` — только фильтр и netlock, без bubblewrap |
 | `OCSB_WORKTREES_DIR` | `../<проект>-worktrees` | куда класть worktree |
@@ -244,9 +245,10 @@ opencode-sandbox run
 - **Сессионная шина:** заменена на `xdg-dbus-proxy`, который пропускает только
   `org.freedesktop.Notifications`; настоящая шина позволила бы агенту запускать процессы вне
   песочницы через `systemd-run --user`.
-- **Нет экрана:** `DISPLAY`, `WAYLAND_DISPLAY` и `XAUTHORITY` пустые, cookie X скрыт — графические
-  программы до вашего рабочего стола не доберутся; браузеры (Playwright MCP, Chrome) — только
-  headless. `xdg-open` отключён; интерфейс открывает `run` из вашей обычной сессии.
+- **Экран:** по умолчанию нет — `DISPLAY`, `WAYLAND_DISPLAY` и `XAUTHORITY` пустые, cookie X
+  скрыт; браузеры — headless. С `OCSB_DISPLAY=1` агент получает только сокет Wayland (и
+  `/dev/dri` для видеокарты): его окна появляются на вашем экране, но, в отличие от X11, клиент
+  Wayland не может читать чужие окна и подделывать в них ввод. X11 не пробрасывается никогда. `xdg-open` отключён; интерфейс открывает `run` из вашей обычной сессии.
 - **Без тихого отката:** при `OCSB_SANDBOX=1` и неработающем bubblewrap `run` не запустится.
 
 **Netlock** (`netlock setup`, sudo) создаёт группу `opencode-sandbox`, добавляет в неё вас и
@@ -268,6 +270,8 @@ opencode-sandbox run
 - **Проект доступен на запись.** Ошибки внутри него настоящие; cc-safety-net блокирует
   типичные разрушительные команды, git хранит историю — коммитьте чаще.
 - С `OCSB_TMP=shared` доступны `/tmp` хоста и его сокеты.
+- С `OCSB_DISPLAY=1` агент может открывать окна на вашем экране и пользоваться буфером обмена,
+  пока его окно в фокусе.
 
 ## Решение проблем
 
@@ -282,7 +286,7 @@ opencode-sandbox run
 | `bubblewrap cannot create a sandbox` | отключены непривилегированные user namespaces (`kernel.unprivileged_userns_clone`, ограничения AppArmor) |
 | нет панели «Токены» | открывайте порт 4196, а не 4197; журнал — `<состояние>/data/opencode/log/context-panel.log` |
 | нет уведомлений | установите `xdg-dbus-proxy` |
-| браузерные инструменты падают (`Missing X server`, `Failed to connect to Wayland display`) | в песочнице нет экрана: запускайте браузер headless (Playwright MCP: `--headless`) |
+| браузерные инструменты падают (`Missing X server`, `Failed to connect to Wayland display`) | в песочнице нет экрана: включите `OCSB_DISPLAY=1` (сессия Wayland) или запускайте браузер headless (Playwright MCP: `--headless`) |
 | не найти файл, который агент положил в `/tmp` | он в `~/.local/share/opencode-sandbox/<имя>/tmp` |
 | `docker build` не скачивает образы | реестры доступны через squid: смотрите `egress logs` |