@treegress.com/treegress-browser-core 1.59.0-treegress.3

package/lib/tools/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_mcpBundle = require("../mcpBundle");
+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_mcpBundle.z.object({
+      accept: import_mcpBundle.z.boolean().describe("Whether to accept the dialog."),
+      promptText: import_mcpBundle.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/evaluate.js

@@ -0,0 +1,61 @@
+"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_mcpBundle = require("../mcpBundle");
+var import_stringUtils = require("../utils/isomorphic/stringUtils");
+var import_tool = require("./tool");
+const evaluateSchema = import_mcpBundle.z.object({
+  function: import_mcpBundle.z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
+  element: import_mcpBundle.z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
+  ref: import_mcpBundle.z.string().optional().describe("Exact target element reference from the page snapshot")
+});
+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, 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 receiver = locator?.locator ?? tab.page;
+      const result = await receiver._evaluateFunction(params.function);
+      const text = JSON.stringify(result, null, 2) || "undefined";
+      response.addTextResult(text);
+    });
+  }
+});
+var evaluate_default = [
+  evaluate
+];

package/lib/tools/exports.js

@@ -0,0 +1,57 @@
+"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 exports_exports = {};
+__export(exports_exports, {
+  BrowserServerBackend: () => import_browserServerBackend.BrowserServerBackend,
+  CustomDomResolverError: () => import_customDomResolverDiagnostics.CustomDomResolverError,
+  Tab: () => import_tab.Tab,
+  browserTools: () => import_tools.browserTools,
+  compileLocatorCandidatesFromPlan: () => import_customDomLocatorCompiler.compileLocatorCandidatesFromPlan,
+  customDomStableLocatorKey: () => import_customDomSnapshotFormatter.customDomStableLocatorKey,
+  filteredTools: () => import_tools2.filteredTools,
+  formatCustomDomResolverDiagnostics: () => import_customDomResolverDiagnostics.formatCustomDomResolverDiagnostics,
+  formatCustomDomSnapshot: () => import_customDomSnapshotFormatter.formatCustomDomSnapshot,
+  inspectLocatorCandidates: () => import_customDomLocatorCompiler.inspectLocatorCandidates,
+  isCustomDomSnapshotEnvelope: () => import_customDomSnapshotFormatter.isCustomDomSnapshotEnvelope,
+  parseResponse: () => import_response.parseResponse
+});
+module.exports = __toCommonJS(exports_exports);
+var import_browserServerBackend = require("./browserServerBackend");
+var import_tools = require("./tools");
+var import_tools2 = require("./tools");
+var import_response = require("./response");
+var import_tab = require("./tab");
+var import_customDomLocatorCompiler = require("./customDomLocatorCompiler");
+var import_customDomResolverDiagnostics = require("./customDomResolverDiagnostics");
+var import_customDomSnapshotFormatter = require("./customDomSnapshotFormatter");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserServerBackend,
+  CustomDomResolverError,
+  Tab,
+  browserTools,
+  compileLocatorCandidatesFromPlan,
+  customDomStableLocatorKey,
+  filteredTools,
+  formatCustomDomResolverDiagnostics,
+  formatCustomDomSnapshot,
+  inspectLocatorCandidates,
+  isCustomDomSnapshotEnvelope,
+  parseResponse
+});

package/lib/tools/files.js

@@ -0,0 +1,58 @@
+"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_mcpBundle = require("../mcpBundle");
+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_mcpBundle.z.object({
+      paths: import_mcpBundle.z.array(import_mcpBundle.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");
+    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/form.js

@@ -0,0 +1,63 @@
+"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_mcpBundle = require("../mcpBundle");
+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_mcpBundle.z.object({
+      fields: import_mcpBundle.z.array(import_mcpBundle.z.object({
+        name: import_mcpBundle.z.string().describe("Human-readable field name"),
+        type: import_mcpBundle.z.enum(["textbox", "checkbox", "radio", "combobox", "slider"]).describe("Type of the field"),
+        ref: import_mcpBundle.z.string().describe("Exact target field reference from the page snapshot"),
+        value: import_mcpBundle.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 });
+      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/keyboard.js

@@ -0,0 +1,151 @@
+"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_mcpBundle = require("../mcpBundle");
+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_mcpBundle.z.object({
+      key: import_mcpBundle.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_mcpBundle.z.object({
+      text: import_mcpBundle.z.string().describe("Text to type"),
+      submit: import_mcpBundle.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_mcpBundle.z.string().describe("Text to type into the element"),
+  submit: import_mcpBundle.z.boolean().optional().describe("Whether to submit entered text (press Enter after)"),
+  slowly: import_mcpBundle.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);
+    await tab.waitForCompletion(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);
+      }
+    });
+  }
+});
+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_mcpBundle.z.object({
+      key: import_mcpBundle.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_mcpBundle.z.object({
+      key: import_mcpBundle.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
+];

package/lib/tools/logFile.js

@@ -0,0 +1,95 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var logFile_exports = {};
+__export(logFile_exports, {
+  LogFile: () => LogFile
+});
+module.exports = __toCommonJS(logFile_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utilsBundle = require("../utilsBundle");
+class LogFile {
+  constructor(context, startTime, filePrefix, title) {
+    this._stopped = false;
+    this._line = 0;
+    this._entries = 0;
+    this._lastLine = 0;
+    this._lastEntries = 0;
+    this._writeChain = Promise.resolve();
+    this._context = context;
+    this._startTime = startTime;
+    this._filePrefix = filePrefix;
+    this._title = title;
+  }
+  appendLine(wallTime, text) {
+    this._writeChain = this._writeChain.then(() => this._write(wallTime, text)).catch((e) => (0, import_utilsBundle.debug)("pw:tools:error")(e));
+  }
+  stop() {
+    this._stopped = true;
+  }
+  async take(relativeTo) {
+    const logChunk = await this._take();
+    if (!logChunk)
+      return void 0;
+    const logFilePath = relativeTo ? import_path.default.relative(relativeTo, logChunk.file) : logChunk.file;
+    const lineRange = logChunk.fromLine === logChunk.toLine ? `#L${logChunk.fromLine}` : `#L${logChunk.fromLine}-L${logChunk.toLine}`;
+    return `${logFilePath}${lineRange}`;
+  }
+  async _take() {
+    await this._writeChain;
+    if (!this._file || this._entries === this._lastEntries)
+      return void 0;
+    const chunk = {
+      type: this._title.toLowerCase(),
+      file: this._file,
+      fromLine: this._lastLine + 1,
+      toLine: this._line,
+      entryCount: this._entries - this._lastEntries
+    };
+    this._lastLine = this._line;
+    this._lastEntries = this._entries;
+    return chunk;
+  }
+  async _write(wallTime, text) {
+    if (this._stopped)
+      return;
+    this._file ??= await this._context.outputFile({ prefix: this._filePrefix, ext: "log", date: new Date(this._startTime) }, { origin: "code" });
+    const relativeTime = Math.round(wallTime - this._startTime);
+    const logLine = `[${String(relativeTime).padStart(8, " ")}ms] ${text()}
+`;
+    await import_fs.default.promises.appendFile(this._file, logLine);
+    const lineCount = logLine.split("\n").length - 1;
+    this._line += lineCount;
+    this._entries++;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LogFile
+});