@actionbookdev/cli 0.2.3 → 0.4.0-alpha.1

package/README.md

@@ -1,6 +1,6 @@
 # @actionbookdev/cli
 
-CLI for Actionbook - Get website action manuals for AI agents.
+CLI for Actionbook - Browser automation and action manuals for AI agents. Powered by a native Rust binary for fast startup and zero runtime dependencies.
 
 ## Installation
 
@@ -8,24 +8,25 @@ CLI for Actionbook - Get website action manuals for AI agents.
 npm install -g @actionbookdev/cli
 ```
 
+Or use directly with npx:
+
+```bash
+npx @actionbookdev/cli search "airbnb search"
+```
+
 ## Quick Start
 
 ```bash
 # Search for actions
 actionbook search "airbnb search"
 
-# Get action details
-actionbook get "https://www.airbnb.com/search"
+# Get action details by area_id
+actionbook get "airbnb.com:/:default"
 
-# List available sources
-actionbook sources
-
-# Search sources
-actionbook sources search "linkedin"
-
-# Browser automation (requires agent-browser)
-actionbook browser open example.com
-actionbook browser snapshot -i
+# Browser automation
+actionbook browser open https://example.com
+actionbook browser snapshot
+actionbook browser click "button.submit"
 ```
 
 ## Commands
@@ -36,192 +37,141 @@ Search for action manuals by keyword.
 
 ```bash
 actionbook search "google login"
-actionbook search "airbnb" --type vector --limit 10
-actionbook search "login" --source-ids 1,2,3
+actionbook search "airbnb" --domain airbnb.com
+actionbook search "login" --page 2 --page-size 20
 ```
 
 **Options:**
-- `-t, --type <type>` - Search type: `vector`, `fulltext`, or `hybrid` (default: `hybrid`)
-- `-l, --limit <number>` - Maximum results 1-100 (default: `5`)
-- `-s, --source-ids <ids>` - Filter by source IDs (comma-separated)
-- `--min-score <score>` - Minimum similarity score 0-1
-- `-j, --json` - Output raw JSON
-
-**Alias:** `actionbook s`
+- `-d, --domain <domain>` - Filter by domain (e.g., "airbnb.com")
+- `-u, --url <url>` - Filter by URL
+- `-p, --page <number>` - Page number (default: `1`)
+- `-s, --page-size <number>` - Results per page 1-100 (default: `10`)
 
-### `actionbook get <id>`
+### `actionbook get <area_id>`
 
-Get complete action details by action ID.
+Get complete action details by area ID.
 
 ```bash
-actionbook get "https://www.airbnb.com/search"
-actionbook get "airbnb.com/search"  # fuzzy matching supported
-actionbook get "releases.rs"        # domain only
+actionbook get "airbnb.com:/:default"
+actionbook get "github.com:/login:default"
 ```
 
-**Options:**
-- `-j, --json` - Output raw JSON
-
-**Alias:** `actionbook g`
+### `actionbook browser <command>`
 
-### `actionbook sources`
+Browser automation via Chrome DevTools Protocol. Uses your existing system browser (Chrome, Brave, Edge, Arc, Chromium) - no browser download required.
 
-List all available sources (websites).
+**Navigation:**
+- `open <url>` - Open URL in new tab
+- `goto <url>` - Navigate current page
+- `back` / `forward` / `reload` - History navigation
+- `pages` / `switch` - Manage tabs
 
-```bash
-actionbook sources
-actionbook sources --limit 100
-actionbook sources --json
-```
+**Interaction:**
+- `click <selector>` - Click element
+- `type <selector> <text>` - Type text (append)
+- `fill <selector> <text>` - Clear and type text
+- `select <selector> <value>` - Select dropdown option
+- `hover <selector>` / `focus <selector>` - Hover/focus element
+- `press <key>` - Press keyboard key
 
-**Options:**
-- `-l, --limit <number>` - Maximum results (default: `50`)
-- `-j, --json` - Output raw JSON
-
-### `actionbook sources search <query>`
-
-Search for sources by keyword.
-
-```bash
-actionbook sources search "airbnb"
-actionbook sources search "e-commerce" --limit 20
-```
-
-**Options:**
-- `-l, --limit <number>` - Maximum results (default: `10`)
-- `-j, --json` - Output raw JSON
-
-**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
+**Waiting:**
+- `wait <selector>` - Wait for element (default 30s)
+- `wait-nav` - Wait for navigation
 
-# Take interactive snapshot
-actionbook browser snapshot -i
-
-# Click element by reference
-actionbook browser click @e1
+**Page Inspection:**
+- `screenshot [path]` - Take screenshot
+- `pdf <path>` - Export as PDF
+- `html [selector]` - Get page/element HTML
+- `text [selector]` - Get page/element text
+- `eval <code>` - Execute JavaScript
+- `snapshot` - Get accessibility snapshot
+- `viewport` - Get viewport dimensions
 
-# Fill input field
-actionbook browser fill @e3 "test@example.com"
+**Cookies:**
+- `cookies list` / `get` / `set` / `delete` / `clear` - Cookie management
 
-# Check current session
-actionbook browser session
+**Session:**
+- `status` - Show detected browsers & session info
+- `close` / `restart` / `connect` - Session control
 
-# Close browser
-actionbook browser close
-```
+### `actionbook sources`
 
-**Setup:**
+List and search available action sources.
 
 ```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
+actionbook sources list
+actionbook sources search "github"
 ```
 
-**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
+### `actionbook config`
 
-**For full command list:**
+Manage CLI configuration.
 
 ```bash
-actionbook browser --help
-actionbook browser  # Shows full agent-browser help
+actionbook config show
+actionbook config get api.base_url
+actionbook config set api.api_key "your_key"
 ```
 
-**Learn more:** [agent-browser on GitHub](https://github.com/vercel-labs/agent-browser)
+### `actionbook profile`
 
-## Authentication
-
-Set your API key via environment variable:
-
-```bash
-export ACTIONBOOK_API_KEY=your_api_key
-```
-
-Or pass it as an option:
+Manage browser profiles for isolated sessions.
 
 ```bash
-actionbook --api-key your_api_key search "query"
+actionbook profile list
+actionbook profile create work
+actionbook profile delete work
 ```
 
-## Output Formats
-
-By default, the CLI outputs formatted, colorized results for human readability.
-
-Use `--json` flag for raw JSON output, useful for piping to other tools:
+## Global Options
 
 ```bash
-actionbook search "login" --json | jq '.results[0].action_id'
+--browser-path <path>    # Custom browser executable
+--cdp <port|url>         # Connect to existing CDP port
+--profile <name>         # Use specific browser profile
+--headless               # Run in headless mode
+--json                   # JSON output format
+--verbose, -v            # Verbose logging
 ```
 
-## Examples
-
-### Typical Workflow
+## Configuration
 
-```bash
-# 1. Search for actions
-actionbook search "airbnb search"
+Config file location: `~/.config/actionbook/config.toml`
 
-# 2. Get details for a specific action
-actionbook get "https://www.airbnb.com/search"
+```toml
+[api]
+base_url = "https://api.actionbook.dev"
+api_key = "your_key"
 
-# 3. Use the selectors in your automation script
+[browser]
+executable = "/path/to/chrome"
+default_profile = "default"
+headless = false
 ```
 
-### Filter by Source
-
-```bash
-# List sources to find IDs
-actionbook sources
-
-# Search within specific sources
-actionbook search "login" --source-ids 1,2
-```
+**Priority:** CLI args > Environment vars > Config file > Auto-discovery
 
-### JSON Output for Scripts
+## Environment Variables
 
-```bash
-# Get action and extract selectors
-actionbook get "booking.com" --json | jq '.elements'
-```
+- `ACTIONBOOK_API_KEY` - API key for Actionbook service
+- `ACTIONBOOK_BINARY_PATH` - Override binary path (for development)
 
-### Browser Automation Workflow
+## Supported Browsers
 
-```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
-```
+| Browser | macOS | Linux | Windows |
+|---------|-------|-------|---------|
+| Google Chrome | Yes | Yes | Yes |
+| Brave | Yes | Yes | Yes |
+| Microsoft Edge | Yes | Yes | Yes |
+| Arc | Yes | - | - |
+| Chromium | Yes | Yes | Yes |
 
 ## Related Packages
 
 - [`@actionbookdev/sdk`](https://www.npmjs.com/package/@actionbookdev/sdk) - JavaScript/TypeScript SDK
 - [`@actionbookdev/mcp`](https://www.npmjs.com/package/@actionbookdev/mcp) - MCP Server for AI agents
+- [`@actionbookdev/tools-ai-sdk`](https://www.npmjs.com/package/@actionbookdev/tools-ai-sdk) - Vercel AI SDK tools
 
 ## License
 
-MIT
+Apache-2.0

package/bin/actionbook.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+/**
+ * Cross-platform CLI wrapper for actionbook
+ *
+ * Detects the current platform and spawns the corresponding native Rust binary
+ * from the same directory. Supports ACTIONBOOK_BINARY_PATH env var for development.
+ */
+
+"use strict";
+
+const { spawn } = require("child_process");
+const { existsSync } = require("fs");
+const path = require("path");
+
+const PLATFORMS = {
+  "darwin-arm64": "actionbook-darwin-arm64",
+  "darwin-x64": "actionbook-darwin-x64",
+  "linux-x64": "actionbook-linux-x64",
+  "linux-arm64": "actionbook-linux-arm64",
+  "win32-x64": "actionbook-win32-x64.exe",
+  "win32-arm64": "actionbook-win32-arm64.exe",
+};
+
+function main() {
+  // Allow env var override for development
+  const envPath = process.env.ACTIONBOOK_BINARY_PATH;
+  if (envPath) {
+    run(envPath);
+    return;
+  }
+
+  const platformKey = `${process.platform}-${process.arch}`;
+  const binaryName = PLATFORMS[platformKey];
+
+  if (!binaryName) {
+    console.error(`Error: Unsupported platform: ${platformKey}`);
+    console.error(`Supported: ${Object.keys(PLATFORMS).join(", ")}`);
+    process.exit(1);
+  }
+
+  const binaryPath = path.join(__dirname, binaryName);
+
+  if (!existsSync(binaryPath)) {
+    console.error(`Error: No binary found for ${platformKey}`);
+    console.error(`Expected: ${binaryPath}`);
+    console.error("");
+    console.error("Try reinstalling:");
+    console.error("  npm install -g @actionbookdev/cli");
+    console.error("");
+    console.error("Or install the Rust CLI directly:");
+    console.error("  cargo install actionbook");
+    process.exit(1);
+  }
+
+  run(binaryPath);
+}
+
+function run(binaryPath) {
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    windowsHide: false,
+  });
+
+  child.on("error", (err) => {
+    console.error(`Error executing binary: ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on("close", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+
+main();

package/package.json

@@ -1,31 +1,20 @@
 {
   "name": "@actionbookdev/cli",
-  "version": "0.2.3",
-  "description": "CLI for Actionbook - Get website action manuals for AI agents",
+  "version": "0.4.0-alpha.1",
+  "description": "CLI for Actionbook - Browser automation and action manuals for AI agents",
   "private": false,
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "bin": {
-    "actionbook": "dist/index.js"
+    "actionbook": "./bin/actionbook.js"
   },
   "files": [
-    "dist"
+    "bin",
+    "scripts"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "agent-browser": "^0.8.3",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "@actionbookdev/sdk": "0.2.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.14.0",
-    "typescript": "^5.6.3",
-    "vitest": "^1.6.0",
-    "rimraf": "^5.0.5"
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
   },
   "engines": {
     "node": ">=18"
@@ -45,12 +34,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/scripts/postinstall.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for @actionbookdev/cli
+ *
+ * If the platform binary is missing (e.g., npm didn't include it),
+ * downloads it from GitHub Releases as a fallback.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+
+const binDir = path.join(__dirname, "..", "bin");
+
+const GITHUB_REPO = "actionbook/actionbook";
+
+function getBinaryName() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const map = {
+    "darwin-arm64": "actionbook-darwin-arm64",
+    "darwin-x64": "actionbook-darwin-x64",
+    "linux-x64": "actionbook-linux-x64",
+    "linux-arm64": "actionbook-linux-arm64",
+    "win32-x64": "actionbook-win32-x64.exe",
+    "win32-arm64": "actionbook-win32-arm64.exe",
+  };
+  return map[platformKey] || null;
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const request = (url) => {
+      https
+        .get(url, (response) => {
+          if (response.statusCode === 301 || response.statusCode === 302) {
+            request(response.headers.location);
+            return;
+          }
+          if (response.statusCode !== 200) {
+            reject(new Error(`HTTP ${response.statusCode}`));
+            return;
+          }
+          const file = fs.createWriteStream(dest);
+          response.pipe(file);
+          file.on("finish", () => {
+            file.close();
+            resolve();
+          });
+          file.on("error", (err) => {
+            fs.unlinkSync(dest);
+            reject(err);
+          });
+        })
+        .on("error", reject);
+    };
+    request(url);
+  });
+}
+
+async function main() {
+  const binaryName = getBinaryName();
+
+  if (!binaryName) {
+    console.log(
+      `⚠ Unsupported platform: ${process.platform}-${process.arch}. ` +
+        "Install the Rust CLI directly: cargo install actionbook"
+    );
+    return;
+  }
+
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Binary already exists (shipped with npm package) — just fix permissions
+  if (fs.existsSync(binaryPath)) {
+    if (process.platform !== "win32") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+    return;
+  }
+
+  // Fallback: download from GitHub Releases
+  const packageJson = JSON.parse(
+    fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")
+  );
+  const version = packageJson.version;
+  const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/actionbook-cli-v${version}/${binaryName}`;
+
+  console.log(`Downloading actionbook binary for ${process.platform}-${process.arch}...`);
+
+  try {
+    if (!fs.existsSync(binDir)) {
+      fs.mkdirSync(binDir, { recursive: true });
+    }
+
+    await downloadFile(downloadUrl, binaryPath);
+
+    if (process.platform !== "win32") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`✓ Downloaded: ${binaryName}`);
+  } catch (err) {
+    console.log(`⚠ Could not download binary: ${err.message}`);
+    console.log("");
+    console.log("To install manually:");
+    console.log("  cargo install actionbook");
+    console.log("  # or set ACTIONBOOK_BINARY_PATH env var");
+  }
+}
+
+main().catch(console.error);