@loadmill/mcp 0.0.2 → 0.1.0

package/README.md

@@ -1,12 +1,13 @@
 # Loadmill MCP Server
 
-This package provides a STDIO-based MCP (Message Control Protocol) server. It is designed to be integrated into your workflow, allowing communication over standard input/output streams.
+This package provides a STDIO-based MCP server. It is designed to be integrated into your workflow, allowing LLM interact with Loadmill.
 
 ## Use Cases
  - Query Loadmill for information
  - Execute Loadmill tests
  - Write and maintain Loadmill tests (TBD)
 
+*Note*: As always, when working with MCPs, make sure you are on `Agent` mode
 
  ## Install
 
@@ -31,4 +32,41 @@ This package provides a STDIO-based MCP (Message Control Protocol) server. It is
       "password": true
     }]
 }
- ```
+ ```
+
+ ### Cursor
+
+ ```
+ {
+  "mcpServers": {
+    // other MCP servers...
+    "loadmill": {
+      "command": "npx",
+      "args": ["@loadmill/mcp"],
+      "env": {
+        "LOADMILL_API_TOKEN": "${env:LOADMILL_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+## MCP Capabilities
+
+This server declares the following MCP capabilities:
+
+- Tools: Supports `list_tools` and `call_tool`.
+  - Search Loadmill test suites.
+  - Search Loadmill test suite runs.
+  - Run a specific test suite.
+  - Fetch details of a test suite run.
+  - Fetch details of a specific suite flow run.
+  - Search Loadmill test plans.
+  - Run a specific test plan (with optional labels/overrides).
+  - Fetch details of a test plan run.
+  - List all available labels in Loadmill.
+
+- Prompts: Supports `list_prompts` and `get_prompt`.
+  - Investigate failed test: Analyze failed test results and suggest next steps.
+
+- Resources: (TBD) Supports `list_resources` and `read_resource` (declared; not yet implemented).

package/dist/constants.d.ts

@@ -1,5 +1,8 @@
 export declare const MCP_SERVER_NAME = "loadmill-mcp-server";
 export declare const MCP_SERVER_VERSION = "0.0.1";
+export declare const LOADMILL_URL: string;
+export declare const ASSETS_URL: string;
+export declare const API_URL: string;
 export declare const SEARCH_TEST_SUITES = "search_test_suites";
 export declare const SEARCH_TEST_SUITE_RUNS = "search_test_suite_runs";
 export declare const RUN_TEST_SUITE = "run_test_suite";
@@ -9,4 +12,11 @@ export declare const SEARCH_TEST_PLAN = "search_test_plans";
 export declare const RUN_TEST_PLAN = "run_test_plans";
 export declare const GET_TEST_PLAN_RUN = "get_test_plan_run";
 export declare const GET_LABELS = "get_labels";
+export declare const GET_TEST_SUITE_SCHEMA = "get_test_suite_schema";
+export declare const VALIDATE_TEST_SUITE = "validate_test_suite";
+export declare const SCHEMA_TYPE: {
+    TEST_SUITE: string;
+};
 export declare const AVALIABLE_TOOLS: string[];
+export declare const AVILABLE_PROMPTS: never[];
+export declare const AVILABLE_RESOURCES: string[];

package/dist/constants.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AVALIABLE_TOOLS = exports.GET_LABELS = exports.GET_TEST_PLAN_RUN = exports.RUN_TEST_PLAN = exports.SEARCH_TEST_PLAN = exports.GET_TEST_SUITE_FLOW_RUN = exports.GET_TEST_SUITE_RUN = exports.RUN_TEST_SUITE = exports.SEARCH_TEST_SUITE_RUNS = exports.SEARCH_TEST_SUITES = exports.MCP_SERVER_VERSION = exports.MCP_SERVER_NAME = void 0;
+exports.AVILABLE_RESOURCES = exports.AVILABLE_PROMPTS = exports.AVALIABLE_TOOLS = exports.SCHEMA_TYPE = exports.VALIDATE_TEST_SUITE = exports.GET_TEST_SUITE_SCHEMA = exports.GET_LABELS = exports.GET_TEST_PLAN_RUN = exports.RUN_TEST_PLAN = exports.SEARCH_TEST_PLAN = exports.GET_TEST_SUITE_FLOW_RUN = exports.GET_TEST_SUITE_RUN = exports.RUN_TEST_SUITE = exports.SEARCH_TEST_SUITE_RUNS = exports.SEARCH_TEST_SUITES = exports.API_URL = exports.ASSETS_URL = exports.LOADMILL_URL = exports.MCP_SERVER_VERSION = exports.MCP_SERVER_NAME = void 0;
 exports.MCP_SERVER_NAME = 'loadmill-mcp-server';
 exports.MCP_SERVER_VERSION = '0.0.1';
+exports.LOADMILL_URL = process.env.LOADMILL_URL || 'https://app.loadmill.com';
+exports.ASSETS_URL = exports.LOADMILL_URL + '/assets';
+exports.API_URL = exports.LOADMILL_URL + '/api';
 //tools
 exports.SEARCH_TEST_SUITES = 'search_test_suites';
 exports.SEARCH_TEST_SUITE_RUNS = 'search_test_suite_runs';
@@ -13,6 +16,11 @@ exports.SEARCH_TEST_PLAN = 'search_test_plans';
 exports.RUN_TEST_PLAN = 'run_test_plans';
 exports.GET_TEST_PLAN_RUN = 'get_test_plan_run';
 exports.GET_LABELS = 'get_labels';
+exports.GET_TEST_SUITE_SCHEMA = 'get_test_suite_schema';
+exports.VALIDATE_TEST_SUITE = 'validate_test_suite';
+exports.SCHEMA_TYPE = {
+    TEST_SUITE: 'loadmill://schemas/test-suite@v1',
+};
 exports.AVALIABLE_TOOLS = [
     exports.SEARCH_TEST_SUITES,
     exports.SEARCH_TEST_SUITE_RUNS,
@@ -23,5 +31,12 @@ exports.AVALIABLE_TOOLS = [
     exports.SEARCH_TEST_PLAN,
     exports.RUN_TEST_PLAN,
     exports.GET_TEST_PLAN_RUN,
+    exports.VALIDATE_TEST_SUITE,
+];
+exports.AVILABLE_PROMPTS = [
+// Add prompt-related constants here
+];
+exports.AVILABLE_RESOURCES = [
+    exports.GET_TEST_SUITE_SCHEMA,
 ];
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AACa,QAAA,eAAe,GAAG,qBAAqB,CAAC;AACxC,QAAA,kBAAkB,GAAG,OAAO,CAAC;AAE1C,OAAO;AACM,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAClD,QAAA,cAAc,GAAG,gBAAgB,CAAC;AAClC,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,uBAAuB,GAAG,yBAAyB,CAAC;AACpD,QAAA,gBAAgB,GAAG,mBAAmB,CAAC;AACvC,QAAA,aAAa,GAAG,gBAAgB,CAAC;AACjC,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACxC,QAAA,UAAU,GAAG,YAAY,CAAC;AAE1B,QAAA,eAAe,GAAG;IAC7B,0BAAkB;IAClB,8BAAsB;IACtB,sBAAc;IACd,0BAAkB;IAClB,+BAAuB;IACvB,kBAAU;IACV,wBAAgB;IAChB,qBAAa;IACb,yBAAiB;CAClB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AACa,QAAA,eAAe,GAAG,qBAAqB,CAAC;AACxC,QAAA,kBAAkB,GAAG,OAAO,CAAC;AAG7B,QAAA,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0BAA0B,CAAC;AACtE,QAAA,UAAU,GAAG,oBAAY,GAAG,SAAS,CAAC;AACtC,QAAA,OAAO,GAAG,oBAAY,GAAG,MAAM,CAAC;AAE7C,OAAO;AACM,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAClD,QAAA,cAAc,GAAG,gBAAgB,CAAC;AAClC,QAAA,kBAAkB,GAAG,oBAAoB,CAAC;AAC1C,QAAA,uBAAuB,GAAG,yBAAyB,CAAC;AACpD,QAAA,gBAAgB,GAAG,mBAAmB,CAAC;AACvC,QAAA,aAAa,GAAG,gBAAgB,CAAC;AACjC,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACxC,QAAA,UAAU,GAAG,YAAY,CAAC;AAC1B,QAAA,qBAAqB,GAAG,uBAAuB,CAAC;AAChD,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAE5C,QAAA,WAAW,GAAG;IACzB,UAAU,EAAE,kCAAkC;CAC/C,CAAC;AAEW,QAAA,eAAe,GAAG;IAC7B,0BAAkB;IAClB,8BAAsB;IACtB,sBAAc;IACd,0BAAkB;IAClB,+BAAuB;IACvB,kBAAU;IACV,wBAAgB;IAChB,qBAAa;IACb,yBAAiB;IACjB,2BAAmB;CACpB,CAAC;AAEW,QAAA,gBAAgB,GAAG;AAC9B,oCAAoC;CACrC,CAAC;AAEW,QAAA,kBAAkB,GAAG;IAChC,6BAAqB;CACtB,CAAC"}

package/dist/handlers/prompts/index.d.ts

@@ -0,0 +1,2 @@
+import { MCPHandler } from '../../mcp-handler.js';
+export declare const handlers: MCPHandler[];

package/dist/handlers/prompts/index.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlers = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const utils_js_1 = require("../../utils.js");
+exports.handlers = [
+    {
+        schema: types_js_1.ListPromptsRequestSchema,
+        handler: async (_request) => {
+            return { prompts };
+        },
+    },
+    {
+        schema: types_js_1.GetPromptRequestSchema,
+        handler: async (req) => {
+            const { name, arguments: args = {} } = req.params;
+            const prompt = prompts.find((p) => p.name === name);
+            if (!prompt) {
+                throw new Error(`Unknown prompt: ${name}`);
+            }
+            const required = (prompt.inputSchema?.required ?? []);
+            const missing = required.filter((k) => args[k] === undefined);
+            if (missing.length) {
+                throw new Error(`Missing required prompt arguments: ${missing.join(', ')}`);
+            }
+            const messages = prompt.messages.map((m) => ({
+                role: m.role,
+                content: (0, utils_js_1.fillTemplate)(m.content, args),
+            }));
+            return { messages };
+        },
+    },
+];
+const prompts = [
+    {
+        name: 'investigate_failed_test',
+        description: 'Analyze failed test results and suggest next steps',
+        messages: [
+            {
+                role: 'system',
+                content: 'You are a QA investigator. Explain failures clearly and suggest next steps.',
+            },
+            {
+                role: 'user',
+                content: `The test '{{test_description}}' has failed.\n\n
+                 Result:\n{{result}}\n\n
+                 RedactableResult (extended data):\n{{redactableResult}}\n\n
+                 Please explain the cause and suggest how to fix it.`,
+            },
+        ],
+        inputSchema: {
+            type: 'object',
+            properties: {
+                test_description: { type: 'string' },
+                result: { type: 'string' },
+                redactableResult: { type: 'string' },
+            },
+            required: ['test_description', 'result', 'redactableResult'],
+        },
+    },
+    {
+        name: 'create_test_suite',
+        description: 'Design a Loadmill test-suite JSON using the official schema',
+        messages: [
+            {
+                role: 'system',
+                content: `You are an expert in API testing. 
+          Produce a valid Loadmill test-suite JSON strictly conforming to the schema returned by the get_test_suite_schema resource.
+          Favor clarity, maintainability, and minimal assumptions.`,
+            },
+            {
+                role: 'user',
+                content: `Create a test-suite named "{{name}}" to test the following endpoints and behaviors:\n\n {{requirements}}\n\n
+          Constraints:\n- Include flows and request steps covering happy-path and key edge-cases.\n- 
+          Use descriptive names for flows and steps.\n- Parameterize repeated values in suite.parameters when reasonable.\n- 
+          Add basic assertions for status, response time, and core fields.\n- Output only JSON.`,
+            },
+        ],
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string' },
+                requirements: { type: 'string' },
+            },
+            required: ['name', 'requirements'],
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/handlers/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/prompts/index.ts"],"names":[],"mappings":";;;AAAA,iEAG4C;AAG5C,6CAA8C;AAGjC,QAAA,QAAQ,GAAiB;IACpC;QACE,MAAM,EAAE,mCAAwB;QAChC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;KACF;IACD;QACE,MAAM,EAAE,iCAAsB;QAC9B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YAElD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE;gBACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;aAC5C;YAED,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAa,CAAC;YAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAC9D,IAAI,OAAO,CAAC,MAAM,EAAE;gBAClB,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;aACH;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,IAAA,uBAAY,EAAC,CAAC,CAAC,OAAO,EAAE,IAA+B,CAAC;aAClE,CAAC,CAAC,CAAC;YAEJ,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;KACF;CACF,CAAC;AAEF,MAAM,OAAO,GAAG;IACd;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EACH,6EAA6E;aAClF;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EACE;;;qEAGoD;aAC9D;SACF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACpC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACrC;YACD,QAAQ,EAAE,CAAC,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,CAAC;SAC7D;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL;;mEAEyD;aAC5D;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EACL;;;gGAGsF;aACzF;SACF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACjC;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC;SACnC;KACF;CACF,CAAC"}

package/dist/handlers/resources/index.d.ts

@@ -0,0 +1,2 @@
+import { MCPHandler } from '../../mcp-handler.js';
+export declare const handlers: MCPHandler[];

package/dist/handlers/resources/index.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlers = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const shared_js_1 = require("../shared.js");
+exports.handlers = [
+    {
+        schema: types_js_1.ListResourcesRequestSchema,
+        handler: async (_request) => {
+            const resources = [
+                {
+                    name: 'loadmill-test-suite-schema',
+                    title: 'Loadmill Test-Suite Schema',
+                    uri: 'loadmill://schemas/test-suite@v1',
+                    description: 'JSON Schema (draft 2020-12) describing the Loadmill test-suite format.',
+                    mimeType: 'application/schema+json',
+                },
+            ];
+            return { resources };
+        },
+    },
+    {
+        schema: types_js_1.ReadResourceRequestSchema,
+        handler: async (request) => {
+            const uri = request?.params?.uri;
+            console.log('Reading resource with URI:', uri);
+            if (!uri) {
+                return {
+                    contents: [
+                        {
+                            mimeType: 'text/plain',
+                            text: 'Missing resource URI',
+                        },
+                    ],
+                };
+            }
+            if (uri === 'loadmill://schemas/test-suite@v1') {
+                const schema = await (0, shared_js_1.getSchema)(uri);
+                console.log('Fetched schema for URI:', uri);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: schema,
+                        },
+                    ],
+                };
+            }
+            // Unknown resource
+            return {
+                contents: [
+                    {
+                        mimeType: 'text/plain',
+                        text: `Unknown resource: ${uri}`,
+                    },
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/handlers/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/resources/index.ts"],"names":[],"mappings":";;;AAAA,iEAG4C;AAE5C,4CAAyC;AAG5B,QAAA,QAAQ,GAAiB;IACpC;QACE,MAAM,EAAE,qCAA0B;QAClC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC1B,MAAM,SAAS,GAAG;gBAChB;oBACE,IAAI,EAAE,4BAA4B;oBAClC,KAAK,EAAE,4BAA4B;oBACnC,GAAG,EAAE,kCAAkC;oBACvC,WAAW,EACT,wEAAwE;oBAC1E,QAAQ,EAAE,yBAAyB;iBACpC;aACF,CAAC;YAEF,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;KACF;IACD;QACE,MAAM,EAAE,oCAAyB;QACjC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC;YAEjC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,EAAE;gBACR,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,QAAQ,EAAE,YAAY;4BACtB,IAAI,EAAE,sBAAsB;yBAC7B;qBACF;iBACF,CAAC;aACH;YAED,IAAI,GAAG,KAAK,kCAAkC,EAAE;gBAC9C,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAS,EAAC,GAAG,CAAC,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;gBAC5C,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG;4BACH,QAAQ,EAAE,kBAAkB;4BAC5B,IAAI,EAAE,MAAM;yBACb;qBACF;iBACF,CAAC;aACH;YAED,mBAAmB;YACnB,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE,qBAAqB,GAAG,EAAE;qBACjC;iBACF;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/handlers/shared.d.ts

@@ -0,0 +1,4 @@
+export declare function getSchema(schemaType: string): Promise<string>;
+export declare const schemaTypeToSchemaURL: {
+    [x: string]: string;
+};

package/dist/handlers/shared.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaTypeToSchemaURL = exports.getSchema = void 0;
+const constants_1 = require("../constants");
+const http_request_1 = require("../http-request");
+const schemaCache = new Map();
+async function getSchema(schemaType) {
+    try {
+        console.log('Getting schema with type:', schemaType);
+        const schemaUrl = getSchemaURLByType(schemaType);
+        const cached = schemaCache.get(schemaUrl);
+        if (cached) {
+            if (!cached.expiresAt || Date.now() < cached.expiresAt) {
+                return cached.text;
+            }
+            schemaCache.delete(schemaUrl);
+        }
+        const resp = await (0, http_request_1.sendHttpRequest)({ method: http_request_1.HttpMethods.GET, url: schemaUrl });
+        const text = resp.text;
+        const entry = {
+            text,
+            expiresAt: Date.now() + 60 * 60 * 1000, // Cache for 60 minutes
+        };
+        console.log('Cached schema:', entry);
+        schemaCache.set(schemaUrl, entry);
+        return entry.text;
+    }
+    catch (error) {
+        console.error(`Failed to fetch schema for ${schemaType}:`, error);
+        throw error;
+    }
+}
+exports.getSchema = getSchema;
+exports.schemaTypeToSchemaURL = {
+    [constants_1.SCHEMA_TYPE.TEST_SUITE]: `${constants_1.ASSETS_URL}/schema/loadmill-test-suite.schema.v1.json`,
+};
+function getSchemaURLByType(schemaType) {
+    const schemaUrl = exports.schemaTypeToSchemaURL[schemaType];
+    //console.log('Resolved schema URL:', schemaUrl);
+    if (!schemaUrl) {
+        throw new Error(`Unknown schema type: ${schemaType}`);
+    }
+    return schemaUrl;
+}
+//# sourceMappingURL=shared.js.map

package/dist/handlers/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/handlers/shared.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,kDAA+D;AAO/D,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEjD,KAAK,UAAU,SAAS,CAAC,UAAkB;IAEhD,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;gBACtD,OAAO,MAAM,CAAC,IAAI,CAAC;aACpB;YACD,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAC/B;QAED,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAe,EAAC,EAAE,MAAM,EAAE,0BAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvB,MAAM,KAAK,GAAqB;YAC9B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,uBAAuB;SAChE,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACrC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,IAAI,CAAC;KACnB;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC;KACb;AACH,CAAC;AA5BD,8BA4BC;AAEY,QAAA,qBAAqB,GAAG;IACnC,CAAC,uBAAW,CAAC,UAAU,CAAC,EAAE,GAAG,sBAAU,4CAA4C;CACpF,CAAC;AAEF,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,MAAM,SAAS,GAAG,6BAAqB,CAAC,UAAU,CAAC,CAAC;IACpD,iDAAiD;IACjD,IAAI,CAAC,SAAS,EAAE;QACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;KACvD;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/handlers/tools/index.d.ts

@@ -0,0 +1,2 @@
+import { MCPHandler } from '../../mcp-handler.js';
+export declare const handlers: MCPHandler[];

package/dist/handlers/tools/index.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlers = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const constants_js_1 = require("../../constants.js");
+const tasks_js_1 = require("./tasks.js");
+exports.handlers = [
+    {
+        schema: types_js_1.ListToolsRequestSchema,
+        handler: async () => {
+            const tools = [
+                {
+                    name: constants_js_1.SEARCH_TEST_SUITES,
+                    title: 'Search Test Suites',
+                    description: 'A tool to search for Loadmill test suites. Returns a list of test suites',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            search: {
+                                type: 'string',
+                                description: 'free text filter to search for test suites',
+                            },
+                            page: {
+                                type: 'integer',
+                                description: 'page number for pagination',
+                            },
+                            labels: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                    description: 'filter suites that have flows with these labels',
+                                },
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.VALIDATE_TEST_SUITE,
+                    title: 'Validate Test Suite',
+                    description: 'Validates a test-suite file against the official JSON Schema.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            path: {
+                                type: 'string',
+                                description: 'Path to a JSON file containing a Loadmill test-suite',
+                            },
+                        },
+                        required: ['path'],
+                    },
+                },
+                {
+                    name: constants_js_1.SEARCH_TEST_SUITE_RUNS,
+                    title: 'Search Test Suite Runs',
+                    description: 'A tool to search for Loadmill test suite runs. Returns a list of test suite runs',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            search: {
+                                type: 'string',
+                                description: 'free text filter to search for test suites',
+                            },
+                            page: {
+                                type: 'integer',
+                                description: 'page number for pagination',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.RUN_TEST_SUITE,
+                    title: 'Run Test Suite',
+                    description: 'A tool to run a Loadmill test suite. Returns the id of the running suite',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'ID of the test suite to run',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.GET_TEST_SUITE_RUN,
+                    title: 'Get Test Suite Run',
+                    description: `A tool to get a Loadmill test suite run by its ID. 
+          Returns the run details including the testSuiteFlowRuns list that can be fetched later and is useful for understanding the flow of the test run.`,
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'ID of the test suite run to fetch',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.GET_TEST_SUITE_FLOW_RUN,
+                    title: 'Get Test Suite Flow Run',
+                    description: `A tool to get a Loadmill test suite flow run by its ID. 
+          Returns the run details. Use this when investigating the test run results.`,
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            flowRunId: {
+                                type: 'string',
+                                description: 'ID of the test suite flow run to fetch',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.SEARCH_TEST_PLAN,
+                    title: 'Search Test Plans',
+                    description: 'A tool to search for Loadmill test plans. Returns a list of test plans with their descriptions (names) and the author\'s information.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            search: {
+                                type: 'string',
+                                description: 'free text filter to search for test suites',
+                            },
+                            page: {
+                                type: 'integer',
+                                description: 'page number for pagination',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.RUN_TEST_PLAN,
+                    title: 'Run a Test Plan',
+                    description: 'A tool to run a Loadmill test plan. Returns the id of the running plan',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'ID of the test plan to run',
+                            },
+                            labels: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                    description: 'filter suites that have flows with these labels',
+                                },
+                            },
+                            overrideParameters: {
+                                type: 'string',
+                                description: `Parameters to override in the test plan.
+                A string of comma separated list of key-value pairs, e.g. "param1=value1,param2=value2".`,
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.GET_TEST_PLAN_RUN,
+                    title: 'Get Test Plan Run',
+                    description: 'A tool to get a Loadmill test plan run by its ID. Returns the run details.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'ID of the test plan run to fetch',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: constants_js_1.GET_LABELS,
+                    title: 'Get Labels',
+                    description: 'A tool to fetch all available labels in Loadmill.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+            ];
+            return { tools };
+        },
+    },
+    {
+        schema: types_js_1.CallToolRequestSchema,
+        handler: async (request) => {
+            if (!constants_js_1.AVALIABLE_TOOLS.includes(request.params.name)) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
+            }
+            const tool = tasks_js_1.toolsTasks[request.params.name];
+            if (!tool) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
+            }
+            return await tool(request.params);
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/handlers/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"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"}