wopee-mcp 1.13.0 → 1.15.0

package/README.md

@@ -175,6 +175,11 @@ Fetch all existing analysis suites for my project
 
 Creates and dispatches a new analysis/crawling suite for your project. Use this to start a fresh analysis session.
 
+- **Parameters:**
+  - `additionalInstructions` _(optional)_ - Additional instructions to guide the agent during the analysis/crawling phase (e.g. focus areas, things to ignore, login steps, etc.)
+  - `additionalVariables` _(optional)_ - Additional environment variables to pass to the analysis. Array of objects, each with:
+    - `key` - Variable name, must be uppercase with underscores only (e.g. `MY_VAR`, `BASE_URL`)
+    - `value` - Variable value (non-empty string)
 - **Returns:** Success message with the created suite information
 
 **Example Usage:**
@@ -183,6 +188,14 @@ Creates and dispatches a new analysis/crawling suite for your project. Use this
 Dispatch a new analysis suite
 ```
 
+```
+Dispatch a new analysis suite and focus on the checkout flow
+```
+
+```
+Dispatch a new analysis suite with additional variables CARD_FILAMENT=123321123 and AUTH_TOKEN=abc123
+```
+
 #### `wopee_create_blank_suite`
 
 Creates a blank analysis suite for your project. Use this when you want to manually configure and populate a suite rather than having it automatically analyzed.
@@ -278,12 +291,10 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 ## Typical Workflow
 
 1. **Start with a suite:**
-
    - Use `wopee_fetch_analysis_suites` to see existing suites, OR
    - Use `wopee_dispatch_analysis` to create a new suite
 
 2. **Generate artifacts:**
-
    - 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`
@@ -292,7 +303,6 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
    - Generate test case steps: `wopee_generate_artifact` with `TEST_CASE_STEPS` and specific `suiteUuid`
 
 3. **Fetch generated content:**
-
    - Use the fetch tools to retrieve generated markdown/JSON files
 
 4. **Run tests:**

package/build/tools/wopee_dispatch_analysis/factory.js

@@ -1,5 +1,5 @@
 import { getConfig } from "../../utils/getConfig.js";
-export const createDispatchAnalysisInput = () => {
+export const createDispatchAnalysisInput = (input) => {
     const { WOPEE_PROJECT_UUID } = getConfig();
     if (!WOPEE_PROJECT_UUID)
         throw new Error("WOPEE_PROJECT_UUID is not set");
@@ -10,8 +10,10 @@ export const createDispatchAnalysisInput = () => {
             username: null,
             password: null,
             cookiesPreference: null,
-            additionalInstructions: null,
-            additionalVariables: null,
+            additionalInstructions: input.additionalInstructions ?? null,
+            additionalVariables: input.additionalVariables?.length
+                ? JSON.stringify(input.additionalVariables)
+                : null,
         },
         rerun: null,
     };

package/build/tools/wopee_dispatch_analysis/index.js

@@ -1,5 +1,5 @@
 import { _parseError } from "../shared/helpers.js";
-import { DispatchAnalysisInputSchema } from "./schema.js";
+import { DispatchAnalysisInputSchema, WopeeDispatchAnalysisInputSchema, } from "./schema.js";
 import { createDispatchAnalysisInput } from "./factory.js";
 import { DispatchAnalysis } from "../shared/gql-queries.js";
 import { requestClient } from "../../utils/requestClient.js";
@@ -9,11 +9,12 @@ export const wopeeDispatchAnalysis = {
     config: {
         title: "Dispatch analysis",
         description: "Create and dispatch analysis/crawling suite for a project",
+        inputSchema: WopeeDispatchAnalysisInputSchema.shape,
     },
-    handler: async () => {
+    handler: async (input) => {
         try {
-            const input = createDispatchAnalysisInput();
-            const parsedInput = DispatchAnalysisInputSchema.parse(input);
+            const rawInput = createDispatchAnalysisInput(input);
+            const parsedInput = DispatchAnalysisInputSchema.parse(rawInput);
             const result = await requestClient(DispatchAnalysis, {
                 input: parsedInput,
             });

package/build/tools/wopee_dispatch_analysis/schema.js

@@ -15,3 +15,23 @@ export const DispatchAnalysisInputSchema = z.object({
     suiteAnalysisConfig: SuiteAnalysisConfigSchema,
     rerun: RerunOptionsSchema.nullable().default(null),
 });
+const AdditionalVariableSchema = z.object({
+    key: z
+        .string({
+        description: "Variable name. Must be uppercase with underscores only (e.g. MY_VAR, BASE_URL).",
+    })
+        .regex(/^[A-Z_][A-Z0-9_]*$/, "Key must be uppercase alphanumeric with underscores, starting with a letter or underscore"),
+    value: z
+        .string({ description: "Variable value. Must be a non-empty string." })
+        .min(1, "Value must be a non-empty string"),
+});
+export const WopeeDispatchAnalysisInputSchema = z.object({
+    additionalInstructions: z
+        .string({ description: "Additional instructions for the agent" })
+        .nullish(),
+    additionalVariables: z
+        .array(AdditionalVariableSchema, {
+        description: "Additional environment variables for the analysis. Each variable needs a key (uppercase, e.g. BASE_URL) and a non-empty value.",
+    })
+        .nullish(),
+});

package/package.json

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