@midscene/web 1.12.8 → 1.12.9-beta-20260917120835.0

package/dist/lib/puppeteer/test-runner/utils.js

@@ -0,0 +1,48 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    resolveWebUrl: ()=>utils_js_namespaceObject.resolveWebUrl,
+    throwIfAborted: ()=>utils_js_namespaceObject.throwIfAborted,
+    requirePuppeteerAgent: ()=>requirePuppeteerAgent
+});
+const utils_js_namespaceObject = require("../../common/test-runner/utils.js");
+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;
+};
+exports.requirePuppeteerAgent = __webpack_exports__.requirePuppeteerAgent;
+exports.resolveWebUrl = __webpack_exports__.resolveWebUrl;
+exports.throwIfAborted = __webpack_exports__.throwIfAborted;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "requirePuppeteerAgent",
+    "resolveWebUrl",
+    "throwIfAborted"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=utils.js.map

package/dist/lib/puppeteer/test-runner/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer/test-runner/utils.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../../src/puppeteer/test-runner/utils.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import 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":["__webpack_require__","definition","key","Object","obj","prop","Symbol","requirePuppeteerAgent","agent","TypeError"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;ACFO,MAAMI,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/puppeteer/test-runner/viewport.js

@@ -0,0 +1,76 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    setViewportSizeInputSchema: ()=>setViewportSizeInputSchema,
+    setViewportSizeNode: ()=>setViewportSizeNode
+});
+const v4_namespaceObject = require("zod/v4");
+const external_utils_js_namespaceObject = require("./utils.js");
+const setViewportSizeInputSchema = v4_namespaceObject.z.strictObject({
+    width: v4_namespaceObject.z.number().int().positive().describe('Viewport width in CSS pixels.'),
+    height: v4_namespaceObject.z.number().int().positive().describe('Viewport height in CSS pixels.')
+});
+const setViewportSizeNode = {
+    name: 'setViewportSize',
+    title: 'Set the browser viewport size',
+    description: 'Set the current Puppeteer Page viewport size in CSS pixels and return the effective size.',
+    stringInputKey: false,
+    inputSchema: setViewportSizeInputSchema,
+    async execute (agent, input, executionContext) {
+        const ctx = {
+            ...executionContext,
+            input,
+            context: (0, external_utils_js_namespaceObject.requirePuppeteerAgent)(agent)
+        };
+        (0, external_utils_js_namespaceObject.throwIfAborted)(ctx.signal, 'setViewportSize');
+        const page = ctx.context.interface.underlyingPage;
+        await page.setViewport({
+            width: input.width,
+            height: input.height
+        });
+        const viewport = page.viewport();
+        if (!viewport) throw new Error('Puppeteer did not report an effective viewport size.');
+        const result = {
+            width: viewport.width,
+            height: viewport.height
+        };
+        return {
+            summary: `Set viewport to ${result.width}x${result.height}`,
+            data: result
+        };
+    }
+};
+exports.setViewportSizeInputSchema = __webpack_exports__.setViewportSizeInputSchema;
+exports.setViewportSizeNode = __webpack_exports__.setViewportSizeNode;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "setViewportSizeInputSchema",
+    "setViewportSizeNode"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=viewport.js.map

package/dist/lib/puppeteer/test-runner/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer/test-runner/viewport.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../../src/puppeteer/test-runner/viewport.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';\nimport { z } from 'zod/v4';\nimport { requirePuppeteerAgent, throwIfAborted } from './utils';\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\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 Puppeteer 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: requirePuppeteerAgent(agent),\n    };\n    throwIfAborted(ctx.signal, 'setViewportSize');\n    const page = ctx.context.interface.underlyingPage;\n    await page.setViewport({ width: input.width, height: input.height });\n    const viewport = page.viewport();\n    if (!viewport) {\n      throw new Error('Puppeteer did not report an effective viewport size.');\n    }\n    const result = { width: viewport.width, height: viewport.height };\n    return {\n      summary: `Set viewport to ${result.width}x${result.height}`,\n      data: result,\n    };\n  },\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","setViewportSizeInputSchema","z","setViewportSizeNode","agent","input","executionContext","ctx","requirePuppeteerAgent","throwIfAborted","page","viewport","Error","result"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;ACFO,MAAMI,6BAA6BC,mBAAAA,CAAAA,CAAAA,YAAc,CAAC;IACvD,OAAOA,mBAAAA,CAAAA,CAAAA,MAAQ,GAAG,GAAG,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,QAAQA,mBAAAA,CAAAA,CAAAA,MACC,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;AACd;AAMO,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,AAAAA,IAAAA,kCAAAA,qBAAAA,AAAAA,EAAsBJ;QACjC;QACAK,IAAAA,kCAAAA,cAAAA,AAAAA,EAAeF,IAAI,MAAM,EAAE;QAC3B,MAAMG,OAAOH,IAAI,OAAO,CAAC,SAAS,CAAC,cAAc;QACjD,MAAMG,KAAK,WAAW,CAAC;YAAE,OAAOL,MAAM,KAAK;YAAE,QAAQA,MAAM,MAAM;QAAC;QAClE,MAAMM,WAAWD,KAAK,QAAQ;QAC9B,IAAI,CAACC,UACH,MAAM,IAAIC,MAAM;QAElB,MAAMC,SAAS;YAAE,OAAOF,SAAS,KAAK;YAAE,QAAQA,SAAS,MAAM;QAAC;QAChE,OAAO;YACL,SAAS,CAAC,gBAAgB,EAAEE,OAAO,KAAK,CAAC,CAAC,EAAEA,OAAO,MAAM,EAAE;YAC3D,MAAMA;QACR;IACF;AACF"}

package/dist/types/common/test-runner/cookies.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod/v4';
+type Awaitable<T> = T | Promise<T>;
+export type CookieSourceReference = {
+    kind: 'env';
+    name: string;
+} | {
+    kind: 'profile';
+    name: string;
+} | {
+    kind: 'storage-state';
+    name: string;
+};
+export interface WebNodeContext<TContext> {
+    input: unknown;
+    context: TContext;
+    signal: AbortSignal;
+}
+export interface CookieProfileContext<TContext> {
+    profile: string;
+    context: TContext;
+    signal: AbortSignal;
+}
+export interface WebCookieSourceOptions<TAgent> {
+    getEnv?(ctx: WebNodeContext<TAgent>): Awaitable<Readonly<Record<string, string | undefined>>>;
+    getCookieProfile?(input: CookieProfileContext<TAgent>): Awaitable<unknown>;
+    resolveStorageStatePath?(path: string, ctx: WebNodeContext<TAgent>): Awaitable<string>;
+}
+export interface PortableWebCookie extends Record<string, unknown> {
+    name: string;
+    value: string;
+    url?: string;
+    domain?: string;
+    path?: string;
+}
+export declare const setCookiesInputSchema: z.ZodObject<{
+    cookiesEnv: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    storageStatePath: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SetCookiesNodeInput = z.infer<typeof setCookiesInputSchema>;
+export interface SetCookiesNodeResult {
+    source: CookieSourceReference['kind'];
+    sourceName: string;
+    count: number;
+}
+export declare const resolveCookieInput: <TAgent>(input: SetCookiesNodeInput, ctx: WebNodeContext<TAgent>, options: WebCookieSourceOptions<TAgent>) => Promise<{
+    cookies: PortableWebCookie[];
+    result: SetCookiesNodeResult;
+}>;
+export {};

package/dist/types/common/test-runner/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const throwIfAborted: (signal: AbortSignal, operation: string) => void;
+export declare const resolveWebUrl: (target: string, baseUrl: string | undefined, label: string) => string;

package/dist/types/playwright/test-runner/cookies.d.ts

@@ -1,32 +1,5 @@
+import { type SetCookiesNodeInput, type SetCookiesNodeResult, setCookiesInputSchema } from '../../common/test-runner/cookies';
 import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
-import { z } from 'zod/v4';
-type CookieSourceReference = {
-    kind: 'env';
-    name: string;
-} | {
-    kind: 'profile';
-    name: string;
-} | {
-    kind: 'storage-state';
-    name: string;
-};
-/** Input schema for the Playwright setCookies Node. */
-export declare const setCookiesInputSchema: z.ZodObject<{
-    cookiesEnv: z.ZodOptional<z.ZodString>;
-    profile: z.ZodOptional<z.ZodString>;
-    storageStatePath: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/** Validated input accepted by the Playwright setCookies Node. */
-export type SetCookiesNodeInput = z.infer<typeof setCookiesInputSchema>;
-/** Secret-free metadata returned by the Playwright setCookies Node. */
-export interface SetCookiesNodeResult {
-    /** Kind of configured reference used to resolve the cookies. */
-    source: CookieSourceReference['kind'];
-    /** Environment variable, profile, or storage-state reference name. */
-    sourceName: string;
-    /** Number of cookies passed to the BrowserContext. */
-    count: number;
-}
-export declare const setCookiesNode: AgentTestRunnerNodeDefinition<z.output<typeof setCookiesInputSchema>, SetCookiesNodeResult>;
-export {};
+export { setCookiesInputSchema };
+export type { SetCookiesNodeInput, SetCookiesNodeResult };
+export declare const setCookiesNode: AgentTestRunnerNodeDefinition<SetCookiesNodeInput, SetCookiesNodeResult>;

package/dist/types/playwright/test-runner/types.d.ts

@@ -1,23 +1,13 @@
 import type { BrowserContext, Page } from 'playwright';
+import type { CookieProfileContext, WebCookieSourceOptions, WebNodeContext } from '../../common/test-runner/cookies';
 type Awaitable<T> = T | Promise<T>;
 export type PlaywrightCookie = Parameters<BrowserContext['addCookies']>[0][number];
 /** Runtime resources supplied by the test runner to Playwright Nodes. */
-export interface PlaywrightNodeContext<TContext> {
-    input: unknown;
-    context: TContext;
-    signal: AbortSignal;
-}
+export type PlaywrightNodeContext<TContext> = WebNodeContext<TContext>;
 /** Context passed to a configured Playwright cookie profile resolver. */
-export interface PlaywrightCookieProfileContext<TContext> {
-    /** Profile reference from the setCookies Node input. */
-    profile: string;
-    /** The Agent executing the current Node. */
-    context: TContext;
-    /** Cancellation signal for the current Node execution. */
-    signal: AbortSignal;
-}
+export type PlaywrightCookieProfileContext<TContext> = CookieProfileContext<TContext>;
 /** Dependencies and source resolvers used by the Playwright preset Nodes. */
-export interface PlaywrightTestRunnerOptions {
+export interface PlaywrightTestRunnerOptions extends WebCookieSourceOptions<PlaywrightTestRunnerAgent> {
     /**
      * Return the environment used by setCookies. Defaults to process.env when
      * omitted.

package/dist/types/playwright/test-runner/utils.d.ts

@@ -1,4 +1,3 @@
+export { resolveWebUrl, throwIfAborted } from '../../common/test-runner/utils';
 import type { PlaywrightTestRunnerAgent } from './types';
-export declare const throwIfAborted: (signal: AbortSignal, operation: string) => void;
-export declare const resolveWebUrl: (target: string, baseUrl: string | undefined, label: string) => string;
 export declare const requirePlaywrightAgent: (agent: unknown) => PlaywrightTestRunnerAgent;

package/dist/types/puppeteer/browser-agent.d.ts

@@ -1,8 +1,11 @@
 import { type BrowserPageManager, WebAgentCore } from '../common/browser-agent';
 import type { WebPageAgentOpt } from '../web-element';
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
 import type { Browser as PuppeteerBrowser, Page as PuppeteerPage, Target as PuppeteerTarget } from 'puppeteer';
 import { PuppeteerWebPage } from './page';
+import type { PuppeteerTestRunnerOptions } from './test-runner/types';
 export type PuppeteerBrowserAgentOpt = Omit<WebPageAgentOpt, 'forceSameTabNavigation'> & {
+    testRunner?: PuppeteerTestRunnerOptions;
     autoFollowNewPage?: boolean;
     newPageTimeout?: number;
 };
@@ -10,6 +13,8 @@ export type PuppeteerBrowserAgentCreateOpt = PuppeteerBrowserAgentOpt & {
     initialPage?: PuppeteerPage;
 };
 export declare class PuppeteerBrowserAgent extends WebAgentCore<PuppeteerWebPage> {
+    static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[];
+    readonly testRunner?: PuppeteerTestRunnerOptions;
     protected pageManager: BrowserPageManager<PuppeteerPage, PuppeteerTarget>;
     constructor(browser: PuppeteerBrowser, initialPage: PuppeteerPage, opts?: PuppeteerBrowserAgentOpt);
     static create(browser: PuppeteerBrowser, opts?: PuppeteerBrowserAgentCreateOpt): Promise<PuppeteerBrowserAgent>;

package/dist/types/puppeteer/index.d.ts

@@ -1,4 +1,4 @@
-export { PuppeteerPageAgent, PuppeteerAgent } from './page-agent';
+export { PuppeteerPageAgent, PuppeteerAgent, type PuppeteerPageAgentOpt, } from './page-agent';
 export { PuppeteerBrowserAgent, type PuppeteerBrowserAgentCreateOpt, type PuppeteerBrowserAgentOpt, } from './browser-agent';
 export { PuppeteerWebPage } from './page';
 export type { WebPageAgentOpt } from '../web-element';

package/dist/types/puppeteer/page-agent.d.ts

@@ -1,8 +1,15 @@
 import { WebAgentCore } from '../common/browser-agent';
 import type { WebPageAgentOpt } from '../web-element';
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
 import type { Page as PuppeteerPage } from 'puppeteer';
 import { PuppeteerWebPage } from './page';
+import type { PuppeteerTestRunnerOptions } from './test-runner/types';
+export type PuppeteerPageAgentOpt = WebPageAgentOpt & {
+    testRunner?: PuppeteerTestRunnerOptions;
+};
 export declare class PuppeteerPageAgent extends WebAgentCore<PuppeteerWebPage> {
-    constructor(page: PuppeteerPage, opts?: WebPageAgentOpt);
+    static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[];
+    readonly testRunner?: PuppeteerTestRunnerOptions;
+    constructor(page: PuppeteerPage, opts?: PuppeteerPageAgentOpt);
 }
 export { PuppeteerPageAgent as PuppeteerAgent };

package/dist/types/puppeteer/test-runner/agent-nodes.d.ts

@@ -0,0 +1,2 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+export declare const puppeteerAgentTestRunnerNodeDefinitions: readonly AgentTestRunnerNodeDefinition[];

package/dist/types/puppeteer/test-runner/clear-cookies.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import { z } from 'zod/v4';
+export declare const clearCookiesInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ClearCookiesNodeInput = z.infer<typeof clearCookiesInputSchema>;
+export declare const clearCookiesNode: AgentTestRunnerNodeDefinition<z.output<typeof clearCookiesInputSchema>, {
+    filters: ClearCookiesNodeInput;
+}>;

package/dist/types/puppeteer/test-runner/cookies.d.ts

@@ -0,0 +1,5 @@
+import { type SetCookiesNodeInput, type SetCookiesNodeResult, setCookiesInputSchema } from '../../common/test-runner/cookies';
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+export { setCookiesInputSchema };
+export type { SetCookiesNodeInput, SetCookiesNodeResult };
+export declare const setCookiesNode: AgentTestRunnerNodeDefinition<SetCookiesNodeInput, SetCookiesNodeResult>;

package/dist/types/puppeteer/test-runner/goto-url.d.ts

@@ -0,0 +1,19 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import { z } from 'zod/v4';
+export declare const gotoUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    waitUntil: z.ZodDefault<z.ZodEnum<{
+        domcontentloaded: "domcontentloaded";
+        load: "load";
+        networkidle0: "networkidle0";
+        networkidle2: "networkidle2";
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type GotoUrlNodeInput = z.infer<typeof gotoUrlInputSchema>;
+export interface GotoUrlNodeResult {
+    url: string;
+    status: number | null;
+    title: string;
+}
+export declare const gotoUrlNode: AgentTestRunnerNodeDefinition<z.output<typeof gotoUrlInputSchema>, GotoUrlNodeResult>;

package/dist/types/puppeteer/test-runner/index.d.ts

@@ -0,0 +1,10 @@
+export { clearCookiesInputSchema } from './clear-cookies';
+export type { ClearCookiesNodeInput } from './clear-cookies';
+export { setCookiesInputSchema } from './cookies';
+export type { SetCookiesNodeInput, SetCookiesNodeResult } from './cookies';
+export { gotoUrlInputSchema } from './goto-url';
+export type { GotoUrlNodeInput, GotoUrlNodeResult } from './goto-url';
+export type { PuppeteerCookieProfileContext, PuppeteerNodeContext, PuppeteerTestRunnerAgent, PuppeteerTestRunnerOptions, } from './types';
+export { setViewportSizeInputSchema } from './viewport';
+export type { SetViewportSizeNodeInput } from './viewport';
+export { puppeteerAgentTestRunnerNodeDefinitions } from './agent-nodes';

package/dist/types/puppeteer/test-runner/types.d.ts

@@ -0,0 +1,18 @@
+import type { CookieProfileContext, WebCookieSourceOptions, WebNodeContext } from '../../common/test-runner/cookies';
+import type { CookieParam, Page } from 'puppeteer';
+export type PuppeteerCookie = CookieParam;
+export type PuppeteerNodeContext<TContext> = WebNodeContext<TContext>;
+export type PuppeteerCookieProfileContext<TContext> = CookieProfileContext<TContext>;
+/** Dependencies and source resolvers used by the Puppeteer preset Nodes. */
+export interface PuppeteerTestRunnerOptions extends WebCookieSourceOptions<PuppeteerTestRunnerAgent> {
+    /** Base URL used to resolve relative gotoUrl inputs before first navigation. */
+    baseURL?: string;
+    getCookieProfile?(input: PuppeteerCookieProfileContext<PuppeteerTestRunnerAgent>): readonly PuppeteerCookie[] | Promise<readonly PuppeteerCookie[]>;
+}
+/** Runtime resources used by Puppeteer Agent Nodes. */
+export interface PuppeteerTestRunnerAgent {
+    interface: {
+        underlyingPage: Page;
+    };
+    readonly testRunner?: PuppeteerTestRunnerOptions;
+}

package/dist/types/puppeteer/test-runner/utils.d.ts

@@ -0,0 +1,3 @@
+import type { PuppeteerTestRunnerAgent } from './types';
+export { resolveWebUrl, throwIfAborted } from '../../common/test-runner/utils';
+export declare const requirePuppeteerAgent: (agent: unknown) => PuppeteerTestRunnerAgent;

package/dist/types/puppeteer/test-runner/viewport.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import { z } from 'zod/v4';
+export declare const setViewportSizeInputSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export type SetViewportSizeNodeInput = z.infer<typeof setViewportSizeInputSchema>;
+export declare const setViewportSizeNode: AgentTestRunnerNodeDefinition<z.output<typeof setViewportSizeInputSchema>, {
+    width: number;
+    height: number;
+}>;

package/package.json

@@ -8,7 +8,7 @@
     "Browser use",
     "Android use"
   ],
-  "version": "1.12.8",
+  "version": "1.12.9-beta-20260917120835.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -50,6 +50,11 @@
       "require": "./dist/lib/puppeteer/agent-launcher.js",
       "import": "./dist/es/puppeteer/agent-launcher.mjs"
     },
+    "./puppeteer/test": {
+      "types": "./dist/types/puppeteer/test-runner/index.d.ts",
+      "require": "./dist/lib/puppeteer/test-runner/index.js",
+      "import": "./dist/es/puppeteer/test-runner/index.mjs"
+    },
     "./playwright": {
       "types": "./dist/types/playwright/index.d.ts",
       "require": "./dist/lib/playwright/index.js",
@@ -117,9 +122,9 @@
     "socket.io-client": "4.8.1",
     "ws": "^8.18.1",
     "zod": "^3.25.1",
-    "@midscene/shared": "1.12.8",
-    "@midscene/core": "1.12.8",
-    "@midscene/playground": "1.12.8"
+    "@midscene/core": "1.12.9-beta-20260917120835.0",
+    "@midscene/shared": "1.12.9-beta-20260917120835.0",
+    "@midscene/playground": "1.12.9-beta-20260917120835.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.45.0",