@skyramp/mcp 0.4.4 → 0.5.0-rc.10

package/node_modules/playwright/lib/mcp/test/skyRampExport.js

@@ -36,6 +36,7 @@ __export(skyRampExport_exports, {
 module.exports = __toCommonJS(skyRampExport_exports);
 var import_crypto = __toESM(require("crypto"));
 var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
 var import_path = __toESM(require("path"));
 var import_zipBundle = require("playwright-core/lib/zipBundle");
 var import_utils = require("playwright-core/lib/utils");
@@ -43,6 +44,12 @@ var import_visualSnapshot = require("../skyramp/common/visualSnapshot");
 var import_snapshotLocators = require("../skyramp/snapshotLocators");
 const DEFAULT_PAGE_ALIAS = "page";
 const DEFAULT_FRAME_PATH = [];
+function actionProvenance(action) {
+  return { actionId: action.actionId, phase: action.phase };
+}
+function derivedActionProvenance(action, suffix) {
+  return { actionId: `${action.actionId}:${suffix}`, phase: action.phase };
+}
 function modifiersArrayToMask(modifiers) {
   if (!modifiers || modifiers.length === 0)
     return 0;
@@ -72,8 +79,9 @@ function jsonlHeader(browserName, harPath, viewport, storageState) {
   });
 }
 function extractLocatorFromCode(code) {
+  code = code.split("\n").filter((line) => !/^\s*await\s+page\.(keyboard|mouse)\./.test(line)).join("\n");
   const extensionFrameMatch = code.match(
-    /await\s+page\.frames\(\)\.find\(\s*f\s*=>\s*f\.url\(\)\.includes\(\s*(['"])([^'"]+)\1\s*\)\s*\)!?\.(.*?)\.(click|dblclick|fill|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s
+    /await\s+page\.frames\(\)\.find\(\s*f\s*=>\s*f\.url\(\)\.includes\(\s*(['"])([^'"]+)\1\s*\)\s*\)!?\.(.*?)\.(click|dblclick|fill|press|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s
   );
   if (extensionFrameMatch) {
     return {
@@ -83,7 +91,7 @@ function extractLocatorFromCode(code) {
     };
   }
   if (code.includes(".contentFrame()")) {
-    const chainMatch = code.match(/await\s+page\.(.+)\.(click|dblclick|fill|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
+    const chainMatch = code.match(/await\s+page\.(.+)\.(click|dblclick|fill|press|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
     if (chainMatch) {
       const segments = chainMatch[1].split(".contentFrame()");
       const framePath = [];
@@ -102,15 +110,15 @@ function extractLocatorFromCode(code) {
       }
     }
   }
-  const contentFrameMatch = code.match(/await\s+page\.locator\((['"])(iframe[^\n]*?)\1\)(?:\.contentFrame\(\))+\.(.*?)\.(click|dblclick|fill|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
+  const contentFrameMatch = code.match(/await\s+page\.locator\((['"])(iframe[^\n]*?)\1\)(?:\.contentFrame\(\))+\.(.*?)\.(click|dblclick|fill|press|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
   if (contentFrameMatch) {
     return { locatorExpr: contentFrameMatch[3].trim(), framePath: [contentFrameMatch[2]] };
   }
-  const chainedIframeMatch = code.match(/await\s+page\.locator\((['"])(iframe[^\n]*?)\1\)\.(get\w+\(.*?)\.(click|dblclick|fill|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
+  const chainedIframeMatch = code.match(/await\s+page\.locator\((['"])(iframe[^\n]*?)\1\)\.(get\w+\(.*?)\.(click|dblclick|fill|press|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
   if (chainedIframeMatch) {
     return { locatorExpr: chainedIframeMatch[3].trim(), framePath: [chainedIframeMatch[2]] };
   }
-  const match = code.match(/await\s+page\.(.*?)\.(click|dblclick|fill|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
+  const match = code.match(/await\s+page\.(.*?)\.(click|dblclick|fill|press|pressSequentially|check|uncheck|selectOption|hover|dragTo|setInputFiles)\s*\(/s);
   if (!match)
     return void 0;
   return { locatorExpr: match[1].trim(), framePath: [] };
@@ -270,6 +278,7 @@ function trackedActionToJsonl(action, pageGuid, timestamp) {
   const pageAlias = action.pageAlias ?? DEFAULT_PAGE_ALIAS;
   const signals = action.popupAlias ? [{ name: "popup", popupAlias: action.popupAlias }] : [];
   const base = {
+    ...actionProvenance(action),
     signals,
     timestamp: String(timestamp),
     pageGuid,
@@ -292,8 +301,20 @@ function trackedActionToJsonl(action, pageGuid, timestamp) {
       return JSON.stringify({ name: "waitForTimeout", duration: Math.min(3e4, time * 1e3), ...base });
     return null;
   }
-  if (toolName === "browser_press_key")
-    return JSON.stringify({ name: "press", key: args.key, modifiers: modifiersArrayToMask(args.modifiers), selector: "", ...base });
+  if (toolName === "browser_press_key") {
+    const extracted2 = extractLocatorFromCode(code);
+    const parsed2 = extracted2 && locatorToJsonl(extracted2.locatorExpr);
+    return JSON.stringify({
+      name: "press",
+      key: args.key,
+      modifiers: modifiersArrayToMask(args.modifiers),
+      selector: parsed2?.selector ?? "",
+      ...parsed2 ? { locator: parsed2.locator } : {},
+      ...base,
+      ...extracted2?.framePath.length ? { framePath: extracted2.framePath } : {},
+      ...extracted2?.frameUrlMatch ? { frameUrlMatch: extracted2.frameUrlMatch } : {}
+    });
+  }
   if (toolName === "browser_mouse_action") {
     if (!args.name)
       return null;
@@ -396,6 +417,7 @@ function gojsAddNodeActionToJsonl(action, pageGuid, timestamp, alias) {
   };
   return JSON.stringify({
     name: "diagramNodeAdd",
+    ...actionProvenance(action),
     ...fields,
     targetIsPalette: false,
     signals: [],
@@ -419,6 +441,7 @@ function gojsLinkActionToJsonl(action, pageGuid, timestamp, alias) {
   };
   return JSON.stringify({
     name: "diagramLinkAdd",
+    ...actionProvenance(action),
     ...fields,
     signals: [],
     timestamp: String(timestamp),
@@ -431,6 +454,7 @@ function assertActionToJsonl(action, pageGuid, timestamp) {
   const { args, code } = action;
   const assertType = args.type;
   const base = {
+    ...actionProvenance(action),
     signals: [],
     timestamp: String(timestamp),
     pageGuid,
@@ -528,6 +552,7 @@ function visualSnapshotActionToJsonl(action, pageGuid, timestamp) {
   if (!args || !args.filename || !String(args.filename).toLowerCase().endsWith(".png"))
     return null;
   const base = {
+    ...actionProvenance(action),
     signals: [],
     timestamp: String(timestamp),
     pageGuid,
@@ -562,12 +587,26 @@ function visualSnapshotActionToJsonl(action, pageGuid, timestamp) {
 }
 function fileUploadActionToJsonl(action, prevClick, pageGuid, timestamp, alias) {
   const paths = action.args.paths || [];
+  const cwd = process.cwd();
+  const fromHome = import_path.default.relative(cwd, import_os.default.homedir());
+  const cwdIsProject = fromHome.split(import_path.default.sep)[0] === ".." || import_path.default.isAbsolute(fromHome);
   const files = paths.map((p) => {
+    if (paths.length === 1 && cwdIsProject) {
+      let real = import_path.default.resolve(p);
+      try {
+        real = import_path.default.join(import_fs.default.realpathSync(import_path.default.dirname(real)), import_path.default.basename(real));
+      } catch {
+      }
+      const fromCwd = import_path.default.relative(cwd, real);
+      if (fromCwd && fromCwd.split(import_path.default.sep)[0] !== ".." && !import_path.default.isAbsolute(fromCwd))
+        return real;
+    }
     const parts = p.split(/[\\/]/);
     return parts[parts.length - 1] || p;
   });
   const code = action.code || "";
   const base = {
+    ...actionProvenance(action),
     signals: [],
     timestamp: String(timestamp),
     pageGuid,
@@ -628,6 +667,7 @@ function assertTableCellActionToJsonl(action, pageGuid, timestamp, alias) {
     return null;
   const line = {
     name: "assertTableCell",
+    ...actionProvenance(action),
     selector,
     text: args.text ?? "",
     isInput: !!args.isInput,
@@ -669,6 +709,7 @@ function fillFormToJsonl(action, pageGuid, baseTimestamp) {
     const locatorObj = parsed?.locator;
     return JSON.stringify({
       name: field.type === "checkbox" || field.type === "radio" ? field.value === "true" ? "check" : "uncheck" : "fill",
+      ...i === 0 ? actionProvenance(action) : derivedActionProvenance(action, `fill-form-${i + 1}`),
       selector: selector || field.ref,
       text: field.value,
       ...locatorObj ? { locator: locatorObj } : {},
@@ -680,8 +721,10 @@ function fillFormToJsonl(action, pageGuid, baseTimestamp) {
     });
   });
 }
-function removeRedundantClicks(actions) {
+function removeRedundantClicks(actions, protectedActionIds) {
   return actions.filter((action, i) => {
+    if (protectedActionIds.has(action.actionId))
+      return true;
     if (action.toolName !== "browser_click")
       return true;
     const prev = actions[i - 1];
@@ -699,7 +742,7 @@ function removeRedundantClicks(actions) {
     return false;
   });
 }
-function deduplicateRetries(actions) {
+function deduplicateRetries(actions, protectedActionIds) {
   const result = [];
   let lastNavIdx = -1;
   for (const action of actions) {
@@ -708,7 +751,7 @@ function deduplicateRetries(actions) {
       continue;
     }
     const url = action.args.url;
-    if (lastNavIdx >= 0 && result[lastNavIdx].args.url === url) {
+    if (lastNavIdx >= 0 && result[lastNavIdx].args.url === url && result[lastNavIdx].phase === action.phase && !result.slice(lastNavIdx).some((prior) => protectedActionIds.has(prior.actionId))) {
       result.length = lastNavIdx;
       lastNavIdx = -1;
       for (let k = result.length - 1; k >= 0; k--) {
@@ -744,15 +787,16 @@ function normalizePrimaryPageAlias(actions) {
   }
 }
 function mouseActionToJsonl(action, pageGuid, baseTs, alias) {
-  const base = {
+  const base = (index) => ({
+    ...index === 0 ? actionProvenance(action) : derivedActionProvenance(action, `mouse-${index + 1}`),
     signals: [],
     pageGuid,
     pageAlias: alias,
     framePath: action.framePath ?? DEFAULT_FRAME_PATH
-  };
-  const move = (x, y, ts) => JSON.stringify({ name: "mouse.move", position: { x, y }, timestamp: String(ts), ...base });
-  const down = (ts) => JSON.stringify({ name: "mouse.down", timestamp: String(ts), ...base });
-  const up = (ts) => JSON.stringify({ name: "mouse.up", timestamp: String(ts), ...base });
+  });
+  const move = (x, y, ts, index = 0) => JSON.stringify({ name: "mouse.move", position: { x, y }, timestamp: String(ts), ...base(index) });
+  const down = (ts, index = 0) => JSON.stringify({ name: "mouse.down", timestamp: String(ts), ...base(index) });
+  const up = (ts, index = 0) => JSON.stringify({ name: "mouse.up", timestamp: String(ts), ...base(index) });
   switch (action.toolName) {
     case "browser_mouse_move_xy":
       return [move(action.args.x, action.args.y, baseTs)];
@@ -761,34 +805,41 @@ function mouseActionToJsonl(action, pageGuid, baseTs, alias) {
     case "browser_mouse_up":
       return [up(baseTs)];
     case "browser_mouse_click_xy":
-      return [move(action.args.x, action.args.y, baseTs), down(baseTs + 1), up(baseTs + 2)];
+      return [move(action.args.x, action.args.y, baseTs), down(baseTs + 1, 1), up(baseTs + 2, 2)];
     case "browser_mouse_drag_xy":
       return [
         move(action.args.startX, action.args.startY, baseTs),
-        down(baseTs + 1),
-        move(action.args.endX, action.args.endY, baseTs + 2),
-        up(baseTs + 3)
+        down(baseTs + 1, 1),
+        move(action.args.endX, action.args.endY, baseTs + 2, 2),
+        up(baseTs + 3, 3)
       ];
     case "browser_mouse_action":
       if (!action.args || !action.args.name)
         return [];
-      return [JSON.stringify({ ...action.args, timestamp: String(baseTs), ...base })];
+      return [JSON.stringify({ ...action.args, timestamp: String(baseTs), ...base(0) })];
     default:
       return [];
   }
 }
-function buildJsonlContent(actions, browserName, harPath, viewport = RECORDING_VIEWPORT, storageState = process.env.PLAYWRIGHT_MCP_STORAGE_STATE?.trim() || void 0) {
+function buildJsonlContent(actions, browserName, harPath, viewport = RECORDING_VIEWPORT, storageState = process.env.PLAYWRIGHT_MCP_STORAGE_STATE?.trim() || void 0, ledgerEntries = []) {
   const simplified = [];
   simplifiedLocators = simplified;
   try {
-    return { ...buildJsonlLines(actions, browserName, harPath, viewport, storageState), simplified };
+    return { ...buildJsonlLines(actions, browserName, harPath, viewport, storageState, ledgerEntries), simplified };
   } finally {
     simplifiedLocators = void 0;
   }
 }
-function buildJsonlLines(actions, browserName, harPath, viewport, storageState) {
+function buildJsonlLines(actions, browserName, harPath, viewport, storageState, ledgerEntries) {
   normalizePrimaryPageAlias(actions);
-  const deduplicated = removeRedundantClicks(deduplicateRetries(actions));
+  const protectedActionIds = new Set(ledgerEntries.flatMap((entry) => entry.sourceActionId ? [entry.sourceActionId] : []));
+  if (ledgerEntries.length) {
+    for (const action of actions) {
+      if (action.phase === "setup")
+        protectedActionIds.add(action.actionId);
+    }
+  }
+  const deduplicated = removeRedundantClicks(deduplicateRetries(actions, protectedActionIds), protectedActionIds);
   const startTime = deduplicated[0]?.timestamp ?? Date.now();
   const pageGuids = /* @__PURE__ */ new Map();
   const getPageGuid = (alias) => {
@@ -799,7 +850,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
   const mainGuid = getPageGuid(DEFAULT_PAGE_ALIAS);
   const lines = [
     jsonlHeader(browserName, harPath, viewport, storageState),
-    JSON.stringify({ name: "openPage", url: "about:blank", signals: [], timestamp: String(startTime - 1e3), pageGuid: mainGuid, pageAlias: DEFAULT_PAGE_ALIAS, framePath: DEFAULT_FRAME_PATH })
+    JSON.stringify({ name: "openPage", actionId: "export:open-page", phase: "setup", url: "about:blank", signals: [], timestamp: String(startTime - 1e3), pageGuid: mainGuid, pageAlias: DEFAULT_PAGE_ALIAS, framePath: DEFAULT_FRAME_PATH })
   ];
   let actionCount = 0;
   const skipped = [];
@@ -811,7 +862,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
     const pageGuid = getPageGuid(alias);
     if (action.popupAlias && !openedAliases.has(action.popupAlias)) {
       const popupGuid = getPageGuid(action.popupAlias);
-      lines.push(JSON.stringify({ name: "openPage", url: "about:blank", signals: [], timestamp: String(action.timestamp), pageGuid: popupGuid, pageAlias: action.popupAlias, framePath: DEFAULT_FRAME_PATH }));
+      lines.push(JSON.stringify({ name: "openPage", ...derivedActionProvenance(action, `open-page-${action.popupAlias}`), url: "about:blank", signals: [], timestamp: String(action.timestamp), pageGuid: popupGuid, pageAlias: action.popupAlias, framePath: DEFAULT_FRAME_PATH }));
       openedAliases.add(action.popupAlias);
     }
     if (alias !== DEFAULT_PAGE_ALIAS && !openedAliases.has(alias)) {
@@ -832,7 +883,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
         }
       }
       const popupGuid = getPageGuid(alias);
-      lines.push(JSON.stringify({ name: "openPage", url: "about:blank", signals: [], timestamp: String(action.timestamp), pageGuid: popupGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
+      lines.push(JSON.stringify({ name: "openPage", ...derivedActionProvenance(action, `open-page-${alias}`), url: "about:blank", signals: [], timestamp: String(action.timestamp), pageGuid: popupGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
       openedAliases.add(alias);
     }
     if ((action.toolName === "browser_type" || action.toolName === "browser_fill") && alias !== DEFAULT_PAGE_ALIAS)
@@ -864,7 +915,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
       continue;
     }
     if (action.toolName === "browser_assert_api_request") {
-      lines.push(JSON.stringify({ name: "assertApiRequest", signals: [], timestamp: String(action.timestamp), pageGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
+      lines.push(JSON.stringify({ name: "assertApiRequest", ...actionProvenance(action), signals: [], timestamp: String(action.timestamp), pageGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
       actionCount++;
       continue;
     }
@@ -930,6 +981,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
           const { selector, locator: locatorObj } = locatorInfo;
           const pressLine = JSON.stringify({
             name: "press",
+            ...derivedActionProvenance(action, "submit"),
             selector,
             key: "Enter",
             locator: locatorObj,
@@ -947,7 +999,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
       continue;
     }
     if (action.toolName === "browser_navigate" && alias === DEFAULT_PAGE_ALIAS && hadPopupFills) {
-      lines.push(JSON.stringify({ name: "waitForTimeout", duration: 3e4, signals: [], timestamp: String(action.timestamp - 1), pageGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
+      lines.push(JSON.stringify({ name: "waitForTimeout", ...derivedActionProvenance(action, "wait-before"), duration: 3e4, signals: [], timestamp: String(action.timestamp - 1), pageGuid, pageAlias: alias, framePath: DEFAULT_FRAME_PATH }));
       actionCount++;
       hadPopupFills = false;
     }
@@ -961,7 +1013,7 @@ function buildJsonlLines(actions, browserName, harPath, viewport, storageState)
     if (action.toolName === "browser_click")
       prevClickByAlias.set(alias, action);
   }
-  lines.push(JSON.stringify({ name: "closePage", signals: [], timestamp: String(Date.now()), pageGuid: mainGuid, pageAlias: DEFAULT_PAGE_ALIAS, framePath: DEFAULT_FRAME_PATH }));
+  lines.push(JSON.stringify({ name: "closePage", actionId: "export:close-page", phase: deduplicated.at(-1)?.phase ?? "setup", signals: [], timestamp: String(Date.now()), pageGuid: mainGuid, pageAlias: DEFAULT_PAGE_ALIAS, framePath: DEFAULT_FRAME_PATH }));
   return { jsonl: lines.join("\n") + "\n", actionCount, skipped };
 }
 const CROSS_PAGE_URL_BLOCKLIST = [
@@ -991,7 +1043,7 @@ function filterHarEntries(harContent) {
     return harContent;
   }
 }
-async function writeSkyrampZip(outputZipPath, jsonlContent, harPath) {
+async function writeSkyrampZip(outputZipPath, jsonlContent, harPath, extraFiles) {
   const zipFile = new import_zipBundle.yazl.ZipFile();
   const done = new import_utils.ManualPromise();
   zipFile.on("error", (e) => done.reject(e));
@@ -1002,6 +1054,8 @@ async function writeSkyrampZip(outputZipPath, jsonlContent, harPath) {
   } else {
     zipFile.addBuffer(Buffer.from('{"log":{"version":"1.2","creator":{"name":"Playwright","version":"1.0"},"entries":[]}}', "utf-8"), "skyramp_network.har");
   }
+  for (const extra of extraFiles ?? [])
+    zipFile.addBuffer(Buffer.from(extra.content, "utf-8"), extra.name);
   zipFile.end();
   await import_fs.default.promises.mkdir(import_path.default.dirname(outputZipPath), { recursive: true });
   zipFile.outputStream.pipe(import_fs.default.createWriteStream(outputZipPath)).on("close", () => done.resolve()).on("error", (e) => done.reject(e));

package/node_modules/playwright/lib/mcp/test/skyRampExport.test.js

@@ -1,8 +1,34 @@
 "use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_crypto = __toESM(require("crypto"));
 var import_vitest = require("vitest");
 var import_skyRampExport = require("./skyRampExport");
+function trackedAction(action, actionId = "action-1", phase = "setup") {
+  return { ...action, actionId, phase };
+}
 function waitForTime(time) {
-  return { toolName: "browser_wait_for", args: { time }, code: "", timestamp: 1e3 };
+  return trackedAction({ toolName: "browser_wait_for", args: { time }, code: "", timestamp: 1e3 });
 }
 function jsonlFor(action) {
   const line = (0, import_skyRampExport.trackedActionToJsonl)(action, "guid-1", 1e3);
@@ -30,13 +56,13 @@ function jsonlFor(action) {
 });
 (0, import_vitest.describe)("browser_wait_for \u2192 text / textGone (unaffected by the clamp)", () => {
   (0, import_vitest.it)("emits waitForSelector for text", () => {
-    const entry = jsonlFor({ toolName: "browser_wait_for", args: { text: "Report.pdf" }, code: "", timestamp: 1e3 });
+    const entry = jsonlFor(trackedAction({ toolName: "browser_wait_for", args: { text: "Report.pdf" }, code: "", timestamp: 1e3 }));
     (0, import_vitest.expect)(entry.name).toBe("waitForSelector");
     (0, import_vitest.expect)(entry.selector).toBe("text=Report.pdf");
     (0, import_vitest.expect)(entry.duration).toBeUndefined();
   });
   (0, import_vitest.it)("emits hidden-state waitForSelector for textGone", () => {
-    const entry = jsonlFor({ toolName: "browser_wait_for", args: { textGone: "Loading" }, code: "", timestamp: 1e3 });
+    const entry = jsonlFor(trackedAction({ toolName: "browser_wait_for", args: { textGone: "Loading" }, code: "", timestamp: 1e3 }));
     (0, import_vitest.expect)(entry.name).toBe("waitForSelector");
     (0, import_vitest.expect)(entry.selector).toBe("text=Loading");
     (0, import_vitest.expect)(entry.state).toBe("hidden");
@@ -44,13 +70,13 @@ function jsonlFor(action) {
 });
 (0, import_vitest.describe)("browser_type \u2192 isPassword flag", () => {
   function typeAction(extra = {}) {
-    return {
+    return trackedAction({
       toolName: "browser_type",
       args: { text: "s3cret" },
       code: `await page.locator('#login-password').fill('s3cret');`,
       timestamp: 1e3,
       ...extra
-    };
+    });
   }
   (0, import_vitest.it)("marks a fill correlated to a password input", () => {
     const entry = jsonlFor(typeAction({ isPassword: true }));
@@ -72,3 +98,104 @@ function jsonlFor(action) {
     (0, import_vitest.expect)(entry.isPassword).toBe(true);
   });
 });
+(0, import_vitest.describe)("export action provenance", () => {
+  function retryActions() {
+    return ["setup", "scenario"].flatMap((phase) => [
+      { toolName: "browser_navigate", args: { url: "https://example.com" }, code: "" },
+      { toolName: "browser_click", args: { ref: "e1" }, code: `await page.getByLabel('Name').click();` },
+      { toolName: "browser_type", args: { ref: "e1", text: "first" }, code: `await page.getByLabel('Name').fill('first');` },
+      { toolName: "browser_navigate", args: { url: "https://example.com" }, code: "" },
+      { toolName: "browser_click", args: { ref: "e1" }, code: `await page.getByLabel('Name').click();` },
+      { toolName: "browser_type", args: { ref: "e1", text: "second" }, code: `await page.getByLabel('Name').fill('second');` }
+    ].map((action) => ({ ...action, phase }))).map((action, index) => ({ ...action, actionId: `action-${index + 1}`, timestamp: 1e3 + index }));
+  }
+  (0, import_vitest.it)("retains setup and resource source actions through retry and click pruning with a non-empty ledger", () => {
+    const ledger = ["action-8", "action-11"].map((sourceActionId, index) => ({
+      entityUrl: `https://example.com/items/${index}`,
+      id: String(index),
+      method: "POST",
+      createdAt: 1e3,
+      deleteEndpoint: `https://example.com/items/${index}`,
+      phase: "scenario",
+      sourceActionId
+    }));
+    const { jsonl } = (0, import_skyRampExport.buildJsonlContent)(retryActions(), "chromium", "/tmp/test.har", void 0, "", ledger);
+    const entries = jsonl.trim().split("\n").slice(1).map((line) => JSON.parse(line));
+    const ids = entries.map((entry) => entry.actionId);
+    (0, import_vitest.expect)(ids).toEqual(import_vitest.expect.arrayContaining(["action-1", "action-2", "action-3", "action-4", "action-5", "action-6"]));
+    for (const entry of ledger)
+      (0, import_vitest.expect)(entries.find((action) => action.actionId === entry.sourceActionId)).toMatchObject({ phase: "scenario", name: "click" });
+  });
+  for (const ledger of [void 0, []]) {
+    (0, import_vitest.it)(`keeps byte-for-byte legacy retry and click pruning with ${ledger ? "zero ledger entries" : "no ledger"}`, () => {
+      import_vitest.vi.spyOn(Date, "now").mockReturnValue(9e3);
+      import_vitest.vi.spyOn(import_crypto.default, "randomBytes").mockReturnValue(Buffer.alloc(16));
+      try {
+        const { jsonl } = (0, import_skyRampExport.buildJsonlContent)(retryActions(), "chromium", "/tmp/test.har", void 0, "", ledger);
+        (0, import_vitest.expect)(jsonl).toMatchInlineSnapshot(`
+          "{"browserName":"chromium","launchOptions":{"headless":false},"contextOptions":{"viewport":{"width":1280,"height":900},"ignoreHTTPSErrors":true,"recordHar":{"path":"/tmp/test.har","mode":"minimal"},"serviceWorkers":"block"},"generateAutoExpect":false}
+          {"name":"openPage","actionId":"export:open-page","phase":"setup","url":"about:blank","signals":[],"timestamp":"3","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          {"name":"navigate","url":"https://example.com","actionId":"action-4","phase":"setup","signals":[],"timestamp":"1003","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          {"name":"fill","selector":"internal:label=\\"Name\\"i","text":"second","locator":{"kind":"label","body":"Name","options":{"exact":false}},"actionId":"action-6","phase":"setup","signals":[],"timestamp":"1005","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          {"name":"navigate","url":"https://example.com","actionId":"action-10","phase":"scenario","signals":[],"timestamp":"1009","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          {"name":"fill","selector":"internal:label=\\"Name\\"i","text":"second","locator":{"kind":"label","body":"Name","options":{"exact":false}},"actionId":"action-12","phase":"scenario","signals":[],"timestamp":"1011","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          {"name":"closePage","actionId":"export:close-page","phase":"scenario","signals":[],"timestamp":"9000","pageGuid":"page@00000000000000000000000000000000","pageAlias":"page","framePath":[]}
+          "
+        `);
+      } finally {
+        import_vitest.vi.restoreAllMocks();
+      }
+    });
+  }
+  (0, import_vitest.it)("keeps setup actions when the same navigation is repeated in the scenario phase", () => {
+    const actions = [
+      trackedAction({ toolName: "browser_navigate", args: { url: "https://example.com" }, code: "", timestamp: 1e3 }, "action-1", "setup"),
+      trackedAction({ toolName: "browser_click", args: { ref: "e1" }, code: `await page.getByRole('button', { name: 'Setup' }).click();`, timestamp: 1100 }, "action-2", "setup"),
+      trackedAction({ toolName: "browser_navigate", args: { url: "https://example.com" }, code: "", timestamp: 1200 }, "action-3", "scenario")
+    ];
+    const entries = (0, import_skyRampExport.buildJsonlContent)(actions, "chromium", "/tmp/test.har").jsonl.trim().split("\n").slice(1).map((line) => JSON.parse(line));
+    (0, import_vitest.expect)(entries.filter((entry) => entry.name === "navigate").map((entry) => entry.actionId)).toEqual(["action-1", "action-3"]);
+    (0, import_vitest.expect)(entries.find((entry) => entry.name === "click")).toMatchObject({ actionId: "action-2", phase: "setup" });
+  });
+  (0, import_vitest.it)("gives compound form and submit sub-actions distinct provenance", () => {
+    const actions = [
+      trackedAction({
+        toolName: "browser_fill_form",
+        args: { fields: [
+          { name: "First name", type: "textbox", ref: "e1", value: "Ada" },
+          { name: "Last name", type: "textbox", ref: "e2", value: "Lovelace" }
+        ] },
+        code: "",
+        timestamp: 1e3
+      }, "action-1", "setup"),
+      trackedAction({
+        toolName: "browser_type",
+        args: { text: "search", submit: true },
+        code: `await page.getByRole('textbox', { name: 'Search' }).fill('search');`,
+        timestamp: 2e3
+      }, "action-2", "scenario")
+    ];
+    const entries = (0, import_skyRampExport.buildJsonlContent)(actions, "chromium", "/tmp/test.har").jsonl.trim().split("\n").slice(1).map((line) => JSON.parse(line));
+    const compound = entries.filter((entry) => ["fill", "press"].includes(entry.name));
+    (0, import_vitest.expect)(new Set(compound.map((entry) => entry.actionId))).toHaveLength(compound.length);
+    (0, import_vitest.expect)(compound.map((entry) => entry.phase)).toEqual(["setup", "setup", "scenario", "scenario"]);
+  });
+  (0, import_vitest.it)("adds unique provenance to every emitted action, including exporter-synthesized actions", () => {
+    const actions = [
+      trackedAction({ toolName: "browser_navigate", args: { url: "https://example.com/start" }, code: "", timestamp: 1e3 }, "action-1", "setup"),
+      trackedAction({
+        toolName: "browser_type",
+        args: { text: "note" },
+        code: `await page.getByRole('textbox', { name: 'Note' }).fill('note');`,
+        timestamp: 2e3,
+        pageAlias: "popupPage"
+      }, "action-2", "setup"),
+      trackedAction({ toolName: "browser_navigate", args: { url: "https://example.com/done" }, code: "", timestamp: 3e3 }, "action-3", "scenario")
+    ];
+    const entries = (0, import_skyRampExport.buildJsonlContent)(actions, "chromium", "/tmp/test.har").jsonl.trim().split("\n").slice(1).map((line) => JSON.parse(line));
+    (0, import_vitest.expect)(entries.map((entry) => entry.name)).toEqual(["openPage", "navigate", "openPage", "fill", "waitForTimeout", "navigate", "closePage"]);
+    for (const entry of entries)
+      (0, import_vitest.expect)(entry).toMatchObject({ actionId: import_vitest.expect.any(String), phase: import_vitest.expect.stringMatching(/^(setup|scenario)$/) });
+    (0, import_vitest.expect)(new Set(entries.map((entry) => entry.actionId))).toHaveLength(entries.length);
+  });
+});

package/node_modules/playwright/node_modules/playwright-core/lib/cli/program.js

@@ -384,6 +384,8 @@ async function launchContext(options, extraOptions) {
     contextOptions.recordHar = { path: import_path.default.resolve(process.cwd(), options.saveHar), mode: "minimal" };
     if (options.saveHarGlob)
       contextOptions.recordHar.urlFilter = options.saveHarGlob;
+    if (options.target === "jsonl")
+      contextOptions.recordHar.frameRef = true;
     contextOptions.serviceWorkers = "block";
   }
   let browser;

package/node_modules/playwright/node_modules/playwright-core/lib/client/browserContext.js

@@ -161,7 +161,8 @@ class BrowserContext extends import_channelOwner.ChannelOwner {
     await this._recordIntoHAR(recordHar.path, null, {
       url: recordHar.urlFilter,
       updateContent: recordHar.content ?? (recordHar.omitContent ? "omit" : defaultContent),
-      updateMode: recordHar.mode ?? "full"
+      updateMode: recordHar.mode ?? "full",
+      frameRef: recordHar.frameRef
     });
   }
   _onPage(page) {
@@ -338,7 +339,8 @@ class BrowserContext extends import_channelOwner.ChannelOwner {
         urlGlob: (0, import_rtti.isString)(options.url) ? options.url : void 0,
         urlRegexSource: (0, import_rtti.isRegExp)(options.url) ? options.url.source : void 0,
         urlRegexFlags: (0, import_rtti.isRegExp)(options.url) ? options.url.flags : void 0,
-        mode: options.updateMode ?? "minimal"
+        mode: options.updateMode ?? "minimal",
+        frameRef: options.frameRef
       }
     });
     this._harRecorders.set(harId, { path: har, content: options.updateContent ?? "attach" });