wopee-mcp 1.26.1 → 1.27.0

package/README.md

@@ -290,7 +290,7 @@ Update app context file for the most recent suite with this content: <YourMarkdo
 
 #### `wopee_dispatch_agent`
 
-Dispatches an autonomous testing agent to execute test cases for a selected suite.
+Dispatches an autonomous testing agent to execute test cases for a selected suite. Tests run **asynchronously** (typically 1-3 minutes). This tool confirms dispatch and returns tracking info — not final results.
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite containing the test cases
@@ -298,7 +298,7 @@ Dispatches an autonomous testing agent to execute test cases for a selected suit
   - `testCases` - Array of test case objects to execute, each containing:
     - `testCaseId` - The ID of the test case
     - `userStoryId` - The ID of the associated user story
-- **Returns:** Array of executed test case objects with their initial execution state (uuid, executionStatus, agentReportStatus, codeReportStatus, etc.)
+- **Returns:** Dispatch confirmation with tracking info (suite UUID, analysis identifier, per-test-case execution status). Does NOT return pass/fail results — use `wopee_fetch_recent_executions` or `wopee_fetch_executed_test_cases` to check results later.
 
 **Example Usage:**
 
@@ -308,6 +308,23 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 
 ### Test Results
 
+#### `wopee_fetch_recent_executions`
+
+Fetches the most recent test case executions for the current project (up to 20, newest first). Use this to quickly check the status of recently dispatched tests without needing to remember specific suite UUIDs.
+
+- **Parameters:** None (uses `WOPEE_PROJECT_UUID` from environment)
+- **Returns:** List of recent executions with execution status (IN_PROGRESS, IN_QUEUE, FINISHED, FAILED), agent reports, and pass/fail results
+
+**Example Usage:**
+
+```
+What's the status of my recent test runs?
+```
+
+```
+How did my tests go?
+```
+
 #### `wopee_fetch_executed_test_cases`
 
 Fetches executed test cases and their results for a given analysis suite. Use this to check the status and reports of dispatched agent runs.
@@ -348,7 +365,8 @@ Show me the executed test cases for my latest analysis suite
    - Use `wopee_dispatch_agent` to execute test cases with the autonomous testing agent
 
 5. **Check results:**
-   - Use `wopee_fetch_executed_test_cases` to check the status and reports of dispatched agent runs
+   - Use `wopee_fetch_recent_executions` to quickly check status of recent test runs
+   - Use `wopee_fetch_executed_test_cases` to check detailed status and reports for a specific suite
    - Or use the `fetch-test-results` prompt for a formatted summary of all test results
 
 ## Available Prompts

package/build/tools/index.js

@@ -6,6 +6,7 @@ import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
 import { wopeeCreateBlankSuite } from "./wopee_create_blank_suite/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
 import { wopeeFetchExecutedTestCases } from "./wopee_fetch_executed_test_cases/index.js";
+import { wopeeFetchRecentExecutions } from "./wopee_fetch_recent_executions/index.js";
 import { wopeeSendChatMessage } from "./wopee_send_chat_message/index.js";
 import { wopeeReadChatHistory } from "./wopee_read_chat_history/index.js";
 import { wopeeCreateGithubIssue } from "./wopee_create_github_issue/index.js";
@@ -13,6 +14,7 @@ export const TOOLS = [
     wopeeCreateBlankSuite,
     wopeeFetchAnalysisSuites,
     wopeeFetchExecutedTestCases,
+    wopeeFetchRecentExecutions,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
     wopeeFetchArtifact,

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

@@ -132,7 +132,7 @@ export const GenerateGeneralUserStories = `
 `;
 export const GenerateUserStoriesWithTestCases = `
   mutation GenerateUserStoriesWithTestCases($input: GenerateAIDataInput!) {
-    generateUserStories(input: $input)
+    generateUserStoriesWithTestCases(input: $input)
   }
 `;
 export const GenerateTestCases = `
@@ -249,6 +249,25 @@ export const FetchChatRoom = `
     }
   }
 `;
+export const FetchRecentExecutedTestCases = `
+  query FetchRecentExecutedTestCases($projectUuid: ID!) {
+    fetchRecentExecutedTestCases(projectUuid: $projectUuid) {
+      uuid
+      suiteUuid
+      analysisSuiteUuid
+      analysisIdentifier
+      userStoryId
+      testCaseId
+      executionStatus
+      agentReport
+      agentReportStatus
+      codeReport
+      codeReportStatus
+      createdAt
+      updatedAt
+    }
+  }
+`;
 export const CreateGitHubIssue = `
   mutation CreateGitHubIssue($projectUuid: ID!, $title: String!, $body: String!, $labels: [String!]) {
     createGitHubIssue(projectUuid: $projectUuid, title: $title, body: $body, labels: $labels) {

package/build/tools/shared/types.js

@@ -3,6 +3,7 @@ export var ToolName;
     ToolName["WOPEE_CREATE_BLANK_SUITE"] = "wopee_create_blank_suite";
     ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
     ToolName["WOPEE_FETCH_EXECUTED_TEST_CASES"] = "wopee_fetch_executed_test_cases";
+    ToolName["WOPEE_FETCH_RECENT_EXECUTIONS"] = "wopee_fetch_recent_executions";
     ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
     ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";
     ToolName["WOPEE_FETCH_ARTIFACT"] = "wopee_fetch_artifact";

package/build/tools/wopee_dispatch_agent/index.js

@@ -5,11 +5,28 @@ import { createDispatchAgentInput } from "./factory.js";
 import { DispatchAgent } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
 import { withRetry } from "../../utils/withRetry.js";
+function formatDispatchSuccess(testCases, input) {
+    const lines = [
+        "DISPATCH SUCCESSFUL — tests are now RUNNING (not yet completed).",
+        "",
+        "Tracking:",
+        `- Suite UUID: ${testCases[0]?.suiteUuid ?? input.suiteUuid}`,
+        `- Analysis Suite UUID: ${testCases[0]?.analysisSuiteUuid ?? "N/A"}`,
+        `- Analysis Identifier: ${testCases[0]?.analysisIdentifier ?? input.analysisIdentifier}`,
+        "",
+        "Test cases dispatched:",
+    ];
+    for (const tc of testCases) {
+        lines.push(`- ${tc.userStoryId}:${tc.testCaseId} → executionStatus: ${tc.executionStatus}`);
+    }
+    lines.push("", "IMPORTANT: These tests are RUNNING asynchronously. Do NOT report them as passed or failed.", "Tell the user their tests are running and results will be available shortly (typically 1-3 minutes).", "You will receive a follow-up notification in chat when tests complete with full results.");
+    return lines.join("\n");
+}
 export const wopeeDispatchAgent = {
     name: ToolName.WOPEE_DISPATCH_AGENT,
     config: {
         title: "Dispatch autonomous testing agent",
-        description: "Execute a specific test case by dispatching an autonomous AI agent. The agent opens a real browser, navigates the web app, follows the test case steps, captures screenshots at each step, and reports pass/fail with detailed findings. Prerequisite: test cases must exist in the suite — generate them first with wopee_generate_artifact (type USER_STORIES_WITH_TEST_CASES). Do NOT use this to analyze or crawl an app — use wopee_dispatch_analysis for that. Side effects: creates execution records and screenshots on the Wopee.io platform. Rate limit: 10 seconds between dispatches per project; concurrent calls auto-retry with exponential backoff. On success, returns executed test case results. On failure (invalid suite/test case ID), returns an error message. Use wopee_fetch_executed_test_cases afterward to get full results.",
+        description: "Dispatch an autonomous AI agent to execute specific test cases. The agent opens a real browser, navigates the app, follows test steps, and reports results. Tests run ASYNCHRONOUSLY (1-3 minutes). This tool returns tracking info confirming dispatch — NOT final results. Do NOT interpret the response as pass/fail. Results arrive later via chat notifications. Prerequisite: test cases must exist in the suite (generate with wopee_generate_artifact type USER_STORIES_WITH_TEST_CASES). Use wopee_fetch_recent_executions or wopee_fetch_executed_test_cases to check status later.",
         inputSchema: WopeeDispatchAgentInputSchema.shape,
     },
     handler: async (input) => {
@@ -24,7 +41,7 @@ export const wopeeDispatchAgent = {
                     content: [
                         {
                             type: "text",
-                            text: "Failed to dispatch agent: no dispatch result returned",
+                            text: "DISPATCH FAILED — tests were NOT started.\nReason: No dispatch result returned from the API.\nSuggest the user try again or check that the suite and test cases exist.",
                         },
                     ],
                 };
@@ -32,12 +49,22 @@ export const wopeeDispatchAgent = {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify(result.dispatchAgent, null, 2),
+                        text: formatDispatchSuccess(result.dispatchAgent, input),
                     },
                 ],
             };
         }
         catch (error) {
+            if (error instanceof Error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `DISPATCH FAILED — tests were NOT started.\nReason: ${error.message}\nThis is a dispatch/infrastructure error, not a test failure. Suggest the user try again.`,
+                        },
+                    ],
+                };
+            }
             return _parseError(error);
         }
     },

package/build/tools/wopee_fetch_recent_executions/index.js

@@ -0,0 +1,78 @@
+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 { FetchRecentExecutedTestCases } from "../shared/gql-queries.js";
+export const wopeeFetchRecentExecutions = {
+    name: ToolName.WOPEE_FETCH_RECENT_EXECUTIONS,
+    config: {
+        title: "Fetch recent test executions",
+        description: "Fetch the most recent test case executions for the current project (up to 20, newest first). Use this to check the status of recently dispatched tests without needing to remember specific suite UUIDs. Returns execution status (IN_PROGRESS, IN_QUEUE, FINISHED, FAILED), agent reports, and pass/fail results. Takes no input; uses WOPEE_PROJECT_UUID from environment. Prefer this tool when the user asks 'what's the status?' or 'how did the tests go?' and you don't have the specific suite UUID handy.",
+    },
+    handler: async () => {
+        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(FetchRecentExecutedTestCases, {
+                projectUuid: WOPEE_PROJECT_UUID,
+            });
+            if (!result?.fetchRecentExecutedTestCases)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No recent test executions found for this project.",
+                        },
+                    ],
+                };
+            const executions = result.fetchRecentExecutedTestCases;
+            if (executions.length === 0)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No recent test executions found for this project.",
+                        },
+                    ],
+                };
+            const lines = [
+                `Recent test executions (${executions.length} most recent):`,
+                "",
+            ];
+            for (const tc of executions) {
+                let status;
+                if (tc.executionStatus === "FINISHED") {
+                    status = tc.agentReportStatus ?? "FINISHED";
+                }
+                else {
+                    status = tc.executionStatus;
+                }
+                lines.push(`- ${tc.userStoryId}:${tc.testCaseId} [${tc.analysisIdentifier}] → ${status} (${tc.updatedAt})`);
+                if (tc.executionStatus === "FINISHED" && tc.agentReport) {
+                    const shortReport = tc.agentReport.slice(0, 200);
+                    lines.push(`  Report: ${shortReport}${tc.agentReport.length > 200 ? "..." : ""}`);
+                }
+            }
+            lines.push("", `Suite UUID of most recent: ${executions[0].suiteUuid}`, `Analysis Identifier of most recent: ${executions[0].analysisIdentifier}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
+    },
+};

package/package.json

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