wopee-mcp 1.3.0 → 1.5.0

package/README.md

@@ -210,6 +210,26 @@ Fetches the test cases JSON file for a suite.
 Fetch test cases for suite abc-123-def-456
 ```
 
+### Update Tools
+
+These tools are used to update or set certain files(artifacts) for a specific suite. `suiteUuid`, `fileType` and `fileContent` is required.
+
+#### `wopee_update_file`
+
+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`
+- **Returns:** Boolean based of success status of the tool call
+
+**Example Usage:**
+
+```
+Update app context file for the most recent suite with this content: <YourMarkdown>
+```
+
 ### Agent Testing
 
 #### `wopee_dispatch_agent`

package/build/tools/index.js

@@ -1,24 +1,14 @@
+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 { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
-import { wopeeFetchTestCases } from "./wopee_fetch_test_cases/index.js";
-import { wopeeFetchAppContext } from "./wopee_fetch_app_context/index.js";
 import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
-import { wopeeFetchUserStories } from "./wopee_fetch_user_stories/index.js";
-import { wopeeGenerateTestCases } from "./wopee_generate_test_cases/index.js";
-import { wopeeGenerateAppContext } from "./wopee_generate_app_context/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
-import { wopeeGenerateUserStories } from "./wopee_generate_user_stories/index.js";
-import { wopeeFetchGeneralUserStories } from "./wopee_fetch_general_user_stories/index.js";
-import { wopeeGenerateGeneralUserStories } from "./wopee_generate_general_user_stories/index.js";
 export const TOOLS = [
+    wopeeFetchAnalysisSuites,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
-    wopeeGenerateAppContext,
-    wopeeGenerateGeneralUserStories,
-    wopeeGenerateUserStories,
-    wopeeGenerateTestCases,
-    wopeeFetchAnalysisSuites,
-    wopeeFetchAppContext,
-    wopeeFetchGeneralUserStories,
-    wopeeFetchUserStories,
-    wopeeFetchTestCases,
+    wopeeFetchFile,
+    wopeeUpdateFile,
+    wopeeGenerateFile,
 ];

package/build/tools/shared/factories.js

@@ -30,3 +30,14 @@ export const createGenerateAIDataInput = (input) => {
         sourceSuiteUuid: null,
     };
 };
+export const createUpdateFileInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        bucket: input.bucket,
+        projectUuid: WOPEE_PROJECT_UUID,
+        suiteUuid: input.suiteUuid,
+        [input.outputType === "markdown" ? "code" : "json"]: input.fileContent,
+    };
+};

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

@@ -104,3 +104,8 @@ export const GenerateUserStories = `
     generateUserStories(input: $input)
   }
 `;
+export const UpdateFile = `
+  mutation UpdateFile($input: UpdateFileInput!) {
+    updateFile(input: $input)
+  }
+`;

package/build/tools/shared/handlers.js

@@ -1,8 +1,8 @@
 import { z } from "zod";
-import { FetchFileInputSchema, GenerateAIDataInputSchema, } from "./schemas.js";
-import { FetchFile, GenerateTestCases, GenerateAppContext, GenerateUserStories, GenerateGeneralUserStories, } from "./gql-queries.js";
-import { createFetchFileInput, createGenerateAIDataInput, } from "./factories.js";
-import { Bucket, GenerationType } from "./types.js";
+import { FetchFileInputSchema, UpdateFileInputSchema, GenerateAIDataInputSchema, } from "./schemas.js";
+import { FetchFile, UpdateFile, GenerateTestCases, GenerateAppContext, GenerateUserStories, GenerateGeneralUserStories, } from "./gql-queries.js";
+import { createFetchFileInput, createUpdateFileInput, createGenerateAIDataInput, } from "./factories.js";
+import { Bucket, FileType } from "./types.js";
 import { requestClient } from "../../utils/requestClient.js";
 export function parseError(error) {
     console.error(error instanceof z.ZodError ? error.issues : error);
@@ -21,47 +21,66 @@ export function parseError(error) {
         ],
     };
 }
-function parseGenerationType(type) {
+function parseFileType(type) {
     switch (type) {
-        case GenerationType.APP_CONTEXT:
+        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 GenerationType.GENERAL_USER_STORIES:
+        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 GenerationType.USER_STORIES:
+        case FileType.USER_STORIES:
             return {
                 query: GenerateUserStories,
                 dataKey: "generateUserStories",
                 bucket: Bucket.USER_STORIES,
+                outputType: "json",
                 description: "user stories JSON file for selected suite",
             };
-        case GenerationType.TEST_CASES:
+        case FileType.TEST_CASES:
             return {
                 query: GenerateTestCases,
                 dataKey: "generateTestCases",
                 bucket: Bucket.USER_STORIES,
+                outputType: "json",
                 description: "test cases for selected suite",
             };
         default:
             return {
                 query: null,
                 dataKey: null,
+                bucket: null,
+                outputType: null,
                 description: null,
             };
     }
 }
 export async function fetchFile(input) {
     try {
-        const fetchFileInput = createFetchFileInput(input);
+        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 parsedInput = FetchFileInputSchema.parse(fetchFileInput);
         const result = await requestClient(FetchFile, parsedInput);
         if (!result || !result.fetchFile)
@@ -86,8 +105,8 @@ export async function fetchFile(input) {
         return parseError(error);
     }
 }
-export async function generateAIDataFile(type, input) {
-    const { query, dataKey, bucket, description } = parseGenerationType(type);
+export async function generateAIDataFile(input) {
+    const { query, dataKey, bucket, description } = parseFileType(input.fileType);
     if (!query || !dataKey || !description || !bucket)
         return {
             content: [
@@ -114,8 +133,52 @@ export async function generateAIDataFile(type, input) {
             };
         return await fetchFile({
             suiteUuid: parsedInput.suiteUuid,
+            fileType: input.fileType,
+        });
+    }
+    catch (error) {
+        return parseError(error);
+    }
+}
+export async function updateFile(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 parsedInput = UpdateFileInputSchema.parse(updateFileInput);
+        const updateFileResult = await requestClient(UpdateFile, {
+            input: parsedInput,
         });
+        if (!updateFileResult || !updateFileResult.updateFile)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Failed to update file",
+                    },
+                ],
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "File updated successfully",
+                },
+            ],
+        };
     }
     catch (error) {
         return parseError(error);

package/build/tools/shared/schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Bucket } from "./types.js";
+import { Bucket, FileType } from "./types.js";
 var CookiesPreference;
 (function (CookiesPreference) {
     CookiesPreference["ACCEPT_ALL"] = "ACCEPT_ALL";
@@ -15,7 +15,12 @@ export const SuiteAnalysisConfigSchema = z.object({
     additionalVariables: z.string().nullable().default(null),
 });
 export const GenerateAIDataHandlerInputSchema = z.object({
-    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    fileType: z.nativeEnum(FileType, {
+        description: "Chosen type of file(artifact) to generate",
+    }),
+    suiteUuid: z
+        .string({ description: "UUID of the suite to generate file(artifact) for" })
+        .min(1, "Suite UUID is required"),
 });
 export const GenerateAIDataInputSchema = z.object({
     projectUuid: z.string().min(1, "Project UUID is required"),
@@ -27,7 +32,12 @@ export const GenerateAIDataInputSchema = z.object({
     continueGeneration: z.boolean().nullish().default(false),
 });
 export const FetchFileHandlerInputSchema = z.object({
-    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    fileType: z.nativeEnum(FileType, {
+        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"),
 });
 export const FetchFileFactoryInputSchema = z.object({
     suiteUuid: z.string().min(1, "Suite UUID is required"),
@@ -38,3 +48,27 @@ export const FetchFileInputSchema = z.object({
     suiteUuid: z.string().min(1, "Suite UUID is required"),
     bucket: z.nativeEnum(Bucket),
 });
+export const UpdateFileHandlerInputSchema = z.object({
+    fileType: z.nativeEnum(FileType, {
+        description: "Chosen file(artifact) to update",
+    }),
+    fileContent: 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"),
+});
+export const UpdateFileFactoryInputSchema = z.object({
+    bucket: z.nativeEnum(Bucket),
+    suiteUuid: z.string().min(1, "Suite UUID is required"),
+    fileContent: z.string(),
+    outputType: z.enum(["markdown", "json"]),
+});
+export const UpdateFileInputSchema = 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(),
+});

package/build/tools/shared/types.js

@@ -1,16 +1,11 @@
 export var ToolName;
 (function (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_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
-    ToolName["WOPEE_FETCH_APP_CONTEXT"] = "wopee_fetch_app_context";
-    ToolName["WOPEE_FETCH_GENERAL_USER_STORIES"] = "wopee_fetch_general_user_stories";
-    ToolName["WOPEE_FETCH_USER_STORIES"] = "wopee_fetch_user_stories";
-    ToolName["WOPEE_FETCH_TEST_CASES"] = "wopee_fetch_test_cases";
-    ToolName["WOPEE_GENERATE_APP_CONTEXT"] = "wopee_generate_app_context";
-    ToolName["WOPEE_GENERATE_GENERAL_USER_STORIES"] = "wopee_generate_general_user_stories";
-    ToolName["WOPEE_GENERATE_USER_STORIES"] = "wopee_generate_user_stories";
-    ToolName["WOPEE_GENERATE_TEST_CASES"] = "wopee_generate_test_cases";
+    ToolName["WOPEE_FETCH_FILE"] = "wopee_fetch_file";
+    ToolName["WOPEE_UPDATE_FILE"] = "wopee_update_file";
+    ToolName["WOPEE_GENERATE_FILE"] = "wopee_generate_file";
 })(ToolName || (ToolName = {}));
 export const Bucket = {
     APP_CONTEXT: "project-suite-app-context",
@@ -21,13 +16,13 @@ export const Bucket = {
     PLAYWRIGHT_CODE: "project-suite-playwright-code",
     UPLOADED_PAGE_DATA: "project-uploaded-page-data",
 };
-export var GenerationType;
-(function (GenerationType) {
-    GenerationType["APP_CONTEXT"] = "APP_CONTEXT";
-    GenerationType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
-    GenerationType["USER_STORIES"] = "USER_STORIES";
-    GenerationType["TEST_CASES"] = "TEST_CASES";
-})(GenerationType || (GenerationType = {}));
+export var FileType;
+(function (FileType) {
+    FileType["APP_CONTEXT"] = "APP_CONTEXT";
+    FileType["GENERAL_USER_STORIES"] = "GENERAL_USER_STORIES";
+    FileType["USER_STORIES"] = "USER_STORIES";
+    FileType["TEST_CASES"] = "TEST_CASES";
+})(FileType || (FileType = {}));
 export var SuiteType;
 (function (SuiteType) {
     SuiteType["BOT"] = "BOT";

package/build/tools/wopee_dispatch_agent/schema.js

@@ -1,12 +1,28 @@
 import { z } from "zod";
 const SelectedTestCasesSchema = z.object({
-    testCaseId: z.string().min(1, "Test case ID is required"),
-    userStoryId: z.string().min(1, "User story ID is required"),
+    testCaseId: z
+        .string({
+        description: "ID of the test case belonging to the user story to dispatch the agent for (ex. TC001)",
+    })
+        .min(1, "Test case ID is required"),
+    userStoryId: z
+        .string({
+        description: "ID of the user story that the test case belongs to (ex. US001)",
+    })
+        .min(1, "User story ID is required"),
 });
 export const WopeeDispatchAgentInputSchema = z.object({
-    suiteUuid: z.string().min(1, "Suite UUID is required"),
-    analysisIdentifier: z.string().min(1, "Analysis identifier is required"),
-    testCases: z.array(SelectedTestCasesSchema),
+    suiteUuid: z
+        .string({ description: "UUID of the suite to dispatch the agent for" })
+        .min(1, "Suite UUID is required"),
+    analysisIdentifier: z
+        .string({
+        description: "Analysis identifier of the suite to dispatch the agent for",
+    })
+        .min(1, "Analysis identifier is required"),
+    testCases: z.array(SelectedTestCasesSchema, {
+        description: "Chosen test cases to dispatch the agent for",
+    }),
 });
 export const DispatchAgentInputSchema = z.object({
     projectUuid: z.string().min(1, "Project UUID is required"),

package/build/tools/wopee_fetch_analysis_suites/index.js

@@ -1,7 +1,7 @@
+import { getConfig } from "../../utils/getConfig.js";
 import { requestClient } from "../../utils/requestClient.js";
 import { ToolName } from "../shared/types.js";
 import { FetchAnalysisSuites } from "../shared/gql-queries.js";
-import { getConfig } from "../../utils/getConfig.js";
 export const wopeeFetchAnalysisSuites = {
     name: ToolName.WOPEE_FETCH_ANALYSIS_SUITES,
     config: {

package/build/tools/wopee_fetch_file/index.js

@@ -0,0 +1,12 @@
+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_generate_file/index.js

@@ -0,0 +1,12 @@
+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,
+    config: {
+        title: "Generate file(artifact)",
+        description: "Generate AI data file for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(input),
+};

package/build/tools/wopee_update_file/index.js

@@ -0,0 +1,12 @@
+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),
+};

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {

package/build/tools/wopee_fetch_app_context/index.js

@@ -1,15 +0,0 @@
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-export const wopeeFetchAppContext = {
-    name: ToolName.WOPEE_FETCH_APP_CONTEXT,
-    config: {
-        title: "Fetch app context",
-        description: "Fetch suite's application context markdown file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.APP_CONTEXT,
-    }),
-};

package/build/tools/wopee_fetch_general_user_stories/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchGeneralUserStories = {
-    name: ToolName.WOPEE_FETCH_GENERAL_USER_STORIES,
-    config: {
-        title: "Fetch general user stories",
-        description: "Fetch suite's general user stories markdown file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.GENERAL_USER_STORIES,
-    }),
-};

package/build/tools/wopee_fetch_test_cases/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchTestCases = {
-    name: ToolName.WOPEE_FETCH_TEST_CASES,
-    config: {
-        title: "Fetch test cases",
-        description: "Fetch suite's test cases JSON file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.USER_STORIES,
-    }),
-};

package/build/tools/wopee_fetch_user_stories/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchUserStories = {
-    name: ToolName.WOPEE_FETCH_USER_STORIES,
-    config: {
-        title: "Fetch user stories",
-        description: "Fetch suite's user stories JSON file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.USER_STORIES,
-    }),
-};

package/build/tools/wopee_generate_app_context/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-import { GenerationType, ToolName } from "../shared/types.js";
-export const wopeeGenerateAppContext = {
-    name: ToolName.WOPEE_GENERATE_APP_CONTEXT,
-    config: {
-        title: "Generate app context",
-        description: "Generate application's context markdown file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(GenerationType.APP_CONTEXT, input),
-};

package/build/tools/wopee_generate_general_user_stories/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-import { GenerationType, ToolName } from "../shared/types.js";
-export const wopeeGenerateGeneralUserStories = {
-    name: ToolName.WOPEE_GENERATE_GENERAL_USER_STORIES,
-    config: {
-        title: "Generate general user stories",
-        description: "Generate general user stories markdown file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(GenerationType.GENERAL_USER_STORIES, input),
-};

package/build/tools/wopee_generate_test_cases/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-import { GenerationType, ToolName } from "../shared/types.js";
-export const wopeeGenerateTestCases = {
-    name: ToolName.WOPEE_GENERATE_TEST_CASES,
-    config: {
-        title: "Generate test cases",
-        description: "Generate test cases for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(GenerationType.TEST_CASES, input),
-};

package/build/tools/wopee_generate_user_stories/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-import { GenerationType, ToolName } from "../shared/types.js";
-export const wopeeGenerateUserStories = {
-    name: ToolName.WOPEE_GENERATE_USER_STORIES,
-    config: {
-        title: "Generate user stories",
-        description: "Generate user stories JSON file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(GenerationType.USER_STORIES, input),
-};