@midscene/web 1.15.3 → 1.15.4-beta-20261013083552.0

package/dist/es/common/test-runner/cookies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common/test-runner/cookies.mjs","sources":["../../../../src/common/test-runner/cookies.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { z } from 'zod/v4';\nimport { resolveWebUrl } from './utils';\n\ntype Awaitable<T> = T | Promise<T>;\n\nexport type CookieSourceReference =\n  | { kind: 'env'; name: string }\n  | { kind: 'profile'; name: string }\n  | { kind: 'storage-state'; name: string };\n\nexport interface WebNodeContext<TContext> {\n  input: unknown;\n  context: TContext;\n  signal: AbortSignal;\n}\n\nexport interface CookieProfileContext<TContext> {\n  profile: string;\n  context: TContext;\n  signal: AbortSignal;\n}\n\nexport interface WebCookieSourceOptions<TAgent> {\n  getEnv?(\n    ctx: WebNodeContext<TAgent>,\n  ): Awaitable<Readonly<Record<string, string | undefined>>>;\n  getCookieProfile?(input: CookieProfileContext<TAgent>): Awaitable<unknown>;\n  resolveStorageStatePath?(\n    path: string,\n    ctx: WebNodeContext<TAgent>,\n  ): Awaitable<string>;\n}\n\nexport interface PortableWebCookie extends Record<string, unknown> {\n  name: string;\n  value: string;\n  url?: string;\n  domain?: string;\n  path?: string;\n}\n\nexport const setCookiesInputSchema = z\n  .strictObject({\n    cookiesEnv: z\n      .string()\n      .regex(/^[A-Za-z_][A-Za-z0-9_]*$/)\n      .optional()\n      .describe(\n        'The environment variable containing a Cookie header, cookie array JSON, or browser storage-state JSON.',\n      ),\n    profile: z\n      .string()\n      .regex(/\\S/)\n      .optional()\n      .describe('A cookie profile resolved by getCookieProfile().'),\n    storageStatePath: z\n      .string()\n      .regex(/\\S/)\n      .optional()\n      .describe('A path to a browser storage-state JSON file.'),\n    url: z\n      .string()\n      .url()\n      .optional()\n      .describe(\n        'The HTTP(S) URL used to scope Cookie-header values or cookies without domain/path.',\n      ),\n  })\n  .superRefine((input, ctx) => {\n    const sourceCount = [\n      input.cookiesEnv,\n      input.profile,\n      input.storageStatePath,\n    ].filter((value) => value !== undefined).length;\n    if (sourceCount !== 1) {\n      ctx.addIssue({\n        code: 'custom',\n        message:\n          'exactly one of cookiesEnv, profile, and storageStatePath is required',\n      });\n    }\n  });\n\nexport type SetCookiesNodeInput = z.infer<typeof setCookiesInputSchema>;\n\nexport interface SetCookiesNodeResult {\n  source: CookieSourceReference['kind'];\n  sourceName: string;\n  count: number;\n}\n\nconst toCookieSourceReference = (\n  input: SetCookiesNodeInput,\n): CookieSourceReference => {\n  if (input.cookiesEnv !== undefined) {\n    return { kind: 'env', name: input.cookiesEnv };\n  }\n  if (input.profile !== undefined) {\n    return { kind: 'profile', name: input.profile };\n  }\n  if (input.storageStatePath !== undefined) {\n    return { kind: 'storage-state', name: input.storageStatePath };\n  }\n  throw new TypeError('setCookies requires one cookie source.');\n};\n\nconst parseCookieHeader = (raw: string, url: string | undefined) => {\n  if (url === undefined) {\n    throw new TypeError(\n      'setCookies.url is required when cookiesEnv contains a Cookie header.',\n    );\n  }\n  const segments = raw\n    .split(';')\n    .map((segment) => segment.trim())\n    .filter(Boolean);\n  if (segments.length === 0) {\n    throw new TypeError('setCookies Cookie header contains no cookies.');\n  }\n  return segments.map((segment) => {\n    const separator = segment.indexOf('=');\n    if (separator <= 0) {\n      throw new TypeError(\n        'setCookies Cookie header contains an invalid name/value pair.',\n      );\n    }\n    const name = segment.slice(0, separator).trim();\n    const value = segment.slice(separator + 1).trim();\n    if (!name) {\n      throw new TypeError('setCookies Cookie header contains an empty name.');\n    }\n    return { name, value, url } satisfies PortableWebCookie;\n  });\n};\n\nconst parseCookieJson = (raw: string): unknown => {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    throw new TypeError(\n      'setCookies source must contain valid JSON or a Cookie header.',\n    );\n  }\n};\n\nconst normalizeCookie = (\n  candidate: unknown,\n  defaultUrl: string | undefined,\n  index: number,\n): PortableWebCookie => {\n  if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {\n    throw new TypeError(\n      `setCookies cookie at index ${index} must be an object.`,\n    );\n  }\n  const cookie = candidate as Record<string, unknown>;\n  if (typeof cookie.name !== 'string' || !cookie.name.trim()) {\n    throw new TypeError(\n      `setCookies cookie at index ${index} requires a non-blank name.`,\n    );\n  }\n  if (typeof cookie.value !== 'string') {\n    throw new TypeError(\n      `setCookies cookie at index ${index} requires a string value.`,\n    );\n  }\n\n  const normalized = { ...cookie } as PortableWebCookie;\n  const hasUrl = typeof cookie.url === 'string' && cookie.url.length > 0;\n  const hasDomain =\n    typeof cookie.domain === 'string' && cookie.domain.length > 0;\n  if (!hasUrl && !hasDomain) {\n    if (defaultUrl === undefined) {\n      throw new TypeError(\n        `setCookies cookie at index ${index} requires url or domain, or setCookies.url must be provided.`,\n      );\n    }\n    normalized.url = defaultUrl;\n  }\n  if (hasDomain && typeof cookie.path !== 'string') normalized.path = '/';\n  return normalized;\n};\n\nconst normalizeCookies = (\n  source: unknown,\n  defaultUrl: string | undefined,\n): PortableWebCookie[] => {\n  const candidates = Array.isArray(source)\n    ? source\n    : source &&\n        typeof source === 'object' &&\n        Array.isArray((source as { cookies?: unknown }).cookies)\n      ? (source as { cookies: unknown[] }).cookies\n      : undefined;\n  if (!candidates) {\n    throw new TypeError(\n      'setCookies JSON must be a cookie array or an object with a cookies array.',\n    );\n  }\n  if (candidates.length === 0) {\n    throw new TypeError('setCookies source contains no cookies.');\n  }\n  return candidates.map((cookie, index) =>\n    normalizeCookie(cookie, defaultUrl, index),\n  );\n};\n\nexport const resolveCookieInput = async <TAgent>(\n  input: SetCookiesNodeInput,\n  ctx: WebNodeContext<TAgent>,\n  options: WebCookieSourceOptions<TAgent>,\n): Promise<{\n  cookies: PortableWebCookie[];\n  result: SetCookiesNodeResult;\n}> => {\n  const defaultUrl =\n    input.url === undefined\n      ? undefined\n      : resolveWebUrl(input.url, undefined, 'setCookies.url');\n  const reference = toCookieSourceReference(input);\n  let source: unknown;\n  switch (reference.kind) {\n    case 'env': {\n      let env: Readonly<Record<string, string | undefined>>;\n      try {\n        env = (await options.getEnv?.(ctx)) ?? process.env;\n      } catch {\n        throw new Error(\n          `Failed to resolve cookie environment ${reference.name}; the original error was redacted because it may contain cookie values.`,\n        );\n      }\n      const raw = env[reference.name];\n      if (!raw?.trim()) {\n        throw new Error(\n          `Environment variable ${reference.name} is missing or blank.`,\n        );\n      }\n      const trimmed = raw.trim();\n      source = /^[\\[{]/.test(trimmed)\n        ? parseCookieJson(trimmed)\n        : parseCookieHeader(trimmed, defaultUrl);\n      break;\n    }\n    case 'profile': {\n      if (!options.getCookieProfile) {\n        throw new Error(\n          'setCookies.profile requires a configured getCookieProfile callback.',\n        );\n      }\n      try {\n        source = await options.getCookieProfile({\n          profile: reference.name,\n          context: ctx.context,\n          signal: ctx.signal,\n        });\n      } catch {\n        throw new Error(\n          `Failed to resolve cookie profile ${reference.name}; the original error was redacted because it may contain cookie values.`,\n        );\n      }\n      break;\n    }\n    case 'storage-state': {\n      let contents: string;\n      try {\n        const path = options.resolveStorageStatePath\n          ? await options.resolveStorageStatePath(reference.name, ctx)\n          : resolve(process.cwd(), reference.name);\n        contents = await readFile(path, 'utf8');\n      } catch {\n        throw new Error(\n          `Failed to read cookie storage state ${reference.name}; the original error was redacted because it may contain cookie values.`,\n        );\n      }\n      source = parseCookieJson(contents);\n      break;\n    }\n  }\n  const cookies = normalizeCookies(source, defaultUrl);\n  return {\n    cookies,\n    result: {\n      source: reference.kind,\n      sourceName: reference.name,\n      count: cookies.length,\n    },\n  };\n};\n"],"names":["setCookiesInputSchema","z","input","ctx","sourceCount","value","undefined","toCookieSourceReference","TypeError","parseCookieHeader","raw","url","segments","segment","Boolean","separator","name","parseCookieJson","JSON","normalizeCookie","candidate","defaultUrl","index","Array","cookie","normalized","hasUrl","hasDomain","normalizeCookies","source","candidates","resolveCookieInput","options","resolveWebUrl","reference","env","process","Error","trimmed","contents","path","resolve","readFile","cookies"],"mappings":"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"}

package/dist/es/common/test-runner/nodes.mjs

@@ -0,0 +1,139 @@
+import { z } from "zod/v4";
+import { resolveCookieInput, setCookiesInputSchema } from "./cookies.mjs";
+import { resolveWebUrl, throwIfAborted } from "./utils.mjs";
+const DEFAULT_NAVIGATION_TIMEOUT_MS = 60000;
+const DEFAULT_WAIT_UNTIL = 'domcontentloaded';
+const gotoUrlInputSchema = z.strictObject({
+    url: z.string().min(1).describe('An absolute HTTP(S) URL or a path relative to testRunner.baseURL or the current page URL.'),
+    waitUntil: z["enum"]([
+        'commit',
+        'domcontentloaded',
+        'load',
+        'networkidle',
+        'networkidle0',
+        'networkidle2'
+    ]).default(DEFAULT_WAIT_UNTIL).describe('The navigation lifecycle event. domcontentloaded, load, and networkidle are portable across browser drivers.'),
+    timeoutMs: z.number().positive().max(600000).default(DEFAULT_NAVIGATION_TIMEOUT_MS).describe('The navigation timeout in milliseconds.')
+});
+const clearCookiesInputSchema = z.strictObject({
+    name: z.string().regex(/\S/).optional().describe('Cookie name to clear.'),
+    domain: z.string().regex(/\S/).optional().describe('Cookie domain to clear.'),
+    path: z.string().regex(/\S/).optional().describe('Cookie path to clear.')
+});
+const setViewportSizeInputSchema = z.strictObject({
+    width: z.number().int().positive().describe('Viewport width in CSS pixels.'),
+    height: z.number().int().positive().describe('Viewport height in CSS pixels.')
+});
+const resolveNavigationUrl = (target, currentUrl, configuredBase)=>{
+    const trimmed = target.trim();
+    if (!trimmed) throw new TypeError('gotoUrl.url must not be blank.');
+    if (/^[a-z][a-z\d+.-]*:/i.test(trimmed)) return resolveWebUrl(trimmed, void 0, 'gotoUrl.url');
+    if (void 0 !== configuredBase) return resolveWebUrl(trimmed, configuredBase, 'gotoUrl.url');
+    if (!/^https?:\/\//i.test(currentUrl)) throw new TypeError(`gotoUrl.url cannot resolve a relative URL from ${JSON.stringify(currentUrl)}. Use an absolute HTTP(S) URL for the first navigation or configure testRunner.baseURL.`);
+    return resolveWebUrl(trimmed, currentUrl, 'gotoUrl.url');
+};
+const createWebTestRunnerNodeDefinitions = (adapter)=>{
+    const gotoUrlNode = {
+        name: 'gotoUrl',
+        title: 'Open a Web URL',
+        description: 'Navigate the current browser Page to an absolute HTTP(S) URL or a path relative to testRunner.baseURL or the current page URL.',
+        stringInputKey: 'url',
+        inputSchema: gotoUrlInputSchema,
+        async execute (agent, input, executionContext) {
+            const runtimeAgent = adapter.requireAgent(agent);
+            const driver = adapter.createDriver(runtimeAgent);
+            throwIfAborted(executionContext.signal, 'gotoUrl');
+            const url = resolveNavigationUrl(input.url, driver.currentUrl(), adapter.getOptions(runtimeAgent)?.baseURL ?? driver.baseUrl());
+            const response = await driver.goto(url, {
+                waitUntil: input.waitUntil,
+                timeoutMs: input.timeoutMs
+            });
+            throwIfAborted(executionContext.signal, 'gotoUrl');
+            const result = {
+                url: driver.currentUrl(),
+                status: response.status,
+                title: await driver.title()
+            };
+            return {
+                summary: `Navigated to ${result.url}`,
+                data: result
+            };
+        }
+    };
+    const setCookiesNode = {
+        name: 'setCookies',
+        title: 'Set browser cookies',
+        description: 'Load cookies from an environment variable, configured profile, or browser storage-state file without persisting cookie values in workflow input or output.',
+        stringInputKey: false,
+        inputSchema: setCookiesInputSchema,
+        async execute (agent, input, executionContext) {
+            const runtimeAgent = adapter.requireAgent(agent);
+            const driver = adapter.createDriver(runtimeAgent);
+            throwIfAborted(executionContext.signal, 'setCookies');
+            const { cookies, result } = await resolveCookieInput(input, {
+                ...executionContext,
+                input,
+                context: runtimeAgent
+            }, adapter.getOptions(runtimeAgent) ?? {});
+            throwIfAborted(executionContext.signal, 'setCookies');
+            try {
+                await driver.setCookies(cookies);
+            } catch  {
+                throw new Error(`Failed to set ${cookies.length} browser cookie(s); the browser error was redacted because it may contain cookie values.`);
+            }
+            return {
+                summary: `Set ${result.count} browser cookie(s) from ${result.source} ${result.sourceName}`,
+                data: result
+            };
+        }
+    };
+    const clearCookiesNode = {
+        name: 'clearCookies',
+        title: 'Clear browser cookies',
+        description: 'Clear all cookies from the current browser context, or only cookies matching name, domain, or path.',
+        stringInputKey: false,
+        inputSchema: clearCookiesInputSchema,
+        async execute (agent, input, executionContext) {
+            const runtimeAgent = adapter.requireAgent(agent);
+            const driver = adapter.createDriver(runtimeAgent);
+            throwIfAborted(executionContext.signal, 'clearCookies');
+            const filters = {
+                ...input
+            };
+            await driver.clearCookies(filters);
+            const filterNames = Object.keys(filters);
+            return {
+                summary: 0 === filterNames.length ? 'Cleared all browser cookies' : `Cleared browser cookies matching ${filterNames.join(', ')}`,
+                data: {
+                    filters
+                }
+            };
+        }
+    };
+    const setViewportSizeNode = {
+        name: 'setViewportSize',
+        title: 'Set the browser viewport size',
+        description: 'Set the current browser Page viewport size in CSS pixels and return the effective size.',
+        stringInputKey: false,
+        inputSchema: setViewportSizeInputSchema,
+        async execute (agent, input, executionContext) {
+            const runtimeAgent = adapter.requireAgent(agent);
+            const driver = adapter.createDriver(runtimeAgent);
+            throwIfAborted(executionContext.signal, 'setViewportSize');
+            const viewport = await driver.setViewportSize(input);
+            return {
+                summary: `Set viewport to ${viewport.width}x${viewport.height}`,
+                data: viewport
+            };
+        }
+    };
+    return [
+        gotoUrlNode,
+        setCookiesNode,
+        clearCookiesNode,
+        setViewportSizeNode
+    ];
+};
+export { clearCookiesInputSchema, createWebTestRunnerNodeDefinitions, gotoUrlInputSchema, setCookiesInputSchema, setViewportSizeInputSchema };
+
+//# sourceMappingURL=nodes.mjs.map

package/dist/es/common/test-runner/nodes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common/test-runner/nodes.mjs","sources":["../../../../src/common/test-runner/nodes.ts"],"sourcesContent":["import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { z } from 'zod/v4';\nimport {\n  type SetCookiesNodeResult,\n  resolveCookieInput,\n  setCookiesInputSchema,\n} from './cookies';\nimport type {\n  WebCookieFilters,\n  WebTestDriverAdapter,\n  WebTestRunnerOptions,\n  WebViewportSize,\n} from './driver';\nimport { resolveWebUrl, throwIfAborted } from './utils';\n\nconst DEFAULT_NAVIGATION_TIMEOUT_MS = 60_000;\nconst DEFAULT_WAIT_UNTIL = 'domcontentloaded' as const;\n\nexport const gotoUrlInputSchema = z.strictObject({\n  url: z\n    .string()\n    .min(1)\n    .describe(\n      'An absolute HTTP(S) URL or a path relative to testRunner.baseURL or the current page URL.',\n    ),\n  waitUntil: z\n    .enum([\n      'commit',\n      'domcontentloaded',\n      'load',\n      'networkidle',\n      'networkidle0',\n      'networkidle2',\n    ])\n    .default(DEFAULT_WAIT_UNTIL)\n    .describe(\n      'The navigation lifecycle event. domcontentloaded, load, and networkidle are portable across browser drivers.',\n    ),\n  timeoutMs: z\n    .number()\n    .positive()\n    .max(10 * 60_000)\n    .default(DEFAULT_NAVIGATION_TIMEOUT_MS)\n    .describe('The navigation timeout in milliseconds.'),\n});\n\nexport type GotoUrlNodeInput = z.infer<typeof gotoUrlInputSchema>;\n\nexport interface GotoUrlNodeResult {\n  url: string;\n  status: number | null;\n  title: string;\n}\n\nexport const clearCookiesInputSchema = z.strictObject({\n  name: z.string().regex(/\\S/).optional().describe('Cookie name to clear.'),\n  domain: z.string().regex(/\\S/).optional().describe('Cookie domain to clear.'),\n  path: z.string().regex(/\\S/).optional().describe('Cookie path to clear.'),\n});\n\nexport type ClearCookiesNodeInput = z.infer<typeof clearCookiesInputSchema>;\n\nexport const setViewportSizeInputSchema = z.strictObject({\n  width: z.number().int().positive().describe('Viewport width in CSS pixels.'),\n  height: z\n    .number()\n    .int()\n    .positive()\n    .describe('Viewport height in CSS pixels.'),\n});\n\nexport type SetViewportSizeNodeInput = z.infer<\n  typeof setViewportSizeInputSchema\n>;\n\nconst resolveNavigationUrl = (\n  target: string,\n  currentUrl: string,\n  configuredBase: string | undefined,\n): string => {\n  const trimmed = target.trim();\n  if (!trimmed) throw new TypeError('gotoUrl.url must not be blank.');\n  if (/^[a-z][a-z\\d+.-]*:/i.test(trimmed)) {\n    return resolveWebUrl(trimmed, undefined, 'gotoUrl.url');\n  }\n  if (configuredBase !== undefined) {\n    return resolveWebUrl(trimmed, configuredBase, 'gotoUrl.url');\n  }\n  if (!/^https?:\\/\\//i.test(currentUrl)) {\n    throw new TypeError(\n      `gotoUrl.url cannot resolve a relative URL from ${JSON.stringify(currentUrl)}. Use an absolute HTTP(S) URL for the first navigation or configure testRunner.baseURL.`,\n    );\n  }\n  return resolveWebUrl(trimmed, currentUrl, 'gotoUrl.url');\n};\n\n/** Create the browser-neutral built-in Web Nodes for one browser adapter. */\nexport const createWebTestRunnerNodeDefinitions = <\n  TAgent,\n  TOptions extends WebTestRunnerOptions<TAgent>,\n>(\n  adapter: WebTestDriverAdapter<TAgent, TOptions>,\n): readonly AgentTestRunnerNodeDefinition[] => {\n  const gotoUrlNode: AgentTestRunnerNodeDefinition<\n    z.output<typeof gotoUrlInputSchema>,\n    GotoUrlNodeResult\n  > = {\n    name: 'gotoUrl',\n    title: 'Open a Web URL',\n    description:\n      'Navigate the current browser Page to an absolute HTTP(S) URL or a path relative to testRunner.baseURL or the current page URL.',\n    stringInputKey: 'url',\n    inputSchema: gotoUrlInputSchema,\n    async execute(agent, input, executionContext) {\n      const runtimeAgent = adapter.requireAgent(agent);\n      const driver = adapter.createDriver(runtimeAgent);\n      throwIfAborted(executionContext.signal, 'gotoUrl');\n      const url = resolveNavigationUrl(\n        input.url,\n        driver.currentUrl(),\n        adapter.getOptions(runtimeAgent)?.baseURL ?? driver.baseUrl(),\n      );\n      const response = await driver.goto(url, {\n        waitUntil: input.waitUntil,\n        timeoutMs: input.timeoutMs,\n      });\n      throwIfAborted(executionContext.signal, 'gotoUrl');\n      const result = {\n        url: driver.currentUrl(),\n        status: response.status,\n        title: await driver.title(),\n      };\n      return { summary: `Navigated to ${result.url}`, data: result };\n    },\n  };\n\n  const setCookiesNode: AgentTestRunnerNodeDefinition<\n    z.output<typeof setCookiesInputSchema>,\n    SetCookiesNodeResult\n  > = {\n    name: 'setCookies',\n    title: 'Set browser cookies',\n    description:\n      'Load cookies from an environment variable, configured profile, or browser storage-state file without persisting cookie values in workflow input or output.',\n    stringInputKey: false,\n    inputSchema: setCookiesInputSchema,\n    async execute(agent, input, executionContext) {\n      const runtimeAgent = adapter.requireAgent(agent);\n      const driver = adapter.createDriver(runtimeAgent);\n      throwIfAborted(executionContext.signal, 'setCookies');\n      const { cookies, result } = await resolveCookieInput(\n        input,\n        { ...executionContext, input, context: runtimeAgent },\n        adapter.getOptions(runtimeAgent) ?? {},\n      );\n      throwIfAborted(executionContext.signal, 'setCookies');\n      try {\n        await driver.setCookies(cookies);\n      } catch {\n        throw new Error(\n          `Failed to set ${cookies.length} browser cookie(s); the browser error was redacted because it may contain cookie values.`,\n        );\n      }\n      return {\n        summary: `Set ${result.count} browser cookie(s) from ${result.source} ${result.sourceName}`,\n        data: result,\n      };\n    },\n  };\n\n  const clearCookiesNode: AgentTestRunnerNodeDefinition<\n    z.output<typeof clearCookiesInputSchema>,\n    { filters: WebCookieFilters }\n  > = {\n    name: 'clearCookies',\n    title: 'Clear browser cookies',\n    description:\n      'Clear all cookies from the current browser context, or only cookies matching name, domain, or path.',\n    stringInputKey: false,\n    inputSchema: clearCookiesInputSchema,\n    async execute(agent, input, executionContext) {\n      const runtimeAgent = adapter.requireAgent(agent);\n      const driver = adapter.createDriver(runtimeAgent);\n      throwIfAborted(executionContext.signal, 'clearCookies');\n      const filters: WebCookieFilters = { ...input };\n      await driver.clearCookies(filters);\n      const filterNames = Object.keys(filters);\n      return {\n        summary:\n          filterNames.length === 0\n            ? 'Cleared all browser cookies'\n            : `Cleared browser cookies matching ${filterNames.join(', ')}`,\n        data: { filters },\n      };\n    },\n  };\n\n  const setViewportSizeNode: AgentTestRunnerNodeDefinition<\n    z.output<typeof setViewportSizeInputSchema>,\n    WebViewportSize\n  > = {\n    name: 'setViewportSize',\n    title: 'Set the browser viewport size',\n    description:\n      'Set the current browser Page viewport size in CSS pixels and return the effective size.',\n    stringInputKey: false,\n    inputSchema: setViewportSizeInputSchema,\n    async execute(agent, input, executionContext) {\n      const runtimeAgent = adapter.requireAgent(agent);\n      const driver = adapter.createDriver(runtimeAgent);\n      throwIfAborted(executionContext.signal, 'setViewportSize');\n      const viewport = await driver.setViewportSize(input);\n      return {\n        summary: `Set viewport to ${viewport.width}x${viewport.height}`,\n        data: viewport,\n      };\n    },\n  };\n\n  return [gotoUrlNode, setCookiesNode, clearCookiesNode, setViewportSizeNode];\n};\n\nexport { setCookiesInputSchema };\nexport type { SetCookiesNodeInput, SetCookiesNodeResult } from './cookies';\n"],"names":["DEFAULT_NAVIGATION_TIMEOUT_MS","DEFAULT_WAIT_UNTIL","gotoUrlInputSchema","z","clearCookiesInputSchema","setViewportSizeInputSchema","resolveNavigationUrl","target","currentUrl","configuredBase","trimmed","TypeError","resolveWebUrl","undefined","JSON","createWebTestRunnerNodeDefinitions","adapter","gotoUrlNode","agent","input","executionContext","runtimeAgent","driver","throwIfAborted","url","response","result","setCookiesNode","setCookiesInputSchema","cookies","resolveCookieInput","Error","clearCookiesNode","filters","filterNames","Object","setViewportSizeNode","viewport"],"mappings":"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"}

package/dist/es/common/test-runner/utils.mjs

@@ -0,0 +1,24 @@
+const SUPPORTED_WEB_PROTOCOLS = new Set([
+    'http:',
+    'https:'
+]);
+const throwIfAborted = (signal, operation)=>{
+    if (signal.aborted) throw signal.reason ?? new Error(`${operation} aborted.`);
+};
+const resolveWebUrl = (target, baseUrl, label)=>{
+    const trimmed = target.trim();
+    if (!trimmed) throw new TypeError(`${label} must not be blank.`);
+    let resolved;
+    try {
+        resolved = void 0 === baseUrl ? new URL(trimmed) : new URL(trimmed, baseUrl);
+    } catch (error) {
+        throw new TypeError(void 0 === baseUrl ? `${label} must be an absolute HTTP(S) URL.` : `${label} is not a valid URL.`, {
+            cause: error
+        });
+    }
+    if (!SUPPORTED_WEB_PROTOCOLS.has(resolved.protocol)) throw new TypeError(`${label} does not support the ${resolved.protocol} protocol.`);
+    return resolved.toString();
+};
+export { resolveWebUrl, throwIfAborted };
+
+//# sourceMappingURL=utils.mjs.map

package/dist/es/common/test-runner/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common/test-runner/utils.mjs","sources":["../../../../src/common/test-runner/utils.ts"],"sourcesContent":["const SUPPORTED_WEB_PROTOCOLS = new Set(['http:', 'https:']);\n\nexport const throwIfAborted = (signal: AbortSignal, operation: string) => {\n  if (signal.aborted) {\n    throw signal.reason ?? new Error(`${operation} aborted.`);\n  }\n};\n\nexport const resolveWebUrl = (\n  target: string,\n  baseUrl: string | undefined,\n  label: string,\n): string => {\n  const trimmed = target.trim();\n  if (!trimmed) throw new TypeError(`${label} must not be blank.`);\n\n  let resolved: URL;\n  try {\n    resolved =\n      baseUrl === undefined ? new URL(trimmed) : new URL(trimmed, baseUrl);\n  } catch (error) {\n    throw new TypeError(\n      baseUrl === undefined\n        ? `${label} must be an absolute HTTP(S) URL.`\n        : `${label} is not a valid URL.`,\n      { cause: error },\n    );\n  }\n  if (!SUPPORTED_WEB_PROTOCOLS.has(resolved.protocol)) {\n    throw new TypeError(\n      `${label} does not support the ${resolved.protocol} protocol.`,\n    );\n  }\n  return resolved.toString();\n};\n"],"names":["SUPPORTED_WEB_PROTOCOLS","Set","throwIfAborted","signal","operation","Error","resolveWebUrl","target","baseUrl","label","trimmed","TypeError","resolved","undefined","URL","error"],"mappings":"AAAA,MAAMA,0BAA0B,IAAIC,IAAI;IAAC;IAAS;CAAS;AAEpD,MAAMC,iBAAiB,CAACC,QAAqBC;IAClD,IAAID,OAAO,OAAO,EAChB,MAAMA,OAAO,MAAM,IAAI,IAAIE,MAAM,GAAGD,UAAU,SAAS,CAAC;AAE5D;AAEO,MAAME,gBAAgB,CAC3BC,QACAC,SACAC;IAEA,MAAMC,UAAUH,OAAO,IAAI;IAC3B,IAAI,CAACG,SAAS,MAAM,IAAIC,UAAU,GAAGF,MAAM,mBAAmB,CAAC;IAE/D,IAAIG;IACJ,IAAI;QACFA,WACEJ,AAAYK,WAAZL,UAAwB,IAAIM,IAAIJ,WAAW,IAAII,IAAIJ,SAASF;IAChE,EAAE,OAAOO,OAAO;QACd,MAAM,IAAIJ,UACRH,AAAYK,WAAZL,UACI,GAAGC,MAAM,iCAAiC,CAAC,GAC3C,GAAGA,MAAM,oBAAoB,CAAC,EAClC;YAAE,OAAOM;QAAM;IAEnB;IACA,IAAI,CAACf,wBAAwB,GAAG,CAACY,SAAS,QAAQ,GAChD,MAAM,IAAID,UACR,GAAGF,MAAM,sBAAsB,EAAEG,SAAS,QAAQ,CAAC,UAAU,CAAC;IAGlE,OAAOA,SAAS,QAAQ;AAC1B"}

package/dist/es/playwright/test-runner/agent-nodes.mjs

@@ -1,13 +1,6 @@
-import { clearCookiesNode } from "./clear-cookies.mjs";
-import { setCookiesNode } from "./cookies.mjs";
-import { gotoUrlNode } from "./goto-url.mjs";
-import { setViewportSizeNode } from "./viewport.mjs";
-const playwrightAgentTestRunnerNodeDefinitions = [
-    gotoUrlNode,
-    setCookiesNode,
-    clearCookiesNode,
-    setViewportSizeNode
-];
+import { createWebTestRunnerNodeDefinitions } from "../../common/test-runner/nodes.mjs";
+import { playwrightTestDriverAdapter } from "./driver.mjs";
+const playwrightAgentTestRunnerNodeDefinitions = createWebTestRunnerNodeDefinitions(playwrightTestDriverAdapter);
 export { playwrightAgentTestRunnerNodeDefinitions };
 
 //# sourceMappingURL=agent-nodes.mjs.map

package/dist/es/playwright/test-runner/agent-nodes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"playwright/test-runner/agent-nodes.mjs","sources":["../../../../src/playwright/test-runner/agent-nodes.ts"],"sourcesContent":["import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { clearCookiesNode } from './clear-cookies';\nimport { setCookiesNode } from './cookies';\nimport { gotoUrlNode } from './goto-url';\nimport { setViewportSizeNode } from './viewport';\n\nexport const playwrightAgentTestRunnerNodeDefinitions: readonly AgentTestRunnerNodeDefinition[] =\n  [gotoUrlNode, setCookiesNode, clearCookiesNode, setViewportSizeNode];\n"],"names":["playwrightAgentTestRunnerNodeDefinitions","gotoUrlNode","setCookiesNode","clearCookiesNode","setViewportSizeNode"],"mappings":";;;;AAMO,MAAMA,2CACX;IAACC;IAAaC;IAAgBC;IAAkBC;CAAoB"}
+{"version":3,"file":"playwright/test-runner/agent-nodes.mjs","sources":["../../../../src/playwright/test-runner/agent-nodes.ts"],"sourcesContent":["import { createWebTestRunnerNodeDefinitions } from '@/common/test-runner/nodes';\nimport { playwrightTestDriverAdapter } from './driver';\n\nexport const playwrightAgentTestRunnerNodeDefinitions =\n  createWebTestRunnerNodeDefinitions(playwrightTestDriverAdapter);\n"],"names":["playwrightAgentTestRunnerNodeDefinitions","createWebTestRunnerNodeDefinitions","playwrightTestDriverAdapter"],"mappings":";;AAGO,MAAMA,2CACXC,mCAAmCC"}

package/dist/es/playwright/test-runner/driver.mjs

@@ -0,0 +1,42 @@
+import { requirePlaywrightAgent } from "./utils.mjs";
+const createPlaywrightDriver = (agent)=>{
+    const page = agent.interface.underlyingPage;
+    return {
+        currentUrl: ()=>page.url(),
+        baseUrl: ()=>{
+            const context = page.context();
+            return context._options?.baseURL;
+        },
+        async goto (url, options) {
+            if ('networkidle0' === options.waitUntil || 'networkidle2' === options.waitUntil) throw new TypeError(`Playwright does not support gotoUrl.waitUntil=${options.waitUntil}; use networkidle instead.`);
+            const response = await page.goto(url, {
+                waitUntil: options.waitUntil,
+                timeout: options.timeoutMs
+            });
+            return {
+                status: response?.status() ?? null
+            };
+        },
+        title: ()=>page.title(),
+        setCookies: async (cookies)=>{
+            await page.context().addCookies(cookies);
+        },
+        clearCookies: async (filters)=>{
+            await page.context().clearCookies(filters);
+        },
+        setViewportSize: async (size)=>{
+            await page.setViewportSize(size);
+            const viewport = page.viewportSize();
+            if (!viewport) throw new Error('Playwright did not report an effective viewport size.');
+            return viewport;
+        }
+    };
+};
+const playwrightTestDriverAdapter = {
+    requireAgent: requirePlaywrightAgent,
+    createDriver: createPlaywrightDriver,
+    getOptions: (agent)=>agent.testRunner
+};
+export { playwrightTestDriverAdapter };
+
+//# sourceMappingURL=driver.mjs.map

package/dist/es/playwright/test-runner/driver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright/test-runner/driver.mjs","sources":["../../../../src/playwright/test-runner/driver.ts"],"sourcesContent":["import type {\n  WebCookieFilters,\n  WebTestDriver,\n  WebTestDriverAdapter,\n} from '@/common/test-runner/driver';\nimport type { BrowserContext } from 'playwright';\nimport type {\n  PlaywrightTestRunnerAgent,\n  PlaywrightTestRunnerOptions,\n} from './types';\nimport { requirePlaywrightAgent } from './utils';\n\ntype CookieClearOptions = NonNullable<\n  Parameters<BrowserContext['clearCookies']>[0]\n>;\n\nconst createPlaywrightDriver = (\n  agent: PlaywrightTestRunnerAgent,\n): WebTestDriver => {\n  const page = agent.interface.underlyingPage;\n  return {\n    currentUrl: () => page.url(),\n    baseUrl: () => {\n      const context = page.context() as BrowserContext & {\n        _options?: { baseURL?: string };\n      };\n      return context._options?.baseURL;\n    },\n    async goto(url, options) {\n      if (\n        options.waitUntil === 'networkidle0' ||\n        options.waitUntil === 'networkidle2'\n      ) {\n        throw new TypeError(\n          `Playwright does not support gotoUrl.waitUntil=${options.waitUntil}; use networkidle instead.`,\n        );\n      }\n      const response = await page.goto(url, {\n        waitUntil: options.waitUntil,\n        timeout: options.timeoutMs,\n      });\n      return { status: response?.status() ?? null };\n    },\n    title: () => page.title(),\n    setCookies: async (cookies) => {\n      await page.context().addCookies(cookies);\n    },\n    clearCookies: async (filters: WebCookieFilters) => {\n      await page.context().clearCookies(filters as CookieClearOptions);\n    },\n    setViewportSize: async (size) => {\n      await page.setViewportSize(size);\n      const viewport = page.viewportSize();\n      if (!viewport) {\n        throw new Error(\n          'Playwright did not report an effective viewport size.',\n        );\n      }\n      return viewport;\n    },\n  };\n};\n\nexport const playwrightTestDriverAdapter: WebTestDriverAdapter<\n  PlaywrightTestRunnerAgent,\n  PlaywrightTestRunnerOptions\n> = {\n  requireAgent: requirePlaywrightAgent,\n  createDriver: createPlaywrightDriver,\n  getOptions: (agent) => agent.testRunner,\n};\n"],"names":["createPlaywrightDriver","agent","page","context","url","options","TypeError","response","cookies","filters","size","viewport","Error","playwrightTestDriverAdapter","requirePlaywrightAgent"],"mappings":";AAgBA,MAAMA,yBAAyB,CAC7BC;IAEA,MAAMC,OAAOD,MAAM,SAAS,CAAC,cAAc;IAC3C,OAAO;QACL,YAAY,IAAMC,KAAK,GAAG;QAC1B,SAAS;YACP,MAAMC,UAAUD,KAAK,OAAO;YAG5B,OAAOC,QAAQ,QAAQ,EAAE;QAC3B;QACA,MAAM,MAAKC,GAAG,EAAEC,OAAO;YACrB,IACEA,AAAsB,mBAAtBA,QAAQ,SAAS,IACjBA,AAAsB,mBAAtBA,QAAQ,SAAS,EAEjB,MAAM,IAAIC,UACR,CAAC,8CAA8C,EAAED,QAAQ,SAAS,CAAC,0BAA0B,CAAC;YAGlG,MAAME,WAAW,MAAML,KAAK,IAAI,CAACE,KAAK;gBACpC,WAAWC,QAAQ,SAAS;gBAC5B,SAASA,QAAQ,SAAS;YAC5B;YACA,OAAO;gBAAE,QAAQE,UAAU,YAAY;YAAK;QAC9C;QACA,OAAO,IAAML,KAAK,KAAK;QACvB,YAAY,OAAOM;YACjB,MAAMN,KAAK,OAAO,GAAG,UAAU,CAACM;QAClC;QACA,cAAc,OAAOC;YACnB,MAAMP,KAAK,OAAO,GAAG,YAAY,CAACO;QACpC;QACA,iBAAiB,OAAOC;YACtB,MAAMR,KAAK,eAAe,CAACQ;YAC3B,MAAMC,WAAWT,KAAK,YAAY;YAClC,IAAI,CAACS,UACH,MAAM,IAAIC,MACR;YAGJ,OAAOD;QACT;IACF;AACF;AAEO,MAAME,8BAGT;IACF,cAAcC;IACd,cAAcd;IACd,YAAY,CAACC,QAAUA,MAAM,UAAU;AACzC"}

package/dist/es/playwright/test-runner/index.mjs

@@ -1,6 +1,3 @@
-import { clearCookiesInputSchema } from "./clear-cookies.mjs";
-import { setCookiesInputSchema } from "./cookies.mjs";
-import { gotoUrlInputSchema } from "./goto-url.mjs";
-import { setViewportSizeInputSchema } from "./viewport.mjs";
+import { clearCookiesInputSchema, gotoUrlInputSchema, setCookiesInputSchema, setViewportSizeInputSchema } from "../../common/test-runner/nodes.mjs";
 import { playwrightAgentTestRunnerNodeDefinitions } from "./agent-nodes.mjs";
 export { clearCookiesInputSchema, gotoUrlInputSchema, playwrightAgentTestRunnerNodeDefinitions, setCookiesInputSchema, setViewportSizeInputSchema };

package/dist/es/playwright/test-runner/utils.mjs

@@ -1,24 +1,4 @@
-const SUPPORTED_WEB_PROTOCOLS = new Set([
-    'http:',
-    'https:'
-]);
-const throwIfAborted = (signal, operation)=>{
-    if (signal.aborted) throw signal.reason ?? new Error(`${operation} aborted.`);
-};
-const resolveWebUrl = (target, baseUrl, label)=>{
-    const trimmed = target.trim();
-    if (!trimmed) throw new TypeError(`${label} must not be blank.`);
-    let resolved;
-    try {
-        resolved = void 0 === baseUrl ? new URL(trimmed) : new URL(trimmed, baseUrl);
-    } catch (error) {
-        throw new TypeError(void 0 === baseUrl ? `${label} must be an absolute HTTP(S) URL.` : `${label} is not a valid URL.`, {
-            cause: error
-        });
-    }
-    if (!SUPPORTED_WEB_PROTOCOLS.has(resolved.protocol)) throw new TypeError(`${label} does not support the ${resolved.protocol} protocol.`);
-    return resolved.toString();
-};
+import { resolveWebUrl, throwIfAborted } from "../../common/test-runner/utils.mjs";
 const requirePlaywrightAgent = (agent)=>{
     if (!agent || 'object' != typeof agent || !('interface' in agent) || !agent.interface || 'object' != typeof agent.interface || !('underlyingPage' in agent.interface) || !agent.interface.underlyingPage) throw new TypeError('getAgent() must return a Playwright Agent with an underlying Page.');
     return agent;

package/dist/es/playwright/test-runner/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"playwright/test-runner/utils.mjs","sources":["../../../../src/playwright/test-runner/utils.ts"],"sourcesContent":["import type { PlaywrightTestRunnerAgent } from './types';\n\nconst SUPPORTED_WEB_PROTOCOLS = new Set(['http:', 'https:']);\n\nexport const throwIfAborted = (signal: AbortSignal, operation: string) => {\n  if (signal.aborted) {\n    throw signal.reason ?? new Error(`${operation} aborted.`);\n  }\n};\n\nexport const resolveWebUrl = (\n  target: string,\n  baseUrl: string | undefined,\n  label: string,\n): string => {\n  const trimmed = target.trim();\n  if (!trimmed) throw new TypeError(`${label} must not be blank.`);\n\n  let resolved: URL;\n  try {\n    resolved =\n      baseUrl === undefined ? new URL(trimmed) : new URL(trimmed, baseUrl);\n  } catch (error) {\n    throw new TypeError(\n      baseUrl === undefined\n        ? `${label} must be an absolute HTTP(S) URL.`\n        : `${label} is not a valid URL.`,\n      { cause: error },\n    );\n  }\n  if (!SUPPORTED_WEB_PROTOCOLS.has(resolved.protocol)) {\n    throw new TypeError(\n      `${label} does not support the ${resolved.protocol} protocol.`,\n    );\n  }\n  return resolved.toString();\n};\n\nexport const requirePlaywrightAgent = (\n  agent: unknown,\n): PlaywrightTestRunnerAgent => {\n  if (\n    !agent ||\n    typeof agent !== 'object' ||\n    !('interface' in agent) ||\n    !agent.interface ||\n    typeof agent.interface !== 'object' ||\n    !('underlyingPage' in agent.interface) ||\n    !agent.interface.underlyingPage\n  ) {\n    throw new TypeError(\n      'getAgent() must return a Playwright Agent with an underlying Page.',\n    );\n  }\n  return agent as PlaywrightTestRunnerAgent;\n};\n"],"names":["SUPPORTED_WEB_PROTOCOLS","Set","throwIfAborted","signal","operation","Error","resolveWebUrl","target","baseUrl","label","trimmed","TypeError","resolved","undefined","URL","error","requirePlaywrightAgent","agent"],"mappings":"AAEA,MAAMA,0BAA0B,IAAIC,IAAI;IAAC;IAAS;CAAS;AAEpD,MAAMC,iBAAiB,CAACC,QAAqBC;IAClD,IAAID,OAAO,OAAO,EAChB,MAAMA,OAAO,MAAM,IAAI,IAAIE,MAAM,GAAGD,UAAU,SAAS,CAAC;AAE5D;AAEO,MAAME,gBAAgB,CAC3BC,QACAC,SACAC;IAEA,MAAMC,UAAUH,OAAO,IAAI;IAC3B,IAAI,CAACG,SAAS,MAAM,IAAIC,UAAU,GAAGF,MAAM,mBAAmB,CAAC;IAE/D,IAAIG;IACJ,IAAI;QACFA,WACEJ,AAAYK,WAAZL,UAAwB,IAAIM,IAAIJ,WAAW,IAAII,IAAIJ,SAASF;IAChE,EAAE,OAAOO,OAAO;QACd,MAAM,IAAIJ,UACRH,AAAYK,WAAZL,UACI,GAAGC,MAAM,iCAAiC,CAAC,GAC3C,GAAGA,MAAM,oBAAoB,CAAC,EAClC;YAAE,OAAOM;QAAM;IAEnB;IACA,IAAI,CAACf,wBAAwB,GAAG,CAACY,SAAS,QAAQ,GAChD,MAAM,IAAID,UACR,GAAGF,MAAM,sBAAsB,EAAEG,SAAS,QAAQ,CAAC,UAAU,CAAC;IAGlE,OAAOA,SAAS,QAAQ;AAC1B;AAEO,MAAMI,yBAAyB,CACpCC;IAEA,IACE,CAACA,SACD,AAAiB,YAAjB,OAAOA,SACP,CAAE,gBAAeA,KAAI,KACrB,CAACA,MAAM,SAAS,IAChB,AAA2B,YAA3B,OAAOA,MAAM,SAAS,IACtB,CAAE,qBAAoBA,MAAM,SAAQ,KACpC,CAACA,MAAM,SAAS,CAAC,cAAc,EAE/B,MAAM,IAAIN,UACR;IAGJ,OAAOM;AACT"}
+{"version":3,"file":"playwright/test-runner/utils.mjs","sources":["../../../../src/playwright/test-runner/utils.ts"],"sourcesContent":["export { resolveWebUrl, throwIfAborted } from '../../common/test-runner/utils';\n\nimport type { PlaywrightTestRunnerAgent } from './types';\n\nexport const requirePlaywrightAgent = (\n  agent: unknown,\n): PlaywrightTestRunnerAgent => {\n  if (\n    !agent ||\n    typeof agent !== 'object' ||\n    !('interface' in agent) ||\n    !agent.interface ||\n    typeof agent.interface !== 'object' ||\n    !('underlyingPage' in agent.interface) ||\n    !agent.interface.underlyingPage\n  ) {\n    throw new TypeError(\n      'getAgent() must return a Playwright Agent with an underlying Page.',\n    );\n  }\n  return agent as PlaywrightTestRunnerAgent;\n};\n"],"names":["requirePlaywrightAgent","agent","TypeError"],"mappings":";AAIO,MAAMA,yBAAyB,CACpCC;IAEA,IACE,CAACA,SACD,AAAiB,YAAjB,OAAOA,SACP,CAAE,gBAAeA,KAAI,KACrB,CAACA,MAAM,SAAS,IAChB,AAA2B,YAA3B,OAAOA,MAAM,SAAS,IACtB,CAAE,qBAAoBA,MAAM,SAAQ,KACpC,CAACA,MAAM,SAAS,CAAC,cAAc,EAE/B,MAAM,IAAIC,UACR;IAGJ,OAAOD;AACT"}

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

@@ -4,6 +4,7 @@ import { appendBrowserAgentPageActions, createBrowserAgentPageActions } from "..
 import { getDebug } from "@midscene/shared/logger";
 import { createPuppeteerBrowserPageManager } from "./browser-page-manager.mjs";
 import { PuppeteerWebPage } from "./page.mjs";
+import { puppeteerAgentTestRunnerNodeDefinitions } from "./test-runner/agent-nodes.mjs";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -16,6 +17,12 @@ function _define_property(obj, key, value) {
 }
 const debug = getDebug('puppeteer:browser-agent');
 class PuppeteerBrowserAgent extends WebAgentCore {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...WebAgentCore.getTestRunnerNodeDefinitions(),
+            ...puppeteerAgentTestRunnerNodeDefinitions
+        ];
+    }
     static async create(browser, opts) {
         const { initialPage, ...agentOpts } = opts ?? {};
         const page = initialPage ?? (await browser.pages())[0] ?? await browser.newPage();
@@ -67,7 +74,8 @@ class PuppeteerBrowserAgent extends WebAgentCore {
             debug,
             pageScope
         });
-        super(webPage, agentOpts), _define_property(this, "pageManager", void 0);
+        super(webPage, agentOpts), _define_property(this, "testRunner", void 0), _define_property(this, "pageManager", void 0);
+        this.testRunner = opts?.testRunner;
         this.pageManager = pageManager;
         applyForceChromeSelectRendering(initialPage, 'puppeteer', forceChromeSelectRendering);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"puppeteer/browser-agent.mjs","sources":["../../../src/puppeteer/browser-agent.ts"],"sourcesContent":["import {\n  type BrowserPageManager,\n  WebAgentCore,\n  resolveBrowserAgentRuntimeOptions,\n} from '@/common/browser-agent';\nimport { applyForceChromeSelectRendering } from '@/common/browser-agent-utils';\nimport {\n  appendBrowserAgentPageActions,\n  createBrowserAgentPageActions,\n} from '@/common/browser-page-actions';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport { getDebug } from '@midscene/shared/logger';\nimport type {\n  Browser as PuppeteerBrowser,\n  Page as PuppeteerPage,\n  Target as PuppeteerTarget,\n} from 'puppeteer';\nimport { createPuppeteerBrowserPageManager } from './browser-page-manager';\nimport type { PuppeteerBrowserPageScope } from './browser-page-manager';\nimport { PuppeteerWebPage } from './page';\n\nconst debug = getDebug('puppeteer:browser-agent');\n\nexport type PuppeteerBrowserAgentOpt = Omit<\n  WebPageAgentOpt,\n  'forceSameTabNavigation'\n> & {\n  autoFollowNewPage?: boolean;\n  newPageTimeout?: number;\n};\n\nexport type PuppeteerBrowserAgentCreateOpt = PuppeteerBrowserAgentOpt & {\n  initialPage?: PuppeteerPage;\n};\n\nexport class PuppeteerBrowserAgent extends WebAgentCore<PuppeteerWebPage> {\n  protected readonly pageManager: BrowserPageManager<\n    PuppeteerPage,\n    PuppeteerTarget\n  >;\n\n  constructor(\n    browser: PuppeteerBrowser,\n    initialPage: PuppeteerPage,\n    opts?: PuppeteerBrowserAgentOpt,\n    pageScope?: PuppeteerBrowserPageScope,\n  ) {\n    if (!browser) {\n      throw new Error(\n        '[midscene] PuppeteerBrowserAgent requires a valid Puppeteer browser instance.',\n      );\n    }\n    if (!initialPage) {\n      throw new Error(\n        '[midscene] PuppeteerBrowserAgent requires a valid initial page instance.',\n      );\n    }\n\n    const { autoFollowNewPage, newPageTimeout, ...agentOpts } = opts ?? {};\n    const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n      agentName: 'PuppeteerBrowserAgent',\n      pageScope: 'browser',\n      forceSameTabNavigation: (opts as WebPageAgentOpt | undefined)\n        ?.forceSameTabNavigation,\n      autoFollowNewPage,\n      newPageTimeout,\n    });\n    const { forceChromeSelectRendering } = agentOpts;\n    const browserActions = createBrowserAgentPageActions({\n      getPageManager: () => pageManager,\n    });\n    const webPage: PuppeteerWebPage = new PuppeteerWebPage(initialPage, {\n      ...agentOpts,\n      forceSameTabNavigation: runtimeOptions.forceSameTabNavigation,\n      customActions: appendBrowserAgentPageActions(\n        agentOpts.customActions,\n        browserActions,\n      ),\n    });\n    const pageManager: BrowserPageManager<PuppeteerPage, PuppeteerTarget> =\n      createPuppeteerBrowserPageManager({\n        browser,\n        webPage,\n        runtimeOptions,\n        debug,\n        pageScope,\n      });\n    super(webPage, agentOpts);\n    this.pageManager = pageManager;\n\n    applyForceChromeSelectRendering(\n      initialPage,\n      'puppeteer',\n      forceChromeSelectRendering,\n    );\n  }\n\n  static async create(\n    browser: PuppeteerBrowser,\n    opts?: PuppeteerBrowserAgentCreateOpt,\n  ) {\n    const { initialPage, ...agentOpts } = opts ?? {};\n    const page =\n      initialPage ?? (await browser.pages())[0] ?? (await browser.newPage());\n\n    return new PuppeteerBrowserAgent(browser, page, agentOpts);\n  }\n\n  get activePage() {\n    return this.pageManager.activePage;\n  }\n\n  pages() {\n    return this.pageManager.pages();\n  }\n\n  async newPage() {\n    return this.pageManager.newPage();\n  }\n\n  async setActivePage(page: PuppeteerPage) {\n    await this.pageManager.setActivePage(page);\n  }\n\n  async waitForNewPage(\n    action?: () => Promise<unknown> | unknown,\n    opts?: { timeout?: number },\n  ) {\n    return this.pageManager.waitForNewPage(action, opts);\n  }\n\n  async destroy() {\n    this.pageManager.destroy();\n    await super.destroy();\n  }\n}\n"],"names":["debug","getDebug","PuppeteerBrowserAgent","WebAgentCore","browser","opts","initialPage","agentOpts","page","action","pageScope","Error","autoFollowNewPage","newPageTimeout","runtimeOptions","resolveBrowserAgentRuntimeOptions","forceChromeSelectRendering","browserActions","createBrowserAgentPageActions","pageManager","webPage","PuppeteerWebPage","appendBrowserAgentPageActions","createPuppeteerBrowserPageManager","applyForceChromeSelectRendering"],"mappings":";;;;;;;;;;;;;;;;AAqBA,MAAMA,QAAQC,SAAS;AAchB,MAAMC,8BAA8BC;IA8DzC,aAAa,OACXC,OAAyB,EACzBC,IAAqC,EACrC;QACA,MAAM,EAAEC,WAAW,EAAE,GAAGC,WAAW,GAAGF,QAAQ,CAAC;QAC/C,MAAMG,OACJF,eAAgB,OAAMF,QAAQ,KAAK,EAAC,CAAE,CAAC,EAAE,IAAK,MAAMA,QAAQ,OAAO;QAErE,OAAO,IAAIF,sBAAsBE,SAASI,MAAMD;IAClD;IAEA,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU;IACpC;IAEA,QAAQ;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK;IAC/B;IAEA,MAAM,UAAU;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO;IACjC;IAEA,MAAM,cAAcC,IAAmB,EAAE;QACvC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAACA;IACvC;IAEA,MAAM,eACJC,MAAyC,EACzCJ,IAA2B,EAC3B;QACA,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAACI,QAAQJ;IACjD;IAEA,MAAM,UAAU;QACd,IAAI,CAAC,WAAW,CAAC,OAAO;QACxB,MAAM,KAAK,CAAC;IACd;IA7FA,YACED,OAAyB,EACzBE,WAA0B,EAC1BD,IAA+B,EAC/BK,SAAqC,CACrC;QACA,IAAI,CAACN,SACH,MAAM,IAAIO,MACR;QAGJ,IAAI,CAACL,aACH,MAAM,IAAIK,MACR;QAIJ,MAAM,EAAEC,iBAAiB,EAAEC,cAAc,EAAE,GAAGN,WAAW,GAAGF,QAAQ,CAAC;QACrE,MAAMS,iBAAiBC,kCAAkC;YACvD,WAAW;YACX,WAAW;YACX,wBAAyBV,MACrB;YACJO;YACAC;QACF;QACA,MAAM,EAAEG,0BAA0B,EAAE,GAAGT;QACvC,MAAMU,iBAAiBC,8BAA8B;YACnD,gBAAgB,IAAMC;QACxB;QACA,MAAMC,UAA4B,IAAIC,iBAAiBf,aAAa;YAClE,GAAGC,SAAS;YACZ,wBAAwBO,eAAe,sBAAsB;YAC7D,eAAeQ,8BACbf,UAAU,aAAa,EACvBU;QAEJ;QACA,MAAME,cACJI,kCAAkC;YAChCnB;YACAgB;YACAN;YACAd;YACAU;QACF;QACF,KAAK,CAACU,SAASb,YAnDjB,uBAAmB,eAAnB;QAoDE,IAAI,CAAC,WAAW,GAAGY;QAEnBK,gCACElB,aACA,aACAU;IAEJ;AAwCF"}
+{"version":3,"file":"puppeteer/browser-agent.mjs","sources":["../../../src/puppeteer/browser-agent.ts"],"sourcesContent":["import {\n  type BrowserPageManager,\n  WebAgentCore,\n  resolveBrowserAgentRuntimeOptions,\n} from '@/common/browser-agent';\nimport { applyForceChromeSelectRendering } from '@/common/browser-agent-utils';\nimport {\n  appendBrowserAgentPageActions,\n  createBrowserAgentPageActions,\n} from '@/common/browser-page-actions';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { getDebug } from '@midscene/shared/logger';\nimport type {\n  Browser as PuppeteerBrowser,\n  Page as PuppeteerPage,\n  Target as PuppeteerTarget,\n} from 'puppeteer';\nimport { createPuppeteerBrowserPageManager } from './browser-page-manager';\nimport type { PuppeteerBrowserPageScope } from './browser-page-manager';\nimport { PuppeteerWebPage } from './page';\nimport { puppeteerAgentTestRunnerNodeDefinitions } from './test-runner/agent-nodes';\nimport type { PuppeteerTestRunnerOptions } from './test-runner/types';\n\nconst debug = getDebug('puppeteer:browser-agent');\n\nexport type PuppeteerBrowserAgentOpt = Omit<\n  WebPageAgentOpt,\n  'forceSameTabNavigation'\n> & {\n  testRunner?: PuppeteerTestRunnerOptions;\n  autoFollowNewPage?: boolean;\n  newPageTimeout?: number;\n};\n\nexport type PuppeteerBrowserAgentCreateOpt = PuppeteerBrowserAgentOpt & {\n  initialPage?: PuppeteerPage;\n};\n\nexport class PuppeteerBrowserAgent extends WebAgentCore<PuppeteerWebPage> {\n  static override getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[] {\n    return [\n      ...WebAgentCore.getTestRunnerNodeDefinitions(),\n      ...puppeteerAgentTestRunnerNodeDefinitions,\n    ];\n  }\n\n  readonly testRunner?: PuppeteerTestRunnerOptions;\n\n  protected readonly pageManager: BrowserPageManager<\n    PuppeteerPage,\n    PuppeteerTarget\n  >;\n\n  constructor(\n    browser: PuppeteerBrowser,\n    initialPage: PuppeteerPage,\n    opts?: PuppeteerBrowserAgentOpt,\n    pageScope?: PuppeteerBrowserPageScope,\n  ) {\n    if (!browser) {\n      throw new Error(\n        '[midscene] PuppeteerBrowserAgent requires a valid Puppeteer browser instance.',\n      );\n    }\n    if (!initialPage) {\n      throw new Error(\n        '[midscene] PuppeteerBrowserAgent requires a valid initial page instance.',\n      );\n    }\n\n    const { autoFollowNewPage, newPageTimeout, ...agentOpts } = opts ?? {};\n    const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n      agentName: 'PuppeteerBrowserAgent',\n      pageScope: 'browser',\n      forceSameTabNavigation: (opts as WebPageAgentOpt | undefined)\n        ?.forceSameTabNavigation,\n      autoFollowNewPage,\n      newPageTimeout,\n    });\n    const { forceChromeSelectRendering } = agentOpts;\n    const browserActions = createBrowserAgentPageActions({\n      getPageManager: () => pageManager,\n    });\n    const webPage: PuppeteerWebPage = new PuppeteerWebPage(initialPage, {\n      ...agentOpts,\n      forceSameTabNavigation: runtimeOptions.forceSameTabNavigation,\n      customActions: appendBrowserAgentPageActions(\n        agentOpts.customActions,\n        browserActions,\n      ),\n    });\n    const pageManager: BrowserPageManager<PuppeteerPage, PuppeteerTarget> =\n      createPuppeteerBrowserPageManager({\n        browser,\n        webPage,\n        runtimeOptions,\n        debug,\n        pageScope,\n      });\n    super(webPage, agentOpts);\n    this.testRunner = opts?.testRunner;\n    this.pageManager = pageManager;\n\n    applyForceChromeSelectRendering(\n      initialPage,\n      'puppeteer',\n      forceChromeSelectRendering,\n    );\n  }\n\n  static async create(\n    browser: PuppeteerBrowser,\n    opts?: PuppeteerBrowserAgentCreateOpt,\n  ) {\n    const { initialPage, ...agentOpts } = opts ?? {};\n    const page =\n      initialPage ?? (await browser.pages())[0] ?? (await browser.newPage());\n\n    return new PuppeteerBrowserAgent(browser, page, agentOpts);\n  }\n\n  get activePage() {\n    return this.pageManager.activePage;\n  }\n\n  pages() {\n    return this.pageManager.pages();\n  }\n\n  async newPage() {\n    return this.pageManager.newPage();\n  }\n\n  async setActivePage(page: PuppeteerPage) {\n    await this.pageManager.setActivePage(page);\n  }\n\n  async waitForNewPage(\n    action?: () => Promise<unknown> | unknown,\n    opts?: { timeout?: number },\n  ) {\n    return this.pageManager.waitForNewPage(action, opts);\n  }\n\n  async destroy() {\n    this.pageManager.destroy();\n    await super.destroy();\n  }\n}\n"],"names":["debug","getDebug","PuppeteerBrowserAgent","WebAgentCore","puppeteerAgentTestRunnerNodeDefinitions","browser","opts","initialPage","agentOpts","page","action","pageScope","Error","autoFollowNewPage","newPageTimeout","runtimeOptions","resolveBrowserAgentRuntimeOptions","forceChromeSelectRendering","browserActions","createBrowserAgentPageActions","pageManager","webPage","PuppeteerWebPage","appendBrowserAgentPageActions","createPuppeteerBrowserPageManager","applyForceChromeSelectRendering"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,MAAMA,QAAQC,SAAS;AAehB,MAAMC,8BAA8BC;IACzC,OAAgB,+BAAyE;QACvF,OAAO;eACFA,aAAa,4BAA4B;eACzCC;SACJ;IACH;IAkEA,aAAa,OACXC,OAAyB,EACzBC,IAAqC,EACrC;QACA,MAAM,EAAEC,WAAW,EAAE,GAAGC,WAAW,GAAGF,QAAQ,CAAC;QAC/C,MAAMG,OACJF,eAAgB,OAAMF,QAAQ,KAAK,EAAC,CAAE,CAAC,EAAE,IAAK,MAAMA,QAAQ,OAAO;QAErE,OAAO,IAAIH,sBAAsBG,SAASI,MAAMD;IAClD;IAEA,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU;IACpC;IAEA,QAAQ;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK;IAC/B;IAEA,MAAM,UAAU;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO;IACjC;IAEA,MAAM,cAAcC,IAAmB,EAAE;QACvC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAACA;IACvC;IAEA,MAAM,eACJC,MAAyC,EACzCJ,IAA2B,EAC3B;QACA,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAACI,QAAQJ;IACjD;IAEA,MAAM,UAAU;QACd,IAAI,CAAC,WAAW,CAAC,OAAO;QACxB,MAAM,KAAK,CAAC;IACd;IA9FA,YACED,OAAyB,EACzBE,WAA0B,EAC1BD,IAA+B,EAC/BK,SAAqC,CACrC;QACA,IAAI,CAACN,SACH,MAAM,IAAIO,MACR;QAGJ,IAAI,CAACL,aACH,MAAM,IAAIK,MACR;QAIJ,MAAM,EAAEC,iBAAiB,EAAEC,cAAc,EAAE,GAAGN,WAAW,GAAGF,QAAQ,CAAC;QACrE,MAAMS,iBAAiBC,kCAAkC;YACvD,WAAW;YACX,WAAW;YACX,wBAAyBV,MACrB;YACJO;YACAC;QACF;QACA,MAAM,EAAEG,0BAA0B,EAAE,GAAGT;QACvC,MAAMU,iBAAiBC,8BAA8B;YACnD,gBAAgB,IAAMC;QACxB;QACA,MAAMC,UAA4B,IAAIC,iBAAiBf,aAAa;YAClE,GAAGC,SAAS;YACZ,wBAAwBO,eAAe,sBAAsB;YAC7D,eAAeQ,8BACbf,UAAU,aAAa,EACvBU;QAEJ;QACA,MAAME,cACJI,kCAAkC;YAChCnB;YACAgB;YACAN;YACAf;YACAW;QACF;QACF,KAAK,CAACU,SAASb,YArDjB,uBAAS,cAAT,SAEA,uBAAmB,eAAnB;QAoDE,IAAI,CAAC,UAAU,GAAGF,MAAM;QACxB,IAAI,CAAC,WAAW,GAAGc;QAEnBK,gCACElB,aACA,aACAU;IAEJ;AAwCF"}

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

@@ -3,12 +3,30 @@ import { applyForceChromeSelectRendering } from "../common/browser-agent-utils.m
 import { getDebug } from "@midscene/shared/logger";
 import { forceClosePopup } from "./base-page.mjs";
 import { PuppeteerWebPage } from "./page.mjs";
+import { puppeteerAgentTestRunnerNodeDefinitions } from "./test-runner/agent-nodes.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = getDebug('puppeteer:agent');
 class PuppeteerPageAgent extends WebAgentCore {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...WebAgentCore.getTestRunnerNodeDefinitions(),
+            ...puppeteerAgentTestRunnerNodeDefinitions
+        ];
+    }
     constructor(page, opts){
         if (!page) throw new Error('[midscene] PuppeteerPageAgent requires a valid Puppeteer page instance. Please make sure to pass a valid page object.');
         const webPage = new PuppeteerWebPage(page, opts);
-        super(webPage, opts);
+        super(webPage, opts), _define_property(this, "testRunner", void 0);
+        this.testRunner = opts?.testRunner;
         const { forceSameTabNavigation, forceChromeSelectRendering } = opts ?? {};
         const runtimeOptions = resolveBrowserAgentRuntimeOptions({
             agentName: 'PuppeteerPageAgent',

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

@@ -1 +1 @@
-{"version":3,"file":"puppeteer/page-agent.mjs","sources":["../../../src/puppeteer/page-agent.ts"],"sourcesContent":["import {\n  WebAgentCore,\n  resolveBrowserAgentRuntimeOptions,\n} from '@/common/browser-agent';\nimport { applyForceChromeSelectRendering } from '@/common/browser-agent-utils';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport { getDebug } from '@midscene/shared/logger';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport { forceClosePopup } from './base-page';\nimport { PuppeteerWebPage } from './page';\n\nconst debug = getDebug('puppeteer:agent');\n\nexport class PuppeteerPageAgent extends WebAgentCore<PuppeteerWebPage> {\n  constructor(page: PuppeteerPage, opts?: WebPageAgentOpt) {\n    if (!page) {\n      throw new Error(\n        '[midscene] PuppeteerPageAgent requires a valid Puppeteer page instance. Please make sure to pass a valid page object.',\n      );\n    }\n    const webPage = new PuppeteerWebPage(page, opts);\n    super(webPage, opts);\n\n    const { forceSameTabNavigation, forceChromeSelectRendering } = opts ?? {};\n    const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n      agentName: 'PuppeteerPageAgent',\n      pageScope: 'page',\n      forceSameTabNavigation,\n    });\n\n    if (runtimeOptions.forceSameTabNavigation) {\n      forceClosePopup(page, debug);\n    }\n\n    applyForceChromeSelectRendering(\n      page,\n      'puppeteer',\n      forceChromeSelectRendering,\n    );\n  }\n}\n\nexport { PuppeteerPageAgent as PuppeteerAgent };\n"],"names":["debug","getDebug","PuppeteerPageAgent","WebAgentCore","page","opts","Error","webPage","PuppeteerWebPage","forceSameTabNavigation","forceChromeSelectRendering","runtimeOptions","resolveBrowserAgentRuntimeOptions","forceClosePopup","applyForceChromeSelectRendering"],"mappings":";;;;;AAWA,MAAMA,QAAQC,SAAS;AAEhB,MAAMC,2BAA2BC;IACtC,YAAYC,IAAmB,EAAEC,IAAsB,CAAE;QACvD,IAAI,CAACD,MACH,MAAM,IAAIE,MACR;QAGJ,MAAMC,UAAU,IAAIC,iBAAiBJ,MAAMC;QAC3C,KAAK,CAACE,SAASF;QAEf,MAAM,EAAEI,sBAAsB,EAAEC,0BAA0B,EAAE,GAAGL,QAAQ,CAAC;QACxE,MAAMM,iBAAiBC,kCAAkC;YACvD,WAAW;YACX,WAAW;YACXH;QACF;QAEA,IAAIE,eAAe,sBAAsB,EACvCE,gBAAgBT,MAAMJ;QAGxBc,gCACEV,MACA,aACAM;IAEJ;AACF"}
+{"version":3,"file":"puppeteer/page-agent.mjs","sources":["../../../src/puppeteer/page-agent.ts"],"sourcesContent":["import {\n  WebAgentCore,\n  resolveBrowserAgentRuntimeOptions,\n} from '@/common/browser-agent';\nimport { applyForceChromeSelectRendering } from '@/common/browser-agent-utils';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { getDebug } from '@midscene/shared/logger';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport { forceClosePopup } from './base-page';\nimport { PuppeteerWebPage } from './page';\nimport { puppeteerAgentTestRunnerNodeDefinitions } from './test-runner/agent-nodes';\nimport type { PuppeteerTestRunnerOptions } from './test-runner/types';\n\nconst debug = getDebug('puppeteer:agent');\n\nexport type PuppeteerPageAgentOpt = WebPageAgentOpt & {\n  testRunner?: PuppeteerTestRunnerOptions;\n};\n\nexport class PuppeteerPageAgent extends WebAgentCore<PuppeteerWebPage> {\n  static override getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[] {\n    return [\n      ...WebAgentCore.getTestRunnerNodeDefinitions(),\n      ...puppeteerAgentTestRunnerNodeDefinitions,\n    ];\n  }\n\n  readonly testRunner?: PuppeteerTestRunnerOptions;\n\n  constructor(page: PuppeteerPage, opts?: PuppeteerPageAgentOpt) {\n    if (!page) {\n      throw new Error(\n        '[midscene] PuppeteerPageAgent requires a valid Puppeteer page instance. Please make sure to pass a valid page object.',\n      );\n    }\n    const webPage = new PuppeteerWebPage(page, opts);\n    super(webPage, opts);\n    this.testRunner = opts?.testRunner;\n\n    const { forceSameTabNavigation, forceChromeSelectRendering } = opts ?? {};\n    const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n      agentName: 'PuppeteerPageAgent',\n      pageScope: 'page',\n      forceSameTabNavigation,\n    });\n\n    if (runtimeOptions.forceSameTabNavigation) {\n      forceClosePopup(page, debug);\n    }\n\n    applyForceChromeSelectRendering(\n      page,\n      'puppeteer',\n      forceChromeSelectRendering,\n    );\n  }\n}\n\nexport { PuppeteerPageAgent as PuppeteerAgent };\n"],"names":["debug","getDebug","PuppeteerPageAgent","WebAgentCore","puppeteerAgentTestRunnerNodeDefinitions","page","opts","Error","webPage","PuppeteerWebPage","forceSameTabNavigation","forceChromeSelectRendering","runtimeOptions","resolveBrowserAgentRuntimeOptions","forceClosePopup","applyForceChromeSelectRendering"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAMA,QAAQC,SAAS;AAMhB,MAAMC,2BAA2BC;IACtC,OAAgB,+BAAyE;QACvF,OAAO;eACFA,aAAa,4BAA4B;eACzCC;SACJ;IACH;IAIA,YAAYC,IAAmB,EAAEC,IAA4B,CAAE;QAC7D,IAAI,CAACD,MACH,MAAM,IAAIE,MACR;QAGJ,MAAMC,UAAU,IAAIC,iBAAiBJ,MAAMC;QAC3C,KAAK,CAACE,SAASF,OATjB,uBAAS,cAAT;QAUE,IAAI,CAAC,UAAU,GAAGA,MAAM;QAExB,MAAM,EAAEI,sBAAsB,EAAEC,0BAA0B,EAAE,GAAGL,QAAQ,CAAC;QACxE,MAAMM,iBAAiBC,kCAAkC;YACvD,WAAW;YACX,WAAW;YACXH;QACF;QAEA,IAAIE,eAAe,sBAAsB,EACvCE,gBAAgBT,MAAML;QAGxBe,gCACEV,MACA,aACAM;IAEJ;AACF"}

package/dist/es/puppeteer/test-runner/agent-nodes.mjs

@@ -0,0 +1,6 @@
+import { createWebTestRunnerNodeDefinitions } from "../../common/test-runner/nodes.mjs";
+import { puppeteerTestDriverAdapter } from "./driver.mjs";
+const puppeteerAgentTestRunnerNodeDefinitions = createWebTestRunnerNodeDefinitions(puppeteerTestDriverAdapter);
+export { puppeteerAgentTestRunnerNodeDefinitions };
+
+//# sourceMappingURL=agent-nodes.mjs.map

package/dist/es/puppeteer/test-runner/agent-nodes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer/test-runner/agent-nodes.mjs","sources":["../../../../src/puppeteer/test-runner/agent-nodes.ts"],"sourcesContent":["import { createWebTestRunnerNodeDefinitions } from '@/common/test-runner/nodes';\nimport { puppeteerTestDriverAdapter } from './driver';\n\nexport const puppeteerAgentTestRunnerNodeDefinitions =\n  createWebTestRunnerNodeDefinitions(puppeteerTestDriverAdapter);\n"],"names":["puppeteerAgentTestRunnerNodeDefinitions","createWebTestRunnerNodeDefinitions","puppeteerTestDriverAdapter"],"mappings":";;AAGO,MAAMA,0CACXC,mCAAmCC"}

package/dist/es/puppeteer/test-runner/driver.mjs

@@ -0,0 +1,44 @@
+import { requirePuppeteerAgent } from "./utils.mjs";
+const createPuppeteerDriver = (agent)=>{
+    const page = agent.interface.underlyingPage;
+    return {
+        currentUrl: ()=>page.url(),
+        baseUrl: ()=>void 0,
+        async goto (url, options) {
+            if ('commit' === options.waitUntil) throw new TypeError('Puppeteer does not support gotoUrl.waitUntil=commit; use domcontentloaded instead.');
+            const response = await page.goto(url, {
+                waitUntil: 'networkidle' === options.waitUntil ? 'networkidle0' : options.waitUntil,
+                timeout: options.timeoutMs
+            });
+            return {
+                status: response?.status() ?? null
+            };
+        },
+        title: ()=>page.title(),
+        setCookies: async (cookies)=>{
+            await page.setCookie(...cookies.map((cookie)=>cookie));
+        },
+        clearCookies: async (filters)=>{
+            const browserContext = page.browserContext();
+            const cookies = (await browserContext.cookies()).filter((cookie)=>(void 0 === filters.name || cookie.name === filters.name) && (void 0 === filters.domain || cookie.domain === filters.domain) && (void 0 === filters.path || cookie.path === filters.path));
+            if (cookies.length > 0) await browserContext.deleteCookie(...cookies);
+        },
+        setViewportSize: async (size)=>{
+            await page.setViewport(size);
+            const viewport = page.viewport();
+            if (!viewport) throw new Error('Puppeteer did not report an effective viewport size.');
+            return {
+                width: viewport.width,
+                height: viewport.height
+            };
+        }
+    };
+};
+const puppeteerTestDriverAdapter = {
+    requireAgent: requirePuppeteerAgent,
+    createDriver: createPuppeteerDriver,
+    getOptions: (agent)=>agent.testRunner
+};
+export { puppeteerTestDriverAdapter };
+
+//# sourceMappingURL=driver.mjs.map

package/dist/es/puppeteer/test-runner/driver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer/test-runner/driver.mjs","sources":["../../../../src/puppeteer/test-runner/driver.ts"],"sourcesContent":["import type {\n  WebTestDriver,\n  WebTestDriverAdapter,\n} from '@/common/test-runner/driver';\nimport type { CookieParam } from 'puppeteer';\nimport type {\n  PuppeteerTestRunnerAgent,\n  PuppeteerTestRunnerOptions,\n} from './types';\nimport { requirePuppeteerAgent } from './utils';\n\nconst createPuppeteerDriver = (\n  agent: PuppeteerTestRunnerAgent,\n): WebTestDriver => {\n  const page = agent.interface.underlyingPage;\n  return {\n    currentUrl: () => page.url(),\n    baseUrl: () => undefined,\n    async goto(url, options) {\n      if (options.waitUntil === 'commit') {\n        throw new TypeError(\n          'Puppeteer does not support gotoUrl.waitUntil=commit; use domcontentloaded instead.',\n        );\n      }\n      const response = await page.goto(url, {\n        waitUntil:\n          options.waitUntil === 'networkidle'\n            ? 'networkidle0'\n            : options.waitUntil,\n        timeout: options.timeoutMs,\n      });\n      return { status: response?.status() ?? null };\n    },\n    title: () => page.title(),\n    setCookies: async (cookies) => {\n      await page.setCookie(\n        ...cookies.map((cookie) => cookie as unknown as CookieParam),\n      );\n    },\n    clearCookies: async (filters) => {\n      const browserContext = page.browserContext();\n      const cookies = (await browserContext.cookies()).filter(\n        (cookie) =>\n          (filters.name === undefined || cookie.name === filters.name) &&\n          (filters.domain === undefined || cookie.domain === filters.domain) &&\n          (filters.path === undefined || cookie.path === filters.path),\n      );\n      if (cookies.length > 0) await browserContext.deleteCookie(...cookies);\n    },\n    setViewportSize: async (size) => {\n      await page.setViewport(size);\n      const viewport = page.viewport();\n      if (!viewport) {\n        throw new Error('Puppeteer did not report an effective viewport size.');\n      }\n      return { width: viewport.width, height: viewport.height };\n    },\n  };\n};\n\nexport const puppeteerTestDriverAdapter: WebTestDriverAdapter<\n  PuppeteerTestRunnerAgent,\n  PuppeteerTestRunnerOptions\n> = {\n  requireAgent: requirePuppeteerAgent,\n  createDriver: createPuppeteerDriver,\n  getOptions: (agent) => agent.testRunner,\n};\n"],"names":["createPuppeteerDriver","agent","page","undefined","url","options","TypeError","response","cookies","cookie","filters","browserContext","size","viewport","Error","puppeteerTestDriverAdapter","requirePuppeteerAgent"],"mappings":";AAWA,MAAMA,wBAAwB,CAC5BC;IAEA,MAAMC,OAAOD,MAAM,SAAS,CAAC,cAAc;IAC3C,OAAO;QACL,YAAY,IAAMC,KAAK,GAAG;QAC1B,SAAS,IAAMC;QACf,MAAM,MAAKC,GAAG,EAAEC,OAAO;YACrB,IAAIA,AAAsB,aAAtBA,QAAQ,SAAS,EACnB,MAAM,IAAIC,UACR;YAGJ,MAAMC,WAAW,MAAML,KAAK,IAAI,CAACE,KAAK;gBACpC,WACEC,AAAsB,kBAAtBA,QAAQ,SAAS,GACb,iBACAA,QAAQ,SAAS;gBACvB,SAASA,QAAQ,SAAS;YAC5B;YACA,OAAO;gBAAE,QAAQE,UAAU,YAAY;YAAK;QAC9C;QACA,OAAO,IAAML,KAAK,KAAK;QACvB,YAAY,OAAOM;YACjB,MAAMN,KAAK,SAAS,IACfM,QAAQ,GAAG,CAAC,CAACC,SAAWA;QAE/B;QACA,cAAc,OAAOC;YACnB,MAAMC,iBAAiBT,KAAK,cAAc;YAC1C,MAAMM,UAAW,OAAMG,eAAe,OAAO,EAAC,EAAG,MAAM,CACrD,CAACF,SACEC,AAAAA,CAAAA,AAAiBP,WAAjBO,QAAQ,IAAI,IAAkBD,OAAO,IAAI,KAAKC,QAAQ,IAAG,KACzDA,CAAAA,AAAmBP,WAAnBO,QAAQ,MAAM,IAAkBD,OAAO,MAAM,KAAKC,QAAQ,MAAK,KAC/DA,CAAAA,AAAiBP,WAAjBO,QAAQ,IAAI,IAAkBD,OAAO,IAAI,KAAKC,QAAQ,IAAG;YAE9D,IAAIF,QAAQ,MAAM,GAAG,GAAG,MAAMG,eAAe,YAAY,IAAIH;QAC/D;QACA,iBAAiB,OAAOI;YACtB,MAAMV,KAAK,WAAW,CAACU;YACvB,MAAMC,WAAWX,KAAK,QAAQ;YAC9B,IAAI,CAACW,UACH,MAAM,IAAIC,MAAM;YAElB,OAAO;gBAAE,OAAOD,SAAS,KAAK;gBAAE,QAAQA,SAAS,MAAM;YAAC;QAC1D;IACF;AACF;AAEO,MAAME,6BAGT;IACF,cAAcC;IACd,cAAchB;IACd,YAAY,CAACC,QAAUA,MAAM,UAAU;AACzC"}

package/dist/es/puppeteer/test-runner/index.mjs

@@ -0,0 +1,3 @@
+import { clearCookiesInputSchema, gotoUrlInputSchema, setCookiesInputSchema, setViewportSizeInputSchema } from "../../common/test-runner/nodes.mjs";
+import { puppeteerAgentTestRunnerNodeDefinitions } from "./agent-nodes.mjs";
+export { clearCookiesInputSchema, gotoUrlInputSchema, puppeteerAgentTestRunnerNodeDefinitions, setCookiesInputSchema, setViewportSizeInputSchema };

package/dist/es/puppeteer/test-runner/utils.mjs

@@ -0,0 +1,8 @@
+import { resolveWebUrl, throwIfAborted } from "../../common/test-runner/utils.mjs";
+const requirePuppeteerAgent = (agent)=>{
+    if (!agent || 'object' != typeof agent || !('interface' in agent) || !agent.interface || 'object' != typeof agent.interface || !('underlyingPage' in agent.interface) || !agent.interface.underlyingPage) throw new TypeError('getAgent() must return a Puppeteer Agent with an underlying Page.');
+    return agent;
+};
+export { requirePuppeteerAgent, resolveWebUrl, throwIfAborted };
+
+//# sourceMappingURL=utils.mjs.map

package/dist/es/puppeteer/test-runner/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer/test-runner/utils.mjs","sources":["../../../../src/puppeteer/test-runner/utils.ts"],"sourcesContent":["import type { PuppeteerTestRunnerAgent } from './types';\n\nexport { resolveWebUrl, throwIfAborted } from '../../common/test-runner/utils';\n\nexport const requirePuppeteerAgent = (\n  agent: unknown,\n): PuppeteerTestRunnerAgent => {\n  if (\n    !agent ||\n    typeof agent !== 'object' ||\n    !('interface' in agent) ||\n    !agent.interface ||\n    typeof agent.interface !== 'object' ||\n    !('underlyingPage' in agent.interface) ||\n    !agent.interface.underlyingPage\n  ) {\n    throw new TypeError(\n      'getAgent() must return a Puppeteer Agent with an underlying Page.',\n    );\n  }\n  return agent as PuppeteerTestRunnerAgent;\n};\n"],"names":["requirePuppeteerAgent","agent","TypeError"],"mappings":";AAIO,MAAMA,wBAAwB,CACnCC;IAEA,IACE,CAACA,SACD,AAAiB,YAAjB,OAAOA,SACP,CAAE,gBAAeA,KAAI,KACrB,CAACA,MAAM,SAAS,IAChB,AAA2B,YAA3B,OAAOA,MAAM,SAAS,IACtB,CAAE,qBAAoBA,MAAM,SAAQ,KACpC,CAACA,MAAM,SAAS,CAAC,cAAc,EAE/B,MAAM,IAAIC,UACR;IAGJ,OAAOD;AACT"}

package/dist/lib/agent-tools-puppeteer.js

@@ -51,6 +51,7 @@ const logger_namespaceObject = require("@midscene/shared/logger");
 const external_puppeteer_core_namespaceObject = require("puppeteer-core");
 var external_puppeteer_core_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_core_namespaceObject);
 const external_agent_init_args_js_namespaceObject = require("./agent-init-args.js");
+const persistent_puppeteer_viewport_js_namespaceObject = require("./common/persistent-puppeteer-viewport.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");
@@ -343,7 +344,7 @@ class WebPuppeteerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneT
         let page;
         if (navigateToUrl) {
             page = await browser.newPage();
-            if (this.viewport) await page.setViewport(this.viewport);
+            if (this.viewport) await (0, persistent_puppeteer_viewport_js_namespaceObject.setPersistentPuppeteerViewport)(page, this.viewport);
             await page.goto(navigateToUrl, {
                 timeout: 30000,
                 waitUntil: 'domcontentloaded'
@@ -354,7 +355,7 @@ class WebPuppeteerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneT
             const webPages = pages.filter((p)=>/^https?:\/\//.test(p.url()));
             page = matchedPage ?? (webPages.length > 0 ? webPages[webPages.length - 1] : pages[pages.length - 1] || await browser.newPage());
             if (reused) await page.bringToFront();
-            if (this.viewport) await page.setViewport(this.viewport);
+            if (this.viewport) await (0, persistent_puppeteer_viewport_js_namespaceObject.setPersistentPuppeteerViewport)(page, this.viewport);
         }
         const targetId = getTargetId(page);
         if (!targetId) throw new Error('Failed to persist Puppeteer page session because Puppeteer did not expose a Chrome targetId.');