wopee-mcp 1.27.0 → 1.28.0

package/build/tools/index.js

@@ -10,11 +10,15 @@ import { wopeeFetchRecentExecutions } from "./wopee_fetch_recent_executions/inde
 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";
+import { wopeeFetchVariables } from "./wopee_fetch_variables/index.js";
+import { wopeeUpdateVariables } from "./wopee_update_variables/index.js";
 export const TOOLS = [
     wopeeCreateBlankSuite,
     wopeeFetchAnalysisSuites,
     wopeeFetchExecutedTestCases,
     wopeeFetchRecentExecutions,
+    wopeeFetchVariables,
+    wopeeUpdateVariables,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
     wopeeFetchArtifact,

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

@@ -13,6 +13,26 @@ export const UpdateArtifact = `
     updateArtifact(input: $input)
   }
 `;
+export const FetchProjectVariables = `
+  query FetchProjectVariables($projectUuid: ID!) {
+    fetchProjectVariables(projectUuid: $projectUuid)
+  }
+`;
+export const FetchSuiteVariables = `
+  query FetchSuiteVariables($suiteUuid: ID!) {
+    fetchSuiteVariables(suiteUuid: $suiteUuid)
+  }
+`;
+export const UpdateProjectVariables = `
+  mutation UpdateProjectVariables($input: UpdateProjectVariablesInput!) {
+    updateProjectVariables(input: $input)
+  }
+`;
+export const UpdateSuiteVariables = `
+  mutation UpdateSuiteVariables($suiteUuid: ID!, $additionalVariables: String!) {
+    updateSuiteVariables(suiteUuid: $suiteUuid, additionalVariables: $additionalVariables)
+  }
+`;
 export const DispatchAgent = `
   mutation DispatchAgent(
     $input: TestCasesInput!

package/build/tools/shared/schemas.js

@@ -14,6 +14,18 @@ export const SuiteAnalysisConfigSchema = z.object({
     additionalInstructions: z.string().nullable().default(null),
     additionalVariables: z.string().nullable().default(null),
 });
+// Shared by wopee_dispatch_analysis and wopee_update_variables. Keys must be
+// uppercase (server enforces the same EnvVarKeyRegex on write).
+export 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 GenerateAIDataHandlerInputSchema = z.object({
     type: z.nativeEnum(GenerateArtifactType, {
         description: "Type of test artifact to generate. One of: APP_CONTEXT, GENERAL_USER_STORIES, USER_STORIES_WITH_TEST_CASES, TEST_CASES, TEST_CASE_STEPS, REUSABLE_TEST_CASES, REUSABLE_TEST_CASE_STEPS. Start with APP_CONTEXT, then generate stories and test cases from it.",

package/build/tools/shared/types.js

@@ -12,7 +12,14 @@ export var ToolName;
     ToolName["WOPEE_SEND_CHAT_MESSAGE"] = "wopee_send_chat_message";
     ToolName["WOPEE_READ_CHAT_HISTORY"] = "wopee_read_chat_history";
     ToolName["WOPEE_CREATE_GITHUB_ISSUE"] = "wopee_create_github_issue";
+    ToolName["WOPEE_FETCH_VARIABLES"] = "wopee_fetch_variables";
+    ToolName["WOPEE_UPDATE_VARIABLES"] = "wopee_update_variables";
 })(ToolName || (ToolName = {}));
+export var VariableLevel;
+(function (VariableLevel) {
+    VariableLevel["PROJECT"] = "PROJECT";
+    VariableLevel["ANALYSIS"] = "ANALYSIS";
+})(VariableLevel || (VariableLevel = {}));
 export var GenerateArtifactType;
 (function (GenerateArtifactType) {
     GenerateArtifactType["APP_CONTEXT"] = "APP_CONTEXT";

package/build/tools/wopee_dispatch_analysis/schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { SuiteAnalysisConfigSchema } from "../shared/schemas.js";
+import { SuiteAnalysisConfigSchema, AdditionalVariableSchema, } from "../shared/schemas.js";
 var RerunMode;
 (function (RerunMode) {
     RerunMode["FULL"] = "FULL";
@@ -15,16 +15,6 @@ 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"),
-});
 const WopeeRerunOptionsSchema = z.object({
     suiteUuid: z
         .string({

package/build/tools/wopee_fetch_variables/index.js

@@ -0,0 +1,36 @@
+import { getConfig } from "../../utils/getConfig.js";
+import { requestClient } from "../../utils/requestClient.js";
+import { _parseError } from "../shared/helpers.js";
+import { ToolName, VariableLevel } from "../shared/types.js";
+import { FetchProjectVariables, FetchSuiteVariables, } from "../shared/gql-queries.js";
+import { WopeeFetchVariablesInputSchema, } from "./schema.js";
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+});
+export const wopeeFetchVariables = {
+    name: ToolName.WOPEE_FETCH_VARIABLES,
+    config: {
+        title: "Fetch run-time variables",
+        description: "Read the run-time variables (additionalVariables) that drive analysis/agent runs, at either level. level: PROJECT returns the project-level variables (uses WOPEE_PROJECT_UUID from the environment); level: ANALYSIS returns a specific analysis suite's variables and requires suiteUuid. Read-only. Returns a JSON string array of { key, value, sourceType } entries, or [] when none are set. Use wopee_fetch_analysis_suites to discover suite UUIDs.",
+        inputSchema: WopeeFetchVariablesInputSchema.shape,
+    },
+    handler: async (input) => {
+        try {
+            const { level, suiteUuid } = input;
+            if (level === VariableLevel.ANALYSIS) {
+                if (!suiteUuid)
+                    return textResult("suiteUuid is required when level is ANALYSIS");
+                const result = await requestClient(FetchSuiteVariables, { suiteUuid });
+                return textResult(result?.fetchSuiteVariables ?? "[]");
+            }
+            const { WOPEE_PROJECT_UUID } = getConfig();
+            if (!WOPEE_PROJECT_UUID)
+                return textResult("WOPEE_PROJECT_UUID is not set");
+            const result = await requestClient(FetchProjectVariables, { projectUuid: WOPEE_PROJECT_UUID });
+            return textResult(result?.fetchProjectVariables ?? "[]");
+        }
+        catch (error) {
+            return _parseError(error);
+        }
+    },
+};

package/build/tools/wopee_fetch_variables/schema.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import { VariableLevel } from "../shared/types.js";
+export const WopeeFetchVariablesInputSchema = z.object({
+    level: z.nativeEnum(VariableLevel, {
+        description: "Which variable set to read. PROJECT reads the project-level variables (uses WOPEE_PROJECT_UUID from the environment). ANALYSIS reads a specific analysis suite's variables and requires suiteUuid.",
+    }),
+    suiteUuid: z
+        .string({
+        description: "UUID of the analysis suite to read variables from. Required when level is ANALYSIS; ignored when level is PROJECT.",
+    })
+        .nullish(),
+});

package/build/tools/wopee_update_variables/factory.js

@@ -0,0 +1,24 @@
+import { getConfig } from "../../utils/getConfig.js";
+/**
+ * Wire payload for the updateSuiteVariables mutation. The handler guarantees
+ * suiteUuid is present before calling this (ANALYSIS level).
+ */
+export const createUpdateSuiteVariablesInput = (input) => ({
+    suiteUuid: input.suiteUuid,
+    additionalVariables: JSON.stringify(input.variables),
+});
+/**
+ * Wire payload for the updateProjectVariables mutation, injecting
+ * WOPEE_PROJECT_UUID from the environment (PROJECT level).
+ */
+export const createUpdateProjectVariablesInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        input: {
+            projectUuid: WOPEE_PROJECT_UUID,
+            additionalVariables: JSON.stringify(input.variables),
+        },
+    };
+};

package/build/tools/wopee_update_variables/index.js

@@ -0,0 +1,38 @@
+import { requestClient } from "../../utils/requestClient.js";
+import { withRetry } from "../../utils/withRetry.js";
+import { _parseError } from "../shared/helpers.js";
+import { ToolName, VariableLevel } from "../shared/types.js";
+import { UpdateProjectVariables, UpdateSuiteVariables, } from "../shared/gql-queries.js";
+import { createUpdateProjectVariablesInput, createUpdateSuiteVariablesInput, } from "./factory.js";
+import { WopeeUpdateVariablesInputSchema, } from "./schema.js";
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+});
+export const wopeeUpdateVariables = {
+    name: ToolName.WOPEE_UPDATE_VARIABLES,
+    config: {
+        title: "Update run-time variables",
+        description: "Upsert the run-time variables (additionalVariables) that drive analysis/agent runs, at either level. level: PROJECT writes the project-level variables (uses WOPEE_PROJECT_UUID from the environment); level: ANALYSIS writes a specific analysis suite's variables and requires suiteUuid. Merge semantics: keys in variables[] are added or overwritten, existing keys not listed are preserved. Keys must be uppercase (e.g. BASE_URL); the server re-sanitizes and drops invalid keys. Returns a confirmation on success.",
+        inputSchema: WopeeUpdateVariablesInputSchema.shape,
+    },
+    handler: async (input) => {
+        try {
+            const { level, suiteUuid } = input;
+            if (level === VariableLevel.ANALYSIS) {
+                if (!suiteUuid)
+                    return textResult("suiteUuid is required when level is ANALYSIS");
+                const result = await withRetry(() => requestClient(UpdateSuiteVariables, createUpdateSuiteVariablesInput(input)));
+                if (!result?.updateSuiteVariables)
+                    return textResult("Failed to update suite variables");
+                return textResult("Suite variables updated successfully");
+            }
+            const result = await withRetry(() => requestClient(UpdateProjectVariables, createUpdateProjectVariablesInput(input)));
+            if (!result?.updateProjectVariables)
+                return textResult("Failed to update project variables");
+            return textResult("Project variables updated successfully");
+        }
+        catch (error) {
+            return _parseError(error);
+        }
+    },
+};

package/build/tools/wopee_update_variables/schema.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { VariableLevel } from "../shared/types.js";
+import { AdditionalVariableSchema } from "../shared/schemas.js";
+export const WopeeUpdateVariablesInputSchema = z.object({
+    level: z.nativeEnum(VariableLevel, {
+        description: "Which variable set to write. PROJECT writes the project-level variables (uses WOPEE_PROJECT_UUID from the environment). ANALYSIS writes a specific analysis suite's variables and requires suiteUuid.",
+    }),
+    suiteUuid: z
+        .string({
+        description: "UUID of the analysis suite to write variables to. Required when level is ANALYSIS; ignored when level is PROJECT.",
+    })
+        .nullish(),
+    variables: z.array(AdditionalVariableSchema, {
+        description: "Variables to upsert. Each needs an uppercase key (e.g. BASE_URL) and a non-empty value. Merge semantics: keys listed here are added or overwritten; existing keys not listed here are preserved.",
+    }),
+});

package/package.json

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