flutter-skill-mcp 0.2.0

package/dart/lib/src/cli/act.dart

@@ -0,0 +1,118 @@
+import 'dart:io';
+import '../flutter_skill_client.dart';
+
+Future<void> runAct(List<String> args) async {
+  String uri;
+
+  // Logic from bin/act.dart to separate URI from args
+  String resolveUriResult;
+  int argOffset;
+
+  if (args.isNotEmpty &&
+      (args[0].startsWith('ws://') || args[0].startsWith('http://'))) {
+    resolveUriResult = args[0];
+    argOffset = 1;
+  } else {
+    // Try file (we assume we are running from project root where .flutter_skill_uri might exist)
+    // NOTE: If global activated, we might not be in the right dir?
+    // Users should run this in their project root.
+    final file = File('.flutter_skill_uri');
+    if (await file.exists()) {
+      resolveUriResult = (await file.readAsString()).trim();
+    } else {
+      print('Usage: flutter_skill act [vm-uri] <action> <params...>');
+      exit(1);
+    }
+    argOffset = 0;
+  }
+
+  if (args.length <= argOffset) {
+    print('Missing action argument');
+    exit(1);
+  }
+
+  uri = resolveUriResult;
+  String action = args[argOffset];
+  final client = FlutterSkillClient(uri);
+
+  String? param1;
+  String? param2;
+  if (args.length > argOffset + 1) param1 = args[argOffset + 1];
+  if (args.length > argOffset + 2) param2 = args[argOffset + 2];
+
+  try {
+    await client.connect();
+
+    switch (action) {
+      case 'tap':
+        if (param1 == null) throw ArgumentError('tap requires a key or text');
+        await client.tap(key: param1);
+        print('Tapped "$param1"');
+        break;
+
+      case 'enter_text':
+        if (param1 == null || param2 == null)
+          throw ArgumentError('enter_text requires key and text');
+        await client.enterText(param1, param2);
+        print('Entered text "$param2" into "$param1"');
+        break;
+
+      case 'scroll_to':
+        if (param1 == null)
+          throw ArgumentError('scroll_to requires a key or text');
+        await client.scrollTo(key: param1);
+        print('Scrolled to "$param1"');
+        break;
+
+      case 'assert_visible':
+        if (param1 == null)
+          throw ArgumentError('assert_visible requires a key or text');
+        final target = param1;
+        final elements = await client.getInteractiveElements();
+        if (_findTarget(elements, target)) {
+          print('Assertion Passed: "$target" is visible.');
+        } else {
+          throw Exception('Assertion Failed: "$target" is NOT visible.');
+        }
+        break;
+
+      case 'assert_gone':
+        if (param1 == null)
+          throw ArgumentError('assert_gone requires a key or text');
+        final target = param1;
+        final elements = await client.getInteractiveElements();
+        if (!_findTarget(elements, target)) {
+          print('Assertion Passed: "$target" is gone.');
+        } else {
+          throw Exception('Assertion Failed: "$target" is STILL visible.');
+        }
+        break;
+
+      default:
+        print('Unknown action: $action');
+        exit(1);
+    }
+  } catch (e) {
+    print('Error: $e');
+    exit(1);
+  } finally {
+    await client.disconnect();
+  }
+}
+
+bool _findTarget(List<dynamic> elements, String target) {
+  for (final e in elements) {
+    if (e is! Map) continue;
+    final key = e['key']?.toString();
+    final text = e['text']?.toString();
+    if (key == target || (text != null && text.contains(target))) {
+      return true;
+    }
+    if (e.containsKey('children')) {
+      if (_findTarget((e['children'] as List).cast<dynamic>(), target)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}

package/dart/lib/src/cli/inspect.dart

@@ -0,0 +1,65 @@
+import 'dart:io';
+import '../flutter_skill_client.dart'; // Relative import to sibling dir
+
+Future<void> runInspect(List<String> args) async {
+  // No initial arg check, let resolveUri handle it
+  // if (args.isEmpty) ...
+
+  String uri;
+  try {
+    uri = await FlutterSkillClient.resolveUri(args);
+  } catch (e) {
+    print(e);
+    exit(1);
+  }
+
+  final client = FlutterSkillClient(uri);
+
+  try {
+    await client.connect();
+    final elements = await client.getInteractiveElements();
+
+    // Print simplified tree for LLM consumption
+    print('Interactive Elements:');
+    if (elements.isEmpty) {
+      print('(No interactive elements found)');
+    } else {
+      for (final e in elements) {
+        _printElement(e);
+      }
+    }
+  } catch (e) {
+    print('Error: $e');
+    exit(1);
+  } finally {
+    await client.disconnect();
+  }
+}
+
+void _printElement(dynamic element, [String prefix = '']) {
+  if (element is! Map) return;
+
+  // Try to extract useful info
+  final type = element['type'] ?? 'Widget';
+  final key = element['key'];
+  final text = element['text'];
+  final tooltip = element['tooltip'];
+
+  var buffer = StringBuffer();
+  buffer.write(prefix);
+  buffer.write('- **$type**');
+
+  if (key != null) buffer.write(' [Key: "$key"]');
+  if (text != null && text.toString().isNotEmpty)
+    buffer.write(' [Text: "$text"]');
+  if (tooltip != null) buffer.write(' [Tooltip: "$tooltip"]');
+
+  print(buffer.toString());
+
+  // Recursively print children if any
+  if (element.containsKey('children') && element['children'] is List) {
+    for (final child in element['children']) {
+      _printElement(child, '$prefix  ');
+    }
+  }
+}

package/dart/lib/src/cli/launch.dart

@@ -0,0 +1,89 @@
+import 'dart:convert';
+import 'dart:io';
+import 'setup.dart'; // Import setup logic
+
+// File to store the last connected URI
+final _uriFile = File('.flutter_skill_uri');
+
+Future<void> runLaunch(List<String> args) async {
+  // Extract project path. Everything else is passed to flutter run.
+  // We assume: flutter_skill launch [project_path] [flutter_args...]
+  // But wait, standard args might be tricky.
+  // Let's say: first arg is project path if it doesn't start with -?
+
+  String projectPath = '.';
+  List<String> flutterArgs = [];
+
+  if (args.isNotEmpty) {
+    if (!args[0].startsWith('-')) {
+      projectPath = args[0];
+      flutterArgs = args.sublist(1);
+    } else {
+      // Current dir, all args are for flutter
+      flutterArgs = args;
+    }
+  }
+
+  print('Running auto-setup...');
+  try {
+    // Call the setup logic directly
+    await runSetup(projectPath);
+  } catch (e) {
+    print('Setup failed: $e');
+    print('Proceeding with launch anyway...');
+  }
+
+  print('Launching Flutter app in: $projectPath with args: $flutterArgs');
+
+  final process = await Process.start(
+    'flutter',
+    ['run', ...flutterArgs],
+    workingDirectory: projectPath,
+    mode: ProcessStartMode.normal,
+  );
+
+  print(
+      'Flutter process started (PID: ${process.pid}). Waiting for connection URI...');
+
+  process.stdout
+      .transform(utf8.decoder)
+      .transform(const LineSplitter())
+      .listen((line) {
+    print('[Flutter]: $line');
+    _checkForUri(line);
+  });
+
+  process.stderr
+      .transform(utf8.decoder)
+      .transform(const LineSplitter())
+      .listen((line) {
+    print('[Flutter Error]: $line');
+  });
+
+  // Forward stdin to flutter run
+  if (stdin.hasTerminal) {
+    stdin.listen((data) => process.stdin.add(data));
+  }
+
+  final exitCode = await process.exitCode;
+  print('Flutter app exited with code $exitCode');
+  exit(exitCode);
+}
+
+void _checkForUri(String line) {
+  if (line.contains('ws://')) {
+    final uriRegex = RegExp(r'ws://[^\s]+');
+    final match = uriRegex.firstMatch(line);
+    if (match != null) {
+      final uri = match.group(0)!;
+      print('\nCode-Skill: Found VM Service URI: $uri');
+      try {
+        _uriFile.writeAsStringSync(uri);
+        print(
+            'Code-Skill: URI saved to .flutter_skill_uri. You can now run scripts without arguments.');
+      } catch (e) {
+        print('Code-Skill: Failed to save URI: $e');
+      }
+    }
+  }
+}