@midscene/web 1.15.4-beta-20261013083552.0 → 1.15.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. package/dist/es/agent-tools-puppeteer.mjs +2 -3
  2. package/dist/es/agent-tools-puppeteer.mjs.map +1 -1
  3. package/dist/es/bridge-mode/io-client.mjs +1 -1
  4. package/dist/es/bridge-mode/io-server.mjs +2 -2
  5. package/dist/es/bridge-mode/io-server.mjs.map +1 -1
  6. package/dist/es/bridge-mode/page-browser-side.mjs +1 -1
  7. package/dist/es/bridge-mode/page-browser-side.mjs.map +1 -1
  8. package/dist/es/cli.mjs +1 -1
  9. package/dist/es/playwright/test-runner/agent-nodes.mjs +10 -3
  10. package/dist/es/playwright/test-runner/agent-nodes.mjs.map +1 -1
  11. package/dist/es/playwright/test-runner/clear-cookies.mjs +45 -0
  12. package/dist/es/playwright/test-runner/clear-cookies.mjs.map +1 -0
  13. package/dist/es/{common → playwright}/test-runner/cookies.mjs +79 -56
  14. package/dist/es/playwright/test-runner/cookies.mjs.map +1 -0
  15. package/dist/es/playwright/test-runner/goto-url.mjs +60 -0
  16. package/dist/es/playwright/test-runner/goto-url.mjs.map +1 -0
  17. package/dist/es/playwright/test-runner/index.mjs +4 -1
  18. package/dist/es/playwright/test-runner/utils.mjs +21 -1
  19. package/dist/es/playwright/test-runner/utils.mjs.map +1 -1
  20. package/dist/es/playwright/test-runner/viewport.mjs +35 -0
  21. package/dist/es/playwright/test-runner/viewport.mjs.map +1 -0
  22. package/dist/es/puppeteer/browser-agent.mjs +1 -9
  23. package/dist/es/puppeteer/browser-agent.mjs.map +1 -1
  24. package/dist/es/puppeteer/page-agent.mjs +1 -19
  25. package/dist/es/puppeteer/page-agent.mjs.map +1 -1
  26. package/dist/lib/agent-tools-puppeteer.js +2 -3
  27. package/dist/lib/agent-tools-puppeteer.js.map +1 -1
  28. package/dist/lib/bridge-mode/io-client.js +1 -1
  29. package/dist/lib/bridge-mode/io-server.js +2 -2
  30. package/dist/lib/bridge-mode/io-server.js.map +1 -1
  31. package/dist/lib/bridge-mode/page-browser-side.js +1 -1
  32. package/dist/lib/bridge-mode/page-browser-side.js.map +1 -1
  33. package/dist/lib/cli.js +1 -1
  34. package/dist/lib/playwright/test-runner/agent-nodes.js +10 -3
  35. package/dist/lib/playwright/test-runner/agent-nodes.js.map +1 -1
  36. package/dist/lib/playwright/test-runner/clear-cookies.js +82 -0
  37. package/dist/lib/playwright/test-runner/clear-cookies.js.map +1 -0
  38. package/dist/lib/{common → playwright}/test-runner/cookies.js +81 -58
  39. package/dist/lib/playwright/test-runner/cookies.js.map +1 -0
  40. package/dist/lib/playwright/test-runner/goto-url.js +97 -0
  41. package/dist/lib/playwright/test-runner/goto-url.js.map +1 -0
  42. package/dist/lib/playwright/test-runner/index.js +8 -5
  43. package/dist/lib/playwright/test-runner/utils.js +24 -4
  44. package/dist/lib/playwright/test-runner/utils.js.map +1 -1
  45. package/dist/lib/playwright/test-runner/viewport.js +72 -0
  46. package/dist/lib/playwright/test-runner/viewport.js.map +1 -0
  47. package/dist/lib/puppeteer/browser-agent.js +1 -9
  48. package/dist/lib/puppeteer/browser-agent.js.map +1 -1
  49. package/dist/lib/puppeteer/page-agent.js +1 -19
  50. package/dist/lib/puppeteer/page-agent.js.map +1 -1
  51. package/dist/types/agent-tools-puppeteer.d.ts.map +1 -1
  52. package/dist/types/playwright/test-runner/agent-nodes.d.ts +2 -1
  53. package/dist/types/playwright/test-runner/agent-nodes.d.ts.map +1 -1
  54. package/dist/types/playwright/test-runner/clear-cookies.d.ts +17 -0
  55. package/dist/types/playwright/test-runner/clear-cookies.d.ts.map +1 -0
  56. package/dist/types/playwright/test-runner/cookies.d.ts +33 -0
  57. package/dist/types/playwright/test-runner/cookies.d.ts.map +1 -0
  58. package/dist/types/playwright/test-runner/goto-url.d.ts +26 -0
  59. package/dist/types/playwright/test-runner/goto-url.d.ts.map +1 -0
  60. package/dist/types/playwright/test-runner/index.d.ts +8 -2
  61. package/dist/types/playwright/test-runner/index.d.ts.map +1 -1
  62. package/dist/types/playwright/test-runner/types.d.ts +14 -5
  63. package/dist/types/playwright/test-runner/types.d.ts.map +1 -1
  64. package/dist/types/playwright/test-runner/utils.d.ts +2 -1
  65. package/dist/types/playwright/test-runner/utils.d.ts.map +1 -1
  66. package/dist/types/playwright/test-runner/viewport.d.ts +14 -0
  67. package/dist/types/playwright/test-runner/viewport.d.ts.map +1 -0
  68. package/dist/types/puppeteer/browser-agent.d.ts +0 -5
  69. package/dist/types/puppeteer/browser-agent.d.ts.map +1 -1
  70. package/dist/types/puppeteer/index.d.ts +1 -1
  71. package/dist/types/puppeteer/index.d.ts.map +1 -1
  72. package/dist/types/puppeteer/page-agent.d.ts +1 -8
  73. package/dist/types/puppeteer/page-agent.d.ts.map +1 -1
  74. package/package.json +4 -9
  75. package/dist/es/common/persistent-puppeteer-viewport.mjs +0 -27
  76. package/dist/es/common/persistent-puppeteer-viewport.mjs.map +0 -1
  77. package/dist/es/common/test-runner/cookies.mjs.map +0 -1
  78. package/dist/es/common/test-runner/driver.mjs +0 -0
  79. package/dist/es/common/test-runner/nodes.mjs +0 -139
  80. package/dist/es/common/test-runner/nodes.mjs.map +0 -1
  81. package/dist/es/common/test-runner/utils.mjs +0 -24
  82. package/dist/es/common/test-runner/utils.mjs.map +0 -1
  83. package/dist/es/playwright/test-runner/driver.mjs +0 -42
  84. package/dist/es/playwright/test-runner/driver.mjs.map +0 -1
  85. package/dist/es/puppeteer/test-runner/agent-nodes.mjs +0 -6
  86. package/dist/es/puppeteer/test-runner/agent-nodes.mjs.map +0 -1
  87. package/dist/es/puppeteer/test-runner/driver.mjs +0 -44
  88. package/dist/es/puppeteer/test-runner/driver.mjs.map +0 -1
  89. package/dist/es/puppeteer/test-runner/index.mjs +0 -3
  90. package/dist/es/puppeteer/test-runner/types.mjs +0 -0
  91. package/dist/es/puppeteer/test-runner/utils.mjs +0 -8
  92. package/dist/es/puppeteer/test-runner/utils.mjs.map +0 -1
  93. package/dist/lib/common/persistent-puppeteer-viewport.js +0 -61
  94. package/dist/lib/common/persistent-puppeteer-viewport.js.map +0 -1
  95. package/dist/lib/common/test-runner/cookies.js.map +0 -1
  96. package/dist/lib/common/test-runner/driver.js +0 -20
  97. package/dist/lib/common/test-runner/driver.js.map +0 -1
  98. package/dist/lib/common/test-runner/nodes.js +0 -185
  99. package/dist/lib/common/test-runner/nodes.js.map +0 -1
  100. package/dist/lib/common/test-runner/utils.js +0 -61
  101. package/dist/lib/common/test-runner/utils.js.map +0 -1
  102. package/dist/lib/playwright/test-runner/driver.js +0 -76
  103. package/dist/lib/playwright/test-runner/driver.js.map +0 -1
  104. package/dist/lib/puppeteer/test-runner/agent-nodes.js +0 -40
  105. package/dist/lib/puppeteer/test-runner/agent-nodes.js.map +0 -1
  106. package/dist/lib/puppeteer/test-runner/driver.js +0 -78
  107. package/dist/lib/puppeteer/test-runner/driver.js.map +0 -1
  108. package/dist/lib/puppeteer/test-runner/index.js +0 -51
  109. package/dist/lib/puppeteer/test-runner/index.js.map +0 -1
  110. package/dist/lib/puppeteer/test-runner/types.js +0 -20
  111. package/dist/lib/puppeteer/test-runner/types.js.map +0 -1
  112. package/dist/lib/puppeteer/test-runner/utils.js +0 -48
  113. package/dist/lib/puppeteer/test-runner/utils.js.map +0 -1
  114. package/dist/types/common/persistent-puppeteer-viewport.d.ts +0 -5
  115. package/dist/types/common/persistent-puppeteer-viewport.d.ts.map +0 -1
  116. package/dist/types/common/test-runner/cookies.d.ts +0 -52
  117. package/dist/types/common/test-runner/cookies.d.ts.map +0 -1
  118. package/dist/types/common/test-runner/driver.d.ts +0 -38
  119. package/dist/types/common/test-runner/driver.d.ts.map +0 -1
  120. package/dist/types/common/test-runner/nodes.d.ts +0 -38
  121. package/dist/types/common/test-runner/nodes.d.ts.map +0 -1
  122. package/dist/types/common/test-runner/utils.d.ts +0 -3
  123. package/dist/types/common/test-runner/utils.d.ts.map +0 -1
  124. package/dist/types/playwright/test-runner/driver.d.ts +0 -4
  125. package/dist/types/playwright/test-runner/driver.d.ts.map +0 -1
  126. package/dist/types/puppeteer/test-runner/agent-nodes.d.ts +0 -2
  127. package/dist/types/puppeteer/test-runner/agent-nodes.d.ts.map +0 -1
  128. package/dist/types/puppeteer/test-runner/driver.d.ts +0 -4
  129. package/dist/types/puppeteer/test-runner/driver.d.ts.map +0 -1
  130. package/dist/types/puppeteer/test-runner/index.d.ts +0 -5
  131. package/dist/types/puppeteer/test-runner/index.d.ts.map +0 -1
  132. package/dist/types/puppeteer/test-runner/types.d.ts +0 -18
  133. package/dist/types/puppeteer/test-runner/types.d.ts.map +0 -1
  134. package/dist/types/puppeteer/test-runner/utils.d.ts +0 -4
  135. package/dist/types/puppeteer/test-runner/utils.d.ts.map +0 -1
@@ -1,11 +1,11 @@
1
1
  import { readFile } from "node:fs/promises";
2
2
  import { resolve } from "node:path";
3
3
  import { z } from "zod/v4";
4
- import { resolveWebUrl } from "./utils.mjs";
4
+ import { requirePlaywrightAgent, resolveWebUrl, throwIfAborted } from "./utils.mjs";
5
5
  const setCookiesInputSchema = z.strictObject({
6
- cookiesEnv: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).optional().describe('The environment variable containing a Cookie header, cookie array JSON, or browser storage-state JSON.'),
6
+ cookiesEnv: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).optional().describe('The environment variable containing a Cookie header, cookie array JSON, or Playwright storage-state JSON.'),
7
7
  profile: z.string().regex(/\S/).optional().describe('A cookie profile resolved by getCookieProfile().'),
8
- storageStatePath: z.string().regex(/\S/).optional().describe('A path to a browser storage-state JSON file.'),
8
+ storageStatePath: z.string().regex(/\S/).optional().describe('A path to a Playwright storage-state JSON file.'),
9
9
  url: z.string().url().optional().describe('The HTTP(S) URL used to scope Cookie-header values or cookies without domain/path.')
10
10
  }).superRefine((input, ctx)=>{
11
11
  const sourceCount = [
@@ -57,33 +57,7 @@ const parseCookieJson = (raw)=>{
57
57
  throw new TypeError('setCookies source must contain valid JSON or a Cookie header.');
58
58
  }
59
59
  };
60
- const normalizeCookie = (candidate, defaultUrl, index)=>{
61
- if (!candidate || 'object' != typeof candidate || Array.isArray(candidate)) throw new TypeError(`setCookies cookie at index ${index} must be an object.`);
62
- const cookie = candidate;
63
- if ('string' != typeof cookie.name || !cookie.name.trim()) throw new TypeError(`setCookies cookie at index ${index} requires a non-blank name.`);
64
- if ('string' != typeof cookie.value) throw new TypeError(`setCookies cookie at index ${index} requires a string value.`);
65
- const normalized = {
66
- ...cookie
67
- };
68
- const hasUrl = 'string' == typeof cookie.url && cookie.url.length > 0;
69
- const hasDomain = 'string' == typeof cookie.domain && cookie.domain.length > 0;
70
- if (!hasUrl && !hasDomain) {
71
- if (void 0 === defaultUrl) throw new TypeError(`setCookies cookie at index ${index} requires url or domain, or setCookies.url must be provided.`);
72
- normalized.url = defaultUrl;
73
- }
74
- if (hasDomain && 'string' != typeof cookie.path) normalized.path = '/';
75
- return normalized;
76
- };
77
- const normalizeCookies = (source, defaultUrl)=>{
78
- const candidates = Array.isArray(source) ? source : source && 'object' == typeof source && Array.isArray(source.cookies) ? source.cookies : void 0;
79
- if (!candidates) throw new TypeError('setCookies JSON must be a cookie array or an object with a cookies array.');
80
- if (0 === candidates.length) throw new TypeError('setCookies source contains no cookies.');
81
- return candidates.map((cookie, index)=>normalizeCookie(cookie, defaultUrl, index));
82
- };
83
- const resolveCookieInput = async (input, ctx, options)=>{
84
- const defaultUrl = void 0 === input.url ? void 0 : resolveWebUrl(input.url, void 0, 'setCookies.url');
85
- const reference = toCookieSourceReference(input);
86
- let source;
60
+ const resolveCookieSource = async (reference, defaultUrl, ctx, options)=>{
87
61
  switch(reference.kind){
88
62
  case 'env':
89
63
  {
@@ -96,44 +70,93 @@ const resolveCookieInput = async (input, ctx, options)=>{
96
70
  const raw = env[reference.name];
97
71
  if (!raw?.trim()) throw new Error(`Environment variable ${reference.name} is missing or blank.`);
98
72
  const trimmed = raw.trim();
99
- source = /^[\[{]/.test(trimmed) ? parseCookieJson(trimmed) : parseCookieHeader(trimmed, defaultUrl);
100
- break;
73
+ return {
74
+ reference,
75
+ cookies: /^[\[{]/.test(trimmed) ? parseCookieJson(trimmed) : parseCookieHeader(trimmed, defaultUrl)
76
+ };
101
77
  }
102
78
  case 'profile':
103
79
  if (!options.getCookieProfile) throw new Error('setCookies.profile requires a configured getCookieProfile callback.');
104
80
  try {
105
- source = await options.getCookieProfile({
106
- profile: reference.name,
107
- context: ctx.context,
108
- signal: ctx.signal
109
- });
81
+ return {
82
+ reference,
83
+ cookies: await options.getCookieProfile({
84
+ profile: reference.name,
85
+ context: ctx.context,
86
+ signal: ctx.signal
87
+ })
88
+ };
110
89
  } catch {
111
90
  throw new Error(`Failed to resolve cookie profile ${reference.name}; the original error was redacted because it may contain cookie values.`);
112
91
  }
113
- break;
114
92
  case 'storage-state':
115
93
  {
116
- let contents;
117
- try {
118
- const path = options.resolveStorageStatePath ? await options.resolveStorageStatePath(reference.name, ctx) : resolve(process.cwd(), reference.name);
119
- contents = await readFile(path, 'utf8');
120
- } catch {
121
- throw new Error(`Failed to read cookie storage state ${reference.name}; the original error was redacted because it may contain cookie values.`);
122
- }
123
- source = parseCookieJson(contents);
124
- break;
94
+ const path = options.resolveStorageStatePath ? await options.resolveStorageStatePath(reference.name, ctx) : resolve(process.cwd(), reference.name);
95
+ return {
96
+ reference,
97
+ cookies: parseCookieJson(await readFile(path, 'utf8'))
98
+ };
125
99
  }
126
100
  }
127
- const cookies = normalizeCookies(source, defaultUrl);
128
- return {
129
- cookies,
130
- result: {
131
- source: reference.kind,
132
- sourceName: reference.name,
133
- count: cookies.length
134
- }
101
+ };
102
+ const normalizeCookie = (candidate, defaultUrl, index)=>{
103
+ if (!candidate || 'object' != typeof candidate || Array.isArray(candidate)) throw new TypeError(`setCookies cookie at index ${index} must be an object.`);
104
+ const cookie = candidate;
105
+ if ('string' != typeof cookie.name || !cookie.name.trim()) throw new TypeError(`setCookies cookie at index ${index} requires a non-blank name.`);
106
+ if ('string' != typeof cookie.value) throw new TypeError(`setCookies cookie at index ${index} requires a string value.`);
107
+ const normalized = {
108
+ ...cookie
135
109
  };
110
+ const hasUrl = 'string' == typeof cookie.url && cookie.url.length > 0;
111
+ const hasDomain = 'string' == typeof cookie.domain && cookie.domain.length > 0;
112
+ if (!hasUrl && !hasDomain) {
113
+ if (void 0 === defaultUrl) throw new TypeError(`setCookies cookie at index ${index} requires url or domain, or setCookies.url must be provided.`);
114
+ normalized.url = defaultUrl;
115
+ }
116
+ if (hasDomain && 'string' != typeof cookie.path) normalized.path = '/';
117
+ return normalized;
118
+ };
119
+ const normalizeCookies = (source, defaultUrl)=>{
120
+ const candidates = Array.isArray(source) ? source : source && 'object' == typeof source && Array.isArray(source.cookies) ? source.cookies : void 0;
121
+ if (!candidates) throw new TypeError('setCookies JSON must be a cookie array or an object with a cookies array.');
122
+ if (0 === candidates.length) throw new TypeError('setCookies source contains no cookies.');
123
+ return candidates.map((cookie, index)=>normalizeCookie(cookie, defaultUrl, index));
124
+ };
125
+ const setCookiesNode = {
126
+ name: 'setCookies',
127
+ title: 'Set browser cookies',
128
+ description: 'Load cookies from an environment variable, configured profile, or Playwright storage-state file without persisting cookie values in workflow input or output.',
129
+ stringInputKey: false,
130
+ inputSchema: setCookiesInputSchema,
131
+ async execute (agent, input, executionContext) {
132
+ const ctx = {
133
+ ...executionContext,
134
+ input,
135
+ context: requirePlaywrightAgent(agent)
136
+ };
137
+ throwIfAborted(ctx.signal, 'setCookies');
138
+ const page = ctx.context.interface.underlyingPage;
139
+ const defaultUrl = void 0 === ctx.input.url ? void 0 : resolveWebUrl(ctx.input.url, void 0, 'setCookies.url');
140
+ const reference = toCookieSourceReference(ctx.input);
141
+ const resolved = await resolveCookieSource(reference, defaultUrl, ctx, ctx.context.testRunner ?? {});
142
+ const cookies = normalizeCookies(resolved.cookies, defaultUrl);
143
+ throwIfAborted(ctx.signal, 'setCookies');
144
+ try {
145
+ await page.context().addCookies(cookies);
146
+ } catch {
147
+ throw new Error(`Failed to set ${cookies.length} browser cookie(s); the browser error was redacted because it may contain cookie values.`);
148
+ }
149
+ const result = {
150
+ source: resolved.reference.kind,
151
+ sourceName: resolved.reference.name,
152
+ count: cookies.length
153
+ };
154
+ return {
155
+ summary: `Set ${result.count} browser cookie(s) from ${result.source} source ${result.sourceName}`,
156
+ data: result
157
+ };
158
+ }
136
159
  };
137
- export { resolveCookieInput, setCookiesInputSchema };
160
+ export { setCookiesInputSchema, setCookiesNode };
138
161
 
139
162
  //# sourceMappingURL=cookies.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright/test-runner/cookies.mjs","sources":["../../../../src/playwright/test-runner/cookies.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { z } from 'zod/v4';\nimport type {\n PlaywrightCookie,\n PlaywrightNodeContext,\n PlaywrightTestRunnerAgent,\n PlaywrightTestRunnerOptions,\n} from './types';\nimport { requirePlaywrightAgent, resolveWebUrl, throwIfAborted } from './utils';\n\ntype CookieSourceReference =\n | { kind: 'env'; name: string }\n | { kind: 'profile'; name: string }\n | { kind: 'storage-state'; name: string };\n\ninterface ResolvedCookieSource {\n reference: CookieSourceReference;\n cookies: unknown;\n}\n\n/** Input schema for the Playwright setCookies Node. */\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 Playwright 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 Playwright 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\n/** Validated input accepted by the Playwright setCookies Node. */\nexport type SetCookiesNodeInput = z.infer<typeof setCookiesInputSchema>;\n\n/** Secret-free metadata returned by the Playwright setCookies Node. */\nexport interface SetCookiesNodeResult {\n /** Kind of configured reference used to resolve the cookies. */\n source: CookieSourceReference['kind'];\n /** Environment variable, profile, or storage-state reference name. */\n sourceName: string;\n /** Number of cookies passed to the BrowserContext. */\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 PlaywrightCookie;\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 resolveCookieSource = async (\n reference: CookieSourceReference,\n defaultUrl: string | undefined,\n ctx: PlaywrightNodeContext<PlaywrightTestRunnerAgent>,\n options: PlaywrightTestRunnerOptions,\n): Promise<ResolvedCookieSource> => {\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 return {\n reference,\n cookies: /^[\\[{]/.test(trimmed)\n ? parseCookieJson(trimmed)\n : parseCookieHeader(trimmed, defaultUrl),\n };\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 return {\n reference,\n cookies: await options.getCookieProfile({\n profile: reference.name,\n context: ctx.context,\n signal: ctx.signal,\n }),\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 }\n case 'storage-state': {\n const path = options.resolveStorageStatePath\n ? await options.resolveStorageStatePath(reference.name, ctx)\n : resolve(process.cwd(), reference.name);\n return {\n reference,\n cookies: parseCookieJson(await readFile(path, 'utf8')),\n };\n }\n }\n};\n\nconst normalizeCookie = (\n candidate: unknown,\n defaultUrl: string | undefined,\n index: number,\n): PlaywrightCookie => {\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 unknown as PlaywrightCookie;\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') {\n normalized.path = '/';\n }\n return normalized;\n};\n\nconst normalizeCookies = (\n source: unknown,\n defaultUrl: string | undefined,\n): PlaywrightCookie[] => {\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 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 Playwright 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 ctx = {\n ...executionContext,\n input,\n context: requirePlaywrightAgent(agent),\n };\n throwIfAborted(ctx.signal, 'setCookies');\n const page = ctx.context.interface.underlyingPage;\n const defaultUrl =\n ctx.input.url === undefined\n ? undefined\n : resolveWebUrl(ctx.input.url, undefined, 'setCookies.url');\n const reference = toCookieSourceReference(ctx.input);\n const resolved = await resolveCookieSource(\n reference,\n defaultUrl,\n ctx,\n ctx.context.testRunner ?? {},\n );\n const cookies = normalizeCookies(resolved.cookies, defaultUrl);\n\n throwIfAborted(ctx.signal, 'setCookies');\n try {\n await page.context().addCookies(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\n const result: SetCookiesNodeResult = {\n source: resolved.reference.kind,\n sourceName: resolved.reference.name,\n count: cookies.length,\n };\n return {\n summary: `Set ${result.count} browser cookie(s) from ${result.source} source ${result.sourceName}`,\n data: result,\n };\n },\n};\n"],"names":["setCookiesInputSchema","z","input","ctx","sourceCount","value","undefined","toCookieSourceReference","TypeError","parseCookieHeader","raw","url","segments","segment","Boolean","separator","name","parseCookieJson","JSON","resolveCookieSource","reference","defaultUrl","options","env","process","Error","trimmed","path","resolve","readFile","normalizeCookie","candidate","index","Array","cookie","normalized","hasUrl","hasDomain","normalizeCookies","source","candidates","setCookiesNode","agent","executionContext","requirePlaywrightAgent","throwIfAborted","page","resolveWebUrl","resolved","cookies","result"],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import { z } from "zod/v4";
2
+ import { requirePlaywrightAgent, resolveWebUrl, throwIfAborted } from "./utils.mjs";
3
+ const DEFAULT_NAVIGATION_TIMEOUT_MS = 60000;
4
+ const DEFAULT_WAIT_UNTIL = 'domcontentloaded';
5
+ const gotoUrlInputSchema = z.strictObject({
6
+ url: z.string().min(1).describe('An absolute HTTP(S) URL or a path relative to Playwright baseURL or the current page URL.'),
7
+ waitUntil: z["enum"]([
8
+ 'commit',
9
+ 'domcontentloaded',
10
+ 'load',
11
+ 'networkidle'
12
+ ]).default(DEFAULT_WAIT_UNTIL).describe('The Playwright navigation lifecycle event to wait for.'),
13
+ timeoutMs: z.number().positive().default(DEFAULT_NAVIGATION_TIMEOUT_MS).describe('The navigation timeout in milliseconds.')
14
+ });
15
+ const resolveNavigationUrl = (target, page)=>{
16
+ const trimmed = target.trim();
17
+ if (!trimmed) throw new TypeError('gotoUrl.url must not be blank.');
18
+ if (/^[a-z][a-z\d+.-]*:/i.test(trimmed)) return resolveWebUrl(trimmed, void 0, 'gotoUrl.url');
19
+ const context = page.context();
20
+ const configuredBase = context._options?.baseURL;
21
+ if (void 0 !== configuredBase) return resolveWebUrl(trimmed, configuredBase, 'gotoUrl.url');
22
+ const currentUrl = page.url();
23
+ 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 Playwright baseURL.`);
24
+ return resolveWebUrl(trimmed, currentUrl, 'gotoUrl.url');
25
+ };
26
+ const gotoUrlNode = {
27
+ name: 'gotoUrl',
28
+ title: 'Open a Web URL',
29
+ description: 'Navigate the current Playwright Page to an absolute HTTP(S) URL or a path relative to Playwright baseURL or the current page URL.',
30
+ stringInputKey: 'url',
31
+ inputSchema: gotoUrlInputSchema,
32
+ async execute (agent, input, executionContext) {
33
+ const ctx = {
34
+ ...executionContext,
35
+ input,
36
+ context: requirePlaywrightAgent(agent)
37
+ };
38
+ throwIfAborted(ctx.signal, 'gotoUrl');
39
+ const page = ctx.context.interface.underlyingPage;
40
+ const url = resolveNavigationUrl(ctx.input.url, page);
41
+ const response = await page.goto(url, {
42
+ waitUntil: ctx.input.waitUntil,
43
+ timeout: ctx.input.timeoutMs
44
+ });
45
+ throwIfAborted(ctx.signal, 'gotoUrl');
46
+ const status = response?.status() ?? null;
47
+ const result = {
48
+ url: page.url(),
49
+ status,
50
+ title: await page.title()
51
+ };
52
+ return {
53
+ summary: `Navigated to ${result.url}`,
54
+ data: result
55
+ };
56
+ }
57
+ };
58
+ export { gotoUrlInputSchema, gotoUrlNode };
59
+
60
+ //# sourceMappingURL=goto-url.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright/test-runner/goto-url.mjs","sources":["../../../../src/playwright/test-runner/goto-url.ts"],"sourcesContent":["import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport type { BrowserContext, Page } from 'playwright';\nimport { z } from 'zod/v4';\nimport { requirePlaywrightAgent, resolveWebUrl, throwIfAborted } from './utils';\n\nconst DEFAULT_NAVIGATION_TIMEOUT_MS = 60_000;\nconst DEFAULT_WAIT_UNTIL = 'domcontentloaded' as const;\n\n/** Input schema for the Playwright gotoUrl Node. */\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 Playwright baseURL or the current page URL.',\n ),\n waitUntil: z\n .enum(['commit', 'domcontentloaded', 'load', 'networkidle'])\n .default(DEFAULT_WAIT_UNTIL)\n .describe('The Playwright navigation lifecycle event to wait for.'),\n timeoutMs: z\n .number()\n .positive()\n .default(DEFAULT_NAVIGATION_TIMEOUT_MS)\n .describe('The navigation timeout in milliseconds.'),\n});\n\n/** Validated input accepted by the Playwright gotoUrl Node. */\nexport type GotoUrlNodeInput = z.infer<typeof gotoUrlInputSchema>;\n\n/** Structured navigation details returned by the Playwright gotoUrl Node. */\nexport interface GotoUrlNodeResult {\n /** Final Page URL after navigation and redirects. */\n url: string;\n /** Main-resource HTTP status, or null when Playwright returns no response. */\n status: number | null;\n /** Document title after navigation completes. */\n title: string;\n}\n\nconst resolveNavigationUrl = (target: string, page: Page): string => {\n const trimmed = target.trim();\n if (!trimmed) throw new TypeError('gotoUrl.url must not be blank.');\n // Absolute URLs do not depend on either configured or current-page bases.\n if (/^[a-z][a-z\\d+.-]*:/i.test(trimmed)) {\n return resolveWebUrl(trimmed, undefined, 'gotoUrl.url');\n }\n\n // Playwright has no public baseURL getter. Its BrowserContext stores the\n // configured value in _options; keep this internal access localized here.\n const context = page.context() as BrowserContext & {\n _options?: { baseURL?: string };\n };\n const configuredBase = context._options?.baseURL;\n if (configuredBase !== undefined) {\n return resolveWebUrl(trimmed, configuredBase, 'gotoUrl.url');\n }\n\n const currentUrl = page.url();\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 Playwright baseURL.`,\n );\n }\n return resolveWebUrl(trimmed, currentUrl, 'gotoUrl.url');\n};\n\nexport 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 Playwright Page to an absolute HTTP(S) URL or a path relative to Playwright baseURL or the current page URL.',\n stringInputKey: 'url',\n inputSchema: gotoUrlInputSchema,\n async execute(agent, input, executionContext) {\n const ctx = {\n ...executionContext,\n input,\n context: requirePlaywrightAgent(agent),\n };\n throwIfAborted(ctx.signal, 'gotoUrl');\n const page = ctx.context.interface.underlyingPage;\n const url = resolveNavigationUrl(ctx.input.url, page);\n const response = await page.goto(url, {\n waitUntil: ctx.input.waitUntil,\n timeout: ctx.input.timeoutMs,\n });\n throwIfAborted(ctx.signal, 'gotoUrl');\n const status = response?.status() ?? null;\n const result = {\n url: page.url(),\n status,\n title: await page.title(),\n };\n return { summary: `Navigated to ${result.url}`, data: result };\n },\n};\n"],"names":["DEFAULT_NAVIGATION_TIMEOUT_MS","DEFAULT_WAIT_UNTIL","gotoUrlInputSchema","z","resolveNavigationUrl","target","page","trimmed","TypeError","resolveWebUrl","undefined","context","configuredBase","currentUrl","JSON","gotoUrlNode","agent","input","executionContext","ctx","requirePlaywrightAgent","throwIfAborted","url","response","status","result"],"mappings":";;AAKA,MAAMA,gCAAgC;AACtC,MAAMC,qBAAqB;AAGpB,MAAMC,qBAAqBC,EAAE,YAAY,CAAC;IAC/C,KAAKA,EAAAA,MACI,GACN,GAAG,CAAC,GACJ,QAAQ,CACP;IAEJ,WAAWA,CAAC,CAADA,OACJ,CAAC;QAAC;QAAU;QAAoB;QAAQ;KAAc,EAC1D,OAAO,CAACF,oBACR,QAAQ,CAAC;IACZ,WAAWE,EAAAA,MACF,GACN,QAAQ,GACR,OAAO,CAACH,+BACR,QAAQ,CAAC;AACd;AAeA,MAAMI,uBAAuB,CAACC,QAAgBC;IAC5C,MAAMC,UAAUF,OAAO,IAAI;IAC3B,IAAI,CAACE,SAAS,MAAM,IAAIC,UAAU;IAElC,IAAI,sBAAsB,IAAI,CAACD,UAC7B,OAAOE,cAAcF,SAASG,QAAW;IAK3C,MAAMC,UAAUL,KAAK,OAAO;IAG5B,MAAMM,iBAAiBD,QAAQ,QAAQ,EAAE;IACzC,IAAIC,AAAmBF,WAAnBE,gBACF,OAAOH,cAAcF,SAASK,gBAAgB;IAGhD,MAAMC,aAAaP,KAAK,GAAG;IAC3B,IAAI,CAAC,gBAAgB,IAAI,CAACO,aACxB,MAAM,IAAIL,UACR,CAAC,+CAA+C,EAAEM,KAAK,SAAS,CAACD,YAAY,uFAAuF,CAAC;IAGzK,OAAOJ,cAAcF,SAASM,YAAY;AAC5C;AAEO,MAAME,cAGT;IACF,MAAM;IACN,OAAO;IACP,aACE;IACF,gBAAgB;IAChB,aAAab;IACb,MAAM,SAAQc,KAAK,EAAEC,KAAK,EAAEC,gBAAgB;QAC1C,MAAMC,MAAM;YACV,GAAGD,gBAAgB;YACnBD;YACA,SAASG,uBAAuBJ;QAClC;QACAK,eAAeF,IAAI,MAAM,EAAE;QAC3B,MAAMb,OAAOa,IAAI,OAAO,CAAC,SAAS,CAAC,cAAc;QACjD,MAAMG,MAAMlB,qBAAqBe,IAAI,KAAK,CAAC,GAAG,EAAEb;QAChD,MAAMiB,WAAW,MAAMjB,KAAK,IAAI,CAACgB,KAAK;YACpC,WAAWH,IAAI,KAAK,CAAC,SAAS;YAC9B,SAASA,IAAI,KAAK,CAAC,SAAS;QAC9B;QACAE,eAAeF,IAAI,MAAM,EAAE;QAC3B,MAAMK,SAASD,UAAU,YAAY;QACrC,MAAME,SAAS;YACb,KAAKnB,KAAK,GAAG;YACbkB;YACA,OAAO,MAAMlB,KAAK,KAAK;QACzB;QACA,OAAO;YAAE,SAAS,CAAC,aAAa,EAAEmB,OAAO,GAAG,EAAE;YAAE,MAAMA;QAAO;IAC/D;AACF"}
@@ -1,3 +1,6 @@
1
- import { clearCookiesInputSchema, gotoUrlInputSchema, setCookiesInputSchema, setViewportSizeInputSchema } from "../../common/test-runner/nodes.mjs";
1
+ import { clearCookiesInputSchema } from "./clear-cookies.mjs";
2
+ import { setCookiesInputSchema } from "./cookies.mjs";
3
+ import { gotoUrlInputSchema } from "./goto-url.mjs";
4
+ import { setViewportSizeInputSchema } from "./viewport.mjs";
2
5
  import { playwrightAgentTestRunnerNodeDefinitions } from "./agent-nodes.mjs";
3
6
  export { clearCookiesInputSchema, gotoUrlInputSchema, playwrightAgentTestRunnerNodeDefinitions, setCookiesInputSchema, setViewportSizeInputSchema };
@@ -1,4 +1,24 @@
1
- import { resolveWebUrl, throwIfAborted } from "../../common/test-runner/utils.mjs";
1
+ const SUPPORTED_WEB_PROTOCOLS = new Set([
2
+ 'http:',
3
+ 'https:'
4
+ ]);
5
+ const throwIfAborted = (signal, operation)=>{
6
+ if (signal.aborted) throw signal.reason ?? new Error(`${operation} aborted.`);
7
+ };
8
+ const resolveWebUrl = (target, baseUrl, label)=>{
9
+ const trimmed = target.trim();
10
+ if (!trimmed) throw new TypeError(`${label} must not be blank.`);
11
+ let resolved;
12
+ try {
13
+ resolved = void 0 === baseUrl ? new URL(trimmed) : new URL(trimmed, baseUrl);
14
+ } catch (error) {
15
+ throw new TypeError(void 0 === baseUrl ? `${label} must be an absolute HTTP(S) URL.` : `${label} is not a valid URL.`, {
16
+ cause: error
17
+ });
18
+ }
19
+ if (!SUPPORTED_WEB_PROTOCOLS.has(resolved.protocol)) throw new TypeError(`${label} does not support the ${resolved.protocol} protocol.`);
20
+ return resolved.toString();
21
+ };
2
22
  const requirePlaywrightAgent = (agent)=>{
3
23
  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.');
4
24
  return agent;
@@ -1 +1 @@
1
- {"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"}
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"}
@@ -0,0 +1,35 @@
1
+ import { z } from "zod/v4";
2
+ import { requirePlaywrightAgent, throwIfAborted } from "./utils.mjs";
3
+ const setViewportSizeInputSchema = z.strictObject({
4
+ width: z.number().int().positive().describe('Viewport width in CSS pixels.'),
5
+ height: z.number().int().positive().describe('Viewport height in CSS pixels.')
6
+ });
7
+ const setViewportSizeNode = {
8
+ name: 'setViewportSize',
9
+ title: 'Set the browser viewport size',
10
+ description: 'Set the current Playwright Page viewport size in CSS pixels and return the effective size.',
11
+ stringInputKey: false,
12
+ inputSchema: setViewportSizeInputSchema,
13
+ async execute (agent, input, executionContext) {
14
+ const ctx = {
15
+ ...executionContext,
16
+ input,
17
+ context: requirePlaywrightAgent(agent)
18
+ };
19
+ throwIfAborted(ctx.signal, 'setViewportSize');
20
+ const page = ctx.context.interface.underlyingPage;
21
+ await page.setViewportSize({
22
+ width: ctx.input.width,
23
+ height: ctx.input.height
24
+ });
25
+ const viewport = page.viewportSize();
26
+ if (!viewport) throw new Error('Playwright did not report an effective viewport size.');
27
+ return {
28
+ summary: `Set viewport to ${viewport.width}x${viewport.height}`,
29
+ data: viewport
30
+ };
31
+ }
32
+ };
33
+ export { setViewportSizeInputSchema, setViewportSizeNode };
34
+
35
+ //# sourceMappingURL=viewport.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright/test-runner/viewport.mjs","sources":["../../../../src/playwright/test-runner/viewport.ts"],"sourcesContent":["import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { z } from 'zod/v4';\nimport { requirePlaywrightAgent, throwIfAborted } from './utils';\n\n/** Input schema for the Playwright setViewportSize Node. */\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\n/** Validated input accepted by the Playwright setViewportSize Node. */\nexport type SetViewportSizeNodeInput = z.infer<\n typeof setViewportSizeInputSchema\n>;\n\nexport const setViewportSizeNode: AgentTestRunnerNodeDefinition<\n z.output<typeof setViewportSizeInputSchema>,\n { width: number; height: number }\n> = {\n name: 'setViewportSize',\n title: 'Set the browser viewport size',\n description:\n 'Set the current Playwright 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 ctx = {\n ...executionContext,\n input,\n context: requirePlaywrightAgent(agent),\n };\n throwIfAborted(ctx.signal, 'setViewportSize');\n const page = ctx.context.interface.underlyingPage;\n await page.setViewportSize({\n width: ctx.input.width,\n height: ctx.input.height,\n });\n const viewport = page.viewportSize();\n if (!viewport) {\n throw new Error('Playwright did not report an effective viewport size.');\n }\n return {\n summary: `Set viewport to ${viewport.width}x${viewport.height}`,\n data: viewport,\n };\n },\n};\n"],"names":["setViewportSizeInputSchema","z","setViewportSizeNode","agent","input","executionContext","ctx","requirePlaywrightAgent","throwIfAborted","page","viewport","Error"],"mappings":";;AAKO,MAAMA,6BAA6BC,EAAE,YAAY,CAAC;IACvD,OAAOA,EAAE,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,QAAQA,EAAAA,MACC,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;AACd;AAOO,MAAMC,sBAGT;IACF,MAAM;IACN,OAAO;IACP,aACE;IACF,gBAAgB;IAChB,aAAaF;IACb,MAAM,SAAQG,KAAK,EAAEC,KAAK,EAAEC,gBAAgB;QAC1C,MAAMC,MAAM;YACV,GAAGD,gBAAgB;YACnBD;YACA,SAASG,uBAAuBJ;QAClC;QACAK,eAAeF,IAAI,MAAM,EAAE;QAC3B,MAAMG,OAAOH,IAAI,OAAO,CAAC,SAAS,CAAC,cAAc;QACjD,MAAMG,KAAK,eAAe,CAAC;YACzB,OAAOH,IAAI,KAAK,CAAC,KAAK;YACtB,QAAQA,IAAI,KAAK,CAAC,MAAM;QAC1B;QACA,MAAMI,WAAWD,KAAK,YAAY;QAClC,IAAI,CAACC,UACH,MAAM,IAAIC,MAAM;QAElB,OAAO;YACL,SAAS,CAAC,gBAAgB,EAAED,SAAS,KAAK,CAAC,CAAC,EAAEA,SAAS,MAAM,EAAE;YAC/D,MAAMA;QACR;IACF;AACF"}
@@ -4,7 +4,6 @@ import { appendBrowserAgentPageActions, createBrowserAgentPageActions } from "..
4
4
  import { getDebug } from "@midscene/shared/logger";
5
5
  import { createPuppeteerBrowserPageManager } from "./browser-page-manager.mjs";
6
6
  import { PuppeteerWebPage } from "./page.mjs";
7
- import { puppeteerAgentTestRunnerNodeDefinitions } from "./test-runner/agent-nodes.mjs";
8
7
  function _define_property(obj, key, value) {
9
8
  if (key in obj) Object.defineProperty(obj, key, {
10
9
  value: value,
@@ -17,12 +16,6 @@ function _define_property(obj, key, value) {
17
16
  }
18
17
  const debug = getDebug('puppeteer:browser-agent');
19
18
  class PuppeteerBrowserAgent extends WebAgentCore {
20
- static getTestRunnerNodeDefinitions() {
21
- return [
22
- ...WebAgentCore.getTestRunnerNodeDefinitions(),
23
- ...puppeteerAgentTestRunnerNodeDefinitions
24
- ];
25
- }
26
19
  static async create(browser, opts) {
27
20
  const { initialPage, ...agentOpts } = opts ?? {};
28
21
  const page = initialPage ?? (await browser.pages())[0] ?? await browser.newPage();
@@ -74,8 +67,7 @@ class PuppeteerBrowserAgent extends WebAgentCore {
74
67
  debug,
75
68
  pageScope
76
69
  });
77
- super(webPage, agentOpts), _define_property(this, "testRunner", void 0), _define_property(this, "pageManager", void 0);
78
- this.testRunner = opts?.testRunner;
70
+ super(webPage, agentOpts), _define_property(this, "pageManager", void 0);
79
71
  this.pageManager = pageManager;
80
72
  applyForceChromeSelectRendering(initialPage, 'puppeteer', forceChromeSelectRendering);
81
73
  }
@@ -1 +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 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"}
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"}
@@ -3,30 +3,12 @@ import { applyForceChromeSelectRendering } from "../common/browser-agent-utils.m
3
3
  import { getDebug } from "@midscene/shared/logger";
4
4
  import { forceClosePopup } from "./base-page.mjs";
5
5
  import { PuppeteerWebPage } from "./page.mjs";
6
- import { puppeteerAgentTestRunnerNodeDefinitions } from "./test-runner/agent-nodes.mjs";
7
- function _define_property(obj, key, value) {
8
- if (key in obj) Object.defineProperty(obj, key, {
9
- value: value,
10
- enumerable: true,
11
- configurable: true,
12
- writable: true
13
- });
14
- else obj[key] = value;
15
- return obj;
16
- }
17
6
  const debug = getDebug('puppeteer:agent');
18
7
  class PuppeteerPageAgent extends WebAgentCore {
19
- static getTestRunnerNodeDefinitions() {
20
- return [
21
- ...WebAgentCore.getTestRunnerNodeDefinitions(),
22
- ...puppeteerAgentTestRunnerNodeDefinitions
23
- ];
24
- }
25
8
  constructor(page, opts){
26
9
  if (!page) throw new Error('[midscene] PuppeteerPageAgent requires a valid Puppeteer page instance. Please make sure to pass a valid page object.');
27
10
  const webPage = new PuppeteerWebPage(page, opts);
28
- super(webPage, opts), _define_property(this, "testRunner", void 0);
29
- this.testRunner = opts?.testRunner;
11
+ super(webPage, opts);
30
12
  const { forceSameTabNavigation, forceChromeSelectRendering } = opts ?? {};
31
13
  const runtimeOptions = resolveBrowserAgentRuntimeOptions({
32
14
  agentName: 'PuppeteerPageAgent',
@@ -1 +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 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"}
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"}
@@ -51,7 +51,6 @@ const logger_namespaceObject = require("@midscene/shared/logger");
51
51
  const external_puppeteer_core_namespaceObject = require("puppeteer-core");
52
52
  var external_puppeteer_core_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_core_namespaceObject);
53
53
  const external_agent_init_args_js_namespaceObject = require("./agent-init-args.js");
54
- const persistent_puppeteer_viewport_js_namespaceObject = require("./common/persistent-puppeteer-viewport.js");
55
54
  const viewport_js_namespaceObject = require("./common/viewport.js");
56
55
  const index_js_namespaceObject = require("./puppeteer/index.js");
57
56
  const external_static_index_js_namespaceObject = require("./static/index.js");
@@ -344,7 +343,7 @@ class WebPuppeteerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneT
344
343
  let page;
345
344
  if (navigateToUrl) {
346
345
  page = await browser.newPage();
347
- if (this.viewport) await (0, persistent_puppeteer_viewport_js_namespaceObject.setPersistentPuppeteerViewport)(page, this.viewport);
346
+ if (this.viewport) await page.setViewport(this.viewport);
348
347
  await page.goto(navigateToUrl, {
349
348
  timeout: 30000,
350
349
  waitUntil: 'domcontentloaded'
@@ -355,7 +354,7 @@ class WebPuppeteerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneT
355
354
  const webPages = pages.filter((p)=>/^https?:\/\//.test(p.url()));
356
355
  page = matchedPage ?? (webPages.length > 0 ? webPages[webPages.length - 1] : pages[pages.length - 1] || await browser.newPage());
357
356
  if (reused) await page.bringToFront();
358
- if (this.viewport) await (0, persistent_puppeteer_viewport_js_namespaceObject.setPersistentPuppeteerViewport)(page, this.viewport);
357
+ if (this.viewport) await page.setViewport(this.viewport);
359
358
  }
360
359
  const targetId = getTargetId(page);
361
360
  if (!targetId) throw new Error('Failed to persist Puppeteer page session because Puppeteer did not expose a Chrome targetId.');