@agentvalet/mcp-server 0.3.2 → 0.3.3

package/dist/index.js

@@ -338,13 +338,35 @@ async function handleListPlatforms() {
         response = await fetchWithAuth(`${PROXY_URL}/v1/agent/permissions`, { method: "GET", headers: {} });
     }
     catch (err) {
-        return errorContent(`Network error: ${err instanceof Error ? err.message : err}`);
+        return errorContent(diagnoseNetworkError(err, PROXY_URL));
     }
     const body = await response.text();
     if (!response.ok)
         return errorContent(`Proxy error ${response.status}: ${body}`);
     return { content: [{ type: "text", text: body }] };
 }
+// Translates a fetch() failure into something an end-user can actually act on.
+// The default "Network error: fetch failed" message tells a non-developer
+// nothing. Look at the underlying cause keyword and map to a concrete fix.
+function diagnoseNetworkError(err, proxyUrl) {
+    const raw = err instanceof Error ? err.message : String(err);
+    const lower = raw.toLowerCase();
+    // Node's undici surfaces DNS failures as "getaddrinfo ENOTFOUND <host>".
+    if (lower.includes("enotfound") || lower.includes("getaddrinfo")) {
+        return `Network error: cannot resolve ${proxyUrl}. Check your DNS / corporate proxy / VPN, or confirm the PROXY_URL setting is correct. Raw: ${raw}`;
+    }
+    // Connection refused / unreachable / TLS handshake failure.
+    if (lower.includes("econnrefused") || lower.includes("econnreset")) {
+        return `Network error: connection to ${proxyUrl} was refused or reset. The proxy may be down — check https://status.agentvalet.ai — or a firewall is blocking the request. Raw: ${raw}`;
+    }
+    if (lower.includes("etimedout") || lower.includes("timeout") || lower.includes("aborterror")) {
+        return `Network error: request to ${proxyUrl} timed out. Likely causes: VPN routing, corporate proxy buffering, or slow network. Try again or confirm api.agentvalet.ai is reachable from this machine. Raw: ${raw}`;
+    }
+    if (lower.includes("self signed") || lower.includes("cert") || lower.includes("ssl") || lower.includes("tls")) {
+        return `Network error: TLS / certificate problem talking to ${proxyUrl}. A corporate MITM proxy may be intercepting traffic. Raw: ${raw}`;
+    }
+    return `Network error reaching ${proxyUrl}: ${raw}. Check VPN, corporate proxy, and firewall rules for api.agentvalet.ai. If the proxy itself is down, see https://status.agentvalet.ai.`;
+}
 // Long-poll budget — under Claude Desktop's hardcoded 60s tool timeout
 // (with 10s of safety). After this we return a graceful "queued" message and
 // the action lands in the user's pending-actions list (Layer 4).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvalet/mcp-server",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "AgentValet MCP server — lets AI agents call approved platforms via the AgentValet proxy",
   "type": "module",
   "main": "dist/index.js",