@triedotdev/mcp 1.0.63 → 1.0.64

package/dist/index.js

@@ -3291,8 +3291,8 @@ function generateChangelogLookup(library, fromVersion, toVersion) {
 `;
   return prompt;
 }
-function lookupKnowledge(request) {
-  const { type, query, context = {} } = request;
+function lookupKnowledge(request2) {
+  const { type, query, context = {} } = request2;
   switch (type) {
     case "cve":
       return generateCVELookup(query, context.version);
@@ -6629,6 +6629,7 @@ Use \`trie_init\` to create one, or create it manually with team ownership info.
 // src/tools/visual-qa-browser.ts
 import { chromium } from "playwright";
 import { createServer } from "net";
+import { request } from "http";
 var DEFAULT_VIEWPORTS = [
   { name: "mobile", width: 375, height: 812 },
   // iPhone X
@@ -6639,29 +6640,62 @@ var DEFAULT_VIEWPORTS = [
 ];
 async function findOpenPort() {
   const commonPorts = [3e3, 3001, 5173, 5174, 4200, 8080, 8e3, 8888, 5e3, 4e3];
-  for (const port of commonPorts) {
-    const isOpen = await checkPort(port);
-    if (isOpen) {
-      return port;
-    }
-  }
-  return null;
+  const portChecks = await Promise.all(
+    commonPorts.map(async (port) => {
+      const isOpen = await checkPort(port);
+      return isOpen ? port : null;
+    })
+  );
+  return portChecks.find((port) => port !== null) || null;
 }
 async function checkPort(port) {
   return new Promise((resolve6) => {
-    const server = createServer();
-    server.once("error", (err) => {
+    const testServer = createServer();
+    let portInUse = false;
+    testServer.once("error", (err) => {
       if (err.code === "EADDRINUSE") {
-        resolve6(true);
+        portInUse = true;
+        testHttpPort(port).then(resolve6).catch(() => resolve6(false));
       } else {
         resolve6(false);
       }
     });
-    server.once("listening", () => {
-      server.close();
+    testServer.once("listening", () => {
+      testServer.close();
+      resolve6(false);
+    });
+    setTimeout(() => {
+      if (!portInUse) {
+        testServer.close();
+        resolve6(false);
+      }
+    }, 1e3);
+    testServer.listen(port, "127.0.0.1");
+  });
+}
+async function testHttpPort(port) {
+  return new Promise((resolve6) => {
+    const req = request({
+      hostname: "localhost",
+      port,
+      path: "/",
+      method: "GET",
+      timeout: 2e3
+    }, (res) => {
+      resolve6(res.statusCode !== void 0);
+      res.on("data", () => {
+      });
+      res.on("end", () => {
+      });
+    });
+    req.on("error", () => {
+      resolve6(false);
+    });
+    req.on("timeout", () => {
+      req.destroy();
       resolve6(false);
     });
-    server.listen(port, "127.0.0.1");
+    req.end();
   });
 }
 async function captureScreenshots(url, viewports, options) {
@@ -6711,17 +6745,42 @@ async function captureScreenshots(url, viewports, options) {
 async function runVisualQA(options = {}) {
   let url = options.url;
   if (!url) {
-    const port = options.port || await findOpenPort();
-    if (!port) {
-      return {
-        success: false,
-        url: "",
-        screenshots: [],
-        error: "No running dev server found. Please provide a URL or start your dev server on a common port (3000, 5173, 8080, etc.)",
-        analysisPrompt: ""
-      };
+    if (options.port) {
+      const isServing = await testHttpPort(options.port);
+      if (!isServing) {
+        return {
+          success: false,
+          url: `http://localhost:${options.port}`,
+          screenshots: [],
+          error: `Port ${options.port} is not serving HTTP. Is your dev server running on this port?
+
+Try:
+1. Verify your dev server is running: curl http://localhost:${options.port}
+2. Check if the port is correct
+3. Provide full URL: trie_visual_qa_browser url:"http://localhost:${options.port}"`,
+          analysisPrompt: ""
+        };
+      }
+      url = `http://localhost:${options.port}`;
+    } else {
+      if (!isInteractiveMode()) {
+        console.error("\u{1F50D} Visual QA: Auto-detecting running dev server...");
+      }
+      const port = await findOpenPort();
+      if (!port) {
+        return {
+          success: false,
+          url: "",
+          screenshots: [],
+          error: 'No running dev server found on common ports (3000, 3001, 5173, 5174, 4200, 8080, 8000, 8888, 5000, 4000).\n\nPlease:\n1. Start your dev server, OR\n2. Provide a URL: trie_visual_qa_browser url:"http://localhost:3000", OR\n3. Specify a port: trie_visual_qa_browser port:3000',
+          analysisPrompt: ""
+        };
+      }
+      url = `http://localhost:${port}`;
+      if (!isInteractiveMode()) {
+        console.error(`   \u2713 Found server on port ${port}`);
+      }
     }
-    url = `http://localhost:${port}`;
   }
   const viewports = options.viewports || DEFAULT_VIEWPORTS;
   try {
@@ -6745,16 +6804,21 @@ async function runVisualQA(options = {}) {
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
-    if (errorMessage.includes("net::ERR_CONNECTION_REFUSED")) {
+    if (errorMessage.includes("net::ERR_CONNECTION_REFUSED") || errorMessage.includes("ECONNREFUSED")) {
       return {
         success: false,
         url,
         screenshots: [],
-        error: `Cannot connect to ${url}. Is your dev server running?`,
+        error: `Cannot connect to ${url}. Is your dev server running?
+
+Try:
+1. Start your dev server (e.g., npm start, npm run dev)
+2. Specify the URL explicitly: trie_visual_qa_browser url:"http://localhost:3000"
+3. Or specify the port: trie_visual_qa_browser port:3000`,
         analysisPrompt: ""
       };
     }
-    if (errorMessage.includes("Executable doesn't exist")) {
+    if (errorMessage.includes("Executable doesn't exist") || errorMessage.includes("BrowserType")) {
       return {
         success: false,
         url,
@@ -6763,11 +6827,30 @@ async function runVisualQA(options = {}) {
         analysisPrompt: ""
       };
     }
+    if (errorMessage.includes("timeout") || errorMessage.includes("Navigation timeout")) {
+      return {
+        success: false,
+        url,
+        screenshots: [],
+        error: `Page load timeout for ${url}. The page may be taking too long to load or may have JavaScript errors.
+
+Try:
+1. Check if the page loads in your browser
+2. Increase wait time: trie_visual_qa_browser url:"${url}" waitMs:5000
+3. Wait for specific element: trie_visual_qa_browser url:"${url}" waitForSelector:".main-content"`,
+        analysisPrompt: ""
+      };
+    }
     return {
       success: false,
       url,
       screenshots: [],
-      error: `Screenshot capture failed: ${errorMessage}`,
+      error: `Screenshot capture failed: ${errorMessage}
+
+Troubleshooting:
+1. Verify ${url} is accessible in your browser
+2. Check that your dev server is running
+3. Try specifying the URL explicitly: trie_visual_qa_browser url:"${url}"`,
       analysisPrompt: ""
     };
   }
@@ -6930,8 +7013,46 @@ var RequestHandlers = class {
         case "visual":
           return await this.toolRegistry.getTool("agent").execute({ ...args, agent: "visual-qa" });
         case "visual_qa_browser": {
-          const result = await runVisualQA(args);
-          return formatMCPResponse(result);
+          try {
+            const result = await runVisualQA(args);
+            return formatMCPResponse(result);
+          } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+              content: [{
+                type: "text",
+                text: `# Visual QA Error
+
+Failed to capture screenshots: ${errorMessage}
+
+## Troubleshooting
+
+1. **Check if your dev server is running:**
+   - Try accessing the URL in your browser
+   - Common ports: 3000, 5173, 8080
+
+2. **Specify the URL explicitly:**
+   \`\`\`
+trie_visual_qa_browser url:"http://localhost:3000"
+\`\`\`
+
+3. **Specify a port:**
+   \`\`\`
+trie_visual_qa_browser port:3000
+\`\`\`
+
+4. **Install Playwright browsers (if needed):**
+   \`\`\`
+npx playwright install chromium
+\`\`\`
+
+5. **Check for JavaScript errors:**
+   - Open browser dev tools
+   - Look for console errors
+   - The page may be failing to load`
+              }]
+            };
+          }
         }
         case "data_flow":
         case "dataflow":
@@ -7132,15 +7253,15 @@ var MCPServer = class {
         tools: this.toolRegistry.getAllTools()
       };
     });
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      const { name, arguments: args } = request.params;
+    this.server.setRequestHandler(CallToolRequestSchema, async (request2) => {
+      const { name, arguments: args } = request2.params;
       return await this.requestHandlers.handleToolCall(name, args);
     });
     this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
       return await this.requestHandlers.handleListResources();
     });
-    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-      const { uri } = request.params;
+    this.server.setRequestHandler(ReadResourceRequestSchema, async (request2) => {
+      const { uri } = request2.params;
       return await this.requestHandlers.handleReadResource(uri);
     });
   }