@diegosouzacdv/jev-browser-mcp 0.6.0 → 0.6.2

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

@@ -16,23 +16,31 @@ 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",
+  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_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",
@@ -47,10 +55,19 @@ 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",
+    "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 +238,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 +247,49 @@ 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 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 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");
+  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);
+  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 +299,25 @@ 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),
+      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),
+      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),
@@ -284,21 +332,30 @@ 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"),
-        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,