@diegosouzacdv/jev-browser-mcp 0.7.0 → 0.7.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.7.0"],
+      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.7.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@0.7.0
+npm install @diegosouzacdv/jev-browser-mcp@0.7.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.7.0
+npm install --global @diegosouzacdv/jev-browser-mcp@0.7.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@0.7.0 --install-browser`.
+pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp@0.7.1 --install-browser`.
 
 O padrão é `computer`: o pacote abre o Chrome/Edge instalado e usa um perfil
 persistente exclusivo por processo MCP em `browser.computer_user_data_dir`. O
@@ -89,8 +89,10 @@ O executável oferece `browser_health`, `describe_actions`, `choose_next_action`
 e `run_browser_flow`, mantém uma sessão do browser por processo e reutiliza
 essa sessão entre chamadas. `browser_health` informa versão, sessão e
 capacidades; `describe_actions` publica o schema atual das ações, opções,
-aliases e placeholders. Consulte essas ferramentas antes de construir um plano
-para evitar nomes de campos desatualizados. O plano
+aliases, placeholders, campos obrigatórios de `flow`/plano e requisitos
+condicionais por ação. `run_browser_flow` agrega campos obrigatórios ausentes
+em todos os planos e etapas antes de abrir o navegador. Consulte essas ferramentas
+antes de construir um plano para evitar nomes de campos desatualizados. O plano
 passado ao Jev continua declarativo: clique, preenchimento, seleção nativa,
 hover, espera, teclas aprovadas, asserções por elemento, upload restrito a uma
 raiz local configurada e reações idempotentes a um comentário único. Também
@@ -174,12 +176,26 @@ Cada plano pode usar:
 - `assert_network` valida resposta HTTP observada (inclusive sucesso 2xx ou erro
   esperado); `wait_for_request` aguarda uma resposta usando `*` como curinga na
   URL e filtros opcionais de método/status; `assert_ws` confere texto, pares
-  JSON esperados ou código de fechamento de WebSocket;
+  JSON esperados ou código de fechamento de WebSocket. `wait_for_request`
+  consulta o histórico desde o começo da chamada, inclusive requisições feitas
+  durante a navegação inicial e dentro de iframes; URLs cobertas por uma
+  asserção ficam retidas mesmo quando a SPA excede o buffer circular;
 - `evaluate` lê somente caminhos de propriedades como `navigator.mediaDevices`,
   `document.readyState` ou `location.pathname`. Não aceita código, chamadas de
   função, armazenamento local ou propriedades de credenciais. Strings e números
   voltam diretamente; objetos e arrays retornam somente tipo, chaves e tamanho,
   sem despejar seus valores;
+- `http_request` executa somente GET com a sessão da página; `inspect_cookies`
+  retorna apenas metadados e valores redigidos; `read_angular_state` devolve o
+  nome do estado e nomes dos parâmetros, sem valores. As três ações exigem
+  `local_only: true` e página em loopback. `http_request` fica restrito à mesma
+  origem, não segue redirecionamentos e limita/redige o corpo opcional;
+- `frame: "first"` seleciona o primeiro iframe; `frame: {"url_contains":"..."}`
+  localiza um iframe pela URL. Uma string diferente continua buscando o nome ou
+  título exato do frame;
+- `navigate_menu` aceita `path` para menus acessíveis ou `screen` para procurar
+  código/nome pela tela Acesso Rápido do SAFI. O segundo caminho usa a interface
+  do SAFI e preserva as verificações de acesso do próprio aplicativo;
 - `new_tab`, `switch_tab` e `new_context` abrem/selecionam abas e criam contexto
   separado dentro do fluxo; `target_page: "popup"` mantém popups abertos para
   passos posteriores;
@@ -271,11 +287,22 @@ incluindo respostas 2xx ou erros esperados como 404. Exemplo:
 Essa asserção aparece na evidência como `response_status`, separado do campo
 `status` da etapa (`passed` ou `failed`). `message_contains` lê somente resposta
 da mesma origem e respeita o limite configurado para captura de corpos.
-`assert_network`, `wait_for_request` e `expected_outcome.request` consultam o
-histórico limitado de respostas depois do marcador da etapa ou do início do
-fluxo. O limite vem de `jev_browser_mcp.browser.max_network_history_events` e
-está em 4096 eventos nesta configuração; assim, chamadas anteriores ao marcador
-não satisfazem a asserção.
+`assert_network` consulta respostas desde o marcador da etapa e usa a resposta
+da navegação inicial como fallback quando nenhuma resposta posterior corresponde.
+`wait_for_request` e `expected_outcome.request` consultam desde o início do fluxo.
+URLs cobertas por uma asserção são retidas em um buffer separado limitado por
+`jev_browser_mcp.browser.max_network_history_events` (4096 eventos nesta
+configuração). A captura de página também observa requisições de iframes.
+Um único plano `fast_path` composto apenas por `assert_network` e
+`wait_for_request` não espera um snapshot visual, então endpoints que respondem
+sem HTML também podem ser verificados. `navigation_http_status` registra um
+status HTTP de erro recebido pela navegação inicial; ele não é uma falha de rede.
+
+`options.capture_network: "all"` inclui até o limite de diagnóstico eventos
+com URL sem query string, método, status, tipo de recurso, duração e cabeçalhos
+de resposta de uma allowlist. `capture_network_url_contains` filtra as URLs.
+Quando o Chromium informa cookies bloqueados, `blocked_cookies` mostra nome,
+domínio, caminho, flags e motivo, sem revelar valores.
 
 Para aguardar a API antes de abrir a interface, passe
 `options.wait_for_http: {"url":"http://localhost:8000/health","timeout_ms":30000}`.
@@ -312,10 +339,38 @@ controle próximo ao texto visível do rótulo.
 `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.
+`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. Para o SAFI, `screen` pesquisa o nome ou código
+na tela Acesso Rápido, exige um resultado único e clica no link oficial da linha;
+por exemplo, `{"action":"navigate_menu","screen":"TCN00022"}`.
+
+Em uma instância local do SAFI, `http_request` pode obter a lista de telas pela
+sessão já aberta sem ler o HTML:
+
+```json
+{
+  "flow": "Consultar telas disponíveis no perfil atual do SAFI",
+  "initial_url": "http://localhost:8011/safi/",
+  "candidate_plans": {
+    "inspect": {
+      "description": "Ler a lista de telas do SAFI no ambiente local",
+      "steps": [{
+        "action": "http_request",
+        "url": "/safi/api/menu/telas_menu",
+        "include_body": true
+      }]
+    }
+  },
+  "options": { "local_only": true, "fast_path": true }
+}
+```
+
+O endpoint usa a sessão atual e pode retornar uma lista específica do perfil.
+Os valores de cookies nunca são retornados. O acesso ao menu continua sujeito
+às permissões verificadas pela própria interface; não use esse diagnóstico
+contra produção.
 
 ```json
 {
@@ -547,12 +602,17 @@ quando nenhuma dessas condições se aplica; confiança do Jev, sozinha, não
 comprova o resultado. `environment_error` identifica falha de
 navegação, autenticação ou sessão do browser; `navigation_error` contém o código
 detectado, como `ERR_CONNECTION_REFUSED`, `AUTHENTICATION_REQUIRED` ou
-`BROWSER_DISCONNECTED`, e `reason` orienta a recuperação. Se uma navegação falhar
+`BROWSER_DISCONNECTED`, `BROWSER_PAGE_NOT_RESTORED` ou
+`BROWSER_PROFILE_IN_USE`, e `reason` orienta a recuperação. Se uma navegação falhar
 e a chamada seguinte tentar reutilizar a página, o MCP informa que a navegação
 anterior não carregou; reinicie a navegação com
 `continue_from_current_page: false` (ou o alias `reuse_page: false`). Uma sessão
-desconectada pode ser reaberta por `browser_health`; o fluxo só é repetido
-automaticamente uma vez se nenhuma etapa mutável tiver sido executada.
+desconectada pode ser reaberta por `browser_health`. `run_browser_flow` também
+tenta reconectar e repetir uma vez quando a desconexão acontece antes da primeira
+etapa; a repetição exige `initial_url`. Sem essa URL, o resultado informa
+`BROWSER_PAGE_NOT_RESTORED`, e chamadas posteriores em `reuse_page` continuam
+recusadas até uma nova navegação explícita. Se qualquer etapa já executou ou
+há token de confirmação de mutação, o MCP não repete o fluxo automaticamente.
 
 `current_url` é devolvido para diagnóstico sem query string nem fragmento; IDs
 longos no caminho também podem ser redigidos. `timings_ms.ready_ms` mede a espera
@@ -584,8 +644,9 @@ continua informada mesmo quando a lista é truncada.
 
 O `run_browser_flow` aceita `options` com `fast_path`, `snapshot_scope`,
 `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`,
+`auto_angular_idle`, `login_url_contains`, `login_text`, `capture_console_errors`,
+`capture_network_errors`, `capture_network_error_bodies`, `capture_network`,
+`capture_network_url_contains`, `ready_timeout_seconds`,
 `ready_network_idle`, `ready_stable_ms`, `ready_text`, `ready`, `continue_from_current_page`,
 `reuse_page`, `reuse_page_match`, `step_timeout_seconds`, `max_flow_steps`, `return_snapshot`,
 `screenshot_on_failure`, `screenshot_on_success`, `trace_on_failure`,
@@ -649,6 +710,8 @@ traz mensagens do console agrupadas por texto e nível (`console_messages` com
 `count`), além de `console_errors` para compatibilidade. `network_failures`
 contém eventos limitados em quantidade e tamanho. Mensagens idênticas do console
 são agrupadas em uma entrada com `count`.
+Controles sem nome acessível aparecem em um único aviso com a contagem e alguns
+exemplos, em vez de gerar uma mensagem por controle.
 Respostas HTTP 4xx/5xx e requisições que falham são listadas; query strings,
 fragmentos, valores de formulário e nomes de arquivo são removidos ou
 sanitizados. `capture_network_error_bodies: true` lê somente respostas JSON
@@ -718,12 +781,12 @@ Chrome/Edge; em outros sistemas, usa o `SingletonLock` do Chromium. O caminho
 padrão já separa processos por PID; configure `JEV_BROWSER_PROFILE` para mudar
 a raiz e `JEV_BROWSER_SESSION_ID` para nomear a instância.
 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. 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.
+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. Passe `{"restart":true}` para fechar e
+reiniciar somente o navegador administrado por este processo MCP. Perfil ocupado
+é devolvido como `BROWSER_PROFILE_IN_USE` com o PID detectado e não provoca
+encerramento do Chrome/Edge existente.
 
 `harness_browser` e `computer_browser` aceitam `chrome` ou `msedge`.
 `computer_user_data_dir` deve ficar fora do repositório e conter `{browser}` e

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.7.0"],
+      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp@0.7.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@0.7.0
+npm install @diegosouzacdv/jev-browser-mcp@0.7.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.7.0
+npm install --global @diegosouzacdv/jev-browser-mcp@0.7.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@0.7.0 --install-browser`.
+pelo Playwright com `npx --yes @diegosouzacdv/jev-browser-mcp@0.7.1 --install-browser`.
 
 O padrão é `computer`: o pacote abre o Chrome/Edge instalado e usa um perfil
 persistente exclusivo por processo MCP em `browser.computer_user_data_dir`. O
@@ -89,8 +89,10 @@ O executável oferece `browser_health`, `describe_actions`, `choose_next_action`
 e `run_browser_flow`, mantém uma sessão do browser por processo e reutiliza
 essa sessão entre chamadas. `browser_health` informa versão, sessão e
 capacidades; `describe_actions` publica o schema atual das ações, opções,
-aliases e placeholders. Consulte essas ferramentas antes de construir um plano
-para evitar nomes de campos desatualizados. O plano
+aliases, placeholders, campos obrigatórios de `flow`/plano e requisitos
+condicionais por ação. `run_browser_flow` agrega campos obrigatórios ausentes
+em todos os planos e etapas antes de abrir o navegador. Consulte essas ferramentas
+antes de construir um plano para evitar nomes de campos desatualizados. O plano
 passado ao Jev continua declarativo: clique, preenchimento, seleção nativa,
 hover, espera, teclas aprovadas, asserções por elemento, upload restrito a uma
 raiz local configurada e reações idempotentes a um comentário único. Também
@@ -174,12 +176,26 @@ Cada plano pode usar:
 - `assert_network` valida resposta HTTP observada (inclusive sucesso 2xx ou erro
   esperado); `wait_for_request` aguarda uma resposta usando `*` como curinga na
   URL e filtros opcionais de método/status; `assert_ws` confere texto, pares
-  JSON esperados ou código de fechamento de WebSocket;
+  JSON esperados ou código de fechamento de WebSocket. `wait_for_request`
+  consulta o histórico desde o começo da chamada, inclusive requisições feitas
+  durante a navegação inicial e dentro de iframes; URLs cobertas por uma
+  asserção ficam retidas mesmo quando a SPA excede o buffer circular;
 - `evaluate` lê somente caminhos de propriedades como `navigator.mediaDevices`,
   `document.readyState` ou `location.pathname`. Não aceita código, chamadas de
   função, armazenamento local ou propriedades de credenciais. Strings e números
   voltam diretamente; objetos e arrays retornam somente tipo, chaves e tamanho,
   sem despejar seus valores;
+- `http_request` executa somente GET com a sessão da página; `inspect_cookies`
+  retorna apenas metadados e valores redigidos; `read_angular_state` devolve o
+  nome do estado e nomes dos parâmetros, sem valores. As três ações exigem
+  `local_only: true` e página em loopback. `http_request` fica restrito à mesma
+  origem, não segue redirecionamentos e limita/redige o corpo opcional;
+- `frame: "first"` seleciona o primeiro iframe; `frame: {"url_contains":"..."}`
+  localiza um iframe pela URL. Uma string diferente continua buscando o nome ou
+  título exato do frame;
+- `navigate_menu` aceita `path` para menus acessíveis ou `screen` para procurar
+  código/nome pela tela Acesso Rápido do SAFI. O segundo caminho usa a interface
+  do SAFI e preserva as verificações de acesso do próprio aplicativo;
 - `new_tab`, `switch_tab` e `new_context` abrem/selecionam abas e criam contexto
   separado dentro do fluxo; `target_page: "popup"` mantém popups abertos para
   passos posteriores;
@@ -271,11 +287,22 @@ incluindo respostas 2xx ou erros esperados como 404. Exemplo:
 Essa asserção aparece na evidência como `response_status`, separado do campo
 `status` da etapa (`passed` ou `failed`). `message_contains` lê somente resposta
 da mesma origem e respeita o limite configurado para captura de corpos.
-`assert_network`, `wait_for_request` e `expected_outcome.request` consultam o
-histórico limitado de respostas depois do marcador da etapa ou do início do
-fluxo. O limite vem de `jev_browser_mcp.browser.max_network_history_events` e
-está em 4096 eventos nesta configuração; assim, chamadas anteriores ao marcador
-não satisfazem a asserção.
+`assert_network` consulta respostas desde o marcador da etapa e usa a resposta
+da navegação inicial como fallback quando nenhuma resposta posterior corresponde.
+`wait_for_request` e `expected_outcome.request` consultam desde o início do fluxo.
+URLs cobertas por uma asserção são retidas em um buffer separado limitado por
+`jev_browser_mcp.browser.max_network_history_events` (4096 eventos nesta
+configuração). A captura de página também observa requisições de iframes.
+Um único plano `fast_path` composto apenas por `assert_network` e
+`wait_for_request` não espera um snapshot visual, então endpoints que respondem
+sem HTML também podem ser verificados. `navigation_http_status` registra um
+status HTTP de erro recebido pela navegação inicial; ele não é uma falha de rede.
+
+`options.capture_network: "all"` inclui até o limite de diagnóstico eventos
+com URL sem query string, método, status, tipo de recurso, duração e cabeçalhos
+de resposta de uma allowlist. `capture_network_url_contains` filtra as URLs.
+Quando o Chromium informa cookies bloqueados, `blocked_cookies` mostra nome,
+domínio, caminho, flags e motivo, sem revelar valores.
 
 Para aguardar a API antes de abrir a interface, passe
 `options.wait_for_http: {"url":"http://localhost:8000/health","timeout_ms":30000}`.
@@ -312,10 +339,38 @@ controle próximo ao texto visível do rótulo.
 `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.
+`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. Para o SAFI, `screen` pesquisa o nome ou código
+na tela Acesso Rápido, exige um resultado único e clica no link oficial da linha;
+por exemplo, `{"action":"navigate_menu","screen":"TCN00022"}`.
+
+Em uma instância local do SAFI, `http_request` pode obter a lista de telas pela
+sessão já aberta sem ler o HTML:
+
+```json
+{
+  "flow": "Consultar telas disponíveis no perfil atual do SAFI",
+  "initial_url": "http://localhost:8011/safi/",
+  "candidate_plans": {
+    "inspect": {
+      "description": "Ler a lista de telas do SAFI no ambiente local",
+      "steps": [{
+        "action": "http_request",
+        "url": "/safi/api/menu/telas_menu",
+        "include_body": true
+      }]
+    }
+  },
+  "options": { "local_only": true, "fast_path": true }
+}
+```
+
+O endpoint usa a sessão atual e pode retornar uma lista específica do perfil.
+Os valores de cookies nunca são retornados. O acesso ao menu continua sujeito
+às permissões verificadas pela própria interface; não use esse diagnóstico
+contra produção.
 
 ```json
 {
@@ -547,12 +602,17 @@ quando nenhuma dessas condições se aplica; confiança do Jev, sozinha, não
 comprova o resultado. `environment_error` identifica falha de
 navegação, autenticação ou sessão do browser; `navigation_error` contém o código
 detectado, como `ERR_CONNECTION_REFUSED`, `AUTHENTICATION_REQUIRED` ou
-`BROWSER_DISCONNECTED`, e `reason` orienta a recuperação. Se uma navegação falhar
+`BROWSER_DISCONNECTED`, `BROWSER_PAGE_NOT_RESTORED` ou
+`BROWSER_PROFILE_IN_USE`, e `reason` orienta a recuperação. Se uma navegação falhar
 e a chamada seguinte tentar reutilizar a página, o MCP informa que a navegação
 anterior não carregou; reinicie a navegação com
 `continue_from_current_page: false` (ou o alias `reuse_page: false`). Uma sessão
-desconectada pode ser reaberta por `browser_health`; o fluxo só é repetido
-automaticamente uma vez se nenhuma etapa mutável tiver sido executada.
+desconectada pode ser reaberta por `browser_health`. `run_browser_flow` também
+tenta reconectar e repetir uma vez quando a desconexão acontece antes da primeira
+etapa; a repetição exige `initial_url`. Sem essa URL, o resultado informa
+`BROWSER_PAGE_NOT_RESTORED`, e chamadas posteriores em `reuse_page` continuam
+recusadas até uma nova navegação explícita. Se qualquer etapa já executou ou
+há token de confirmação de mutação, o MCP não repete o fluxo automaticamente.
 
 `current_url` é devolvido para diagnóstico sem query string nem fragmento; IDs
 longos no caminho também podem ser redigidos. `timings_ms.ready_ms` mede a espera
@@ -584,8 +644,9 @@ continua informada mesmo quando a lista é truncada.
 
 O `run_browser_flow` aceita `options` com `fast_path`, `snapshot_scope`,
 `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`,
+`auto_angular_idle`, `login_url_contains`, `login_text`, `capture_console_errors`,
+`capture_network_errors`, `capture_network_error_bodies`, `capture_network`,
+`capture_network_url_contains`, `ready_timeout_seconds`,
 `ready_network_idle`, `ready_stable_ms`, `ready_text`, `ready`, `continue_from_current_page`,
 `reuse_page`, `reuse_page_match`, `step_timeout_seconds`, `max_flow_steps`, `return_snapshot`,
 `screenshot_on_failure`, `screenshot_on_success`, `trace_on_failure`,
@@ -649,6 +710,8 @@ traz mensagens do console agrupadas por texto e nível (`console_messages` com
 `count`), além de `console_errors` para compatibilidade. `network_failures`
 contém eventos limitados em quantidade e tamanho. Mensagens idênticas do console
 são agrupadas em uma entrada com `count`.
+Controles sem nome acessível aparecem em um único aviso com a contagem e alguns
+exemplos, em vez de gerar uma mensagem por controle.
 Respostas HTTP 4xx/5xx e requisições que falham são listadas; query strings,
 fragmentos, valores de formulário e nomes de arquivo são removidos ou
 sanitizados. `capture_network_error_bodies: true` lê somente respostas JSON
@@ -718,12 +781,12 @@ Chrome/Edge; em outros sistemas, usa o `SingletonLock` do Chromium. O caminho
 padrão já separa processos por PID; configure `JEV_BROWSER_PROFILE` para mudar
 a raiz e `JEV_BROWSER_SESSION_ID` para nomear a instância.
 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. 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.
+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. Passe `{"restart":true}` para fechar e
+reiniciar somente o navegador administrado por este processo MCP. Perfil ocupado
+é devolvido como `BROWSER_PROFILE_IN_USE` com o PID detectado e não provoca
+encerramento do Chrome/Edge existente.
 
 `harness_browser` e `computer_browser` aceitam `chrome` ou `msedge`.
 `computer_user_data_dir` deve ficar fora do repositório e conter `{browser}` e