@midscene/web 1.12.6-beta-20260910093036.0 → 1.12.6

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"playwright/test-runner/utils.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../../src/playwright/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 { 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":["__webpack_require__","definition","key","Object","obj","prop","Symbol","SUPPORTED_WEB_PROTOCOLS","Set","throwIfAborted","signal","operation","Error","resolveWebUrl","target","baseUrl","label","trimmed","TypeError","resolved","undefined","URL","error","requirePlaywrightAgent","agent"],"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;;;;;;;;;ACJA,MAAMI,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"}

package/dist/lib/playwright/test-runner/viewport.js

@@ -0,0 +1,72 @@
+"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 Playwright 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.requirePlaywrightAgent)(agent)
+        };
+        (0, external_utils_js_namespaceObject.throwIfAborted)(ctx.signal, 'setViewportSize');
+        const page = ctx.context.interface.underlyingPage;
+        await page.setViewportSize({
+            width: ctx.input.width,
+            height: ctx.input.height
+        });
+        const viewport = page.viewportSize();
+        if (!viewport) throw new Error('Playwright did not report an effective viewport size.');
+        return {
+            summary: `Set viewport to ${viewport.width}x${viewport.height}`,
+            data: viewport
+        };
+    }
+};
+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/playwright/test-runner/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright/test-runner/viewport.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../../src/playwright/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 { 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":["__webpack_require__","definition","key","Object","obj","prop","Symbol","setViewportSizeInputSchema","z","setViewportSizeNode","agent","input","executionContext","ctx","requirePlaywrightAgent","throwIfAborted","page","viewport","Error"],"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;;;;;;;;;;ACDO,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;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,AAAAA,IAAAA,kCAAAA,sBAAAA,AAAAA,EAAuBJ;QAClC;QACAK,IAAAA,kCAAAA,cAAAA,AAAAA,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"}

package/dist/types/playwright/agent.d.ts

@@ -3,3 +3,5 @@ export { WebPage as PlaywrightWebPage } from './page';
 export type { WebPageAgentOpt } from '../web-element';
 export { PlaywrightPageAgent, PlaywrightAgent } from './page-agent';
 export { PlaywrightBrowserAgent, type PlaywrightBrowserAgentCreateOpt, type PlaywrightBrowserAgentOpt, } from './browser-agent';
+export type { PlaywrightPageAgentOpt } from './page-agent';
+export type { PlaywrightTestRunnerOptions } from './test-runner/types';

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

@@ -1,8 +1,11 @@
 import { WebAgentCore } from '../common/browser-agent';
 import type { WebPageAgentOpt } from '../web-element';
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
 import type { BrowserContext as PlaywrightBrowserContext, Page as PlaywrightPage } from 'playwright';
 import { WebPage as PlaywrightWebPage } from './page';
+import type { PlaywrightTestRunnerOptions } from './test-runner/types';
 export type PlaywrightBrowserAgentOpt = Omit<WebPageAgentOpt, 'forceSameTabNavigation'> & {
+    testRunner?: PlaywrightTestRunnerOptions;
     autoFollowNewPage?: boolean;
     newPageTimeout?: number;
 };
@@ -10,6 +13,8 @@ export type PlaywrightBrowserAgentCreateOpt = PlaywrightBrowserAgentOpt & {
     initialPage?: PlaywrightPage;
 };
 export declare class PlaywrightBrowserAgent extends WebAgentCore<PlaywrightWebPage> {
+    static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[];
+    readonly testRunner?: PlaywrightTestRunnerOptions;
     private readonly pageManager;
     constructor(context: PlaywrightBrowserContext, initialPage: PlaywrightPage, opts?: PlaywrightBrowserAgentOpt);
     static create(context: PlaywrightBrowserContext, opts?: PlaywrightBrowserAgentCreateOpt): Promise<PlaywrightBrowserAgent>;

package/dist/types/playwright/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 PlaywrightPage } from 'playwright';
 import { WebPage as PlaywrightWebPage } from './page';
+import type { PlaywrightTestRunnerOptions } from './test-runner/types';
+export type PlaywrightPageAgentOpt = WebPageAgentOpt & {
+    testRunner?: PlaywrightTestRunnerOptions;
+};
 export declare class PlaywrightPageAgent extends WebAgentCore<PlaywrightWebPage> {
-    constructor(page: PlaywrightPage, opts?: WebPageAgentOpt);
+    static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[];
+    readonly testRunner?: PlaywrightTestRunnerOptions;
+    constructor(page: PlaywrightPage, opts?: PlaywrightPageAgentOpt);
 }
 export { PlaywrightPageAgent as PlaywrightAgent };

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

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

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

@@ -0,0 +1,16 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import type { BrowserContext } from 'playwright';
+import { z } from 'zod/v4';
+type CookieClearOptions = NonNullable<Parameters<BrowserContext['clearCookies']>[0]>;
+/** Input schema for the Playwright clearCookies Node. */
+export declare const clearCookiesInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Validated input accepted by the Playwright clearCookies Node. */
+export type ClearCookiesNodeInput = z.infer<typeof clearCookiesInputSchema>;
+export declare const clearCookiesNode: AgentTestRunnerNodeDefinition<z.output<typeof clearCookiesInputSchema>, {
+    filters: CookieClearOptions;
+}>;
+export {};

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

@@ -0,0 +1,32 @@
+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 {};

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

@@ -0,0 +1,25 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import { z } from 'zod/v4';
+/** Input schema for the Playwright gotoUrl Node. */
+export declare const gotoUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    waitUntil: z.ZodDefault<z.ZodEnum<{
+        domcontentloaded: "domcontentloaded";
+        load: "load";
+        networkidle: "networkidle";
+        commit: "commit";
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+/** Validated input accepted by the Playwright gotoUrl Node. */
+export type GotoUrlNodeInput = z.infer<typeof gotoUrlInputSchema>;
+/** Structured navigation details returned by the Playwright gotoUrl Node. */
+export interface GotoUrlNodeResult {
+    /** Final Page URL after navigation and redirects. */
+    url: string;
+    /** Main-resource HTTP status, or null when Playwright returns no response. */
+    status: number | null;
+    /** Document title after navigation completes. */
+    title: string;
+}
+export declare const gotoUrlNode: AgentTestRunnerNodeDefinition<z.output<typeof gotoUrlInputSchema>, GotoUrlNodeResult>;

package/dist/types/playwright/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 { PlaywrightTestRunnerOptions, PlaywrightTestRunnerAgent, PlaywrightCookieProfileContext, PlaywrightNodeContext, } from './types';
+export { setViewportSizeInputSchema } from './viewport';
+export type { SetViewportSizeNodeInput } from './viewport';
+export { playwrightAgentTestRunnerNodeDefinitions } from './agent-nodes';

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

@@ -0,0 +1,41 @@
+import type { BrowserContext, Page } from 'playwright';
+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;
+}
+/** 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;
+}
+/** Dependencies and source resolvers used by the Playwright preset Nodes. */
+export interface PlaywrightTestRunnerOptions {
+    /**
+     * Return the environment used by setCookies. Defaults to process.env when
+     * omitted.
+     */
+    getEnv?(ctx: PlaywrightNodeContext<PlaywrightTestRunnerAgent>): Awaitable<Readonly<Record<string, string | undefined>>>;
+    /** Resolve a named cookie profile without placing cookie values in YAML. */
+    getCookieProfile?(input: PlaywrightCookieProfileContext<PlaywrightTestRunnerAgent>): Awaitable<readonly PlaywrightCookie[]>;
+    /**
+     * Resolve a storage-state reference to a file path. References are resolved
+     * from process.cwd() when omitted.
+     */
+    resolveStorageStatePath?(path: string, ctx: PlaywrightNodeContext<PlaywrightTestRunnerAgent>): Awaitable<string>;
+}
+/** The runtime resources used by Playwright Agent Nodes. */
+export interface PlaywrightTestRunnerAgent {
+    interface: {
+        underlyingPage: Page;
+    };
+    readonly testRunner?: PlaywrightTestRunnerOptions;
+}
+export {};

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

@@ -0,0 +1,4 @@
+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/playwright/test-runner/viewport.d.ts

@@ -0,0 +1,13 @@
+import type { AgentTestRunnerNodeDefinition } from '@midscene/core/agent';
+import { z } from 'zod/v4';
+/** Input schema for the Playwright setViewportSize Node. */
+export declare const setViewportSizeInputSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+/** Validated input accepted by the Playwright setViewportSize Node. */
+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.6-beta-20260910093036.0",
+  "version": "1.12.6",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -89,6 +89,11 @@
       "types": "./dist/types/static/index.d.ts",
       "require": "./dist/lib/static/index.js",
       "import": "./dist/es/static/index.mjs"
+    },
+    "./playwright/test": {
+      "types": "./dist/types/playwright/test-runner/index.d.ts",
+      "require": "./dist/lib/playwright/test-runner/index.js",
+      "import": "./dist/es/playwright/test-runner/index.mjs"
     }
   },
   "bin": {
@@ -111,9 +116,10 @@
     "socket.io": "^4.8.1",
     "socket.io-client": "4.8.1",
     "ws": "^8.18.1",
-    "@midscene/core": "1.12.6-beta-20260910093036.0",
-    "@midscene/playground": "1.12.6-beta-20260910093036.0",
-    "@midscene/shared": "1.12.6-beta-20260910093036.0"
+    "zod": "^3.25.1",
+    "@midscene/core": "1.12.6",
+    "@midscene/shared": "1.12.6",
+    "@midscene/playground": "1.12.6"
   },
   "devDependencies": {
     "@playwright/test": "^1.45.0",