claw-browser-automation 0.2.0

package/dist/actions/wait.js

@@ -0,0 +1,69 @@
+import { resolveWithConfidence } from "../selectors/strategy.js";
+import { executeAction, resolveTimeout } from "./action.js";
+function buildSelectorRetryOptions(opts, selector) {
+    if (!Array.isArray(selector)) {
+        return { actionOpts: opts, selectorInput: selector };
+    }
+    const selectorStrategies = [...selector];
+    return {
+        actionOpts: {
+            ...opts,
+            _selectorStrategies: selectorStrategies,
+        },
+        selectorInput: selectorStrategies,
+    };
+}
+function recordSelectorMeta(ctx, resolution) {
+    if (!ctx._traceMeta) {
+        ctx._traceMeta = {};
+    }
+    ctx._traceMeta.selectorResolved = {
+        strategy: resolution.strategy.type,
+        strategyIndex: resolution.strategyIndex,
+        resolutionMs: resolution.resolutionMs,
+    };
+}
+function recordWait(ctx, waitType) {
+    if (!ctx._traceMeta) {
+        ctx._traceMeta = {};
+    }
+    if (!ctx._traceMeta.waitsPerformed) {
+        ctx._traceMeta.waitsPerformed = [];
+    }
+    ctx._traceMeta.waitsPerformed.push(waitType);
+}
+export async function waitForSelector(ctx, selector, opts = {}) {
+    const timeoutMs = resolveTimeout(opts.timeout);
+    const state = opts.state ?? "visible";
+    const { actionOpts, selectorInput } = buildSelectorRetryOptions(opts, selector);
+    return executeAction(ctx, "waitForSelector", actionOpts, async (_ctx) => {
+        recordWait(_ctx, `selector:${state}`);
+        const resolution = await resolveWithConfidence(_ctx.page, selectorInput, state, timeoutMs);
+        recordSelectorMeta(_ctx, resolution);
+        const locator = resolution.locator;
+        await locator.first().waitFor({ state, timeout: timeoutMs });
+    });
+}
+export async function waitForCondition(ctx, condition, opts = {}) {
+    const timeoutMs = resolveTimeout(opts.timeout);
+    return executeAction(ctx, "waitForCondition", opts, async (_ctx) => {
+        recordWait(_ctx, "condition");
+        await _ctx.page.waitForFunction(condition, { timeout: timeoutMs });
+    });
+}
+export async function waitForNetworkIdle(ctx, opts = {}) {
+    const timeoutMs = resolveTimeout(opts.timeout);
+    return executeAction(ctx, "waitForNetworkIdle", opts, async (_ctx) => {
+        recordWait(_ctx, "networkidle");
+        await _ctx.page.waitForLoadState("networkidle", { timeout: timeoutMs });
+    });
+}
+export async function waitForUrl(ctx, pattern, opts = {}) {
+    const timeoutMs = resolveTimeout(opts.timeout);
+    return executeAction(ctx, "waitForUrl", opts, async (_ctx) => {
+        recordWait(_ctx, "url");
+        await _ctx.page.waitForURL(pattern, { timeout: timeoutMs });
+        return _ctx.page.url();
+    });
+}
+//# sourceMappingURL=wait.js.map

package/dist/actions/wait.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Typed error hierarchy for browser automation.
+ *
+ * Every subclass carries a machine-readable `code` and an actionable
+ * `recoveryHint` so callers (and the agent) can decide how to retry.
+ */
+export declare class BrowserAutomationError extends Error {
+    readonly code: string;
+    readonly recoveryHint: string;
+    constructor(code: string, message: string, recoveryHint: string);
+}
+export declare class TargetNotFoundError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+export declare class StaleElementError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+export declare class AssertionFailedError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+export declare class NavigationInterruptedError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+export declare class TimeoutExceededError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+export declare class SessionUnhealthyError extends BrowserAutomationError {
+    constructor(message: string, recoveryHint?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAM/D;AAED,qBAAa,mBAAoB,SAAQ,sBAAsB;gBAClD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQlD;AAED,qBAAa,iBAAkB,SAAQ,sBAAsB;gBAChD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQlD;AAED,qBAAa,oBAAqB,SAAQ,sBAAsB;gBACnD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQlD;AAED,qBAAa,0BAA2B,SAAQ,sBAAsB;gBACzD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CASlD;AAED,qBAAa,oBAAqB,SAAQ,sBAAsB;gBACnD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQlD;AAED,qBAAa,qBAAsB,SAAQ,sBAAsB;gBACpD,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQlD"}

package/dist/errors.js

@@ -0,0 +1,54 @@
+/**
+ * Typed error hierarchy for browser automation.
+ *
+ * Every subclass carries a machine-readable `code` and an actionable
+ * `recoveryHint` so callers (and the agent) can decide how to retry.
+ */
+export class BrowserAutomationError extends Error {
+    code;
+    recoveryHint;
+    constructor(code, message, recoveryHint) {
+        super(message);
+        this.name = "BrowserAutomationError";
+        this.code = code;
+        this.recoveryHint = recoveryHint;
+    }
+}
+export class TargetNotFoundError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("TARGET_NOT_FOUND", message, recoveryHint ?? "Verify the selector is correct and the element exists on the page.");
+        this.name = "TargetNotFoundError";
+    }
+}
+export class StaleElementError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("STALE_ELEMENT", message, recoveryHint ?? "Re-resolve the element handle — the DOM has changed since it was captured.");
+        this.name = "StaleElementError";
+    }
+}
+export class AssertionFailedError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("ASSERTION_FAILED", message, recoveryHint ?? "Check the postcondition or verification logic for this action.");
+        this.name = "AssertionFailedError";
+    }
+}
+export class NavigationInterruptedError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("NAVIGATION_INTERRUPTED", message, recoveryHint ??
+            "The page navigated away during the action. Wait for navigation to settle before retrying.");
+        this.name = "NavigationInterruptedError";
+    }
+}
+export class TimeoutExceededError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("TIMEOUT_EXCEEDED", message, recoveryHint ?? "Increase the timeout or ensure the page has finished loading.");
+        this.name = "TimeoutExceededError";
+    }
+}
+export class SessionUnhealthyError extends BrowserAutomationError {
+    constructor(message, recoveryHint) {
+        super("SESSION_UNHEALTHY", message, recoveryHint ?? "The browser session is broken. Close it and create a new one.");
+        this.name = "SessionUnhealthyError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,IAAI,CAAS;IACb,YAAY,CAAS;IAE9B,YAAY,IAAY,EAAE,OAAe,EAAE,YAAoB;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,sBAAsB;IAC9D,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,kBAAkB,EAClB,OAAO,EACP,YAAY,IAAI,oEAAoE,CACpF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,sBAAsB;IAC5D,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,eAAe,EACf,OAAO,EACP,YAAY,IAAI,4EAA4E,CAC5F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAC/D,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,kBAAkB,EAClB,OAAO,EACP,YAAY,IAAI,gEAAgE,CAChF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AAED,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IACrE,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,wBAAwB,EACxB,OAAO,EACP,YAAY;YACX,2FAA2F,CAC5F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAC/D,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,kBAAkB,EAClB,OAAO,EACP,YAAY,IAAI,+DAA+D,CAC/E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,sBAAsB;IAChE,YAAY,OAAe,EAAE,YAAqB;QACjD,KAAK,CACJ,mBAAmB,EACnB,OAAO,EACP,YAAY,IAAI,+DAA+D,CAC/E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACrC,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import type { SkillContext } from "./tools/context.js";
+import type { ToolDefinition } from "./tools/session-tools.js";
+export declare const VERSION = "0.2.0";
+export interface SkillConfig {
+    maxContexts?: number;
+    headless?: boolean;
+    dbPath?: string;
+    artifactsDir?: string;
+    logLevel?: string;
+}
+export interface BrowserAutomationSkill {
+    tools: ToolDefinition[];
+    context: SkillContext;
+    shutdown: () => Promise<void>;
+}
+export declare function createSkill(config?: SkillConfig): Promise<BrowserAutomationSkill>;
+export type { ActionContext, ActionOptions, ActionResult, StructuredError, TraceMetadata, } from "./actions/action.js";
+export type { AssertionCheck } from "./actions/assertions.js";
+export { allOf, assertElementGone, assertElementText, assertElementVisible, assertUrlContains, } from "./actions/assertions.js";
+export type { ExtractionResult, ItemProvenance } from "./actions/extract-structured.js";
+export { extractStructured } from "./actions/extract-structured.js";
+export type { InputMode } from "./actions/interact.js";
+export type { ApplyFilterOptions, ApplyFilterResult, SetFieldOptions, SetFieldResult, SubmitFormOptions, SubmitFormResult, } from "./actions/semantic.js";
+export { applyFilter, setField, submitForm } from "./actions/semantic.js";
+export { AssertionFailedError, BrowserAutomationError, NavigationInterruptedError, SessionUnhealthyError, StaleElementError, TargetNotFoundError, TimeoutExceededError, } from "./errors.js";
+export type { SelectorResolutionTrace, TraceEntry, TraceStats } from "./observe/trace.js";
+export type { PoolStatus } from "./pool/browser-pool.js";
+export type { SelectorResolution, SelectorStrategy } from "./selectors/strategy.js";
+export type { ElementHandle, HandleResolution } from "./session/handle-registry.js";
+export { HandleRegistry } from "./session/handle-registry.js";
+export type { CookieData, SessionSnapshot } from "./session/snapshot.js";
+export type { SkillContext } from "./tools/context.js";
+export type { ToolDefinition, ToolResult } from "./tools/session-tools.js";
+//# 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":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAsB,WAAW,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4E3F;AAED,YAAY,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EACN,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,88 @@
+import { createLogger } from "./observe/logger.js";
+import { ActionTrace } from "./observe/trace.js";
+import { BrowserPool } from "./pool/browser-pool.js";
+import { ActionLog } from "./store/action-log.js";
+import { ArtifactManager } from "./store/artifacts.js";
+import { Store } from "./store/db.js";
+import { SessionStore } from "./store/sessions.js";
+import { createActionTools } from "./tools/action-tools.js";
+import { createApprovalTools } from "./tools/approval-tools.js";
+import { createHandleTools } from "./tools/handle-tools.js";
+import { createPageTools } from "./tools/page-tools.js";
+import { createSemanticTools } from "./tools/semantic-tools.js";
+import { createSessionTools } from "./tools/session-tools.js";
+export const VERSION = "0.2.0";
+export async function createSkill(config = {}) {
+    const logger = createLogger("browser-automation");
+    const pool = new BrowserPool({
+        maxContexts: config.maxContexts ?? 4,
+        launchOptions: { headless: config.headless ?? true },
+        logger,
+    });
+    const storeOpts = { logger };
+    if (config.dbPath) {
+        storeOpts.dbPath = config.dbPath;
+    }
+    const store = new Store(storeOpts);
+    const sessions = new SessionStore(store.db);
+    const actionLog = new ActionLog(store.db);
+    const artifactOpts = { logger };
+    if (config.artifactsDir) {
+        artifactOpts.baseDir = config.artifactsDir;
+    }
+    const artifacts = new ArtifactManager(artifactOpts);
+    const trace = new ActionTrace();
+    // Suspend any sessions that were active when the process last exited
+    const suspended = sessions.suspendAll();
+    if (suspended > 0) {
+        logger.info({ count: suspended }, "suspended leftover active sessions from previous run");
+    }
+    const ctx = {
+        pool,
+        store,
+        sessions,
+        actionLog,
+        artifacts,
+        trace,
+        logger,
+    };
+    const tools = [
+        ...createSessionTools(ctx),
+        ...createActionTools(ctx),
+        ...createPageTools(ctx),
+        ...createApprovalTools(ctx),
+        ...createHandleTools(ctx),
+        ...createSemanticTools(ctx),
+    ];
+    const shutdown = async () => {
+        logger.info("shutting down browser automation skill");
+        const activeSessions = pool.listSessions();
+        for (const session of activeSessions) {
+            try {
+                const snapshot = await session.snapshot();
+                if (!sessions.get(session.id)) {
+                    sessions.create(session.id, session.profile);
+                }
+                sessions.saveSnapshot(session.id, snapshot);
+                sessions.updateStatus(session.id, "suspended");
+            }
+            catch (err) {
+                logger.warn({ sessionId: session.id, err }, "failed to snapshot session during shutdown");
+            }
+        }
+        sessions.suspendAll();
+        await pool.shutdown();
+        store.close();
+        trace.reset();
+        logger.info("browser automation skill shut down");
+    };
+    logger.info({ toolCount: tools.length, version: VERSION }, "browser automation skill initialized");
+    return { tools, context: ctx, shutdown };
+}
+// biome-ignore lint/performance/noBarrelFile: index.ts is the package public API surface
+export { allOf, assertElementGone, assertElementText, assertElementVisible, assertUrlContains, } from "./actions/assertions.js";
+export { extractStructured } from "./actions/extract-structured.js";
+export { applyFilter, setField, submitForm } from "./actions/semantic.js";
+export { AssertionFailedError, BrowserAutomationError, NavigationInterruptedError, SessionUnhealthyError, StaleElementError, TargetNotFoundError, TimeoutExceededError, } from "./errors.js";
+export { HandleRegistry } from "./session/handle-registry.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":"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"}

package/dist/observe/logger.d.ts

@@ -0,0 +1,4 @@
+import pino from "pino";
+export declare function createLogger(name: string): pino.Logger<never, boolean>;
+export type Logger = pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/observe/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/observe/logger.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,MAAM,CAAC;AAkCxB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,+BAqBxC;AAED,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC"}

package/dist/observe/logger.js

@@ -0,0 +1,52 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import pino from "pino";
+function resolveWritableLogDir() {
+    const configured = process.env["BROWSER_LOG_DIR"];
+    const candidates = configured
+        ? [configured]
+        : [
+            path.join(os.homedir(), ".openclaw", "workspace", "browser-automation", "logs"),
+            path.join(process.cwd(), ".openclaw-logs"),
+            path.join(os.tmpdir(), "openclaw-logs"),
+        ];
+    for (const dir of candidates) {
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            const probeFile = path.join(dir, `.probe-${process.pid}.log`);
+            const fd = fs.openSync(probeFile, "a");
+            fs.closeSync(fd);
+            fs.rmSync(probeFile, { force: true });
+            return dir;
+        }
+        catch {
+            // Try next candidate if this location is not writable.
+        }
+    }
+    throw new Error("no writable log directory available");
+}
+function resolveLogFile(name) {
+    const logDir = resolveWritableLogDir();
+    const day = new Date().toISOString().slice(0, 10);
+    return path.join(logDir, `${name}-${day}.log`);
+}
+export function createLogger(name) {
+    const baseOptions = {
+        name,
+        level: process.env["LOG_LEVEL"] ?? "info",
+        timestamp: pino.stdTimeFunctions.isoTime,
+    };
+    try {
+        const fileStream = pino.destination({
+            dest: resolveLogFile(name),
+            sync: false,
+            append: true,
+        });
+        return pino(baseOptions, pino.multistream([{ stream: process.stdout }, { stream: fileStream }]));
+    }
+    catch {
+        return pino(baseOptions, process.stdout);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/observe/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observe/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,SAAS,qBAAqB;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,UAAU;QAC5B,CAAC,CAAC,CAAC,UAAU,CAAC;QACd,CAAC,CAAC;YACA,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC;YAC/E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC;SACvC,CAAC;IAEJ,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YAC9D,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACvC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACR,uDAAuD;QACxD,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IACnC,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,MAAM,WAAW,GAAG;QACnB,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM;QACzC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;KACxC,CAAC;IAEF,IAAI,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;YACnC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,OAAO,IAAI,CACV,WAAW,EACX,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CACtE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;AACF,CAAC"}

package/dist/observe/trace.d.ts

@@ -0,0 +1,46 @@
+export interface SelectorResolutionTrace {
+    strategy: string;
+    strategyIndex: number;
+    resolutionMs: number;
+}
+export interface TraceEntry {
+    action: string;
+    selector?: string;
+    timestamp: number;
+    durationMs: number;
+    ok: boolean;
+    error?: string;
+    retries: number;
+    selectorResolved?: SelectorResolutionTrace;
+    eventsDispatched?: string[];
+    waitsPerformed?: string[];
+    assertionsChecked?: string[];
+}
+export interface TraceStats {
+    actionsTotal: number;
+    actionsByType: Record<string, number>;
+    actionsByOutcome: {
+        ok: number;
+        failed: number;
+    };
+    retriesTotal: number;
+    sessionsTotal: number;
+    durationP50Ms: number;
+    durationP95Ms: number;
+}
+export declare class ActionTrace {
+    private _entries;
+    private _allDurations;
+    private _totalRetries;
+    private _outcomeOk;
+    private _outcomeFailed;
+    private _actionCounts;
+    record(sessionId: string, entry: TraceEntry): void;
+    getSessionTrace(sessionId: string): TraceEntry[];
+    getSessionSummary(sessionId: string): string;
+    clearSession(sessionId: string): void;
+    stats(): TraceStats;
+    reset(): void;
+    private _recomputeAggregates;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/observe/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/observe/trace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAkC;IAEvD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAqBlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAKhD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAgB5C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOrC,KAAK,IAAI,UAAU;IAkBnB,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,oBAAoB;CAqB5B"}

package/dist/observe/trace.js

@@ -0,0 +1,102 @@
+export class ActionTrace {
+    _entries = new Map();
+    _allDurations = [];
+    _totalRetries = 0;
+    _outcomeOk = 0;
+    _outcomeFailed = 0;
+    _actionCounts = new Map();
+    record(sessionId, entry) {
+        let entries = this._entries.get(sessionId);
+        if (!entries) {
+            entries = [];
+            this._entries.set(sessionId, entries);
+        }
+        entries.push(entry);
+        this._allDurations.push(entry.durationMs);
+        this._totalRetries += entry.retries;
+        if (entry.ok) {
+            this._outcomeOk++;
+        }
+        else {
+            this._outcomeFailed++;
+        }
+        const count = this._actionCounts.get(entry.action) ?? 0;
+        this._actionCounts.set(entry.action, count + 1);
+    }
+    getSessionTrace(sessionId) {
+        const entries = this._entries.get(sessionId) ?? [];
+        return [...entries];
+    }
+    getSessionSummary(sessionId) {
+        const entries = this.getSessionTrace(sessionId);
+        if (entries.length === 0) {
+            return "no actions recorded";
+        }
+        const lines = entries.map((e, i) => {
+            const status = e.ok ? "OK" : `FAIL: ${e.error ?? "unknown"}`;
+            const selector = e.selector ? ` (${e.selector})` : "";
+            const retries = e.retries > 0 ? ` [${e.retries} retries]` : "";
+            return `${i + 1}. ${e.action}${selector} → ${status} (${e.durationMs}ms)${retries}`;
+        });
+        return lines.join("\n");
+    }
+    clearSession(sessionId) {
+        if (!this._entries.delete(sessionId)) {
+            return;
+        }
+        this._recomputeAggregates();
+    }
+    stats() {
+        const sorted = [...this._allDurations].sort((a, b) => a - b);
+        const actionsByType = {};
+        for (const [action, count] of this._actionCounts) {
+            actionsByType[action] = count;
+        }
+        return {
+            actionsTotal: this._outcomeOk + this._outcomeFailed,
+            actionsByType,
+            actionsByOutcome: { ok: this._outcomeOk, failed: this._outcomeFailed },
+            retriesTotal: this._totalRetries,
+            sessionsTotal: this._entries.size,
+            durationP50Ms: percentile(sorted, 0.5),
+            durationP95Ms: percentile(sorted, 0.95),
+        };
+    }
+    reset() {
+        this._entries.clear();
+        this._allDurations = [];
+        this._totalRetries = 0;
+        this._outcomeOk = 0;
+        this._outcomeFailed = 0;
+        this._actionCounts.clear();
+    }
+    _recomputeAggregates() {
+        this._allDurations = [];
+        this._totalRetries = 0;
+        this._outcomeOk = 0;
+        this._outcomeFailed = 0;
+        this._actionCounts.clear();
+        for (const entries of this._entries.values()) {
+            for (const entry of entries) {
+                this._allDurations.push(entry.durationMs);
+                this._totalRetries += entry.retries;
+                if (entry.ok) {
+                    this._outcomeOk++;
+                }
+                else {
+                    this._outcomeFailed++;
+                }
+                const count = this._actionCounts.get(entry.action) ?? 0;
+                this._actionCounts.set(entry.action, count + 1);
+            }
+        }
+    }
+}
+function percentile(sorted, p) {
+    if (sorted.length === 0) {
+        return 0;
+    }
+    const idx = Math.ceil(sorted.length * p) - 1;
+    return sorted[Math.max(0, idx)] ?? 0;
+}
+//# sourceMappingURL=trace.js.map

package/dist/observe/trace.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi): Promise<void>;
+};
+export default plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AA+BlG,QAAA,MAAM,MAAM;;;;kBAKS,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BrD,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,58 @@
+import { createSkill } from "./index.js";
+/** Maps `api.pluginConfig` keys to our `SkillConfig`. */
+function resolveConfig(raw) {
+    if (!raw)
+        return {};
+    const cfg = {};
+    if (typeof raw["maxContexts"] === "number")
+        cfg.maxContexts = raw["maxContexts"];
+    if (typeof raw["headless"] === "boolean")
+        cfg.headless = raw["headless"];
+    if (typeof raw["dbPath"] === "string")
+        cfg.dbPath = raw["dbPath"];
+    if (typeof raw["artifactsDir"] === "string")
+        cfg.artifactsDir = raw["artifactsDir"];
+    return cfg;
+}
+/** Wraps our `ToolDefinition` into an OpenClaw `AgentTool`. */
+function adaptTool(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        label: tool.label,
+        parameters: tool.parameters,
+        execute: (_toolCallId, params, _signal, _onUpdate) => tool.execute(params),
+    };
+}
+const plugin = {
+    id: "browser-automation",
+    name: "Browser Automation",
+    description: "Reliable browser automation layer for OpenClaw using Playwright",
+    async register(api) {
+        const config = resolveConfig(api.pluginConfig);
+        let skill;
+        const service = {
+            id: "browser-automation",
+            async start() {
+                skill = await createSkill(config);
+                api.logger.info(`browser-automation started (${skill.tools.length} tools)`);
+            },
+            async stop() {
+                if (skill) {
+                    await skill.shutdown();
+                    skill = undefined;
+                    api.logger.info("browser-automation stopped");
+                }
+            },
+        };
+        api.registerService(service);
+        // Register tools as a factory — OpenClaw calls it when an agent session needs tools
+        api.registerTool(() => {
+            if (!skill)
+                return null;
+            return skill.tools.map(adaptTool);
+        });
+    },
+};
+export default plugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,WAAW,EAAoB,MAAM,YAAY,CAAC;AAGxF,yDAAyD;AACzD,SAAS,aAAa,CAAC,GAAwC;IAC9D,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACjF,IAAI,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;QAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ;QAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IACpF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,+DAA+D;AAC/D,SAAS,SAAS,CAAC,IAAoB;IACtC,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,CACR,WAAmB,EACnB,MAA+B,EAC/B,OAAqB,EACrB,SAAmB,EAClB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;KACT,CAAC;AACnB,CAAC;AAED,MAAM,MAAM,GAAG;IACd,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,iEAAiE;IAE9E,KAAK,CAAC,QAAQ,CAAC,GAAsB;QACpC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,KAAyC,CAAC;QAE9C,MAAM,OAAO,GAA0B;YACtC,EAAE,EAAE,oBAAoB;YACxB,KAAK,CAAC,KAAK;gBACV,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;YAC7E,CAAC;YACD,KAAK,CAAC,IAAI;gBACT,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACvB,KAAK,GAAG,SAAS,CAAC;oBAClB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;gBAC/C,CAAC;YACF,CAAC;SACD,CAAC;QACF,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAE7B,oFAAoF;QACpF,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE;YACrB,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC;AAEF,eAAe,MAAM,CAAC"}