fix: null safety and parameter flexibility for bridge mode

- drag: support coordinate-based drag (start_x/end_x) alongside key-based
- edge_swipe: default edge/direction params instead of null cast
- assert_text: allow missing key param, fallback to element/text
- execute_batch: accept both 'actions' and 'commands' param names
- native_gesture: accept 'type'/'name' as alias for 'gesture'
- native_key_combo: accept List<String> or String for keys param
- get_widget_properties: require key/element with helpful error
- get_text_value: allow nullable key in FlutterSkillClient

Author: GitLab CI

lib/src/cli/server.dart

@@ -672,7 +672,7 @@ class FlutterMcpServer {
   /// Execute a batch of actions in sequence
   Future<Map<String, dynamic>> _executeBatch(
       Map<String, dynamic> args, FlutterSkillClient client) async {
-    final actions = args['actions'] as List<dynamic>;
+    final actions = (args['actions'] ?? args['commands'] ?? []) as List<dynamic>;
     final stopOnFailure = args['stop_on_failure'] ?? true;
 
     final results = <Map<String, dynamic>>[];

lib/src/cli/tool_handlers/bf_batch.dart

@@ -104,8 +104,8 @@ extension _BfBatch on FlutterMcpServer {
           });
         }
         final fc = _asFlutterClient(client!, 'edge_swipe');
-        final edge = args['edge'] as String;
-        final direction = args['direction'] as String;
+        final edge = args['edge'] as String? ?? 'left';
+        final direction = args['direction'] as String? ?? 'right';
         final distance = (args['distance'] as num?)?.toDouble() ?? 200;
         final result = await fc.edgeSwipe(
             edge: edge, direction: direction, distance: distance);

lib/src/cli/tool_handlers/bf_inspection.dart

@@ -179,8 +179,18 @@ extension _BfInspection on FlutterMcpServer {
         final maxDepth = args['max_depth'] ?? 10;
         return await fc.getWidgetTree(maxDepth: maxDepth);
       case 'get_widget_properties':
+        if (client is BridgeDriver) {
+          return await client.callMethod('get_widget_properties', {
+            'key': args['key'] as String?,
+            'element': args['element'] as String?,
+          });
+        }
         final fc = _asFlutterClient(client!, 'get_widget_properties');
-        return await fc.getWidgetProperties(args['key']);
+        final wpKey = (args['key'] ?? args['element'] ?? '') as String;
+        if (wpKey.isEmpty) {
+          return {"success": false, "error": "key or element parameter required"};
+        }
+        return await fc.getWidgetProperties(wpKey);
       case 'get_text_content':
         if (client is BridgeDriver) {
           final text = await client.getText();

lib/src/cli/tool_handlers/bf_interaction.dart

@@ -118,23 +118,44 @@ extension _BfInteraction on FlutterMcpServer {
         return success ? "Swiped ${args['direction']}" : "Swipe failed";
       case 'drag':
         if (client is BridgeDriver) {
+          // Support both key-based and coordinate-based drag
+          if (args['start_x'] != null) {
+            final result = await client.callMethod('drag', {
+              'start_x': (args['start_x'] as num).toDouble(),
+              'start_y': (args['start_y'] as num).toDouble(),
+              'end_x': (args['end_x'] as num).toDouble(),
+              'end_y': (args['end_y'] as num).toDouble(),
+            });
+            return result;
+          }
           final result = await client.callMethod(
               'drag', {'from_key': args['from_key'], 'to_key': args['to_key']});
           return result['success'] == true ? "Dragged" : "Drag failed";
         }
         final fc = _asFlutterClient(client!, 'drag');
-        final success =
-            await fc.drag(fromKey: args['from_key'], toKey: args['to_key']);
+        // Support coordinate-based drag via swipeCoordinates for FlutterClient
+        if (args['start_x'] != null) {
+          final result = await fc.swipeCoordinates(
+            (args['start_x'] as num).toDouble(),
+            (args['start_y'] as num).toDouble(),
+            (args['end_x'] as num).toDouble(),
+            (args['end_y'] as num).toDouble(),
+          );
+          return result;
+        }
+        final success = await fc.drag(
+            fromKey: args['from_key'] as String? ?? '',
+            toKey: args['to_key'] as String? ?? '');
         return success ? "Dragged" : "Drag failed";
 
       // State & Validation
       case 'get_text_value':
         if (client is BridgeDriver) {
-          final text = await client.getText(key: args['key']);
+          final text = await client.getText(key: args['key'] as String?);
           return {"success": true, "text": text};
         }
         final fc = _asFlutterClient(client!, 'get_text_value');
-        return await fc.getTextValue(args['key']);
+        return await fc.getTextValue(args['key'] as String?);
       case 'get_checkbox_state':
         if (client is BridgeDriver) {
           return await client

lib/src/cli/tool_handlers/flutter_helpers.dart

@@ -312,11 +312,11 @@ extension _FlutterHelpers on FlutterMcpServer {
   /// Assert text content
   Future<Map<String, dynamic>> _assertText(
       Map<String, dynamic> args, FlutterSkillClient client) async {
-    final key = args['key'] as String;
-    final expected = args['expected'] as String;
+    final key = args['key'] as String? ?? args['element'] as String? ?? '';
+    final expected = args['expected'] as String? ?? args['text'] as String? ?? '';
     final useContains = args['contains'] ?? false;
 
-    final actual = await client.getTextValue(key);
+    final actual = await client.getTextValue(key.isEmpty ? null : key);
 
     bool matches;
     if (useContains) {

lib/src/cli/tool_handlers/native_handlers.dart

@@ -263,7 +263,7 @@ extension _NativeHandlers on FlutterMcpServer {
           },
         };
       }
-      final gesture = args['gesture'] as String;
+      final gesture = (args['gesture'] ?? args['type'] ?? args['name']) as String;
       final result = await driver.gesture(gesture).timeout(
             const Duration(seconds: 15),
             onTimeout: () => NativeResult(
@@ -303,7 +303,9 @@ extension _NativeHandlers on FlutterMcpServer {
           },
         };
       }
-      final keys = args['keys'] as String;
+      // Accept both String ("shift+a") and List (["shift", "a"])
+      final rawKeys = args['keys'];
+      final keys = rawKeys is List ? rawKeys.join('+') : rawKeys as String;
       final result = await driver.keyCombo(keys).timeout(
             const Duration(seconds: 10),
             onTimeout: () => NativeResult(

lib/src/drivers/flutter_driver.dart

@@ -261,9 +261,9 @@ URI: $wsUri''');
 
   // ==================== STATE & VALIDATION ====================
 
-  Future<String?> getTextValue(String key) async {
+  Future<String?> getTextValue(String? key) async {
     final result = await _call('ext.flutter.flutter_skill.getTextValue', {
-      'key': key,
+      if (key != null) 'key': key,
     });
     return result['value'];
   }