@aria-cli/tools 1.0.0

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

@@ -0,0 +1,118 @@
+"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.waitForDownload = waitForDownload;
+/**
+ * File upload and download handling.
+ * Ported from OpenClaw's pw-tools-core.downloads.ts.
+ *
+ * Note: Upload is handled in pw-interactions.ts via setInputFiles.
+ * This module provides download capture via page "download" event.
+ */
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const node_crypto_1 = require("node:crypto");
+const pw_shared_js_1 = require("./pw-shared.js");
+// ── Filename sanitization ─────────────────────────────────────────────
+function sanitizeDownloadFileName(fileName) {
+    const trimmed = String(fileName ?? "").trim();
+    if (!trimmed) {
+        return "download.bin";
+    }
+    // Force a basename so path separators/traversal can't escape the downloads dir.
+    let base = (0, node_path_1.basename)(trimmed);
+    let cleaned = "";
+    for (let i = 0; i < base.length; i++) {
+        const code = base.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f) {
+            continue;
+        }
+        cleaned += base[i];
+    }
+    base = cleaned.trim();
+    if (!base || base === "." || base === "..") {
+        return "download.bin";
+    }
+    if (base.length > 200) {
+        base = base.slice(0, 200);
+    }
+    return base;
+}
+function buildTempDownloadPath(fileName) {
+    const id = (0, node_crypto_1.randomUUID)();
+    const safeName = sanitizeDownloadFileName(fileName);
+    return (0, node_path_1.join)((0, node_os_1.tmpdir)(), "aria-downloads", `${id}-${safeName}`);
+}
+// ── Download waiter ───────────────────────────────────────────────────
+function createPageDownloadWaiter(page, timeoutMs) {
+    let done = false;
+    let timer;
+    let handler;
+    const cleanup = () => {
+        if (timer) {
+            clearTimeout(timer);
+        }
+        timer = undefined;
+        if (handler) {
+            page.off("download", handler);
+            handler = undefined;
+        }
+    };
+    const promise = new Promise((resolveP, reject) => {
+        handler = (download) => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+            resolveP(download);
+        };
+        page.on("download", handler);
+        timer = setTimeout(() => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+            reject(new Error("Timeout waiting for download"));
+        }, timeoutMs);
+    });
+    return {
+        promise,
+        cancel: () => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+        },
+    };
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Wait for the next download event on the page and save the file.
+ */
+async function waitForDownload(opts) {
+    const timeout = (0, pw_shared_js_1.normalizeTimeoutMs)(opts.timeoutMs, 120_000);
+    const waiter = createPageDownloadWaiter(opts.page, timeout);
+    try {
+        const download = (await waiter.promise);
+        const suggested = download.suggestedFilename?.() || "download.bin";
+        const outPath = opts.path?.trim() || buildTempDownloadPath(suggested);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(outPath), { recursive: true });
+        await download.saveAs?.(outPath);
+        return {
+            url: download.url?.() || "",
+            suggestedFilename: suggested,
+            path: (0, node_path_1.resolve)(outPath),
+        };
+    }
+    catch (err) {
+        waiter.cancel();
+        throw err;
+    }
+}
+//# sourceMappingURL=pw-downloads.js.map

package/dist-cjs/definitions/browser/pw-downloads.js.map

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

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,214 @@
+"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);
+    }
+}
+//# sourceMappingURL=pw-interactions.js.map

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

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

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,85 @@
+"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");
+}
+//# sourceMappingURL=pw-responses.js.map

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

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

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 {};