viyv-browser-mcp 0.7.0 → 0.7.2

package/dist/index.js

@@ -567,13 +567,11 @@ function startBridge(options) {
     if (chromeConnections.size === 0 && mcpConnections.size === 0) {
       gracefulExit("No connections remaining");
     }
-    if (chromeConnections.size === 0 && !orphanTimer) {
-      orphanTimer = setTimeout(() => {
-        orphanTimer = null;
-        if (chromeConnections.size === 0) {
-          gracefulExit(`No Chrome reconnected within ${ORPHAN_TIMEOUT}ms`);
-        }
-      }, ORPHAN_TIMEOUT);
+    if (chromeConnections.size === 0 && mcpConnections.size > 0 && !orphanTimer) {
+      process.stderr.write(
+        `${LOG_PREFIX2} No Chrome connections, but ${mcpConnections.size} MCP Server(s) connected \u2014 waiting for Chrome relay
+`
+      );
     }
   }
   function setupRelayConnection(socket) {
@@ -894,7 +892,11 @@ var lastHeartbeat = null;
 var chromeProfiles = [];
 function setExtensionConnected(connected) {
   extensionConnected = connected;
-  if (connected) lastHeartbeat = Date.now();
+  if (connected) {
+    lastHeartbeat = Date.now();
+  } else {
+    chromeProfiles = [];
+  }
 }
 function recordHeartbeat() {
   lastHeartbeat = Date.now();
@@ -1447,7 +1449,7 @@ var DRAG_RETURNS = `{ dragged: true }`;
 var DRAG_RELATED = ["click", "hover"];
 
 // src/tools/core/find.ts
-var FIND_DESCRIPTION = `Find elements by natural language query. Returns refs for click/form_input.
+var FIND_DESCRIPTION = `Find page elements by natural language query. Returns refs for click/form_input.
 Returns: { matches[{ref, text, role, rect}], total }`;
 var FIND_DETAIL = `Find elements on the page using a natural language query.
 Searches the DOM for elements matching the given description,
@@ -1713,7 +1715,7 @@ var READ_PAGE_RETURNS = `{
 var READ_PAGE_RELATED = ["page_outline", "find", "get_page_text", "screenshot"];
 
 // src/tools/core/read-table.ts
-var READ_TABLE_DESCRIPTION = `Extract structured table data by ref. Supports <table> and ARIA role="table".
+var READ_TABLE_DESCRIPTION = `Extract HTML table data from web page by ref. Supports <table> and ARIA role="table".
 Returns: { headers, rows, totalRows, truncated, tableRef }`;
 var READ_TABLE_DETAIL = `Extract structured data from a table element identified by ref.
 
@@ -1824,7 +1826,7 @@ var NETWORK_INTERCEPT_RETURNS = `{
 var NETWORK_INTERCEPT_RELATED = ["read_network_requests"];
 
 // src/tools/debug/read-console-messages.ts
-var READ_CONSOLE_MESSAGES_DESCRIPTION = `Read page console messages. Filter by level/pattern, clear after read.
+var READ_CONSOLE_MESSAGES_DESCRIPTION = `Read browser console messages. Filter by level/pattern, clear after read.
 Returns: { messages[], total }`;
 var READ_CONSOLE_MESSAGES_DETAIL = `Read console messages captured from the page.
 Returns log, warning, error, and info messages that have been
@@ -2906,7 +2908,7 @@ var SM_TEST_TARGET_RETURNS = `{
 var SM_TEST_TARGET_RELATED = ["sm_add_target", "sm_invoke", "sm_status"];
 
 // src/tools/sheets/descriptions.ts
-var SHEETS_READ_DESCRIPTION = `Read spreadsheet data. Supports tq queries and formula mode.
+var SHEETS_READ_DESCRIPTION = `Read Google Sheets spreadsheet data. Supports tq queries and formula mode.
 Returns: { data[][], row_count, col_count }`;
 var SHEETS_READ_DETAIL = `Read data from the active Google Sheets spreadsheet.
 
@@ -2929,7 +2931,7 @@ var SHEETS_READ_RETURNS = `{
   sheet_name: string
 }`;
 var SHEETS_READ_RELATED = ["sheets_write", "sheets_info", "sheets_navigate"];
-var SHEETS_WRITE_DESCRIPTION = `Write to spreadsheet. Single cell (value), range (values 2D array), or clear.
+var SHEETS_WRITE_DESCRIPTION = `Write to Google Sheets spreadsheet. Single cell (value), range (values 2D array), or clear.
 Returns: { success, cells_written }`;
 var SHEETS_WRITE_DETAIL = `Write data to the active Google Sheets spreadsheet.
 
@@ -2946,7 +2948,7 @@ var SHEETS_WRITE_RETURNS = `{
   range: string
 }`;
 var SHEETS_WRITE_RELATED = ["sheets_read", "sheets_navigate", "sheets_import"];
-var SHEETS_INFO_DESCRIPTION = `Get spreadsheet metadata.
+var SHEETS_INFO_DESCRIPTION = `Get Google Sheets spreadsheet metadata.
 Returns: { title, sheets[], active_cell, url }`;
 var SHEETS_INFO_DETAIL = `Get metadata about the active Google Sheets spreadsheet.
 
@@ -2961,7 +2963,7 @@ var SHEETS_INFO_RETURNS = `{
   url: string
 }`;
 var SHEETS_INFO_RELATED = ["sheets_read", "sheets_navigate"];
-var SHEETS_NAVIGATE_DESCRIPTION = `Jump to cell or switch sheet tab.
+var SHEETS_NAVIGATE_DESCRIPTION = `Jump to cell or switch sheet tab in Google Sheets.
 Returns: { success, active_cell, active_sheet }`;
 var SHEETS_NAVIGATE_DETAIL = `Navigate within the active Google Sheets spreadsheet.
 
@@ -2974,7 +2976,7 @@ var SHEETS_NAVIGATE_RETURNS = `{
   active_sheet: string
 }`;
 var SHEETS_NAVIGATE_RELATED = ["sheets_read", "sheets_write", "sheets_info"];
-var SHEETS_CREATE_DESCRIPTION = `Create a new sheet tab in the spreadsheet.
+var SHEETS_CREATE_DESCRIPTION = `Create a new sheet tab in Google Sheets spreadsheet.
 Returns: { success, sheet_name }`;
 var SHEETS_CREATE_DETAIL = `Create a new sheet tab with the specified name.
 
@@ -3005,7 +3007,7 @@ var SHEETS_IMPORT_RETURNS = `{
 var SHEETS_IMPORT_RELATED = ["sheets_write", "sheets_read", "sheets_create"];
 
 // src/tools/tabs/select-tab.ts
-var SELECT_TAB_DESCRIPTION = `Switch to a tab.
+var SELECT_TAB_DESCRIPTION = `Switch to a browser tab by ID.
 Returns: { selected, tabId, url, title }`;
 var SELECT_TAB_DETAIL = `Switch focus to a specific tab by its identifier.
 Makes the target tab the active tab in the agent's group,
@@ -3020,7 +3022,7 @@ var SELECT_TAB_RETURNS = `{
 var SELECT_TAB_RELATED = ["tabs_context", "tabs_create", "tab_close"];
 
 // src/tools/tabs/tab-close.ts
-var TAB_CLOSE_DESCRIPTION = `Close a tab.
+var TAB_CLOSE_DESCRIPTION = `Close a browser tab by ID.
 Returns: { closed, tabId }`;
 var TAB_CLOSE_DETAIL = `Close a tab by its identifier.
 Removes the specified tab from the browser and the agent's tab group.
@@ -3033,7 +3035,7 @@ var TAB_CLOSE_RETURNS = `{
 var TAB_CLOSE_RELATED = ["tabs_context", "tabs_create", "select_tab"];
 
 // src/tools/tabs/tabs-context.ts
-var TABS_CONTEXT_DESCRIPTION = `Get agent's tab group info.
+var TABS_CONTEXT_DESCRIPTION = `List tabs in agent's browser tab group with URLs and titles.
 Returns: { groupId, tabs[{tabId, url, title, active}] }`;
 var TABS_CONTEXT_DETAIL = `Get information about the current agent tab group.
 Returns the list of tabs belonging to the agent's assigned group,
@@ -3048,7 +3050,7 @@ var TABS_CONTEXT_RETURNS = `{
 var TABS_CONTEXT_RELATED = ["tabs_create", "tab_close", "select_tab"];
 
 // src/tools/tabs/tabs-create.ts
-var TABS_CREATE_DESCRIPTION = `Create new tab in agent's group.
+var TABS_CREATE_DESCRIPTION = `Open new browser tab in agent's group.
 Returns: { tabId, url, title }`;
 var TABS_CREATE_DETAIL = `Create a new tab within the agent's tab group.
 Opens a new tab with an optional URL and automatically assigns it
@@ -3286,7 +3288,7 @@ var scrollTool = {
     tabId: z.coerce.number().describe("Tab ID"),
     coordinate: z.tuple([z.coerce.number(), z.coerce.number()]).optional().describe("Scroll position [x, y] (required for directional scroll)"),
     direction: z.enum(["up", "down", "left", "right"]).optional().describe("Scroll direction (required for directional scroll)"),
-    amount: z.coerce.number().min(1).max(10).optional().describe("Scroll amount (default: 3)"),
+    amount: z.coerce.number().min(1).max(10).optional().describe("Scroll amount in viewport fractions: 3 = one full viewport (default: 3)"),
     ref: z.string().optional().describe("Element reference ID to scroll into view")
   })
 };