@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/definitions/browser/pw-interactions.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Playwright interaction handlers: click, type, hover, drag, select, key press, evaluate.
+ * Ported from OpenClaw's pw-tools-core.interactions.ts.
+ */
+import type { PwPage, RoleRefMap } from "./types.js";
+/**
+ * Resolve a ref string (e.g. "e1") into a Playwright Locator using the
+ * role-ref map from the last snapshot.
+ */
+export declare function refLocator(page: PwPage, ref: string, refs: RoleRefMap): import("./types.js").PwLocator;
+export declare function clickViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    doubleClick?: boolean;
+    button?: "left" | "right" | "middle";
+    modifiers?: string[];
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function hoverViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function dragViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    startRef: string;
+    endRef: string;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function typeViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    text: string;
+    submit?: boolean;
+    slowly?: boolean;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function selectOptionViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    values: string[];
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function pressKeyViaPlaywright(opts: {
+    page: PwPage;
+    key: string;
+}): Promise<void>;
+export declare function evaluateViaPlaywright(opts: {
+    page: PwPage;
+    script: string;
+    timeoutMs?: number;
+}): Promise<unknown>;
+export declare function takeScreenshot(opts: {
+    page: PwPage;
+    fullPage?: boolean;
+}): Promise<Buffer>;
+export declare function scrollPage(opts: {
+    page: PwPage;
+    direction: "up" | "down";
+    amount?: number;
+}): Promise<void>;
+export declare function waitForCondition(opts: {
+    page: PwPage;
+    selector?: string;
+    text?: string;
+    timeout?: number;
+}): Promise<void>;
+export declare function uploadFiles(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    paths: string[];
+}): Promise<void>;

package/dist-cjs/definitions/browser/pw-interactions.js

@@ -0,0 +1,213 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refLocator = refLocator;
+exports.clickViaPlaywright = clickViaPlaywright;
+exports.hoverViaPlaywright = hoverViaPlaywright;
+exports.dragViaPlaywright = dragViaPlaywright;
+exports.typeViaPlaywright = typeViaPlaywright;
+exports.selectOptionViaPlaywright = selectOptionViaPlaywright;
+exports.pressKeyViaPlaywright = pressKeyViaPlaywright;
+exports.evaluateViaPlaywright = evaluateViaPlaywright;
+exports.takeScreenshot = takeScreenshot;
+exports.scrollPage = scrollPage;
+exports.waitForCondition = waitForCondition;
+exports.uploadFiles = uploadFiles;
+const pw_shared_js_1 = require("./pw-shared.js");
+// ── Ref locator ───────────────────────────────────────────────────────
+/**
+ * Resolve a ref string (e.g. "e1") into a Playwright Locator using the
+ * role-ref map from the last snapshot.
+ */
+function refLocator(page, ref, refs) {
+    const normalized = ref.startsWith("@")
+        ? ref.slice(1)
+        : ref.startsWith("ref=")
+            ? ref.slice(4)
+            : ref;
+    if (/^e\d+$/.test(normalized)) {
+        const info = refs[normalized];
+        if (!info) {
+            throw new Error(`Unknown ref "${normalized}". Run a new snapshot and use a ref from that snapshot.`);
+        }
+        const locator = info.name
+            ? page.getByRole(info.role, { name: info.name, exact: true })
+            : page.getByRole(info.role);
+        return info.nth !== undefined ? locator.nth(info.nth) : locator;
+    }
+    // Fallback: treat as CSS selector
+    return page.locator(normalized);
+}
+// ── Click ─────────────────────────────────────────────────────────────
+async function clickViaPlaywright(opts) {
+    const ref = (0, pw_shared_js_1.requireRef)(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 8000);
+    try {
+        if (opts.doubleClick) {
+            await locator.dblclick({
+                timeout,
+                button: opts.button,
+                modifiers: opts.modifiers,
+            });
+        }
+        else {
+            await locator.click({
+                timeout,
+                button: opts.button,
+                modifiers: opts.modifiers,
+            });
+        }
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, ref);
+    }
+}
+// ── Hover ─────────────────────────────────────────────────────────────
+async function hoverViaPlaywright(opts) {
+    const ref = (0, pw_shared_js_1.requireRef)(opts.ref);
+    try {
+        await refLocator(opts.page, ref, opts.refs).hover({
+            timeout: (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, ref);
+    }
+}
+// ── Drag ──────────────────────────────────────────────────────────────
+async function dragViaPlaywright(opts) {
+    const startRef = (0, pw_shared_js_1.requireRef)(opts.startRef);
+    const endRef = (0, pw_shared_js_1.requireRef)(opts.endRef);
+    try {
+        await refLocator(opts.page, startRef, opts.refs).dragTo(refLocator(opts.page, endRef, opts.refs), { timeout: (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 8000) });
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, `${startRef} -> ${endRef}`);
+    }
+}
+// ── Type ──────────────────────────────────────────────────────────────
+async function typeViaPlaywright(opts) {
+    const text = String(opts.text ?? "");
+    const ref = (0, pw_shared_js_1.requireRef)(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 8000);
+    try {
+        if (opts.slowly) {
+            await locator.click({ timeout });
+            await locator.type(text, { timeout, delay: 75 });
+        }
+        else {
+            await locator.fill(text, { timeout });
+        }
+        if (opts.submit) {
+            await locator.press("Enter", { timeout });
+        }
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, ref);
+    }
+}
+// ── Select option ─────────────────────────────────────────────────────
+async function selectOptionViaPlaywright(opts) {
+    const ref = (0, pw_shared_js_1.requireRef)(opts.ref);
+    if (!opts.values?.length) {
+        throw new Error("values are required");
+    }
+    try {
+        await refLocator(opts.page, ref, opts.refs).selectOption(opts.values, {
+            timeout: (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, ref);
+    }
+}
+// ── Key press ─────────────────────────────────────────────────────────
+async function pressKeyViaPlaywright(opts) {
+    const key = String(opts.key ?? "").trim();
+    if (!key) {
+        throw new Error("key is required");
+    }
+    await opts.page.keyboard.press(key);
+}
+// ── Evaluate ──────────────────────────────────────────────────────────
+async function evaluateViaPlaywright(opts) {
+    const script = String(opts.script ?? "").trim();
+    if (!script) {
+        throw new Error("script is required");
+    }
+    const evaluateTimeout = (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 20_000);
+    // Inject a timeout wrapper into the browser context so async scripts
+    // don't block the Playwright command queue indefinitely.
+    // We use a string-form evaluate to avoid TypeScript signature conflicts
+    // with our minimal PwPage interface.
+    const wrappedScript = `
+    (function() {
+      var fnBody = ${JSON.stringify(script)};
+      var timeoutMs = ${evaluateTimeout};
+      try {
+        var candidate = eval("(" + fnBody + ")");
+        var result = typeof candidate === "function" ? candidate() : candidate;
+        if (result && typeof result === "object" && typeof result.then === "function") {
+          return Promise.race([
+            result,
+            new Promise(function(_, reject) {
+              setTimeout(function() { reject(new Error("evaluate timed out after " + timeoutMs + "ms")); }, timeoutMs);
+            })
+          ]);
+        }
+        return result;
+      } catch (err) {
+        throw new Error("Invalid evaluate function: " + (err && err.message ? err.message : String(err)));
+      }
+    })()
+  `;
+    const result = await opts.page.evaluate(wrappedScript);
+    return result;
+}
+// ── Screenshot ────────────────────────────────────────────────────────
+async function takeScreenshot(opts) {
+    return opts.page.screenshot({
+        type: "png",
+        fullPage: Boolean(opts.fullPage),
+    });
+}
+// ── Scroll ────────────────────────────────────────────────────────────
+async function scrollPage(opts) {
+    const pixels = Math.max(100, Math.min(5000, opts.amount ?? 500));
+    const deltaY = opts.direction === "up" ? -pixels : pixels;
+    await opts.page.mouse.wheel(0, deltaY);
+    // Give the page a moment to process the scroll
+    await opts.page.waitForTimeout(300);
+}
+// ── Wait ──────────────────────────────────────────────────────────────
+async function waitForCondition(opts) {
+    const timeout = (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeout, 10_000);
+    if (opts.text) {
+        await opts.page.locator(`text=${opts.text}`).first().waitFor({ state: "visible", timeout });
+        return;
+    }
+    if (opts.selector) {
+        await opts.page.locator(opts.selector).first().waitFor({ state: "visible", timeout });
+        return;
+    }
+    // Default: wait for network idle
+    await opts.page.waitForLoadState("networkidle", { timeout });
+}
+// ── Upload ────────────────────────────────────────────────────────────
+async function uploadFiles(opts) {
+    if (!opts.paths?.length) {
+        throw new Error("paths are required");
+    }
+    const ref = (0, pw_shared_js_1.requireRef)(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    try {
+        await locator.setInputFiles(opts.paths);
+    }
+    catch (err) {
+        throw (0, pw_shared_js_1.toAIFriendlyError)(err, ref);
+    }
+}

package/dist-cjs/definitions/browser/pw-responses.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Console, network, and error monitoring.
+ * Ported from OpenClaw's pw-tools-core.activity.ts + pw-tools-core.responses.ts.
+ */
+import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError } from "./types.js";
+export declare const MAX_CONSOLE_MESSAGES = 500;
+export declare const MAX_NETWORK_REQUESTS = 500;
+export declare const MAX_PAGE_ERRORS = 200;
+/**
+ * Filter console messages by minimum severity level.
+ */
+export declare function filterConsoleMessages(messages: BrowserConsoleMessage[], level?: string): BrowserConsoleMessage[];
+/**
+ * Filter network requests by URL substring match.
+ */
+export declare function filterNetworkRequests(requests: BrowserNetworkRequest[], filter?: string): BrowserNetworkRequest[];
+/**
+ * Format console messages for tool output.
+ */
+export declare function formatConsoleMessages(messages: BrowserConsoleMessage[]): string;
+/**
+ * Format network requests for tool output.
+ */
+export declare function formatNetworkRequests(requests: BrowserNetworkRequest[]): string;
+/**
+ * Format page errors for tool output.
+ */
+export declare function formatPageErrors(errors: BrowserPageError[]): string;

package/dist-cjs/definitions/browser/pw-responses.js

@@ -0,0 +1,84 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PAGE_ERRORS = exports.MAX_NETWORK_REQUESTS = exports.MAX_CONSOLE_MESSAGES = void 0;
+exports.filterConsoleMessages = filterConsoleMessages;
+exports.filterNetworkRequests = filterNetworkRequests;
+exports.formatConsoleMessages = formatConsoleMessages;
+exports.formatNetworkRequests = formatNetworkRequests;
+exports.formatPageErrors = formatPageErrors;
+// ── Circular buffer limits ────────────────────────────────────────────
+exports.MAX_CONSOLE_MESSAGES = 500;
+exports.MAX_NETWORK_REQUESTS = 500;
+exports.MAX_PAGE_ERRORS = 200;
+// ── Console message filtering ─────────────────────────────────────────
+function consolePriority(level) {
+    switch (level) {
+        case "error":
+            return 3;
+        case "warning":
+            return 2;
+        case "info":
+        case "log":
+            return 1;
+        case "debug":
+            return 0;
+        default:
+            return 1;
+    }
+}
+/**
+ * Filter console messages by minimum severity level.
+ */
+function filterConsoleMessages(messages, level) {
+    if (!level) {
+        return [...messages];
+    }
+    const min = consolePriority(level);
+    return messages.filter((msg) => consolePriority(msg.type) >= min);
+}
+/**
+ * Filter network requests by URL substring match.
+ */
+function filterNetworkRequests(requests, filter) {
+    const pattern = typeof filter === "string" ? filter.trim() : "";
+    if (!pattern) {
+        return [...requests];
+    }
+    return requests.filter((r) => r.url.includes(pattern));
+}
+/**
+ * Format console messages for tool output.
+ */
+function formatConsoleMessages(messages) {
+    if (!messages.length) {
+        return "No console messages captured.";
+    }
+    return messages.map((m) => `[${m.type.toUpperCase()}] ${m.text}`).join("\n");
+}
+/**
+ * Format network requests for tool output.
+ */
+function formatNetworkRequests(requests) {
+    if (!requests.length) {
+        return "No network requests captured.";
+    }
+    return requests
+        .map((r) => {
+        const status = r.status !== undefined ? ` ${r.status}` : "";
+        const failure = r.failureText ? ` (FAILED: ${r.failureText})` : "";
+        return `${r.method}${status} ${r.url}${failure}`;
+    })
+        .join("\n");
+}
+/**
+ * Format page errors for tool output.
+ */
+function formatPageErrors(errors) {
+    if (!errors.length) {
+        return "No page errors captured.";
+    }
+    return errors.map((e) => `${e.name ?? "Error"}: ${e.message}`).join("\n");
+}

package/dist-cjs/definitions/browser/pw-session.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Browser session lifecycle management.
+ * Unlike OpenClaw (which connects to an external Chrome via CDP), ARIA
+ * launches its own Playwright browser instance directly.
+ */
+import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError, BrowserSession, PwBrowser, RoleRefMap } from "./types.js";
+export declare function getSession(): BrowserSession | null;
+export declare function getRefs(): RoleRefMap;
+export declare function setRefs(refs: RoleRefMap): void;
+export declare function getConsoleMessages(): BrowserConsoleMessage[];
+export declare function getNetworkRequests(): BrowserNetworkRequest[];
+export declare function getPageErrors(): BrowserPageError[];
+/**
+ * Test seam for injecting a mocked playwright loader.
+ * Passing null restores the production loader.
+ */
+export declare function setPlaywrightLoaderForTest(loader: (() => Promise<unknown>) | null): void;
+type ChromiumLike = {
+    launch: (options?: {
+        headless?: boolean;
+    }) => Promise<PwBrowser>;
+};
+/**
+ * Resolve Playwright's chromium launcher across module interop shapes.
+ * Some runtimes expose `{ chromium }`, others only `{ default: { chromium } }`.
+ */
+export declare function resolveChromiumLauncher(moduleValue: unknown): ChromiumLike;
+/**
+ * Launch a new Playwright browser session.
+ * Uses dynamic import so the tool module loads even without playwright installed.
+ */
+export declare function launchBrowser(options?: {
+    headless?: boolean;
+    url?: string;
+}): Promise<BrowserSession>;
+/**
+ * Close the current browser session and clean up all state.
+ */
+export declare function closeBrowser(): Promise<void>;
+/**
+ * List all open tabs (pages) in the current context.
+ */
+export declare function listTabs(): Array<{
+    index: number;
+    url: string;
+    active: boolean;
+}>;
+/**
+ * Open a new tab, optionally navigating to a URL.
+ */
+export declare function newTab(url?: string): Promise<{
+    index: number;
+    url: string;
+}>;
+/**
+ * Switch to a tab by index.
+ */
+export declare function selectTab(index: number): Promise<{
+    url: string;
+}>;
+/**
+ * Close a tab by index (defaults to current tab).
+ */
+export declare function closeTab(index?: number): Promise<void>;
+export {};