flutter-skill-mcp 0.2.19 → 0.2.20

package/README.md

@@ -154,13 +154,42 @@ flutter-skill.inspect()
 
 ## Installation Methods
 
-| Method | Command | Auto-Update | Native Binary |
-|--------|---------|-------------|---------------|
-| npm | `npm install -g flutter-skill-mcp` | Manual | Auto-download |
-| Homebrew | `brew install ai-dashboad/flutter-skill/flutter-skill` | `brew upgrade` | Pre-compiled |
-| VSCode | Extensions → "Flutter Skill" | Auto | Auto-download |
-| IntelliJ | Plugins → "Flutter Skill" | Auto | Auto-download |
-| pub.dev | `dart pub global activate flutter_skill` | Manual | Dart runtime |
+| Method | Command | Platform |
+|--------|---------|----------|
+| **npm** | `npm install -g flutter-skill-mcp` | All |
+| **Homebrew** | `brew install ai-dashboad/flutter-skill/flutter-skill` | macOS/Linux |
+| **Docker** | `docker pull ghcr.io/ai-dashboad/flutter-skill` | All |
+| **Snap** | `snap install flutter-skill` | Linux |
+| **Scoop** | `scoop install flutter-skill` | Windows |
+| **Winget** | `winget install AIDashboard.FlutterSkill` | Windows |
+| **pub.dev** | `dart pub global activate flutter_skill` | All |
+| **VSCode** | Extensions → "Flutter Skill" | All |
+| **IntelliJ** | Plugins → "Flutter Skill" | All |
+| **Devcontainer** | See below | All |
+
+### Docker
+
+```bash
+# Run MCP server
+docker run --rm -it ghcr.io/ai-dashboad/flutter-skill server
+
+# Or use in docker-compose
+services:
+  flutter-skill:
+    image: ghcr.io/ai-dashboad/flutter-skill:latest
+    command: ["server"]
+```
+
+### Devcontainer Feature
+
+Add to your `.devcontainer/devcontainer.json`:
+```json
+{
+    "features": {
+        "ghcr.io/ai-dashboad/flutter-skill/flutter-skill:latest": {}
+    }
+}
+```
 
 ### Native Binary Performance
 | Version | Startup Time |
@@ -189,7 +218,7 @@ flutter-skill launch /path/to/project
 1. Add dependency:
 ```yaml
 dependencies:
-  flutter_skill: ^0.2.19
+  flutter_skill: ^0.2.20
 ```
 
 2. Initialize in main.dart:

package/dart/lib/flutter_skill.dart

@@ -25,7 +25,8 @@ class FlutterSkillBinding {
     // ==================== EXISTING EXTENSIONS ====================
 
     // 1. Interactive Elements
-    developer.registerExtension('ext.flutter.flutter_skill.interactive', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.interactive',
+        (method, parameters) async {
       try {
         final elements = _findInteractiveElements();
         return developer.ServiceExtensionResponse.result(
@@ -37,13 +38,17 @@ class FlutterSkillBinding {
     });
 
     // 2. Tap
-    developer.registerExtension('ext.flutter.flutter_skill.tap', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.tap',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final success = await _performTap(key: key, text: text);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Tap successful' : 'Element not found'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Tap successful' : 'Element not found'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -51,7 +56,8 @@ class FlutterSkillBinding {
     });
 
     // 3. Enter Text
-    developer.registerExtension('ext.flutter.flutter_skill.enterText', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.enterText',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
@@ -63,7 +69,10 @@ class FlutterSkillBinding {
         }
         final success = await _performEnterText(key: key, text: text);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Text entered' : 'TextField not found'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Text entered' : 'TextField not found'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -71,13 +80,17 @@ class FlutterSkillBinding {
     });
 
     // 4. Scroll
-    developer.registerExtension('ext.flutter.flutter_skill.scroll', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.scroll',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final success = await _performScroll(key: key, text: text);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Scroll successful' : 'Element not found'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Scroll successful' : 'Element not found'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -87,18 +100,21 @@ class FlutterSkillBinding {
     // ==================== UI INSPECTION EXTENSIONS ====================
 
     // 5. Get Widget Tree
-    developer.registerExtension('ext.flutter.flutter_skill.getWidgetTree', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getWidgetTree',
+        (method, parameters) async {
       try {
         final maxDepth = int.tryParse(parameters['maxDepth'] ?? '10') ?? 10;
         final tree = _getWidgetTree(maxDepth: maxDepth);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'tree': tree}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'tree': tree}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 6. Get Widget Properties
-    developer.registerExtension('ext.flutter.flutter_skill.getWidgetProperties', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getWidgetProperties',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         if (key == null) {
@@ -108,24 +124,28 @@ class FlutterSkillBinding {
           );
         }
         final properties = _getWidgetProperties(key);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'properties': properties}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'properties': properties}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 7. Get Text Content
-    developer.registerExtension('ext.flutter.flutter_skill.getTextContent', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getTextContent',
+        (method, parameters) async {
       try {
         final textList = _getTextContent();
-        return developer.ServiceExtensionResponse.result(jsonEncode({'texts': textList}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'texts': textList}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 8. Find By Type
-    developer.registerExtension('ext.flutter.flutter_skill.findByType', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.findByType',
+        (method, parameters) async {
       try {
         final type = parameters['type'];
         if (type == null) {
@@ -135,7 +155,8 @@ class FlutterSkillBinding {
           );
         }
         final elements = _findByType(type);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'elements': elements}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'elements': elements}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
@@ -144,14 +165,19 @@ class FlutterSkillBinding {
     // ==================== MORE INTERACTIONS ====================
 
     // 9. Long Press
-    developer.registerExtension('ext.flutter.flutter_skill.longPress', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.longPress',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final duration = int.tryParse(parameters['duration'] ?? '500') ?? 500;
-        final success = await _performLongPress(key: key, text: text, duration: duration);
+        final success =
+            await _performLongPress(key: key, text: text, duration: duration);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Long press successful' : 'Element not found'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Long press successful' : 'Element not found'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -159,14 +185,20 @@ class FlutterSkillBinding {
     });
 
     // 10. Swipe
-    developer.registerExtension('ext.flutter.flutter_skill.swipe', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.swipe',
+        (method, parameters) async {
       try {
         final direction = parameters['direction'] ?? 'up';
-        final distance = double.tryParse(parameters['distance'] ?? '300') ?? 300;
+        final distance =
+            double.tryParse(parameters['distance'] ?? '300') ?? 300;
         final key = parameters['key'];
-        final success = await _performSwipe(direction: direction, distance: distance, key: key);
+        final success = await _performSwipe(
+            direction: direction, distance: distance, key: key);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Swipe successful' : 'Swipe failed'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Swipe successful' : 'Swipe failed'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -174,13 +206,17 @@ class FlutterSkillBinding {
     });
 
     // 11. Drag
-    developer.registerExtension('ext.flutter.flutter_skill.drag', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.drag',
+        (method, parameters) async {
       try {
         final fromKey = parameters['fromKey'];
         final toKey = parameters['toKey'];
         final success = await _performDrag(fromKey: fromKey, toKey: toKey);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Drag successful' : 'Drag failed'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Drag successful' : 'Drag failed'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -188,13 +224,17 @@ class FlutterSkillBinding {
     });
 
     // 12. Double Tap
-    developer.registerExtension('ext.flutter.flutter_skill.doubleTap', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.doubleTap',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final success = await _performDoubleTap(key: key, text: text);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Double tap successful' : 'Element not found'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Double tap successful' : 'Element not found'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -204,7 +244,8 @@ class FlutterSkillBinding {
     // ==================== STATE & VALIDATION ====================
 
     // 13. Get Text Value
-    developer.registerExtension('ext.flutter.flutter_skill.getTextValue', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getTextValue',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         if (key == null) {
@@ -214,14 +255,16 @@ class FlutterSkillBinding {
           );
         }
         final value = _getTextFieldValue(key);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'value': value}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'value': value}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 14. Get Checkbox State
-    developer.registerExtension('ext.flutter.flutter_skill.getCheckboxState', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getCheckboxState',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         if (key == null) {
@@ -231,14 +274,16 @@ class FlutterSkillBinding {
           );
         }
         final state = _getCheckboxState(key);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'checked': state}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'checked': state}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 15. Get Slider Value
-    developer.registerExtension('ext.flutter.flutter_skill.getSliderValue', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getSliderValue',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         if (key == null) {
@@ -248,21 +293,27 @@ class FlutterSkillBinding {
           );
         }
         final value = _getSliderValue(key);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'value': value}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'value': value}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 16. Wait For Element
-    developer.registerExtension('ext.flutter.flutter_skill.waitForElement', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.waitForElement',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final timeout = int.tryParse(parameters['timeout'] ?? '5000') ?? 5000;
-        final found = await _waitForElement(key: key, text: text, timeout: timeout);
+        final found =
+            await _waitForElement(key: key, text: text, timeout: timeout);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'found': found, 'message': found ? 'Element found' : 'Timeout waiting for element'}),
+          jsonEncode({
+            'found': found,
+            'message': found ? 'Element found' : 'Timeout waiting for element'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -270,14 +321,18 @@ class FlutterSkillBinding {
     });
 
     // 17. Wait For Gone
-    developer.registerExtension('ext.flutter.flutter_skill.waitForGone', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.waitForGone',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         final text = parameters['text'];
         final timeout = int.tryParse(parameters['timeout'] ?? '5000') ?? 5000;
         final gone = await _waitForGone(key: key, text: text, timeout: timeout);
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'gone': gone, 'message': gone ? 'Element is gone' : 'Element still present'}),
+          jsonEncode({
+            'gone': gone,
+            'message': gone ? 'Element is gone' : 'Element still present'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -287,17 +342,20 @@ class FlutterSkillBinding {
     // ==================== SCREENSHOT ====================
 
     // 18. Screenshot
-    developer.registerExtension('ext.flutter.flutter_skill.screenshot', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.screenshot',
+        (method, parameters) async {
       try {
         final base64Image = await _takeScreenshot();
-        return developer.ServiceExtensionResponse.result(jsonEncode({'image': base64Image}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'image': base64Image}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 19. Screenshot Element
-    developer.registerExtension('ext.flutter.flutter_skill.screenshotElement', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.screenshotElement',
+        (method, parameters) async {
       try {
         final key = parameters['key'];
         if (key == null) {
@@ -307,7 +365,8 @@ class FlutterSkillBinding {
           );
         }
         final base64Image = await _takeElementScreenshot(key);
-        return developer.ServiceExtensionResponse.result(jsonEncode({'image': base64Image}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'image': base64Image}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
@@ -316,21 +375,27 @@ class FlutterSkillBinding {
     // ==================== NAVIGATION ====================
 
     // 20. Get Current Route
-    developer.registerExtension('ext.flutter.flutter_skill.getCurrentRoute', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getCurrentRoute',
+        (method, parameters) async {
       try {
         final route = _getCurrentRoute();
-        return developer.ServiceExtensionResponse.result(jsonEncode({'route': route}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'route': route}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 21. Go Back
-    developer.registerExtension('ext.flutter.flutter_skill.goBack', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.goBack',
+        (method, parameters) async {
       try {
         final success = _goBack();
         return developer.ServiceExtensionResponse.result(
-          jsonEncode({'success': success, 'message': success ? 'Navigated back' : 'Cannot go back'}),
+          jsonEncode({
+            'success': success,
+            'message': success ? 'Navigated back' : 'Cannot go back'
+          }),
         );
       } catch (e, stack) {
         return _errorResponse(e, stack);
@@ -338,10 +403,12 @@ class FlutterSkillBinding {
     });
 
     // 22. Get Navigation Stack
-    developer.registerExtension('ext.flutter.flutter_skill.getNavigationStack', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getNavigationStack',
+        (method, parameters) async {
       try {
         final stack = _getNavigationStack();
-        return developer.ServiceExtensionResponse.result(jsonEncode({'stack': stack}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'stack': stack}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
@@ -350,36 +417,43 @@ class FlutterSkillBinding {
     // ==================== DEBUG & LOGS ====================
 
     // 23. Get Logs
-    developer.registerExtension('ext.flutter.flutter_skill.getLogs', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getLogs',
+        (method, parameters) async {
       try {
-        return developer.ServiceExtensionResponse.result(jsonEncode({'logs': _logs}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'logs': _logs}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 24. Get Errors
-    developer.registerExtension('ext.flutter.flutter_skill.getErrors', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getErrors',
+        (method, parameters) async {
       try {
-        return developer.ServiceExtensionResponse.result(jsonEncode({'errors': _errors}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'errors': _errors}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 25. Clear Logs
-    developer.registerExtension('ext.flutter.flutter_skill.clearLogs', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.clearLogs',
+        (method, parameters) async {
       try {
         _logs.clear();
         _errors.clear();
-        return developer.ServiceExtensionResponse.result(jsonEncode({'success': true}));
+        return developer.ServiceExtensionResponse.result(
+            jsonEncode({'success': true}));
       } catch (e, stack) {
         return _errorResponse(e, stack);
       }
     });
 
     // 26. Get Performance
-    developer.registerExtension('ext.flutter.flutter_skill.getPerformance', (method, parameters) async {
+    developer.registerExtension('ext.flutter.flutter_skill.getPerformance',
+        (method, parameters) async {
       try {
         final perf = _getPerformanceMetrics();
         return developer.ServiceExtensionResponse.result(jsonEncode(perf));
@@ -400,7 +474,8 @@ class FlutterSkillBinding {
     };
   }
 
-  static developer.ServiceExtensionResponse _errorResponse(Object e, StackTrace stack) {
+  static developer.ServiceExtensionResponse _errorResponse(
+      Object e, StackTrace stack) {
     return developer.ServiceExtensionResponse.error(
       developer.ServiceExtensionResponse.extensionError,
       '$e\n$stack',
@@ -414,7 +489,8 @@ class FlutterSkillBinding {
     void visit(Element element) {
       if (found != null) return;
       final widget = element.widget;
-      if (widget.key is ValueKey<String> && (widget.key as ValueKey<String>).value == key) {
+      if (widget.key is ValueKey<String> &&
+          (widget.key as ValueKey<String>).value == key) {
         found = element;
         return;
       }
@@ -474,7 +550,8 @@ class FlutterSkillBinding {
       return false;
     }
 
-    final center = renderObject.localToGlobal(renderObject.size.center(Offset.zero));
+    final center =
+        renderObject.localToGlobal(renderObject.size.center(Offset.zero));
     _log('Tapping at $center (key: $key, text: $text)');
 
     await _dispatchTap(center);
@@ -486,13 +563,16 @@ class FlutterSkillBinding {
     final binding = WidgetsBinding.instance;
     final pointer = _pointerCounter++;
 
-    binding.handlePointerEvent(PointerDownEvent(position: position, pointer: pointer));
+    binding.handlePointerEvent(
+        PointerDownEvent(position: position, pointer: pointer));
     await Future.delayed(const Duration(milliseconds: 50));
-    binding.handlePointerEvent(PointerUpEvent(position: position, pointer: pointer));
+    binding.handlePointerEvent(
+        PointerUpEvent(position: position, pointer: pointer));
     await Future.delayed(const Duration(milliseconds: 100));
   }
 
-  static Future<bool> _performEnterText({String? key, required String text}) async {
+  static Future<bool> _performEnterText(
+      {String? key, required String text}) async {
     final element = _findElement(key: key);
     if (element == null) {
       _log('TextField not found (key: $key)');
@@ -502,7 +582,8 @@ class FlutterSkillBinding {
     final renderObject = element.renderObject;
     if (renderObject is! RenderBox) return false;
 
-    final center = renderObject.localToGlobal(renderObject.size.center(Offset.zero));
+    final center =
+        renderObject.localToGlobal(renderObject.size.center(Offset.zero));
     await _dispatchTap(center);
     await Future.delayed(const Duration(milliseconds: 200));
 
@@ -515,6 +596,7 @@ class FlutterSkillBinding {
       }
       e.visitChildren(findEditable);
     }
+
     findEditable(element);
 
     if (editableTextState != null) {
@@ -545,7 +627,8 @@ class FlutterSkillBinding {
     }
 
     try {
-      await Scrollable.ensureVisible(element, duration: const Duration(milliseconds: 300), curve: Curves.easeInOut);
+      await Scrollable.ensureVisible(element,
+          duration: const Duration(milliseconds: 300), curve: Curves.easeInOut);
       _log('Scrolled to element (key: $key, text: $text)');
       return true;
     } catch (e) {
@@ -554,27 +637,32 @@ class FlutterSkillBinding {
     }
   }
 
-  static Future<bool> _performLongPress({String? key, String? text, int duration = 500}) async {
+  static Future<bool> _performLongPress(
+      {String? key, String? text, int duration = 500}) async {
     final element = _findElement(key: key, text: text);
     if (element == null) return false;
 
     final renderObject = element.renderObject;
     if (renderObject is! RenderBox || !renderObject.hasSize) return false;
 
-    final center = renderObject.localToGlobal(renderObject.size.center(Offset.zero));
+    final center =
+        renderObject.localToGlobal(renderObject.size.center(Offset.zero));
     final binding = WidgetsBinding.instance;
     final pointer = _pointerCounter++;
 
-    binding.handlePointerEvent(PointerDownEvent(position: center, pointer: pointer));
+    binding.handlePointerEvent(
+        PointerDownEvent(position: center, pointer: pointer));
     await Future.delayed(Duration(milliseconds: duration));
-    binding.handlePointerEvent(PointerUpEvent(position: center, pointer: pointer));
+    binding
+        .handlePointerEvent(PointerUpEvent(position: center, pointer: pointer));
     await Future.delayed(const Duration(milliseconds: 100));
 
     _log('Long press completed (key: $key, text: $text)');
     return true;
   }
 
-  static Future<bool> _performSwipe({required String direction, double distance = 300, String? key}) async {
+  static Future<bool> _performSwipe(
+      {required String direction, double distance = 300, String? key}) async {
     final binding = WidgetsBinding.instance;
     Offset start;
 
@@ -612,13 +700,17 @@ class FlutterSkillBinding {
     final pointer = _pointerCounter++;
     final end = start + delta;
 
-    binding.handlePointerEvent(PointerDownEvent(position: start, pointer: pointer));
+    binding.handlePointerEvent(
+        PointerDownEvent(position: start, pointer: pointer));
     await Future.delayed(const Duration(milliseconds: 16));
 
     const steps = 10;
     for (int i = 1; i <= steps; i++) {
       final current = Offset.lerp(start, end, i / steps)!;
-      binding.handlePointerEvent(PointerMoveEvent(position: current, pointer: pointer, delta: delta / steps.toDouble()));
+      binding.handlePointerEvent(PointerMoveEvent(
+          position: current,
+          pointer: pointer,
+          delta: delta / steps.toDouble()));
       await Future.delayed(const Duration(milliseconds: 16));
     }
 
@@ -646,13 +738,15 @@ class FlutterSkillBinding {
     final binding = WidgetsBinding.instance;
     final pointer = _pointerCounter++;
 
-    binding.handlePointerEvent(PointerDownEvent(position: start, pointer: pointer));
+    binding.handlePointerEvent(
+        PointerDownEvent(position: start, pointer: pointer));
     await Future.delayed(const Duration(milliseconds: 100));
 
     const steps = 20;
     for (int i = 1; i <= steps; i++) {
       final current = Offset.lerp(start, end, i / steps)!;
-      binding.handlePointerEvent(PointerMoveEvent(position: current, pointer: pointer));
+      binding.handlePointerEvent(
+          PointerMoveEvent(position: current, pointer: pointer));
       await Future.delayed(const Duration(milliseconds: 16));
     }
 
@@ -670,7 +764,8 @@ class FlutterSkillBinding {
     final renderObject = element.renderObject;
     if (renderObject is! RenderBox || !renderObject.hasSize) return false;
 
-    final center = renderObject.localToGlobal(renderObject.size.center(Offset.zero));
+    final center =
+        renderObject.localToGlobal(renderObject.size.center(Offset.zero));
 
     await _dispatchTap(center);
     await Future.delayed(const Duration(milliseconds: 50));
@@ -695,8 +790,11 @@ class FlutterSkillBinding {
         key = (widget.key as ValueKey<String>).value;
       }
 
-      if (widget is ElevatedButton || widget is TextButton || widget is OutlinedButton ||
-          widget is IconButton || widget is FloatingActionButton) {
+      if (widget is ElevatedButton ||
+          widget is TextButton ||
+          widget is OutlinedButton ||
+          widget is IconButton ||
+          widget is FloatingActionButton) {
         type = 'Button';
         text = _extractTextFrom(element);
       } else if (widget is TextField || widget is TextFormField) {
@@ -752,7 +850,10 @@ class FlutterSkillBinding {
 
       final renderObject = element.renderObject;
       if (renderObject is RenderBox && renderObject.hasSize) {
-        node['size'] = {'width': renderObject.size.width, 'height': renderObject.size.height};
+        node['size'] = {
+          'width': renderObject.size.width,
+          'height': renderObject.size.height
+        };
         final offset = renderObject.localToGlobal(Offset.zero);
         node['position'] = {'x': offset.dx, 'y': offset.dy};
       }
@@ -790,10 +891,15 @@ class FlutterSkillBinding {
 
     final renderObject = element.renderObject;
     if (renderObject is RenderBox && renderObject.hasSize) {
-      props['size'] = {'width': renderObject.size.width, 'height': renderObject.size.height};
+      props['size'] = {
+        'width': renderObject.size.width,
+        'height': renderObject.size.height
+      };
       final offset = renderObject.localToGlobal(Offset.zero);
       props['position'] = {'x': offset.dx, 'y': offset.dy};
-      props['visible'] = renderObject.attached && renderObject.size.width > 0 && renderObject.size.height > 0;
+      props['visible'] = renderObject.attached &&
+          renderObject.size.width > 0 &&
+          renderObject.size.height > 0;
     }
 
     if (widget is Text) {
@@ -864,7 +970,10 @@ class FlutterSkillBinding {
         if (renderObject is RenderBox && renderObject.hasSize) {
           final offset = renderObject.localToGlobal(Offset.zero);
           node['position'] = {'x': offset.dx, 'y': offset.dy};
-          node['size'] = {'width': renderObject.size.width, 'height': renderObject.size.height};
+          node['size'] = {
+            'width': renderObject.size.width,
+            'height': renderObject.size.height
+          };
         }
 
         results.add(node);
@@ -897,6 +1006,7 @@ class FlutterSkillBinding {
       }
       e.visitChildren(findEditable);
     }
+
     findEditable(element);
 
     return editableTextState?.textEditingValue.text;
@@ -927,7 +1037,8 @@ class FlutterSkillBinding {
     return null;
   }
 
-  static Future<bool> _waitForElement({String? key, String? text, int timeout = 5000}) async {
+  static Future<bool> _waitForElement(
+      {String? key, String? text, int timeout = 5000}) async {
     final endTime = DateTime.now().add(Duration(milliseconds: timeout));
 
     while (DateTime.now().isBefore(endTime)) {
@@ -939,7 +1050,8 @@ class FlutterSkillBinding {
     return false;
   }
 
-  static Future<bool> _waitForGone({String? key, String? text, int timeout = 5000}) async {
+  static Future<bool> _waitForGone(
+      {String? key, String? text, int timeout = 5000}) async {
     final endTime = DateTime.now().add(Duration(milliseconds: timeout));
 
     while (DateTime.now().isBefore(endTime)) {
@@ -969,6 +1081,7 @@ class FlutterSkillBinding {
           }
           obj.visitChildren(findBoundary);
         }
+
         renderObject?.visitChildren(findBoundary);
 
         if (boundary == null) {
@@ -1024,7 +1137,8 @@ class FlutterSkillBinding {
             final boundaryBox = current;
 
             // Get element position relative to boundary
-            final offset = box.localToGlobal(Offset.zero, ancestor: boundaryBox);
+            final offset =
+                box.localToGlobal(Offset.zero, ancestor: boundaryBox);
             final size = box.size;
 
             // Capture the boundary
@@ -1043,8 +1157,10 @@ class FlutterSkillBinding {
             );
 
             final picture = recorder.endRecording();
-            final croppedImage = await picture.toImage(size.width.toInt(), size.height.toInt());
-            final byteData = await croppedImage.toByteData(format: ui.ImageByteFormat.png);
+            final croppedImage =
+                await picture.toImage(size.width.toInt(), size.height.toInt());
+            final byteData =
+                await croppedImage.toByteData(format: ui.ImageByteFormat.png);
             if (byteData == null) return null;
             return base64Encode(byteData.buffer.asUint8List());
           }

package/dart/lib/src/cli/server.dart

@@ -19,24 +19,35 @@ Future<void> runServer(List<String> args) async {
 /// Check pub.dev for newer version
 Future<void> _checkForUpdates() async {
   try {
-    final response = await http.get(
-      Uri.parse('https://pub.dev/api/packages/flutter_skill'),
-    ).timeout(const Duration(seconds: 5));
+    final response = await http
+        .get(
+          Uri.parse('https://pub.dev/api/packages/flutter_skill'),
+        )
+        .timeout(const Duration(seconds: 5));
 
     if (response.statusCode == 200) {
       final data = jsonDecode(response.body);
       final latestVersion = data['latest']?['version'] as String?;
 
-      if (latestVersion != null && _isNewerVersion(latestVersion, _currentVersion)) {
+      if (latestVersion != null &&
+          _isNewerVersion(latestVersion, _currentVersion)) {
         stderr.writeln('');
-        stderr.writeln('╔══════════════════════════════════════════════════════════╗');
-        stderr.writeln('║  flutter-skill v$latestVersion available (current: v$_currentVersion)');
-        stderr.writeln('║                                                          ║');
-        stderr.writeln('║  Update with:                                            ║');
-        stderr.writeln('║    dart pub global activate flutter_skill                ║');
-        stderr.writeln('║  Or:                                                     ║');
-        stderr.writeln('║    npm update -g flutter-skill-mcp                       ║');
-        stderr.writeln('╚══════════════════════════════════════════════════════════╝');
+        stderr.writeln(
+            '╔══════════════════════════════════════════════════════════╗');
+        stderr.writeln(
+            '║  flutter-skill v$latestVersion available (current: v$_currentVersion)');
+        stderr.writeln(
+            '║                                                          ║');
+        stderr.writeln(
+            '║  Update with:                                            ║');
+        stderr.writeln(
+            '║    dart pub global activate flutter_skill                ║');
+        stderr.writeln(
+            '║  Or:                                                     ║');
+        stderr.writeln(
+            '║    npm update -g flutter-skill-mcp                       ║');
+        stderr.writeln(
+            '╚══════════════════════════════════════════════════════════╝');
         stderr.writeln('');
       }
     }
@@ -64,7 +75,10 @@ class FlutterMcpServer {
   Process? _flutterProcess;
 
   Future<void> run() async {
-    stdin.transform(utf8.decoder).transform(const LineSplitter()).listen((line) async {
+    stdin
+        .transform(utf8.decoder)
+        .transform(const LineSplitter())
+        .listen((line) async {
       if (line.trim().isEmpty) return;
       try {
         final request = jsonDecode(line);
@@ -87,7 +101,10 @@ class FlutterMcpServer {
         _sendResult(id, {
           "capabilities": {"tools": {}, "resources": {}},
           "protocolVersion": "2024-11-05",
-          "serverInfo": {"name": "flutter-skill-mcp", "version": _currentVersion},
+          "serverInfo": {
+            "name": "flutter-skill-mcp",
+            "version": _currentVersion
+          },
         });
       } else if (method == 'notifications/initialized') {
         // No op
@@ -119,7 +136,10 @@ class FlutterMcpServer {
         "inputSchema": {
           "type": "object",
           "properties": {
-            "uri": {"type": "string", "description": "WebSocket URI (ws://...)"},
+            "uri": {
+              "type": "string",
+              "description": "WebSocket URI (ws://...)"
+            },
           },
           "required": ["uri"],
         },
@@ -130,7 +150,10 @@ class FlutterMcpServer {
         "inputSchema": {
           "type": "object",
           "properties": {
-            "project_path": {"type": "string", "description": "Path to Flutter project"},
+            "project_path": {
+              "type": "string",
+              "description": "Path to Flutter project"
+            },
             "device_id": {"type": "string", "description": "Target device"},
           },
         },
@@ -148,7 +171,10 @@ class FlutterMcpServer {
         "inputSchema": {
           "type": "object",
           "properties": {
-            "max_depth": {"type": "integer", "description": "Maximum tree depth (default: 10)"},
+            "max_depth": {
+              "type": "integer",
+              "description": "Maximum tree depth (default: 10)"
+            },
           },
         },
       },
@@ -174,7 +200,10 @@ class FlutterMcpServer {
         "inputSchema": {
           "type": "object",
           "properties": {
-            "type": {"type": "string", "description": "Widget type name to search"},
+            "type": {
+              "type": "string",
+              "description": "Widget type name to search"
+            },
           },
           "required": ["type"],
         },
@@ -225,7 +254,10 @@ class FlutterMcpServer {
           "properties": {
             "key": {"type": "string", "description": "Widget key"},
             "text": {"type": "string", "description": "Text to find"},
-            "duration": {"type": "integer", "description": "Duration in ms (default: 500)"},
+            "duration": {
+              "type": "integer",
+              "description": "Duration in ms (default: 500)"
+            },
           },
         },
       },
@@ -246,9 +278,18 @@ class FlutterMcpServer {
         "inputSchema": {
           "type": "object",
           "properties": {
-            "direction": {"type": "string", "enum": ["up", "down", "left", "right"]},
-            "distance": {"type": "number", "description": "Swipe distance in pixels (default: 300)"},
-            "key": {"type": "string", "description": "Start from element (optional)"},
+            "direction": {
+              "type": "string",
+              "enum": ["up", "down", "left", "right"]
+            },
+            "distance": {
+              "type": "number",
+              "description": "Swipe distance in pixels (default: 300)"
+            },
+            "key": {
+              "type": "string",
+              "description": "Start from element (optional)"
+            },
           },
           "required": ["direction"],
         },
@@ -308,7 +349,10 @@ class FlutterMcpServer {
           "properties": {
             "key": {"type": "string", "description": "Widget key"},
             "text": {"type": "string", "description": "Text to find"},
-            "timeout": {"type": "integer", "description": "Timeout in ms (default: 5000)"},
+            "timeout": {
+              "type": "integer",
+              "description": "Timeout in ms (default: 5000)"
+            },
           },
         },
       },
@@ -320,7 +364,10 @@ class FlutterMcpServer {
           "properties": {
             "key": {"type": "string", "description": "Widget key"},
             "text": {"type": "string", "description": "Text to find"},
-            "timeout": {"type": "integer", "description": "Timeout in ms (default: 5000)"},
+            "timeout": {
+              "type": "integer",
+              "description": "Timeout in ms (default: 5000)"
+            },
           },
         },
       },
@@ -430,11 +477,15 @@ class FlutterMcpServer {
         // Continue even if setup fails
       }
 
-      _flutterProcess = await Process.start('flutter', processArgs, workingDirectory: projectPath);
+      _flutterProcess = await Process.start('flutter', processArgs,
+          workingDirectory: projectPath);
 
       final completer = Completer<String>();
 
-      _flutterProcess!.stdout.transform(utf8.decoder).transform(const LineSplitter()).listen((line) {
+      _flutterProcess!.stdout
+          .transform(utf8.decoder)
+          .transform(const LineSplitter())
+          .listen((line) {
         if (line.contains('ws://')) {
           final uriRegex = RegExp(r'ws://[a-zA-Z0-9.:/-]+');
           final match = uriRegex.firstMatch(line);
@@ -443,9 +494,11 @@ class FlutterMcpServer {
             _client?.disconnect();
             _client = FlutterSkillClient(uri);
             _client!.connect().then((_) {
-              if (!completer.isCompleted) completer.complete("Launched and connected to $uri");
+              if (!completer.isCompleted)
+                completer.complete("Launched and connected to $uri");
             }).catchError((e) {
-              if (!completer.isCompleted) completer.completeError("Found URI but failed to connect: $e");
+              if (!completer.isCompleted)
+                completer.completeError("Found URI but failed to connect: $e");
             });
           }
         }
@@ -510,17 +563,21 @@ class FlutterMcpServer {
       // Advanced Actions
       case 'long_press':
         final duration = args['duration'] ?? 500;
-        final success = await _client!.longPress(key: args['key'], text: args['text'], duration: duration);
+        final success = await _client!.longPress(
+            key: args['key'], text: args['text'], duration: duration);
         return success ? "Long pressed" : "Long press failed";
       case 'double_tap':
-        final success = await _client!.doubleTap(key: args['key'], text: args['text']);
+        final success =
+            await _client!.doubleTap(key: args['key'], text: args['text']);
         return success ? "Double tapped" : "Double tap failed";
       case 'swipe':
         final distance = (args['distance'] ?? 300).toDouble();
-        final success = await _client!.swipe(direction: args['direction'], distance: distance, key: args['key']);
+        final success = await _client!.swipe(
+            direction: args['direction'], distance: distance, key: args['key']);
         return success ? "Swiped ${args['direction']}" : "Swipe failed";
       case 'drag':
-        final success = await _client!.drag(fromKey: args['from_key'], toKey: args['to_key']);
+        final success = await _client!
+            .drag(fromKey: args['from_key'], toKey: args['to_key']);
         return success ? "Dragged" : "Drag failed";
 
       // State & Validation
@@ -532,11 +589,13 @@ class FlutterMcpServer {
         return await _client!.getSliderValue(args['key']);
       case 'wait_for_element':
         final timeout = args['timeout'] ?? 5000;
-        final found = await _client!.waitForElement(key: args['key'], text: args['text'], timeout: timeout);
+        final found = await _client!.waitForElement(
+            key: args['key'], text: args['text'], timeout: timeout);
         return {"found": found};
       case 'wait_for_gone':
         final timeout = args['timeout'] ?? 5000;
-        final gone = await _client!.waitForGone(key: args['key'], text: args['text'], timeout: timeout);
+        final gone = await _client!.waitForGone(
+            key: args['key'], text: args['text'], timeout: timeout);
         return {"gone": gone};
 
       // Screenshot
@@ -574,7 +633,8 @@ class FlutterMcpServer {
 
   void _requireConnection() {
     if (_client == null || !_client!.isConnected) {
-      throw Exception("Not connected. Call 'connect_app' or 'launch_app' first.");
+      throw Exception(
+          "Not connected. Call 'connect_app' or 'launch_app' first.");
     }
   }
 

package/dart/lib/src/flutter_skill_client.dart

@@ -29,7 +29,8 @@ class FlutterSkillClient {
     _isolateId = null;
   }
 
-  Future<Map<String, dynamic>> _call(String method, [Map<String, dynamic>? args]) async {
+  Future<Map<String, dynamic>> _call(String method,
+      [Map<String, dynamic>? args]) async {
     if (_service == null || _isolateId == null) {
       throw Exception('Not connected');
     }
@@ -88,7 +89,8 @@ class FlutterSkillClient {
   }
 
   Future<Map<String, dynamic>?> getWidgetProperties(String key) async {
-    final result = await _call('ext.flutter.flutter_skill.getWidgetProperties', {
+    final result =
+        await _call('ext.flutter.flutter_skill.getWidgetProperties', {
       'key': key,
     });
     return result['properties'];
@@ -108,7 +110,8 @@ class FlutterSkillClient {
 
   // ==================== MORE INTERACTIONS ====================
 
-  Future<bool> longPress({String? key, String? text, int duration = 500}) async {
+  Future<bool> longPress(
+      {String? key, String? text, int duration = 500}) async {
     final result = await _call('ext.flutter.flutter_skill.longPress', {
       if (key != null) 'key': key,
       if (text != null) 'text': text,
@@ -117,7 +120,8 @@ class FlutterSkillClient {
     return result['success'] == true;
   }
 
-  Future<bool> swipe({required String direction, double distance = 300, String? key}) async {
+  Future<bool> swipe(
+      {required String direction, double distance = 300, String? key}) async {
     final result = await _call('ext.flutter.flutter_skill.swipe', {
       'direction': direction,
       'distance': distance.toString(),
@@ -165,7 +169,8 @@ class FlutterSkillClient {
     return result['value']?.toDouble();
   }
 
-  Future<bool> waitForElement({String? key, String? text, int timeout = 5000}) async {
+  Future<bool> waitForElement(
+      {String? key, String? text, int timeout = 5000}) async {
     final result = await _call('ext.flutter.flutter_skill.waitForElement', {
       if (key != null) 'key': key,
       if (text != null) 'text': text,
@@ -174,7 +179,8 @@ class FlutterSkillClient {
     return result['found'] == true;
   }
 
-  Future<bool> waitForGone({String? key, String? text, int timeout = 5000}) async {
+  Future<bool> waitForGone(
+      {String? key, String? text, int timeout = 5000}) async {
     final result = await _call('ext.flutter.flutter_skill.waitForGone', {
       if (key != null) 'key': key,
       if (text != null) 'text': text,
@@ -252,8 +258,10 @@ class FlutterSkillClient {
 
   Future<Map<String, dynamic>> getLayoutTree() async {
     try {
-      final groupName = 'flutter_skill_${DateTime.now().millisecondsSinceEpoch}';
-      final result = await _call('ext.flutter.inspector.getRootWidgetSummaryTree', {
+      final groupName =
+          'flutter_skill_${DateTime.now().millisecondsSinceEpoch}';
+      final result =
+          await _call('ext.flutter.inspector.getRootWidgetSummaryTree', {
         'objectGroup': groupName,
       });
       return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flutter-skill-mcp",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "description": "MCP Server for Flutter app automation - Give your AI Agent eyes and hands inside your Flutter app",
   "main": "index.js",
   "bin": {