@midscene/web 1.7.7 → 1.7.9

package/dist/es/mcp-tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.mjs","sources":["../../src/mcp-tools.ts"],"sourcesContent":["import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const reportOptions = this.readCliReportAgentOptions();\n    const agent = new AgentOverChromeBridge({\n      closeConflictServer: true,\n      ...(reportOptions ?? {}),\n    });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-tab',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected to: ${label}` },\n              ...(screenshot ? this.buildScreenshotContent(screenshot) : []),\n            ],\n          };\n        },\n      },\n      {\n        name: 'web_disconnect',\n        description:\n          'Disconnect from current web page and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","openNewTabWithUrl","error","console","undefined","url","reportOptions","agent","AgentOverChromeBridge","z","args","reportSession","screenshot","label"],"mappings":";;;;AASO,MAAMA,yBAAyBC;IAC1B,0BAA0B;QAClC,OAAO;IACT;IAEU,wBAAwB;QAIhC,OAAO,IAAIC,WAAW;YACpB,YAAYC,eAAe,MAAM,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAU;gBAAE,OAAO;gBAAM,QAAQ;YAAK;YACtC,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,gBAAgB,IAAI,CAAC,yBAAyB;QACpD,MAAMC,QAAQ,IAAIC,sBAAsB;YACtC,qBAAqB;YACrB,GAAIF,iBAAiB,CAAC,CAAC;QACzB;QAEA,IAAKD,KAGH,MAAME,MAAM,oBAAoB,CAACF;aAFjC,MAAME,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,EAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEL,GAAG,EAAE,GAAGK;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGN;oBACf;oBACA,MAAMO,gBAAgB,IAAI,CAAC,yBAAyB,CAClDN,OAAO;oBAET,IAAI,CAAC,sBAAsB,CAACM;oBAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACN;oBAE5C,MAAMO,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQR,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEQ,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}
+{"version":3,"file":"mcp-tools.mjs","sources":["../../src/mcp-tools.ts"],"sourcesContent":["import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { defaultStaticPageViewportSize } from './common/viewport';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const reportOptions = this.readCliReportAgentOptions();\n    const agent = new AgentOverChromeBridge({\n      closeConflictServer: true,\n      ...(reportOptions ?? {}),\n    });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-tab',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected to: ${label}` },\n              ...(screenshot ? this.buildScreenshotContent(screenshot) : []),\n            ],\n          };\n        },\n      },\n      {\n        name: 'web_disconnect',\n        description:\n          'Disconnect from current web page and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","openNewTabWithUrl","error","console","undefined","url","reportOptions","agent","AgentOverChromeBridge","z","args","reportSession","screenshot","label"],"mappings":";;;;;AAUO,MAAMA,yBAAyBC;IAC1B,0BAA0B;QAClC,OAAO;IACT;IAEU,wBAAwB;QAIhC,OAAO,IAAIC,WAAW;YACpB,YAAYC,eAAe,MAAM,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAUC;YACV,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,gBAAgB,IAAI,CAAC,yBAAyB;QACpD,MAAMC,QAAQ,IAAIC,sBAAsB;YACtC,qBAAqB;YACrB,GAAIF,iBAAiB,CAAC,CAAC;QACzB;QAEA,IAAKD,KAGH,MAAME,MAAM,oBAAoB,CAACF;aAFjC,MAAME,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,EAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEL,GAAG,EAAE,GAAGK;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGN;oBACf;oBACA,MAAMO,gBAAgB,IAAI,CAAC,yBAAyB,CAClDN,OAAO;oBAET,IAAI,CAAC,sBAAsB,CAACM;oBAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACN;oBAE5C,MAAMO,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQR,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEQ,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}

package/dist/es/puppeteer/agent-launcher.mjs

@@ -1,12 +1,11 @@
 import { readFileSync } from "node:fs";
 import { getDebug } from "@midscene/shared/logger";
 import { assert } from "@midscene/shared/utils";
+import { defaultViewportHeight, defaultViewportWidth, resolveWebViewportSize } from "../common/viewport.mjs";
 import { PuppeteerAgent } from "./index.mjs";
 import { DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from "@midscene/shared/constants";
 import puppeteer from "puppeteer";
 const defaultUA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36';
-const defaultViewportWidth = 1440;
-const defaultViewportHeight = 768;
 const defaultViewportScale = 0;
 const defaultWaitForNetworkIdleTimeout = DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT;
 function resolveAiActionContext(target, preference) {
@@ -68,18 +67,7 @@ async function launchPuppeteerPage(target, preference, browser, existingPage) {
     assert(target.url, 'url is required');
     const freeFn = [];
     const ua = target.userAgent || defaultUA;
-    let width = defaultViewportWidth;
-    if (void 0 !== target.viewportWidth && null !== target.viewportWidth) {
-        assert('number' == typeof target.viewportWidth, 'viewportWidth must be a number');
-        width = Number.parseInt(target.viewportWidth, 10);
-        assert(width > 0, `viewportWidth must be greater than 0, but got ${width}`);
-    }
-    let height = defaultViewportHeight;
-    if (void 0 !== target.viewportHeight && null !== target.viewportHeight) {
-        assert('number' == typeof target.viewportHeight, 'viewportHeight must be a number');
-        height = Number.parseInt(target.viewportHeight, 10);
-        assert(height > 0, `viewportHeight must be greater than 0, but got ${height}`);
-    }
+    const { width, height } = resolveWebViewportSize(target);
     let dpr = defaultViewportScale;
     if (void 0 !== target.deviceScaleFactor && null !== target.deviceScaleFactor) {
         assert('number' == typeof target.deviceScaleFactor, 'deviceScaleFactor must be a number');

package/dist/es/puppeteer/agent-launcher.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"puppeteer/agent-launcher.mjs","sources":["../../../src/puppeteer/agent-launcher.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\n\nimport { PuppeteerAgent } from '@/puppeteer/index';\nimport type { AgentOpt, Cache, MidsceneYamlScriptWebEnv } from '@midscene/core';\nimport { DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from '@midscene/shared/constants';\nimport puppeteer, { type Browser, type Page } from 'puppeteer';\n\nexport const defaultUA =\n  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36';\nexport const defaultViewportWidth = 1440;\nexport const defaultViewportHeight = 768;\n// Setting deviceScaleFactor value to `0` means reset this value to the system default in Puppeteer.\nexport const defaultViewportScale = 0;\nexport const defaultWaitForNetworkIdleTimeout =\n  DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT;\n\nexport function resolveAiActionContext(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: Partial<Pick<AgentOpt, 'aiActionContext' | 'aiActContext'>>,\n): AgentOpt['aiActionContext'] | undefined {\n  // Prefer agent-level preference if provided; otherwise fall back to target-level context.\n  // Priority: preference.aiActContext > preference.aiActionContext (deprecated) > target.aiActionContext\n  const data =\n    preference?.aiActContext ??\n    preference?.aiActionContext ??\n    target.aiActionContext;\n  return data;\n}\n\n/**\n * Chrome arguments that may reduce browser security.\n * These should only be used in controlled testing environments.\n *\n * Security implications:\n * - `--no-sandbox`: Disables Chrome's sandbox security model\n * - `--disable-setuid-sandbox`: Disables setuid sandbox on Linux\n * - `--disable-web-security`: Allows cross-origin requests without CORS\n * - `--ignore-certificate-errors`: Ignores SSL/TLS certificate errors\n * - `--disable-features=IsolateOrigins`: Disables origin isolation\n * - `--disable-site-isolation-trials`: Disables site isolation\n * - `--allow-running-insecure-content`: Allows mixed HTTP/HTTPS content\n */\nconst DANGEROUS_ARGS = [\n  '--no-sandbox',\n  '--disable-setuid-sandbox',\n  '--disable-web-security',\n  '--ignore-certificate-errors',\n  '--disable-features=IsolateOrigins',\n  '--disable-site-isolation-trials',\n  '--allow-running-insecure-content',\n] as const;\n\n/**\n * Validates Chrome launch arguments for security concerns.\n * Emits a warning if dangerous arguments are detected.\n *\n * This function filters out arguments that are already present in baseArgs\n * to avoid warning about platform-specific defaults (e.g., --no-sandbox on non-Windows).\n *\n * @param args - Chrome launch arguments to validate\n * @param baseArgs - Base Chrome arguments already configured\n *\n * @example\n * ```typescript\n * // Will show warning for --disable-web-security\n * validateChromeArgs(['--disable-web-security', '--headless'], ['--no-sandbox']);\n *\n * // Will NOT show warning for --no-sandbox (already in baseArgs)\n * validateChromeArgs(['--no-sandbox'], ['--no-sandbox', '--headless']);\n * ```\n */\nfunction validateChromeArgs(args: string[], baseArgs: string[]): void {\n  // Filter out arguments that are already in baseArgs\n  const newArgs = args.filter(\n    (arg) =>\n      !baseArgs.some((baseArg) => {\n        // Check if arg starts with the same flag as baseArg (before '=' if present)\n        const argFlag = arg.split('=')[0];\n        const baseFlag = baseArg.split('=')[0];\n        return argFlag === baseFlag;\n      }),\n  );\n\n  const dangerousArgs = newArgs.filter((arg) =>\n    DANGEROUS_ARGS.some((dangerous) => arg.startsWith(dangerous)),\n  );\n\n  if (dangerousArgs.length > 0) {\n    console.warn(\n      `Warning: Dangerous Chrome arguments detected: ${dangerousArgs.join(', ')}.\\nThese arguments may reduce browser security. Use only in controlled testing environments.`,\n    );\n  }\n}\n\ninterface FreeFn {\n  name: string;\n  fn: () => void;\n}\n\nconst launcherDebug = getDebug('puppeteer:launcher');\n\nexport interface BuildChromeArgsOptions {\n  userAgent?: string;\n  windowSize?: { width: number; height: number };\n  chromeArgs?: string[];\n}\n\n/**\n * Builds Chrome launch arguments with sensible defaults.\n *\n * Platform-specific behavior:\n * - On non-Windows systems, automatically adds --no-sandbox and --disable-setuid-sandbox\n *   for compatibility with containerized/CI environments\n *\n * @param options - Configuration options for Chrome arguments\n * @returns Array of Chrome launch arguments\n *\n * @example\n * ```typescript\n * // Basic usage\n * const args = buildChromeArgs();\n *\n * // With custom arguments\n * const args = buildChromeArgs({\n *   chromeArgs: ['--disable-gpu', '--disable-dev-shm-usage'],\n *   userAgent: 'CustomUA/1.0',\n *   windowSize: { width: 1920, height: 1080 },\n * });\n * ```\n */\nexport function buildChromeArgs(options?: BuildChromeArgsOptions): string[] {\n  const isWindows = process.platform === 'win32';\n\n  const sandboxArgs = isWindows\n    ? []\n    : ['--no-sandbox', '--disable-setuid-sandbox'];\n  const featureArgs = [\n    '--disable-features=HttpsFirstBalancedModeAutoEnable',\n    '--disable-features=PasswordLeakDetection',\n    '--disable-save-password-bubble',\n  ];\n  const userAgentArg = options?.userAgent\n    ? [`--user-agent=\"${options.userAgent}\"`]\n    : [];\n  const windowSizeArg = options?.windowSize\n    ? [`--window-size=${options.windowSize.width},${options.windowSize.height}`]\n    : [];\n\n  const baseArgs = [\n    ...sandboxArgs,\n    ...featureArgs,\n    ...userAgentArg,\n    ...windowSizeArg,\n  ];\n\n  if (options?.chromeArgs?.length) {\n    validateChromeArgs(options.chromeArgs, baseArgs);\n    return [...baseArgs, ...options.chromeArgs];\n  }\n\n  return baseArgs;\n}\n\nexport async function launchPuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n) {\n  assert(target.url, 'url is required');\n  const freeFn: FreeFn[] = [];\n\n  // prepare the environment\n  const ua = target.userAgent || defaultUA;\n  let width = defaultViewportWidth;\n  if (target.viewportWidth !== undefined && target.viewportWidth !== null) {\n    assert(\n      typeof target.viewportWidth === 'number',\n      'viewportWidth must be a number',\n    );\n    width = Number.parseInt(target.viewportWidth as unknown as string, 10);\n    assert(width > 0, `viewportWidth must be greater than 0, but got ${width}`);\n  }\n  let height = defaultViewportHeight;\n  if (target.viewportHeight !== undefined && target.viewportHeight !== null) {\n    assert(\n      typeof target.viewportHeight === 'number',\n      'viewportHeight must be a number',\n    );\n    height = Number.parseInt(target.viewportHeight as unknown as string, 10);\n    assert(\n      height > 0,\n      `viewportHeight must be greater than 0, but got ${height}`,\n    );\n  }\n  let dpr = defaultViewportScale;\n  if (\n    target.deviceScaleFactor !== undefined &&\n    target.deviceScaleFactor !== null\n  ) {\n    assert(\n      typeof target.deviceScaleFactor === 'number',\n      'deviceScaleFactor must be a number',\n    );\n    dpr = target.deviceScaleFactor;\n    assert(dpr > 0, `deviceScaleFactor must be > 0, but got ${dpr}`);\n  }\n  const viewportConfig = {\n    width,\n    height,\n    deviceScaleFactor: dpr,\n  };\n\n  const headed = preference?.headed || preference?.keepWindow;\n  const defaultViewportConfig = headed ? null : viewportConfig;\n\n  // launch the browser\n  if (headed && process.env.CI === '1') {\n    console.warn(\n      'you are probably running headed mode in CI, this will usually fail.',\n    );\n  }\n\n  // Build Chrome arguments using the shared helper\n  // Only pass windowSize in headed mode; in headless mode, defaultViewport takes precedence\n  // Add 100px to height to account for browser UI (address bar, tabs, etc.)\n  const browserUIHeight = 100;\n  const args = buildChromeArgs({\n    userAgent: ua,\n    windowSize: headed\n      ? { width, height: height + browserUIHeight }\n      : undefined,\n    chromeArgs: target.chromeArgs,\n  });\n\n  launcherDebug(\n    'launching browser with viewport, headed',\n    headed,\n    'viewport',\n    viewportConfig,\n    'args',\n    args,\n    'preference',\n    preference,\n  );\n  // If an existing page is provided, reuse it instead of creating a new one\n  // This allows sharing localStorage and sessionStorage between YAML files\n  let page: Page;\n  let browserInstance = browser;\n\n  if (existingPage) {\n    // Reuse the existing page - this preserves localStorage and sessionStorage\n    page = existingPage;\n    launcherDebug('reusing existing page for shared browser context');\n\n    // Get the browser instance from the existing page\n    if (!browserInstance) {\n      browserInstance = page.browser();\n    }\n  } else {\n    // Create a new browser and page\n    if (!browserInstance) {\n      browserInstance = await puppeteer.launch({\n        headless: !preference?.headed,\n        defaultViewport: defaultViewportConfig,\n        args,\n        acceptInsecureCerts: target.acceptInsecureCerts,\n        ignoreDefaultArgs: preference?.ignoreDefaultArgs,\n      });\n      freeFn.push({\n        name: 'puppeteer_browser',\n        fn: () => {\n          if (!preference?.keepWindow) {\n            if (process.platform === 'win32') {\n              setTimeout(() => {\n                browserInstance?.close();\n              }, 800);\n            } else {\n              browserInstance?.close();\n            }\n          }\n        },\n      });\n    }\n    page = await browserInstance.newPage();\n  }\n\n  if (target.cookie) {\n    const cookieFileContent = readFileSync(target.cookie, 'utf-8');\n    await browserInstance.setCookie(...JSON.parse(cookieFileContent));\n  }\n\n  if (ua) {\n    await page.setUserAgent(ua);\n  }\n\n  if (viewportConfig) {\n    await page.setViewport(viewportConfig);\n  }\n\n  const waitForNetworkIdleTimeout =\n    typeof target.waitForNetworkIdle?.timeout === 'number'\n      ? target.waitForNetworkIdle.timeout\n      : defaultWaitForNetworkIdleTimeout;\n\n  try {\n    launcherDebug('goto', target.url);\n    await page.goto(target.url);\n    if (waitForNetworkIdleTimeout > 0) {\n      launcherDebug('waitForNetworkIdle', waitForNetworkIdleTimeout);\n      await page.waitForNetworkIdle({\n        timeout: waitForNetworkIdleTimeout,\n      });\n    }\n  } catch (e) {\n    if (\n      typeof target.waitForNetworkIdle?.continueOnNetworkIdleError ===\n        'boolean' &&\n      !target.waitForNetworkIdle?.continueOnNetworkIdleError\n    ) {\n      const newError = new Error(`failed to wait for network idle: ${e}`, {\n        cause: e,\n      });\n      throw newError;\n    }\n    const newMessage = `failed to wait for network idle after ${waitForNetworkIdleTimeout}ms, but the script will continue.`;\n    console.warn(newMessage);\n  }\n\n  return { page, freeFn };\n}\n\nexport async function puppeteerAgentForTarget(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n  } & Partial<\n    Pick<\n      AgentOpt,\n      | 'groupName'\n      | 'groupDescription'\n      | 'generateReport'\n      | 'persistExecutionDump'\n      | 'autoPrintReportMsg'\n      | 'reportFileName'\n      | 'replanningCycleLimit'\n      | 'cache'\n      | 'aiActionContext'\n    >\n  >,\n  browser?: Browser,\n  existingPage?: Page,\n) {\n  const { page, freeFn } = await launchPuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n  );\n  const aiActContext = resolveAiActionContext(target, preference);\n\n  const { aiActionContext, ...preferenceToUse } = preference ?? {};\n\n  // prepare Midscene agent\n  const agent = new PuppeteerAgent(page, {\n    ...preferenceToUse,\n    aiActContext,\n    waitForNetworkIdleTimeout:\n      typeof target.waitForNetworkIdle?.timeout === 'number'\n        ? target.waitForNetworkIdle.timeout\n        : undefined,\n    forceSameTabNavigation:\n      typeof target.forceSameTabNavigation !== 'undefined'\n        ? target.forceSameTabNavigation\n        : true, // true for default in yaml script\n  });\n\n  freeFn.push({\n    name: 'midscene_puppeteer_agent',\n    fn: () => agent.destroy(),\n  });\n\n  return { agent, freeFn };\n}\n"],"names":["defaultUA","defaultViewportWidth","defaultViewportHeight","defaultViewportScale","defaultWaitForNetworkIdleTimeout","DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT","resolveAiActionContext","target","preference","data","DANGEROUS_ARGS","validateChromeArgs","args","baseArgs","newArgs","arg","baseArg","argFlag","baseFlag","dangerousArgs","dangerous","console","launcherDebug","getDebug","buildChromeArgs","options","isWindows","process","sandboxArgs","featureArgs","userAgentArg","windowSizeArg","launchPuppeteerPage","browser","existingPage","assert","freeFn","ua","width","undefined","Number","height","dpr","viewportConfig","headed","defaultViewportConfig","browserUIHeight","page","browserInstance","puppeteer","setTimeout","cookieFileContent","readFileSync","JSON","waitForNetworkIdleTimeout","e","newError","Error","newMessage","puppeteerAgentForTarget","aiActContext","aiActionContext","preferenceToUse","agent","PuppeteerAgent"],"mappings":"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"}
+{"version":3,"file":"puppeteer/agent-launcher.mjs","sources":["../../../src/puppeteer/agent-launcher.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\n\nimport {\n  defaultViewportHeight,\n  defaultViewportWidth,\n  resolveWebViewportSize,\n} from '@/common/viewport';\nimport { PuppeteerAgent } from '@/puppeteer/index';\nimport type { AgentOpt, Cache, MidsceneYamlScriptWebEnv } from '@midscene/core';\nimport { DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from '@midscene/shared/constants';\nimport puppeteer, { type Browser, type Page } from 'puppeteer';\n\nexport { defaultViewportWidth, defaultViewportHeight } from '@/common/viewport';\n\nexport const defaultUA =\n  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36';\n// Setting deviceScaleFactor value to `0` means reset this value to the system default in Puppeteer.\nexport const defaultViewportScale = 0;\nexport const defaultWaitForNetworkIdleTimeout =\n  DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT;\n\nexport function resolveAiActionContext(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: Partial<Pick<AgentOpt, 'aiActionContext' | 'aiActContext'>>,\n): AgentOpt['aiActionContext'] | undefined {\n  // Prefer agent-level preference if provided; otherwise fall back to target-level context.\n  // Priority: preference.aiActContext > preference.aiActionContext (deprecated) > target.aiActionContext\n  const data =\n    preference?.aiActContext ??\n    preference?.aiActionContext ??\n    target.aiActionContext;\n  return data;\n}\n\n/**\n * Chrome arguments that may reduce browser security.\n * These should only be used in controlled testing environments.\n *\n * Security implications:\n * - `--no-sandbox`: Disables Chrome's sandbox security model\n * - `--disable-setuid-sandbox`: Disables setuid sandbox on Linux\n * - `--disable-web-security`: Allows cross-origin requests without CORS\n * - `--ignore-certificate-errors`: Ignores SSL/TLS certificate errors\n * - `--disable-features=IsolateOrigins`: Disables origin isolation\n * - `--disable-site-isolation-trials`: Disables site isolation\n * - `--allow-running-insecure-content`: Allows mixed HTTP/HTTPS content\n */\nconst DANGEROUS_ARGS = [\n  '--no-sandbox',\n  '--disable-setuid-sandbox',\n  '--disable-web-security',\n  '--ignore-certificate-errors',\n  '--disable-features=IsolateOrigins',\n  '--disable-site-isolation-trials',\n  '--allow-running-insecure-content',\n] as const;\n\n/**\n * Validates Chrome launch arguments for security concerns.\n * Emits a warning if dangerous arguments are detected.\n *\n * This function filters out arguments that are already present in baseArgs\n * to avoid warning about platform-specific defaults (e.g., --no-sandbox on non-Windows).\n *\n * @param args - Chrome launch arguments to validate\n * @param baseArgs - Base Chrome arguments already configured\n *\n * @example\n * ```typescript\n * // Will show warning for --disable-web-security\n * validateChromeArgs(['--disable-web-security', '--headless'], ['--no-sandbox']);\n *\n * // Will NOT show warning for --no-sandbox (already in baseArgs)\n * validateChromeArgs(['--no-sandbox'], ['--no-sandbox', '--headless']);\n * ```\n */\nfunction validateChromeArgs(args: string[], baseArgs: string[]): void {\n  // Filter out arguments that are already in baseArgs\n  const newArgs = args.filter(\n    (arg) =>\n      !baseArgs.some((baseArg) => {\n        // Check if arg starts with the same flag as baseArg (before '=' if present)\n        const argFlag = arg.split('=')[0];\n        const baseFlag = baseArg.split('=')[0];\n        return argFlag === baseFlag;\n      }),\n  );\n\n  const dangerousArgs = newArgs.filter((arg) =>\n    DANGEROUS_ARGS.some((dangerous) => arg.startsWith(dangerous)),\n  );\n\n  if (dangerousArgs.length > 0) {\n    console.warn(\n      `Warning: Dangerous Chrome arguments detected: ${dangerousArgs.join(', ')}.\\nThese arguments may reduce browser security. Use only in controlled testing environments.`,\n    );\n  }\n}\n\ninterface FreeFn {\n  name: string;\n  fn: () => void;\n}\n\nconst launcherDebug = getDebug('puppeteer:launcher');\n\nexport interface BuildChromeArgsOptions {\n  userAgent?: string;\n  windowSize?: { width: number; height: number };\n  chromeArgs?: string[];\n}\n\n/**\n * Builds Chrome launch arguments with sensible defaults.\n *\n * Platform-specific behavior:\n * - On non-Windows systems, automatically adds --no-sandbox and --disable-setuid-sandbox\n *   for compatibility with containerized/CI environments\n *\n * @param options - Configuration options for Chrome arguments\n * @returns Array of Chrome launch arguments\n *\n * @example\n * ```typescript\n * // Basic usage\n * const args = buildChromeArgs();\n *\n * // With custom arguments\n * const args = buildChromeArgs({\n *   chromeArgs: ['--disable-gpu', '--disable-dev-shm-usage'],\n *   userAgent: 'CustomUA/1.0',\n *   windowSize: { width: 1920, height: 1080 },\n * });\n * ```\n */\nexport function buildChromeArgs(options?: BuildChromeArgsOptions): string[] {\n  const isWindows = process.platform === 'win32';\n\n  const sandboxArgs = isWindows\n    ? []\n    : ['--no-sandbox', '--disable-setuid-sandbox'];\n  const featureArgs = [\n    '--disable-features=HttpsFirstBalancedModeAutoEnable',\n    '--disable-features=PasswordLeakDetection',\n    '--disable-save-password-bubble',\n  ];\n  const userAgentArg = options?.userAgent\n    ? [`--user-agent=\"${options.userAgent}\"`]\n    : [];\n  const windowSizeArg = options?.windowSize\n    ? [`--window-size=${options.windowSize.width},${options.windowSize.height}`]\n    : [];\n\n  const baseArgs = [\n    ...sandboxArgs,\n    ...featureArgs,\n    ...userAgentArg,\n    ...windowSizeArg,\n  ];\n\n  if (options?.chromeArgs?.length) {\n    validateChromeArgs(options.chromeArgs, baseArgs);\n    return [...baseArgs, ...options.chromeArgs];\n  }\n\n  return baseArgs;\n}\n\nexport async function launchPuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n) {\n  assert(target.url, 'url is required');\n  const freeFn: FreeFn[] = [];\n\n  // prepare the environment\n  const ua = target.userAgent || defaultUA;\n  const { width, height } = resolveWebViewportSize(target);\n  let dpr = defaultViewportScale;\n  if (\n    target.deviceScaleFactor !== undefined &&\n    target.deviceScaleFactor !== null\n  ) {\n    assert(\n      typeof target.deviceScaleFactor === 'number',\n      'deviceScaleFactor must be a number',\n    );\n    dpr = target.deviceScaleFactor;\n    assert(dpr > 0, `deviceScaleFactor must be > 0, but got ${dpr}`);\n  }\n  const viewportConfig = {\n    width,\n    height,\n    deviceScaleFactor: dpr,\n  };\n\n  const headed = preference?.headed || preference?.keepWindow;\n  const defaultViewportConfig = headed ? null : viewportConfig;\n\n  // launch the browser\n  if (headed && process.env.CI === '1') {\n    console.warn(\n      'you are probably running headed mode in CI, this will usually fail.',\n    );\n  }\n\n  // Build Chrome arguments using the shared helper\n  // Only pass windowSize in headed mode; in headless mode, defaultViewport takes precedence\n  // Add 100px to height to account for browser UI (address bar, tabs, etc.)\n  const browserUIHeight = 100;\n  const args = buildChromeArgs({\n    userAgent: ua,\n    windowSize: headed\n      ? { width, height: height + browserUIHeight }\n      : undefined,\n    chromeArgs: target.chromeArgs,\n  });\n\n  launcherDebug(\n    'launching browser with viewport, headed',\n    headed,\n    'viewport',\n    viewportConfig,\n    'args',\n    args,\n    'preference',\n    preference,\n  );\n  // If an existing page is provided, reuse it instead of creating a new one\n  // This allows sharing localStorage and sessionStorage between YAML files\n  let page: Page;\n  let browserInstance = browser;\n\n  if (existingPage) {\n    // Reuse the existing page - this preserves localStorage and sessionStorage\n    page = existingPage;\n    launcherDebug('reusing existing page for shared browser context');\n\n    // Get the browser instance from the existing page\n    if (!browserInstance) {\n      browserInstance = page.browser();\n    }\n  } else {\n    // Create a new browser and page\n    if (!browserInstance) {\n      browserInstance = await puppeteer.launch({\n        headless: !preference?.headed,\n        defaultViewport: defaultViewportConfig,\n        args,\n        acceptInsecureCerts: target.acceptInsecureCerts,\n        ignoreDefaultArgs: preference?.ignoreDefaultArgs,\n      });\n      freeFn.push({\n        name: 'puppeteer_browser',\n        fn: () => {\n          if (!preference?.keepWindow) {\n            if (process.platform === 'win32') {\n              setTimeout(() => {\n                browserInstance?.close();\n              }, 800);\n            } else {\n              browserInstance?.close();\n            }\n          }\n        },\n      });\n    }\n    page = await browserInstance.newPage();\n  }\n\n  if (target.cookie) {\n    const cookieFileContent = readFileSync(target.cookie, 'utf-8');\n    await browserInstance.setCookie(...JSON.parse(cookieFileContent));\n  }\n\n  if (ua) {\n    await page.setUserAgent(ua);\n  }\n\n  if (viewportConfig) {\n    await page.setViewport(viewportConfig);\n  }\n\n  const waitForNetworkIdleTimeout =\n    typeof target.waitForNetworkIdle?.timeout === 'number'\n      ? target.waitForNetworkIdle.timeout\n      : defaultWaitForNetworkIdleTimeout;\n\n  try {\n    launcherDebug('goto', target.url);\n    await page.goto(target.url);\n    if (waitForNetworkIdleTimeout > 0) {\n      launcherDebug('waitForNetworkIdle', waitForNetworkIdleTimeout);\n      await page.waitForNetworkIdle({\n        timeout: waitForNetworkIdleTimeout,\n      });\n    }\n  } catch (e) {\n    if (\n      typeof target.waitForNetworkIdle?.continueOnNetworkIdleError ===\n        'boolean' &&\n      !target.waitForNetworkIdle?.continueOnNetworkIdleError\n    ) {\n      const newError = new Error(`failed to wait for network idle: ${e}`, {\n        cause: e,\n      });\n      throw newError;\n    }\n    const newMessage = `failed to wait for network idle after ${waitForNetworkIdleTimeout}ms, but the script will continue.`;\n    console.warn(newMessage);\n  }\n\n  return { page, freeFn };\n}\n\nexport async function puppeteerAgentForTarget(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n  } & Partial<\n    Pick<\n      AgentOpt,\n      | 'groupName'\n      | 'groupDescription'\n      | 'generateReport'\n      | 'persistExecutionDump'\n      | 'autoPrintReportMsg'\n      | 'reportFileName'\n      | 'replanningCycleLimit'\n      | 'cache'\n      | 'aiActionContext'\n    >\n  >,\n  browser?: Browser,\n  existingPage?: Page,\n) {\n  const { page, freeFn } = await launchPuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n  );\n  const aiActContext = resolveAiActionContext(target, preference);\n\n  const { aiActionContext, ...preferenceToUse } = preference ?? {};\n\n  // prepare Midscene agent\n  const agent = new PuppeteerAgent(page, {\n    ...preferenceToUse,\n    aiActContext,\n    waitForNetworkIdleTimeout:\n      typeof target.waitForNetworkIdle?.timeout === 'number'\n        ? target.waitForNetworkIdle.timeout\n        : undefined,\n    forceSameTabNavigation:\n      typeof target.forceSameTabNavigation !== 'undefined'\n        ? target.forceSameTabNavigation\n        : true, // true for default in yaml script\n  });\n\n  freeFn.push({\n    name: 'midscene_puppeteer_agent',\n    fn: () => agent.destroy(),\n  });\n\n  return { agent, freeFn };\n}\n"],"names":["defaultUA","defaultViewportScale","defaultWaitForNetworkIdleTimeout","DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT","resolveAiActionContext","target","preference","data","DANGEROUS_ARGS","validateChromeArgs","args","baseArgs","newArgs","arg","baseArg","argFlag","baseFlag","dangerousArgs","dangerous","console","launcherDebug","getDebug","buildChromeArgs","options","isWindows","process","sandboxArgs","featureArgs","userAgentArg","windowSizeArg","launchPuppeteerPage","browser","existingPage","assert","freeFn","ua","width","height","resolveWebViewportSize","dpr","undefined","viewportConfig","headed","defaultViewportConfig","browserUIHeight","page","browserInstance","puppeteer","setTimeout","cookieFileContent","readFileSync","JSON","waitForNetworkIdleTimeout","e","newError","Error","newMessage","puppeteerAgentForTarget","aiActContext","aiActionContext","preferenceToUse","agent","PuppeteerAgent"],"mappings":"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"}

package/dist/lib/bridge-mode/io-client.js

@@ -51,7 +51,7 @@ class BridgeClient {
                     ]
                 } : {},
                 query: {
-                    version: "1.7.7"
+                    version: "1.7.9"
                 }
             });
             const timeout = setTimeout(()=>{

package/dist/lib/bridge-mode/io-server.js

@@ -115,7 +115,7 @@ class BridgeServer {
                     (0, shared_utils_namespaceObject.logMsg)('one client connected');
                     this.socket = socket;
                     const clientVersion = socket.handshake.query.version;
-                    (0, shared_utils_namespaceObject.logMsg)(`Bridge connected, cli-side version v1.7.7, browser-side version v${clientVersion}`);
+                    (0, shared_utils_namespaceObject.logMsg)(`Bridge connected, cli-side version v1.7.9, browser-side version v${clientVersion}`);
                     socket.on(external_common_js_namespaceObject.BridgeEvent.CallResponse, (params)=>{
                         const id = params.id;
                         const response = params.response;
@@ -139,7 +139,7 @@ class BridgeServer {
                     setTimeout(()=>{
                         this.onConnect?.();
                         const payload = {
-                            version: "1.7.7"
+                            version: "1.7.9"
                         };
                         socket.emit(external_common_js_namespaceObject.BridgeEvent.Connected, payload);
                         Promise.resolve().then(()=>{

package/dist/lib/bridge-mode/page-browser-side.js

@@ -103,7 +103,7 @@ class ExtensionBridgePageBrowserSide extends page_js_default() {
                 throw new Error('Connection denied by user');
             }
         }
-        this.onLogMessage(`Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v1.7.7`, 'log');
+        this.onLogMessage(`Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v1.7.9`, 'log');
     }
     async connect() {
         return await this.setupBridgeClient();

package/dist/lib/cli-options.js

@@ -0,0 +1,133 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    parseWebCliOptions: ()=>parseWebCliOptions
+});
+const cli_namespaceObject = require("@midscene/shared/cli");
+const viewport_js_namespaceObject = require("./common/viewport.js");
+const viewportWidthFlag = '--viewport-width';
+const viewportHeightFlag = '--viewport-height';
+function isLikelyCdpEndpoint(value) {
+    return !!value && /^(wss?):\/\//.test(value);
+}
+function parsePositiveIntegerOption(flag, rawValue) {
+    const value = Number(rawValue);
+    if (!Number.isInteger(value) || value <= 0) throw new cli_namespaceObject.CLIError(`Invalid value for "${flag}": expected a positive integer, got "${rawValue}".`);
+    return value;
+}
+function readRequiredOptionValue(args, index, flag) {
+    const currentArg = args[index];
+    const inlinePrefix = `${flag}=`;
+    if (currentArg.startsWith(inlinePrefix)) return {
+        value: currentArg.slice(inlinePrefix.length),
+        nextIndex: index
+    };
+    const nextArg = args[index + 1];
+    if (!nextArg || nextArg.startsWith('--')) throw new cli_namespaceObject.CLIError(`Option "${flag}" requires a value.`);
+    return {
+        value: nextArg,
+        nextIndex: index + 1
+    };
+}
+function readOptionalCdpEndpoint(args, index) {
+    const currentArg = args[index];
+    const inlinePrefix = '--cdp=';
+    if (currentArg.startsWith(inlinePrefix)) return {
+        value: currentArg.slice(inlinePrefix.length),
+        nextIndex: index
+    };
+    const nextArg = args[index + 1];
+    if (!isLikelyCdpEndpoint(nextArg)) return {
+        nextIndex: index
+    };
+    return {
+        value: nextArg,
+        nextIndex: index + 1
+    };
+}
+function parseWebCliOptions(rawArgs, env = process.env) {
+    const argv = [];
+    let isBridge = false;
+    let isCdp = false;
+    let viewportWidth;
+    let viewportHeight;
+    let cdpEndpoint;
+    for(let index = 0; index < rawArgs.length; index += 1){
+        const arg = rawArgs[index];
+        if ('--bridge' === arg) {
+            isBridge = true;
+            continue;
+        }
+        if ('--cdp' === arg || arg.startsWith('--cdp=')) {
+            isCdp = true;
+            const parsed = readOptionalCdpEndpoint(rawArgs, index);
+            cdpEndpoint = parsed.value ?? cdpEndpoint;
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (arg === viewportWidthFlag || arg.startsWith(`${viewportWidthFlag}=`)) {
+            const parsed = readRequiredOptionValue(rawArgs, index, viewportWidthFlag);
+            viewportWidth = parsePositiveIntegerOption(viewportWidthFlag, parsed.value);
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (arg === viewportHeightFlag || arg.startsWith(`${viewportHeightFlag}=`)) {
+            const parsed = readRequiredOptionValue(rawArgs, index, viewportHeightFlag);
+            viewportHeight = parsePositiveIntegerOption(viewportHeightFlag, parsed.value);
+            index = parsed.nextIndex;
+            continue;
+        }
+        argv.push(arg);
+    }
+    if (isBridge && isCdp) throw new cli_namespaceObject.CLIError('--bridge and --cdp are mutually exclusive. Please specify only one.');
+    const mode = isBridge ? 'bridge' : isCdp ? 'cdp' : 'puppeteer';
+    if ('puppeteer' !== mode) {
+        if (void 0 !== viewportWidth || void 0 !== viewportHeight) throw new cli_namespaceObject.CLIError('Viewport options are only supported in the default Puppeteer mode.');
+    }
+    if ('cdp' === mode) {
+        cdpEndpoint = cdpEndpoint ?? env.MIDSCENE_CDP_ENDPOINT;
+        if (!cdpEndpoint) throw new cli_namespaceObject.CLIError('CDP endpoint is required. Provide it as: --cdp <ws-endpoint> or set MIDSCENE_CDP_ENDPOINT environment variable.');
+    }
+    const hasViewportOverride = void 0 !== viewportWidth || void 0 !== viewportHeight;
+    return {
+        argv,
+        mode,
+        cdpEndpoint,
+        viewport: hasViewportOverride ? (0, viewport_js_namespaceObject.resolveViewportSize)({
+            width: viewportWidth,
+            height: viewportHeight
+        }, viewport_js_namespaceObject.defaultPuppeteerWindowViewportSize) : void 0
+    };
+}
+exports.parseWebCliOptions = __webpack_exports__.parseWebCliOptions;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "parseWebCliOptions"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=cli-options.js.map

package/dist/lib/cli-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-options.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/cli-options.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { CLIError } from '@midscene/shared/cli';\nimport {\n  type ViewportSize,\n  defaultPuppeteerWindowViewportSize,\n  resolveViewportSize,\n} from './common/viewport';\n\nconst viewportWidthFlag = '--viewport-width';\nconst viewportHeightFlag = '--viewport-height';\n\nexport interface ParsedWebCliOptions {\n  argv: string[];\n  mode: 'bridge' | 'cdp' | 'puppeteer';\n  cdpEndpoint?: string;\n  viewport?: ViewportSize;\n}\n\nfunction isLikelyCdpEndpoint(value: string | undefined): boolean {\n  return !!value && /^(wss?):\\/\\//.test(value);\n}\n\nfunction parsePositiveIntegerOption(flag: string, rawValue: string): number {\n  const value = Number(rawValue);\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new CLIError(\n      `Invalid value for \"${flag}\": expected a positive integer, got \"${rawValue}\".`,\n    );\n  }\n\n  return value;\n}\n\nfunction readRequiredOptionValue(\n  args: string[],\n  index: number,\n  flag: string,\n): { value: string; nextIndex: number } {\n  const currentArg = args[index];\n  const inlinePrefix = `${flag}=`;\n  if (currentArg.startsWith(inlinePrefix)) {\n    return {\n      value: currentArg.slice(inlinePrefix.length),\n      nextIndex: index,\n    };\n  }\n\n  const nextArg = args[index + 1];\n  if (!nextArg || nextArg.startsWith('--')) {\n    throw new CLIError(`Option \"${flag}\" requires a value.`);\n  }\n\n  return {\n    value: nextArg,\n    nextIndex: index + 1,\n  };\n}\n\nfunction readOptionalCdpEndpoint(\n  args: string[],\n  index: number,\n): { value?: string; nextIndex: number } {\n  const currentArg = args[index];\n  const inlinePrefix = '--cdp=';\n  if (currentArg.startsWith(inlinePrefix)) {\n    return {\n      value: currentArg.slice(inlinePrefix.length),\n      nextIndex: index,\n    };\n  }\n\n  const nextArg = args[index + 1];\n  if (!isLikelyCdpEndpoint(nextArg)) {\n    return { nextIndex: index };\n  }\n\n  return {\n    value: nextArg,\n    nextIndex: index + 1,\n  };\n}\n\nexport function parseWebCliOptions(\n  rawArgs: string[],\n  env: NodeJS.ProcessEnv = process.env,\n): ParsedWebCliOptions {\n  const argv: string[] = [];\n  let isBridge = false;\n  let isCdp = false;\n  let viewportWidth: number | undefined;\n  let viewportHeight: number | undefined;\n  let cdpEndpoint: string | undefined;\n\n  for (let index = 0; index < rawArgs.length; index += 1) {\n    const arg = rawArgs[index];\n\n    if (arg === '--bridge') {\n      isBridge = true;\n      continue;\n    }\n\n    if (arg === '--cdp' || arg.startsWith('--cdp=')) {\n      isCdp = true;\n      const parsed = readOptionalCdpEndpoint(rawArgs, index);\n      cdpEndpoint = parsed.value ?? cdpEndpoint;\n      index = parsed.nextIndex;\n      continue;\n    }\n\n    if (arg === viewportWidthFlag || arg.startsWith(`${viewportWidthFlag}=`)) {\n      const parsed = readRequiredOptionValue(rawArgs, index, viewportWidthFlag);\n      viewportWidth = parsePositiveIntegerOption(\n        viewportWidthFlag,\n        parsed.value,\n      );\n      index = parsed.nextIndex;\n      continue;\n    }\n\n    if (\n      arg === viewportHeightFlag ||\n      arg.startsWith(`${viewportHeightFlag}=`)\n    ) {\n      const parsed = readRequiredOptionValue(\n        rawArgs,\n        index,\n        viewportHeightFlag,\n      );\n      viewportHeight = parsePositiveIntegerOption(\n        viewportHeightFlag,\n        parsed.value,\n      );\n      index = parsed.nextIndex;\n      continue;\n    }\n\n    argv.push(arg);\n  }\n\n  if (isBridge && isCdp) {\n    throw new CLIError(\n      '--bridge and --cdp are mutually exclusive. Please specify only one.',\n    );\n  }\n\n  const mode = isBridge ? 'bridge' : isCdp ? 'cdp' : 'puppeteer';\n\n  if (mode !== 'puppeteer') {\n    if (viewportWidth !== undefined || viewportHeight !== undefined) {\n      throw new CLIError(\n        'Viewport options are only supported in the default Puppeteer mode.',\n      );\n    }\n  }\n\n  if (mode === 'cdp') {\n    cdpEndpoint = cdpEndpoint ?? env.MIDSCENE_CDP_ENDPOINT;\n    if (!cdpEndpoint) {\n      throw new CLIError(\n        'CDP endpoint is required. Provide it as: --cdp <ws-endpoint> or set MIDSCENE_CDP_ENDPOINT environment variable.',\n      );\n    }\n  }\n\n  const hasViewportOverride =\n    viewportWidth !== undefined || viewportHeight !== undefined;\n\n  return {\n    argv,\n    mode,\n    cdpEndpoint,\n    viewport: hasViewportOverride\n      ? resolveViewportSize(\n          {\n            width: viewportWidth,\n            height: viewportHeight,\n          },\n          defaultPuppeteerWindowViewportSize,\n        )\n      : undefined,\n  };\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","viewportWidthFlag","viewportHeightFlag","isLikelyCdpEndpoint","value","parsePositiveIntegerOption","flag","rawValue","Number","CLIError","readRequiredOptionValue","args","index","currentArg","inlinePrefix","nextArg","readOptionalCdpEndpoint","parseWebCliOptions","rawArgs","env","process","argv","isBridge","isCdp","viewportWidth","viewportHeight","cdpEndpoint","arg","parsed","mode","undefined","hasViewportOverride","resolveViewportSize","defaultPuppeteerWindowViewportSize"],"mappings":"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"}

package/dist/lib/cli.js

@@ -27,6 +27,7 @@ const core_namespaceObject = require("@midscene/core");
 const cli_namespaceObject = require("@midscene/shared/cli");
 const external_dotenv_namespaceObject = require("dotenv");
 var external_dotenv_default = /*#__PURE__*/ __webpack_require__.n(external_dotenv_namespaceObject);
+const external_cli_options_js_namespaceObject = require("./cli-options.js");
 const external_mcp_tools_js_namespaceObject = require("./mcp-tools.js");
 const external_mcp_tools_cdp_js_namespaceObject = require("./mcp-tools-cdp.js");
 const external_mcp_tools_puppeteer_js_namespaceObject = require("./mcp-tools-puppeteer.js");
@@ -34,38 +35,16 @@ const envFile = (0, external_node_path_namespaceObject.join)(process.cwd(), '.en
 if ((0, external_node_fs_namespaceObject.existsSync)(envFile)) external_dotenv_default().config({
     path: envFile
 });
-const isBridge = process.argv.includes('--bridge');
-const cdpIdx = process.argv.indexOf('--cdp');
-const isCdp = -1 !== cdpIdx;
-if (isBridge && isCdp) {
-    console.error('--bridge and --cdp are mutually exclusive. Please specify only one.');
-    process.exit(1);
-}
-let cdpEndpoint;
-if (isCdp) {
-    const next = process.argv[cdpIdx + 1];
-    if (next && !next.startsWith('-')) cdpEndpoint = next;
-    if (!cdpEndpoint) cdpEndpoint = process.env.MIDSCENE_CDP_ENDPOINT;
-    if (!cdpEndpoint) {
-        console.error('CDP endpoint is required. Provide it as: --cdp <ws-endpoint> or set MIDSCENE_CDP_ENDPOINT environment variable.');
-        process.exit(1);
-    }
-}
-const bridgeIdx = process.argv.indexOf('--bridge');
-const cdpValueIdx = -1 !== cdpIdx && cdpIdx + 1 < process.argv.length && !process.argv[cdpIdx + 1].startsWith('-') ? cdpIdx + 1 : -1;
-const skipIndices = new Set([
-    bridgeIdx,
-    cdpIdx,
-    cdpValueIdx
-].filter((i)=>-1 !== i));
-const argv = process.argv.slice(2).filter((_, idx)=>!skipIndices.has(idx + 2));
-let tools;
-tools = isBridge ? new external_mcp_tools_js_namespaceObject.WebMidsceneTools() : isCdp ? new external_mcp_tools_cdp_js_namespaceObject.WebCdpMidsceneTools(cdpEndpoint) : new external_mcp_tools_puppeteer_js_namespaceObject.WebPuppeteerMidsceneTools();
-(0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-web', {
-    stripPrefix: 'web_',
-    argv,
-    version: "1.7.7",
-    extraCommands: (0, core_namespaceObject.createReportCliCommands)()
+Promise.resolve().then(()=>{
+    const parsedOptions = (0, external_cli_options_js_namespaceObject.parseWebCliOptions)(process.argv.slice(2));
+    let tools;
+    tools = 'bridge' === parsedOptions.mode ? new external_mcp_tools_js_namespaceObject.WebMidsceneTools() : 'cdp' === parsedOptions.mode ? new external_mcp_tools_cdp_js_namespaceObject.WebCdpMidsceneTools(parsedOptions.cdpEndpoint) : new external_mcp_tools_puppeteer_js_namespaceObject.WebPuppeteerMidsceneTools(parsedOptions.viewport);
+    return (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-web', {
+        stripPrefix: 'web_',
+        argv: parsedOptions.argv,
+        version: "1.7.9",
+        extraCommands: (0, core_namespaceObject.createReportCliCommands)()
+    });
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));
 });

package/dist/lib/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","../../src/cli.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createReportCliCommands } from '@midscene/core';\nimport { reportCLIError, runToolsCLI } from '@midscene/shared/cli';\nimport dotenv from 'dotenv';\nimport { WebMidsceneTools } from './mcp-tools';\nimport { WebCdpMidsceneTools } from './mcp-tools-cdp';\nimport { WebPuppeteerMidsceneTools } from './mcp-tools-puppeteer';\n\n// Load .env early so MIDSCENE_CDP_ENDPOINT is available during arg parsing\nconst envFile = join(process.cwd(), '.env');\nif (existsSync(envFile)) {\n  dotenv.config({ path: envFile });\n}\n\ndeclare const __VERSION__: string;\nconst isBridge = process.argv.includes('--bridge');\nconst cdpIdx = process.argv.indexOf('--cdp');\nconst isCdp = cdpIdx !== -1;\n\n// Fail-fast: mutually exclusive flags\nif (isBridge && isCdp) {\n  console.error(\n    '--bridge and --cdp are mutually exclusive. Please specify only one.',\n  );\n  process.exit(1);\n}\n\n// Parse --cdp endpoint value\nlet cdpEndpoint: string | undefined;\nif (isCdp) {\n  const next = process.argv[cdpIdx + 1];\n  if (next && !next.startsWith('-')) {\n    cdpEndpoint = next;\n  }\n  if (!cdpEndpoint) {\n    cdpEndpoint = process.env.MIDSCENE_CDP_ENDPOINT;\n  }\n  if (!cdpEndpoint) {\n    console.error(\n      'CDP endpoint is required. Provide it as: --cdp <ws-endpoint> or set MIDSCENE_CDP_ENDPOINT environment variable.',\n    );\n    process.exit(1);\n  }\n}\n\n// Filter out --bridge, --cdp, and cdp endpoint from argv using absolute indices\nconst bridgeIdx = process.argv.indexOf('--bridge');\nconst cdpValueIdx =\n  cdpIdx !== -1 &&\n  cdpIdx + 1 < process.argv.length &&\n  !process.argv[cdpIdx + 1].startsWith('-')\n    ? cdpIdx + 1\n    : -1;\nconst skipIndices = new Set(\n  [bridgeIdx, cdpIdx, cdpValueIdx].filter((i) => i !== -1),\n);\nconst argv = process.argv\n  .slice(2)\n  .filter((_, idx) => !skipIndices.has(idx + 2));\n\nlet tools: WebMidsceneTools | WebPuppeteerMidsceneTools | WebCdpMidsceneTools;\nif (isBridge) {\n  tools = new WebMidsceneTools();\n} else if (isCdp) {\n  tools = new WebCdpMidsceneTools(cdpEndpoint!);\n} else {\n  tools = new WebPuppeteerMidsceneTools();\n}\n\nrunToolsCLI(tools, 'midscene-web', {\n  stripPrefix: 'web_',\n  argv,\n  version: __VERSION__,\n  extraCommands: createReportCliCommands(),\n}).catch((e) => {\n  process.exit(reportCLIError(e));\n});\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","envFile","join","process","existsSync","dotenv","isBridge","cdpIdx","isCdp","console","cdpEndpoint","next","bridgeIdx","cdpValueIdx","skipIndices","Set","i","argv","_","idx","tools","WebMidsceneTools","WebCdpMidsceneTools","WebPuppeteerMidsceneTools","runToolsCLI","__VERSION__","createReportCliCommands","e","reportCLIError"],"mappings":";;;IACAA,oBAAoB,CAAC,GAAG,CAACC;QACxB,IAAIC,SAASD,UAAUA,OAAO,UAAU,GACvC,IAAOA,MAAM,CAAC,UAAU,GACxB,IAAOA;QACRD,oBAAoB,CAAC,CAACE,QAAQ;YAAE,GAAGA;QAAO;QAC1C,OAAOA;IACR;;;ICPAF,oBAAoB,CAAC,GAAG,CAAC,UAASG;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGH,oBAAoB,CAAC,CAACG,YAAYC,QAAQ,CAACJ,oBAAoB,CAAC,CAAC,UAASI,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAJ,oBAAoB,CAAC,GAAG,CAACM,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;;;;;;;;;;ACUlF,MAAMC,UAAUC,AAAAA,IAAAA,mCAAAA,IAAAA,AAAAA,EAAKC,QAAQ,GAAG,IAAI;AACpC,IAAIC,AAAAA,IAAAA,iCAAAA,UAAAA,AAAAA,EAAWH,UACbI,0BAAAA,MAAa,CAAC;IAAE,MAAMJ;AAAQ;AAIhC,MAAMK,WAAWH,QAAQ,IAAI,CAAC,QAAQ,CAAC;AACvC,MAAMI,SAASJ,QAAQ,IAAI,CAAC,OAAO,CAAC;AACpC,MAAMK,QAAQD,AAAW,OAAXA;AAGd,IAAID,YAAYE,OAAO;IACrBC,QAAQ,KAAK,CACX;IAEFN,QAAQ,IAAI,CAAC;AACf;AAGA,IAAIO;AACJ,IAAIF,OAAO;IACT,MAAMG,OAAOR,QAAQ,IAAI,CAACI,SAAS,EAAE;IACrC,IAAII,QAAQ,CAACA,KAAK,UAAU,CAAC,MAC3BD,cAAcC;IAEhB,IAAI,CAACD,aACHA,cAAcP,QAAQ,GAAG,CAAC,qBAAqB;IAEjD,IAAI,CAACO,aAAa;QAChBD,QAAQ,KAAK,CACX;QAEFN,QAAQ,IAAI,CAAC;IACf;AACF;AAGA,MAAMS,YAAYT,QAAQ,IAAI,CAAC,OAAO,CAAC;AACvC,MAAMU,cACJN,AAAW,OAAXA,UACAA,SAAS,IAAIJ,QAAQ,IAAI,CAAC,MAAM,IAChC,CAACA,QAAQ,IAAI,CAACI,SAAS,EAAE,CAAC,UAAU,CAAC,OACjCA,SAAS,IACT;AACN,MAAMO,cAAc,IAAIC,IACtB;IAACH;IAAWL;IAAQM;CAAY,CAAC,MAAM,CAAC,CAACG,IAAMA,AAAM,OAANA;AAEjD,MAAMC,OAAOd,QAAQ,IAAI,CACtB,KAAK,CAAC,GACN,MAAM,CAAC,CAACe,GAAGC,MAAQ,CAACL,YAAY,GAAG,CAACK,MAAM;AAE7C,IAAIC;AAEFA,QADEd,WACM,IAAIe,sCAAAA,gBAAgBA,KACnBb,QACD,IAAIc,0CAAAA,mBAAmBA,CAACZ,eAExB,IAAIa,gDAAAA,yBAAyBA;AAGvCC,IAAAA,oBAAAA,WAAAA,AAAAA,EAAYJ,OAAO,gBAAgB;IACjC,aAAa;IACbH;IACA,SAASQ;IACT,eAAeC,AAAAA,IAAAA,qBAAAA,uBAAAA,AAAAA;AACjB,GAAG,KAAK,CAAC,CAACC;IACRxB,QAAQ,IAAI,CAACyB,AAAAA,IAAAA,oBAAAA,cAAAA,AAAAA,EAAeD;AAC9B"}
+{"version":3,"file":"cli.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","../../src/cli.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createReportCliCommands } from '@midscene/core';\nimport { reportCLIError, runToolsCLI } from '@midscene/shared/cli';\nimport dotenv from 'dotenv';\nimport { parseWebCliOptions } from './cli-options';\nimport { WebMidsceneTools } from './mcp-tools';\nimport { WebCdpMidsceneTools } from './mcp-tools-cdp';\nimport { WebPuppeteerMidsceneTools } from './mcp-tools-puppeteer';\n\n// Load .env early so MIDSCENE_CDP_ENDPOINT is available during arg parsing\nconst envFile = join(process.cwd(), '.env');\nif (existsSync(envFile)) {\n  dotenv.config({ path: envFile });\n}\n\ndeclare const __VERSION__: string;\n\nPromise.resolve()\n  .then(() => {\n    const parsedOptions = parseWebCliOptions(process.argv.slice(2));\n\n    let tools:\n      | WebMidsceneTools\n      | WebPuppeteerMidsceneTools\n      | WebCdpMidsceneTools;\n    if (parsedOptions.mode === 'bridge') {\n      tools = new WebMidsceneTools();\n    } else if (parsedOptions.mode === 'cdp') {\n      tools = new WebCdpMidsceneTools(parsedOptions.cdpEndpoint!);\n    } else {\n      tools = new WebPuppeteerMidsceneTools(parsedOptions.viewport);\n    }\n\n    return runToolsCLI(tools, 'midscene-web', {\n      stripPrefix: 'web_',\n      argv: parsedOptions.argv,\n      version: __VERSION__,\n      extraCommands: createReportCliCommands(),\n    });\n  })\n  .catch((e) => {\n    process.exit(reportCLIError(e));\n  });\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","envFile","join","process","existsSync","dotenv","Promise","parsedOptions","parseWebCliOptions","tools","WebMidsceneTools","WebCdpMidsceneTools","WebPuppeteerMidsceneTools","runToolsCLI","__VERSION__","createReportCliCommands","e","reportCLIError"],"mappings":";;;IACAA,oBAAoB,CAAC,GAAG,CAACC;QACxB,IAAIC,SAASD,UAAUA,OAAO,UAAU,GACvC,IAAOA,MAAM,CAAC,UAAU,GACxB,IAAOA;QACRD,oBAAoB,CAAC,CAACE,QAAQ;YAAE,GAAGA;QAAO;QAC1C,OAAOA;IACR;;;ICPAF,oBAAoB,CAAC,GAAG,CAAC,UAASG;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGH,oBAAoB,CAAC,CAACG,YAAYC,QAAQ,CAACJ,oBAAoB,CAAC,CAAC,UAASI,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAJ,oBAAoB,CAAC,GAAG,CAACM,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;;;;;;;;;;;ACWlF,MAAMC,UAAUC,AAAAA,IAAAA,mCAAAA,IAAAA,AAAAA,EAAKC,QAAQ,GAAG,IAAI;AACpC,IAAIC,AAAAA,IAAAA,iCAAAA,UAAAA,AAAAA,EAAWH,UACbI,0BAAAA,MAAa,CAAC;IAAE,MAAMJ;AAAQ;AAKhCK,QAAQ,OAAO,GACZ,IAAI,CAAC;IACJ,MAAMC,gBAAgBC,AAAAA,IAAAA,wCAAAA,kBAAAA,AAAAA,EAAmBL,QAAQ,IAAI,CAAC,KAAK,CAAC;IAE5D,IAAIM;IAKFA,QADEF,AAAuB,aAAvBA,cAAc,IAAI,GACZ,IAAIG,sCAAAA,gBAAgBA,KACnBH,AAAuB,UAAvBA,cAAc,IAAI,GACnB,IAAII,0CAAAA,mBAAmBA,CAACJ,cAAc,WAAW,IAEjD,IAAIK,gDAAAA,yBAAyBA,CAACL,cAAc,QAAQ;IAG9D,OAAOM,AAAAA,IAAAA,oBAAAA,WAAAA,AAAAA,EAAYJ,OAAO,gBAAgB;QACxC,aAAa;QACb,MAAMF,cAAc,IAAI;QACxB,SAASO;QACT,eAAeC,AAAAA,IAAAA,qBAAAA,uBAAAA,AAAAA;IACjB;AACF,GACC,KAAK,CAAC,CAACC;IACNb,QAAQ,IAAI,CAACc,AAAAA,IAAAA,oBAAAA,cAAAA,AAAAA,EAAeD;AAC9B"}

package/dist/lib/common/viewport.js

@@ -0,0 +1,90 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    defaultViewportSize: ()=>defaultViewportSize,
+    defaultStaticPageViewportSize: ()=>defaultStaticPageViewportSize,
+    defaultViewportWidth: ()=>defaultViewportWidth,
+    resolveViewportSize: ()=>resolveViewportSize,
+    resolveWebViewportSize: ()=>resolveWebViewportSize,
+    defaultPuppeteerWindowViewportSize: ()=>defaultPuppeteerWindowViewportSize,
+    defaultViewportHeight: ()=>defaultViewportHeight
+});
+const utils_namespaceObject = require("@midscene/shared/utils");
+const defaultViewportWidth = 1440;
+const defaultViewportHeight = 800;
+const defaultViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+const defaultPuppeteerWindowViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+const defaultStaticPageViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+function parseViewportDimension(rawValue, name) {
+    const parsedValue = 'number' == typeof rawValue ? rawValue : Number(rawValue);
+    (0, utils_namespaceObject.assert)(Number.isInteger(parsedValue), `${name} must be a positive integer, but got ${rawValue}`);
+    (0, utils_namespaceObject.assert)(parsedValue > 0, `${name} must be greater than 0, but got ${rawValue}`);
+    return parsedValue;
+}
+function resolveViewportSize(viewport, fallback = defaultViewportSize) {
+    const width = viewport?.width === void 0 || null === viewport.width ? fallback.width : parseViewportDimension(viewport.width, 'viewportWidth');
+    const height = viewport?.height === void 0 || null === viewport.height ? fallback.height : parseViewportDimension(viewport.height, 'viewportHeight');
+    return {
+        width,
+        height
+    };
+}
+function resolveWebViewportSize(viewport, fallback = defaultViewportSize) {
+    return resolveViewportSize({
+        width: viewport?.viewportWidth,
+        height: viewport?.viewportHeight
+    }, fallback);
+}
+exports.defaultPuppeteerWindowViewportSize = __webpack_exports__.defaultPuppeteerWindowViewportSize;
+exports.defaultStaticPageViewportSize = __webpack_exports__.defaultStaticPageViewportSize;
+exports.defaultViewportHeight = __webpack_exports__.defaultViewportHeight;
+exports.defaultViewportSize = __webpack_exports__.defaultViewportSize;
+exports.defaultViewportWidth = __webpack_exports__.defaultViewportWidth;
+exports.resolveViewportSize = __webpack_exports__.resolveViewportSize;
+exports.resolveWebViewportSize = __webpack_exports__.resolveWebViewportSize;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "defaultPuppeteerWindowViewportSize",
+    "defaultStaticPageViewportSize",
+    "defaultViewportHeight",
+    "defaultViewportSize",
+    "defaultViewportWidth",
+    "resolveViewportSize",
+    "resolveWebViewportSize"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=viewport.js.map

package/dist/lib/common/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common/viewport.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/common/viewport.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { assert } from '@midscene/shared/utils';\n\nexport interface ViewportSize {\n  width: number;\n  height: number;\n}\n\nexport const defaultViewportWidth = 1440;\nexport const defaultViewportHeight = 800;\nexport const defaultViewportSize: ViewportSize = {\n  width: defaultViewportWidth,\n  height: defaultViewportHeight,\n};\nexport const defaultPuppeteerWindowViewportSize: ViewportSize = {\n  width: defaultViewportWidth,\n  height: defaultViewportHeight,\n};\nexport const defaultStaticPageViewportSize: ViewportSize = {\n  width: defaultViewportWidth,\n  height: defaultViewportHeight,\n};\n\nfunction parseViewportDimension(\n  rawValue: number | string,\n  name: 'viewportWidth' | 'viewportHeight',\n): number {\n  const parsedValue =\n    typeof rawValue === 'number' ? rawValue : Number(rawValue);\n\n  assert(\n    Number.isInteger(parsedValue),\n    `${name} must be a positive integer, but got ${rawValue}`,\n  );\n  assert(\n    parsedValue > 0,\n    `${name} must be greater than 0, but got ${rawValue}`,\n  );\n\n  return parsedValue;\n}\n\nexport function resolveViewportSize(\n  viewport?: {\n    width?: number | string | null;\n    height?: number | string | null;\n  },\n  fallback: ViewportSize = defaultViewportSize,\n): ViewportSize {\n  const width =\n    viewport?.width === undefined || viewport.width === null\n      ? fallback.width\n      : parseViewportDimension(viewport.width, 'viewportWidth');\n  const height =\n    viewport?.height === undefined || viewport.height === null\n      ? fallback.height\n      : parseViewportDimension(viewport.height, 'viewportHeight');\n\n  return { width, height };\n}\n\nexport function resolveWebViewportSize(\n  viewport?: {\n    viewportWidth?: number | string | null;\n    viewportHeight?: number | string | null;\n  },\n  fallback: ViewportSize = defaultViewportSize,\n): ViewportSize {\n  return resolveViewportSize(\n    {\n      width: viewport?.viewportWidth,\n      height: viewport?.viewportHeight,\n    },\n    fallback,\n  );\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","defaultViewportWidth","defaultViewportHeight","defaultViewportSize","defaultPuppeteerWindowViewportSize","defaultStaticPageViewportSize","parseViewportDimension","rawValue","name","parsedValue","Number","assert","resolveViewportSize","viewport","fallback","width","undefined","height","resolveWebViewportSize"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;;;;ACCO,MAAMI,uBAAuB;AAC7B,MAAMC,wBAAwB;AAC9B,MAAMC,sBAAoC;IAC/C,OAAOF;IACP,QAAQC;AACV;AACO,MAAME,qCAAmD;IAC9D,OAAOH;IACP,QAAQC;AACV;AACO,MAAMG,gCAA8C;IACzD,OAAOJ;IACP,QAAQC;AACV;AAEA,SAASI,uBACPC,QAAyB,EACzBC,IAAwC;IAExC,MAAMC,cACJ,AAAoB,YAApB,OAAOF,WAAwBA,WAAWG,OAAOH;IAEnDI,IAAAA,sBAAAA,MAAAA,AAAAA,EACED,OAAO,SAAS,CAACD,cACjB,GAAGD,KAAK,qCAAqC,EAAED,UAAU;IAE3DI,IAAAA,sBAAAA,MAAAA,AAAAA,EACEF,cAAc,GACd,GAAGD,KAAK,iCAAiC,EAAED,UAAU;IAGvD,OAAOE;AACT;AAEO,SAASG,oBACdC,QAGC,EACDC,WAAyBX,mBAAmB;IAE5C,MAAMY,QACJF,UAAU,UAAUG,UAAaH,AAAmB,SAAnBA,SAAS,KAAK,GAC3CC,SAAS,KAAK,GACdR,uBAAuBO,SAAS,KAAK,EAAE;IAC7C,MAAMI,SACJJ,UAAU,WAAWG,UAAaH,AAAoB,SAApBA,SAAS,MAAM,GAC7CC,SAAS,MAAM,GACfR,uBAAuBO,SAAS,MAAM,EAAE;IAE9C,OAAO;QAAEE;QAAOE;IAAO;AACzB;AAEO,SAASC,uBACdL,QAGC,EACDC,WAAyBX,mBAAmB;IAE5C,OAAOS,oBACL;QACE,OAAOC,UAAU;QACjB,QAAQA,UAAU;IACpB,GACAC;AAEJ"}

package/dist/lib/mcp-server.js

@@ -37,7 +37,7 @@ class WebMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/web-bridge-mcp',
-            version: "1.7.7",
+            version: "1.7.9",
             description: 'Control the browser using natural language commands'
         }, toolsManager);
     }

package/dist/lib/mcp-tools-cdp.js

@@ -42,6 +42,7 @@ const external_puppeteer_core_namespaceObject = require("puppeteer-core");
 var external_puppeteer_core_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_core_namespaceObject);
 const external_cdp_proxy_manager_js_namespaceObject = require("./cdp-proxy-manager.js");
 const external_cdp_target_store_js_namespaceObject = require("./cdp-target-store.js");
+const viewport_js_namespaceObject = require("./common/viewport.js");
 const index_js_namespaceObject = require("./puppeteer/index.js");
 const external_static_index_js_namespaceObject = require("./static/index.js");
 function _define_property(obj, key, value) {
@@ -66,10 +67,7 @@ class WebCdpMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new external_static_index_js_namespaceObject.StaticPage({
             screenshot: core_namespaceObject.ScreenshotItem.create('', Date.now()),
-            shotSize: {
-                width: 1920,
-                height: 1080
-            },
+            shotSize: viewport_js_namespaceObject.defaultStaticPageViewportSize,
             shrunkShotToLogicalRatio: 1
         });
     }