patchright-core 1.57.0 → 1.59.0

package/lib/tools/backend/cookies.js

@@ -0,0 +1,152 @@
+"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 cookies_exports = {};
+__export(cookies_exports, {
+  default: () => cookies_default
+});
+module.exports = __toCommonJS(cookies_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_tool = require("./tool");
+const cookieList = (0, import_tool.defineTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_cookie_list",
+    title: "List cookies",
+    description: "List all cookies (optionally filtered by domain/path)",
+    inputSchema: import_zodBundle.z.object({
+      domain: import_zodBundle.z.string().optional().describe("Filter cookies by domain"),
+      path: import_zodBundle.z.string().optional().describe("Filter cookies by path")
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    let cookies = await browserContext.cookies();
+    if (params.domain)
+      cookies = cookies.filter((c) => c.domain.includes(params.domain));
+    if (params.path)
+      cookies = cookies.filter((c) => c.path.startsWith(params.path));
+    if (cookies.length === 0)
+      response.addTextResult("No cookies found");
+    else
+      response.addTextResult(cookies.map((c) => `${c.name}=${c.value} (domain: ${c.domain}, path: ${c.path})`).join("\n"));
+    response.addCode(`await page.context().cookies();`);
+  }
+});
+const cookieGet = (0, import_tool.defineTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_cookie_get",
+    title: "Get cookie",
+    description: "Get a specific cookie by name",
+    inputSchema: import_zodBundle.z.object({
+      name: import_zodBundle.z.string().describe("Cookie name to get")
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    const cookies = await browserContext.cookies();
+    const cookie = cookies.find((c) => c.name === params.name);
+    if (!cookie)
+      response.addTextResult(`Cookie '${params.name}' not found`);
+    else
+      response.addTextResult(`${cookie.name}=${cookie.value} (domain: ${cookie.domain}, path: ${cookie.path}, httpOnly: ${cookie.httpOnly}, secure: ${cookie.secure}, sameSite: ${cookie.sameSite})`);
+    response.addCode(`await page.context().cookies();`);
+  }
+});
+const cookieSet = (0, import_tool.defineTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_cookie_set",
+    title: "Set cookie",
+    description: "Set a cookie with optional flags (domain, path, expires, httpOnly, secure, sameSite)",
+    inputSchema: import_zodBundle.z.object({
+      name: import_zodBundle.z.string().describe("Cookie name"),
+      value: import_zodBundle.z.string().describe("Cookie value"),
+      domain: import_zodBundle.z.string().optional().describe("Cookie domain"),
+      path: import_zodBundle.z.string().optional().describe("Cookie path"),
+      expires: import_zodBundle.z.number().optional().describe("Cookie expiration as Unix timestamp"),
+      httpOnly: import_zodBundle.z.boolean().optional().describe("Whether the cookie is HTTP only"),
+      secure: import_zodBundle.z.boolean().optional().describe("Whether the cookie is secure"),
+      sameSite: import_zodBundle.z.enum(["Strict", "Lax", "None"]).optional().describe("Cookie SameSite attribute")
+    }),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    const tab = await context.ensureTab();
+    const url = new URL(tab.page.url());
+    const cookie = {
+      name: params.name,
+      value: params.value,
+      domain: params.domain || url.hostname,
+      path: params.path || "/"
+    };
+    if (params.expires !== void 0)
+      cookie.expires = params.expires;
+    if (params.httpOnly !== void 0)
+      cookie.httpOnly = params.httpOnly;
+    if (params.secure !== void 0)
+      cookie.secure = params.secure;
+    if (params.sameSite !== void 0)
+      cookie.sameSite = params.sameSite;
+    await browserContext.addCookies([cookie]);
+    response.addCode(`await page.context().addCookies([${JSON.stringify(cookie)}]);`);
+  }
+});
+const cookieDelete = (0, import_tool.defineTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_cookie_delete",
+    title: "Delete cookie",
+    description: "Delete a specific cookie",
+    inputSchema: import_zodBundle.z.object({
+      name: import_zodBundle.z.string().describe("Cookie name to delete")
+    }),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    await browserContext.clearCookies({ name: params.name });
+    response.addCode(`await page.context().clearCookies({ name: '${params.name}' });`);
+  }
+});
+const cookieClear = (0, import_tool.defineTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_cookie_clear",
+    title: "Clear cookies",
+    description: "Clear all cookies",
+    inputSchema: import_zodBundle.z.object({}),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    await browserContext.clearCookies();
+    response.addCode(`await page.context().clearCookies();`);
+  }
+});
+var cookies_default = [
+  cookieList,
+  cookieGet,
+  cookieSet,
+  cookieDelete,
+  cookieClear
+];

package/lib/tools/backend/devtools.js

@@ -0,0 +1,69 @@
+"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 devtools_exports = {};
+__export(devtools_exports, {
+  default: () => devtools_default
+});
+module.exports = __toCommonJS(devtools_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_tool = require("./tool");
+const resume = (0, import_tool.defineTool)({
+  capability: "devtools",
+  schema: {
+    name: "browser_resume",
+    title: "Resume paused script execution",
+    description: "Resume script execution after it was paused. When called with step set to true, execution will pause again before the next action.",
+    inputSchema: import_zodBundle.z.object({
+      step: import_zodBundle.z.boolean().optional().describe("When true, execution will pause again before the next action, allowing step-by-step debugging."),
+      location: import_zodBundle.z.string().optional().describe('Pause execution at a specific <file>:<line>, e.g. "example.spec.ts:42".')
+    }),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    const pausedPromise = new Promise((resolve) => {
+      const listener = () => {
+        if (browserContext.debugger.pausedDetails()) {
+          browserContext.debugger.off("pausedstatechanged", listener);
+          resolve();
+        }
+      };
+      browserContext.debugger.on("pausedstatechanged", listener);
+    });
+    if (params.location) {
+      const [file, lineStr] = params.location.split(":");
+      let location;
+      if (lineStr) {
+        const line = Number(lineStr);
+        if (isNaN(line))
+          throw new Error(`Invalid location "${params.location}", expected format is <file>:<line>, e.g. "example.spec.ts:42"`);
+        location = { file, line };
+      } else {
+        location = { file: params.location };
+      }
+      await browserContext.debugger.runTo(location);
+    } else if (params.step) {
+      await browserContext.debugger.next();
+    } else {
+      await browserContext.debugger.resume();
+    }
+    await pausedPromise;
+  }
+});
+var devtools_default = [resume];

package/lib/tools/backend/dialogs.js

@@ -0,0 +1,59 @@
+"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 dialogs_exports = {};
+__export(dialogs_exports, {
+  default: () => dialogs_default,
+  handleDialog: () => handleDialog
+});
+module.exports = __toCommonJS(dialogs_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_tool = require("./tool");
+const handleDialog = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_handle_dialog",
+    title: "Handle a dialog",
+    description: "Handle a dialog",
+    inputSchema: import_zodBundle.z.object({
+      accept: import_zodBundle.z.boolean().describe("Whether to accept the dialog."),
+      promptText: import_zodBundle.z.string().optional().describe("The text of the prompt in case of a prompt dialog.")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    const dialogState = tab.modalStates().find((state) => state.type === "dialog");
+    if (!dialogState)
+      throw new Error("No dialog visible");
+    tab.clearModalState(dialogState);
+    await tab.waitForCompletion(async () => {
+      if (params.accept)
+        await dialogState.dialog.accept(params.promptText);
+      else
+        await dialogState.dialog.dismiss();
+    });
+  },
+  clearsModalState: "dialog"
+});
+var dialogs_default = [
+  handleDialog
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handleDialog
+});

package/lib/tools/backend/evaluate.js

@@ -0,0 +1,64 @@
+"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 evaluate_exports = {};
+__export(evaluate_exports, {
+  default: () => evaluate_default
+});
+module.exports = __toCommonJS(evaluate_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_stringUtils = require("../../utils/isomorphic/stringUtils");
+var import_tool = require("./tool");
+const evaluateSchema = import_zodBundle.z.object({
+  function: import_zodBundle.z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
+  element: import_zodBundle.z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
+  ref: import_zodBundle.z.string().optional().describe("Exact target element reference from the page snapshot"),
+  selector: import_zodBundle.z.string().optional().describe('CSS or role selector for the target element, when "ref" is not available.'),
+  filename: import_zodBundle.z.string().optional().describe("Filename to save the result to. If not provided, result is returned as text.")
+});
+const evaluate = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_evaluate",
+    title: "Evaluate JavaScript",
+    description: "Evaluate JavaScript expression on page or element",
+    inputSchema: evaluateSchema,
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    let locator;
+    if (!params.function.includes("=>"))
+      params.function = `() => (${params.function})`;
+    if (params.ref) {
+      locator = await tab.refLocator({ ref: params.ref, selector: params.selector, element: params.element || "element" });
+      response.addCode(`await page.${locator.resolved}.evaluate(${(0, import_stringUtils.escapeWithQuotes)(params.function)});`);
+    } else {
+      response.addCode(`await page.evaluate(${(0, import_stringUtils.escapeWithQuotes)(params.function)});`);
+    }
+    await tab.waitForCompletion(async () => {
+      const func = new Function();
+      func.toString = () => params.function;
+      const result = locator?.locator ? await locator?.locator.evaluate(func) : await tab.page.evaluate(func);
+      const text = JSON.stringify(result, null, 2) || "undefined";
+      await response.addResult("Evaluation result", text, { prefix: "result", ext: "json", suggestedFilename: params.filename });
+    });
+  }
+});
+var evaluate_default = [
+  evaluate
+];

package/lib/tools/backend/files.js

@@ -0,0 +1,60 @@
+"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 files_exports = {};
+__export(files_exports, {
+  default: () => files_default,
+  uploadFile: () => uploadFile
+});
+module.exports = __toCommonJS(files_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_tool = require("./tool");
+const uploadFile = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_file_upload",
+    title: "Upload files",
+    description: "Upload one or multiple files",
+    inputSchema: import_zodBundle.z.object({
+      paths: import_zodBundle.z.array(import_zodBundle.z.string()).optional().describe("The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const modalState = tab.modalStates().find((state) => state.type === "fileChooser");
+    if (!modalState)
+      throw new Error("No file chooser visible");
+    if (params.paths)
+      await Promise.all(params.paths.map((filePath) => response.resolveClientFilename(filePath)));
+    response.addCode(`await fileChooser.setFiles(${JSON.stringify(params.paths)})`);
+    tab.clearModalState(modalState);
+    await tab.waitForCompletion(async () => {
+      if (params.paths)
+        await modalState.fileChooser.setFiles(params.paths);
+    });
+  },
+  clearsModalState: "fileChooser"
+});
+var files_default = [
+  uploadFile
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  uploadFile
+});

package/lib/tools/backend/form.js

@@ -0,0 +1,64 @@
+"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 form_exports = {};
+__export(form_exports, {
+  default: () => form_default
+});
+module.exports = __toCommonJS(form_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_stringUtils = require("../../utils/isomorphic/stringUtils");
+var import_tool = require("./tool");
+const fillForm = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_fill_form",
+    title: "Fill form",
+    description: "Fill multiple form fields",
+    inputSchema: import_zodBundle.z.object({
+      fields: import_zodBundle.z.array(import_zodBundle.z.object({
+        name: import_zodBundle.z.string().describe("Human-readable field name"),
+        type: import_zodBundle.z.enum(["textbox", "checkbox", "radio", "combobox", "slider"]).describe("Type of the field"),
+        ref: import_zodBundle.z.string().describe("Exact target field reference from the page snapshot"),
+        selector: import_zodBundle.z.string().optional().describe('CSS or role selector for the field element, when "ref" is not available. Either "selector" or "ref" is required.'),
+        value: import_zodBundle.z.string().describe("Value to fill in the field. If the field is a checkbox, the value should be `true` or `false`. If the field is a combobox, the value should be the text of the option.")
+      })).describe("Fields to fill in")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    for (const field of params.fields) {
+      const { locator, resolved } = await tab.refLocator({ element: field.name, ref: field.ref, selector: field.selector });
+      const locatorSource = `await page.${resolved}`;
+      if (field.type === "textbox" || field.type === "slider") {
+        const secret = tab.context.lookupSecret(field.value);
+        await locator.fill(secret.value, tab.actionTimeoutOptions);
+        response.addCode(`${locatorSource}.fill(${secret.code});`);
+      } else if (field.type === "checkbox" || field.type === "radio") {
+        await locator.setChecked(field.value === "true", tab.actionTimeoutOptions);
+        response.addCode(`${locatorSource}.setChecked(${field.value});`);
+      } else if (field.type === "combobox") {
+        await locator.selectOption({ label: field.value }, tab.actionTimeoutOptions);
+        response.addCode(`${locatorSource}.selectOption(${(0, import_stringUtils.escapeWithQuotes)(field.value)});`);
+      }
+    }
+  }
+});
+var form_default = [
+  fillForm
+];

package/lib/tools/backend/keyboard.js

@@ -0,0 +1,155 @@
+"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 keyboard_exports = {};
+__export(keyboard_exports, {
+  default: () => keyboard_default
+});
+module.exports = __toCommonJS(keyboard_exports);
+var import_zodBundle = require("../../zodBundle");
+var import_tool = require("./tool");
+var import_snapshot = require("./snapshot");
+const press = (0, import_tool.defineTabTool)({
+  capability: "core-input",
+  schema: {
+    name: "browser_press_key",
+    title: "Press a key",
+    description: "Press a key on the keyboard",
+    inputSchema: import_zodBundle.z.object({
+      key: import_zodBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`// Press ${params.key}`);
+    response.addCode(`await page.keyboard.press('${params.key}');`);
+    if (params.key === "Enter") {
+      response.setIncludeSnapshot();
+      await tab.waitForCompletion(async () => {
+        await tab.page.keyboard.press("Enter");
+      });
+    } else {
+      await tab.page.keyboard.press(params.key);
+    }
+  }
+});
+const pressSequentially = (0, import_tool.defineTabTool)({
+  capability: "core-input",
+  skillOnly: true,
+  schema: {
+    name: "browser_press_sequentially",
+    title: "Type text key by key",
+    description: "Type text key by key on the keyboard",
+    inputSchema: import_zodBundle.z.object({
+      text: import_zodBundle.z.string().describe("Text to type"),
+      submit: import_zodBundle.z.boolean().optional().describe("Whether to submit entered text (press Enter after)")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`// Press ${params.text}`);
+    response.addCode(`await page.keyboard.type('${params.text}');`);
+    await tab.page.keyboard.type(params.text);
+    if (params.submit) {
+      response.addCode(`await page.keyboard.press('Enter');`);
+      response.setIncludeSnapshot();
+      await tab.waitForCompletion(async () => {
+        await tab.page.keyboard.press("Enter");
+      });
+    }
+  }
+});
+const typeSchema = import_snapshot.elementSchema.extend({
+  text: import_zodBundle.z.string().describe("Text to type into the element"),
+  submit: import_zodBundle.z.boolean().optional().describe("Whether to submit entered text (press Enter after)"),
+  slowly: import_zodBundle.z.boolean().optional().describe("Whether to type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once.")
+});
+const type = (0, import_tool.defineTabTool)({
+  capability: "core-input",
+  schema: {
+    name: "browser_type",
+    title: "Type text",
+    description: "Type text into editable element",
+    inputSchema: typeSchema,
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    const { locator, resolved } = await tab.refLocator(params);
+    const secret = tab.context.lookupSecret(params.text);
+    const action = async () => {
+      if (params.slowly) {
+        response.setIncludeSnapshot();
+        response.addCode(`await page.${resolved}.pressSequentially(${secret.code});`);
+        await locator.pressSequentially(secret.value, tab.actionTimeoutOptions);
+      } else {
+        response.addCode(`await page.${resolved}.fill(${secret.code});`);
+        await locator.fill(secret.value, tab.actionTimeoutOptions);
+      }
+      if (params.submit) {
+        response.setIncludeSnapshot();
+        response.addCode(`await page.${resolved}.press('Enter');`);
+        await locator.press("Enter", tab.actionTimeoutOptions);
+      }
+    };
+    if (params.submit || params.slowly)
+      await tab.waitForCompletion(action);
+    else
+      await action();
+  }
+});
+const keydown = (0, import_tool.defineTabTool)({
+  capability: "core-input",
+  skillOnly: true,
+  schema: {
+    name: "browser_keydown",
+    title: "Press a key down",
+    description: "Press a key down on the keyboard",
+    inputSchema: import_zodBundle.z.object({
+      key: import_zodBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`await page.keyboard.down('${params.key}');`);
+    await tab.page.keyboard.down(params.key);
+  }
+});
+const keyup = (0, import_tool.defineTabTool)({
+  capability: "core-input",
+  skillOnly: true,
+  schema: {
+    name: "browser_keyup",
+    title: "Press a key up",
+    description: "Press a key up on the keyboard",
+    inputSchema: import_zodBundle.z.object({
+      key: import_zodBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`await page.keyboard.up('${params.key}');`);
+    await tab.page.keyboard.up(params.key);
+  }
+});
+var keyboard_default = [
+  press,
+  type,
+  pressSequentially,
+  keydown,
+  keyup
+];