fix: add go_online tool, fix screenshot_element selector param

- go_online: restore network after go_offline (prevents timeout cascade)
- screenshot_element: add 'selector' to tool definition (handler already supported it)
- Tool count: 176 → 177

Author: GitLab CI

lib/src/bridge/cdp_browser_methods.dart

@@ -401,6 +401,17 @@ extension CdpBrowserMethods on CdpDriver {
     return {"success": true, "offline": true};
   }
 
+  /// Go back online — restore normal network conditions.
+  Future<Map<String, dynamic>> goOnline() async {
+    await _call('Network.emulateNetworkConditions', {
+      'offline': false,
+      'latency': 0,
+      'downloadThroughput': -1,
+      'uploadThroughput': -1,
+    });
+    return {"success": true, "offline": false};
+  }
+
   /// Clear browser data.
   Future<Map<String, dynamic>> clearBrowserData() async {
     await _call('Network.clearBrowserCookies');

lib/src/cli/tool_handlers/cdp_tool_handlers.dart

@@ -514,6 +514,9 @@ extension _CdpToolHandlers on FlutterMcpServer {
       case 'go_offline':
         return await cdp.goOffline();
 
+      case 'go_online':
+        return await cdp.goOnline();
+
       case 'clear_browser_data':
         return await cdp.clearBrowserData();
 

lib/src/cli/tool_handlers/tool_definitions.dart

@@ -52,6 +52,7 @@ extension _ToolDefinitions on FlutterMcpServer {
       'block_urls',
       'throttle_network',
       'go_offline',
+      'go_online',
       'clear_browser_data',
       'accessibility_audit',
       'a11y_full_audit',
@@ -940,7 +941,12 @@ After starting, point the web SDK at ws://127.0.0.1:<port>.""",
       },
       {
         "name": "go_offline",
-        "description": "Simulate offline mode (no network)",
+        "description": "Simulate offline mode (no network). Use go_online to restore.",
+        "inputSchema": {"type": "object", "properties": {}}
+      },
+      {
+        "name": "go_online",
+        "description": "Restore normal network conditions after go_offline.",
         "inputSchema": {"type": "object", "properties": {}}
       },
       {
@@ -1765,10 +1771,11 @@ By default, saves screenshot to a temporary file and returns file path. Optional
       },
       {
         "name": "screenshot_element",
-        "description": "Take a screenshot of a specific element",
+        "description": "Take a screenshot of a specific element by CSS selector, key, or text content",
         "inputSchema": {
           "type": "object",
           "properties": {
+            "selector": {"type": "string", "description": "CSS selector (e.g. 'h1', '.my-class', '#my-id')"},
             "key": {"type": "string", "description": "Element key"},
             "text": {"type": "string", "description": "Text to find"},
           },

lib/src/engine/tool_registry.dart

@@ -63,6 +63,7 @@ class ToolRegistry {
     'block_urls',
     'throttle_network',
     'go_offline',
+    'go_online',
     'clear_browser_data',
     'accessibility_audit',
     'set_geolocation',
@@ -940,7 +941,12 @@ After starting, point the web SDK at ws://127.0.0.1:<port>.""",
       },
       {
         "name": "go_offline",
-        "description": "Simulate offline mode (no network)",
+        "description": "Simulate offline mode (no network). Use go_online to restore.",
+        "inputSchema": {"type": "object", "properties": {}}
+      },
+      {
+        "name": "go_online",
+        "description": "Restore normal network conditions after go_offline.",
         "inputSchema": {"type": "object", "properties": {}}
       },
       {
@@ -1773,12 +1779,13 @@ By default, saves screenshot to a temporary file and returns file path. Optional
       },
       {
         "name": "screenshot_element",
-        "description": "Take a screenshot of a specific element",
+        "description": "Take a screenshot of a specific element by CSS selector, key, or text content",
         "inputSchema": {
           "type": "object",
           "properties": {
+            "selector": {"type": "string", "description": "CSS selector (e.g. 'h1', '.my-class', '#my-id')"},
             "key": {"type": "string", "description": "Element key"},
-            "text": {"type": "string", "description": "Text to find"}
+            "text": {"type": "string", "description": "Text content to find"}
           }
         }
       },