@ejazullah/browser-mcp 0.0.65 → 0.0.67

package/lib/config.js

@@ -134,6 +134,8 @@ export function configFromCLIOptions(cliOptions) {
         saveTrace: cliOptions.saveTrace,
         outputDir: cliOptions.outputDir,
         imageResponses: cliOptions.imageResponses,
+        maxResponseChars: cliOptions.maxResponseChars ? parseInt(cliOptions.maxResponseChars, 10) : undefined,
+        actionSnapshots: cliOptions.actionSnapshots,
         mongodb: {
             url: cliOptions.mongodbUrl,
             dbName: cliOptions.mongodbDb,
@@ -166,6 +168,9 @@ function configFromEnv() {
     options.isolated = envToBoolean(process.env.PLAYWRIGHT_MCP_ISOLATED);
     if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES === 'omit')
         options.imageResponses = 'omit';
+    options.maxResponseChars = envToString(process.env.PLAYWRIGHT_MCP_MAX_RESPONSE_CHARS);
+    if (process.env.PLAYWRIGHT_MCP_ACTION_SNAPSHOTS === 'false' || process.env.PLAYWRIGHT_MCP_ACTION_SNAPSHOTS === '0')
+        options.actionSnapshots = false;
     options.sandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_SANDBOX);
     options.outputDir = envToString(process.env.PLAYWRIGHT_MCP_OUTPUT_DIR);
     options.port = envToNumber(process.env.PLAYWRIGHT_MCP_PORT);

package/lib/program.js

@@ -65,6 +65,8 @@ program
     .option('--ignore-https-errors', 'ignore https errors')
     .option('--isolated', 'keep the browser profile in memory, do not save it to disk.')
     .option('--image-responses <mode>', 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".')
+    .option('--max-response-chars <number>', 'Maximum characters to send in a single response. Default is 40000.')
+    .option('--no-action-snapshots', 'disable automatic snapshots after tool actions like click and scroll.')
     .option('--no-sandbox', 'disable the sandbox for all process types that are normally sandboxed.')
     .option('--output-dir <path>', 'path to the directory for output files.')
     .option('--port <port>', 'port to listen on for SSE transport.')

package/lib/response.js

@@ -20,6 +20,7 @@ export class Response {
     _images = [];
     _context;
     _includeSnapshot = false;
+    _snapshotOffsetLine = 0;
     _includeTabs = false;
     _tabSnapshot;
     _elementInteraction;
@@ -56,8 +57,14 @@ export class Response {
     images() {
         return this._images;
     }
-    setIncludeSnapshot() {
+    setIncludeSnapshot(offsetLine) {
+        if (this._context.config.actionSnapshots === false && this.toolName !== 'browser_snapshot') {
+            return;
+        }
         this._includeSnapshot = true;
+        if (offsetLine !== undefined) {
+            this._snapshotOffsetLine = offsetLine;
+        }
     }
     setIncludeTabs() {
         this._includeTabs = true;
@@ -104,12 +111,20 @@ ${this._code.join('\n')}
             response.push('');
         }
         else if (this._tabSnapshot) {
-            response.push(renderTabSnapshot(this._tabSnapshot));
+            const currentLength = response.join('\n').length;
+            const maxChars = this._context.config.maxResponseChars ?? 40000;
+            const remainingBudget = Math.max(1000, maxChars - currentLength);
+            response.push(renderTabSnapshot(this._tabSnapshot, remainingBudget, this._snapshotOffsetLine));
             response.push('');
         }
         // Main response part
+        let responseText = response.join('\n');
+        const maxChars = this._context.config.maxResponseChars ?? 40000;
+        if (responseText.length > maxChars) {
+            responseText = responseText.slice(0, maxChars - 100) + '\n\n... [Response truncated due to length limits]';
+        }
         const content = [
-            { type: 'text', text: response.join('\n') },
+            { type: 'text', text: responseText },
         ];
         // Image attachments.
         if (this._context.config.imageResponses !== 'omit') {
@@ -119,7 +134,7 @@ ${this._code.join('\n')}
         return { content, isError: this._isError };
     }
 }
-function renderTabSnapshot(tabSnapshot) {
+function renderTabSnapshot(tabSnapshot, maxLength = Infinity, offsetLine = 0) {
     const lines = [];
     if (tabSnapshot.consoleMessages.length) {
         lines.push(`### New console messages`);
@@ -141,8 +156,30 @@ function renderTabSnapshot(tabSnapshot) {
     lines.push(`- Page URL: ${tabSnapshot.url}`);
     lines.push(`- Page Title: ${tabSnapshot.title}`);
     lines.push(`- Page Snapshot:`);
+    const prefix = '```yaml\n';
+    const suffix = '\n```';
+    const currentLength = lines.join('\n').length + prefix.length + suffix.length;
+    const budget = maxLength - currentLength;
+    let ariaSnapshotLines = tabSnapshot.ariaSnapshot.split('\n');
+    if (offsetLine > 0) {
+        ariaSnapshotLines = ariaSnapshotLines.slice(offsetLine);
+    }
+    let includedLines = 0;
+    let currentStringLength = 0;
+    let truncatedAriaSnapshot = '';
+    for (const line of ariaSnapshotLines) {
+        if (currentStringLength + line.length + 1 > budget)
+            break;
+        truncatedAriaSnapshot += line + '\n';
+        currentStringLength += line.length + 1;
+        includedLines++;
+    }
+    if (includedLines < ariaSnapshotLines.length) {
+        const nextOffset = offsetLine + includedLines;
+        truncatedAriaSnapshot += `\n... [ARIA Snapshot truncated due to length limits. To see more, call browser_snapshot with offset set to ${nextOffset}]`;
+    }
     lines.push('```yaml');
-    lines.push(tabSnapshot.ariaSnapshot);
+    lines.push(truncatedAriaSnapshot.trimEnd());
     lines.push('```');
     return lines.join('\n');
 }

package/lib/tools/snapshot.js

@@ -23,12 +23,14 @@ const snapshot = defineTool({
         name: 'browser_snapshot',
         title: 'Page snapshot',
         description: 'Capture accessibility snapshot of the current page, this is better than screenshot',
-        inputSchema: z.object({}),
+        inputSchema: z.object({
+            offset: z.number().int().optional().describe('Used for pagination. Starts reading the snapshot from this line offset. Use the offset provided in the truncation message.'),
+        }),
         type: 'readOnly',
     },
     handle: async (context, params, response) => {
         await context.ensureTab();
-        response.setIncludeSnapshot();
+        response.setIncludeSnapshot(params.offset);
     },
 });
 export const elementSchema = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ejazullah/browser-mcp",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "description": "@ejazullah/browser-mcp - Enhanced Playwright Tools for MCP with CDP Support",
   "type": "module",
   "repository": {