mcpbrowser 0.3.44 → 0.3.45

package/src/actions/type-text.js

@@ -16,7 +16,7 @@ import logger from '../core/logger.js';
 // ============================================================================
 
 /**
- * Response for successful type_text operations
+ * Response for successful browser_type_text operations
  */
 export class TypeTextSuccessResponse extends MCPResponse {
   /**
@@ -64,9 +64,9 @@ export class TypeTextSuccessResponse extends MCPResponse {
  * @type {Tool}
  */
 export const TYPE_TEXT_TOOL = {
-  name: "type_text",
+  name: "browser_type_text",
   title: "Type Text",
-  description: "**BROWSER INTERACTION** - Types text into multiple input fields on browser-loaded pages in a single call. Use this for filling forms, entering search queries, or any text input on the page.\n\nWorks with input fields, textareas, and other editable elements. Supports filling multiple fields at once for efficient form filling.\n\n**PREREQUISITE**: Page MUST be loaded with fetch_webpage first. This tool operates on an already-loaded page in the browser.",
+  description: "**BROWSER INTERACTION** - Types text into multiple input fields on browser-loaded pages in a single call. Use this for filling forms, entering search queries, or any text input on the page.\n\nWorks with input fields, textareas, and other editable elements. Supports filling multiple fields at once for efficient form filling.\n\n**PREREQUISITE**: Page MUST be loaded with browser_fetch_webpage first. This tool operates on an already-loaded page in the browser.",
   inputSchema: {
     type: "object",
     properties: {
@@ -137,7 +137,7 @@ const TYPE_DELAY_MS = 10;
  */
 export async function typeText({ url, fields, returnHtml = true, removeUnnecessaryHTML = true, postTypeWait = 1000 }) {
   const startTime = Date.now();
-  logger.info(`type_text called: ${fields?.length || 0} fields, url=${url}`);
+  logger.info(`browser_type_text called: ${fields?.length || 0} fields, url=${url}`);
   
   if (!url) {
     throw new Error("url parameter is required");
@@ -169,7 +169,7 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
   try {
     await getBrowser();
   } catch (err) {
-    logger.error(`type_text: Failed to connect to browser: ${err.message}`);
+    logger.error(`browser_type_text: Failed to connect to browser: ${err.message}`);
     return new InformationalResponse(
       `Browser connection failed: ${err.message}`,
       'The browser must be running with remote debugging enabled.',
@@ -186,15 +186,15 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
   
   if (!page) {
     const isConnectionLost = pageError && pageError.includes('connection');
-    logger.debug(`type_text: ${pageError || 'No page found for ' + hostname}`);
+    logger.debug(`browser_type_text: ${pageError || 'No page found for ' + hostname}`);
     return new InformationalResponse(
       isConnectionLost ? `Page connection lost for ${hostname}` : `No open page found for ${hostname}`,
       isConnectionLost 
         ? 'The browser tab was closed or the connection was lost. The page needs to be reloaded.'
         : 'The page must be loaded before you can type text into elements',
       [
-        "Use MCPBrowser's fetch_webpage tool to load the page first",
-        "Then retry MCPBrowser's type_text with the same URL"
+        "Use MCPBrowser's browser_fetch_webpage tool to load the page first",
+        "Then retry MCPBrowser's browser_type_text with the same URL"
       ]
     );
   }
@@ -239,20 +239,20 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
     const html = returnHtml ? await extractAndProcessHtml(page, removeUnnecessaryHTML) : null;
     const nextSteps = returnHtml
       ? [
-          "Use MCPBrowser's type_text to fill additional fields",
-          "Use MCPBrowser's click_element to submit the form or navigate",
-          "Use MCPBrowser's get_current_html to check for validation messages",
-          "Use MCPBrowser's take_screenshot if form has visual feedback or validation that's hard to parse from HTML",
-          "Use MCPBrowser's close_tab when finished"
+          "Use MCPBrowser's browser_type_text to fill additional fields",
+          "Use MCPBrowser's browser_click_element to submit the form or navigate",
+          "Use MCPBrowser's browser_get_current_html to check for validation messages",
+          "Use MCPBrowser's browser_take_screenshot if form has visual feedback or validation that's hard to parse from HTML",
+          "Use MCPBrowser's browser_close_tab when finished"
         ]
       : [
-          "Use MCPBrowser's get_current_html to see updated page state",
-          "Use MCPBrowser's take_screenshot if the page has visual feedback that's hard to parse",
-          "Use MCPBrowser's type_text for additional fields or MCPBrowser's click_element to submit",
-          "Use MCPBrowser's close_tab when finished"
+          "Use MCPBrowser's browser_get_current_html to see updated page state",
+          "Use MCPBrowser's browser_take_screenshot if the page has visual feedback that's hard to parse",
+          "Use MCPBrowser's browser_type_text for additional fields or MCPBrowser's browser_click_element to submit",
+          "Use MCPBrowser's browser_close_tab when finished"
         ];
     
-    logger.info(`type_text completed: typed into ${fieldsSummary}${returnHtml ? '' : ' (no HTML)'}`);
+    logger.info(`browser_type_text completed: typed into ${fieldsSummary}${returnHtml ? '' : ' (no HTML)'}`);
     
     return new TypeTextSuccessResponse(currentUrl, `Typed text into: ${fieldsSummary}`, html, nextSteps);
   } catch (err) {
@@ -272,29 +272,29 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
     if (isNotFound) {
       reason = `Selector not found: "${currentSelector}". The element may not exist on the page or have a different selector.`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to find the correct selector",
-        "Use MCPBrowser's take_screenshot to visually inspect the form",
+        "Use MCPBrowser's browser_get_current_html to find the correct selector",
+        "Use MCPBrowser's browser_take_screenshot to visually inspect the form",
         "Check for typos in the selector or try a simpler selector (e.g., 'input[type=\"text\"]')",
         "The element may load dynamically - try increasing waitForElementTimeout"
       ];
     } else if (isNotVisible) {
       reason = `Element "${currentSelector}" exists but is not visible. It may be hidden, collapsed, or off-screen.`;
       nextSteps = [
-        "Use MCPBrowser's take_screenshot to see the page state",
-        "Use MCPBrowser's click_element to expand/show the form section first",
-        "Use MCPBrowser's scroll_page to bring the element into view"
+        "Use MCPBrowser's browser_take_screenshot to see the page state",
+        "Use MCPBrowser's browser_click_element to expand/show the form section first",
+        "Use MCPBrowser's browser_scroll_page to bring the element into view"
       ];
     } else if (isDetached) {
       reason = `Element "${currentSelector}" was removed from the page during interaction. The page may have reloaded or updated.`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to check current page state",
-        "Retry the type_text call - the page may have stabilized"
+        "Use MCPBrowser's browser_get_current_html to check current page state",
+        "Retry the browser_type_text call - the page may have stabilized"
       ];
     } else {
       reason = `Failed to interact with "${currentSelector}": ${errorMsg}`;
       nextSteps = [
-        "Use MCPBrowser's get_current_html to verify page state",
-        "Use MCPBrowser's take_screenshot to see what's on the page visually",
+        "Use MCPBrowser's browser_get_current_html to verify page state",
+        "Use MCPBrowser's browser_take_screenshot to see what's on the page visually",
         "The element may be disabled or read-only"
       ];
     }
@@ -307,7 +307,7 @@ export async function typeText({ url, fields, returnHtml = true, removeUnnecessa
       progressInfo = `Failed on field ${failedFieldNum} of ${totalFields}. Successfully filled ${filledSelectors.length} field(s): ${filledSelectors.join(', ')}. Do NOT re-type these fields.`;
     }
     
-    logger.error(`type_text failed on field ${failedFieldNum}/${totalFields} (${currentSelector}): ${errorMsg}`);
+    logger.error(`browser_type_text failed on field ${failedFieldNum}/${totalFields} (${currentSelector}): ${errorMsg}`);
     
     return new InformationalResponse(
       `${progressInfo}`,

package/src/cli/help.js

@@ -162,7 +162,7 @@ export function printHelp() {
   o('━'.repeat(70));
   o('');
   o('  No arguments → starts MCP server (stdin/stdout JSON-RPC).');
-  o('  CLI commands map 1:1 to MCP tools (fetch→fetch_webpage, etc.).');
+  o('  CLI commands map 1:1 to MCP tools (fetch→browser_fetch_webpage, etc.).');
   o('');
   o('  { "mcpServers": { "mcpbrowser": { "command": "npx", "args": ["-y", "mcpbrowser@latest"] } } }');
   o('');

package/src/core/logger.js

@@ -1,5 +1,7 @@
 /**
  * Logger - Emits to stderr and, when available, via MCP logging notifications.
+ * Also sends MCP progress notifications (notifications/progress) when a
+ * progressToken is active, so agents see real-time status during tool execution.
  * Stderr stays the primary sink to avoid interfering with MCP stdout traffic.
  */
 
@@ -8,6 +10,10 @@ const PREFIX = '[MCPBrowser]';
 // Optional MCP server reference for notifications/message logs.
 let mcpServer = null;
 
+// MCP progress tracking — set per-request by the request handler.
+let _progressToken = null;
+let _progressStep = 0;
+
 // Optional stdout mirroring (off by default to avoid corrupting MCP stdout).
 // Auto-enable during tests so test runners capture output.
 let consoleOutputEnabled = process.env.NODE_ENV === 'test';
@@ -32,6 +38,25 @@ function setConsoleOutput(enabled = true) {
   consoleOutputEnabled = !!enabled;
 }
 
+/**
+ * Set the MCP progress token for the current request.
+ * While set, every logger.info() call also sends a notifications/progress
+ * message so the agent sees real-time status during tool execution.
+ * @param {string|number|null|undefined} token - progressToken from request._meta
+ */
+function setProgressToken(token) {
+  _progressToken = token ?? null;
+  _progressStep = 0;
+}
+
+/**
+ * Clear the progress token after the request completes.
+ */
+function clearProgressToken() {
+  _progressToken = null;
+  _progressStep = 0;
+}
+
 async function notifyAgent(level, data) {
   if (!mcpServer?.sendLoggingMessage) return;
   try {
@@ -44,6 +69,28 @@ async function notifyAgent(level, data) {
   }
 }
 
+/**
+ * Send an MCP progress notification if a progressToken is active.
+ * Called automatically from info-level log messages.
+ * @param {string} message - Human-readable progress message
+ */
+async function sendProgress(message) {
+  if (!_progressToken || !mcpServer) return;
+  _progressStep++;
+  try {
+    await mcpServer.notification({
+      method: 'notifications/progress',
+      params: {
+        progressToken: _progressToken,
+        progress: _progressStep,
+        message
+      }
+    });
+  } catch {
+    // Fire and forget — don't break the action if progress fails
+  }
+}
+
 function emit(level, message, symbol = '') {
   const line = symbol ? `${PREFIX} ${symbol} ${message}` : `${PREFIX} ${message}`;
   console.error(line);
@@ -55,6 +102,8 @@ function emit(level, message, symbol = '') {
 
 function info(message) {
   emit('info', message);
+  // Also send as MCP progress notification when token is active
+  void sendProgress(message);
 }
 
 function warn(message) {
@@ -69,6 +118,6 @@ function debug(message) {
   emit('debug', message, '🔍');
 }
 
-export const logger = { info, warn, error, debug, attachServer, setConsoleOutput };
-export { attachServer, setConsoleOutput };
+export const logger = { info, warn, error, debug, attachServer, setConsoleOutput, setProgressToken, clearProgressToken };
+export { attachServer, setConsoleOutput, setProgressToken, clearProgressToken };
 export default logger;

package/src/core/plugin-loader.js

@@ -302,7 +302,7 @@ export function getPluginNextSteps(url, html) {
 /**
  * Build the recommendedPlugins payload for structuredContent.
  * Returns full plugin metadata including action catalog with params,
- * so agents can call actions directly without needing plugin_info.
+ * so agents can call actions directly without needing browser_plugin_info.
  * @param {string} url - Current page URL
  * @param {string} html - Extracted page HTML
  * @returns {Array<{ plugin: string, recommendation: string, actions: Array, usage: string }>}
@@ -317,7 +317,7 @@ export function getRecommendedPlugins(url, html) {
       plugin: d.pluginName,
       recommendation: recommendationText,
       actions: info.actions || [],
-      usage: `plugin_action({ plugin: '${d.pluginName}', action: '<name>', params: {...} })`
+      usage: `browser_plugin_action({ plugin: '${d.pluginName}', action: '<name>', params: {...} })`
     };
   });
 }

package/src/core/responses.js

@@ -188,7 +188,7 @@ function getHttpStatusNextSteps(statusCode, url) {
     return [
       'Authentication may be required - try logging in first',
       'Check if you have permission to access this resource',
-      "Use MCPBrowser's fetch_webpage to navigate to the login page first"
+      "Use MCPBrowser's browser_fetch_webpage to navigate to the login page first"
     ];
   }
   
@@ -204,14 +204,14 @@ function getHttpStatusNextSteps(statusCode, url) {
     return [
       'Rate limit exceeded - wait a few minutes before retrying',
       'Reduce request frequency',
-      "Call MCPBrowser's fetch_webpage again after waiting"
+      "Call MCPBrowser's browser_fetch_webpage again after waiting"
     ];
   }
   
   if (statusCode >= 500 && statusCode < 600) {
     return [
       'The server is experiencing issues',
-      "Wait a moment and try again with MCPBrowser's fetch_webpage",
+      "Wait a moment and try again with MCPBrowser's browser_fetch_webpage",
       'Check if the service has a status page for outages'
     ];
   }
@@ -219,7 +219,7 @@ function getHttpStatusNextSteps(statusCode, url) {
   return [
     ...baseSteps,
     'Try again later if this is a temporary issue',
-    "Call MCPBrowser's fetch_webpage to retry the request"
+    "Call MCPBrowser's browser_fetch_webpage to retry the request"
   ];
 }
 

package/src/mcp-browser.js

@@ -86,10 +86,16 @@ async function main() {
 
   server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
 
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     const { name, arguments: args } = request.params;
     const safeArgs = args || {};
     
+    // Enable MCP progress notifications for this request if the client sent a progressToken.
+    // Every logger.info() call during tool execution will automatically send a
+    // notifications/progress message so the agent sees real-time status updates.
+    const progressToken = extra?._meta?.progressToken;
+    logger.setProgressToken(progressToken);
+    
     let result;
     
     try {
@@ -104,47 +110,47 @@ async function main() {
         //   result = await handleAcceptEula(safeArgs);
         //   break;
           
-        case "fetch_webpage":
+        case "browser_fetch_webpage":
           result = await fetchPage(safeArgs);
           break;
 
-        case "execute_javascript":
+        case "browser_execute_javascript":
           result = await executeJavascript(safeArgs);
           break;
           
-        case "click_element":
+        case "browser_click_element":
           result = await clickElement(safeArgs);
           break;
           
-        case "type_text":
+        case "browser_type_text":
           result = await typeText(safeArgs);
           break;
           
-        case "close_tab":
+        case "browser_close_tab":
           result = await closeTab(safeArgs);
           break;
           
-        case "get_current_html":
+        case "browser_get_current_html":
           result = await getCurrentHtml(safeArgs);
           break;
           
-        case "take_screenshot":
+        case "browser_take_screenshot":
           result = await takeScreenshot(safeArgs);
           break;
           
-        case "scroll_page":
+        case "browser_scroll_page":
           result = await scrollPage(safeArgs);
           break;
 
-        case "navigate_history":
+        case "browser_navigate_history":
           result = await navigateHistory(safeArgs);
           break;
 
-        case "plugin_info":
+        case "browser_plugin_info":
           result = pluginInfo(safeArgs);
           break;
 
-        case "plugin_action":
+        case "browser_plugin_action":
           result = await pluginAction(safeArgs);
           break;
           
@@ -161,6 +167,8 @@ async function main() {
         `${name} failed: ${error.message}`,
         ['Check browser is installed', 'Try specifying browser parameter explicitly (chrome, edge, or brave)', 'Check MCP server logs for details']
       ).toMcpFormat();
+    } finally {
+      logger.clearProgressToken();
     }
     
     // Transform result into MCP-compliant response using instance method

package/src/plugins/_example/index.js

@@ -81,7 +81,7 @@ export function getActions() {
         }, limit);
 
         return new ExampleActionResponse(items, [
-          "Call plugin_action with action 'get_item_detail' to read a specific item"
+          "Call browser_plugin_action with action 'get_item_detail' to read a specific item"
         ]);
       }
     },
@@ -114,7 +114,7 @@ export function getActions() {
         }
 
         return new ExampleActionResponse(detail, [
-          "Use plugin_action with action 'list_items' to see all items"
+          "Use browser_plugin_action with action 'list_items' to see all items"
         ]);
       }
     }

package/src/plugins/gcal/actions/check-availability.js

@@ -85,7 +85,7 @@ export async function checkAvailability({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/create-event.js

@@ -47,7 +47,7 @@ export async function createEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/delete-event.js

@@ -44,7 +44,7 @@ export async function deleteEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/edit-event.js

@@ -51,7 +51,7 @@ export async function editEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/list-events.js

@@ -34,7 +34,7 @@ export async function listEvents({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/read-event.js

@@ -47,7 +47,7 @@ export async function readEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/rsvp-event.js

@@ -62,7 +62,7 @@ export async function rsvpEvent({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/actions/search-events.js

@@ -42,7 +42,7 @@ export async function searchEvents({ page, params }) {
   const pre = await checkPrecondition(page, 'on_calendar');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to open Google Calendar first."
     ]);
   }
 

package/src/plugins/gcal/helpers.js

@@ -235,7 +235,7 @@ export async function checkPrecondition(page, requirement) {
         return {
           met: false,
           error: 'Google Calendar is not the active page.',
-          suggestion: "Use fetch_webpage({ url: 'https://calendar.google.com' }) to navigate to Google Calendar first."
+          suggestion: "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to navigate to Google Calendar first."
         };
       }
       return { met: true };
@@ -247,7 +247,7 @@ export async function checkPrecondition(page, requirement) {
         return {
           met: false,
           error: 'Google Calendar is not ready.',
-          suggestion: "Use fetch_webpage({ url: 'https://calendar.google.com' }) to navigate to Google Calendar."
+          suggestion: "Use browser_fetch_webpage({ url: 'https://calendar.google.com' }) to navigate to Google Calendar."
         };
       }
       return { met: true };

package/src/plugins/gmail/actions/archive-email.js

@@ -30,7 +30,7 @@ export async function archiveEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/compose-email.js

@@ -40,7 +40,7 @@ export async function composeEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/delete-email.js

@@ -30,7 +30,7 @@ export async function deleteEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/forward-email.js

@@ -30,7 +30,7 @@ export async function forwardEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/label-email.js

@@ -43,7 +43,7 @@ export async function labelEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/list-emails.js

@@ -31,7 +31,7 @@ export async function listEmails({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/mark-read.js

@@ -29,7 +29,7 @@ export async function markRead({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/mark-unread.js

@@ -29,7 +29,7 @@ export async function markUnread({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/read-email.js

@@ -51,7 +51,7 @@ export async function readEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/reply-email.js

@@ -30,7 +30,7 @@ export async function replyEmail({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/actions/search-emails.js

@@ -41,7 +41,7 @@ export async function searchEmails({ page, params }) {
   const pre = await checkPrecondition(page, 'on_gmail');
   if (!pre.met) {
     return new ErrorResponse(pre.error, [
-      pre.suggestion || "Use fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
+      pre.suggestion || "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to open Gmail first."
     ]);
   }
 

package/src/plugins/gmail/helpers.js

@@ -230,7 +230,7 @@ export async function checkPrecondition(page, requirement) {
         return {
           met: false,
           error: 'Gmail is not the active page.',
-          suggestion: "Use fetch_webpage({ url: 'https://mail.google.com' }) to navigate to Gmail first."
+          suggestion: "Use browser_fetch_webpage({ url: 'https://mail.google.com' }) to navigate to Gmail first."
         };
       }
       return { met: true };
@@ -243,7 +243,7 @@ export async function checkPrecondition(page, requirement) {
         return {
           met: false,
           error: 'No email thread is currently open.',
-          suggestion: "Use plugin_action({ plugin: 'gmail', action: 'read_email', params: { index: 0 } }) to open an email first."
+          suggestion: "Use browser_plugin_action({ plugin: 'gmail', action: 'read_email', params: { index: 0 } }) to open an email first."
         };
       }
       return { met: true };
@@ -255,7 +255,7 @@ export async function checkPrecondition(page, requirement) {
         return {
           met: false,
           error: 'Not in email list view.',
-          suggestion: "Use plugin_action({ plugin: 'gmail', action: 'list_emails' }) to return to the email list."
+          suggestion: "Use browser_plugin_action({ plugin: 'gmail', action: 'list_emails' }) to return to the email list."
         };
       }
       return { met: true };