@fasttest-ai/qa-agent 0.1.3 → 0.3.0

package/dist/cloud.d.ts

@@ -5,6 +5,18 @@ export interface CloudClientOptions {
     apiKey: string;
     baseUrl?: string;
 }
+export interface DeviceCodeResponse {
+    code: string;
+    poll_token: string;
+    expires_in: number;
+    verification_url: string;
+}
+export interface DeviceCodeStatusResponse {
+    status: "pending" | "completed" | "expired";
+    api_key?: string;
+    org_name?: string;
+    org_slug?: string;
+}
 export interface RunResponse {
     execution_id: string;
     status: string;
@@ -18,6 +30,7 @@ export interface TestCasePayload {
     assertions: TestAssertion[];
     test_data: Record<string, unknown>[];
     timeout_seconds: number;
+    retry_count: number;
 }
 export interface TestStep {
     action: string;
@@ -31,6 +44,9 @@ export interface TestStep {
     key?: string;
     file_paths?: string[];
     expression?: string;
+    target?: string;
+    width?: number;
+    height?: number;
     type?: string;
     text?: string;
     count?: number;
@@ -51,6 +67,16 @@ export declare class CloudClient {
     private apiKey;
     private baseUrl;
     constructor(options: CloudClientOptions);
+    /**
+     * Request a device code for browser-based authentication.
+     * Unauthenticated — no API key needed.
+     */
+    static requestDeviceCode(baseUrl: string): Promise<DeviceCodeResponse>;
+    /**
+     * Poll for device code status. Returns when completed or expired.
+     * Unauthenticated — uses the poll_token for identity.
+     */
+    static pollDeviceCode(baseUrl: string, pollToken: string): Promise<DeviceCodeStatusResponse>;
     private request;
     get<T>(path: string): Promise<T>;
     post<T>(path: string, body?: unknown): Promise<T>;
@@ -59,17 +85,85 @@ export declare class CloudClient {
     }>;
     getOrg(): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
+    /** Get-or-create a project by name. Returns project with id. */
+    resolveProject(name: string, baseUrl?: string): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** List all test suites across all projects for the org. */
+    listSuites(search?: string): Promise<Array<Record<string, unknown>>>;
+    /** Resolve a suite by name (case-insensitive). Returns the best match. */
+    resolveSuite(name: string, projectId?: string): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** Create a test suite under a project. */
+    createSuite(projectId: string, body: {
+        name: string;
+        description?: string;
+        test_type?: string;
+        auto_generated?: boolean;
+        tags?: string[];
+    }): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** Update an existing test suite. */
+    updateSuite(projectId: string, suiteId: string, body: {
+        name?: string;
+        description?: string;
+        tags?: string[];
+    }): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** Create a test case and link it to suite(s). */
+    createTestCase(body: {
+        name: string;
+        description?: string;
+        priority?: string;
+        steps: Array<Record<string, unknown>>;
+        assertions: Array<Record<string, unknown>>;
+        tags?: string[];
+        test_suite_ids: string[];
+        auto_generated?: boolean;
+        generated_by_agent?: boolean;
+        natural_language_source?: string;
+    }): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** Update an existing test case. */
+    updateTestCase(testCaseId: string, body: {
+        name?: string;
+        description?: string;
+        priority?: string;
+        steps?: Array<Record<string, unknown>>;
+        assertions?: Array<Record<string, unknown>>;
+        tags?: string[];
+    }): Promise<{
+        id: string;
+        name: string;
+    }>;
+    /** Get a suite with its test cases. */
+    getSuiteWithCases(projectId: string, suiteId: string): Promise<{
+        id: string;
+        name: string;
+        description?: string;
+        test_cases: Array<{
+            id: string;
+            name: string;
+            steps: Array<Record<string, unknown>>;
+            assertions: Array<Record<string, unknown>>;
+        }>;
+    }>;
+    /** @deprecated Cloud exploration endpoints removed. Exploration runs via local skill. */
     startExploration(body: {
         url: string;
         max_pages?: number;
         focus?: string;
+        project_id?: 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;
@@ -86,6 +180,15 @@ export declare class CloudClient {
         screenshots?: string[];
         console_logs?: string[];
         step_results?: Record<string, unknown>[];
+        retry_attempt?: number;
+        network_summary?: Array<{
+            url: string;
+            method: string;
+            status: number;
+            duration: number;
+            mimeType: string;
+            responseSize: number;
+        }>;
     }): Promise<{
         status: string;
     }>;
@@ -95,6 +198,12 @@ export declare class CloudClient {
     cancelExecution(executionId: string): Promise<Record<string, unknown>>;
     /** Get execution status. */
     getExecutionStatus(executionId: string): Promise<Record<string, unknown>>;
+    /** Notify that a test case is about to start executing. Non-fatal. */
+    notifyTestStarted(executionId: string, testCaseId: string, testCaseName: string): Promise<void>;
+    /** Notify that selector healing is being attempted. Non-fatal. */
+    notifyHealingStarted(executionId: string, testCaseId: string, originalSelector: string): Promise<void>;
+    /** Lightweight check for control signals (pause/cancel) from the dashboard. */
+    checkControlStatus(executionId: string): Promise<string>;
     /** Set the org's GitHub token. */
     setGithubToken(token: string): Promise<Record<string, unknown>>;
     /** Post test results as a PR comment. */
@@ -118,5 +227,24 @@ export declare class CloudClient {
             strategy?: string;
             confidence?: number;
         }>;
+        flaky_retries?: Array<{
+            name?: string;
+            retry_attempts?: number;
+        }>;
+    }): Promise<Record<string, unknown>>;
+    /** Save a chaos report with adversarial findings. */
+    saveChaosReport(projectId: string | undefined, body: {
+        url: string;
+        findings: Array<{
+            severity: string;
+            category: string;
+            description: string;
+            reproduction_steps: string[];
+            console_errors?: string[];
+        }>;
     }): Promise<Record<string, unknown>>;
+    /** List chaos reports for the org. */
+    listChaosReports(projectId?: string): Promise<Record<string, unknown>>;
+    /** Get a single chaos report. */
+    getChaosReport(reportId: string): Promise<Record<string, unknown>>;
 }

package/dist/cloud.js

@@ -6,7 +6,33 @@ export class CloudClient {
     baseUrl;
     constructor(options) {
         this.apiKey = options.apiKey;
-        this.baseUrl = (options.baseUrl ?? "https://api.qa-agent.dev").replace(/\/$/, "");
+        this.baseUrl = (options.baseUrl ?? "https://api.fasttest.ai").replace(/\/$/, "");
+    }
+    /**
+     * Request a device code for browser-based authentication.
+     * Unauthenticated — no API key needed.
+     */
+    static async requestDeviceCode(baseUrl) {
+        const url = `${baseUrl.replace(/\/$/, "")}/api/v1/auth/device-code`;
+        const resp = await fetch(url, { method: "POST" });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Device code request failed (${resp.status}): ${text}`);
+        }
+        return (await resp.json());
+    }
+    /**
+     * Poll for device code status. Returns when completed or expired.
+     * Unauthenticated — uses the poll_token for identity.
+     */
+    static async pollDeviceCode(baseUrl, pollToken) {
+        const url = `${baseUrl.replace(/\/$/, "")}/api/v1/auth/device-code/status?poll_token=${encodeURIComponent(pollToken)}`;
+        const resp = await fetch(url);
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Device code poll failed (${resp.status}): ${text}`);
+        }
+        return (await resp.json());
     }
     async request(method, path, body) {
         const url = `${this.baseUrl}/api/v1${path}`;
@@ -14,16 +40,40 @@ export class CloudClient {
             "x-api-key": this.apiKey,
             "Content-Type": "application/json",
         };
-        const init = { method, headers };
-        if (body !== undefined) {
-            init.body = JSON.stringify(body);
+        const maxRetries = 2;
+        const baseDelay = 1000;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 30_000);
+            try {
+                const init = { method, headers, signal: controller.signal };
+                if (body !== undefined) {
+                    init.body = JSON.stringify(body);
+                }
+                const resp = await fetch(url, init);
+                clearTimeout(timeoutId);
+                if (!resp.ok) {
+                    const text = await resp.text();
+                    if (resp.status >= 500 && attempt < maxRetries) {
+                        await new Promise((r) => setTimeout(r, baseDelay * 2 ** attempt));
+                        continue;
+                    }
+                    throw new Error(`Cloud API ${method} ${path} → ${resp.status}: ${text}`);
+                }
+                return (await resp.json());
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                const isRetryable = err instanceof Error &&
+                    (err.name === "AbortError" || err.message.includes("fetch failed"));
+                if (isRetryable && attempt < maxRetries) {
+                    await new Promise((r) => setTimeout(r, baseDelay * 2 ** attempt));
+                    continue;
+                }
+                throw err;
+            }
         }
-        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());
+        throw new Error(`Cloud API ${method} ${path}: max retries exceeded`);
     }
     async get(path) {
         return this.request("GET", path);
@@ -45,20 +95,55 @@ export class CloudClient {
     async listProjects() {
         return this.get("/qa/projects/");
     }
-    // --- Exploration ---
+    /** Get-or-create a project by name. Returns project with id. */
+    async resolveProject(name, baseUrl) {
+        const body = { name };
+        if (baseUrl)
+            body.base_url = baseUrl;
+        return this.post("/qa/projects/resolve", body);
+    }
+    // --- Suites ---
+    /** List all test suites across all projects for the org. */
+    async listSuites(search) {
+        const qs = search ? `?search=${encodeURIComponent(search)}` : "";
+        return this.get(`/qa/projects/suites/all${qs}`);
+    }
+    /** Resolve a suite by name (case-insensitive). Returns the best match. */
+    async resolveSuite(name, projectId) {
+        const body = { name };
+        if (projectId)
+            body.project_id = projectId;
+        return this.post("/qa/projects/suites/resolve", body);
+    }
+    // --- Suite + Test Case Management ---
+    /** Create a test suite under a project. */
+    async createSuite(projectId, body) {
+        return this.post(`/qa/projects/${projectId}/test-suites`, {
+            ...body,
+            project_id: projectId,
+        });
+    }
+    /** Update an existing test suite. */
+    async updateSuite(projectId, suiteId, body) {
+        return this.request("PUT", `/qa/projects/${projectId}/test-suites/${suiteId}`, body);
+    }
+    /** Create a test case and link it to suite(s). */
+    async createTestCase(body) {
+        return this.post("/qa/test-cases/", body);
+    }
+    /** Update an existing test case. */
+    async updateTestCase(testCaseId, body) {
+        return this.request("PUT", `/qa/test-cases/${testCaseId}`, body);
+    }
+    /** Get a suite with its test cases. */
+    async getSuiteWithCases(projectId, suiteId) {
+        return this.get(`/qa/projects/${projectId}/suites/${suiteId}/details`);
+    }
+    // --- Exploration (DEPRECATED — cloud exploration endpoints no longer served) ---
+    /** @deprecated Cloud exploration endpoints removed. Exploration runs via local skill. */
     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) {
@@ -80,6 +165,35 @@ export class CloudClient {
     async getExecutionStatus(executionId) {
         return this.get(`/qa/execution/executions/${executionId}`);
     }
+    /** Notify that a test case is about to start executing. Non-fatal. */
+    async notifyTestStarted(executionId, testCaseId, testCaseName) {
+        try {
+            await this.post(`/qa/execution/executions/${executionId}/test-started`, {
+                test_case_id: testCaseId,
+                test_case_name: testCaseName,
+            });
+        }
+        catch {
+            // Non-fatal — War Room will just miss the "running" indicator
+        }
+    }
+    /** Notify that selector healing is being attempted. Non-fatal. */
+    async notifyHealingStarted(executionId, testCaseId, originalSelector) {
+        try {
+            await this.post(`/qa/execution/executions/${executionId}/healing-started`, {
+                test_case_id: testCaseId,
+                original_selector: originalSelector,
+            });
+        }
+        catch {
+            // Non-fatal — War Room will just miss the "healing..." indicator
+        }
+    }
+    /** Lightweight check for control signals (pause/cancel) from the dashboard. */
+    async checkControlStatus(executionId) {
+        const resp = await this.get(`/qa/execution/executions/${executionId}/control-status`);
+        return resp.status;
+    }
     // --- GitHub (Phase 6) ---
     /** Set the org's GitHub token. */
     async setGithubToken(token) {
@@ -89,5 +203,20 @@ export class CloudClient {
     async postPrComment(body) {
         return this.post("/qa/github/pr-comment", body);
     }
+    // --- Chaos (Break My App) ---
+    /** Save a chaos report with adversarial findings. */
+    async saveChaosReport(projectId, body) {
+        const qs = projectId ? `?project_id=${projectId}` : "";
+        return this.post(`/qa/chaos/reports${qs}`, body);
+    }
+    /** List chaos reports for the org. */
+    async listChaosReports(projectId) {
+        const qs = projectId ? `?project_id=${projectId}` : "";
+        return this.get(`/qa/chaos/reports${qs}`);
+    }
+    /** Get a single chaos report. */
+    async getChaosReport(reportId) {
+        return this.get(`/qa/chaos/reports/${reportId}`);
+    }
 }
 //# sourceMappingURL=cloud.js.map

package/dist/cloud.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Global config manager — reads/writes ~/.fasttest/config.json
+ * Stores API key and base URL so the MCP server can boot without CLI args.
+ * Falls back to legacy ~/.qa-agent/config.json for backward compatibility.
+ */
+declare const CONFIG_PATH: string;
+export interface GlobalConfig {
+    api_key?: string;
+    base_url?: string;
+}
+/**
+ * Load config from ~/.fasttest/config.json (or legacy ~/.qa-agent/config.json).
+ * Returns empty object if file doesn't exist or is malformed.
+ */
+export declare function loadGlobalConfig(): GlobalConfig;
+/**
+ * Merge new values into ~/.fasttest/config.json and write with 0o600 permissions.
+ * Always writes to the new location (~/.fasttest/).
+ */
+export declare function saveGlobalConfig(updates: Partial<GlobalConfig>): void;
+export { CONFIG_PATH };

package/dist/config.js

@@ -0,0 +1,49 @@
+/**
+ * Global config manager — reads/writes ~/.fasttest/config.json
+ * Stores API key and base URL so the MCP server can boot without CLI args.
+ * Falls back to legacy ~/.qa-agent/config.json for backward compatibility.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const NEW_CONFIG_DIR = path.join(os.homedir(), ".fasttest");
+const OLD_CONFIG_DIR = path.join(os.homedir(), ".qa-agent");
+/** Resolve config dir: prefer ~/.fasttest/, fall back to ~/.qa-agent/ */
+function resolveConfigDir() {
+    if (fs.existsSync(path.join(NEW_CONFIG_DIR, "config.json")))
+        return NEW_CONFIG_DIR;
+    if (fs.existsSync(path.join(OLD_CONFIG_DIR, "config.json")))
+        return OLD_CONFIG_DIR;
+    return NEW_CONFIG_DIR;
+}
+const CONFIG_DIR = resolveConfigDir();
+const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
+/**
+ * Load config from ~/.fasttest/config.json (or legacy ~/.qa-agent/config.json).
+ * Returns empty object if file doesn't exist or is malformed.
+ */
+export function loadGlobalConfig() {
+    if (!fs.existsSync(CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Merge new values into ~/.fasttest/config.json and write with 0o600 permissions.
+ * Always writes to the new location (~/.fasttest/).
+ */
+export function saveGlobalConfig(updates) {
+    const existing = loadGlobalConfig();
+    const merged = { ...existing, ...updates };
+    const saveDir = NEW_CONFIG_DIR;
+    const savePath = path.join(saveDir, "config.json");
+    fs.mkdirSync(saveDir, { recursive: true });
+    const content = JSON.stringify(merged, null, 2) + "\n";
+    fs.writeFileSync(savePath, content, { mode: 0o600 });
+}
+export { CONFIG_PATH };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAE5D,yEAAyE;AACzE,SAAS,gBAAgB;IACvB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,cAAc,CAAC;IACnF,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,cAAc,CAAC;IACnF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;AACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAOzD;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAiB,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA8B;IAC7D,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACnD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/healer.d.ts

@@ -24,4 +24,4 @@ export interface HealResult {
  * 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>;
+export declare function healSelector(page: Page, cloud: CloudClient | null, originalSelector: string, failureType: string, errorMessage: string, pageUrl: string): Promise<HealResult>;