playwright-core 1.58.0-alpha-2025-12-11 → 1.58.0-alpha-2025-12-13

package/lib/protocol/validator.js

@@ -613,7 +613,9 @@ import_validatorPrimitives.scheme.BrowserTypeLaunchPersistentContextParams = (0,
     model: import_validatorPrimitives.tString,
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"])),
-    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue")))
+    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
+    maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+    maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
   })),
   userDataDir: import_validatorPrimitives.tString,
   slowMo: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tFloat)
@@ -712,7 +714,9 @@ import_validatorPrimitives.scheme.BrowserNewContextParams = (0, import_validator
     model: import_validatorPrimitives.tString,
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"])),
-    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue")))
+    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
+    maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+    maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
   })),
   proxy: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
     server: import_validatorPrimitives.tString,
@@ -790,7 +794,9 @@ import_validatorPrimitives.scheme.BrowserNewContextForReuseParams = (0, import_v
     model: import_validatorPrimitives.tString,
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"])),
-    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue")))
+    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
+    maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+    maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
   })),
   proxy: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
     server: import_validatorPrimitives.tString,
@@ -913,7 +919,9 @@ import_validatorPrimitives.scheme.BrowserContextInitializer = (0, import_validat
       model: import_validatorPrimitives.tString,
       cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
       cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"])),
-      secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue")))
+      secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
+      maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+      maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
     }))
   })
 });
@@ -1519,16 +1527,24 @@ import_validatorPrimitives.scheme.PageUpdateSubscriptionResult = (0, import_vali
 import_validatorPrimitives.scheme.PagePerformParams = (0, import_validatorPrimitives.tObject)({
   task: import_validatorPrimitives.tString,
   key: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-  maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
+  maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+  maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
+});
+import_validatorPrimitives.scheme.PagePerformResult = (0, import_validatorPrimitives.tObject)({
+  turns: import_validatorPrimitives.tInt,
+  inputTokens: import_validatorPrimitives.tInt,
+  outputTokens: import_validatorPrimitives.tInt
 });
-import_validatorPrimitives.scheme.PagePerformResult = (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({}));
 import_validatorPrimitives.scheme.PageExtractParams = (0, import_validatorPrimitives.tObject)({
   query: import_validatorPrimitives.tString,
   schema: import_validatorPrimitives.tAny,
   maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
 });
 import_validatorPrimitives.scheme.PageExtractResult = (0, import_validatorPrimitives.tObject)({
-  result: import_validatorPrimitives.tAny
+  result: import_validatorPrimitives.tAny,
+  turns: import_validatorPrimitives.tInt,
+  inputTokens: import_validatorPrimitives.tInt,
+  outputTokens: import_validatorPrimitives.tInt
 });
 import_validatorPrimitives.scheme.FrameInitializer = (0, import_validatorPrimitives.tObject)({
   url: import_validatorPrimitives.tString,
@@ -2823,7 +2839,9 @@ import_validatorPrimitives.scheme.AndroidDeviceLaunchBrowserParams = (0, import_
     model: import_validatorPrimitives.tString,
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"])),
-    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue")))
+    secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
+    maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
+    maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
   })),
   pkg: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   args: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)(import_validatorPrimitives.tString)),

package/lib/server/agent/agent.js

@@ -41,9 +41,10 @@ var import_context = require("./context");
 async function pagePerform(progress, page, options) {
   const context = new import_context.Context(progress, page);
   if (await cachedPerform(context, options))
-    return;
-  await perform(context, options.task, void 0, options);
+    return { turns: 0, inputTokens: 0, outputTokens: 0 };
+  const { usage } = await perform(context, options.task, void 0, options);
   await updateCache(context, options);
+  return usage;
 }
 async function pageExtract(progress, page, options) {
   const context = new import_context.Context(progress, page);
@@ -53,7 +54,8 @@ Extract the following information from the page. Do not perform any actions, jus
 
 ### Query
 ${options.query}`;
-  return await perform(context, task, options.schema, options);
+  const { result, usage } = await perform(context, task, options.schema, options);
+  return { result, usage };
 }
 async function perform(context, userTask, resultSchema, options = {}) {
   const { progress, page } = context;
@@ -62,13 +64,17 @@ async function perform(context, userTask, resultSchema, options = {}) {
     throw new Error(`page.perform() and page.extract() require the agent to be set on the browser context`);
   const { full } = await page.snapshotForAI(progress);
   const { tools, callTool } = (0, import_backend.toolsForLoop)(context);
+  const limits = context.limits(options);
+  let turns = 0;
   const loop = new import_mcpBundle.Loop(browserContext._options.agent.provider, {
     model: browserContext._options.agent.model,
     summarize: true,
     debug: import_utilsBundle.debug,
     callTool,
     tools,
+    ...limits,
     beforeTurn: (params) => {
+      ++turns;
       const lastReply = params.conversation.messages.findLast((m) => m.role === "assistant");
       const toolCall = lastReply?.content.find((c) => c.type === "tool_call");
       if (!resultSchema && toolCall && toolCall.arguments.thatShouldBeIt)
@@ -82,15 +88,22 @@ async function perform(context, userTask, resultSchema, options = {}) {
 ### Page snapshot
 ${full}
 `;
-  const { result } = await loop.run(task, { resultSchema });
-  return result;
+  const { result, usage } = await loop.run(task, { resultSchema });
+  return {
+    result,
+    usage: {
+      turns,
+      inputTokens: usage.input,
+      outputTokens: usage.output
+    }
+  };
 }
 const allCaches = /* @__PURE__ */ new Map();
 async function cachedPerform(context, options) {
   if (!context.options?.cacheFile || context.options.cacheMode === "ignore")
     return false;
   const cache = await cachedActions(context.options.cacheFile);
-  const cacheKey = options.key ?? options.task;
+  const cacheKey = (options.key ?? options.task).trim();
   const entry = cache[cacheKey];
   if (!entry) {
     if (context.options.cacheMode === "force")
@@ -106,7 +119,7 @@ async function updateCache(context, options) {
   if (!cacheFile)
     return;
   const cache = await cachedActions(cacheFile);
-  const cacheKey = options.key ?? options.task;
+  const cacheKey = (options.key ?? options.task).trim();
   cache[cacheKey] = {
     timestamp: Date.now(),
     actions: context.actions

package/lib/server/agent/backend.js

@@ -32,7 +32,6 @@ __export(backend_exports, {
 });
 module.exports = __toCommonJS(backend_exports);
 var import_tools = __toESM(require("./tools"));
-var import_progress = require("../progress");
 var import_mcpBundle = require("../../mcpBundle");
 function toolsForLoop(context) {
   const tools = import_tools.default.map((tool) => {
@@ -44,6 +43,7 @@ function toolsForLoop(context) {
     return result;
   });
   const callTool = async (params) => {
+    const intent = params.arguments._meta?.["dev.lowire/intent"];
     const tool = import_tools.default.find((t) => t.schema.name === params.name);
     if (!tool) {
       return {
@@ -54,11 +54,8 @@ function toolsForLoop(context) {
         isError: true
       };
     }
-    const progressController = new import_progress.ProgressController();
     try {
-      return await progressController.run(async (progress) => {
-        return await tool.handle(context, params.arguments);
-      });
+      return await context.callTool(tool, params.arguments, { intent });
     } catch (error) {
       return {
         content: [{ type: "text", text: error.message }],

package/lib/server/agent/codegen.js

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var codegen_exports = {};
+__export(codegen_exports, {
+  generateCode: () => generateCode
+});
+module.exports = __toCommonJS(codegen_exports);
+var import_locatorGenerators = require("../../utils/isomorphic/locatorGenerators");
+var import_stringUtils = require("../../utils/isomorphic/stringUtils");
+async function generateCode(sdkLanguage, action) {
+  switch (action.method) {
+    case "click": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      return `await page.${locator}.click(${(0, import_stringUtils.formatObjectOrVoid)(action.options)});`;
+    }
+    case "drag": {
+      const sourceLocator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.sourceSelector);
+      const targetLocator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.targetSelector);
+      return `await page.${sourceLocator}.dragAndDrop(${targetLocator});`;
+    }
+    case "hover": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      return `await page.${locator}.hover(${(0, import_stringUtils.formatObjectOrVoid)(action.options)});`;
+    }
+    case "pressKey": {
+      return `await page.keyboard.press(${(0, import_stringUtils.escapeWithQuotes)(action.key, "'")});`;
+    }
+    case "selectOption": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      return `await page.${locator}.selectOption(${action.labels.length === 1 ? (0, import_stringUtils.escapeWithQuotes)(action.labels[0]) : "[" + action.labels.map((label) => (0, import_stringUtils.escapeWithQuotes)(label)).join(", ") + "]"});`;
+    }
+    case "pressSequentially": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      const code = [`await page.${locator}.pressSequentially(${(0, import_stringUtils.escapeWithQuotes)(action.text)});`];
+      if (action.submit)
+        code.push(`await page.keyboard.press('Enter');`);
+      return code.join("\n");
+    }
+    case "fill": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      const code = [`await page.${locator}.fill(${(0, import_stringUtils.escapeWithQuotes)(action.text)});`];
+      if (action.submit)
+        code.push(`await page.keyboard.press('Enter');`);
+      return code.join("\n");
+    }
+    case "setChecked": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      if (action.checked)
+        return `await page.${locator}.check();`;
+      else
+        return `await page.${locator}.uncheck();`;
+    }
+    case "expectVisible": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      return `await expect(page.${locator}).toBeVisible();`;
+    }
+    case "expectValue": {
+      const locator = (0, import_locatorGenerators.asLocator)(sdkLanguage, action.selector);
+      return `await expect(page.${locator}).toHaveValue(${(0, import_stringUtils.escapeWithQuotes)(action.value)});`;
+    }
+  }
+  throw new Error("Unknown action " + action.method);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateCode
+});

package/lib/server/agent/context.js

@@ -23,12 +23,22 @@ __export(context_exports, {
 module.exports = __toCommonJS(context_exports);
 var import_browserContext = require("../browserContext");
 var import_actionRunner = require("./actionRunner");
+var import_codegen = require("./codegen");
 class Context {
   constructor(progress, page) {
     this.actions = [];
     this.progress = progress;
     this.page = page;
     this.options = page.browserContext._options.agent;
+    this.sdkLanguage = page.browserContext._browser.sdkLanguage();
+  }
+  async callTool(tool, params, options) {
+    this._callIntent = options.intent;
+    try {
+      return await tool.handle(this, params);
+    } finally {
+      this._callIntent = void 0;
+    }
   }
   async runActionAndWait(action) {
     return await this.runActionsAndWait([action]);
@@ -38,7 +48,8 @@ class Context {
       await this.waitForCompletion(async () => {
         for (const a of action) {
           await (0, import_actionRunner.runAction)(this.progress, this.page, a, this.options?.secrets ?? []);
-          this.actions.push(a);
+          const code = await (0, import_codegen.generateCode)(this.sdkLanguage, a);
+          this.actions.push({ ...a, code, intent: this._callIntent });
         }
       });
       return await this.snapshotResult();
@@ -112,6 +123,12 @@ ${full}`);
       }
     }));
   }
+  limits(options = {}) {
+    return {
+      maxTurns: options.maxTurns ?? this.options?.maxTurns ?? 10,
+      maxTokens: options.maxTokens ?? this.options?.maxTokens ?? void 0
+    };
+  }
   _redactText(text) {
     const secrets = this.options?.secrets;
     if (!secrets)

package/lib/server/codegen/javascript.js

@@ -90,7 +90,7 @@ class JavaScriptLanguageGenerator {
       case "fill":
         return `await ${subject}.${this._asLocator(action.selector)}.fill(${quote(action.text)});`;
       case "setInputFiles":
-        return `await ${subject}.${this._asLocator(action.selector)}.setInputFiles(${formatObject(action.files.length === 1 ? action.files[0] : action.files)});`;
+        return `await ${subject}.${this._asLocator(action.selector)}.setInputFiles(${(0, import_utils.formatObject)(action.files.length === 1 ? action.files[0] : action.files)});`;
       case "press": {
         const modifiers = (0, import_language.toKeyboardModifiers)(action.modifiers);
         const shortcut = [...modifiers, action.key].join("+");
@@ -99,7 +99,7 @@ class JavaScriptLanguageGenerator {
       case "navigate":
         return `await ${subject}.goto(${quote(action.url)});`;
       case "select":
-        return `await ${subject}.${this._asLocator(action.selector)}.selectOption(${formatObject(action.options.length === 1 ? action.options[0] : action.options)});`;
+        return `await ${subject}.${this._asLocator(action.selector)}.selectOption(${(0, import_utils.formatObject)(action.options.length === 1 ? action.options[0] : action.options)});`;
       case "assertText":
         return `${this._isTest ? "" : "// "}await expect(${subject}.${this._asLocator(action.selector)}).${action.substring ? "toContainText" : "toHaveText"}(${quote(action.text)});`;
       case "assertChecked":
@@ -151,7 +151,7 @@ ${useText ? "\ntest.use(" + useText + ");\n" : ""}
       const { ${options.browserName}${options.deviceName ? ", devices" : ""} } = require('playwright');
 
       (async () => {
-        const browser = await ${options.browserName}.launch(${formatObjectOrVoid(options.launchOptions)});
+        const browser = await ${options.browserName}.launch(${(0, import_utils.formatObjectOrVoid)(options.launchOptions)});
         const context = await browser.newContext(${formatContextOptions(options.contextOptions, options.deviceName, false)});`);
     if (options.contextOptions.recordHar)
       formatter.add(`        await context.routeFromHAR(${quote(options.contextOptions.recordHar.path)});`);
@@ -171,37 +171,14 @@ function formatOptions(value, hasArguments) {
   const keys = Object.keys(value).filter((key) => value[key] !== void 0);
   if (!keys.length)
     return "";
-  return (hasArguments ? ", " : "") + formatObject(value);
-}
-function formatObject(value, indent = "  ") {
-  if (typeof value === "string")
-    return quote(value);
-  if (Array.isArray(value))
-    return `[${value.map((o) => formatObject(o)).join(", ")}]`;
-  if (typeof value === "object") {
-    const keys = Object.keys(value).filter((key) => value[key] !== void 0).sort();
-    if (!keys.length)
-      return "{}";
-    const tokens = [];
-    for (const key of keys)
-      tokens.push(`${key}: ${formatObject(value[key])}`);
-    return `{
-${indent}${tokens.join(`,
-${indent}`)}
-}`;
-  }
-  return String(value);
-}
-function formatObjectOrVoid(value, indent = "  ") {
-  const result = formatObject(value, indent);
-  return result === "{}" ? "" : result;
+  return (hasArguments ? ", " : "") + (0, import_utils.formatObject)(value);
 }
 function formatContextOptions(options, deviceName, isTest) {
   const device = deviceName && import_deviceDescriptors.deviceDescriptors[deviceName];
   options = { ...options, recordHar: void 0 };
   if (!device)
-    return formatObjectOrVoid(options);
-  let serializedObject = formatObjectOrVoid((0, import_language.sanitizeDeviceOptions)(device, options));
+    return (0, import_utils.formatObjectOrVoid)(options);
+  let serializedObject = (0, import_utils.formatObjectOrVoid)((0, import_language.sanitizeDeviceOptions)(device, options));
   if (!serializedObject)
     serializedObject = "{\n}";
   const lines = serializedObject.split("\n");