@_deep4wee/agent-lens 1.1.0 → 1.2.0

package/dist/plugins/live-controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/live-controller/index.ts","../../../src/shared/api/plugin.ts","../../../src/plugins/live-controller/actions.ts","../../../src/plugins/live-controller/session.ts","../../../src/shared/lib/playwrightLoader.ts"],"sourcesContent":["import { definePlugin, type AgentLensPlugin } from '../../shared/api/plugin';\nimport {\n  clickCoords,\n  dragAndDrop,\n  scrollPercent,\n  snapLive,\n  handleLiveCli,\n  type SnapLiveOptions\n} from './actions';\n\nexport {\n  clickCoords,\n  dragAndDrop,\n  scrollPercent,\n  snapLive,\n  handleLiveCli,\n  type SnapLiveOptions\n};\n\nexport const liveControllerPlugin: AgentLensPlugin = definePlugin({\n  name: 'live-controller',\n  version: '1.0.0',\n\n  extendContext: (_ctx, page) => {\n    return {\n      clickCoords: async (\n        x: number,\n        y: number,\n        options?: { button?: 'left' | 'right' | 'middle'; clickCount?: number }\n      ) => {\n        await clickCoords(page, x, y, options);\n      },\n\n      dragAndDrop: async (\n        fromX: number,\n        fromY: number,\n        toX: number,\n        toY: number,\n        steps?: number\n      ) => {\n        await dragAndDrop(page, fromX, fromY, toX, toY, steps);\n      },\n\n      scrollPercent: async (percent: number) => {\n        await scrollPercent(page, percent);\n      },\n\n      snapLive: async (options?: SnapLiveOptions) => {\n        return await snapLive(page, options);\n      }\n    };\n  }\n});\n\nexport default liveControllerPlugin;\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 path from 'path';\nimport type { Page } from 'playwright';\nimport {\n  connectToLiveSession,\n  saveLiveSession,\n  stopLiveSession,\n  getLiveArtifactsDir\n} from './session';\nimport { chromium } from '../../shared/lib/playwrightLoader';\n\nexport interface SnapLiveOptions {\n  name?: string;\n  fullPage?: boolean;\n  selector?: string;\n}\n\n/**\n * Click at physical pixel coordinates on the page (for Vision AI models).\n */\nexport async function clickCoords(\n  page: Page,\n  x: number,\n  y: number,\n  options?: { button?: 'left' | 'right' | 'middle'; clickCount?: number }\n): Promise<void> {\n  console.log(`🖱️ [LiveController] Clicking coordinates: (${x}, ${y})`);\n  await page.mouse.click(x, y, options);\n  await page.waitForTimeout(200);\n}\n\n/**\n * Drag and drop from (fromX, fromY) to (toX, toY).\n */\nexport async function dragAndDrop(\n  page: Page,\n  fromX: number,\n  fromY: number,\n  toX: number,\n  toY: number,\n  steps = 10\n): Promise<void> {\n  console.log(`🖐️ [LiveController] Dragging from (${fromX}, ${fromY}) to (${toX}, ${toY}) in ${steps} steps`);\n  await page.mouse.move(fromX, fromY);\n  await page.mouse.down();\n  await page.mouse.move(toX, toY, { steps });\n  await page.mouse.up();\n  await page.waitForTimeout(200);\n}\n\n/**\n * Scroll page by percentage (0 to 100).\n */\nexport async function scrollPercent(page: Page, percent: number): Promise<void> {\n  const clamped = Math.max(0, Math.min(100, percent));\n  console.log(`📜 [LiveController] Scrolling to ${clamped}% of page height`);\n  await page.evaluate((pct) => {\n    const totalHeight = document.documentElement.scrollHeight - window.innerHeight;\n    const targetY = (totalHeight * pct) / 100;\n    window.scrollTo({ top: targetY, behavior: 'smooth' });\n  }, clamped);\n  await page.waitForTimeout(300);\n}\n\n/**\n * Capture a live snapshot with optional fullPage (--full) support.\n */\nexport async function snapLive(page: Page, options?: SnapLiveOptions): Promise<string> {\n  const artifactsDir = getLiveArtifactsDir();\n  const fileName = options?.name ? `${options.name}.png` : 'current.png';\n  const filePath = path.join(artifactsDir, fileName);\n\n  if (options?.selector) {\n    const el = await page.waitForSelector(options.selector, { timeout: 5000 });\n    await el.screenshot({ path: filePath });\n  } else {\n    await page.screenshot({ path: filePath, fullPage: options?.fullPage ?? false });\n  }\n\n  console.log(`📸 [LiveController] Snapshot saved: ${filePath}${options?.fullPage ? ' (Full Page)' : ''}`);\n  return filePath;\n}\n\n/**\n * Handle CLI commands: live start, click, type, snap, stop\n */\nexport async function handleLiveCli(argv: string[]): Promise<boolean> {\n  const action = argv[0]?.toLowerCase();\n\n  switch (action) {\n    case 'start': {\n      const urlArg = argv.find((a) => a.startsWith('--url='))?.split('=')[1] || 'http://localhost:5173';\n      const portArg = parseInt(argv.find((a) => a.startsWith('--port='))?.split('=')[1] || '9223', 10);\n      const isHeaded = argv.includes('--headed');\n\n      console.log(`🚀 [Live] Starting background browser for ${urlArg} on CDP port ${portArg}...`);\n\n      const browser = await chromium.launch({\n        headless: !isHeaded,\n        args: [`--remote-debugging-port=${portArg}`, '--no-sandbox']\n      });\n\n      const context = await browser.newContext({ viewport: { width: 1200, height: 800 } });\n      const page = await context.newPage();\n      await page.goto(urlArg, { waitUntil: 'domcontentloaded' });\n      await page.waitForTimeout(500);\n\n      saveLiveSession({\n        port: portArg,\n        url: urlArg,\n        startedAt: new Date().toISOString()\n      });\n\n      await snapLive(page, { name: 'current' });\n      console.log(`✅ [Live] Session active! You can now send live commands:\\n`);\n      console.log(`   npx agent-lens live click 450 120`);\n      console.log(`   npx agent-lens live type \"input\" \"hello\"`);\n      console.log(`   npx agent-lens live snap --full`);\n      console.log(`   npx agent-lens live stop\\n`);\n      return true;\n    }\n\n    case 'click': {\n      const { page, browser } = await connectToLiveSession();\n      const firstArg = argv[1];\n      const secondArg = argv[2];\n\n      const x = parseInt(firstArg, 10);\n      const y = parseInt(secondArg, 10);\n\n      if (!isNaN(x) && !isNaN(y)) {\n        await clickCoords(page, x, y);\n      } else if (firstArg) {\n        console.log(`🖱️ [Live] Clicking selector: \"${firstArg}\"`);\n        await page.click(firstArg);\n      } else {\n        console.error(`❌ Usage: npx agent-lens live click <x> <y> OR npx agent-lens live click <selector>`);\n        await browser.close();\n        return false;\n      }\n\n      await snapLive(page, { name: 'current' });\n      return true;\n    }\n\n    case 'type': {\n      const { page, browser } = await connectToLiveSession();\n      const selector = argv[1];\n      const text = argv[2];\n\n      if (!selector || text === undefined) {\n        console.error(`❌ Usage: npx agent-lens live type <selector> <text>`);\n        await browser.close();\n        return false;\n      }\n\n      console.log(`⌨️ [Live] Typing into \"${selector}\": \"${text}\"`);\n      await page.fill(selector, text);\n      await snapLive(page, { name: 'current' });\n      return true;\n    }\n\n    case 'snap': {\n      const { page } = await connectToLiveSession();\n      const isFull = argv.includes('--full');\n      const nameArg = argv.find((a) => !a.startsWith('--') && a !== 'snap');\n\n      await snapLive(page, { name: nameArg || 'current', fullPage: isFull });\n      return true;\n    }\n\n    case 'stop': {\n      return await stopLiveSession();\n    }\n\n    default: {\n      console.log(`\nℹ️ AgentLens Live Controller:\n  npx agent-lens live start --url=<url>   Start background live session\n  npx agent-lens live click <x> <y>       Click at pixel coordinates\n  npx agent-lens live click <selector>    Click CSS selector\n  npx agent-lens live type <sel> <text>   Fill input field\n  npx agent-lens live snap [name] [--full] Capture current or full-page screenshot\n  npx agent-lens live stop                Close live browser and finish\n      `);\n      return true;\n    }\n  }\n}\n","import fs from 'fs';\nimport path from 'path';\nimport type { Page, Browser, BrowserContext } from 'playwright';\nimport { chromium } from '../../shared/lib/playwrightLoader';\nimport treeKill from 'tree-kill';\n\nexport interface LiveSessionInfo {\n  port: number;\n  url: string;\n  pid?: number;\n  startedAt: string;\n}\n\nconst SESSION_DIR = path.resolve(process.cwd(), '.agent-lens');\nconst SESSION_FILE = path.join(SESSION_DIR, 'live-session.json');\nconst LIVE_ARTIFACTS_DIR = path.resolve(process.cwd(), 'artifacts', 'live');\n\nexport function getSessionFile(): string {\n  return SESSION_FILE;\n}\n\nexport function getLiveArtifactsDir(): string {\n  if (!fs.existsSync(LIVE_ARTIFACTS_DIR)) {\n    fs.mkdirSync(LIVE_ARTIFACTS_DIR, { recursive: true });\n  }\n  return LIVE_ARTIFACTS_DIR;\n}\n\nexport function readLiveSession(): LiveSessionInfo | null {\n  if (!fs.existsSync(SESSION_FILE)) return null;\n  try {\n    return JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nexport function saveLiveSession(info: LiveSessionInfo): void {\n  if (!fs.existsSync(SESSION_DIR)) {\n    fs.mkdirSync(SESSION_DIR, { recursive: true });\n  }\n  fs.writeFileSync(SESSION_FILE, JSON.stringify(info, null, 2), 'utf-8');\n}\n\nexport function clearLiveSession(): void {\n  if (fs.existsSync(SESSION_FILE)) {\n    try {\n      fs.unlinkSync(SESSION_FILE);\n    } catch {\n      // ignore\n    }\n  }\n}\n\n/**\n * Connect to an already running Live Browser session over CDP.\n */\nexport async function connectToLiveSession(): Promise<{ browser: Browser; context: BrowserContext; page: Page }> {\n  const session = readLiveSession();\n  if (!session) {\n    throw new Error(\n      `No active live session found. Start one with: npx agent-lens live start --url=http://localhost:5173`\n    );\n  }\n\n  const browser = await chromium.connectOverCDP(`http://127.0.0.1:${session.port}`);\n  const contexts = browser.contexts();\n  const context = contexts[0] || (await browser.newContext());\n  const pages = context.pages();\n  const page = pages[0] || (await context.waitForEvent('page', { timeout: 5000 }));\n\n  return { browser, context, page };\n}\n\n/**\n * Stop running live session and clean up process and session file.\n */\nexport async function stopLiveSession(): Promise<boolean> {\n  const session = readLiveSession();\n  if (!session) {\n    console.log(`ℹ️ [Live] No active session to stop.`);\n    return false;\n  }\n\n  try {\n    const { browser } = await connectToLiveSession();\n    await browser.close().catch(() => {});\n  } catch {\n    // browser might already be closed\n  }\n\n  if (session.pid) {\n    await new Promise<void>((resolve) => {\n      treeKill(session.pid!, 'SIGTERM', () => resolve());\n    });\n  }\n\n  clearLiveSession();\n  console.log(`🛑 [Live] Session stopped and cleaned up.`);\n  return true;\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":["import_path","baseChromium","path","fs","treeKill","path"]}

package/dist/plugins/live-controller/index.mjs

@@ -0,0 +1,261 @@
+// src/shared/api/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+
+// src/plugins/live-controller/actions.ts
+import path2 from "path";
+
+// src/plugins/live-controller/session.ts
+import fs from "fs";
+import path from "path";
+
+// src/shared/lib/playwrightLoader.ts
+import { chromium as baseChromium } from "playwright";
+var chromium = new Proxy(baseChromium, {
+  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/live-controller/session.ts
+import treeKill from "tree-kill";
+var SESSION_DIR = path.resolve(process.cwd(), ".agent-lens");
+var SESSION_FILE = path.join(SESSION_DIR, "live-session.json");
+var LIVE_ARTIFACTS_DIR = path.resolve(process.cwd(), "artifacts", "live");
+function getLiveArtifactsDir() {
+  if (!fs.existsSync(LIVE_ARTIFACTS_DIR)) {
+    fs.mkdirSync(LIVE_ARTIFACTS_DIR, { recursive: true });
+  }
+  return LIVE_ARTIFACTS_DIR;
+}
+function readLiveSession() {
+  if (!fs.existsSync(SESSION_FILE)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(SESSION_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveLiveSession(info) {
+  if (!fs.existsSync(SESSION_DIR)) {
+    fs.mkdirSync(SESSION_DIR, { recursive: true });
+  }
+  fs.writeFileSync(SESSION_FILE, JSON.stringify(info, null, 2), "utf-8");
+}
+function clearLiveSession() {
+  if (fs.existsSync(SESSION_FILE)) {
+    try {
+      fs.unlinkSync(SESSION_FILE);
+    } catch {
+    }
+  }
+}
+async function connectToLiveSession() {
+  const session = readLiveSession();
+  if (!session) {
+    throw new Error(
+      `No active live session found. Start one with: npx agent-lens live start --url=http://localhost:5173`
+    );
+  }
+  const browser = await chromium.connectOverCDP(`http://127.0.0.1:${session.port}`);
+  const contexts = browser.contexts();
+  const context = contexts[0] || await browser.newContext();
+  const pages = context.pages();
+  const page = pages[0] || await context.waitForEvent("page", { timeout: 5e3 });
+  return { browser, context, page };
+}
+async function stopLiveSession() {
+  const session = readLiveSession();
+  if (!session) {
+    console.log(`\u2139\uFE0F [Live] No active session to stop.`);
+    return false;
+  }
+  try {
+    const { browser } = await connectToLiveSession();
+    await browser.close().catch(() => {
+    });
+  } catch {
+  }
+  if (session.pid) {
+    await new Promise((resolve) => {
+      treeKill(session.pid, "SIGTERM", () => resolve());
+    });
+  }
+  clearLiveSession();
+  console.log(`\u{1F6D1} [Live] Session stopped and cleaned up.`);
+  return true;
+}
+
+// src/plugins/live-controller/actions.ts
+async function clickCoords(page, x, y, options) {
+  console.log(`\u{1F5B1}\uFE0F [LiveController] Clicking coordinates: (${x}, ${y})`);
+  await page.mouse.click(x, y, options);
+  await page.waitForTimeout(200);
+}
+async function dragAndDrop(page, fromX, fromY, toX, toY, steps = 10) {
+  console.log(`\u{1F590}\uFE0F [LiveController] Dragging from (${fromX}, ${fromY}) to (${toX}, ${toY}) in ${steps} steps`);
+  await page.mouse.move(fromX, fromY);
+  await page.mouse.down();
+  await page.mouse.move(toX, toY, { steps });
+  await page.mouse.up();
+  await page.waitForTimeout(200);
+}
+async function scrollPercent(page, percent) {
+  const clamped = Math.max(0, Math.min(100, percent));
+  console.log(`\u{1F4DC} [LiveController] Scrolling to ${clamped}% of page height`);
+  await page.evaluate((pct) => {
+    const totalHeight = document.documentElement.scrollHeight - window.innerHeight;
+    const targetY = totalHeight * pct / 100;
+    window.scrollTo({ top: targetY, behavior: "smooth" });
+  }, clamped);
+  await page.waitForTimeout(300);
+}
+async function snapLive(page, options) {
+  const artifactsDir = getLiveArtifactsDir();
+  const fileName = options?.name ? `${options.name}.png` : "current.png";
+  const filePath = path2.join(artifactsDir, fileName);
+  if (options?.selector) {
+    const el = await page.waitForSelector(options.selector, { timeout: 5e3 });
+    await el.screenshot({ path: filePath });
+  } else {
+    await page.screenshot({ path: filePath, fullPage: options?.fullPage ?? false });
+  }
+  console.log(`\u{1F4F8} [LiveController] Snapshot saved: ${filePath}${options?.fullPage ? " (Full Page)" : ""}`);
+  return filePath;
+}
+async function handleLiveCli(argv) {
+  const action = argv[0]?.toLowerCase();
+  switch (action) {
+    case "start": {
+      const urlArg = argv.find((a) => a.startsWith("--url="))?.split("=")[1] || "http://localhost:5173";
+      const portArg = parseInt(argv.find((a) => a.startsWith("--port="))?.split("=")[1] || "9223", 10);
+      const isHeaded = argv.includes("--headed");
+      console.log(`\u{1F680} [Live] Starting background browser for ${urlArg} on CDP port ${portArg}...`);
+      const browser = await chromium.launch({
+        headless: !isHeaded,
+        args: [`--remote-debugging-port=${portArg}`, "--no-sandbox"]
+      });
+      const context = await browser.newContext({ viewport: { width: 1200, height: 800 } });
+      const page = await context.newPage();
+      await page.goto(urlArg, { waitUntil: "domcontentloaded" });
+      await page.waitForTimeout(500);
+      saveLiveSession({
+        port: portArg,
+        url: urlArg,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      await snapLive(page, { name: "current" });
+      console.log(`\u2705 [Live] Session active! You can now send live commands:
+`);
+      console.log(`   npx agent-lens live click 450 120`);
+      console.log(`   npx agent-lens live type "input" "hello"`);
+      console.log(`   npx agent-lens live snap --full`);
+      console.log(`   npx agent-lens live stop
+`);
+      return true;
+    }
+    case "click": {
+      const { page, browser } = await connectToLiveSession();
+      const firstArg = argv[1];
+      const secondArg = argv[2];
+      const x = parseInt(firstArg, 10);
+      const y = parseInt(secondArg, 10);
+      if (!isNaN(x) && !isNaN(y)) {
+        await clickCoords(page, x, y);
+      } else if (firstArg) {
+        console.log(`\u{1F5B1}\uFE0F [Live] Clicking selector: "${firstArg}"`);
+        await page.click(firstArg);
+      } else {
+        console.error(`\u274C Usage: npx agent-lens live click <x> <y> OR npx agent-lens live click <selector>`);
+        await browser.close();
+        return false;
+      }
+      await snapLive(page, { name: "current" });
+      return true;
+    }
+    case "type": {
+      const { page, browser } = await connectToLiveSession();
+      const selector = argv[1];
+      const text = argv[2];
+      if (!selector || text === void 0) {
+        console.error(`\u274C Usage: npx agent-lens live type <selector> <text>`);
+        await browser.close();
+        return false;
+      }
+      console.log(`\u2328\uFE0F [Live] Typing into "${selector}": "${text}"`);
+      await page.fill(selector, text);
+      await snapLive(page, { name: "current" });
+      return true;
+    }
+    case "snap": {
+      const { page } = await connectToLiveSession();
+      const isFull = argv.includes("--full");
+      const nameArg = argv.find((a) => !a.startsWith("--") && a !== "snap");
+      await snapLive(page, { name: nameArg || "current", fullPage: isFull });
+      return true;
+    }
+    case "stop": {
+      return await stopLiveSession();
+    }
+    default: {
+      console.log(`
+\u2139\uFE0F AgentLens Live Controller:
+  npx agent-lens live start --url=<url>   Start background live session
+  npx agent-lens live click <x> <y>       Click at pixel coordinates
+  npx agent-lens live click <selector>    Click CSS selector
+  npx agent-lens live type <sel> <text>   Fill input field
+  npx agent-lens live snap [name] [--full] Capture current or full-page screenshot
+  npx agent-lens live stop                Close live browser and finish
+      `);
+      return true;
+    }
+  }
+}
+
+// src/plugins/live-controller/index.ts
+var liveControllerPlugin = definePlugin({
+  name: "live-controller",
+  version: "1.0.0",
+  extendContext: (_ctx, page) => {
+    return {
+      clickCoords: async (x, y, options) => {
+        await clickCoords(page, x, y, options);
+      },
+      dragAndDrop: async (fromX, fromY, toX, toY, steps) => {
+        await dragAndDrop(page, fromX, fromY, toX, toY, steps);
+      },
+      scrollPercent: async (percent) => {
+        await scrollPercent(page, percent);
+      },
+      snapLive: async (options) => {
+        return await snapLive(page, options);
+      }
+    };
+  }
+});
+var live_controller_default = liveControllerPlugin;
+export {
+  clickCoords,
+  live_controller_default as default,
+  dragAndDrop,
+  handleLiveCli,
+  liveControllerPlugin,
+  scrollPercent,
+  snapLive
+};
+//# sourceMappingURL=index.mjs.map

package/dist/plugins/live-controller/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/api/plugin.ts","../../../src/plugins/live-controller/actions.ts","../../../src/plugins/live-controller/session.ts","../../../src/shared/lib/playwrightLoader.ts","../../../src/plugins/live-controller/index.ts"],"sourcesContent":["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 path from 'path';\nimport type { Page } from 'playwright';\nimport {\n  connectToLiveSession,\n  saveLiveSession,\n  stopLiveSession,\n  getLiveArtifactsDir\n} from './session';\nimport { chromium } from '../../shared/lib/playwrightLoader';\n\nexport interface SnapLiveOptions {\n  name?: string;\n  fullPage?: boolean;\n  selector?: string;\n}\n\n/**\n * Click at physical pixel coordinates on the page (for Vision AI models).\n */\nexport async function clickCoords(\n  page: Page,\n  x: number,\n  y: number,\n  options?: { button?: 'left' | 'right' | 'middle'; clickCount?: number }\n): Promise<void> {\n  console.log(`🖱️ [LiveController] Clicking coordinates: (${x}, ${y})`);\n  await page.mouse.click(x, y, options);\n  await page.waitForTimeout(200);\n}\n\n/**\n * Drag and drop from (fromX, fromY) to (toX, toY).\n */\nexport async function dragAndDrop(\n  page: Page,\n  fromX: number,\n  fromY: number,\n  toX: number,\n  toY: number,\n  steps = 10\n): Promise<void> {\n  console.log(`🖐️ [LiveController] Dragging from (${fromX}, ${fromY}) to (${toX}, ${toY}) in ${steps} steps`);\n  await page.mouse.move(fromX, fromY);\n  await page.mouse.down();\n  await page.mouse.move(toX, toY, { steps });\n  await page.mouse.up();\n  await page.waitForTimeout(200);\n}\n\n/**\n * Scroll page by percentage (0 to 100).\n */\nexport async function scrollPercent(page: Page, percent: number): Promise<void> {\n  const clamped = Math.max(0, Math.min(100, percent));\n  console.log(`📜 [LiveController] Scrolling to ${clamped}% of page height`);\n  await page.evaluate((pct) => {\n    const totalHeight = document.documentElement.scrollHeight - window.innerHeight;\n    const targetY = (totalHeight * pct) / 100;\n    window.scrollTo({ top: targetY, behavior: 'smooth' });\n  }, clamped);\n  await page.waitForTimeout(300);\n}\n\n/**\n * Capture a live snapshot with optional fullPage (--full) support.\n */\nexport async function snapLive(page: Page, options?: SnapLiveOptions): Promise<string> {\n  const artifactsDir = getLiveArtifactsDir();\n  const fileName = options?.name ? `${options.name}.png` : 'current.png';\n  const filePath = path.join(artifactsDir, fileName);\n\n  if (options?.selector) {\n    const el = await page.waitForSelector(options.selector, { timeout: 5000 });\n    await el.screenshot({ path: filePath });\n  } else {\n    await page.screenshot({ path: filePath, fullPage: options?.fullPage ?? false });\n  }\n\n  console.log(`📸 [LiveController] Snapshot saved: ${filePath}${options?.fullPage ? ' (Full Page)' : ''}`);\n  return filePath;\n}\n\n/**\n * Handle CLI commands: live start, click, type, snap, stop\n */\nexport async function handleLiveCli(argv: string[]): Promise<boolean> {\n  const action = argv[0]?.toLowerCase();\n\n  switch (action) {\n    case 'start': {\n      const urlArg = argv.find((a) => a.startsWith('--url='))?.split('=')[1] || 'http://localhost:5173';\n      const portArg = parseInt(argv.find((a) => a.startsWith('--port='))?.split('=')[1] || '9223', 10);\n      const isHeaded = argv.includes('--headed');\n\n      console.log(`🚀 [Live] Starting background browser for ${urlArg} on CDP port ${portArg}...`);\n\n      const browser = await chromium.launch({\n        headless: !isHeaded,\n        args: [`--remote-debugging-port=${portArg}`, '--no-sandbox']\n      });\n\n      const context = await browser.newContext({ viewport: { width: 1200, height: 800 } });\n      const page = await context.newPage();\n      await page.goto(urlArg, { waitUntil: 'domcontentloaded' });\n      await page.waitForTimeout(500);\n\n      saveLiveSession({\n        port: portArg,\n        url: urlArg,\n        startedAt: new Date().toISOString()\n      });\n\n      await snapLive(page, { name: 'current' });\n      console.log(`✅ [Live] Session active! You can now send live commands:\\n`);\n      console.log(`   npx agent-lens live click 450 120`);\n      console.log(`   npx agent-lens live type \"input\" \"hello\"`);\n      console.log(`   npx agent-lens live snap --full`);\n      console.log(`   npx agent-lens live stop\\n`);\n      return true;\n    }\n\n    case 'click': {\n      const { page, browser } = await connectToLiveSession();\n      const firstArg = argv[1];\n      const secondArg = argv[2];\n\n      const x = parseInt(firstArg, 10);\n      const y = parseInt(secondArg, 10);\n\n      if (!isNaN(x) && !isNaN(y)) {\n        await clickCoords(page, x, y);\n      } else if (firstArg) {\n        console.log(`🖱️ [Live] Clicking selector: \"${firstArg}\"`);\n        await page.click(firstArg);\n      } else {\n        console.error(`❌ Usage: npx agent-lens live click <x> <y> OR npx agent-lens live click <selector>`);\n        await browser.close();\n        return false;\n      }\n\n      await snapLive(page, { name: 'current' });\n      return true;\n    }\n\n    case 'type': {\n      const { page, browser } = await connectToLiveSession();\n      const selector = argv[1];\n      const text = argv[2];\n\n      if (!selector || text === undefined) {\n        console.error(`❌ Usage: npx agent-lens live type <selector> <text>`);\n        await browser.close();\n        return false;\n      }\n\n      console.log(`⌨️ [Live] Typing into \"${selector}\": \"${text}\"`);\n      await page.fill(selector, text);\n      await snapLive(page, { name: 'current' });\n      return true;\n    }\n\n    case 'snap': {\n      const { page } = await connectToLiveSession();\n      const isFull = argv.includes('--full');\n      const nameArg = argv.find((a) => !a.startsWith('--') && a !== 'snap');\n\n      await snapLive(page, { name: nameArg || 'current', fullPage: isFull });\n      return true;\n    }\n\n    case 'stop': {\n      return await stopLiveSession();\n    }\n\n    default: {\n      console.log(`\nℹ️ AgentLens Live Controller:\n  npx agent-lens live start --url=<url>   Start background live session\n  npx agent-lens live click <x> <y>       Click at pixel coordinates\n  npx agent-lens live click <selector>    Click CSS selector\n  npx agent-lens live type <sel> <text>   Fill input field\n  npx agent-lens live snap [name] [--full] Capture current or full-page screenshot\n  npx agent-lens live stop                Close live browser and finish\n      `);\n      return true;\n    }\n  }\n}\n","import fs from 'fs';\nimport path from 'path';\nimport type { Page, Browser, BrowserContext } from 'playwright';\nimport { chromium } from '../../shared/lib/playwrightLoader';\nimport treeKill from 'tree-kill';\n\nexport interface LiveSessionInfo {\n  port: number;\n  url: string;\n  pid?: number;\n  startedAt: string;\n}\n\nconst SESSION_DIR = path.resolve(process.cwd(), '.agent-lens');\nconst SESSION_FILE = path.join(SESSION_DIR, 'live-session.json');\nconst LIVE_ARTIFACTS_DIR = path.resolve(process.cwd(), 'artifacts', 'live');\n\nexport function getSessionFile(): string {\n  return SESSION_FILE;\n}\n\nexport function getLiveArtifactsDir(): string {\n  if (!fs.existsSync(LIVE_ARTIFACTS_DIR)) {\n    fs.mkdirSync(LIVE_ARTIFACTS_DIR, { recursive: true });\n  }\n  return LIVE_ARTIFACTS_DIR;\n}\n\nexport function readLiveSession(): LiveSessionInfo | null {\n  if (!fs.existsSync(SESSION_FILE)) return null;\n  try {\n    return JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nexport function saveLiveSession(info: LiveSessionInfo): void {\n  if (!fs.existsSync(SESSION_DIR)) {\n    fs.mkdirSync(SESSION_DIR, { recursive: true });\n  }\n  fs.writeFileSync(SESSION_FILE, JSON.stringify(info, null, 2), 'utf-8');\n}\n\nexport function clearLiveSession(): void {\n  if (fs.existsSync(SESSION_FILE)) {\n    try {\n      fs.unlinkSync(SESSION_FILE);\n    } catch {\n      // ignore\n    }\n  }\n}\n\n/**\n * Connect to an already running Live Browser session over CDP.\n */\nexport async function connectToLiveSession(): Promise<{ browser: Browser; context: BrowserContext; page: Page }> {\n  const session = readLiveSession();\n  if (!session) {\n    throw new Error(\n      `No active live session found. Start one with: npx agent-lens live start --url=http://localhost:5173`\n    );\n  }\n\n  const browser = await chromium.connectOverCDP(`http://127.0.0.1:${session.port}`);\n  const contexts = browser.contexts();\n  const context = contexts[0] || (await browser.newContext());\n  const pages = context.pages();\n  const page = pages[0] || (await context.waitForEvent('page', { timeout: 5000 }));\n\n  return { browser, context, page };\n}\n\n/**\n * Stop running live session and clean up process and session file.\n */\nexport async function stopLiveSession(): Promise<boolean> {\n  const session = readLiveSession();\n  if (!session) {\n    console.log(`ℹ️ [Live] No active session to stop.`);\n    return false;\n  }\n\n  try {\n    const { browser } = await connectToLiveSession();\n    await browser.close().catch(() => {});\n  } catch {\n    // browser might already be closed\n  }\n\n  if (session.pid) {\n    await new Promise<void>((resolve) => {\n      treeKill(session.pid!, 'SIGTERM', () => resolve());\n    });\n  }\n\n  clearLiveSession();\n  console.log(`🛑 [Live] Session stopped and cleaned up.`);\n  return true;\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});","import { definePlugin, type AgentLensPlugin } from '../../shared/api/plugin';\nimport {\n  clickCoords,\n  dragAndDrop,\n  scrollPercent,\n  snapLive,\n  handleLiveCli,\n  type SnapLiveOptions\n} from './actions';\n\nexport {\n  clickCoords,\n  dragAndDrop,\n  scrollPercent,\n  snapLive,\n  handleLiveCli,\n  type SnapLiveOptions\n};\n\nexport const liveControllerPlugin: AgentLensPlugin = definePlugin({\n  name: 'live-controller',\n  version: '1.0.0',\n\n  extendContext: (_ctx, page) => {\n    return {\n      clickCoords: async (\n        x: number,\n        y: number,\n        options?: { button?: 'left' | 'right' | 'middle'; clickCount?: number }\n      ) => {\n        await clickCoords(page, x, y, options);\n      },\n\n      dragAndDrop: async (\n        fromX: number,\n        fromY: number,\n        toX: number,\n        toY: number,\n        steps?: number\n      ) => {\n        await dragAndDrop(page, fromX, fromY, toX, toY, steps);\n      },\n\n      scrollPercent: async (percent: number) => {\n        await scrollPercent(page, percent);\n      },\n\n      snapLive: async (options?: SnapLiveOptions) => {\n        return await snapLive(page, options);\n      }\n    };\n  }\n});\n\nexport default liveControllerPlugin;\n"],"mappings":"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","names":["path","path"]}

package/dist/plugins/mock-ipc/index.d.mts

@@ -0,0 +1,30 @@
+import { M as MockIpcResponseType, a as MockIpcEntry, A as AgentLensPlugin } from '../../dsl-BIjVN1M0.mjs';
+import 'playwright';
+
+declare class MockIpcRegistry {
+    private mocks;
+    set(action: string, data: any, options?: {
+        type?: MockIpcResponseType;
+        delayMs?: number;
+    }): void;
+    setBatch(entries: Array<{
+        action: string;
+        data: any;
+        type?: MockIpcResponseType;
+        delayMs?: number;
+    }>): void;
+    remove(action: string): void;
+    clear(): void;
+    get(action: string): MockIpcEntry | null;
+    toSerializable(): Record<string, {
+        data: any;
+        type: string;
+        delayMs: number;
+    }>;
+    get size(): number;
+}
+declare function generateMockIpcScript(registry: MockIpcRegistry): string;
+
+declare const mockIpcPlugin: AgentLensPlugin;
+
+export { MockIpcRegistry, mockIpcPlugin as default, generateMockIpcScript, mockIpcPlugin };

package/dist/plugins/mock-ipc/index.d.ts

@@ -0,0 +1,30 @@
+import { M as MockIpcResponseType, a as MockIpcEntry, A as AgentLensPlugin } from '../../dsl-BIjVN1M0.js';
+import 'playwright';
+
+declare class MockIpcRegistry {
+    private mocks;
+    set(action: string, data: any, options?: {
+        type?: MockIpcResponseType;
+        delayMs?: number;
+    }): void;
+    setBatch(entries: Array<{
+        action: string;
+        data: any;
+        type?: MockIpcResponseType;
+        delayMs?: number;
+    }>): void;
+    remove(action: string): void;
+    clear(): void;
+    get(action: string): MockIpcEntry | null;
+    toSerializable(): Record<string, {
+        data: any;
+        type: string;
+        delayMs: number;
+    }>;
+    get size(): number;
+}
+declare function generateMockIpcScript(registry: MockIpcRegistry): string;
+
+declare const mockIpcPlugin: AgentLensPlugin;
+
+export { MockIpcRegistry, mockIpcPlugin as default, generateMockIpcScript, mockIpcPlugin };

package/dist/plugins/mock-ipc/index.js

@@ -0,0 +1,210 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugins/mock-ipc/index.ts
+var mock_ipc_exports = {};
+__export(mock_ipc_exports, {
+  MockIpcRegistry: () => MockIpcRegistry,
+  default: () => mock_ipc_default,
+  generateMockIpcScript: () => generateMockIpcScript,
+  mockIpcPlugin: () => mockIpcPlugin
+});
+module.exports = __toCommonJS(mock_ipc_exports);
+
+// src/shared/api/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+
+// src/plugins/mock-ipc/registry.ts
+var MockIpcRegistry = class {
+  mocks = /* @__PURE__ */ new Map();
+  set(action, data, options) {
+    this.mocks.set(action, {
+      action,
+      data,
+      type: options?.type ?? "SUCCESS",
+      delayMs: options?.delayMs ?? 20
+    });
+  }
+  setBatch(entries) {
+    for (const entry of entries) {
+      this.set(entry.action, entry.data, { type: entry.type, delayMs: entry.delayMs });
+    }
+  }
+  remove(action) {
+    this.mocks.delete(action);
+  }
+  clear() {
+    this.mocks.clear();
+  }
+  get(action) {
+    return this.mocks.get(action) ?? null;
+  }
+  toSerializable() {
+    const result = {};
+    for (const [action, entry] of this.mocks.entries()) {
+      result[action] = {
+        data: entry.data,
+        type: entry.type ?? "SUCCESS",
+        delayMs: entry.delayMs ?? 20
+      };
+    }
+    return result;
+  }
+  get size() {
+    return this.mocks.size;
+  }
+};
+function generateMockIpcScript(registry) {
+  const mocksJson = JSON.stringify(registry.toSerializable());
+  return `
+    (() => {
+      const __mockTable = ${mocksJson};
+
+      window.__visualRunnerMocks = __mockTable;
+
+      // Generic IPC mock bridge for modern web applications
+      window.__mockIpc = {
+        invoke: (action, payload) => {
+          return new Promise((resolve, reject) => {
+            const mock = window.__visualRunnerMocks[action];
+
+            if (mock) {
+              setTimeout(() => {
+                if (mock.type === 'ERROR') {
+                  reject(new Error(mock.data));
+                } else {
+                  resolve(mock.data);
+                }
+              }, mock.delayMs || 20);
+            } else {
+              console.warn('[Mock IPC] No mock for action:', action, '\u2014 returning empty SUCCESS');
+              setTimeout(() => resolve(null), 20);
+            }
+          });
+        }
+      };
+
+      // Safe fallback bridge for hybrid webviews (Photino / CEF / WebView2)
+      try {
+        if (!window.external) {
+          window.external = {};
+        }
+        window.external.sendMessage = (msg) => {
+          try {
+            const parsed = typeof msg === 'string' ? JSON.parse(msg) : msg;
+            const action = parsed.Action || parsed.action;
+            const id = parsed.Id || parsed.id;
+            const mock = window.__visualRunnerMocks[action];
+
+            if (mock) {
+              const response = { Id: id, Type: mock.type || 'SUCCESS', Data: mock.data };
+              setTimeout(() => {
+                const cb = window.__mockCallback;
+                if (typeof cb === 'function') cb(JSON.stringify(response));
+              }, mock.delayMs || 20);
+            } else {
+              setTimeout(() => {
+                const cb = window.__mockCallback;
+                if (typeof cb === 'function') cb(JSON.stringify({ Id: id, Type: 'SUCCESS', Data: null }));
+              }, 20);
+            }
+          } catch (e) {
+            console.error('[Mock IPC] Failed to process message:', e);
+          }
+        };
+
+        window.external.receiveMessage = (callback) => {
+          window.__mockCallback = callback;
+        };
+      } catch {
+        // Ignored if window.external is read-only in strict Chromium sandboxes
+      }
+
+      console.log('[Visual Runner] Mock IPC bridge initialized with', Object.keys(window.__visualRunnerMocks).length, 'mocked actions');
+    })();
+  `;
+}
+
+// src/plugins/mock-ipc/index.ts
+var STATE_KEY = "mockIpcRegistry";
+var mockIpcPlugin = definePlugin({
+  name: "mock-ipc",
+  version: "1.0.0",
+  setup: (hookContext) => {
+    const registry = new MockIpcRegistry();
+    hookContext.state.set(STATE_KEY, registry);
+    const scenarioMocks = hookContext.scenario?.mockIpc || [];
+    const globalMocks = hookContext.cliOptions?.globalMocks || [];
+    const allMocks = [...globalMocks, ...scenarioMocks];
+    if (allMocks.length > 0) {
+      console.log(`\u{1F4E6} [Plugin:mock-ipc] Pre-loading ${allMocks.length} initial IPC mocks`);
+      registry.setBatch(allMocks);
+    }
+  },
+  onContextCreated: async (context, hookContext) => {
+    const registry = hookContext.state.get(STATE_KEY) || new MockIpcRegistry();
+    const script = generateMockIpcScript(registry);
+    await context.addInitScript(script);
+    console.log(`\u{1F50C} [Plugin:mock-ipc] Injected window.__mockIpc & window.external bridge into browser context`);
+  },
+  extendContext: (_ctx, page, hookContext) => {
+    const registry = hookContext.state.get(STATE_KEY) || new MockIpcRegistry();
+    return {
+      setMockIpc: async (action, data, options) => {
+        const preview = typeof data === "string" ? data : JSON.stringify(data).slice(0, 80);
+        console.log(`\u{1F4E6} [Plugin:mock-ipc] Dynamic set: ${action} -> ${preview}`);
+        registry.set(action, data, options);
+        await page.evaluate(
+          ({ action: action2, mock }) => {
+            const w = window;
+            if (!w.__visualRunnerMocks) {
+              w.__visualRunnerMocks = {};
+            }
+            w.__visualRunnerMocks[action2] = mock;
+          },
+          {
+            action,
+            mock: {
+              data,
+              type: options?.type ?? "SUCCESS",
+              delayMs: options?.delayMs ?? 20
+            }
+          }
+        );
+      }
+    };
+  },
+  teardown: (hookContext) => {
+    const registry = hookContext.state.get(STATE_KEY);
+    if (registry) {
+      registry.clear();
+      hookContext.state.delete(STATE_KEY);
+    }
+  }
+});
+var mock_ipc_default = mockIpcPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MockIpcRegistry,
+  generateMockIpcScript,
+  mockIpcPlugin
+});
+//# sourceMappingURL=index.js.map

package/dist/plugins/mock-ipc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/mock-ipc/index.ts","../../../src/shared/api/plugin.ts","../../../src/plugins/mock-ipc/registry.ts"],"sourcesContent":["import { definePlugin, type AgentLensPlugin } from '../../shared/api/plugin';\nimport { MockIpcRegistry, generateMockIpcScript } from './registry';\nimport type { MockIpcResponseType } from '../../shared/types/ipc';\n\nexport { MockIpcRegistry, generateMockIpcScript };\n\nconst STATE_KEY = 'mockIpcRegistry';\n\nexport const mockIpcPlugin: AgentLensPlugin = definePlugin({\n  name: 'mock-ipc',\n  version: '1.0.0',\n\n  setup: (hookContext) => {\n    const registry = new MockIpcRegistry();\n    hookContext.state.set(STATE_KEY, registry);\n\n    const scenarioMocks = hookContext.scenario?.mockIpc || [];\n    const globalMocks = (hookContext.cliOptions?.globalMocks as Array<{ action: string; data: unknown; type?: MockIpcResponseType; delayMs?: number }>) || [];\n    const allMocks = [...globalMocks, ...scenarioMocks];\n\n    if (allMocks.length > 0) {\n      console.log(`📦 [Plugin:mock-ipc] Pre-loading ${allMocks.length} initial IPC mocks`);\n      registry.setBatch(allMocks);\n    }\n  },\n\n  onContextCreated: async (context, hookContext) => {\n    const registry = (hookContext.state.get(STATE_KEY) as MockIpcRegistry) || new MockIpcRegistry();\n    const script = generateMockIpcScript(registry);\n    await context.addInitScript(script);\n    console.log(`🔌 [Plugin:mock-ipc] Injected window.__mockIpc & window.external bridge into browser context`);\n  },\n\n  extendContext: (_ctx, page, hookContext) => {\n    const registry = (hookContext.state.get(STATE_KEY) as MockIpcRegistry) || new MockIpcRegistry();\n\n    return {\n      setMockIpc: async (\n        action: string,\n        data: unknown,\n        options?: { type?: MockIpcResponseType; delayMs?: number }\n      ) => {\n        const preview = typeof data === 'string' ? data : JSON.stringify(data).slice(0, 80);\n        console.log(`📦 [Plugin:mock-ipc] Dynamic set: ${action} -> ${preview}`);\n        registry.set(action, data, options);\n\n        await page.evaluate(\n          ({ action, mock }) => {\n            const w = window as unknown as { __visualRunnerMocks?: Record<string, unknown> };\n            if (!w.__visualRunnerMocks) {\n              w.__visualRunnerMocks = {};\n            }\n            w.__visualRunnerMocks[action] = mock;\n          },\n          {\n            action,\n            mock: {\n              data,\n              type: options?.type ?? 'SUCCESS',\n              delayMs: options?.delayMs ?? 20\n            }\n          }\n        );\n      }\n    };\n  },\n\n  teardown: (hookContext) => {\n    const registry = hookContext.state.get(STATE_KEY) as MockIpcRegistry | undefined;\n    if (registry) {\n      registry.clear();\n      hookContext.state.delete(STATE_KEY);\n    }\n  }\n});\n\nexport default mockIpcPlugin;\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 type { MockIpcResponseType, MockIpcEntry } from '../../shared/types/ipc';\n\nexport class MockIpcRegistry {\n  private mocks = new Map<string, MockIpcEntry>();\n\n  public set(action: string, data: any, options?: { type?: MockIpcResponseType; delayMs?: number }): void {\n    this.mocks.set(action, {\n      action,\n      data,\n      type: options?.type ?? 'SUCCESS',\n      delayMs: options?.delayMs ?? 20\n    });\n  }\n\n  public setBatch(entries: Array<{ action: string; data: any; type?: MockIpcResponseType; delayMs?: number }>): void {\n    for (const entry of entries) {\n      this.set(entry.action, entry.data, { type: entry.type, delayMs: entry.delayMs });\n    }\n  }\n\n  public remove(action: string): void {\n    this.mocks.delete(action);\n  }\n\n  public clear(): void {\n    this.mocks.clear();\n  }\n\n  public get(action: string): MockIpcEntry | null {\n    return this.mocks.get(action) ?? null;\n  }\n\n  public toSerializable(): Record<string, { data: any; type: string; delayMs: number }> {\n    const result: Record<string, { data: any; type: string; delayMs: number }> = {};\n    for (const [action, entry] of this.mocks.entries()) {\n      result[action] = {\n        data: entry.data,\n        type: entry.type ?? 'SUCCESS',\n        delayMs: entry.delayMs ?? 20\n      };\n    }\n    return result;\n  }\n\n  public get size(): number {\n    return this.mocks.size;\n  }\n}\n\nexport function generateMockIpcScript(registry: MockIpcRegistry): string {\n  const mocksJson = JSON.stringify(registry.toSerializable());\n\n  return `\n    (() => {\n      const __mockTable = ${mocksJson};\n\n      window.__visualRunnerMocks = __mockTable;\n\n      // Generic IPC mock bridge for modern web applications\n      window.__mockIpc = {\n        invoke: (action, payload) => {\n          return new Promise((resolve, reject) => {\n            const mock = window.__visualRunnerMocks[action];\n\n            if (mock) {\n              setTimeout(() => {\n                if (mock.type === 'ERROR') {\n                  reject(new Error(mock.data));\n                } else {\n                  resolve(mock.data);\n                }\n              }, mock.delayMs || 20);\n            } else {\n              console.warn('[Mock IPC] No mock for action:', action, '— returning empty SUCCESS');\n              setTimeout(() => resolve(null), 20);\n            }\n          });\n        }\n      };\n\n      // Safe fallback bridge for hybrid webviews (Photino / CEF / WebView2)\n      try {\n        if (!window.external) {\n          window.external = {};\n        }\n        window.external.sendMessage = (msg) => {\n          try {\n            const parsed = typeof msg === 'string' ? JSON.parse(msg) : msg;\n            const action = parsed.Action || parsed.action;\n            const id = parsed.Id || parsed.id;\n            const mock = window.__visualRunnerMocks[action];\n\n            if (mock) {\n              const response = { Id: id, Type: mock.type || 'SUCCESS', Data: mock.data };\n              setTimeout(() => {\n                const cb = window.__mockCallback;\n                if (typeof cb === 'function') cb(JSON.stringify(response));\n              }, mock.delayMs || 20);\n            } else {\n              setTimeout(() => {\n                const cb = window.__mockCallback;\n                if (typeof cb === 'function') cb(JSON.stringify({ Id: id, Type: 'SUCCESS', Data: null }));\n              }, 20);\n            }\n          } catch (e) {\n            console.error('[Mock IPC] Failed to process message:', e);\n          }\n        };\n\n        window.external.receiveMessage = (callback) => {\n          window.__mockCallback = callback;\n        };\n      } catch {\n        // Ignored if window.external is read-only in strict Chromium sandboxes\n      }\n\n      console.log('[Visual Runner] Mock IPC bridge initialized with', Object.keys(window.__visualRunnerMocks).length, 'mocked actions');\n    })();\n  `;\n}\n"],"mappings":"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","names":["action"]}