vigthoria-cli 1.8.12 → 1.8.13

package/dist/utils/tools.d.ts

@@ -193,6 +193,7 @@ export declare class AgenticTools {
      * Uses Node.js native fetch (available in Node 18+)
      */
     private fetchUrl;
+    private browserTool;
     /**
      * Execute command via SSH on remote server
      * Useful for running Unix commands from Windows

package/dist/utils/tools.js

@@ -399,6 +399,19 @@ class AgenticTools {
                 riskLevel: 'low',
                 category: 'read',
             },
+            {
+                name: 'browser',
+                description: 'Drive a real headless Chromium via the Vigthoria DevTools Bridge. Use to capture a page (screenshot+HTML+metrics), collect console/page errors, or run a quick smoke test on a URL. Cross-platform.',
+                parameters: [
+                    { name: 'mode', description: "One of: 'capture' (screenshot + html + metrics), 'errors' (console + page errors), 'test' (quick smoke test)", required: true },
+                    { name: 'url', description: 'Target URL (must start with http:// or https://)', required: true },
+                    { name: 'include_screenshot', description: "For mode=capture: 'true' to include base64 screenshot (default true), 'false' to skip", required: false },
+                ],
+                requiresPermission: true,
+                dangerous: false,
+                riskLevel: 'low',
+                category: 'read',
+            },
             {
                 name: 'ssh_exec',
                 description: 'Execute a command on a remote server via SSH (useful for Unix commands from Windows)',
@@ -602,6 +615,8 @@ class AgenticTools {
                 return this.repo(call.args);
             case 'fetch_url':
                 return this.fetchUrl(call.args);
+            case 'browser':
+                return this.browserTool(call.args);
             case 'ssh_exec':
                 return this.sshExec(call.args);
             case 'task':
@@ -1857,6 +1872,74 @@ class AgenticTools {
             return this.createErrorResult(ToolErrorType.NETWORK_ERROR, error.message, 'Check your internet connection and ensure the URL is correct.');
         }
     }
+    async browserTool(args) {
+        const mode = (args.mode || '').toLowerCase();
+        const url = args.url;
+        if (!['capture', 'errors', 'test'].includes(mode)) {
+            return this.createErrorResult(ToolErrorType.INVALID_ARGS, `Invalid mode: ${args.mode}`, "mode must be one of: 'capture', 'errors', 'test'");
+        }
+        if (!url || (!url.startsWith('http://') && !url.startsWith('https://'))) {
+            return this.createErrorResult(ToolErrorType.INVALID_ARGS, 'URL must start with http:// or https://', 'Provide a valid URL, e.g., https://example.com');
+        }
+        const host = process.env.VIGTHORIA_DEVTOOLS_BRIDGE_HOST || '127.0.0.1';
+        const port = process.env.VIGTHORIA_DEVTOOLS_BRIDGE_PORT || '4016';
+        const base = `http://${host}:${port}`;
+        const toolName = mode === 'capture' ? 'capture_state' :
+            mode === 'errors' ? 'get_page_errors' :
+                'run_test';
+        const params = { url };
+        if (mode === 'capture' && (args.include_screenshot || '').toLowerCase() === 'false') {
+            params.includeScreenshot = false;
+        }
+        if (mode === 'test') {
+            params.testType = 'quick';
+        }
+        const controller = new AbortController();
+        const timeoutMs = mode === 'test' ? 60000 : 45000;
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(`${base}/api/mcp/tools`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'User-Agent': 'Vigthoria-CLI-Browser/1.0' },
+                body: JSON.stringify({ tool: toolName, params }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                return this.createErrorResult(ToolErrorType.NETWORK_ERROR, `DevTools Bridge HTTP ${res.status}`, 'Ensure the bridge is running (vigthoria bridge status). On a developer workstation it must be installed and started locally.');
+            }
+            const data = await res.json();
+            if (!data.success) {
+                return this.createErrorResult(ToolErrorType.NETWORK_ERROR, data.error || 'DevTools Bridge returned unsuccessful response', 'Check the bridge logs.');
+            }
+            let payload;
+            if (mode === 'capture' && data.result && typeof data.result === 'object') {
+                const r = data.result;
+                const trimmed = {
+                    url: r.url,
+                    timestamp: r.timestamp,
+                    metrics: r.metrics,
+                    performance: r.performance,
+                    html_excerpt: typeof r.html === 'string' ? r.html.slice(0, 4000) : undefined,
+                    screenshot_data_url_length: typeof r.screenshot === 'string' ? r.screenshot.length : 0,
+                };
+                payload = JSON.stringify(trimmed, null, 2);
+            }
+            else {
+                payload = JSON.stringify(data.result, null, 2).slice(0, 8000);
+            }
+            return {
+                success: true,
+                output: payload,
+                metadata: { tool: 'browser', mode, url },
+            };
+        }
+        catch (e) {
+            clearTimeout(timeout);
+            const msg = e instanceof Error ? e.message : String(e);
+            return this.createErrorResult(ToolErrorType.NETWORK_ERROR, `Browser tool failed: ${msg}`, "Verify the DevTools Bridge is reachable on host:port (defaults 127.0.0.1:4016).");
+        }
+    }
     /**
      * Execute command via SSH on remote server
      * Useful for running Unix commands from Windows

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigthoria-cli",
-  "version": "1.8.12",
+  "version": "1.8.13",
   "description": "Vigthoria Coder CLI - AI-powered terminal coding assistant",
   "main": "dist/index.js",
   "files": [