wopee-mcp 1.14.0 → 1.15.0

package/README.md

@@ -176,7 +176,10 @@ 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.)
+  - `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:**
@@ -189,6 +192,10 @@ 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.
@@ -284,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`
@@ -298,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

@@ -11,7 +11,9 @@ export const createDispatchAnalysisInput = (input) => {
             password: null,
             cookiesPreference: null,
             additionalInstructions: input.additionalInstructions ?? null,
-            additionalVariables: null,
+            additionalVariables: input.additionalVariables?.length
+                ? JSON.stringify(input.additionalVariables)
+                : null,
         },
         rerun: null,
     };

package/build/tools/wopee_dispatch_analysis/schema.js

@@ -15,8 +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.14.0",
+  "version": "1.15.0",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {