answer42 0.7.0__tar.gz → 0.8.0__tar.gz

{answer42-0.7.0 → answer42-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: answer42
-Version: 0.7.0
+Version: 0.8.0
 Summary: Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API
 Author: Marvin (AI Assistant), 42Clouds, and contributors
 Author-email: "Kosolapov Stanislav (proDOOMman)" <prodoomman@gmail.com>
@@ -229,7 +229,17 @@ answer42
 
 **Статический HTML** — инструменты группы `forms` через API клиента тестирования: `html_field_content` (HTML поля в том виде, в каком страница загрузилась, и её видимый текст), `html_field_click_link`, `html_field_input`.
 
-**Живые страницы** — группа `html`. `start_session` по умолчанию (`html_agent=true`) готовит мост к встроенному WebKit клиента; `html_agent=false` его не запускает.
+**Живые страницы** — группа `html`. Способ доступа к встроенному WebKit клиента выбирает параметр `start_session(html_mode=...)` (значение по умолчанию можно задать переменной `ONEC_MCP_HTML_MODE`):
+
+| `html_mode` | Где | Как |
+|---|---|---|
+| `auto` (по умолчанию) | везде | Linux — `remote`; Windows — `patched`, если в Web Inspector платформы установлен актуальный мост, иначе `console` |
+| `console` | Windows | горячая клавиша инспектора и короткий загрузчик, введённый в его консоль |
+| `patched` | Windows, Linux | мост, встроенный в интерфейс инспектора: на Windows — в Web Inspector платформы (сначала `answer42 webkit-inspector install`, см. ниже), на Linux — подставляется для сессии, ничего устанавливать не нужно |
+| `remote` | Linux | удалённый отладчик WebKitGTK (`WEBKIT_INSPECTOR_SERVER`) |
+| `disabled` | везде | мост не запускается, инструменты `html_*` недоступны |
+
+Явно выбранный режим не подменяется другим: если он недоступен (`patched` без моста в платформе, режим другой ОС), `start_session` сразу возвращает ошибку с подсказкой. Мост ничего не делает, пока не вызван инструмент `html_*`: на Windows инспектор открывается только при первом вызове, на Linux клиент запускается со встроенным сервером отладки.
 
 | Инструмент | Что делает |
 |---|---|
@@ -241,6 +251,7 @@ answer42
 | `html_wait` | дождаться появления или исчезновения текста / элемента |
 | `html_eval` | выполнить произвольный JavaScript в странице — **только с `--dev-tools`** (см. ниже) |
 | `html_console` | ошибки и предупреждения консоли страницы и скрипты, которые эта сборка WebKit не разбирает (например `?.`) |
+| `html_download` | скачать файл по ссылке страницы изнутри страницы (с её cookie и сеансом) и сохранить в каталог сессии: путь, размер, тип, HTTP-статус |
 | `html_inspector_patch` | Windows: встроить мост в Web Inspector установленных платформ 1С или убрать его (необязательно, см. ниже) |
 
 Если живых страниц несколько, нужная выбирается параметром `page` (id из `html_pages` или часть URL / заголовка).
@@ -250,8 +261,12 @@ answer42
 Как это устроено:
 
 - **Windows.** Встроенный WebKit клиента 1С не имеет сервера удалённой отладки, но его Web Inspector открывается по Ctrl+Alt+Shift+F12. При первом вызове `html_*` Answer42 открывает инспектор поля (он встраивается в нижнюю часть формы), переключает его на вкладку Console и вводит в консоль короткий загрузчик. Загрузчик подключается к локальному WebSocket Answer42 по одноразовому токену, получает мост и выполняет операции в странице. Подключение к странице занимает около 2–3 секунд. После перезагрузки страницы загрузчик вводится заново. Платформа используется как установлена.
-- **Windows, мост в инспекторе платформы (необязательно).** `answer42 webkit-inspector install` (или инструмент `html_inspector_patch(action="install")`) встраивает мост в Web Inspector установленной платформы: `bin\WebKit.resources\WebInspectorUI\Main.html` подключает `Answer42Bridge.js`. Каталог платформы доступен на запись только администратору, поэтому команда сама запрашивает права через UAC — одно подтверждение на все выбранные платформы — и разрешает текущему пользователю менять файл с портом сессии; сессиям права администратора больше не нужны. Если процесс Answer42 запущен из среды, которая не может показать запрос UAC (например, из песочницы агента), через 90 секунд команда вернёт ошибку с готовой командой для PowerShell, запущенного от имени администратора. После этого интерфейс инспектора подключается к Answer42 сам: в консоль ничего не вводится, мост переживает перезагрузку страницы, а `html_console` видит сообщения с момента её загрузки. Если инспектор открывает человек, мост ничего не делает. `answer42 webkit-inspector status` показывает состояние платформ, `uninstall` возвращает исходные файлы; без моста (или после обновления платформы) Answer42 вводит загрузчик, как обычно. Ключ `--version` выбирает платформу, без него — все установленные.
-- **Linux.** HTML-поля рисует системный WebKitGTK. Answer42 запускает тест-клиент с `WEBKIT_INSPECTOR_SERVER=127.0.0.1:<порт>` и подключается к удалённому отладчику WebKitGTK напрямую: окна инспектора и ввода с клавиатуры нет.
+- **Windows, мост в инспекторе платформы (`html_mode=patched`).** `answer42 webkit-inspector install` (или инструмент `html_inspector_patch(action="install")`) встраивает мост в Web Inspector установленной платформы: `bin\WebKit.resources\WebInspectorUI\Main.html` подключает `Answer42Bridge.js`. Каталог платформы доступен на запись только администратору, поэтому команда сама запрашивает права через UAC — одно подтверждение на все выбранные платформы — и разрешает текущему пользователю менять файл с портом сессии; сессиям права администратора больше не нужны. Если процесс Answer42 запущен из среды, которая не может показать запрос UAC (например, из песочницы агента), через 90 секунд команда вернёт ошибку с готовой командой для PowerShell, запущенного от имени администратора. После этого интерфейс инспектора подключается к Answer42 сам: в консоль ничего не вводится, мост переживает перезагрузку страницы, а `html_console` видит сообщения с момента её загрузки. Если инспектор открывает человек, мост ничего не делает. `answer42 webkit-inspector status` показывает состояние платформ, `uninstall` возвращает исходные файлы. После обновления Answer42 или платформы мост нужно поставить заново: `html_mode=patched` с устаревшим мостом не запускается. Ключ `--version` выбирает платформу, без него — все установленные.
+- **Linux, `remote` (по умолчанию).** HTML-поля рисует системный WebKitGTK. Answer42 запускает тест-клиент с `WEBKIT_INSPECTOR_SERVER=127.0.0.1:<порт>` и подключается к удалённому отладчику WebKitGTK напрямую: окна инспектора и ввода с клавиатуры нет.
+- **Linux, `patched`.** Инспектор WebKitGTK в 1С открывается той же клавишей Ctrl+Alt+Shift+F12 и встраивается в форму. Интерфейс инспектора вшит в системную `libwebkit2gtk`, поэтому Answer42 его не меняет: переменная GLib `G_RESOURCE_OVERLAYS` подставляет тест-клиенту из каталога сессии один файл инспектора (`localizedStrings.js`) с мостом. Answer42 ставит фокус в HTML-поле средствами клиента тестирования и отправляет клавишу через `xdotool`, после чего интерфейс инспектора подключается сам (около 1 с). Нужен `xdotool`; на живом дисплее горячая клавиша уходит в окно 1С.
+- **Linux, `console`** не поддерживается: встроенный инспектор WebKitGTK не отдельное окно X11, поэтому клавиши уходят в элемент с фокусом — в саму страницу. В проверке набранный загрузчик попал в поле ввода чата и был отправлен как сообщение.
+
+**Внешний браузер на Linux.** Ссылки и файлы, которые 1С открывает «снаружи» (например, «Скачать» в HTML-поле или `ЗапуститьПриложение`), платформа открывает через `xdg-open` и ждёт его завершения, а `xdg-open` ждёт браузер, который ему пришлось запустить. Без Answer42 клиент 1С висел, пока не закроют Chrome, а с ним вставали мост тест-клиента и инструменты `html_*`. Поэтому тест-клиент получает в `PATH` обёртку `xdg-open` от Answer42: она записывает адрес и сразу возвращает управление, а на настоящем дисплее открывает адрес в браузере отдельно от клиента. Записанные адреса видны в `external_opens` ответов `html_field_click_link` и `session_status`; файл по такому адресу скачивает `html_download`. `ONEC_MCP_EXTERNAL_OPEN`: `auto` (по умолчанию: на собственном Xvfb Answer42 только записывать, на настоящем дисплее ещё и открывать), `open`, `record`, `off` (без обёртки).
 
 Ограничения: на Windows инспектор остаётся встроенным в форму и попадает на скриншоты. `html_console` на Linux и с мостом в инспекторе платформы отдаёт сообщения с момента загрузки страницы, а с загрузчиком в консоли — с момента подключения (`collected_since`); неподдержанный синтаксис в скриптах страницы находит проверка скриптов (`check_scripts`). Встроенный WebKit Windows-клиента 1С не поддерживает часть современного JavaScript (например `?.`), а WebKitGTK на Linux — поддерживает: одна и та же страница может работать в одном клиенте и ломаться в другом.
 

{answer42-0.7.0 → answer42-0.8.0}/README.md

@@ -187,7 +187,17 @@ answer42
 
 **Статический HTML** — инструменты группы `forms` через API клиента тестирования: `html_field_content` (HTML поля в том виде, в каком страница загрузилась, и её видимый текст), `html_field_click_link`, `html_field_input`.
 
-**Живые страницы** — группа `html`. `start_session` по умолчанию (`html_agent=true`) готовит мост к встроенному WebKit клиента; `html_agent=false` его не запускает.
+**Живые страницы** — группа `html`. Способ доступа к встроенному WebKit клиента выбирает параметр `start_session(html_mode=...)` (значение по умолчанию можно задать переменной `ONEC_MCP_HTML_MODE`):
+
+| `html_mode` | Где | Как |
+|---|---|---|
+| `auto` (по умолчанию) | везде | Linux — `remote`; Windows — `patched`, если в Web Inspector платформы установлен актуальный мост, иначе `console` |
+| `console` | Windows | горячая клавиша инспектора и короткий загрузчик, введённый в его консоль |
+| `patched` | Windows, Linux | мост, встроенный в интерфейс инспектора: на Windows — в Web Inspector платформы (сначала `answer42 webkit-inspector install`, см. ниже), на Linux — подставляется для сессии, ничего устанавливать не нужно |
+| `remote` | Linux | удалённый отладчик WebKitGTK (`WEBKIT_INSPECTOR_SERVER`) |
+| `disabled` | везде | мост не запускается, инструменты `html_*` недоступны |
+
+Явно выбранный режим не подменяется другим: если он недоступен (`patched` без моста в платформе, режим другой ОС), `start_session` сразу возвращает ошибку с подсказкой. Мост ничего не делает, пока не вызван инструмент `html_*`: на Windows инспектор открывается только при первом вызове, на Linux клиент запускается со встроенным сервером отладки.
 
 | Инструмент | Что делает |
 |---|---|
@@ -199,6 +209,7 @@ answer42
 | `html_wait` | дождаться появления или исчезновения текста / элемента |
 | `html_eval` | выполнить произвольный JavaScript в странице — **только с `--dev-tools`** (см. ниже) |
 | `html_console` | ошибки и предупреждения консоли страницы и скрипты, которые эта сборка WebKit не разбирает (например `?.`) |
+| `html_download` | скачать файл по ссылке страницы изнутри страницы (с её cookie и сеансом) и сохранить в каталог сессии: путь, размер, тип, HTTP-статус |
 | `html_inspector_patch` | Windows: встроить мост в Web Inspector установленных платформ 1С или убрать его (необязательно, см. ниже) |
 
 Если живых страниц несколько, нужная выбирается параметром `page` (id из `html_pages` или часть URL / заголовка).
@@ -208,8 +219,12 @@ answer42
 Как это устроено:
 
 - **Windows.** Встроенный WebKit клиента 1С не имеет сервера удалённой отладки, но его Web Inspector открывается по Ctrl+Alt+Shift+F12. При первом вызове `html_*` Answer42 открывает инспектор поля (он встраивается в нижнюю часть формы), переключает его на вкладку Console и вводит в консоль короткий загрузчик. Загрузчик подключается к локальному WebSocket Answer42 по одноразовому токену, получает мост и выполняет операции в странице. Подключение к странице занимает около 2–3 секунд. После перезагрузки страницы загрузчик вводится заново. Платформа используется как установлена.
-- **Windows, мост в инспекторе платформы (необязательно).** `answer42 webkit-inspector install` (или инструмент `html_inspector_patch(action="install")`) встраивает мост в Web Inspector установленной платформы: `bin\WebKit.resources\WebInspectorUI\Main.html` подключает `Answer42Bridge.js`. Каталог платформы доступен на запись только администратору, поэтому команда сама запрашивает права через UAC — одно подтверждение на все выбранные платформы — и разрешает текущему пользователю менять файл с портом сессии; сессиям права администратора больше не нужны. Если процесс Answer42 запущен из среды, которая не может показать запрос UAC (например, из песочницы агента), через 90 секунд команда вернёт ошибку с готовой командой для PowerShell, запущенного от имени администратора. После этого интерфейс инспектора подключается к Answer42 сам: в консоль ничего не вводится, мост переживает перезагрузку страницы, а `html_console` видит сообщения с момента её загрузки. Если инспектор открывает человек, мост ничего не делает. `answer42 webkit-inspector status` показывает состояние платформ, `uninstall` возвращает исходные файлы; без моста (или после обновления платформы) Answer42 вводит загрузчик, как обычно. Ключ `--version` выбирает платформу, без него — все установленные.
-- **Linux.** HTML-поля рисует системный WebKitGTK. Answer42 запускает тест-клиент с `WEBKIT_INSPECTOR_SERVER=127.0.0.1:<порт>` и подключается к удалённому отладчику WebKitGTK напрямую: окна инспектора и ввода с клавиатуры нет.
+- **Windows, мост в инспекторе платформы (`html_mode=patched`).** `answer42 webkit-inspector install` (или инструмент `html_inspector_patch(action="install")`) встраивает мост в Web Inspector установленной платформы: `bin\WebKit.resources\WebInspectorUI\Main.html` подключает `Answer42Bridge.js`. Каталог платформы доступен на запись только администратору, поэтому команда сама запрашивает права через UAC — одно подтверждение на все выбранные платформы — и разрешает текущему пользователю менять файл с портом сессии; сессиям права администратора больше не нужны. Если процесс Answer42 запущен из среды, которая не может показать запрос UAC (например, из песочницы агента), через 90 секунд команда вернёт ошибку с готовой командой для PowerShell, запущенного от имени администратора. После этого интерфейс инспектора подключается к Answer42 сам: в консоль ничего не вводится, мост переживает перезагрузку страницы, а `html_console` видит сообщения с момента её загрузки. Если инспектор открывает человек, мост ничего не делает. `answer42 webkit-inspector status` показывает состояние платформ, `uninstall` возвращает исходные файлы. После обновления Answer42 или платформы мост нужно поставить заново: `html_mode=patched` с устаревшим мостом не запускается. Ключ `--version` выбирает платформу, без него — все установленные.
+- **Linux, `remote` (по умолчанию).** HTML-поля рисует системный WebKitGTK. Answer42 запускает тест-клиент с `WEBKIT_INSPECTOR_SERVER=127.0.0.1:<порт>` и подключается к удалённому отладчику WebKitGTK напрямую: окна инспектора и ввода с клавиатуры нет.
+- **Linux, `patched`.** Инспектор WebKitGTK в 1С открывается той же клавишей Ctrl+Alt+Shift+F12 и встраивается в форму. Интерфейс инспектора вшит в системную `libwebkit2gtk`, поэтому Answer42 его не меняет: переменная GLib `G_RESOURCE_OVERLAYS` подставляет тест-клиенту из каталога сессии один файл инспектора (`localizedStrings.js`) с мостом. Answer42 ставит фокус в HTML-поле средствами клиента тестирования и отправляет клавишу через `xdotool`, после чего интерфейс инспектора подключается сам (около 1 с). Нужен `xdotool`; на живом дисплее горячая клавиша уходит в окно 1С.
+- **Linux, `console`** не поддерживается: встроенный инспектор WebKitGTK не отдельное окно X11, поэтому клавиши уходят в элемент с фокусом — в саму страницу. В проверке набранный загрузчик попал в поле ввода чата и был отправлен как сообщение.
+
+**Внешний браузер на Linux.** Ссылки и файлы, которые 1С открывает «снаружи» (например, «Скачать» в HTML-поле или `ЗапуститьПриложение`), платформа открывает через `xdg-open` и ждёт его завершения, а `xdg-open` ждёт браузер, который ему пришлось запустить. Без Answer42 клиент 1С висел, пока не закроют Chrome, а с ним вставали мост тест-клиента и инструменты `html_*`. Поэтому тест-клиент получает в `PATH` обёртку `xdg-open` от Answer42: она записывает адрес и сразу возвращает управление, а на настоящем дисплее открывает адрес в браузере отдельно от клиента. Записанные адреса видны в `external_opens` ответов `html_field_click_link` и `session_status`; файл по такому адресу скачивает `html_download`. `ONEC_MCP_EXTERNAL_OPEN`: `auto` (по умолчанию: на собственном Xvfb Answer42 только записывать, на настоящем дисплее ещё и открывать), `open`, `record`, `off` (без обёртки).
 
 Ограничения: на Windows инспектор остаётся встроенным в форму и попадает на скриншоты. `html_console` на Linux и с мостом в инспекторе платформы отдаёт сообщения с момента загрузки страницы, а с загрузчиком в консоли — с момента подключения (`collected_since`); неподдержанный синтаксис в скриптах страницы находит проверка скриптов (`check_scripts`). Встроенный WebKit Windows-клиента 1С не поддерживает часть современного JavaScript (например `?.`), а WebKitGTK на Linux — поддерживает: одна и та же страница может работать в одном клиенте и ломаться в другом.
 

{answer42-0.7.0 → answer42-0.8.0}/docs/architecture.md

@@ -91,7 +91,7 @@ class SessionState:
 
 `dynamic_list_sort_by_column` — отдельный быстрый tool для сортировки уже открытого динамического списка по видимой колонке через API списка. Он не является fallback-веткой `dynamic_list_set_settings`.
 - табличные документы: `tabular_documents` (список или ячейки одного документа по `name`/`title`), `tabular_document_save`;
-- HTML-поля: `html_field_content`, `html_field_click_link`, `html_field_input` (API тест-клиента) и живые страницы `html_pages`, `html_text`, `html_query`, `html_click`, `html_type`, `html_wait`, `html_console` (через `mcp_1c.html_agent`); `html_eval` (произвольный JavaScript) и `dev_eval` (произвольный BSL) регистрируются только с `--dev-tools` / `ONEC_MCP_DEV_TOOLS=1` (`DEV_TOOL_NAMES`, `_register_dev_tools`);
+- HTML-поля: `html_field_content`, `html_field_click_link`, `html_field_input` (API тест-клиента) и живые страницы `html_pages`, `html_text`, `html_query`, `html_click`, `html_type`, `html_wait`, `html_console` (через `mcp_1c.html_agent`); `html_download` (файл по ссылке страницы, запросом изнутри страницы); `html_eval` (произвольный JavaScript) и `dev_eval` (произвольный BSL) регистрируются только с `--dev-tools` / `ONEC_MCP_DEV_TOOLS=1` (`DEV_TOOL_NAMES`, `_register_dev_tools`);
 - доказательная запись: `recording_start`, `recording_capture`, `recording_stop`;
 - RAG: `rag_source_add`, `rag_sources_add_from_directory`, `rag_source_roots_list`, `rag_sources_list`, `rag_available_configurations`, `rag_snapshot_create`, `rag_snapshots_list`, `rag_index_build`, `rag_lookup_object`, `rag_query`, `rag_session_autoconfigure`.
 
@@ -119,6 +119,8 @@ Windows-аналог Xvfb: скрытые рабочие столы (`CreateDesk
 
 ### `mcp_1c.html_agent`
 
+Режим задаёт `start_session(html_mode=...)` (`resolve_mode`): `auto` — `remote` на Linux, а на Windows `HtmlInspector.check_platform` выбирает `patched`, если в Web Inspector платформы клиента установлен актуальный мост, иначе `console`; `console` и `patched` — только Windows, `remote` — только Linux. На Linux `console` отклоняется: клавиши через XTEST уходят в элемент с фокусом, а встроенный инспектор WebKitGTK — не отдельное окно X11, поэтому загрузчик попал бы в саму страницу. `patched` на Linux подставляет через `G_RESOURCE_OVERLAYS` файл `Localizations/en.lproj/localizedStrings.js` интерфейса инспектора (пустой словарь строк — интерфейс показывает английские ключи — плюс конфиг и `LINUX_BRIDGE_JS`, который учитывает домен `Target`); фокус в поле ставит `activate_field` клиента тестирования (`_HtmlFieldDriver` в `mcp_1c.server`), клавишу отправляет `xdotool`. `disabled` не запускает мост. Явно выбранный режим строгий: `patched` без актуального моста в платформе отклоняется ещё до запуска клиента (`HtmlInspector.check_platform`), а при сбое подключения нет отката на другой режим.
+
 Мост к живым страницам HTML-полей. API тест-клиента отдаёт только HTML, с которым страница загрузилась, поэтому для страниц, которые рисуют себя скриптами, Answer42 работает со встроенным WebKit клиента напрямую. Операции над страницей — одна самодостаточная ES5-функция `OPS_JS` (`info`, `text`, `html`, `query`, `click`, `type`, `eval`, `hook_console`, `console`, `check_scripts`), которая выполняется в странице и возвращает JSON. `HtmlInspector` — состояние моста сессии: страницы `p1`, `p2`, …, выбор страницы, ошибки подключения.
 
 ```mermaid
@@ -140,7 +142,7 @@ flowchart LR
 
 Дальше `_type_into_console`: `WM_SETFOCUS` делает интерфейс инспектора активным для WebKit, не трогая фокус внутри его документа; Ctrl+Alt+C открывает вкладку Console, которая сама ставит фокус в строку ввода (инспектор запоминает вкладку). На вкладку Elements ввод попадать не должен: её дерево DOM забирает фокус, когда догружается, и набранные в нём клавиши, особенно Enter, правят DOM страницы. Esc тоже нельзя — его первой обрабатывает 1С и закрывает форму. Загрузчик `loader_js` (около 110 символов) вводится за комментарием `//`: автодополнение консоли асинхронно отвечает на набранный код и может заменить набранное после него, но внутри комментария не срабатывает. Home и два Delete снимают `//`, Enter выполняет строку. Загрузчик открывает WebSocket с одноразовым токеном в адресе, сервер в ответ присылает `PAGE_BRIDGE_JS`, который выполняет присланные выражения через `eval`. Подключение к странице занимает около 2–3 секунд; время по этапам — в `last_connect` статуса моста. Мост живёт в странице: после перезагрузки следующий вызов вводит загрузчик заново.
 
-**Windows, мост в инспекторе платформы** (`mcp_1c.webkit_patch`, необязательно). `install` дописывает в `WebKit.resources\WebInspectorUI\Main.html` платформы `Answer42BridgeConfig.js` и `Answer42Bridge.js` (исходный `Main.html` сохраняется рядом). Каталог в Program Files доступен на запись только администратору, поэтому модуль перезапускает себя с повышением прав (`ShellExecuteEx` с `runas`, одно подтверждение UAC на все платформы) и выдаёт текущему пользователю право менять `Answer42BridgeConfig.js` (`icacls`). Перед тем как открыть инспектор, сессия записывает в этот файл свой порт и одноразовый токен (под файловой блокировкой: платформу могут делить несколько сессий) и очищает его сразу после. Мост в интерфейсе инспектора подключается к `HtmlInspector` по пути `/answer42-inspector/<токен>`, отправляет в бэкенд сообщения протокола с id от `BRIDGE_BASE_ID` и возвращает ответы на них, а также копии `Console.messageAdded`; остальное идёт в обычный интерфейс инспектора. Операции над страницей — `Runtime.evaluate` с `returnByValue`; мост переживает перезагрузку страницы, а сообщения консоли видны с её загрузки. Если платформа не пропатчена, патч устарел или инспектор уже открыт, используется ввод в консоль.
+**Windows, мост в инспекторе платформы** (`mcp_1c.webkit_patch`, необязательно). `install` дописывает в `WebKit.resources\WebInspectorUI\Main.html` платформы `Answer42BridgeConfig.js` и `Answer42Bridge.js` (исходный `Main.html` сохраняется рядом). Каталог в Program Files доступен на запись только администратору, поэтому модуль перезапускает себя с повышением прав (`ShellExecuteEx` с `runas`, одно подтверждение UAC на все платформы) и выдаёт текущему пользователю право менять `Answer42BridgeConfig.js` (`icacls`). Перед тем как открыть инспектор, сессия записывает в этот файл свой порт и одноразовый токен (под файловой блокировкой: платформу могут делить несколько сессий) и очищает его сразу после. Мост в интерфейсе инспектора подключается к `HtmlInspector` по пути `/answer42-inspector/<токен>`, отправляет в бэкенд сообщения протокола с id от `BRIDGE_BASE_ID` и возвращает ответы на них, а также копии `Console.messageAdded`; остальное идёт в обычный интерфейс инспектора. Операции над страницей — `Runtime.evaluate` с `returnByValue`; мост переживает перезагрузку страницы, а сообщения консоли видны с её загрузки. Режим включается явно (`html_mode=patched`); если инспектор поля уже открыт без моста, его нужно закрыть.
 
 **Linux.** HTML-поля рисует системный WebKitGTK (`libwebkit2gtk-4.0`). `HtmlInspector.client_env()` добавляет тест-клиенту `WEBKIT_INSPECTOR_SERVER=127.0.0.1:<свободный порт>` (`runtime.start_test_client(extra_env=...)`). `RemoteInspectorClient` подключается к этому серверу как фронтенд: сообщения — размер (uint32 BE), флаг порядка байт, имя и параметры GVariant (`SetupInspectorClient`, `SetTargetList (ta(tsssb))`, `Setup (tt)`, `SendMessageToBackend (tts)`, `SendMessageToFrontend (tts)`). Каждая страница — цель `WebPage`; протокол инспектора мультиплексирован доменом `Target`, поэтому `Runtime.evaluate` уходит в `Target.sendMessageToTarget` текущей page-цели (она меняется при навигации, `Target.didCommitProvisionalTarget`). Домен `Console` включается на каждой page-цели, и WebKit отдаёт сообщения с момента загрузки страницы. Пустые скрытые страницы `about:blank` пропускаются. Некорректное сообщение может уронить клиент 1С, поэтому отправляются только перечисленные формы сообщений.
 
@@ -266,6 +268,7 @@ MCP-инструмент `rag_sources_add_from_directory(path, watch=true)` ищ
 | `ONEC_MCP_WS_HOST` | WebSocket host | `127.0.0.1` |
 | `ONEC_MCP_WS_PORT` | WebSocket port | `8765` |
 | `ONEC_MCP_REQUEST_TIMEOUT` | Таймаут запроса, сек | `60` |
+| `ONEC_MCP_EXTERNAL_OPEN` | Linux: что делать с адресами и файлами, которые тест-клиент открывает через `xdg-open` (обёртка `runtime.external_open_env`): `auto` — на собственном Xvfb только записывать в `external_opens`, на настоящем дисплее ещё и открывать отдельно от клиента; `open`; `record`; `off` — без обёртки | `auto` |
 | `ONEC_MCP_WINDOWS_DESKTOP` | Windows: `hidden` — запускать менеджер и клиент 1С на скрытых рабочих столах сессии; `current` — на текущем рабочем столе | `current` |
 | `ONEC_MCP_DATA_DIR` | Рабочая директория | OS tempdir + `answer42` (`/tmp/answer42` on Linux, `%TEMP%\answer42` on Windows) |
 | `MCP_1C_RAG_DB` | Путь к RAG SQLite | `build/rag/onec-rag.sqlite` |

{answer42-0.7.0 → answer42-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "answer42"
-version = "0.7.0"
+version = "0.8.0"
 description = "Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API"
 readme = "README.md"
 requires-python = ">=3.11"

{answer42-0.7.0 → answer42-0.8.0}/src/mcp_1c/html_agent.py

@@ -33,9 +33,12 @@ import datetime as _dt
 import itertools
 import json
 import logging
+import os
 import secrets
+import shutil
 import socket
 import struct
+import subprocess
 import time
 from contextlib import suppress
 from dataclasses import dataclass, field
@@ -194,6 +197,30 @@ OPS_JS = r"""function (op, args) {
       return describe(el, a.index || 0);
     },
     eval: function (a) { return (0, eval)(a.code); },
+    fetch: function (a) {
+      var url = a.url;
+      if (!url) {
+        var el = one(a);
+        url = el.href || el.getAttribute('href') || el.getAttribute('data-href') || el.src || '';
+        if (!url) { throw new Error('the element has no link (href, data-href or src)'); }
+      }
+      var link = document.createElement('a');
+      link.href = url;
+      var x = new XMLHttpRequest();
+      x.open('GET', link.href, false);
+      x.overrideMimeType('text/plain; charset=x-user-defined');
+      x.send(null);
+      var body = x.responseText || '', size = body.length;
+      if (a.max_bytes && size > a.max_bytes) { throw new Error('the file is too large: ' + size + ' bytes, the limit is ' + a.max_bytes); }
+      var chunks = [], step = 0x6000;
+      for (var i = 0; i < size; i += step) {
+        var part = body.substr(i, step), bytes = new Array(part.length);
+        for (var j = 0; j < part.length; j++) { bytes[j] = part.charCodeAt(j) & 0xff; }
+        chunks.push(String.fromCharCode.apply(null, bytes));
+      }
+      return { url: x.responseURL || link.href, status: x.status, content_type: x.getResponseHeader('Content-Type') || '',
+               disposition: x.getResponseHeader('Content-Disposition') || '', size: size, base64: btoa(chunks.join('')) };
+    },
     hook_console: function () {
       if (window.__answer42Console) { return false; }
       var log = window.__answer42Console = [];
@@ -774,14 +801,115 @@ class RemoteInspectorClient:
         return value.get("value")
 
 
+
+# --- Linux, local inspector (html_mode patched) ---
+#
+# 1C opens the WebKitGTK inspector of the focused HTML field on Ctrl+Alt+Shift+F12, docked into
+# the form.  GTK widgets are no X11 windows, so the field gets the focus through the test client
+# (activate_field) and the keys go to the client's window with xdotool (XTEST).  patched: GLib's
+# G_RESOURCE_OVERLAYS replaces one resource of the inspector front end, its localized strings
+# (the UI falls back to the English keys), with a file that also carries the session's port,
+# token and LINUX_BRIDGE_JS; no system file changes and no administrator rights.
+
+INSPECTOR_STRINGS_RESOURCE = "/org/webkit/inspector/Localizations/en.lproj"
+INSPECTOR_STRINGS_FILE = "localizedStrings.js"
+LINUX_INSPECTOR_KEYS = "ctrl+alt+shift+F12"
+
+# Like webkit_patch.BRIDGE_JS, plus the Target domain: WebKitGTK's front end talks to the page
+# through Target.sendMessageToTarget / Target.dispatchMessageFromTarget.
+LINUX_BRIDGE_JS = r"""(function () {
+  var config = window.ANSWER42_BRIDGE;
+  window.ANSWER42_BRIDGE = null;
+  if (!config || !config.port || !config.token) { return; }
+  var BASE_ID = __BASE_ID__;
+  function start() {
+    if (!window.InspectorFrontendAPI || !window.InspectorFrontendHost || !InspectorFrontendAPI.dispatchMessageAsync) { setTimeout(start, 50); return; }
+    var ws = new WebSocket('ws://127.0.0.1:' + config.port + '__PATH__' + config.token), queue = [];
+    function post(obj) { var text = JSON.stringify(obj); if (ws.readyState === 1) { ws.send(text); } else { queue.push(text); } }
+    function parse(message) {
+      if (typeof message !== 'string') { return message; }
+      if (message.indexOf('"id":') < 0 && message.indexOf('"Target.') < 0 && message.indexOf('Console.messageAdded') < 0) { return null; }
+      try { return JSON.parse(message); } catch (e) { return null; }
+    }
+    function divert(obj) {
+      if (!obj) { return false; }
+      if (typeof obj.id === 'number' && obj.id >= BASE_ID) { post({ type: 'message', message: obj }); return true; }
+      if (obj.method === 'Target.dispatchMessageFromTarget') {
+        var inner = obj.params && obj.params.message, o = null;
+        if (typeof inner === 'string' && (inner.indexOf('"id":') >= 0 || inner.indexOf('Console.messageAdded') >= 0)) {
+          try { o = JSON.parse(inner); } catch (e) { o = null; }
+        }
+        if (o && typeof o.id === 'number' && o.id >= BASE_ID) { post({ type: 'message', message: o }); return true; }
+        if (o && o.method === 'Console.messageAdded') { post({ type: 'event', message: o }); }
+        return false;
+      }
+      if (obj.method && obj.method.indexOf('Target.') === 0) { post({ type: 'target', message: obj }); }
+      if (obj.method === 'Console.messageAdded') { post({ type: 'event', message: obj }); }
+      return false;
+    }
+    ['dispatchMessageAsync', 'dispatchMessage'].forEach(function (name) {
+      var original = InspectorFrontendAPI[name];
+      if (!original) { return; }
+      InspectorFrontendAPI[name] = function (message) {
+        if (divert(parse(message))) { return undefined; }
+        return original.apply(this, arguments);
+      };
+    });
+    ws.onopen = function () { ws.send(JSON.stringify({ type: 'hello', version: 1 })); while (queue.length) { ws.send(queue.shift()); } };
+    ws.onmessage = function (event) {
+      var m;
+      try { m = JSON.parse(event.data); } catch (e) { return; }
+      if (m.type === 'send') { InspectorFrontendHost.sendMessageToBackend(JSON.stringify(m.message)); }
+    };
+  }
+  start();
+})();
+""".replace("__BASE_ID__", str(webkit_patch.BRIDGE_BASE_ID)).replace("__PATH__", webkit_patch.INSPECTOR_PATH)
+
+
+def write_inspector_strings(overlay_dir: Path, port: int = 0, token: str = "") -> None:
+    """The overlay localizedStrings.js: empty strings, the bridge config (or none) and LINUX_BRIDGE_JS."""
+    overlay_dir.mkdir(parents=True, exist_ok=True)
+    config = json.dumps({"port": int(port), "token": token}) if port and token else "null"
+    text = f"var localizedStrings = {{}};\nwindow.ANSWER42_BRIDGE = {config};\n{LINUX_BRIDGE_JS}"
+    tmp = overlay_dir / (INSPECTOR_STRINGS_FILE + ".tmp")
+    tmp.write_text(text, encoding="utf-8")
+    tmp.replace(overlay_dir / INSPECTOR_STRINGS_FILE)
+
+
+def _xdotool(display: str, *args: str) -> subprocess.CompletedProcess:
+    env = {**os.environ, "DISPLAY": display} if display else None
+    return subprocess.run(["xdotool", *args], env=env, capture_output=True, text=True, timeout=30)
+
+
+def _client_x_window(display: str, pid: int) -> str:
+    """The client's main X11 window: the visible window of the pid that has a title."""
+    for window in _xdotool(display, "search", "--pid", str(pid), "--onlyvisible", "--name", "").stdout.split():
+        if _xdotool(display, "getwindowname", window).stdout.strip():
+            return window
+    raise HtmlAgentError(f"No visible window of the test client (pid {pid}) on display {display or '$DISPLAY'}")
+
+
+def _x_keys(display: str, pid: int, *keys: str) -> None:
+    window = _client_x_window(display, pid)
+    _xdotool(display, "windowfocus", "--sync", window)
+    for key in keys:
+        _xdotool(display, "key", "--clearmodifiers", key)
+
+
+
 @dataclass
 class InspectorPage:
     page_id: str
     connection: Any
     hwnd: int = 0
     target: tuple[int, int] | None = None
-    # Windows with webkit_patch: the connection is the inspector front end, not the page.
+    # patched: the connection is the inspector front end, not the page.
     front_end: bool = False
+    # WebKitGTK front end: the page is reached through this target of the Target domain.
+    page_target: str = ""
+    # Linux console / patched: the HTML field the page belongs to.
+    field_name: str = ""
     console_log: list[dict[str, Any]] = field(default_factory=list)
     url: str = ""
     title: str = ""
@@ -798,12 +926,41 @@ class InspectorPage:
         }
 
 
+HTML_MODES = ("auto", "console", "patched", "remote", "disabled")
+
+
+def resolve_mode(mode: str = "auto") -> str:
+    """The way to reach live pages: auto stays auto on Windows (see check_platform), remote on Linux.
+
+    console (Windows): open the embedded Web Inspector with its hot key and type
+    the loader into its console; patched (Windows): the bridge built into the
+    platform's Web Inspector (webkit_patch); remote (Linux): the WebKitGTK remote
+    inspector of a client started with WEBKIT_INSPECTOR_SERVER.
+    """
+    mode = (mode or "auto").strip().lower()
+    if mode not in HTML_MODES:
+        raise HtmlAgentError(f"Unknown html_mode {mode!r}: use {', '.join(HTML_MODES)}")
+    if mode == "auto":
+        return "auto" if os_support.IS_WINDOWS else "remote"
+    if mode == "remote" and os_support.IS_WINDOWS:
+        raise HtmlAgentError("html_mode=remote is for the Linux client (WebKitGTK); on Windows use console or patched")
+    if mode == "console" and not os_support.IS_WINDOWS:
+        # The docked WebKitGTK inspector is no X11 window: keys sent with XTEST go to the focused widget,
+        # which stays the page (its input field), so the loader would be typed and submitted there.
+        raise HtmlAgentError(
+            "html_mode=console is not available on Linux: keys cannot be routed to the WebKitGTK inspector "
+            "console and would land in the page itself; use patched (nothing is typed) or remote"
+        )
+    return mode
+
+
 class HtmlInspector:
     """A session's page bridge server plus the bookkeeping of the client's WebKit views."""
 
     MAX_ATTEMPTS = 2
 
-    def __init__(self) -> None:
+    def __init__(self, mode: str = "auto") -> None:
+        self.mode = resolve_mode(mode)
         self.port = 0
         self.pages: dict[str, InspectorPage] = {}
         self.desktop = ""
@@ -820,8 +977,13 @@ class HtmlInspector:
         self._attempts: dict[int, int] = {}
         self._open_lock = asyncio.Lock()
         self.last_connect: dict[str, Any] = {}  # Windows: timings of the latest page connection
-        # Linux: the client is started with its WebKit remote inspector server on this port.
-        self.remote_port = 0 if os_support.IS_WINDOWS else free_local_port()
+        # remote: the client is started with its WebKit remote inspector server on this port.
+        self.remote_port = free_local_port() if self.mode == "remote" else 0
+        # Linux console / patched: finds and focuses HTML fields through the test client (set by the server).
+        self.field_driver: Any = None
+        self.overlay_dir: Path | None = None  # Linux patched: the session's G_RESOURCE_OVERLAYS directory
+        self._outer: dict[int, int] = {}  # Target.sendMessageToTarget id -> the inner message id
+        self._field_keys: dict[str, int] = {}
         self._remote: RemoteInspectorClient | None = None
 
     async def start(self) -> int:
@@ -845,16 +1007,42 @@ class HtmlInspector:
         self._tokens.clear()
 
     def client_env(self) -> dict[str, str]:
-        """Environment for the test client: Linux clients serve the WebKit remote inspector."""
-        return {"WEBKIT_INSPECTOR_SERVER": f"127.0.0.1:{self.remote_port}"} if self.remote_port else {}
+        """Environment for the test client: the WebKit remote inspector (remote) or the inspector overlay (Linux patched)."""
+        if self.remote_port:
+            return {"WEBKIT_INSPECTOR_SERVER": f"127.0.0.1:{self.remote_port}"}
+        if self._linux_local() and self.mode == "patched" and self.overlay_dir is not None:
+            write_inspector_strings(self.overlay_dir)
+            return {"G_RESOURCE_OVERLAYS": f"{INSPECTOR_STRINGS_RESOURCE}={self.overlay_dir}"}
+        return {}
+
+    def _linux_local(self) -> bool:
+        return not os_support.IS_WINDOWS and self.mode in {"console", "patched"}
 
     def attach(self, desktop: str, pid: int, client_path: str = "") -> None:
         self.desktop, self.client_pid = desktop, int(pid or 0)
         self.client_bin = str(Path(client_path).parent) if client_path else ""
 
-    def uses_patched_inspector(self) -> bool:
-        """Windows: the client's platform has the current webkit_patch bridge (checked on each use)."""
-        return bool(os_support.IS_WINDOWS and self.client_bin and webkit_patch.is_ready(self.client_bin))
+    def check_platform(self, client_path: str) -> None:
+        """Settle auto for this client's platform; fail early when the chosen mode cannot work with it.
+
+        Windows auto prefers the bridge built into the platform's Web Inspector
+        (webkit_patch) when it is installed and current, and types into the
+        console otherwise.
+        """
+        if self.mode == "auto":
+            self.mode = "patched" if webkit_patch.is_ready(Path(client_path).parent) else "console"
+        if self._linux_local():
+            if not shutil.which("xdotool"):  # Ctrl+Alt+Shift+F12 that opens the inspector
+                raise HtmlAgentError(f"html_mode={self.mode} on Linux needs xdotool (apt install xdotool), or use html_mode=remote")
+            return
+        if self.mode == "patched":
+            bin_dir = Path(client_path).parent
+            if not webkit_patch.is_ready(bin_dir):
+                raise HtmlAgentError(
+                    f"html_mode=patched: the Web Inspector of the platform in {bin_dir} has no current Answer42 bridge; "
+                    f"install it with html_inspector_patch(action='install', version='{bin_dir.parent.name}') "
+                    "(or `answer42 webkit-inspector install`), or use html_mode=console"
+                )
 
     def status(self) -> dict[str, Any]:
         return {
@@ -862,7 +1050,7 @@ class HtmlInspector:
             "running": self._server is not None,
             "pages_alive": sum(1 for p in self.pages.values() if not p.closed),
             **({"remote_inspector_port": self.remote_port} if self.remote_port else {}),
-            **({"patched_inspector": self.uses_patched_inspector()} if os_support.IS_WINDOWS else {}),
+            "mode": self.mode,
             **({"last_connect": self.last_connect} if self.last_connect else {}),
             **({"last_error": self.last_error} if self.last_error else {}),
         }
@@ -917,9 +1105,21 @@ class HtmlInspector:
                         waiting.set_result(message)
                 elif message.get("type") == "message":  # a patched front end relays a protocol reply
                     reply = message.get("message") or {}
-                    waiting = self._pending.pop(reply.get("id"), None)
+                    inner = self._outer.pop(reply.get("id"), None)
+                    if inner is not None:  # the Target.sendMessageToTarget reply: only an error matters
+                        waiting = self._pending.pop(inner, None) if "error" in reply else None
+                    else:
+                        waiting = self._pending.pop(reply.get("id"), None)
                     if waiting is not None and not waiting.done():
                         waiting.set_result(reply)
+                elif message.get("type") == "target":  # WebKitGTK front end: the page target and its changes
+                    event = message.get("message") or {}
+                    params = event.get("params") or {}
+                    info = params.get("targetInfo") or {}
+                    if event.get("method") == "Target.targetCreated" and info.get("type") == "page" and not info.get("isProvisional"):
+                        page.page_target = str(info.get("targetId") or "")
+                    elif event.get("method") == "Target.didCommitProvisionalTarget":
+                        page.page_target = str(params.get("newTargetId") or "")
                 elif message.get("type") == "event":  # ... or a console message
                     params = (message.get("message") or {}).get("params") or {}
                     page.console_log.append(console_entry(params.get("message") or {}))
@@ -942,8 +1142,14 @@ class HtmlInspector:
         message_id = next(self._ids)
         if page.front_end:
             message_id += webkit_patch.BRIDGE_BASE_ID  # the front end relays only ids from BRIDGE_BASE_ID
-            outgoing: dict[str, Any] = {"type": "send", "message": {"id": message_id, "method": "Runtime.evaluate", "params": {
-                "expression": expression, "returnByValue": True, "doNotPauseOnExceptionsAndMuteConsole": True}}}
+            evaluate = {"id": message_id, "method": "Runtime.evaluate", "params": {
+                "expression": expression, "returnByValue": True, "doNotPauseOnExceptionsAndMuteConsole": True}}
+            if page.page_target:
+                outer_id = next(self._ids) + webkit_patch.BRIDGE_BASE_ID
+                self._outer[outer_id] = message_id
+                evaluate = {"id": outer_id, "method": "Target.sendMessageToTarget", "params": {
+                    "targetId": page.page_target, "message": json.dumps(evaluate, ensure_ascii=False)}}
+            outgoing: dict[str, Any] = {"type": "send", "message": evaluate}
         else:
             outgoing = {"id": message_id, "expression": expression}
         future = asyncio.get_running_loop().create_future()
@@ -983,9 +1189,12 @@ class HtmlInspector:
         """Bridge every WebKit view of the client that has no live page yet; return new page ids."""
         if not self.client_pid:
             raise HtmlAgentError("The test client is not running for the HTML page bridge")
-        if not os_support.IS_WINDOWS:
+        if self.mode == "remote":
             async with self._open_lock:
                 return await self._open_remote()
+        if self._linux_local():
+            async with self._open_lock:
+                return await self._open_linux_local()
         async with self._open_lock:
             live = {p.hwnd for p in self.pages.values() if not p.closed}
             opened: list[str] = []
@@ -1032,6 +1241,53 @@ class HtmlInspector:
             opened.append(page.page_id)
         return opened
 
+    async def _open_linux_local(self) -> list[str]:
+        """Linux console / patched: open the inspector of each HTML field of the active form without a live page."""
+        if self.field_driver is None:
+            raise HtmlAgentError("The HTML page bridge cannot reach the test client's form fields")
+        live = {p.field_name for p in self.pages.values() if not p.closed}
+        opened: list[str] = []
+        for name in await self.field_driver.html_fields():
+            key = self._field_keys.setdefault(name, len(self._field_keys) + 1)
+            if name in live or self._attempts.get(key, 0) >= self.MAX_ATTEMPTS:
+                continue
+            page = await self._connect_linux(name, key)
+            if page is not None:
+                opened.append(page.page_id)
+        return opened
+
+    async def _connect_linux(self, name: str, key: int) -> InspectorPage | None:
+        self._attempts[key] = self._attempts.get(key, 0) + 1
+        started = time.monotonic()
+        timings: dict[str, Any] = {"field": name, "mode": self.mode}
+        self.last_connect = timings
+        patched = True  # console is refused on Linux (resolve_mode)
+        token, future = self.expect(key, webkit_patch.INSPECTOR_PATH)
+        try:
+            if self.overlay_dir is not None:
+                await asyncio.to_thread(write_inspector_strings, self.overlay_dir, self.port, token)
+            await self.field_driver.focus(name)
+            await asyncio.to_thread(_x_keys, self.desktop, self.client_pid, LINUX_INSPECTOR_KEYS)
+            page = await asyncio.wait_for(future, PATCHED_CONNECT_SECONDS)
+            for _ in range(60):  # the page target arrives right after the front end connects
+                if page.page_target or page.closed:
+                    break
+                await asyncio.sleep(0.05)
+            timings["connected_seconds"] = round(time.monotonic() - started, 2)
+        except (HtmlAgentError, TimeoutError, OSError, subprocess.SubprocessError) as exc:
+            self.last_error = str(exc) or f"The page of HTML field {name} did not connect within the timeout"
+            LOGGER.warning("%s", self.last_error)
+            return None
+        finally:
+            self._tokens.pop(token, None)
+            if patched and self.overlay_dir is not None:
+                await asyncio.to_thread(write_inspector_strings, self.overlay_dir)
+        page.field_name = name
+        self._attempts.pop(key, None)
+        with suppress(HtmlAgentError):
+            await self.refresh(page)
+        return page
+
     async def _front_end(self, view: int) -> int:
         """The docked inspector front end of ``view``, opening the inspector when needed."""
         views = set(await self._views())
@@ -1080,14 +1336,20 @@ class HtmlInspector:
         started = time.monotonic()
         timings: dict[str, Any] = {"view": view, "typed": 0}
         self.last_connect = timings
-        if view not in self._front_ends and self.uses_patched_inspector():
+        if self.mode == "patched":
+            if view in self._front_ends and self._front_ends[view] in set(await self._views()):
+                self.last_error = (f"The inspector of WebKit view {view} is open without the Answer42 bridge "
+                                   "(it was opened before or its bridge closed): close it and call again")
+                return None
             patched = await self._connect_patched(view, timings)
-            if patched is not None:
-                self._attempts.pop(view, None)
-                with suppress(HtmlAgentError):
-                    await self.refresh(patched)
-                return patched
-            # The inspector is open now (or failed to open): fall back to the console loader.
+            if patched is None:
+                self.last_error = str(timings.get("patched_error") or "the patched inspector did not connect")
+                LOGGER.warning("%s", self.last_error)
+                return None
+            self._attempts.pop(view, None)
+            with suppress(HtmlAgentError):
+                await self.refresh(patched)
+            return patched
         token, future = self.expect(view)
         try:
             front_end = await self._front_end(view)