@diegosouzacdv/jev-browser-mcp 0.2.0 → 0.3.0

package/README.md

@@ -1635,97 +1635,101 @@ proxies publicam exclusivamente a allowlist read-only e reaplicam sanitização
 Prompt Guard em cada resultado. Portanto, ferramentas novas ou mutantes que o
 21st venha a publicar não ficam automaticamente acessíveis ao executor.
 
-### MCP de navegador com Jev e Playwright
-
-O pacote independente `@diegosouzacdv/jev-browser-mcp` conecta qualquer harness
-compatível com MCP por `stdio` ao Jev e ao Playwright. Requer Node.js 22 ou mais
-recente. Instale o navegador do Playwright uma vez para execuções no modo
-`harness`:
-
-```sh
-npx --yes @diegosouzacdv/jev-browser-mcp --install-browser
-```
-
-Registre o servidor MCP no formato aceito pelo seu harness. Exemplo de
-configuração comum:
-
-```json
-{
-  "mcpServers": {
-    "jev-browser": {
-      "command": "npx",
-      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp"],
-      "env": {
-        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
-        "JEV_BROWSER_MODE": "harness"
-      }
-    }
-  }
-}
-```
-
-Configure `OPENROUTER_API_KEY` no secret manager ou no ambiente do processo
-que inicia o harness. Não coloque a chave no JSON. O endpoint e o modelo
-Decisions têm valores padrão no pacote; `JEV_PROVIDER_URL` e `JEV_MODEL` podem
-substituí-los.
-
-Escolha o navegador por variáveis de ambiente:
-
-- `JEV_BROWSER_MODE=harness` inicia um navegador isolado e sem interface,
-  adequado para testes automatizados e CI.
-- `JEV_BROWSER_MODE=computer` abre o Chrome ou Edge instalado. O MCP usa um
-  perfil persistente próprio; faça login nele uma vez. Não configure o perfil
-  pessoal que já está aberto no computador.
-- `JEV_BROWSER_CHANNEL=chrome` ou `msedge` escolhe o navegador.
-- `JEV_BROWSER_PROFILE` define o caminho absoluto do perfil persistente no
-  modo `computer`.
-
-Para um fluxo conhecido, o agente do harness consulta o cenário e os critérios
-de aceitação no projeto e chama `run_browser_flow` uma vez. Informe o objetivo,
-a URL inicial, o resultado esperado e planos candidatos declarativos. O Jev
-escolhe um dos planos com base no snapshot acessível da página; o MCP executa
-os passos e confere se o resultado esperado apareceu. Exemplo resumido:
-
-```json
-{
-  "flow": "Adicionar o produto ao carrinho",
-  "initial_url": "http://127.0.0.1:4173/products/coffee",
-  "expected_outcome": "Coffee added to cart",
-  "candidate_plans": {
-    "add_product": {
-      "description": "Adicionar o produto visível ao carrinho",
-      "steps": [
-        {"action": "click", "role": "button", "name": "Add to cart"},
-        {"action": "wait_for_text", "text": "Coffee added to cart"}
-      ]
-    }
-  }
-}
-```
-
-O servidor também oferece `choose_next_action` para exploração passo a passo;
-esse modo exige chamadas separadas do harness e costuma ser mais lento. Os
-planos aceitam ações limitadas como clique por papel e nome acessível,
-preenchimento, espera por texto, rolagem e reação idempotente a um comentário
-único. Não aceitam JavaScript arbitrário, coordenadas nem seletores livres.
-Valores digitados ficam no Playwright e são removidos do conteúdo enviado ao
-Jev. Não coloque senhas, tokens ou outros segredos na descrição do fluxo ou
-nos critérios.
-
-O contrato também oferece `select_option`, `hover`, teclas `Enter`/`Escape`/`Tab`,
-asserções por elemento (`assert_text`, `assert_value`, `assert_visible`,
-`assert_hidden`) e alvos nomeados em iframes. `upload_file` aceita inputs,
-botões que abrem o seletor nativo e dropzones; configure `JEV_BROWSER_UPLOAD_ROOT`
-para limitar os arquivos locais que o MCP pode ler. Um único plano usa o
-fast-path por padrão e não chama a API Decisions. `options` pode limitar o
-snapshot a `main` ou `dialog`, bloquear rastreadores, capturar erros de console
-e rede e salvar screenshot/trace local em falhas. Os caminhos e limites estão
-descritos no [guia completo](docs/jev-browser-mcp.md).
-
-A resposta informa o status, o plano escolhido, as ações executadas, a captura
-final e se o resultado esperado foi confirmado. Consulte o [guia completo do
-MCP Jev Browser](docs/jev-browser-mcp.md) para schemas, limites, tempos e
-detalhes de segurança.
+### MCP de navegador com Jev e Playwright
+
+O pacote independente `@diegosouzacdv/jev-browser-mcp` conecta qualquer harness
+compatível com MCP por `stdio` ao Jev e ao Playwright. Requer Node.js 22 ou mais
+recente. Instale o navegador do Playwright uma vez para execuções no modo
+`harness`:
+
+```sh
+npx --yes @diegosouzacdv/jev-browser-mcp --install-browser
+```
+
+Registre o servidor MCP no formato aceito pelo seu harness. Exemplo de
+configuração comum:
+
+```json
+{
+  "mcpServers": {
+    "jev-browser": {
+      "command": "npx",
+      "args": ["--yes", "@diegosouzacdv/jev-browser-mcp"],
+      "env": {
+        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
+        "JEV_BROWSER_MODE": "harness"
+      }
+    }
+  }
+}
+```
+
+Configure `OPENROUTER_API_KEY` no secret manager ou no ambiente do processo
+que inicia o harness. Não coloque a chave no JSON. O endpoint e o modelo
+Decisions têm valores padrão no pacote; `JEV_PROVIDER_URL` e `JEV_MODEL` podem
+substituí-los.
+
+Escolha o navegador por variáveis de ambiente:
+
+- `JEV_BROWSER_MODE=harness` inicia um navegador isolado e sem interface,
+  adequado para testes automatizados e CI.
+- `JEV_BROWSER_MODE=computer` abre o Chrome ou Edge instalado. O MCP usa um
+  perfil persistente próprio; faça login nele uma vez. Não configure o perfil
+  pessoal que já está aberto no computador.
+- `JEV_BROWSER_CHANNEL=chrome` ou `msedge` escolhe o navegador.
+- `JEV_BROWSER_PROFILE` define o caminho absoluto do perfil persistente no
+  modo `computer`.
+
+Para um fluxo conhecido, o agente do harness consulta o cenário e os critérios
+de aceitação no projeto e chama `run_browser_flow` uma vez. Informe o objetivo,
+a URL inicial, o resultado esperado e planos candidatos declarativos. O Jev
+escolhe um dos planos com base no snapshot acessível da página; o MCP executa
+os passos e confere se o resultado esperado apareceu. Exemplo resumido:
+
+```json
+{
+  "flow": "Adicionar o produto ao carrinho",
+  "initial_url": "http://127.0.0.1:4173/products/coffee",
+  "expected_outcome": "Coffee added to cart",
+  "candidate_plans": {
+    "add_product": {
+      "description": "Adicionar o produto visível ao carrinho",
+      "steps": [
+        {"action": "click", "role": "button", "name": "Add to cart"},
+        {"action": "wait_for_text", "text": "Coffee added to cart"}
+      ]
+    }
+  }
+}
+```
+
+O servidor também oferece `choose_next_action` para exploração passo a passo;
+esse modo exige chamadas separadas do harness e costuma ser mais lento. Os
+planos aceitam ações limitadas como clique por papel e nome acessível,
+preenchimento, espera por texto, rolagem e reação idempotente a um comentário
+único. Não aceitam JavaScript arbitrário, coordenadas nem seletores livres.
+Valores digitados ficam no Playwright e são removidos do conteúdo enviado ao
+Jev. Não coloque senhas, tokens ou outros segredos na descrição do fluxo ou
+nos critérios.
+
+O contrato também oferece `select_option`, `hover`, teclas `Enter`/`Escape`/`Tab`,
+asserções por elemento (`assert_text`, `assert_value`, `assert_visible`,
+`assert_hidden`), escopo de alvo por `within` e índice zero-based com `index`,
+além de alvos nomeados em iframes. `upload_file` aceita inputs, botões que abrem
+o seletor nativo e dropzones; configure `JEV_BROWSER_UPLOAD_ROOT` para limitar
+os arquivos locais que o MCP pode ler. `click` com `expect_download: true`
+captura arquivos na pasta de artefatos dentro dos limites configurados, e
+`audit_accessibility` roda axe nas tags WCAG 2.0/2.1 A/AA. A análise automatizada
+não substitui auditoria manual. Um único plano usa o fast-path por padrão e não
+chama a API Decisions. `options` pode limitar o
+snapshot a `main` ou `dialog`, bloquear rastreadores, capturar erros de console
+e rede e salvar screenshot/trace local em falhas. Os caminhos e limites estão
+descritos no [guia completo](docs/jev-browser-mcp.md).
+
+A resposta informa o status, o plano escolhido, as ações executadas, a captura
+final e se o resultado esperado foi confirmado. Consulte o [guia completo do
+MCP Jev Browser](docs/jev-browser-mcp.md) para schemas, limites, tempos e
+detalhes de segurança.
 
 O sidecar PostgreSQL de teste pode ser validado localmente com:
 

package/config/ui-testing.json

@@ -5,9 +5,9 @@
     "harness_browser": "chrome",
     "playwright_mcp_package": "@playwright/mcp@0.0.79",
     "computer_browser": "chrome",
-    "computer_user_data_dir": "~/.cache/orquestrador/jev-browser-{browser}",
-    "max_flow_steps": 24,
-    "max_text_entry_chars": 2000
+    "computer_user_data_dir": "~/.cache/orquestrador/jev-browser-{browser}",
+    "max_flow_steps": 24,
+    "max_text_entry_chars": 2000
   },
   "jev": {
     "provider_url": "https://openrouter.ai/api/alpha/decisions",
@@ -16,40 +16,45 @@
     "request_timeout_seconds": 30,
     "max_flow_chars": 12000,
     "max_snapshot_chars": 12000,
-    "max_action_count": 32,
-    "max_action_description_chars": 300,
-    "max_response_bytes": 65536
-  },
-  "jev_browser_mcp": {
-    "browser": {
-      "max_action_timeout_seconds": 8,
-      "max_upload_files": 5,
-      "max_upload_path_chars": 4096,
-      "max_upload_file_bytes": 10485760,
-      "max_upload_total_bytes": 26214400,
-      "upload_root_env": "JEV_BROWSER_UPLOAD_ROOT",
-      "artifact_directory": "~/.cache/orquestrador/jev-browser-artifacts",
-      "artifact_directory_env": "JEV_BROWSER_ARTIFACT_DIR",
-      "max_frame_snapshots": 5,
-      "fast_path_single_plan_default": true,
-      "screenshot_on_failure_default": true,
-      "trace_on_failure_default": false,
-      "capture_console_errors_default": true,
-      "capture_network_errors_default": false,
-      "block_trackers_default": false,
-      "snapshot_scope_default": "body",
-      "tracker_host_suffixes": [
-        "google-analytics.com",
-        "googletagmanager.com",
-        "hotjar.com",
-        "fonts.googleapis.com",
-        "fonts.gstatic.com"
-      ],
-      "blocked_resource_types": ["font", "media"]
-    },
-    "jev": {
-      "max_diagnostic_items": 50,
-      "max_diagnostic_chars": 500
-    }
-  }
-}
+    "max_action_count": 32,
+    "max_action_description_chars": 300,
+    "max_response_bytes": 65536
+  },
+  "jev_browser_mcp": {
+    "browser": {
+      "max_action_timeout_seconds": 8,
+      "max_upload_files": 5,
+      "max_upload_path_chars": 4096,
+      "max_upload_file_bytes": 10485760,
+      "max_upload_total_bytes": 26214400,
+      "max_download_files": 5,
+      "max_download_file_bytes": 10485760,
+      "max_download_total_bytes": 26214400,
+      "max_download_timeout_seconds": 30,
+      "upload_root_env": "JEV_BROWSER_UPLOAD_ROOT",
+      "artifact_directory": "~/.cache/orquestrador/jev-browser-artifacts",
+      "artifact_directory_env": "JEV_BROWSER_ARTIFACT_DIR",
+      "max_frame_snapshots": 5,
+      "fast_path_single_plan_default": true,
+      "screenshot_on_failure_default": true,
+      "trace_on_failure_default": false,
+      "capture_console_errors_default": true,
+      "capture_network_errors_default": false,
+      "block_trackers_default": false,
+      "snapshot_scope_default": "body",
+      "tracker_host_suffixes": [
+        "google-analytics.com",
+        "googletagmanager.com",
+        "hotjar.com",
+        "fonts.googleapis.com",
+        "fonts.gstatic.com"
+      ],
+      "blocked_resource_types": ["font", "media"]
+    },
+    "jev": {
+      "max_diagnostic_items": 50,
+      "max_diagnostic_chars": 500,
+      "max_accessibility_violations": 50
+    }
+  }
+}