@_deep4wee/agent-lens 1.0.1 → 1.2.0

package/dist/plugins/a11y-tree/index.mjs

@@ -0,0 +1,155 @@
+// src/plugins/a11y-tree/index.ts
+import fs from "fs";
+import path from "path";
+
+// src/shared/api/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+
+// src/plugins/a11y-tree/formatter.ts
+function formatAccessibilityTree(node, depth = 0, options) {
+  if (!node) return "";
+  const indent = "  ".repeat(depth);
+  const parts = [`${indent}- role: **${node.role}**`];
+  if (node.name) {
+    parts.push(`"${node.name.replace(/"/g, '\\"')}"`);
+  }
+  const flags = [];
+  if (node.level !== void 0) flags.push(`level ${node.level}`);
+  if (node.disabled) flags.push("disabled");
+  if (node.required) flags.push("required");
+  if (node.focused) flags.push("focused");
+  if (node.checked !== void 0 && node.checked !== false) flags.push(`checked: ${String(node.checked)}`);
+  if (node.pressed !== void 0) flags.push(`pressed: ${String(node.pressed)}`);
+  if (node.selected) flags.push("selected");
+  if (node.value !== void 0 && node.value !== "") flags.push(`value: "${String(node.value)}"`);
+  if (flags.length > 0) {
+    parts.push(`[${flags.join(", ")}]`);
+  }
+  let result = parts.join(" ") + "\n";
+  if (node.children && node.children.length > 0) {
+    for (const child of node.children) {
+      if (options?.compact && !child.name && (!child.children || child.children.length === 0)) {
+        continue;
+      }
+      result += formatAccessibilityTree(child, depth + 1, options);
+    }
+  }
+  return result;
+}
+
+// src/plugins/a11y-tree/index.ts
+var STATE_A11Y_KEY = "latestA11yTree";
+async function extractDomAccessibilityTree(page, rootSelector) {
+  return await page.evaluate((selector) => {
+    function getRole(el) {
+      const explicit = el.getAttribute("role");
+      if (explicit) return explicit;
+      const tag = el.tagName.toLowerCase();
+      if (tag === "button") return "button";
+      if (tag === "a" && el.hasAttribute("href")) return "link";
+      if (tag === "input") {
+        const type = el.type || "text";
+        if (["checkbox", "radio"].includes(type)) return type;
+        if (["button", "submit", "reset"].includes(type)) return "button";
+        return "textbox";
+      }
+      if (tag === "textarea") return "textbox";
+      if (tag === "select") return "combobox";
+      if (["h1", "h2", "h3", "h4", "h5", "h6"].includes(tag)) return "heading";
+      if (tag === "nav") return "navigation";
+      if (tag === "main") return "main";
+      if (tag === "header") return "banner";
+      if (tag === "footer") return "contentinfo";
+      if (tag === "ul" || tag === "ol") return "list";
+      if (tag === "li") return "listitem";
+      if (tag === "table") return "table";
+      if (tag === "img") return "img";
+      return "";
+    }
+    function getName(el) {
+      const ariaLabel = el.getAttribute("aria-label");
+      if (ariaLabel) return ariaLabel.trim();
+      const placeholder = el.placeholder;
+      if (placeholder) return placeholder.trim();
+      const alt = el.getAttribute("alt");
+      if (alt) return alt.trim();
+      const tag = el.tagName.toLowerCase();
+      if (["button", "a", "h1", "h2", "h3", "h4", "h5", "h6"].includes(tag)) {
+        return (el.innerText || el.textContent || "").trim().slice(0, 80);
+      }
+      return "";
+    }
+    function walk(el) {
+      const htmlEl = el;
+      if (!htmlEl || htmlEl.nodeType !== 1) return null;
+      const style = window.getComputedStyle(htmlEl);
+      if (style.display === "none" || style.visibility === "hidden") return null;
+      const role = getRole(htmlEl);
+      const name = getName(htmlEl);
+      const children = [];
+      for (const child of Array.from(htmlEl.children)) {
+        const childNode = walk(child);
+        if (childNode) children.push(childNode);
+      }
+      if (!role && !name && children.length === 0) return null;
+      if (!role && !name) {
+        if (children.length === 1) return children[0];
+        return { role: "group", children };
+      }
+      const node = { role: role || "generic" };
+      if (name) node.name = name;
+      if (children.length > 0) node.children = children;
+      if (htmlEl.tagName.startsWith("H") && htmlEl.tagName.length === 2) {
+        node.level = parseInt(htmlEl.tagName[1], 10);
+      }
+      if (htmlEl.disabled) node.disabled = true;
+      if (htmlEl.hasAttribute("required")) node.required = true;
+      if (document.activeElement === htmlEl) node.focused = true;
+      return node;
+    }
+    const rootEl = selector ? document.querySelector(selector) : document.body;
+    return rootEl ? walk(rootEl) : null;
+  }, rootSelector);
+}
+var a11yTreePlugin = definePlugin({
+  name: "a11y-tree",
+  version: "1.0.0",
+  extendContext: (_ctx, page, hookContext) => {
+    return {
+      dumpAccessibilityTree: async (options) => {
+        console.log(`\u267F [a11y-tree] Capturing semantic accessibility tree...`);
+        const rootNode = await extractDomAccessibilityTree(page, options?.selector);
+        const markdown = formatAccessibilityTree(rootNode, 0, { compact: options?.compact ?? true });
+        if (hookContext.artifactsDir && options?.saveToFile !== false) {
+          const filePath = path.join(hookContext.artifactsDir, "a11y-tree.md");
+          fs.writeFileSync(filePath, markdown, "utf-8");
+          console.log(`\u267F [a11y-tree] Dump saved to: ${filePath}`);
+        }
+        hookContext.state.set(STATE_A11Y_KEY, markdown);
+        return markdown;
+      }
+    };
+  },
+  onAfterRun: (reportData, hookContext) => {
+    const tree = hookContext.state.get(STATE_A11Y_KEY);
+    if (tree && reportData.customSections) {
+      const truncated = tree.length > 3e3 ? tree.slice(0, 3e3) + "\n\n*...and more (see a11y-tree.md)*" : tree;
+      reportData.customSections.push({
+        title: "\u267F Accessibility Semantic Tree (for Text AI Agents)",
+        content: `> Clean semantic hierarchy for text models (GPT-4o-mini, Haiku, Ollama).
+
+\`\`\`markdown
+${truncated}
+\`\`\``
+      });
+    }
+  }
+});
+var a11y_tree_default = a11yTreePlugin;
+export {
+  a11yTreePlugin,
+  a11y_tree_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/plugins/a11y-tree/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/a11y-tree/index.ts","../../../src/shared/api/plugin.ts","../../../src/plugins/a11y-tree/formatter.ts"],"sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport type { Page } from 'playwright';\nimport { definePlugin, type AgentLensPlugin } from '../../shared/api/plugin';\nimport { formatAccessibilityTree, type AccessibilityNode } from './formatter';\n\nconst STATE_A11Y_KEY = 'latestA11yTree';\n\nexport interface DumpA11yOptions {\n  compact?: boolean;\n  selector?: string;\n  saveToFile?: boolean;\n}\n\nasync function extractDomAccessibilityTree(page: Page, rootSelector?: string): Promise<AccessibilityNode | null> {\n  return await page.evaluate((selector) => {\n    function getRole(el: HTMLElement): string {\n      const explicit = el.getAttribute('role');\n      if (explicit) return explicit;\n      const tag = el.tagName.toLowerCase();\n      if (tag === 'button') return 'button';\n      if (tag === 'a' && el.hasAttribute('href')) return 'link';\n      if (tag === 'input') {\n        const type = (el as HTMLInputElement).type || 'text';\n        if (['checkbox', 'radio'].includes(type)) return type;\n        if (['button', 'submit', 'reset'].includes(type)) return 'button';\n        return 'textbox';\n      }\n      if (tag === 'textarea') return 'textbox';\n      if (tag === 'select') return 'combobox';\n      if (['h1', 'h2', 'h3', 'h4', 'h5', 'h6'].includes(tag)) return 'heading';\n      if (tag === 'nav') return 'navigation';\n      if (tag === 'main') return 'main';\n      if (tag === 'header') return 'banner';\n      if (tag === 'footer') return 'contentinfo';\n      if (tag === 'ul' || tag === 'ol') return 'list';\n      if (tag === 'li') return 'listitem';\n      if (tag === 'table') return 'table';\n      if (tag === 'img') return 'img';\n      return '';\n    }\n\n    function getName(el: HTMLElement): string {\n      const ariaLabel = el.getAttribute('aria-label');\n      if (ariaLabel) return ariaLabel.trim();\n      const placeholder = (el as HTMLInputElement).placeholder;\n      if (placeholder) return placeholder.trim();\n      const alt = el.getAttribute('alt');\n      if (alt) return alt.trim();\n      const tag = el.tagName.toLowerCase();\n      if (['button', 'a', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6'].includes(tag)) {\n        return (el.innerText || el.textContent || '').trim().slice(0, 80);\n      }\n      return '';\n    }\n\n    function walk(el: Element): any {\n      const htmlEl = el as HTMLElement;\n      if (!htmlEl || htmlEl.nodeType !== 1) return null;\n\n      const style = window.getComputedStyle(htmlEl);\n      if (style.display === 'none' || style.visibility === 'hidden') return null;\n\n      const role = getRole(htmlEl);\n      const name = getName(htmlEl);\n\n      const children: any[] = [];\n      for (const child of Array.from(htmlEl.children)) {\n        const childNode = walk(child);\n        if (childNode) children.push(childNode);\n      }\n\n      if (!role && !name && children.length === 0) return null;\n\n      if (!role && !name) {\n        if (children.length === 1) return children[0];\n        return { role: 'group', children };\n      }\n\n      const node: any = { role: role || 'generic' };\n      if (name) node.name = name;\n      if (children.length > 0) node.children = children;\n\n      if (htmlEl.tagName.startsWith('H') && htmlEl.tagName.length === 2) {\n        node.level = parseInt(htmlEl.tagName[1], 10);\n      }\n      if ((htmlEl as any).disabled) node.disabled = true;\n      if (htmlEl.hasAttribute('required')) node.required = true;\n      if (document.activeElement === htmlEl) node.focused = true;\n\n      return node;\n    }\n\n    const rootEl = selector ? document.querySelector(selector) : document.body;\n    return rootEl ? walk(rootEl) : null;\n  }, rootSelector);\n}\n\nexport const a11yTreePlugin: AgentLensPlugin = definePlugin({\n  name: 'a11y-tree',\n  version: '1.0.0',\n\n  extendContext: (_ctx, page, hookContext) => {\n    return {\n      dumpAccessibilityTree: async (options?: DumpA11yOptions): Promise<string> => {\n        console.log(`♿ [a11y-tree] Capturing semantic accessibility tree...`);\n\n        const rootNode = await extractDomAccessibilityTree(page, options?.selector);\n        const markdown = formatAccessibilityTree(rootNode, 0, { compact: options?.compact ?? true });\n\n        if (hookContext.artifactsDir && options?.saveToFile !== false) {\n          const filePath = path.join(hookContext.artifactsDir, 'a11y-tree.md');\n          fs.writeFileSync(filePath, markdown, 'utf-8');\n          console.log(`♿ [a11y-tree] Dump saved to: ${filePath}`);\n        }\n\n        hookContext.state.set(STATE_A11Y_KEY, markdown);\n        return markdown;\n      }\n    };\n  },\n\n  onAfterRun: (reportData, hookContext) => {\n    const tree = hookContext.state.get(STATE_A11Y_KEY) as string | undefined;\n    if (tree && reportData.customSections) {\n      const truncated = tree.length > 3000 ? tree.slice(0, 3000) + '\\n\\n*...and more (see a11y-tree.md)*' : tree;\n      reportData.customSections.push({\n        title: '♿ Accessibility Semantic Tree (for Text AI Agents)',\n        content: `> Clean semantic hierarchy for text models (GPT-4o-mini, Haiku, Ollama).\\n\\n\\`\\`\\`markdown\\n${truncated}\\n\\`\\`\\``\n      });\n    }\n  }\n});\n\nexport default a11yTreePlugin;\n","import type { Page, BrowserContext, Browser } from 'playwright';\nimport type { TestContext, VisualScenario } from './dsl';\nimport type { ReportData } from '../types/report';\n\nexport interface DriverLaunchResult {\n  page: Page;\n  context: BrowserContext;\n  browser?: Browser;\n  stop?: () => Promise<void>;\n}\n\nexport interface PluginHookContext {\n  scenario?: VisualScenario;\n  targetMode: 'desktop' | 'preview' | string;\n  artifactsDir: string;\n  cliOptions?: Record<string, unknown>;\n  state: Map<string, unknown>;\n}\n\nexport interface AgentLensPlugin {\n  /** Unique plugin identifier (e.g. 'desktop-webview2', 'live-controller', 'mock-ipc') */\n  name: string;\n  version?: string;\n\n  /** Lifecycle hook: initial setup before drivers and scenarios start */\n  setup?: (context: PluginHookContext) => Promise<void> | void;\n\n  /**\n   * Microkernel driver hook: allows a plugin to provide a custom browser/page session\n   * (e.g., desktop WebView2 CDP connection, custom remote browser).\n   */\n  launchSession?: (\n    options: { currentViewport: { width: number; height: number }; headed?: boolean },\n    hookContext: PluginHookContext\n  ) => Promise<DriverLaunchResult | undefined>;\n\n  /** Lifecycle hook: called when browser context is ready */\n  onContextCreated?: (context: BrowserContext, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /** Lifecycle hook: called when the test page is created/navigated */\n  onPageCreated?: (page: Page, context: BrowserContext, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /**\n   * Context extension: inject custom methods or properties directly into TestContext (ctx)\n   */\n  extendContext?: (\n    ctx: TestContext,\n    page: Page,\n    hookContext: PluginHookContext\n  ) => Record<string, any> | Promise<Record<string, any>>;\n\n  /** Lifecycle hook: called after scenario runs and report data is calculated */\n  onAfterRun?: (reportData: ReportData, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /** Lifecycle hook: teardown and cleanup guaranteed to run */\n  teardown?: (hookContext: PluginHookContext) => Promise<void> | void;\n}\n\nexport function definePlugin(plugin: AgentLensPlugin): AgentLensPlugin {\n  return plugin;\n}","export interface AccessibilityNode {\n  role: string;\n  name?: string;\n  value?: string | number;\n  description?: string;\n  keyshortcuts?: string;\n  roledescription?: string;\n  valuetext?: string;\n  disabled?: boolean;\n  expanded?: boolean;\n  focused?: boolean;\n  modal?: boolean;\n  multiline?: boolean;\n  multiselectable?: boolean;\n  readonly?: boolean;\n  required?: boolean;\n  selected?: boolean;\n  checked?: boolean | 'mixed';\n  pressed?: boolean | 'mixed';\n  level?: number;\n  valuemin?: number;\n  valuemax?: number;\n  autocomplete?: string;\n  haspopup?: string;\n  invalid?: string;\n  orientation?: string;\n  children?: AccessibilityNode[];\n}\n\n/**\n * Format an accessibility tree node into clean, indented Markdown for text-based LLMs.\n */\nexport function formatAccessibilityTree(\n  node: AccessibilityNode | null,\n  depth = 0,\n  options?: { compact?: boolean }\n): string {\n  if (!node) return '';\n\n  const indent = '  '.repeat(depth);\n  const parts: string[] = [`${indent}- role: **${node.role}**`];\n\n  if (node.name) {\n    parts.push(`\"${node.name.replace(/\"/g, '\\\\\"')}\"`);\n  }\n\n  const flags: string[] = [];\n  if (node.level !== undefined) flags.push(`level ${node.level}`);\n  if (node.disabled) flags.push('disabled');\n  if (node.required) flags.push('required');\n  if (node.focused) flags.push('focused');\n  if (node.checked !== undefined && node.checked !== false) flags.push(`checked: ${String(node.checked)}`);\n  if (node.pressed !== undefined) flags.push(`pressed: ${String(node.pressed)}`);\n  if (node.selected) flags.push('selected');\n  if (node.value !== undefined && node.value !== '') flags.push(`value: \"${String(node.value)}\"`);\n\n  if (flags.length > 0) {\n    parts.push(`[${flags.join(', ')}]`);\n  }\n\n  let result = parts.join(' ') + '\\n';\n\n  if (node.children && node.children.length > 0) {\n    for (const child of node.children) {\n      if (options?.compact && !child.name && (!child.children || child.children.length === 0)) {\n        continue;\n      }\n      result += formatAccessibilityTree(child, depth + 1, options);\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/plugins/desktop-webview2/index.d.mts

@@ -0,0 +1,14 @@
+import { A as AgentLensPlugin } from '../../dsl-BIjVN1M0.mjs';
+import 'playwright';
+
+interface DesktopPluginOptions {
+    executablePath?: string;
+    port?: number;
+    autoLaunch?: boolean;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+declare const desktopWebview2Plugin: AgentLensPlugin;
+
+export { type DesktopPluginOptions, desktopWebview2Plugin as default, desktopWebview2Plugin };

package/dist/plugins/desktop-webview2/index.d.ts

@@ -0,0 +1,14 @@
+import { A as AgentLensPlugin } from '../../dsl-BIjVN1M0.js';
+import 'playwright';
+
+interface DesktopPluginOptions {
+    executablePath?: string;
+    port?: number;
+    autoLaunch?: boolean;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+declare const desktopWebview2Plugin: AgentLensPlugin;
+
+export { type DesktopPluginOptions, desktopWebview2Plugin as default, desktopWebview2Plugin };

package/dist/plugins/desktop-webview2/index.js

@@ -0,0 +1,258 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugins/desktop-webview2/index.ts
+var desktop_webview2_exports = {};
+__export(desktop_webview2_exports, {
+  default: () => desktop_webview2_default,
+  desktopWebview2Plugin: () => desktopWebview2Plugin
+});
+module.exports = __toCommonJS(desktop_webview2_exports);
+
+// src/shared/api/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+
+// src/plugins/desktop-webview2/driver.ts
+var import_child_process = require("child_process");
+var import_http = __toESM(require("http"));
+var import_path = __toESM(require("path"));
+var import_fs = __toESM(require("fs"));
+
+// src/shared/lib/playwrightLoader.ts
+var import_playwright = require("playwright");
+var chromium = new Proxy(import_playwright.chromium, {
+  get(target, prop, receiver) {
+    if (prop === "launch") {
+      return async (...args) => {
+        try {
+          return await target.launch(...args);
+        } catch (err) {
+          if (err.message?.includes("Executable doesn't exist") || err.message?.includes("playwright install") || err.message?.includes("browser has not been downloaded")) {
+            console.error("\n\u274C [AgentLens] Playwright Chromium browser binary is missing!");
+            console.error("\u{1F449} Please install it by running: npx playwright install chromium\n");
+          }
+          throw err;
+        }
+      };
+    }
+    const val = Reflect.get(target, prop, receiver);
+    return typeof val === "function" ? val.bind(target) : val;
+  }
+});
+
+// src/plugins/desktop-webview2/driver.ts
+var import_tree_kill = __toESM(require("tree-kill"));
+var DesktopDriver = class {
+  port;
+  executablePath;
+  autoLaunch;
+  args;
+  env;
+  cwd;
+  childProcess = null;
+  browser = null;
+  context = null;
+  page = null;
+  processStderr = "";
+  processExited = false;
+  exitCode = null;
+  constructor(options) {
+    this.port = options?.port || 9222;
+    this.autoLaunch = options?.autoLaunch ?? true;
+    this.executablePath = options?.executablePath;
+    this.args = options?.args || [];
+    this.env = options?.env || {};
+    this.cwd = options?.cwd;
+  }
+  async isPortAvailable() {
+    return new Promise((resolve) => {
+      const req = import_http.default.get(`http://127.0.0.1:${this.port}/json/version`, (res) => {
+        resolve(res.statusCode === 200);
+      });
+      req.on("error", () => resolve(false));
+      req.setTimeout(800, () => {
+        req.destroy();
+        resolve(false);
+      });
+    });
+  }
+  async waitForPort(timeoutMs = 25e3) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+      if (this.processExited) {
+        throw new Error(
+          `[DesktopDriver] Process terminated prematurely with exit code ${this.exitCode}.
+Stderr: ${this.processStderr.trim() || "(none)"}`
+        );
+      }
+      if (await this.isPortAvailable()) {
+        return;
+      }
+      await new Promise((r) => setTimeout(r, 400));
+    }
+    throw new Error(
+      `Timeout waiting for WebView2/Chromium CDP port ${this.port}. Last stderr:
+${this.processStderr.trim() || "(no stderr output)"}`
+    );
+  }
+  async start(initialViewport = { width: 1200, height: 800 }) {
+    const alreadyRunning = await this.isPortAvailable();
+    if (!alreadyRunning) {
+      if (!this.autoLaunch) {
+        throw new Error(
+          `App is not running on port ${this.port} and autoLaunch is false. Start app with WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=${this.port}`
+        );
+      }
+      if (!this.executablePath) {
+        throw new Error(
+          `[DesktopDriver] No executablePath provided and nothing is running on port ${this.port}. Specify --exe=<path> in CLI or executablePath in config.`
+        );
+      }
+      const resolvedExe = import_path.default.resolve(process.cwd(), this.executablePath);
+      if (!import_fs.default.existsSync(resolvedExe)) {
+        throw new Error(
+          `[DesktopDriver] Desktop executable not found at: ${resolvedExe}. Please build your native project first.`
+        );
+      }
+      console.log(`\u{1F680} [DesktopDriver] Launching: ${resolvedExe}`);
+      const finalArgs = [...this.args];
+      const hasDebugPort = finalArgs.some((a) => a.startsWith("--remote-debugging-port="));
+      if (!hasDebugPort) {
+        finalArgs.push(`--remote-debugging-port=${this.port}`);
+      }
+      const mergedEnv = {
+        ...process.env,
+        ...this.env,
+        WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS: `--remote-debugging-port=${this.port}`
+      };
+      this.processStderr = "";
+      this.processExited = false;
+      this.exitCode = null;
+      this.childProcess = (0, import_child_process.spawn)(resolvedExe, finalArgs, {
+        env: mergedEnv,
+        cwd: this.cwd || import_path.default.dirname(resolvedExe),
+        stdio: ["ignore", "ignore", "pipe"],
+        detached: false
+      });
+      this.childProcess.stderr?.on("data", (chunk) => {
+        this.processStderr += chunk.toString();
+      });
+      this.childProcess.on("exit", (code) => {
+        this.processExited = true;
+        this.exitCode = code;
+      });
+      this.childProcess.on("error", (err) => {
+        console.error("[DesktopDriver] Failed to spawn process:", err);
+      });
+      console.log(`\u23F3 [DesktopDriver] Waiting for CDP debugging port on ${this.port}...`);
+      await this.waitForPort();
+    } else {
+      console.log(`\u{1F50C} [DesktopDriver] Attached to already running process on port ${this.port}`);
+    }
+    console.log(`\u{1F310} [DesktopDriver] Connecting Playwright CDP to http://127.0.0.1:${this.port}...`);
+    this.browser = await chromium.connectOverCDP(`http://127.0.0.1:${this.port}`);
+    const contexts = this.browser.contexts();
+    this.context = contexts[0] || await this.browser.newContext();
+    const pages = this.context.pages();
+    if (pages.length > 0) {
+      this.page = pages[0];
+    } else {
+      this.page = await this.context.waitForEvent("page", { timeout: 1e4 });
+    }
+    if (initialViewport) {
+      await this.page.setViewportSize(initialViewport).catch(() => {
+      });
+    }
+    return { page: this.page, context: this.context, browser: this.browser };
+  }
+  async stop() {
+    if (this.browser) {
+      await this.browser.close().catch(() => {
+      });
+      this.browser = null;
+    }
+    if (this.childProcess && !this.childProcess.killed && this.childProcess.pid) {
+      console.log("\u{1F6D1} [DesktopDriver] Terminating spawned desktop process tree...");
+      const pid = this.childProcess.pid;
+      await new Promise((resolve) => {
+        (0, import_tree_kill.default)(pid, "SIGTERM", () => resolve());
+      });
+      this.childProcess = null;
+    }
+  }
+};
+
+// src/plugins/desktop-webview2/index.ts
+var activeDriver = null;
+var desktopWebview2Plugin = definePlugin({
+  name: "desktop-webview2",
+  version: "1.0.0",
+  launchSession: async (options, hookContext) => {
+    const cliOpts = hookContext.cliOptions || {};
+    const isDesktopMode = hookContext.targetMode === "desktop";
+    const hasExe = Boolean(cliOpts.executablePath || cliOpts.exe);
+    if (!isDesktopMode && !hasExe) {
+      return void 0;
+    }
+    console.log(`\u{1F50C} [Plugin:desktop-webview2] Initializing native desktop bridge...`);
+    const driver = new DesktopDriver({
+      executablePath: typeof cliOpts.executablePath === "string" ? cliOpts.executablePath : typeof cliOpts.exe === "string" ? cliOpts.exe : void 0,
+      port: typeof cliOpts.port === "number" ? cliOpts.port : 9222,
+      autoLaunch: typeof cliOpts.autoLaunchDesktop === "boolean" ? cliOpts.autoLaunchDesktop : true,
+      args: Array.isArray(cliOpts.desktopArgs) ? cliOpts.desktopArgs : void 0,
+      env: cliOpts.desktopEnv || void 0,
+      cwd: typeof cliOpts.startCwd === "string" ? cliOpts.startCwd : void 0
+    });
+    activeDriver = driver;
+    const session = await driver.start(options.currentViewport);
+    return {
+      page: session.page,
+      context: session.context,
+      browser: session.browser,
+      stop: async () => {
+        await driver.stop();
+        activeDriver = null;
+      }
+    };
+  },
+  teardown: async () => {
+    if (activeDriver) {
+      await activeDriver.stop();
+      activeDriver = null;
+    }
+  }
+});
+var desktop_webview2_default = desktopWebview2Plugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  desktopWebview2Plugin
+});
+//# sourceMappingURL=index.js.map

package/dist/plugins/desktop-webview2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/desktop-webview2/index.ts","../../../src/shared/api/plugin.ts","../../../src/plugins/desktop-webview2/driver.ts","../../../src/shared/lib/playwrightLoader.ts"],"sourcesContent":["import { definePlugin, type AgentLensPlugin } from '../../shared/api/plugin';\nimport { DesktopDriver } from './driver';\n\nexport interface DesktopPluginOptions {\n  executablePath?: string;\n  port?: number;\n  autoLaunch?: boolean;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n}\n\nlet activeDriver: DesktopDriver | null = null;\n\nexport const desktopWebview2Plugin: AgentLensPlugin = definePlugin({\n  name: 'desktop-webview2',\n  version: '1.0.0',\n\n  launchSession: async (options, hookContext) => {\n    // Only intercept if targetMode is desktop or an executable is explicitly provided\n    const cliOpts = hookContext.cliOptions || {};\n    const isDesktopMode = hookContext.targetMode === 'desktop';\n    const hasExe = Boolean(cliOpts.executablePath || cliOpts.exe);\n\n    if (!isDesktopMode && !hasExe) {\n      return undefined;\n    }\n\n    console.log(`🔌 [Plugin:desktop-webview2] Initializing native desktop bridge...`);\n\n    const driver = new DesktopDriver({\n      executablePath: typeof cliOpts.executablePath === 'string'\n        ? cliOpts.executablePath\n        : typeof cliOpts.exe === 'string'\n        ? cliOpts.exe\n        : undefined,\n      port: typeof cliOpts.port === 'number' ? cliOpts.port : 9222,\n      autoLaunch: typeof cliOpts.autoLaunchDesktop === 'boolean' ? cliOpts.autoLaunchDesktop : true,\n      args: Array.isArray(cliOpts.desktopArgs) ? (cliOpts.desktopArgs as string[]) : undefined,\n      env: (cliOpts.desktopEnv as Record<string, string>) || undefined,\n      cwd: typeof cliOpts.startCwd === 'string' ? cliOpts.startCwd : undefined\n    });\n\n    activeDriver = driver;\n    const session = await driver.start(options.currentViewport);\n\n    return {\n      page: session.page,\n      context: session.context,\n      browser: session.browser,\n      stop: async () => {\n        await driver.stop();\n        activeDriver = null;\n      }\n    };\n  },\n\n  teardown: async () => {\n    if (activeDriver) {\n      await activeDriver.stop();\n      activeDriver = null;\n    }\n  }\n});\n\nexport default desktopWebview2Plugin;\n","import type { Page, BrowserContext, Browser } from 'playwright';\nimport type { TestContext, VisualScenario } from './dsl';\nimport type { ReportData } from '../types/report';\n\nexport interface DriverLaunchResult {\n  page: Page;\n  context: BrowserContext;\n  browser?: Browser;\n  stop?: () => Promise<void>;\n}\n\nexport interface PluginHookContext {\n  scenario?: VisualScenario;\n  targetMode: 'desktop' | 'preview' | string;\n  artifactsDir: string;\n  cliOptions?: Record<string, unknown>;\n  state: Map<string, unknown>;\n}\n\nexport interface AgentLensPlugin {\n  /** Unique plugin identifier (e.g. 'desktop-webview2', 'live-controller', 'mock-ipc') */\n  name: string;\n  version?: string;\n\n  /** Lifecycle hook: initial setup before drivers and scenarios start */\n  setup?: (context: PluginHookContext) => Promise<void> | void;\n\n  /**\n   * Microkernel driver hook: allows a plugin to provide a custom browser/page session\n   * (e.g., desktop WebView2 CDP connection, custom remote browser).\n   */\n  launchSession?: (\n    options: { currentViewport: { width: number; height: number }; headed?: boolean },\n    hookContext: PluginHookContext\n  ) => Promise<DriverLaunchResult | undefined>;\n\n  /** Lifecycle hook: called when browser context is ready */\n  onContextCreated?: (context: BrowserContext, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /** Lifecycle hook: called when the test page is created/navigated */\n  onPageCreated?: (page: Page, context: BrowserContext, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /**\n   * Context extension: inject custom methods or properties directly into TestContext (ctx)\n   */\n  extendContext?: (\n    ctx: TestContext,\n    page: Page,\n    hookContext: PluginHookContext\n  ) => Record<string, any> | Promise<Record<string, any>>;\n\n  /** Lifecycle hook: called after scenario runs and report data is calculated */\n  onAfterRun?: (reportData: ReportData, hookContext: PluginHookContext) => Promise<void> | void;\n\n  /** Lifecycle hook: teardown and cleanup guaranteed to run */\n  teardown?: (hookContext: PluginHookContext) => Promise<void> | void;\n}\n\nexport function definePlugin(plugin: AgentLensPlugin): AgentLensPlugin {\n  return plugin;\n}","import { spawn, type ChildProcess } from 'child_process';\nimport http from 'http';\nimport path from 'path';\nimport fs from 'fs';\nimport type { Browser, BrowserContext, Page } from 'playwright';\nimport { chromium } from '../../shared/lib/playwrightLoader';\nimport treeKill from 'tree-kill';\n\nexport interface DesktopDriverOptions {\n  port?: number;\n  executablePath?: string;\n  autoLaunch?: boolean;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n}\n\nexport class DesktopDriver {\n  private port: number;\n  private executablePath?: string;\n  private autoLaunch: boolean;\n  private args: string[];\n  private env: Record<string, string>;\n  private cwd?: string;\n\n  private childProcess: ChildProcess | null = null;\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private page: Page | null = null;\n  private processStderr: string = '';\n  private processExited: boolean = false;\n  private exitCode: number | null = null;\n\n  constructor(options?: DesktopDriverOptions) {\n    this.port = options?.port || 9222;\n    this.autoLaunch = options?.autoLaunch ?? true;\n    this.executablePath = options?.executablePath;\n    this.args = options?.args || [];\n    this.env = options?.env || {};\n    this.cwd = options?.cwd;\n  }\n\n  private async isPortAvailable(): Promise<boolean> {\n    return new Promise((resolve) => {\n      const req = http.get(`http://127.0.0.1:${this.port}/json/version`, (res) => {\n        resolve(res.statusCode === 200);\n      });\n      req.on('error', () => resolve(false));\n      req.setTimeout(800, () => {\n        req.destroy();\n        resolve(false);\n      });\n    });\n  }\n\n  private async waitForPort(timeoutMs: number = 25000): Promise<void> {\n    const startTime = Date.now();\n    while (Date.now() - startTime < timeoutMs) {\n      if (this.processExited) {\n        throw new Error(\n          `[DesktopDriver] Process terminated prematurely with exit code ${this.exitCode}.\\nStderr: ${this.processStderr.trim() || '(none)'}`\n        );\n      }\n\n      if (await this.isPortAvailable()) {\n        return;\n      }\n      await new Promise((r) => setTimeout(r, 400));\n    }\n    throw new Error(\n      `Timeout waiting for WebView2/Chromium CDP port ${this.port}. Last stderr:\\n${this.processStderr.trim() || '(no stderr output)'}`\n    );\n  }\n\n  public async start(initialViewport = { width: 1200, height: 800 }): Promise<{ page: Page; context: BrowserContext; browser: Browser }> {\n    const alreadyRunning = await this.isPortAvailable();\n\n    if (!alreadyRunning) {\n      if (!this.autoLaunch) {\n        throw new Error(\n          `App is not running on port ${this.port} and autoLaunch is false. Start app with WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=${this.port}`\n        );\n      }\n\n      if (!this.executablePath) {\n        throw new Error(\n          `[DesktopDriver] No executablePath provided and nothing is running on port ${this.port}. Specify --exe=<path> in CLI or executablePath in config.`\n        );\n      }\n\n      const resolvedExe = path.resolve(process.cwd(), this.executablePath);\n      if (!fs.existsSync(resolvedExe)) {\n        throw new Error(\n          `[DesktopDriver] Desktop executable not found at: ${resolvedExe}. Please build your native project first.`\n        );\n      }\n\n      console.log(`🚀 [DesktopDriver] Launching: ${resolvedExe}`);\n\n      const finalArgs = [...this.args];\n      const hasDebugPort = finalArgs.some((a) => a.startsWith('--remote-debugging-port='));\n      if (!hasDebugPort) {\n        finalArgs.push(`--remote-debugging-port=${this.port}`);\n      }\n\n      const mergedEnv = {\n        ...process.env,\n        ...this.env,\n        WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS: `--remote-debugging-port=${this.port}`\n      };\n\n      this.processStderr = '';\n      this.processExited = false;\n      this.exitCode = null;\n\n      this.childProcess = spawn(resolvedExe, finalArgs, {\n        env: mergedEnv,\n        cwd: this.cwd || path.dirname(resolvedExe),\n        stdio: ['ignore', 'ignore', 'pipe'],\n        detached: false\n      });\n\n      this.childProcess.stderr?.on('data', (chunk) => {\n        this.processStderr += chunk.toString();\n      });\n\n      this.childProcess.on('exit', (code) => {\n        this.processExited = true;\n        this.exitCode = code;\n      });\n\n      this.childProcess.on('error', (err) => {\n        console.error('[DesktopDriver] Failed to spawn process:', err);\n      });\n\n      console.log(`⏳ [DesktopDriver] Waiting for CDP debugging port on ${this.port}...`);\n      await this.waitForPort();\n    } else {\n      console.log(`🔌 [DesktopDriver] Attached to already running process on port ${this.port}`);\n    }\n\n    console.log(`🌐 [DesktopDriver] Connecting Playwright CDP to http://127.0.0.1:${this.port}...`);\n    this.browser = await chromium.connectOverCDP(`http://127.0.0.1:${this.port}`);\n\n    const contexts = this.browser.contexts();\n    this.context = contexts[0] || (await this.browser.newContext());\n\n    const pages = this.context.pages();\n    if (pages.length > 0) {\n      this.page = pages[0];\n    } else {\n      this.page = await this.context.waitForEvent('page', { timeout: 10000 });\n    }\n\n    if (initialViewport) {\n      await this.page.setViewportSize(initialViewport).catch(() => {});\n    }\n\n    return { page: this.page, context: this.context, browser: this.browser };\n  }\n\n  public async stop(): Promise<void> {\n    if (this.browser) {\n      await this.browser.close().catch(() => {});\n      this.browser = null;\n    }\n\n    if (this.childProcess && !this.childProcess.killed && this.childProcess.pid) {\n      console.log('🛑 [DesktopDriver] Terminating spawned desktop process tree...');\n      const pid = this.childProcess.pid;\n      await new Promise<void>((resolve) => {\n        treeKill(pid, 'SIGTERM', () => resolve());\n      });\n      this.childProcess = null;\n    }\n  }\n}\n","import { chromium as baseChromium, type ChromiumBrowser, type BrowserType } from 'playwright';\r\n\r\n/**\r\n * Safe Playwright Chromium loader that wraps browser initialization with helpful diagnostic messages.\r\n */\r\nexport const chromium: BrowserType<ChromiumBrowser> = new Proxy(baseChromium, {\r\n  get(target, prop, receiver) {\r\n    if (prop === 'launch') {\r\n      return async (...args: Parameters<typeof baseChromium.launch>) => {\r\n        try {\r\n          return await target.launch(...args);\r\n        } catch (err: any) {\r\n          if (\r\n            err.message?.includes(\"Executable doesn't exist\") ||\r\n            err.message?.includes('playwright install') ||\r\n            err.message?.includes('browser has not been downloaded')\r\n          ) {\r\n            console.error(\"\\n❌ [AgentLens] Playwright Chromium browser binary is missing!\");\r\n            console.error(\"👉 Please install it by running: npx playwright install chromium\\n\");\r\n          }\r\n          throw err;\r\n        }\r\n      };\r\n    }\r\n    const val = Reflect.get(target, prop, receiver);\r\n    return typeof val === 'function' ? val.bind(target) : val;\r\n  }\r\n});"],"mappings":"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","names":["baseChromium","http","path","fs","treeKill"]}