@aria-cli/tools 1.0.9 → 1.0.11

package/src/definitions/browser/pw-interactions.ts

@@ -1,282 +0,0 @@
-// 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
-
-/**
- * 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";
-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: PwPage, ref: string, refs: RoleRefMap) {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  ref: string;
-  doubleClick?: boolean;
-  button?: "left" | "right" | "middle";
-  modifiers?: string[];
-  timeoutMs?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  ref: string;
-  timeoutMs?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  startRef: string;
-  endRef: string;
-  timeoutMs?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  ref: string;
-  text: string;
-  submit?: boolean;
-  slowly?: boolean;
-  timeoutMs?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  ref: string;
-  values: string[];
-  timeoutMs?: number;
-}): Promise<void> {
-  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: { page: PwPage; key: string }): Promise<void> {
-  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: {
-  page: PwPage;
-  script: string;
-  timeoutMs?: number;
-}): Promise<unknown> {
-  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: { page: PwPage; fullPage?: boolean }): Promise<Buffer> {
-  return opts.page.screenshot({
-    type: "png",
-    fullPage: Boolean(opts.fullPage),
-  });
-}
-
-// ── Scroll ────────────────────────────────────────────────────────────
-
-export async function scrollPage(opts: {
-  page: PwPage;
-  direction: "up" | "down";
-  amount?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  selector?: string;
-  text?: string;
-  timeout?: number;
-}): Promise<void> {
-  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: {
-  page: PwPage;
-  refs: RoleRefMap;
-  ref: string;
-  paths: string[];
-}): Promise<void> {
-  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);
-  }
-}

package/src/definitions/browser/pw-responses.ts

@@ -1,98 +0,0 @@
-// 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
-
-/**
- * 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";
-
-// ── 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: string): number {
-  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: BrowserConsoleMessage[],
-  level?: string,
-): BrowserConsoleMessage[] {
-  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: BrowserNetworkRequest[],
-  filter?: string,
-): BrowserNetworkRequest[] {
-  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: BrowserConsoleMessage[]): string {
-  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: BrowserNetworkRequest[]): string {
-  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: BrowserPageError[]): string {
-  if (!errors.length) {
-    return "No page errors captured.";
-  }
-  return errors.map((e) => `${e.name ?? "Error"}: ${e.message}`).join("\n");
-}