venombrowser 4.1.0

package/bin/venombrowser-mcp.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * VenomBrowser MCP Server — CLI entry point
+ * Starts the MCP server in stdio mode for agent integration.
+ *
+ * Usage: node bin/venombrowser-mcp.js
+ * Or:    npm run mcp
+ *
+ * Agent configuration example (Claude Code):
+ *   {
+ *     "mcpServers": {
+ *       "venombrowser": {
+ *         "command": "node",
+ *         "args": ["C:/path/to/VenomBrowser/server/bin/venombrowser-mcp.js"],
+ *         "env": { "REST_API_KEY": "your-bridge-api-key" }
+ *       }
+ *     }
+ *   }
+ */
+
+// Load .env for default config — agents can also pass env vars directly
+require('dotenv').config({ path: require('path').join(__dirname, '..', '.env') });
+
+const VenomBrowserMcpServer = require('../src/mcp-server');
+
+const server = new VenomBrowserMcpServer();
+server.start().catch(err => {
+  console.error('[VenomBrowser MCP] Failed to start:', err.message);
+  process.exit(1);
+});

package/bin/venombrowser-server.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * VenomBrowser Bridge Server — CLI entry point
+ * Starts the WebSocket + REST API bridge server.
+ *
+ * Usage: node bin/venombrowser-server.js
+ * Or:    npm start
+ */
+
+require('dotenv').config({ path: require('path').join(__dirname, '..', '.env') });
+require('../src/bridge-server');

package/bin/venombrowser-setup.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+/**
+ * VenomBrowser Setup — Interactive setup wizard
+ *
+ * Helps users (and agents) configure VenomBrowser by:
+ * 1. Creating/updating .env from .env.example
+ * 2. Generating a REST_API_KEY if missing
+ * 3. Prompting for WS_AUTH_TOKEN (from extension popup)
+ * 4. Configuring the LLM provider
+ *
+ * Usage:
+ *   node bin/venombrowser-setup.js
+ *   node bin/venombrowser-setup.js --auto          # Non-interactive: generate keys, use defaults
+ *   node bin/venombrowser-setup.js --token=<tok>   # Set the WS_AUTH_TOKEN directly
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const readline = require('readline');
+
+const ENV_PATH = path.join(__dirname, '..', '.env');
+const EXAMPLE_PATH = path.join(__dirname, '..', '.env.example');
+
+function generateKey(length = 32) {
+  return crypto.randomBytes(length).toString('hex');
+}
+
+function parseEnv(content) {
+  const vars = {};
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eqIndex = trimmed.indexOf('=');
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const val = trimmed.slice(eqIndex + 1).trim();
+    vars[key] = val;
+  }
+  return vars;
+}
+
+function updateEnvFile(updates) {
+  let content;
+  if (fs.existsSync(ENV_PATH)) {
+    content = fs.readFileSync(ENV_PATH, 'utf8');
+  } else if (fs.existsSync(EXAMPLE_PATH)) {
+    content = fs.readFileSync(EXAMPLE_PATH, 'utf8');
+  } else {
+    // Build minimal .env
+    content = Object.entries(updates).map(([k, v]) => `${k}=${v}`).join('\n') + '\n';
+    fs.writeFileSync(ENV_PATH, content);
+    return;
+  }
+
+  for (const [key, value] of Object.entries(updates)) {
+    // Replace existing key= lines, or append
+    const regex = new RegExp(`^${key}=.*$`, 'm');
+    if (regex.test(content)) {
+      content = content.replace(regex, `${key}=${value}`);
+    } else {
+      content += `\n${key}=${value}\n`;
+    }
+  }
+
+  fs.writeFileSync(ENV_PATH, content);
+}
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const isAuto = args.includes('--auto');
+  const tokenArg = args.find(a => a.startsWith('--token='));
+  const tokenValue = tokenArg ? tokenArg.split('=').slice(1).join('=') : null;
+
+  console.log('🕷️ VenomBrowser Bridge Setup');
+  console.log('═'.repeat(50));
+
+  // Load existing env
+  let existing = {};
+  if (fs.existsSync(ENV_PATH)) {
+    existing = parseEnv(fs.readFileSync(ENV_PATH, 'utf8'));
+    console.log('📄 Found existing .env file');
+  } else {
+    console.log('📄 No .env file found — will create one');
+  }
+
+  const updates = {};
+
+  // ── REST_API_KEY ─────────────────────────────────────────────────────────
+  if (!existing.REST_API_KEY || existing.REST_API_KEY.includes('pick-any') || existing.REST_API_KEY.includes('your')) {
+    const key = generateKey();
+    updates.REST_API_KEY = key;
+    console.log(`🔑 Generated REST_API_KEY: ${key}`);
+  } else {
+    console.log(`🔑 REST_API_KEY: ${existing.REST_API_KEY.slice(0, 8)}...`);
+  }
+
+  // ── WS_AUTH_TOKEN ────────────────────────────────────────────────────────
+  if (tokenValue) {
+    updates.WS_AUTH_TOKEN = tokenValue;
+    console.log(`🔐 WS_AUTH_TOKEN set from --token flag`);
+  } else if (isAuto) {
+    if (!existing.WS_AUTH_TOKEN || existing.WS_AUTH_TOKEN.includes('paste')) {
+      console.log('⚠️  WS_AUTH_TOKEN not set. After loading the extension, run:');
+      console.log('   node bin/venombrowser-setup.js --token=<paste-token-from-extension-popup>');
+    }
+  } else {
+    // Interactive
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    if (!existing.WS_AUTH_TOKEN || existing.WS_AUTH_TOKEN.includes('paste')) {
+      console.log();
+      console.log('📋 To get your WS_AUTH_TOKEN:');
+      console.log('   1. Load the extension/ folder in chrome://extensions/');
+      console.log('   2. Click the VenomBrowser Bridge icon in your toolbar');
+      console.log('   3. Click the auth token to copy it');
+      console.log();
+      const token = await ask(rl, '🔐 Paste your Auth Token (or press Enter to skip): ');
+      if (token.trim()) {
+        updates.WS_AUTH_TOKEN = token.trim();
+        console.log('✅ WS_AUTH_TOKEN saved!');
+      } else {
+        console.log('⏭️  Skipped — you can set it later with: node bin/venombrowser-setup.js --token=<token>');
+      }
+    } else {
+      console.log(`🔐 WS_AUTH_TOKEN: ${existing.WS_AUTH_TOKEN.slice(0, 8)}...`);
+    }
+
+    rl.close();
+  }
+
+  // ── Save ──────────────────────────────────────────────────────────────────
+  if (Object.keys(updates).length > 0) {
+    updateEnvFile(updates);
+    console.log();
+    console.log('💾 Configuration saved to server/.env');
+  } else {
+    console.log();
+    console.log('✅ Configuration is already up to date');
+  }
+
+  // ── Final summary ─────────────────────────────────────────────────────────
+  const final = { ...existing, ...updates };
+  console.log();
+  console.log('🚀 Next steps:');
+  if (!final.WS_AUTH_TOKEN || final.WS_AUTH_TOKEN.includes('paste')) {
+    console.log('   1. Set your WS_AUTH_TOKEN (see instructions above)');
+    console.log('   2. venombrowser start     — start the bridge server');
+  } else {
+    console.log('   1. venombrowser start     — start the bridge server');
+  }
+  console.log('   2. venombrowser chat      — start interactive chat');
+  console.log('   3. venombrowser agent "task" — run a one-shot task');
+  console.log();
+
+  // ── Auto-register with agents ────────────────────────────────────────────
+  try {
+    const { connect } = require('../src/connect');
+    connect();
+  } catch (err) {
+    console.log('ℹ️  Auto-registration skipped:', err.message);
+    // Still print manual instructions as fallback
+    const absPath = path.resolve(__dirname, 'venombrowser-mcp.js').replace(/\\/g, '/');
+    console.log('🔌 To connect Claude Code or other MCP agents, add this to your MCP config:');
+    console.log(JSON.stringify({
+      "venombrowser": {
+        command: "node",
+        args: [absPath],
+        env: {
+          REST_API_KEY: final.REST_API_KEY || updates.REST_API_KEY || 'your-key'
+        }
+      }
+    }, null, 2));
+    console.log();
+  }
+}
+
+main().catch(console.error);
+

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "venombrowser",
+  "version": "4.1.0",
+  "description": "Agent-agnostic browser automation platform — give any AI agent eyes and hands in your real Chrome browser",
+  "author": "TechVenom",
+  "main": "src/bridge-server.js",
+  "bin": {
+    "venombrowser": "bin/venombrowser-cli.js",
+    "venombrowser-server": "bin/venombrowser-server.js",
+    "venombrowser-mcp": "bin/venombrowser-mcp.js",
+    "venombrowser-agent": "bin/venombrowser-agent.js",
+    "venombrowser-chat": "bin/venombrowser-chat.js",
+    "venombrowser-setup": "bin/venombrowser-setup.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    ".env.example"
+  ],
+  "scripts": {
+    "setup": "node bin/venombrowser-setup.js",
+    "start": "node bin/venombrowser-server.js",
+    "mcp": "node bin/venombrowser-mcp.js",
+    "agent": "node bin/venombrowser-agent.js",
+    "chat": "node bin/venombrowser-chat.js",
+    "test": "node test/test-connection.js",
+    "prepublishOnly": "node -e \"const p=require('./package.json'); if(!p.bin||!p.bin.venombrowser){console.error('ERROR: missing bin entry');process.exit(1)} console.log('prepublishOnly: bin entry OK')\""
+  },
+  "keywords": [
+    "browser",
+    "automation",
+    "mcp",
+    "ai-agent",
+    "chrome-extension",
+    "playwright-alternative",
+    "llm",
+    "openai",
+    "anthropic",
+    "opencode",
+    "cursor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TechVenom/VenomBrowser.git",
+    "directory": "server"
+  },
+  "homepage": "https://github.com/TechVenom/VenomBrowser#readme",
+  "bugs": {
+    "url": "https://github.com/TechVenom/VenomBrowser/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.0",
+    "axios": "^1.7.7",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.21.0",
+    "jsonc-parser": "^3.3.1",
+    "uuid": "^9.0.1",
+    "ws": "^8.18.0"
+  }
+}

package/src/bridge-client.js

@@ -0,0 +1,207 @@
+/**
+ * VenomBrowser Bridge Client — Kimi-style HTTP client
+ *
+ * Communicates with the daemon via single POST /command endpoint.
+ * Format: { action, args, session }
+ *
+ * Usage:
+ *   const client = new BrowserBridge({ session: 'my-task' });
+ *   await client.navigate('https://example.com');
+ *   const snapshot = await client.snapshot();
+ */
+
+const axios = require('axios');
+
+class BridgeError extends Error {}
+class BridgeNotConnectedError extends BridgeError {}
+class BridgeTimeoutError extends BridgeError {}
+class BridgeCommandError extends BridgeError {}
+
+class BrowserBridge {
+  constructor({ host = '127.0.0.1', port = 10086, session = 'default' } = {}) {
+    this.baseUrl = `http://${host}:${port}`;
+    this.session = session;
+    this.http = axios.create({
+      baseURL: this.baseUrl,
+      timeout: 60000
+    });
+  }
+
+  // ─── Core command method ─────────────────────────────────────────────────
+  async command(action, args = {}, timeout = 30000) {
+    try {
+      const response = await this.http.post('/command', {
+        action,
+        args,
+        session: this.session
+      }, { timeout });
+      return response.data;
+    } catch (e) {
+      this._handleError(e, action);
+    }
+  }
+
+  // ─── Connection ───────────────────────────────────────────────────────────
+  async isConnected() {
+    try {
+      const r = await this.http.get('/health');
+      return r.data.server === 'ok';
+    } catch { return false; }
+  }
+
+  async getStatus() {
+    return this._get('/status');
+  }
+
+  // ─── Navigation (Kimi-style) ─────────────────────────────────────────────
+  async navigate(url, { newTab = false, group_title } = {}) {
+    return this.command('navigate', { url, newTab, group_title }, 45000);
+  }
+
+  // ─── Tab management (Kimi-style) ─────────────────────────────────────────
+  async findTab(url, { active = false } = {}) {
+    return this.command('find_tab', { url, active });
+  }
+
+  async listTabs() {
+    const r = await this.command('list_tabs');
+    return r.tabs || [];
+  }
+
+  async closeTab(tabId) {
+    return this.command('close_tab', { tabId });
+  }
+
+  async closeSession() {
+    return this.command('close_session');
+  }
+
+  // ─── Content interaction (Kimi-style) ────────────────────────────────────
+  async snapshot() {
+    return this.command('snapshot');
+  }
+
+  async click(selector) {
+    return this.command('click', { selector });
+  }
+
+  async fill(selector, value) {
+    return this.command('fill', { selector, value });
+  }
+
+  async type(selector, text, { pressEnter = false } = {}) {
+    return this.command('type', { selector, text, pressEnter });
+  }
+
+  async submitForm(selector) {
+    return this.command('submit_form', { selector });
+  }
+
+  async evaluate(code) {
+    return this.command('evaluate', { code }, 30000);
+  }
+
+  async cdp(method, params = {}) {
+    return this.command('cdp', { method, params }, 30000);
+  }
+
+  // ─── Screenshots (Kimi-style — returns file path, not base64) ────────────
+  async screenshot({ format = 'png', quality, selector, path } = {}) {
+    return this.command('screenshot', { format, quality, selector, path });
+  }
+
+  // ─── Network monitoring (Kimi-style) ─────────────────────────────────────
+  async network(cmd, { filter, requestId } = {}) {
+    return this.command('network', { cmd, filter, requestId });
+  }
+
+  // ─── File upload (Kimi-style) ────────────────────────────────────────────
+  async upload(selector, files) {
+    return this.command('upload', { selector, files });
+  }
+
+  // ─── Save as PDF (Kimi-style) ────────────────────────────────────────────
+  async saveAsPdf({ paper_format, landscape, scale, print_background, path } = {}) {
+    return this.command('save_as_pdf', { paper_format, landscape, scale, print_background, path }, 60000);
+  }
+
+  // ─── Scroll ───────────────────────────────────────────────────────────────
+  async scroll(direction = 'down', amount = 500) {
+    return this.command('scroll', { direction, amount });
+  }
+
+  // ─── Legacy compatibility (maps old names to new) ─────────────────────────
+  async extract(selector = null) {
+    const r = await this.evaluate(`
+      (() => {
+        ${selector
+          ? `const el = document.querySelector('${selector.replace(/'/g, "\\'")}');
+             return el ? { text: el.innerText || el.textContent || '' } : null;`
+          : `const clone = document.body.cloneNode(true);
+             ['script','style','noscript','svg','iframe'].forEach(t =>
+               clone.querySelectorAll(t).forEach(e => e.remove()));
+             return { text: clone.innerText || clone.textContent || '' };`
+        }
+      })()
+    `);
+    return r.value?.text || '';
+  }
+
+  async getLinks({ selector = 'a' } = {}) {
+    const r = await this.evaluate(`
+      (() => {
+        return Array.from(document.querySelectorAll('${selector.replace(/'/g, "\\'")}'))
+          .map(a => ({ text: (a.innerText||'').trim(), href: a.href }))
+          .filter(l => l.href && l.href !== location.href);
+      })()
+    `);
+    return r.value || [];
+  }
+
+  async getForms() {
+    const r = await this.evaluate(`
+      (() => {
+        return Array.from(document.forms).map((f, i) => ({
+          index: i, action: f.action, method: f.method,
+          fields: Array.from(f.elements).map(e => ({
+            name: e.name, type: e.type, tag: e.tagName.toLowerCase(),
+            value: e.value, placeholder: e.placeholder || null
+          }))
+        }));
+      })()
+    `);
+    return r.value || [];
+  }
+
+  async getCurrentUrl() {
+    const r = await this.evaluate('location.href');
+    return r.value || '';
+  }
+
+  async getPageTitle() {
+    const r = await this.evaluate('document.title');
+    return r.value || '';
+  }
+
+  // ─── HTTP helpers ─────────────────────────────────────────────────────────
+  async _get(path) {
+    try {
+      return (await this.http.get(path)).data;
+    } catch (e) { this._handleError(e, `GET ${path}`); }
+  }
+
+  _handleError(e, context) {
+    if (e.response?.status === 503) throw new BridgeNotConnectedError('Extension not connected');
+    if (e.response?.status === 408) throw new BridgeTimeoutError(`${context} timed out`);
+    if (e.code === 'ECONNREFUSED') throw new BridgeNotConnectedError(`Server not running on ${this.baseUrl}`);
+    throw new BridgeCommandError(`${context}: ${e.response?.data?.error ?? e.message}`);
+  }
+}
+
+module.exports = {
+  BrowserBridge,
+  BridgeError,
+  BridgeNotConnectedError,
+  BridgeTimeoutError,
+  BridgeCommandError
+};