@aria-cli/tools 1.0.18 → 1.0.31

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

@@ -0,0 +1,115 @@
+// 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
+/**
+ * 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.
+ */
+import { tmpdir } from "node:os";
+import { join, dirname, resolve, basename } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { normalizeTimeoutMs } from "./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 = 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 = randomUUID();
+    const safeName = sanitizeDownloadFileName(fileName);
+    return join(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.
+ */
+export async function waitForDownload(opts) {
+    const timeout = 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 mkdir(dirname(outPath), { recursive: true });
+        await download.saveAs?.(outPath);
+        return {
+            url: download.url?.() || "",
+            suggestedFilename: suggested,
+            path: resolve(outPath),
+        };
+    }
+    catch (err) {
+        waiter.cancel();
+        throw err;
+    }
+}
+//# sourceMappingURL=pw-downloads.js.map

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

@@ -0,0 +1,200 @@
+// 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
+import { requireRef, toAIFriendlyError, normalizeTimeoutMs } from "./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.
+ */
+export 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 ─────────────────────────────────────────────────────────────
+export async function clickViaPlaywright(opts) {
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = 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 toAIFriendlyError(err, ref);
+    }
+}
+// ── Hover ─────────────────────────────────────────────────────────────
+export async function hoverViaPlaywright(opts) {
+    const ref = requireRef(opts.ref);
+    try {
+        await refLocator(opts.page, ref, opts.refs).hover({
+            timeout: normalizeTimeoutMs(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Drag ──────────────────────────────────────────────────────────────
+export async function dragViaPlaywright(opts) {
+    const startRef = requireRef(opts.startRef);
+    const endRef = requireRef(opts.endRef);
+    try {
+        await refLocator(opts.page, startRef, opts.refs).dragTo(refLocator(opts.page, endRef, opts.refs), { timeout: normalizeTimeoutMs(opts.timeoutMs, 8000) });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, `${startRef} -> ${endRef}`);
+    }
+}
+// ── Type ──────────────────────────────────────────────────────────────
+export async function typeViaPlaywright(opts) {
+    const text = String(opts.text ?? "");
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = 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 toAIFriendlyError(err, ref);
+    }
+}
+// ── Select option ─────────────────────────────────────────────────────
+export async function selectOptionViaPlaywright(opts) {
+    const ref = 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: normalizeTimeoutMs(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Key press ─────────────────────────────────────────────────────────
+export 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 ──────────────────────────────────────────────────────────
+export async function evaluateViaPlaywright(opts) {
+    const script = String(opts.script ?? "").trim();
+    if (!script) {
+        throw new Error("script is required");
+    }
+    const evaluateTimeout = 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 ────────────────────────────────────────────────────────
+export async function takeScreenshot(opts) {
+    return opts.page.screenshot({
+        type: "png",
+        fullPage: Boolean(opts.fullPage),
+    });
+}
+// ── Scroll ────────────────────────────────────────────────────────────
+export 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 ──────────────────────────────────────────────────────────────
+export async function waitForCondition(opts) {
+    const timeout = 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 ────────────────────────────────────────────────────────────
+export async function uploadFiles(opts) {
+    if (!opts.paths?.length) {
+        throw new Error("paths are required");
+    }
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    try {
+        await locator.setInputFiles(opts.paths);
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+//# sourceMappingURL=pw-interactions.js.map

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

@@ -0,0 +1,77 @@
+// 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
+// ── Circular buffer limits ────────────────────────────────────────────
+export const MAX_CONSOLE_MESSAGES = 500;
+export const MAX_NETWORK_REQUESTS = 500;
+export const 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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