@agentic-qe/v3 3.0.0-alpha.34 → 3.0.0-alpha.42

package/dist/cli/bundle.js

@@ -13698,12 +13698,12 @@ var TestGenerationCoordinator = class {
       await this.agentCoordinator.stop(agentResult.value);
       return result;
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
       if (this.config.publishEvents) {
-        await this.publishGenerationFailed(err2, "generateTests");
+        await this.publishGenerationFailed(err3, "generateTests");
       }
-      return { success: false, error: err2 };
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -14475,13 +14475,13 @@ var TestGenerationPlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulGeneration(_tests) {
     const health = this.getHealth();
@@ -16367,10 +16367,10 @@ var RetryHandlerService = class {
         const result = this.parseTestResult(code, stdout, stderr);
         resolve7(result);
       });
-      proc.on("error", (err2) => {
+      proc.on("error", (err3) => {
         clearTimeout(timeoutHandle);
         reject(new Error(
-          `Failed to spawn test process: ${err2.message}. Command: ${command} ${args.join(" ")}. Ensure the test runner is installed and accessible.`
+          `Failed to spawn test process: ${err3.message}. Command: ${command} ${args.join(" ")}. Ensure the test runner is installed and accessible.`
         ));
       });
     });
@@ -16946,6 +16946,1906 @@ var TestPrioritizerService = class {
   }
 };
 
+// src/integrations/browser/types.ts
+var BrowserError = class _BrowserError extends Error {
+  constructor(message, code, tool, cause) {
+    super(message);
+    this.code = code;
+    this.tool = tool;
+    this.cause = cause;
+    this.name = "BrowserError";
+    Object.setPrototypeOf(this, _BrowserError.prototype);
+  }
+};
+var BrowserUnavailableError = class _BrowserUnavailableError extends BrowserError {
+  constructor(tool, message, cause) {
+    super(message || "Browser tool is unavailable", "BROWSER_UNAVAILABLE", tool, cause);
+    this.name = "BrowserUnavailableError";
+    Object.setPrototypeOf(this, _BrowserUnavailableError.prototype);
+  }
+};
+var BrowserTimeoutError = class _BrowserTimeoutError extends BrowserError {
+  constructor(tool, operation, cause) {
+    super(`${operation} timed out`, "BROWSER_TIMEOUT", tool, cause);
+    this.name = "BrowserTimeoutError";
+    Object.setPrototypeOf(this, _BrowserTimeoutError.prototype);
+  }
+};
+var BrowserElementNotFoundError = class _BrowserElementNotFoundError extends BrowserError {
+  constructor(tool, target, cause) {
+    const targetStr = typeof target === "string" ? target : JSON.stringify(target);
+    super(`Element not found: ${targetStr}`, "ELEMENT_NOT_FOUND", tool, cause);
+    this.name = "BrowserElementNotFoundError";
+    Object.setPrototypeOf(this, _BrowserElementNotFoundError.prototype);
+  }
+};
+
+// src/integrations/browser/agent-browser/command-executor.ts
+import { execSync, spawn as spawn4 } from "child_process";
+var AgentBrowserCommandExecutor = class {
+  config;
+  browserLaunched = false;
+  constructor(config = {}) {
+    this.config = {
+      sessionName: config.sessionName ?? "default",
+      timeout: config.timeout ?? 3e4,
+      headed: config.headed ?? false,
+      debug: config.debug ?? false
+    };
+  }
+  // ========================================================================
+  // Core execution methods
+  // ========================================================================
+  /**
+   * Execute a command synchronously and parse JSON result
+   */
+  execute(command, args = []) {
+    const fullArgs = this.buildArgs(command, args);
+    const cmdString = `npx agent-browser ${fullArgs.join(" ")}`;
+    if (this.config.debug) {
+      console.log(`[agent-browser] Executing: ${cmdString}`);
+    }
+    try {
+      const output = execSync(cmdString, {
+        encoding: "utf-8",
+        timeout: this.config.timeout,
+        maxBuffer: 10 * 1024 * 1024
+        // 10MB for screenshots
+      });
+      try {
+        const parsed = JSON.parse(output.trim());
+        return { success: true, data: parsed };
+      } catch {
+        return { success: true, data: output.trim() };
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return { success: false, error: message };
+    }
+  }
+  /**
+   * Execute a command asynchronously (for long-running ops)
+   */
+  async executeAsync(command, args = []) {
+    return new Promise((resolve7) => {
+      const fullArgs = this.buildArgs(command, args);
+      if (this.config.debug) {
+        console.log(`[agent-browser] Executing async: npx agent-browser ${fullArgs.join(" ")}`);
+      }
+      const process2 = spawn4("npx", ["agent-browser", ...fullArgs], {
+        timeout: this.config.timeout
+      });
+      let stdout = "";
+      let stderr = "";
+      process2.stdout?.on("data", (data) => {
+        stdout += data.toString();
+      });
+      process2.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      process2.on("close", (code) => {
+        if (code === 0) {
+          try {
+            const parsed = JSON.parse(stdout.trim());
+            resolve7({ success: true, data: parsed });
+          } catch {
+            resolve7({ success: true, data: stdout.trim() });
+          }
+        } else {
+          resolve7({ success: false, error: stderr || `Exit code: ${code}` });
+        }
+      });
+      process2.on("error", (error) => {
+        resolve7({ success: false, error: error.message });
+      });
+    });
+  }
+  // ========================================================================
+  // Browser lifecycle commands
+  // ========================================================================
+  /**
+   * Open URL in browser (auto-launches if needed)
+   */
+  open(url) {
+    const args = [url];
+    if (this.config.headed) {
+      args.push("--headed");
+    }
+    const result = this.execute("open", args);
+    if (result.success) {
+      this.browserLaunched = true;
+    }
+    return result;
+  }
+  /**
+   * Close browser
+   */
+  close() {
+    const result = this.execute("close");
+    if (result.success) {
+      this.browserLaunched = false;
+    }
+    return result;
+  }
+  /**
+   * Terminate the daemon process for this session
+   * CRITICAL: Must be called to prevent memory leaks!
+   * The daemon persists even after close() - this kills it entirely.
+   */
+  terminateDaemon() {
+    try {
+      this.close();
+      const sessionName = this.config.sessionName;
+      try {
+        execSync(
+          `pkill -f "agent-browser.*--session[= ]${sessionName}" 2>/dev/null || true`,
+          { timeout: 5e3, stdio: "ignore" }
+        );
+      } catch {
+      }
+      this.browserLaunched = false;
+      return { success: true };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Failed to terminate daemon"
+      };
+    }
+  }
+  // ========================================================================
+  // Snapshot commands (key feature)
+  // ========================================================================
+  /**
+   * Get accessibility snapshot with refs
+   */
+  snapshot(options) {
+    const args = ["--json"];
+    if (options?.interactive) args.push("-i");
+    if (options?.compact) args.push("-c");
+    if (options?.depth) args.push("-d", String(options.depth));
+    return this.execute("snapshot", args);
+  }
+  // ========================================================================
+  // Element interaction commands
+  // ========================================================================
+  /**
+   * Click element by ref or selector
+   */
+  click(target) {
+    return this.execute("click", [target]);
+  }
+  /**
+   * Fill input by ref or selector
+   */
+  fill(target, text) {
+    return this.execute("fill", [target, `"${text.replace(/"/g, '\\"')}"`]);
+  }
+  /**
+   * Type text (without clearing)
+   */
+  type(target, text) {
+    return this.execute("type", [target, `"${text.replace(/"/g, '\\"')}"`]);
+  }
+  /**
+   * Get element text
+   */
+  getText(target) {
+    return this.execute("get", ["text", target, "--json"]);
+  }
+  /**
+   * Check if element is visible
+   */
+  isVisible(target) {
+    const result = this.execute("is", ["visible", target, "--json"]);
+    if (result.success && result.data) {
+      return { success: true, data: result.data.success };
+    }
+    return { success: false, error: result.error };
+  }
+  // ========================================================================
+  // Screenshot commands
+  // ========================================================================
+  /**
+   * Take screenshot
+   */
+  screenshot(path13, fullPage) {
+    const args = [];
+    if (path13) args.push(path13);
+    if (fullPage) args.push("--full");
+    if (!path13) args.push("--json");
+    return this.execute("screenshot", args);
+  }
+  // ========================================================================
+  // Wait commands
+  // ========================================================================
+  /**
+   * Wait for element
+   */
+  waitForElement(target, timeout) {
+    const args = [target];
+    if (timeout) {
+      return this.execute("wait", args);
+    }
+    return this.execute("wait", args);
+  }
+  /**
+   * Wait for text to appear
+   */
+  waitForText(text) {
+    return this.execute("wait", ["--text", text]);
+  }
+  /**
+   * Wait for URL pattern
+   */
+  waitForUrl(pattern) {
+    const urlPattern = pattern.includes("*") ? pattern : `**${pattern}**`;
+    return this.execute("wait", ["--url", urlPattern]);
+  }
+  /**
+   * Wait for network idle
+   */
+  waitForNetworkIdle() {
+    return this.execute("wait", ["--load", "networkidle"]);
+  }
+  // ========================================================================
+  // Device/viewport commands
+  // ========================================================================
+  /**
+   * Set device emulation
+   */
+  setDevice(deviceName) {
+    return this.execute("set", ["device", `"${deviceName}"`]);
+  }
+  /**
+   * Set viewport size
+   */
+  setViewport(width, height) {
+    return this.execute("set", ["viewport", String(width), String(height)]);
+  }
+  // ========================================================================
+  // Network commands
+  // ========================================================================
+  /**
+   * Mock network route
+   */
+  mockRoute(urlPattern, body) {
+    const bodyJson = JSON.stringify(body).replace(/"/g, '\\"');
+    return this.execute("network", ["route", urlPattern, "--body", `"${bodyJson}"`]);
+  }
+  /**
+   * Abort network route
+   */
+  abortRoute(urlPattern) {
+    return this.execute("network", ["route", urlPattern, "--abort"]);
+  }
+  /**
+   * Clear network routes
+   */
+  clearRoutes() {
+    return this.execute("network", ["unroute"]);
+  }
+  // ========================================================================
+  // State commands
+  // ========================================================================
+  /**
+   * Save browser state (cookies, storage)
+   */
+  saveState(path13) {
+    return this.execute("state", ["save", path13]);
+  }
+  /**
+   * Load browser state
+   */
+  loadState(path13) {
+    return this.execute("state", ["load", path13]);
+  }
+  // ========================================================================
+  // Trace recording
+  // ========================================================================
+  /**
+   * Start trace recording
+   * Records browser activity for debugging and analysis
+   */
+  startTrace() {
+    return this.execute("trace", ["start"]);
+  }
+  /**
+   * Stop trace recording and save to file
+   * @param outputPath - Path to save the trace file
+   */
+  stopTrace(outputPath) {
+    const result = this.execute("trace", ["stop", outputPath]);
+    if (result.success) {
+      return { success: true, data: outputPath };
+    }
+    return { success: false, error: result.error };
+  }
+  // ========================================================================
+  // JavaScript evaluation
+  // ========================================================================
+  /**
+   * Evaluate JavaScript in page context
+   */
+  eval(script) {
+    const escapedScript = script.replace(/"/g, '\\"').replace(/\n/g, " ");
+    return this.execute("eval", [`"${escapedScript}"`, "--json"]);
+  }
+  // ========================================================================
+  // Session info
+  // ========================================================================
+  /**
+   * Get current session name
+   */
+  getSessionName() {
+    return this.config.sessionName;
+  }
+  /**
+   * Check if browser is launched
+   */
+  isBrowserLaunched() {
+    return this.browserLaunched;
+  }
+  // ========================================================================
+  // Private helpers
+  // ========================================================================
+  buildArgs(command, args) {
+    const fullArgs = [];
+    if (this.config.sessionName !== "default") {
+      fullArgs.push("--session", this.config.sessionName);
+    }
+    fullArgs.push(command, ...args);
+    return fullArgs;
+  }
+};
+function isAgentBrowserAvailable() {
+  try {
+    const output = execSync("npx agent-browser 2>&1", { encoding: "utf-8", timeout: 1e4 });
+    return output.includes("agent-browser") && output.includes("Usage:");
+  } catch {
+    return false;
+  }
+}
+
+// src/integrations/browser/agent-browser/snapshot-parser.ts
+var INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
+  "button",
+  "link",
+  "textbox",
+  "checkbox",
+  "radio",
+  "combobox",
+  "listbox",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "option",
+  "searchbox",
+  "slider",
+  "spinbutton",
+  "switch",
+  "tab",
+  "treeitem"
+]);
+var SnapshotParser = class {
+  /**
+   * Parse raw snapshot text into structured format
+   */
+  parse(snapshotOutput) {
+    const lines = snapshotOutput.split("\n");
+    const elements = [];
+    const refMap = /* @__PURE__ */ new Map();
+    let maxDepth = 0;
+    for (const line of lines) {
+      const element = this.parseLine(line);
+      if (element) {
+        elements.push(element);
+        refMap.set(element.ref, element);
+        if (element.depth > maxDepth) {
+          maxDepth = element.depth;
+        }
+      }
+    }
+    this.buildRelationships(elements);
+    const interactiveElements = elements.filter(
+      (el) => INTERACTIVE_ROLES.has(el.role.toLowerCase())
+    );
+    return {
+      rawTree: snapshotOutput,
+      elements,
+      interactiveElements,
+      refMap,
+      stats: {
+        totalElements: elements.length,
+        interactiveCount: interactiveElements.length,
+        maxDepth
+      },
+      parsedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  /**
+   * Parse JSON output from `agent-browser snapshot --json`
+   */
+  parseJson(jsonOutput) {
+    const data = typeof jsonOutput === "string" ? JSON.parse(jsonOutput) : jsonOutput;
+    if (data.success && data.data) {
+      const snapshot = data.data.snapshot || data.data;
+      const refs = data.data.refs || {};
+      return this.parseWithRefs(snapshot, refs);
+    }
+    if (typeof data === "string") {
+      return this.parse(data);
+    }
+    throw new Error("Invalid snapshot JSON format");
+  }
+  /**
+   * Parse snapshot with pre-extracted refs (from JSON)
+   */
+  parseWithRefs(tree, refs) {
+    const elements = [];
+    const refMap = /* @__PURE__ */ new Map();
+    let maxDepth = 0;
+    for (const [refId, refData] of Object.entries(refs)) {
+      const element = {
+        ref: refId,
+        refWithAt: `@${refId}`,
+        role: refData.role,
+        name: refData.name,
+        attributes: {},
+        depth: 0,
+        children: []
+      };
+      elements.push(element);
+      refMap.set(refId, element);
+    }
+    const treeElements = this.parse(tree);
+    for (const treeEl of treeElements.elements) {
+      const existing = refMap.get(treeEl.ref);
+      if (existing) {
+        existing.text = treeEl.text;
+        existing.depth = treeEl.depth;
+        existing.level = treeEl.level;
+        if (treeEl.depth > maxDepth) maxDepth = treeEl.depth;
+      }
+    }
+    const interactiveElements = elements.filter(
+      (el) => INTERACTIVE_ROLES.has(el.role.toLowerCase())
+    );
+    return {
+      rawTree: tree,
+      elements,
+      interactiveElements,
+      refMap,
+      stats: {
+        totalElements: elements.length,
+        interactiveCount: interactiveElements.length,
+        maxDepth
+      },
+      parsedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  /**
+   * Parse a single line from snapshot output
+   */
+  parseLine(line) {
+    if (!line.trim()) return null;
+    const depth = this.getIndentLevel(line);
+    const match = line.match(/^(\s*-\s*)(\w+)(?:\s+"([^"]*)")?(.*)$/);
+    if (!match) return null;
+    const [, , role, name, suffix] = match;
+    const refMatch = suffix?.match(/\[ref=(\w+)\]/);
+    if (!refMatch) return null;
+    const ref = refMatch[1];
+    const levelMatch = suffix?.match(/\[level=(\d+)\]/);
+    const level = levelMatch ? parseInt(levelMatch[1], 10) : void 0;
+    const nthMatch = suffix?.match(/\[nth=(\d+)\]/);
+    const nth = nthMatch ? parseInt(nthMatch[1], 10) : void 0;
+    const textMatch = line.match(/:\s*(.+)$/);
+    const text = textMatch ? textMatch[1].trim() : void 0;
+    const attributes = {};
+    if (level) attributes["level"] = String(level);
+    if (nth !== void 0) attributes["nth"] = String(nth);
+    return {
+      ref,
+      refWithAt: `@${ref}`,
+      role: role.toLowerCase(),
+      name,
+      text,
+      level,
+      attributes,
+      depth,
+      children: []
+    };
+  }
+  /**
+   * Get indentation level (2 spaces per level)
+   */
+  getIndentLevel(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? Math.floor(match[1].length / 2) : 0;
+  }
+  /**
+   * Build parent-child relationships between elements
+   */
+  buildRelationships(elements) {
+    const stack = [];
+    for (const element of elements) {
+      while (stack.length > 0 && stack[stack.length - 1].depth >= element.depth) {
+        stack.pop();
+      }
+      if (stack.length > 0) {
+        const parent = stack[stack.length - 1];
+        element.parent = parent.ref;
+        parent.children.push(element.ref);
+      }
+      stack.push(element);
+    }
+  }
+  // ========================================================================
+  // Query methods
+  // ========================================================================
+  /**
+   * Find element by ref
+   */
+  findByRef(snapshot, ref) {
+    const normalizedRef = ref.startsWith("@") ? ref.slice(1) : ref;
+    return snapshot.refMap.get(normalizedRef) || null;
+  }
+  /**
+   * Find elements by role
+   */
+  findByRole(snapshot, role) {
+    return snapshot.elements.filter(
+      (el) => el.role.toLowerCase() === role.toLowerCase()
+    );
+  }
+  /**
+   * Find elements by name (accessible name)
+   */
+  findByName(snapshot, name, exact = false) {
+    return snapshot.elements.filter((el) => {
+      if (!el.name) return false;
+      if (exact) return el.name === name;
+      return el.name.toLowerCase().includes(name.toLowerCase());
+    });
+  }
+  /**
+   * Find elements by text content
+   */
+  findByText(snapshot, text, exact = false) {
+    return snapshot.elements.filter((el) => {
+      const content = el.text || el.name || "";
+      if (exact) return content === text;
+      return content.toLowerCase().includes(text.toLowerCase());
+    });
+  }
+  /**
+   * Find first interactive element matching criteria
+   */
+  findInteractive(snapshot, criteria) {
+    for (const el of snapshot.interactiveElements) {
+      if (criteria.role && el.role.toLowerCase() !== criteria.role.toLowerCase()) {
+        continue;
+      }
+      if (criteria.name && el.name !== criteria.name) {
+        continue;
+      }
+      if (criteria.text) {
+        const content = el.text || el.name || "";
+        if (!content.toLowerCase().includes(criteria.text.toLowerCase())) {
+          continue;
+        }
+      }
+      return el;
+    }
+    return null;
+  }
+  /**
+   * Convert ref to CSS selector (for Vibium fallback)
+   * Uses role + name as best guess
+   */
+  refToCssSelector(snapshot, ref) {
+    const element = this.findByRef(snapshot, ref);
+    if (!element) return null;
+    const role = element.role;
+    const name = element.name;
+    const selectorMap = {
+      button: name ? `button:has-text("${name}")` : "button",
+      link: name ? `a:has-text("${name}")` : "a",
+      textbox: name ? `input[placeholder="${name}"], input[aria-label="${name}"]` : 'input[type="text"]',
+      heading: name ? `h1:has-text("${name}"), h2:has-text("${name}"), h3:has-text("${name}")` : "h1, h2, h3",
+      checkbox: name ? `input[type="checkbox"][aria-label="${name}"]` : 'input[type="checkbox"]'
+    };
+    return selectorMap[role] || `[role="${role}"]`;
+  }
+};
+var parserInstance = null;
+function getSnapshotParser() {
+  if (!parserInstance) {
+    parserInstance = new SnapshotParser();
+  }
+  return parserInstance;
+}
+
+// src/integrations/browser/agent-browser/session-manager.ts
+import { execSync as execSync2 } from "child_process";
+var AgentBrowserSessionManager = class {
+  constructor(defaultConfig) {
+    this.defaultConfig = defaultConfig;
+  }
+  sessions = /* @__PURE__ */ new Map();
+  activeSession = null;
+  sessionCounter = 0;
+  // ========================================================================
+  // Session lifecycle
+  // ========================================================================
+  /**
+   * Create a new isolated session
+   */
+  async createSession(options) {
+    const name = options?.name ?? this.generateSessionName();
+    if (this.sessions.has(name)) {
+      throw new Error(`Session "${name}" already exists`);
+    }
+    const executor = new AgentBrowserCommandExecutor({
+      sessionName: name,
+      headed: options?.headed ?? this.defaultConfig?.headed ?? false,
+      timeout: options?.timeout ?? this.defaultConfig?.timeout ?? 3e4
+    });
+    const session = {
+      name,
+      createdAt: /* @__PURE__ */ new Date(),
+      lastActivity: /* @__PURE__ */ new Date(),
+      status: "idle",
+      executor
+    };
+    this.sessions.set(name, session);
+    if (options?.initialUrl) {
+      const result = executor.open(options.initialUrl);
+      if (result.success) {
+        session.currentUrl = options.initialUrl;
+        session.status = "active";
+      }
+    }
+    if (!this.activeSession) {
+      this.activeSession = name;
+    }
+    return session;
+  }
+  /**
+   * Get or create a session by name
+   */
+  async getOrCreateSession(name, options) {
+    const existing = this.sessions.get(name);
+    if (existing) {
+      return existing;
+    }
+    return this.createSession({ ...options, name });
+  }
+  /**
+   * Get session by name
+   */
+  getSession(name) {
+    return this.sessions.get(name);
+  }
+  /**
+   * Get currently active session
+   */
+  getActiveSession() {
+    if (!this.activeSession) return void 0;
+    return this.sessions.get(this.activeSession);
+  }
+  /**
+   * Switch to a different session
+   */
+  switchSession(name) {
+    if (!this.sessions.has(name)) {
+      throw new Error(`Session "${name}" not found`);
+    }
+    this.activeSession = name;
+  }
+  /**
+   * List all sessions
+   */
+  listSessions() {
+    return Array.from(this.sessions.values());
+  }
+  /**
+   * List active session names from CLI
+   */
+  listCliSessions() {
+    try {
+      const output = execSync2("npx agent-browser session list", {
+        encoding: "utf-8",
+        timeout: 5e3
+      });
+      const lines = output.split("\n");
+      const sessions = [];
+      for (const line of lines) {
+        const match = line.match(/^\s*(?:->)?\s*(\w+)\s*$/);
+        if (match) {
+          sessions.push(match[1]);
+        }
+      }
+      return sessions;
+    } catch {
+      return [];
+    }
+  }
+  // ========================================================================
+  // Session control
+  // ========================================================================
+  /**
+   * Close a specific session
+   */
+  async closeSession(name) {
+    const session = this.sessions.get(name);
+    if (!session) {
+      return { success: false, error: `Session "${name}" not found` };
+    }
+    const result = session.executor.terminateDaemon();
+    if (result.success) {
+      session.status = "closed";
+      this.sessions.delete(name);
+      if (this.activeSession === name) {
+        const remaining = Array.from(this.sessions.keys());
+        this.activeSession = remaining.length > 0 ? remaining[0] : null;
+      }
+    }
+    return result;
+  }
+  /**
+   * Close all sessions
+   */
+  async closeAllSessions() {
+    const names = Array.from(this.sessions.keys());
+    for (const name of names) {
+      await this.closeSession(name);
+    }
+    this.sessions.clear();
+    this.activeSession = null;
+  }
+  /**
+   * Clean up idle sessions older than maxAge
+   */
+  async cleanupIdleSessions(maxAgeMs = 5 * 60 * 1e3) {
+    const now = Date.now();
+    let closedCount = 0;
+    for (const [name, session] of this.sessions) {
+      if (session.status === "idle") {
+        const age = now - session.lastActivity.getTime();
+        if (age > maxAgeMs) {
+          await this.closeSession(name);
+          closedCount++;
+        }
+      }
+    }
+    return closedCount;
+  }
+  // ========================================================================
+  // Session operations via active session
+  // ========================================================================
+  /**
+   * Get executor for active session
+   */
+  getExecutor() {
+    const session = this.getActiveSession();
+    if (!session) {
+      throw new Error("No active session. Create one first.");
+    }
+    return session.executor;
+  }
+  /**
+   * Get executor for specific session
+   */
+  getSessionExecutor(name) {
+    const session = this.sessions.get(name);
+    if (!session) {
+      throw new Error(`Session "${name}" not found`);
+    }
+    return session.executor;
+  }
+  /**
+   * Update session activity timestamp
+   */
+  touchSession(name) {
+    const session = this.sessions.get(name);
+    if (session) {
+      session.lastActivity = /* @__PURE__ */ new Date();
+    }
+  }
+  /**
+   * Update session URL
+   */
+  updateSessionUrl(name, url) {
+    const session = this.sessions.get(name);
+    if (session) {
+      session.currentUrl = url;
+      session.lastActivity = /* @__PURE__ */ new Date();
+      session.status = "active";
+    }
+  }
+  // ========================================================================
+  // Private helpers
+  // ========================================================================
+  generateSessionName() {
+    return `session-${++this.sessionCounter}-${Date.now().toString(36)}`;
+  }
+  // ========================================================================
+  // Stats
+  // ========================================================================
+  /**
+   * Get session statistics
+   */
+  getStats() {
+    let active = 0;
+    let idle = 0;
+    let closed = 0;
+    for (const session of this.sessions.values()) {
+      switch (session.status) {
+        case "active":
+          active++;
+          break;
+        case "idle":
+          idle++;
+          break;
+        case "closed":
+          closed++;
+          break;
+      }
+    }
+    return {
+      totalSessions: this.sessions.size,
+      activeSessions: active,
+      idleSessions: idle,
+      closedSessions: closed,
+      activeSessionName: this.activeSession
+    };
+  }
+};
+
+// src/integrations/browser/agent-browser/client.ts
+function resolveTarget(target) {
+  if (typeof target === "string") {
+    if (/^@?e\d+$/.test(target)) {
+      return target.startsWith("@") ? target : `@${target}`;
+    }
+    return target;
+  }
+  switch (target.type) {
+    case "ref":
+      return target.value.startsWith("@") ? target.value : `@${target.value}`;
+    case "css":
+      return target.value;
+    case "xpath":
+      return `xpath=${target.value}`;
+    case "text":
+      return `text=${target.value}`;
+    default:
+      return target.value;
+  }
+}
+function ok2(value) {
+  return { success: true, value };
+}
+function err2(error) {
+  return { success: false, error };
+}
+function toSessionInfo(info) {
+  return {
+    id: info.name,
+    tool: "agent-browser",
+    status: info.status,
+    currentUrl: info.currentUrl,
+    createdAt: info.createdAt
+  };
+}
+function toTypedSnapshot(parsed) {
+  const elements = parsed.elements.map((el) => ({
+    ref: el.refWithAt,
+    role: el.role,
+    name: el.name,
+    text: el.text,
+    depth: el.depth
+  }));
+  const interactiveElements = parsed.interactiveElements.map((el) => ({
+    ref: el.refWithAt,
+    role: el.role,
+    name: el.name,
+    text: el.text,
+    depth: el.depth
+  }));
+  const refMap = /* @__PURE__ */ new Map();
+  for (const el of elements) {
+    refMap.set(el.ref, el);
+  }
+  return {
+    url: parsed.url ?? "",
+    title: parsed.title ?? "",
+    elements,
+    interactiveElements,
+    refMap,
+    timestamp: parsed.parsedAt
+  };
+}
+var AgentBrowserClient = class {
+  tool = "agent-browser";
+  executor;
+  sessionManager;
+  snapshotParser;
+  config;
+  isLaunched = false;
+  currentSessionId = null;
+  constructor(config = {}) {
+    this.config = {
+      headed: config.headed ?? false,
+      timeout: config.timeout ?? 3e4,
+      debug: config.debug ?? false,
+      sessionName: config.sessionName ?? "default"
+    };
+    const executorConfig = {
+      sessionName: this.config.sessionName,
+      timeout: this.config.timeout,
+      headed: this.config.headed,
+      debug: this.config.debug
+    };
+    this.executor = new AgentBrowserCommandExecutor(executorConfig);
+    this.sessionManager = new AgentBrowserSessionManager({
+      headed: this.config.headed,
+      timeout: this.config.timeout
+    });
+    this.snapshotParser = getSnapshotParser();
+  }
+  // ==========================================================================
+  // Lifecycle
+  // ==========================================================================
+  /**
+   * Launch a browser instance
+   */
+  async launch(options) {
+    try {
+      if (this.isLaunched && this.currentSessionId) {
+        const existingSession = this.sessionManager.getSession(this.currentSessionId);
+        if (existingSession) {
+          if (options?.viewport) {
+            await this.setViewport(options.viewport.width, options.viewport.height);
+          }
+          return ok2(toSessionInfo(existingSession));
+        }
+      }
+      const available = await this.isAvailable();
+      if (!available) {
+        return err2(new BrowserUnavailableError("agent-browser", "agent-browser CLI is not available"));
+      }
+      const sessionName = options?.sessionName ?? this.config.sessionName;
+      const session = await this.sessionManager.createSession({
+        name: sessionName,
+        headed: options?.headless === false || this.config.headed,
+        timeout: this.config.timeout
+      });
+      this.currentSessionId = session.name;
+      this.isLaunched = true;
+      this.executor = new AgentBrowserCommandExecutor({
+        sessionName: session.name,
+        timeout: this.config.timeout,
+        headed: options?.headless === false || this.config.headed,
+        debug: this.config.debug
+      });
+      if (options?.viewport) {
+        await this.setViewport(options.viewport.width, options.viewport.height);
+      }
+      if (options?.deviceName) {
+        await this.setDevice(options.deviceName);
+      }
+      return ok2(toSessionInfo(session));
+    } catch (error) {
+      const browserError = new BrowserError(
+        error instanceof Error ? error.message : String(error),
+        "LAUNCH_FAILED",
+        "agent-browser",
+        error instanceof Error ? error : void 0
+      );
+      return err2(browserError);
+    }
+  }
+  /**
+   * Close the browser and terminate the daemon process
+   * CRITICAL: This must fully terminate all processes to prevent memory leaks!
+   */
+  async quit() {
+    try {
+      if (this.currentSessionId) {
+        const result = await this.sessionManager.closeSession(this.currentSessionId);
+        if (!result.success) {
+          if (this.config.debug) {
+            console.warn(`[agent-browser] Session close warning: ${result.error}`);
+          }
+        }
+      }
+      if (this.executor) {
+        try {
+          this.executor.terminateDaemon();
+        } catch {
+        }
+      }
+      this.isLaunched = false;
+      this.currentSessionId = null;
+      return ok2(void 0);
+    } catch (error) {
+      this.isLaunched = false;
+      this.currentSessionId = null;
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "QUIT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Check if agent-browser CLI is available
+   */
+  async isAvailable() {
+    return isAgentBrowserAvailable();
+  }
+  /**
+   * Dispose all resources
+   */
+  async dispose() {
+    await this.sessionManager.closeAllSessions();
+    this.isLaunched = false;
+    this.currentSessionId = null;
+  }
+  // ==========================================================================
+  // Navigation
+  // ==========================================================================
+  /**
+   * Navigate to a URL
+   */
+  async navigate(url) {
+    const startTime = Date.now();
+    try {
+      const result = this.executor.open(url);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Navigation failed", "NAVIGATION_FAILED", "agent-browser"));
+      }
+      if (this.currentSessionId) {
+        this.sessionManager.updateSessionUrl(this.currentSessionId, url);
+      }
+      const evalResult = this.executor.eval(
+        "JSON.stringify({ title: document.title, url: window.location.href })"
+      );
+      const pageInfo = evalResult.success && evalResult.data ? typeof evalResult.data === "string" ? JSON.parse(evalResult.data) : evalResult.data : { title: "", url };
+      return ok2({
+        url: pageInfo.url || url,
+        title: pageInfo.title || "",
+        success: true,
+        durationMs: Date.now() - startTime
+      });
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "NAVIGATION_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Reload the current page
+   */
+  async reload() {
+    try {
+      const result = this.executor.eval("window.location.reload()");
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Reload failed", "RELOAD_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "RELOAD_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Go back in browser history
+   */
+  async goBack() {
+    try {
+      const result = this.executor.eval("window.history.back()");
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Go back failed", "HISTORY_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "HISTORY_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Go forward in browser history
+   */
+  async goForward() {
+    try {
+      const result = this.executor.eval("window.history.forward()");
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Go forward failed", "HISTORY_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "HISTORY_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Element Interaction
+  // ==========================================================================
+  /**
+   * Click an element
+   */
+  async click(target) {
+    try {
+      const resolvedTarget = resolveTarget(target);
+      const result = this.executor.click(resolvedTarget);
+      if (!result.success) {
+        return err2(new BrowserElementNotFoundError("agent-browser", target, new Error(result.error)));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "CLICK_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Fill input field with text
+   */
+  async fill(target, text) {
+    try {
+      const resolvedTarget = resolveTarget(target);
+      const result = this.executor.fill(resolvedTarget, text);
+      if (!result.success) {
+        return err2(new BrowserElementNotFoundError("agent-browser", target, new Error(result.error)));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "FILL_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Get text content of an element
+   */
+  async getText(target) {
+    try {
+      const resolvedTarget = resolveTarget(target);
+      const result = this.executor.getText(resolvedTarget);
+      if (!result.success) {
+        return err2(new BrowserElementNotFoundError("agent-browser", target, new Error(result.error)));
+      }
+      let text = result.data;
+      if (text && typeof text === "object") {
+        const obj = text;
+        if ("text" in obj) {
+          text = obj.text;
+        } else if ("data" in obj && typeof obj.data === "object") {
+          const dataObj = obj.data;
+          if ("text" in dataObj) {
+            text = dataObj.text;
+          } else if ("result" in dataObj) {
+            text = dataObj.result;
+          }
+        } else if ("result" in obj) {
+          text = obj.result;
+        }
+      }
+      return ok2(String(text ?? ""));
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "GET_TEXT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Check if element is visible
+   */
+  async isVisible(target) {
+    try {
+      const resolvedTarget = resolveTarget(target);
+      const result = this.executor.isVisible(resolvedTarget);
+      if (!result.success) {
+        return ok2(false);
+      }
+      return ok2(Boolean(result.data));
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "VISIBILITY_CHECK_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Screenshots
+  // ==========================================================================
+  /**
+   * Capture a screenshot
+   */
+  async screenshot(options) {
+    try {
+      const result = this.executor.screenshot(options?.path, options?.fullPage);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Screenshot failed", "SCREENSHOT_FAILED", "agent-browser"));
+      }
+      const dimensionsResult = this.executor.eval(
+        "JSON.stringify({ width: window.innerWidth, height: window.innerHeight })"
+      );
+      let dimensions = { width: 1280, height: 720 };
+      if (dimensionsResult.success && dimensionsResult.data) {
+        const parsed = typeof dimensionsResult.data === "string" ? JSON.parse(dimensionsResult.data) : dimensionsResult.data;
+        dimensions = { width: parsed.width || 1280, height: parsed.height || 720 };
+      }
+      return ok2({
+        base64: options?.path ? void 0 : String(result.data ?? ""),
+        path: options?.path,
+        format: "png",
+        dimensions
+      });
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SCREENSHOT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Script Evaluation
+  // ==========================================================================
+  /**
+   * Evaluate JavaScript in the browser context
+   */
+  async evaluate(script) {
+    try {
+      const result = this.executor.eval(script);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Evaluation failed", "EVAL_FAILED", "agent-browser"));
+      }
+      let value = result.data;
+      if (value && typeof value === "object") {
+        const obj = value;
+        if ("data" in obj && obj.data && typeof obj.data === "object") {
+          const dataObj = obj.data;
+          if ("result" in dataObj) {
+            value = dataObj.result;
+          }
+        } else if ("result" in obj) {
+          value = obj.result;
+        }
+      }
+      return ok2(value);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "EVAL_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Snapshots (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Get accessibility snapshot with element refs
+   */
+  async getSnapshot(options) {
+    try {
+      const result = this.executor.snapshot({
+        interactive: options?.interactive,
+        depth: options?.depth
+      });
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Snapshot failed", "SNAPSHOT_FAILED", "agent-browser"));
+      }
+      let parsed;
+      try {
+        parsed = this.snapshotParser.parseJson(result.data);
+      } catch {
+        parsed = this.snapshotParser.parse(String(result.data));
+      }
+      const urlResult = this.executor.eval("window.location.href");
+      const titleResult = this.executor.eval("document.title");
+      if (urlResult.success) {
+        parsed.url = String(urlResult.data);
+      }
+      if (titleResult.success) {
+        parsed.title = String(titleResult.data);
+      }
+      return ok2(toTypedSnapshot(parsed));
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SNAPSHOT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Session Management (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Create a new isolated session
+   */
+  async createSession(name) {
+    try {
+      const session = await this.sessionManager.createSession({ name });
+      return ok2(toSessionInfo(session));
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SESSION_CREATE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Switch to an existing session
+   */
+  async switchSession(name) {
+    try {
+      this.sessionManager.switchSession(name);
+      this.currentSessionId = name;
+      this.executor = new AgentBrowserCommandExecutor({
+        sessionName: name,
+        timeout: this.config.timeout,
+        headed: this.config.headed,
+        debug: this.config.debug
+      });
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SESSION_SWITCH_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * List all available sessions
+   */
+  async listSessions() {
+    try {
+      const sessions = this.sessionManager.listSessions();
+      return ok2(sessions.map(toSessionInfo));
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SESSION_LIST_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Network Interception (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Mock network route
+   */
+  async mockRoute(urlPattern, response) {
+    try {
+      const mockBody = {
+        status: response.status ?? 200,
+        body: response.body,
+        headers: response.headers
+      };
+      const result = this.executor.mockRoute(urlPattern, mockBody);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Mock route failed", "MOCK_ROUTE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "MOCK_ROUTE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Abort requests matching a pattern
+   */
+  async abortRoute(urlPattern) {
+    try {
+      const result = this.executor.abortRoute(urlPattern);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Abort route failed", "ABORT_ROUTE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "ABORT_ROUTE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Clear all mocked routes
+   */
+  async clearRoutes() {
+    try {
+      const result = this.executor.clearRoutes();
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Clear routes failed", "CLEAR_ROUTES_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "CLEAR_ROUTES_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Device Emulation (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Emulate a specific device
+   */
+  async setDevice(deviceName) {
+    try {
+      const result = this.executor.setDevice(deviceName);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Set device failed", "SET_DEVICE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SET_DEVICE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Set custom viewport dimensions
+   */
+  async setViewport(width, height) {
+    try {
+      const result = this.executor.setViewport(width, height);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Set viewport failed", "SET_VIEWPORT_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SET_VIEWPORT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Authentication State Persistence (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Save browser state (cookies, storage, etc.)
+   */
+  async saveState(path13) {
+    try {
+      const result = this.executor.saveState(path13);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Save state failed", "SAVE_STATE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "SAVE_STATE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Load previously saved browser state
+   */
+  async loadState(path13) {
+    try {
+      const result = this.executor.loadState(path13);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Load state failed", "LOAD_STATE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "LOAD_STATE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Advanced Wait Strategies (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Wait for an element to be present
+   */
+  async waitForElement(target, timeout) {
+    try {
+      const resolvedTarget = resolveTarget(target);
+      const result = this.executor.waitForElement(resolvedTarget, timeout);
+      if (!result.success) {
+        return err2(
+          new BrowserTimeoutError("agent-browser", `waitForElement(${resolvedTarget})`, new Error(result.error))
+        );
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "WAIT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Wait for text to appear on page
+   */
+  async waitForText(text, timeout) {
+    try {
+      void timeout;
+      const result = this.executor.waitForText(text);
+      if (!result.success) {
+        return err2(new BrowserTimeoutError("agent-browser", `waitForText("${text}")`, new Error(result.error)));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "WAIT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Wait for URL to match pattern
+   */
+  async waitForUrl(pattern, timeout) {
+    try {
+      void timeout;
+      const result = this.executor.waitForUrl(pattern);
+      if (!result.success) {
+        return err2(new BrowserTimeoutError("agent-browser", `waitForUrl("${pattern}")`, new Error(result.error)));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "WAIT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Wait for network to idle
+   */
+  async waitForNetworkIdle(timeout) {
+    try {
+      void timeout;
+      const result = this.executor.waitForNetworkIdle();
+      if (!result.success) {
+        return err2(new BrowserTimeoutError("agent-browser", "waitForNetworkIdle", new Error(result.error)));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "WAIT_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  // ==========================================================================
+  // Trace Recording (agent-browser specific)
+  // ==========================================================================
+  /**
+   * Start trace recording
+   *
+   * Records browser activity including network requests, console logs,
+   * and user interactions. Useful for debugging test failures.
+   */
+  async startTrace() {
+    try {
+      const result = this.executor.startTrace();
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Start trace failed", "START_TRACE_FAILED", "agent-browser"));
+      }
+      return ok2(void 0);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "START_TRACE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+  /**
+   * Stop trace recording and save to file
+   *
+   * @param outputPath - Path to save the trace file (.zip recommended)
+   * @returns Path where trace was saved
+   */
+  async stopTrace(outputPath) {
+    try {
+      const result = this.executor.stopTrace(outputPath);
+      if (!result.success) {
+        return err2(new BrowserError(result.error ?? "Stop trace failed", "STOP_TRACE_FAILED", "agent-browser"));
+      }
+      return ok2(result.data ?? outputPath);
+    } catch (error) {
+      return err2(
+        new BrowserError(
+          error instanceof Error ? error.message : String(error),
+          "STOP_TRACE_FAILED",
+          "agent-browser",
+          error instanceof Error ? error : void 0
+        )
+      );
+    }
+  }
+};
+
+// src/integrations/browser/client-factory.ts
+async function isVibiumAvailable() {
+  return false;
+}
+async function isAgentBrowserAvailable2() {
+  try {
+    const client = new AgentBrowserClient();
+    return await client.isAvailable();
+  } catch {
+    return false;
+  }
+}
+var AGENT_BROWSER_REQUIRED_USE_CASES = [
+  "e2e-testing",
+  // Requires refs and sessions
+  "api-mocking",
+  // Only agent-browser supports network interception
+  "responsive-testing",
+  // Requires device emulation
+  "auth-testing"
+  // Requires state persistence
+];
+function requiresAgentBrowser(useCase) {
+  return AGENT_BROWSER_REQUIRED_USE_CASES.includes(useCase);
+}
+var VibiumClientStub = class {
+  tool = "vibium";
+  async isAvailable() {
+    return false;
+  }
+  async launch() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async quit() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async navigate() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async reload() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async goBack() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async goForward() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async click() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async fill() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async getText() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async isVisible() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async screenshot() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async evaluate() {
+    return {
+      success: false,
+      error: new BrowserUnavailableError("vibium", "Vibium client not yet implemented")
+    };
+  }
+  async dispose() {
+  }
+};
+async function createBrowserClient(options = {}) {
+  const { preference = "auto", useCase } = options;
+  if (useCase && requiresAgentBrowser(useCase)) {
+    return createAgentBrowserClient();
+  }
+  if (preference === "agent-browser") {
+    return createAgentBrowserClient();
+  }
+  if (preference === "vibium") {
+    const available = await isVibiumAvailable();
+    if (available) {
+      return new VibiumClientStub();
+    }
+    throw new BrowserUnavailableError("vibium", "Vibium is not available");
+  }
+  const vibiumAvailable = await isVibiumAvailable();
+  if (vibiumAvailable) {
+    return new VibiumClientStub();
+  }
+  const agentBrowserAvailable = await isAgentBrowserAvailable2();
+  if (agentBrowserAvailable) {
+    return createAgentBrowserClient();
+  }
+  return createAgentBrowserClient();
+}
+async function createAgentBrowserClient() {
+  return new AgentBrowserClient();
+}
+async function getBrowserClientForUseCase(useCase) {
+  return createBrowserClient({ useCase });
+}
+
 // src/domains/test-execution/types/e2e-step.types.ts
 var E2EStepType = {
   /** Navigate to a URL */
@@ -16994,7 +18894,9 @@ var DEFAULT_E2E_RUNNER_CONFIG = {
   stopOnFirstFailure: false,
   pollingInterval: 100,
   maxParallelWorkers: 4,
-  verbose: false
+  verbose: false,
+  preferAgentBrowser: true,
+  browserClientType: "auto"
 };
 var E2ERunnerError = class extends Error {
   constructor(message, code, stepId, cause) {
@@ -17019,17 +18921,102 @@ var AssertionError = class extends E2ERunnerError {
     this.name = "AssertionError";
   }
 };
+function isAgentBrowserClient(client) {
+  return "tool" in client && client.tool === "agent-browser";
+}
+function isVibiumClient(client) {
+  return !("tool" in client) || !client.tool;
+}
+function toElementTarget(selector) {
+  if (/^@?e\d+$/.test(selector)) {
+    const value = selector.startsWith("@") ? selector : `@${selector}`;
+    return { type: "ref", value };
+  }
+  if (selector.startsWith("//") || selector.startsWith("xpath=")) {
+    const value = selector.replace(/^xpath=/, "");
+    return { type: "xpath", value };
+  }
+  if (selector.startsWith("text=")) {
+    const value = selector.replace(/^text=/, "");
+    return { type: "text", value };
+  }
+  return { type: "css", value: selector };
+}
+function toVibiumScreenshotResult(result) {
+  return {
+    base64: result.base64,
+    path: result.path,
+    format: result.format,
+    dimensions: result.dimensions,
+    sizeBytes: result.base64 ? Math.ceil(result.base64.length * 0.75) : 0,
+    // Estimate size from base64
+    capturedAt: /* @__PURE__ */ new Date()
+  };
+}
+function toVibiumAccessibilityResult(axeResults) {
+  const violationsBySeverity = {
+    critical: 0,
+    high: 0,
+    medium: 0,
+    low: 0,
+    info: 0
+  };
+  const violations = axeResults.violations.map((v) => {
+    const impact = v.impact;
+    if (impact in violationsBySeverity) {
+      violationsBySeverity[impact]++;
+    }
+    return {
+      id: v.id,
+      impact: v.impact,
+      description: v.description,
+      nodes: v.nodes.length
+    };
+  });
+  return {
+    passes: violations.length === 0,
+    violations,
+    violationsBySeverity,
+    passedRules: axeResults.passes.map((p) => p.id),
+    incompleteRules: axeResults.incomplete.map((i) => i.id),
+    checkedAt: /* @__PURE__ */ new Date()
+  };
+}
 var E2ETestRunnerService = class {
   /**
    * Create E2E Test Runner Service
-   * @param client - Vibium browser automation client (dependency injection)
+   *
+   * @param client - Browser automation client (VibiumClient or IBrowserClient)
    * @param config - Runner configuration
+   *
+   * @example
+   * ```typescript
+   * // Using VibiumClient (legacy)
+   * const vibiumClient = await createVibiumClient({ enabled: true });
+   * const runner = new E2ETestRunnerService(vibiumClient);
+   *
+   * // Using agent-browser (recommended for E2E)
+   * const agentClient = await createAgentBrowserClient();
+   * const runner = new E2ETestRunnerService(agentClient, {
+   *   preferAgentBrowser: true
+   * });
+   *
+   * // Using auto-selection
+   * const runner = createE2ETestRunnerServiceWithBrowserClient(undefined, {
+   *   browserClientType: 'auto'
+   * });
+   * ```
    */
   constructor(client, config = {}) {
     this.client = client;
     this.config = { ...DEFAULT_E2E_RUNNER_CONFIG, ...config };
+    this.unifiedClient = config.browserClient ?? client;
+    this.useAgentBrowser = isAgentBrowserClient(this.unifiedClient);
+    this.log(`E2E Runner initialized with ${this.useAgentBrowser ? "agent-browser" : "vibium"} client`);
   }
   config;
+  unifiedClient;
+  useAgentBrowser;
   // ==========================================================================
   // Public Methods
   // ==========================================================================
@@ -17055,27 +19042,20 @@ var E2ETestRunnerService = class {
       }
     }
     try {
-      const session = await this.client.getSession();
-      if (!session) {
-        const launchResult = await this.client.launch({
-          headless: true,
-          viewport: testCase.viewport,
-          ...this.getBrowserContextOptions(testCase)
-        });
-        if (!launchResult.success) {
-          return this.createErrorResult(
-            testCase,
-            startedAt,
-            `Failed to launch browser: ${launchResult.error.message}`
-          );
-        }
+      const launchError = await this.ensureBrowserLaunched(testCase);
+      if (launchError) {
+        return this.createErrorResult(testCase, startedAt, launchError);
       }
       const context2 = {
         testCase,
         baseUrl: testCase.baseUrl,
         variables: testCase.testData ?? {},
-        previousResults: stepResults
+        previousResults: stepResults,
+        useAgentBrowser: this.useAgentBrowser
       };
+      if (this.useAgentBrowser) {
+        context2.currentSnapshot = await this.refreshSnapshot();
+      }
       if (testCase.hooks?.beforeAll) {
         const hookResults = await this.executeHooks(
           testCase.hooks.beforeAll,
@@ -17189,14 +19169,95 @@ var E2ETestRunnerService = class {
     };
   }
   // ==========================================================================
+  // Browser Launch Helper
+  // ==========================================================================
+  /**
+   * Ensure browser is launched for the test case
+   * Handles both agent-browser and Vibium clients
+   */
+  async ensureBrowserLaunched(testCase) {
+    try {
+      if (this.useAgentBrowser && isAgentBrowserClient(this.unifiedClient)) {
+        const launchResult = await this.unifiedClient.launch({
+          headless: true,
+          viewport: testCase.viewport
+          // Use client's default session name, not test-specific
+        });
+        if (!launchResult.success) {
+          return `Failed to launch browser: ${launchResult.error.message}`;
+        }
+        return null;
+      } else if (isVibiumClient(this.client)) {
+        const session = await this.client.getSession();
+        if (!session) {
+          const launchResult = await this.client.launch({
+            headless: true,
+            viewport: testCase.viewport,
+            ...this.getBrowserContextOptions(testCase)
+          });
+          if (!launchResult.success) {
+            return `Failed to launch browser: ${launchResult.error.message}`;
+          }
+        }
+        return null;
+      } else {
+        const launchResult = await this.unifiedClient.launch({
+          headless: true,
+          viewport: testCase.viewport
+        });
+        if (!launchResult.success) {
+          return `Failed to launch browser: ${launchResult.error.message}`;
+        }
+        return null;
+      }
+    } catch (error) {
+      return error instanceof Error ? error.message : String(error);
+    }
+  }
+  /**
+   * Refresh the page snapshot (agent-browser only)
+   */
+  async refreshSnapshot() {
+    if (!this.useAgentBrowser || !isAgentBrowserClient(this.unifiedClient)) {
+      return void 0;
+    }
+    try {
+      const snapshotResult = await this.unifiedClient.getSnapshot({ interactive: true });
+      if (snapshotResult.success) {
+        return snapshotResult.value;
+      }
+    } catch {
+      this.log("Failed to refresh snapshot");
+    }
+    return void 0;
+  }
+  // ==========================================================================
   // Step Executors
   // ==========================================================================
   /**
    * Execute a navigate step
+   * Supports both agent-browser and Vibium clients
    */
   async executeNavigateStep(step, client, context2) {
     const url = this.resolveUrl(step.target, context2.baseUrl);
-    const result = await client.navigate({
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const result2 = await browserClient.navigate(url);
+      if (!result2.success) {
+        throw result2.error;
+      }
+      if (context2.useAgentBrowser) {
+        context2.currentSnapshot = await this.refreshSnapshot();
+      }
+      return {
+        data: {
+          url: result2.value.url,
+          title: result2.value.title
+        }
+      };
+    }
+    const vibiumClient = client;
+    const result = await vibiumClient.navigate({
       url,
       waitUntil: step.options?.waitUntil ?? "load",
       timeout: step.timeout ?? this.config.defaultStepTimeout
@@ -17213,18 +19274,43 @@ var E2ETestRunnerService = class {
   }
   /**
    * Execute a click step
+   * Supports both agent-browser and Vibium clients
    */
-  async executeClickStep(step, client, _context) {
+  async executeClickStep(step, client, context2) {
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const target = toElementTarget(step.target);
+      if (context2.useAgentBrowser && isAgentBrowserClient(browserClient)) {
+        const waitResult = await browserClient.waitForElement(target, step.timeout);
+        if (!waitResult.success) {
+          throw waitResult.error;
+        }
+      }
+      const result2 = await browserClient.click(target);
+      if (!result2.success) {
+        throw result2.error;
+      }
+      if (context2.useAgentBrowser) {
+        context2.currentSnapshot = await this.refreshSnapshot();
+      }
+      if (step.options?.waitForNavigation && isAgentBrowserClient(browserClient)) {
+        await browserClient.waitForNetworkIdle(step.timeout);
+      }
+      return {
+        data: {}
+      };
+    }
+    const vibiumClient = client;
     if (step.options?.scrollIntoView) {
-      await this.scrollIntoView(client, step.target);
+      await this.scrollIntoView(vibiumClient, step.target);
     }
     if (step.options?.hoverFirst) {
-      const findResult = await client.findElement({ selector: step.target });
+      const findResult = await vibiumClient.findElement({ selector: step.target });
       if (!findResult.success) {
         throw findResult.error;
       }
     }
-    const result = await client.click({
+    const result = await vibiumClient.click({
       selector: step.target,
       button: step.options?.button,
       clickCount: step.options?.clickCount,
@@ -17239,7 +19325,7 @@ var E2ETestRunnerService = class {
     }
     if (step.options?.waitForNavigation) {
       await this.delay(500);
-      const pageInfo = await client.getPageInfo();
+      const pageInfo = await vibiumClient.getPageInfo();
       if (pageInfo.success) {
         return {
           data: {
@@ -17256,9 +19342,33 @@ var E2ETestRunnerService = class {
   }
   /**
    * Execute a type step
+   * Supports both agent-browser and Vibium clients
    */
-  async executeTypeStep(step, client, _context) {
-    const result = await client.type({
+  async executeTypeStep(step, client, context2) {
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const target = toElementTarget(step.target);
+      if (context2.useAgentBrowser && isAgentBrowserClient(browserClient)) {
+        const waitResult = await browserClient.waitForElement(target, step.timeout);
+        if (!waitResult.success) {
+          throw waitResult.error;
+        }
+      }
+      const result2 = await browserClient.fill(target, step.value);
+      if (!result2.success) {
+        throw result2.error;
+      }
+      if (context2.useAgentBrowser) {
+        context2.currentSnapshot = await this.refreshSnapshot();
+      }
+      return {
+        data: {
+          elementText: step.options?.sensitive ? "[MASKED]" : step.value
+        }
+      };
+    }
+    const vibiumClient = client;
+    const result = await vibiumClient.type({
       selector: step.target,
       text: step.value,
       delay: step.options?.delay,
@@ -17277,11 +19387,51 @@ var E2ETestRunnerService = class {
   }
   /**
    * Execute a wait step
+   * Supports both agent-browser and Vibium clients
    */
-  async executeWaitStep(step, client, _context) {
+  async executeWaitStep(step, client, context2) {
     const timeout = step.timeout ?? this.config.defaultStepTimeout;
     const pollingInterval = step.options.pollingInterval ?? this.config.pollingInterval;
-    const waitResult = await this.waitForCondition(
+    if (!isVibiumClient(client) && isAgentBrowserClient(client)) {
+      const browserClient = client;
+      let waitResult;
+      switch (step.options.condition) {
+        case "element-visible":
+        case "element-hidden":
+          if (step.target) {
+            waitResult = await browserClient.waitForElement(toElementTarget(step.target), timeout);
+          }
+          break;
+        case "element-text":
+          if (step.options.expectedText) {
+            waitResult = await browserClient.waitForText(step.options.expectedText, timeout);
+          }
+          break;
+        case "url-match":
+          if (step.options.urlPattern) {
+            const pattern = typeof step.options.urlPattern === "string" ? step.options.urlPattern : step.options.urlPattern.source;
+            waitResult = await browserClient.waitForUrl(pattern, timeout);
+          }
+          break;
+        case "network-idle":
+        case "page-loaded":
+        case "dom-loaded":
+          waitResult = await browserClient.waitForNetworkIdle(timeout);
+          break;
+        default:
+          break;
+      }
+      if (waitResult && !waitResult.success) {
+        throw waitResult.error;
+      }
+      context2.currentSnapshot = await this.refreshSnapshot();
+      return { data: {} };
+    }
+    if (!isVibiumClient(client)) {
+      await this.delay(pollingInterval);
+      return { data: {} };
+    }
+    const waitData = await this.waitForCondition(
       step.options.condition,
       client,
       step,
@@ -17289,16 +19439,33 @@ var E2ETestRunnerService = class {
       pollingInterval
     );
     return {
-      data: waitResult
+      data: waitData
     };
   }
   /**
    * Execute an assert step
-   */
-  async executeAssertStep(step, client, _context) {
+   * Supports both agent-browser and Vibium clients
+   */
+  async executeAssertStep(step, client, context2) {
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const assertResult2 = await this.performUnifiedAssertion(
+        step.options.assertion,
+        browserClient,
+        step,
+        context2
+      );
+      return {
+        data: {
+          actualValue: assertResult2.actual,
+          expectedValue: assertResult2.expected
+        }
+      };
+    }
+    const vibiumClient = client;
     const assertResult = await this.performAssertion(
       step.options.assertion,
-      client,
+      vibiumClient,
       step
     );
     return {
@@ -17310,9 +19477,28 @@ var E2ETestRunnerService = class {
   }
   /**
    * Execute a screenshot step
+   * Supports both agent-browser and Vibium clients
    */
   async executeScreenshotStep(step, client, _context) {
-    const result = await client.screenshot({
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const result2 = await browserClient.screenshot({
+        path: step.target,
+        fullPage: step.options?.fullPage
+      });
+      if (!result2.success) {
+        throw result2.error;
+      }
+      const screenshotResult = toVibiumScreenshotResult(result2.value);
+      return {
+        screenshot: screenshotResult,
+        data: {
+          url: result2.value.path
+        }
+      };
+    }
+    const vibiumClient = client;
+    const result = await vibiumClient.screenshot({
       selector: step.target,
       fullPage: step.options?.fullPage,
       format: step.options?.format,
@@ -17331,9 +19517,56 @@ var E2ETestRunnerService = class {
   }
   /**
    * Execute an accessibility check step
+   * Supports both agent-browser and Vibium clients
    */
   async executeA11yCheckStep(step, client, _context) {
-    const result = await client.checkAccessibility({
+    if (!isVibiumClient(client)) {
+      const browserClient = client;
+      const axeScript = `
+        (async () => {
+          if (!window.axe) {
+            const script = document.createElement('script');
+            script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.7.2/axe.min.js';
+            document.head.appendChild(script);
+            await new Promise(resolve => script.onload = resolve);
+          }
+          const results = await axe.run(${step.target ? `'${step.target}'` : "document"}, {
+            runOnly: ${JSON.stringify(step.options?.tags ?? ["wcag2a", "wcag2aa"])},
+          });
+          return JSON.stringify(results);
+        })()
+      `;
+      const evalResult = await browserClient.evaluate(axeScript);
+      if (!evalResult.success) {
+        throw evalResult.error;
+      }
+      const axeResults = JSON.parse(evalResult.value);
+      const a11yResult2 = toVibiumAccessibilityResult(axeResults);
+      if (step.options?.failOnSeverity) {
+        const severityOrder = {
+          critical: 0,
+          high: 1,
+          medium: 2,
+          low: 3,
+          info: 4
+        };
+        const threshold = severityOrder[step.options.failOnSeverity];
+        const violationsOverThreshold = axeResults.violations.filter(
+          (v) => severityOrder[v.impact] <= threshold
+        );
+        if (violationsOverThreshold.length > 0) {
+          throw new AssertionError(
+            `Accessibility violations found: ${violationsOverThreshold.length} at or above ${step.options.failOnSeverity}`,
+            step.id,
+            0,
+            violationsOverThreshold.length
+          );
+        }
+      }
+      return { accessibilityResult: a11yResult2 };
+    }
+    const vibiumClient = client;
+    const result = await vibiumClient.checkAccessibility({
       selector: step.target,
       wcagLevel: step.options?.wcagLevel ?? "AA",
       rules: step.options?.rules ? {
@@ -17472,7 +19705,188 @@ var E2ETestRunnerService = class {
   // Assertion Handlers
   // ==========================================================================
   /**
-   * Perform an assertion
+   * Perform an assertion using the unified browser client (IBrowserClient)
+   * Supports agent-browser and generic browser clients
+   */
+  async performUnifiedAssertion(assertion, client, step, _context) {
+    let actual;
+    const expected = step.options.expected ?? step.value;
+    switch (assertion) {
+      case "element-exists":
+      case "element-visible":
+      case "visible": {
+        if (step.target) {
+          const result = await client.isVisible(toElementTarget(step.target));
+          actual = result.success ? result.value : false;
+        } else {
+          actual = false;
+        }
+        this.assertCondition(actual === true, step, true, actual);
+        break;
+      }
+      case "element-not-exists":
+      case "element-hidden":
+      case "hidden": {
+        if (step.target) {
+          const result = await client.isVisible(toElementTarget(step.target));
+          actual = result.success ? !result.value : true;
+        } else {
+          actual = true;
+        }
+        this.assertCondition(actual === true, step, true, actual);
+        break;
+      }
+      case "element-text":
+      case "text": {
+        if (step.target) {
+          const result = await client.getText(toElementTarget(step.target));
+          if (!result.success) {
+            throw result.error;
+          }
+          actual = result.value;
+          this.assertTextMatch(actual, expected, step.options.operator, step);
+        }
+        break;
+      }
+      case "url-equals":
+      case "url-contains":
+      case "url-matches": {
+        const urlResult = await client.evaluate("window.location.href");
+        if (!urlResult.success) {
+          throw urlResult.error;
+        }
+        actual = urlResult.value;
+        if (assertion === "url-equals") {
+          this.assertCondition(actual === expected, step, expected, actual);
+        } else if (assertion === "url-contains") {
+          this.assertCondition(
+            actual.includes(expected),
+            step,
+            expected,
+            actual
+          );
+        } else {
+          const regex = new RegExp(expected);
+          this.assertCondition(regex.test(actual), step, expected, actual);
+        }
+        break;
+      }
+      case "title-equals":
+      case "title-contains": {
+        const titleResult = await client.evaluate("document.title");
+        if (!titleResult.success) {
+          throw titleResult.error;
+        }
+        actual = titleResult.value;
+        if (assertion === "title-equals") {
+          this.assertCondition(actual === expected, step, expected, actual);
+        } else {
+          this.assertCondition(
+            actual.includes(expected),
+            step,
+            expected,
+            actual
+          );
+        }
+        break;
+      }
+      case "page-has-text": {
+        const textResult = await client.evaluate(
+          `document.body.innerText.includes('${expected}')`
+        );
+        actual = textResult.success ? textResult.value : false;
+        this.assertCondition(actual === true, step, true, actual);
+        break;
+      }
+      case "element-attribute": {
+        if (step.target && step.options.attributeName) {
+          const attrResult = await client.evaluate(
+            `document.querySelector('${step.target}')?.getAttribute('${step.options.attributeName}')`
+          );
+          if (attrResult.success) {
+            actual = attrResult.value;
+            this.assertCondition(actual === expected, step, expected, actual);
+          } else {
+            throw attrResult.error;
+          }
+        }
+        break;
+      }
+      case "element-value": {
+        if (step.target) {
+          const valueResult = await client.evaluate(
+            `document.querySelector('${step.target}')?.value`
+          );
+          if (valueResult.success) {
+            actual = valueResult.value;
+            this.assertCondition(actual === expected, step, expected, actual);
+          } else {
+            throw valueResult.error;
+          }
+        }
+        break;
+      }
+      case "element-count": {
+        if (step.target) {
+          const countResult = await client.evaluate(
+            `document.querySelectorAll('${step.target}').length`
+          );
+          if (countResult.success) {
+            actual = countResult.value;
+            const expectedCount = step.options.count ?? expected;
+            this.assertNumericCondition(
+              actual,
+              expectedCount,
+              step.options.operator ?? "eq",
+              step
+            );
+          } else {
+            throw countResult.error;
+          }
+        }
+        break;
+      }
+      case "element-class": {
+        if (step.target && step.options.className) {
+          const classResult = await client.evaluate(
+            `document.querySelector('${step.target}')?.classList.contains('${step.options.className}')`
+          );
+          actual = classResult.success ? classResult.value : false;
+          this.assertCondition(actual === true, step, true, actual);
+        }
+        break;
+      }
+      case "element-enabled":
+      case "element-disabled": {
+        if (step.target) {
+          const enabledResult = await client.evaluate(
+            `!document.querySelector('${step.target}')?.disabled`
+          );
+          actual = enabledResult.success ? enabledResult.value : false;
+          if (assertion === "element-disabled") {
+            actual = !actual;
+          }
+          this.assertCondition(actual === true, step, true, actual);
+        }
+        break;
+      }
+      case "console-no-errors":
+        actual = true;
+        break;
+      case "custom":
+        actual = true;
+        break;
+      default:
+        throw new E2ERunnerError(
+          `Unsupported assertion type: ${assertion}`,
+          "UNSUPPORTED_ASSERTION",
+          step.id
+        );
+    }
+    return { actual, expected };
+  }
+  /**
+   * Perform an assertion (Legacy Vibium path)
    */
   async performAssertion(assertion, client, step) {
     let actual;
@@ -17701,20 +20115,21 @@ var E2ETestRunnerService = class {
         return { data: {} };
       }
     }
+    const client = this.unifiedClient;
     if (isNavigateStep(step)) {
-      return this.executeNavigateStep(step, this.client, context2);
+      return this.executeNavigateStep(step, client, context2);
     } else if (isClickStep(step)) {
-      return this.executeClickStep(step, this.client, context2);
+      return this.executeClickStep(step, client, context2);
     } else if (isTypeStep(step)) {
-      return this.executeTypeStep(step, this.client, context2);
+      return this.executeTypeStep(step, client, context2);
     } else if (isWaitStep(step)) {
-      return this.executeWaitStep(step, this.client, context2);
+      return this.executeWaitStep(step, client, context2);
     } else if (isAssertStep(step)) {
-      return this.executeAssertStep(step, this.client, context2);
+      return this.executeAssertStep(step, client, context2);
     } else if (isScreenshotStep(step)) {
-      return this.executeScreenshotStep(step, this.client, context2);
+      return this.executeScreenshotStep(step, client, context2);
     } else if (isA11yCheckStep(step)) {
-      return this.executeA11yCheckStep(step, this.client, context2);
+      return this.executeA11yCheckStep(step, client, context2);
     }
     const unknownStep = step;
     throw new E2ERunnerError(
@@ -17930,9 +20345,18 @@ var E2ETestRunnerService = class {
   }
   /**
    * Capture screenshot on failure
+   * Supports both agent-browser and Vibium clients
    */
   async captureFailureScreenshot(stepId) {
     try {
+      if (!isVibiumClient(this.unifiedClient)) {
+        const browserClient = this.unifiedClient;
+        const result2 = await browserClient.screenshot({ fullPage: true });
+        if (result2.success) {
+          return toVibiumScreenshotResult(result2.value);
+        }
+        return null;
+      }
       const result = await this.client.screenshot({
         fullPage: true,
         format: "png"
@@ -25737,13 +28161,13 @@ var QualityAssessmentPlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(type) {
     const health = this.getHealth();
@@ -28053,9 +30477,9 @@ var DefectIntelligenceCoordinator = class {
       await this.agentCoordinator.stop(agentResult.value);
       return result;
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -28635,13 +31059,13 @@ var DefectIntelligencePlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(_type) {
     const health = this.getHealth();
@@ -30451,12 +32875,12 @@ var RequirementsValidationCoordinator = class {
       }
       return ok(analysis);
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
       if (this.config.publishEvents) {
-        await this.publishValidationFailed(err2, "analyzeRequirement");
+        await this.publishValidationFailed(err3, "analyzeRequirement");
       }
-      return { success: false, error: err2 };
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -30526,9 +32950,9 @@ var RequirementsValidationCoordinator = class {
       }
       return ok(artifacts);
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -30611,9 +33035,9 @@ var RequirementsValidationCoordinator = class {
       }
       return ok(validation);
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   // ============================================================================
@@ -31371,13 +33795,13 @@ var RequirementsValidationPlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(_type) {
     const health = this.getHealth();
@@ -33080,7 +35504,7 @@ var DEFAULT_METRIC_CONFIG = {
 };
 
 // src/domains/code-intelligence/services/metric-collector/loc-counter.ts
-import { execSync, spawnSync } from "child_process";
+import { execSync as execSync3, spawnSync } from "child_process";
 import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync4 } from "fs";
 import { join as join5, extname } from "path";
 async function countLOC(projectPath, config = {}) {
@@ -33125,7 +35549,7 @@ async function tryClocCount(projectPath, config) {
   try {
     const excludeDirs = config.excludeDirs.join(",");
     const command = `cloc --json --exclude-dir=${excludeDirs} "${projectPath}"`;
-    const output = execSync(command, {
+    const output = execSync3(command, {
       encoding: "utf-8",
       timeout: config.timeout,
       maxBuffer: 10 * 1024 * 1024
@@ -33159,7 +35583,7 @@ async function tryTokeiCount(projectPath, config) {
   try {
     const excludeArgs = config.excludeDirs.map((dir) => `-e "${dir}"`).join(" ");
     const command = `tokei --output json ${excludeArgs} "${projectPath}"`;
-    const output = execSync(command, {
+    const output = execSync3(command, {
       encoding: "utf-8",
       timeout: config.timeout,
       maxBuffer: 10 * 1024 * 1024
@@ -33428,7 +35852,7 @@ function getBlockCommentEnd(ext) {
 }
 
 // src/domains/code-intelligence/services/metric-collector/test-counter.ts
-import { execSync as execSync2, spawnSync as spawnSync2 } from "child_process";
+import { execSync as execSync4, spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync6, readFileSync as readFileSync5, readdirSync as readdirSync2 } from "fs";
 import { join as join6, extname as extname2 } from "path";
 async function countTests(projectPath, config = {}) {
@@ -33541,7 +35965,7 @@ function checkTestRunners(projectPath) {
 }
 function countVitestTests(projectPath, config) {
   try {
-    const output = execSync2(
+    const output = execSync4(
       "npx vitest list --reporter=json 2>/dev/null",
       {
         cwd: projectPath,
@@ -33601,7 +36025,7 @@ function countTestsRecursive(tests) {
 }
 function countJestTests(projectPath, config) {
   try {
-    const output = execSync2(
+    const output = execSync4(
       "npx jest --listTests 2>/dev/null",
       {
         cwd: projectPath,
@@ -33627,7 +36051,7 @@ function countJestTests(projectPath, config) {
 }
 function countCargoTests(projectPath, config) {
   try {
-    const output = execSync2(
+    const output = execSync4(
       'cargo test --list 2>/dev/null || echo ""',
       {
         cwd: projectPath,
@@ -33661,7 +36085,7 @@ function countCargoTests(projectPath, config) {
 }
 function countPytestTests(projectPath, config) {
   try {
-    const output = execSync2(
+    const output = execSync4(
       'pytest --collect-only -q 2>/dev/null || echo ""',
       {
         cwd: projectPath,
@@ -33702,7 +36126,7 @@ function countPytestTests(projectPath, config) {
 }
 function countGoTests(projectPath, config) {
   try {
-    const output = execSync2(
+    const output = execSync4(
       'go test -list ".*" ./... 2>/dev/null || echo ""',
       {
         cwd: projectPath,
@@ -35301,13 +37725,13 @@ var CodeIntelligencePlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(_operation, _result) {
     const health = this.getHealth();
@@ -42067,9 +44491,9 @@ var SecurityComplianceCoordinator = class {
       await this.agentCoordinator.stop(agentResult.value);
       return result;
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -42094,9 +44518,9 @@ var SecurityComplianceCoordinator = class {
       }
       return result;
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -42122,9 +44546,9 @@ var SecurityComplianceCoordinator = class {
       }
       return result;
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -42150,9 +44574,9 @@ var SecurityComplianceCoordinator = class {
         return result;
       }
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -42822,13 +45246,13 @@ var SecurityCompliancePlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(operation) {
     const health = this.getHealth();
@@ -47134,13 +49558,13 @@ var ContractTestingPlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(_operation) {
     const health = this.getHealth();
@@ -47667,7 +50091,9 @@ var DEFAULT_CONFIG36 = {
   browserConfig: {
     headless: true,
     timeout: 3e4
-  }
+  },
+  browserClient: void 0,
+  preferAgentBrowser: true
 };
 var WCAG_CRITERIA = {
   "1.1.1": { id: "1.1.1", level: "A", title: "Non-text Content" },
@@ -47691,35 +50117,49 @@ var AccessibilityTesterService = class {
    *
    * @param memory - Memory backend for storing audit results
    * @param config - Service configuration options
-   * @param vibiumClient - Optional Vibium client for browser-based testing
+   * @param vibiumClient - Optional Vibium client for browser-based testing (legacy)
    */
   constructor(memory, config = {}, vibiumClient) {
     this.memory = memory;
     this.config = { ...DEFAULT_CONFIG36, ...config };
     this.rules = this.initializeRules();
     this.vibiumClient = vibiumClient ?? null;
+    this.browserClient = config.browserClient ?? null;
   }
   config;
   rules;
   vibiumClient;
+  browserClient;
+  managedBrowserClient = null;
   /**
    * Check if browser mode is available and enabled
    *
    * Browser mode requires:
-   * 1. useBrowserMode feature flag enabled
-   * 2. VibiumClient instance provided
-   * 3. axe-core feature flag enabled (for accessibility checks)
+   * 1. useBrowserMode config setting enabled
+   * 2. Browser client (IBrowserClient) or VibiumClient instance provided
+   * 3. Feature flags enabled (if using Vibium)
+   *
+   * Priority order:
+   * 1. Provided browserClient (from config)
+   * 2. agent-browser (if preferAgentBrowser is true)
+   * 3. Vibium (if available and feature flags enabled)
    *
    * @returns true if browser mode should be used
    */
   shouldUseBrowserMode() {
-    if (!isBrowserModeEnabled()) {
+    if (!this.config.useBrowserMode) {
       return false;
     }
-    if (!isAxeCoreEnabled()) {
+    if (this.browserClient) {
+      return true;
+    }
+    if (this.config.preferAgentBrowser) {
+      return true;
+    }
+    if (!isBrowserModeEnabled()) {
       return false;
     }
-    if (!this.config.useBrowserMode) {
+    if (!isAxeCoreEnabled()) {
       return false;
     }
     if (!this.vibiumClient) {
@@ -47727,11 +50167,45 @@ var AccessibilityTesterService = class {
     }
     return true;
   }
+  /**
+   * Get or create a browser client for accessibility testing
+   * Prefers agent-browser, falls back to Vibium
+   *
+   * @returns Browser client or null if unavailable
+   */
+  async getBrowserClient() {
+    if (this.browserClient) {
+      return this.browserClient;
+    }
+    if (this.managedBrowserClient) {
+      return this.managedBrowserClient;
+    }
+    if (this.config.preferAgentBrowser) {
+      try {
+        const client = await getBrowserClientForUseCase("accessibility");
+        const available = await client.isAvailable();
+        if (available) {
+          this.managedBrowserClient = client;
+          return client;
+        }
+      } catch {
+      }
+    }
+    return null;
+  }
+  /**
+   * Check if client is an IAgentBrowserClient (has getSnapshot method)
+   */
+  isAgentBrowserClient(client) {
+    return client.tool === "agent-browser" && "getSnapshot" in client;
+  }
   /**
    * Run full accessibility audit
    *
-   * Uses browser mode via Vibium if available and enabled, otherwise
-   * falls back to heuristic-based URL pattern analysis.
+   * Priority order for browser-based testing:
+   * 1. agent-browser (if preferAgentBrowser is true and available)
+   * 2. Vibium (if available and enabled via feature flags)
+   * 3. Heuristic mode (URL pattern analysis)
    *
    * @param url - URL to audit
    * @param options - Audit configuration options
@@ -47741,13 +50215,30 @@ var AccessibilityTesterService = class {
     try {
       const wcagLevel = options?.wcagLevel || this.config.defaultWCAGLevel;
       if (this.shouldUseBrowserMode()) {
-        const browserResult = await this.auditWithBrowser(url, wcagLevel, options);
-        if (browserResult.success) {
-          await this.storeReport(browserResult.value);
-          return browserResult;
+        const browserClient = await this.getBrowserClient();
+        if (browserClient) {
+          const browserResult = await this.auditWithBrowserClient(
+            browserClient,
+            url,
+            wcagLevel,
+            options
+          );
+          if (browserResult.success) {
+            await this.storeReport(browserResult.value);
+            return browserResult;
+          }
+          const errorMsg = this.getErrorMessage(browserResult);
+          console.warn(`Browser client audit failed: ${errorMsg}`);
+        }
+        if (this.vibiumClient && isBrowserModeEnabled() && isAxeCoreEnabled()) {
+          const vibiumResult = await this.auditWithBrowser(url, wcagLevel, options);
+          if (vibiumResult.success) {
+            await this.storeReport(vibiumResult.value);
+            return vibiumResult;
+          }
+          const errorMsg = this.getErrorMessage(vibiumResult);
+          console.warn(`Vibium audit failed, falling back to heuristic mode: ${errorMsg}`);
         }
-        const errorMsg = this.getErrorMessage(browserResult);
-        console.warn(`Browser mode audit failed, falling back to heuristic mode: ${errorMsg}`);
       }
       return this.auditWithHeuristics(url, wcagLevel, options);
     } catch (error) {
@@ -47755,7 +50246,208 @@ var AccessibilityTesterService = class {
     }
   }
   /**
-   * Run accessibility audit using browser via Vibium
+   * Run accessibility audit using unified browser client (agent-browser or other)
+   *
+   * This method uses the IBrowserClient interface for browser automation.
+   * For agent-browser, it uses getSnapshot() for element discovery and
+   * evaluate() to inject and run axe-core for accessibility testing.
+   *
+   * @param client - Browser client instance
+   * @param url - URL to audit
+   * @param wcagLevel - WCAG conformance level
+   * @param options - Audit options
+   * @returns AccessibilityReport from browser-based axe-core audit
+   */
+  async auditWithBrowserClient(client, url, wcagLevel, options) {
+    try {
+      const launchResult = await client.launch({
+        headless: this.config.browserConfig.headless
+      });
+      if (!launchResult.success) {
+        return err(new Error(`Failed to launch browser: ${launchResult.error?.message ?? "Unknown error"}`));
+      }
+      try {
+        const navResult = await client.navigate(url);
+        if (!navResult.success) {
+          return err(new Error(`Failed to navigate to ${url}: ${navResult.error?.message ?? "Unknown error"}`));
+        }
+        if (this.isAgentBrowserClient(client)) {
+          const snapshotResult = await client.getSnapshot({ interactive: true });
+          if (snapshotResult.success) {
+            const elementCount = snapshotResult.value.interactiveElements.length;
+            console.debug(`[AccessibilityTester] Found ${elementCount} interactive elements`);
+          }
+        }
+        const axeResult = await this.runAxeCore(client, wcagLevel, options);
+        if (!axeResult.success) {
+          return err(axeResult.error);
+        }
+        const report = this.mapAxeResultToReport(url, axeResult.value, wcagLevel);
+        return ok(report);
+      } finally {
+        await client.quit();
+      }
+    } catch (error) {
+      return err(error instanceof Error ? error : new Error(String(error)));
+    }
+  }
+  /**
+   * Inject and run axe-core in the browser context
+   *
+   * @param client - Browser client
+   * @param wcagLevel - WCAG conformance level
+   * @param options - Audit options
+   * @returns Axe-core results
+   */
+  async runAxeCore(client, wcagLevel, options) {
+    const tags = this.getAxeTagsForWcagLevel(wcagLevel);
+    const excludeSelectors = options?.excludeSelectors ?? [];
+    const axeScript = `
+      (async function() {
+        // Check if axe is already loaded
+        if (typeof axe === 'undefined') {
+          // Inject axe-core from CDN
+          const script = document.createElement('script');
+          script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.4/axe.min.js';
+          script.crossOrigin = 'anonymous';
+          document.head.appendChild(script);
+
+          // Wait for script to load
+          await new Promise((resolve, reject) => {
+            script.onload = resolve;
+            script.onerror = () => reject(new Error('Failed to load axe-core'));
+            setTimeout(() => reject(new Error('Timeout loading axe-core')), 10000);
+          });
+        }
+
+        // Configure and run axe
+        const config = {
+          runOnly: {
+            type: 'tag',
+            values: ${JSON.stringify(tags)}
+          },
+          exclude: ${JSON.stringify(excludeSelectors.map((s) => [s]))}
+        };
+
+        const results = await axe.run(document, config);
+
+        return JSON.stringify({
+          violations: results.violations.map(v => ({
+            id: v.id,
+            impact: v.impact,
+            description: v.description,
+            help: v.help,
+            helpUrl: v.helpUrl,
+            tags: v.tags,
+            nodes: v.nodes.map(n => ({
+              selector: n.target.join(' > '),
+              html: n.html,
+              target: n.target,
+              failureSummary: n.failureSummary
+            }))
+          })),
+          passes: results.passes.map(p => p.id),
+          incomplete: results.incomplete.map(i => i.id),
+          inapplicable: results.inapplicable.map(i => i.id)
+        });
+      })();
+    `;
+    const evalResult = await client.evaluate(axeScript);
+    if (!evalResult.success) {
+      return err(new Error(`Failed to run axe-core: ${evalResult.error?.message ?? "Unknown error"}`));
+    }
+    try {
+      const parsed = JSON.parse(evalResult.value);
+      return ok(parsed);
+    } catch (parseError) {
+      return err(new Error(`Failed to parse axe-core results: ${parseError}`));
+    }
+  }
+  /**
+   * Get axe-core tags for a WCAG conformance level
+   */
+  getAxeTagsForWcagLevel(level) {
+    const baseTags = ["wcag2a", "wcag21a", "wcag22a", "best-practice"];
+    if (level === "A") {
+      return baseTags;
+    }
+    const aaTags = [...baseTags, "wcag2aa", "wcag21aa", "wcag22aa"];
+    if (level === "AA") {
+      return aaTags;
+    }
+    return [...aaTags, "wcag2aaa", "wcag21aaa", "wcag22aaa"];
+  }
+  /**
+   * Map axe-core result to AccessibilityReport
+   */
+  mapAxeResultToReport(url, axeResult, wcagLevel) {
+    const violations = axeResult.violations.map((v) => ({
+      id: v.id,
+      impact: this.mapImpactSeverity(v.impact ?? "moderate"),
+      wcagCriteria: this.extractWcagCriteria(v.tags ?? [], wcagLevel),
+      description: v.description,
+      help: v.help,
+      helpUrl: v.helpUrl ?? `https://dequeuniversity.com/rules/axe/4.8/${v.id}`,
+      nodes: v.nodes.map((n) => ({
+        selector: n.selector,
+        html: n.html,
+        target: n.target,
+        failureSummary: n.failureSummary ?? ""
+      }))
+    }));
+    const passes = axeResult.passes.map((ruleId) => ({
+      id: ruleId,
+      description: `Rule ${ruleId} passed`,
+      nodes: 0
+    }));
+    const incomplete = axeResult.incomplete.map((ruleId) => ({
+      id: ruleId,
+      description: `Rule ${ruleId} requires manual review`,
+      reason: "Could not automatically determine compliance",
+      nodes: []
+    }));
+    const totalRules = violations.length + passes.length + incomplete.length;
+    const failedWeight = violations.reduce((sum, v) => {
+      const weights = { critical: 4, serious: 3, moderate: 2, minor: 1 };
+      return sum + weights[v.impact];
+    }, 0);
+    const maxWeight = totalRules * 4;
+    const score = totalRules > 0 ? Math.round((maxWeight - failedWeight) / maxWeight * 100) : 100;
+    return {
+      url,
+      timestamp: /* @__PURE__ */ new Date(),
+      violations,
+      passes,
+      incomplete,
+      score: Math.max(0, Math.min(100, score)),
+      wcagLevel
+    };
+  }
+  /**
+   * Extract WCAG criteria from axe-core tags
+   */
+  extractWcagCriteria(tags, defaultLevel) {
+    const criteria = [];
+    for (const tag of tags) {
+      const match = tag.match(/^wcag(\d)(\d)(\d)(\d)?$/);
+      if (match) {
+        const id = match[4] ? `${match[1]}.${match[2]}.${match[3]}${match[4]}` : `${match[1]}.${match[2]}.${match[3]}`;
+        const existing = WCAG_CRITERIA[id];
+        if (existing) {
+          criteria.push(existing);
+        } else {
+          criteria.push({
+            id,
+            level: defaultLevel,
+            title: `WCAG ${id}`
+          });
+        }
+      }
+    }
+    return criteria;
+  }
+  /**
+   * Run accessibility audit using browser via Vibium (legacy method)
    *
    * @param url - URL to audit
    * @param wcagLevel - WCAG conformance level
@@ -48867,6 +51559,16 @@ var AccessibilityTesterService = class {
     }
     return Math.abs(hash).toString(36);
   }
+  /**
+   * Dispose service resources
+   * Cleans up any managed browser clients
+   */
+  async dispose() {
+    if (this.managedBrowserClient) {
+      await this.managedBrowserClient.dispose();
+      this.managedBrowserClient = null;
+    }
+  }
 };
 
 // src/domains/visual-accessibility/services/responsive-tester.ts
@@ -49922,9 +52624,9 @@ var VisualAccessibilityCoordinator = class {
       await this.agentCoordinator.stop(agentResult.value);
       return ok(report);
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -49978,9 +52680,9 @@ var VisualAccessibilityCoordinator = class {
       await this.agentCoordinator.stop(agentResult.value);
       return ok(auditReport);
     } catch (error) {
-      const err2 = error instanceof Error ? error : new Error(String(error));
-      this.failWorkflow(workflowId, err2.message);
-      return { success: false, error: err2 };
+      const err3 = error instanceof Error ? error : new Error(String(error));
+      this.failWorkflow(workflowId, err3.message);
+      return { success: false, error: err3 };
     }
   }
   /**
@@ -50906,13 +53608,13 @@ var VisualAccessibilityPlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulTest(_type, _count) {
     const health = this.getHealth();
@@ -51327,10 +54029,10 @@ var ChaosEngineerService = class _ChaosEngineerService {
           socket.destroy();
           resolve7(true);
         });
-        socket.on("error", (err2) => {
+        socket.on("error", (err3) => {
           clearTimeout(timer);
           socket.destroy();
-          console.log(`TCP probe error: ${probe.name} -> ${err2.message}`);
+          console.log(`TCP probe error: ${probe.name} -> ${err3.message}`);
           resolve7(false);
         });
       } catch (error) {
@@ -54689,13 +57391,13 @@ var ChaosResiliencePlugin = class extends BaseDomainPlugin {
     }
   }
   handleError(error) {
-    const err2 = error instanceof Error ? error : new Error(String(error));
+    const err3 = error instanceof Error ? error : new Error(String(error));
     const currentHealth = this.getHealth();
     this.updateHealth({
-      errors: [...currentHealth.errors.slice(-9), err2.message],
+      errors: [...currentHealth.errors.slice(-9), err3.message],
       status: currentHealth.errors.length >= 5 ? "degraded" : currentHealth.status
     });
-    return { success: false, error: err2 };
+    return { success: false, error: err3 };
   }
   trackSuccessfulOperation(_type) {
     const health = this.getHealth();
@@ -61751,8 +64453,8 @@ var MinCutHealthMonitor = class {
         ...payload
       }
     };
-    this.eventBus.publish(event).catch((err2) => {
-      console.error("Failed to publish MinCut event:", err2);
+    this.eventBus.publish(event).catch((err3) => {
+      console.error("Failed to publish MinCut event:", err3);
     });
   }
 };
@@ -67518,13 +70220,13 @@ var InitOrchestrator = class {
         db.close();
         console.log(`  \u2713 Version ${version} written to memory.db`);
         return true;
-      } catch (err2) {
+      } catch (err3) {
         db.close();
-        console.warn(`  \u26A0 Could not write version: ${err2 instanceof Error ? err2.message : String(err2)}`);
+        console.warn(`  \u26A0 Could not write version: ${err3 instanceof Error ? err3.message : String(err3)}`);
         return false;
       }
-    } catch (err2) {
-      console.warn(`  \u26A0 Could not open memory.db: ${err2 instanceof Error ? err2.message : String(err2)}`);
+    } catch (err3) {
+      console.warn(`  \u26A0 Could not open memory.db: ${err3 instanceof Error ? err3.message : String(err3)}`);
       return false;
     }
   }
@@ -72530,8 +75232,8 @@ var TokenMetricsCollectorImpl = class {
     if (this.persistenceConfig.autoSaveIntervalMs > 0) {
       this.autoSaveTimer = setInterval(() => {
         if (this.isDirty) {
-          this.save().catch((err2) => {
-            console.warn("[TokenMetricsCollector] Auto-save failed:", err2);
+          this.save().catch((err3) => {
+            console.warn("[TokenMetricsCollector] Auto-save failed:", err3);
           });
         }
       }, this.persistenceConfig.autoSaveIntervalMs);
@@ -73304,10 +76006,10 @@ function parsePipelineFile(filePath) {
   let content;
   try {
     content = fs10.readFileSync(filePath, "utf-8");
-  } catch (err2) {
+  } catch (err3) {
     return {
       success: false,
-      errors: [`Failed to read file: ${err2}`]
+      errors: [`Failed to read file: ${err3}`]
     };
   }
   return parsePipelineContent(content, filePath);
@@ -73317,10 +76019,10 @@ function parsePipelineContent(content, sourcePath) {
   let parsed;
   try {
     parsed = parseYAMLContent(content);
-  } catch (err2) {
+  } catch (err3) {
     return {
       success: false,
-      errors: [`Invalid YAML syntax: ${err2}`]
+      errors: [`Invalid YAML syntax: ${err3}`]
     };
   }
   if (!parsed.name || typeof parsed.name !== "string") {
@@ -78159,13 +80861,13 @@ async function ensureInitialized() {
     ]);
     console.log(chalk8.green("\u2713 System ready\n"));
     return true;
-  } catch (err2) {
-    const error = err2;
+  } catch (err3) {
+    const error = err3;
     if (error.message.includes("timeout")) {
       console.error(chalk8.red("Initialization timed out after 30 seconds."));
       console.log(chalk8.yellow("Try running `aqe init` manually."));
     } else {
-      console.error(chalk8.red("Failed to auto-initialize:"), err2);
+      console.error(chalk8.red("Failed to auto-initialize:"), err3);
       console.log(chalk8.yellow("Try running `aqe init` manually."));
     }
     return false;
@@ -78186,6 +80888,7 @@ async function cleanupAndExit(code = 0) {
     if (context.kernel) {
       await context.kernel.dispose();
     }
+    UnifiedMemoryManager.resetInstance();
   } catch {
   }
   process.exit(code);
@@ -78382,7 +81085,7 @@ program.command("health").description("Check system health").option("-d, --domai
       if (health.errors.length > 0) {
         console.log(chalk8.red(`
   Errors:`));
-        health.errors.forEach((err2) => console.log(chalk8.red(`    \u2022 ${err2}`)));
+        health.errors.forEach((err3) => console.log(chalk8.red(`    \u2022 ${err3}`)));
       }
     } else {
       const health = context.queen.getHealth();
@@ -78684,7 +81387,7 @@ domainCmd.command("health <domain>").description("Get domain health").action(asy
     }
     if (health.errors.length > 0) {
       console.log(chalk8.red("\n  Errors:"));
-      health.errors.forEach((err2) => console.log(chalk8.red(`    \u2022 ${err2}`)));
+      health.errors.forEach((err3) => console.log(chalk8.red(`    \u2022 ${err3}`)));
     }
     console.log("");
   } catch (error) {
@@ -79132,7 +81835,7 @@ program.command("test").description("Test generation shortcut").argument("<actio
       console.log(chalk8.blue(`
 \u{1F9EA} Generating tests for ${target || "current directory"}...
 `));
-      const testGenAPI = context.kernel.getDomainAPI("test-generation");
+      const testGenAPI = await context.kernel.getDomainAPIAsync("test-generation");
       if (!testGenAPI) {
         console.log(chalk8.red("\u274C Test generation domain not available"));
         return;
@@ -79201,7 +81904,7 @@ program.command("test").description("Test generation shortcut").argument("<actio
       console.log(chalk8.blue(`
 \u{1F9EA} Executing tests in ${target || "current directory"}...
 `));
-      const testExecAPI = context.kernel.getDomainAPI("test-execution");
+      const testExecAPI = await context.kernel.getDomainAPIAsync("test-execution");
       if (!testExecAPI) {
         console.log(chalk8.red("\u274C Test execution domain not available"));
         return;
@@ -79293,8 +81996,8 @@ program.command("coverage").description("Coverage analysis shortcut").argument("
       detectGaps = true;
       threshold = wizardResult.threshold;
       console.log(chalk8.green("\n  Starting coverage analysis...\n"));
-    } catch (err2) {
-      console.error(chalk8.red("\n  Wizard error:"), err2);
+    } catch (err3) {
+      console.error(chalk8.red("\n  Wizard error:"), err3);
       await cleanupAndExit(1);
     }
   }
@@ -79303,7 +82006,7 @@ program.command("coverage").description("Coverage analysis shortcut").argument("
     console.log(chalk8.blue(`
   Analyzing coverage for ${analyzeTarget}...
 `));
-    const coverageAPI = context.kernel.getDomainAPI("coverage-analysis");
+    const coverageAPI = await context.kernel.getDomainAPIAsync("coverage-analysis");
     if (!coverageAPI) {
       console.log(chalk8.red("\u274C Coverage analysis domain not available"));
       return;
@@ -79482,7 +82185,7 @@ program.command("security").description("Security scanning shortcut").option("--
     console.log(chalk8.blue(`
 \u{1F512} Running security scan on ${options.target}...
 `));
-    const securityAPI = context.kernel.getDomainAPI("security-compliance");
+    const securityAPI = await context.kernel.getDomainAPIAsync("security-compliance");
     if (!securityAPI) {
       console.log(chalk8.red("\u274C Security domain not available"));
       return;
@@ -79568,15 +82271,15 @@ program.command("security").description("Security scanning shortcut").option("--
     }
     console.log(chalk8.green("\u2705 Security scan complete\n"));
     await cleanupAndExit(0);
-  } catch (err2) {
-    console.error(chalk8.red("\n\u274C Failed:"), err2);
+  } catch (err3) {
+    console.error(chalk8.red("\n\u274C Failed:"), err3);
     await cleanupAndExit(1);
   }
 });
 program.command("code").description("Code intelligence analysis").argument("<action>", "Action (index|search|impact|deps)").argument("[target]", "Target path or query").option("--depth <depth>", "Analysis depth", "3").option("--include-tests", "Include test files").action(async (action, target, options) => {
   if (!await ensureInitialized()) return;
   try {
-    const codeAPI = context.kernel.getDomainAPI("code-intelligence");
+    const codeAPI = await context.kernel.getDomainAPIAsync("code-intelligence");
     if (!codeAPI) {
       console.log(chalk8.red("\u274C Code intelligence domain not available"));
       return;
@@ -79631,8 +82334,8 @@ program.command("code").description("Code intelligence analysis").argument("<act
         if (idx.errors.length > 0) {
           console.log(chalk8.red(`
   Errors (${idx.errors.length}):`));
-          for (const err2 of idx.errors.slice(0, 5)) {
-            console.log(chalk8.red(`    ${err2.file}: ${err2.error}`));
+          for (const err3 of idx.errors.slice(0, 5)) {
+            console.log(chalk8.red(`    ${err3.file}: ${err3.error}`));
           }
         }
       } else {
@@ -79900,8 +82603,8 @@ migrateCmd.command("run").description("Run full migration from v2 to v3").option
       if (hasClaudeAgents) copyDir(claudeAgentDir, path13.join(backupDir, ".claude", "agents"));
       console.log(chalk8.green(`   \u2713 Backup created at .aqe-backup/
 `));
-    } catch (err2) {
-      console.log(chalk8.red(`   \u2717 Backup failed: ${err2}`));
+    } catch (err3) {
+      console.log(chalk8.red(`   \u2717 Backup failed: ${err3}`));
       await cleanupAndExit(1);
     }
   } else {
@@ -79916,8 +82619,8 @@ migrateCmd.command("run").description("Run full migration from v2 to v3").option
       fs13.mkdirSync(path13.join(v3Dir, "cache"), { recursive: true });
       fs13.mkdirSync(path13.join(v3Dir, "logs"), { recursive: true });
       console.log(chalk8.green("   \u2713 Directory structure created\n"));
-    } catch (err2) {
-      console.log(chalk8.red(`   \u2717 Failed: ${err2}
+    } catch (err3) {
+      console.log(chalk8.red(`   \u2717 Failed: ${err3}
 `));
       await cleanupAndExit(1);
     }
@@ -79938,8 +82641,8 @@ migrateCmd.command("run").description("Run full migration from v2 to v3").option
       const stats = fs13.statSync(v2Files.memoryDb);
       console.log(chalk8.green(`   \u2713 Memory database migrated (${(stats.size / 1024).toFixed(1)} KB)
 `));
-    } catch (err2) {
-      console.log(chalk8.red(`   \u2717 Migration failed: ${err2}
+    } catch (err3) {
+      console.log(chalk8.red(`   \u2717 Migration failed: ${err3}
 `));
     }
   } else if (options.target && options.target !== "memory") {
@@ -79991,8 +82694,8 @@ migrateCmd.command("run").description("Run full migration from v2 to v3").option
       const destConfig = path13.join(v3Dir, "config.json");
       fs13.writeFileSync(destConfig, JSON.stringify(v3Config, null, 2));
       console.log(chalk8.green("   \u2713 Configuration migrated\n"));
-    } catch (err2) {
-      console.log(chalk8.red(`   \u2717 Config migration failed: ${err2}
+    } catch (err3) {
+      console.log(chalk8.red(`   \u2717 Config migration failed: ${err3}
 `));
     }
   } else if (options.target && options.target !== "config") {
@@ -80025,8 +82728,8 @@ migrateCmd.command("run").description("Run full migration from v2 to v3").option
       }, null, 2));
       console.log(chalk8.green(`   \u2713 ${migratedCount} patterns migrated
 `));
-    } catch (err2) {
-      console.log(chalk8.red(`   \u2717 Pattern migration failed: ${err2}
+    } catch (err3) {
+      console.log(chalk8.red(`   \u2717 Pattern migration failed: ${err3}
 `));
     }
   } else if (options.skipPatterns) {
@@ -80079,8 +82782,8 @@ ${newFrontmatter}
         fs13.renameSync(v2FilePath, deprecatedPath);
         console.log(chalk8.gray(`   ${v2Name} \u2192 ${v3Name}`));
         migratedAgents++;
-      } catch (err2) {
-        console.log(chalk8.red(`   \u2717 ${v2Name}: ${err2}`));
+      } catch (err3) {
+        console.log(chalk8.red(`   \u2717 ${v2Name}: ${err3}`));
       }
     }
     if (migratedAgents > 0) {
@@ -80278,8 +82981,8 @@ ${newFrontmatter}
               console.log(chalk8.green(`   \u2713 Migrated ${v2Name} \u2192 ${v3Name}`));
               fixedCount++;
             }
-          } catch (err2) {
-            console.log(chalk8.red(`   \u2717 Failed to migrate ${v2Name}: ${err2}`));
+          } catch (err3) {
+            console.log(chalk8.red(`   \u2717 Failed to migrate ${v2Name}: ${err3}`));
           }
         }
       }
@@ -80404,8 +83107,8 @@ Installing completions for ${shellInfo.name}...
       fs13.writeFileSync(completionFile, script);
       console.log(chalk8.green(`Completions installed to: ${completionFile}`));
       console.log(chalk8.gray("\nRestart your shell or run: source ~/.config/fish/completions/aqe.fish\n"));
-    } catch (err2) {
-      console.log(chalk8.red(`Failed to install: ${err2}`));
+    } catch (err3) {
+      console.log(chalk8.red(`Failed to install: ${err3}`));
       console.log(chalk8.yellow("\nManual installation:"));
       console.log(getInstallInstructions("fish"));
     }