@fasttest-ai/qa-agent 0.1.0

package/bin/qa-agent.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// CLI entry point — forwards to compiled TypeScript
+import "../dist/index.js";

package/dist/actions.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Browser action executor — navigate, click, fill, screenshot, etc.
+ * Reference implementation from Python qa_browser_service.py → _execute_step()
+ */
+import type { Page } from "playwright";
+export interface ActionResult {
+    success: boolean;
+    error?: string;
+    data?: Record<string, unknown>;
+}
+export declare function navigate(page: Page, url: string): Promise<ActionResult>;
+export declare function click(page: Page, selector: string): Promise<ActionResult>;
+export declare function fill(page: Page, selector: string, value: string): Promise<ActionResult>;
+export declare function hover(page: Page, selector: string): Promise<ActionResult>;
+export declare function selectOption(page: Page, selector: string, value: string): Promise<ActionResult>;
+export declare function waitFor(page: Page, selector: string, timeoutMs?: number): Promise<ActionResult>;
+export declare function screenshot(page: Page, fullPage?: boolean): Promise<string>;
+export declare function getSnapshot(page: Page): Promise<Record<string, unknown>>;
+export declare function getConsoleLogs(page: Page): Promise<string[]>;
+export type AssertionType = "element_visible" | "element_hidden" | "text_contains" | "text_equals" | "url_contains" | "url_equals" | "element_count" | "attribute_value";
+export interface AssertionParams {
+    type: AssertionType;
+    selector?: string;
+    text?: string;
+    url?: string;
+    count?: number;
+    attribute?: string;
+    value?: string;
+}
+export interface AssertionResult {
+    pass: boolean;
+    actual?: string | number | boolean;
+    error?: string;
+}
+export declare function assertPage(page: Page, params: AssertionParams): Promise<AssertionResult>;

package/dist/actions.js

@@ -0,0 +1,145 @@
+/**
+ * Browser action executor — navigate, click, fill, screenshot, etc.
+ * Reference implementation from Python qa_browser_service.py → _execute_step()
+ */
+export async function navigate(page, url) {
+    try {
+        await page.goto(url, { waitUntil: "networkidle", timeout: 30_000 });
+        return {
+            success: true,
+            data: {
+                title: await page.title(),
+                url: page.url(),
+            },
+        };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function click(page, selector) {
+    try {
+        await page.click(selector, { timeout: 10_000 });
+        await page.waitForLoadState("networkidle", { timeout: 10_000 }).catch(() => { });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function fill(page, selector, value) {
+    try {
+        await page.fill(selector, value, { timeout: 10_000 });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function hover(page, selector) {
+    try {
+        await page.hover(selector, { timeout: 10_000 });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function selectOption(page, selector, value) {
+    try {
+        await page.selectOption(selector, value, { timeout: 10_000 });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function waitFor(page, selector, timeoutMs = 10_000) {
+    try {
+        await page.waitForSelector(selector, { timeout: timeoutMs });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function screenshot(page, fullPage = false) {
+    const buffer = await page.screenshot({
+        type: "jpeg",
+        quality: 80,
+        fullPage,
+    });
+    return buffer.toString("base64");
+}
+export async function getSnapshot(page) {
+    // Use Playwright's built-in aria snapshot for accessibility tree
+    const ariaSnapshot = await page.locator("body").ariaSnapshot().catch(() => "");
+    return {
+        url: page.url(),
+        title: await page.title(),
+        accessibilityTree: ariaSnapshot,
+    };
+}
+export async function getConsoleLogs(page) {
+    // Console logs must be captured via event listener — return empty for now.
+    // The actual collection is done in the MCP server via page.on('console').
+    return [];
+}
+export async function assertPage(page, params) {
+    try {
+        switch (params.type) {
+            case "element_visible": {
+                const visible = await page.isVisible(params.selector, { timeout: 5000 });
+                return { pass: visible, actual: visible };
+            }
+            case "element_hidden": {
+                const visible = await page.isVisible(params.selector);
+                return { pass: !visible, actual: !visible };
+            }
+            case "text_contains": {
+                const loc = page.locator(params.selector);
+                const count = await loc.count();
+                if (count === 0)
+                    return { pass: false, error: "Element not found" };
+                const text = await loc.first().textContent();
+                const contains = text?.includes(params.text ?? "") ?? false;
+                return { pass: contains, actual: text ?? "" };
+            }
+            case "text_equals": {
+                const loc = page.locator(params.selector);
+                const count = await loc.count();
+                if (count === 0)
+                    return { pass: false, error: "Element not found" };
+                const text = (await loc.first().textContent())?.trim() ?? "";
+                return { pass: text === params.text, actual: text };
+            }
+            case "url_contains": {
+                const currentUrl = page.url();
+                return { pass: currentUrl.includes(params.text ?? ""), actual: currentUrl };
+            }
+            case "url_equals": {
+                const currentUrl = page.url();
+                return { pass: currentUrl === params.url, actual: currentUrl };
+            }
+            case "element_count": {
+                const loc = page.locator(params.selector);
+                const elCount = await loc.count();
+                return { pass: elCount === (params.count ?? 1), actual: elCount };
+            }
+            case "attribute_value": {
+                const loc = page.locator(params.selector);
+                const elCount = await loc.count();
+                if (elCount === 0)
+                    return { pass: false, error: "Element not found" };
+                const attrVal = await loc.first().getAttribute(params.attribute ?? "");
+                return { pass: attrVal === params.value, actual: attrVal ?? "" };
+            }
+            default:
+                return { pass: false, error: `Unknown assertion type: ${params.type}` };
+        }
+    }
+    catch (err) {
+        return { pass: false, error: String(err) };
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAU,EAAE,GAAW;IACpD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE;gBACzB,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;aAChB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAU,EAAE,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAU,EAAE,QAAgB,EAAE,KAAa;IACpE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAU,EAAE,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAU,EAAE,QAAgB,EAAE,KAAa;IAC5E,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAU,EAAE,QAAgB,EAAE,YAAoB,MAAM;IACpF,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU,EAAE,WAAoB,KAAK;IACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE;QACX,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU;IAC1C,iEAAiE;IACjE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;QACf,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE;QACzB,iBAAiB,EAAE,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,2EAA2E;IAC3E,0EAA0E;IAC1E,OAAO,EAAE,CAAC;AACZ,CAAC;AA4BD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU,EAAE,MAAuB;IAClE,IAAI,CAAC;QACH,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5C,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;gBACvD,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YAC9C,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;gBACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC;gBAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;YAChD,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;gBACpE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7D,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACtD,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YAC9E,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,OAAO,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACjE,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBAClC,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACpE,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBAClC,IAAI,OAAO,KAAK,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;gBACtE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;gBACvE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;YACnE,CAAC;YACD;gBACE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Playwright browser manager — launch, reuse, and close browser instances.
+ * Manages browser contexts and pages with session persistence.
+ */
+import { type Page } from "playwright";
+export type BrowserType = "chromium" | "firefox" | "webkit";
+export interface BrowserManagerOptions {
+    browserType?: BrowserType;
+    headless?: boolean;
+    orgSlug?: string;
+}
+export declare class BrowserManager {
+    private browser;
+    private context;
+    private page;
+    private browserType;
+    private headless;
+    private orgSlug;
+    constructor(options?: BrowserManagerOptions);
+    ensureBrowser(): Promise<Page>;
+    getPage(): Promise<Page>;
+    newContext(): Promise<Page>;
+    saveSession(name: string): Promise<string>;
+    restoreSession(name: string): Promise<Page>;
+    close(): Promise<void>;
+}

package/dist/browser.js

@@ -0,0 +1,116 @@
+/**
+ * Playwright browser manager — launch, reuse, and close browser instances.
+ * Manages browser contexts and pages with session persistence.
+ */
+import { chromium, firefox, webkit } from "playwright";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const SESSION_DIR = path.join(os.homedir(), ".qa-agent", "sessions");
+export class BrowserManager {
+    browser = null;
+    context = null;
+    page = null;
+    browserType;
+    headless;
+    orgSlug;
+    constructor(options = {}) {
+        this.browserType = options.browserType ?? "chromium";
+        this.headless = options.headless ?? true;
+        this.orgSlug = options.orgSlug ?? "default";
+    }
+    async ensureBrowser() {
+        if (this.page && !this.page.isClosed()) {
+            return this.page;
+        }
+        if (!this.browser || !this.browser.isConnected()) {
+            const launcher = this.browserType === "firefox"
+                ? firefox
+                : this.browserType === "webkit"
+                    ? webkit
+                    : chromium;
+            this.browser = await launcher.launch({
+                headless: this.headless,
+                args: this.browserType === "chromium" ? ["--disable-blink-features=AutomationControlled"] : [],
+            });
+        }
+        if (!this.context) {
+            this.context = await this.browser.newContext({
+                viewport: { width: 1280, height: 720 },
+                ignoreHTTPSErrors: true,
+            });
+        }
+        this.page = await this.context.newPage();
+        return this.page;
+    }
+    async getPage() {
+        return this.ensureBrowser();
+    }
+    async newContext() {
+        if (!this.browser || !this.browser.isConnected()) {
+            await this.ensureBrowser();
+        }
+        // Close old context/page if open
+        if (this.page && !this.page.isClosed()) {
+            await this.page.close().catch(() => { });
+        }
+        if (this.context) {
+            await this.context.close().catch(() => { });
+        }
+        this.context = await this.browser.newContext({
+            viewport: { width: 1280, height: 720 },
+            ignoreHTTPSErrors: true,
+        });
+        this.page = await this.context.newPage();
+        return this.page;
+    }
+    async saveSession(name) {
+        if (!this.context) {
+            throw new Error("No browser context — nothing to save");
+        }
+        const dir = path.join(SESSION_DIR, this.orgSlug);
+        fs.mkdirSync(dir, { recursive: true });
+        const filePath = path.join(dir, `${name}.json`);
+        const state = await this.context.storageState();
+        fs.writeFileSync(filePath, JSON.stringify(state, null, 2));
+        return filePath;
+    }
+    async restoreSession(name) {
+        const filePath = path.join(SESSION_DIR, this.orgSlug, `${name}.json`);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Session "${name}" not found at ${filePath}`);
+        }
+        const state = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        if (!this.browser || !this.browser.isConnected()) {
+            await this.ensureBrowser();
+        }
+        if (this.page && !this.page.isClosed()) {
+            await this.page.close().catch(() => { });
+        }
+        if (this.context) {
+            await this.context.close().catch(() => { });
+        }
+        this.context = await this.browser.newContext({
+            storageState: state,
+            viewport: { width: 1280, height: 720 },
+            ignoreHTTPSErrors: true,
+        });
+        this.page = await this.context.newPage();
+        return this.page;
+    }
+    async close() {
+        if (this.page && !this.page.isClosed()) {
+            await this.page.close().catch(() => { });
+        }
+        if (this.context) {
+            await this.context.close().catch(() => { });
+        }
+        if (this.browser) {
+            await this.browser.close().catch(() => { });
+        }
+        this.page = null;
+        this.context = null;
+        this.browser = null;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/cloud.d.ts

@@ -0,0 +1,119 @@
+/**
+ * HTTP client to Cloud API — authenticates with the org's API key.
+ */
+export interface CloudClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface RunResponse {
+    execution_id: string;
+    status: string;
+    base_url: string | null;
+    test_cases: TestCasePayload[];
+}
+export interface TestCasePayload {
+    id: string;
+    name: string;
+    steps: TestStep[];
+    assertions: TestAssertion[];
+    test_data: Record<string, unknown>[];
+    timeout_seconds: number;
+}
+export interface TestStep {
+    action: string;
+    selector?: string;
+    value?: string;
+    url?: string;
+    description?: string;
+    timeout?: number;
+    fields?: Record<string, string>;
+    condition?: string;
+    type?: string;
+    text?: string;
+    count?: number;
+    attribute?: string;
+}
+export interface TestAssertion {
+    type: string;
+    selector?: string;
+    text?: string;
+    url?: string;
+    count?: number;
+    attribute?: string;
+    value?: string;
+    expected_value?: string;
+    description?: string;
+}
+export declare class CloudClient {
+    private apiKey;
+    private baseUrl;
+    constructor(options: CloudClientOptions);
+    private request;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    health(): Promise<{
+        status: string;
+    }>;
+    getOrg(): Promise<Record<string, unknown>>;
+    listProjects(): Promise<Record<string, unknown>>;
+    startExploration(body: {
+        url: string;
+        max_pages?: number;
+        focus?: string;
+    }): Promise<Record<string, unknown>>;
+    startConversation(body: {
+        description: string;
+        url?: string;
+    }): Promise<Record<string, unknown>>;
+    answerConversation(sessionId: string, answers: string): Promise<Record<string, unknown>>;
+    approveConversation(sessionId: string, exclude?: number[]): Promise<Record<string, unknown>>;
+    /** Start a test run — returns execution_id + test cases to execute locally. */
+    startRun(body: {
+        suite_id: string;
+        environment_id?: string;
+        browser?: string;
+        test_case_ids?: string[];
+    }): Promise<RunResponse>;
+    /** Report the result of a single test case. */
+    reportResult(executionId: string, body: {
+        test_case_id: string;
+        status: string;
+        duration_ms?: number;
+        error_message?: string;
+        screenshots?: string[];
+        console_logs?: string[];
+        step_results?: Record<string, unknown>[];
+    }): Promise<{
+        status: string;
+    }>;
+    /** Mark a suite execution as complete. */
+    completeExecution(executionId: string, status?: string): Promise<Record<string, unknown>>;
+    /** Cancel a running execution. */
+    cancelExecution(executionId: string): Promise<Record<string, unknown>>;
+    /** Get execution status. */
+    getExecutionStatus(executionId: string): Promise<Record<string, unknown>>;
+    /** Set the org's GitHub token. */
+    setGithubToken(token: string): Promise<Record<string, unknown>>;
+    /** Post test results as a PR comment. */
+    postPrComment(body: {
+        pr_url: string;
+        execution_id: string;
+        status: string;
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        duration_seconds: number;
+        test_results: Array<{
+            name?: string;
+            status?: string;
+            error?: string;
+        }>;
+        healed?: Array<{
+            original_selector?: string;
+            new_selector?: string;
+            strategy?: string;
+            confidence?: number;
+        }>;
+    }): Promise<Record<string, unknown>>;
+}

package/dist/cloud.js

@@ -0,0 +1,93 @@
+/**
+ * HTTP client to Cloud API — authenticates with the org's API key.
+ */
+export class CloudClient {
+    apiKey;
+    baseUrl;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? "https://api.qa-agent.dev").replace(/\/$/, "");
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}/api/v1${path}`;
+        const headers = {
+            "x-api-key": this.apiKey,
+            "Content-Type": "application/json",
+        };
+        const init = { method, headers };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const resp = await fetch(url, init);
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Cloud API ${method} ${path} → ${resp.status}: ${text}`);
+        }
+        return (await resp.json());
+    }
+    async get(path) {
+        return this.request("GET", path);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    // --- Health ---
+    async health() {
+        const url = `${this.baseUrl}/health`;
+        const resp = await fetch(url);
+        return (await resp.json());
+    }
+    // --- Organization ---
+    async getOrg() {
+        return this.get("/orgs/me");
+    }
+    // --- Projects ---
+    async listProjects() {
+        return this.get("/qa/projects/");
+    }
+    // --- Exploration ---
+    async startExploration(body) {
+        return this.post("/explore/", body);
+    }
+    // --- Conversation (Phase 4) ---
+    async startConversation(body) {
+        return this.post("/conversation/start", body);
+    }
+    async answerConversation(sessionId, answers) {
+        return this.post(`/conversation/${sessionId}/answer`, { answers });
+    }
+    async approveConversation(sessionId, exclude) {
+        return this.post(`/conversation/${sessionId}/approve`, { exclude });
+    }
+    // --- Execution (Phase 3) ---
+    /** Start a test run — returns execution_id + test cases to execute locally. */
+    async startRun(body) {
+        return this.post("/qa/execution/run", body);
+    }
+    /** Report the result of a single test case. */
+    async reportResult(executionId, body) {
+        return this.post(`/qa/execution/executions/${executionId}/results`, body);
+    }
+    /** Mark a suite execution as complete. */
+    async completeExecution(executionId, status) {
+        return this.post(`/qa/execution/executions/${executionId}/complete`, { status });
+    }
+    /** Cancel a running execution. */
+    async cancelExecution(executionId) {
+        return this.post(`/qa/execution/executions/${executionId}/cancel`, {});
+    }
+    /** Get execution status. */
+    async getExecutionStatus(executionId) {
+        return this.get(`/qa/execution/executions/${executionId}`);
+    }
+    // --- GitHub (Phase 6) ---
+    /** Set the org's GitHub token. */
+    async setGithubToken(token) {
+        return this.request("PUT", "/qa/github/token", { github_token: token });
+    }
+    /** Post test results as a PR comment. */
+    async postPrComment(body) {
+        return this.post("/qa/github/pr-comment", body);
+    }
+}
+//# sourceMappingURL=cloud.js.map

package/dist/cloud.js.map

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

package/dist/healer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Self-healing module — locator repair cascade.
+ *
+ * When a test step fails with a selector error, the healer tries:
+ *   1. data-testid  (confidence: 98%)
+ *   2. ARIA labels   (confidence: 95%)
+ *   3. Text content  (confidence: 90%)
+ *   4. Structural    (confidence: 85%)
+ *   5. AI-generated  (confidence: 75%) — via Cloud LLM call
+ *
+ * After a successful heal the pattern is stored in the Cloud DB so
+ * future failures with the same signature are fixed instantly.
+ */
+import type { Page } from "playwright";
+import type { CloudClient } from "./cloud.js";
+export interface HealResult {
+    healed: boolean;
+    newSelector?: string;
+    strategy?: string;
+    confidence?: number;
+    error?: string;
+}
+/**
+ * Attempt to heal a broken selector by trying 5 strategies in order.
+ * Returns the first working selector with its confidence score.
+ */
+export declare function healSelector(page: Page, cloud: CloudClient, originalSelector: string, failureType: string, errorMessage: string, pageUrl: string): Promise<HealResult>;