genat-mcp 2.2.6 → 2.2.7

package/README.md

@@ -39,6 +39,7 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 | **N8N_SCOPE_TO_REGIONS** | No       | (none)  | Comma-separated regions to focus tests on (e.g. `header,main,table`). Used as default when the tool is invoked without `scopeToRegions`; also used by run-genat.mjs. |
 | **N8N_ANALYZE_STATES** | No       | (off)   | Set to `1`, `true`, or `yes` to analyze dropdown/combobox expanded states and include state-specific violations in generated tests. Used as default when the tool is invoked without `analyzeStates`; also used by run-genat.mjs. Increases analysis time. |
 | **GENAT_PROJECT_ROOT** | No       | (cwd)   | Base path for resolving `parentProjectFolder`. When set, `parentProjectFolder` is resolved relative to this path. Use when your project is outside the MCP's working directory. Example: if your pytest project is at `/Users/me/projects/ill_tests`, set `GENAT_PROJECT_ROOT=/Users/me/projects` and use `parentProjectFolder ill_tests` in the prompt. |
+| **GENAT_FETCH_TIMEOUT_MS** | No       | 600000 (10 min) | Max time in milliseconds to wait for the n8n webhook response. Increase if GenAT times out before the workflow completes (e.g. complex pages with JIRA + AI Agent). Set in MCP env, e.g. `GENAT_FETCH_TIMEOUT_MS=900000` for 15 minutes. |
 
 ## Framework detection and auto-discovery
 
@@ -108,6 +109,24 @@ GenAT detects **language** (TypeScript, JavaScript, Python), **BDD framework** (
   }
 }
 ```
+
+**With GENAT_FETCH_TIMEOUT_MS** (increase timeout when workflow takes longer):
+
+```json
+{
+  "mcpServers": {
+    "GenAT": {
+      "command": "npx",
+      "args": ["genat-mcp"],
+      "env": {
+        "GENAT_FETCH_TIMEOUT_MS": "900000",
+        "N8N_WEBHOOK_URL": "https://n8n.example.com/webhook-test/webhook-genat-login"
+      }
+    }
+  }
+}
+```
+(900000 = 15 minutes. Default is 600000 = 10 minutes.)
 Then use `parentProjectFolder ill_tests` in the prompt to target `/Users/me/projects/ill_tests`.
 
 **With optional params for complex pages** (`N8N_MAX_ASSERTIONS`, `N8N_SCOPE_TO_REGIONS`, `N8N_ANALYZE_STATES`):

package/index.js

@@ -16,12 +16,14 @@ import { writeGeneratedFiles } from './write-files.js';
 const N8N_WEBHOOK_URL = process.env.N8N_WEBHOOK_URL || 'http://localhost:5678/webhook-test/webhook-genat-login';
 const SERVICE_BASE_URL = process.env.SERVICE_BASE_URL || null;
 const N8N_INSECURE_TLS = /^1|true|yes$/i.test(process.env.N8N_INSECURE_TLS || '');
+const GENAT_FETCH_TIMEOUT_MS = Math.max(60000, parseInt(process.env.GENAT_FETCH_TIMEOUT_MS || '600000', 10) || 600000);
 
 /**
  * HTTPS fetch with rejectUnauthorized: false for self-signed/internal CA certs.
  * Returns a Response-like object { ok, status, text(), json() }.
+ * Supports signal for timeout.
  */
-function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
+function insecureHttpsFetch(url, { method = 'GET', headers = {}, body, signal }) {
   return new Promise((resolve, reject) => {
     const req = https.request(
       url,
@@ -29,6 +31,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
         method,
         headers: { 'Content-Type': 'application/json', ...headers },
         agent: new https.Agent({ rejectUnauthorized: false }),
+        signal,
       },
       (res) => {
         let data = '';
@@ -52,7 +55,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.2.6',
+    version: '2.2.7',
   },
   {
     capabilities: {
@@ -171,10 +174,13 @@ server.registerTool(
     };
 
     const useInsecureTls = N8N_INSECURE_TLS && N8N_WEBHOOK_URL.startsWith('https://');
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), GENAT_FETCH_TIMEOUT_MS);
     const fetchOpts = {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(body),
+      signal: controller.signal,
     };
     let response;
     try {
@@ -190,13 +196,15 @@ server.registerTool(
             text: JSON.stringify({
               error: 'Failed to call n8n webhook',
               message: err instanceof Error ? err.message : String(err),
-              hint: 'Set N8N_WEBHOOK_URL to your n8n webhook URL. For self-signed/internal certs, set N8N_INSECURE_TLS=1',
+              hint: err?.name === 'AbortError' ? `Request timed out after ${GENAT_FETCH_TIMEOUT_MS / 1000}s. Set GENAT_FETCH_TIMEOUT_MS in MCP env to increase (default 600000).` : 'Set N8N_WEBHOOK_URL to your n8n webhook URL. For self-signed/internal certs, set N8N_INSECURE_TLS=1',
               workaround: `Run: N8N_WEBHOOK_URL='${loginUrl}' N8N_INSECURE_TLS=1 node node_modules/genat-mcp/run-genat.mjs "<url>" .  Use node_modules/genat-mcp/run-genat.mjs only (delete any run-genat.mjs in project root that uses webhook-genat).`,
             }),
           },
         ],
         isError: true,
       };
+    } finally {
+      clearTimeout(timeoutId);
     }
 
     if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genat-mcp",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",