wopee-mcp 1.20.0 → 1.21.0

package/build/tools/shared/handlers.js

@@ -15,12 +15,12 @@ export async function fetchArtifact(input) {
         const result = await requestClient(FetchArtifact, {
             input: parsedInput,
         });
-        if (!result || !result?.fetchArtifact || !result?.fetchArtifact?.content)
+        if (!result?.fetchArtifact?.content)
             return {
                 content: [
                     {
                         type: "text",
-                        text: "Failed to fetch file",
+                        text: "Failed to fetch file: no content returned",
                     },
                 ],
             };
@@ -54,12 +54,12 @@ export async function generateAIDataFile(input) {
         const generationResult = await requestClient(query, {
             input: parsedInput,
         });
-        if (!generationResult || !generationResult[dataKey])
+        if (!generationResult?.[dataKey])
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Failed to generate ${description}`,
+                        text: `Failed to generate ${description}: no result returned`,
                     },
                 ],
             };
@@ -86,12 +86,12 @@ export async function updateArtifact(input) {
         const updateFileResult = await requestClient(UpdateArtifact, {
             input: parsedInput,
         });
-        if (!updateFileResult || !updateFileResult.updateArtifact)
+        if (!updateFileResult?.updateArtifact)
             return {
                 content: [
                     {
                         type: "text",
-                        text: "Failed to update file",
+                        text: "Failed to update file: operation returned false",
                     },
                 ],
             };

package/build/tools/shared/helpers.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { GenerateAppContext, GenerateGeneralUserStories, GenerateReusableTestCases, GenerateReusableTestCaseSteps, GenerateTestCases, GenerateTestCaseSteps, GenerateUserStoriesWithTestCases, } from "./gql-queries.js";
 import { ArtifactType, GenerateArtifactType } from "./types.js";
+import { RequestError } from "../../utils/requestClient.js";
 export function _convertToArtifactType(type) {
     switch (type) {
         case GenerateArtifactType.APP_CONTEXT:
@@ -69,6 +70,16 @@ export function _parseGenerateArtifactType(type) {
 }
 export function _parseError(error) {
     console.error(error instanceof z.ZodError ? error.issues : error);
+    if (error instanceof RequestError) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `[${error.code}] ${error.message}${error.retryable ? " (retryable)" : ""}`,
+                },
+            ],
+        };
+    }
     return {
         content: [
             {

package/build/tools/wopee_create_blank_suite/index.js

@@ -1,5 +1,6 @@
 import { getConfig } from "../../utils/getConfig.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { _parseError } from "../shared/helpers.js";
 import { ToolName } from "../shared/types.js";
 import { CreateBlankAnalysisSuite } from "../shared/gql-queries.js";
 export const wopeeCreateBlankSuite = {
@@ -9,35 +10,40 @@ export const wopeeCreateBlankSuite = {
         description: "Create a blank analysis suite for a project",
     },
     handler: async () => {
-        const { WOPEE_PROJECT_UUID } = getConfig();
-        if (!WOPEE_PROJECT_UUID)
+        try {
+            const { WOPEE_PROJECT_UUID } = getConfig();
+            if (!WOPEE_PROJECT_UUID)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "WOPEE_PROJECT_UUID is not set",
+                        },
+                    ],
+                };
+            const result = await requestClient(CreateBlankAnalysisSuite, {
+                projectUuid: WOPEE_PROJECT_UUID,
+            });
+            if (!result?.createBlankAnalysisSuite)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to create blank suite: no data returned",
+                        },
+                    ],
+                };
             return {
                 content: [
                     {
                         type: "text",
-                        text: "WOPEE_PROJECT_UUID is not set",
+                        text: JSON.stringify(result.createBlankAnalysisSuite, null, 2),
                     },
                 ],
             };
-        const result = await requestClient(CreateBlankAnalysisSuite, {
-            projectUuid: WOPEE_PROJECT_UUID,
-        });
-        if (!result || !result.createBlankAnalysisSuite)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to fetch analysis suites",
-                    },
-                ],
-            };
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.createBlankAnalysisSuite, null, 2),
-                },
-            ],
-        };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
     },
 };

package/build/tools/wopee_dispatch_agent/index.js

@@ -4,26 +4,27 @@ import { _parseError } from "../shared/helpers.js";
 import { createDispatchAgentInput } from "./factory.js";
 import { DispatchAgent } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { withRetry } from "../../utils/withRetry.js";
 export const wopeeDispatchAgent = {
     name: ToolName.WOPEE_DISPATCH_AGENT,
     config: {
         title: "Dispatch agent",
-        description: "Dispatch agent testing for selected suite's test cases",
+        description: "Dispatch agent testing for selected suite's test cases. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
         inputSchema: WopeeDispatchAgentInputSchema.shape,
     },
     handler: async (input) => {
         try {
             const dispatchAgentInput = createDispatchAgentInput(input);
             const parsedInput = DispatchAgentInputSchema.parse(dispatchAgentInput);
-            const result = await requestClient(DispatchAgent, {
+            const result = await withRetry(() => requestClient(DispatchAgent, {
                 input: parsedInput,
-            });
-            if (!result || result?.dispatchAgent?.length === 0)
+            }));
+            if (!result?.dispatchAgent?.length)
                 return {
                     content: [
                         {
                             type: "text",
-                            text: "Failed to dispatch agent",
+                            text: "Failed to dispatch agent: no dispatch result returned",
                         },
                     ],
                 };

package/build/tools/wopee_dispatch_analysis/index.js

@@ -3,27 +3,28 @@ import { DispatchAnalysisInputSchema, WopeeDispatchAnalysisInputSchema, } from "
 import { createDispatchAnalysisInput } from "./factory.js";
 import { DispatchAnalysis } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { withRetry } from "../../utils/withRetry.js";
 import { ToolName } from "../shared/types.js";
 export const wopeeDispatchAnalysis = {
     name: ToolName.WOPEE_DISPATCH_ANALYSIS,
     config: {
         title: "Dispatch analysis",
-        description: "Create and dispatch analysis/crawling suite for a project",
+        description: "Create and dispatch analysis/crawling suite for a project. Note: there is a 10-second per-project rate limit between dispatches; concurrent calls will auto-retry with backoff.",
         inputSchema: WopeeDispatchAnalysisInputSchema.shape,
     },
     handler: async (input) => {
         try {
             const rawInput = createDispatchAnalysisInput(input);
             const parsedInput = DispatchAnalysisInputSchema.parse(rawInput);
-            const result = await requestClient(DispatchAnalysis, {
+            const result = await withRetry(() => requestClient(DispatchAnalysis, {
                 input: parsedInput,
-            });
-            if (!result || !result.dispatchAnalysis)
+            }));
+            if (!result?.dispatchAnalysis)
                 return {
                     content: [
                         {
                             type: "text",
-                            text: "Failed to dispatch agent",
+                            text: "Failed to dispatch agent: no analysis suite returned",
                         },
                     ],
                 };

package/build/tools/wopee_fetch_analysis_suites/index.js

@@ -1,5 +1,6 @@
 import { getConfig } from "../../utils/getConfig.js";
 import { requestClient } from "../../utils/requestClient.js";
+import { _parseError } from "../shared/helpers.js";
 import { ToolName } from "../shared/types.js";
 import { FetchAnalysisSuites } from "../shared/gql-queries.js";
 export const wopeeFetchAnalysisSuites = {
@@ -9,35 +10,40 @@ export const wopeeFetchAnalysisSuites = {
         description: "Fetch project's analysis suites from Woopee",
     },
     handler: async () => {
-        const { WOPEE_PROJECT_UUID } = getConfig();
-        if (!WOPEE_PROJECT_UUID)
+        try {
+            const { WOPEE_PROJECT_UUID } = getConfig();
+            if (!WOPEE_PROJECT_UUID)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "WOPEE_PROJECT_UUID is not set",
+                        },
+                    ],
+                };
+            const result = await requestClient(FetchAnalysisSuites, {
+                projectUuid: WOPEE_PROJECT_UUID,
+            });
+            if (!result?.fetchAnalysisSuites)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to fetch analysis suites: no data returned",
+                        },
+                    ],
+                };
             return {
                 content: [
                     {
                         type: "text",
-                        text: "WOPEE_PROJECT_UUID is not set",
+                        text: JSON.stringify(result.fetchAnalysisSuites, null, 2),
                     },
                 ],
             };
-        const result = await requestClient(FetchAnalysisSuites, {
-            projectUuid: WOPEE_PROJECT_UUID,
-        });
-        if (!result || !result.fetchAnalysisSuites)
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Failed to fetch analysis suites",
-                    },
-                ],
-            };
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.fetchAnalysisSuites, null, 2),
-                },
-            ],
-        };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
     },
 };

package/build/utils/requestClient.js

@@ -1,37 +1,57 @@
 import { getConfig } from "./getConfig.js";
+export class RequestError extends Error {
+    code;
+    status;
+    retryable;
+    constructor(message, code, options) {
+        super(message);
+        this.name = "RequestError";
+        this.code = code;
+        this.status = options?.status ?? null;
+        this.retryable = options?.retryable ?? false;
+    }
+}
+function classifyGraphQLErrors(errors) {
+    const combined = errors.map((e) => e.message).join("; ");
+    const lower = combined.toLowerCase();
+    if (lower.includes("rate limit")) {
+        return new RequestError(combined, "RATE_LIMITED", { retryable: true });
+    }
+    if (lower.includes("usage limit") || lower.includes("usage_limit")) {
+        return new RequestError(combined, "USAGE_LIMIT_EXCEEDED");
+    }
+    return new RequestError(combined, "GRAPHQL_ERROR");
+}
 export const requestClient = async (query, variables) => {
     const { WOPEE_API_URL, WOPEE_API_KEY } = getConfig();
+    if (!WOPEE_API_KEY) {
+        throw new RequestError("WOPEE_API_KEY is not set", "AUTH_ERROR");
+    }
+    const headers = {
+        api_key: WOPEE_API_KEY,
+        "Content-Type": "application/json",
+    };
+    let response;
     try {
-        if (!WOPEE_API_KEY) {
-            console.error("[REQUEST_CLIENT_ERROR]: WOPEE_API_KEY is not set");
-            return null;
-        }
-        const headers = {
-            api_key: WOPEE_API_KEY,
-            "Content-Type": "application/json",
-        };
-        const response = await fetch(`${WOPEE_API_URL}`, {
+        response = await fetch(`${WOPEE_API_URL}`, {
             method: "POST",
             headers,
-            body: JSON.stringify({
-                query,
-                variables,
-            }),
+            body: JSON.stringify({ query, variables }),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            console.error("[REQUEST_CLIENT_ERROR]:", errorText);
-            return null;
-        }
-        const result = (await response.json());
-        if (result.errors && result.errors.length > 0) {
-            console.error("GraphQL errors:", result.errors);
-            return null;
-        }
-        return result.data || null;
     }
     catch (error) {
-        console.error("[REQUEST_CLIENT_ERROR]:", error);
-        return null;
+        throw new RequestError(`Network error: ${error instanceof Error ? error.message : String(error)}`, "NETWORK_ERROR", { retryable: true });
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => "");
+        const status = response.status;
+        const isRateLimit = status === 429 || errorText.toLowerCase().includes("rate limit");
+        const isRetryable = isRateLimit || status >= 500;
+        throw new RequestError(`HTTP ${status}: ${errorText || response.statusText}`, isRateLimit ? "RATE_LIMITED" : "HTTP_ERROR", { status, retryable: isRetryable });
+    }
+    const result = (await response.json());
+    if (result.errors && result.errors.length > 0) {
+        throw classifyGraphQLErrors(result.errors);
     }
+    return result.data;
 };

package/build/utils/withRetry.js

@@ -0,0 +1,24 @@
+import { RequestError } from "./requestClient.js";
+export async function withRetry(fn, options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 2000;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (error instanceof RequestError &&
+                error.retryable &&
+                attempt < maxRetries) {
+                lastError = error;
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                console.error(`[RETRY] Attempt ${attempt + 1}/${maxRetries} failed (${error.code}): ${error.message}. Retrying in ${delay}ms...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw lastError;
+}

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.20.0",
+  "version": "1.21.0",
   "mcpName": "io.github.Wopee-io/wopee-mcp",
   "description": "Wopee.io MCP server for autonomous testing platform",
   "main": "./build/index.js",