@actionbookdev/openclaw-plugin 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './plugin.js';
+export { default as actionbookPlugin } from './plugin.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default } from './plugin.js';
+export { default as actionbookPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,12 @@
+import { ApiClient as BaseApiClient } from '@actionbookdev/sdk';
+export interface ApiClientOptions {
+    apiKey?: string;
+    timeoutMs?: number;
+    retry?: {
+        maxRetries?: number;
+        retryDelay?: number;
+    };
+}
+export declare class ApiClient extends BaseApiClient {
+    constructor(baseUrl: string, options?: ApiClientOptions);
+}

package/dist/lib/api-client.js

@@ -0,0 +1,73 @@
+import { ProxyAgent, fetch as undiciFetch } from 'undici';
+import { ApiClient as BaseApiClient } from '@actionbookdev/sdk';
+function getProxyUrl() {
+    return (process.env.HTTPS_PROXY ||
+        process.env.HTTP_PROXY ||
+        process.env.https_proxy ||
+        process.env.http_proxy);
+}
+function shouldBypassProxy(url) {
+    const noProxy = process.env.NO_PROXY || process.env.no_proxy;
+    if (!noProxy)
+        return false;
+    if (noProxy === '*')
+        return true;
+    let urlHost;
+    let urlPort;
+    try {
+        const parsed = new URL(url);
+        urlHost = parsed.hostname.toLowerCase();
+        urlPort = parsed.port || (parsed.protocol === 'https:' ? '443' : '80');
+    }
+    catch {
+        return false;
+    }
+    const bypassList = noProxy.split(',').map((h) => h.trim().toLowerCase());
+    return bypassList.some((bypass) => {
+        if (!bypass)
+            return false;
+        // Handle port-specific entries (e.g. "example.com:8080")
+        const [bypassHost, bypassPort] = bypass.includes(':')
+            ? [bypass.split(':')[0], bypass.split(':')[1]]
+            : [bypass, undefined];
+        if (bypassPort && bypassPort !== urlPort)
+            return false;
+        if (bypassHost.startsWith('.')) {
+            return urlHost.endsWith(bypassHost) || urlHost === bypassHost.slice(1);
+        }
+        return urlHost === bypassHost || urlHost.endsWith('.' + bypassHost);
+    });
+}
+function createProxyFetch() {
+    const proxyUrl = getProxyUrl();
+    if (!proxyUrl) {
+        return globalThis.fetch;
+    }
+    const proxyAgent = new ProxyAgent(proxyUrl);
+    const customFetch = async (url, init) => {
+        const urlString = typeof url === 'string'
+            ? url
+            : url instanceof URL
+                ? url.toString()
+                : url.url;
+        const useProxy = proxyAgent && !shouldBypassProxy(urlString);
+        const response = await undiciFetch(url, {
+            ...init,
+            dispatcher: useProxy ? proxyAgent : undefined,
+        });
+        return response;
+    };
+    return customFetch;
+}
+export class ApiClient extends BaseApiClient {
+    constructor(baseUrl, options = {}) {
+        super({
+            apiKey: options.apiKey || '',
+            baseUrl,
+            timeoutMs: options.timeoutMs,
+            retry: options.retry,
+            fetch: createProxyFetch(),
+        });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Actionbook OpenClaw Plugin
+ *
+ * Registers search_actions and get_action_by_area_id as native OpenClaw agent tools.
+ * Provides pre-verified selectors for token-efficient browser automation.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+declare const actionbookPlugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi): void;
+};
+export default actionbookPlugin;

package/dist/plugin.js

@@ -0,0 +1,230 @@
+/**
+ * Actionbook OpenClaw Plugin
+ *
+ * Registers search_actions and get_action_by_area_id as native OpenClaw agent tools.
+ * Provides pre-verified selectors for token-efficient browser automation.
+ */
+import { Type } from "@sinclair/typebox";
+import { isActionbookError } from "@actionbookdev/sdk";
+import { ApiClient } from "./lib/api-client.js";
+const DEFAULT_API_URL = "https://api.actionbook.dev";
+const ACTIONBOOK_GUIDANCE = [
+    "## Actionbook Browser Automation",
+    "When the user needs to interact with any website, call `search_actions` BEFORE taking page snapshots. Use `get_action_by_area_id` to get pre-verified selectors from the results.",
+].join("\n");
+const SEARCH_ACTIONS_DESCRIPTION = `Search for website action manuals by keyword.
+
+Use this tool to find actions, page elements, and their selectors for browser automation.
+Returns area_id identifiers with descriptions and health scores.
+
+Example queries:
+- "airbnb search" → find Airbnb search-related actions
+- "google login" → find Google login actions
+
+Typical workflow:
+1. search_actions({ query: "airbnb search" })
+2. Get area_id from results (e.g., "airbnb.com:/:default")
+3. get_action_by_area_id({ area_id: "airbnb.com:/:default" })
+4. Use returned selectors with browser tools`;
+const GET_ACTION_BY_AREA_ID_DESCRIPTION = `Get complete action details by area_id, including DOM selectors.
+
+Area ID format: site:path:area (e.g., "airbnb.com:/:default")
+
+Returns:
+- Page description and functions
+- Interactive elements with selectors (CSS, XPath, data-testid, role, aria-label)
+- Element types and allowed methods (click, type, etc.)
+- Health score indicating selector reliability
+
+Use returned selectors with browser automation tools:
+- data-testid selectors (0.95 confidence) → use with browser eval
+- aria-label selectors (0.88 confidence) → use with browser eval
+- role selectors (0.9 confidence) → use with browser snapshot + click`;
+const PRIVATE_IP_RANGES = [
+    /^127\./,
+    /^10\./,
+    /^172\.(1[6-9]|2\d|3[01])\./,
+    /^192\.168\./,
+    /^169\.254\./,
+    /^0\./,
+    /^::1$/,
+    /^fe80:/i,
+    /^fc00:/i,
+    /^fd00:/i,
+];
+function isPrivateHost(hostname) {
+    if (hostname === "localhost" ||
+        hostname === "[::1]" ||
+        hostname.endsWith(".local")) {
+        return true;
+    }
+    // URL.hostname wraps IPv6 in brackets (e.g. "[fd00::1]") — strip them
+    const bare = hostname.startsWith("[") && hostname.endsWith("]")
+        ? hostname.slice(1, -1)
+        : hostname;
+    return PRIVATE_IP_RANGES.some((re) => re.test(bare));
+}
+function resolveApiUrl(value) {
+    if (value == null || value === "") {
+        return DEFAULT_API_URL;
+    }
+    if (typeof value !== "string") {
+        throw new Error("actionbook: apiUrl must be a string");
+    }
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error(`actionbook: invalid apiUrl "${value}"`);
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+        throw new Error(`actionbook: apiUrl must use http or https, got "${parsed.protocol}"`);
+    }
+    if (isPrivateHost(parsed.hostname)) {
+        throw new Error(`actionbook: apiUrl must not point to private/local addresses, got "${parsed.hostname}"`);
+    }
+    return parsed.toString().replace(/\/$/, "");
+}
+function formatToolError(action, error) {
+    if (isActionbookError(error)) {
+        // Upstream SDK errors already have structured info — pass through markdown
+        // errors and provide error code in details for agent observability
+        const text = error.message.startsWith("## ")
+            ? error.message
+            : `## Error\n\nFailed to ${action}: ${error.message}`;
+        return {
+            content: [{ type: "text", text }],
+            details: { error: error.message, code: error.code },
+        };
+    }
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return {
+        content: [
+            {
+                type: "text",
+                text: `## Error\n\nFailed to ${action}: ${message}`,
+            },
+        ],
+        details: { error: message },
+    };
+}
+const actionbookPlugin = {
+    id: "actionbook",
+    name: "Actionbook",
+    description: "Token-efficient browser automation with pre-verified selectors from Actionbook",
+    register(api) {
+        let pluginConfig;
+        try {
+            const raw = api.pluginConfig ?? {};
+            if (typeof raw !== "object" || raw === null) {
+                throw new Error("actionbook: pluginConfig must be an object");
+            }
+            pluginConfig = raw;
+        }
+        catch (err) {
+            api.logger.error(`Actionbook plugin config error: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        const apiKey = pluginConfig.apiKey ?? "";
+        let apiUrl;
+        try {
+            apiUrl = resolveApiUrl(pluginConfig.apiUrl);
+        }
+        catch (err) {
+            api.logger.error(`Actionbook plugin URL error: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        const client = new ApiClient(apiUrl, {
+            apiKey,
+            timeoutMs: 30000,
+            retry: { maxRetries: 3, retryDelay: 1000 },
+        });
+        // ========================================================================
+        // Lifecycle: inject Actionbook workflow guidance into agent context
+        // ========================================================================
+        api.on("before_prompt_build", async () => {
+            return {
+                prependSystemContext: ACTIONBOOK_GUIDANCE,
+            };
+        });
+        // ========================================================================
+        // Tool: search_actions
+        // ========================================================================
+        api.registerTool({
+            name: "search_actions",
+            label: "Actionbook Search",
+            description: SEARCH_ACTIONS_DESCRIPTION,
+            parameters: Type.Object({
+                query: Type.String({
+                    minLength: 1,
+                    maxLength: 200,
+                    description: "Search keyword (e.g., 'airbnb search', 'login button')",
+                }),
+                domain: Type.Optional(Type.String({
+                    description: "Filter by domain (e.g., 'airbnb.com')",
+                })),
+                background: Type.Optional(Type.String({
+                    description: "Context for search (improves relevance)",
+                })),
+                url: Type.Optional(Type.String({ description: "Filter by specific page URL" })),
+                page: Type.Optional(Type.Integer({
+                    minimum: 1,
+                    description: "Page number (default: 1)",
+                })),
+                page_size: Type.Optional(Type.Integer({
+                    minimum: 1,
+                    maximum: 100,
+                    description: "Results per page (1-100, default: 10)",
+                })),
+            }),
+            async execute(_toolCallId, params) {
+                try {
+                    const result = await client.searchActions({
+                        query: params.query,
+                        domain: params.domain,
+                        background: params.background,
+                        url: params.url,
+                        page: params.page,
+                        page_size: params.page_size,
+                    });
+                    return {
+                        content: [{ type: "text", text: result }],
+                        details: { query: params.query, domain: params.domain },
+                    };
+                }
+                catch (error) {
+                    return formatToolError("search actions", error);
+                }
+            },
+        });
+        // ========================================================================
+        // Tool: get_action_by_area_id
+        // ========================================================================
+        api.registerTool({
+            name: "get_action_by_area_id",
+            label: "Actionbook Get Action",
+            description: GET_ACTION_BY_AREA_ID_DESCRIPTION,
+            parameters: Type.Object({
+                area_id: Type.String({
+                    minLength: 1,
+                    description: "Area ID from search_actions (e.g., 'airbnb.com:/:default')",
+                }),
+            }),
+            async execute(_toolCallId, params) {
+                try {
+                    const result = await client.getActionByAreaId(params.area_id);
+                    return {
+                        content: [{ type: "text", text: result }],
+                        details: { area_id: params.area_id },
+                    };
+                }
+                catch (error) {
+                    return formatToolError("get action", error);
+                }
+            },
+        });
+    },
+};
+export default actionbookPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,31 @@
+{
+  "id": "actionbook",
+  "name": "Actionbook",
+  "description": "Token-efficient browser automation with pre-verified selectors from Actionbook",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Actionbook API key (optional, reduces rate limiting)"
+      },
+      "apiUrl": {
+        "type": "string",
+        "description": "Actionbook API base URL (must be a valid URL)"
+      }
+    },
+    "additionalProperties": false
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "help": "Optional. Get one at https://actionbook.dev"
+    },
+    "apiUrl": {
+      "label": "API URL",
+      "help": "Default: https://api.actionbook.dev"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@actionbookdev/openclaw-plugin",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Actionbook plugin for OpenClaw - token-efficient browser automation with pre-verified selectors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/actionbook/actionbook.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "pnpm --filter @actionbookdev/sdk build",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@actionbookdev/sdk": "workspace:*",
+    "@sinclair/typebox": "^0.34.48",
+    "undici": "^6.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "Apache-2.0"
+}

package/skills/actionbook/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: actionbook
+description: Activate when the user needs to interact with any website — browser automation, web scraping, screenshots, form filling, UI testing, monitoring, or building AI agents. Provides pre-verified page actions with step-by-step instructions and tested selectors.
+user-invocable: false
+---
+
+## When to Use
+
+Activate when the user:
+- Needs to do anything on a website ("Send a LinkedIn message", "Book an Airbnb", "Search Google for...")
+- Asks how to interact with a site ("How do I post a tweet?", "How to apply on LinkedIn?")
+- Wants to fill out forms, click buttons, navigate, search, filter, or browse on a specific site
+- Wants to take a screenshot of a web page or monitor changes
+- Builds browser-based AI agents, web scrapers, or E2E tests for external websites
+- Automates repetitive web tasks (data entry, form submission, content posting)
+
+When performing browser automation tasks, check Actionbook BEFORE taking page snapshots.
+
+## Workflow
+
+1. Before interacting with a website, call `search_actions` to check if Actionbook has pre-verified selectors
+2. Use `get_action_by_area_id` to get element selectors from the results
+3. Extract selectors from the returned Elements and use them by priority below
+4. If no results, skip to Fallback Strategy
+
+## Constructing an Effective Search Query
+
+The `query` parameter is the **primary signal** for finding the right action. Pack it with the user's full intent — not just a site name or a vague keyword.
+
+**Include in the query:**
+1. **Target site** — the website name or domain
+2. **Task verb** — what the user wants to do (search, book, post, filter, login, compose, etc.)
+3. **Object / context** — what they're acting on (listings, messages, flights, repositories, etc.)
+4. **Specific details** — any constraints, filters, or parameters the user mentioned
+
+**Rule of thumb:** Rewrite the user's request as a single descriptive sentence and use that as the query.
+
+| User says | Bad query | Good query |
+|-----------|-----------|------------|
+| "Book an Airbnb in Tokyo for next week" | `"airbnb"` | `"airbnb search listings Tokyo dates check-in check-out guests"` |
+| "Search arXiv for recent NLP papers" | `"arxiv search"` | `"arxiv advanced search papers NLP natural language processing recent"` |
+| "Send a LinkedIn connection request" | `"linkedin"` | `"linkedin send connection request invite someone"` |
+| "Post a tweet with an image" | `"twitter post"` | `"twitter compose new tweet post with image media attachment"` |
+| "Filter GitHub issues by label" | `"github issues"` | `"github repository issues filter by label search issues"` |
+
+When `domain` or `url` is known, always add them — they narrow results and improve precision.
+
+## Response Structure
+
+### search_actions response
+
+Returns a list of matching actions. Each result includes:
+
+- **ID** — unique identifier, use with `get_action_by_area_id` (e.g., `arxiv.org:/search/stat:default`)
+- **Type** — `page` (full page) or `area` (page section)
+- **Description** — page overview with URL, query parameters, and a brief summary
+- **URL** — page where this action applies
+- **Health Score** — selector reliability percentage (0–100%)
+- **Updated** — last verified date
+
+### get_action_by_area_id response
+
+Returns a structured document describing the page in detail:
+
+1. **Page URL** — exact URL with query/path parameter descriptions
+2. **Page Overview** — what the page does (definition of the page's purpose)
+3. **Page Function Summary** — interactive capabilities listed as bullet points (e.g., "Keyword Search", "Field Selection", "Abstract Toggle")
+4. **Page Structure Summary** — DOM hierarchy description with **CSS selectors inline** in the text
+
+Extract CSS selectors from the Page Structure Summary. Selectors appear embedded in the description, e.g.:
+```
+Search Form (form[method="GET"]): Large search input field with "All fields" dropdown selector and search button
+Header (<header>): Contains branding, logo, and a mini-search form with query input
+```
+
+## Selector Priority
+
+When Actionbook returns multiple selector types for an element, prefer them in this order:
+
+1. **data-testid** (confidence: 0.95) — e.g., `[data-testid="search-input"]`
+2. **aria-label** (confidence: 0.88) — e.g., `[aria-label="Notifications"]`
+3. **CSS selector** — e.g., `button.Search`, `input[type="text"]`
+4. **role selector** (confidence: 0.9) — e.g., `getByRole('link', { name: 'Notifications' })`
+
+Use the returned selectors with the agent's available browser tools (click, fill, evaluate, etc.).
+
+## Example
+
+User request: "Search arXiv for papers about Neural Networks, search in titles only"
+
+```
+1. search_actions({ query: "arxiv advanced search papers neural network title field", domain: "arxiv.org" })
+   → Returns area_id: "arxiv.org:/search/advanced:default"
+
+2. get_action_by_area_id({ area_id: "arxiv.org:/search/advanced:default" })
+   → Returns page structure with selectors: input[type="text"], select[name="searchtype"], button.Search
+
+3. Use browser tools with returned selectors:
+   - Navigate to https://arxiv.org/search/advanced
+   - Fill input[type="text"] with "Neural Network"
+   - Select select[name="searchtype"] → "title"
+   - Click button.Search
+   - Wait for navigation
+   - Read results
+```
+
+## Fallback Strategy
+
+Actionbook stores page data captured at indexing time. Websites evolve, so selectors may become outdated.
+
+- **No Actionbook results**: Use the agent's own browser tools to observe and interact with the page directly
+- **Selector execution fails at runtime**: Fall back to the agent's browser tools to re-observe the live page and retry with updated selectors
+
+Selectors should come from Actionbook or live page observation in the current session — not from prior knowledge or memory.
+
+
+## Important Notes
+
+- Do NOT modify selectors returned from Actionbook
+- Check `Allow Methods` field — it indicates supported operations (click/type/read) per element
+- `region_high_filter_page` entries indicate some elements lack unique selectors — use snapshot fallback for those