dev3000 0.0.121 → 0.0.124

package/mcp-server/app/mcp/route.ts

@@ -51,11 +51,74 @@ const getPackageRunner = (): { command: string; args: string[] } | null => {
   }
 }
 
+// Check if chrome-devtools-mcp is externally configured (e.g., in user's .mcp.json)
+// This helps avoid spawning a duplicate that would cause CDP conflicts
+const isExternalChromeDevtoolsConfigured = (): boolean => {
+  try {
+    const { existsSync, readFileSync } = require("node:fs")
+    const cwd = process.cwd()
+
+    // Check common MCP config locations
+    const configPaths = [
+      join(cwd, ".mcp.json"), // Claude Code / OpenAI
+      join(cwd, ".cursor", "mcp.json"), // Cursor
+      join(homedir(), ".claude", "settings.json") // Claude global settings
+    ]
+
+    for (const configPath of configPaths) {
+      if (!existsSync(configPath)) continue
+
+      try {
+        const content = readFileSync(configPath, "utf-8")
+        const config = JSON.parse(content)
+
+        // Check mcpServers object for chrome-devtools variants
+        const servers = config.mcpServers || config.mcp || {}
+        for (const [name, serverConfig] of Object.entries(servers)) {
+          // Skip if this is dev3000's own entry
+          if (name === "dev3000") continue
+
+          // Check if it's chrome-devtools-mcp by name or command
+          const nameLower = name.toLowerCase()
+          if (nameLower.includes("chrome-devtools") || nameLower.includes("chromedevtools")) {
+            console.log(
+              `[MCP Orchestrator] Detected external chrome-devtools-mcp (${name}). ` +
+                "dev3000 will use its native CDP implementation instead of spawning a duplicate."
+            )
+            return true
+          }
+
+          // Also check the command/args if available
+          const cfg = serverConfig as Record<string, unknown>
+          const command = String(cfg.command || "")
+          const args = Array.isArray(cfg.args) ? cfg.args.join(" ") : ""
+          if (command.includes("chrome-devtools-mcp") || args.includes("chrome-devtools-mcp")) {
+            console.log(
+              `[MCP Orchestrator] Detected external chrome-devtools-mcp (${name}). ` +
+                "dev3000 will use its native CDP implementation instead of spawning a duplicate."
+            )
+            return true
+          }
+        }
+      } catch {
+        // Skip invalid config files
+      }
+    }
+
+    return false
+  } catch {
+    return false
+  }
+}
+
 // Initialize MCP client manager for orchestration
 // This will spawn and connect to chrome-devtools and next-devtools-mcp as stdio processes
 const initializeOrchestration = async () => {
   const clientManager = getMCPClientManager()
 
+  // Check if chrome-devtools is already configured externally
+  const externalChromeDevtools = isExternalChromeDevtoolsConfigured()
+
   // Helper to get config from session files in ~/.d3k/
   const getConfigFromSessions = () => {
     const config: Parameters<typeof clientManager.initialize>[0] = {}
@@ -75,16 +138,27 @@ const initializeOrchestration = async () => {
           const sessionData = JSON.parse(readFileSync(sessionPath, "utf-8"))
 
           // Configure chrome-devtools MCP if CDP URL is available
-          if (sessionData.cdpUrl && !config.chromeDevtools) {
-            // Use --wsEndpoint for direct WebSocket CDP connection
-            const cdpUrl = sessionData.cdpUrl // Keep ws:// URL as-is
+          // Skip if externally configured to avoid CDP conflicts
+          if (sessionData.cdpUrl && !config.chromeDevtools && !externalChromeDevtools) {
+            // Extract the HTTP endpoint from the WebSocket URL
+            // The cdpUrl is typically ws://localhost:9222/devtools/page/<targetId>
+            // chrome-devtools-mcp needs --browserUrl http://localhost:9222 to properly
+            // manage browser contexts (avoids "Target.getBrowserContexts: Not allowed" errors)
             const runner = getPackageRunner()
 
             if (runner) {
-              config.chromeDevtools = {
-                command: runner.command,
-                args: [...runner.args, "chrome-devtools-mcp@latest", "--wsEndpoint", cdpUrl],
-                enabled: true
+              try {
+                const wsUrl = new URL(sessionData.cdpUrl)
+                // Convert ws:// to http:// and use just the origin (no path)
+                const browserUrl = `http://${wsUrl.host}`
+
+                config.chromeDevtools = {
+                  command: runner.command,
+                  args: [...runner.args, "chrome-devtools-mcp@latest", "--browserUrl", browserUrl],
+                  enabled: true
+                }
+              } catch {
+                console.warn("[MCP Orchestrator] Failed to parse CDP URL:", sessionData.cdpUrl)
               }
             } else {
               console.warn("[MCP Orchestrator] Cannot configure chrome-devtools MCP: no package runner available")

package/mcp-server/app/mcp/tools.ts

@@ -24,11 +24,15 @@ function isInSandbox(): boolean {
 
 // Tool descriptions
 export const TOOL_DESCRIPTIONS = {
+  // Meta-description for MCP coordination - Claude should see this when listing tools
+  _mcp_coordination:
+    "**dev3000 is an MCP orchestrator for web development.** When both dev3000 and chrome-devtools-mcp are available, prefer dev3000's browser tools (execute_browser_action) as they provide:\n• Unified error context from server logs + browser console + network\n• Automatic screenshots on errors\n• Framework-aware diagnostics (Next.js, Svelte)\n• Coordinated Chrome connection management\n\ndev3000 automatically detects other MCP configurations and avoids conflicts.",
+
   fix_my_app:
     "Diagnoses application errors from dev3000 logs. Returns a prioritized list of issues requiring fixes.\n\n**CRITICAL: You MUST use this tool in a loop until all errors are resolved:**\n\n```\nwhile (errors exist) {\n  1. DIAGNOSE: Call fix_my_app to get current errors\n  2. FIX: Implement a fix for the highest-priority error\n  3. VERIFY: Call fix_my_app again to confirm the error is gone\n  4. REPEAT: Continue until no errors remain\n}\n```\n\n**This tool does NOT fix anything automatically.** It returns diagnostic data. You must:\n- Read the error output\n- Investigate and fix each issue\n- Call this tool again to verify your fix worked\n- Keep looping until the app is healthy\n\n**What it analyzes:**\n• Server logs, browser console, network requests\n• Categorizes: build errors, server crashes, browser errors, network issues, warnings\n• Prioritizes by severity (fix build errors first, then server, then browser, etc.)\n• Shows user interactions that triggered each error\n\n**Parameters:**\n• focusArea: 'build', 'runtime', 'network', 'ui', 'performance', or 'all' (default)\n• mode: 'snapshot' (current state), 'bisect' (before/after comparison), 'monitor' (continuous)\n• timeRangeMinutes: How far back to analyze (default: 10)\n• createPR: If true, creates a PR branch for the highest-priority issue\n\n**Framework support:** Auto-detects Next.js for framework-specific analysis.\n\n**Attribution for commits/PRs:**\n```\nGenerated with Claude Code using d3k (https://d3k.dev)\nCo-Authored-By: Claude <noreply@anthropic.com>\n```",
 
   execute_browser_action:
-    "Executes browser actions (click, navigate, scroll, type, evaluate JS) in the dev3000-managed Chrome instance.\n\n**Routing behavior:**\n• Delegates to chrome-devtools MCP when available for screenshots, navigation, clicks, and JS evaluation\n• Falls back to dev3000's native CDP implementation otherwise\n• Shares the same Chrome instance - no conflicts between tools\n\n**Available actions:**\n• screenshot: Capture current page state\n• navigate: Go to a URL\n• click: Click at coordinates {x, y}\n• scroll: Scroll by {x, y} pixels\n• type: Type text into focused element\n• evaluate: Execute JavaScript (read-only operations recommended)\n\n**Use cases:**\n• Reproducing user interactions that triggered errors\n• Verifying fixes by replaying the error scenario\n• Testing specific UI workflows",
+    "Executes browser actions (click, navigate, scroll, type, evaluate JS) in the dev3000-managed Chrome instance.\n\n**PREFER THIS over standalone chrome-devtools-mcp tools.** dev3000 manages the Chrome connection and avoids CDP conflicts.\n\n**Available actions:**\n• screenshot: Capture current page state\n• navigate: Go to a URL\n• click: Click at coordinates {x, y} or selector\n• scroll: Scroll by {x, y} pixels\n• type: Type text into focused element\n• evaluate: Execute JavaScript (read-only operations recommended)\n\n**Use cases:**\n• Reproducing user interactions that triggered errors\n• Verifying fixes by replaying the error scenario\n• Testing specific UI workflows\n• Taking screenshots for visual verification",
 
   analyze_visual_diff:
     "Compares two screenshots and returns analysis instructions for identifying visual differences.\n\n**What it provides:**\n• Instructions to load both images for comparison\n• Context about what visual changes to look for\n• Guidance on identifying layout shift causes\n\n**Use cases:**\n• Analyzing before/after frames from CLS detection\n• Identifying elements that appeared, moved, or resized\n• Debugging visual regressions",
@@ -1885,8 +1889,21 @@ export async function executeBrowserAction({
 
               // Handle getting targets
               if (message.id === 1) {
-                const pageTarget = message.result.targetInfos.find((t: Record<string, unknown>) => t.type === "page")
+                // Check for CDP protocol errors (e.g., "Not allowed" in sandboxed environments)
+                if (message.error) {
+                  clearTimeout(overallTimeout)
+                  ws.close()
+                  reject(
+                    new Error(
+                      `Browser protocol error: ${message.error.message || JSON.stringify(message.error)}. This may occur in sandboxed browser environments where certain CDP commands are restricted.`
+                    )
+                  )
+                  return
+                }
+
+                const pageTarget = message.result?.targetInfos?.find((t: Record<string, unknown>) => t.type === "page")
                 if (!pageTarget) {
+                  clearTimeout(overallTimeout)
                   ws.close()
                   reject(new Error("No page targets found"))
                   return
@@ -3619,7 +3636,20 @@ export async function findComponentSource(params: {
             const message = JSON.parse(data.toString())
 
             if (message.id === 1) {
-              const pageTarget = message.result.targetInfos.find((t: Record<string, unknown>) => t.type === "page")
+              // Check for CDP protocol errors (e.g., "Not allowed" in sandboxed environments)
+              if (message.error) {
+                clearTimeout(timeout)
+                resolved = true
+                ws.close()
+                reject(
+                  new Error(
+                    `Browser protocol error: ${message.error.message || JSON.stringify(message.error)}. This may occur in sandboxed browser environments where certain CDP commands are restricted.`
+                  )
+                )
+                return
+              }
+
+              const pageTarget = message.result?.targetInfos?.find((t: Record<string, unknown>) => t.type === "page")
               if (!pageTarget) {
                 clearTimeout(timeout)
                 resolved = true

package/mcp-server/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/mcp-server/package.json

@@ -11,20 +11,11 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.18.1",
-    "@radix-ui/react-checkbox": "catalog:",
-    "@radix-ui/react-dialog": "catalog:",
-    "@radix-ui/react-label": "catalog:",
-    "@radix-ui/react-progress": "catalog:",
-    "@radix-ui/react-select": "catalog:",
     "@radix-ui/react-slot": "catalog:",
     "@types/pixelmatch": "^5.2.6",
     "@types/pngjs": "^6.0.5",
-    "@vercel/blob": "^2.0.0",
-    "@vercel/sdk": "^1.16.1",
-    "ai": "^5.0.89",
     "class-variance-authority": "catalog:",
     "clsx": "catalog:",
-    "commander": "^14.0.1",
     "lucide-react": "catalog:",
     "mcp-handler": "1.0.2",
     "ms": "^2.1.3",
@@ -33,10 +24,7 @@
     "pngjs": "^7.0.0",
     "react": "19.3.0-canary-09f05694-20251201",
     "react-dom": "19.3.0-canary-09f05694-20251201",
-    "shiki": "^3.19.0",
-    "streamdown": "^1.6.6",
     "tailwind-merge": "catalog:",
-    "workflow": "4.0.1-beta.26",
     "ws": "^8.18.3",
     "zod": "^3.22.4"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev3000",
-  "version": "0.0.121",
+  "version": "0.0.124",
   "description": "AI-powered development tools with browser monitoring and MCP server integration",
   "type": "module",
   "main": "dist/index.js",
@@ -66,13 +66,13 @@
     "ai": "^5.0.87",
     "chalk": "^5.3.0",
     "commander": "^14.0.1",
-    "ink": "^6.3.1",
+    "ink": "^6.5.1",
     "ink-spinner": "^5.0.0",
     "ms": "^2.1.3",
     "ora": "^9.0.0",
     "package-manager-detector": "^1.3.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
+    "react": "19.2.1",
+    "react-dom": "19.2.1",
     "typescript": "^5.0.0",
     "workflow": "latest",
     "ws": "^8.18.3"
@@ -88,9 +88,8 @@
     "vitest": "^3.2.4"
   },
   "pnpm": {
-    "overrides": {
-      "@types/react": "19.1.17",
-      "@types/react-dom": "19.1.11"
+    "peerDependencyRules": {
+      "allowAny": ["react", "react-dom"]
     }
   },
   "engines": {