@muggleai/works 5.19.0-staging.131 → 5.19.0-staging.132

package/README.md

@@ -247,11 +247,11 @@ so the result carries a viewUrl straight to the dashboard
 ├── oauth-session.json    # OAuth tokens (short-lived, auto-refresh)
 ├── api-key.json          # Long-lived key for service calls
 ├── projects/             # Local project cache
-├── sessions/             # Run sessions
+├── sessions/             # Run sessions — read one with `muggle run-view [runId]`
 │   └── {runId}/
-│       ├── action-script.json    # Recorded browser steps
-│       ├── results.md            # Step-by-step report
-│       └── screenshots/          # Per-step images
+│       ├── action-script.json            # Recorded browser steps
+│       ├── results.md                    # Step-by-step report
+│       └── electron-runtime/screenshot/  # Per-step images
 ├── muggle-do/sessions/   # Cycle state, iterations, PR watchers
 └── electron-app/{version}/
 ```
@@ -260,7 +260,7 @@ so the result carries a viewUrl straight to the dashboard
 
 ## MCP tool reference
 
-106 tools across authentication, projects, use cases, test cases, scripts, workflows, local execution, reporting, secrets, billing, and administration. Call them directly from any MCP client to build your own pipeline.
+108 tools across authentication, projects, use cases, test cases, scripts, workflows, local execution, reporting, secrets, billing, and administration. Call them directly from any MCP client to build your own pipeline.
 
 **Authentication** — `muggle-remote-auth-status`, `-login`, `-poll`, `-logout`, plus `-api-key-create`, `-list`, `-get`, `-revoke`.
 
@@ -308,6 +308,7 @@ Bulk-preview submissions return a `jobId` immediately. Poll `muggle-remote-bulk-
 | `muggle-local-execute-replay` | Replay an existing script |
 | `muggle-local-cancel-execution` | Cancel the active run |
 | `muggle-local-run-result-list` / `-get` | Results, screenshots, and cloud refs (`viewUrl`) |
+| `muggle-local-run-steps-get` | A run's ordered steps beside the frame each produced |
 | `muggle-local-test-script-list` / `-get` | Read locally cached scripts |
 | `muggle-local-last-host-*` / `-last-project-*` | Remember the host and project between runs |
 | `muggle-local-preferences-set` | Set harness preferences |
@@ -335,6 +336,11 @@ muggle versions               # List installed runner versions
 muggle cleanup [--dry-run]    # Remove old versions and obsolete skills
 muggle doctor                 # Diagnose installation problems
 
+# Inspecting runs
+muggle run-view [runId]       # A run's steps beside the frames they produced (newest run by default)
+muggle run-view --html        # Render those frames as a self-contained page
+muggle run-view --open        # Render it and open it in the browser
+
 # Authentication
 muggle login [--key-expiry 90d]
 muggle logout

package/dist/{chunk-ODEPI25T.js → chunk-H2KMRAQZ.js}

@@ -1,4 +1,4 @@
-import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, toolRequiresAuth, getCallerCredentials, hasShownDisclosure, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require, getDisclosureCopy, buildOnboardingPlan, applyOnboardingAnswers, needsOnboarding, OnboardingBlanketChoice, PreferenceKey } from './chunk-U6ZACW6K.js';
+import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, toolRequiresAuth, getCallerCredentials, hasShownDisclosure, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require, getDisclosureCopy, buildOnboardingPlan, applyOnboardingAnswers, needsOnboarding, readRunView, RunViewError, renderRunViewText, writeRunViewHtml, openBrowserUrl, OnboardingBlanketChoice, PreferenceKey } from './chunk-ZA5KHVX5.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -8,7 +8,7 @@ import * as fs from 'fs';
 import { readFileSync, existsSync, rmSync, mkdirSync, readdirSync, createWriteStream, writeFileSync, statSync } from 'fs';
 import * as path from 'path';
 import { dirname, resolve, join } from 'path';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 import { Command } from 'commander';
 import axios from 'axios';
 import { platform, homedir, arch } from 'os';
@@ -754,7 +754,7 @@ async function resolveGsScreenshotUrls(report, opts) {
     if (gsUrls.length === 0) {
       return report;
     }
-    const mcps = await import('./src-C2IZ3MAZ.js');
+    const mcps = await import('./src-RU5QOCXE.js');
     const credentials = await mcps.getCallerCredentialsAsync();
     if (!credentials.bearerToken && !credentials.apiKey) {
       stderrWrite(
@@ -807,7 +807,7 @@ var withSentinel = (s) => s ? `${REPORT_SECTION_SENTINEL}
 ${s}` : s;
 async function resolveDashboardBaseUrl(stderrWrite) {
   try {
-    const mcps = await import('./src-C2IZ3MAZ.js');
+    const mcps = await import('./src-RU5QOCXE.js');
     return mcps.resolveActiveProfile().dashboardBaseUrl;
   } catch (err) {
     stderrWrite(
@@ -1619,6 +1619,10 @@ function getHelpGuidance() {
     `    ${cmd("muggle upgrade")}          Check for updates`,
     `    ${cmd("muggle upgrade --check")}  Check updates without installing`,
     "",
+    `  ${colorize("Inspecting Runs:", COLORS.bold)}`,
+    `    ${cmd("muggle run-view")}         Show a run's steps beside the frames they produced`,
+    `    ${cmd("muggle run-view --html")}  Render those frames as a self-contained page`,
+    "",
     `  ${colorize("Authentication:", COLORS.bold)}`,
     `    ${cmd("muggle login")}            Login to Muggle AI`,
     `    ${cmd("muggle logout")}           Clear stored credentials`,
@@ -1654,7 +1658,7 @@ function getHelpGuidance() {
     "",
     `  ${colorize("Local E2E tools:", COLORS.bold)} (prefix: muggle-local-)`,
     "    muggle-local-execute-test-generation, muggle-local-execute-replay,",
-    "    muggle-local-run-result-get, muggle-local-check-status, etc.",
+    "    muggle-local-run-result-get, muggle-local-run-steps-get, muggle-local-check-status, etc.",
     "",
     header("Data Directory"),
     "",
@@ -1662,7 +1666,7 @@ function getHelpGuidance() {
     "",
     `    ${path3("api-key.json")}         Long-lived API key (auto-generated)`,
     `    ${path3("projects/")}            Local test projects`,
-    `    ${path3("sessions/")}            Test execution sessions`,
+    `    ${path3("sessions/")}            Test execution sessions (read one with ${cmd("muggle run-view")})`,
     `    ${path3("electron-app/")}        Downloaded Electron app binaries`,
     "",
     header("Troubleshooting"),
@@ -2132,6 +2136,33 @@ async function prWalkthroughCheckCommand(flags) {
 `);
   process.exitCode = judgment.exitCode;
 }
+async function runViewCommand(runId, options = {}) {
+  let runView;
+  try {
+    runView = readRunView(runId);
+  } catch (error) {
+    if (error instanceof RunViewError) {
+      console.error(error.message);
+      process.exitCode = 1;
+      return;
+    }
+    throw error;
+  }
+  if (!options.html && !options.open) {
+    console.log(renderRunViewText(runView, { includeHtmlOffer: true }));
+    return;
+  }
+  const htmlPath = writeRunViewHtml(runView, options.outDir);
+  console.log(renderRunViewText(runView, { includeHtmlOffer: false }));
+  console.log(`
+Wrote ${htmlPath}`);
+  if (options.open) {
+    const opened = await openBrowserUrl({ url: pathToFileURL(htmlPath).href });
+    if (!opened.opened) {
+      console.log("Could not open a browser automatically \u2014 open the file above.");
+    }
+  }
+}
 
 // src/cli/disclosure/disclosure-constants.ts
 var DISCLOSURE_OPT_OUT_MARKER = "To opt out,";
@@ -2918,6 +2949,7 @@ function createProgram() {
   program.command("logout").description("Clear stored credentials").action(logoutCommand);
   program.command("status").description("Show authentication status").action(statusCommand);
   program.command("build-pr-section").description("Render a muggle-do PR body evidence block from an e2e report on stdin").option("--max-body-bytes <n>", "Max UTF-8 byte budget for the PR body (default 60000)").action(buildPrSectionCommand);
+  program.command("run-view").argument("[runId]", "Run id, or a unique prefix of one (default: the newest run)").description("Show a local run's steps beside the frames they produced").option("--html", "Render a self-contained HTML page instead of terminal text").option("--open", "Open the rendered page in the default browser (implies --html)").option("--out-dir <dir>", "Directory to write the page into (default: current directory)").action(runViewCommand);
   program.command("pr-walkthrough-check").description("Check that a PR's Muggle AI walkthrough comment carries a result or a stated skip").option("--repo <owner/repo>", "Repository (default: $GITHUB_REPOSITORY)").option("--pr <number>", "Pull request number (default: the Actions event payload)").option("--head-sha <sha>", "Commit the check run attaches to (default: the PR head)").option("--check-run", "Publish the verdict as a check run instead of failing the process").action(prWalkthroughCheckCommand);
   program.command("ci-install").description("Add the Muggle walkthrough check to this repository's GitHub Actions").option("--force", "Replace an existing workflow file").action(ciInstallCommand);
   program.action(() => {