chrome-devtools-mcp-for-extension 0.6.3 → 0.6.4

package/README.md

@@ -25,19 +25,6 @@ AI-powered Chrome extension development with automated testing, debugging, and W
 
 ---
 
-## 📊 How It Compares
-
-| Feature | This Tool | Puppeteer/Playwright | Original chrome-devtools-mcp |
-|---------|-----------|----------------------|------------------------------|
-| Extension Support | ✅ Always enabled | ❌ Disabled by default | ⚠️ Manual config required |
-| Setup Required | ❌ None | ✅ Complex config files | ✅ Multiple flags needed |
-| Real User Profile | ✅ Direct access | ❌ Temporary profiles | ⚠️ Optional |
-| Profile Copying | ❌ No copying needed | ⚠️ Manual setup | ⚠️ Manual setup |
-| Web Store Automation | ✅ Built-in | ❌ None | ❌ None |
-| Extension Debugging | ✅ Service worker + console | ⚠️ Limited | ❌ None |
-
----
-
 ## 🚀 Quick Start
 
 ### 1. Install (30 seconds)
@@ -47,14 +34,10 @@ AI-powered Chrome extension development with automated testing, debugging, and W
 claude mcp add --scope user chrome-devtools-extension npx chrome-devtools-mcp-for-extension@latest
 ```
 
-<details>
 <summary>Other MCP clients (Cursor, VS Code Copilot, Cline)</summary>
 
 Add to your MCP configuration file:
 
-**Cursor**: `~/.cursor/extensions_config.json`
-**VS Code Copilot**: `.vscode/settings.json`
-
 ```json
 {
   "mcpServers": {
@@ -66,7 +49,6 @@ Add to your MCP configuration file:
 }
 ```
 
-</details>
 
 ### 2. Restart your AI client
 
@@ -79,39 +61,6 @@ See [Common Workflows](#-common-workflows) below for typical use cases
 
 ---
 
-## 💡 See The Difference
-
-### Traditional Approach (Puppeteer)
-```javascript
-// ❌ Complex 15+ line setup
-const browser = await puppeteer.launch({
-  headless: false,
-  args: [
-    '--disable-extensions-except=/path/to/your/extension',
-    '--load-extension=/path/to/your/extension',
-    '--user-data-dir=/tmp/test-profile',
-    // ... 10+ more flags
-  ],
-  ignoreDefaultArgs: ['--disable-extensions'],
-});
-// Still doesn't use your real Chrome environment!
-```
-
-### Zero-Config Approach (This Tool)
-```bash
-# ✅ One command
-claude mcp add chrome-devtools-extension npx chrome-devtools-mcp-for-extension@latest
-
-# Then just ask:
-"Test my extension on youtube.com"
-"Debug why my content script isn't working"
-"Submit my extension to Chrome Web Store"
-
-# That's it! Uses your actual Chrome with all your extensions
-```
-
----
-
 ## ✨ Core Capabilities
 
 - 🧩 **Extension Development**: Load, debug, and reload Chrome extensions during development
@@ -166,6 +115,21 @@ Quick reference for the 3 core extension tools:
 | `reload_extension` | Hot-reload during development | "Reload my-extension" |
 | `inspect_service_worker` | Debug background scripts | "Debug service worker for my-extension" |
 
+
+---
+
+## 📊 How It Compares
+
+| Feature | This Tool | Puppeteer/Playwright | Original chrome-devtools-mcp |
+|---------|-----------|----------------------|------------------------------|
+| Extension Support | ✅ Always enabled | ❌ Disabled by default | ⚠️ Manual config required |
+| Setup Required | ❌ None | ✅ Complex config files | ✅ Multiple flags needed |
+| Real User Profile | ✅ Direct access | ❌ Temporary profiles | ⚠️ Optional |
+| Profile Copying | ❌ No copying needed | ⚠️ Manual setup | ⚠️ Manual setup |
+| Web Store Automation | ✅ Built-in | ❌ None | ❌ None |
+| Extension Debugging | ✅ Service worker + console | ⚠️ Limited | ❌ None |
+
+---
 <details>
 <summary>📖 Detailed Tool Documentation</summary>
 
@@ -481,9 +445,27 @@ interface ManifestValidation {
 
 ## Profile Lock Conflicts
 
-**Error: "User Data Directory is already in use"**
-- Close regular Chrome before starting MCP server
-- Or use `--isolated` flag for separate profile
+**Error: "Chrome is already using this profile"**
+
+This error occurs when Chrome is already running with the system profile. The MCP server detects profile lock files and fails immediately to prevent conflicts.
+
+**Solution:**
+1. **Close all Chrome windows** - The simplest solution is to completely quit Chrome before starting the MCP server
+2. **Use isolated profile** - Run with `--isolated` flag to use a temporary profile:
+   ```bash
+   npx chrome-devtools-mcp-for-extension@latest --isolated
+   ```
+3. **Use custom profile** - Specify a custom profile directory:
+   ```bash
+   npx chrome-devtools-mcp-for-extension@latest --userDataDir=/path/to/custom/profile
+   ```
+
+**Why This Happens:**
+- Chrome creates lock files (`SingletonLock`, `SingletonCookie`, `SingletonSocket`) when a profile is in use
+- Multiple Chrome instances cannot share the same profile simultaneously
+- The MCP server now detects these locks early and fails fast with a clear error message
+
+**Note:** Previous versions silently fell back to a temporary profile, which caused confusion. Version 0.6.4+ fails immediately with a clear error instead.
 
 </details>
 

package/build/src/browser.js

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import fs from 'node:fs';
-import { promises as fsPromises } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import puppeteer from 'puppeteer-core';
@@ -43,6 +42,33 @@ async function ensureBrowserConnected(browserURL) {
     });
     return browser;
 }
+/**
+ * Get the last used Chrome profile directory name from Local State
+ */
+function getLastUsedProfile(userDataDir) {
+    const localStatePath = path.join(userDataDir, 'Local State');
+    try {
+        const localStateContent = fs.readFileSync(localStatePath, 'utf8');
+        const localState = JSON.parse(localStateContent);
+        return localState?.profile?.last_used || 'Default';
+    }
+    catch (error) {
+        console.warn(`Could not read Local State: ${error instanceof Error ? error.message : String(error)}`);
+        return 'Default';
+    }
+}
+/**
+ * Check if Chrome profile is already in use (locked)
+ * Throws an error if the profile is locked
+ */
+function assertProfileNotInUse(userDataDir) {
+    const lockFiles = ['SingletonLock', 'SingletonCookie', 'SingletonSocket'];
+    const hasLock = lockFiles.some(lockFile => fs.existsSync(path.join(userDataDir, lockFile)));
+    if (hasLock) {
+        throw new Error(`Chrome is already using this profile: ${userDataDir}\n` +
+            `Please close Chrome and try again.`);
+    }
+}
 function scanExtensionsDirectory(extensionsDir) {
     const extensionPaths = [];
     try {
@@ -234,6 +260,7 @@ export async function launch(options) {
         : 'chrome-profile';
     let userDataDir = options.userDataDir;
     let usingSystemProfile = false;
+    let profileDirectory = 'Default';
     if (!isolated && !userDataDir) {
         // Try to use system Chrome profile directly
         const systemProfile = detectSystemChromeProfile(channel) || detectAnySystemChromeProfile();
@@ -241,9 +268,13 @@ export async function launch(options) {
             // Use system profile directly for better user experience
             userDataDir = systemProfile.path;
             usingSystemProfile = true;
+            // Check if profile is already in use
+            assertProfileNotInUse(userDataDir);
+            // Detect last used profile directory
+            profileDirectory = getLastUsedProfile(userDataDir);
             console.error(`✅ Using system Chrome profile: ${systemProfile.channel}`);
             console.error(`   Path: ${userDataDir}`);
-            console.error(`   ⚠️  Note: Close regular Chrome if you encounter issues`);
+            console.error(`   Profile Directory: ${profileDirectory}`);
         }
         else {
             // Fallback to isolated profile if no system Chrome found
@@ -256,7 +287,7 @@ export async function launch(options) {
     }
     const args = [
         '--hide-crash-restore-bubble',
-        '--profile-directory=Default', // Ensure we use the Default profile
+        `--profile-directory=${profileDirectory}`,
     ];
     if (customDevTools) {
         args.push(`--custom-devtools-frontend=file://${customDevTools}`);
@@ -333,6 +364,7 @@ export async function launch(options) {
     console.error(`  Channel: ${puppeterChannel || 'default'}`);
     console.error(`  Executable: ${executablePath || 'auto-detected'}`);
     console.error(`  User Data Dir: ${userDataDir || 'temporary'}`);
+    console.error(`  Profile Directory: ${profileDirectory}`);
     console.error(`  Profile Type: ${usingSystemProfile ? 'System Profile (auto-detected)' : 'Custom Profile'}`);
     console.error(`  Headless: ${headless}`);
     console.error(`  Args: ${JSON.stringify(args, null, 2)}`);
@@ -349,6 +381,11 @@ export async function launch(options) {
             args,
             ignoreDefaultArgs: ['--disable-extensions', '--enable-automation'],
         });
+        // Log actual spawn args for debugging
+        const spawnArgs = browser.process()?.spawnargs;
+        if (spawnArgs) {
+            console.error(`Actual spawn args: ${spawnArgs.join(' ')}`);
+        }
         if (options.logFile) {
             // FIXME: we are probably subscribing too late to catch startup logs. We
             // should expose the process earlier or expose the getRecentLogs() getter.
@@ -424,55 +461,17 @@ export async function launch(options) {
         return browser;
     }
     catch (error) {
-        // When system profile is already in use, create a minimal copy for automation
-        if (usingSystemProfile &&
-            (error.message.includes('The browser is already running') ||
-                error.message.includes('Target closed') ||
-                error.message.includes('Connection closed'))) {
-            console.error(`⚠️  Chrome is already running with system profile.`);
-            console.error(`📋 Creating a temporary copy of system profile for automation...`);
-            // Create a temporary copy of the system profile
-            const tempProfileDir = path.join(os.tmpdir(), `chrome-mcp-${Date.now()}`);
-            try {
-                // Copy only essential data (bookmarks, extensions) without locking files
-                await fsPromises.mkdir(tempProfileDir, { recursive: true });
-                // Copy bookmarks if they exist
-                const bookmarksPath = path.join(userDataDir, 'Default', 'Bookmarks');
-                try {
-                    await fsPromises.access(bookmarksPath);
-                    const bookmarksDestDir = path.join(tempProfileDir, 'Default');
-                    await fsPromises.mkdir(bookmarksDestDir, { recursive: true });
-                    await fsPromises.copyFile(bookmarksPath, path.join(bookmarksDestDir, 'Bookmarks'));
-                    console.error(`✅ Bookmarks copied from system profile`);
-                }
-                catch {
-                    // Bookmarks don't exist or can't be accessed, skip
-                }
-                // Retry with the temporary profile by recursively calling launch
-                console.error(`🔄 Retrying with temporary profile copy...`);
-                const retryOptions = { ...options };
-                retryOptions.userDataDir = tempProfileDir;
-                return launch(retryOptions);
-            }
-            catch (copyError) {
-                console.error(`❌ Failed to create temporary profile copy: ${copyError}`);
-                // Fall through to regular error handling
-            }
-        }
-        // For non-system profiles, maintain the blocking behavior
-        if (!usingSystemProfile &&
-            userDataDir &&
-            (error.message.includes('The browser is already running') ||
-                error.message.includes('Target closed') ||
-                error.message.includes('Connection closed'))) {
-            throw new Error(`The browser is already running for custom profile: ${userDataDir}. Use --isolated to run multiple browser instances.`, {
-                cause: error,
-            });
-        }
-        // If system profile failed for other reasons, suggest fallback options
+        // Fail fast with clear error message - no silent fallback
+        console.error(`❌ Failed to launch Chrome`);
+        console.error(`   User Data Dir: ${userDataDir}`);
+        console.error(`   Profile Directory: ${profileDirectory}`);
+        console.error(`   Error: ${error instanceof Error ? error.message : String(error)}`);
         if (usingSystemProfile) {
-            console.error(`❌ Failed to launch Chrome with system profile: ${userDataDir}`);
-            console.error(`💡 Suggestion: Try with --isolated flag for temporary profile, or --userDataDir to specify custom location`);
+            console.error('');
+            console.error('💡 Troubleshooting:');
+            console.error('   1. Close all Chrome windows and try again');
+            console.error('   2. Use --isolated flag to use temporary profile');
+            console.error('   3. Use --userDataDir to specify custom profile location');
         }
         throw error;
     }

package/build/src/tools/bookmarks.js

@@ -110,63 +110,40 @@ function loadChromeBookmarks() {
     }
 }
 /**
- * Get all bookmarks: merged Chrome bookmarks with default fallback
+ * Get all bookmarks: returns only default development bookmarks for privacy
+ * User's personal Chrome bookmarks are not loaded to protect privacy
  */
 function getBookmarks() {
-    const defaultBookmarks = getDefaultBookmarks();
-    const chromeBookmarks = loadChromeBookmarks();
-    // Merge bookmarks: Chrome bookmarks take precedence, but defaults are always included
-    return {
-        ...defaultBookmarks,
-        ...chromeBookmarks
-    };
+    return getDefaultBookmarks();
 }
 export const listBookmarks = defineTool({
     name: 'list_bookmarks',
-    description: `List all available bookmarks including both Chrome bookmarks from the user's profile and default development bookmarks. Automatically loads bookmarks from Chrome's bookmark file and merges them with predefined development URLs.`,
+    description: `List all available bookmarks. Returns hardcoded development bookmarks only. User's personal Chrome bookmarks are not loaded to protect privacy.`,
     annotations: {
         category: ToolCategories.NAVIGATION_AUTOMATION,
         readOnlyHint: true,
     },
     schema: {},
     handler: async (_request, response, _context) => {
-        const defaultBookmarks = getDefaultBookmarks();
-        const chromeBookmarks = loadChromeBookmarks();
         const allBookmarks = getBookmarks();
         const bookmarkNames = Object.keys(allBookmarks);
         if (bookmarkNames.length === 0) {
             response.appendResponseLine('No bookmarks configured.');
-            response.appendResponseLine('');
-            response.appendResponseLine('💡 **Tip:** Chrome bookmarks could not be loaded. Check if Chrome is installed and has bookmarks.');
             return;
         }
-        response.appendResponseLine('📚 **Available Bookmarks:**');
-        response.appendResponseLine('');
-        // Show loading status
-        const chromeBookmarkCount = Object.keys(chromeBookmarks).length;
-        const defaultBookmarkCount = Object.keys(defaultBookmarks).length;
-        if (chromeBookmarkCount > 0) {
-            response.appendResponseLine(`✅ Loaded ${chromeBookmarkCount} bookmarks from Chrome profile${chromeBookmarkCount >= 100 ? ' (limited to 100)' : ''}`);
-            response.appendResponseLine(`📋 ${defaultBookmarkCount} default development bookmarks included`);
-        }
-        else {
-            response.appendResponseLine(`⚠️  Could not load Chrome bookmarks, using ${defaultBookmarkCount} default bookmarks`);
-        }
+        response.appendResponseLine('📚 **Available Development Bookmarks:**');
         response.appendResponseLine('');
         bookmarkNames.forEach(name => {
             const url = allBookmarks[name];
-            const source = chromeBookmarks[name] ? '🌐' : '🔧';
-            response.appendResponseLine(`${source} **${name}**: ${url}`);
+            response.appendResponseLine(`🔧 **${name}**: ${url}`);
         });
         response.appendResponseLine('');
-        response.appendResponseLine('**Legend:** 🌐 = Chrome bookmark, 🔧 = Default bookmark');
-        response.appendResponseLine('');
         response.appendResponseLine(`Use \`navigate_bookmark name="<bookmark_name>"\` to navigate to any of these URLs.`);
     },
 });
 export const navigateBookmark = defineTool({
     name: 'navigate_bookmark',
-    description: `Navigate to a bookmark URL from Chrome bookmarks or default development bookmarks. Automatically includes bookmarks from the user's Chrome profile merged with predefined development resources.`,
+    description: `Navigate to a bookmark URL from default development bookmarks. User's personal Chrome bookmarks are not loaded to protect privacy.`,
     annotations: {
         category: ToolCategories.NAVIGATION_AUTOMATION,
         readOnlyHint: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp-for-extension",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "MCP server for Chrome extension development with Web Store automation. Fork of chrome-devtools-mcp with extension-specific tools.",
   "type": "module",
   "bin": "./build/src/index.js",

package/build/src/tools/webstore-auto-screenshot.js

@@ -1,159 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import z from 'zod';
-import { ToolCategories } from './categories.js';
-import { defineTool } from './ToolDefinition.js';
-// Tool for generating extension screenshots automatically
-export const generateExtensionScreenshots = defineTool({
-    name: 'generate_extension_screenshots',
-    description: `Automatically generate screenshots for Chrome Web Store submission`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionPath: z.string().describe('Path to the extension directory'),
-        extensionId: z.string().optional().describe('Extension ID if already installed'),
-    },
-    handler: async (request, response, context) => {
-        const { extensionPath, extensionId } = request.params;
-        const screenshotsDir = path.join(path.dirname(extensionPath), 'screenshots');
-        // Create screenshots directory
-        if (!fs.existsSync(screenshotsDir)) {
-            fs.mkdirSync(screenshotsDir, { recursive: true });
-        }
-        const page = context.getSelectedPage();
-        response.appendResponseLine('📸 **Generating Extension Screenshots**');
-        response.appendResponseLine('='.repeat(40));
-        response.appendResponseLine('');
-        try {
-            // Set viewport to Chrome Web Store recommended size
-            await page.setViewport({ width: 1280, height: 800 });
-            // Screenshot 1: Extension in action on a popular website
-            response.appendResponseLine('1️⃣ Taking screenshot of extension in action...');
-            // Navigate to a demo page
-            await page.goto('https://www.example.com', { waitUntil: 'networkidle0' });
-            // If extension has a popup, try to capture it
-            if (extensionId) {
-                // Open extension popup if possible
-                const extensionUrl = `chrome-extension://${extensionId}/popup.html`;
-                // Try to open popup in new tab for screenshot
-                const popupPage = await page.browser().newPage();
-                await popupPage.setViewport({ width: 1280, height: 800 });
-                try {
-                    await popupPage.goto(extensionUrl, { waitUntil: 'networkidle0' });
-                    // Take screenshot of popup
-                    const popupScreenshot = await popupPage.screenshot({
-                        type: 'png',
-                        fullPage: false,
-                    });
-                    const popupPath = path.join(screenshotsDir, 'screenshot-1-popup.png');
-                    fs.writeFileSync(popupPath, popupScreenshot);
-                    response.appendResponseLine(`✅ Popup screenshot saved: ${popupPath}`);
-                    await popupPage.close();
-                }
-                catch (error) {
-                    response.appendResponseLine(`⚠️ Could not capture popup: ${error}`);
-                }
-            }
-            // Screenshot 2: Extension toolbar icon
-            response.appendResponseLine('2️⃣ Taking screenshot with extension icon visible...');
-            // Navigate to chrome://extensions to show the extension
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            const extensionsScreenshot = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const extensionsPath = path.join(screenshotsDir, 'screenshot-2-extensions.png');
-            fs.writeFileSync(extensionsPath, extensionsScreenshot);
-            response.appendResponseLine(`✅ Extensions page screenshot saved: ${extensionsPath}`);
-            // Screenshot 3: Options page (if exists)
-            response.appendResponseLine('3️⃣ Taking screenshot of options page...');
-            if (extensionId) {
-                const optionsUrl = `chrome-extension://${extensionId}/options.html`;
-                try {
-                    await page.goto(optionsUrl, { waitUntil: 'networkidle0' });
-                    const optionsScreenshot = await page.screenshot({
-                        type: 'png',
-                        fullPage: false,
-                    });
-                    const optionsPath = path.join(screenshotsDir, 'screenshot-3-options.png');
-                    fs.writeFileSync(optionsPath, optionsScreenshot);
-                    response.appendResponseLine(`✅ Options page screenshot saved: ${optionsPath}`);
-                }
-                catch (error) {
-                    response.appendResponseLine(`⚠️ No options page found`);
-                }
-            }
-            // Screenshot 4: Extension working on a real website
-            response.appendResponseLine('4️⃣ Taking screenshot on a real website...');
-            // Navigate to a website where the extension might be useful
-            await page.goto('https://www.google.com', { waitUntil: 'networkidle0' });
-            await new Promise(resolve => setTimeout(resolve, 2000));
-            const websiteScreenshot = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const websitePath = path.join(screenshotsDir, 'screenshot-4-website.png');
-            fs.writeFileSync(websitePath, websiteScreenshot);
-            response.appendResponseLine(`✅ Website screenshot saved: ${websitePath}`);
-            // Generate promotional images (smaller versions)
-            response.appendResponseLine('');
-            response.appendResponseLine('5️⃣ Generating promotional images...');
-            // Small promo tile: 440x280
-            await page.setViewport({ width: 440, height: 280 });
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const smallPromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const smallPromoPath = path.join(screenshotsDir, 'promo-small-440x280.png');
-            fs.writeFileSync(smallPromoPath, smallPromo);
-            response.appendResponseLine(`✅ Small promo tile saved: ${smallPromoPath}`);
-            // Large promo tile: 920x680
-            await page.setViewport({ width: 920, height: 680 });
-            const largePromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const largePromoPath = path.join(screenshotsDir, 'promo-large-920x680.png');
-            fs.writeFileSync(largePromoPath, largePromo);
-            response.appendResponseLine(`✅ Large promo tile saved: ${largePromoPath}`);
-            // Marquee promo: 1400x560
-            await page.setViewport({ width: 1400, height: 560 });
-            const marqueePromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const marqueePromoPath = path.join(screenshotsDir, 'promo-marquee-1400x560.png');
-            fs.writeFileSync(marqueePromoPath, marqueePromo);
-            response.appendResponseLine(`✅ Marquee promo saved: ${marqueePromoPath}`);
-            response.appendResponseLine('');
-            response.appendResponseLine('='.repeat(40));
-            response.appendResponseLine('✅ **Screenshots Generated Successfully!**');
-            response.appendResponseLine('');
-            response.appendResponseLine(`📁 Screenshots saved in: ${screenshotsDir}`);
-            response.appendResponseLine('');
-            response.appendResponseLine('**Chrome Web Store Requirements:**');
-            response.appendResponseLine('• Screenshots: 1280x800 or 640x400 (PNG or JPG)');
-            response.appendResponseLine('• Small promo tile: 440x280');
-            response.appendResponseLine('• Large promo tile: 920x680');
-            response.appendResponseLine('• Marquee promo: 1400x560');
-            response.appendResponseLine('');
-            response.appendResponseLine('💡 **Tip:** Edit these screenshots to highlight your extension features!');
-        }
-        catch (error) {
-            response.appendResponseLine(`❌ Error generating screenshots: ${error}`);
-        }
-        finally {
-            // Reset viewport
-            await page.setViewport({ width: 1280, height: 800 });
-        }
-    },
-});

package/build/src/tools/webstore-submission.js

@@ -1,332 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import archiver from 'archiver';
-import z from 'zod';
-import { ToolCategories } from './categories.js';
-import { defineTool } from './ToolDefinition.js';
-// Main submission tool - now with browser automation!
-export const submitToWebStore = defineTool({
-    name: 'submit_to_webstore',
-    description: `Automatically submit a Chrome extension to the Web Store using browser automation`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionPath: z.string().describe('Path to the extension directory'),
-        autoSubmit: z.boolean().optional().default(false).describe('Automatically submit via browser (requires login)'),
-    },
-    handler: async (request, response, context) => {
-        const { extensionPath } = request.params;
-        const outputPath = path.join(path.dirname(extensionPath), `${path.basename(extensionPath)}-submission.zip`);
-        response.appendResponseLine('🚀 **Chrome Web Store Submission Process**');
-        response.appendResponseLine('='.repeat(40));
-        response.appendResponseLine('');
-        // Step 1: Validate manifest
-        response.appendResponseLine('**Step 1: Validating manifest.json...**');
-        const manifestPath = path.join(extensionPath, 'manifest.json');
-        let manifest;
-        let manifestValid = true;
-        try {
-            if (!fs.existsSync(manifestPath)) {
-                response.appendResponseLine('❌ manifest.json not found');
-                return;
-            }
-            const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
-            manifest = JSON.parse(manifestContent);
-            // Validation checks
-            const errors = [];
-            const warnings = [];
-            const suggestions = [];
-            // Required fields
-            if (manifest.manifest_version !== 3) {
-                errors.push('Must use Manifest V3 (manifest_version: 3)');
-                manifestValid = false;
-            }
-            if (!manifest.name || manifest.name.length > 45) {
-                errors.push('Name is required and must be <= 45 characters');
-                manifestValid = false;
-            }
-            if (!manifest.version || !/^\d+\.\d+\.\d+(\.\d+)?$/.test(manifest.version)) {
-                errors.push('Version must follow format: 1.0.0 or 1.0.0.0');
-                manifestValid = false;
-            }
-            if (!manifest.description || manifest.description.length > 132) {
-                warnings.push('Description should be provided and <= 132 characters');
-            }
-            // Icons
-            if (!manifest.icons || !manifest.icons['128']) {
-                warnings.push('Should include 128x128 icon');
-            }
-            // Permissions check
-            const dangerousPermissions = [
-                'debugger',
-                'devtools',
-                'management',
-                'privacy',
-                'proxy',
-                'system.cpu',
-                'system.memory',
-                'vpnProvider',
-            ];
-            const usedDangerousPerms = manifest.permissions?.filter(p => dangerousPermissions.includes(p)) || [];
-            if (usedDangerousPerms.length > 0) {
-                warnings.push(`Uses sensitive permissions: ${usedDangerousPerms.join(', ')}`);
-            }
-            // Host permissions
-            if (manifest.host_permissions?.includes('<all_urls>')) {
-                warnings.push('Using <all_urls> requires strong justification');
-            }
-            // Service worker check
-            if (manifest.background?.service_worker) {
-                const swPath = path.join(extensionPath, manifest.background.service_worker);
-                if (!fs.existsSync(swPath)) {
-                    errors.push(`Service worker file not found: ${manifest.background.service_worker}`);
-                    manifestValid = false;
-                }
-            }
-            // Suggestions
-            if (!manifest.icons?.['16'] || !manifest.icons?.['48']) {
-                suggestions.push('Consider adding 16x16 and 48x48 icons');
-            }
-            // Display results
-            if (manifestValid) {
-                response.appendResponseLine('✅ Manifest is valid');
-            }
-            else {
-                response.appendResponseLine('❌ Manifest has errors');
-            }
-            if (errors.length > 0) {
-                response.appendResponseLine('\n**Errors:**');
-                errors.forEach(err => response.appendResponseLine(`- ❌ ${err}`));
-            }
-            if (warnings.length > 0) {
-                response.appendResponseLine('\n**Warnings:**');
-                warnings.forEach(warn => response.appendResponseLine(`- ⚠️ ${warn}`));
-            }
-            if (suggestions.length > 0) {
-                response.appendResponseLine('\n**Suggestions:**');
-                suggestions.forEach(sug => response.appendResponseLine(`- 💡 ${sug}`));
-            }
-        }
-        catch (error) {
-            response.appendResponseLine(`❌ Failed to parse manifest: ${error}`);
-            return;
-        }
-        if (!manifestValid) {
-            response.appendResponseLine('');
-            response.appendResponseLine('❌ **Submission blocked:** Fix manifest errors first');
-            return;
-        }
-        response.appendResponseLine('');
-        // Step 2: Generate store listing
-        response.appendResponseLine('**Step 2: Generating store listing...**');
-        let description = `${manifest.name} is a Chrome extension that ${manifest.description || 'enhances your browsing experience'}.\n\n`;
-        description += '## Features\n\n';
-        // Infer features from permissions
-        if (manifest.permissions?.includes('tabs')) {
-            description += '• Manage and organize your browser tabs\n';
-        }
-        if (manifest.permissions?.includes('storage')) {
-            description += '• Save your preferences and settings\n';
-        }
-        if (manifest.permissions?.includes('notifications')) {
-            description += '• Receive helpful notifications\n';
-        }
-        if (manifest.content_scripts) {
-            description += '• Enhance website functionality\n';
-        }
-        if (manifest.action?.default_popup) {
-            description += '• Quick access from toolbar\n';
-        }
-        // Guess category
-        const { permissions = [], host_permissions = [] } = manifest;
-        let category = 'Productivity'; // Default
-        if (permissions.includes('tabs') || permissions.includes('bookmarks')) {
-            category = 'Productivity';
-        }
-        else if (permissions.includes('downloads')) {
-            category = 'Tools';
-        }
-        else if (host_permissions.some(h => h.includes('youtube') || h.includes('video'))) {
-            category = 'Entertainment';
-        }
-        else if (host_permissions.some(h => h.includes('facebook') || h.includes('twitter'))) {
-            category = 'Social & Communication';
-        }
-        response.appendResponseLine(`**Name:** ${manifest.name}`);
-        response.appendResponseLine(`**Summary:** ${manifest.description || `${manifest.name} - Chrome Extension`}`);
-        response.appendResponseLine(`**Category:** ${category}`);
-        response.appendResponseLine('');
-        response.appendResponseLine('**Generated Description Preview:**');
-        response.appendResponseLine(description.substring(0, 200) + '...');
-        response.appendResponseLine('');
-        // Step 3: Create submission package
-        response.appendResponseLine('**Step 3: Creating submission package...**');
-        try {
-            await new Promise((resolve, reject) => {
-                const output = fs.createWriteStream(outputPath);
-                const archive = archiver('zip', {
-                    zlib: { level: 9 } // Maximum compression
-                });
-                output.on('close', () => {
-                    const sizeKB = (archive.pointer() / 1024).toFixed(2);
-                    response.appendResponseLine(`📦 Package created: ${outputPath}`);
-                    response.appendResponseLine(`   Size: ${sizeKB} KB`);
-                    resolve();
-                });
-                archive.on('error', (err) => {
-                    response.appendResponseLine(`❌ Failed to create package: ${err}`);
-                    reject(err);
-                });
-                archive.pipe(output);
-                // Add extension files, excluding unnecessary ones
-                archive.glob('**/*', {
-                    cwd: extensionPath,
-                    ignore: [
-                        'node_modules/**',
-                        '.git/**',
-                        '.gitignore',
-                        '*.map',
-                        '.DS_Store',
-                        'Thumbs.db',
-                        '*.log',
-                        'test/**',
-                        'tests/**',
-                        'docs/**',
-                    ],
-                });
-                archive.finalize();
-            });
-            response.appendResponseLine('✅ Package created successfully!');
-        }
-        catch (error) {
-            response.appendResponseLine(`❌ Failed to create package: ${error}`);
-            return;
-        }
-        response.appendResponseLine('');
-        response.appendResponseLine('='.repeat(40));
-        response.appendResponseLine('**📋 Final Checklist:**');
-        response.appendResponseLine('');
-        response.appendResponseLine('Before submitting to Chrome Web Store:');
-        response.appendResponseLine('1. ✅ Manifest validated');
-        response.appendResponseLine('2. ✅ ZIP package created');
-        response.appendResponseLine('3. ⬜ Add screenshots (1280x800 recommended)');
-        response.appendResponseLine('4. ⬜ Add promotional images');
-        response.appendResponseLine('5. ⬜ Write privacy policy (if needed)');
-        response.appendResponseLine('6. ⬜ Pay $5 developer registration fee (first time only)');
-        response.appendResponseLine('');
-        response.appendResponseLine('**Submit at:** https://chrome.google.com/webstore/devconsole');
-        // Step 4: Auto-submit via browser automation
-        if (request.params.autoSubmit) {
-            response.appendResponseLine('');
-            response.appendResponseLine('='.repeat(40));
-            response.appendResponseLine('**🤖 Step 4: Automated Browser Submission**');
-            response.appendResponseLine('');
-            const page = context.getSelectedPage();
-            try {
-                // Navigate to Chrome Web Store Developer Dashboard
-                response.appendResponseLine('Navigating to Developer Dashboard...');
-                await page.goto('https://chrome.google.com/webstore/devconsole', {
-                    waitUntil: 'networkidle0',
-                });
-                // Check if user is logged in
-                await new Promise(resolve => setTimeout(resolve, 2000));
-                const currentUrl = page.url();
-                if (currentUrl.includes('accounts.google.com')) {
-                    response.appendResponseLine('⚠️ Login required. Please log in manually.');
-                    response.appendResponseLine('After logging in, run this command again.');
-                    return;
-                }
-                // Check if this is a new submission or update
-                response.appendResponseLine('Checking for existing extensions...');
-                // Look for "Add new item" button
-                const addNewButton = await page.$('button[aria-label="Add new item"], a[href*="register"]');
-                if (addNewButton) {
-                    response.appendResponseLine('Creating new extension submission...');
-                    await addNewButton.click();
-                    await page.waitForNavigation({ waitUntil: 'networkidle0' });
-                }
-                else {
-                    response.appendResponseLine('❌ Could not find "Add new item" button');
-                    response.appendResponseLine('Please ensure you are on the Developer Dashboard');
-                    return;
-                }
-                // Upload the ZIP file
-                response.appendResponseLine('Uploading extension package...');
-                const fileInput = await page.$('input[type="file"]');
-                if (fileInput) {
-                    await fileInput.uploadFile(outputPath);
-                    response.appendResponseLine('✅ Package uploaded');
-                    // Wait for processing
-                    await new Promise(resolve => setTimeout(resolve, 3000));
-                    // Look for any errors
-                    const errorElements = await page.$$('.error-message, [role="alert"]');
-                    if (errorElements.length > 0) {
-                        const errorText = await page.evaluate(() => {
-                            const errors = document.querySelectorAll('.error-message, [role="alert"]');
-                            return Array.from(errors).map(e => e.textContent).join('\n');
-                        });
-                        response.appendResponseLine(`⚠️ Upload errors detected: ${errorText}`);
-                    }
-                }
-                else {
-                    response.appendResponseLine('❌ Could not find file upload input');
-                    return;
-                }
-                // Fill in store listing information
-                response.appendResponseLine('Filling in store listing...');
-                // Title field (usually pre-filled from manifest)
-                const titleInput = await page.$('input[name="title"], input[aria-label*="title"]');
-                if (titleInput) {
-                    const currentTitle = await titleInput.evaluate(el => el.value);
-                    if (!currentTitle) {
-                        await titleInput.type(manifest.name);
-                    }
-                }
-                // Summary/Short description
-                const summaryInput = await page.$('textarea[name="summary"], textarea[aria-label*="summary"]');
-                if (summaryInput) {
-                    await summaryInput.click({ clickCount: 3 }); // Select all
-                    await summaryInput.type(manifest.description || `${manifest.name} - Chrome Extension`);
-                }
-                // Detailed description
-                const descriptionInput = await page.$('textarea[name="description"], textarea[aria-label*="description"]');
-                if (descriptionInput) {
-                    await descriptionInput.click({ clickCount: 3 });
-                    await descriptionInput.type(description);
-                }
-                // Category selection
-                const categorySelect = await page.$('select[name="category"], select[aria-label*="category"]');
-                if (categorySelect) {
-                    await categorySelect.select(category.toLowerCase().replace(/\s+/g, '_'));
-                }
-                // Language
-                const languageSelect = await page.$('select[name="language"], select[aria-label*="language"]');
-                if (languageSelect) {
-                    await languageSelect.select('en');
-                }
-                response.appendResponseLine('✅ Store listing filled');
-                // Screenshots reminder
-                response.appendResponseLine('');
-                response.appendResponseLine('⚠️ **Manual steps required:**');
-                response.appendResponseLine('1. Add at least 1 screenshot (1280x800 or 640x400)');
-                response.appendResponseLine('2. Add promotional images if needed');
-                response.appendResponseLine('3. Review all information');
-                response.appendResponseLine('4. Click "Save draft" or "Submit for review"');
-                response.appendResponseLine('');
-                response.appendResponseLine('The browser is now on the submission page.');
-                response.appendResponseLine('Complete the remaining steps manually.');
-            }
-            catch (error) {
-                response.appendResponseLine(`❌ Automation error: ${error}`);
-                response.appendResponseLine('You may need to complete the submission manually.');
-            }
-        }
-    },
-});