@muggleai/mcp 1.0.20 → 1.0.22

package/dist/{chunk-HOXCZIJC.js → chunk-DGEO3CP2.js}

@@ -9,7 +9,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSche
 import { v4 } from 'uuid';
 import { z, ZodError } from 'zod';
 import axios, { AxiosError } from 'axios';
-import { exec } from 'child_process';
+import { spawn, exec } from 'child_process';
 import * as fs5 from 'fs/promises';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 
@@ -24,14 +24,18 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
-var DEFAULT_PROMPT_SERVICE_URL = "https://promptservice.muggle-ai.com";
+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 DATA_DIR_NAME = ".muggle-ai";
 var ELECTRON_APP_DIR = "electron-app";
 var CREDENTIALS_FILE = "credentials.json";
-var DEFAULT_AUTH0_DOMAIN = "login.muggle-ai.com";
-var DEFAULT_AUTH0_CLIENT_ID = "UgG5UjoyLksxMciWWKqVpwfWrJ4rFvtT";
-var DEFAULT_AUTH0_AUDIENCE = "https://muggleai.us.auth0.com/api/v2/";
+var DEFAULT_AUTH0_PRODUCTION_DOMAIN = "login.muggle-ai.com";
+var DEFAULT_AUTH0_PRODUCTION_CLIENT_ID = "UgG5UjoyLksxMciWWKqVpwfWrJ4rFvtT";
+var DEFAULT_AUTH0_PRODUCTION_AUDIENCE = "https://muggleai.us.auth0.com/api/v2/";
+var DEFAULT_AUTH0_DEV_DOMAIN = "dev-po4mxmz0rd8a0w8w.us.auth0.com";
+var DEFAULT_AUTH0_DEV_CLIENT_ID = "hihMM2cxb40yHaZMH2MMXwO2ZRJQ3MxA";
+var DEFAULT_AUTH0_DEV_AUDIENCE = "https://dev-po4mxmz0rd8a0w8w.us.auth0.com/api/v2/";
 var DEFAULT_AUTH0_SCOPE = "openid profile email offline_access";
 var configInstance = null;
 var muggleConfigCache = null;
@@ -93,10 +97,20 @@ function getMuggleConfig() {
   This is a bug - please report it.`
     );
   }
+  if (config.runtimeTargetDefault !== void 0 && config.runtimeTargetDefault !== "production" && config.runtimeTargetDefault !== "dev") {
+    throw new Error(
+      `Invalid muggleConfig.runtimeTargetDefault in package.json.
+  Path: ${packageJsonPath}
+  Value: ${JSON.stringify(config.runtimeTargetDefault)}
+  Expected: "production" or "dev"
+  This is a bug - please report it.`
+    );
+  }
   muggleConfigCache = {
     electronAppVersion: config.electronAppVersion,
     downloadBaseUrl: config.downloadBaseUrl,
-    checksums: config.checksums || {}
+    checksums: config.checksums || {},
+    runtimeTargetDefault: config.runtimeTargetDefault
   };
   return muggleConfigCache;
 }
@@ -104,12 +118,12 @@ function getDataDir() {
   return path.join(os.homedir(), DATA_DIR_NAME);
 }
 function getDownloadedElectronAppPath() {
-  const platform3 = os.platform();
+  const platform4 = os.platform();
   const config = getMuggleConfig();
   const version = config.electronAppVersion;
   const baseDir = path.join(getDataDir(), ELECTRON_APP_DIR, version);
   let binaryPath;
-  switch (platform3) {
+  switch (platform4) {
     case "darwin":
       binaryPath = path.join(baseDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
       break;
@@ -128,10 +142,10 @@ function getDownloadedElectronAppPath() {
   return null;
 }
 function getSystemElectronAppPath() {
-  const platform3 = os.platform();
+  const platform4 = os.platform();
   const homeDir = os.homedir();
   let binaryPath;
-  switch (platform3) {
+  switch (platform4) {
     case "darwin":
       binaryPath = path.join(homeDir, "Applications", "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
       break;
@@ -183,17 +197,65 @@ function parseInteger(value, defaultValue) {
   const parsed = parseInt(value, 10);
   return isNaN(parsed) ? defaultValue : parsed;
 }
+function getPromptServiceRuntimeTarget() {
+  const runtimeTargetFromEnv = process.env.MUGGLE_MCP_PROMPT_SERVICE_TARGET;
+  if (runtimeTargetFromEnv) {
+    if (runtimeTargetFromEnv === "production" || runtimeTargetFromEnv === "dev") {
+      return runtimeTargetFromEnv;
+    }
+    throw new Error(
+      `Invalid MUGGLE_MCP_PROMPT_SERVICE_TARGET value: '${runtimeTargetFromEnv}'. Expected 'production' or 'dev'.`
+    );
+  }
+  const muggleConfig = getMuggleConfig();
+  if (muggleConfig.runtimeTargetDefault) {
+    return muggleConfig.runtimeTargetDefault;
+  }
+  return "dev";
+}
+function getDefaultPromptServiceUrl() {
+  const runtimeTarget = getPromptServiceRuntimeTarget();
+  if (runtimeTarget === "dev") {
+    return DEFAULT_PROMPT_SERVICE_DEV_URL;
+  }
+  return DEFAULT_PROMPT_SERVICE_PRODUCTION_URL;
+}
+function getDefaultAuth0Domain() {
+  const runtimeTarget = getPromptServiceRuntimeTarget();
+  if (runtimeTarget === "dev") {
+    return DEFAULT_AUTH0_DEV_DOMAIN;
+  }
+  return DEFAULT_AUTH0_PRODUCTION_DOMAIN;
+}
+function getDefaultAuth0ClientId() {
+  const runtimeTarget = getPromptServiceRuntimeTarget();
+  if (runtimeTarget === "dev") {
+    return DEFAULT_AUTH0_DEV_CLIENT_ID;
+  }
+  return DEFAULT_AUTH0_PRODUCTION_CLIENT_ID;
+}
+function getDefaultAuth0Audience() {
+  const runtimeTarget = getPromptServiceRuntimeTarget();
+  if (runtimeTarget === "dev") {
+    return DEFAULT_AUTH0_DEV_AUDIENCE;
+  }
+  return DEFAULT_AUTH0_PRODUCTION_AUDIENCE;
+}
 function buildAuth0Config() {
+  const defaultAuth0Domain = getDefaultAuth0Domain();
+  const defaultAuth0ClientId = getDefaultAuth0ClientId();
+  const defaultAuth0Audience = getDefaultAuth0Audience();
   return {
-    domain: process.env.AUTH0_DOMAIN ?? DEFAULT_AUTH0_DOMAIN,
-    clientId: process.env.AUTH0_CLIENT_ID ?? DEFAULT_AUTH0_CLIENT_ID,
-    audience: process.env.AUTH0_AUDIENCE ?? DEFAULT_AUTH0_AUDIENCE,
+    domain: process.env.AUTH0_DOMAIN ?? defaultAuth0Domain,
+    clientId: process.env.AUTH0_CLIENT_ID ?? defaultAuth0ClientId,
+    audience: process.env.AUTH0_AUDIENCE ?? defaultAuth0Audience,
     scope: process.env.AUTH0_SCOPE ?? DEFAULT_AUTH0_SCOPE
   };
 }
 function buildQaConfig() {
+  const defaultPromptServiceUrl = getDefaultPromptServiceUrl();
   return {
-    promptServiceBaseUrl: process.env.PROMPT_SERVICE_BASE_URL ?? DEFAULT_PROMPT_SERVICE_URL,
+    promptServiceBaseUrl: process.env.PROMPT_SERVICE_BASE_URL ?? defaultPromptServiceUrl,
     requestTimeoutMs: parseInteger(process.env.REQUEST_TIMEOUT_MS, 3e4),
     workflowTimeoutMs: parseInteger(process.env.WORKFLOW_TIMEOUT_MS, 12e4)
   };
@@ -201,9 +263,13 @@ function buildQaConfig() {
 function buildLocalQaConfig() {
   const dataDir = getDataDir();
   const auth0Scopes = (process.env.AUTH0_SCOPE ?? DEFAULT_AUTH0_SCOPE).split(" ");
+  const defaultPromptServiceUrl = getDefaultPromptServiceUrl();
+  const defaultAuth0Domain = getDefaultAuth0Domain();
+  const defaultAuth0ClientId = getDefaultAuth0ClientId();
+  const defaultAuth0Audience = getDefaultAuth0Audience();
   return {
     webServiceUrl: process.env.WEB_SERVICE_URL ?? DEFAULT_WEB_SERVICE_URL,
-    promptServiceUrl: process.env.PROMPT_SERVICE_BASE_URL ?? DEFAULT_PROMPT_SERVICE_URL,
+    promptServiceUrl: process.env.PROMPT_SERVICE_BASE_URL ?? defaultPromptServiceUrl,
     dataDir,
     sessionsDir: path.join(dataDir, "sessions"),
     projectsDir: path.join(dataDir, "projects"),
@@ -214,9 +280,9 @@ function buildLocalQaConfig() {
     webServicePath: resolveWebServicePath(),
     webServicePidFile: path.join(dataDir, "web-service.pid"),
     auth0: {
-      domain: process.env.AUTH0_DOMAIN ?? DEFAULT_AUTH0_DOMAIN,
-      clientId: process.env.AUTH0_CLIENT_ID ?? DEFAULT_AUTH0_CLIENT_ID,
-      audience: process.env.AUTH0_AUDIENCE ?? DEFAULT_AUTH0_AUDIENCE,
+      domain: process.env.AUTH0_DOMAIN ?? defaultAuth0Domain,
+      clientId: process.env.AUTH0_CLIENT_ID ?? defaultAuth0ClientId,
+      audience: process.env.AUTH0_AUDIENCE ?? defaultAuth0Audience,
       scopes: auth0Scopes
     }
   };
@@ -320,8 +386,8 @@ function getLogger() {
   return loggerInstance;
 }
 function createChildLogger(correlationId) {
-  const logger5 = getLogger();
-  return logger5.child({ correlationId });
+  const logger6 = getLogger();
+  return logger6.child({ correlationId });
 }
 function resetLogger() {
   loggerInstance = null;
@@ -341,7 +407,7 @@ function getOpenCommand(url) {
   }
 }
 async function openBrowserUrl(options) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     try {
       const command = getOpenCommand(options.url);
       logger.debug("[Browser] Opening URL", { url: options.url, command });
@@ -351,13 +417,13 @@ async function openBrowserUrl(options) {
             url: options.url,
             error: error.message
           });
-          resolve2({
+          resolve3({
             opened: false,
             error: error.message
           });
         } else {
           logger.info("[Browser] URL opened successfully", { url: options.url });
-          resolve2({ opened: true });
+          resolve3({ opened: true });
         }
       });
     } catch (error) {
@@ -366,7 +432,7 @@ async function openBrowserUrl(options) {
         url: options.url,
         error: errorMessage
       });
-      resolve2({
+      resolve3({
         opened: false,
         error: errorMessage
       });
@@ -472,16 +538,16 @@ var AuthService = class {
    * Get current authentication status.
    */
   getAuthStatus() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const storedAuth = this.loadStoredAuth();
     if (!storedAuth) {
-      logger5.debug("No stored auth found");
+      logger6.debug("No stored auth found");
       return { authenticated: false };
     }
     const now = /* @__PURE__ */ new Date();
     const expiresAt = new Date(storedAuth.expiresAt);
     const isExpired = now >= expiresAt;
-    logger5.debug("Auth status checked", {
+    logger6.debug("Auth status checked", {
       email: storedAuth.email,
       isExpired,
       expiresAt: storedAuth.expiresAt
@@ -498,10 +564,10 @@ var AuthService = class {
    * Start the device code flow.
    */
   async startDeviceCodeFlow() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const config = getConfig();
     const { domain, clientId, audience, scopes } = config.localQa.auth0;
-    logger5.info("Starting device code flow");
+    logger6.info("Starting device code flow");
     const url = `https://${domain}/oauth/device/code`;
     const body = new URLSearchParams({
       client_id: clientId,
@@ -517,14 +583,14 @@ var AuthService = class {
     });
     if (!response.ok) {
       const errorText = await response.text();
-      logger5.error("Device code request failed", {
+      logger6.error("Device code request failed", {
         status: response.status,
         error: errorText
       });
       throw new Error(`Failed to start device code flow: ${response.status} ${errorText}`);
     }
     const data = await response.json();
-    logger5.info("Device code flow started", {
+    logger6.info("Device code flow started", {
       userCode: data.user_code,
       verificationUri: data.verification_uri,
       expiresIn: data.expires_in
@@ -538,9 +604,9 @@ var AuthService = class {
       url: data.verification_uri_complete
     });
     if (browserOpenResult.opened) {
-      logger5.info("Browser opened for device code login");
+      logger6.info("Browser opened for device code login");
     } else {
-      logger5.warn("Failed to open browser for device code login", {
+      logger6.warn("Failed to open browser for device code login", {
         error: browserOpenResult.error,
         verificationUriComplete: data.verification_uri_complete
       });
@@ -560,7 +626,7 @@ var AuthService = class {
    * Store a pending device code for later retrieval.
    */
   storePendingDeviceCode(params) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const dir = path.dirname(this.pendingDeviceCodePath);
     if (!fs3.existsSync(dir)) {
       fs3.mkdirSync(dir, { recursive: true });
@@ -569,15 +635,15 @@ var AuthService = class {
       encoding: "utf-8",
       mode: 384
     });
-    logger5.debug("Pending device code stored", { userCode: params.userCode });
+    logger6.debug("Pending device code stored", { userCode: params.userCode });
   }
   /**
    * Get the pending device code if one exists and is not expired.
    */
   getPendingDeviceCode() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (!fs3.existsSync(this.pendingDeviceCodePath)) {
-      logger5.debug("No pending device code found");
+      logger6.debug("No pending device code found");
       return null;
     }
     try {
@@ -586,13 +652,13 @@ var AuthService = class {
       const now = /* @__PURE__ */ new Date();
       const expiresAt = new Date(data.expiresAt);
       if (now >= expiresAt) {
-        logger5.debug("Pending device code expired");
+        logger6.debug("Pending device code expired");
         this.clearPendingDeviceCode();
         return null;
       }
       return data.deviceCode;
     } catch (error) {
-      logger5.warn("Failed to read pending device code", {
+      logger6.warn("Failed to read pending device code", {
         error: error instanceof Error ? error.message : String(error)
       });
       return null;
@@ -602,13 +668,13 @@ var AuthService = class {
    * Clear the pending device code file.
    */
   clearPendingDeviceCode() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (fs3.existsSync(this.pendingDeviceCodePath)) {
       try {
         fs3.unlinkSync(this.pendingDeviceCodePath);
-        logger5.debug("Pending device code cleared");
+        logger6.debug("Pending device code cleared");
       } catch (error) {
-        logger5.warn("Failed to clear pending device code", {
+        logger6.warn("Failed to clear pending device code", {
           error: error instanceof Error ? error.message : String(error)
         });
       }
@@ -618,10 +684,10 @@ var AuthService = class {
    * Poll for device code authorization completion.
    */
   async pollDeviceCode(deviceCode) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const config = getConfig();
     const { domain, clientId } = config.localQa.auth0;
-    logger5.debug("Polling for device code authorization");
+    logger6.debug("Polling for device code authorization");
     const url = `https://${domain}/oauth/token`;
     const body = new URLSearchParams({
       grant_type: "urn:ietf:params:oauth:grant-type:device_code",
@@ -651,7 +717,7 @@ var AuthService = class {
           userId: userInfo.sub
         });
         this.clearPendingDeviceCode();
-        logger5.info("Device code authorization complete", { email: userInfo.email });
+        logger6.info("Device code authorization complete", { email: userInfo.email });
         return {
           status: "complete" /* Complete */,
           message: "Authentication successful!",
@@ -660,35 +726,35 @@ var AuthService = class {
       }
       const errorData = await response.json();
       if (errorData.error === "authorization_pending") {
-        logger5.debug("Authorization pending");
+        logger6.debug("Authorization pending");
         return {
           status: "pending" /* Pending */,
           message: "Waiting for user to complete authorization..."
         };
       }
       if (errorData.error === "slow_down") {
-        logger5.debug("Polling too fast");
+        logger6.debug("Polling too fast");
         return {
           status: "pending" /* Pending */,
           message: "Polling too fast, slowing down..."
         };
       }
       if (errorData.error === "expired_token") {
-        logger5.warn("Device code expired");
+        logger6.warn("Device code expired");
         return {
           status: "expired" /* Expired */,
           message: "The authorization code has expired. Please start again."
         };
       }
       if (errorData.error === "access_denied") {
-        logger5.warn("Access denied");
+        logger6.warn("Access denied");
         return {
           status: "error" /* Error */,
           message: "Access was denied by the user.",
           error: errorData.error_description ?? errorData.error
         };
       }
-      logger5.error("Unexpected error during polling", { error: errorData });
+      logger6.error("Unexpected error during polling", { error: errorData });
       return {
         status: "error" /* Error */,
         message: errorData.error_description ?? errorData.error,
@@ -696,7 +762,7 @@ var AuthService = class {
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      logger5.error("Poll request failed", { error: errorMessage });
+      logger6.error("Poll request failed", { error: errorMessage });
       return {
         status: "error" /* Error */,
         message: `Poll request failed: ${errorMessage}`,
@@ -708,11 +774,11 @@ var AuthService = class {
    * Poll for device code authorization until completion or timeout.
    */
   async waitForDeviceCodeAuthorization(params) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const timeoutMs = params.timeoutMs ?? DEFAULT_LOGIN_WAIT_TIMEOUT_MS;
     const pollIntervalMs = Math.max(params.intervalSeconds, 1) * 1e3;
     const startedAt = Date.now();
-    logger5.info("Waiting for device code authorization", {
+    logger6.info("Waiting for device code authorization", {
       timeoutMs,
       pollIntervalMs
     });
@@ -736,7 +802,7 @@ var AuthService = class {
    * Get user info from Auth0.
    */
   async getUserInfo(accessToken) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const config = getConfig();
     const { domain } = config.localQa.auth0;
     const url = `https://${domain}/userinfo`;
@@ -748,13 +814,13 @@ var AuthService = class {
         }
       });
       if (!response.ok) {
-        logger5.warn("Failed to get user info", { status: response.status });
+        logger6.warn("Failed to get user info", { status: response.status });
         return {};
       }
       const data = await response.json();
       return data;
     } catch (error) {
-      logger5.warn("User info request failed", {
+      logger6.warn("User info request failed", {
         error: error instanceof Error ? error.message : String(error)
       });
       return {};
@@ -765,7 +831,7 @@ var AuthService = class {
    */
   async storeAuth(params) {
     const { tokenResponse, email, userId } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const expiresAt = new Date(Date.now() + tokenResponse.expiresIn * 1e3).toISOString();
     const storedAuth = {
       accessToken: tokenResponse.accessToken,
@@ -782,13 +848,13 @@ var AuthService = class {
       encoding: "utf-8",
       mode: 384
     });
-    logger5.info("Auth stored successfully", { email, expiresAt });
+    logger6.info("Auth stored successfully", { email, expiresAt });
   }
   /**
    * Load stored authentication.
    */
   loadStoredAuth() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (!fs3.existsSync(this.authFilePath)) {
       return null;
     }
@@ -796,7 +862,7 @@ var AuthService = class {
       const content = fs3.readFileSync(this.authFilePath, "utf-8");
       return JSON.parse(content);
     } catch (error) {
-      logger5.error("Failed to load stored auth", {
+      logger6.error("Failed to load stored auth", {
         error: error instanceof Error ? error.message : String(error)
       });
       return null;
@@ -837,15 +903,15 @@ var AuthService = class {
    * @returns New access token or null if refresh failed.
    */
   async refreshAccessToken() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const storedAuth = this.loadStoredAuth();
     if (!storedAuth?.refreshToken) {
-      logger5.debug("No refresh token available");
+      logger6.debug("No refresh token available");
       return null;
     }
     const config = getConfig();
     const { domain, clientId } = config.localQa.auth0;
-    logger5.info("Refreshing access token");
+    logger6.info("Refreshing access token");
     const url = `https://${domain}/oauth/token`;
     const body = new URLSearchParams({
       grant_type: "refresh_token",
@@ -862,7 +928,7 @@ var AuthService = class {
       });
       if (!response.ok) {
         const errorText = await response.text();
-        logger5.error("Token refresh failed", {
+        logger6.error("Token refresh failed", {
           status: response.status,
           error: errorText
         });
@@ -885,10 +951,10 @@ var AuthService = class {
         encoding: "utf-8",
         mode: 384
       });
-      logger5.info("Access token refreshed", { expiresAt: newExpiresAt });
+      logger6.info("Access token refreshed", { expiresAt: newExpiresAt });
       return tokenData.access_token;
     } catch (error) {
-      logger5.error("Token refresh request failed", {
+      logger6.error("Token refresh request failed", {
         error: error instanceof Error ? error.message : String(error)
       });
       return null;
@@ -900,38 +966,49 @@ var AuthService = class {
    * @returns Valid access token or null if not authenticated or refresh failed.
    */
   async getValidAccessToken() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const storedAuth = this.loadStoredAuth();
     if (!storedAuth) {
-      logger5.debug("No stored auth, cannot get valid token");
+      logger6.debug("No stored auth, cannot get valid token");
       return null;
     }
-    if (!this.isAccessTokenExpired()) {
+    const now = /* @__PURE__ */ new Date();
+    const expiresAt = new Date(storedAuth.expiresAt);
+    const isStrictlyExpired = now >= expiresAt;
+    if (!isStrictlyExpired && !this.isAccessTokenExpired()) {
       return storedAuth.accessToken;
     }
-    logger5.info("Access token expired, attempting refresh");
+    if (!isStrictlyExpired) {
+      logger6.debug("Access token in buffer zone, attempting proactive refresh");
+    } else {
+      logger6.info("Access token expired, attempting refresh");
+    }
     const refreshedToken = await this.refreshAccessToken();
     if (refreshedToken) {
       return refreshedToken;
     }
-    logger5.warn("Token refresh failed, user needs to re-authenticate");
+    if (!isStrictlyExpired) {
+      logger6.warn("Token refresh failed, but token not yet expired - using existing token");
+      return storedAuth.accessToken;
+    }
+    logger6.warn("Token refresh failed and token is expired, user needs to re-authenticate");
     return null;
   }
   /**
    * Clear stored authentication (logout).
    */
   logout() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (!fs3.existsSync(this.authFilePath)) {
-      logger5.debug("No auth to clear");
+      logger6.debug("No auth to clear");
       return false;
     }
     try {
       fs3.unlinkSync(this.authFilePath);
-      logger5.info("Auth cleared successfully");
+      logger6.info("Auth cleared successfully");
       return true;
     } catch (error) {
-      logger5.error("Failed to clear auth", {
+      logger6.error("Failed to clear auth", {
         error: error instanceof Error ? error.message : String(error)
       });
       return false;
@@ -947,9 +1024,9 @@ function resetAuthService() {
   serviceInstance = null;
 }
 function sleep(params) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     setTimeout(() => {
-      resolve2();
+      resolve3();
     }, params.durationMs);
   });
 }
@@ -971,14 +1048,14 @@ var StorageService = class {
    * Ensure the base directories exist.
    */
   ensureDirectories() {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (!fs3.existsSync(this.dataDir)) {
       fs3.mkdirSync(this.dataDir, { recursive: true });
-      logger5.info("Created data directory", { path: this.dataDir });
+      logger6.info("Created data directory", { path: this.dataDir });
     }
     if (!fs3.existsSync(this.sessionsDir)) {
       fs3.mkdirSync(this.sessionsDir, { recursive: true });
-      logger5.info("Created sessions directory", { path: this.sessionsDir });
+      logger6.info("Created sessions directory", { path: this.sessionsDir });
     }
   }
   /**
@@ -987,14 +1064,14 @@ var StorageService = class {
    * @returns Path to the session directory.
    */
   createSessionDirectory(sessionId) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     this.ensureDirectories();
     const sessionDir = path.join(this.sessionsDir, sessionId);
     if (!fs3.existsSync(sessionDir)) {
       fs3.mkdirSync(sessionDir, { recursive: true });
       fs3.mkdirSync(path.join(sessionDir, "screenshots"), { recursive: true });
       fs3.mkdirSync(path.join(sessionDir, "logs"), { recursive: true });
-      logger5.info("Created session directory", { sessionId, path: sessionDir });
+      logger6.info("Created session directory", { sessionId, path: sessionDir });
     }
     return sessionDir;
   }
@@ -1003,11 +1080,11 @@ var StorageService = class {
    * @param metadata - Session metadata to save.
    */
   saveSessionMetadata(metadata) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(metadata.sessionId);
     const metadataPath = path.join(sessionDir, "metadata.json");
     fs3.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
-    logger5.debug("Saved session metadata", { sessionId: metadata.sessionId });
+    logger6.debug("Saved session metadata", { sessionId: metadata.sessionId });
   }
   /**
    * Load session metadata.
@@ -1015,7 +1092,7 @@ var StorageService = class {
    * @returns Session metadata, or null if not found.
    */
   loadSessionMetadata(sessionId) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const metadataPath = path.join(this.sessionsDir, sessionId, "metadata.json");
     if (!fs3.existsSync(metadataPath)) {
       return null;
@@ -1024,7 +1101,7 @@ var StorageService = class {
       const content = fs3.readFileSync(metadataPath, "utf-8");
       return JSON.parse(content);
     } catch (error) {
-      logger5.error("Failed to load session metadata", {
+      logger6.error("Failed to load session metadata", {
         sessionId,
         error: error instanceof Error ? error.message : String(error)
       });
@@ -1065,14 +1142,14 @@ var StorageService = class {
    * @param sessionId - Session ID to set as current.
    */
   setCurrentSession(sessionId) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const currentPath = path.join(this.sessionsDir, "current");
     const targetPath = path.join(this.sessionsDir, sessionId);
     if (fs3.existsSync(currentPath)) {
       fs3.unlinkSync(currentPath);
     }
     fs3.symlinkSync(targetPath, currentPath);
-    logger5.info("Set current session", { sessionId });
+    logger6.info("Set current session", { sessionId });
   }
   /**
    * Save a screenshot to the session directory.
@@ -1080,11 +1157,11 @@ var StorageService = class {
    */
   saveScreenshot(params) {
     const { sessionId, filename, data } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(sessionId);
     const screenshotPath = path.join(sessionDir, "screenshots", filename);
     fs3.writeFileSync(screenshotPath, data);
-    logger5.debug("Saved screenshot", { sessionId, filename });
+    logger6.debug("Saved screenshot", { sessionId, filename });
     return screenshotPath;
   }
   /**
@@ -1093,11 +1170,11 @@ var StorageService = class {
    */
   appendToResults(params) {
     const { sessionId, content } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(sessionId);
     const resultsPath = path.join(sessionDir, "results.md");
     fs3.appendFileSync(resultsPath, content + "\n", "utf-8");
-    logger5.debug("Appended to results", { sessionId });
+    logger6.debug("Appended to results", { sessionId });
   }
   /**
    * Get the results markdown content.
@@ -1132,7 +1209,7 @@ var StorageService = class {
    */
   createSession(params) {
     const { sessionId, targetUrl, testInstructions } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(sessionId);
     const metadata = {
       sessionId,
@@ -1144,7 +1221,7 @@ var StorageService = class {
     };
     this.saveSessionMetadata(metadata);
     this.setCurrentSession(sessionId);
-    logger5.info("Created session", { sessionId, targetUrl });
+    logger6.info("Created session", { sessionId, targetUrl });
     return sessionDir;
   }
   /**
@@ -1153,10 +1230,10 @@ var StorageService = class {
    */
   updateSessionStatus(params) {
     const { sessionId, status } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const metadata = this.loadSessionMetadata(sessionId);
     if (!metadata) {
-      logger5.warn("Session not found for status update", { sessionId });
+      logger6.warn("Session not found for status update", { sessionId });
       return;
     }
     metadata.status = status;
@@ -1164,7 +1241,7 @@ var StorageService = class {
       metadata.endTime = (/* @__PURE__ */ new Date()).toISOString();
     }
     this.saveSessionMetadata(metadata);
-    logger5.debug("Updated session status", { sessionId, status });
+    logger6.debug("Updated session status", { sessionId, status });
   }
   /**
    * Initialize the results.md file with a header.
@@ -1172,7 +1249,7 @@ var StorageService = class {
    */
   initializeResults(params) {
     const { sessionId, targetUrl, testInstructions } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(sessionId);
     const resultsPath = path.join(sessionDir, "results.md");
     const header = [
@@ -1188,7 +1265,7 @@ var StorageService = class {
       ""
     ].join("\n");
     fs3.writeFileSync(resultsPath, header, "utf-8");
-    logger5.debug("Initialized results.md", { sessionId });
+    logger6.debug("Initialized results.md", { sessionId });
   }
   /**
    * Append a test step to the results.md file.
@@ -1196,7 +1273,7 @@ var StorageService = class {
    */
   appendStepToResults(params) {
     const { sessionId, step } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = this.createSessionDirectory(sessionId);
     const resultsPath = path.join(sessionDir, "results.md");
     const statusIcon = step.success ? "\u2713" : "\u2717";
@@ -1209,7 +1286,7 @@ var StorageService = class {
       ""
     ].filter(Boolean).join("\n");
     fs3.appendFileSync(resultsPath, stepContent + "\n", "utf-8");
-    logger5.debug("Appended step to results", { sessionId, stepNumber: step.stepNumber });
+    logger6.debug("Appended step to results", { sessionId, stepNumber: step.stepNumber });
     const metadata = this.loadSessionMetadata(sessionId);
     if (metadata) {
       metadata.stepsCount = (metadata.stepsCount ?? 0) + 1;
@@ -1222,11 +1299,11 @@ var StorageService = class {
    */
   finalizeResults(params) {
     const { sessionId, status, summary } = params;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = path.join(this.sessionsDir, sessionId);
     const resultsPath = path.join(sessionDir, "results.md");
     if (!fs3.existsSync(resultsPath)) {
-      logger5.warn("Results file not found for finalization", { sessionId });
+      logger6.warn("Results file not found for finalization", { sessionId });
       return;
     }
     const metadata = this.loadSessionMetadata(sessionId);
@@ -1249,7 +1326,7 @@ var StorageService = class {
       summary ? summary : ""
     ].join("\n");
     fs3.appendFileSync(resultsPath, footer, "utf-8");
-    logger5.debug("Finalized results.md", { sessionId, status });
+    logger6.debug("Finalized results.md", { sessionId, status });
     if (metadata) {
       metadata.durationMs = durationMs;
       metadata.endTime = endTime.toISOString();
@@ -1291,7 +1368,7 @@ var StorageService = class {
    */
   cleanupOldSessions(params) {
     const maxAgeDays = params?.maxAgeDays ?? DEFAULT_SESSION_MAX_AGE_DAYS;
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const cutoffDate = /* @__PURE__ */ new Date();
     cutoffDate.setDate(cutoffDate.getDate() - maxAgeDays);
     const sessionIds = this.listSessions();
@@ -1310,12 +1387,12 @@ var StorageService = class {
         try {
           fs3.rmSync(sessionDir, { recursive: true, force: true });
           deletedCount++;
-          logger5.info("Deleted old session", {
+          logger6.info("Deleted old session", {
             sessionId,
             age: Math.floor((Date.now() - sessionDate.getTime()) / (1e3 * 60 * 60 * 24))
           });
         } catch (error) {
-          logger5.error("Failed to delete session", {
+          logger6.error("Failed to delete session", {
             sessionId,
             error: error instanceof Error ? error.message : String(error)
           });
@@ -1323,7 +1400,7 @@ var StorageService = class {
       }
     }
     if (deletedCount > 0) {
-      logger5.info("Session cleanup completed", {
+      logger6.info("Session cleanup completed", {
         deletedCount,
         maxAgeDays
       });
@@ -1344,10 +1421,10 @@ var StorageService = class {
    * @returns Whether deletion succeeded.
    */
   deleteSession(sessionId) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     const sessionDir = path.join(this.sessionsDir, sessionId);
     if (!fs3.existsSync(sessionDir)) {
-      logger5.warn("Session not found for deletion", { sessionId });
+      logger6.warn("Session not found for deletion", { sessionId });
       return false;
     }
     try {
@@ -1359,10 +1436,10 @@ var StorageService = class {
         }
       }
       fs3.rmSync(sessionDir, { recursive: true, force: true });
-      logger5.info("Deleted session", { sessionId });
+      logger6.info("Deleted session", { sessionId });
       return true;
     } catch (error) {
-      logger5.error("Failed to delete session", {
+      logger6.error("Failed to delete session", {
         sessionId,
         error: error instanceof Error ? error.message : String(error)
       });
@@ -1458,7 +1535,11 @@ var RunResultStorageService = class {
       runType: params.runType,
       status: "pending",
       cloudTestCaseId: params.cloudTestCaseId,
+      projectId: params.projectId,
+      useCaseId: params.useCaseId,
       localUrl: params.localUrl,
+      productionUrl: params.productionUrl,
+      localExecutionContext: params.localExecutionContext,
       createdAt: now,
       updatedAt: now
     };
@@ -1572,6 +1653,7 @@ function getRunResultStorageService() {
 function resetRunResultStorageService() {
   instance = null;
 }
+var logger3 = getLogger();
 var activeProcesses = /* @__PURE__ */ new Map();
 function getAuthenticatedUserId() {
   const authService = getAuthService();
@@ -1584,6 +1666,44 @@ function getAuthenticatedUserId() {
   }
   return authStatus.userId;
 }
+async function findPackageJsonAsync() {
+  const currentFileUrl = import.meta.url;
+  const currentDir = path.dirname(new URL(currentFileUrl).pathname);
+  const candidatePaths = [
+    path.resolve(currentDir, "../../../package.json"),
+    path.resolve(currentDir, "../package.json"),
+    path.resolve(currentDir, "../../package.json")
+  ];
+  for (const candidatePath of candidatePaths) {
+    try {
+      const packageJsonRaw = await fs5.readFile(candidatePath, "utf-8");
+      const packageJson = JSON.parse(packageJsonRaw);
+      if (packageJson.name === "@muggleai/mcp" && packageJson.version && packageJson.muggleConfig?.electronAppVersion) {
+        return {
+          version: packageJson.version,
+          muggleConfig: { electronAppVersion: packageJson.muggleConfig.electronAppVersion }
+        };
+      }
+    } catch {
+      continue;
+    }
+  }
+  throw new Error(
+    `Could not find @muggleai/mcp package.json with required fields. Searched paths: ${candidatePaths.join(", ")}`
+  );
+}
+async function getLocalExecutionContextBaseAsync(params) {
+  const packageJson = await findPackageJsonAsync();
+  return {
+    originalUrl: params.originalUrl,
+    productionUrl: params.productionUrl,
+    runByUserId: params.runByUserId,
+    machineHostname: os.hostname(),
+    osInfo: `${os.platform()} ${os.release()} ${os.arch()}`,
+    electronAppVersion: packageJson.muggleConfig.electronAppVersion,
+    mcpServerVersion: packageJson.version
+  };
+}
 function buildStudioAuthContent() {
   const authService = getAuthService();
   const authStatus = authService.getAuthStatus();
@@ -1620,15 +1740,259 @@ async function cleanupTempFiles(params) {
     }
   }
 }
+async function moveResultsToArtifacts(params) {
+  const storageService = getStorageService();
+  const sessionsDir = storageService.getSessionsDir();
+  const artifactsDir = path.join(sessionsDir, params.runId);
+  const actionScriptPath = path.join(artifactsDir, "action-script.json");
+  await fs5.mkdir(artifactsDir, { recursive: true });
+  await fs5.copyFile(params.generatedScriptPath, actionScriptPath);
+  try {
+    await fs5.unlink(params.generatedScriptPath);
+  } catch {
+  }
+  return artifactsDir;
+}
+async function writeExecutionLogs(params) {
+  const storageService = getStorageService();
+  const sessionsDir = storageService.getSessionsDir();
+  const artifactsDir = path.join(sessionsDir, params.runId);
+  await fs5.mkdir(artifactsDir, { recursive: true });
+  const stdoutPath = path.join(artifactsDir, "stdout.log");
+  const stderrPath = path.join(artifactsDir, "stderr.log");
+  await Promise.all([
+    fs5.writeFile(stdoutPath, params.stdout, "utf-8"),
+    fs5.writeFile(stderrPath, params.stderr, "utf-8")
+  ]);
+  logger3.info("Wrote execution logs to artifacts directory", {
+    runId: params.runId,
+    artifactsDir
+  });
+}
+function getElectronAppPathOrThrow() {
+  const config = getConfig();
+  const electronAppPath = config.localQa.electronAppPath;
+  if (!electronAppPath || electronAppPath.trim() === "") {
+    throw new Error(
+      "Electron app binary not found. Run 'muggle-mcp setup' or set ELECTRON_APP_PATH."
+    );
+  }
+  return electronAppPath;
+}
+function getRequiredStringField(params) {
+  const value = params.source[params.fieldName];
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(
+      `Missing required field '${params.fieldName}' in ${params.sourceLabel}. Please pass the full object from the corresponding muggle-remote-* get tool.`
+    );
+  }
+  return value;
+}
+function buildGenerationActionScript(params) {
+  const testCaseRecord = params.testCase;
+  const projectId = getRequiredStringField({
+    source: testCaseRecord,
+    fieldName: "projectId",
+    sourceLabel: "testCase"
+  });
+  const useCaseId = getRequiredStringField({
+    source: testCaseRecord,
+    fieldName: "useCaseId",
+    sourceLabel: "testCase"
+  });
+  return {
+    actionScriptId: params.localTestScriptId,
+    actionScriptName: `Local Generation ${params.testCase.title}`,
+    actionType: "UserDefined",
+    actionParams: {
+      type: "Test Script Generation Workflow",
+      name: `Local Generation ${params.testCase.title}`,
+      ownerId: params.ownerUserId,
+      projectId,
+      useCaseId,
+      testCaseId: params.testCase.id,
+      testScriptId: params.localTestScriptId,
+      actionScriptId: params.localTestScriptId,
+      workflowRunId: params.runId,
+      url: params.localUrl,
+      sharedTestMemoryId: ""
+    },
+    goal: params.testCase.goal,
+    url: params.localUrl,
+    description: params.testCase.title,
+    precondition: params.testCase.precondition ?? "",
+    expectedResult: params.testCase.expectedResult,
+    steps: [],
+    ownerId: params.ownerUserId,
+    createdAt: Date.now(),
+    isRemoteScript: false,
+    status: "active"
+  };
+}
+function buildReplayActionScript(params) {
+  const testScriptRecord = params.testScript;
+  const projectId = getRequiredStringField({
+    source: testScriptRecord,
+    fieldName: "projectId",
+    sourceLabel: "testScript"
+  });
+  const useCaseId = getRequiredStringField({
+    source: testScriptRecord,
+    fieldName: "useCaseId",
+    sourceLabel: "testScript"
+  });
+  const rewrittenActionScript = rewriteActionScriptUrls({
+    actionScript: params.testScript.actionScript,
+    originalUrl: params.testScript.url,
+    localUrl: params.localUrl
+  });
+  return {
+    actionScriptId: params.testScript.id,
+    actionScriptName: params.testScript.name,
+    actionType: "UserDefined",
+    actionParams: {
+      type: "Test Script Replay Workflow",
+      name: params.testScript.name,
+      ownerId: params.ownerUserId,
+      projectId,
+      useCaseId,
+      testCaseId: params.testScript.testCaseId,
+      testScriptId: params.testScript.id,
+      workflowRunId: params.runId,
+      sharedTestMemoryId: ""
+    },
+    goal: params.testScript.name,
+    url: params.localUrl,
+    description: params.testScript.name,
+    precondition: "",
+    expectedResult: "Replay completes without critical failures.",
+    steps: rewrittenActionScript,
+    ownerId: params.ownerUserId,
+    createdAt: Date.now(),
+    isRemoteScript: true,
+    status: "active"
+  };
+}
+async function executeElectronAppAsync(params) {
+  const mode = params.runType === "generation" ? "explore" : "engine";
+  const electronAppPath = getElectronAppPathOrThrow();
+  const spawnArgs = [mode, params.scriptFilePath, "", params.authFilePath];
+  logger3.info("Spawning electron-app for local execution", {
+    runId: params.runId,
+    mode,
+    electronAppPath,
+    spawnArgs
+  });
+  const electronEnv = { ...process.env };
+  delete electronEnv.ELECTRON_RUN_AS_NODE;
+  const child = spawn(electronAppPath, spawnArgs, {
+    stdio: ["ignore", "pipe", "pipe"],
+    env: electronEnv,
+    cwd: path.dirname(electronAppPath)
+  });
+  const processInfo = {
+    runId: params.runId,
+    process: child,
+    status: "running",
+    startedAt: Date.now(),
+    capturedStdout: "",
+    capturedStderr: ""
+  };
+  activeProcesses.set(params.runId, processInfo);
+  return await new Promise((resolve3, reject) => {
+    let settled = false;
+    const finalize = (result) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      if (processInfo.timeoutTimer) {
+        clearTimeout(processInfo.timeoutTimer);
+      }
+      activeProcesses.delete(params.runId);
+      if (result.ok) {
+        resolve3(result.payload);
+      } else {
+        reject(result.payload);
+      }
+    };
+    processInfo.timeoutTimer = setTimeout(() => {
+      processInfo.process.kill("SIGTERM");
+      finalize({
+        ok: false,
+        payload: new Error(
+          `Electron execution timed out after ${params.timeoutMs}ms.
+STDOUT:
+${processInfo.capturedStdout}
+STDERR:
+${processInfo.capturedStderr}`
+        )
+      });
+    }, params.timeoutMs);
+    if (child.stdout) {
+      child.stdout.on("data", (chunk) => {
+        processInfo.capturedStdout += chunk.toString();
+      });
+    }
+    if (child.stderr) {
+      child.stderr.on("data", (chunk) => {
+        processInfo.capturedStderr += chunk.toString();
+      });
+    }
+    child.on("error", (error) => {
+      finalize({
+        ok: false,
+        payload: new Error(`Failed to start electron-app: ${error.message}`)
+      });
+    });
+    child.on("close", (code, signal) => {
+      const exitCode = code ?? -1;
+      if (signal) {
+        finalize({
+          ok: false,
+          payload: new Error(
+            `Electron execution terminated by signal ${signal}.
+STDOUT:
+${processInfo.capturedStdout}
+STDERR:
+${processInfo.capturedStderr}`
+          )
+        });
+        return;
+      }
+      finalize({
+        ok: true,
+        payload: {
+          exitCode,
+          stdout: processInfo.capturedStdout,
+          stderr: processInfo.capturedStderr
+        }
+      });
+    });
+  });
+}
 async function executeTestGeneration(params) {
   const { testCase, localUrl } = params;
-  getAuthenticatedUserId();
+  const timeoutMs = params.timeoutMs ?? 3e5;
+  const userId = getAuthenticatedUserId();
   const authContent = buildStudioAuthContent();
+  if (!testCase.url) {
+    throw new Error("Missing required testCase.url for local run upload metadata");
+  }
+  const localExecutionContextBase = await getLocalExecutionContextBaseAsync({
+    runByUserId: userId,
+    originalUrl: localUrl,
+    productionUrl: testCase.url
+  });
   const storage = getRunResultStorageService();
   const runResult = storage.createRunResult({
     runType: "generation",
     cloudTestCaseId: testCase.id,
-    localUrl
+    projectId: testCase.projectId,
+    useCaseId: testCase.useCaseId,
+    localUrl,
+    productionUrl: testCase.url,
+    localExecutionContext: localExecutionContextBase
   });
   try {
     const localTestScript = storage.createTestScript({
@@ -1637,22 +2001,15 @@ async function executeTestGeneration(params) {
       cloudTestCaseId: testCase.id,
       goal: testCase.goal
     });
-    const actionScript = {
-      steps: [
-        {
-          type: "navigate",
-          url: localUrl
-        },
-        {
-          type: "explore",
-          goal: testCase.goal,
-          instructions: testCase.instructions,
-          expectedResult: testCase.expectedResult
-        }
-      ]
-    };
     const runId = runResult.id;
     const startedAt = Date.now();
+    const actionScript = buildGenerationActionScript({
+      testCase,
+      localUrl,
+      runId,
+      localTestScriptId: localTestScript.id,
+      ownerUserId: authContent.userId
+    });
     const inputFilePath = await writeTempFile({
       filename: `${runId}_input.json`,
       data: actionScript
@@ -1661,27 +2018,99 @@ async function executeTestGeneration(params) {
       filename: `${runId}_auth.json`,
       data: authContent
     });
-    const completedAt = Date.now();
-    const executionTimeMs = completedAt - startedAt;
-    storage.updateRunResult(runId, {
-      status: "failed",
-      testScriptId: localTestScript.id,
-      executionTimeMs,
-      errorMessage: "Electron-app execution not yet implemented."
-    });
-    await cleanupTempFiles({ filePaths: [inputFilePath, authFilePath] });
-    return {
-      id: runId,
-      testScriptId: localTestScript.id,
-      status: "failed",
-      executionTimeMs,
-      errorMessage: "Electron-app execution not yet implemented."
-    };
+    try {
+      const executionResult = await executeElectronAppAsync({
+        runId,
+        runType: "generation",
+        scriptFilePath: inputFilePath,
+        authFilePath,
+        timeoutMs
+      });
+      const completedAt = Date.now();
+      const executionTimeMs = completedAt - startedAt;
+      await writeExecutionLogs({
+        runId,
+        stdout: executionResult.stdout,
+        stderr: executionResult.stderr
+      });
+      if (executionResult.exitCode !== 0) {
+        const failureMessage = `Electron exited with code ${executionResult.exitCode}.
+STDOUT:
+${executionResult.stdout}
+STDERR:
+${executionResult.stderr}`;
+        storage.updateRunResult(runId, {
+          status: "failed",
+          testScriptId: localTestScript.id,
+          executionTimeMs,
+          errorMessage: failureMessage,
+          localExecutionContext: {
+            ...localExecutionContextBase,
+            localExecutionCompletedAt: completedAt
+          }
+        });
+        storage.updateTestScript(localTestScript.id, {
+          status: "failed"
+        });
+        return {
+          id: runId,
+          testScriptId: localTestScript.id,
+          status: "failed",
+          executionTimeMs,
+          errorMessage: failureMessage
+        };
+      }
+      const generatedScriptPath = path.join(
+        path.dirname(inputFilePath),
+        `gen_${path.basename(inputFilePath)}`
+      );
+      const generatedScriptRaw = await fs5.readFile(generatedScriptPath, "utf-8");
+      const generatedScript = JSON.parse(generatedScriptRaw);
+      const generatedSteps = generatedScript.steps;
+      if (!Array.isArray(generatedSteps)) {
+        throw new Error(
+          `Generated script does not contain a valid 'steps' array. File: ${generatedScriptPath}`
+        );
+      }
+      storage.updateTestScript(localTestScript.id, {
+        status: "generated",
+        actionScript: generatedSteps
+      });
+      const artifactsDir = await moveResultsToArtifacts({
+        runId,
+        generatedScriptPath
+      });
+      storage.updateRunResult(runId, {
+        status: "passed",
+        testScriptId: localTestScript.id,
+        executionTimeMs,
+        artifactsDir,
+        localExecutionContext: {
+          ...localExecutionContextBase,
+          localExecutionCompletedAt: completedAt
+        }
+      });
+      return {
+        id: runId,
+        testScriptId: localTestScript.id,
+        status: "passed",
+        executionTimeMs
+      };
+    } finally {
+      await cleanupTempFiles({
+        filePaths: [inputFilePath, authFilePath]
+      });
+    }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
+    const completedAt = Date.now();
     storage.updateRunResult(runResult.id, {
       status: "failed",
-      errorMessage
+      errorMessage,
+      localExecutionContext: {
+        ...localExecutionContextBase,
+        localExecutionCompletedAt: completedAt
+      }
     });
     return {
       id: runResult.id,
@@ -1693,49 +2122,111 @@ async function executeTestGeneration(params) {
 }
 async function executeReplay(params) {
   const { testScript, localUrl } = params;
-  getAuthenticatedUserId();
+  const timeoutMs = params.timeoutMs ?? 18e4;
+  const userId = getAuthenticatedUserId();
   const authContent = buildStudioAuthContent();
+  if (!testScript.url) {
+    throw new Error("Missing required testScript.url for local run upload metadata");
+  }
+  const localExecutionContextBase = await getLocalExecutionContextBaseAsync({
+    runByUserId: userId,
+    originalUrl: localUrl,
+    productionUrl: testScript.url
+  });
   const storage = getRunResultStorageService();
   const runResult = storage.createRunResult({
     runType: "replay",
     cloudTestCaseId: testScript.testCaseId,
-    localUrl
+    projectId: testScript.projectId,
+    useCaseId: testScript.useCaseId,
+    localUrl,
+    productionUrl: testScript.url,
+    localExecutionContext: localExecutionContextBase
   });
   try {
     const runId = runResult.id;
     const startedAt = Date.now();
-    const rewrittenActionScript = rewriteActionScriptUrls({
-      actionScript: testScript.actionScript,
-      originalUrl: testScript.url,
-      localUrl
+    const actionScript = buildReplayActionScript({
+      testScript,
+      localUrl,
+      runId,
+      ownerUserId: authContent.userId
     });
     const inputFilePath = await writeTempFile({
       filename: `${runId}_input.json`,
-      data: rewrittenActionScript
+      data: actionScript
     });
     const authFilePath = await writeTempFile({
       filename: `${runId}_auth.json`,
       data: authContent
     });
-    const completedAt = Date.now();
-    const executionTimeMs = completedAt - startedAt;
-    storage.updateRunResult(runId, {
-      status: "failed",
-      executionTimeMs,
-      errorMessage: "Electron-app execution not yet implemented."
-    });
-    await cleanupTempFiles({ filePaths: [inputFilePath, authFilePath] });
-    return {
-      id: runId,
-      status: "failed",
-      executionTimeMs,
-      errorMessage: "Electron-app execution not yet implemented."
-    };
+    try {
+      const executionResult = await executeElectronAppAsync({
+        runId,
+        runType: "replay",
+        scriptFilePath: inputFilePath,
+        authFilePath,
+        timeoutMs
+      });
+      const completedAt = Date.now();
+      const executionTimeMs = completedAt - startedAt;
+      await writeExecutionLogs({
+        runId,
+        stdout: executionResult.stdout,
+        stderr: executionResult.stderr
+      });
+      if (executionResult.exitCode !== 0) {
+        const failureMessage = `Electron exited with code ${executionResult.exitCode}.
+STDOUT:
+${executionResult.stdout}
+STDERR:
+${executionResult.stderr}`;
+        storage.updateRunResult(runId, {
+          status: "failed",
+          executionTimeMs,
+          errorMessage: failureMessage,
+          localExecutionContext: {
+            ...localExecutionContextBase,
+            localExecutionCompletedAt: completedAt
+          }
+        });
+        return {
+          id: runId,
+          status: "failed",
+          executionTimeMs,
+          errorMessage: failureMessage
+        };
+      }
+      const artifactsDir = path.join(getStorageService().getSessionsDir(), runId);
+      storage.updateRunResult(runId, {
+        status: "passed",
+        executionTimeMs,
+        artifactsDir,
+        localExecutionContext: {
+          ...localExecutionContextBase,
+          localExecutionCompletedAt: completedAt
+        }
+      });
+      return {
+        id: runId,
+        status: "passed",
+        executionTimeMs
+      };
+    } finally {
+      await cleanupTempFiles({
+        filePaths: [inputFilePath, authFilePath]
+      });
+    }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
+    const completedAt = Date.now();
     storage.updateRunResult(runResult.id, {
       status: "failed",
-      errorMessage
+      errorMessage,
+      localExecutionContext: {
+        ...localExecutionContextBase,
+        localExecutionCompletedAt: completedAt
+      }
     });
     return {
       id: runResult.id,
@@ -1789,52 +2280,52 @@ function ensureDataDir() {
   }
 }
 function loadCredentials() {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   const credentialsPath = getCredentialsFilePath();
   try {
     if (!fs3.existsSync(credentialsPath)) {
-      logger5.debug("No credentials file found", { path: credentialsPath });
+      logger6.debug("No credentials file found", { path: credentialsPath });
       return null;
     }
     const content = fs3.readFileSync(credentialsPath, "utf-8");
     const credentials = JSON.parse(content);
     if (!credentials.accessToken || !credentials.expiresAt) {
-      logger5.warn("Invalid credentials file - missing required fields");
+      logger6.warn("Invalid credentials file - missing required fields");
       return null;
     }
     return credentials;
   } catch (error) {
-    logger5.warn("Failed to load credentials", {
+    logger6.warn("Failed to load credentials", {
       error: error instanceof Error ? error.message : String(error)
     });
     return null;
   }
 }
 function saveCredentials(credentials) {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   const credentialsPath = getCredentialsFilePath();
   try {
     ensureDataDir();
     const content = JSON.stringify(credentials, null, 2);
     fs3.writeFileSync(credentialsPath, content, { mode: 384 });
-    logger5.info("Credentials saved", { path: credentialsPath });
+    logger6.info("Credentials saved", { path: credentialsPath });
   } catch (error) {
-    logger5.error("Failed to save credentials", {
+    logger6.error("Failed to save credentials", {
       error: error instanceof Error ? error.message : String(error)
     });
     throw error;
   }
 }
 function deleteCredentials() {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   const credentialsPath = getCredentialsFilePath();
   try {
     if (fs3.existsSync(credentialsPath)) {
       fs3.unlinkSync(credentialsPath);
-      logger5.info("Credentials deleted", { path: credentialsPath });
+      logger6.info("Credentials deleted", { path: credentialsPath });
     }
   } catch (error) {
-    logger5.warn("Failed to delete credentials", {
+    logger6.warn("Failed to delete credentials", {
       error: error instanceof Error ? error.message : String(error)
     });
   }
@@ -1864,7 +2355,7 @@ function getApiKey() {
   return credentials?.apiKey ?? null;
 }
 function saveApiKey(params) {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   const credentialsPath = getCredentialsFilePath();
   try {
     ensureDataDir();
@@ -1876,9 +2367,9 @@ function saveApiKey(params) {
     };
     const content = JSON.stringify(credentials, null, 2);
     fs3.writeFileSync(credentialsPath, content, { mode: 384 });
-    logger5.info("API key saved", { path: credentialsPath });
+    logger6.info("API key saved", { path: credentialsPath });
   } catch (error) {
-    logger5.error("Failed to save API key", {
+    logger6.error("Failed to save API key", {
       error: error instanceof Error ? error.message : String(error)
     });
     throw error;
@@ -1886,11 +2377,11 @@ function saveApiKey(params) {
 }
 
 // src/shared/auth.ts
-var logger3 = getLogger();
+var logger4 = getLogger();
 async function startDeviceCodeFlow(config) {
   const deviceCodeUrl = `https://${config.domain}/oauth/device/code`;
   try {
-    logger3.info("[Auth] Starting device code flow", {
+    logger4.info("[Auth] Starting device code flow", {
       domain: config.domain,
       clientId: config.clientId
     });
@@ -1908,7 +2399,7 @@ async function startDeviceCodeFlow(config) {
       }
     );
     const data = response.data;
-    logger3.info("[Auth] Device code flow started successfully", {
+    logger4.info("[Auth] Device code flow started successfully", {
       userCode: data.user_code,
       expiresIn: data.expires_in
     });
@@ -1916,9 +2407,9 @@ async function startDeviceCodeFlow(config) {
       url: data.verification_uri_complete
     });
     if (browserOpenResult.opened) {
-      logger3.info("[Auth] Browser opened for device code login");
+      logger4.info("[Auth] Browser opened for device code login");
     } else {
-      logger3.warn("[Auth] Failed to open browser", {
+      logger4.warn("[Auth] Failed to open browser", {
         error: browserOpenResult.error,
         verificationUriComplete: data.verification_uri_complete
       });
@@ -1935,7 +2426,7 @@ async function startDeviceCodeFlow(config) {
     };
   } catch (error) {
     if (error instanceof AxiosError) {
-      logger3.error("[Auth] Failed to start device code flow", {
+      logger4.error("[Auth] Failed to start device code flow", {
         status: error.response?.status,
         data: error.response?.data
       });
@@ -1962,7 +2453,7 @@ async function pollDeviceCode(config, deviceCode) {
         }
       }
     );
-    logger3.info("[Auth] Authorization successful");
+    logger4.info("[Auth] Authorization successful");
     return {
       status: "authorized",
       accessToken: response.data.access_token,
@@ -2001,7 +2492,7 @@ async function pollDeviceCode(config, deviceCode) {
           errorDescription: data.error_description || "User denied access"
         };
       }
-      logger3.error("[Auth] Unexpected error during poll", {
+      logger4.error("[Auth] Unexpected error during poll", {
         status: error.response.status,
         error: errorCode,
         description: data.error_description
@@ -2017,7 +2508,7 @@ async function createApiKeyWithToken(accessToken, keyName, expiry = "90d") {
   const config = getConfig();
   const apiKeyUrl = `${config.qa.promptServiceBaseUrl}/v1/protected/api-keys`;
   try {
-    logger3.info("[Auth] Creating API key", {
+    logger4.info("[Auth] Creating API key", {
       keyName,
       expiry
     });
@@ -2034,13 +2525,13 @@ async function createApiKeyWithToken(accessToken, keyName, expiry = "90d") {
         }
       }
     );
-    logger3.info("[Auth] API key created successfully", {
+    logger4.info("[Auth] API key created successfully", {
       keyId: response.data.id
     });
     return response.data;
   } catch (error) {
     if (error instanceof AxiosError) {
-      logger3.error("[Auth] Failed to create API key", {
+      logger4.error("[Auth] Failed to create API key", {
         status: error.response?.status,
         data: error.response?.data
       });
@@ -2079,7 +2570,7 @@ async function performLogin(keyName, keyExpiry = "90d", timeoutMs = 12e4) {
         userId: storedAuth?.userId
       };
       if (keyName && storedAuth?.accessToken) {
-        logger3.info("[Auth] Creating API key as explicitly requested", {
+        logger4.info("[Auth] Creating API key as explicitly requested", {
           keyName
         });
         const apiKeyResult = await createApiKeyWithToken(
@@ -2127,7 +2618,7 @@ function performLogout() {
   const authService = getAuthService();
   authService.logout();
   deleteCredentials();
-  logger3.info("[Auth] Logged out successfully");
+  logger4.info("[Auth] Logged out successfully");
 }
 function getCallerCredentials() {
   const credentials = getValidCredentials();
@@ -2203,8 +2694,7 @@ function toolRequiresAuth(toolName) {
     "muggle-local-workflow-file-list-available",
     "muggle-local-workflow-file-get",
     "muggle-local-workflow-file-update",
-    "muggle-local-workflow-file-delete",
-    "muggle-local-publish-test-script"
+    "muggle-local-workflow-file-delete"
   ];
   return !noAuthTools.includes(toolName);
 }
@@ -2336,7 +2826,7 @@ async function handleJitAuth(toolName, correlationId) {
   return { credentials: {}, authTriggered: false };
 }
 function createUnifiedMcpServer(options) {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   const config = getConfig();
   const server = new Server(
     {
@@ -2352,7 +2842,7 @@ function createUnifiedMcpServer(options) {
   );
   server.setRequestHandler(ListToolsRequestSchema, () => {
     const tools = getAllTools();
-    logger5.debug("Listing tools", { count: tools.length });
+    logger6.debug("Listing tools", { count: tools.length });
     const toolDefinitions = tools.map((tool) => {
       const jsonSchema = zodToJsonSchema(tool.inputSchema);
       return {
@@ -2428,8 +2918,8 @@ function createUnifiedMcpServer(options) {
           errors: error.errors
         });
         const issueMessages = error.errors.slice(0, 3).map((issue) => {
-          const path7 = issue.path.join(".");
-          return path7 ? `'${path7}': ${issue.message}` : issue.message;
+          const path8 = issue.path.join(".");
+          return path8 ? `'${path8}': ${issue.message}` : issue.message;
         });
         return {
           content: [
@@ -2463,12 +2953,12 @@ function createUnifiedMcpServer(options) {
     }
   });
   server.setRequestHandler(ListResourcesRequestSchema, () => {
-    logger5.debug("Listing resources");
+    logger6.debug("Listing resources");
     return { resources: [] };
   });
   server.setRequestHandler(ReadResourceRequestSchema, (request) => {
     const uri = request.params.uri;
-    logger5.debug("Reading resource", { uri });
+    logger6.debug("Reading resource", { uri });
     return {
       contents: [
         {
@@ -2479,7 +2969,7 @@ function createUnifiedMcpServer(options) {
       ]
     };
   });
-  logger5.info("Unified MCP server configured", {
+  logger6.info("Unified MCP server configured", {
     tools: getAllTools().length,
     enableQaTools: options.enableQaTools,
     enableLocalTools: options.enableLocalTools
@@ -2496,14 +2986,14 @@ __export(server_exports, {
   registerTools: () => registerTools,
   startStdioServer: () => startStdioServer
 });
-var logger4 = getLogger();
+var logger5 = getLogger();
 async function startStdioServer(server) {
-  logger4.info("Starting stdio server transport");
+  logger5.info("Starting stdio server transport");
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  logger4.info("Stdio server connected");
+  logger5.info("Stdio server connected");
   const shutdown = (signal) => {
-    logger4.info(`Received ${signal}, shutting down...`);
+    logger5.info(`Received ${signal}, shutting down...`);
     process.exit(0);
   };
   process.on("SIGTERM", () => shutdown("SIGTERM"));
@@ -2522,6 +3012,8 @@ __export(qa_exports, {
   EmptyInputSchema: () => EmptyInputSchema,
   GatewayError: () => GatewayError,
   IdSchema: () => IdSchema,
+  LocalExecutionContextInputSchema: () => LocalExecutionContextInputSchema,
+  LocalRunUploadInputSchema: () => LocalRunUploadInputSchema,
   McpErrorCode: () => McpErrorCode,
   PaginationInputSchema: () => PaginationInputSchema,
   PrdFileDeleteInputSchema: () => PrdFileDeleteInputSchema,
@@ -2575,6 +3067,7 @@ __export(qa_exports, {
   WorkflowGetLatestScriptGenByTestCaseInputSchema: () => WorkflowGetLatestScriptGenByTestCaseInputSchema,
   WorkflowGetReplayBulkBatchSummaryInputSchema: () => WorkflowGetReplayBulkBatchSummaryInputSchema,
   WorkflowListRuntimesInputSchema: () => WorkflowListRuntimesInputSchema,
+  WorkflowMemoryParamsSchema: () => WorkflowMemoryParamsSchema,
   WorkflowParamsSchema: () => WorkflowParamsSchema,
   WorkflowStartTestCaseDetectionInputSchema: () => WorkflowStartTestCaseDetectionInputSchema,
   WorkflowStartTestScriptGenerationInputSchema: () => WorkflowStartTestScriptGenerationInputSchema,
@@ -2587,12 +3080,43 @@ __export(qa_exports, {
   getQaToolByName: () => getQaToolByName,
   getQaTools: () => getQaTools
 });
+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"),
+  runByUserId: z.string().min(1).describe("User ID who executed the run locally"),
+  machineHostname: z.string().optional().describe("Local machine hostname"),
+  osInfo: z.string().optional().describe("Local OS information"),
+  electronAppVersion: z.string().optional().describe("Electron app version used for local run"),
+  mcpServerVersion: z.string().optional().describe("MCP server version used for local run"),
+  localExecutionCompletedAt: z.number().int().positive().describe("Epoch milliseconds when local run completed"),
+  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"),
+  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"),
+  actionScript: z.array(z.unknown()).min(1).describe("Generated action script steps from local execution"),
+  status: z.enum(["passed", "failed"]).describe("Final local run status"),
+  executionTimeMs: z.number().int().nonnegative().describe("Run duration in milliseconds"),
+  errorMessage: z.string().optional().describe("Error message when status is failed")
+});
+
+// src/qa/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 WorkflowParamsSchema = z.record(z.unknown()).optional().describe("Optional workflow parameters for memory configuration overrides");
+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")
+});
+var WorkflowParamsSchema = z.object({
+  memory: WorkflowMemoryParamsSchema.optional().describe("Per-run memory override settings")
+}).passthrough().optional().describe("Optional workflow parameters for workflow-level overrides");
 var ProjectCreateInputSchema = z.object({
   projectName: z.string().min(1).max(255).describe("Name of the project"),
   description: z.string().min(1).describe("Project description"),
@@ -2917,17 +3441,17 @@ var PromptServiceClient = class {
    * @param path - Path to validate.
    * @throws GatewayError if path is not allowed.
    */
-  validatePath(path7) {
-    const isAllowed = ALLOWED_UPSTREAM_PREFIXES.some((prefix) => path7.startsWith(prefix));
+  validatePath(path8) {
+    const isAllowed = ALLOWED_UPSTREAM_PREFIXES.some((prefix) => path8.startsWith(prefix));
     if (!isAllowed) {
-      const logger5 = getLogger();
-      logger5.error("Path not in allowlist", {
-        path: path7,
+      const logger6 = getLogger();
+      logger6.error("Path not in allowlist", {
+        path: path8,
         allowedPrefixes: ALLOWED_UPSTREAM_PREFIXES
       });
       throw new GatewayError({
         code: "FORBIDDEN" /* FORBIDDEN */,
-        message: `Path '${path7}' is not allowed`
+        message: `Path '${path8}' is not allowed`
       });
     }
   }
@@ -3027,7 +3551,7 @@ var PromptServiceClient = class {
    * @throws GatewayError on validation or upstream errors.
    */
   async execute(call, credentials, correlationId) {
-    const logger5 = getLogger();
+    const logger6 = getLogger();
     if (!credentials.bearerToken && !credentials.apiKey) {
       throw new GatewayError({
         code: "UNAUTHORIZED" /* UNAUTHORIZED */,
@@ -3039,7 +3563,7 @@ var PromptServiceClient = class {
     const headers = this.buildHeaders(credentials, correlationId);
     const timeout = call.timeoutMs || this.requestTimeoutMs;
     const startTime = Date.now();
-    logger5.info("Upstream request", {
+    logger6.info("Upstream request", {
       correlationId,
       method: call.method,
       path: call.path,
@@ -3066,7 +3590,7 @@ var PromptServiceClient = class {
       }
       const response = await this.httpClient.request(requestConfig);
       const latency = Date.now() - startTime;
-      logger5.info("Upstream response", {
+      logger6.info("Upstream response", {
         correlationId,
         statusCode: response.status,
         latencyMs: latency
@@ -3097,7 +3621,7 @@ var PromptServiceClient = class {
         throw error;
       }
       if (error instanceof AxiosError) {
-        logger5.error("Upstream request failed", {
+        logger6.error("Upstream request failed", {
           correlationId,
           error: error.message,
           code: error.code,
@@ -3116,7 +3640,7 @@ var PromptServiceClient = class {
           details: { upstreamPath: call.path }
         });
       }
-      logger5.error("Unknown upstream error", {
+      logger6.error("Unknown upstream error", {
         correlationId,
         error: String(error),
         latencyMs: latency
@@ -3680,6 +4204,40 @@ var workflowTools = [
         path: `${MUGGLE_TEST_PREFIX}/workflow/runtimes/${data.workflowRuntimeId}/cancel`
       };
     }
+  },
+  {
+    name: "muggle-remote-local-run-upload",
+    description: "Upload a locally executed run (generation/replay) to cloud workflow records.",
+    inputSchema: LocalRunUploadInputSchema,
+    mapToUpstream: (input) => {
+      const data = input;
+      return {
+        method: "POST",
+        path: `${MUGGLE_TEST_PREFIX}/local-run/upload`,
+        body: {
+          projectId: data.projectId,
+          useCaseId: data.useCaseId,
+          testCaseId: data.testCaseId,
+          runType: data.runType,
+          productionUrl: data.productionUrl,
+          localExecutionContext: {
+            originalUrl: data.localExecutionContext.originalUrl,
+            productionUrl: data.localExecutionContext.productionUrl,
+            runByUserId: data.localExecutionContext.runByUserId,
+            machineHostname: data.localExecutionContext.machineHostname,
+            osInfo: data.localExecutionContext.osInfo,
+            electronAppVersion: data.localExecutionContext.electronAppVersion,
+            mcpServerVersion: data.localExecutionContext.mcpServerVersion,
+            localExecutionCompletedAt: data.localExecutionContext.localExecutionCompletedAt,
+            uploadedAt: data.localExecutionContext.uploadedAt
+          },
+          actionScript: data.actionScript,
+          status: data.status,
+          executionTimeMs: data.executionTimeMs,
+          errorMessage: data.errorMessage
+        }
+      };
+    }
   }
 ];
 var reportTools = [
@@ -4372,7 +4930,7 @@ function defaultResponseMapper(response) {
   return response.data;
 }
 async function executeQaTool(toolName, input, correlationId) {
-  const logger5 = createChildLogger(correlationId);
+  const logger6 = createChildLogger(correlationId);
   const tool = getQaToolByName(toolName);
   if (!tool) {
     return {
@@ -4413,7 +4971,7 @@ async function executeQaTool(toolName, input, correlationId) {
     }
   } catch (error) {
     if (error instanceof GatewayError) {
-      logger5.warn("Tool call failed with gateway error", {
+      logger6.warn("Tool call failed with gateway error", {
         tool: toolName,
         code: error.code,
         message: error.message
@@ -4424,7 +4982,7 @@ async function executeQaTool(toolName, input, correlationId) {
       };
     }
     const errorMessage = error instanceof Error ? error.message : String(error);
-    logger5.error("Tool call failed", { tool: toolName, error: errorMessage });
+    logger6.error("Tool call failed", { tool: toolName, error: errorMessage });
     return {
       content: JSON.stringify({ error: "INTERNAL_ERROR", message: errorMessage }),
       isError: true
@@ -4514,7 +5072,11 @@ var TestCaseDetailsSchema = z.object({
   /** Step-by-step instructions (optional). */
   instructions: z.string().optional().describe("Step-by-step instructions for the test"),
   /** Original cloud URL (for reference, replaced by localUrl). */
-  url: z.string().url().optional().describe("Original cloud URL (replaced by localUrl during execution)")
+  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"),
+  /** Cloud use case ID (required for electron workflow context). */
+  useCaseId: z.string().min(1).describe("Cloud use case ID")
 });
 var TestScriptDetailsSchema = z.object({
   /** Cloud test script ID. */
@@ -4526,7 +5088,11 @@ var TestScriptDetailsSchema = z.object({
   /** Action script steps. */
   actionScript: z.array(z.unknown()).describe("Action script steps to replay"),
   /** Original cloud URL (for reference, replaced by localUrl). */
-  url: z.string().url().optional().describe("Original cloud URL (replaced by localUrl during execution)")
+  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"),
+  /** Cloud use case ID (required for electron workflow context). */
+  useCaseId: z.string().min(1).describe("Cloud use case ID")
 });
 var ExecuteTestGenerationInputSchema = z.object({
   /** Test case details from qa_test_case_get. */
@@ -4577,12 +5143,12 @@ var CleanupSessionsInputSchema = z.object({
 
 // src/local-qa/tools/tool-registry.ts
 function createChildLogger2(correlationId) {
-  const logger5 = getLogger();
+  const logger6 = getLogger();
   return {
-    info: (msg, meta) => logger5.info(msg, { ...meta, correlationId }),
-    error: (msg, meta) => logger5.error(msg, { ...meta, correlationId }),
-    warn: (msg, meta) => logger5.warn(msg, { ...meta, correlationId }),
-    debug: (msg, meta) => logger5.debug(msg, { ...meta, correlationId })
+    info: (msg, meta) => logger6.info(msg, { ...meta, correlationId }),
+    error: (msg, meta) => logger6.error(msg, { ...meta, correlationId }),
+    warn: (msg, meta) => logger6.warn(msg, { ...meta, correlationId }),
+    debug: (msg, meta) => logger6.debug(msg, { ...meta, correlationId })
   };
 }
 var checkStatusTool = {
@@ -4590,8 +5156,8 @@ var checkStatusTool = {
   description: "Check the status of Muggle Test Local. This verifies the connection to web-service and shows current session information.",
   inputSchema: EmptyInputSchema2,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-check-status");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-check-status");
     const authService = getAuthService();
     const storageService = getStorageService();
     const authStatus = authService.getAuthStatus();
@@ -4614,8 +5180,8 @@ var listSessionsTool = {
   description: "List all stored testing sessions. Shows session IDs, status, and metadata for each session.",
   inputSchema: ListSessionsInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-list-sessions");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-list-sessions");
     const input = ListSessionsInputSchema.parse(ctx.input);
     const storageService = getStorageService();
     const sessions = storageService.listSessionsWithMetadata();
@@ -4642,8 +5208,8 @@ var runResultListTool = {
   description: "List run results (test generation and replay history), optionally filtered by cloud test case ID.",
   inputSchema: RunResultListInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-run-result-list");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-run-result-list");
     const input = RunResultListInputSchema.parse(ctx.input);
     const storage = getRunResultStorageService();
     let results = storage.listRunResults();
@@ -4667,15 +5233,15 @@ var runResultGetTool = {
   description: "Get detailed information about a run result including screenshots and action script output.",
   inputSchema: RunResultGetInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-run-result-get");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-run-result-get");
     const input = RunResultGetInputSchema.parse(ctx.input);
     const storage = getRunResultStorageService();
     const result = storage.getRunResult(input.runId);
     if (!result) {
       return { content: `Run result not found: ${input.runId}`, isError: true };
     }
-    const content = [
+    const contentParts = [
       "## Run Result Details",
       "",
       `**ID:** ${result.id}`,
@@ -4684,7 +5250,56 @@ var runResultGetTool = {
       `**Cloud Test Case:** ${result.cloudTestCaseId}`,
       `**Duration:** ${result.executionTimeMs ?? 0}ms`,
       result.errorMessage ? `**Error:** ${result.errorMessage}` : ""
-    ].filter(Boolean).join("\n");
+    ];
+    let testScriptSteps;
+    if (result.testScriptId) {
+      const testScript = storage.getTestScript(result.testScriptId);
+      testScriptSteps = testScript?.actionScript?.length;
+    }
+    if (result.artifactsDir && fs3.existsSync(result.artifactsDir)) {
+      contentParts.push(
+        "",
+        "### Artifacts (view action script + screenshots)",
+        "",
+        `**Location:** \`${result.artifactsDir}\``,
+        ""
+      );
+      const actionScriptPath = path.join(result.artifactsDir, "action-script.json");
+      const resultsMdPath = path.join(result.artifactsDir, "results.md");
+      const screenshotsDir = path.join(result.artifactsDir, "screenshots");
+      const stdoutLogPath = path.join(result.artifactsDir, "stdout.log");
+      const stderrLogPath = path.join(result.artifactsDir, "stderr.log");
+      const artifactItems = [];
+      if (fs3.existsSync(actionScriptPath)) {
+        artifactItems.push("- `action-script.json` \u2014 generated test steps");
+      }
+      if (fs3.existsSync(resultsMdPath)) {
+        artifactItems.push("- `results.md` \u2014 step-by-step report with screenshot links");
+      }
+      if (fs3.existsSync(screenshotsDir)) {
+        const screenshots = fs3.readdirSync(screenshotsDir).filter((f) => /\.(png|jpg|jpeg|webp)$/i.test(f));
+        artifactItems.push(`- \`screenshots/\` \u2014 ${screenshots.length} image(s)`);
+      }
+      if (fs3.existsSync(stdoutLogPath)) {
+        artifactItems.push("- `stdout.log` \u2014 electron-app stdout output");
+      }
+      if (fs3.existsSync(stderrLogPath)) {
+        artifactItems.push("- `stderr.log` \u2014 electron-app stderr output");
+      }
+      if (artifactItems.length > 0) {
+        contentParts.push(artifactItems.join("\n"), "");
+      }
+    }
+    contentParts.push(
+      "",
+      "### Ending state",
+      "",
+      `- **Status:** ${result.status}`,
+      `- **Duration:** ${result.executionTimeMs ?? 0}ms`,
+      testScriptSteps !== void 0 ? `- **Steps generated:** ${testScriptSteps}` : "",
+      result.artifactsDir ? `- **Artifacts path:** \`${result.artifactsDir}\`` : ""
+    );
+    const content = contentParts.filter(Boolean).join("\n");
     return { content, isError: false, data: result };
   }
 };
@@ -4693,8 +5308,8 @@ var testScriptListTool = {
   description: "List locally generated test scripts, optionally filtered by cloud test case ID.",
   inputSchema: TestScriptListInputSchema2,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-test-script-list");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-test-script-list");
     const input = TestScriptListInputSchema2.parse(ctx.input);
     const storage = getRunResultStorageService();
     let scripts = storage.listTestScripts();
@@ -4714,8 +5329,8 @@ var testScriptGetTool = {
   description: "Get details of a locally generated test script including action script steps.",
   inputSchema: TestScriptGetInputSchema2,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-test-script-get");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-test-script-get");
     const input = TestScriptGetInputSchema2.parse(ctx.input);
     const storage = getRunResultStorageService();
     const testScript = storage.getTestScript(input.testScriptId);
@@ -4740,8 +5355,8 @@ var executeTestGenerationTool = {
   description: "Execute test script generation for a test case. First call qa_test_case_get to get test case details, then pass them here along with the localhost URL. Requires explicit approval before launching electron-app in explore mode.",
   inputSchema: ExecuteTestGenerationInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-execute-test-generation");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-execute-test-generation");
     const input = ExecuteTestGenerationInputSchema.parse(ctx.input);
     if (!input.approveElectronAppLaunch) {
       return {
@@ -4782,7 +5397,7 @@ var executeTestGenerationTool = {
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      logger5.error("Test generation failed", { error: errorMessage });
+      logger6.error("Test generation failed", { error: errorMessage });
       return { content: `Test generation failed: ${errorMessage}`, isError: true };
     }
   }
@@ -4792,8 +5407,8 @@ var executeReplayTool = {
   description: "Execute test script replay. First call qa_test_script_get to get test script details (including actionScript), then pass them here along with the localhost URL. Requires explicit approval before launching electron-app in engine mode.",
   inputSchema: ExecuteReplayInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-execute-replay");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-execute-replay");
     const input = ExecuteReplayInputSchema.parse(ctx.input);
     if (!input.approveElectronAppLaunch) {
       return {
@@ -4835,7 +5450,7 @@ var executeReplayTool = {
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      logger5.error("Test replay failed", { error: errorMessage });
+      logger6.error("Test replay failed", { error: errorMessage });
       return { content: `Test replay failed: ${errorMessage}`, isError: true };
     }
   }
@@ -4845,8 +5460,8 @@ var cancelExecutionTool = {
   description: "Cancel an active test generation or replay execution.",
   inputSchema: CancelExecutionInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-cancel-execution");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-cancel-execution");
     const input = CancelExecutionInputSchema.parse(ctx.input);
     const cancelled = cancelExecution({ runId: input.runId });
     if (cancelled) {
@@ -4860,8 +5475,8 @@ var publishTestScriptTool = {
   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.",
   inputSchema: PublishTestScriptInputSchema,
   execute: async (ctx) => {
-    const logger5 = createChildLogger2(ctx.correlationId);
-    logger5.info("Executing muggle-local-publish-test-script");
+    const logger6 = createChildLogger2(ctx.correlationId);
+    logger6.info("Executing muggle-local-publish-test-script");
     const input = PublishTestScriptInputSchema.parse(ctx.input);
     const storage = getRunResultStorageService();
     const runResult = storage.getRunResult(input.runId);
@@ -4875,18 +5490,121 @@ var publishTestScriptTool = {
     if (!testScript) {
       return { content: `Test script not found: ${runResult.testScriptId}`, isError: true };
     }
-    return {
-      content: [
-        "## Test Script Publishing",
-        "",
-        "Publishing test scripts to cloud is not yet implemented.",
-        "",
-        `**Run ID:** ${input.runId}`,
-        `**Test Script ID:** ${runResult.testScriptId}`,
-        `**Target Cloud Test Case:** ${input.cloudTestCaseId}`
-      ].join("\n"),
-      isError: true
-    };
+    if (runResult.runType !== "generation") {
+      return {
+        content: `Only generation runs can be published. Run ${input.runId} is '${runResult.runType}'.`,
+        isError: true
+      };
+    }
+    if (runResult.status !== "passed" && runResult.status !== "failed") {
+      return {
+        content: `Run ${input.runId} must be in passed/failed state before publishing. Current status: ${runResult.status}.`,
+        isError: true
+      };
+    }
+    if (!Array.isArray(testScript.actionScript) || testScript.actionScript.length === 0) {
+      return {
+        content: `Test script ${testScript.id} has no generated actionScript steps to publish.`,
+        isError: true
+      };
+    }
+    if (!runResult.projectId) {
+      return { content: `Run result ${input.runId} is missing projectId.`, isError: true };
+    }
+    if (!runResult.useCaseId) {
+      return { content: `Run result ${input.runId} is missing useCaseId.`, isError: true };
+    }
+    if (!runResult.productionUrl) {
+      return { content: `Run result ${input.runId} is missing productionUrl.`, isError: true };
+    }
+    if (!runResult.executionTimeMs && runResult.executionTimeMs !== 0) {
+      return { content: `Run result ${input.runId} is missing executionTimeMs.`, isError: true };
+    }
+    if (!runResult.localExecutionContext) {
+      return { content: `Run result ${input.runId} is missing localExecutionContext.`, isError: true };
+    }
+    if (!runResult.localExecutionContext.localExecutionCompletedAt) {
+      return {
+        content: `Run result ${input.runId} is missing localExecutionCompletedAt in localExecutionContext.`,
+        isError: true
+      };
+    }
+    const authStatus = getAuthService().getAuthStatus();
+    if (!authStatus.userId) {
+      return { content: "Authenticated user ID is missing. Please login again.", isError: true };
+    }
+    try {
+      const credentials = await getCallerCredentialsAsync();
+      const client = getPromptServiceClient();
+      const uploadedAt = Date.now();
+      const response = await client.execute(
+        {
+          method: "POST",
+          path: "/v1/protected/muggle-test/local-run/upload",
+          body: {
+            projectId: runResult.projectId,
+            useCaseId: runResult.useCaseId,
+            testCaseId: input.cloudTestCaseId,
+            runType: runResult.runType,
+            productionUrl: runResult.productionUrl,
+            localExecutionContext: {
+              originalUrl: runResult.localExecutionContext.originalUrl,
+              productionUrl: runResult.localExecutionContext.productionUrl,
+              runByUserId: authStatus.userId,
+              machineHostname: runResult.localExecutionContext.machineHostname,
+              osInfo: runResult.localExecutionContext.osInfo,
+              electronAppVersion: runResult.localExecutionContext.electronAppVersion,
+              mcpServerVersion: runResult.localExecutionContext.mcpServerVersion,
+              localExecutionCompletedAt: runResult.localExecutionContext.localExecutionCompletedAt,
+              uploadedAt
+            },
+            actionScript: testScript.actionScript,
+            status: runResult.status === "passed" ? "passed" : "failed",
+            executionTimeMs: runResult.executionTimeMs,
+            errorMessage: runResult.errorMessage
+          }
+        },
+        credentials,
+        ctx.correlationId
+      );
+      storage.updateTestScript(testScript.id, {
+        status: "published",
+        cloudActionScriptId: response.data.actionScriptId
+      });
+      storage.updateRunResult(runResult.id, {
+        localExecutionContext: {
+          ...runResult.localExecutionContext,
+          runByUserId: authStatus.userId
+        }
+      });
+      return {
+        content: [
+          "## Test Script Published",
+          "",
+          `**Run ID:** ${input.runId}`,
+          `**Local Test Script ID:** ${testScript.id}`,
+          `**Cloud Test Case ID:** ${input.cloudTestCaseId}`,
+          `**Cloud Test Script ID:** ${response.data.testScriptId}`,
+          `**Cloud Action Script ID:** ${response.data.actionScriptId}`,
+          `**Workflow Runtime ID:** ${response.data.workflowRuntimeId}`,
+          `**Workflow Run ID:** ${response.data.workflowRunId}`,
+          `**View URL:** ${response.data.viewUrl}`
+        ].join("\n"),
+        isError: false,
+        data: response.data
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logger6.error("Failed to publish local test script to cloud", {
+        runId: input.runId,
+        cloudTestCaseId: input.cloudTestCaseId,
+        error: errorMessage
+      });
+      return {
+        content: `Failed to publish test script: ${errorMessage}`,
+        isError: true
+      };
+    }
   }
 };
 var allLocalQaTools = [
@@ -4958,5 +5676,5 @@ function isLocalOnlyTool(toolName) {
 }
 
 export { __export, __require, createApiKeyWithToken, createChildLogger, createUnifiedMcpServer, deleteCredentials, getApiKey, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getConfig, getCredentialsFilePath, getDataDir, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getQaTools, getValidCredentials, hasApiKey, isCredentialsExpired, isElectronAppInstalled, loadCredentials, local_qa_exports, openBrowserUrl, performLogin, performLogout, pollDeviceCode, qa_exports, registerTools, resetConfig, resetLogger, saveApiKey, saveCredentials, server_exports, startDeviceCodeFlow, startStdioServer, toolRequiresAuth };
-//# sourceMappingURL=chunk-HOXCZIJC.js.map
-//# sourceMappingURL=chunk-HOXCZIJC.js.map
+//# sourceMappingURL=chunk-DGEO3CP2.js.map
+//# sourceMappingURL=chunk-DGEO3CP2.js.map