@canaryai/cli 0.2.7 → 0.2.8

package/dist/{chunk-RL5Y6V3C.js → chunk-FK3EZADZ.js}

@@ -119,7 +119,7 @@ var require_omggif = __commonJS({
         var min_code_size = 0;
         while (num_colors >>= 1) ++min_code_size;
         num_colors = 1 << min_code_size;
-        var delay = opts.delay === void 0 ? 0 : opts.delay;
+        var delay2 = opts.delay === void 0 ? 0 : opts.delay;
         var disposal = opts.disposal === void 0 ? 0 : opts.disposal;
         if (disposal < 0 || disposal > 3)
           throw new Error("Disposal out of range.");
@@ -131,13 +131,13 @@ var require_omggif = __commonJS({
           if (transparent_index < 0 || transparent_index >= num_colors)
             throw new Error("Transparent color index.");
         }
-        if (disposal !== 0 || use_transparency || delay !== 0) {
+        if (disposal !== 0 || use_transparency || delay2 !== 0) {
           buf[p++] = 33;
           buf[p++] = 249;
           buf[p++] = 4;
           buf[p++] = disposal << 2 | (use_transparency === true ? 1 : 0);
-          buf[p++] = delay & 255;
-          buf[p++] = delay >> 8 & 255;
+          buf[p++] = delay2 & 255;
+          buf[p++] = delay2 >> 8 & 255;
           buf[p++] = transparent_index;
           buf[p++] = 0;
         }
@@ -279,7 +279,7 @@ var require_omggif = __commonJS({
       }
       var no_eof = true;
       var frames = [];
-      var delay = 0;
+      var delay2 = 0;
       var transparent_index = null;
       var disposal = 0;
       var loop_count = null;
@@ -311,7 +311,7 @@ var require_omggif = __commonJS({
                 if (buf[p++] !== 4 || buf[p + 4] !== 0)
                   throw new Error("Invalid graphics extension block.");
                 var pf1 = buf[p++];
-                delay = buf[p++] | buf[p++] << 8;
+                delay2 = buf[p++] | buf[p++] << 8;
                 transparent_index = buf[p++];
                 if ((pf1 & 1) === 0) transparent_index = null;
                 disposal = pf1 >> 2 & 7;
@@ -370,7 +370,7 @@ var require_omggif = __commonJS({
               data_length: p - data_offset,
               transparent_index,
               interlaced: !!interlace_flag,
-              delay,
+              delay: delay2,
               disposal
             });
             break;
@@ -3777,7 +3777,7 @@ var require_gifframe = __commonJS({
 var require_gifutil = __commonJS({
   "../../node_modules/.bun/gifwrap@0.10.1/node_modules/gifwrap/src/gifutil.js"(exports2) {
     "use strict";
-    var fs4 = __require("fs");
+    var fs5 = __require("fs");
     var ImageQ = require_image_q();
     var BitmapImage2 = require_bitmapimage();
     var { GifFrame: GifFrame2 } = require_gifframe();
@@ -3892,14 +3892,14 @@ var require_gifutil = __commonJS({
       jimpImage.bitmap.data = bitmapImageToShare.bitmap.data;
       return jimpImage;
     };
-    exports2.write = function(path4, frames, spec, encoder) {
+    exports2.write = function(path5, frames, spec, encoder) {
       encoder = encoder || defaultCodec;
-      const matches = path4.match(/\.[a-zA-Z]+$/);
+      const matches = path5.match(/\.[a-zA-Z]+$/);
       if (matches !== null && INVALID_SUFFIXES.includes(matches[0].toLowerCase())) {
-        throw new Error(`GIF '${path4}' has an unexpected suffix`);
+        throw new Error(`GIF '${path5}' has an unexpected suffix`);
       }
       return encoder.encodeGif(frames, spec).then((gif2) => {
-        return _writeBinary(path4, gif2.buffer).then(() => {
+        return _writeBinary(path5, gif2.buffer).then(() => {
           return gif2;
         });
       });
@@ -3971,9 +3971,9 @@ var require_gifutil = __commonJS({
         }
       }
     }
-    function _readBinary(path4) {
+    function _readBinary(path5) {
       return new Promise((resolve2, reject2) => {
-        fs4.readFile(path4, (err, buffer) => {
+        fs5.readFile(path5, (err, buffer) => {
           if (err) {
             return reject2(err);
           }
@@ -3981,9 +3981,9 @@ var require_gifutil = __commonJS({
         });
       });
     }
-    function _writeBinary(path4, buffer) {
+    function _writeBinary(path5, buffer) {
       return new Promise((resolve2, reject2) => {
-        fs4.writeFile(path4, buffer, (err) => {
+        fs5.writeFile(path5, buffer, (err) => {
           if (err) {
             return reject2(err);
           }
@@ -5964,9 +5964,9 @@ var require_decoder = __commonJS({
         return a < 0 ? 0 : a > 255 ? 255 : a;
       }
       constructor.prototype = {
-        load: function load(path4) {
+        load: function load(path5) {
           var xhr = new XMLHttpRequest();
-          xhr.open("GET", path4, true);
+          xhr.open("GET", path5, true);
           xhr.responseType = "arraybuffer";
           xhr.onload = (function() {
             var data = new Uint8Array(xhr.response || xhr.mozResponseArrayBuffer);
@@ -18862,11 +18862,11 @@ var require_Mime = __commonJS({
         }
       }
     };
-    Mime.prototype.getType = function(path4) {
-      path4 = String(path4);
-      let last = path4.replace(/^.*[/\\]/, "").toLowerCase();
+    Mime.prototype.getType = function(path5) {
+      path5 = String(path5);
+      let last = path5.replace(/^.*[/\\]/, "").toLowerCase();
       let ext = last.replace(/^.*\./, "").toLowerCase();
-      let hasPath = last.length < path4.length;
+      let hasPath = last.length < path5.length;
       let hasDot = ext.length < last.length - 1;
       return (hasDot || !hasPath) && this._types[ext] || null;
     };
@@ -32623,9 +32623,9 @@ function createJimp({ plugins: pluginsArg, formats: formatsArg } = {}) {
      * await image.write("test/output.png");
      * ```
      */
-    async write(path4, options) {
-      const mimeType = import_lite.default.getType(path4);
-      await writeFile(path4, await this.getBuffer(mimeType, options));
+    async write(path5, options) {
+      const mimeType = import_lite.default.getType(path5);
+      await writeFile(path5, await this.getBuffer(mimeType, options));
     }
     /**
      * Clone the image into a new Jimp instance.
@@ -38485,6 +38485,27 @@ function resolveContainerFieldLabel(container) {
   }
   return void 0;
 }
+function shouldDropInheritedFieldLabel(element, inheritedFieldLabel) {
+  if (!inheritedFieldLabel) return false;
+  if (INTERACTIVE_LEAF_ROLES.has(element.role)) return false;
+  if (!isClickableByAttribute(element)) return false;
+  const directText = getElementText(element);
+  if (directText) {
+    return directText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
+  }
+  const childTexts = [];
+  for (const child of element.children) {
+    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+      const text = getElementText(child);
+      if (text && TEXT_CARRYING_ROLES.has(child.role)) {
+        childTexts.push(text);
+      }
+    }
+  }
+  const composedText = childTexts.join(" ");
+  if (!composedText) return false;
+  return composedText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
+}
 var TEXT_CARRYING_ROLES = /* @__PURE__ */ new Set([
   "generic",
   "paragraph",
@@ -38571,10 +38592,10 @@ function extractDataValue(text) {
 }
 function findRelevanceScope(elements, activeElementRef) {
   if (!activeElementRef) return null;
-  const path4 = [];
+  const path5 = [];
   function findPath(el) {
     if (el.ref) {
-      path4.push({ ref: el.ref, role: el.role });
+      path5.push({ ref: el.ref, role: el.role });
     }
     if (el.ref === activeElementRef) {
       return true;
@@ -38582,15 +38603,15 @@ function findRelevanceScope(elements, activeElementRef) {
     for (const child of el.children) {
       if (findPath(child)) return true;
     }
-    if (el.ref) path4.pop();
+    if (el.ref) path5.pop();
     return false;
   }
   for (const el of elements) {
     if (findPath(el)) break;
   }
-  for (let i = path4.length - 1; i >= 0; i--) {
-    if (SECTION_BOUNDARY_ROLES.has(path4[i].role)) {
-      return path4[i].ref;
+  for (let i = path5.length - 1; i >= 0; i--) {
+    if (SECTION_BOUNDARY_ROLES.has(path5[i].role)) {
+      return path5[i].ref;
     }
   }
   return null;
@@ -38639,9 +38660,9 @@ function searchElements(elements, searchTerms, scopeRef = null) {
 function findElementInSections(sections, targetRef, ancestors = []) {
   for (const section of sections) {
     const newAncestors = [...ancestors, section];
-    const path4 = newAncestors.map((s) => s.heading);
+    const path5 = newAncestors.map((s) => s.heading);
     if (section.elements.some((el) => el.ref === targetRef)) {
-      return { section, ancestors: newAncestors, path: path4 };
+      return { section, ancestors: newAncestors, path: path5 };
     }
     const found = findElementInSections(section.subsections, targetRef, newAncestors);
     if (found) return found;
@@ -38652,7 +38673,7 @@ function populateSearchContext(matches, sections) {
   for (const match of matches) {
     const result = findElementInSections(sections, match.ref);
     if (result) {
-      const { section, ancestors, path: path4 } = result;
+      const { section, ancestors, path: path5 } = result;
       const inFocusedDialog = ancestors.some((s) => s.isFocused);
       const inBackground = section.isBackground || ancestors.some((s) => s.isBackground);
       if (inFocusedDialog) {
@@ -38663,7 +38684,7 @@ function populateSearchContext(matches, sections) {
         match.context = "foreground";
       }
       const SKIP_HEADINGS = ["generic", "main", "iframe"];
-      match.sectionPath = path4.filter((p) => !SKIP_HEADINGS.includes(p.toLowerCase())).slice(-3).join(" > ");
+      match.sectionPath = path5.filter((p) => !SKIP_HEADINGS.includes(p.toLowerCase())).slice(-3).join(" > ");
     }
   }
 }
@@ -38825,6 +38846,24 @@ function findPrimaryColumnLabel(columnHeader) {
   };
   return search(columnHeader);
 }
+function isWidgetTable(element) {
+  if (element.role !== "table") return false;
+  const rows = element.children.filter((c2) => c2.role === "row");
+  if (rows.length === 0 || rows.length > 2) return false;
+  let totalCells = 0;
+  let interactiveCells = 0;
+  for (const row of rows) {
+    for (const cell of row.children) {
+      if (cell.role === "cell" || cell.role === "gridcell" || cell.role === "columnheader") {
+        totalCells++;
+        if (hasInteractiveDescendants(cell)) {
+          interactiveCells++;
+        }
+      }
+    }
+  }
+  return totalCells > 0 && interactiveCells >= totalCells * 0.5;
+}
 function detectGrid(element) {
   if (element.role !== "grid" && element.role !== "treegrid" && element.role !== "table") {
     return null;
@@ -39150,7 +39189,7 @@ function formatElement(element, options) {
   const textSource = normalizeIconLabelText(element.role, rawTextSource);
   const extracted = extractDataValue(textSource);
   const normalizedAttributes = Object.entries(element.attributes).filter(
-    ([key]) => key !== "ref" && key !== "cursor" && key !== "aria-controls" && key !== "aria-owns" && key !== "options"
+    ([key]) => key !== "ref" && key !== "cursor" && key !== "aria-controls" && key !== "aria-owns" && key !== "options" && key !== "field"
   ).map(([key, val]) => {
     if (key === "aria-haspopup") return "haspopup";
     if (key === "aria-expanded") return `expanded=${val}`;
@@ -39169,7 +39208,7 @@ function formatElement(element, options) {
     ref: element.ref,
     role: element.role,
     name: textSource,
-    fieldLabel: options?.fieldLabel,
+    fieldLabel: options?.fieldLabel || element.attributes["field"] || void 0,
     label: extracted.label || void 0,
     value: extracted.value,
     status: extracted.status,
@@ -39396,22 +39435,23 @@ function buildGridSection(element, gridInfo) {
 }
 function collectInteractiveElements(element, elements, subsections, depth, inheritedFieldLabel) {
   if ((INTERACTIVE_LEAF_ROLES.has(element.role) || isClickableByAttribute(element)) && element.ref) {
+    const effectiveFieldLabel = shouldDropInheritedFieldLabel(element, inheritedFieldLabel) ? void 0 : inheritedFieldLabel;
     if (INTERACTIVE_LEAF_ROLES.has(element.role) && isExpandedWithActionableChildren(element)) {
-      elements.push(formatElement(element, { overrideLabel: composeTriggerLabel(element), fieldLabel: inheritedFieldLabel }));
+      elements.push(formatElement(element, { overrideLabel: composeTriggerLabel(element), fieldLabel: effectiveFieldLabel }));
       collectExpandedChildren(element, elements);
       return;
     }
     if (!isMenuTriggerNoise(element)) {
-      elements.push(formatElement(element, { fieldLabel: inheritedFieldLabel }));
+      elements.push(formatElement(element, { fieldLabel: effectiveFieldLabel }));
     }
     if (!INTERACTIVE_LEAF_ROLES.has(element.role) && isClickableByAttribute(element)) {
       for (const child of element.children) {
-        collectInteractiveElements(child, elements, subsections, depth + 1, inheritedFieldLabel);
+        collectInteractiveElements(child, elements, subsections, depth + 1, effectiveFieldLabel);
       }
     }
     return;
   }
-  if (element.role === "heading" || STRUCTURAL_ROLES.has(element.role) || element.role === "grid" || element.role === "treegrid" || element.role === "table") {
+  if (element.role === "heading" || STRUCTURAL_ROLES.has(element.role) || element.role === "grid" || element.role === "treegrid" || element.role === "table" && !isWidgetTable(element)) {
     const section = buildSection(element, depth);
     if (section) {
       subsections.push(section);
@@ -39449,7 +39489,8 @@ function collectInteractiveElements(element, elements, subsections, depth, inher
         collectInteractiveElements(child, elements, subsections, depth + 1);
       }
     } else if ((INTERACTIVE_LEAF_ROLES.has(child.role) || isClickableByAttribute(child)) && child.ref) {
-      const fieldLabel = findFieldLabelInContext(child, kids, ki) ?? inheritedFieldLabel;
+      const rawFieldLabel = findFieldLabelInContext(child, kids, ki) ?? inheritedFieldLabel;
+      const fieldLabel = shouldDropInheritedFieldLabel(child, rawFieldLabel) ? void 0 : rawFieldLabel;
       if (!isMenuTriggerNoise(child)) {
         if (INTERACTIVE_LEAF_ROLES.has(child.role) && isExpandedWithActionableChildren(child)) {
           elements.push(formatElement(child, { overrideLabel: composeTriggerLabel(child), fieldLabel }));
@@ -39464,7 +39505,7 @@ function collectInteractiveElements(element, elements, subsections, depth, inher
         }
       }
     } else {
-      const containerLabel = resolveContainerFieldLabel(child) ?? inheritedFieldLabel;
+      const containerLabel = resolveContainerFieldLabel(child) ?? (child.role === "table" ? findFieldLabelFromSiblings(kids, ki) : void 0) ?? inheritedFieldLabel;
       collectInteractiveElements(child, elements, subsections, depth + 1, containerLabel);
     }
   }
@@ -39608,7 +39649,7 @@ var COLOR_NAMES = [
   "teal",
   "pink"
 ];
-function generateFrontmatter(elementCount, sectionCount, activeElement, dialogStack, searchMatches, totalMatchCount, snapshotFilePath, probeResult) {
+function generateFrontmatter(elementCount, sectionCount, activeElement, dialogStack, searchMatches, totalMatchCount, snapshotFilePath, probeResult, currentTime, capturedToasts) {
   const activeLabel = activeElement ? normalizeIconLabelText(
     activeElement.role,
     INTERACTIVE_LEAF_ROLES.has(activeElement.role) && isExpandedWithActionableChildren(activeElement) ? composeTriggerLabel(activeElement) : activeElement.text || ""
@@ -39616,6 +39657,16 @@ function generateFrontmatter(elementCount, sectionCount, activeElement, dialogSt
   const activeDesc = activeElement ? `${activeElement.ref} ${activeElement.role} "${activeLabel}"` : "None";
   const dialogStackLine = dialogStack.length > 0 ? `
 DIALOG STACK: ${dialogStack.join(" \u2192 ")}` : "";
+  let toastSection = "";
+  if (capturedToasts && capturedToasts.length > 0) {
+    const toastLines = capturedToasts.map((t) => {
+      const ttl = t.snapshotsRemaining !== void 0 ? ` (expires in ${t.snapshotsRemaining} snapshots)` : "";
+      return `  - [${t.role}] "${t.text}"${ttl}`;
+    });
+    toastSection = `
+TOAST NOTIFICATIONS:
+${toastLines.join("\n")}`;
+  }
   let searchSection = "";
   if (searchMatches && searchMatches.length > 0) {
     const hasContextInfo = searchMatches.some((m) => m.context);
@@ -39665,10 +39716,12 @@ PROBE RESULT:
 FULL TREE FILE: ${snapshotFilePath}
   Use bash or python_execute to grep/parse this file for detailed element analysis.`;
   }
+  const browserTime = currentTime ?? (/* @__PURE__ */ new Date()).toISOString();
   return `---
 SEMANTIC SNAPSHOT - ${elementCount} elements in ${sectionCount} sections
+BROWSER TIME: ${browserTime} (UTC)
 FORMAT: Sections grouped by headings. [ref] tags identify clickable elements.
-ACTIVE ELEMENT: ${activeDesc}${dialogStackLine}${searchSection}${probeSection}${fullTreeFileSection}
+ACTIVE ELEMENT: ${activeDesc}${dialogStackLine}${toastSection}${searchSection}${probeSection}${fullTreeFileSection}
 ACTIONS:
   - Click/type using [ref] values (e.g., browser_click ref=e123)${typeActionHint}
   - Click using coordinates from search results (e.g., browser_click x=450 y=320)
@@ -39738,7 +39791,9 @@ function formatSemanticSnapshot(yaml, options) {
       // Use re-sorted matches with context
       options?.totalMatchCount,
       options?.snapshotFilePath,
-      options?.probeResult
+      options?.probeResult,
+      options?.currentTime,
+      options?.capturedToasts
     )
   );
   lines.push("");
@@ -40137,10 +40192,11 @@ function generateHint(diff2, networkInfo) {
   }
   return hints.join(" ");
 }
-function formatSemanticDiff(diff2, actionDescription, networkInfo) {
+function formatSemanticDiff(diff2, actionDescription, networkInfo, currentTime) {
   const lines = [];
   lines.push("---");
   lines.push("SEMANTIC DIFF: Page state changes after browser action.");
+  lines.push(`BROWSER TIME: ${currentTime ?? (/* @__PURE__ */ new Date()).toISOString()} (UTC)`);
   lines.push("Format: [PREVIOUS] value [CURRENT] value");
   lines.push("");
   lines.push(`ACTION: ${actionDescription}`);
@@ -40219,6 +40275,38 @@ function formatValue(value) {
   return `"${truncate(value, 20)}"`;
 }
 
+// ../browser-core/src/playwright-client/download-utils.ts
+import * as path from "path";
+function formatFileSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function guessMimeType(filename) {
+  const ext = path.extname(filename).toLowerCase();
+  const mimeMap = {
+    ".pdf": "application/pdf",
+    ".txt": "text/plain",
+    ".csv": "text/csv",
+    ".json": "application/json",
+    ".xml": "application/xml",
+    ".html": "text/html",
+    ".htm": "text/html",
+    ".md": "text/markdown",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".zip": "application/zip",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+  };
+  return mimeMap[ext] ?? "application/octet-stream";
+}
+
 // ../browser-core/src/playwright-client/element-inspection.ts
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
@@ -40618,7 +40706,7 @@ async function extractElementMetadata(page, locator, ref, logger2) {
 }
 
 // ../browser-core/src/tools/executor.ts
-import * as path from "path";
+import * as path2 from "path";
 import * as fs2 from "fs/promises";
 import * as crypto2 from "crypto";
 
@@ -40750,7 +40838,7 @@ var BrowserToolExecutor = class {
     if (!options?.workspaceDir && !options?.tmpBaseDir) {
       options?.logger?.debug?.("[BrowserToolExecutor] No tmpBaseDir provided, using flat canary dir (not org-scoped)");
     }
-    this.workspaceDir = options?.workspaceDir ?? path.join(options?.tmpBaseDir ?? getCanaryTmpDir(), `browser-workspace-${Date.now()}-${crypto2.randomUUID().slice(0, 8)}`);
+    this.workspaceDir = options?.workspaceDir ?? path2.join(options?.tmpBaseDir ?? getCanaryTmpDir(), `browser-workspace-${Date.now()}-${crypto2.randomUUID().slice(0, 8)}`);
     this.logger = options?.logger;
     fs2.mkdir(this.workspaceDir, { recursive: true }).catch(() => {
     });
@@ -40915,15 +41003,18 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
     try {
       await fs2.mkdir(this.workspaceDir, { recursive: true });
       const filename = `snapshot-${Date.now()}-${crypto2.randomUUID().slice(0, 8)}.yaml`;
-      snapshotFilePath = path.join(this.workspaceDir, filename);
+      snapshotFilePath = path2.join(this.workspaceDir, filename);
       await fs2.writeFile(snapshotFilePath, yaml, "utf-8");
     } catch {
     }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
     const semanticText = formatSemanticSnapshot(yaml, {
       searchMatches: searchMatches.length > 0 ? searchMatches : void 0,
       totalMatchCount: totalMatchCount > 0 ? totalMatchCount : void 0,
       snapshotFilePath,
-      probeResult
+      probeResult,
+      currentTime: now,
+      capturedToasts: this.client.getCapturedToasts?.() ?? []
     });
     if (hasImages) {
       const resolutionNote = buildResolutionNote(
@@ -41166,7 +41257,7 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
         if (!afterModal) {
           const afterState2 = captureSnapshotState(afterUrl2, afterYaml2);
           const diff3 = compareSnapshots(beforeState, afterState2);
-          return formatSemanticDiff(diff3, `Dismissed overlay using ${strategy}`);
+          return formatSemanticDiff(diff3, `Dismissed overlay using ${strategy}`, void 0, (/* @__PURE__ */ new Date()).toISOString());
         }
       } catch (err) {
         this.logger?.debug?.(`[BrowserTools] Dismiss strategy ${strategy} failed`, {
@@ -41182,7 +41273,7 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
     const diff2 = compareSnapshots(beforeState, afterState);
     return `Could not dismiss overlay with strategies: ${strategies.join(", ")}. Modal may require specific interaction.
 
-` + formatSemanticDiff(diff2, "Dismiss overlay attempted (failed)");
+` + formatSemanticDiff(diff2, "Dismiss overlay attempted (failed)", void 0, (/* @__PURE__ */ new Date()).toISOString());
   }
   // ==================== Waiting ====================
   async waitFor(opts) {
@@ -41296,7 +41387,8 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
     }
     const diff2 = compareSnapshots(beforeState, afterState);
     const networkInfo = this.client.getPendingNetworkInfo?.() ?? void 0;
-    const diffText = formatSemanticDiff(diff2, actionDescription, networkInfo);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const diffText = formatSemanticDiff(diff2, actionDescription, networkInfo, now);
     const hasChanges = hasDiffChanges(diff2);
     const isStable = !networkInfo || networkInfo.pendingCount === 0;
     let autoSnapshot;
@@ -41306,11 +41398,11 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
         try {
           await fs2.mkdir(this.workspaceDir, { recursive: true });
           const filename = `snapshot-${Date.now()}-${crypto2.randomUUID().slice(0, 8)}.yaml`;
-          snapshotFilePath = path.join(this.workspaceDir, filename);
+          snapshotFilePath = path2.join(this.workspaceDir, filename);
           await fs2.writeFile(snapshotFilePath, afterYaml, "utf-8");
         } catch {
         }
-        const semanticText = formatSemanticSnapshot(afterYaml, { snapshotFilePath });
+        const semanticText = formatSemanticSnapshot(afterYaml, { snapshotFilePath, currentTime: now, capturedToasts: this.client.getCapturedToasts?.() ?? [] });
         const afterImages = isMCPContentWithImages(afterResult) ? afterResult.images : void 0;
         if (afterImages?.length && this.onScreenshot) {
           const img = afterImages[0];
@@ -41347,11 +41439,11 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
     try {
       await fs2.mkdir(this.workspaceDir, { recursive: true });
       const filename = `snapshot-${Date.now()}-${crypto2.randomUUID().slice(0, 8)}.yaml`;
-      snapshotFilePath = path.join(this.workspaceDir, filename);
+      snapshotFilePath = path2.join(this.workspaceDir, filename);
       await fs2.writeFile(snapshotFilePath, yaml, "utf-8");
     } catch {
     }
-    const semanticText = formatSemanticSnapshot(yaml, { snapshotFilePath });
+    const semanticText = formatSemanticSnapshot(yaml, { snapshotFilePath, currentTime: (/* @__PURE__ */ new Date()).toISOString(), capturedToasts: this.client.getCapturedToasts?.() ?? [] });
     const yamlBlockPattern = /- Page Snapshot:\n```yaml\n[\s\S]*?```/;
     if (yamlBlockPattern.test(result)) {
       return result.replace(yamlBlockPattern, `- Page Snapshot (semantic):
@@ -42586,8 +42678,8 @@ var errors = playwrightLoader.lazyloadExportOrDie("errors");
 
 // ../browser-core/src/playwright-client.ts
 var import_puppeteer_extra_plugin_stealth = __toESM(require_puppeteer_extra_plugin_stealth(), 1);
-import * as fs3 from "fs/promises";
-import * as path3 from "path";
+import * as fs4 from "fs/promises";
+import * as path4 from "path";
 
 // ../browser-core/src/playwright-client/toast-capture-script.ts
 var TOAST_CAPTURE_SCRIPT = `
@@ -43310,11 +43402,44 @@ async function enrichHiddenClickableElements(page, logger2) {
   try {
     const enrichedCount = await page.evaluate(() => {
       let count = 0;
-      const patterns = [
-        ["abbr.search-choice-close", "search-choice-close"],
+      const chosenCloseButtons = document.querySelectorAll("abbr.search-choice-close");
+      for (const el of chosenCloseButtons) {
+        if (el.getAttribute("data-enriched-clickable") === "true") continue;
+        if (el.getAttribute("role") === "button") continue;
+        let fieldName;
+        const container = el.closest(".chosen-container");
+        if (container) {
+          const selectEl = container.previousElementSibling;
+          if (selectEl && selectEl.tagName === "SELECT") {
+            const selectId = selectEl.id;
+            if (selectId) {
+              const labelEl = document.querySelector(`label[for="${selectId}"]`);
+              if (labelEl?.textContent?.trim()) {
+                fieldName = labelEl.textContent.trim();
+              }
+            }
+            if (!fieldName) {
+              fieldName = selectEl.getAttribute("aria-label") || void 0;
+            }
+          }
+          if (!fieldName && container.parentElement) {
+            const prev = container.parentElement.previousElementSibling;
+            if (prev && (prev.tagName === "LABEL" || prev.querySelector("label"))) {
+              const labelText = prev.textContent?.trim();
+              if (labelText && labelText.length < 80) fieldName = labelText;
+            }
+          }
+        }
+        const label = fieldName ? `Clear ${fieldName}` : "Clear selection";
+        el.setAttribute("role", "button");
+        el.setAttribute("aria-label", label);
+        el.setAttribute("data-enriched-clickable", "true");
+        count++;
+      }
+      const genericPatterns = [
         [".select2-selection__clear", "select2-selection__clear"]
       ];
-      for (const [selector, fallbackLabel] of patterns) {
+      for (const [selector, fallbackLabel] of genericPatterns) {
         const elements = document.querySelectorAll(selector);
         for (const el of elements) {
           if (el.getAttribute("data-enriched-clickable") === "true") continue;
@@ -43326,6 +43451,12 @@ async function enrichHiddenClickableElements(page, logger2) {
           count++;
         }
       }
+      const chosenSearchInputs = document.querySelectorAll(
+        ".chosen-container:not(.chosen-with-drop) .chosen-search-input"
+      );
+      for (const input of chosenSearchInputs) {
+        input.setAttribute("aria-hidden", "true");
+      }
       return count;
     });
     if (enrichedCount > 0) {
@@ -43364,10 +43495,29 @@ async function augmentHiddenSelectOptions(page, yaml, logger2) {
         if (!trigger) continue;
         const rect = trigger.getBoundingClientRect();
         const triggerText = trigger.textContent?.trim()?.slice(0, 80) || null;
+        let fieldLabel = null;
+        const selectId = sel.id;
+        if (selectId) {
+          const labelEl = document.querySelector(`label[for="${selectId}"]`);
+          if (labelEl?.textContent?.trim()) {
+            fieldLabel = labelEl.textContent.trim();
+          }
+        }
+        if (!fieldLabel) {
+          fieldLabel = sel.getAttribute("aria-label") || null;
+        }
+        if (!fieldLabel && parent.previousElementSibling) {
+          const prev = parent.previousElementSibling;
+          if (prev.tagName === "LABEL" || prev.querySelector("label")) {
+            const labelText = prev.textContent?.trim();
+            if (labelText && labelText.length < 80) fieldLabel = labelText;
+          }
+        }
         results.push({
           options: opts.slice(0, 15),
           triggerText,
-          triggerRect: rect.width > 0 ? { x: rect.x, y: rect.y, width: rect.width, height: rect.height } : null
+          triggerRect: rect.width > 0 ? { x: rect.x, y: rect.y, width: rect.width, height: rect.height } : null,
+          fieldLabel
         });
       }
       return results;
@@ -43379,7 +43529,7 @@ async function augmentHiddenSelectOptions(page, yaml, logger2) {
     const elements = parseSnapshot(yaml);
     let augmented = yaml;
     for (const selectInfo of hiddenSelects) {
-      const { options: opts, triggerText, triggerRect } = selectInfo;
+      const { options: opts, triggerText, triggerRect, fieldLabel } = selectInfo;
       if (!opts.length) continue;
       let matchedRef = null;
       if (triggerText) {
@@ -43428,11 +43578,13 @@ async function augmentHiddenSelectOptions(page, yaml, logger2) {
       }
       if (!matchedRef) continue;
       const optionsValue = opts.join("|");
-      augmented = updateElementLineByRef(
-        augmented,
-        matchedRef,
-        (line) => appendAttributeIfMissing(line, "options", optionsValue)
-      );
+      augmented = updateElementLineByRef(augmented, matchedRef, (line) => {
+        let next = appendAttributeIfMissing(line, "options", optionsValue);
+        if (fieldLabel) {
+          next = appendAttributeIfMissing(next, "field", fieldLabel);
+        }
+        return next;
+      });
     }
     return augmented;
   } catch (err) {
@@ -43488,38 +43640,6 @@ async function enrichInteractiveSVGElements(page, logger2) {
   }
 }
 
-// ../browser-core/src/playwright-client/download-utils.ts
-import * as path2 from "path";
-function formatFileSize(bytes) {
-  if (bytes < 1024) return `${bytes}B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-}
-function guessMimeType(filename) {
-  const ext = path2.extname(filename).toLowerCase();
-  const mimeMap = {
-    ".pdf": "application/pdf",
-    ".txt": "text/plain",
-    ".csv": "text/csv",
-    ".json": "application/json",
-    ".xml": "application/xml",
-    ".html": "text/html",
-    ".htm": "text/html",
-    ".md": "text/markdown",
-    ".png": "image/png",
-    ".jpg": "image/jpeg",
-    ".jpeg": "image/jpeg",
-    ".gif": "image/gif",
-    ".svg": "image/svg+xml",
-    ".zip": "application/zip",
-    ".doc": "application/msword",
-    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-    ".xls": "application/vnd.ms-excel",
-    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-  };
-  return mimeMap[ext] ?? "application/octet-stream";
-}
-
 // ../browser-core/src/playwright-client/response-format.ts
 var TOAST_SNAPSHOT_TTL = 5;
 function formatMcpResponse(input) {
@@ -43578,10 +43698,172 @@ function formatMcpResponse(input) {
   };
 }
 
+// ../browser-core/src/playwright-client/launch-retry.ts
+var TRANSIENT_BROWSER_LAUNCH_PATTERNS = [
+  /failed to connect/i,
+  /syscall["':\s]+connect/i,
+  /\bENOENT\b/i,
+  /browser has been closed/i,
+  /target page, context or browser has been closed/i,
+  /failed to launch/i,
+  /\bSIGKILL\b/i,
+  /process was terminated/i
+];
+function formatBrowserLaunchError(error) {
+  if (error instanceof Error) {
+    const extra = error;
+    const parts = [error.message];
+    if (extra.code) parts.push(`code=${extra.code}`);
+    if (typeof extra.errno === "number") parts.push(`errno=${extra.errno}`);
+    if (extra.syscall) parts.push(`syscall=${extra.syscall}`);
+    if (extra.cause) parts.push(`cause=${formatBrowserLaunchError(extra.cause)}`);
+    return parts.join(" ");
+  }
+  return String(error);
+}
+function isTransientBrowserLaunchError(error) {
+  const text = formatBrowserLaunchError(error);
+  return TRANSIENT_BROWSER_LAUNCH_PATTERNS.some((pattern) => pattern.test(text));
+}
+async function withBrowserLaunchRetry(operation, options) {
+  const maxAttempts = options.maxAttempts ?? 3;
+  const initialDelayMs = options.initialDelayMs ?? 150;
+  let lastError;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await operation(attempt);
+    } catch (error) {
+      lastError = error;
+      if (attempt >= maxAttempts || !isTransientBrowserLaunchError(error)) {
+        throw error;
+      }
+      const delayMs = initialDelayMs * 2 ** (attempt - 1);
+      options.logger.warn("[DirectPlaywright] Browser launch failed transiently, retrying", {
+        label: options.label,
+        attempt,
+        nextAttempt: attempt + 1,
+        delayMs,
+        error: formatBrowserLaunchError(error)
+      });
+      await new Promise((resolve2) => setTimeout(resolve2, delayMs));
+    }
+  }
+  throw lastError;
+}
+
+// ../browser-core/src/playwright-client/test-browser-lock.ts
+import * as fs3 from "fs/promises";
+import * as path3 from "path";
+var TEST_BROWSER_LOCK_DIR = path3.join(getCanaryTmpDir(), "playwright-test-browser-lock");
+var TEST_BROWSER_LOCK_METADATA_PATH = path3.join(TEST_BROWSER_LOCK_DIR, "owner.json");
+var TEST_BROWSER_LOCK_POLL_MS = 100;
+var TEST_BROWSER_LOCK_TIMEOUT_MS = 12e4;
+var TEST_BROWSER_LOCK_STALE_MS = 15 * 6e4;
+function shouldUseTestBrowserLock(options) {
+  return process.env.NODE_ENV === "test" && !options.browserLease && !options.cdpUrl && options.browserMode !== "headed";
+}
+async function acquireTestBrowserLock(logger2) {
+  const startedAt = Date.now();
+  const owner = {
+    pid: process.pid,
+    acquiredAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  while (true) {
+    try {
+      await fs3.mkdir(TEST_BROWSER_LOCK_DIR);
+      await fs3.writeFile(TEST_BROWSER_LOCK_METADATA_PATH, JSON.stringify(owner), "utf8");
+      logger2.debug("[DirectPlaywright] Acquired test browser lock", {
+        lockDir: TEST_BROWSER_LOCK_DIR,
+        pid: process.pid
+      });
+      let released = false;
+      return async () => {
+        if (released) return;
+        released = true;
+        try {
+          await fs3.rm(TEST_BROWSER_LOCK_DIR, { recursive: true, force: true });
+          logger2.debug("[DirectPlaywright] Released test browser lock", {
+            lockDir: TEST_BROWSER_LOCK_DIR,
+            pid: process.pid
+          });
+        } catch (error) {
+          logger2.warn("[DirectPlaywright] Failed to release test browser lock", {
+            lockDir: TEST_BROWSER_LOCK_DIR,
+            pid: process.pid,
+            error: error instanceof Error ? error.message : String(error)
+          });
+        }
+      };
+    } catch (error) {
+      const code = error.code;
+      if (code !== "EEXIST") {
+        throw error;
+      }
+      await cleanupStaleTestBrowserLock(logger2);
+      if (Date.now() - startedAt >= TEST_BROWSER_LOCK_TIMEOUT_MS) {
+        throw new Error(
+          `Timed out acquiring test browser lock after ${TEST_BROWSER_LOCK_TIMEOUT_MS}ms`
+        );
+      }
+      await delay(TEST_BROWSER_LOCK_POLL_MS);
+    }
+  }
+}
+async function cleanupStaleTestBrowserLock(logger2) {
+  const metadata = await readLockMetadata();
+  if (!metadata) {
+    const orphanedLockStats = await fs3.stat(TEST_BROWSER_LOCK_DIR).catch(() => null);
+    if (!orphanedLockStats) {
+      return;
+    }
+    const orphanedAgeMs = Date.now() - orphanedLockStats.mtimeMs;
+    if (orphanedAgeMs < 1e3) {
+      return;
+    }
+    logger2.warn("[DirectPlaywright] Removing orphaned test browser lock", {
+      lockDir: TEST_BROWSER_LOCK_DIR,
+      ageMs: orphanedAgeMs
+    });
+    await fs3.rm(TEST_BROWSER_LOCK_DIR, { recursive: true, force: true });
+    return;
+  }
+  const ageMs = Date.now() - Date.parse(metadata.acquiredAt);
+  if (ageMs < TEST_BROWSER_LOCK_STALE_MS && isProcessAlive(metadata.pid)) {
+    return;
+  }
+  logger2.warn("[DirectPlaywright] Removing stale test browser lock", {
+    lockDir: TEST_BROWSER_LOCK_DIR,
+    ownerPid: metadata.pid,
+    ageMs
+  });
+  await fs3.rm(TEST_BROWSER_LOCK_DIR, { recursive: true, force: true });
+}
+async function readLockMetadata() {
+  try {
+    const raw = await fs3.readFile(TEST_BROWSER_LOCK_METADATA_PATH, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    const code = error.code;
+    return code !== "ESRCH";
+  }
+}
+function delay(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+
 // ../browser-core/src/playwright-client.ts
 var PlaywrightClient = class _PlaywrightClient {
   disconnectInProgress = false;
   browserLease;
+  releaseTestBrowserLock = null;
   logger;
   screencastEncoderFactory;
   tmpBaseDir;
@@ -43743,8 +44025,8 @@ var PlaywrightClient = class _PlaywrightClient {
       const cursorOpts = typeof cursorOverlay === "object" ? cursorOverlay : {};
       this.cursorOverlay = new CursorOverlay({ ...cursorOpts, enabled: cursorEnabled });
     }
-    this._downloadDir = path3.join(this.tmpBaseDir, `playwright-downloads-${Date.now()}`);
-    await fs3.mkdir(this._downloadDir, { recursive: true });
+    this._downloadDir = path4.join(this.tmpBaseDir, `playwright-downloads-${Date.now()}`);
+    await fs4.mkdir(this._downloadDir, { recursive: true });
     this.logger.info("[DirectPlaywright] Launching browser", {
       browserMode: resolvedBrowserMode,
       hasStorageState: !!storageStatePath,
@@ -43755,82 +44037,100 @@ var PlaywrightClient = class _PlaywrightClient {
       highlightEnabled: this.highlightEnabled,
       downloadDir: this._downloadDir
     });
-    if (cdpUrl) {
-      this.logger.info("[DirectPlaywright] Connecting via CDP", { cdpUrl });
-      this.browser = await this.withOperationTimeout(
-        playwrightChromium.connectOverCDP(cdpUrl),
-        3e4,
-        "[DirectPlaywright] connectOverCDP"
-      );
-      const existingContexts = this.browser.contexts();
-      this.context = existingContexts[0] ?? await this.browser.newContext({ viewport: resolvedViewport });
-    } else if (this.browserLease && !this.stealthEnabled && !this.extensionsEnabled && resolvedBrowserMode !== "headed") {
-      const videoConfig2 = this.resolveVideoConfig(recordVideo);
-      const contextOptions = {
-        viewport: resolvedViewport,
-        acceptDownloads: true
-      };
-      if (storageStatePath) {
-        try {
-          await fs3.access(storageStatePath);
-          contextOptions.storageState = storageStatePath;
-        } catch {
+    try {
+      if (shouldUseTestBrowserLock({
+        browserLease: !!this.browserLease,
+        cdpUrl,
+        browserMode: resolvedBrowserMode
+      }) && !this.releaseTestBrowserLock) {
+        this.releaseTestBrowserLock = await acquireTestBrowserLock(this.logger);
+      }
+      if (cdpUrl) {
+        this.logger.info("[DirectPlaywright] Connecting via CDP", { cdpUrl });
+        this.browser = await this.withOperationTimeout(
+          playwrightChromium.connectOverCDP(cdpUrl),
+          3e4,
+          "[DirectPlaywright] connectOverCDP"
+        );
+        const existingContexts = this.browser.contexts();
+        this.context = existingContexts[0] ?? await this.browser.newContext({ viewport: resolvedViewport });
+      } else if (this.browserLease && !this.stealthEnabled && !this.extensionsEnabled && resolvedBrowserMode !== "headed") {
+        const videoConfig2 = this.resolveVideoConfig(recordVideo);
+        const contextOptions = {
+          viewport: resolvedViewport,
+          acceptDownloads: true
+        };
+        if (storageStatePath) {
+          try {
+            await fs4.access(storageStatePath);
+            contextOptions.storageState = storageStatePath;
+          } catch {
+          }
         }
-      }
-      if (videoConfig2) {
-        await fs3.mkdir(videoConfig2.dir, { recursive: true });
-        contextOptions.recordVideo = videoConfig2;
-        this.videoDir = videoConfig2.dir;
-      }
-      if (extraHTTPHeaders && Object.keys(extraHTTPHeaders).length > 0) {
-        contextOptions.extraHTTPHeaders = extraHTTPHeaders;
-      }
-      this.logger.info("[DirectPlaywright] Using pooled browser via lease", {
-        leaseId: this.browserLease.leaseId,
-        browserId: this.browserLease.browserId
-      });
-      this.context = await this.withOperationTimeout(
-        this.browserLease.createContext(contextOptions),
-        3e4,
-        "[DirectPlaywright] browserLease.createContext"
-      );
-      this.browser = null;
-    } else {
-      if (this.browserLease) {
-        this.logger.info("[DirectPlaywright] Releasing pool lease for direct launch", {
+        if (videoConfig2) {
+          await fs4.mkdir(videoConfig2.dir, { recursive: true });
+          contextOptions.recordVideo = videoConfig2;
+          this.videoDir = videoConfig2.dir;
+        }
+        if (extraHTTPHeaders && Object.keys(extraHTTPHeaders).length > 0) {
+          contextOptions.extraHTTPHeaders = extraHTTPHeaders;
+        }
+        this.logger.info("[DirectPlaywright] Using pooled browser via lease", {
           leaseId: this.browserLease.leaseId,
-          reason: resolvedBrowserMode === "headed" ? "headed-mode" : "requires-dedicated-browser"
+          browserId: this.browserLease.browserId
         });
-        await this.browserLease.release();
-        this.browserLease = null;
+        this.context = await this.withOperationTimeout(
+          this.browserLease.createContext(contextOptions),
+          3e4,
+          "[DirectPlaywright] browserLease.createContext"
+        );
+        this.browser = null;
+      } else {
+        if (this.browserLease) {
+          this.logger.info("[DirectPlaywright] Releasing pool lease for direct launch", {
+            leaseId: this.browserLease.leaseId,
+            reason: resolvedBrowserMode === "headed" ? "headed-mode" : "requires-dedicated-browser"
+          });
+          await this.browserLease.release();
+          this.browserLease = null;
+        }
+        const { browser, context } = await withBrowserLaunchRetry(
+          () => this.launchBrowser({
+            browserMode: resolvedBrowserMode,
+            storageStatePath,
+            viewport,
+            recordVideo,
+            stealth,
+            extensions,
+            extraHTTPHeaders
+          }),
+          {
+            logger: this.logger,
+            label: "direct-launch"
+          }
+        );
+        this.browser = browser;
+        this.context = context;
       }
-      const { browser, context } = await this.launchBrowser({
+      this.attachContextListeners(this.context);
+      if (this.browser) {
+        this.attachBrowserListeners(this.browser);
+      }
+      await this.createPageWithListeners(this.context, "initial_connect");
+      const now = Date.now();
+      const initialPageId = this._assignPageId(this.page);
+      this._pageCreationTimes.set(initialPageId, now);
+      this._tabFocusLog.push({ pageIndex: initialPageId, timestamp: now });
+      this.logger.info("[DirectPlaywright] Browser connected successfully", {
         browserMode: resolvedBrowserMode,
-        storageStatePath,
-        viewport,
-        recordVideo,
-        stealth,
-        extensions,
-        extraHTTPHeaders
+        stealthEnabled: this.stealthEnabled,
+        extensionsEnabled: this.extensionsEnabled,
+        pooled: !!this.browserLease
       });
-      this.browser = browser;
-      this.context = context;
-    }
-    this.attachContextListeners(this.context);
-    if (this.browser) {
-      this.attachBrowserListeners(this.browser);
+    } catch (error) {
+      await this.cleanupFailedConnect(error);
+      throw error;
     }
-    await this.createPageWithListeners(this.context, "initial_connect");
-    const now = Date.now();
-    const initialPageId = this._assignPageId(this.page);
-    this._pageCreationTimes.set(initialPageId, now);
-    this._tabFocusLog.push({ pageIndex: initialPageId, timestamp: now });
-    this.logger.info("[DirectPlaywright] Browser connected successfully", {
-      browserMode: resolvedBrowserMode,
-      stealthEnabled: this.stealthEnabled,
-      extensionsEnabled: this.extensionsEnabled,
-      pooled: !!this.browserLease
-    });
   }
   supportsContextSwap() {
     return !this.extensionsEnabled && (!!this.browser || !!this.browserLease);
@@ -43902,7 +44202,7 @@ var PlaywrightClient = class _PlaywrightClient {
     }
     if (nextStorageStatePath) {
       try {
-        await fs3.access(nextStorageStatePath);
+        await fs4.access(nextStorageStatePath);
         contextOptions.storageState = nextStorageStatePath;
         this.logger.debug("[DirectPlaywright] Loading storage state for swapped context", {
           storageStatePath: nextStorageStatePath
@@ -43923,7 +44223,7 @@ var PlaywrightClient = class _PlaywrightClient {
     this._pageCreationTimes.clear();
     this._closedPageVideos = [];
     if (videoConfig) {
-      await fs3.mkdir(videoConfig.dir, { recursive: true });
+      await fs4.mkdir(videoConfig.dir, { recursive: true });
       contextOptions.recordVideo = videoConfig;
       this.videoDir = videoConfig.dir;
       this.highlightEnabled = true;
@@ -43980,6 +44280,7 @@ var PlaywrightClient = class _PlaywrightClient {
       this.logger.debug("[DirectPlaywright] Stealth plugin applied");
     }
     const chromiumLauncher = useStealthMode ? chromium : playwrightChromium;
+    const executablePath = await _PlaywrightClient.resolveChromiumExecutable(this.logger);
     const args = ["--no-sandbox", "--disable-dev-shm-usage"];
     if (browserMode === "headed" && process.platform === "darwin") {
       args.push(
@@ -44001,7 +44302,7 @@ var PlaywrightClient = class _PlaywrightClient {
     }
     if (storageStatePath) {
       try {
-        await fs3.access(storageStatePath);
+        await fs4.access(storageStatePath);
         contextOptions.storageState = storageStatePath;
         this.logger.debug("[DirectPlaywright] Loading storage state from file", {
           storageStatePath
@@ -44013,7 +44314,7 @@ var PlaywrightClient = class _PlaywrightClient {
       }
     }
     if (videoConfig) {
-      await fs3.mkdir(videoConfig.dir, { recursive: true });
+      await fs4.mkdir(videoConfig.dir, { recursive: true });
       contextOptions.recordVideo = videoConfig;
       this.videoDir = videoConfig.dir;
       this.logger.info("[DirectPlaywright] Video recording enabled", {
@@ -44022,9 +44323,9 @@ var PlaywrightClient = class _PlaywrightClient {
       });
     }
     if (hasExtensions) {
-      this.userDataDir = extensions.userDataDir || path3.join(this.tmpBaseDir, `playwright-userdata-${Date.now()}`);
+      this.userDataDir = extensions.userDataDir || path4.join(this.tmpBaseDir, `playwright-userdata-${Date.now()}`);
       this.shouldCleanupUserDataDir = !extensions.persistUserData;
-      await fs3.mkdir(this.userDataDir, { recursive: true });
+      await fs4.mkdir(this.userDataDir, { recursive: true });
       if (browserMode === "headless") {
         args.push("--headless=new");
       }
@@ -44040,6 +44341,7 @@ var PlaywrightClient = class _PlaywrightClient {
           headless: false,
           // We use --headless=new in args for extension support
           args,
+          ...executablePath ? { executablePath } : {},
           ...contextOptions
         }),
         3e4,
@@ -44050,7 +44352,8 @@ var PlaywrightClient = class _PlaywrightClient {
     const browser = await this.withOperationTimeout(
       chromiumLauncher.launch({
         headless: browserMode === "headless",
-        args
+        args,
+        ...executablePath ? { executablePath } : {}
       }),
       3e4,
       "[DirectPlaywright] chromium.launch"
@@ -44062,6 +44365,68 @@ var PlaywrightClient = class _PlaywrightClient {
     );
     return { browser, context };
   }
+  /**
+   * Resolve a working Chromium executable path, handling version mismatches
+   * between the Playwright version bundled in this package and the browser
+   * binaries installed on the system.
+   *
+   * When the exact expected binary doesn't exist (e.g. Playwright expects
+   * chromium-1191 but only chromium-1194 is installed), this finds the
+   * newest available chromium binary as a fallback.
+   */
+  static async resolveChromiumExecutable(logger2) {
+    const defaultPath = playwrightChromium.executablePath();
+    try {
+      await fs4.access(defaultPath);
+      return void 0;
+    } catch {
+    }
+    const parts = defaultPath.split(path4.sep);
+    const msPlaywrightIdx = parts.findIndex((p) => p === "ms-playwright");
+    if (msPlaywrightIdx === -1) {
+      logger2.warn("[DirectPlaywright] Cannot locate ms-playwright cache directory", {
+        defaultPath
+      });
+      return void 0;
+    }
+    const cacheDir = parts.slice(0, msPlaywrightIdx + 1).join(path4.sep);
+    const relativeBinaryPath = parts.slice(msPlaywrightIdx + 2).join(path4.sep);
+    try {
+      const entries = await fs4.readdir(cacheDir);
+      const chromiumDirs = entries.filter((e) => e.startsWith("chromium-") && !e.includes("headless")).sort((a, b) => {
+        const revA = parseInt(a.split("-")[1] ?? "0", 10);
+        const revB = parseInt(b.split("-")[1] ?? "0", 10);
+        return revB - revA;
+      });
+      for (const dir of chromiumDirs) {
+        const candidate = path4.join(cacheDir, dir, relativeBinaryPath);
+        try {
+          await fs4.access(candidate);
+          logger2.warn(
+            "[DirectPlaywright] Using fallback Chromium binary (version mismatch)",
+            {
+              expected: defaultPath,
+              using: candidate
+            }
+          );
+          return candidate;
+        } catch {
+          continue;
+        }
+      }
+      logger2.warn("[DirectPlaywright] No compatible Chromium binary found", {
+        cacheDir,
+        candidates: chromiumDirs,
+        expectedRelativePath: relativeBinaryPath
+      });
+    } catch (err) {
+      logger2.warn("[DirectPlaywright] Failed to scan browser cache directory", {
+        cacheDir,
+        error: String(err)
+      });
+    }
+    return void 0;
+  }
   async disconnect() {
     this.logger.info("[DirectPlaywright] Disconnecting");
     this.disconnectInProgress = true;
@@ -44121,7 +44486,7 @@ var PlaywrightClient = class _PlaywrightClient {
       this.lastSnapshotYaml = "";
       if (this._downloadDir) {
         try {
-          await fs3.rm(this._downloadDir, { recursive: true, force: true });
+          await fs4.rm(this._downloadDir, { recursive: true, force: true });
           this.logger.debug("[DirectPlaywright] Cleaned up download directory", {
             downloadDir: this._downloadDir
           });
@@ -44133,12 +44498,26 @@ var PlaywrightClient = class _PlaywrightClient {
         }
         this._downloadDir = null;
       }
+      if (this.traceDir) {
+        try {
+          await fs4.rm(this.traceDir, { recursive: true, force: true });
+          this.logger.debug("[DirectPlaywright] Cleaned up trace directory", {
+            traceDir: this.traceDir
+          });
+        } catch (err) {
+          this.logger.warn("[DirectPlaywright] Failed to clean up trace directory", {
+            traceDir: this.traceDir,
+            error: err instanceof Error ? err.message : String(err)
+          });
+        }
+        this.traceDir = null;
+      }
       this._capturedDownloads = [];
       this._downloadCounter = 0;
       this._lastReportedDownloadIndex = 0;
       if (this.shouldCleanupUserDataDir && this.userDataDir) {
         try {
-          await fs3.rm(this.userDataDir, { recursive: true, force: true });
+          await fs4.rm(this.userDataDir, { recursive: true, force: true });
           this.logger.debug("[DirectPlaywright] Cleaned up user data directory", {
             userDataDir: this.userDataDir
           });
@@ -44152,7 +44531,7 @@ var PlaywrightClient = class _PlaywrightClient {
       if (this.snapshotFilePaths.size > 0) {
         for (const filePath of this.snapshotFilePaths) {
           try {
-            await fs3.unlink(filePath);
+            await fs4.unlink(filePath);
           } catch (err) {
             this.logger.warn("[DirectPlaywright] Failed to clean up snapshot file", {
               filePath,
@@ -44171,11 +44550,33 @@ var PlaywrightClient = class _PlaywrightClient {
       this.stealthEnabled = false;
       this.logger.info("[DirectPlaywright] Disconnected");
     } finally {
+      await this.releaseTestBrowserLockIfHeld();
       this.contextClosedIntentionally = false;
       this.pageClosedIntentionally = false;
       this.disconnectInProgress = false;
     }
   }
+  async cleanupFailedConnect(error) {
+    this.logger.warn("[DirectPlaywright] Cleaning up after failed connect", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+    try {
+      await this.disconnect();
+    } catch (disconnectError) {
+      this.logger.warn("[DirectPlaywright] Failed cleanup after connect error", {
+        error: disconnectError instanceof Error ? disconnectError.message : String(disconnectError)
+      });
+      await this.releaseTestBrowserLockIfHeld();
+    }
+  }
+  async releaseTestBrowserLockIfHeld() {
+    if (!this.releaseTestBrowserLock) {
+      return;
+    }
+    const release = this.releaseTestBrowserLock;
+    this.releaseTestBrowserLock = null;
+    await release();
+  }
   // ================ NAVIGATION ================
   async navigate(url, opts) {
     const dialogMsg = this.getPendingDialogMessage();
@@ -44448,8 +44849,8 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     }
     const sampleUrls = pendingRequests.slice(0, 3).map((url) => {
       try {
-        const path4 = new URL(url).pathname + new URL(url).search;
-        return path4.length > 60 ? path4.slice(0, 57) + "..." : path4;
+        const path5 = new URL(url).pathname + new URL(url).search;
+        return path5.length > 60 ? path5.slice(0, 57) + "..." : path5;
       } catch {
         return url.length > 60 ? url.slice(0, 57) + "..." : url;
       }
@@ -45124,7 +45525,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
             const video = closingPage.video();
             if (video) {
               const videoFileName = `video-tab${closePageId}-${Date.now()}.webm`;
-              const savePath = path3.join(this.videoDir, videoFileName);
+              const savePath = path4.join(this.videoDir, videoFileName);
               await closingPage.close();
               await video.saveAs(savePath);
               const createdAt = this._pageCreationTimes.get(closePageId) ?? Date.now();
@@ -45221,8 +45622,8 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     const timestamp = Date.now();
     const shortId = crypto.randomUUID().slice(0, 8);
     const filename = `snapshot-${timestamp}-${shortId}.yaml`;
-    const filePath = path3.join(this.tmpBaseDir, filename);
-    await fs3.writeFile(filePath, yaml, "utf-8");
+    const filePath = path4.join(this.tmpBaseDir, filename);
+    await fs4.writeFile(filePath, yaml, "utf-8");
     this.snapshotFilePaths.add(filePath);
     this.logger.debug("[DirectPlaywright] Wrote snapshot to disk", {
       filePath,
@@ -45366,8 +45767,8 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
   async startTracing(_opts) {
     const context = await this.getContext();
     this.logger.info("[DirectPlaywright] Starting trace recording");
-    this.traceDir = path3.join(this.tmpBaseDir, `playwright-trace-${Date.now()}`);
-    await fs3.mkdir(this.traceDir, { recursive: true });
+    this.traceDir = path4.join(this.tmpBaseDir, `playwright-trace-${Date.now()}`);
+    await fs4.mkdir(this.traceDir, { recursive: true });
     await context.tracing.start({ screenshots: true, snapshots: true });
     this.tracingActive = true;
   }
@@ -45383,7 +45784,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     const context = await this.getContext();
     if (!this.traceDir) throw new Error("Tracing not started");
     this.logger.info("[DirectPlaywright] Stopping trace recording");
-    const tracePath = path3.join(this.traceDir, "trace.zip");
+    const tracePath = path4.join(this.traceDir, "trace.zip");
     await context.tracing.stop({ path: tracePath });
     this.tracingActive = false;
     return {
@@ -46047,18 +46448,18 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
         this.logger.error("[DirectPlaywright] Download failed: no download directory", { id });
         return;
       }
-      const savePath = path3.join(this._downloadDir, `${id}-${suggestedFilename}`);
+      const savePath = path4.join(this._downloadDir, `${id}-${suggestedFilename}`);
       download.saveAs(savePath).then(
         async () => {
           try {
-            const stat2 = await fs3.stat(savePath);
+            const stat3 = await fs4.stat(savePath);
             entry.savedPath = savePath;
-            entry.sizeBytes = stat2.size;
+            entry.sizeBytes = stat3.size;
             entry.completed = true;
             this.logger.info("[DirectPlaywright] Download completed", {
               id,
               suggestedFilename,
-              sizeBytes: stat2.size,
+              sizeBytes: stat3.size,
               savedPath: savePath
             });
           } catch {
@@ -46200,13 +46601,13 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
         };
         if (ssp) {
           try {
-            await fs3.access(ssp);
+            await fs4.access(ssp);
             ctxOpts.storageState = ssp;
           } catch {
           }
         }
         if (videoConfig2) {
-          await fs3.mkdir(videoConfig2.dir, { recursive: true });
+          await fs4.mkdir(videoConfig2.dir, { recursive: true });
           ctxOpts.recordVideo = videoConfig2;
         }
         if (headers && Object.keys(headers).length > 0) {
@@ -46232,7 +46633,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
       }
       if (this.shouldCleanupUserDataDir && this.userDataDir) {
         try {
-          await fs3.rm(this.userDataDir, { recursive: true, force: true });
+          await fs4.rm(this.userDataDir, { recursive: true, force: true });
         } catch {
         }
         this.userDataDir = null;
@@ -46321,7 +46722,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
    */
   resolveVideoConfig(recordVideo) {
     if (!recordVideo) return null;
-    const dir = recordVideo === true || !recordVideo.dir ? path3.join(this.tmpBaseDir, `playwright-video-${Date.now()}`) : recordVideo.dir;
+    const dir = recordVideo === true || !recordVideo.dir ? path4.join(this.tmpBaseDir, `playwright-video-${Date.now()}`) : recordVideo.dir;
     const size = recordVideo !== true && recordVideo.size ? recordVideo.size : DEFAULT_VIEWPORT;
     return { dir, size };
   }
@@ -46380,7 +46781,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
       for (const handle of videoHandles) {
         try {
           const videoFileName = `video-tab${handle.pageIndex}-${timestamp}.webm`;
-          const savePath = path3.join(this.videoDir, videoFileName);
+          const savePath = path4.join(this.videoDir, videoFileName);
           await handle.video.saveAs(savePath);
           const createdAt = this._pageCreationTimes.get(handle.pageIndex) ?? timestamp;
           allPageVideos.push({
@@ -46446,7 +46847,14 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     );
     return null;
   }
+  // ================ TOASTS ================
+  getCapturedToasts() {
+    return this._lastCapturedToasts;
+  }
   // ================ DOWNLOADS ================
+  getCapturedDownloads() {
+    return this._capturedDownloads;
+  }
   async listDownloads() {
     if (this._capturedDownloads.length === 0) {
       return "No downloads captured during this session.";
@@ -46487,7 +46895,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     const filename = target.suggestedFilename;
     const sizeBytes = target.sizeBytes ?? 0;
     const mimeType = this.guessMimeType(filename);
-    const ext = path3.extname(filename).toLowerCase();
+    const ext = path4.extname(filename).toLowerCase();
     if (ext === ".pdf") {
       const { extractPdfText: extractPdfText2 } = await import("./pdf-extract-XYDS42VL.js");
       const { text } = await extractPdfText2(target.savedPath);
@@ -46508,7 +46916,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
       ".svg"
     ]);
     if (textExtensions.has(ext)) {
-      const content = await fs3.readFile(target.savedPath, "utf-8");
+      const content = await fs4.readFile(target.savedPath, "utf-8");
       return { filename, sizeBytes, mimeType, textContent: content };
     }
     return { filename, sizeBytes, mimeType, textContent: null };
@@ -46619,6 +47027,7 @@ export {
   compareSnapshots,
   hasDiffChanges,
   formatSemanticDiff,
+  guessMimeType,
   captureElementAtPoint,
   AUTO_SNAPSHOT_MARKER,
   isMCPContentWithImages,
@@ -46915,4 +47324,4 @@ playwright-extra/dist/index.esm.js:
    * @license MIT
    *)
 */
-//# sourceMappingURL=chunk-RL5Y6V3C.js.map
+//# sourceMappingURL=chunk-FK3EZADZ.js.map