@aria-cli/tools 1.0.12 → 1.0.14

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

@@ -1,117 +0,0 @@
-"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;
-    }
-}

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

@@ -1,213 +0,0 @@
-"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.js

@@ -1,84 +0,0 @@
-"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");
-}