@hapticpaper/mcp-server 1.0.31 → 1.0.32

package/dist/client/hapticPaperClient.js

@@ -5,6 +5,7 @@ export class HapticPaperClient {
     constructor(config) {
         this.client = axios.create({
             baseURL: config.baseUrl,
+            timeout: 30000, // 30 second timeout to prevent indefinite hangs
             headers: {
                 'Content-Type': 'application/json',
             },
@@ -23,9 +24,20 @@ export class HapticPaperClient {
         // Response interceptor to handle auth errors
         this.client.interceptors.response.use((response) => response, async (error) => {
             const originalRequest = error.config;
+            // Log errors for debugging (but not in production to avoid log spam)
+            if (process.env.NODE_ENV !== 'production') {
+                console.error('[HapticPaperClient] Request failed:', {
+                    url: error.config?.url,
+                    method: error.config?.method,
+                    status: error.response?.status,
+                    message: error.message,
+                    code: error.code,
+                });
+            }
             if (error.response?.status === 401 && !originalRequest._retry && config.onAuthError) {
                 originalRequest._retry = true;
                 try {
+                    console.error('[HapticPaperClient] Auth error, attempting token refresh');
                     const newToken = await config.onAuthError();
                     if (typeof newToken === 'string') {
                         originalRequest.headers.Authorization = `Bearer ${newToken}`;
@@ -33,6 +45,7 @@ export class HapticPaperClient {
                     }
                 }
                 catch (authError) {
+                    console.error('[HapticPaperClient] Token refresh failed:', authError instanceof Error ? authError.message : String(authError));
                     return Promise.reject(authError);
                 }
             }

package/dist/tools/account.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { requireScopes } from "../auth/access.js";
 import { HAPTICPAPER_WIDGET_URI } from "../constants/widget.js";
+import { handleToolError } from "./errorHandler.js";
 function oauthSecuritySchemes(scopes) {
     return [
         { type: 'oauth2', scopes },
@@ -106,10 +107,7 @@ export function registerAccountTools(server, client) {
             }
         }
         catch (err) {
-            return {
-                content: [{ type: 'text', text: `Error: ${err.message}` }],
-                isError: true,
-            };
+            return handleToolError(err, 'Account Tool');
         }
     };
     server.registerTool('account', {

package/dist/tools/errorHandler.js

@@ -0,0 +1,58 @@
+/**
+ * Formats errors from tool handlers into user-friendly messages
+ * and logs detailed error information for debugging
+ */
+export function handleToolError(err, toolName) {
+    let errorMessage = 'An unexpected error occurred';
+    if (err.code === 'ECONNABORTED' || err.code === 'ETIMEDOUT') {
+        errorMessage = 'Request timed out. The backend service may be unavailable.';
+        console.error(`[${toolName}] Timeout error:`, err.message);
+    }
+    else if (err.response?.status === 401) {
+        errorMessage = 'Authentication failed. Your session may have expired. Please reconnect.';
+        console.error(`[${toolName}] Auth error:`, {
+            status: err.response.status,
+            data: err.response.data,
+        });
+    }
+    else if (err.response?.status === 403) {
+        errorMessage = 'Access denied. You may not have permission for this action.';
+        console.error(`[${toolName}] Permission error:`, {
+            status: err.response.status,
+            data: err.response.data,
+        });
+    }
+    else if (err.response?.status === 404) {
+        errorMessage = 'Resource not found.';
+        console.error(`[${toolName}] Not found error:`, {
+            status: err.response.status,
+            url: err.config?.url,
+        });
+    }
+    else if (err.response?.status >= 500) {
+        errorMessage = 'Backend service error. Please try again later.';
+        console.error(`[${toolName}] Server error:`, {
+            status: err.response.status,
+            data: err.response.data,
+        });
+    }
+    else if (err.message) {
+        errorMessage = err.message;
+        console.error(`[${toolName}] Error:`, err.message);
+    }
+    else {
+        console.error(`[${toolName}] Unknown error:`, err);
+    }
+    return {
+        content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+        isError: true,
+    };
+}
+/**
+ * Logs successful tool invocations for debugging
+ */
+export function logToolSuccess(toolName, action, details) {
+    if (process.env.NODE_ENV !== 'production') {
+        console.log(`[${toolName}] Success:`, { action, ...details });
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hapticpaper/mcp-server",
   "mcpName": "com.hapticpaper/mcp",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "description": "Official MCP Server for Haptic Paper - Connect your account to create human tasks from agentic pipelines.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -25,7 +25,7 @@
     "subfolder": "packages/mcp-server"
   },
   "websiteUrl": "https://hapticpaper.com/developer",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "remotes": [
     {
       "type": "streamable-http",
@@ -37,7 +37,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@hapticpaper/mcp-server",
-      "version": "1.0.31",
+      "version": "1.0.32",
       "transport": {
         "type": "stdio"
       },