wopee-mcp 1.7.1 → 1.11.0

package/README.md

@@ -38,6 +38,38 @@ Add this server to your MCP configuration.
 
 - **`WOPEE_API_URL`** - The Wopee API endpoint URL. Should be specified only for testing/development purposes.
 
+### Corporate Proxy Configuration
+
+If you're behind a corporate proxy/VPN and experiencing connection timeouts, you can configure proxy settings using standard environment variables:
+
+```json
+{
+  "mcpServers": {
+    "wopee": {
+      "command": "npx wopee-mcp",
+      "env": {
+        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
+        "WOPEE_API_KEY": "your-api-key-here",
+        "HTTPS_PROXY": "http://your-proxy-server:8080"
+      }
+    }
+  }
+}
+```
+
+#### Supported Proxy Environment Variables
+
+- **`HTTPS_PROXY`** or **`https_proxy`** - Proxy server URL for HTTPS connections (recommended)
+- **`HTTP_PROXY`** or **`http_proxy`** - Fallback proxy server URL
+
+#### Finding Your Proxy Settings
+
+If you're unsure about your proxy settings, check your VS Code settings (`settings.json`) for `http.proxy` value, or consult your IT department. Common corporate proxy formats:
+
+- `http://proxy.company.com:8080`
+- `http://10.x.x.x:8080`
+- `http://username:password@proxy.company.com:8080` (if authentication is required)
+
 ## Getting Started
 
 Most tools in this MCP server require a `suiteUuid` to operate. You have two options to get started:
@@ -92,15 +124,15 @@ Dispatch a new analysis suite
 
 ### Generation Tools
 
-These tools generate various artifacts for a specific suite. All require a `suiteUuid` and `fileType` to generate.
+These tools generate various artifacts for a specific suite. All require a `suiteUuid` and `type` to generate.
 
-#### `wopee_generate_file`
+#### `wopee_generate_artifact`
 
 Generates a specific file(artifact) for the selected suite.
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite
-  - `fileType` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES_WITH_TEST_CASES" | "TEST_CASES" | "TEST_CASE_STEPS" | "REUSABLE_TEST_CASES" | "REUSABLE_TEST_CASE_STEPS"`
+  - `type` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES_WITH_TEST_CASES" | "TEST_CASES" | "TEST_CASE_STEPS" | "REUSABLE_TEST_CASES" | "REUSABLE_TEST_CASE_STEPS"`
 - **Returns:** Generated output in case of successful generation.
 
 **Example Usage:**
@@ -111,15 +143,16 @@ Generate app context for my most recent analysis suite
 
 ### Fetch Tools
 
-These tools retrieve generated artifacts for a specific suite. All require a `suiteUuid` and `fileType`.
+These tools retrieve generated artifacts for a specific suite. All require a `suiteUuid` and `type`.
 
-#### `wopee_fetch_file`
+#### `wopee_fetch_artifact`
 
 Fetches the enquired file(artifact) from the selected suite.
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite
-  - `fileType` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "TEST_CASES"`
+  - `type` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"`
+  - `identifier` - Identifier of the test case to fetch Playwright code for, ex. `US003:TC004`
 - **Returns:** The file contents in case of successful fetch.
 
 **Example Usage:**
@@ -130,16 +163,17 @@ Fetch user stories for the latest suite
 
 ### Update Tools
 
-These tools are used to update or set certain files(artifacts) for a specific suite. `suiteUuid`, `fileType` and `fileContent` is required.
+These tools are used to update or set certain files(artifacts) for a specific suite. `suiteUuid`, `type` and `content` is required.
 
-#### `wopee_update_file`
+#### `wopee_update_artifact`
 
 Updates/replaces existing file(artifact) for a specific suite
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite
-  - `fileType` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "TEST_CASES"`
-  - `fileContent` - Markdown content for `app context` and `general user stories`, structured JSON for `user stories` and `test cases`
+  - `type` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"`
+  - `content` - Markdown content for `app context`, `general user stories` and `project context`, structured JSON for `user stories`
+  - `identifier` - Identifier of the test case to fetch Playwright code for, ex. `US003:TC004`
 - **Returns:** Boolean based of success status of the tool call
 
 **Example Usage:**
@@ -177,10 +211,12 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 
 2. **Generate artifacts:**
 
-   - Generate app context: `wopee_generate_file` with `APP_CONTEXT` and specific `suiteUuid`
-   - Generate general user stories: `wopee_generate_file` with `GENERAL_USER_STORIES` and specific `suiteUuid`
-   - Generate user stories: `wopee_generate_file` with `USER_STORIES` and specific `suiteUuid`
-   - Generate test cases: `wopee_generate_file` with `TEST_CASES` and specific `suiteUuid`
+   - Generate app context: `wopee_generate_artifact` with `APP_CONTEXT` and specific `suiteUuid`
+   - Generate general user stories: `wopee_generate_artifact` with `GENERAL_USER_STORIES` and specific `suiteUuid`
+   - Generate user stories with test cases: `wopee_generate_artifact` with `USER_STORIES_WITH_TEST_CASES` and specific `suiteUuid`
+   - Generate reusable test cases: `wopee_generate_artifact` with `REUSABLE_TEST_CASES` and specific `suiteUuid`
+   - Generate reusable test case steps: `wopee_generate_artifact` with `REUSABLE_TEST_CASE_STEPS` and specific `suiteUuid`
+   - Generate test case steps: `wopee_generate_artifact` with `TEST_CASE_STEPS` and specific `suiteUuid`
 
 3. **Fetch generated content:**
 

package/build/index.js

@@ -1,8 +1,17 @@
 #!/usr/bin/env node
+import { setGlobalDispatcher, ProxyAgent } from "undici";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { TOOLS } from "./tools/index.js";
 import { PROMPTS } from "./prompts/index.js";
+const proxyUrl = process.env.HTTPS_PROXY ||
+    process.env.https_proxy ||
+    process.env.HTTP_PROXY ||
+    process.env.http_proxy;
+if (proxyUrl) {
+    setGlobalDispatcher(new ProxyAgent(proxyUrl));
+    console.error(`[WOPEE]: Using proxy ${proxyUrl}`);
+}
 const server = new McpServer({
     name: "wopee-mcp",
     version: "1.0.0",

package/build/tools/index.js

@@ -1,6 +1,6 @@
-import { wopeeFetchFile } from "./wopee_fetch_file/index.js";
-import { wopeeUpdateFile } from "./wopee_update_file/index.js";
-import { wopeeGenerateFile } from "./wopee_generate_file/index.js";
+import { wopeeFetchArtifact } from "./wopee_fetch_artifact/index.js";
+import { wopeeUpdateArtifact } from "./wopee_update_artifact/index.js";
+import { wopeeGenerateArtifact } from "./wopee_generate_artifact/index.js";
 import { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
 import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
@@ -8,7 +8,7 @@ export const TOOLS = [
     wopeeFetchAnalysisSuites,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
-    wopeeFetchFile,
-    wopeeUpdateFile,
-    wopeeGenerateFile,
+    wopeeFetchArtifact,
+    wopeeUpdateArtifact,
+    wopeeGenerateArtifact,
 ];

package/build/tools/shared/factories.js

@@ -1,12 +1,14 @@
 import { getConfig } from "../../utils/getConfig.js";
-export const createFetchFileInput = (input) => {
+export const createFetchArtifactInput = (input) => {
     const { WOPEE_PROJECT_UUID } = getConfig();
     if (!WOPEE_PROJECT_UUID)
         throw new Error("WOPEE_PROJECT_UUID is not set");
+    const { type, suiteUuid, identifier } = input;
     return {
+        type,
+        suiteUuid,
         projectUuid: WOPEE_PROJECT_UUID,
-        suiteUuid: input.suiteUuid,
-        bucket: input.bucket,
+        ...(identifier ? { identifier } : {}),
     };
 };
 export const createGenerateAIDataInput = (input) => {
@@ -31,14 +33,16 @@ export const createGenerateAIDataInput = (input) => {
         sourceSuiteUuid: null,
     };
 };
-export const createUpdateFileInput = (input) => {
+export const createUpdateArtifactInput = (input) => {
     const { WOPEE_PROJECT_UUID } = getConfig();
     if (!WOPEE_PROJECT_UUID)
         throw new Error("WOPEE_PROJECT_UUID is not set");
+    const { type, suiteUuid, content, identifier } = input;
     return {
-        bucket: input.bucket,
+        type,
+        content,
+        suiteUuid,
         projectUuid: WOPEE_PROJECT_UUID,
-        suiteUuid: input.suiteUuid,
-        [input.outputType === "markdown" ? "code" : "json"]: input.fileContent,
+        ...(identifier ? { identifier } : {}),
     };
 };

package/build/tools/shared/gql-queries.js

@@ -1,13 +1,38 @@
-export const FetchFile = `
-  query FetchFile($projectUuid: ID!, $suiteUuid: ID!, $bucket: String!) {
-    fetchFile(projectUuid: $projectUuid, suiteUuid: $suiteUuid, bucket: $bucket)
+export const FetchArtifact = `
+  query FetchArtifact($input: FetchArtifactInput!) {
+    fetchArtifact(input: $input) {
+      content
+      blobSha
+      commitSha
+      commitDate
+    }
+  }
+`;
+export const UpdateArtifact = `
+  mutation Mutation($input: UpdateArtifactInput!) {
+    updateArtifact(input: $input)
   }
 `;
 export const DispatchAgent = `
   mutation DispatchAgent(
     $input: TestCasesInput!
   ) {
-    dispatchAgent(input: $input)
+    dispatchAgent(input: $input) {
+      uuid
+      projectUuid
+      suiteUuid
+      analysisSuiteUuid
+      analysisIdentifier
+      userStoryId
+      testCaseId
+      executionStatus
+      agentReport
+      agentReportStatus
+      codeReport
+      codeReportStatus
+      createdAt
+      updatedAt
+    }
   }
 `;
 export const DispatchAnalysis = `
@@ -130,8 +155,3 @@ export const GenerateReusableTestCaseSteps = `
     generateReusableTestCaseSteps(input: $input)
   }
 `;
-export const UpdateFile = `
-  mutation UpdateFile($input: UpdateFileInput!) {
-    updateFile(input: $input)
-  }
-`;

package/build/tools/shared/handlers.js

@@ -1,113 +1,21 @@
-import { z } from "zod";
-import { FetchFileInputSchema, UpdateFileInputSchema, GenerateAIDataInputSchema, } from "./schemas.js";
-import { FetchFile, UpdateFile, GenerateAppContext, GenerateGeneralUserStories, GenerateUserStoriesWithTestCases, GenerateTestCases, GenerateReusableTestCases, GenerateReusableTestCaseSteps, GenerateTestCaseSteps, } from "./gql-queries.js";
-import { createFetchFileInput, createUpdateFileInput, createGenerateAIDataInput, } from "./factories.js";
-import { Bucket, FileType } from "./types.js";
+import { FetchArtifactInputSchema, UpdateArtifactInputSchema, GenerateAIDataInputSchema, } from "./schemas.js";
+import { FetchArtifact, UpdateArtifact } from "./gql-queries.js";
+import { createFetchArtifactInput, createUpdateArtifactInput, createGenerateAIDataInput, } from "./factories.js";
 import { requestClient } from "../../utils/requestClient.js";
-export function parseError(error) {
-    console.error(error instanceof z.ZodError ? error.issues : error);
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Failed to parse input: ${error instanceof z.ZodError
-                    ? error.issues
-                        .map((issue) => `${issue.path[0] ?? "Unknown"}: ${issue.message}`)
-                        .join("\n")
-                    : error instanceof Error
-                        ? error.message
-                        : "Unknown zod validation error"}`,
-            },
-        ],
-    };
-}
-function parseFileType(type) {
-    switch (type) {
-        case FileType.APP_CONTEXT:
-            return {
-                query: GenerateAppContext,
-                dataKey: "generateAppContext",
-                bucket: Bucket.APP_CONTEXT,
-                outputType: "markdown",
-                description: "application's context markdown file for selected suite",
-            };
-        case FileType.GENERAL_USER_STORIES:
-            return {
-                query: GenerateGeneralUserStories,
-                dataKey: "generateGeneralUserStories",
-                bucket: Bucket.GENERAL_USER_STORIES,
-                outputType: "markdown",
-                description: "general user stories markdown file for selected suite",
-            };
-        case FileType.USER_STORIES_WITH_TEST_CASES:
-            return {
-                query: GenerateUserStoriesWithTestCases,
-                dataKey: "generateUserStoriesWithTestCases",
-                bucket: Bucket.USER_STORIES,
-                outputType: "json",
-                description: "generate user stories with test cases without test case steps JSON file for selected suite",
-            };
-        case FileType.TEST_CASES:
-            return {
-                query: GenerateTestCases,
-                dataKey: "generateTestCases",
-                bucket: Bucket.USER_STORIES,
-                outputType: "json",
-                description: "generate test cases without test case steps in user stories for selected suite",
-            };
-        case FileType.REUSABLE_TEST_CASES:
-            return {
-                query: GenerateReusableTestCases,
-                dataKey: "generateReusableTestCases",
-                bucket: Bucket.USER_STORIES,
-                outputType: "json",
-                description: "generate reusable blocks without test case steps in user stories for selected suite",
-            };
-        case FileType.REUSABLE_TEST_CASE_STEPS:
-            return {
-                query: GenerateReusableTestCaseSteps,
-                dataKey: "generateReusableTestCaseSteps",
-                bucket: Bucket.USER_STORIES,
-                outputType: "json",
-                description: "generate steps for reusable blocks in user stories for selected suite",
-            };
-        case FileType.TEST_CASE_STEPS:
-            return {
-                query: GenerateTestCaseSteps,
-                dataKey: "generateTestCaseSteps",
-                bucket: Bucket.USER_STORIES,
-                outputType: "json",
-                description: "generate test case steps for test cases in user stories for selected suite",
-            };
-        default:
-            return {
-                query: null,
-                dataKey: null,
-                bucket: null,
-                outputType: null,
-                description: null,
-            };
-    }
-}
-export async function fetchFile(input) {
+import { _convertToArtifactType, _parseError, _parseGenerateArtifactType, } from "./helpers.js";
+export async function fetchArtifact(input) {
     try {
-        const { bucket, description } = parseFileType(input.fileType);
-        if (!bucket || !description)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to parse file type",
-                    },
-                ],
-            };
-        const fetchFileInput = createFetchFileInput({
-            bucket,
-            suiteUuid: input.suiteUuid,
+        const { type, suiteUuid, identifier } = input;
+        const fetchArtifactInput = createFetchArtifactInput({
+            type,
+            suiteUuid,
+            ...(identifier ? { identifier } : {}),
         });
-        const parsedInput = FetchFileInputSchema.parse(fetchFileInput);
-        const result = await requestClient(FetchFile, parsedInput);
-        if (!result || !result.fetchFile)
+        const parsedInput = FetchArtifactInputSchema.parse(fetchArtifactInput);
+        const result = await requestClient(FetchArtifact, {
+            input: parsedInput,
+        });
+        if (!result || !result?.fetchArtifact || !result?.fetchArtifact?.content)
             return {
                 content: [
                     {
@@ -120,18 +28,18 @@ export async function fetchFile(input) {
             content: [
                 {
                     type: "text",
-                    text: result.fetchFile,
+                    text: result.fetchArtifact.content,
                 },
             ],
         };
     }
     catch (error) {
-        return parseError(error);
+        return _parseError(error);
     }
 }
 export async function generateAIDataFile(input) {
-    const { query, dataKey, bucket, description } = parseFileType(input.fileType);
-    if (!query || !dataKey || !description || !bucket)
+    const { query, dataKey, description } = _parseGenerateArtifactType(input.type);
+    if (!query || !dataKey || !description)
         return {
             content: [
                 {
@@ -155,38 +63,30 @@ export async function generateAIDataFile(input) {
                     },
                 ],
             };
-        return await fetchFile({
+        const convertedType = _convertToArtifactType(input.type);
+        return await fetchArtifact({
             suiteUuid: parsedInput.suiteUuid,
-            fileType: input.fileType,
+            type: convertedType,
         });
     }
     catch (error) {
-        return parseError(error);
+        return _parseError(error);
     }
 }
-export async function updateFile(input) {
+export async function updateArtifact(input) {
     try {
-        const { bucket, outputType } = parseFileType(input.fileType);
-        if (!bucket || !outputType)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to parse file type",
-                    },
-                ],
-            };
-        const updateFileInput = createUpdateFileInput({
-            bucket,
-            outputType,
-            suiteUuid: input.suiteUuid,
-            fileContent: input.fileContent,
+        const { type, suiteUuid, content, identifier } = input;
+        const updateArtifactInput = createUpdateArtifactInput({
+            type,
+            content,
+            suiteUuid,
+            ...(identifier ? { identifier } : {}),
         });
-        const parsedInput = UpdateFileInputSchema.parse(updateFileInput);
-        const updateFileResult = await requestClient(UpdateFile, {
+        const parsedInput = UpdateArtifactInputSchema.parse(updateArtifactInput);
+        const updateFileResult = await requestClient(UpdateArtifact, {
             input: parsedInput,
         });
-        if (!updateFileResult || !updateFileResult.updateFile)
+        if (!updateFileResult || !updateFileResult.updateArtifact)
             return {
                 content: [
                     {
@@ -205,6 +105,6 @@ export async function updateFile(input) {
         };
     }
     catch (error) {
-        return parseError(error);
+        return _parseError(error);
     }
 }

package/build/tools/shared/helpers.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { GenerateAppContext, GenerateGeneralUserStories, GenerateReusableTestCases, GenerateReusableTestCaseSteps, GenerateTestCases, GenerateTestCaseSteps, GenerateUserStoriesWithTestCases, } from "./gql-queries.js";
+import { ArtifactType, GenerateArtifactType } from "./types.js";
+export function _convertToArtifactType(type) {
+    switch (type) {
+        case GenerateArtifactType.APP_CONTEXT:
+            return ArtifactType.APP_CONTEXT;
+        case GenerateArtifactType.GENERAL_USER_STORIES:
+            return ArtifactType.GENERAL_USER_STORIES;
+        case GenerateArtifactType.USER_STORIES_WITH_TEST_CASES:
+        case GenerateArtifactType.REUSABLE_TEST_CASES:
+        case GenerateArtifactType.REUSABLE_TEST_CASE_STEPS:
+        case GenerateArtifactType.TEST_CASES:
+        case GenerateArtifactType.TEST_CASE_STEPS:
+            return ArtifactType.USER_STORIES;
+    }
+}
+export function _parseGenerateArtifactType(type) {
+    switch (type) {
+        case GenerateArtifactType.APP_CONTEXT:
+            return {
+                query: GenerateAppContext,
+                dataKey: "generateAppContext",
+                description: "application's context markdown file for selected suite",
+            };
+        case GenerateArtifactType.GENERAL_USER_STORIES:
+            return {
+                query: GenerateGeneralUserStories,
+                dataKey: "generateGeneralUserStories",
+                description: "general user stories markdown file for selected suite",
+            };
+        case GenerateArtifactType.USER_STORIES_WITH_TEST_CASES:
+            return {
+                query: GenerateUserStoriesWithTestCases,
+                dataKey: "generateUserStoriesWithTestCases",
+                description: "generate user stories with test cases without test case steps JSON file for selected suite",
+            };
+        case GenerateArtifactType.TEST_CASES:
+            return {
+                query: GenerateTestCases,
+                dataKey: "generateTestCases",
+                description: "generate test cases without test case steps in user stories for selected suite",
+            };
+        case GenerateArtifactType.REUSABLE_TEST_CASES:
+            return {
+                query: GenerateReusableTestCases,
+                dataKey: "generateReusableTestCases",
+                description: "generate reusable blocks without test case steps in user stories for selected suite",
+            };
+        case GenerateArtifactType.REUSABLE_TEST_CASE_STEPS:
+            return {
+                query: GenerateReusableTestCaseSteps,
+                dataKey: "generateReusableTestCaseSteps",
+                description: "generate steps for reusable blocks in user stories for selected suite",
+            };
+        case GenerateArtifactType.TEST_CASE_STEPS:
+            return {
+                query: GenerateTestCaseSteps,
+                dataKey: "generateTestCaseSteps",
+                description: "generate test case steps for test cases in user stories for selected suite",
+            };
+        default:
+            return {
+                query: null,
+                dataKey: null,
+                description: null,
+            };
+    }
+}
+export function _parseError(error) {
+    console.error(error instanceof z.ZodError ? error.issues : error);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Failed to parse input: ${error instanceof z.ZodError
+                    ? error.issues
+                        .map((issue) => `${issue.path[0] ?? "Unknown"}: ${issue.message}`)
+                        .join("\n")
+                    : error instanceof Error
+                        ? error.message
+                        : "Unknown zod validation error"}`,
+            },
+        ],
+    };
+}

package/build/tools/shared/schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Bucket, FileType } from "./types.js";
+import { ArtifactType, GenerateArtifactType } from "./types.js";
 var CookiesPreference;
 (function (CookiesPreference) {
     CookiesPreference["ACCEPT_ALL"] = "ACCEPT_ALL";
@@ -15,7 +15,7 @@ export const SuiteAnalysisConfigSchema = z.object({
     additionalVariables: z.string().nullable().default(null),
 });
 export const GenerateAIDataHandlerInputSchema = z.object({
-    fileType: z.nativeEnum(FileType, {
+    type: z.nativeEnum(GenerateArtifactType, {
         description: "Chosen type of file(artifact) to generate",
     }),
     suiteUuid: z
@@ -32,44 +32,71 @@ export const GenerateAIDataInputSchema = z.object({
     suiteAnalysisConfig: SuiteAnalysisConfigSchema,
     continueGeneration: z.boolean().nullish().default(false),
 });
-export const FetchFileHandlerInputSchema = z.object({
-    fileType: z.nativeEnum(FileType, {
+export const FetchArtifactHandlerInputSchema = z.object({
+    type: z.nativeEnum(ArtifactType, {
         description: "Chosen file(artifact) to fetch",
     }),
     suiteUuid: z
         .string({ description: "UUID of the suite to fetch the file from" })
         .min(1, "Suite UUID is required"),
+    identifier: z
+        .string({
+        description: "Identifier for the test case to fetch playwright code for, ex. `US004:TC006`, should be provided only for `PLAYWRIGHT_CODE` artifact type",
+    })
+        .optional(),
 });
-export const FetchFileFactoryInputSchema = z.object({
+export const FetchArtifactFactoryInputSchema = z.object({
     suiteUuid: z.string().min(1, "Suite UUID is required"),
-    bucket: z.nativeEnum(Bucket),
+    type: z.nativeEnum(ArtifactType),
+    identifier: z
+        .string({
+        description: "Identifier for the test case to fetch playwright code for, ex. `US004:TC006`, should be provided only for `PLAYWRIGHT_CODE` artifact type",
+    })
+        .nullish(),
 });
-export const FetchFileInputSchema = z.object({
+export const FetchArtifactInputSchema = z.object({
     projectUuid: z.string().min(1, "Project UUID is required"),
     suiteUuid: z.string().min(1, "Suite UUID is required"),
-    bucket: z.nativeEnum(Bucket),
+    type: z.nativeEnum(ArtifactType),
+    identifier: z
+        .string({
+        description: "Identifier for the test case to fetch playwright code for, ex. `US004:TC006`, should be provided only for `PLAYWRIGHT_CODE` artifact type",
+    })
+        .nullish(),
+    ref: z.string().nullish(), // branch, tag or commit sha
 });
-export const UpdateFileHandlerInputSchema = z.object({
-    fileType: z.nativeEnum(FileType, {
+export const UpdateArtifactHandlerInputSchema = z.object({
+    type: z.nativeEnum(ArtifactType, {
         description: "Chosen file(artifact) to update",
     }),
-    fileContent: z.string({
+    content: z.string({
         description: "Content of the file(artifact) to update",
     }),
     suiteUuid: z
         .string({ description: "UUID of the suite to update the file for" })
         .min(1, "Suite UUID is required"),
+    identifier: z
+        .string({
+        description: "Identifier for the test case to update playwright code for, ex. `US004:TC006`, should be provided only for `PLAYWRIGHT_CODE` artifact type",
+    })
+        .optional(),
 });
-export const UpdateFileFactoryInputSchema = z.object({
-    bucket: z.nativeEnum(Bucket),
+export const UpdateArtifactFactoryInputSchema = z.object({
+    type: z.nativeEnum(ArtifactType),
     suiteUuid: z.string().min(1, "Suite UUID is required"),
-    fileContent: z.string(),
-    outputType: z.enum(["markdown", "json"]),
+    content: z.string(),
+    identifier: z.string().optional(),
 });
-export const UpdateFileInputSchema = z.object({
+export const UpdateArtifactInputSchema = z.object({
     projectUuid: z.string().min(1, "Project UUID is required"),
     suiteUuid: z.string().min(1, "Suite UUID is required"),
-    bucket: z.nativeEnum(Bucket),
-    json: z.string().nullish(),
-    code: z.string().nullish(),
+    type: z.nativeEnum(ArtifactType),
+    identifier: z
+        .string({
+        description: "Identifier for the test case to update playwright code for, ex. `US004:TC006`, should be provided only for `PLAYWRIGHT_CODE` artifact type",
+    })
+        .nullish(),
+    content: z.string({
+        description: "Content of the artifact to update",
+    }),
 });

package/build/tools/shared/types.js

@@ -3,29 +3,28 @@ export var ToolName;
     ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
     ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
     ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";
-    ToolName["WOPEE_FETCH_FILE"] = "wopee_fetch_file";
-    ToolName["WOPEE_UPDATE_FILE"] = "wopee_update_file";
-    ToolName["WOPEE_GENERATE_FILE"] = "wopee_generate_file";
+    ToolName["WOPEE_FETCH_ARTIFACT"] = "wopee_fetch_artifact";
+    ToolName["WOPEE_UPDATE_ARTIFACT"] = "wopee_update_artifact";
+    ToolName["WOPEE_GENERATE_ARTIFACT"] = "wopee_generate_artifact";
 })(ToolName || (ToolName = {}));
-export const Bucket = {
-    APP_CONTEXT: "project-suite-app-context",
-    GENERAL_USER_STORIES: "project-suite-general-user-stories",
-    USER_STORIES: "project-suite-user-stories",
-    PAGE_CONTENT: "screen-instance-page-content",
-    PROMPTS: "project-prompts",
-    PLAYWRIGHT_CODE: "project-suite-playwright-code",
-    UPLOADED_PAGE_DATA: "project-uploaded-page-data",
-};
-export var FileType;
-(function (FileType) {
-    FileType["APP_CONTEXT"] = "APP_CONTEXT";
-    FileType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
-    FileType["USER_STORIES_WITH_TEST_CASES"] = "USER_STORIES_WITH_TEST_CASES";
-    FileType["TEST_CASES"] = "TEST_CASES";
-    FileType["TEST_CASE_STEPS"] = "TEST_CASE_STEPS";
-    FileType["REUSABLE_TEST_CASES"] = "REUSABLE_TEST_CASES";
-    FileType["REUSABLE_TEST_CASE_STEPS"] = "REUSABLE_TEST_CASE_STEPS";
-})(FileType || (FileType = {}));
+export var GenerateArtifactType;
+(function (GenerateArtifactType) {
+    GenerateArtifactType["APP_CONTEXT"] = "APP_CONTEXT";
+    GenerateArtifactType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
+    GenerateArtifactType["USER_STORIES_WITH_TEST_CASES"] = "USER_STORIES_WITH_TEST_CASES";
+    GenerateArtifactType["TEST_CASES"] = "TEST_CASES";
+    GenerateArtifactType["TEST_CASE_STEPS"] = "TEST_CASE_STEPS";
+    GenerateArtifactType["REUSABLE_TEST_CASES"] = "REUSABLE_TEST_CASES";
+    GenerateArtifactType["REUSABLE_TEST_CASE_STEPS"] = "REUSABLE_TEST_CASE_STEPS";
+})(GenerateArtifactType || (GenerateArtifactType = {}));
+export var ArtifactType;
+(function (ArtifactType) {
+    ArtifactType["APP_CONTEXT"] = "APP_CONTEXT";
+    ArtifactType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
+    ArtifactType["USER_STORIES"] = "USER_STORIES";
+    ArtifactType["PLAYWRIGHT_CODE"] = "PLAYWRIGHT_CODE";
+    ArtifactType["PROJECT_CONTEXT"] = "PROJECT_CONTEXT";
+})(ArtifactType || (ArtifactType = {}));
 export var SuiteType;
 (function (SuiteType) {
     SuiteType["BOT"] = "BOT";

package/build/tools/wopee_dispatch_agent/index.js

@@ -1,6 +1,6 @@
 import { DispatchAgentInputSchema, WopeeDispatchAgentInputSchema, } from "./schema.js";
 import { ToolName } from "../shared/types.js";
-import { parseError } from "../shared/handlers.js";
+import { _parseError } from "../shared/helpers.js";
 import { createDispatchAgentInput } from "./factory.js";
 import { DispatchAgent } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
@@ -18,7 +18,7 @@ export const wopeeDispatchAgent = {
             const result = await requestClient(DispatchAgent, {
                 input: parsedInput,
             });
-            if (!result || !result.dispatchAgent)
+            if (!result || result?.dispatchAgent?.length === 0)
                 return {
                     content: [
                         {
@@ -37,7 +37,7 @@ export const wopeeDispatchAgent = {
             };
         }
         catch (error) {
-            return parseError(error);
+            return _parseError(error);
         }
     },
 };

package/build/tools/wopee_dispatch_analysis/index.js

@@ -1,4 +1,4 @@
-import { parseError } from "../shared/handlers.js";
+import { _parseError } from "../shared/helpers.js";
 import { DispatchAnalysisInputSchema } from "./schema.js";
 import { createDispatchAnalysisInput } from "./factory.js";
 import { DispatchAnalysis } from "../shared/gql-queries.js";
@@ -36,7 +36,7 @@ export const wopeeDispatchAnalysis = {
             };
         }
         catch (error) {
-            return parseError(error);
+            return _parseError(error);
         }
     },
 };

package/build/tools/wopee_fetch_artifact/index.js

@@ -0,0 +1,12 @@
+import { FetchArtifactHandlerInputSchema, } from "../shared/schemas.js";
+import { ToolName } from "../shared/types.js";
+import { fetchArtifact } from "../shared/handlers.js";
+export const wopeeFetchArtifact = {
+    name: ToolName.WOPEE_FETCH_ARTIFACT,
+    config: {
+        title: "Fetch file(artifact)",
+        description: "Fetch suite's file(artifact) for selected project",
+        inputSchema: FetchArtifactHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchArtifact(input),
+};

package/build/tools/{wopee_generate_file → wopee_generate_artifact}/index.js

@@ -1,8 +1,8 @@
 import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
 import { ToolName } from "../shared/types.js";
 import { generateAIDataFile } from "../shared/handlers.js";
-export const wopeeGenerateFile = {
-    name: ToolName.WOPEE_GENERATE_FILE,
+export const wopeeGenerateArtifact = {
+    name: ToolName.WOPEE_GENERATE_ARTIFACT,
     config: {
         title: "Generate file(artifact)",
         description: "Generate AI data file for selected suite",

package/build/tools/wopee_update_artifact/index.js

@@ -0,0 +1,12 @@
+import { UpdateArtifactHandlerInputSchema, } from "../shared/schemas.js";
+import { ToolName } from "../shared/types.js";
+import { updateArtifact } from "../shared/handlers.js";
+export const wopeeUpdateArtifact = {
+    name: ToolName.WOPEE_UPDATE_ARTIFACT,
+    config: {
+        title: "Update file",
+        description: "Update file(artifact) in the project",
+        inputSchema: UpdateArtifactHandlerInputSchema.shape,
+    },
+    handler: async (input) => await updateArtifact(input),
+};

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.7.1",
+  "version": "1.11.0",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {
@@ -30,13 +30,14 @@
   "license": "ISC",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.21.0",
+    "undici": "^7.18.2",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/node": "^24.10.0",
     "semantic-release": "^24.2.7",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/changelog": "^6.0.3"
+    "typescript": "^5.9.3"
   }
 }

package/build/tools/wopee_fetch_file/index.js

@@ -1,12 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { ToolName } from "../shared/types.js";
-import { fetchFile } from "../shared/handlers.js";
-export const wopeeFetchFile = {
-    name: ToolName.WOPEE_FETCH_FILE,
-    config: {
-        title: "Fetch file(artifact)",
-        description: "Fetch suite's file(artifact) for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile(input),
-};

package/build/tools/wopee_update_file/index.js

@@ -1,12 +0,0 @@
-import { UpdateFileHandlerInputSchema, } from "../shared/schemas.js";
-import { ToolName } from "../shared/types.js";
-import { updateFile } from "../shared/handlers.js";
-export const wopeeUpdateFile = {
-    name: ToolName.WOPEE_UPDATE_FILE,
-    config: {
-        title: "Update file",
-        description: "Update file(artifact) in the project",
-        inputSchema: UpdateFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await updateFile(input),
-};