agent-browser 0.1.3 → 0.3.0

package/dist/cli-light.js

@@ -0,0 +1,409 @@
+#!/usr/bin/env bun
+/**
+ * Lightweight CLI client for agent-browser
+ *
+ * This file contains ONLY the client logic (no Playwright imports).
+ * It can be compiled with Bun for fast startup times.
+ *
+ * The actual browser automation runs in a separate daemon process.
+ */
+import * as net from 'net';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { spawn } from 'child_process';
+// ============================================================================
+// Configuration
+// ============================================================================
+const SESSION = process.env.AGENT_BROWSER_SESSION || 'default';
+const SOCKET_PATH = path.join(os.tmpdir(), `agent-browser-${SESSION}.sock`);
+const PID_FILE = path.join(os.tmpdir(), `agent-browser-${SESSION}.pid`);
+// ============================================================================
+// Daemon Management
+// ============================================================================
+function isDaemonRunning() {
+    if (!fs.existsSync(PID_FILE))
+        return false;
+    try {
+        const pid = parseInt(fs.readFileSync(PID_FILE, 'utf8').trim(), 10);
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDaemon() {
+    if (isDaemonRunning() && fs.existsSync(SOCKET_PATH)) {
+        return;
+    }
+    // Find the daemon script - look relative to this script
+    const scriptDir = path.dirname(process.argv[1]);
+    let daemonPath = path.join(scriptDir, 'daemon.js');
+    // Fallback paths
+    if (!fs.existsSync(daemonPath)) {
+        daemonPath = path.join(scriptDir, '../dist/daemon.js');
+    }
+    if (!fs.existsSync(daemonPath)) {
+        daemonPath = path.join(process.cwd(), 'dist/daemon.js');
+    }
+    if (!fs.existsSync(daemonPath)) {
+        throw new Error(`Daemon not found. Looked in: ${daemonPath}`);
+    }
+    const child = spawn('node', [daemonPath], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, AGENT_BROWSER_DAEMON: '1', AGENT_BROWSER_SESSION: SESSION },
+    });
+    child.unref();
+    // Wait for socket
+    for (let i = 0; i < 50; i++) {
+        if (fs.existsSync(SOCKET_PATH))
+            return;
+        await new Promise(r => setTimeout(r, 100));
+    }
+    throw new Error('Failed to start daemon');
+}
+async function sendCommand(cmd) {
+    return new Promise((resolve, reject) => {
+        let buffer = '';
+        let resolved = false;
+        const socket = net.createConnection(SOCKET_PATH);
+        const cleanup = () => {
+            socket.removeAllListeners();
+            socket.destroy();
+        };
+        socket.on('connect', () => {
+            socket.write(JSON.stringify(cmd) + '\n');
+        });
+        socket.on('data', (data) => {
+            buffer += data.toString();
+            const idx = buffer.indexOf('\n');
+            if (idx !== -1 && !resolved) {
+                resolved = true;
+                try {
+                    const response = JSON.parse(buffer.substring(0, idx));
+                    cleanup();
+                    resolve(response);
+                }
+                catch {
+                    cleanup();
+                    reject(new Error('Invalid JSON response'));
+                }
+            }
+        });
+        socket.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                reject(err);
+            }
+        });
+        socket.on('close', () => {
+            if (!resolved && buffer.trim()) {
+                resolved = true;
+                try {
+                    resolve(JSON.parse(buffer.trim()));
+                }
+                catch {
+                    reject(new Error('Connection closed'));
+                }
+            }
+        });
+        setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                reject(new Error('Timeout'));
+            }
+        }, 30000);
+    });
+}
+// ============================================================================
+// Command Parsing
+// ============================================================================
+function parseCommand(parts) {
+    if (parts.length === 0)
+        return null;
+    const command = parts[0];
+    const rest = parts.slice(1);
+    const id = Math.random().toString(36).slice(2, 10);
+    switch (command) {
+        case 'open':
+        case 'goto':
+        case 'navigate':
+            return { id, action: 'navigate', url: rest[0]?.startsWith('http') ? rest[0] : `https://${rest[0]}` };
+        case 'click':
+            return { id, action: 'click', selector: rest[0] };
+        case 'fill':
+            return { id, action: 'fill', selector: rest[0], value: rest.slice(1).join(' ') };
+        case 'type':
+            return { id, action: 'type', selector: rest[0], text: rest.slice(1).join(' ') };
+        case 'hover':
+            return { id, action: 'hover', selector: rest[0] };
+        case 'snapshot': {
+            const opts = { id, action: 'snapshot' };
+            // Parse snapshot options from rest args
+            for (let i = 0; i < rest.length; i++) {
+                const arg = rest[i];
+                if (arg === '-i' || arg === '--interactive') {
+                    opts.interactive = true;
+                }
+                else if (arg === '-c' || arg === '--compact') {
+                    opts.compact = true;
+                }
+                else if (arg === '--depth' || arg === '-d') {
+                    opts.maxDepth = parseInt(rest[++i], 10);
+                }
+                else if (arg === '--selector' || arg === '-s') {
+                    opts.selector = rest[++i];
+                }
+            }
+            return opts;
+        }
+        case 'screenshot':
+            return { id, action: 'screenshot', path: rest[0] };
+        case 'close':
+        case 'quit':
+            return { id, action: 'close' };
+        case 'get':
+            if (rest[0] === 'text')
+                return { id, action: 'gettext', selector: rest[1] };
+            if (rest[0] === 'url')
+                return { id, action: 'url' };
+            if (rest[0] === 'title')
+                return { id, action: 'title' };
+            return null;
+        case 'press':
+            return { id, action: 'press', key: rest[0] };
+        case 'wait':
+            if (/^\d+$/.test(rest[0])) {
+                return { id, action: 'wait', timeout: parseInt(rest[0], 10) };
+            }
+            return { id, action: 'wait', selector: rest[0] };
+        case 'back':
+            return { id, action: 'back' };
+        case 'forward':
+            return { id, action: 'forward' };
+        case 'reload':
+            return { id, action: 'reload' };
+        case 'eval':
+            return { id, action: 'evaluate', script: rest.join(' ') };
+        default:
+            return null;
+    }
+}
+function parseBatchCommands(args) {
+    const commands = [];
+    // Each argument after 'batch' is a command string
+    for (const arg of args) {
+        // Split the command string into parts
+        const parts = arg.match(/(?:[^\s"]+|"[^"]*")+/g) || [];
+        const cleanParts = parts.map(p => p.replace(/^"|"$/g, ''));
+        const cmd = parseCommand(cleanParts);
+        if (cmd) {
+            commands.push(cmd);
+        }
+    }
+    return commands;
+}
+// ============================================================================
+// Output Formatting
+// ============================================================================
+function formatResponse(response) {
+    if (!response.success) {
+        return `\x1b[31m✗ Error:\x1b[0m ${response.error}`;
+    }
+    const data = response.data;
+    if (data?.url && data?.title) {
+        return `\x1b[32m✓\x1b[0m \x1b[1m${data.title}\x1b[0m\n\x1b[2m  ${data.url}\x1b[0m`;
+    }
+    else if (data?.snapshot) {
+        return String(data.snapshot);
+    }
+    else if (data?.text !== undefined) {
+        return String(data.text);
+    }
+    else if (data?.url) {
+        return String(data.url);
+    }
+    else if (data?.title) {
+        return String(data.title);
+    }
+    else if (data?.result !== undefined) {
+        return typeof data.result === 'object' ? JSON.stringify(data.result, null, 2) : String(data.result);
+    }
+    else if (data?.closed) {
+        return '\x1b[32m✓\x1b[0m Browser closed';
+    }
+    else {
+        return '\x1b[32m✓\x1b[0m Done';
+    }
+}
+function printResponse(response, json) {
+    if (json) {
+        console.log(JSON.stringify(response));
+    }
+    else {
+        console.log(formatResponse(response));
+    }
+}
+// ============================================================================
+// Main
+// ============================================================================
+const HELP = `
+agent-browser - fast browser automation CLI
+
+Usage: 
+  agent-browser <command> [args] [--json]
+  agent-browser batch <cmd1> <cmd2> ... [--json]
+
+Commands:
+  open <url>              Navigate to URL
+  click <sel>             Click element (use @ref from snapshot)
+  fill <sel> <text>       Fill input
+  type <sel> <text>       Type text
+  hover <sel>             Hover element
+  snapshot [options]      Get accessibility tree with refs
+  screenshot [path]       Take screenshot
+  get text <sel>          Get text content
+  get url                 Get current URL
+  get title               Get page title
+  press <key>             Press keyboard key
+  wait <ms|sel>           Wait for time or element
+  eval <js>               Evaluate JavaScript
+  close                   Close browser
+
+Snapshot Options:
+  -i, --interactive       Only show interactive elements (buttons, links, inputs)
+  -c, --compact           Remove empty structural elements
+  -d, --depth <n>         Limit tree depth (e.g., --depth 3)
+  -s, --selector <sel>    Scope snapshot to CSS selector
+
+Batch Mode:
+  batch <cmd1> <cmd2> ... Execute multiple commands in sequence
+                          Each command is a quoted string
+
+Options:
+  --json                  Output JSON (for AI agents)
+
+Examples:
+  agent-browser open example.com
+  agent-browser snapshot
+  agent-browser click @e2
+  agent-browser fill @e3 "hello"
+
+  # Batch mode - execute multiple commands efficiently
+  agent-browser batch "open example.com" "snapshot" "click a"
+  agent-browser batch "open google.com" "snapshot" "get title" --json
+`;
+async function runBatch(commands, json) {
+    const results = [];
+    let hasError = false;
+    for (const cmd of commands) {
+        try {
+            const response = await sendCommand(cmd);
+            results.push(response);
+            if (!json) {
+                // Print each result as we go for non-JSON mode
+                console.log(`\x1b[36m[${cmd.action}]\x1b[0m`);
+                console.log(formatResponse(response));
+                console.log();
+            }
+            if (!response.success) {
+                hasError = true;
+                break; // Stop on first error
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const errorResponse = {
+                id: String(cmd.id),
+                success: false,
+                error: message,
+            };
+            results.push(errorResponse);
+            hasError = true;
+            if (!json) {
+                console.log(`\x1b[36m[${cmd.action}]\x1b[0m`);
+                console.log(`\x1b[31m✗ Error:\x1b[0m ${message}`);
+            }
+            break;
+        }
+    }
+    if (json) {
+        console.log(JSON.stringify({
+            success: !hasError,
+            results,
+            completed: results.length,
+            total: commands.length,
+        }));
+    }
+    else {
+        console.log(`\x1b[2m─────────────────────────────────────\x1b[0m`);
+        console.log(`Completed ${results.length}/${commands.length} commands`);
+    }
+    process.exit(hasError ? 1 : 0);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const json = args.includes('--json');
+    const cleanArgs = args.filter(a => !a.startsWith('--'));
+    if (cleanArgs.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    // Check for batch mode
+    if (cleanArgs[0] === 'batch') {
+        const batchArgs = cleanArgs.slice(1);
+        if (batchArgs.length === 0) {
+            console.error('\x1b[31mBatch mode requires at least one command\x1b[0m');
+            console.log('\nExample: agent-browser batch "open example.com" "snapshot"');
+            process.exit(1);
+        }
+        const commands = parseBatchCommands(batchArgs);
+        if (commands.length === 0) {
+            console.error('\x1b[31mNo valid commands found\x1b[0m');
+            process.exit(1);
+        }
+        try {
+            await ensureDaemon();
+            await runBatch(commands, json);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (json) {
+                console.log(JSON.stringify({ success: false, error: message }));
+            }
+            else {
+                console.error('\x1b[31m✗ Error:\x1b[0m', message);
+            }
+            process.exit(1);
+        }
+        return;
+    }
+    // Single command mode
+    const cmd = parseCommand(cleanArgs);
+    if (!cmd) {
+        console.error('\x1b[31mUnknown command:\x1b[0m', cleanArgs[0]);
+        process.exit(1);
+    }
+    try {
+        await ensureDaemon();
+        const response = await sendCommand(cmd);
+        printResponse(response, json);
+        process.exit(response.success ? 0 : 1);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (json) {
+            console.log(JSON.stringify({ success: false, error: message }));
+        }
+        else {
+            console.error('\x1b[31m✗ Error:\x1b[0m', message);
+        }
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli-light.js.map

package/dist/cli-light.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-light.js","sourceRoot":"","sources":["../src/cli-light.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -214,7 +214,7 @@ ${c('yellow', 'Usage:')} agent-browser <command> [options]
 
 ${c('yellow', 'Core Commands:')}
   ${c('cyan', 'open')} <url>                 Navigate to URL
-  ${c('cyan', 'click')} <sel>                Click element
+  ${c('cyan', 'click')} <sel>                Click element (or @ref)
   ${c('cyan', 'type')} <sel> <text>          Type into element
   ${c('cyan', 'fill')} <sel> <text>          Clear and fill
   ${c('cyan', 'press')} <key>                Press key (Enter, Tab, Control+a)
@@ -223,10 +223,16 @@ ${c('yellow', 'Core Commands:')}
   ${c('cyan', 'scroll')} <dir> [px]          Scroll (up/down/left/right)
   ${c('cyan', 'wait')} <sel|ms>              Wait for element or time
   ${c('cyan', 'screenshot')} [path]          Take screenshot
-  ${c('cyan', 'snapshot')}                   Accessibility tree (for AI)
+  ${c('cyan', 'snapshot')}                   Accessibility tree with refs (for AI)
   ${c('cyan', 'eval')} <js>                  Run JavaScript
   ${c('cyan', 'close')}                      Close browser
 
+${c('yellow', 'Selectors:')} CSS, XPath, text=, or ${c('green', '@ref')} from snapshot
+  ${c('dim', 'CSS:')}     "#id", ".class", "button"
+  ${c('dim', 'XPath:')}   "xpath=//button"
+  ${c('dim', 'Text:')}    "text=Submit"
+  ${c('dim', 'Ref:')}     ${c('green', '@e1')}, ${c('green', '@e2')} (from snapshot output)
+
 ${c('yellow', 'Get Info:')}  agent-browser get <what> [selector]
   text, html, value, attr, title, url, count, box
 
@@ -270,13 +276,12 @@ ${c('yellow', 'Options:')}
 
 ${c('yellow', 'Examples:')}
   agent-browser open example.com
-  agent-browser click "#submit"
-  agent-browser fill "#email" "test@example.com"
-  agent-browser get text "h1"
-  agent-browser is visible ".modal"
+  agent-browser snapshot                    # Get tree with refs
+  agent-browser click @e2                   # Click by ref from snapshot
+  agent-browser fill @e3 "test@example.com" # Fill by ref
+  agent-browser click "#submit"             # CSS selector still works
+  agent-browser get text @e1                # Get text by ref
   agent-browser find role button click --name Submit
-  agent-browser wait 2000
-  agent-browser wait --load networkidle
 `);
 }
 // ============================================================================