viyv-browser-mcp 0.6.3 → 0.6.5

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 }`;
@@ -2921,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"];
 
@@ -2938,6 +2973,37 @@ var PAGE_DATA_EXTRACT_RETURNS = `{
 }`;
 var PAGE_DATA_EXTRACT_RELATED = ["get_page_text", "javascript_exec", "sm_fetch"];
 
+// src/tools/viyv/feedback.ts
+var FEEDBACK_DESCRIPTION = `Visual feedback/review system. Actions: list, get, add, reply, resolve, reopen, complete.
+Pin comments to page elements for human-AI review workflow.`;
+var FEEDBACK_DETAIL = `Collaborative review system for pinning feedback to UI elements.
+
+Actions:
+- list: Get feedback threads for the current tab's URL. Filter by status (default: open).
+  Returns: url_pattern, selector, element_tag, text_preview, created_by, latest_comment.
+- get: Get full thread details including all comments. Requires thread_id.
+- add: Create new thread on an element. Requires ref (from read_page) or selector + body.
+- reply: Add comment to existing thread. Requires thread_id + body.
+- resolve: Mark thread as resolved. Requires thread_id. Optional resolution_note.
+- reopen: Reopen a resolved thread. Requires thread_id.
+- complete: Archive/dismiss a thread (removes pin). Requires thread_id.
+
+Workflow: list \u2192 get (for full context) \u2192 fix code \u2192 resolve.
+Element targeting: Use ref from read_page output, or provide a CSS selector.
+Threads persist across page reloads via element selectors.
+Users see pins on the page and can interact via inline popovers.
+Status flow: open \u2192 resolved \u2192 completed (or open \u2192 completed).`;
+var FEEDBACK_RETURNS = `{
+  // list:     { threads[{ thread_id, status, url_pattern, selector, element_tag, text_preview, created_by, created_by_type, comment_count, latest_comment, created_at }], total }
+  // get:      { thread_id, status, url_pattern, url_exact, selector, element_tag, text_preview, created_by, resolution?, comments[{ comment_id, author_type, author_name, body, created_at }] }
+  // add:      { thread_id, comment_id }
+  // reply:    { thread_id, comment_id, comment_count }
+  // resolve:  { thread_id, status }
+  // reopen:   { thread_id, status }
+  // complete: { thread_id, archived }
+}`;
+var FEEDBACK_RELATED = ["read_page", "screenshot", "find"];
+
 // src/tools/index.ts
 var navigateTool = {
   name: "navigate",
@@ -3124,7 +3190,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 = {
@@ -3295,6 +3362,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,
@@ -3390,6 +3475,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,
@@ -3484,6 +3586,24 @@ var browserHealthTool = {
   related: BROWSER_HEALTH_RELATED,
   inputSchema: z.object({})
 };
+var feedbackTool = {
+  name: "feedback",
+  description: FEEDBACK_DESCRIPTION,
+  detail: FEEDBACK_DETAIL,
+  returns: FEEDBACK_RETURNS,
+  category: "viyv",
+  related: FEEDBACK_RELATED,
+  inputSchema: z.object({
+    tabId: z.coerce.number().describe("Tab ID"),
+    action: z.enum(["list", "get", "add", "reply", "resolve", "reopen", "complete"]).describe("Operation to perform"),
+    ref: z.string().optional().describe("Element ref from read_page (for add)"),
+    selector: z.string().optional().describe("CSS selector (for add, alternative to ref)"),
+    body: z.string().optional().describe("Comment text (for add/reply)"),
+    thread_id: z.string().optional().describe("Thread ID (for reply/resolve/reopen/complete)"),
+    resolution_note: z.string().optional().describe("Resolution note (for resolve)"),
+    status: z.enum(["open", "resolved", "completed", "all"]).optional().describe("Status filter (for list, default: open)")
+  })
+};
 var smCapabilitiesTool = {
   name: "sm_capabilities",
   description: SM_CAPABILITIES_DESCRIPTION,
@@ -4289,10 +4409,11 @@ var allTools = [
   tabsCreateTool,
   tabCloseTool,
   selectTabTool,
-  // Debug (2)
+  // Debug (3)
   readConsoleMessagesTool,
   readNetworkRequestsTool,
-  // Advanced (8)
+  networkInterceptTool,
+  // Advanced (9)
   gifCreatorTool,
   uploadImageTool,
   fileUploadTool,
@@ -4301,6 +4422,7 @@ var allTools = [
   shortcutsListTool,
   shortcutsExecuteTool,
   switchBrowserTool,
+  savePdfTool,
   // viyv Integration (7)
   agentTabAssignTool,
   agentTabListTool,
@@ -4309,6 +4431,7 @@ var allTools = [
   artifactFromPageTool,
   pageDataExtractTool,
   browserHealthTool,
+  feedbackTool,
   // Semantic (12)
   smCapabilitiesTool,
   smInvokeTool,
@@ -5060,14 +5183,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();