@muggleai/works 4.2.1 → 4.3.0

package/dist/{chunk-CXTJOYWM.js → chunk-23NOSJFH.js}

@@ -8,9 +8,10 @@ import { fileURLToPath } from 'url';
 import winston from 'winston';
 import axios, { AxiosError } from 'axios';
 import { spawn, exec, execFile } from 'child_process';
+import * as crypto from 'crypto';
+import { randomUUID } from 'crypto';
 import * as fs5 from 'fs/promises';
 import { z, ZodError } from 'zod';
-import * as crypto from 'crypto';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -39,6 +40,7 @@ var DEFAULT_PROMPT_SERVICE_PRODUCTION_URL = "https://promptservice.muggle-ai.com
 var DEFAULT_PROMPT_SERVICE_DEV_URL = "http://localhost:5050";
 var DEFAULT_WEB_SERVICE_URL = "http://localhost:3001";
 var ELECTRON_APP_DIR = "electron-app";
+var ELECTRON_APP_RELEASE_TAG_PREFIX = "electron-app-v";
 var API_KEY_FILE = "api-key.json";
 var DEFAULT_AUTH0_PRODUCTION_DOMAIN = "login.muggle-ai.com";
 var DEFAULT_AUTH0_PRODUCTION_CLIENT_ID = "UgG5UjoyLksxMciWWKqVpwfWrJ4rFvtT";
@@ -262,7 +264,7 @@ function buildAuth0Config() {
     scope: process.env.AUTH0_SCOPE ?? DEFAULT_AUTH0_SCOPE
   };
 }
-function buildQaConfig() {
+function buildE2eConfig() {
   const defaultPromptServiceUrl = getDefaultPromptServiceUrl();
   return {
     promptServiceBaseUrl: process.env.PROMPT_SERVICE_BASE_URL ?? defaultPromptServiceUrl,
@@ -306,7 +308,7 @@ function getConfig() {
     serverVersion: "1.0.0",
     logLevel: process.env.LOG_LEVEL ?? "info",
     auth0: buildAuth0Config(),
-    qa: buildQaConfig(),
+    e2e: buildE2eConfig(),
     localQa: buildLocalQaConfig()
   };
   return configInstance;
@@ -357,6 +359,15 @@ function getBundledElectronAppVersion() {
 function getDownloadBaseUrl() {
   return getMuggleConfig().downloadBaseUrl;
 }
+function buildElectronAppReleaseTag(version) {
+  return `${ELECTRON_APP_RELEASE_TAG_PREFIX}${version}`;
+}
+function buildElectronAppReleaseAssetUrl(params) {
+  return `${getDownloadBaseUrl()}/${buildElectronAppReleaseTag(params.version)}/${params.assetFileName}`;
+}
+function buildElectronAppChecksumsUrl(version) {
+  return `${getDownloadBaseUrl()}/${buildElectronAppReleaseTag(version)}/checksums.txt`;
+}
 function getElectronAppChecksums() {
   return getMuggleConfig().checksums;
 }
@@ -403,12 +414,14 @@ function resetLogger() {
   loggerInstance = null;
 }
 
-// packages/mcps/src/mcp/qa/index.ts
-var qa_exports2 = {};
-__export(qa_exports2, {
+// packages/mcps/src/mcp/e2e/index.ts
+var e2e_exports2 = {};
+__export(e2e_exports2, {
+  ActionScriptGetInputSchema: () => ActionScriptGetInputSchema,
   ApiKeyCreateInputSchema: () => ApiKeyCreateInputSchema,
   ApiKeyGetInputSchema: () => ApiKeyGetInputSchema,
   ApiKeyListInputSchema: () => ApiKeyListInputSchema,
+  ApiKeyRecordIdSchema: () => ApiKeyRecordIdSchema,
   ApiKeyRevokeInputSchema: () => ApiKeyRevokeInputSchema,
   AuthLoginInputSchema: () => AuthLoginInputSchema,
   AuthPollInputSchema: () => AuthPollInputSchema,
@@ -418,6 +431,7 @@ __export(qa_exports2, {
   LocalExecutionContextInputSchema: () => LocalExecutionContextInputSchema,
   LocalRunUploadInputSchema: () => LocalRunUploadInputSchema,
   McpErrorCode: () => McpErrorCode,
+  MuggleEntityIdSchema: () => MuggleEntityIdSchema,
   PaginationInputSchema: () => PaginationInputSchema,
   PrdFileDeleteInputSchema: () => PrdFileDeleteInputSchema,
   PrdFileListInputSchema: () => PrdFileListInputSchema,
@@ -439,11 +453,13 @@ __export(qa_exports2, {
   ReportFinalGenerateInputSchema: () => ReportFinalGenerateInputSchema,
   ReportPreferencesUpsertInputSchema: () => ReportPreferencesUpsertInputSchema,
   ReportStatsSummaryInputSchema: () => ReportStatsSummaryInputSchema,
+  RunBatchIdSchema: () => RunBatchIdSchema,
   SecretCreateInputSchema: () => SecretCreateInputSchema,
   SecretDeleteInputSchema: () => SecretDeleteInputSchema,
   SecretGetInputSchema: () => SecretGetInputSchema,
   SecretListInputSchema: () => SecretListInputSchema,
   SecretUpdateInputSchema: () => SecretUpdateInputSchema,
+  StripePaymentMethodIdSchema: () => StripePaymentMethodIdSchema,
   TestCaseCreateInputSchema: () => TestCaseCreateInputSchema,
   TestCaseGenerateFromPromptInputSchema: () => TestCaseGenerateFromPromptInputSchema,
   TestCaseGetInputSchema: () => TestCaseGetInputSchema,
@@ -452,6 +468,8 @@ __export(qa_exports2, {
   TestScriptGetInputSchema: () => TestScriptGetInputSchema,
   TestScriptListInputSchema: () => TestScriptListInputSchema,
   TestScriptListPaginatedInputSchema: () => TestScriptListPaginatedInputSchema,
+  TokenPackageIdSchema: () => TokenPackageIdSchema,
+  TokenUsageFilterTypeSchema: () => TokenUsageFilterTypeSchema,
   UseCaseCandidatesApproveInputSchema: () => UseCaseCandidatesApproveInputSchema,
   UseCaseCreateFromPromptsInputSchema: () => UseCaseCreateFromPromptsInputSchema,
   UseCaseDiscoveryMemoryGetInputSchema: () => UseCaseDiscoveryMemoryGetInputSchema,
@@ -1620,7 +1638,7 @@ var RunResultStorageService = class {
    */
   createRunResult(params) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const id = `run_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+    const id = randomUUID();
     const result = {
       id,
       runType: params.runType,
@@ -1703,7 +1721,7 @@ var RunResultStorageService = class {
    */
   createTestScript(params) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const id = `ts_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+    const id = randomUUID();
     const script = {
       id,
       name: params.name,
@@ -1750,7 +1768,7 @@ function getAuthenticatedUserId() {
   const authService = getAuthService();
   const authStatus = authService.getAuthStatus();
   if (!authStatus.authenticated) {
-    throw new Error("Not authenticated. Please run qa_auth_login first.");
+    throw new Error("Not authenticated. Please run muggle-remote-auth-login first.");
   }
   if (!authStatus.userId) {
     throw new Error("User ID not found in auth. Please re-authenticate.");
@@ -1800,7 +1818,7 @@ function buildStudioAuthContent() {
   const authStatus = authService.getAuthStatus();
   const storedAuth = authService.loadStoredAuth();
   if (!authStatus.authenticated || !storedAuth) {
-    throw new Error("Not authenticated. Please run qa_auth_login first.");
+    throw new Error("Not authenticated. Please run muggle-remote-auth-login first.");
   }
   if (!storedAuth.email || !storedAuth.userId) {
     throw new Error("Auth data incomplete. Please re-authenticate.");
@@ -1927,6 +1945,7 @@ function buildGenerationActionScript(params) {
     url: params.localUrl,
     description: params.testCase.title,
     precondition: params.testCase.precondition ?? "",
+    instructions: params.testCase.instructions ?? "",
     expectedResult: params.testCase.expectedResult,
     steps: [],
     ownerId: params.ownerUserId,
@@ -1948,12 +1967,12 @@ function buildReplayActionScript(params) {
     sourceLabel: "testScript"
   });
   const rewrittenActionScript = rewriteActionScriptUrls({
-    actionScript: params.testScript.actionScript,
+    actionScript: params.actionScript,
     originalUrl: params.testScript.url,
     localUrl: params.localUrl
   });
   return {
-    actionScriptId: params.testScript.id,
+    actionScriptId: params.testScript.actionScriptId,
     actionScriptName: params.testScript.name,
     actionType: "UserDefined",
     actionParams: {
@@ -2231,7 +2250,7 @@ ${executionResult.stderr}`;
   }
 }
 async function executeReplay(params) {
-  const { testScript, localUrl } = params;
+  const { testScript, actionScript, localUrl } = params;
   const timeoutMs = params.timeoutMs ?? 18e4;
   const userId = getAuthenticatedUserId();
   const authContent = buildStudioAuthContent();
@@ -2256,15 +2275,16 @@ async function executeReplay(params) {
   try {
     const runId = runResult.id;
     const startedAt = Date.now();
-    const actionScript = buildReplayActionScript({
+    const builtActionScript = buildReplayActionScript({
       testScript,
+      actionScript,
       localUrl,
       runId,
       ownerUserId: authContent.userId
     });
     const inputFilePath = await writeTempFile({
       filename: `${runId}_input.json`,
-      data: actionScript
+      data: builtActionScript
     });
     const authFilePath = await writeTempFile({
       filename: `${runId}_auth.json`,
@@ -2614,7 +2634,7 @@ async function pollDeviceCode(config, deviceCode) {
 }
 async function createApiKeyWithToken(accessToken, keyName, expiry = "90d") {
   const config = getConfig();
-  const apiKeyUrl = `${config.qa.promptServiceBaseUrl}/v1/protected/api-keys`;
+  const apiKeyUrl = `${config.e2e.promptServiceBaseUrl}/v1/protected/api-keys`;
   try {
     logger4.info("[Auth] Creating API key", {
       keyName,
@@ -2807,6 +2827,7 @@ function toolRequiresAuth(toolName) {
   ];
   return !noAuthTools.includes(toolName);
 }
+var MuggleEntityIdSchema = z.string().uuid();
 var LocalExecutionContextInputSchema = z.object({
   originalUrl: z.string().url().describe("Original local URL used during local execution (typically localhost)"),
   productionUrl: z.string().url().describe("Cloud production URL for the test case"),
@@ -2819,9 +2840,9 @@ var LocalExecutionContextInputSchema = z.object({
   uploadedAt: z.number().int().positive().optional().describe("Epoch milliseconds when uploaded to cloud")
 });
 var LocalRunUploadInputSchema = z.object({
-  projectId: z.string().min(1).describe("Project ID for the local run"),
-  useCaseId: z.string().min(1).describe("Use case ID for the local run"),
-  testCaseId: z.string().min(1).describe("Test case ID for the local run"),
+  projectId: MuggleEntityIdSchema.describe("Project ID (UUID) for the local run"),
+  useCaseId: MuggleEntityIdSchema.describe("Use case ID (UUID) for the local run"),
+  testCaseId: MuggleEntityIdSchema.describe("Test case ID (UUID) for the local run"),
   runType: z.enum(["generation", "replay"]).describe("Type of local run to upload"),
   productionUrl: z.string().url().describe("Cloud production URL associated with the run"),
   localExecutionContext: LocalExecutionContextInputSchema.describe("Local execution metadata"),
@@ -2831,12 +2852,16 @@ var LocalRunUploadInputSchema = z.object({
   errorMessage: z.string().optional().describe("Error message when status is failed")
 });
 
-// packages/mcps/src/mcp/qa/contracts/index.ts
+// packages/mcps/src/mcp/e2e/contracts/index.ts
 var PaginationInputSchema = z.object({
   page: z.number().int().positive().optional().describe("Page number (1-based)"),
   pageSize: z.number().int().positive().max(100).optional().describe("Number of items per page")
 });
-var IdSchema = z.string().min(1).describe("Unique identifier");
+var IdSchema = MuggleEntityIdSchema;
+var RunBatchIdSchema = MuggleEntityIdSchema.describe("Bulk replay run batch ID (UUID)");
+var TokenPackageIdSchema = z.string().min(1).describe("Token package ID from wallet catalog");
+var StripePaymentMethodIdSchema = z.string().regex(/^pm_[a-zA-Z0-9]+$/).describe("Stripe payment method ID (pm_\u2026)");
+var ApiKeyRecordIdSchema = z.string().length(24).regex(/^[0-9a-f]+$/i).describe("API key record ID (24-character hex)");
 var WorkflowMemoryParamsSchema = z.object({
   enableSharedTestMemory: z.boolean().optional().describe("Override to enable/disable SharedTestMemory for this workflow run"),
   enableEverMemOS: z.boolean().optional().describe("Override to enable/disable EverMemOS for this workflow run")
@@ -2844,39 +2869,46 @@ var WorkflowMemoryParamsSchema = z.object({
 var WorkflowParamsSchema = z.object({
   memory: WorkflowMemoryParamsSchema.optional().describe("Per-run memory override settings")
 }).passthrough().optional().describe("Optional workflow parameters for workflow-level overrides");
+var TokenUsageFilterTypeSchema = z.enum([
+  "project",
+  "useCase",
+  "testCase",
+  "testScript",
+  "actionScript"
+]).describe("Token cost aggregation dimension");
 var ProjectCreateInputSchema = z.object({
   projectName: z.string().min(1).max(255).describe("Name of the project"),
   description: z.string().min(1).describe("Project description"),
   url: z.string().url().describe("Target website URL to test")
 });
 var ProjectGetInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to retrieve")
+  projectId: IdSchema.describe("Project ID (UUID) to retrieve")
 });
 var ProjectDeleteInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to delete")
+  projectId: IdSchema.describe("Project ID (UUID) to delete")
 });
 var ProjectUpdateInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to update"),
+  projectId: IdSchema.describe("Project ID (UUID) to update"),
   projectName: z.string().min(1).max(255).optional().describe("New project name"),
   description: z.string().optional().describe("Updated description"),
   url: z.string().url().optional().describe("Updated target URL")
 });
 var ProjectListInputSchema = PaginationInputSchema.extend({});
 var PrdFileUploadInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to associate the PRD file with"),
+  projectId: IdSchema.describe("Project ID (UUID) to associate the PRD file with"),
   fileName: z.string().min(1).describe("Name of the file"),
   contentBase64: z.string().min(1).describe("Base64-encoded file content"),
   contentType: z.string().optional().describe("MIME type of the file")
 });
 var PrdFileListInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list PRD files for")
+  projectId: IdSchema.describe("Project ID (UUID) to list PRD files for")
 });
 var PrdFileDeleteInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  prdFileId: IdSchema.describe("PRD file ID to delete")
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  prdFileId: IdSchema.describe("PRD file ID (UUID) to delete")
 });
 var PrdFileProcessStartInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to process PRD files for"),
+  projectId: IdSchema.describe("Project ID (UUID) to process PRD files for"),
   name: z.string().min(1).describe("Workflow name"),
   description: z.string().min(1).describe("Description of the PRD processing workflow"),
   prdFilePath: z.string().min(1).describe("Storage path of the uploaded PRD file (from upload response)"),
@@ -2886,75 +2918,75 @@ var PrdFileProcessStartInputSchema = z.object({
   fileSize: z.number().int().min(0).describe("Size of the PRD file in bytes (from upload response)")
 });
 var PrdFileProcessLatestRunInputSchema = z.object({
-  workflowRuntimeId: IdSchema.describe("PRD processing workflow runtime ID")
+  workflowRuntimeId: IdSchema.describe("PRD processing workflow runtime ID (UUID)")
 });
 var SecretListInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list secrets for")
+  projectId: IdSchema.describe("Project ID (UUID) to list secrets for")
 });
 var SecretCreateInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to create the secret for"),
+  projectId: IdSchema.describe("Project ID (UUID) to create the secret for"),
   name: z.string().min(1).describe("Secret name/key"),
   value: z.string().min(1).describe("Secret value"),
   description: z.string().min(1).describe("Human-readable description for selection guidance"),
   source: z.enum(["user", "agent"]).optional().describe("Source of the secret: 'user' for user-provided credentials, 'agent' for agent-generated credentials")
 });
 var SecretGetInputSchema = z.object({
-  secretId: IdSchema.describe("Secret ID to retrieve")
+  secretId: IdSchema.describe("Secret ID (UUID) to retrieve")
 });
 var SecretUpdateInputSchema = z.object({
-  secretId: IdSchema.describe("Secret ID to update"),
+  secretId: IdSchema.describe("Secret ID (UUID) to update"),
   name: z.string().min(1).optional().describe("Updated secret name"),
   value: z.string().min(1).optional().describe("Updated secret value"),
   description: z.string().optional().describe("Updated description")
 });
 var SecretDeleteInputSchema = z.object({
-  secretId: IdSchema.describe("Secret ID to delete")
+  secretId: IdSchema.describe("Secret ID (UUID) to delete")
 });
 var UseCaseDiscoveryMemoryGetInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to get use case discovery memory for")
+  projectId: IdSchema.describe("Project ID (UUID) to get use case discovery memory for")
 });
 var UseCaseCandidatesApproveInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
   approvedCandidateIds: z.array(IdSchema).min(1).describe("IDs of candidates to approve/graduate")
 });
 var UseCaseListInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list use cases for")
+  projectId: IdSchema.describe("Project ID (UUID) to list use cases for")
 }).merge(PaginationInputSchema);
 var UseCaseGetInputSchema = z.object({
-  useCaseId: IdSchema.describe("Use case ID to retrieve")
+  useCaseId: IdSchema.describe("Use case ID (UUID) to retrieve")
 });
 var UseCasePromptPreviewInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to generate use case for"),
+  projectId: IdSchema.describe("Project ID (UUID) to generate use case for"),
   instruction: z.string().min(1).describe("Natural language instruction describing the use case (e.g., 'As a logged-in user, I can add items to cart')")
 });
 var UseCaseCreateFromPromptsInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to create use cases for"),
+  projectId: IdSchema.describe("Project ID (UUID) to create use cases for"),
   prompts: z.array(z.object({
     instruction: z.string().min(1).describe("Natural language instruction describing the use case")
   })).min(1).describe("Array of prompts to generate use cases from")
 });
 var UseCaseUpdateFromPromptInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID to update"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID) to update"),
   instruction: z.string().min(1).describe("Natural language instruction to regenerate the use case from")
 });
 var TestCaseListInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list test cases for")
+  projectId: IdSchema.describe("Project ID (UUID) to list test cases for")
 }).merge(PaginationInputSchema);
 var TestCaseGetInputSchema = z.object({
-  testCaseId: IdSchema.describe("Test case ID to retrieve")
+  testCaseId: IdSchema.describe("Test case ID (UUID) to retrieve")
 });
 var TestCaseListByUseCaseInputSchema = z.object({
-  useCaseId: IdSchema.describe("Use case ID to list test cases for")
+  useCaseId: IdSchema.describe("Use case ID (UUID) to list test cases for")
 });
 var TestCaseGenerateFromPromptInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID to generate test cases for"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID) to generate test cases for"),
   instruction: z.string().min(1).describe("Natural language instruction describing the test cases to generate")
 });
 var TestCaseCreateInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID to associate the test case with"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID) to associate the test case with"),
   title: z.string().min(1).describe("Test case title"),
   description: z.string().min(1).describe("Detailed description of what the test case validates"),
   goal: z.string().min(1).describe("Concise, measurable goal of the test"),
@@ -2968,39 +3000,43 @@ var TestCaseCreateInputSchema = z.object({
   automated: z.boolean().optional().describe("Whether this test case is automated (default: true)")
 });
 var TestScriptListInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list test scripts for")
+  projectId: IdSchema.describe("Project ID (UUID) to list test scripts for"),
+  testCaseId: IdSchema.optional().describe("Optional test case ID (UUID) to filter scripts by")
 }).merge(PaginationInputSchema);
 var TestScriptGetInputSchema = z.object({
-  testScriptId: IdSchema.describe("Test script ID to retrieve")
+  testScriptId: IdSchema.describe("Test script ID (UUID) to retrieve")
 });
 var TestScriptListPaginatedInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to list test scripts for")
+  projectId: IdSchema.describe("Project ID (UUID) to list test scripts for")
 }).merge(PaginationInputSchema);
+var ActionScriptGetInputSchema = z.object({
+  actionScriptId: IdSchema.describe("Action script ID (UUID) to retrieve")
+});
 var WorkflowStartWebsiteScanInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to scan"),
+  projectId: IdSchema.describe("Project ID (UUID) to scan"),
   url: z.string().url().describe("Website URL to scan"),
   description: z.string().min(1).describe("Description of what to scan/discover"),
   archiveUnapproved: z.boolean().optional().describe("Whether to archive unapproved candidates before scanning"),
   workflowParams: WorkflowParamsSchema
 });
 var WorkflowListRuntimesInputSchema = z.object({
-  projectId: IdSchema.optional().describe("Filter by project ID")
+  projectId: IdSchema.optional().describe("Filter by project ID (UUID)")
 });
 var WorkflowGetLatestRunInputSchema = z.object({
-  workflowRuntimeId: IdSchema.describe("Workflow runtime ID")
+  workflowRuntimeId: IdSchema.describe("Workflow runtime ID (UUID)")
 });
 var WorkflowStartTestCaseDetectionInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID to detect test cases for"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID) to detect test cases for"),
   name: z.string().min(1).describe("Workflow name"),
   description: z.string().min(1).describe("Workflow description"),
   url: z.string().url().describe("Target website URL"),
   workflowParams: WorkflowParamsSchema
 });
 var WorkflowStartTestScriptGenerationInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID"),
-  testCaseId: IdSchema.describe("Test case ID"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID)"),
+  testCaseId: IdSchema.describe("Test case ID (UUID)"),
   name: z.string().min(1).describe("Workflow name"),
   url: z.string().url().describe("Target website URL"),
   goal: z.string().min(1).describe("Test goal"),
@@ -3010,57 +3046,57 @@ var WorkflowStartTestScriptGenerationInputSchema = z.object({
   workflowParams: WorkflowParamsSchema
 });
 var WorkflowGetLatestScriptGenByTestCaseInputSchema = z.object({
-  testCaseId: IdSchema.describe("Test case ID")
+  testCaseId: IdSchema.describe("Test case ID (UUID)")
 });
 var WorkflowStartTestScriptReplayInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
-  useCaseId: IdSchema.describe("Use case ID"),
-  testCaseId: IdSchema.describe("Test case ID"),
-  testScriptId: IdSchema.describe("Test script ID to replay"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  useCaseId: IdSchema.describe("Use case ID (UUID)"),
+  testCaseId: IdSchema.describe("Test case ID (UUID)"),
+  testScriptId: IdSchema.describe("Test script ID (UUID) to replay"),
   name: z.string().min(1).describe("Workflow name"),
   workflowParams: WorkflowParamsSchema
 });
 var WorkflowStartTestScriptReplayBulkInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
   name: z.string().min(1).describe("Workflow name"),
   intervalSec: z.number().int().describe("Interval in seconds (-1 for one-time / on-demand)"),
-  useCaseId: IdSchema.optional().describe("Optional: only replay test cases under this use case"),
+  useCaseId: IdSchema.optional().describe("Optional: only replay test cases under this use case (UUID)"),
   namePrefix: z.string().optional().describe("Optional: prefix for generated workflow names"),
   limit: z.number().int().optional().describe("Optional: limit number of test cases to replay"),
-  testCaseIds: z.array(IdSchema).optional().describe("Optional: targeted test cases to replay"),
+  testCaseIds: z.array(IdSchema).optional().describe("Optional: targeted test case UUIDs to replay"),
   repeatPerTestCase: z.number().int().optional().describe("Optional: repeat count per test case"),
   workflowParams: WorkflowParamsSchema
 });
 var WorkflowGetReplayBulkBatchSummaryInputSchema = z.object({
-  runBatchId: IdSchema.describe("Run batch ID")
+  runBatchId: RunBatchIdSchema.describe("Run batch ID (UUID) from bulk replay workflow")
 });
 var WorkflowCancelRunInputSchema = z.object({
-  workflowRunId: IdSchema.describe("Workflow run ID to cancel")
+  workflowRunId: IdSchema.describe("Workflow run ID (UUID) to cancel")
 });
 var WorkflowCancelRuntimeInputSchema = z.object({
-  workflowRuntimeId: IdSchema.describe("Workflow runtime ID to cancel")
+  workflowRuntimeId: IdSchema.describe("Workflow runtime ID (UUID) to cancel")
 });
 var ProjectTestResultsSummaryInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to get test results summary for")
+  projectId: IdSchema.describe("Project ID (UUID) to get test results summary for")
 });
 var ProjectTestScriptsSummaryInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to get test scripts summary for")
+  projectId: IdSchema.describe("Project ID (UUID) to get test scripts summary for")
 });
 var ProjectTestRunsSummaryInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to get test runs summary for")
+  projectId: IdSchema.describe("Project ID (UUID) to get test runs summary for")
 });
 var ReportStatsSummaryInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to get report stats for")
+  projectId: IdSchema.describe("Project ID (UUID) to get report stats for")
 });
 var ReportCostQueryInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
   startDateKey: z.string().optional().describe("Start date key (YYYYMMDD)"),
   endDateKey: z.string().optional().describe("End date key (YYYYMMDD)"),
-  filterType: z.string().optional().describe("Filter type for cost breakdown"),
-  filterIds: z.array(z.unknown()).optional().describe("Filter IDs")
+  filterType: TokenUsageFilterTypeSchema.optional().describe("Aggregation dimension for cost breakdown"),
+  filterIds: z.array(IdSchema).optional().describe("Entity UUIDs matching filterType (project / use case / test case / test script / action script)")
 });
 var ReportPreferencesUpsertInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID"),
+  projectId: IdSchema.describe("Project ID (UUID)"),
   channels: z.array(z.unknown()).describe("Delivery channels to enable"),
   emails: z.array(z.unknown()).optional().describe("Email addresses for delivery"),
   phones: z.array(z.unknown()).optional().describe("Phone numbers for SMS delivery"),
@@ -3068,11 +3104,11 @@ var ReportPreferencesUpsertInputSchema = z.object({
   defaultExportFormat: z.string().optional().describe("Default export format (pdf, html, etc.)")
 });
 var ReportFinalGenerateInputSchema = z.object({
-  projectId: IdSchema.describe("Project ID to generate report for"),
+  projectId: IdSchema.describe("Project ID (UUID) to generate report for"),
   exportFormat: z.enum(["pdf", "html", "markdown"]).describe("Export format for the report")
 });
 var WalletTopUpInputSchema = z.object({
-  packageId: IdSchema.describe("Token package ID to purchase"),
+  packageId: TokenPackageIdSchema.describe("Token package ID to purchase"),
   checkoutSuccessCallback: z.string().url().describe("URL to redirect to when checkout succeeds"),
   checkoutCancelCallback: z.string().url().describe("URL to redirect to when checkout is canceled")
 });
@@ -3081,21 +3117,21 @@ var WalletPaymentMethodCreateSetupSessionInputSchema = z.object({
   checkoutCancelCallback: z.string().url().describe("URL to redirect to when payment method setup is canceled")
 });
 var WalletAutoTopUpSetPaymentMethodInputSchema = z.object({
-  paymentMethodId: IdSchema.describe("Saved Stripe payment method ID (e.g., pm_xxx)")
+  paymentMethodId: StripePaymentMethodIdSchema.describe("Saved Stripe payment method ID")
 });
 var WalletPaymentMethodListInputSchema = z.object({});
 var WalletAutoTopUpUpdateInputSchema = z.object({
   enabled: z.boolean().describe("Whether auto top-up is enabled"),
   topUpTriggerTokenThreshold: z.number().int().min(0).describe("Token balance threshold to trigger auto top-up"),
-  packageId: IdSchema.describe("Token package ID to purchase when auto top-up triggers")
+  packageId: TokenPackageIdSchema.describe("Token package ID to purchase when auto top-up triggers")
 });
 var RecommendScheduleInputSchema = z.object({
-  projectId: IdSchema.optional().describe("Project ID for context"),
+  projectId: IdSchema.optional().describe("Project ID (UUID) for context"),
   testFrequency: z.enum(["daily", "weekly", "onDemand"]).optional().describe("Desired test frequency"),
   timezone: z.string().optional().describe("Timezone for scheduling")
 });
 var RecommendCicdSetupInputSchema = z.object({
-  projectId: IdSchema.optional().describe("Project ID for context"),
+  projectId: IdSchema.optional().describe("Project ID (UUID) for context"),
   repositoryProvider: z.enum(["github", "azureDevOps", "gitlab", "other"]).optional().describe("Git repository provider"),
   cadence: z.enum(["onPullRequest", "nightly", "onDemand"]).optional().describe("CI/CD trigger cadence")
 });
@@ -3105,10 +3141,10 @@ var ApiKeyCreateInputSchema = z.object({
 });
 var ApiKeyListInputSchema = z.object({});
 var ApiKeyGetInputSchema = z.object({
-  apiKeyId: IdSchema.describe("ID of the API key to retrieve")
+  apiKeyId: ApiKeyRecordIdSchema.describe("ID of the API key record to retrieve")
 });
 var ApiKeyRevokeInputSchema = z.object({
-  apiKeyId: IdSchema.describe("ID of the API key to revoke")
+  apiKeyId: ApiKeyRecordIdSchema.describe("ID of the API key record to revoke")
 });
 var AuthLoginInputSchema = z.object({
   waitForCompletion: z.boolean().optional().describe("Whether to wait for browser login completion before returning. Default: true"),
@@ -3119,7 +3155,7 @@ var AuthPollInputSchema = z.object({
 });
 var EmptyInputSchema = z.object({});
 
-// packages/mcps/src/mcp/qa/types.ts
+// packages/mcps/src/mcp/e2e/types.ts
 var McpErrorCode = /* @__PURE__ */ ((McpErrorCode2) => {
   McpErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
   McpErrorCode2["FORBIDDEN"] = "FORBIDDEN";
@@ -3147,7 +3183,8 @@ var GatewayError = class extends Error {
 var ALLOWED_UPSTREAM_PREFIXES = [
   "/v1/protected/muggle-test/",
   "/v1/protected/wallet/",
-  "/v1/protected/api-keys"
+  "/v1/protected/api-keys",
+  "/v1/protected/actionScript/"
 ];
 var PromptServiceClient = class {
   httpClient;
@@ -3155,8 +3192,8 @@ var PromptServiceClient = class {
   requestTimeoutMs;
   constructor() {
     const config = getConfig();
-    this.baseUrl = config.qa.promptServiceBaseUrl;
-    this.requestTimeoutMs = config.qa.requestTimeoutMs;
+    this.baseUrl = config.e2e.promptServiceBaseUrl;
+    this.requestTimeoutMs = config.e2e.requestTimeoutMs;
     this.httpClient = axios.create({
       baseURL: this.baseUrl,
       timeout: this.requestTimeoutMs,
@@ -3387,13 +3424,13 @@ function getPromptServiceClient() {
   return clientInstance;
 }
 
-// packages/mcps/src/mcp/tools/qa/tool-registry.ts
+// packages/mcps/src/mcp/tools/e2e/tool-registry.ts
 var MUGGLE_TEST_PREFIX = "/v1/protected/muggle-test";
-var getWorkflowTimeoutMs = () => getConfig().qa.workflowTimeoutMs;
+var getWorkflowTimeoutMs = () => getConfig().e2e.workflowTimeoutMs;
 var projectTools = [
   {
     name: "muggle-remote-project-create",
-    description: "Create a QA testing project to organize browser tests for a web app. A project groups test scenarios (use cases), specific test steps (test cases), and replayable browser scripts (test scripts) for one application. Create a project first before generating or running any QA tests.",
+    description: "Create an E2E acceptance testing project to organize browser tests for a web app. A project groups test scenarios (use cases), specific test steps (test cases), and replayable browser scripts (test scripts) for one application. Create a project first before generating or running any E2E tests.",
     inputSchema: ProjectCreateInputSchema,
     mapToUpstream: (input) => {
       const data = input;
@@ -3594,7 +3631,7 @@ var testCaseTools = [
   },
   {
     name: "muggle-remote-test-case-generate-from-prompt",
-    description: "Generate QA test cases from a plain-English description of what to test \u2014 e.g., 'test the signup flow with invalid email' or 'verify the checkout handles empty cart'. Returns preview test cases that can be used to generate executable browser test scripts.",
+    description: "Generate E2E acceptance test cases from a plain-English description of what to test \u2014 e.g., 'test the signup flow with invalid email' or 'verify the checkout handles empty cart'. Returns preview test cases that can be used to generate executable browser test scripts.",
     inputSchema: TestCaseGenerateFromPromptInputSchema,
     mapToUpstream: (input) => {
       const data = input;
@@ -3636,14 +3673,14 @@ var testCaseTools = [
 var testScriptTools = [
   {
     name: "muggle-remote-test-script-list",
-    description: "List test scripts for a project.",
+    description: "List test scripts for a project, optionally filtered by test case.",
     inputSchema: TestScriptListInputSchema,
     mapToUpstream: (input) => {
       const data = input;
       return {
         method: "GET",
         path: `${MUGGLE_TEST_PREFIX}/test-scripts`,
-        queryParams: { projectId: data.projectId, page: data.page, pageSize: data.pageSize }
+        queryParams: { projectId: data.projectId, testCaseId: data.testCaseId, page: data.page, pageSize: data.pageSize }
       };
     }
   },
@@ -3673,10 +3710,24 @@ var testScriptTools = [
     }
   }
 ];
+var actionScriptTools = [
+  {
+    name: "muggle-remote-action-script-get",
+    description: "Get the full action script content by ID. Use actionScriptId from a test script to fetch the complete script with all steps and element labels needed for replay.",
+    inputSchema: ActionScriptGetInputSchema,
+    mapToUpstream: (input) => {
+      const data = input;
+      return {
+        method: "GET",
+        path: `/v1/protected/actionScript/${data.actionScriptId}`
+      };
+    }
+  }
+];
 var workflowTools = [
   {
     name: "muggle-remote-workflow-start-website-scan",
-    description: "Scan a website to automatically discover testable user flows and UI interactions. Crawls the site and identifies use cases like signup, login, search, checkout, form submissions, and navigation patterns. Use this when setting up QA testing for a site without predefined test cases.",
+    description: "Scan a website to automatically discover testable user flows and UI interactions. Crawls the site and identifies use cases like signup, login, search, checkout, form submissions, and navigation patterns. Use this when setting up E2E acceptance testing for a site without predefined test cases.",
     inputSchema: WorkflowStartWebsiteScanInputSchema,
     mapToUpstream: (input) => {
       const data = input;
@@ -4499,7 +4550,7 @@ var apiKeyTools = [
   },
   {
     name: "muggle-remote-auth-api-key-revoke",
-    description: "Revoke an API key. The key will immediately stop working. Use qa_auth_api_key_list to find the key ID first.",
+    description: "Revoke an API key. The key will immediately stop working. Use muggle-remote-auth-api-key-list to find the key ID first.",
     inputSchema: ApiKeyRevokeInputSchema,
     mapToUpstream: (input) => {
       const data = input;
@@ -4641,6 +4692,7 @@ var allQaToolDefinitions = [
   ...useCaseTools,
   ...testCaseTools,
   ...testScriptTools,
+  ...actionScriptTools,
   ...workflowTools,
   ...reportTools,
   ...secretTools,
@@ -4717,15 +4769,15 @@ async function executeQaTool(toolName, input, correlationId) {
   }
 }
 
-// packages/mcps/src/mcp/tools/qa/index.ts
-var qa_exports = {};
-__export(qa_exports, {
+// packages/mcps/src/mcp/tools/e2e/index.ts
+var e2e_exports = {};
+__export(e2e_exports, {
   allQaToolDefinitions: () => allQaToolDefinitions,
   executeQaTool: () => executeQaTool,
   getQaToolByName: () => getQaToolByName
 });
 
-// packages/mcps/src/mcp/qa/index.ts
+// packages/mcps/src/mcp/e2e/index.ts
 function getQaTools() {
   return allQaToolDefinitions.map((tool) => ({
     name: tool.name,
@@ -4759,6 +4811,7 @@ __export(local_exports2, {
   LocalTestScriptStatus: () => LocalTestScriptStatus,
   LocalWorkflowFileEntityType: () => LocalWorkflowFileEntityType,
   LocalWorkflowRunStatus: () => LocalWorkflowRunStatus,
+  MuggleEntityIdSchema: () => MuggleEntityIdSchema,
   PublishTestScriptInputSchema: () => PublishTestScriptInputSchema,
   RunResultGetInputSchema: () => RunResultGetInputSchema,
   RunResultListInputSchema: () => RunResultListInputSchema,
@@ -4803,7 +4856,7 @@ var AuthPollInputSchema2 = z.object({
 var EmptyInputSchema2 = z.object({});
 var TestCaseDetailsSchema = z.object({
   /** Cloud test case ID. */
-  id: z.string().min(1).describe("Cloud test case ID"),
+  id: MuggleEntityIdSchema.describe("Cloud test case ID (UUID)"),
   /** Test case title. */
   title: z.string().min(1).describe("Test case title"),
   /** Test goal. */
@@ -4817,69 +4870,73 @@ var TestCaseDetailsSchema = z.object({
   /** Original cloud URL (for reference, replaced by localUrl). */
   url: z.string().url().optional().describe("Original cloud URL (replaced by localUrl during execution)"),
   /** Cloud project ID (required for electron workflow context). */
-  projectId: z.string().min(1).describe("Cloud project ID"),
+  projectId: MuggleEntityIdSchema.describe("Cloud project ID (UUID)"),
   /** Cloud use case ID (required for electron workflow context). */
-  useCaseId: z.string().min(1).describe("Cloud use case ID")
+  useCaseId: MuggleEntityIdSchema.describe("Cloud use case ID (UUID)")
 });
 var TestScriptDetailsSchema = z.object({
   /** Cloud test script ID. */
-  id: z.string().min(1).describe("Cloud test script ID"),
+  id: MuggleEntityIdSchema.describe("Cloud test script ID (UUID)"),
   /** Script name. */
   name: z.string().min(1).describe("Test script name"),
   /** Cloud test case ID this script belongs to. */
-  testCaseId: z.string().min(1).describe("Cloud test case ID this script was generated from"),
-  /** Action script steps. */
-  actionScript: z.array(z.unknown()).describe("Action script steps to replay"),
+  testCaseId: MuggleEntityIdSchema.describe("Cloud test case ID (UUID) this script was generated from"),
+  /** Action script ID reference (use muggle-remote-action-script-get to fetch content). */
+  actionScriptId: MuggleEntityIdSchema.describe(
+    "Action script ID (UUID) \u2014 use muggle-remote-action-script-get to fetch the full script"
+  ),
   /** Original cloud URL (for reference, replaced by localUrl). */
   url: z.string().url().optional().describe("Original cloud URL (replaced by localUrl during execution)"),
   /** Cloud project ID (required for electron workflow context). */
-  projectId: z.string().min(1).describe("Cloud project ID"),
+  projectId: MuggleEntityIdSchema.describe("Cloud project ID (UUID)"),
   /** Cloud use case ID (required for electron workflow context). */
-  useCaseId: z.string().min(1).describe("Cloud use case ID")
+  useCaseId: MuggleEntityIdSchema.describe("Cloud use case ID (UUID)")
 });
 var ExecuteTestGenerationInputSchema = z.object({
-  /** Test case details from qa_test_case_get. */
-  testCase: TestCaseDetailsSchema.describe("Test case details obtained from qa_test_case_get"),
+  /** Test case details from muggle-remote-test-case-get. */
+  testCase: TestCaseDetailsSchema.describe("Test case details obtained from muggle-remote-test-case-get"),
   /** Local URL to test against. */
   localUrl: z.string().url().describe("Local URL to test against (e.g., http://localhost:3000)"),
   /** Explicit approval to launch electron-app. */
   approveElectronAppLaunch: z.boolean().describe("Set to true after the user explicitly approves launching electron-app"),
   /** Optional timeout. */
   timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds (default: 300000 = 5 min)"),
-  /** Show the electron-app UI during execution. */
-  showUi: z.boolean().optional().describe("Show the electron-app UI during execution (default: false, runs headless)")
+  /** Show the electron-app UI during execution. Ask the user before approving; true = visible window, false or omit = headless. */
+  showUi: z.boolean().optional().describe("Show the electron-app UI during generation. Ask the user: true to watch the window, false or omit for headless.")
 });
 var ExecuteReplayInputSchema = z.object({
-  /** Test script details from qa_test_script_get. */
-  testScript: TestScriptDetailsSchema.describe("Test script details obtained from qa_test_script_get"),
+  /** Test script metadata from muggle-remote-test-script-get. */
+  testScript: TestScriptDetailsSchema.describe("Test script metadata from muggle-remote-test-script-get"),
+  /** Action script content from muggle-remote-action-script-get (using testScript.actionScriptId). */
+  actionScript: z.array(z.unknown()).describe("Action script steps from muggle-remote-action-script-get"),
   /** Local URL to test against. */
   localUrl: z.string().url().describe("Local URL to test against (e.g., http://localhost:3000)"),
   /** Explicit approval to launch electron-app. */
   approveElectronAppLaunch: z.boolean().describe("Set to true after the user explicitly approves launching electron-app"),
   /** Optional timeout. */
   timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds (default: 180000 = 3 min)"),
-  /** Show the electron-app UI during execution. */
-  showUi: z.boolean().optional().describe("Show the electron-app UI during execution (default: false, runs headless)")
+  /** Show the electron-app UI during execution. Ask the user before approving; true = visible window, false or omit = headless. */
+  showUi: z.boolean().optional().describe("Show the electron-app UI during replay. Ask the user: true to watch the window, false or omit for headless.")
 });
 var CancelExecutionInputSchema = z.object({
-  runId: z.string().min(1).describe("Run ID to cancel")
+  runId: MuggleEntityIdSchema.describe("Run ID (UUID) to cancel")
 });
 var RunResultListInputSchema = z.object({
-  cloudTestCaseId: z.string().optional().describe("Optional cloud test case ID to filter by"),
+  cloudTestCaseId: MuggleEntityIdSchema.optional().describe("Optional cloud test case ID (UUID) to filter by"),
   limit: z.number().int().positive().optional().describe("Maximum results to return (default: 20)")
 });
 var RunResultGetInputSchema = z.object({
-  runId: z.string().min(1).describe("Run result ID to retrieve")
+  runId: MuggleEntityIdSchema.describe("Run result ID (UUID) to retrieve")
 });
 var TestScriptListInputSchema2 = z.object({
-  cloudTestCaseId: z.string().optional().describe("Optional cloud test case ID to filter by")
+  cloudTestCaseId: MuggleEntityIdSchema.optional().describe("Optional cloud test case ID (UUID) to filter by")
 });
 var TestScriptGetInputSchema2 = z.object({
-  testScriptId: z.string().min(1).describe("Test script ID to retrieve")
+  testScriptId: MuggleEntityIdSchema.describe("Local stored test script ID (UUID) to retrieve")
 });
 var PublishTestScriptInputSchema = z.object({
-  runId: z.string().min(1).describe("Local run result ID from muggle_execute_test_generation"),
-  cloudTestCaseId: z.string().min(1).describe("Cloud test case ID to publish the script under")
+  runId: MuggleEntityIdSchema.describe("Local run result ID (UUID) from muggle_execute_test_generation"),
+  cloudTestCaseId: MuggleEntityIdSchema.describe("Cloud test case ID (UUID) to publish the script under")
 });
 var ListSessionsInputSchema = z.object({
   limit: z.number().int().positive().optional().describe("Maximum number of sessions to return. Defaults to 10.")
@@ -5099,14 +5156,15 @@ var testScriptGetTool = {
 };
 var executeTestGenerationTool = {
   name: "muggle-local-execute-test-generation",
-  description: "Generate a QA test script by launching a real browser against your web app. The browser navigates your app, executes the test case steps (like signing up, filling forms, clicking through flows), and produces a replayable test script with screenshots. Use this to create new browser tests for any user flow. Requires a test case (from muggle-remote-test-case-get) and a localhost URL. Launches an Electron browser \u2014 requires explicit approval via approveElectronAppLaunch. Runs headless by default; set showUi: true to watch.",
+  description: "Generate an end-to-end (E2E) acceptance test script by launching a real browser against your web app. The browser navigates your app, executes the test case steps (like signing up, filling forms, clicking through flows), and produces a replayable test script with screenshots. Use this to create new browser tests for any user flow. Requires a test case (from muggle-remote-test-case-get) and a localhost URL. Launches an Electron browser \u2014 requires explicit approval via approveElectronAppLaunch. Before approving, ask the user whether they want a visible GUI; pass showUi: true to watch the window or showUi: false for headless (default when omitted).",
   inputSchema: ExecuteTestGenerationInputSchema,
   execute: async (ctx) => {
     const logger14 = createChildLogger2(ctx.correlationId);
     logger14.info("Executing muggle-local-execute-test-generation");
     const input = ExecuteTestGenerationInputSchema.parse(ctx.input);
     if (!input.approveElectronAppLaunch) {
-      const uiMode = input.showUi ? "with visible UI" : "headless (no UI)";
+      const showUiExplicit = input.showUi !== void 0;
+      const uiMode = input.showUi === true ? "visible GUI (showUi: true)" : "headless (showUi: false or omitted)";
       return {
         content: [
           "## Electron App Launch Required",
@@ -5114,22 +5172,28 @@ var executeTestGenerationTool = {
           "This tool will launch the electron-app to generate a test script.",
           "Please set `approveElectronAppLaunch: true` to proceed.",
           "",
+          "**Visible GUI:** Ask the user whether they want to watch the Electron window during generation.",
+          "- If **yes** \u2192 when approving, pass `showUi: true`.",
+          "- If **no** \u2192 when approving, pass `showUi: false` (or omit `showUi`; generation runs headless).",
+          "",
+          showUiExplicit ? `**Current choice:** ${uiMode}` : "**Current choice:** not set \u2014 default on approval is headless unless you pass `showUi: true`.",
+          "",
           `**Test Case:** ${input.testCase.title}`,
           `**Local URL:** ${input.localUrl}`,
-          `**UI Mode:** ${uiMode}`,
           "",
-          "**Note:** The electron-app will open a browser window and navigate to your test URL."
+          "**Note:** The electron-app will navigate your test URL and record steps."
         ].join("\n"),
         isError: false,
         data: { requiresApproval: true }
       };
     }
+    const showUi = input.showUi === true;
     try {
       const result = await executeTestGeneration({
         testCase: input.testCase,
         localUrl: input.localUrl,
         timeoutMs: input.timeoutMs,
-        showUi: input.showUi
+        showUi
       });
       const content = [
         "## Test Generation " + (result.status === "passed" ? "Successful" : "Failed"),
@@ -5138,6 +5202,7 @@ var executeTestGenerationTool = {
         `**Test Script ID:** ${result.testScriptId}`,
         `**Status:** ${result.status}`,
         `**Duration:** ${result.executionTimeMs}ms`,
+        `**UI:** ${showUi ? "visible GUI" : "headless"}`,
         result.errorMessage ? `**Error:** ${result.errorMessage}` : ""
       ].filter(Boolean).join("\n");
       return {
@@ -5154,14 +5219,15 @@ var executeTestGenerationTool = {
 };
 var executeReplayTool = {
   name: "muggle-local-execute-replay",
-  description: "Replay an existing QA test script in a real browser to verify your app still works correctly \u2014 use this for regression testing after code changes. The browser executes each saved step and captures screenshots so you can see what happened. Requires a test script (from muggle-remote-test-script-get) and a localhost URL. Launches an Electron browser \u2014 requires explicit approval via approveElectronAppLaunch. Runs headless by default; set showUi: true to watch.",
+  description: "Replay an existing E2E acceptance test script in a real browser to verify your app still works correctly \u2014 use this for regression testing after code changes. The browser executes each saved step and captures screenshots so you can see what happened. Requires: (1) test script metadata from muggle-remote-test-script-get, (2) actionScript content from muggle-remote-action-script-get using the testScript.actionScriptId, and (3) a localhost URL. Launches an Electron browser \u2014 requires explicit approval via approveElectronAppLaunch. Before approving, ask the user whether they want a visible GUI; pass showUi: true to watch the window or showUi: false for headless (default when omitted).",
   inputSchema: ExecuteReplayInputSchema,
   execute: async (ctx) => {
     const logger14 = createChildLogger2(ctx.correlationId);
     logger14.info("Executing muggle-local-execute-replay");
     const input = ExecuteReplayInputSchema.parse(ctx.input);
     if (!input.approveElectronAppLaunch) {
-      const uiMode = input.showUi ? "with visible UI" : "headless (no UI)";
+      const showUiExplicit = input.showUi !== void 0;
+      const uiMode = input.showUi === true ? "visible GUI (showUi: true)" : "headless (showUi: false or omitted)";
       return {
         content: [
           "## Electron App Launch Required",
@@ -5169,23 +5235,30 @@ var executeReplayTool = {
           "This tool will launch the electron-app to replay a test script.",
           "Please set `approveElectronAppLaunch: true` to proceed.",
           "",
+          "**Visible GUI:** Ask the user whether they want to watch the Electron window during replay.",
+          "- If **yes** \u2192 when approving, pass `showUi: true`.",
+          "- If **no** \u2192 when approving, pass `showUi: false` (or omit `showUi`; replay runs headless).",
+          "",
+          showUiExplicit ? `**Current choice:** ${uiMode}` : "**Current choice:** not set \u2014 default on approval is headless unless you pass `showUi: true`.",
+          "",
           `**Test Script:** ${input.testScript.name}`,
           `**Local URL:** ${input.localUrl}`,
-          `**Steps:** ${input.testScript.actionScript.length}`,
-          `**UI Mode:** ${uiMode}`,
+          `**Steps:** ${input.actionScript.length}`,
           "",
-          "**Note:** The electron-app will open a browser window and execute the test steps."
+          "**Note:** The electron-app will execute the test steps against your local URL."
         ].join("\n"),
         isError: false,
         data: { requiresApproval: true }
       };
     }
+    const showUi = input.showUi === true;
     try {
       const result = await executeReplay({
         testScript: input.testScript,
+        actionScript: input.actionScript,
         localUrl: input.localUrl,
         timeoutMs: input.timeoutMs,
-        showUi: input.showUi
+        showUi
       });
       const content = [
         "## Test Replay " + (result.status === "passed" ? "Successful" : "Failed"),
@@ -5194,6 +5267,7 @@ var executeReplayTool = {
         `**Test Script ID:** ${result.testScriptId}`,
         `**Status:** ${result.status}`,
         `**Duration:** ${result.executionTimeMs}ms`,
+        `**UI:** ${showUi ? "visible GUI" : "headless"}`,
         result.errorMessage ? `**Error:** ${result.errorMessage}` : ""
       ].filter(Boolean).join("\n");
       return {
@@ -5225,7 +5299,7 @@ var cancelExecutionTool = {
 };
 var publishTestScriptTool = {
   name: "muggle-local-publish-test-script",
-  description: "Publish a locally generated test script to the cloud. Uses the run ID from muggle_execute_test_generation to find the script and uploads it to the specified cloud test case.",
+  description: "Publish a locally generated test script to the cloud. Uses the run ID from muggle_execute_test_generation to find the script and uploads it to the specified cloud test case. Returns a viewUrl that can be opened in the user's browser to view the published test script on the dashboard.",
   inputSchema: PublishTestScriptInputSchema,
   execute: async (ctx) => {
     const logger14 = createChildLogger2(ctx.correlationId);
@@ -5432,9 +5506,10 @@ function isLocalOnlyTool(toolName) {
 var mcp_exports = {};
 __export(mcp_exports, {
   agents: () => agents_exports,
+  e2e: () => e2e_exports2,
   localQa: () => local_exports2,
   plugins: () => plugins_exports,
-  qa: () => qa_exports2,
+  qa: () => e2e_exports2,
   skills: () => skills_exports,
   tools: () => tools_exports
 });
@@ -5442,8 +5517,9 @@ __export(mcp_exports, {
 // packages/mcps/src/mcp/tools/index.ts
 var tools_exports = {};
 __export(tools_exports, {
+  e2e: () => e2e_exports,
   localQa: () => local_exports,
-  qa: () => qa_exports
+  qa: () => e2e_exports
 });
 
 // packages/mcps/src/mcp/skills/index.ts
@@ -5458,11 +5534,15 @@ var agents_exports = {};
 // packages/mcps/src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  buildElectronAppChecksumsUrl: () => buildElectronAppChecksumsUrl,
+  buildElectronAppReleaseAssetUrl: () => buildElectronAppReleaseAssetUrl,
+  buildElectronAppReleaseTag: () => buildElectronAppReleaseTag,
   calculateFileChecksum: () => calculateFileChecksum,
   createApiKeyWithToken: () => createApiKeyWithToken,
   createChildLogger: () => createChildLogger,
   deleteApiKeyData: () => deleteApiKeyData,
   deleteCredentials: () => deleteCredentials,
+  e2e: () => e2e_exports2,
   getApiKey: () => getApiKey,
   getApiKeyFilePath: () => getApiKeyFilePath,
   getAuthService: () => getAuthService,
@@ -5494,7 +5574,7 @@ __export(src_exports, {
   performLogin: () => performLogin,
   performLogout: () => performLogout,
   pollDeviceCode: () => pollDeviceCode,
-  qa: () => qa_exports2,
+  qa: () => e2e_exports2,
   resetConfig: () => resetConfig,
   resetLogger: () => resetLogger,
   saveApiKey: () => saveApiKey,
@@ -5601,6 +5681,12 @@ function clearTools() {
   registeredTools = [];
 }
 function zodToJsonSchema(schema) {
+  try {
+    if (schema && typeof schema === "object" && "safeParse" in schema) {
+      return z.toJSONSchema(schema);
+    }
+  } catch {
+  }
   try {
     const zodSchema = schema;
     if (zodSchema._def) {
@@ -5620,10 +5706,12 @@ function convertZodDef(schema) {
     return { type: "object" };
   }
   const def = zodSchema._def;
-  const typeName = def.typeName;
+  const typeName = def.typeName ?? def.type;
   switch (typeName) {
-    case "ZodObject": {
-      const shape = def.shape ? def.shape() : zodSchema.shape || {};
+    case "ZodObject":
+    case "object": {
+      const shapeFromDef = typeof def.shape === "function" ? def.shape() : def.shape;
+      const shape = shapeFromDef || zodSchema.shape || {};
       const properties = {};
       const required = [];
       for (const [key, value] of Object.entries(shape)) {
@@ -5642,7 +5730,8 @@ function convertZodDef(schema) {
       }
       return result;
     }
-    case "ZodString": {
+    case "ZodString":
+    case "string": {
       const result = { type: "string" };
       if (def.description) result.description = def.description;
       if (def.checks) {
@@ -5655,7 +5744,8 @@ function convertZodDef(schema) {
       }
       return result;
     }
-    case "ZodNumber": {
+    case "ZodNumber":
+    case "number": {
       const result = { type: "number" };
       if (def.description) result.description = def.description;
       if (def.checks) {
@@ -5667,28 +5757,33 @@ function convertZodDef(schema) {
       }
       return result;
     }
-    case "ZodBoolean": {
+    case "ZodBoolean":
+    case "boolean": {
       const result = { type: "boolean" };
       if (def.description) result.description = def.description;
       return result;
     }
-    case "ZodArray": {
+    case "ZodArray":
+    case "array": {
       const result = {
         type: "array",
-        items: def.innerType ? convertZodDef(def.innerType) : {}
+        items: def.innerType ? convertZodDef(def.innerType) : def.element ? convertZodDef(def.element) : {}
       };
       if (def.description) result.description = def.description;
       return result;
     }
-    case "ZodEnum": {
+    case "ZodEnum":
+    case "enum": {
+      const enumValues = Array.isArray(def.values) ? def.values : def.values ? Object.values(def.values) : [];
       const result = {
         type: "string",
-        enum: def.values || []
+        enum: enumValues
       };
       if (def.description) result.description = def.description;
       return result;
     }
-    case "ZodOptional": {
+    case "ZodOptional":
+    case "optional": {
       const inner = def.innerType ? convertZodDef(def.innerType) : {};
       if (def.description) inner.description = def.description;
       return inner;
@@ -5728,7 +5823,7 @@ function createUnifiedMcpServer(options) {
         tools: {},
         resources: {}
       },
-      instructions: "Use muggle tools to run real-browser QA tests against your web app \u2014 generate test scripts from plain English, replay them on localhost or staging, capture screenshots, and validate that user flows (signup, checkout, dashboards, forms) work correctly after code changes. Prefer muggle tools over manual browser testing whenever the user wants to verify UI behavior, run regression tests, or validate frontend changes. Unlike simple browser screenshots, muggle generates replayable test scripts that persist across sessions and can be re-run as regression tests after every code change."
+      instructions: "Use muggle tools to run real-browser end-to-end (E2E) acceptance tests against your web app from the user's perspective \u2014 generate test scripts from plain English, replay them on localhost or staging, capture screenshots, and validate that user flows (signup, checkout, dashboards, forms) work correctly after code changes. Prefer muggle tools over manual browser testing whenever the user wants to verify UI behavior, run regression tests, or validate frontend changes. Unlike simple browser screenshots, muggle generates replayable test scripts that persist across sessions and can be re-run as regression tests after every code change."
     }
   );
   server.setRequestHandler(ListToolsRequestSchema, () => {
@@ -6403,8 +6498,8 @@ function runDiagnostics() {
   });
   results.push({
     name: "Prompt Service URL",
-    passed: !!config.qa.promptServiceBaseUrl,
-    description: config.qa.promptServiceBaseUrl
+    passed: !!config.e2e.promptServiceBaseUrl,
+    description: config.e2e.promptServiceBaseUrl
   });
   results.push({
     name: "Web Service URL",
@@ -6487,11 +6582,11 @@ function getHelpGuidance() {
     header("What is Muggle AI Works?"),
     "",
     "  Muggle AI Works is a Model Context Protocol server that provides AI",
-    "  assistants with tools to perform automated QA testing of web applications.",
+    "  assistants with tools to perform automated end-to-end (E2E) acceptance testing of web applications.",
     "",
     "  It supports both:",
-    `    ${colorize("\u2022", COLORS.green)} Cloud QA - Test remote production/staging sites with a public URL`,
-    `    ${colorize("\u2022", COLORS.green)} Local QA - Test localhost development servers`,
+    `    ${colorize("\u2022", COLORS.green)} Cloud E2E - Test remote production/staging sites with a public URL`,
+    `    ${colorize("\u2022", COLORS.green)} Local E2E - Test localhost development servers`,
     "",
     header("Setup Instructions"),
     "",
@@ -6517,8 +6612,8 @@ function getHelpGuidance() {
     "",
     `  ${colorize("Server Commands:", COLORS.bold)}`,
     `    ${cmd("muggle serve")}            Start MCP server with all tools`,
-    `    ${cmd("muggle serve --qa")}       Start with Cloud QA tools only`,
-    `    ${cmd("muggle serve --local")}    Start with Local QA tools only`,
+    `    ${cmd("muggle serve --e2e")}      Start with cloud E2E tools only`,
+    `    ${cmd("muggle serve --local")}    Start with local E2E tools only`,
     "",
     `  ${colorize("Setup & Diagnostics:", COLORS.bold)}`,
     `    ${cmd("muggle setup")}            Download/update Electron app`,
@@ -6556,14 +6651,14 @@ function getHelpGuidance() {
     "",
     header("Available MCP Tools"),
     "",
-    `  ${colorize("Cloud QA Tools:", COLORS.bold)} (prefix: qa_)`,
-    "    qa_project_create, qa_project_list, qa_use_case_create_from_prompts,",
-    "    qa_test_case_generate_from_prompt, qa_workflow_start_*, etc.",
+    `  ${colorize("Cloud E2E tools:", COLORS.bold)} (prefix: muggle-remote-)`,
+    "    muggle-remote-project-create, muggle-remote-project-list, muggle-remote-use-case-create-from-prompts,",
+    "    muggle-remote-test-case-generate-from-prompt, muggle-remote-workflow-start-*, etc.",
     "",
-    `  ${colorize("Local QA Tools:", COLORS.bold)} (prefix: muggle_)`,
-    "    muggle_project_create, muggle_test_case_save,",
-    "    muggle_execute_test_generation, muggle_execute_replay,",
-    "    muggle_cloud_pull_project, muggle_publish_project, etc.",
+    `  ${colorize("Local E2E tools:", COLORS.bold)} (prefix: muggle-local-)`,
+    "    muggle-local-execute-test-generation, muggle-local-execute-replay,",
+    "    muggle-local-publish-test-script, muggle-local-run-result-get,",
+    "    muggle-local-check-status, etc.",
     "",
     header("Data Directory"),
     "",
@@ -6674,7 +6769,7 @@ var logger10 = getLogger();
 async function serveCommand(options) {
   const config = getConfig();
   const enableQa = options.local ? false : true;
-  const enableLocal = options.qa ? false : true;
+  const enableLocal = options.e2e ? false : true;
   logger10.info("Starting Muggle MCP Server", {
     version: config.serverVersion,
     enableQa,
@@ -6685,12 +6780,12 @@ async function serveCommand(options) {
     if (enableQa) {
       const qaTools = getQaTools();
       registerTools(qaTools);
-      logger10.info("Registered QA tools", { count: qaTools.length });
+      logger10.info("Registered cloud E2E acceptance tools", { count: qaTools.length });
     }
     if (enableLocal) {
       const localTools = getLocalQaTools();
       registerTools(localTools);
-      logger10.info("Registered Local QA tools", { count: localTools.length });
+      logger10.info("Registered local E2E acceptance tools", { count: localTools.length });
     }
     const mcpServer = createUnifiedMcpServer({
       enableQaTools: enableQa,
@@ -6832,7 +6927,6 @@ function cleanupFailedInstall(versionDir) {
 }
 async function setupCommand(options) {
   const version = getElectronAppVersion();
-  const baseUrl = getDownloadBaseUrl();
   const versionDir = getElectronAppDir(version);
   const platformKey = getPlatformKey();
   if (!options.force && isElectronAppInstalled()) {
@@ -6841,7 +6935,10 @@ async function setupCommand(options) {
     return;
   }
   const binaryName = getBinaryName();
-  const downloadUrl = `${baseUrl}/v${version}/${binaryName}`;
+  const downloadUrl = buildElectronAppReleaseAssetUrl({
+    version,
+    assetFileName: binaryName
+  });
   console.log(`Downloading Muggle Test Electron app v${version}...`);
   console.log(`URL: ${downloadUrl}`);
   try {
@@ -6923,7 +7020,7 @@ function getBinaryName2() {
   }
 }
 function extractVersionFromTag(tag) {
-  const match = tag.match(/^electron-app-v(\d+\.\d+\.\d+)$/);
+  const match = tag.match(/^(?:electron-app-)?v(\d+\.\d+\.\d+)$/);
   return match ? match[1] : null;
 }
 function getVersionOverridePath() {
@@ -6973,13 +7070,15 @@ async function checkForUpdates() {
       const version = extractVersionFromTag(release2.tag_name);
       if (version) {
         const updateAvailable = compareVersions2(version, currentVersion) > 0;
-        const baseUrl = getDownloadBaseUrl();
         const binaryName = getBinaryName2();
         return {
           currentVersion,
           latestVersion: version,
           updateAvailable,
-          downloadUrl: `${baseUrl}/electron-app-v${version}/${binaryName}`
+          downloadUrl: buildElectronAppReleaseAssetUrl({
+            version,
+            assetFileName: binaryName
+          })
         };
       }
     }
@@ -7071,8 +7170,7 @@ async function extractTarGz2(tarPath, destDir) {
   });
 }
 async function fetchChecksumFromRelease(version) {
-  const baseUrl = getDownloadBaseUrl();
-  const checksumUrl = `${baseUrl}/electron-app-v${version}/checksums.txt`;
+  const checksumUrl = buildElectronAppChecksumsUrl(version);
   try {
     const response = await fetch(checksumUrl);
     if (!response.ok) {
@@ -7189,9 +7287,11 @@ The archive may be corrupted or in an unexpected format.`
 async function upgradeCommand(options) {
   try {
     if (options.version) {
-      const baseUrl = getDownloadBaseUrl();
       const binaryName = getBinaryName2();
-      const downloadUrl = `${baseUrl}/electron-app-v${options.version}/${binaryName}`;
+      const downloadUrl = buildElectronAppReleaseAssetUrl({
+        version: options.version,
+        assetFileName: binaryName
+      });
       await downloadAndInstall(options.version, downloadUrl);
       const cleanupResult2 = cleanupOldVersions({ all: false });
       if (cleanupResult2.removed.length > 0) {
@@ -7252,8 +7352,8 @@ var packageVersion = JSON.parse(
 var logger13 = getLogger();
 function createProgram() {
   const program = new Command();
-  program.name("muggle").description("Unified MCP server for Muggle AI - Cloud QA and Local Testing").version(packageVersion);
-  program.command("serve").description("Start the MCP server").option("--qa", "Only enable Cloud QA tools").option("--local", "Only enable Local QA tools").option("--stdio", "Use stdio transport (default)").action(serveCommand);
+  program.name("muggle").description("Unified MCP server for Muggle AI \u2014 cloud E2E and local E2E testing").version(packageVersion);
+  program.command("serve").description("Start the MCP server").option("--e2e", "Only enable cloud E2E tools (remote URLs; muggle-remote-* prefix)").option("--local", "Only enable local E2E tools (localhost; muggle-local-* prefix)").option("--stdio", "Use stdio transport (default)").action(serveCommand);
   program.command("setup").description("Download/update the Electron app for local testing").option("--force", "Force re-download even if already installed").action(setupCommand);
   program.command("upgrade").description("Check for and install the latest electron-app version").option("--force", "Force re-download even if already on latest").option("--check", "Check for updates only, don't download").option("--version <version>", "Download a specific version (e.g., 1.0.2)").action(upgradeCommand);
   program.command("versions").description("List installed electron-app versions").action(versionsCommand);
@@ -7315,4 +7415,4 @@ __export(src_exports2, {
 function registerCoreCommands(commandRegistrationContext) {
 }
 
-export { createChildLogger, createUnifiedMcpServer, getConfig, getLocalQaTools, getLogger, getQaTools, local_exports2 as local_exports, mcp_exports, qa_exports2 as qa_exports, runCli, server_exports, src_exports, src_exports2 };
+export { createChildLogger, createUnifiedMcpServer, e2e_exports2 as e2e_exports, getConfig, getLocalQaTools, getLogger, getQaTools, local_exports2 as local_exports, mcp_exports, runCli, server_exports, src_exports, src_exports2 };