@actionbookdev/cli 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# actionbook
+
+CLI for Actionbook - Get website action manuals for AI agents.
+
+## Installation
+
+```bash
+npm install -g actionbook
+# or
+npx actionbook <command>
+```
+
+## Quick Start
+
+```bash
+# Search for actions
+actionbook search "airbnb search"
+
+# Get action details
+actionbook get "https://www.airbnb.com/search"
+
+# List available sources
+actionbook sources
+
+# Search sources
+actionbook sources search "linkedin"
+```
+
+## Commands
+
+### `actionbook search <query>`
+
+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
+```
+
+**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`
+
+### `actionbook get <id>`
+
+Get complete action details by action ID.
+
+```bash
+actionbook get "https://www.airbnb.com/search"
+actionbook get "airbnb.com/search"  # fuzzy matching supported
+actionbook get "releases.rs"        # domain only
+```
+
+**Options:**
+- `-j, --json` - Output raw JSON
+
+**Alias:** `actionbook g`
+
+### `actionbook sources`
+
+List all available sources (websites).
+
+```bash
+actionbook sources
+actionbook sources --limit 100
+actionbook sources --json
+```
+
+**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`
+
+## Authentication
+
+Set your API key via environment variable:
+
+```bash
+export ACTIONBOOK_API_KEY=your_api_key
+```
+
+Or pass it as an option:
+
+```bash
+actionbook --api-key your_api_key search "query"
+```
+
+## 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:
+
+```bash
+actionbook search "login" --json | jq '.results[0].action_id'
+```
+
+## Examples
+
+### Typical Workflow
+
+```bash
+# 1. Search for actions
+actionbook search "airbnb search"
+
+# 2. Get details for a specific action
+actionbook get "https://www.airbnb.com/search"
+
+# 3. Use the selectors in your automation script
+```
+
+### Filter by Source
+
+```bash
+# List sources to find IDs
+actionbook sources
+
+# Search within specific sources
+actionbook search "login" --source-ids 1,2
+```
+
+### JSON Output for Scripts
+
+```bash
+# Get action and extract selectors
+actionbook get "booking.com" --json | jq '.elements'
+```
+
+## 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
+
+## License
+
+MIT

package/dist/commands/get.d.ts

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

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

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

package/dist/commands/get.js

@@ -0,0 +1,68 @@
+import { Command } from 'commander';
+import { Actionbook } from '@actionbookdev/sdk';
+import chalk from 'chalk';
+import { getApiKey, handleError, outputResult } from '../output.js';
+export const getCommand = new Command('get')
+    .alias('g')
+    .description('Get complete action details by action ID')
+    .argument('<id>', 'Action ID (URL or domain, e.g., "https://example.com/page" or "example.com/page")')
+    .option('-j, --json', 'Output raw JSON')
+    .action(async (id, options) => {
+    try {
+        const apiKey = getApiKey(options);
+        const client = new Actionbook({ apiKey });
+        const result = await client.getActionById(id);
+        if (options.json) {
+            outputResult(result);
+        }
+        else {
+            // Formatted output
+            console.log(chalk.bold.cyan(`\n${result.heading || result.documentTitle}\n`));
+            console.log(chalk.bold('Metadata'));
+            console.log(chalk.dim('─'.repeat(50)));
+            console.log(`${chalk.gray('Action ID:')}    ${result.action_id}`);
+            console.log(`${chalk.gray('Document:')}     ${result.documentTitle}`);
+            console.log(`${chalk.gray('URL:')}          ${result.documentUrl}`);
+            console.log(`${chalk.gray('Chunk Index:')}  ${result.chunkIndex}`);
+            console.log(`${chalk.gray('Token Count:')}  ${result.tokenCount}`);
+            console.log();
+            console.log(chalk.bold('Content'));
+            console.log(chalk.dim('─'.repeat(50)));
+            console.log(result.content);
+            console.log();
+            if (result.elements) {
+                try {
+                    const elements = JSON.parse(result.elements);
+                    console.log(chalk.bold('UI Elements'));
+                    console.log(chalk.dim('─'.repeat(50)));
+                    for (const [name, el] of Object.entries(elements)) {
+                        console.log(chalk.yellow(`  ${name}:`));
+                        if (el.css_selector) {
+                            console.log(`    ${chalk.gray('CSS:')} ${el.css_selector}`);
+                        }
+                        if (el.xpath_selector) {
+                            console.log(`    ${chalk.gray('XPath:')} ${el.xpath_selector}`);
+                        }
+                        if (el.description) {
+                            console.log(`    ${chalk.gray('Description:')} ${el.description}`);
+                        }
+                        if (el.element_type) {
+                            console.log(`    ${chalk.gray('Type:')} ${el.element_type}`);
+                        }
+                        if (el.allow_methods?.length) {
+                            console.log(`    ${chalk.gray('Methods:')} ${el.allow_methods.join(', ')}`);
+                        }
+                    }
+                    console.log();
+                }
+                catch {
+                    console.log(chalk.dim('(Failed to parse elements data)'));
+                }
+            }
+        }
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+//# sourceMappingURL=get.js.map

package/dist/commands/get.js.map

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

package/dist/commands/search.d.ts

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

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

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

package/dist/commands/search.js

@@ -0,0 +1,61 @@
+import { Command } from 'commander';
+import { Actionbook } from '@actionbookdev/sdk';
+import chalk from 'chalk';
+import { getApiKey, handleError, outputResult } from '../output.js';
+export const searchCommand = new Command('search')
+    .alias('s')
+    .description('Search for action manuals by keyword')
+    .argument('<query>', 'Search keyword (e.g., "airbnb search", "google login")')
+    .option('-t, --type <type>', 'Search type: vector, fulltext, or hybrid', 'hybrid')
+    .option('-l, --limit <number>', 'Maximum results (1-100)', '5')
+    .option('-s, --source-ids <ids>', 'Filter by source IDs (comma-separated)')
+    .option('--min-score <score>', 'Minimum similarity score (0-1)')
+    .option('-j, --json', 'Output raw JSON')
+    .action(async (query, options) => {
+    try {
+        const apiKey = getApiKey(options);
+        const client = new Actionbook({ apiKey });
+        const result = await client.searchActions({
+            query,
+            type: options.type,
+            limit: parseInt(options.limit, 10),
+            sourceIds: options.sourceIds,
+            minScore: options.minScore ? parseFloat(options.minScore) : undefined,
+        });
+        if (options.json) {
+            outputResult(result);
+        }
+        else {
+            // Formatted output
+            if (result.results.length === 0) {
+                console.log(chalk.yellow(`No actions found for "${query}"`));
+                console.log(chalk.dim('Try broader search terms or different search type'));
+            }
+            else {
+                console.log(chalk.bold.cyan(`\nSearch Results for "${query}"\n`));
+                console.log(chalk.dim(`Found ${result.count} result(s)\n`));
+                result.results.forEach((action, index) => {
+                    const num = index + 1;
+                    console.log(chalk.bold.white(`${num}. ${action.action_id}`));
+                    console.log(chalk.dim(`   Score: ${(action.score ?? 0).toFixed(3)}`));
+                    console.log(chalk.gray(`   ${truncate(action.content, 120)}`));
+                    console.log();
+                });
+                if (result.hasMore) {
+                    console.log(chalk.dim('More results available. Increase --limit to see more.\n'));
+                }
+                console.log(chalk.cyan('Next step: ') + chalk.white(`actionbook get "<action_id>"`));
+            }
+        }
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+function truncate(str, maxLen) {
+    const cleaned = str.replace(/\n/g, ' ').trim();
+    if (cleaned.length <= maxLen)
+        return cleaned;
+    return cleaned.substring(0, maxLen) + '...';
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/sources.d.ts

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

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

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

package/dist/commands/sources.js

@@ -0,0 +1,97 @@
+import { Command } from 'commander';
+import { Actionbook } from '@actionbookdev/sdk';
+import chalk from 'chalk';
+import { getApiKey, handleError, outputResult } from '../output.js';
+export const sourcesCommand = new Command('sources')
+    .description('List or search available sources (websites)')
+    .option('-l, --limit <number>', 'Maximum results', '50')
+    .option('-j, --json', 'Output raw JSON')
+    .action(async (options) => {
+    try {
+        const apiKey = getApiKey(options);
+        const client = new Actionbook({ apiKey });
+        const result = await client.listSources({
+            limit: parseInt(options.limit, 10),
+        });
+        if (options.json) {
+            outputResult(result);
+        }
+        else {
+            formatSourceList(result.results, result.count);
+        }
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+// Add search subcommand
+sourcesCommand
+    .command('search <query>')
+    .alias('s')
+    .description('Search for sources by keyword')
+    .option('-l, --limit <number>', 'Maximum results', '10')
+    .option('-j, --json', 'Output raw JSON')
+    .action(async (query, options) => {
+    try {
+        // Get parent command options
+        const parentOpts = sourcesCommand.opts();
+        const apiKey = getApiKey({ ...parentOpts, ...options });
+        const client = new Actionbook({ apiKey });
+        const result = await client.searchSources({
+            query,
+            limit: parseInt(options.limit, 10),
+        });
+        if (options.json) {
+            outputResult(result);
+        }
+        else {
+            if (result.results.length === 0) {
+                console.log(chalk.yellow(`\nNo sources found for "${query}"`));
+            }
+            else {
+                console.log(chalk.bold.cyan(`\nSources matching "${query}"\n`));
+                formatSourceList(result.results, result.count);
+            }
+        }
+    }
+    catch (error) {
+        handleError(error);
+    }
+});
+function formatSourceList(sources, count) {
+    if (sources.length === 0) {
+        console.log(chalk.yellow('No sources found'));
+        return;
+    }
+    console.log(chalk.dim(`${count} source(s)\n`));
+    // Calculate column widths
+    const maxIdLen = Math.max(...sources.map((s) => String(s.id).length), 2);
+    const maxNameLen = Math.min(Math.max(...sources.map((s) => s.name.length), 4), 30);
+    // Header
+    console.log(chalk.bold(`${'ID'.padEnd(maxIdLen)}  ${'Name'.padEnd(maxNameLen)}  ${'URL'}`));
+    console.log(chalk.dim('─'.repeat(80)));
+    // Rows
+    for (const source of sources) {
+        const id = String(source.id).padEnd(maxIdLen);
+        const name = truncate(source.name, maxNameLen).padEnd(maxNameLen);
+        const url = source.baseUrl;
+        console.log(`${chalk.yellow(id)}  ${chalk.white(name)}  ${chalk.cyan(url)}`);
+        if (source.description) {
+            console.log(chalk.dim(`${''.padEnd(maxIdLen)}  ${truncate(source.description, 70)}`));
+        }
+        if (source.tags?.length) {
+            console.log(chalk.dim(`${''.padEnd(maxIdLen)}  Tags: `) +
+                source.tags.map((t) => chalk.magenta(t)).join(', '));
+        }
+    }
+    console.log();
+    console.log(chalk.cyan('Tip: ') +
+        chalk.white('Use --source-ids with search to filter by source'));
+    console.log(chalk.dim('Example: actionbook search "login" --source-ids 1,2'));
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.substring(0, maxLen - 1) + '…';
+}
+//# sourceMappingURL=sources.js.map

package/dist/commands/sources.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { searchCommand } from './commands/search.js';
+import { getCommand } from './commands/get.js';
+import { sourcesCommand } from './commands/sources.js';
+const program = new Command();
+program
+    .name('actionbook')
+    .description('CLI for Actionbook - Get website action manuals for AI agents')
+    .version('0.1.0')
+    .option('--api-key <key>', 'API key (or set ACTIONBOOK_API_KEY env var)');
+program.addCommand(searchCommand);
+program.addCommand(getCommand);
+program.addCommand(sourcesCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/output.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get API key from options or environment
+ */
+export declare function getApiKey(options: {
+    apiKey?: string;
+}): string | undefined;
+/**
+ * Output result as JSON
+ */
+export declare function outputResult(data: unknown): void;
+/**
+ * Handle and display errors
+ */
+export declare function handleError(error: unknown): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAahD"}

package/dist/output.js

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { isActionbookError } from '@actionbookdev/sdk';
+/**
+ * Get API key from options or environment
+ */
+export function getApiKey(options) {
+    return options.apiKey ?? process.env.ACTIONBOOK_API_KEY;
+}
+/**
+ * Output result as JSON
+ */
+export function outputResult(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+/**
+ * Handle and display errors
+ */
+export function handleError(error) {
+    if (isActionbookError(error)) {
+        console.error(chalk.red(`\nError: ${error.code}`));
+        console.error(chalk.white(error.message));
+        if (error.suggestion) {
+            console.error(chalk.yellow(`\nSuggestion: ${error.suggestion}`));
+        }
+    }
+    else if (error instanceof Error) {
+        console.error(chalk.red(`\nError: ${error.message}`));
+    }
+    else {
+        console.error(chalk.red('\nUnknown error occurred'));
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAA4B;IACpD,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QACzC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@actionbookdev/cli",
+  "version": "0.1.0",
+  "description": "CLI for Actionbook - Get website action manuals for AI agents",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "actionbook": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "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": {
+    "@actionbookdev/sdk": "workspace:*",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0",
+    "rimraf": "^5.0.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "actionbook",
+    "cli",
+    "ai-agent",
+    "browser-automation",
+    "web-scraping",
+    "selectors"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/actionbook/actionbook.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://actionbook.dev",
+  "author": "Actionbook Team",
+  "license": "MIT"
+}