@muggleai/works 5.31.0-staging.277 → 5.31.0-staging.278

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "muggleai",
       "source": "./plugin",
       "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-      "version": "5.31.0-staging.277"
+      "version": "5.31.0-staging.278"
     }
   ]
 }

package/dist/{chunk-FVG7CYB7.js → chunk-CGKARU5D.js}

@@ -2937,6 +2937,11 @@ var MUGGLE_MCP_SERVER_PATTERN = /@muggleai[\\/]works\b.*\bserve\b/;
 var PR_WATCH_LOOP_PATTERN = /pr-watch-loop\.sh\b.*?--slot\s+(?:"([^"]+)"|(\S+))/;
 var CLAUDE_SESSION_REGISTRY_DIR_NAME = "sessions";
 var CLAUDE_PROJECTS_DIR_NAME = "projects";
+var CLAUDE_JOBS_DIR_NAME = "jobs";
+var CLAUDE_JOB_STATE_FILE_NAME = "state.json";
+var SESSION_NAME_FLAG = "--name";
+var CLAUDE_PROMPT_NAME_MAX_LENGTH = 200;
+var CUSTOM_TITLE_ENTRY_TYPE = "custom-title";
 var CLAUDE_INSTALLED_PLUGINS_RELATIVE_PATH = ["plugins", "installed_plugins.json"];
 var CLAUDE_GLOBAL_CONFIG_FILE_NAME = ".claude.json";
 var CLAUDE_SETTINGS_FILE_NAME = "settings.json";
@@ -3004,6 +3009,7 @@ function resolveWatchPaths(env = process.env) {
     slotsDir: join(muggleDataDir, ...PR_WATCH_SLOTS_RELATIVE_PATH),
     claudeSessionRegistryDir: join(claudeConfigDir, CLAUDE_SESSION_REGISTRY_DIR_NAME),
     claudeProjectsDir: join(claudeConfigDir, CLAUDE_PROJECTS_DIR_NAME),
+    claudeJobsDir: join(claudeConfigDir, CLAUDE_JOBS_DIR_NAME),
     claudeInstalledPluginsFile: join(claudeConfigDir, ...CLAUDE_INSTALLED_PLUGINS_RELATIVE_PATH),
     claudeGlobalConfigFile: join(env.CLAUDE_CONFIG_DIR || homedir(), CLAUDE_GLOBAL_CONFIG_FILE_NAME),
     claudeSettingsFile: join(claudeConfigDir, CLAUDE_SETTINGS_FILE_NAME),
@@ -5167,6 +5173,44 @@ function readCodexSessions(sessionsDir, nowMs) {
   }
   return sessions;
 }
+function jobStatePath(jobsDir, shortId) {
+  return join(jobsDir, shortId, CLAUDE_JOB_STATE_FILE_NAME);
+}
+function readJobState(statePath) {
+  try {
+    const parsed = JSON.parse(readFileSync(statePath, "utf-8"));
+    return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function respawnFlagsOf(state) {
+  return Array.isArray(state.respawnFlags) ? state.respawnFlags.filter((flag) => typeof flag === "string") : [];
+}
+function nameFlagOf(respawnFlags) {
+  const flagIndex = respawnFlags.lastIndexOf(SESSION_NAME_FLAG);
+  return flagIndex === -1 ? void 0 : optionalString(respawnFlags[flagIndex + 1]);
+}
+function readClaudeJob(jobsDir, shortId) {
+  const state = readJobState(jobStatePath(jobsDir, shortId));
+  if (state === void 0) return void 0;
+  const intent = optionalString(state.intent);
+  return { respawnFlags: respawnFlagsOf(state), ...intent === void 0 ? {} : { intent } };
+}
+function pinClaudeJobName(jobsDir, shortId, name) {
+  const statePath = jobStatePath(jobsDir, shortId);
+  const state = readJobState(statePath);
+  if (state === void 0) return false;
+  const respawnFlags = respawnFlagsOf(state);
+  if (nameFlagOf(respawnFlags) === name) return true;
+  const otherFlags = respawnFlags.filter((flag, index) => flag !== SESSION_NAME_FLAG && respawnFlags[index - 1] !== SESSION_NAME_FLAG);
+  try {
+    writeFileSync(statePath, JSON.stringify({ ...state, respawnFlags: [...otherFlags, SESSION_NAME_FLAG, name] }, null, 2));
+    return true;
+  } catch {
+    return false;
+  }
+}
 function findTranscriptPath(projectsDir, sessionId) {
   let projectDirNames;
   try {
@@ -5211,6 +5255,23 @@ function readLimitStop(projectsDir, sessionId) {
   }
   return void 0;
 }
+function readCustomTitle(projectsDir, sessionId) {
+  const transcriptPath = findTranscriptPath(projectsDir, sessionId);
+  if (transcriptPath === void 0) return void 0;
+  let transcript;
+  try {
+    transcript = readFileSync(transcriptPath, "utf-8");
+  } catch {
+    return void 0;
+  }
+  let customTitle;
+  for (const line of transcript.split("\n")) {
+    if (!line.includes(CUSTOM_TITLE_ENTRY_TYPE)) continue;
+    const entry = parseTranscriptLine(line);
+    if (entry?.type === CUSTOM_TITLE_ENTRY_TYPE) customTitle = optionalString(entry.customTitle) ?? customTitle;
+  }
+  return customTitle;
+}
 function findClaudeSessionCwd(projectsDir, sessionId) {
   const transcriptPath = findTranscriptPath(projectsDir, sessionId);
   if (transcriptPath === void 0) return void 0;
@@ -5430,7 +5491,7 @@ function startServiceLoops(assessments, nowMs, isPollingDisabled, ownerSessionOf
 }
 
 // src/watch/session-restart.ts
-function resumeSession(target, runCommand, waitForExit, isSessionRunning2) {
+function resumeSession(target, runCommand, waitForExit, isSessionRunning2, pinSessionName) {
   const runningSessionId = target.runningSessionId ?? target.sessionId;
   if (target.runningShortId !== void 0) {
     runCommand("claude", ["stop", target.runningShortId]);
@@ -5438,6 +5499,7 @@ function resumeSession(target, runCommand, waitForExit, isSessionRunning2) {
   } else if (isSessionRunning2(runningSessionId)) {
     return { outcome: "still-running" /* StillRunning */ };
   }
+  pinSessionName(target.sessionId, target.runningShortId ?? shortSessionId(target.sessionId));
   const resumed = runCommand("claude", ["--resume", target.sessionId, "--bg", target.prompt], { cwd: target.cwd, isStderrCaptured: true });
   if (resumed?.exitCode !== 0) return { outcome: "failed" /* Failed */ };
   const backgroundedShortId = resumed.stdout.match(BACKGROUNDED_SESSION_ID_PATTERN)?.[1];
@@ -5530,7 +5592,8 @@ function executeWatcherRecoveries(planned, attemptsByOwner, deps) {
       { sessionId: recovery.ownerSessionId, cwd, prompt, runningShortId: recovery.ownerShortId, runningSessionId: recovery.ownerRunningSessionId },
       deps.runCommand,
       deps.waitForExit,
-      deps.isSessionRunning
+      deps.isSessionRunning,
+      deps.pinSessionName
     );
     if (resumed.outcome === "continued" /* Continued */) {
       markServiceLoopReportDelivered(recovery.slotDir);
@@ -5889,7 +5952,8 @@ function executeLimitResumes(planned, attemptsBySession, deps) {
         { sessionId: decision.sessionId, cwd, prompt: LIMIT_RESUME_PROMPT, runningShortId: decision.runningShortId },
         deps.runCommand,
         deps.waitForExit,
-        deps.isSessionRunning
+        deps.isSessionRunning,
+        deps.pinSessionName
       );
       outcome = continuedOutcomeOf(resumed.outcome);
       message = continueMessageOf(resumed, decision.reason);
@@ -6159,7 +6223,7 @@ function planReloadFanOut(sessions, pending, watchOwnerSessionIds, maxRestarts =
   }
   return decisions;
 }
-function executeReloadFanOut(decisions, runCommand, canRestartIn) {
+function executeReloadFanOut(decisions, runCommand, canRestartIn, pinSessionName) {
   const restartableByCwd = /* @__PURE__ */ new Map();
   const isRestartable = (cwd) => {
     if (!restartableByCwd.has(cwd)) restartableByCwd.set(cwd, canRestartIn(cwd));
@@ -6172,6 +6236,7 @@ function executeReloadFanOut(decisions, runCommand, canRestartIn) {
       report.untrustedSessionIds.push(decision.sessionId);
       continue;
     }
+    pinSessionName(decision.sessionId, decision.shortId);
     const isRestarted = runCommand("claude", ["respawn", decision.shortId])?.exitCode === 0;
     (isRestarted ? report.respawnedSessionIds : report.failedSessionIds).push(decision.sessionId);
   }
@@ -6372,6 +6437,16 @@ function stampSessionLoads(sessions, table, tracked, installs, nowMs) {
   });
 }
 
+// src/watch/session-names.ts
+function isPlaceholderSessionName(name, shortId) {
+  return name === void 0 || name === shortId || name === LIMIT_RESUME_PROMPT || name.startsWith("/");
+}
+function resolveSessionName(sources) {
+  const promptName = sources.job?.intent?.replace(/\s+/g, " ").trim().slice(0, CLAUDE_PROMPT_NAME_MAX_LENGTH);
+  const candidates = [sources.customTitle, sources.job && nameFlagOf(sources.job.respawnFlags), sources.registeredName, promptName];
+  return candidates.find((candidate) => !isPlaceholderSessionName(candidate, sources.shortId));
+}
+
 // src/watch/terminal-pr-cache.ts
 function isRecheckDue(record, nowMs) {
   if (!record) return true;
@@ -6677,12 +6752,12 @@ function reloadRecordFor(state, targetAtMs) {
 }
 function runReloadPass(record, claudeSessions, watchOwnerSessionIds, deps, at) {
   const decisions = planReloadFanOut(claudeSessions, record, watchOwnerSessionIds);
-  const report = executeReloadFanOut(decisions, deps.runCommand, canRestartVia(deps));
+  const report = executeReloadFanOut(decisions, deps.runCommand, canRestartVia(deps), pinSessionNameVia(deps, claudeSessions));
   return { report, pendingReload: advancePendingReload(record, report), events: reloadEvents(report, at) };
 }
 function runRemoteControlPass(login, claudeSessions, restartsBySession, maxRestarts, deps, at) {
   const plan = planRemoteControlRestarts(claudeSessions, login, restartsBySession, deps.nowMs, maxRestarts);
-  const executed = executeReloadFanOut(plan.decisions, deps.runCommand, canRestartVia(deps));
+  const executed = executeReloadFanOut(plan.decisions, deps.runCommand, canRestartVia(deps), pinSessionNameVia(deps, claudeSessions));
   return {
     report: { ...executed, connectedSessionIds: plan.connectedSessionIds },
     restartsBySession: recordRemoteControlRestarts(restartsBySession, executed, deps.nowMs),
@@ -6698,14 +6773,26 @@ function waitForExitVia(deps) {
 function isSessionRunningVia(deps) {
   return (sessionId) => isSessionRunning(deps.runCommand, deps.paths.claudeSessionRegistryDir, sessionId) !== false;
 }
-function resumeDepsOf(deps) {
+function pinSessionNameVia(deps, claudeSessions) {
+  return (sessionId, shortId) => {
+    const name = resolveSessionName({
+      shortId,
+      customTitle: readCustomTitle(deps.paths.claudeProjectsDir, sessionId),
+      job: readClaudeJob(deps.paths.claudeJobsDir, shortId),
+      registeredName: claudeSessions?.find((session) => session.sessionId === sessionId)?.name
+    });
+    if (name !== void 0) pinClaudeJobName(deps.paths.claudeJobsDir, shortId, name);
+  };
+}
+function resumeDepsOf(deps, claudeSessions) {
   return {
     runCommand: deps.runCommand,
     claudeProjectsDir: deps.paths.claudeProjectsDir,
     nowMs: deps.nowMs,
     canRestartIn: canRestartVia(deps),
     waitForExit: waitForExitVia(deps),
-    isSessionRunning: isSessionRunningVia(deps)
+    isSessionRunning: isSessionRunningVia(deps),
+    pinSessionName: pinSessionNameVia(deps, claudeSessions)
   };
 }
 function runLimitResumePass(claudeSessions, attemptsBySession, maxContinues, deps) {
@@ -6722,7 +6809,7 @@ function runLimitResumePass(claudeSessions, attemptsBySession, maxContinues, dep
     isClaudeUsageLimitInForce(deps.paths.claudeGlobalConfigFile, deps.nowMs),
     maxContinues
   );
-  const executed = executeLimitResumes(planned, attemptsBySession, resumeDepsOf(deps));
+  const executed = executeLimitResumes(planned, attemptsBySession, resumeDepsOf(deps, claudeSessions));
   return { report: { decisions: executed.decisions }, attemptsBySession: executed.attemptsBySession, events: executed.events };
 }
 function reloadTargetAtMs(deps, installs) {
@@ -6787,7 +6874,7 @@ function runTickUnlocked(deps) {
       sessionsById,
       isClaudeUsageLimitInForce(deps.paths.claudeGlobalConfigFile, deps.nowMs)
     );
-    const executed = executeWatcherRecoveries(planned, recoveryAttemptsByOwner, resumeDepsOf(deps));
+    const executed = executeWatcherRecoveries(planned, recoveryAttemptsByOwner, resumeDepsOf(deps, claudeSessions));
     recoveries = executed.recoveries;
     recoveryAttemptsByOwner = executed.attemptsByOwner;
     events.push(...executed.events);

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runCli } from './chunk-FVG7CYB7.js';
+import { runCli } from './chunk-CGKARU5D.js';
 import './chunk-NTEBYUCA.js';
 
 // src/cli/main.ts

package/dist/index.js

@@ -1,2 +1,2 @@
-export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-FVG7CYB7.js';
+export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-CGKARU5D.js';
 export { createChildLogger, e2e_exports as e2e, getConfig, getLocalQaTools, getLogger, getQaTools, local_exports as localQa, mcp_exports as mcp, e2e_exports as qa, src_exports as shared } from './chunk-NTEBYUCA.js';

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.codex-mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.278",
         "serve"
       ],
       "env": {

package/dist/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
   "author": {
     "name": "Muggle AI",

package/dist/plugin/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.278",
         "serve"
       ]
     }

package/dist/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "release": "5.26.0",
-  "buildId": "run-277-1",
-  "commitSha": "fea69b3dd04919c685e56559e6ceba0b6d57129e",
-  "buildTime": "2026-11-01T19:01:29Z",
+  "buildId": "run-278-1",
+  "commitSha": "eb4ff94a05a224818f6e1e2c273fbf00e6b9b76c",
+  "buildTime": "2026-11-01T21:49:32Z",
   "serviceName": "muggle-ai-works-mcp"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@muggleai/works",
   "mcpName": "io.github.multiplex-ai/muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "description": "13 years of Microsoft hyperscale engineering, packaged as a harness for your AI coding agent.",
   "type": "module",
   "main": "dist/index.js",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.codex-mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.278",
         "serve"
       ],
       "env": {

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
   "author": {
     "name": "Muggle AI",

package/plugin/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.278",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.278",
         "serve"
       ]
     }