@eidra-umain/greenlight 0.1.0

package/dist/pilot/locator.js

@@ -0,0 +1,248 @@
+/**
+ * Locator resolution — translates a11y tree refs into Playwright locators.
+ */
+/**
+ * Find an A11yNode by its ref ID, searching the tree recursively.
+ */
+export function findNodeByRef(nodes, ref) {
+    for (const node of nodes) {
+        if (node.ref === ref)
+            return node;
+        if (node.children) {
+            const found = findNodeByRef(node.children, ref);
+            if (found)
+                return found;
+        }
+    }
+    return undefined;
+}
+/**
+ * Find the path from root to a node by ref.
+ * Returns the chain of ancestor nodes including the target, or undefined.
+ */
+export function findNodePath(nodes, ref, path = []) {
+    for (const node of nodes) {
+        const currentPath = [...path, node];
+        if (node.ref === ref)
+            return currentPath;
+        if (node.children) {
+            const found = findNodePath(node.children, ref, currentPath);
+            if (found)
+                return found;
+        }
+    }
+    return undefined;
+}
+/**
+ * Given a locator, return it if it matches exactly one element,
+ * or return the first visible match if there are several.
+ * Returns undefined if the locator matches nothing.
+ */
+export async function pickVisible(locator) {
+    try {
+        const count = await locator.count();
+        if (count === 1)
+            return locator;
+        if (count > 1) {
+            for (let i = 0; i < count; i++) {
+                const nth = locator.nth(i);
+                if (await nth.isVisible())
+                    return nth;
+            }
+        }
+    }
+    catch {
+        // Locator failed entirely
+    }
+    return undefined;
+}
+export function roleLocator(scope, node) {
+    const role = node.role;
+    if (node.name) {
+        return scope.getByRole(role, { name: node.name, exact: true });
+    }
+    return scope.getByRole(role);
+}
+/**
+ * Resolve an element ref to a Playwright locator using the a11y tree hierarchy.
+ *
+ * Primary strategy: chain getByRole calls from ancestor → target using the
+ * same tree structure that ariaSnapshot reported. This disambiguates elements
+ * that share the same role+name but live under different parents.
+ *
+ * Fallback strategies (tried in order if chained locator doesn't match):
+ *   1. Direct getByRole (ignoring hierarchy)
+ *   2. getByLabel (for form inputs)
+ *   3. getByPlaceholder (for text inputs)
+ * Returns the first locator that resolves to a single visible element.
+ */
+export async function resolveLocator(page, nodes, ref) {
+    const path = findNodePath(nodes, ref);
+    if (!path || path.length === 0) {
+        throw new Error(`Element ref "${ref}" not found in accessibility tree`);
+    }
+    const target = path[path.length - 1];
+    const role = target.role;
+    // Build candidates list, best to worst
+    const candidates = [];
+    // 1. Chained locator using ancestor hierarchy
+    //    Use named ancestors to scope the search progressively
+    if (path.length > 1) {
+        let scoped;
+        for (const ancestor of path.slice(0, -1)) {
+            // Only chain through named nodes — unnamed structural nodes
+            // (like bare "list" or "main") add noise without disambiguation
+            if (!ancestor.name)
+                continue;
+            scoped = roleLocator(scoped ?? page, ancestor);
+        }
+        if (scoped) {
+            candidates.push(roleLocator(scoped, target));
+        }
+    }
+    // 2. Direct getByRole with exact name
+    if (target.name) {
+        candidates.push(page.getByRole(role, { name: target.name, exact: true }));
+    }
+    // 3. getByLabel (finds inputs by associated label text)
+    if (target.name) {
+        candidates.push(page.getByLabel(target.name, { exact: true }));
+    }
+    // 4. getByPlaceholder (finds inputs by placeholder attribute)
+    if (target.name) {
+        candidates.push(page.getByPlaceholder(target.name, { exact: true }));
+    }
+    // 5. Direct getByRole with loose name match
+    if (target.name) {
+        candidates.push(page.getByRole(role, { name: target.name }));
+    }
+    // Try each candidate: return the first that matches exactly one element,
+    // or the first visible element when there are multiple matches.
+    for (const locator of candidates) {
+        const match = await pickVisible(locator);
+        if (match)
+            return match;
+    }
+    // Last resort — return the basic locator and let Playwright handle errors
+    if (target.name) {
+        return page.getByRole(role, { name: target.name });
+    }
+    return page.getByRole(role);
+}
+/**
+ * Resolve an element by its visible text content.
+ * Used as a fallback when the element isn't in the accessibility tree
+ * (e.g. due to missing ARIA roles in the page markup).
+ */
+export async function resolveByText(page, text) {
+    const candidates = [
+        // Exact text match (link, button, or any element)
+        page.getByRole("link", { name: text, exact: true }),
+        page.getByRole("button", { name: text, exact: true }),
+        page.getByText(text, { exact: true }),
+        // Loose match
+        page.getByRole("link", { name: text }),
+        page.getByRole("button", { name: text }),
+        page.getByText(text),
+    ];
+    for (const locator of candidates) {
+        const match = await pickVisible(locator);
+        if (match)
+            return match;
+    }
+    // Last resort — let Playwright handle the error
+    return page.getByText(text);
+}
+/**
+ * Resolve a locator from an action's ref or text field.
+ */
+export async function resolveActionTarget(page, action, a11yTree) {
+    if (action.ref) {
+        return resolveLocator(page, a11yTree, action.ref);
+    }
+    if (action.text) {
+        return resolveByText(page, action.text);
+    }
+    throw new Error(`${action.action} action requires a ref or text target`);
+}
+/**
+ * Extract a CSS selector from a resolved Playwright locator.
+ * Evaluates in-browser to build a unique path-based selector.
+ */
+export async function extractCssSelector(locator) {
+    try {
+        return await locator.evaluate((el) => {
+            const escape = (s) => CSS.escape(s);
+            if (el.id)
+                return "#" + escape(el.id);
+            const parts = [];
+            let current = el;
+            while (current &&
+                current !== document.body &&
+                current !== document.documentElement) {
+                let sel = current.tagName.toLowerCase();
+                if (current.id) {
+                    parts.unshift("#" + escape(current.id));
+                    break;
+                }
+                const parent = current.parentElement;
+                if (parent) {
+                    const cur = current;
+                    const sameTag = Array.from(parent.children).filter((c) => c.tagName === cur.tagName);
+                    if (sameTag.length > 1) {
+                        sel += `:nth-of-type(${String(sameTag.indexOf(current) + 1)})`;
+                    }
+                }
+                parts.unshift(sel);
+                current = current.parentElement;
+            }
+            return parts.join(" > ");
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extract selector info from a resolved action for the plan recorder.
+ * For ref-based actions: returns role + name from the a11y node.
+ * For text-based actions: extracts a CSS selector from the DOM element.
+ */
+export async function extractSelectorInfo(page, action, a11yTree, locator) {
+    if (action.ref) {
+        const node = findNodeByRef(a11yTree, action.ref);
+        if (node) {
+            const selector = { role: node.role, name: node.name };
+            // Check if multiple elements match this role+name.
+            // If so, record which one was acted on (nth index).
+            try {
+                const allMatches = node.name
+                    ? page.getByRole(node.role, { name: node.name })
+                    : page.getByRole(node.role);
+                const count = await allMatches.count();
+                if (count > 1) {
+                    // Find which nth match our locator corresponds to
+                    const targetEl = await locator.elementHandle();
+                    for (let i = 0; i < count; i++) {
+                        const matchEl = await allMatches.nth(i).elementHandle();
+                        if (targetEl && matchEl && await targetEl.evaluate((a, b) => a === b, matchEl)) {
+                            selector.nth = i;
+                            break;
+                        }
+                    }
+                }
+            }
+            catch {
+                // If counting fails, proceed without nth
+            }
+            return selector;
+        }
+    }
+    if (action.text) {
+        const css = await extractCssSelector(locator);
+        if (css)
+            return { css };
+    }
+    return undefined;
+}
+//# sourceMappingURL=locator.js.map

package/dist/pilot/locator.js.map

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

package/dist/pilot/message-builder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Message construction helpers for the LLM client.
+ */
+import type { PageState } from "../reporter/types.js";
+import type { ChatMessage } from "./providers/types.js";
+/** Build the user message containing the step and full page state. */
+export declare function buildUserMessage(step: string, pageState: PageState): string;
+/**
+ * Compute a line-level diff between two tree strings.
+ * Returns added and removed lines, preserving order.
+ */
+export declare function computeTreeDiff(oldTree: string, newTree: string): {
+    added: string[];
+    removed: string[];
+    changedRatio: number;
+};
+/**
+ * Build a compact message for subsequent steps on the same page.
+ * Refs are stable across captures (derived from structural identity), so:
+ * - If the a11y tree is identical: skip both tree and visible text ("unchanged").
+ * - If < 30% of tree lines changed: send only the diff ("tree-diff").
+ * - If >= 30% changed: send the full tree without visible text ("tree-only").
+ * Returns null if we should send full state instead (e.g. after navigation).
+ */
+export declare function buildCompactMessage(step: string, pageState: PageState, prevState: PageState, prevTree: string): {
+    message: string;
+    mode: "unchanged" | "tree-diff" | "tree-only";
+} | null;
+/** Build the full messages array for a chat completion request. */
+export declare function buildMessages(step: string, pageState: PageState): ChatMessage[];
+//# sourceMappingURL=message-builder.d.ts.map

package/dist/pilot/message-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builder.d.ts","sourceRoot":"","sources":["../../src/pilot/message-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAa9D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAA;CAAE,GAAG,IAAI,CAyD3E;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,GAClB,WAAW,EAAE,CAKf"}

package/dist/pilot/message-builder.js

@@ -0,0 +1,112 @@
+/**
+ * Message construction helpers for the LLM client.
+ */
+import { formatA11yTree } from "./a11y-parser.js";
+import { SYSTEM_PROMPT } from "./prompts.js";
+/** Build the user message containing the step and full page state. */
+export function buildUserMessage(step, pageState) {
+    const tree = formatA11yTree(pageState.a11yTree);
+    const parts = [
+        `Current URL: ${pageState.url}`,
+        `Page title: ${pageState.title}`,
+        "",
+        "Accessibility tree:",
+        tree,
+    ];
+    if (pageState.visibleText) {
+        parts.push("", "Visible page text:", pageState.visibleText);
+    }
+    parts.push("", `Step to execute: ${step}`);
+    return parts.join("\n");
+}
+/**
+ * Compute a line-level diff between two tree strings.
+ * Returns added and removed lines, preserving order.
+ */
+export function computeTreeDiff(oldTree, newTree) {
+    const oldLines = oldTree.split("\n");
+    const newLines = newTree.split("\n");
+    const oldSet = new Set(oldLines);
+    const newSet = new Set(newLines);
+    const added = newLines.filter((l) => !oldSet.has(l));
+    const removed = oldLines.filter((l) => !newSet.has(l));
+    const total = Math.max(oldLines.length, newLines.length);
+    return {
+        added,
+        removed,
+        changedRatio: total > 0 ? (added.length + removed.length) / total : 0,
+    };
+}
+/**
+ * Build a compact message for subsequent steps on the same page.
+ * Refs are stable across captures (derived from structural identity), so:
+ * - If the a11y tree is identical: skip both tree and visible text ("unchanged").
+ * - If < 30% of tree lines changed: send only the diff ("tree-diff").
+ * - If >= 30% changed: send the full tree without visible text ("tree-only").
+ * Returns null if we should send full state instead (e.g. after navigation).
+ */
+export function buildCompactMessage(step, pageState, prevState, prevTree) {
+    // If the URL path changed, the page is fundamentally different — send full state
+    try {
+        const oldPath = new URL(prevState.url).pathname;
+        const newPath = new URL(pageState.url).pathname;
+        if (oldPath !== newPath)
+            return null;
+    }
+    catch {
+        return null;
+    }
+    const tree = formatA11yTree(pageState.a11yTree);
+    const treeUnchanged = tree === prevTree;
+    if (treeUnchanged) {
+        const parts = [
+            `Current URL: ${pageState.url}`,
+            "",
+            "Page state is unchanged from the previous step. All element refs remain the same.",
+            "",
+            `Step to execute: ${step}`,
+        ];
+        return { message: parts.join("\n"), mode: "unchanged" };
+    }
+    const { added, removed, changedRatio } = computeTreeDiff(prevTree, tree);
+    // Small change — send just the diff. Refs are stable so the LLM can
+    // combine this with the full tree it saw earlier.
+    if (changedRatio < 0.3) {
+        const parts = [
+            `Current URL: ${pageState.url}`,
+            "",
+            "Accessibility tree changes (refs are stable — unchanged elements keep their refs from the previous message):",
+        ];
+        if (removed.length > 0) {
+            parts.push("Removed elements:");
+            for (const line of removed)
+                parts.push(`  - ${line.trim()}`);
+        }
+        if (added.length > 0) {
+            parts.push("New/changed elements:");
+            for (const line of added)
+                parts.push(`  + ${line.trim()}`);
+        }
+        parts.push("", `Step to execute: ${step}`);
+        return { message: parts.join("\n"), mode: "tree-diff" };
+    }
+    // Large change — send full tree without visible text
+    const parts = [
+        `Current URL: ${pageState.url}`,
+        `Page title: ${pageState.title}`,
+        "",
+        "Accessibility tree (updated — refs are stable, only changed elements have new/removed entries):",
+        tree,
+        "",
+        `Step to execute: ${step}`,
+    ];
+    return { message: parts.join("\n"), mode: "tree-only" };
+}
+/** Build the full messages array for a chat completion request. */
+export function buildMessages(step, pageState) {
+    return [
+        { role: "system", content: SYSTEM_PROMPT },
+        { role: "user", content: buildUserMessage(step, pageState) },
+    ];
+}
+//# sourceMappingURL=message-builder.js.map

package/dist/pilot/message-builder.js.map

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

package/dist/pilot/network.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Network idle tracking and console log collection for Playwright pages.
+ */
+import type { Page } from "playwright";
+import type { ConsoleEntry } from "../reporter/types.js";
+/**
+ * Attach a network request tracker to a page.
+ * Call once after page creation. The returned `waitForNetworkIdle` function
+ * waits until all in-flight requests have completed (with a grace period
+ * to allow follow-up requests to start).
+ */
+export declare function attachNetworkTracker(page: Page): {
+    waitForNetworkIdle: (timeoutMs?: number) => Promise<void>;
+};
+/**
+ * Collect console messages from a page.
+ * Call attachConsoleCollector(page) once after page creation,
+ * then drainConsoleLogs() to retrieve and clear collected entries.
+ */
+export declare function attachConsoleCollector(page: Page): {
+    drain: () => ConsoleEntry[];
+};
+//# sourceMappingURL=network.d.ts.map

package/dist/pilot/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/pilot/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG;IACjD,kBAAkB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACzD,CA6DA;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG;IACnD,KAAK,EAAE,MAAM,YAAY,EAAE,CAAA;CAC3B,CAcA"}

package/dist/pilot/network.js

@@ -0,0 +1,92 @@
+/**
+ * Network idle tracking and console log collection for Playwright pages.
+ */
+/**
+ * Attach a network request tracker to a page.
+ * Call once after page creation. The returned `waitForNetworkIdle` function
+ * waits until all in-flight requests have completed (with a grace period
+ * to allow follow-up requests to start).
+ */
+export function attachNetworkTracker(page) {
+    const pending = new Set();
+    page.on("request", (req) => pending.add(req));
+    page.on("requestfinished", (req) => pending.delete(req));
+    page.on("requestfailed", (req) => pending.delete(req));
+    return {
+        /**
+         * Wait until the page has settled: network requests done AND
+         * rendered content stable. Two phases:
+         * 1. Wait for zero in-flight requests (with grace period for chained requests)
+         * 2. Wait for innerText to stop changing (catches CSS transitions/animations)
+         */
+        async waitForNetworkIdle(timeoutMs = 5000) {
+            const deadline = performance.now() + timeoutMs;
+            // Phase 1: wait for network requests to complete
+            const networkGrace = 200;
+            let quietSince = pending.size === 0 ? performance.now() : 0;
+            while (performance.now() < deadline) {
+                if (pending.size === 0) {
+                    if (!quietSince)
+                        quietSince = performance.now();
+                    if (performance.now() - quietSince >= networkGrace)
+                        break;
+                }
+                else {
+                    quietSince = 0;
+                }
+                await new Promise((r) => setTimeout(r, 50));
+            }
+            // Phase 2: wait for DOM content to stabilize.
+            // Use textContent (not innerText) because some frameworks
+            // render content that CSS hides from innerText during animations.
+            // textContent sees all DOM text regardless of CSS.
+            const contentGrace = 300;
+            let previous;
+            try {
+                previous =
+                    (await page.locator("body").textContent()) ?? "";
+            }
+            catch {
+                return;
+            }
+            let stableSince = performance.now();
+            while (performance.now() < deadline) {
+                await new Promise((r) => setTimeout(r, 100));
+                let current;
+                try {
+                    current =
+                        (await page.locator("body").textContent()) ?? "";
+                }
+                catch {
+                    return;
+                }
+                if (current !== previous) {
+                    previous = current;
+                    stableSince = performance.now();
+                }
+                else if (performance.now() - stableSince >= contentGrace) {
+                    return;
+                }
+            }
+        },
+    };
+}
+/**
+ * Collect console messages from a page.
+ * Call attachConsoleCollector(page) once after page creation,
+ * then drainConsoleLogs() to retrieve and clear collected entries.
+ */
+export function attachConsoleCollector(page) {
+    const logs = [];
+    page.on("console", (msg) => {
+        logs.push({ type: msg.type(), text: msg.text() });
+    });
+    return {
+        drain() {
+            const snapshot = [...logs];
+            logs.length = 0;
+            return snapshot;
+        },
+    };
+}
+//# sourceMappingURL=network.js.map

package/dist/pilot/network.js.map

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

package/dist/pilot/pilot.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The Pilot — core AI agent loop.
+ * Iterates through test steps: capture state → LLM → execute → record result.
+ */
+import type { Page } from "playwright";
+import type { ConsoleEntry, TestCaseResult } from "../reporter/types.js";
+import type { LLMClient } from "./llm.js";
+import type { PlanRecorder } from "../planner/plan-generator.js";
+export interface PilotOptions {
+    /** Per-step timeout in ms. */
+    timeout: number;
+    /** Console log drain function. */
+    consoleDrain: () => ConsoleEntry[];
+    /** Optional plan recorder for capturing heuristic plans during discovery. */
+    recorder?: PlanRecorder;
+    /** Wait for network requests to settle before capturing page state. */
+    waitForNetworkIdle?: () => Promise<void>;
+}
+/**
+ * Run all steps of a test case sequentially.
+ * Fails fast: stops on the first failed step.
+ */
+export declare function runTestCase(page: Page, testCase: {
+    name: string;
+    steps: string[];
+}, llm: LLMClient, options: PilotOptions): Promise<TestCaseResult>;
+//# sourceMappingURL=pilot.d.ts.map

package/dist/pilot/pilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pilot.d.ts","sourceRoot":"","sources":["../../src/pilot/pilot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAGX,YAAY,EAGZ,cAAc,EACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAMzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAGhE,MAAM,WAAW,YAAY;IAC5B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,YAAY,EAAE,MAAM,YAAY,EAAE,CAAA;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAC3C,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,cAAc,CAAC,CAwQzB"}