@skyramp/mcp 0.3.2 → 0.3.4

package/node_modules/playwright/lib/dom-analyzer/blueprint.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var blueprint_exports = {};
 __export(blueprint_exports, {
   BlueprintInvariantError: () => BlueprintInvariantError,
+  DEFAULT_TEST_ID_ATTRIBUTE: () => DEFAULT_TEST_ID_ATTRIBUTE,
   applyPositionHintToNamelessElements: () => applyPositionHintToNamelessElements,
   buildMap: () => buildMap,
   buildOutline: () => buildOutline,
@@ -26,6 +27,7 @@ __export(blueprint_exports, {
   deriveLogicalName: () => deriveLogicalName,
   resolveAccessibleName: () => resolveAccessibleName,
   resolveTemplate: () => resolveTemplate,
+  resolveTestIdAttributes: () => resolveTestIdAttributes,
   resolveXpath: () => resolveXpath,
   validateElement: () => validateElement,
   validateRepeatingElement: () => validateRepeatingElement,
@@ -42,6 +44,13 @@ class BlueprintInvariantError extends Error {
     this.name = "BlueprintInvariantError";
   }
 }
+const DEFAULT_TEST_ID_ATTRIBUTE = "data-testid";
+function resolveTestIdAttributes(configured) {
+  const trimmed = configured?.trim();
+  if (!trimmed || trimmed === DEFAULT_TEST_ID_ATTRIBUTE)
+    return [DEFAULT_TEST_ID_ATTRIBUTE];
+  return [trimmed, DEFAULT_TEST_ID_ATTRIBUTE];
+}
 const CANONICAL_ARIA_ROLES = /* @__PURE__ */ new Set([
   "button",
   "link",
@@ -133,7 +142,16 @@ function xpathLiteralNode(value) {
   }
   return pieces.length === 1 ? pieces[0] : `concat(${pieces.join(", ")})`;
 }
-async function domEvaluationScript() {
+async function domEvaluationScript(options) {
+  const { testIdAttributes } = options;
+  function resolveTestId(el) {
+    for (const attr of testIdAttributes) {
+      const value = el.getAttribute(attr);
+      if (value && value.trim())
+        return { attr, value };
+    }
+    return null;
+  }
   const DESTRUCTIVE_VERBS = /(delete|remove|destroy|submit|send|confirm|place\s*order|checkout|pay|purchase|buy|charge|cancel|close\s*account|deactivate|publish|approve|reject|logout|sign\s*out|save|create|update|add|edit|clear|reset|duplicate|clone|enable|disable|toggle|import|export|upload|download|invite|subscribe|unsubscribe|favorite|unfavorite|follow|unfollow|rename|archive|restore)/i;
   const VIEW_VERBS = /(view|show|open|see|preview|browse|navigate|go\s*to|back|next|previous|search|filter|sort|paginate|expand|collapse|select|choose|display|refresh|reload|close|dismiss|cancel\s*close|copy)/i;
   const SAFE_LANDMARK_DEFAULTS = /* @__PURE__ */ new Set(["navigation", "banner", "footer", "contentinfo"]);
@@ -165,9 +183,9 @@ async function domEvaluationScript() {
       return false;
     }
   }
-  function testIdUnique(testId) {
+  function testIdUnique(attr, testId) {
     try {
-      return document.querySelectorAll(`[data-testid=${CSS.escape(testId)}]`).length === 1;
+      return document.querySelectorAll(`[${attr}=${CSS.escape(testId)}]`).length === 1;
     } catch {
       return false;
     }
@@ -190,9 +208,11 @@ async function domEvaluationScript() {
     return pieces.length === 1 ? pieces[0] : `concat(${pieces.join(", ")})`;
   }
   function getXPath(el) {
-    const testId = el.getAttribute("data-testid");
-    if (testId && testIdUnique(testId))
-      return `//*[@data-testid=${xpathLiteral(testId)}]`;
+    for (const attr of testIdAttributes) {
+      const value = el.getAttribute(attr);
+      if (value && value.trim() && testIdUnique(attr, value))
+        return `//*[@${attr}=${xpathLiteral(value)}]`;
+    }
     if (el.id && idUnique(el.id))
       return `//*[@id=${xpathLiteral(el.id)}]`;
     const parts = [];
@@ -236,30 +256,130 @@ async function domEvaluationScript() {
     "region",
     "form"
   ]);
-  function getAccessibleName(el, role) {
-    const ariaLabel = el.getAttribute("aria-label");
-    if (ariaLabel && ariaLabel.trim())
-      return ariaLabel.trim();
-    const labelledBy = el.getAttribute("aria-labelledby");
-    if (labelledBy) {
-      const names = labelledBy.split(/\s+/).map((id) => document.getElementById(id)?.textContent?.trim()).filter(Boolean);
-      if (names.length)
-        return names.join(" ");
+  function isHiddenForName(el) {
+    if (el.getAttribute("aria-hidden") === "true")
+      return true;
+    const style = el.ownerDocument?.defaultView?.getComputedStyle(el) || null;
+    if (!style)
+      return false;
+    return style.display === "none" || style.visibility === "hidden";
+  }
+  function needsSeparator(el) {
+    if (el.tagName === "BR")
+      return true;
+    const style = el.ownerDocument?.defaultView?.getComputedStyle(el) || null;
+    if (!style)
+      return false;
+    const display = style.display;
+    return display !== "contents" && !display.startsWith("inline");
+  }
+  function embeddedControlValue(el) {
+    const tag = el.tagName;
+    if (tag === "TEXTAREA")
+      return el.value || null;
+    if (tag === "SELECT") {
+      const selected = Array.from(el.selectedOptions);
+      const text = selected.map((o) => o.textContent?.trim() ?? "").filter(Boolean).join(" ");
+      return text || null;
     }
+    if (tag !== "INPUT")
+      return null;
+    const input = el;
+    const type = (input.getAttribute("type") || "text").toLowerCase();
+    if (TEXTUAL_INPUT_TYPES.has(type) || type === "range")
+      return input.value || null;
+    return null;
+  }
+  const TEXTUAL_INPUT_TYPES = /* @__PURE__ */ new Set([
+    "text",
+    "search",
+    "email",
+    "url",
+    "tel",
+    "number"
+  ]);
+  function fallbackLabel(el) {
+    const alt = el.getAttribute("alt")?.trim() || null;
+    const tag = el.tagName;
+    const nativeAlt = tag === "IMG" || tag === "AREA" || tag === "INPUT" && (el.getAttribute("type") || "").toLowerCase() === "image";
+    if (nativeAlt && alt)
+      return alt;
     const title = el.getAttribute("title");
     if (title && title.trim())
       return title.trim();
     const placeholder = el.getAttribute("placeholder");
     if (placeholder && placeholder.trim())
       return placeholder.trim();
-    const alt = el.getAttribute("alt");
-    if (alt && alt.trim())
-      return alt.trim();
-    if (role && NAME_FROM_CONTENT_PROHIBITED.has(role))
+    return alt;
+  }
+  function labelledByName(el, depth) {
+    const labelledBy = el.getAttribute("aria-labelledby");
+    if (!labelledBy || depth > MAX_NAME_DEPTH)
+      return null;
+    const names = [];
+    for (const id of labelledBy.split(/\s+/)) {
+      const ref = id ? document.getElementById(id) : null;
+      if (!ref)
+        continue;
+      const ownLabel = ref.getAttribute("aria-label")?.trim();
+      const name = ownLabel || collapse(contentName(ref, depth + 1, true));
+      if (name)
+        names.push(name);
+    }
+    return names.length ? names.join(" ") : null;
+  }
+  const MAX_NAME_DEPTH = 20;
+  function collapse(text) {
+    return text.trim().replace(/\s+/g, " ");
+  }
+  function contentName(el, depth = 0, includeHidden = false) {
+    if (depth > MAX_NAME_DEPTH)
       return "";
-    const text = el.textContent?.trim().replace(/\s+/g, " ").slice(0, 60);
+    let out = "";
+    for (const node of Array.from(el.childNodes)) {
+      if (node.nodeType === Node.TEXT_NODE) {
+        out += node.nodeValue ?? "";
+        continue;
+      }
+      if (node.nodeType !== Node.ELEMENT_NODE)
+        continue;
+      const child = node;
+      if (!includeHidden && isHiddenForName(child))
+        continue;
+      const separator = needsSeparator(child) ? " " : "";
+      let contribution = embeddedControlValue(child);
+      if (contribution === null) {
+        const childLabelledBy = labelledByName(child, depth + 1);
+        const childAriaLabel = child.getAttribute("aria-label")?.trim();
+        if (childLabelledBy)
+          contribution = childLabelledBy;
+        else if (childAriaLabel)
+          contribution = childAriaLabel;
+      }
+      if (contribution !== null) {
+        out += `${separator} ${contribution} ${separator}`;
+        continue;
+      }
+      const inner = contentName(child, depth + 1, includeHidden);
+      out += inner.trim() ? `${separator}${inner}${separator}` : `${separator} ${fallbackLabel(child) ?? ""} ${separator}`;
+    }
+    return out;
+  }
+  function getAccessibleName(el, role) {
+    const labelledBy = labelledByName(el, 0);
+    if (labelledBy)
+      return labelledBy;
+    const ariaLabel = el.getAttribute("aria-label");
+    if (ariaLabel && ariaLabel.trim())
+      return ariaLabel.trim();
+    if (role && NAME_FROM_CONTENT_PROHIBITED.has(role))
+      return fallbackLabel(el) ?? "";
+    const text = collapse(contentName(el)).slice(0, 60);
     if (text)
       return text;
+    const fallback = fallbackLabel(el);
+    if (fallback)
+      return fallback;
     if (NAMELESS_INTERACTIVE_ICON_ROLES.has(role)) {
       const iconName = findDescendantIconName(el);
       if (iconName)
@@ -503,8 +623,8 @@ async function domEvaluationScript() {
     let depth = 0;
     while (cur && depth < ANCESTOR_ID_MAX_DEPTH) {
       if (isElementVisible(cur)) {
-        const testId = cur.getAttribute("data-testid");
-        if (testId) return testId;
+        const ancestorTestId = resolveTestId(cur);
+        if (ancestorTestId) return ancestorTestId.value;
         const id = cur.getAttribute("id");
         if (id && !isDynamicIdClient(id)) return id;
       }
@@ -722,7 +842,7 @@ async function domEvaluationScript() {
     if (!accessibleName && !LIVE_REGION_ROLES.has(role))
       return null;
     const idAttr = el.getAttribute("id");
-    const testIdAttr = el.getAttribute("data-testid");
+    const resolvedTestId = resolveTestId(el);
     const fingerprint = widgetType === "native" ? null : await computeElementFingerprint(el);
     const stableIdValue = idAttr && idUnique(idAttr) && !isDynamicIdClient(idAttr) ? idAttr : null;
     return {
@@ -734,7 +854,8 @@ async function domEvaluationScript() {
       framePath: computeFramePath(el),
       shadowRoot: hasShadowRootAncestor(el),
       stableId: stableIdValue,
-      testId: testIdAttr || null,
+      testId: resolvedTestId?.value ?? null,
+      testIdAttr: resolvedTestId?.attr ?? null,
       fingerprint,
       visible: isElementVisible(el),
       nearestAncestorId: getNearestAncestorId(el),
@@ -757,10 +878,11 @@ async function domEvaluationScript() {
   const pageHash = `${elements.length}:${hashAccum}`;
   return { elements, pageHash };
 }
-async function buildPageBlueprint(page) {
+async function buildPageBlueprint(page, testIdAttribute) {
+  const testIdAttributes = resolveTestIdAttributes(testIdAttribute);
   const [pageUrl, evalResult] = await Promise.all([
     page.url(),
-    page.evaluate(domEvaluationScript)
+    page.evaluate(domEvaluationScript, { testIdAttributes })
   ]);
   const unknownRoles = /* @__PURE__ */ new Set();
   for (const el of evalResult.elements) {
@@ -977,6 +1099,9 @@ function analyseByVariableName(group, xpathTemplate) {
 function analyseByVaryingTestId(group) {
   if (group.some((el) => !el.testId))
     return null;
+  const testIdAttribute = group[0].testIdAttr;
+  if (!testIdAttribute || group.some((el) => el.testIdAttr !== testIdAttribute))
+    return null;
   const firstName = group[0].accessibleName;
   if (!group.every((el) => el.accessibleName === firstName))
     return null;
@@ -995,7 +1120,7 @@ function analyseByVaryingTestId(group) {
   const firstToken = firstName.toLowerCase().split(/\s+/)[0];
   const slugParamName = guessParamName(firstToken, "") || "itemSlug";
   const testIdPattern = `${commonPrefix}{${slugParamName}}${commonSuffix}`;
-  const xpathBySlug = `//*[@data-testid=${xpathLiteralNode(testIdPattern)}]`;
+  const xpathBySlug = `//*[@${testIdAttribute}=${xpathLiteralNode(testIdPattern)}]`;
   const parameters = [slugParamName];
   const indexParameter = slugParamName;
   const accessibleNameTemplate = firstName;
@@ -1214,6 +1339,7 @@ function buildOutline(blueprint) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BlueprintInvariantError,
+  DEFAULT_TEST_ID_ATTRIBUTE,
   applyPositionHintToNamelessElements,
   buildMap,
   buildOutline,
@@ -1221,6 +1347,7 @@ function buildOutline(blueprint) {
   deriveLogicalName,
   resolveAccessibleName,
   resolveTemplate,
+  resolveTestIdAttributes,
   resolveXpath,
   validateElement,
   validateRepeatingElement,

package/node_modules/playwright/lib/dom-analyzer/crawler.js

@@ -214,7 +214,7 @@ async function crawl(entryUrl, options) {
       }
       let blueprint;
       try {
-        blueprint = await (0, import_blueprint.buildPageBlueprint)(page);
+        blueprint = await (0, import_blueprint.buildPageBlueprint)(page, options.testIdAttribute);
       } catch (err) {
         if (err instanceof import_blueprint.BlueprintInvariantError) {
           console.warn(`[dom-analyzer] Skipping blueprint for ${page.url()} \u2014 invariant violated: ${err.message}`);
@@ -327,7 +327,7 @@ async function crawlSinglePage(entryUrl, options) {
     await page.goto(entryUrl, { waitUntil: "networkidle" });
     let blueprint;
     try {
-      blueprint = await (0, import_blueprint.buildPageBlueprint)(page);
+      blueprint = await (0, import_blueprint.buildPageBlueprint)(page, options.testIdAttribute);
     } catch (err) {
       if (err instanceof import_blueprint.BlueprintInvariantError) {
         console.warn(`[dom-analyzer] Blueprint skipped \u2014 invariant violated: ${err.message}`);

package/node_modules/playwright/lib/mcp/browser/tools/pageBlueprint.js

@@ -67,7 +67,7 @@ const blueprint = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, _params, response) => {
     try {
-      const current = await (0, import_blueprint.buildPageBlueprint)(tab.page);
+      const current = await (0, import_blueprint.buildPageBlueprint)(tab.page, tab.context.config.testIdAttribute);
       const url = current.url;
       const previous = tab.blueprintCache.get(url);
       if (!previous) {

package/node_modules/playwright/lib/mcp/browser/tools/sitemap.js

@@ -119,10 +119,14 @@ Use browser_sitemap_query to read any page. Pass refresh=true to recrawl.`
         maxPages,
         sameOriginOnly,
         probeButtons: probeMode,
-        playwrightStoragePath
+        playwrightStoragePath,
+        testIdAttribute: context.config.testIdAttribute
       });
     } else {
-      sitemap = await (0, import_crawler.crawlSinglePage)(url, { playwrightStoragePath });
+      sitemap = await (0, import_crawler.crawlSinglePage)(url, {
+        playwrightStoragePath,
+        testIdAttribute: context.config.testIdAttribute
+      });
     }
     context.sitemapCache.set(key, { sitemap, storageStateHash, probeButtonsMode: probeMode });
     const pageCount = Object.keys(sitemap.pages).length;

package/node_modules/playwright/lib/mcp/skyramp/loadTraceTool.js

@@ -36,7 +36,8 @@ const loadTraceSchema = {
   name: "skyramp_load_trace",
   title: "Load and replay a Skyramp trace",
   description: [
-    "Load a previously recorded Skyramp trace (.zip or .jsonl/.txt) and replay a range of its actions against the live browser to restore state, then continue recording from that point.",
+    "Load a previously recorded Skyramp trace (.zip or .jsonl/.txt) OR a generated Skyramp test file (.spec.ts/.ts/.js/.py) and replay a range of its actions against the live browser to restore state, then continue recording from that point.",
+    "A test file is a lossy projection of its original trace: the replayable interaction skeleton (navigate/click/fill/press/...) is extracted, while codegen enrichments with no replay primitive (waitForResponse, payload assertions) are skipped and reported. Step numbers refer to the converted steps \u2014 use dryRun to see them.",
     "The replayed actions are merged into the current recording, so subsequent browser_* steps append to them and skyramp_export_zip writes a combined trace. You can record some steps FIRST, then load a trace to insert an already-recorded fragment at the current point.",
     "STARTING LATER (skip a stale prefix): set startAtStep to begin replay partway in, skipping earlier steps. Use this when the live browser is already past the trace's opening steps - e.g. the login page changed, you recorded the NEW login manually, and now want to append only the still-valid post-login part of the old trace. Omit to start from step 1.",
     "- startAtStep: begin replay at step N (1-based, from the numbered step list); steps 1..N-1 are skipped (neither replayed nor recorded).",
@@ -47,7 +48,7 @@ const loadTraceSchema = {
     "If unsure where to start/stop, first call with dryRun:true to read the numbered step list, then call again with the chosen start/stop parameters."
   ].join(" "),
   inputSchema: import_mcpBundle.z.object({
-    path: import_mcpBundle.z.string().describe("Absolute path to the trace file (.zip, .jsonl, or .txt)."),
+    path: import_mcpBundle.z.string().describe("Absolute path to the trace file (.zip, .jsonl, or .txt) or a generated Skyramp test file (.spec.ts, .ts, .js, .py)."),
     startAtStep: import_mcpBundle.z.number().int().positive().optional().describe("Begin replay at step N (1-based); skip steps 1..N-1. Use to skip a stale prefix (e.g. old login)."),
     stopAtStep: import_mcpBundle.z.number().int().positive().optional().describe("Replay up to and including step N (1-based), then stop before continuing."),
     stopAtUrl: import_mcpBundle.z.string().optional().describe("Stop once the active page URL matches this glob/regex/substring."),

package/node_modules/playwright/lib/mcp/skyramp/resultCode.js

@@ -24,9 +24,10 @@ module.exports = __toCommonJS(resultCode_exports);
 function rewriteResultCodeText(text, newCode) {
   if (!text.includes("await page."))
     return null;
-  const fence = text.match(/```(?:js|javascript)\n/);
-  if (fence && fence.index !== void 0) {
-    const codeStart = fence.index + fence[0].length;
+  const JS_FENCE = "```js\n";
+  const fenceIdx = text.indexOf(JS_FENCE);
+  if (fenceIdx >= 0) {
+    const codeStart = fenceIdx + JS_FENCE.length;
     const codeEnd = text.indexOf("\n```", codeStart);
     if (codeEnd >= 0)
       return text.slice(0, codeStart) + newCode + text.slice(codeEnd);

package/node_modules/playwright/lib/mcp/skyramp/skyRampImport.js

@@ -31,11 +31,14 @@ __export(skyRampImport_exports, {
   actionsFromFile: () => actionsFromFile,
   actionsFromPath: () => actionsFromPath,
   actionsFromZip: () => actionsFromZip,
-  parseJsonl: () => parseJsonl
+  parseJsonl: () => parseJsonl,
+  traceSourceFromPath: () => traceSourceFromPath
 });
 module.exports = __toCommonJS(skyRampImport_exports);
 var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
 var import_utils = require("playwright-core/lib/utils");
+var import_specImport = require("./specImport");
 const SKYRAMP_ACTIVITIES_FILE = "skyramp_playwright.txt";
 const ACTION_NAMES = /* @__PURE__ */ new Set([
   "marker",
@@ -101,8 +104,16 @@ async function actionsFromZip(zipPath) {
 function actionsFromFile(jsonlPath) {
   return parseJsonl(import_fs.default.readFileSync(jsonlPath, "utf-8"));
 }
+async function traceSourceFromPath(tracePath) {
+  if (tracePath.endsWith(".zip"))
+    return { actions: await actionsFromZip(tracePath), diagnostics: [] };
+  const specLanguage = (0, import_specImport.specLanguageForPath)(tracePath);
+  if (specLanguage)
+    return (0, import_specImport.specToActions)(import_fs.default.readFileSync(tracePath, "utf-8"), specLanguage, import_path.default.dirname(tracePath));
+  return { actions: actionsFromFile(tracePath), diagnostics: [] };
+}
 async function actionsFromPath(tracePath) {
-  return tracePath.endsWith(".zip") ? await actionsFromZip(tracePath) : actionsFromFile(tracePath);
+  return (await traceSourceFromPath(tracePath)).actions;
 }
 function parseJsonl(content) {
   const result = [];
@@ -143,5 +154,6 @@ function parseLine(line) {
   actionsFromFile,
   actionsFromPath,
   actionsFromZip,
-  parseJsonl
+  parseJsonl,
+  traceSourceFromPath
 });