@testomatio/mcp 2.1.0-beta.1 → 2.1.1-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/mcp",
-  "version": "2.1.0-beta.1",
+  "version": "2.1.1-beta",
   "description": "Model Context Protocol server for Testomatio API",
   "main": "src/index.js",
   "bin": {

package/src/api/testomatio-client.js

@@ -60,14 +60,27 @@ export class TestomatioApiClient {
   }
 
   async mutate(method, path, options = {}) {
-    const sessionHash = await this.ensureSession();
-    return this.http.request(method, path, {
-      ...options,
-      headers: {
-        ...options.headers,
-        'X-Session-Hash': sessionHash,
-      },
-    });
+    const runRequest = async () => {
+      const sessionHash = await this.ensureSession();
+      return this.http.request(method, path, {
+        ...options,
+        headers: {
+          ...options.headers,
+          'X-Session-Hash': sessionHash,
+        },
+      });
+    };
+
+    try {
+      return await runRequest();
+    } catch (error) {
+      if (!this.shouldRefreshSession(error)) {
+        throw error;
+      }
+
+      await this.refreshSession();
+      return runRequest();
+    }
   }
 
   async ensureSession() {
@@ -124,4 +137,13 @@ export class TestomatioApiClient {
       }
     }
   }
+
+  shouldRefreshSession(error) {
+    return error?.status === 403 && Boolean(this.sessionHash);
+  }
+
+  async refreshSession() {
+    this.sessionHash = null;
+    return this.ensureSession();
+  }
 }

package/src/mcp/definitions/plans.js

@@ -1,3 +1,5 @@
+import { PLANS_TQL_INPUT_DESCRIPTION, PLANS_TQL_REFERENCE } from './tql-reference.js';
+
 export const PLANS_TOOLS = [
   {
     "name": "plans_list",
@@ -56,7 +58,7 @@ export const PLANS_TOOLS = [
   },
   {
     "name": "plans_create",
-    "description": "Create plan (/api/v2/{project_id}/plans)",
+    "description": `Create plan (/api/v2/{project_id}/plans). ${PLANS_TQL_REFERENCE}`,
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -94,6 +96,10 @@ export const PLANS_TOOLS = [
           },
           "description": "List of suite IDs (8-char) to include in the plan. If omitted, all suites are considered."
         },
+        "tql": {
+          "type": "string",
+          "description": PLANS_TQL_INPUT_DESCRIPTION
+        },
         "link": {
           "type": "array",
           "items": {
@@ -138,7 +144,7 @@ export const PLANS_TOOLS = [
   },
   {
     "name": "plans_update",
-    "description": "Update plan (/api/v2/{project_id}/plans/{id})",
+    "description": `Update plan (/api/v2/{project_id}/plans/{id}). ${PLANS_TQL_REFERENCE}`,
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -179,6 +185,10 @@ export const PLANS_TOOLS = [
           },
           "description": "List of suite IDs (8-char) to include in the plan. If omitted, all suites are considered."
         },
+        "tql": {
+          "type": "string",
+          "description": PLANS_TQL_INPUT_DESCRIPTION
+        },
         "link": {
           "type": "array",
           "items": {

package/src/mcp/definitions/rungroups.js

@@ -62,7 +62,8 @@ export const RUNGROUPS_TOOLS = [
           "type": "string"
         },
         "children": {
-          "type": "array"
+          "type": "array",
+          "items": {}
         }
       },
       "required": [
@@ -102,7 +103,8 @@ export const RUNGROUPS_TOOLS = [
           "type": "string"
         },
         "children": {
-          "type": "array"
+          "type": "array",
+          "items": {}
         }
       },
       "required": [

package/src/mcp/definitions/suites.js

@@ -78,7 +78,8 @@ export const SUITES_TOOLS = [
           "type": "string"
         },
         "children": {
-          "type": "array"
+          "type": "array",
+          "items": {}
         },
         "link": {
           "type": "array",
@@ -154,7 +155,8 @@ export const SUITES_TOOLS = [
           "type": "string"
         },
         "children": {
-          "type": "array"
+          "type": "array",
+          "items": {}
         },
         "link": {
           "type": "array",

package/src/mcp/definitions/tql-reference.js

@@ -15,6 +15,8 @@ const TESTS_TQL_VARIABLES = [
   'assigned_to',
   'suite',
   'test',
+  'shared',
+  'milestone',
 ];
 
 const RUNS_TQL_VARIABLES = [
@@ -57,16 +59,20 @@ const RUNS_TQL_VARIABLES = [
   'updated_at',
   'launched_at',
   'finished_at',
+  'milestone',
 ];
 
 const TESTS_TQL_EXAMPLES = [
   "priority == 'high'",
+  "priority >= 'normal'",
   "state == 'automated'",
   "tag in ['smoke', 'stage1'] and status == 'failed'",
   "suite % 'Checkout'",
   "test % 'User login'",
+  "custom_status % 'issue'",
   "created_at < 1.month_ago",
   "jira in ['JST-1', 'JST-2']",
+  "milestone == 'Sprint 1'",
 ];
 
 const RUNS_TQL_EXAMPLES = [
@@ -81,7 +87,7 @@ const RUNS_TQL_EXAMPLES = [
 ];
 
 const COMMON_TQL_SYNTAX =
-  "Supported syntax includes `==`, `!=`, `>`, `<`, `>=`, `<=`, `in [...]`, `%` for partial text match, `and`, `or`, `not`, and parentheses for grouping. Use quotes for string values, for example `state == 'automated'`.";
+  "Supported syntax includes logical operators `and`, `or`, `not`, equality operators `==` and `!=`, list membership `in [...]`, `%` for partial text match on supported text fields, and parentheses for grouping. Ordered comparisons `>`, `<`, `>=`, `<=` are for ordered fields such as `priority`, dates, and numeric counters/durations. Use quotes for string values, for example `state == 'automated'`.";
 
 export const TESTS_TQL_REFERENCE =
   `TQL (Testomat.io Query Language) is a string expression passed in \`tql\` to filter tests. ${COMMON_TQL_SYNTAX} ` +
@@ -104,6 +110,17 @@ export const RUNS_TQL_INPUT_DESCRIPTION =
   `TQL filter for runs. Documented variables: ${RUNS_TQL_VARIABLES.map((item) => `\`${item}\``).join(', ')}. ` +
   `Examples: ${RUNS_TQL_EXAMPLES.map((item) => `\`${item}\``).join(', ')}.`;
 
+export const PLANS_TQL_REFERENCE =
+  `TQL (Testomat.io Query Language) is a string expression passed in \`tql\` to select tests included in a plan. ${COMMON_TQL_SYNTAX} ` +
+  `Plan TQL uses documented test variables: ${TESTS_TQL_VARIABLES.map((item) => `\`${item}\``).join(', ')}. ` +
+  `Documented examples: ${TESTS_TQL_EXAMPLES.map((item) => `\`${item}\``).join(', ')}. ` +
+  'Use `tql` when you want the API to resolve matching tests automatically instead of sending explicit `test_ids`. Do not invent undocumented fields or syntax. If a query fails, simplify it to one documented predicate.';
+
+export const PLANS_TQL_INPUT_DESCRIPTION =
+  'TQL filter for selecting tests included in the plan. ' +
+  `Documented test variables: ${TESTS_TQL_VARIABLES.map((item) => `\`${item}\``).join(', ')}. ` +
+  `Examples: ${TESTS_TQL_EXAMPLES.map((item) => `\`${item}\``).join(', ')}.`;
+
 export const ANALYTICS_TESTS_TQL_REFERENCE =
   `TQL (Testomat.io Query Language) is a string expression passed in \`q\` to filter enterprise analytics test reports. ${COMMON_TQL_SYNTAX} ` +
   'For analytics tools, the API parameter name is `q`, not `tql`. ' +

package/src/mcp/registry/payloads.js

@@ -316,6 +316,7 @@ export const payloadMethods = {
     as_manual: asManual,
     test_ids: testIds,
     suite_ids: suiteIds,
+    tql,
     link,
   } = {}) {
     return {
@@ -326,6 +327,7 @@ export const payloadMethods = {
       as_manual: asManual,
       test_ids: testIds,
       suite_ids: suiteIds,
+      tql,
       link,
     };
   },