flutter-skill 0.7.4 → 0.7.6

package/README.md

@@ -1,83 +1,37 @@
 # Flutter Skill
 
-> **AI-Powered End-to-End Testing for Flutter Apps**
+> **Give your AI Agent eyes and hands inside your Flutter app.**
 
 ![Version](https://img.shields.io/pub/v/flutter_skill.svg)
 ![npm](https://img.shields.io/npm/v/flutter-skill.svg)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
-![Platform](https://img.shields.io/badge/Platform-Flutter%20%7C%20Web%20%7C%20React%20Native%20%7C%20iOS%20%7C%20Android-02569B)
+![Platform](https://img.shields.io/badge/Platform-Flutter-02569B)
 
-**Flutter Skill** is an E2E testing bridge that gives AI agents (Claude Code, Cursor, Windsurf, etc.) full control over running apps across **Flutter, Web, React Native, iOS, and Android**. Describe what you want to test in natural language, and the AI sees the screen, taps buttons, fills forms, scrolls, and verifies results - just like a human tester would.
+**Flutter Skill** is a bridge that connects AI Agents (like Claude Code, Cursor, Windsurf) directly to running Flutter applications via the MCP (Model Context Protocol). It provides 30+ tools for UI automation, inspection, and testing.
 
-```
-You: "Test the login flow - enter test@example.com and password123, tap Login, verify Dashboard appears"
-
-AI Agent:
-  1. screenshot()          → sees the login screen
-  2. enter_text("email")   → types the email
-  3. enter_text("password") → types the password
-  4. tap("Login")           → taps the button
-  5. wait_for_element("Dashboard") → confirms navigation
-  6. screenshot()          → captures the result
-  ✅ Login flow verified!
-```
-
-## Why Flutter Skill?
-
-| Traditional E2E Testing | Flutter Skill |
-|------------------------|---------------|
-| Write Dart test code manually | Describe tests in natural language |
-| Learn WidgetTester API | AI handles the automation |
-| Maintain brittle test scripts | AI adapts to UI changes |
-| Debug test failures manually | AI sees screenshots and self-corrects |
-| Setup takes hours | Setup takes 2 minutes |
-
-**Flutter Skill is for you if:**
-- You want E2E tests without writing test code
-- You're using AI coding agents (Claude Code, Cursor, Windsurf)
-- You want to automate QA workflows with natural language
-- You need to test real app behavior on simulators/emulators
-
----
-
-## Quick Start (2 minutes)
+## Quick Start
 
-### 1. Install
+### 1. Install (choose one)
 
 ```bash
-# One-click install (macOS/Linux) - recommended
-curl -fsSL https://raw.githubusercontent.com/ai-dashboad/flutter-skill/main/install.sh | bash
-
-# Or: npm (all platforms)
+# npm (recommended - includes native binary for instant startup)
 npm install -g flutter-skill
 
-# Or: Homebrew (macOS/Linux)
-brew tap ai-dashboad/flutter-skill && brew install flutter-skill
+# Homebrew (macOS/Linux)
+brew tap ai-dashboad/flutter-skill
+brew install flutter-skill
 
-# Or: Dart
+# Dart
 dart pub global activate flutter_skill
-```
-
-<details>
-<summary>More installation methods (Windows, Docker, IDE extensions...)</summary>
-
-| Method | Command | Platform |
-|--------|---------|----------|
-| **One-click** | `curl -fsSL .../install.sh \| bash` | macOS/Linux |
-| **Windows** | `iwr .../install.ps1 -useb \| iex` | Windows |
-| **npm** | `npm install -g flutter-skill` | All |
-| **Homebrew** | `brew install ai-dashboad/flutter-skill/flutter-skill` | macOS/Linux |
-| **Scoop** | `scoop install flutter-skill` | Windows |
-| **Docker** | `docker pull ghcr.io/ai-dashboad/flutter-skill` | All |
-| **pub.dev** | `dart pub global activate flutter_skill` | All |
-| **VSCode** | Extensions -> "Flutter Skill" | All |
-| **IntelliJ** | Plugins -> "Flutter Skill" | All |
 
-</details>
+# IDE Extensions
+# - VSCode: Search "Flutter Skill" in Extensions
+# - IntelliJ/Android Studio: Search "Flutter Skill" in Plugins
+```
 
-### 2. Configure Your AI Agent
+### 2. Configure AI Agent
 
-Add to your agent's MCP config:
+Add to your AI agent's MCP config:
 
 **Claude Code** (`~/.claude/settings.json`):
 ```json
@@ -91,9 +45,6 @@ Add to your agent's MCP config:
 }
 ```
 
-<details>
-<summary>Cursor, Windsurf, and other agents</summary>
-
 **Cursor** (`~/.cursor/mcp.json`):
 ```json
 {
@@ -106,289 +57,222 @@ Add to your agent's MCP config:
 }
 ```
 
-Any MCP-compatible agent uses the same config format.
-
-</details>
-
-### 3. Add to Your Flutter App
-
-```yaml
-# pubspec.yaml
-dependencies:
-  flutter_skill: ^0.7.4
-```
-
-```dart
-// main.dart
-import 'package:flutter/foundation.dart';
-import 'package:flutter_skill/flutter_skill.dart';
-
-void main() {
-  if (kDebugMode) {
-    FlutterSkillBinding.ensureInitialized();
-  }
-  runApp(MyApp());
-}
-```
-
-> **Tip:** `launch_app` can auto-add this for you. The `kDebugMode` guard ensures it's stripped from release builds.
-
-### 4. Start Testing
+### 3. Use
 
-Just tell your AI agent what to test:
+```javascript
+// Option 1: Launch app with environment variables
+flutter-skill.launch_app({
+  project_path: "/path/to/flutter/project",
+  dart_defines: ["ENV=staging", "DEBUG=true"],
+  flavor: "staging"
+})
 
-```
-"Launch my app on iPhone simulator, tap the Sign Up button, fill in the form, and verify the success screen"
-```
+// Option 2: Connect to already running app (auto-detect)
+flutter-skill.scan_and_connect()
 
-Or use tools directly:
-```javascript
-flutter-skill.launch_app({ project_path: "." })
-flutter-skill.inspect()                          // See all interactive elements
-flutter-skill.tap({ text: "Sign Up" })           // Tap by text
-flutter-skill.enter_text({ key: "email", text: "user@test.com" })
-flutter-skill.screenshot()                       // Visual verification
+// Now use any tool
+flutter-skill.screenshot()
+flutter-skill.tap({ text: "Login" })
+flutter-skill.inspect()
 ```
 
 ---
 
-## Multi-Platform Support
-
-Flutter Skill isn't just for Flutter — it works with **5 platforms**, giving AI agents control over any app:
-
-| Platform | SDK | Status |
-|----------|-----|--------|
-| **Flutter** (Dart) | Core — `flutter_skill` package | ✅ Stable |
-| **Web** (JavaScript) | `sdks/web/flutter-skill.js` | ✅ Stable |
-| **React Native** | `sdks/react-native/` npm package | ✅ Stable |
-| **iOS** (Swift/SwiftUI) | `sdks/ios/` Swift Package | ✅ Stable |
-| **Android** (Kotlin) | `sdks/android/` Gradle dependency | ✅ Stable |
+## Features
 
-### Web
+### App Lifecycle Management
+| Tool | Description |
+|------|-------------|
+| `launch_app` | Launch Flutter app with dart_defines, flavor, target, extra_args |
+| `scan_and_connect` | Auto-scan ports and connect to first running Flutter app |
+| `list_running_apps` | List all running Flutter apps (VM Services) |
+| `connect_app` | Connect to specific VM Service URI |
+| `stop_app` | Stop the currently running app |
+| `disconnect` | Disconnect without stopping the app |
+| `get_connection_status` | Get connection info and suggestions |
+| `hot_reload` | Fast reload (keeps state) |
+| `hot_restart` | Full restart (resets state) |
+
+### UI Inspection
+| Tool | Description |
+|------|-------------|
+| `inspect` | Get interactive elements (buttons, text fields, etc.) |
+| `get_widget_tree` | Get widget tree structure with depth control |
+| `get_widget_properties` | Get properties of a widget (size, position, visibility) |
+| `get_text_content` | Extract all visible text from the screen |
+| `find_by_type` | Find widgets by type (e.g., ElevatedButton) |
+
+### Interactions
+| Tool | Description |
+|------|-------------|
+| `tap` | Tap a widget by Key or Text |
+| `double_tap` | Double tap a widget |
+| `long_press` | Long press with configurable duration |
+| `swipe` | Swipe gesture (up/down/left/right) |
+| `drag` | Drag from one element to another |
+| `scroll_to` | Scroll to make an element visible |
+| `enter_text` | Enter text into a text field |
 
-```html
-<script src="flutter-skill.js"></script>
-<script>
-  FlutterSkill.start({ port: 50000 });
-</script>
-```
+### State & Validation
+| Tool | Description |
+|------|-------------|
+| `get_text_value` | Get current value of a text field |
+| `get_checkbox_state` | Get checked state of a checkbox/switch |
+| `get_slider_value` | Get current value of a slider |
+| `wait_for_element` | Wait for an element to appear (with timeout) |
+| `wait_for_gone` | Wait for an element to disappear |
+
+### Screenshots
+| Tool | Description |
+|------|-------------|
+| `screenshot` | Take full app screenshot (returns base64) |
+| `screenshot_element` | Take screenshot of specific element |
 
-### React Native
+### Navigation
+| Tool | Description |
+|------|-------------|
+| `get_current_route` | Get the current route name |
+| `go_back` | Navigate back |
+| `get_navigation_stack` | Get the navigation stack |
 
-```bash
-npm install flutter-skill
-```
+### Debug & Logs
+| Tool | Description |
+|------|-------------|
+| `get_logs` | Get application logs |
+| `get_errors` | Get application errors |
+| `clear_logs` | Clear logs and errors |
+| `get_performance` | Get performance metrics |
 
-```js
-import FlutterSkill from 'flutter-skill';
-FlutterSkill.start();
-```
+### Utilities
+| Tool | Description |
+|------|-------------|
+| `pub_search` | Search Flutter packages on pub.dev |
 
-### iOS (Swift / SwiftUI)
+---
 
-Add via Swift Package Manager:
-```
-https://github.com/ai-dashboad/flutter-skill (sdks/ios)
-```
+## Installation Methods
 
-```swift
-import FlutterSkill
+| Method | Command | Auto-Update | Native Binary |
+|--------|---------|-------------|---------------|
+| npm | `npm install -g flutter-skill` | 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 |
 
-// Initialize in your app
-FlutterSkillBridge.shared.start()
+### Native Binary Performance
+| Version | Startup Time |
+|---------|--------------|
+| Dart JIT | ~1 second |
+| Native Binary | ~0.01 second |
 
-// Register SwiftUI elements for AI interaction
-Text("Hello")
-    .flutterSkillId("greeting")
+Native binaries are automatically downloaded on first use for supported platforms:
+- macOS (Apple Silicon & Intel)
+- Linux (x64)
+- Windows (x64)
 
-Button("Submit") { submit() }
-    .flutterSkillButton("submitBtn")
+---
 
-TextField("Email", text: $email)
-    .flutterSkillTextField("emailField")
-```
+## Flutter App Setup
 
-### Android (Kotlin)
+For the MCP tools to work, your Flutter app needs the `flutter_skill` package:
 
-```kotlin
-// build.gradle.kts
-implementation("com.flutterskill:flutter-skill:0.7.3")
+### Automatic Setup (Recommended)
+```bash
+flutter-skill launch /path/to/project
+# Automatically adds dependency and initializes
 ```
 
-```kotlin
-// In your Activity
-import com.flutterskill.FlutterSkillBridge
-
-FlutterSkillBridge.start(this)
+### Manual Setup
+1. Add dependency:
+```yaml
+dependencies:
+  flutter_skill: ^0.2.13
 ```
 
-### Connecting the AI Agent
-
-Once integrated, **the same CLI and MCP tools work for all platforms**:
+2. Initialize in main.dart:
+```dart
+import 'package:flutter_skill/flutter_skill.dart';
 
-```bash
-flutter_skill inspect          # See all UI elements
-flutter_skill act tap "login"  # Tap a button
-flutter_skill act enter_text "email" "user@test.com"
-flutter_skill act screenshot   # Capture the screen
+void main() {
+  FlutterSkillBinding.ensureInitialized();
+  runApp(MyApp());
+}
 ```
 
-All platforms support the same 14 capabilities: inspect, tap, enter_text, scroll, screenshot, get_text, find_element, wait_for_element, and more.
-
----
-
-## What Can It Do?
-
-### 40+ MCP Tools for Complete App Control
-
-**Launch & Connect**
-| Tool | What it does |
-|------|-------------|
-| `launch_app` | Launch app with dart-defines, flavors, custom targets |
-| `scan_and_connect` | Auto-find and connect to any running Flutter app |
-| `hot_reload` / `hot_restart` | Reload code without restarting |
-
-**See the Screen**
-| Tool | What it does |
-|------|-------------|
-| `screenshot` | Full app screenshot (configurable quality) |
-| `screenshot_region` | Screenshot a specific area |
-| `screenshot_element` | Screenshot a single widget |
-| `native_screenshot` | OS-level screenshot (native dialogs, permission popups) |
-| `inspect` | List all interactive elements with coordinates |
-| `get_widget_tree` | Full widget tree structure |
-| `find_by_type` | Find widgets by type (e.g., `ElevatedButton`) |
-| `get_text_content` | Extract all visible text |
-
-**Interact Like a User**
-| Tool | What it does |
-|------|-------------|
-| `tap` | Tap by Key, text, or coordinates |
-| `double_tap` | Double tap |
-| `long_press` | Long press with configurable duration |
-| `enter_text` | Type into text fields (by key or focused field) |
-| `swipe` | Swipe gestures (up/down/left/right) |
-| `scroll_to` | Scroll until element is visible |
-| `drag` | Drag from one element to another |
-| `go_back` | Navigate back |
-| `native_tap` | Tap native UI (permission dialogs, photo pickers) |
-| `native_input_text` | Type into native text fields |
-| `native_swipe` | Scroll native views |
-
-**Verify & Assert**
-| Tool | What it does |
-|------|-------------|
-| `assert_text` | Verify element contains expected text |
-| `assert_visible` | Verify element is visible |
-| `assert_not_visible` | Verify element is gone |
-| `assert_element_count` | Verify number of matching elements |
-| `wait_for_element` | Wait for element to appear (with timeout) |
-| `wait_for_gone` | Wait for element to disappear |
-| `get_checkbox_state` | Read checkbox/switch state |
-| `get_slider_value` | Read slider value |
-| `get_text_value` | Read text field value |
-
-**Debug & Monitor**
-| Tool | What it does |
-|------|-------------|
-| `get_logs` | Read application logs |
-| `get_errors` | Read application errors |
-| `get_performance` | Performance metrics |
-| `get_memory_stats` | Memory usage stats |
-
-**Multi-Session**
-| Tool | What it does |
-|------|-------------|
-| `list_sessions` | See all connected apps |
-| `switch_session` | Switch between apps |
-| `close_session` | Disconnect from an app |
-
 ---
 
 ## Example Workflows
 
-### Login Flow Test
-```
-You: "Test login with test@example.com / password123, verify it reaches the dashboard"
-```
-The AI agent will:
-1. `launch_app` or `scan_and_connect` to your app
-2. `screenshot` to see the current screen
-3. `enter_text(key: "email_field", text: "test@example.com")`
-4. `enter_text(key: "password_field", text: "password123")`
-5. `tap(text: "Login")`
-6. `wait_for_element(text: "Dashboard")`
-7. `screenshot` to confirm
-
-### Form Validation Test
-```
-You: "Submit the registration form empty and check that all validation errors appear"
-```
-
-### Navigation Test
-```
-You: "Navigate through all tabs, take a screenshot of each, and verify the back button works"
-```
-
-### Visual Regression
-```
-You: "Take screenshots of the home, profile, and settings pages - compare them with last time"
-```
-
----
-
-## Native Platform Support
+### E2E Testing with Environment Variables
+```javascript
+// Launch staging environment
+flutter-skill.launch_app({
+  project_path: "./",
+  dart_defines: ["ENV=staging", "API_URL=https://staging.api.com"],
+  flavor: "staging",
+  target: "lib/main_staging.dart"
+})
 
-Flutter Skill can interact with **native dialogs** that Flutter can't see (permission popups, photo pickers, share sheets):
+// Wait for app to load
+flutter-skill.wait_for_element({ text: "Welcome" })
 
-| Tool | iOS Simulator | Android Emulator |
-|------|--------------|-----------------|
-| `native_screenshot` | `xcrun simctl screenshot` | `adb screencap` |
-| `native_tap` | macOS Accessibility API | `adb input tap` |
-| `native_input_text` | Pasteboard + Cmd+V | `adb input text` |
-| `native_swipe` | Accessibility scroll | `adb input swipe` |
+// Take screenshot
+flutter-skill.screenshot()
 
-No external tools needed - works with built-in OS capabilities.
+// Perform login
+flutter-skill.tap({ text: "Login" })
+flutter-skill.enter_text({ key: "email_field", text: "test@example.com" })
+flutter-skill.enter_text({ key: "password_field", text: "password123" })
+flutter-skill.tap({ text: "Submit" })
 
----
+// Verify success
+flutter-skill.wait_for_element({ text: "Dashboard" })
+```
 
-## Flutter 3.x Compatibility
+### Connect to Running App
+```javascript
+// List all running Flutter apps
+flutter-skill.list_running_apps()
+// Returns: { apps: ["ws://127.0.0.1:50123/ws", ...], count: 2 }
 
-Flutter 3.x defaults to the DTD protocol. Flutter Skill auto-adds `--vm-service-port=50000` to ensure VM Service protocol is available. No manual configuration needed.
+// Auto-connect to first one
+flutter-skill.scan_and_connect()
 
-If you see "no VM Service URI" errors:
-```javascript
-// Explicitly set a port
-flutter-skill.launch_app({
-  project_path: ".",
-  extra_args: ["--vm-service-port=50000"]
-})
+// Or connect to specific one
+flutter-skill.connect_app({ uri: "ws://127.0.0.1:50123/ws" })
 ```
 
----
+### Debug a UI Issue
+```javascript
+// Get widget tree
+flutter-skill.get_widget_tree({ max_depth: 5 })
 
-## Tool Priority Setup (Claude Code)
+// Find specific widgets
+flutter-skill.find_by_type({ type: "ElevatedButton" })
 
-For Claude Code users, ensure it always uses Flutter Skill for Flutter testing:
+// Inspect interactive elements
+flutter-skill.inspect()
 
-```bash
-flutter_skill setup
+// Check if element is visible
+flutter-skill.wait_for_element({ key: "submit_button", timeout: 3000 })
 ```
 
-This installs priority rules so Claude Code automatically chooses Flutter Skill over Dart MCP, giving you full UI automation (tap, screenshot, swipe) instead of read-only inspection.
-
 ---
 
 ## IDE Extensions
 
 ### VSCode Extension
 - Auto-detects Flutter projects
+- Prompts to add `flutter_skill` dependency
+- Auto-downloads native binary
 - Status bar shows connection state
 - Commands: Launch, Inspect, Screenshot
 
-### IntelliJ / Android Studio Plugin
+### IntelliJ/Android Studio Plugin
 - Same features as VSCode
 - Integrates with IDE notifications
+- Tool window for status
 
 ---
 
@@ -396,22 +280,31 @@ This installs priority rules so Claude Code automatically chooses Flutter Skill
 
 ### "Not connected to Flutter app"
 ```javascript
-flutter-skill.get_connection_status()  // Shows suggestions
-flutter-skill.scan_and_connect()       // Auto-find running apps
+// Check status and get suggestions
+flutter-skill.get_connection_status()
+
+// This returns:
+// - Current connection state
+// - List of available apps
+// - Actionable suggestions
 ```
 
 ### "Unknown method ext.flutter.flutter_skill.xxx"
-Your app doesn't have the flutter_skill package:
+Your Flutter app doesn't have the `flutter_skill` package. Add it:
 ```bash
 flutter pub add flutter_skill
 ```
-Then restart the app (hot reload is not enough for new packages).
+Then restart the app (hot reload is not enough).
 
-### More help
-- [Usage Guide](docs/USAGE_GUIDE.md)
-- [Architecture](docs/ARCHITECTURE.md)
-- [Troubleshooting](docs/TROUBLESHOOTING.md)
-- [Flutter 3.x Fix](docs/FLUTTER_3X_FIX.md)
+### MCP server slow to start
+The native binary should auto-download. If not:
+```bash
+# For npm
+npm update -g flutter-skill
+
+# For Homebrew
+brew upgrade flutter-skill
+```
 
 ---
 
@@ -421,19 +314,7 @@ Then restart the app (hot reload is not enough for new packages).
 - [pub.dev](https://pub.dev/packages/flutter_skill)
 - [npm](https://www.npmjs.com/package/flutter-skill)
 - [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=ai-dashboad.flutter-skill)
-- [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/29991-flutter-skill)
-- [Roadmap](docs/ROADMAP.md)
-
-## Support This Project
-
-If Flutter Skill helps you build better Flutter apps, consider supporting its development:
-
-- [GitHub Sponsors](https://github.com/sponsors/ai-dashboad)
-- [Buy Me a Coffee](https://buymeacoffee.com/ai-dashboad)
-
-Your support helps maintain the project, add new features, and keep it free and open source.
-
----
+- [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/PLUGIN_ID)
 
 ## License
 

package/dart/.dart_tool/extension_discovery/README.md

@@ -0,0 +1,31 @@
+Extension Discovery Cache
+=========================
+
+This folder is used by `package:extension_discovery` to cache lists of
+packages that contains extensions for other packages.
+
+DO NOT USE THIS FOLDER
+----------------------
+
+ * Do not read (or rely) the contents of this folder.
+ * Do write to this folder.
+
+If you're interested in the lists of extensions stored in this folder use the
+API offered by package `extension_discovery` to get this information.
+
+If this package doesn't work for your use-case, then don't try to read the
+contents of this folder. It may change, and will not remain stable.
+
+Use package `extension_discovery`
+---------------------------------
+
+If you want to access information from this folder.
+
+Feel free to delete this folder
+-------------------------------
+
+Files in this folder act as a cache, and the cache is discarded if the files
+are older than the modification time of `.dart_tool/package_config.json`.
+
+Hence, it should never be necessary to clear this cache manually, if you find a
+need to do please file a bug.

package/dart/.dart_tool/extension_discovery/devtools.json

@@ -0,0 +1 @@
+{"version":2,"entries":[{"package":"flutter_skill","rootUri":"../","packageUri":"lib/"}]}

package/dart/.dart_tool/extension_discovery/vs_code.json

@@ -0,0 +1 @@
+{"version":2,"entries":[{"package":"flutter_skill","rootUri":"../","packageUri":"lib/"}]}

package/dart/.dart_tool/package_config.json

@@ -0,0 +1,196 @@
+{
+  "configVersion": 2,
+  "packages": [
+    {
+      "name": "async",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/async-2.13.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "boolean_selector",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/boolean_selector-2.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "characters",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/characters-1.4.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "clock",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/clock-1.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "collection",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/collection-1.19.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "fake_async",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/fake_async-1.3.3",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "flutter",
+      "rootUri": "file:///Users/cw/development/flutter/packages/flutter",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "flutter_test",
+      "rootUri": "file:///Users/cw/development/flutter/packages/flutter_test",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "http",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/http-1.6.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "http_parser",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/http_parser-4.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "leak_tracker",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/leak_tracker-11.0.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "leak_tracker_flutter_testing",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/leak_tracker_flutter_testing-3.0.10",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "leak_tracker_testing",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/leak_tracker_testing-3.0.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "lints",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/lints-3.0.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.0"
+    },
+    {
+      "name": "logging",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/logging-1.3.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "matcher",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/matcher-0.12.18",
+      "packageUri": "lib/",
+      "languageVersion": "3.7"
+    },
+    {
+      "name": "material_color_utilities",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/material_color_utilities-0.13.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "meta",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/meta-1.17.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "path",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/path-1.9.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "sky_engine",
+      "rootUri": "file:///Users/cw/development/flutter/bin/cache/pkg/sky_engine",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "source_span",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/source_span-1.10.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "stack_trace",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/stack_trace-1.12.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "stream_channel",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/stream_channel-2.1.4",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "string_scanner",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/string_scanner-1.4.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "term_glyph",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/term_glyph-1.2.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "test_api",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/test_api-0.7.8",
+      "packageUri": "lib/",
+      "languageVersion": "3.7"
+    },
+    {
+      "name": "typed_data",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/typed_data-1.4.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "vector_math",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/vector_math-2.2.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "vm_service",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/vm_service-14.3.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "web",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.dev/web-1.1.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "flutter_skill",
+      "rootUri": "../",
+      "packageUri": "lib/",
+      "languageVersion": "3.0"
+    }
+  ],
+  "generator": "pub",
+  "generatorVersion": "3.11.0-296.4.beta",
+  "flutterRoot": "file:///Users/cw/development/flutter",
+  "flutterVersion": "3.41.0-0.1.pre",
+  "pubCache": "file:///Users/cw/.pub-cache"
+}

package/dart/.dart_tool/package_graph.json

@@ -0,0 +1,258 @@
+{
+  "roots": [
+    "flutter_skill"
+  ],
+  "packages": [
+    {
+      "name": "flutter_skill",
+      "version": "0.2.0",
+      "dependencies": [
+        "flutter",
+        "http",
+        "logging",
+        "path",
+        "vm_service"
+      ],
+      "devDependencies": [
+        "flutter_test",
+        "lints"
+      ]
+    },
+    {
+      "name": "lints",
+      "version": "3.0.0",
+      "dependencies": []
+    },
+    {
+      "name": "flutter_test",
+      "version": "0.0.0",
+      "dependencies": [
+        "clock",
+        "collection",
+        "fake_async",
+        "flutter",
+        "leak_tracker_flutter_testing",
+        "matcher",
+        "meta",
+        "path",
+        "stack_trace",
+        "stream_channel",
+        "test_api",
+        "vector_math"
+      ]
+    },
+    {
+      "name": "logging",
+      "version": "1.3.0",
+      "dependencies": []
+    },
+    {
+      "name": "path",
+      "version": "1.9.1",
+      "dependencies": []
+    },
+    {
+      "name": "http",
+      "version": "1.6.0",
+      "dependencies": [
+        "async",
+        "http_parser",
+        "meta",
+        "web"
+      ]
+    },
+    {
+      "name": "vm_service",
+      "version": "14.3.1",
+      "dependencies": []
+    },
+    {
+      "name": "flutter",
+      "version": "0.0.0",
+      "dependencies": [
+        "characters",
+        "collection",
+        "material_color_utilities",
+        "meta",
+        "sky_engine",
+        "vector_math"
+      ]
+    },
+    {
+      "name": "stream_channel",
+      "version": "2.1.4",
+      "dependencies": [
+        "async"
+      ]
+    },
+    {
+      "name": "meta",
+      "version": "1.17.0",
+      "dependencies": []
+    },
+    {
+      "name": "collection",
+      "version": "1.19.1",
+      "dependencies": []
+    },
+    {
+      "name": "leak_tracker_flutter_testing",
+      "version": "3.0.10",
+      "dependencies": [
+        "flutter",
+        "leak_tracker",
+        "leak_tracker_testing",
+        "matcher",
+        "meta"
+      ]
+    },
+    {
+      "name": "vector_math",
+      "version": "2.2.0",
+      "dependencies": []
+    },
+    {
+      "name": "stack_trace",
+      "version": "1.12.1",
+      "dependencies": [
+        "path"
+      ]
+    },
+    {
+      "name": "clock",
+      "version": "1.1.2",
+      "dependencies": []
+    },
+    {
+      "name": "fake_async",
+      "version": "1.3.3",
+      "dependencies": [
+        "clock",
+        "collection"
+      ]
+    },
+    {
+      "name": "matcher",
+      "version": "0.12.18",
+      "dependencies": [
+        "async",
+        "meta",
+        "stack_trace",
+        "term_glyph",
+        "test_api"
+      ]
+    },
+    {
+      "name": "test_api",
+      "version": "0.7.8",
+      "dependencies": [
+        "async",
+        "boolean_selector",
+        "collection",
+        "meta",
+        "source_span",
+        "stack_trace",
+        "stream_channel",
+        "string_scanner",
+        "term_glyph"
+      ]
+    },
+    {
+      "name": "web",
+      "version": "1.1.1",
+      "dependencies": []
+    },
+    {
+      "name": "http_parser",
+      "version": "4.1.2",
+      "dependencies": [
+        "collection",
+        "source_span",
+        "string_scanner",
+        "typed_data"
+      ]
+    },
+    {
+      "name": "async",
+      "version": "2.13.0",
+      "dependencies": [
+        "collection",
+        "meta"
+      ]
+    },
+    {
+      "name": "sky_engine",
+      "version": "0.0.0",
+      "dependencies": []
+    },
+    {
+      "name": "material_color_utilities",
+      "version": "0.13.0",
+      "dependencies": [
+        "collection"
+      ]
+    },
+    {
+      "name": "characters",
+      "version": "1.4.1",
+      "dependencies": []
+    },
+    {
+      "name": "leak_tracker_testing",
+      "version": "3.0.2",
+      "dependencies": [
+        "leak_tracker",
+        "matcher",
+        "meta"
+      ]
+    },
+    {
+      "name": "leak_tracker",
+      "version": "11.0.2",
+      "dependencies": [
+        "clock",
+        "collection",
+        "meta",
+        "path",
+        "vm_service"
+      ]
+    },
+    {
+      "name": "term_glyph",
+      "version": "1.2.2",
+      "dependencies": []
+    },
+    {
+      "name": "string_scanner",
+      "version": "1.4.1",
+      "dependencies": [
+        "source_span"
+      ]
+    },
+    {
+      "name": "source_span",
+      "version": "1.10.1",
+      "dependencies": [
+        "collection",
+        "path",
+        "term_glyph"
+      ]
+    },
+    {
+      "name": "boolean_selector",
+      "version": "2.1.2",
+      "dependencies": [
+        "source_span",
+        "string_scanner"
+      ]
+    },
+    {
+      "name": "typed_data",
+      "version": "1.4.0",
+      "dependencies": [
+        "collection"
+      ]
+    }
+  ],
+  "configVersion": 1
+}

package/dart/.dart_tool/version

@@ -0,0 +1 @@
+3.41.0-0.1.pre

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

@@ -101,10 +101,7 @@ class FlutterMcpServer {
         _sendResult(id, {
           "capabilities": {"tools": {}, "resources": {}},
           "protocolVersion": "2024-11-05",
-          "serverInfo": {
-            "name": "flutter-skill",
-            "version": _currentVersion
-          },
+          "serverInfo": {"name": "flutter-skill", "version": _currentVersion},
         });
       } else if (method == 'notifications/initialized') {
         // No op

package/dart/pubspec.lock

@@ -0,0 +1,237 @@
+# Generated by pub
+# See https://dart.dev/tools/pub/glossary#lockfile
+packages:
+  async:
+    dependency: transitive
+    description:
+      name: async
+      sha256: "758e6d74e971c3e5aceb4110bfd6698efc7f501675bcfe0c775459a8140750eb"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.13.0"
+  boolean_selector:
+    dependency: transitive
+    description:
+      name: boolean_selector
+      sha256: "8aab1771e1243a5063b8b0ff68042d67334e3feab9e95b9490f9a6ebf73b42ea"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.2"
+  characters:
+    dependency: transitive
+    description:
+      name: characters
+      sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.4.1"
+  clock:
+    dependency: transitive
+    description:
+      name: clock
+      sha256: fddb70d9b5277016c77a80201021d40a2247104d9f4aa7bab7157b7e3f05b84b
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.2"
+  collection:
+    dependency: transitive
+    description:
+      name: collection
+      sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.19.1"
+  fake_async:
+    dependency: transitive
+    description:
+      name: fake_async
+      sha256: "5368f224a74523e8d2e7399ea1638b37aecfca824a3cc4dfdf77bf1fa905ac44"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.3.3"
+  flutter:
+    dependency: "direct main"
+    description: flutter
+    source: sdk
+    version: "0.0.0"
+  flutter_test:
+    dependency: "direct dev"
+    description: flutter
+    source: sdk
+    version: "0.0.0"
+  http:
+    dependency: "direct main"
+    description:
+      name: http
+      sha256: "87721a4a50b19c7f1d49001e51409bddc46303966ce89a65af4f4e6004896412"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.6.0"
+  http_parser:
+    dependency: transitive
+    description:
+      name: http_parser
+      sha256: "178d74305e7866013777bab2c3d8726205dc5a4dd935297175b19a23a2e66571"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.1.2"
+  leak_tracker:
+    dependency: transitive
+    description:
+      name: leak_tracker
+      sha256: "33e2e26bdd85a0112ec15400c8cbffea70d0f9c3407491f672a2fad47915e2de"
+      url: "https://pub.dev"
+    source: hosted
+    version: "11.0.2"
+  leak_tracker_flutter_testing:
+    dependency: transitive
+    description:
+      name: leak_tracker_flutter_testing
+      sha256: "1dbc140bb5a23c75ea9c4811222756104fbcd1a27173f0c34ca01e16bea473c1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.10"
+  leak_tracker_testing:
+    dependency: transitive
+    description:
+      name: leak_tracker_testing
+      sha256: "8d5a2d49f4a66b49744b23b018848400d23e54caf9463f4eb20df3eb8acb2eb1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.2"
+  lints:
+    dependency: "direct dev"
+    description:
+      name: lints
+      sha256: cbf8d4b858bb0134ef3ef87841abdf8d63bfc255c266b7bf6b39daa1085c4290
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.0"
+  logging:
+    dependency: "direct main"
+    description:
+      name: logging
+      sha256: c8245ada5f1717ed44271ed1c26b8ce85ca3228fd2ffdb75468ab01979309d61
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.3.0"
+  matcher:
+    dependency: transitive
+    description:
+      name: matcher
+      sha256: "12956d0ad8390bbcc63ca2e1469c0619946ccb52809807067a7020d57e647aa6"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.12.18"
+  material_color_utilities:
+    dependency: transitive
+    description:
+      name: material_color_utilities
+      sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.13.0"
+  meta:
+    dependency: transitive
+    description:
+      name: meta
+      sha256: "23f08335362185a5ea2ad3a4e597f1375e78bce8a040df5c600c8d3552ef2394"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.17.0"
+  path:
+    dependency: "direct main"
+    description:
+      name: path
+      sha256: "75cca69d1490965be98c73ceaea117e8a04dd21217b37b292c9ddbec0d955bc5"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.9.1"
+  sky_engine:
+    dependency: transitive
+    description: flutter
+    source: sdk
+    version: "0.0.0"
+  source_span:
+    dependency: transitive
+    description:
+      name: source_span
+      sha256: "254ee5351d6cb365c859e20ee823c3bb479bf4a293c22d17a9f1bf144ce86f7c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.10.1"
+  stack_trace:
+    dependency: transitive
+    description:
+      name: stack_trace
+      sha256: "8b27215b45d22309b5cddda1aa2b19bdfec9df0e765f2de506401c071d38d1b1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.12.1"
+  stream_channel:
+    dependency: transitive
+    description:
+      name: stream_channel
+      sha256: "969e04c80b8bcdf826f8f16579c7b14d780458bd97f56d107d3950fdbeef059d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.4"
+  string_scanner:
+    dependency: transitive
+    description:
+      name: string_scanner
+      sha256: "921cd31725b72fe181906c6a94d987c78e3b98c2e205b397ea399d4054872b43"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.4.1"
+  term_glyph:
+    dependency: transitive
+    description:
+      name: term_glyph
+      sha256: "7f554798625ea768a7518313e58f83891c7f5024f88e46e7182a4558850a4b8e"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.2.2"
+  test_api:
+    dependency: transitive
+    description:
+      name: test_api
+      sha256: "19a78f63e83d3a61f00826d09bc2f60e191bf3504183c001262be6ac75589fb8"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.7.8"
+  typed_data:
+    dependency: transitive
+    description:
+      name: typed_data
+      sha256: f9049c039ebfeb4cf7a7104a675823cd72dba8297f264b6637062516699fa006
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.4.0"
+  vector_math:
+    dependency: transitive
+    description:
+      name: vector_math
+      sha256: d530bd74fea330e6e364cda7a85019c434070188383e1cd8d9777ee586914c5b
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.0"
+  vm_service:
+    dependency: "direct main"
+    description:
+      name: vm_service
+      sha256: "0968250880a6c5fe7edc067ed0a13d4bae1577fe2771dcf3010d52c4a9d3ca14"
+      url: "https://pub.dev"
+    source: hosted
+    version: "14.3.1"
+  web:
+    dependency: transitive
+    description:
+      name: web
+      sha256: "868d88a33d8a87b18ffc05f9f030ba328ffefba92d6c127917a2ba740f9cfe4a"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.1"
+sdks:
+  dart: ">=3.9.0-0 <4.0.0"
+  flutter: ">=3.18.0-18.0.pre.54"

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "flutter-skill",
-  "version": "0.7.4",
+  "version": "0.7.6",
+  "mcpName": "io.github.telsav/flutter-skill",
   "description": "MCP Server for app automation - Give your AI Agent eyes and hands inside any app (Flutter, React, Web, Native)",
   "main": "index.js",
   "bin": {