@actionbookdev/cli 0.1.2 → 0.2.0

package/README.md

@@ -22,6 +22,10 @@ actionbook sources
 
 # Search sources
 actionbook sources search "linkedin"
+
+# Browser automation (requires agent-browser)
+actionbook browser open example.com
+actionbook browser snapshot -i
 ```
 
 ## Commands
@@ -89,6 +93,61 @@ actionbook sources search "e-commerce" --limit 20
 
 **Alias:** `actionbook sources s`
 
+### `actionbook browser [command]`
+
+Execute browser automation commands. This command forwards all arguments to `agent-browser` CLI.
+
+```bash
+# Open a website
+actionbook browser open example.com
+
+# Take interactive snapshot
+actionbook browser snapshot -i
+
+# Click element by reference
+actionbook browser click @e1
+
+# Fill input field
+actionbook browser fill @e3 "test@example.com"
+
+# Check current session
+actionbook browser session
+
+# Close browser
+actionbook browser close
+```
+
+**Setup:**
+
+```bash
+# npm (recommended)
+# Download Chromium
+actionbook browser install
+
+# Linux users - include system dependencies
+actionbook browser install --with-deps
+# or manually: npx playwright install-deps chromium
+```
+
+**Common Commands:**
+- `open <url>` - Navigate to URL
+- `snapshot -i` - Get interactive elements with references
+- `click <selector>` - Click element (or @ref)
+- `fill <selector> <text>` - Fill input field
+- `type <selector> <text>` - Type into element
+- `wait <selector|ms>` - Wait for element or time
+- `screenshot [path]` - Take screenshot
+- `close` - Close browser
+
+**For full command list:**
+
+```bash
+actionbook browser --help
+actionbook browser  # Shows full agent-browser help
+```
+
+**Learn more:** [agent-browser on GitHub](https://github.com/vercel-labs/agent-browser)
+
 ## Authentication
 
 Set your API key via environment variable:
@@ -144,6 +203,20 @@ actionbook search "login" --source-ids 1,2
 actionbook get "booking.com" --json | jq '.elements'
 ```
 
+### Browser Automation Workflow
+
+```bash
+# 1. Get action details with verified selectors
+actionbook get "github.com/login"
+
+# 2. Use browser command to automate
+actionbook browser open "https://github.com/login"
+actionbook browser snapshot -i
+actionbook browser fill @e1 "username"
+actionbook browser fill @e2 "password"
+actionbook browser click @e3
+```
+
 ## Related Packages
 
 - [`@actionbookdev/sdk`](https://www.npmjs.com/package/@actionbookdev/sdk) - JavaScript/TypeScript SDK

package/dist/commands/act.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const actCommand: Command;
+//# sourceMappingURL=act.d.ts.map

package/dist/commands/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,eAAO,MAAM,UAAU,SAiDnB,CAAA"}

package/dist/commands/act.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { checkCommandExists, spawnCommand, showAgentBrowserInstallation, } from '../utils/process.js';
+export const actCommand = new Command('act')
+    .description('Execute agent-browser commands (browser automation)')
+    .allowUnknownOption(true) // Critical: allow any args through
+    .allowExcessArguments(true)
+    .helpOption('-h, --help', 'Display help for actionbook act')
+    .addHelpText('after', `
+Examples:
+  $ actionbook act open example.com
+  $ actionbook act snapshot -i
+  $ actionbook act click @e1
+  $ actionbook act fill @e3 "test@example.com"
+
+For detailed agent-browser commands:
+  $ agent-browser --help
+
+Learn more: ${chalk.cyan('https://github.com/vercel-labs/agent-browser')}
+  `)
+    .action(async (_options, command) => {
+    // Get all arguments passed after 'act'
+    const args = command.args;
+    // If no args and user didn't ask for help, show agent-browser help
+    if (args.length === 0) {
+        console.log(chalk.dim('Powered by agent-browser\n'));
+        console.log(chalk.yellow('No arguments provided. Showing agent-browser help:\n'));
+        if (!checkCommandExists('agent-browser')) {
+            showAgentBrowserInstallation();
+            process.exit(1);
+        }
+        const exitCode = await spawnCommand('agent-browser', ['--help']);
+        process.exit(exitCode);
+        return;
+    }
+    // Check if agent-browser is installed
+    if (!checkCommandExists('agent-browser')) {
+        showAgentBrowserInstallation();
+        process.exit(1);
+    }
+    // Execute agent-browser with all args
+    console.log(chalk.dim('Powered by agent-browser\n'));
+    const exitCode = await spawnCommand('agent-browser', args);
+    process.exit(exitCode);
+});
+//# sourceMappingURL=act.js.map

package/dist/commands/act.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.js","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,qBAAqB,CAAA;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,qDAAqD,CAAC;KAClE,kBAAkB,CAAC,IAAI,CAAC,CAAC,mCAAmC;KAC5D,oBAAoB,CAAC,IAAI,CAAC;KAC1B,UAAU,CAAC,YAAY,EAAE,iCAAiC,CAAC;KAC3D,WAAW,CACV,OAAO,EACP;;;;;;;;;;cAUU,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC;GACrE,CACA;KACA,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAClC,uCAAuC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IAEzB,mEAAmE;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAA;QACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sDAAsD,CAAC,CAAC,CAAA;QAEjF,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC;YACzC,4BAA4B,EAAE,CAAA;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,4BAA4B,EAAE,CAAA;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAA;IACpD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;IAC1D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC,CAAC,CAAA"}

package/dist/commands/browser.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const browserCommand: Command;
+//# sourceMappingURL=browser.d.ts.map

package/dist/commands/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/commands/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,eAAO,MAAM,cAAc,SA8CvB,CAAA"}

package/dist/commands/browser.js

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { spawnAgentBrowser, installAgentBrowser } from '../utils/process.js';
+export const browserCommand = new Command('browser')
+    .description('Execute actionbook browser commands (browser automation)')
+    .allowUnknownOption(true) // Critical: allow any args through
+    .allowExcessArguments(true)
+    .helpOption('-h, --help', 'Display help for actionbook browser')
+    .addHelpText('after', `
+Examples:
+  $ actionbook browser open example.com
+  $ actionbook browser snapshot -i
+  $ actionbook browser click @e1
+  $ actionbook browser fill @e3 "test@example.com"
+
+Setup:
+  $ actionbook browser install          # Download Chromium browser
+  $ actionbook browser install --with-deps  # Linux: include system dependencies
+
+For detailed commands:
+  $ actionbook browser
+
+Learn more: ${chalk.cyan('https://github.com/vercel-labs/agent-browser')}
+  `)
+    .action(async (_options, command) => {
+    // Get all arguments passed after 'browser'
+    const args = command.args;
+    // If no args and user didn't ask for help, show agent-browser help
+    if (args.length === 0) {
+        console.log(chalk.yellow('No arguments provided. Showing agent-browser help:\n'));
+        const exitCode = await spawnAgentBrowser(['--help']);
+        process.exit(exitCode);
+        return;
+    }
+    // Special handling for 'install' command - auto-install agent-browser if needed
+    if (args[0] === 'install') {
+        const exitCode = await installAgentBrowser(args.slice(1));
+        process.exit(exitCode);
+        return;
+    }
+    // Execute agent-browser with all args
+    const exitCode = await spawnAgentBrowser(args);
+    process.exit(exitCode);
+});
+//# sourceMappingURL=browser.js.map

package/dist/commands/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/commands/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE5E,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CAAC,0DAA0D,CAAC;KACvE,kBAAkB,CAAC,IAAI,CAAC,CAAC,mCAAmC;KAC5D,oBAAoB,CAAC,IAAI,CAAC;KAC1B,UAAU,CAAC,YAAY,EAAE,qCAAqC,CAAC;KAC/D,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;cAcU,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC;GACrE,CACA;KACA,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAClC,2CAA2C;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IAEzB,mEAAmE;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sDAAsD,CAAC,CAAC,CAAA;QACjF,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IAED,gFAAgF;IAChF,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IAED,sCAAsC;IACtC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC9C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC,CAAC,CAAA"}

package/dist/index.js

@@ -1,16 +1,23 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
 import { searchCommand } from './commands/search.js';
 import { getCommand } from './commands/get.js';
 import { sourcesCommand } from './commands/sources.js';
+import { browserCommand } from './commands/browser.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
 const program = new Command();
 program
     .name('actionbook')
     .description('CLI for Actionbook - Get website action manuals for AI agents')
-    .version('0.1.0')
+    .version(pkg.version)
     .option('--api-key <key>', 'API key (or set ACTIONBOOK_API_KEY env var)');
 program.addCommand(searchCommand);
 program.addCommand(getCommand);
 program.addCommand(sourcesCommand);
+program.addCommand(browserCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC,CAAA;AAE3E,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC9B,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AAElC,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AAEpF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC,CAAA;AAE3E,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC9B,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AAElC,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/utils/process.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Spawn a command with arguments, inheriting stdio
+ * Returns the exit code
+ * If command is not found (ENOENT), shows installation instructions
+ * @param suppressInstallInstructions - If true, don't show installation instructions on ENOENT
+ */
+export declare function spawnCommand(command: string, args: string[], suppressInstallInstructions?: boolean): Promise<number>;
+/**
+ * Spawn agent-browser command using npx from CLI package directory
+ * This ensures agent-browser is executed from the CLI's node_modules
+ * Replaces "agent-browser" with "actionbook browser" in output
+ */
+export declare function spawnAgentBrowser(args: string[]): Promise<number>;
+/**
+ * Show installation instructions for agent-browser
+ */
+export declare function showAgentBrowserInstallation(): void;
+/**
+ * Install Chromium browser binaries for agent-browser
+ * @param installArgs - Additional arguments like ['--with-deps'] for Linux
+ */
+export declare function installAgentBrowser(installArgs?: string[]): Promise<number>;
+//# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,2BAA2B,UAAQ,GAClC,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDvE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAYnD;AAoBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDrF"}

package/dist/utils/process.js

@@ -0,0 +1,179 @@
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import chalk from 'chalk';
+/**
+ * Spawn a command with arguments, inheriting stdio
+ * Returns the exit code
+ * If command is not found (ENOENT), shows installation instructions
+ * @param suppressInstallInstructions - If true, don't show installation instructions on ENOENT
+ */
+export async function spawnCommand(command, args, suppressInstallInstructions = false) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            stdio: 'inherit',
+            shell: false,
+            env: process.env,
+        });
+        child.on('close', (code, signal) => {
+            if (signal) {
+                // Process was killed by signal (e.g., SIGINT from Ctrl+C)
+                // Convert signal to exit code: 128 + signal number
+                resolve(128 + (signal === 'SIGINT' ? 2 : 15));
+            }
+            else {
+                resolve(code ?? 1);
+            }
+        });
+        child.on('error', (error) => {
+            // Command not found - show installation instructions
+            if (error.code === 'ENOENT') {
+                if (!suppressInstallInstructions) {
+                    showAgentBrowserInstallation();
+                }
+                resolve(127); // Standard exit code for command not found
+            }
+            else {
+                console.error(chalk.red(`Failed to execute ${command}: ${error.message}`));
+                resolve(1);
+            }
+        });
+    });
+}
+/**
+ * Spawn agent-browser command using npx from CLI package directory
+ * This ensures agent-browser is executed from the CLI's node_modules
+ * Replaces "agent-browser" with "actionbook browser" in output
+ */
+export async function spawnAgentBrowser(args) {
+    return new Promise((resolve) => {
+        // Get CLI package root directory (dist/utils/process.js -> ../..)
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const cliPackageRoot = join(__dirname, '..', '..');
+        const child = spawn('npx', ['agent-browser', ...args], {
+            stdio: ['inherit', 'pipe', 'pipe'], // Inherit stdin, pipe stdout/stderr for transformation
+            shell: false,
+            env: process.env,
+            cwd: cliPackageRoot, // Execute in CLI package directory
+        });
+        // Transform and output stdout
+        if (child.stdout) {
+            child.stdout.on('data', (data) => {
+                const output = data.toString().replace(/agent-browser/g, 'actionbook browser');
+                process.stdout.write(output);
+            });
+        }
+        // Transform and output stderr
+        if (child.stderr) {
+            child.stderr.on('data', (data) => {
+                const output = data.toString().replace(/agent-browser/g, 'actionbook browser');
+                process.stderr.write(output);
+            });
+        }
+        child.on('close', (code, signal) => {
+            if (signal) {
+                resolve(128 + (signal === 'SIGINT' ? 2 : 15));
+            }
+            else {
+                resolve(code ?? 1);
+            }
+        });
+        child.on('error', (error) => {
+            if (error.code === 'ENOENT') {
+                console.error(chalk.red('\nnpx command not found.'));
+                console.error(chalk.white('Please ensure npm 5.2+ is installed.\n'));
+                resolve(127);
+            }
+            else {
+                console.error(chalk.red(`Failed to execute agent-browser: ${error.message}`));
+                resolve(1);
+            }
+        });
+    });
+}
+/**
+ * Show installation instructions for agent-browser
+ */
+export function showAgentBrowserInstallation() {
+    console.error(chalk.red('\nagent-browser is not installed or not in PATH.\n'));
+    console.error(chalk.white('agent-browser is a fast browser automation CLI for AI agents.'));
+    console.error(chalk.white('To install it, run:\n'));
+    console.error(chalk.cyan('  npm install -g agent-browser\n'));
+    console.error(chalk.white('Learn more: ') + chalk.cyan('https://github.com/vercel-labs/agent-browser\n'));
+    console.error(chalk.white('After installation, verify with:\n'));
+    console.error(chalk.cyan('  agent-browser --help\n'));
+}
+/**
+ * Get playwright-core version from agent-browser's package.json
+ * Returns version string like "1.57.0" (without ^ or ~ prefix)
+ */
+function getAgentBrowserPlaywrightVersion(cliPackageRoot) {
+    try {
+        const agentBrowserPkgPath = join(cliPackageRoot, 'node_modules', 'agent-browser', 'package.json');
+        const pkgContent = readFileSync(agentBrowserPkgPath, 'utf-8');
+        const pkg = JSON.parse(pkgContent);
+        const playwrightCoreVersion = pkg.dependencies?.['playwright-core'] || '';
+        // Remove ^ ~ or other semver prefixes
+        return playwrightCoreVersion.replace(/^[\^~]/, '');
+    }
+    catch (error) {
+        console.warn(chalk.yellow('Warning: Could not read agent-browser version, using latest playwright'));
+        return 'latest';
+    }
+}
+/**
+ * Install Chromium browser binaries for agent-browser
+ * @param installArgs - Additional arguments like ['--with-deps'] for Linux
+ */
+export async function installAgentBrowser(installArgs = []) {
+    console.log(chalk.cyan('Setting up browser automation...\n'));
+    console.log(chalk.yellow('Downloading Chromium browser binaries...\n'));
+    // Get CLI package root directory to run npx from there
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const cliPackageRoot = join(__dirname, '..', '..');
+    // Dynamically get playwright version from agent-browser to ensure binary compatibility
+    const playwrightVersion = getAgentBrowserPlaywrightVersion(cliPackageRoot);
+    const playwrightArgs = [`playwright@${playwrightVersion}`, 'install', 'chromium'];
+    // Add --with-deps if requested (Linux only)
+    if (installArgs.includes('--with-deps')) {
+        playwrightArgs.push('--with-deps');
+    }
+    const exitCode = await new Promise((resolve) => {
+        const child = spawn('npx', playwrightArgs, {
+            stdio: 'inherit',
+            shell: false,
+            env: process.env,
+            cwd: cliPackageRoot,
+        });
+        child.on('close', (code, signal) => {
+            if (signal) {
+                resolve(128 + (signal === 'SIGINT' ? 2 : 15));
+            }
+            else {
+                resolve(code ?? 1);
+            }
+        });
+        child.on('error', (error) => {
+            if (error.code === 'ENOENT') {
+                console.error(chalk.red('\nnpx command not found.'));
+                console.error(chalk.white('Please ensure npm 5.2+ is installed.\n'));
+                resolve(127);
+            }
+            else {
+                console.error(chalk.red(`Failed to install Chromium: ${error.message}`));
+                resolve(1);
+            }
+        });
+    });
+    if (exitCode === 0) {
+        console.log(chalk.green('\n✓ Browser automation setup complete!\n'));
+        console.log(chalk.white('You can now use: ') + chalk.cyan('actionbook browser <command>\n'));
+    }
+    else {
+        console.error(chalk.red('\nBrowser setup encountered an error.'));
+        console.error(chalk.white('Please check the output above for details.\n'));
+    }
+    return exitCode;
+}
+//# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actionbookdev/cli",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "CLI for Actionbook - Get website action manuals for AI agents",
   "private": false,
   "type": "module",
@@ -15,10 +15,19 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "lint": "eslint . --ext .ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
   "dependencies": {
-    "commander": "^12.1.0",
+    "@actionbookdev/sdk": "workspace:*",
+    "agent-browser": "^0.8.3",
     "chalk": "^5.3.0",
-    "@actionbookdev/sdk": "0.2.2"
+    "commander": "^12.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",
@@ -44,12 +53,5 @@
   },
   "homepage": "https://actionbook.dev",
   "author": "Actionbook Team",
-  "license": "Apache-2.0",
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsc -p tsconfig.build.json --watch",
-    "test": "vitest run",
-    "lint": "eslint . --ext .ts",
-    "clean": "rimraf dist"
-  }
-}
+  "license": "Apache-2.0"
+}

package/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 2025 Cue Labs, Inc.
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.