@aria-cli/tools 1.0.0

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

@@ -0,0 +1,327 @@
+"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.getSession = getSession;
+exports.getRefs = getRefs;
+exports.setRefs = setRefs;
+exports.getConsoleMessages = getConsoleMessages;
+exports.getNetworkRequests = getNetworkRequests;
+exports.getPageErrors = getPageErrors;
+exports.setPlaywrightLoaderForTest = setPlaywrightLoaderForTest;
+exports.resolveChromiumLauncher = resolveChromiumLauncher;
+exports.launchBrowser = launchBrowser;
+exports.closeBrowser = closeBrowser;
+exports.listTabs = listTabs;
+exports.newTab = newTab;
+exports.selectTab = selectTab;
+exports.closeTab = closeTab;
+const pw_responses_js_1 = require("./pw-responses.js");
+// ── Module-level state (singleton per Node process) ───────────────────
+let currentSession = null;
+let currentRefs = {};
+const consoleMessages = [];
+const networkRequests = [];
+const pageErrors = [];
+let nextRequestId = 0;
+const DEFAULT_NAVIGATION_OPTIONS = {
+    timeout: 20_000,
+    waitUntil: "domcontentloaded",
+};
+// ── Accessors ─────────────────────────────────────────────────────────
+function getSession() {
+    return currentSession;
+}
+function getRefs() {
+    return currentRefs;
+}
+function setRefs(refs) {
+    currentRefs = refs;
+}
+function getConsoleMessages() {
+    return consoleMessages;
+}
+function getNetworkRequests() {
+    return networkRequests;
+}
+function getPageErrors() {
+    return pageErrors;
+}
+const defaultPlaywrightLoader = () => Function('return import("playwright")')();
+let playwrightLoader = defaultPlaywrightLoader;
+/**
+ * Test seam for injecting a mocked playwright loader.
+ * Passing null restores the production loader.
+ */
+function setPlaywrightLoaderForTest(loader) {
+    playwrightLoader = loader ?? defaultPlaywrightLoader;
+}
+// ── Page listener wiring ──────────────────────────────────────────────
+const observedPages = new WeakSet();
+function wirePageListeners(page) {
+    if (observedPages.has(page)) {
+        return;
+    }
+    observedPages.add(page);
+    page.on("console", (...args) => {
+        const msg = args[0];
+        if (!msg)
+            return;
+        const entry = {
+            type: typeof msg.type === "function" ? msg.type() : "log",
+            text: typeof msg.text === "function" ? msg.text() : String(msg),
+            timestamp: new Date().toISOString(),
+        };
+        consoleMessages.push(entry);
+        if (consoleMessages.length > pw_responses_js_1.MAX_CONSOLE_MESSAGES) {
+            consoleMessages.shift();
+        }
+    });
+    page.on("pageerror", (...args) => {
+        const err = args[0];
+        pageErrors.push({
+            message: err?.message ? String(err.message) : String(err),
+            name: err?.name ? String(err.name) : undefined,
+            timestamp: new Date().toISOString(),
+        });
+        if (pageErrors.length > pw_responses_js_1.MAX_PAGE_ERRORS) {
+            pageErrors.shift();
+        }
+    });
+    page.on("request", (...args) => {
+        const req = args[0];
+        if (!req)
+            return;
+        nextRequestId += 1;
+        const entry = {
+            id: `r${nextRequestId}`,
+            timestamp: new Date().toISOString(),
+            method: typeof req.method === "function" ? req.method() : "GET",
+            url: typeof req.url === "function" ? req.url() : "",
+            resourceType: typeof req.resourceType === "function" ? req.resourceType() : undefined,
+        };
+        networkRequests.push(entry);
+        if (networkRequests.length > pw_responses_js_1.MAX_NETWORK_REQUESTS) {
+            networkRequests.shift();
+        }
+    });
+    page.on("response", (...args) => {
+        const resp = args[0];
+        if (!resp)
+            return;
+        const respUrl = typeof resp.url === "function" ? resp.url() : "";
+        // Match by URL (find most recent matching request)
+        for (let i = networkRequests.length - 1; i >= 0; i -= 1) {
+            const rec = networkRequests[i];
+            if (rec && rec.url === respUrl && rec.status === undefined) {
+                rec.status = typeof resp.status === "function" ? resp.status() : undefined;
+                rec.ok = typeof resp.ok === "function" ? resp.ok() : undefined;
+                break;
+            }
+        }
+    });
+    page.on("requestfailed", (...args) => {
+        const req = args[0];
+        if (!req)
+            return;
+        const failUrl = typeof req.url === "function" ? req.url() : "";
+        for (let i = networkRequests.length - 1; i >= 0; i -= 1) {
+            const rec = networkRequests[i];
+            if (rec && rec.url === failUrl && rec.ok === undefined) {
+                rec.ok = false;
+                rec.failureText = typeof req.failure === "function" ? req.failure()?.errorText : undefined;
+                break;
+            }
+        }
+    });
+}
+function isChromiumLike(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.launch === "function");
+}
+/**
+ * Resolve Playwright's chromium launcher across module interop shapes.
+ * Some runtimes expose `{ chromium }`, others only `{ default: { chromium } }`.
+ */
+function resolveChromiumLauncher(moduleValue) {
+    const pw = moduleValue;
+    const chromium = pw?.chromium ?? pw?.default?.chromium;
+    if (isChromiumLike(chromium)) {
+        return chromium;
+    }
+    const keys = pw && typeof pw === "object"
+        ? Object.keys(pw)
+            .sort()
+            .join(", ")
+        : String(pw);
+    throw new Error(`Invalid playwright module shape: missing chromium.launch (module keys: ${keys || "(none)"}).`);
+}
+/**
+ * Launch a new Playwright browser session.
+ * Uses dynamic import so the tool module loads even without playwright installed.
+ */
+async function launchBrowser(options) {
+    if (currentSession) {
+        // Already have a session — navigate if URL given, otherwise return existing
+        if (options?.url) {
+            try {
+                await currentSession.page.goto(options.url, DEFAULT_NAVIGATION_OPTIONS);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Navigation to ${options.url} failed: ${message}. Session remains active; use 'snapshot' or retry 'navigate'.`);
+            }
+        }
+        return currentSession;
+    }
+    // Dynamic import: playwright is an optional peer dependency.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let pw;
+    try {
+        pw = await playwrightLoader();
+    }
+    catch {
+        throw new Error("playwright is not installed. Run: npx playwright install chromium\n" +
+            "Or: npm install playwright && npx playwright install chromium");
+    }
+    const chromium = resolveChromiumLauncher(pw);
+    const browser = await chromium.launch({
+        headless: options?.headless !== false, // default headless
+    });
+    const context = browser.newContext
+        ? await browser.newContext({
+            viewport: { width: 1280, height: 720 },
+            userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        })
+        : (browser.contexts()[0] ??
+            (() => {
+                throw new Error("No browser context available");
+            })());
+    const page = context.pages?.().length
+        ? context.pages()[0]
+        : await context.newPage();
+    wirePageListeners(page);
+    // Persist session state before first navigation so launch+goto timeout
+    // cannot leave the tool in a "no session" state.
+    currentSession = { browser, context, page };
+    currentRefs = {};
+    consoleMessages.length = 0;
+    networkRequests.length = 0;
+    pageErrors.length = 0;
+    nextRequestId = 0;
+    if (options?.url) {
+        try {
+            await page.goto(options.url, DEFAULT_NAVIGATION_OPTIONS);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Browser launched, but initial navigation to ${options.url} failed: ${message}. Session remains active; use 'snapshot' or retry 'navigate'.`);
+        }
+    }
+    return currentSession;
+}
+/**
+ * Close the current browser session and clean up all state.
+ */
+async function closeBrowser() {
+    const session = currentSession;
+    currentSession = null;
+    currentRefs = {};
+    consoleMessages.length = 0;
+    networkRequests.length = 0;
+    pageErrors.length = 0;
+    nextRequestId = 0;
+    if (session) {
+        try {
+            await session.browser.close();
+        }
+        catch {
+            // Best-effort close.
+        }
+    }
+}
+// ── Tab management ────────────────────────────────────────────────────
+/**
+ * List all open tabs (pages) in the current context.
+ */
+function listTabs() {
+    if (!currentSession) {
+        return [];
+    }
+    const pages = currentSession.context.pages();
+    return pages.map((p, i) => ({
+        index: i,
+        url: p.url(),
+        active: p === currentSession.page,
+    }));
+}
+/**
+ * Open a new tab, optionally navigating to a URL.
+ */
+async function newTab(url) {
+    if (!currentSession) {
+        const launched = await launchBrowser({ url });
+        return { index: 0, url: launched.page.url() };
+    }
+    const page = await currentSession.context.newPage();
+    wirePageListeners(page);
+    currentSession.page = page;
+    currentRefs = {};
+    if (url) {
+        await page.goto(url, DEFAULT_NAVIGATION_OPTIONS);
+    }
+    const pages = currentSession.context.pages();
+    return { index: pages.length - 1, url: page.url() };
+}
+/**
+ * Switch to a tab by index.
+ */
+async function selectTab(index) {
+    if (!currentSession) {
+        await launchBrowser();
+    }
+    if (!currentSession) {
+        throw new Error("No tabs open.");
+    }
+    const pages = currentSession.context.pages();
+    if (index < 0 || index >= pages.length) {
+        throw new Error(`Tab index ${index} out of range (0..${pages.length - 1})`);
+    }
+    const page = pages[index];
+    currentSession.page = page;
+    wirePageListeners(page);
+    currentRefs = {};
+    return { url: page.url() };
+}
+/**
+ * Close a tab by index (defaults to current tab).
+ */
+async function closeTab(index) {
+    if (!currentSession) {
+        throw new Error("No tabs open.");
+    }
+    const pages = currentSession.context.pages();
+    const targetIndex = index ?? pages.indexOf(currentSession.page);
+    if (targetIndex < 0 || targetIndex >= pages.length) {
+        throw new Error(`Tab index ${targetIndex} out of range`);
+    }
+    const targetPage = pages[targetIndex];
+    await targetPage.close();
+    // Update current page if we closed the active one
+    const remaining = currentSession.context.pages();
+    if (!remaining.length) {
+        // All tabs closed — create a fresh one
+        const page = await currentSession.context.newPage();
+        currentSession.page = page;
+        wirePageListeners(page);
+    }
+    else if (targetPage === currentSession.page) {
+        const newIndex = Math.min(targetIndex, remaining.length - 1);
+        currentSession.page = remaining[newIndex];
+        wirePageListeners(currentSession.page);
+    }
+    currentRefs = {};
+}
+//# sourceMappingURL=pw-session.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Shared utilities for Playwright-based browser tool functions.
+ * Ported from OpenClaw's pw-tools-core.shared.ts.
+ */
+/**
+ * Parse a raw ref string into its canonical "eN" form.
+ * Accepts: "e1", "@e1", "ref=e1" -> "e1". Returns null if invalid.
+ */
+export declare function parseRoleRef(raw: string): string | null;
+/**
+ * Validate and normalize a ref string. Throws if the ref is empty/invalid.
+ */
+export declare function requireRef(value: unknown): string;
+/**
+ * Clamp a timeout value to a safe range (500ms .. 120s).
+ */
+export declare function normalizeTimeoutMs(timeoutMs: number | undefined, fallback: number): number;
+/**
+ * Rewrite Playwright errors into messages that guide the LLM to take
+ * corrective action (re-snapshot, scroll, etc.).
+ */
+export declare function toAIFriendlyError(error: unknown, selector: string): Error;

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

@@ -0,0 +1,73 @@
+"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.parseRoleRef = parseRoleRef;
+exports.requireRef = requireRef;
+exports.normalizeTimeoutMs = normalizeTimeoutMs;
+exports.toAIFriendlyError = toAIFriendlyError;
+/**
+ * Shared utilities for Playwright-based browser tool functions.
+ * Ported from OpenClaw's pw-tools-core.shared.ts.
+ */
+/**
+ * Parse a raw ref string into its canonical "eN" form.
+ * Accepts: "e1", "@e1", "ref=e1" -> "e1". Returns null if invalid.
+ */
+function parseRoleRef(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const normalized = trimmed.startsWith("@")
+        ? trimmed.slice(1)
+        : trimmed.startsWith("ref=")
+            ? trimmed.slice(4)
+            : trimmed;
+    return /^e\d+$/.test(normalized) ? normalized : null;
+}
+/**
+ * Validate and normalize a ref string. Throws if the ref is empty/invalid.
+ */
+function requireRef(value) {
+    const raw = typeof value === "string" ? value.trim() : "";
+    const roleRef = raw ? parseRoleRef(raw) : null;
+    const ref = roleRef ?? (raw.startsWith("@") ? raw.slice(1) : raw);
+    if (!ref) {
+        throw new Error("ref is required");
+    }
+    return ref;
+}
+/**
+ * Clamp a timeout value to a safe range (500ms .. 120s).
+ */
+function normalizeTimeoutMs(timeoutMs, fallback) {
+    return Math.max(500, Math.min(120_000, timeoutMs ?? fallback));
+}
+/**
+ * Rewrite Playwright errors into messages that guide the LLM to take
+ * corrective action (re-snapshot, scroll, etc.).
+ */
+function toAIFriendlyError(error, selector) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("strict mode violation")) {
+        const countMatch = message.match(/resolved to (\d+) elements/);
+        const count = countMatch ? countMatch[1] : "multiple";
+        return new Error(`Selector "${selector}" matched ${count} elements. ` +
+            `Run a new snapshot to get updated refs, or use a different ref.`);
+    }
+    if ((message.includes("Timeout") || message.includes("waiting for")) &&
+        (message.includes("to be visible") || message.includes("not visible"))) {
+        return new Error(`Element "${selector}" not found or not visible. ` +
+            `Run a new snapshot to see current page elements.`);
+    }
+    if (message.includes("intercepts pointer events") ||
+        message.includes("not visible") ||
+        message.includes("not receive pointer events")) {
+        return new Error(`Element "${selector}" is not interactable (hidden or covered). ` +
+            `Try scrolling it into view, closing overlays, or re-snapshotting.`);
+    }
+    return error instanceof Error ? error : new Error(message);
+}
+//# sourceMappingURL=pw-shared.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Accessibility tree snapshot and role-ref system.
+ * Ported from OpenClaw's pw-role-snapshot.ts + pw-tools-core.snapshot.ts.
+ */
+import type { PwPage, RoleRefMap, RoleSnapshotStats, SnapshotResult } from "./types.js";
+export interface RoleSnapshotOptions {
+    /** Only include interactive elements (buttons, links, inputs, etc.). */
+    interactive?: boolean;
+    /** Maximum depth to include (0 = root only). */
+    maxDepth?: number;
+    /** Remove unnamed structural elements and empty branches. */
+    compact?: boolean;
+}
+export declare function getRoleSnapshotStats(snapshot: string, refs: RoleRefMap): RoleSnapshotStats;
+/**
+ * Build a role-ref snapshot from Playwright's ariaSnapshot() output.
+ * This is the core transform: raw ARIA tree text -> annotated tree + ref map.
+ */
+export declare function buildRoleSnapshotFromAriaSnapshot(ariaSnapshot: string, options?: RoleSnapshotOptions): {
+    snapshot: string;
+    refs: RoleRefMap;
+};
+/**
+ * Take a role-based accessibility snapshot of a page.
+ * Uses Playwright's built-in ariaSnapshot() on the :root locator,
+ * then annotates elements with [ref=eN] markers.
+ */
+export declare function snapshotPage(page: PwPage, options?: RoleSnapshotOptions): Promise<SnapshotResult>;
+/**
+ * Navigate a page to a URL.
+ */
+export declare function navigatePage(page: PwPage, url: string, timeoutMs?: number): Promise<{
+    url: string;
+}>;