viyv-browser-mcp 0.6.2 → 0.6.4

package/dist/index.js

@@ -1248,6 +1248,21 @@ var RESIZE_WINDOW_RETURNS = `{
 }`;
 var RESIZE_WINDOW_RELATED = ["screenshot"];
 
+// src/tools/advanced/save-pdf.ts
+var SAVE_PDF_DESCRIPTION = `Generate PDF from page. Supports landscape, margins, page ranges.
+Returns: { sizeBytes, filename } or { data (base64) }`;
+var SAVE_PDF_DETAIL = `Generate a PDF document from the current page via CDP Page.printToPDF.
+Use download:true to save to Downloads folder (recommended \u2014 base64 may exceed 1MB MCP message limit).
+Without download, returns base64 data.`;
+var SAVE_PDF_RETURNS = `{
+  data?: string       // base64 PDF (omitted when download:true)
+  sizeBytes: number
+  downloaded?: boolean
+  filename?: string   // when download:true
+  warning?: string    // when PDF > 700KB without download
+}`;
+var SAVE_PDF_RELATED = ["screenshot", "artifact_from_page"];
+
 // src/tools/advanced/shortcuts-execute.ts
 var SHORTCUTS_EXECUTE_DESCRIPTION = `Execute shortcut by command or ID.
 Returns: execution result`;
@@ -1403,7 +1418,10 @@ Supports text inputs, textareas, selects, checkboxes, and radio buttons.
 The ref must be obtained from a prior find or snapshot operation
 to ensure the correct element is targeted.
 Use submit: true to press Enter after setting the value and wait for any
-resulting navigation. Useful for search boxes and login forms.`;
+resulting navigation. Useful for search boxes and login forms.
+For select elements: use listOptions:true to list available options without changing selection
+(pass any value for the required value param, e.g. value:"").
+If no option matches, the error includes availableOptions (up to 20).`;
 var FORM_INPUT_RETURNS = `{
   set: true
   value?: string        // new value
@@ -1628,6 +1646,22 @@ var WAIT_FOR_RETURNS = `// Navigation: { waited: "navigation" }
 // Timeout:    { waited: number, type: "delay" }`;
 var WAIT_FOR_RELATED = ["click", "navigate", "form_input"];
 
+// src/tools/debug/network-intercept.ts
+var NETWORK_INTERCEPT_DESCRIPTION = `Intercept/mock/block network requests. Actions: add, remove, list, clear.
+Returns: { rules[] } or { cleared }`;
+var NETWORK_INTERCEPT_DETAIL = `Intercept network requests matching URL patterns.
+Use action "add" to add a rule. Each rule blocks or mocks requests matching the URL pattern.
+Use action "list" to see active rules, "remove" to delete by ruleId, "clear" to remove all.
+Max 10 rules per tab. Rules are auto-cleared when the tab is closed or agent disconnects.
+Caution: blocking critical requests may break page functionality \u2014 use "clear" to recover.`;
+var NETWORK_INTERCEPT_RETURNS = `{
+  // add:    { ruleId, rules[] }
+  // remove: { removed, rules[] }
+  // list:   { rules[] }
+  // clear:  { cleared, removedCount }
+}`;
+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.
 Returns: { messages[], total }`;
@@ -2734,18 +2768,20 @@ 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) or range (values 2D array).
+var SHEETS_WRITE_DESCRIPTION = `Write to 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.
 
-For single cell: navigates to the cell via Name Box and types the value.
-For multiple cells: converts 2D array to TSV, copies to clipboard via Offscreen Document, then pastes with Ctrl+V. Sheets auto-expands TSV into multiple cells.
+For single cell: provide "value" with target "cell".
+For multiple cells: provide "values" (2D array) with starting "cell". Writes cell-by-cell.
+For clearing: provide "clear: true" with "cell" as a range (e.g., "G2:H2").
 
-Provide either "value" (single cell string) or "values" (2D array), not both.
+These three modes are mutually exclusive.
 The tab must be on a Google Sheets page.`;
 var SHEETS_WRITE_RETURNS = `{
   success: boolean
-  cells_written: number
+  cells_written?: number  // write modes
+  cleared?: boolean       // clear mode
   range: string
 }`;
 var SHEETS_WRITE_RELATED = ["sheets_read", "sheets_navigate"];
@@ -2919,6 +2955,7 @@ var BROWSER_HEALTH_RETURNS = `{
   currentGroup?: { groupId, tabs: number[], color } | null
   totalSessions: number
   extensionVersion: string
+  recentActions: [{ tool, timestamp, durationMs, result, errorCode?, tabId?, meta? }]
 }`;
 var BROWSER_HEALTH_RELATED = ["tabs_context", "switch_browser"];
 
@@ -3122,7 +3159,8 @@ var formInputTool = {
     value: z.union([z.string(), z.boolean(), z.coerce.number()]).describe("Value to set"),
     submit: z.boolean().optional().describe(
       "Submit the form after setting value (dispatches Enter key and waits for navigation)"
-    )
+    ),
+    listOptions: z.boolean().optional().describe("List select options without changing selection")
   })
 };
 var javascriptExecTool = {
@@ -3293,6 +3331,24 @@ var readNetworkRequestsTool = {
     file_path: z.string().optional().describe("Save results to local file as JSON. Returns metadata only.")
   })
 };
+var networkInterceptTool = {
+  name: "network_intercept",
+  description: NETWORK_INTERCEPT_DESCRIPTION,
+  detail: NETWORK_INTERCEPT_DETAIL,
+  returns: NETWORK_INTERCEPT_RETURNS,
+  category: "debug",
+  related: NETWORK_INTERCEPT_RELATED,
+  inputSchema: z.object({
+    tabId: z.coerce.number().describe("Tab ID"),
+    action: z.enum(["add", "remove", "list", "clear"]).describe("Operation"),
+    urlPattern: z.string().optional().describe("URL substring to match (for add)"),
+    response: z.enum(["block", "mock"]).optional().describe("What to do with matched requests (for add)"),
+    mockStatus: z.coerce.number().optional().describe("Mock response status code"),
+    mockBody: z.string().optional().describe("Mock response body"),
+    mockContentType: z.string().optional().describe("Mock Content-Type header"),
+    ruleId: z.string().optional().describe("Rule ID (for remove)")
+  })
+};
 var gifCreatorTool = {
   name: "gif_creator",
   description: GIF_CREATOR_DESCRIPTION,
@@ -3388,6 +3444,23 @@ var switchBrowserTool = {
   related: SWITCH_BROWSER_RELATED,
   inputSchema: z.object({})
 };
+var savePdfTool = {
+  name: "save_pdf",
+  description: SAVE_PDF_DESCRIPTION,
+  detail: SAVE_PDF_DETAIL,
+  returns: SAVE_PDF_RETURNS,
+  category: "advanced",
+  related: SAVE_PDF_RELATED,
+  inputSchema: z.object({
+    tabId: z.coerce.number().describe("Tab ID"),
+    landscape: z.boolean().optional().describe("Landscape orientation"),
+    scale: z.coerce.number().min(0.1).max(2).optional().describe("Scale (default: 1)"),
+    pageRanges: z.string().optional().describe('Pages (e.g. "1-3, 5")'),
+    printBackground: z.boolean().optional().describe("Print backgrounds (default: true)"),
+    download: z.boolean().optional().describe("Save to Downloads folder"),
+    filename: z.string().optional().describe("Filename for download")
+  })
+};
 var fileUploadTool = {
   name: "file_upload",
   description: FILE_UPLOAD_DESCRIPTION,
@@ -4206,8 +4279,9 @@ var sheetsWriteTool = {
   inputSchema: z.object({
     tabId: z.coerce.number().describe("Tab ID of the Google Sheets page"),
     cell: z.string().describe('Target cell reference (e.g., "A1", "Sheet2!B5")'),
-    value: z.string().optional().describe("Single cell value (exclusive with values)"),
-    values: z.array(z.array(z.string())).optional().describe("2D array of values (exclusive with value)")
+    value: z.string().optional().describe("Single cell value (exclusive with values/clear)"),
+    values: z.array(z.array(z.string())).optional().describe("2D array of values (exclusive with value/clear)"),
+    clear: z.boolean().optional().describe('Clear cell/range contents (use cell as range, e.g., "G2:H5")')
   })
 };
 var sheetsInfoTool = {
@@ -4286,10 +4360,11 @@ var allTools = [
   tabsCreateTool,
   tabCloseTool,
   selectTabTool,
-  // Debug (2)
+  // Debug (3)
   readConsoleMessagesTool,
   readNetworkRequestsTool,
-  // Advanced (8)
+  networkInterceptTool,
+  // Advanced (9)
   gifCreatorTool,
   uploadImageTool,
   fileUploadTool,
@@ -4298,6 +4373,7 @@ var allTools = [
   shortcutsListTool,
   shortcutsExecuteTool,
   switchBrowserTool,
+  savePdfTool,
   // viyv Integration (7)
   agentTabAssignTool,
   agentTabListTool,
@@ -5057,14 +5133,12 @@ async function callExtensionTool(tool, input) {
     };
   }
   if (tool === "browser_health") {
-    return {
-      content: [
-        {
-          type: "text",
-          text: JSON.stringify(getHealthStatus())
-        }
-      ]
-    };
+    const health = getHealthStatus();
+    if (!health.extensionConnected || !extensionSocket || extensionSocket.destroyed) {
+      return {
+        content: [{ type: "text", text: JSON.stringify(health) }]
+      };
+    }
   }
   if (tool === "switch_browser") {
     return handleSwitchBrowser();