@diegosouzacdv/jev-browser-mcp 0.6.1 → 0.7.0

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

@@ -4,7 +4,7 @@ export const ACCESSIBILITY_STANDARDS = Object.freeze({
   wcag2aa: Object.freeze(["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"]),
 });
 
-export async function runAccessibilityAudit(page, standard, settings) {
+export async function runAccessibilityAudit(page, standard, settings, { scope, failOnImpact } = {}) {
   const tags = ACCESSIBILITY_STANDARDS[standard];
   if (!tags) throw new JevBrowserError("audit_accessibility standard must be wcag2aa");
 
@@ -15,17 +15,26 @@ export async function runAccessibilityAudit(page, standard, settings) {
     throw new JevBrowserError("accessibility auditing requires the installed @axe-core/playwright dependency");
   }
 
-  let results;
-  try {
-    results = await new AxeBuilder({ page }).withTags([...tags]).analyze();
+  let results;
+  try {
+    let audit = new AxeBuilder({ page }).withTags([...tags]);
+    if (scope) audit = audit.include(scope);
+    results = await audit.analyze();
   } catch {
     throw new JevBrowserError("axe-core could not complete the accessibility audit");
   }
-  const violations = Array.isArray(results?.violations) ? results.violations : [];
-  const incomplete = Array.isArray(results?.incomplete) ? results.incomplete : [];
-  return {
-    standard,
-    violations_count: violations.length,
+  const violations = Array.isArray(results?.violations) ? results.violations : [];
+  const incomplete = Array.isArray(results?.incomplete) ? results.incomplete : [];
+  const impactOrder = ["minor", "moderate", "serious", "critical"];
+  const threshold = impactOrder.indexOf(failOnImpact || settings.browser.accessibilityFailOnImpactDefault);
+  if (threshold < 0) throw new JevBrowserError("accessibility fail_on_impact must be minor, moderate, serious, or critical");
+  const blockingViolations = violations.filter((violation) => impactOrder.indexOf(violation.impact) >= threshold);
+  return {
+    standard,
+    ...(scope ? { scope } : {}),
+    fail_on_impact: impactOrder[threshold],
+    violations_count: violations.length,
+    blocking_violations_count: blockingViolations.length,
     violations_truncated: violations.length > settings.jev.maxAccessibilityViolations,
     violations: violations.slice(0, settings.jev.maxAccessibilityViolations).map((violation) => ({
       id: String(violation.id || "unknown").slice(0, 100),

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

@@ -32,8 +32,15 @@ const CONFIG_KEYS = {
     "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_network_error_body_bytes",
+    "max_network_error_message_chars",
+    "max_network_history_events",
+    "max_tool_response_bytes",
+    "max_viewport_width",
+    "max_viewport_height",
+    "accessibility_fail_on_impact_default",
+    "record_video_width",
+    "record_video_height",
     "max_upload_files",
     "max_upload_path_chars",
     "max_upload_file_bytes",
@@ -48,7 +55,8 @@ const CONFIG_KEYS = {
     "max_frame_snapshots",
     "fast_path_single_plan_default",
     "screenshot_on_failure_default",
-    "trace_on_failure_default",
+    "trace_on_failure_default",
+    "trace_on_success_default",
     "capture_console_errors_default",
     "capture_network_errors_default",
     "block_trackers_default",
@@ -162,11 +170,20 @@ function validProviderUrl(value) {
   return parsed.toString();
 }
 
-function profileDirectory(template, channel, override) {
-  const value = expandHomeDirectory(override?.trim() || template.replace("{browser}", channel));
-  if (!path.isAbsolute(value)) throw new JevBrowserError("JEV_BROWSER_PROFILE must be an absolute path");
-  return requireOutsidePackage(path.resolve(value), "browser profile");
-}
+function profileDirectory(template, channel, sessionId, override) {
+  const requestedOverride = override?.trim();
+  const unsupportedPlaceholder = requestedOverride?.replaceAll("{session}", "");
+  if (unsupportedPlaceholder?.includes("{") || unsupportedPlaceholder?.includes("}")) {
+    throw new JevBrowserError("JEV_BROWSER_PROFILE supports only the {session} placeholder");
+  }
+  const hasSessionPlaceholder = Boolean(requestedOverride?.includes("{session}"));
+  const profileBase = requestedOverride?.replaceAll("{session}", sessionId);
+  const value = expandHomeDirectory(requestedOverride
+    ? hasSessionPlaceholder ? profileBase : `${profileBase}-session-${sessionId}`
+    : template.replace("{browser}", channel).replace("{session}", sessionId));
+  if (!path.isAbsolute(value)) throw new JevBrowserError("JEV_BROWSER_PROFILE must be an absolute path");
+  return requireOutsidePackage(path.resolve(value), "browser profile");
+}
 
 export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {}) {
   let document;
@@ -205,12 +222,17 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
   if (!new Set(["chrome", "msedge"]).has(channel)) {
     throw new JevBrowserError("JEV_BROWSER_CHANNEL must be chrome or msedge");
   }
-  const profileTemplate = document.browser.computer_user_data_dir;
-  const profileRemainder = typeof profileTemplate === "string" ? profileTemplate.replace("{browser}", "") : "";
-  if (typeof profileTemplate !== "string" || profileTemplate.split("{browser}").length !== 2
-    || profileRemainder.includes("{") || profileRemainder.includes("}")) {
-    throw new JevBrowserError("config/ui-testing.json browser.computer_user_data_dir must contain {browser}");
-  }
+  const profileTemplate = document.browser.computer_user_data_dir;
+  const profileRemainder = typeof profileTemplate === "string"
+    ? profileTemplate.replace("{browser}", "").replace("{session}", "") : "";
+  if (typeof profileTemplate !== "string" || profileTemplate.split("{browser}").length !== 2
+    || profileTemplate.split("{session}").length !== 2 || profileRemainder.includes("{") || profileRemainder.includes("}")) {
+    throw new JevBrowserError("config/ui-testing.json browser.computer_user_data_dir must contain {browser} and {session}");
+  }
+  const sessionId = (env.JEV_BROWSER_SESSION_ID?.trim() || `pid-${process.pid}`);
+  if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(sessionId)) {
+    throw new JevBrowserError("JEV_BROWSER_SESSION_ID must contain 1-64 letters, numbers, underscores, or hyphens");
+  }
 
   const configuredProviderUrl = validProviderUrl(document.jev.provider_url);
   const providerUrl = validProviderUrl(env.JEV_PROVIDER_URL?.trim() || configuredProviderUrl);
@@ -259,9 +281,12 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
     browserOptions.login_text_default,
     "jev_browser_mcp.browser.login_text_default",
   );
-  if (!new Set(["none", "diff", "full"]).has(browserOptions.return_snapshot_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");
-  }
+  }
+  if (!new Set(["minor", "moderate", "serious", "critical"]).has(browserOptions.accessibility_fail_on_impact_default)) {
+    throw new JevBrowserError("config/ui-testing.json accessibility_fail_on_impact_default must be minor, moderate, serious, or critical");
+  }
   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);
@@ -285,7 +310,8 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
     browser: Object.freeze({
       mode,
       channel,
-      profileDir: profileDirectory(profileTemplate, channel, env.JEV_BROWSER_PROFILE),
+      profileDir: profileDirectory(profileTemplate, channel, sessionId, env.JEV_BROWSER_PROFILE),
+      sessionId,
       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,
@@ -297,7 +323,16 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
       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),
+      maxNetworkErrorMessageChars: positiveNumber(browserOptions.max_network_error_message_chars, "jev_browser_mcp.browser.max_network_error_message_chars", true),
+      maxNetworkHistoryEvents: positiveNumber(browserOptions.max_network_history_events, "jev_browser_mcp.browser.max_network_history_events", true),
+      maxToolResponseBytes: positiveNumber(browserOptions.max_tool_response_bytes, "jev_browser_mcp.browser.max_tool_response_bytes", true),
+      maxViewportWidth: positiveNumber(browserOptions.max_viewport_width, "jev_browser_mcp.browser.max_viewport_width", true),
+      maxViewportHeight: positiveNumber(browserOptions.max_viewport_height, "jev_browser_mcp.browser.max_viewport_height", true),
+      accessibilityFailOnImpactDefault: browserOptions.accessibility_fail_on_impact_default,
+      recordVideoSize: Object.freeze({
+        width: positiveNumber(browserOptions.record_video_width, "jev_browser_mcp.browser.record_video_width", true),
+        height: positiveNumber(browserOptions.record_video_height, "jev_browser_mcp.browser.record_video_height", 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),
@@ -312,7 +347,8 @@ export function loadSettings({ env = process.env, configPath = CONFIG_PATH } = {
       defaults: Object.freeze({
         fastPath: booleanValue(browserOptions.fast_path_single_plan_default, "jev_browser_mcp.browser.fast_path_single_plan_default"),
         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"),
+        traceOnFailure: booleanValue(browserOptions.trace_on_failure_default, "jev_browser_mcp.browser.trace_on_failure_default"),
+        traceOnSuccess: booleanValue(browserOptions.trace_on_success_default, "jev_browser_mcp.browser.trace_on_success_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"),