@diegosouzacdv/jev-browser-mcp 0.6.0 → 0.6.1

package/README.md

@@ -17,7 +17,7 @@ versão em produção, use o número explícito no argumento do pacote:
   "mcpServers": {
     "jev-browser": {
       "command": "npx",
-      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.6.0"],
+      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.6.1"],
       "env": {
         "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
         "JEV_BROWSER_MODE": "computer"
@@ -32,7 +32,7 @@ um secret manager ou pelo ambiente do processo; não grave a chave no arquivo
 de configuração. Para instalar no projeto Node do próprio harness:
 
 ```sh
-npm install @diegosouzacdv/jev-browser-mcp
+npm install @diegosouzacdv/jev-browser-mcp@0.6.1
 ```
 
 Se o harness executa o MCP repetidamente nesta máquina, instale uma versão
@@ -40,7 +40,7 @@ fixa globalmente para evitar a resolução e o download feitos pelo `npx` em cad
 inicialização:
 
 ```sh
-npm install --global @diegosouzacdv/jev-browser-mcp@0.6.0
+npm install --global @diegosouzacdv/jev-browser-mcp@0.6.1
 ```
 
 Depois configure o servidor MCP com `command: "jev-browser-mcp"` e `args: []`.
@@ -49,7 +49,7 @@ Para atualizar, rode `npm install --global
 
 O padrão `computer` exige Chrome ou Edge instalado. Se optar por `harness`,
 configure `JEV_BROWSER_MODE=harness` antes de instalar o navegador gerenciado
-pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp --install-browser`.
+pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp@0.6.1 --install-browser`.
 
 O padrão é `computer`: o pacote abre o Chrome/Edge instalado e usa um perfil
 persistente exclusivo em `browser.computer_user_data_dir`. No modo `harness`, a
@@ -92,7 +92,13 @@ Playwright. O transporte MCP usa `stdio`; toda saída de diagnóstico vai para
 O modo `computer` grava cookies no perfil exclusivo configurado, e conteúdo da
 página pode conter instruções maliciosas. O Jev recebe a captura acessível com
 uma instrução para tratar esse conteúdo como dado não confiável; não inclua
-segredos no fluxo, no resultado esperado ou nas descrições dos planos.
+segredos no fluxo, no resultado esperado ou nas descrições dos planos. Antes de
+enviar contexto ao provedor, o cliente mascara valores de campos e padrões
+detectados de CPF/CNPJ, email, telefone, nome de cliente e valores monetários.
+Isso reduz exposição acidental, mas não substitui o cuidado com os dados que o
+harness escolhe incluir no fluxo. Use `local_only: true` quando nenhuma chamada
+externa ao Jev puder ocorrer; esse modo recusa fluxos que precisam escolher
+entre vários planos.
 
 Para um fluxo conhecido, o LLM do harness procura o cenário e os critérios de
 aceitação no projeto e chama `jev_browser.run_browser_flow` com planos
@@ -148,17 +154,24 @@ Cada plano pode usar:
 
 As proteções e evidências por etapa usam estes campos:
 
-- `confirm_dialog` recebe `expected_text` e `button`. O MCP exige um diálogo
-  visível único e confere se ele contém o texto esperado antes de clicar; se o
-  alerta mudou, a etapa falha sem clicar no botão. Reserve `click` comum para
-  ações que não dependem do conteúdo de uma confirmação;
+- `confirm_dialog` recebe `expected_text` e `button`. Em diálogos HTML, o MCP
+  confere o texto antes de localizar e clicar no botão. Também trata diálogos
+  nativos `alert`/`confirm`: precisa haver uma etapa `confirm_dialog` logo após
+  o clique que os abre, o texto deve corresponder e um diálogo inesperado é
+  fechado sem aceitar;
 - `mutating: true` marca etapas que gravam dados ou disparam efeitos externos.
-  Com `options.dry_run: true`, o fluxo para imediatamente antes da primeira
-  etapa marcada e retorna `dry_run_stopped_before_step` e `mutating_steps`.
-  Marque toda ação que grava ou envia algo, mesmo quando não for um botão
-  chamado Salvar;
+  O MCP também classifica botões conhecidos como `Salvar`, `Emitir`, `Cancelar`
+  ou `Sim` pelo nome e pelo controle resolvido, inclusive quando o plano usa um
+  seletor CSS. `options.dry_run: true` executa até a primeira etapa mutável e
+  para antes dela; retorna `dry_run_stopped_before_step` e um
+  `confirmation_token` temporário, de uso único e vinculado ao fluxo e à página.
+  Reenvie a mesma chamada com `options.confirmation_token` para autorizar essa
+  etapa. O MCP pausa novamente antes de cada outra etapa mutável. Sem `dry_run`,
+  o primeiro pedido de ação mutável também retorna `status: "confirmation_required"`
+  e token; nenhuma etapa mutável roda sem essa autorização. O token expira após
+  dez minutos por padrão;
 - `duration_ms` aparece em cada etapa concluída ou falha. `mutating_steps`
-  lista as etapas marcadas e informa quais foram executadas;
+  lista etapas mutáveis que foram executadas ou falharam;
 - `screenshot: true` salva uma captura depois da etapa e inclui seu caminho na
   evidência da etapa;
 - `options.report_path` grava um resumo `.md` ou JUnit `.xml`. O caminho deve
@@ -210,6 +223,17 @@ ocorrência zero-based dentro desse escopo; sem `index`, o MCP exige exatamente
 um alvo. Para uma página com rótulo `for` quebrado, `label` também procura o
 controle próximo ao texto visível do rótulo.
 
+`within` pode combinar um container e uma linha. Use, por exemplo,
+`{"role":"cell","name":"Documento A","within":{"role":"table","row_containing_word":"1528721"}}`.
+`row_containing_word` usa limites de palavra para não confundir `1528721` com
+`15287210`; `row_containing_exact` continua disponível para texto de célula
+exato. `check` e `uncheck` alteram checkboxes, e `select_option` aceita rótulo
+exato (`option`), valor (`value`) ou rótulo parcial único (`label_contains`).
+`navigate_menu` percorre uma lista de rótulos exatos e abre `#open_btn` quando o
+primeiro item ainda está oculto. Se vários itens visíveis tiverem o mesmo
+rótulo, seleciona a última ocorrência, útil quando o submenu recém-aberto
+repete o nome da categoria pai.
+
 ```json
 {
   "action": "click",
@@ -429,11 +453,13 @@ limita quantas descrições de violações axe entram no resultado; a contagem t
 continua informada mesmo quando a lista é truncada.
 
 O `run_browser_flow` aceita `options` com `fast_path`, `snapshot_scope`,
-`block_trackers`, `capture_console_errors`, `capture_network_errors`,
-`capture_network_error_bodies`, `ready_timeout_seconds`, `ready_network_idle`,
-`ready_stable_ms`, `ready_text`, `continue_from_current_page`, `reuse_page`, `screenshot_on_failure`,
-`trace_on_failure`, `snapshot_include_hidden`, `stop_on_expected`, `dry_run` e
-`report_path`. Sem override,
+`block_trackers`, `block_fonts`, `local_only`, `busy_selectors`,
+`auto_angular_idle`, `login_url_contains`, `login_text`, `capture_console_errors`,
+`capture_network_errors`, `capture_network_error_bodies`, `ready_timeout_seconds`,
+`ready_network_idle`, `ready_stable_ms`, `ready_text`, `continue_from_current_page`,
+`reuse_page`, `step_timeout_seconds`, `max_flow_steps`, `return_snapshot`,
+`screenshot_on_failure`, `trace_on_failure`, `snapshot_include_hidden`,
+`stop_on_expected`, `dry_run`, `confirmation_token` e `report_path`. Sem override,
 os padrões são lidos de `jev_browser_mcp` em
 `config/ui-testing.json`: um plano candidato pula a chamada Decisions;
 captura de console e screenshot de falha ficam ligadas; trace, rede e bloqueio
@@ -446,12 +472,22 @@ sem esperar novamente por `load`/`networkidle`. As etapas continuam aguardando
 seus próprios alvos e condições. `reuse_page` segue como alias legado; defina
 `continue_from_current_page: false` para iniciar cada chamada em `initial_url`.
 Se a página atual e `initial_url` tiverem origens diferentes, o MCP navega para
-`initial_url`. `snapshot_scope` aceita `body`, `main` ou `dialog`; se `main` não
-existir, o snapshot usa `body`.
-
-`block_trackers: true` bloqueia os domínios e tipos de recurso listados na
-configuração (analytics, Hotjar, fontes externas e mídia). Isso pode alterar o
-layout ou o comportamento do site, então a opção é desligada por padrão.
+`initial_url`. Se forem da mesma origem, continua a página atual e avisa quando
+as URLs completas forem diferentes. `snapshot_scope` aceita `body`, `main` ou
+`dialog`; se `main` não existir, o snapshot usa `body`.
+
+`block_trackers: true` bloqueia analytics/trackers e os tipos de recurso
+configurados. Fontes ficam habilitadas por padrão para preservar ícones e
+glyphs; `block_fonts: true` bloqueia fontes separadamente. `busy_selectors`
+complementa `aria-busy="true"` ao aguardar overlays de carregamento.
+`auto_angular_idle` aguarda AngularJS depois de cliques e digitação quando a
+página expõe o injector. `login_url_contains` e `login_text` substituem a
+detecção padrão de autenticação. `local_only: true` recusa qualquer etapa que
+precisaria chamar o provedor Jev; use exatamente um plano com `fast_path: true`.
+`step_timeout_seconds` define o timeout padrão por etapa e cada etapa pode
+substituí-lo com `timeout_seconds`. `max_flow_steps` reduz o limite por chamada,
+sem superar o teto da configuração. `return_snapshot` aceita `full`, `diff` ou
+`none`; `diff` retorna linhas acessíveis novas desde o snapshot inicial.
 
 Com `capture_console_errors` e `capture_network_errors`, o retorno traz
 `console_errors` e `network_failures`, limitados em quantidade e tamanho.
@@ -482,7 +518,10 @@ Chrome/Edge; em outros sistemas, usa o `SingletonLock` do Chromium. Configure
 Resultados MCP incluem `server_version`; erros também começam com a versão do
 servidor para facilitar a comparação entre instalações. A ferramenta
 `browser_health` informa se a sessão está ativa e tenta reconectar um browser
-que encerrou desde a chamada anterior.
+que encerrou desde a chamada anterior. Passe `{"restart":true}` para fechar e
+reiniciar somente o navegador administrado por este processo MCP. Um fluxo pode
+ser repetido automaticamente uma vez após `BROWSER_DISCONNECTED` quando nenhuma
+etapa mutável foi executada.
 
 `harness_browser` e `computer_browser` aceitam `chrome` ou `msedge`.
 `computer_user_data_dir` deve ficar fora do repositório e conter `{browser}`;

package/config/ui-testing.json

@@ -23,6 +23,7 @@
   "jev_browser_mcp": {
     "browser": {
       "max_action_timeout_seconds": 8,
+      "mutation_confirmation_ttl_seconds": 600,
       "ready_timeout_seconds_default": 15,
       "max_ready_timeout_seconds": 60,
       "ready_network_idle_default": true,
@@ -56,6 +57,14 @@
       "capture_console_errors_default": true,
       "capture_network_errors_default": false,
       "block_trackers_default": false,
+      "block_fonts_default": false,
+      "local_only_default": false,
+      "auto_angular_idle_default": false,
+      "return_snapshot_default": "full",
+      "busy_selectors_default": [],
+      "login_url_contains_default": ["/auth"],
+      "login_text_default": [],
+      "max_busy_selectors": 8,
       "snapshot_scope_default": "body",
       "tracker_host_suffixes": [
         "google-analytics.com",
@@ -64,7 +73,7 @@
         "fonts.googleapis.com",
         "fonts.gstatic.com"
       ],
-      "blocked_resource_types": ["font", "media"]
+      "blocked_resource_types": ["media"]
     },
     "jev": {
       "max_diagnostic_items": 50,

package/docs/jev-browser-mcp.md

@@ -17,7 +17,7 @@ versão em produção, use o número explícito no argumento do pacote:
   "mcpServers": {
     "jev-browser": {
       "command": "npx",
-      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.6.0"],
+      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.6.1"],
       "env": {
         "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
         "JEV_BROWSER_MODE": "computer"
@@ -32,7 +32,7 @@ um secret manager ou pelo ambiente do processo; não grave a chave no arquivo
 de configuração. Para instalar no projeto Node do próprio harness:
 
 ```sh
-npm install @diegosouzacdv/jev-browser-mcp
+npm install @diegosouzacdv/jev-browser-mcp@0.6.1
 ```
 
 Se o harness executa o MCP repetidamente nesta máquina, instale uma versão
@@ -40,7 +40,7 @@ fixa globalmente para evitar a resolução e o download feitos pelo `npx` em cad
 inicialização:
 
 ```sh
-npm install --global @diegosouzacdv/jev-browser-mcp@0.6.0
+npm install --global @diegosouzacdv/jev-browser-mcp@0.6.1
 ```
 
 Depois configure o servidor MCP com `command: "jev-browser-mcp"` e `args: []`.
@@ -49,7 +49,7 @@ Para atualizar, rode `npm install --global
 
 O padrão `computer` exige Chrome ou Edge instalado. Se optar por `harness`,
 configure `JEV_BROWSER_MODE=harness` antes de instalar o navegador gerenciado
-pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp --install-browser`.
+pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp@0.6.1 --install-browser`.
 
 O padrão é `computer`: o pacote abre o Chrome/Edge instalado e usa um perfil
 persistente exclusivo em `browser.computer_user_data_dir`. No modo `harness`, a
@@ -92,7 +92,13 @@ Playwright. O transporte MCP usa `stdio`; toda saída de diagnóstico vai para
 O modo `computer` grava cookies no perfil exclusivo configurado, e conteúdo da
 página pode conter instruções maliciosas. O Jev recebe a captura acessível com
 uma instrução para tratar esse conteúdo como dado não confiável; não inclua
-segredos no fluxo, no resultado esperado ou nas descrições dos planos.
+segredos no fluxo, no resultado esperado ou nas descrições dos planos. Antes de
+enviar contexto ao provedor, o cliente mascara valores de campos e padrões
+detectados de CPF/CNPJ, email, telefone, nome de cliente e valores monetários.
+Isso reduz exposição acidental, mas não substitui o cuidado com os dados que o
+harness escolhe incluir no fluxo. Use `local_only: true` quando nenhuma chamada
+externa ao Jev puder ocorrer; esse modo recusa fluxos que precisam escolher
+entre vários planos.
 
 Para um fluxo conhecido, o LLM do harness procura o cenário e os critérios de
 aceitação no projeto e chama `jev_browser.run_browser_flow` com planos
@@ -148,17 +154,24 @@ Cada plano pode usar:
 
 As proteções e evidências por etapa usam estes campos:
 
-- `confirm_dialog` recebe `expected_text` e `button`. O MCP exige um diálogo
-  visível único e confere se ele contém o texto esperado antes de clicar; se o
-  alerta mudou, a etapa falha sem clicar no botão. Reserve `click` comum para
-  ações que não dependem do conteúdo de uma confirmação;
+- `confirm_dialog` recebe `expected_text` e `button`. Em diálogos HTML, o MCP
+  confere o texto antes de localizar e clicar no botão. Também trata diálogos
+  nativos `alert`/`confirm`: precisa haver uma etapa `confirm_dialog` logo após
+  o clique que os abre, o texto deve corresponder e um diálogo inesperado é
+  fechado sem aceitar;
 - `mutating: true` marca etapas que gravam dados ou disparam efeitos externos.
-  Com `options.dry_run: true`, o fluxo para imediatamente antes da primeira
-  etapa marcada e retorna `dry_run_stopped_before_step` e `mutating_steps`.
-  Marque toda ação que grava ou envia algo, mesmo quando não for um botão
-  chamado Salvar;
+  O MCP também classifica botões conhecidos como `Salvar`, `Emitir`, `Cancelar`
+  ou `Sim` pelo nome e pelo controle resolvido, inclusive quando o plano usa um
+  seletor CSS. `options.dry_run: true` executa até a primeira etapa mutável e
+  para antes dela; retorna `dry_run_stopped_before_step` e um
+  `confirmation_token` temporário, de uso único e vinculado ao fluxo e à página.
+  Reenvie a mesma chamada com `options.confirmation_token` para autorizar essa
+  etapa. O MCP pausa novamente antes de cada outra etapa mutável. Sem `dry_run`,
+  o primeiro pedido de ação mutável também retorna `status: "confirmation_required"`
+  e token; nenhuma etapa mutável roda sem essa autorização. O token expira após
+  dez minutos por padrão;
 - `duration_ms` aparece em cada etapa concluída ou falha. `mutating_steps`
-  lista as etapas marcadas e informa quais foram executadas;
+  lista etapas mutáveis que foram executadas ou falharam;
 - `screenshot: true` salva uma captura depois da etapa e inclui seu caminho na
   evidência da etapa;
 - `options.report_path` grava um resumo `.md` ou JUnit `.xml`. O caminho deve
@@ -210,6 +223,17 @@ ocorrência zero-based dentro desse escopo; sem `index`, o MCP exige exatamente
 um alvo. Para uma página com rótulo `for` quebrado, `label` também procura o
 controle próximo ao texto visível do rótulo.
 
+`within` pode combinar um container e uma linha. Use, por exemplo,
+`{"role":"cell","name":"Documento A","within":{"role":"table","row_containing_word":"1528721"}}`.
+`row_containing_word` usa limites de palavra para não confundir `1528721` com
+`15287210`; `row_containing_exact` continua disponível para texto de célula
+exato. `check` e `uncheck` alteram checkboxes, e `select_option` aceita rótulo
+exato (`option`), valor (`value`) ou rótulo parcial único (`label_contains`).
+`navigate_menu` percorre uma lista de rótulos exatos e abre `#open_btn` quando o
+primeiro item ainda está oculto. Se vários itens visíveis tiverem o mesmo
+rótulo, seleciona a última ocorrência, útil quando o submenu recém-aberto
+repete o nome da categoria pai.
+
 ```json
 {
   "action": "click",
@@ -429,11 +453,13 @@ limita quantas descrições de violações axe entram no resultado; a contagem t
 continua informada mesmo quando a lista é truncada.
 
 O `run_browser_flow` aceita `options` com `fast_path`, `snapshot_scope`,
-`block_trackers`, `capture_console_errors`, `capture_network_errors`,
-`capture_network_error_bodies`, `ready_timeout_seconds`, `ready_network_idle`,
-`ready_stable_ms`, `ready_text`, `continue_from_current_page`, `reuse_page`, `screenshot_on_failure`,
-`trace_on_failure`, `snapshot_include_hidden`, `stop_on_expected`, `dry_run` e
-`report_path`. Sem override,
+`block_trackers`, `block_fonts`, `local_only`, `busy_selectors`,
+`auto_angular_idle`, `login_url_contains`, `login_text`, `capture_console_errors`,
+`capture_network_errors`, `capture_network_error_bodies`, `ready_timeout_seconds`,
+`ready_network_idle`, `ready_stable_ms`, `ready_text`, `continue_from_current_page`,
+`reuse_page`, `step_timeout_seconds`, `max_flow_steps`, `return_snapshot`,
+`screenshot_on_failure`, `trace_on_failure`, `snapshot_include_hidden`,
+`stop_on_expected`, `dry_run`, `confirmation_token` e `report_path`. Sem override,
 os padrões são lidos de `jev_browser_mcp` em
 `config/ui-testing.json`: um plano candidato pula a chamada Decisions;
 captura de console e screenshot de falha ficam ligadas; trace, rede e bloqueio
@@ -446,12 +472,22 @@ sem esperar novamente por `load`/`networkidle`. As etapas continuam aguardando
 seus próprios alvos e condições. `reuse_page` segue como alias legado; defina
 `continue_from_current_page: false` para iniciar cada chamada em `initial_url`.
 Se a página atual e `initial_url` tiverem origens diferentes, o MCP navega para
-`initial_url`. `snapshot_scope` aceita `body`, `main` ou `dialog`; se `main` não
-existir, o snapshot usa `body`.
-
-`block_trackers: true` bloqueia os domínios e tipos de recurso listados na
-configuração (analytics, Hotjar, fontes externas e mídia). Isso pode alterar o
-layout ou o comportamento do site, então a opção é desligada por padrão.
+`initial_url`. Se forem da mesma origem, continua a página atual e avisa quando
+as URLs completas forem diferentes. `snapshot_scope` aceita `body`, `main` ou
+`dialog`; se `main` não existir, o snapshot usa `body`.
+
+`block_trackers: true` bloqueia analytics/trackers e os tipos de recurso
+configurados. Fontes ficam habilitadas por padrão para preservar ícones e
+glyphs; `block_fonts: true` bloqueia fontes separadamente. `busy_selectors`
+complementa `aria-busy="true"` ao aguardar overlays de carregamento.
+`auto_angular_idle` aguarda AngularJS depois de cliques e digitação quando a
+página expõe o injector. `login_url_contains` e `login_text` substituem a
+detecção padrão de autenticação. `local_only: true` recusa qualquer etapa que
+precisaria chamar o provedor Jev; use exatamente um plano com `fast_path: true`.
+`step_timeout_seconds` define o timeout padrão por etapa e cada etapa pode
+substituí-lo com `timeout_seconds`. `max_flow_steps` reduz o limite por chamada,
+sem superar o teto da configuração. `return_snapshot` aceita `full`, `diff` ou
+`none`; `diff` retorna linhas acessíveis novas desde o snapshot inicial.
 
 Com `capture_console_errors` e `capture_network_errors`, o retorno traz
 `console_errors` e `network_failures`, limitados em quantidade e tamanho.
@@ -482,7 +518,10 @@ Chrome/Edge; em outros sistemas, usa o `SingletonLock` do Chromium. Configure
 Resultados MCP incluem `server_version`; erros também começam com a versão do
 servidor para facilitar a comparação entre instalações. A ferramenta
 `browser_health` informa se a sessão está ativa e tenta reconectar um browser
-que encerrou desde a chamada anterior.
+que encerrou desde a chamada anterior. Passe `{"restart":true}` para fechar e
+reiniciar somente o navegador administrado por este processo MCP. Um fluxo pode
+ser repetido automaticamente uma vez após `BROWSER_DISCONNECTED` quando nenhuma
+etapa mutável foi executada.
 
 `harness_browser` e `computer_browser` aceitam `chrome` ou `msedge`.
 `computer_user_data_dir` deve ficar fora do repositório e conter `{browser}`;

package/mcp_servers/jev-browser-npm/src/config.mjs

@@ -16,23 +16,24 @@ const CONFIG_KEYS = {
     "max_flow_steps",
     "max_text_entry_chars",
   ],
-  nodeBrowser: [
-    "max_action_timeout_seconds",
-    "ready_timeout_seconds_default",
-    "max_ready_timeout_seconds",
-    "ready_network_idle_default",
-    "ready_stable_ms_default",
-    "max_ready_stable_ms",
-    "post_step_ready_timeout_seconds_default",
-    "max_step_timeout_seconds",
-    "key_delay_ms_default",
-    "reuse_page_default",
-    "stop_on_expected_default",
-    "snapshot_include_hidden_default",
-    "visibility_poll_interval_ms_default",
-    "capture_network_error_bodies_default",
-    "max_network_error_body_bytes",
-    "max_network_error_message_chars",
+  nodeBrowser: [
+    "max_action_timeout_seconds",
+    "mutation_confirmation_ttl_seconds",
+    "ready_timeout_seconds_default",
+    "max_ready_timeout_seconds",
+    "ready_network_idle_default",
+    "ready_stable_ms_default",
+    "max_ready_stable_ms",
+    "post_step_ready_timeout_seconds_default",
+    "max_step_timeout_seconds",
+    "key_delay_ms_default",
+    "reuse_page_default",
+    "stop_on_expected_default",
+    "snapshot_include_hidden_default",
+    "visibility_poll_interval_ms_default",
+    "capture_network_error_bodies_default",
+    "max_network_error_body_bytes",
+    "max_network_error_message_chars",
     "max_upload_files",
     "max_upload_path_chars",
     "max_upload_file_bytes",
@@ -51,6 +52,14 @@ const CONFIG_KEYS = {
     "capture_console_errors_default",
     "capture_network_errors_default",
     "block_trackers_default",
+    "block_fonts_default",
+    "local_only_default",
+    "auto_angular_idle_default",
+    "return_snapshot_default",
+    "busy_selectors_default",
+    "login_url_contains_default",
+    "login_text_default",
+    "max_busy_selectors",
     "snapshot_scope_default",
     "tracker_host_suffixes",
     "blocked_resource_types",
@@ -221,7 +230,7 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
   const uploadRoot = configuredUploadRoot
     ? configuredDirectory(configuredUploadRoot, `environment ${uploadRootEnv}`)
     : null;
-  const snapshotScope = browserOptions.snapshot_scope_default;
+  const snapshotScope = browserOptions.snapshot_scope_default;
   if (!new Set(["body", "main", "dialog"]).has(snapshotScope)) {
     throw new JevBrowserError("config/ui-testing.json jev_browser_mcp.browser.snapshot_scope_default must be body, main, or dialog");
   }
@@ -230,28 +239,46 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
     "jev_browser_mcp.browser.tracker_host_suffixes",
     (host) => /^[a-z0-9.-]+$/i.test(host) && !host.startsWith(".") && !host.endsWith("."),
   );
-  const blockedResourceTypes = stringList(
+  const blockedResourceTypes = stringList(
     browserOptions.blocked_resource_types,
     "jev_browser_mcp.browser.blocked_resource_types",
     (type) => new Set(["font", "media", "image"]).has(type),
-  );
-  const maxReadyTimeoutSeconds = positiveNumber(browserOptions.max_ready_timeout_seconds, "jev_browser_mcp.browser.max_ready_timeout_seconds");
-  const readyTimeoutSecondsDefault = positiveNumber(browserOptions.ready_timeout_seconds_default, "jev_browser_mcp.browser.ready_timeout_seconds_default");
-  const maxReadyStableMs = positiveNumber(browserOptions.max_ready_stable_ms, "jev_browser_mcp.browser.max_ready_stable_ms", true);
-  const readyStableMsDefault = positiveNumber(browserOptions.ready_stable_ms_default, "jev_browser_mcp.browser.ready_stable_ms_default", true);
-  if (readyTimeoutSecondsDefault > maxReadyTimeoutSeconds) {
-    throw new JevBrowserError("config/ui-testing.json ready timeout default exceeds its configured maximum");
-  }
-  if (readyStableMsDefault > maxReadyStableMs) {
-    throw new JevBrowserError("config/ui-testing.json stable snapshot default exceeds its configured maximum");
-  }
-  const postStepReadyTimeoutSeconds = positiveNumber(
-    browserOptions.post_step_ready_timeout_seconds_default,
-    "jev_browser_mcp.browser.post_step_ready_timeout_seconds_default",
-  );
-  if (postStepReadyTimeoutSeconds > maxReadyTimeoutSeconds) {
-    throw new JevBrowserError("config/ui-testing.json post-step readiness timeout exceeds its configured maximum");
-  }
+  );
+  const busySelectorsDefault = stringList(
+    browserOptions.busy_selectors_default,
+    "jev_browser_mcp.browser.busy_selectors_default",
+  );
+  if (busySelectorsDefault.length > positiveNumber(browserOptions.max_busy_selectors, "jev_browser_mcp.browser.max_busy_selectors", true)) {
+    throw new JevBrowserError("config/ui-testing.json busy_selectors_default exceeds max_busy_selectors");
+  }
+  const loginUrlContainsDefault = stringList(
+    browserOptions.login_url_contains_default,
+    "jev_browser_mcp.browser.login_url_contains_default",
+  );
+  const loginTextDefault = stringList(
+    browserOptions.login_text_default,
+    "jev_browser_mcp.browser.login_text_default",
+  );
+  if (!new Set(["none", "diff", "full"]).has(browserOptions.return_snapshot_default)) {
+    throw new JevBrowserError("config/ui-testing.json return_snapshot_default must be none, diff, or full");
+  }
+  const maxReadyTimeoutSeconds = positiveNumber(browserOptions.max_ready_timeout_seconds, "jev_browser_mcp.browser.max_ready_timeout_seconds");
+  const readyTimeoutSecondsDefault = positiveNumber(browserOptions.ready_timeout_seconds_default, "jev_browser_mcp.browser.ready_timeout_seconds_default");
+  const maxReadyStableMs = positiveNumber(browserOptions.max_ready_stable_ms, "jev_browser_mcp.browser.max_ready_stable_ms", true);
+  const readyStableMsDefault = positiveNumber(browserOptions.ready_stable_ms_default, "jev_browser_mcp.browser.ready_stable_ms_default", true);
+  if (readyTimeoutSecondsDefault > maxReadyTimeoutSeconds) {
+    throw new JevBrowserError("config/ui-testing.json ready timeout default exceeds its configured maximum");
+  }
+  if (readyStableMsDefault > maxReadyStableMs) {
+    throw new JevBrowserError("config/ui-testing.json stable snapshot default exceeds its configured maximum");
+  }
+  const postStepReadyTimeoutSeconds = positiveNumber(
+    browserOptions.post_step_ready_timeout_seconds_default,
+    "jev_browser_mcp.browser.post_step_ready_timeout_seconds_default",
+  );
+  if (postStepReadyTimeoutSeconds > maxReadyTimeoutSeconds) {
+    throw new JevBrowserError("config/ui-testing.json post-step readiness timeout exceeds its configured maximum");
+  }
 
   return Object.freeze({
     env,
@@ -261,15 +288,16 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
       profileDir: profileDirectory(profileTemplate, channel, env.JEV_BROWSER_PROFILE),
       maxFlowSteps: positiveNumber(document.browser.max_flow_steps, "browser.max_flow_steps", true),
       maxTextEntryChars: positiveNumber(document.browser.max_text_entry_chars, "browser.max_text_entry_chars", true),
-      actionTimeoutMs: positiveNumber(browserOptions.max_action_timeout_seconds, "jev_browser_mcp.browser.max_action_timeout_seconds") * 1000,
-      maxReadyTimeoutSeconds,
-      maxReadyStableMs,
-      postStepReadyTimeoutMs: postStepReadyTimeoutSeconds * 1000,
-      maxStepTimeoutSeconds: positiveNumber(browserOptions.max_step_timeout_seconds, "jev_browser_mcp.browser.max_step_timeout_seconds"),
-      keyDelayMs: positiveNumber(browserOptions.key_delay_ms_default, "jev_browser_mcp.browser.key_delay_ms_default", true),
-      visibilityPollMs: positiveNumber(browserOptions.visibility_poll_interval_ms_default, "jev_browser_mcp.browser.visibility_poll_interval_ms_default", true),
-      maxNetworkErrorBodyBytes: positiveNumber(browserOptions.max_network_error_body_bytes, "jev_browser_mcp.browser.max_network_error_body_bytes", true),
-      maxNetworkErrorMessageChars: positiveNumber(browserOptions.max_network_error_message_chars, "jev_browser_mcp.browser.max_network_error_message_chars", true),
+      actionTimeoutMs: positiveNumber(browserOptions.max_action_timeout_seconds, "jev_browser_mcp.browser.max_action_timeout_seconds") * 1000,
+      mutationConfirmationTtlMs: positiveNumber(browserOptions.mutation_confirmation_ttl_seconds, "jev_browser_mcp.browser.mutation_confirmation_ttl_seconds") * 1000,
+      maxReadyTimeoutSeconds,
+      maxReadyStableMs,
+      postStepReadyTimeoutMs: postStepReadyTimeoutSeconds * 1000,
+      maxStepTimeoutSeconds: positiveNumber(browserOptions.max_step_timeout_seconds, "jev_browser_mcp.browser.max_step_timeout_seconds"),
+      keyDelayMs: positiveNumber(browserOptions.key_delay_ms_default, "jev_browser_mcp.browser.key_delay_ms_default", true),
+      visibilityPollMs: positiveNumber(browserOptions.visibility_poll_interval_ms_default, "jev_browser_mcp.browser.visibility_poll_interval_ms_default", true),
+      maxNetworkErrorBodyBytes: positiveNumber(browserOptions.max_network_error_body_bytes, "jev_browser_mcp.browser.max_network_error_body_bytes", true),
+      maxNetworkErrorMessageChars: positiveNumber(browserOptions.max_network_error_message_chars, "jev_browser_mcp.browser.max_network_error_message_chars", true),
       maxUploadFiles: positiveNumber(browserOptions.max_upload_files, "jev_browser_mcp.browser.max_upload_files", true),
       maxUploadPathChars: positiveNumber(browserOptions.max_upload_path_chars, "jev_browser_mcp.browser.max_upload_path_chars", true),
       maxUploadFileBytes: positiveNumber(browserOptions.max_upload_file_bytes, "jev_browser_mcp.browser.max_upload_file_bytes", true),
@@ -286,19 +314,27 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
         screenshotOnFailure: booleanValue(browserOptions.screenshot_on_failure_default, "jev_browser_mcp.browser.screenshot_on_failure_default"),
         traceOnFailure: booleanValue(browserOptions.trace_on_failure_default, "jev_browser_mcp.browser.trace_on_failure_default"),
         captureConsoleErrors: booleanValue(browserOptions.capture_console_errors_default, "jev_browser_mcp.browser.capture_console_errors_default"),
-        captureNetworkErrors: booleanValue(browserOptions.capture_network_errors_default, "jev_browser_mcp.browser.capture_network_errors_default"),
-        captureNetworkErrorBodies: booleanValue(browserOptions.capture_network_error_bodies_default, "jev_browser_mcp.browser.capture_network_error_bodies_default"),
-        blockTrackers: booleanValue(browserOptions.block_trackers_default, "jev_browser_mcp.browser.block_trackers_default"),
-        readyNetworkIdle: booleanValue(browserOptions.ready_network_idle_default, "jev_browser_mcp.browser.ready_network_idle_default"),
-        reusePage: booleanValue(browserOptions.reuse_page_default, "jev_browser_mcp.browser.reuse_page_default"),
-        stopOnExpected: booleanValue(browserOptions.stop_on_expected_default, "jev_browser_mcp.browser.stop_on_expected_default"),
-        snapshotIncludeHidden: booleanValue(browserOptions.snapshot_include_hidden_default, "jev_browser_mcp.browser.snapshot_include_hidden_default"),
-        readyTimeoutSeconds: readyTimeoutSecondsDefault,
-        readyStableMs: readyStableMsDefault,
+        captureNetworkErrors: booleanValue(browserOptions.capture_network_errors_default, "jev_browser_mcp.browser.capture_network_errors_default"),
+        captureNetworkErrorBodies: booleanValue(browserOptions.capture_network_error_bodies_default, "jev_browser_mcp.browser.capture_network_error_bodies_default"),
+        blockTrackers: booleanValue(browserOptions.block_trackers_default, "jev_browser_mcp.browser.block_trackers_default"),
+        blockFonts: booleanValue(browserOptions.block_fonts_default, "jev_browser_mcp.browser.block_fonts_default"),
+        localOnly: booleanValue(browserOptions.local_only_default, "jev_browser_mcp.browser.local_only_default"),
+        autoAngularIdle: booleanValue(browserOptions.auto_angular_idle_default, "jev_browser_mcp.browser.auto_angular_idle_default"),
+        returnSnapshot: browserOptions.return_snapshot_default,
+        readyNetworkIdle: booleanValue(browserOptions.ready_network_idle_default, "jev_browser_mcp.browser.ready_network_idle_default"),
+        reusePage: booleanValue(browserOptions.reuse_page_default, "jev_browser_mcp.browser.reuse_page_default"),
+        stopOnExpected: booleanValue(browserOptions.stop_on_expected_default, "jev_browser_mcp.browser.stop_on_expected_default"),
+        snapshotIncludeHidden: booleanValue(browserOptions.snapshot_include_hidden_default, "jev_browser_mcp.browser.snapshot_include_hidden_default"),
+        readyTimeoutSeconds: readyTimeoutSecondsDefault,
+        readyStableMs: readyStableMsDefault,
         snapshotScope,
       }),
       trackerHostSuffixes: Object.freeze(trackerHostSuffixes),
       blockedResourceTypes: Object.freeze(blockedResourceTypes),
+      busySelectorsDefault: Object.freeze(busySelectorsDefault),
+      loginUrlContainsDefault: Object.freeze(loginUrlContainsDefault),
+      loginTextDefault: Object.freeze(loginTextDefault),
+      maxBusySelectors: positiveNumber(browserOptions.max_busy_selectors, "jev_browser_mcp.browser.max_busy_selectors", true),
     }),
     jev: Object.freeze({
       providerUrl,