@diegosouzacdv/jev-browser-mcp 0.6.1 → 0.6.2

package/mcp_servers/jev-browser-npm/src/server.mjs

@@ -21,7 +21,8 @@ class BrowserPool {
   #startedAt;
   #everStarted = false;
   #navigationError;
-  #flowQueue = Promise.resolve();
+  #flowQueue = Promise.resolve();
+  #configurationKey;
 
   constructor(settings) {
     this.#settings = settings;
@@ -47,12 +48,15 @@ class BrowserPool {
     }
   }
 
-  async getPage() {
-    let isOpening = !this.#contextPromise;
-    if (isOpening) {
-      this.#everStarted = true;
-      this.#startedAt = performance.now();
-      this.#contextPromise = this.#open();
+  async getPage(configuration = {}) {
+    const configurationKey = JSON.stringify(configuration);
+    if (this.#contextPromise && this.#configurationKey !== configurationKey) await this.close();
+    let isOpening = !this.#contextPromise;
+    if (isOpening) {
+      this.#everStarted = true;
+      this.#startedAt = performance.now();
+      this.#configurationKey = configurationKey;
+      this.#contextPromise = this.#open(configuration);
     }
     try {
       await this.#contextPromise;
@@ -64,7 +68,8 @@ class BrowserPool {
       if (!isOpening) {
         isOpening = true;
         this.#startedAt = performance.now();
-        this.#contextPromise = this.#open();
+        this.#configurationKey = configurationKey;
+        this.#contextPromise = this.#open(configuration);
         await this.#contextPromise;
       } else {
         throw error;
@@ -93,7 +98,7 @@ class BrowserPool {
     }
   }
 
-  async restart() {
+  async restart() {
     await this.close();
     this.#everStarted = true;
     this.#startedAt = performance.now();
@@ -104,7 +109,12 @@ class BrowserPool {
     } catch (error) {
       return { status: "disconnected", connected: false, restarted: true, reason: error?.message || error?.name || "browser unavailable" };
     }
-  }
+  }
+
+  async replaceClosedPage(page) {
+    if (this.#page !== page || !this.#context) return;
+    this.#page = this.#context.pages()[0] || await this.#context.newPage();
+  }
 
   #watchContext(context, browser) {
     context.once("close", () => {
@@ -115,19 +125,21 @@ class BrowserPool {
     });
   }
 
-  async #open() {
+  async #open({ contextOptions = {}, launchArgs = [] } = {}) {
     const { mode, channel, profileDir } = this.#settings.browser;
     try {
       if (mode === "computer") {
-        this.#context = await chromium.launchPersistentContext(profileDir, {
-          channel,
-          headless: false,
-        });
+        this.#context = await chromium.launchPersistentContext(profileDir, {
+          channel,
+          headless: false,
+          args: launchArgs,
+          ...contextOptions,
+        });
         this.#watchContext(this.#context);
         this.#page = this.#context.pages()[0] || await this.#context.newPage();
       } else {
-        this.#browser = await chromium.launch({ channel, headless: true });
-        this.#context = await this.#browser.newContext();
+        this.#browser = await chromium.launch({ channel, headless: true, args: launchArgs });
+        this.#context = await this.#browser.newContext(contextOptions);
         this.#watchContext(this.#context, this.#browser);
         this.#page = await this.#context.newPage();
       }
@@ -150,8 +162,9 @@ class BrowserPool {
     this.#context = undefined;
     this.#browser = undefined;
     this.#page = undefined;
-    this.#contextPromise = undefined;
-    this.#navigationError = undefined;
+    this.#contextPromise = undefined;
+    this.#navigationError = undefined;
+    this.#configurationKey = undefined;
   }
 }
 
@@ -164,11 +177,46 @@ function toolError(error, settings) {
   return { isError: true, content: [{ type: "text", text: `[jev-browser ${packageManifest.version}] ${message}` }] };
 }
 
-function toolText(value) {
-  const versioned = value && typeof value === "object" && !Array.isArray(value)
-    ? { ...value, server_version: packageManifest.version }
-    : { result: value, server_version: packageManifest.version };
-  return { content: [{ type: "text", text: JSON.stringify(versioned) }] };
+export function fitToolResponse(value, maxBytes) {
+  const clone = structuredClone(value && typeof value === "object" ? value : { result: value });
+  const measure = () => Buffer.byteLength(JSON.stringify(clone), "utf8");
+  if (measure() <= maxBytes) return clone;
+  clone.output_truncated = true;
+  delete clone.unnamed_controls;
+  if (typeof clone.final_snapshot === "string") clone.final_snapshot = "[snapshot omitted to fit the configured MCP response limit]";
+  for (const key of ["unnamed_controls_initial", "unnamed_controls_final"]) {
+    if (Array.isArray(clone[key])) clone[key] = clone[key].map(({ role, index, nearest_label }) => ({ role, index, nearest_label }));
+  }
+  for (const key of ["console_errors", "network_failures", "warnings"]) {
+    if (Array.isArray(clone[key])) clone[key] = clone[key].slice(-10);
+  }
+  for (const step of clone.steps || []) {
+    delete step.html;
+    if (typeof step.error === "string") step.error = step.error.slice(0, 300);
+  }
+  while (measure() > maxBytes) {
+    if (Array.isArray(clone.steps) && clone.steps.length > 4) clone.steps.splice(1, clone.steps.length - 4);
+    else if (Array.isArray(clone.network_failures) && clone.network_failures.length) clone.network_failures.shift();
+    else if (Array.isArray(clone.console_errors) && clone.console_errors.length) clone.console_errors.shift();
+    else if (Array.isArray(clone.warnings) && clone.warnings.length) clone.warnings.shift();
+    else break;
+  }
+  if (measure() <= maxBytes) return clone;
+  return {
+    ...(clone.server_version ? { server_version: clone.server_version } : {}),
+    status: clone.status || "failed",
+    output_truncated: true,
+    ...(clone.reason ? { reason: String(clone.reason).slice(0, 300) } : {}),
+    ...(Number.isSafeInteger(clone.steps_executed) ? { steps_executed: clone.steps_executed } : {}),
+  };
+}
+
+function toolText(value, maxBytes) {
+  const versioned = value && typeof value === "object" && !Array.isArray(value)
+    ? { ...value, server_version: packageManifest.version }
+    : { result: value, server_version: packageManifest.version };
+  const bounded = maxBytes ? fitToolResponse(versioned, maxBytes) : versioned;
+  return { content: [{ type: "text", text: JSON.stringify(bounded) }] };
 }
 
 export function profileOwnerPidFromProcessList(processes, profileDir, platform = process.platform) {
@@ -242,7 +290,10 @@ export function createJevBrowserServer({ env = process.env, configPath, fetchImp
       description: "Check the managed browser connection; set restart=true to close and restart only the browser session owned by this MCP process.",
       inputSchema: { restart: z.boolean().optional() },
     },
-    async ({ restart = false } = {}) => toolText(restart ? await browserPool.restart() : await browserPool.health()),
+    async ({ restart = false } = {}) => toolText(
+      restart ? await browserPool.restart() : await browserPool.health(),
+      settings.browser.maxToolResponseBytes,
+    ),
   );
 
   server.registerTool(
@@ -259,7 +310,10 @@ export function createJevBrowserServer({ env = process.env, configPath, fetchImp
     },
     async ({ flow, page_snapshot: pageSnapshot, actions, completed_steps: completedSteps, local_only: localOnly }) => {
       try {
-        return toolText(await chooseNextAction({ flow, pageSnapshot, actions, completedSteps, localOnly, settings, fetchImpl }));
+        return toolText(
+          await chooseNextAction({ flow, pageSnapshot, actions, completedSteps, localOnly, settings, fetchImpl }),
+          settings.browser.maxToolResponseBytes,
+        );
       } catch (error) {
         return toolError(error, settings);
       }
@@ -281,7 +335,7 @@ export function createJevBrowserServer({ env = process.env, configPath, fetchImp
     },
     async ({ flow, initial_url: initialUrl, expected_outcome: expectedOutcome, candidate_plans: candidatePlans, params, options }) => {
       try {
-        return toolText(await browserPool.runFlow(async () => {
+        return toolText(await browserPool.runFlow(async () => {
           const args = {
           flow,
           initialUrl,
@@ -302,7 +356,7 @@ export function createJevBrowserServer({ env = process.env, configPath, fetchImp
           if (!recovery.connected) return { ...first, browser_restart: recovery, retry_count: 0 };
           const retry = await executeBrowserFlow({ ...args, options: { ...options, reuse_page: false } });
           return { ...retry, browser_restart: recovery, retry_count: 1 };
-        }));
+        }), settings.browser.maxToolResponseBytes);
       } catch (error) {
         return toolError(error, settings);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegosouzacdv/jev-browser-mcp",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Portable MCP server for bounded Playwright screen flows selected by Jev",
   "license": "MIT",
   "repository": {