@bdayadev/flutter-ultra-mcp 0.0.0 → 1.0.1

package/examples/counter-app/README.md

@@ -1,24 +1,24 @@
-# Counter App
-
-Minimal Flutter counter demonstrating `ultra_flutter` binding integration.
-
-Used as the primary E2E test fixture for the flutter-ultra-mcp plugin — all
-platform-specific CI workflows drive this app to verify gesture, runtime, and
-native automation servers.
-
-## Running
-
-```bash
-flutter run -d chrome
-```
-
-In debug mode the `UltraFlutterBinding` is automatically initialized, exposing
-`ext.flutter.ultra.*` VM service extensions that the MCP servers connect to.
-
-## Widget Keys
-
-| Key | Widget | Purpose |
-|-----|--------|---------|
-| `counter_value` | Text | Displays current count |
-| `increment` | FAB | Increments counter |
-| `decrement` | FAB | Decrements counter |
+# Counter App
+
+Minimal Flutter counter demonstrating `ultra_flutter` binding integration.
+
+Used as the primary E2E test fixture for the flutter-ultra-mcp plugin — all
+platform-specific CI workflows drive this app to verify gesture, runtime, and
+native automation servers.
+
+## Running
+
+```bash
+flutter run -d chrome
+```
+
+In debug mode the `UltraFlutterBinding` is automatically initialized, exposing
+`ext.flutter.ultra.*` VM service extensions that the MCP servers connect to.
+
+## Widget Keys
+
+| Key | Widget | Purpose |
+|-----|--------|---------|
+| `counter_value` | Text | Displays current count |
+| `increment` | FAB | Increments counter |
+| `decrement` | FAB | Decrements counter |

package/examples/counter-app/pubspec.yaml

@@ -1,23 +1,23 @@
-name: counter_app
-description: Minimal counter app demonstrating ultra_flutter binding for MCP-driven E2E testing.
-publish_to: none
-version: 1.0.0
-
-resolution: workspace
-
-environment:
-  sdk: '>=3.6.0 <4.0.0'
-  flutter: '>=3.27.0'
-
-dependencies:
-  flutter:
-    sdk: flutter
-  ultra_flutter:
-    path: ../../dart/ultra_flutter
-
-dev_dependencies:
-  flutter_test:
-    sdk: flutter
-
-flutter:
-  uses-material-design: true
+name: counter_app
+description: Minimal counter app demonstrating ultra_flutter binding for MCP-driven E2E testing.
+publish_to: none
+version: 1.0.0
+
+resolution: workspace
+
+environment:
+  sdk: '>=3.6.0 <4.0.0'
+  flutter: '>=3.27.0'
+
+dependencies:
+  flutter:
+    sdk: flutter
+  ultra_flutter:
+    path: ../../dart/ultra_flutter
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+
+flutter:
+  uses-material-design: true

package/examples/oidc-app/README.md

@@ -1,48 +1,48 @@
-# OIDC App
-
-Flutter example demonstrating OIDC PKCE authorization code flow with a mock
-identity provider, used to verify the flutter-ultra-browser MCP server's OAuth
-interception and CCT (Custom Chrome Tab) OAuth solver on mobile.
-
-## Architecture
-
-```
-[Flutter App] --launch--> [Browser: /authorize]
-                              |
-                        [Mock OIDC Server]
-                              |
-                        [302 → localhost:9981/callback]
-                              |
-[Flutter App] <--code----- [Local HTTP server]
-```
-
-## Running
-
-1. Start the mock OIDC server:
-   ```bash
-   dart run lib/mock_oidc_server.dart
-   ```
-
-2. Run the Flutter app:
-   ```bash
-   flutter run -d chrome
-   ```
-
-3. Click "Login with OIDC" — the browser server intercepts the redirect.
-
-## Widget Keys
-
-| Key | Widget | Purpose |
-|-----|--------|---------|
-| `login_button` | FilledButton | Initiates OIDC flow |
-| `logout_button` | FilledButton.tonal | Clears token |
-| `auth_status` | Text | Shows "Authenticated" or "Not authenticated" |
-| `token_preview` | SelectableText | Truncated token display |
-| `loading_indicator` | CircularProgressIndicator | During OAuth exchange |
-| `error_text` | Text | Error message |
-
-## CI Usage
-
-The `ci-e2e-web.yml` workflow starts `mock_oidc_server.dart` as a background
-process, then drives the app via Playwright to complete the full OAuth flow
-end-to-end.
+# OIDC App
+
+Flutter example demonstrating OIDC PKCE authorization code flow with a mock
+identity provider, used to verify the flutter-ultra-browser MCP server's OAuth
+interception and CCT (Custom Chrome Tab) OAuth solver on mobile.
+
+## Architecture
+
+```
+[Flutter App] --launch--> [Browser: /authorize]
+                              |
+                        [Mock OIDC Server]
+                              |
+                        [302 → localhost:9981/callback]
+                              |
+[Flutter App] <--code----- [Local HTTP server]
+```
+
+## Running
+
+1. Start the mock OIDC server:
+   ```bash
+   dart run lib/mock_oidc_server.dart
+   ```
+
+2. Run the Flutter app:
+   ```bash
+   flutter run -d chrome
+   ```
+
+3. Click "Login with OIDC" — the browser server intercepts the redirect.
+
+## Widget Keys
+
+| Key | Widget | Purpose |
+|-----|--------|---------|
+| `login_button` | FilledButton | Initiates OIDC flow |
+| `logout_button` | FilledButton.tonal | Clears token |
+| `auth_status` | Text | Shows "Authenticated" or "Not authenticated" |
+| `token_preview` | SelectableText | Truncated token display |
+| `loading_indicator` | CircularProgressIndicator | During OAuth exchange |
+| `error_text` | Text | Error message |
+
+## CI Usage
+
+The `ci-e2e-web.yml` workflow starts `mock_oidc_server.dart` as a background
+process, then drives the app via Playwright to complete the full OAuth flow
+end-to-end.

package/examples/oidc-app/pubspec.yaml

@@ -1,24 +1,24 @@
-name: oidc_app
-description: OIDC example app demonstrating browser-server OAuth flow with ultra_flutter binding.
-publish_to: none
-version: 1.0.0
-
-resolution: workspace
-
-environment:
-  sdk: '>=3.6.0 <4.0.0'
-  flutter: '>=3.27.0'
-
-dependencies:
-  flutter:
-    sdk: flutter
-  ultra_flutter:
-    path: ../../dart/ultra_flutter
-  url_launcher: ^6.3.0
-
-dev_dependencies:
-  flutter_test:
-    sdk: flutter
-
-flutter:
-  uses-material-design: true
+name: oidc_app
+description: OIDC example app demonstrating browser-server OAuth flow with ultra_flutter binding.
+publish_to: none
+version: 1.0.0
+
+resolution: workspace
+
+environment:
+  sdk: '>=3.6.0 <4.0.0'
+  flutter: '>=3.27.0'
+
+dependencies:
+  flutter:
+    sdk: flutter
+  ultra_flutter:
+    path: ../../dart/ultra_flutter
+  url_launcher: ^6.3.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+
+flutter:
+  uses-material-design: true

package/package.json

@@ -1,82 +1,82 @@
-{
-  "name": "@bdayadev/flutter-ultra-mcp",
-  "version": "0.0.0",
-  "description": "Flutter Ultra MCP plugin monorepo \u00e2\u20ac\u201d 8 MCP servers + ultra_flutter Dart packages + skills for Claude Code.",
-  "license": "Apache-2.0",
-  "homepage": "https://github.com/Bdaya-Dev/flutter-ultra-mcp",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Bdaya-Dev/flutter-ultra-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Bdaya-Dev/flutter-ultra-mcp/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "packageManager": "npm@10.9.0",
-  "workspaces": [
-    "packages/*",
-    "shared/*"
-  ],
-  "scripts": {
-    "build": "turbo run build",
-    "lint": "turbo run lint",
-    "test": "turbo run test",
-    "typecheck": "turbo run typecheck",
-    "clean": "turbo run clean && rimraf node_modules",
-    "format": "prettier --write \"**/*.{ts,tsx,js,json,md,yml,yaml}\"",
-    "format:check": "prettier --check \"**/*.{ts,tsx,js,json,md,yml,yaml}\"",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "turbo run build && changeset publish",
-    "prepare": "husky"
-  },
-  "devDependencies": {
-    "@changesets/cli": "^2.27.0",
-    "@commitlint/cli": "^19.0.0",
-    "@commitlint/config-conventional": "^19.0.0",
-    "@eslint/js": "^9.39.4",
-    "@types/node": "^22.0.0",
-    "eslint": "^9.0.0",
-    "eslint-config-prettier": "^10.1.8",
-    "husky": "^9.0.0",
-    "prettier": "^3.3.0",
-    "rimraf": "^6.0.0",
-    "turbo": "^2.3.0",
-    "typescript": "^5.6.0",
-    "typescript-eslint": "^8.59.3",
-    "vitest": "^3.2.4"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  },
-  "files": [
-    ".claude-plugin/",
-    ".mcp.json",
-    "skills/",
-    "packages/*/dist/",
-    "packages/*/package.json",
-    "packages/*/README.md",
-    "packages/*/sidecars/",
-    "shared/*/dist/",
-    "shared/*/package.json",
-    "shared/*/README.md",
-    "dart/*/lib/",
-    "dart/*/pubspec.yaml",
-    "dart/*/README.md",
-    "dart/*/CHANGELOG.md",
-    "dart/*/EXTENSIONS.md",
-    "docs/",
-    "examples/*/lib/",
-    "examples/*/pubspec.yaml",
-    "examples/*/web/",
-    "examples/*/README.md",
-    "README.md",
-    "LICENSE",
-    "CONTRIBUTING.md",
-    "SECURITY.md",
-    "CODE_OF_CONDUCT.md"
-  ]
-}
+{
+  "name": "@bdayadev/flutter-ultra-mcp",
+  "version": "1.0.1",
+  "description": "Flutter Ultra MCP plugin monorepo — 8 MCP servers + ultra_flutter Dart packages + skills for Claude Code.",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/Bdaya-Dev/flutter-ultra-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Bdaya-Dev/flutter-ultra-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Bdaya-Dev/flutter-ultra-mcp/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "npm@10.9.0",
+  "workspaces": [
+    "packages/*",
+    "shared/*"
+  ],
+  "scripts": {
+    "build": "turbo run build",
+    "lint": "turbo run lint",
+    "test": "turbo run test",
+    "typecheck": "turbo run typecheck",
+    "clean": "turbo run clean && rimraf node_modules",
+    "format": "prettier --write \"**/*.{ts,tsx,js,json,md,yml,yaml}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,json,md,yml,yaml}\"",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@eslint/js": "^9.39.4",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/exec": "7.1.0",
+    "@semantic-release/git": "10.0.1",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.0.0",
+    "prettier": "^3.3.0",
+    "rimraf": "^6.0.0",
+    "semantic-release": "25.0.3",
+    "turbo": "^2.3.0",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.59.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    ".claude-plugin/",
+    ".mcp.json",
+    "skills/",
+    "packages/*/dist/",
+    "packages/*/package.json",
+    "packages/*/README.md",
+    "packages/*/sidecars/",
+    "shared/*/dist/",
+    "shared/*/package.json",
+    "shared/*/README.md",
+    "dart/*/lib/",
+    "dart/*/pubspec.yaml",
+    "dart/*/README.md",
+    "dart/*/CHANGELOG.md",
+    "dart/*/EXTENSIONS.md",
+    "docs/",
+    "examples/*/lib/",
+    "examples/*/pubspec.yaml",
+    "examples/*/web/",
+    "examples/*/README.md",
+    "README.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md"
+  ]
+}

package/packages/flutter-ultra-browser/README.md

@@ -1,29 +1,29 @@
-# @flutter-ultra/flutter-ultra-browser
-
-MCP server for **Playwright-driven browser automation**: navigate, click, fill, screenshot, console / network capture, OAuth redirect handling, and sandboxed Playwright scripts for Flutter web apps.
-
-## Tools
-
-| Tool                                                                     | Purpose                                                                                                                                                                                           |
-| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `launch_browser` / `close_browser`                                       | Lifecycle of a single per-session browser instance                                                                                                                                                |
-| `new_context` / `new_tab`                                                | Cookie/storage-isolated contexts; pages within a context                                                                                                                                          |
-| `navigate`                                                               | `page.goto(url)` with load wait                                                                                                                                                                   |
-| `intercept_redirect` / `wait_for_url`                                    | Wait for navigation matching URL pattern; auth flows                                                                                                                                              |
-| `click` / `fill` / `press_key`                                           | Interaction primitives by selector                                                                                                                                                                |
-| `screenshot`                                                             | PNG screenshot of page or element (works on CanvasKit)                                                                                                                                            |
-| `console_logs`                                                           | One-shot read of recent console events                                                                                                                                                            |
-| `start_console_capture` / `get_console_capture` / `stop_console_capture` | **rev-23** persistent buffer of `console.*` + `pageerror` + `crash`, survives navigation, captures Dart `print()` on Flutter web within 100ms (AC-Br4)                                            |
-| `network_requests`                                                       | Recent network events for a page                                                                                                                                                                  |
-| `evaluate_js`                                                            | Run JS expression in page context, return JSON-serialized value                                                                                                                                   |
-| `run_playwright_script`                                                  | **Sandboxed** Node `vm` execution of Playwright TS/JS with `page` / `context` / `browser` / `expect` / `console` / `fetch` exposed; **no** `process`/`require`/`import`; CPU + wall-time watchdog |
-| `eval_playwright_recipe`                                                 | Run a named recipe from `${CLAUDE_PLUGIN_DATA}/recipes/*.ts`                                                                                                                                      |
-| `set_storage` / `get_storage`                                            | Pre-seed / export cookies + localStorage                                                                                                                                                          |
-| `link_to_flutter`                                                        | Associate this browser context with a Flutter sessionId (used by `/flutter:drive`)                                                                                                                |
-
-See plan §5.4 lines 596-660 for the full design, AC-Br1..AC-Br4 acceptance criteria, and `run_playwright_script` sandbox boundary rationale.
-
-State files this server owns:
-
-- `${FLUTTER_ULTRA_STATE_DIR}/browsers.json` — active browser instances and their `link_to_flutter` mappings (plan §4)
-- `${FLUTTER_ULTRA_STATE_DIR}/captures/console-<captureId>.jsonl` — append-only console event buffer per active capture (rev-23, survives server restart)
+# @flutter-ultra/flutter-ultra-browser
+
+MCP server for **Playwright-driven browser automation**: navigate, click, fill, screenshot, console / network capture, OAuth redirect handling, and sandboxed Playwright scripts for Flutter web apps.
+
+## Tools
+
+| Tool                                                                     | Purpose                                                                                                                                                                                           |
+| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `launch_browser` / `close_browser`                                       | Lifecycle of a single per-session browser instance                                                                                                                                                |
+| `new_context` / `new_tab`                                                | Cookie/storage-isolated contexts; pages within a context                                                                                                                                          |
+| `navigate`                                                               | `page.goto(url)` with load wait                                                                                                                                                                   |
+| `intercept_redirect` / `wait_for_url`                                    | Wait for navigation matching URL pattern; auth flows                                                                                                                                              |
+| `click` / `fill` / `press_key`                                           | Interaction primitives by selector                                                                                                                                                                |
+| `screenshot`                                                             | PNG screenshot of page or element (works on CanvasKit)                                                                                                                                            |
+| `console_logs`                                                           | One-shot read of recent console events                                                                                                                                                            |
+| `start_console_capture` / `get_console_capture` / `stop_console_capture` | **rev-23** persistent buffer of `console.*` + `pageerror` + `crash`, survives navigation, captures Dart `print()` on Flutter web within 100ms (AC-Br4)                                            |
+| `network_requests`                                                       | Recent network events for a page                                                                                                                                                                  |
+| `evaluate_js`                                                            | Run JS expression in page context, return JSON-serialized value                                                                                                                                   |
+| `run_playwright_script`                                                  | **Sandboxed** Node `vm` execution of Playwright TS/JS with `page` / `context` / `browser` / `expect` / `console` / `fetch` exposed; **no** `process`/`require`/`import`; CPU + wall-time watchdog |
+| `eval_playwright_recipe`                                                 | Run a named recipe from `${CLAUDE_PLUGIN_DATA}/recipes/*.ts`                                                                                                                                      |
+| `set_storage` / `get_storage`                                            | Pre-seed / export cookies + localStorage                                                                                                                                                          |
+| `link_to_flutter`                                                        | Associate this browser context with a Flutter sessionId (used by `/flutter:drive`)                                                                                                                |
+
+See plan §5.4 lines 596-660 for the full design, AC-Br1..AC-Br4 acceptance criteria, and `run_playwright_script` sandbox boundary rationale.
+
+State files this server owns:
+
+- `${FLUTTER_ULTRA_STATE_DIR}/browsers.json` — active browser instances and their `link_to_flutter` mappings (plan §4)
+- `${FLUTTER_ULTRA_STATE_DIR}/captures/console-<captureId>.jsonl` — append-only console event buffer per active capture (rev-23, survives server restart)

package/packages/flutter-ultra-browser/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "@flutter-ultra/flutter-ultra-browser",
-  "version": "0.0.0",
-  "private": true,
-  "description": "MCP server for Playwright-driven browser automation: OAuth redirects, popups, console capture, network, sandboxed JS.",
-  "license": "Apache-2.0",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "flutter-ultra-browser": "dist/bin.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -b",
-    "lint": "eslint src",
-    "test": "vitest run",
-    "typecheck": "tsc -b --noEmit",
-    "clean": "rimraf dist .turbo *.tsbuildinfo"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
-    "playwright-core": "^1.49.0",
-    "proper-lockfile": "^4.1.2",
-    "superjson": "^2.2.1",
-    "zod": "^3.23.8",
-    "zod-to-json-schema": "^3.23.5"
-  },
-  "devDependencies": {
-    "@types/proper-lockfile": "^4.1.4",
-    "playwright": "^1.49.0",
-    "rimraf": "^6.0.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "@flutter-ultra/flutter-ultra-browser",
+  "version": "0.0.0",
+  "private": true,
+  "description": "MCP server for Playwright-driven browser automation: OAuth redirects, popups, console capture, network, sandboxed JS.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "flutter-ultra-browser": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "typecheck": "tsc -b --noEmit",
+    "clean": "rimraf dist .turbo *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "playwright-core": "^1.49.0",
+    "proper-lockfile": "^4.1.2",
+    "superjson": "^2.2.1",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.23.5"
+  },
+  "devDependencies": {
+    "@types/proper-lockfile": "^4.1.4",
+    "playwright": "^1.49.0",
+    "rimraf": "^6.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}