@zibby/mcp-browser 0.1.0 → 0.1.6

package/lib/browser/tab.js

@@ -1,301 +0,0 @@
-"use strict";
-const __defProp = Object.defineProperty;
-const __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-const __getOwnPropNames = Object.getOwnPropertyNames;
-const __hasOwnProp = Object.prototype.hasOwnProperty;
-const __export = (target, all) => {
-  for (const name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-const __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (const 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;
-};
-const __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-const tab_exports = {};
-__export(tab_exports, {
-  Tab: () => Tab,
-  TabEvents: () => TabEvents,
-  renderModalStates: () => renderModalStates
-});
-module.exports = __toCommonJS(tab_exports);
-const import_events = require("events");
-const import_utils = require("playwright-core/lib/utils");
-const import_utils2 = require("./tools/utils");
-const import_log = require("../log");
-const import_dialogs = require("./tools/dialogs");
-const import_files = require("./tools/files");
-const import_transform = require("../../transform/transform");
-const TabEvents = {
-  modalState: "modalState"
-};
-class Tab extends import_events.EventEmitter {
-  constructor(context, page, onPageClose) {
-    super();
-    this._lastTitle = "about:blank";
-    this._consoleMessages = [];
-    this._recentConsoleMessages = [];
-    this._requests = /* @__PURE__ */ new Set();
-    this._modalStates = [];
-    this._downloads = [];
-    this._needsFullSnapshot = false;
-    this.context = context;
-    this.page = page;
-    this._onPageClose = onPageClose;
-    page.on("console", (event) => this._handleConsoleMessage(messageToConsoleMessage(event)));
-    page.on("pageerror", (error) => this._handleConsoleMessage(pageErrorToConsoleMessage(error)));
-    page.on("request", (request) => this._requests.add(request));
-    page.on("close", () => this._onClose());
-    page.on("filechooser", (chooser) => {
-      this.setModalState({
-        type: "fileChooser",
-        description: "File chooser",
-        fileChooser: chooser,
-        clearedBy: import_files.uploadFile.schema.name
-      });
-    });
-    page.on("dialog", (dialog) => this._dialogShown(dialog));
-    page.on("download", (download) => {
-      void this._downloadStarted(download);
-    });
-    page.setDefaultNavigationTimeout(this.context.config.timeouts.navigation);
-    page.setDefaultTimeout(this.context.config.timeouts.action);
-    page[tabSymbol] = this;
-    this.initializedPromise = this._initialize();
-  }
-  static forPage(page) {
-    return page[tabSymbol];
-  }
-  static async collectConsoleMessages(page) {
-    const result = [];
-    const messages = await page.consoleMessages().catch(() => []);
-    for (const message of messages)
-      result.push(messageToConsoleMessage(message));
-    const errors = await page.pageErrors().catch(() => []);
-    for (const error of errors)
-      result.push(pageErrorToConsoleMessage(error));
-    return result;
-  }
-  async _initialize() {
-    for (const message of await Tab.collectConsoleMessages(this.page))
-      this._handleConsoleMessage(message);
-    const requests = await this.page.requests().catch(() => []);
-    for (const request of requests)
-      this._requests.add(request);
-    for (const initPage of this.context.config.browser.initPage || []) {
-      try {
-        const { default: func } = await (0, import_transform.requireOrImport)(initPage);
-        await func({ page: this.page });
-      } catch (e) {
-        (0, import_log.logUnhandledError)(e);
-      }
-    }
-  }
-  modalStates() {
-    return this._modalStates;
-  }
-  setModalState(modalState) {
-    this._modalStates.push(modalState);
-    this.emit(TabEvents.modalState, modalState);
-  }
-  clearModalState(modalState) {
-    this._modalStates = this._modalStates.filter((state) => state !== modalState);
-  }
-  modalStatesMarkdown() {
-    return renderModalStates(this.context, this.modalStates());
-  }
-  _dialogShown(dialog) {
-    this.setModalState({
-      type: "dialog",
-      description: `"${dialog.type()}" dialog with message "${dialog.message()}"`,
-      dialog,
-      clearedBy: import_dialogs.handleDialog.schema.name
-    });
-  }
-  async _downloadStarted(download) {
-    const entry = {
-      download,
-      finished: false,
-      outputFile: await this.context.outputFile(download.suggestedFilename(), { origin: "web", reason: "Saving download" })
-    };
-    this._downloads.push(entry);
-    await download.saveAs(entry.outputFile);
-    entry.finished = true;
-  }
-  _clearCollectedArtifacts() {
-    this._consoleMessages.length = 0;
-    this._recentConsoleMessages.length = 0;
-    this._requests.clear();
-  }
-  _handleConsoleMessage(message) {
-    this._consoleMessages.push(message);
-    this._recentConsoleMessages.push(message);
-  }
-  _onClose() {
-    this._clearCollectedArtifacts();
-    this._onPageClose(this);
-  }
-  async updateTitle() {
-    await this._raceAgainstModalStates(async () => {
-      this._lastTitle = await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.title());
-    });
-  }
-  lastTitle() {
-    return this._lastTitle;
-  }
-  isCurrentTab() {
-    return this === this.context.currentTab();
-  }
-  async waitForLoadState(state, options) {
-    await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForLoadState(state, options).catch(import_log.logUnhandledError));
-  }
-  async navigate(url) {
-    this._clearCollectedArtifacts();
-    const downloadEvent = (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForEvent("download").catch(import_log.logUnhandledError));
-    try {
-      await this.page.goto(url, { waitUntil: "domcontentloaded" });
-    } catch (_e) {
-      const e = _e;
-      const mightBeDownload = e.message.includes("net::ERR_ABORTED") || e.message.includes("Download is starting");
-      if (!mightBeDownload)
-        throw e;
-      const download = await Promise.race([
-        downloadEvent,
-        new Promise((resolve) => setTimeout(resolve, 3e3))
-      ]);
-      if (!download)
-        throw e;
-      await new Promise((resolve) => setTimeout(resolve, 500));
-      return;
-    }
-    await this.waitForLoadState("load", { timeout: 5e3 });
-  }
-  async consoleMessages(type) {
-    await this.initializedPromise;
-    return this._consoleMessages.filter((message) => type ? message.type === type : true);
-  }
-  async requests() {
-    await this.initializedPromise;
-    return this._requests;
-  }
-  async captureSnapshot() {
-    let tabSnapshot;
-    const modalStates = await this._raceAgainstModalStates(async () => {
-      const snapshot = await this.page._snapshotForAI({ track: "response" });
-      tabSnapshot = {
-        url: this.page.url(),
-        title: await this.page.title(),
-        ariaSnapshot: snapshot.full,
-        ariaSnapshotDiff: this._needsFullSnapshot ? void 0 : snapshot.incremental,
-        modalStates: [],
-        consoleMessages: [],
-        downloads: this._downloads
-      };
-    });
-    if (tabSnapshot) {
-      tabSnapshot.consoleMessages = this._recentConsoleMessages;
-      this._recentConsoleMessages = [];
-    }
-    this._needsFullSnapshot = !tabSnapshot;
-    return tabSnapshot ?? {
-      url: this.page.url(),
-      title: "",
-      ariaSnapshot: "",
-      modalStates,
-      consoleMessages: [],
-      downloads: []
-    };
-  }
-  _javaScriptBlocked() {
-    return this._modalStates.some((state) => state.type === "dialog");
-  }
-  async _raceAgainstModalStates(action) {
-    if (this.modalStates().length)
-      return this.modalStates();
-    const promise = new import_utils.ManualPromise();
-    const listener = (modalState) => promise.resolve([modalState]);
-    this.once(TabEvents.modalState, listener);
-    return await Promise.race([
-      action().then(() => {
-        this.off(TabEvents.modalState, listener);
-        return [];
-      }),
-      promise
-    ]);
-  }
-  async waitForCompletion(callback) {
-    await this._raceAgainstModalStates(() => (0, import_utils2.waitForCompletion)(this, callback));
-  }
-  async refLocator(params) {
-    return (await this.refLocators([params]))[0];
-  }
-  async refLocators(params) {
-    return Promise.all(params.map(async (param) => {
-      try {
-        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
-        const { resolvedSelector } = await locator._resolveSelector();
-        
-        // ZIBBY: Capture stable ID from element BEFORE action
-        let stableId = null;
-        try {
-          stableId = await locator.getAttribute('data-zibby-id');
-        } catch (e) {
-          // Element may not have stable ID yet
-        }
-        
-        return { locator, resolved: (0, import_utils.asLocator)("javascript", resolvedSelector), stableId };
-      } catch (e) {
-        throw new Error(`Ref ${param.ref} not found in the current page snapshot. Try capturing new snapshot.`);
-      }
-    }));
-  }
-  async waitForTimeout(time) {
-    if (this._javaScriptBlocked()) {
-      await new Promise((f) => setTimeout(f, time));
-      return;
-    }
-    await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => {
-      return page.evaluate(() => new Promise((f) => setTimeout(f, 1e3)));
-    });
-  }
-}
-function messageToConsoleMessage(message) {
-  return {
-    type: message.type(),
-    text: message.text(),
-    toString: () => `[${message.type().toUpperCase()}] ${message.text()} @ ${message.location().url}:${message.location().lineNumber}`
-  };
-}
-function pageErrorToConsoleMessage(errorOrValue) {
-  if (errorOrValue instanceof Error) {
-    return {
-      type: "error",
-      text: errorOrValue.message,
-      toString: () => errorOrValue.stack || errorOrValue.message
-    };
-  }
-  return {
-    type: "error",
-    text: String(errorOrValue),
-    toString: () => String(errorOrValue)
-  };
-}
-function renderModalStates(context, modalStates) {
-  const result = ["### Modal state"];
-  if (modalStates.length === 0)
-    result.push("- There is no modal state present");
-  for (const state of modalStates)
-    result.push(`- [${state.description}]: can be handled by the "${state.clearedBy}" tool`);
-  return result;
-}
-const tabSymbol = Symbol("tabSymbol");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Tab,
-  TabEvents,
-  renderModalStates
-});

package/lib/browser/tools/common.js

@@ -1,67 +0,0 @@
-"use strict";
-const __defProp = Object.defineProperty;
-const __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-const __getOwnPropNames = Object.getOwnPropertyNames;
-const __hasOwnProp = Object.prototype.hasOwnProperty;
-const __export = (target, all) => {
-  for (const name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-const __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (const 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;
-};
-const __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-const common_exports = {};
-__export(common_exports, {
-  default: () => common_default
-});
-module.exports = __toCommonJS(common_exports);
-const import_bundle = require("../../sdk/bundle");
-const import_tool = require("./tool");
-const close = (0, import_tool.defineTool)({
-  capability: "core",
-  schema: {
-    name: "browser_close",
-    title: "Close browser",
-    description: "Close the page",
-    inputSchema: import_bundle.z.object({}),
-    type: "action"
-  },
-  handle: async (context, params, response) => {
-    // ZIBBY: Record close event BEFORE closing
-    if (typeof global.__zibbyRecordEvent === 'function') {
-      global.__zibbyRecordEvent('close', {});
-    }
-    await context.closeBrowserContext();
-    response.setIncludeTabs();
-    response.addCode(`await page.close()`);
-  }
-});
-const resize = (0, import_tool.defineTabTool)({
-  capability: "core",
-  schema: {
-    name: "browser_resize",
-    title: "Resize browser window",
-    description: "Resize the browser window",
-    inputSchema: import_bundle.z.object({
-      width: import_bundle.z.number().describe("Width of the browser window"),
-      height: import_bundle.z.number().describe("Height of the browser window")
-    }),
-    type: "action"
-  },
-  handle: async (tab, params, response) => {
-    response.addCode(`await page.setViewportSize({ width: ${params.width}, height: ${params.height} });`);
-    await tab.waitForCompletion(async () => {
-      await tab.page.setViewportSize({ width: params.width, height: params.height });
-    });
-  }
-});
-var common_default = [
-  close,
-  resize
-];

package/lib/browser/tools/keyboard.js

@@ -1,88 +0,0 @@
-"use strict";
-const __defProp = Object.defineProperty;
-const __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-const __getOwnPropNames = Object.getOwnPropertyNames;
-const __hasOwnProp = Object.prototype.hasOwnProperty;
-const __export = (target, all) => {
-  for (const name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-const __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (const 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;
-};
-const __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-const keyboard_exports = {};
-__export(keyboard_exports, {
-  default: () => keyboard_default
-});
-module.exports = __toCommonJS(keyboard_exports);
-const import_bundle = require("../../sdk/bundle");
-const import_tool = require("./tool");
-const import_snapshot = require("./snapshot");
-const pressKey = (0, import_tool.defineTabTool)({
-  capability: "core",
-  schema: {
-    name: "browser_press_key",
-    title: "Press a key",
-    description: "Press a key on the keyboard",
-    inputSchema: import_bundle.z.object({
-      key: import_bundle.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.setIncludeSnapshot();
-    response.addCode(`// Press ${params.key}`);
-    response.addCode(`await page.keyboard.press('${params.key}');`);
-    await tab.waitForCompletion(async () => {
-      await tab.page.keyboard.press(params.key);
-    });
-  }
-});
-const typeSchema = import_snapshot.elementSchema.extend({
-  text: import_bundle.z.string().describe("Text to type into the element"),
-  submit: import_bundle.z.boolean().optional().describe("Whether to submit entered text (press Enter after)"),
-  slowly: import_bundle.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",
-  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, stableId } = 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);
-      } else {
-        response.addCode(`await page.${resolved}.fill(${secret.code});`);
-        await locator.fill(secret.value);
-      }
-      if (params.submit) {
-        response.setIncludeSnapshot();
-        response.addCode(`await page.${resolved}.press('Enter');`);
-        await locator.press("Enter");
-      }
-    });
-    // ZIBBY: Record event with stable ID
-    if (typeof global.__zibbyRecordEvent === 'function') {
-      global.__zibbyRecordEvent('type', { element: params.element, ref: params.ref, text: params.text, stableId });
-    }
-  }
-});
-var keyboard_default = [
-  pressKey,
-  type
-];

package/lib/browser/tools/navigate.js

@@ -1,66 +0,0 @@
-"use strict";
-const __defProp = Object.defineProperty;
-const __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-const __getOwnPropNames = Object.getOwnPropertyNames;
-const __hasOwnProp = Object.prototype.hasOwnProperty;
-const __export = (target, all) => {
-  for (const name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-const __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (const 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;
-};
-const __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-const navigate_exports = {};
-__export(navigate_exports, {
-  default: () => navigate_default
-});
-module.exports = __toCommonJS(navigate_exports);
-const import_bundle = require("../../sdk/bundle");
-const import_tool = require("./tool");
-const navigate = (0, import_tool.defineTool)({
-  capability: "core",
-  schema: {
-    name: "browser_navigate",
-    title: "Navigate to a URL",
-    description: "Navigate to a URL",
-    inputSchema: import_bundle.z.object({
-      url: import_bundle.z.string().describe("The URL to navigate to")
-    }),
-    type: "action"
-  },
-  handle: async (context, params, response) => {
-    const tab = await context.ensureTab();
-    await tab.navigate(params.url);
-    response.setIncludeSnapshot();
-    response.addCode(`await page.goto('${params.url}');`);
-    // ZIBBY: Record navigate event
-    if (typeof global.__zibbyRecordEvent === 'function') {
-      global.__zibbyRecordEvent('navigate', { url: params.url });
-    }
-  }
-});
-const goBack = (0, import_tool.defineTabTool)({
-  capability: "core",
-  schema: {
-    name: "browser_navigate_back",
-    title: "Go back",
-    description: "Go back to the previous page",
-    inputSchema: import_bundle.z.object({}),
-    type: "action"
-  },
-  handle: async (tab, params, response) => {
-    await tab.page.goBack();
-    response.setIncludeSnapshot();
-    response.addCode(`await page.goBack();`);
-  }
-});
-var navigate_default = [
-  navigate,
-  goBack
-];