agentic-qe 3.7.6 → 3.7.8

package/dist/integrations/browser/page-pool-types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Browser Page Pool Types
+ *
+ * Manages concurrent browser pages for parallel E2E test execution.
+ * Follows the ConnectionPoolImpl pattern from src/mcp/connection-pool.ts.
+ *
+ * @module integrations/browser/page-pool-types
+ */
+/**
+ * State of a pooled browser page
+ */
+export type PageState = 'ready' | 'busy' | 'error' | 'closed';
+/**
+ * A managed browser page within the pool
+ */
+export interface PooledPage {
+    /** Unique page identifier */
+    id: string;
+    /** Current page state */
+    state: PageState;
+    /** When the page was created (ms since epoch) */
+    createdAt: number;
+    /** When the page was last used (ms since epoch) */
+    lastUsedAt: number;
+    /** Health score (0-1, where 1 is healthy) */
+    health: number;
+    /** Current URL */
+    url?: string;
+    /** Cumulative error count */
+    errorCount: number;
+    /** Total requests served by this page */
+    requestsServed: number;
+}
+/**
+ * Browser page pool configuration
+ */
+export interface BrowserPagePoolConfig {
+    /** Maximum concurrent pages (default: 6) */
+    maxPages: number;
+    /** Minimum pre-warmed pages (default: 1) */
+    minPages: number;
+    /** Idle timeout before page is closed in ms (default: 120000) */
+    idleTimeoutMs: number;
+    /** Health check interval in ms (default: 15000) */
+    healthCheckIntervalMs: number;
+    /** Minimum health score to keep a page (default: 0.5) */
+    healthThreshold: number;
+}
+/**
+ * Default page pool configuration
+ */
+export declare const DEFAULT_PAGE_POOL_CONFIG: BrowserPagePoolConfig;
+/**
+ * Page pool statistics for monitoring
+ */
+export interface PagePoolStats {
+    /** Total pages in the pool */
+    totalPages: number;
+    /** Pages ready for use */
+    readyPages: number;
+    /** Pages currently in use */
+    busyPages: number;
+    /** Pages in error state */
+    errorPages: number;
+    /** Ratio of successful acquisitions to total attempts */
+    poolHitRate: number;
+    /** Average time to acquire a page in ms */
+    avgAcquisitionTimeMs: number;
+}
+//# sourceMappingURL=page-pool-types.d.ts.map

package/dist/integrations/browser/page-pool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-pool-types.d.ts","sourceRoot":"","sources":["../../../src/integrations/browser/page-pool-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAMtC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/integrations/browser/page-pool-types.js

@@ -0,0 +1,19 @@
+/**
+ * Browser Page Pool Types
+ *
+ * Manages concurrent browser pages for parallel E2E test execution.
+ * Follows the ConnectionPoolImpl pattern from src/mcp/connection-pool.ts.
+ *
+ * @module integrations/browser/page-pool-types
+ */
+/**
+ * Default page pool configuration
+ */
+export const DEFAULT_PAGE_POOL_CONFIG = {
+    maxPages: 6,
+    minPages: 1,
+    idleTimeoutMs: 120_000,
+    healthCheckIntervalMs: 15_000,
+    healthThreshold: 0.5,
+};
+//# sourceMappingURL=page-pool-types.js.map

package/dist/integrations/browser/page-pool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-pool-types.js","sourceRoot":"","sources":["../../../src/integrations/browser/page-pool-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqDH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA0B;IAC7D,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,aAAa,EAAE,OAAO;IACtB,qBAAqB,EAAE,MAAM;IAC7B,eAAe,EAAE,GAAG;CACrB,CAAC"}

package/dist/integrations/browser/page-pool.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Browser Page Pool
+ *
+ * Manages concurrent browser pages with state tracking for parallel E2E execution.
+ * Follows the ConnectionPoolImpl pattern from src/mcp/connection-pool.ts.
+ *
+ * @module integrations/browser/page-pool
+ */
+import type { PooledPage, BrowserPagePoolConfig, PagePoolStats } from './page-pool-types';
+/**
+ * Browser Page Pool
+ *
+ * Manages a pool of browser pages for concurrent E2E test execution.
+ * Uses semaphore pattern for thread-safe acquisition and idle set for O(1) lookup.
+ */
+export declare class BrowserPagePool {
+    private readonly pages;
+    private readonly readyPages;
+    private readonly config;
+    private healthCheckInterval;
+    private initialized;
+    private totalRequests;
+    private cacheHits;
+    private acquisitionTimes;
+    private readonly MAX_SAMPLES;
+    private acquireQueue;
+    private processing;
+    constructor(config?: Partial<BrowserPagePoolConfig>);
+    /**
+     * Initialize the pool, pre-warming minPages
+     */
+    initialize(): Promise<void>;
+    /**
+     * Acquire a ready page from the pool (sync fast path)
+     */
+    acquire(): PooledPage | null;
+    /**
+     * Acquire a page asynchronously (thread-safe for concurrent callers)
+     */
+    acquireAsync(): Promise<PooledPage | null>;
+    /**
+     * Release a page back to the pool.
+     * If there are pending acquireAsync waiters, resolves the next one immediately.
+     */
+    release(pageId: string): void;
+    /**
+     * Mark a page as errored
+     */
+    markError(pageId: string): void;
+    /**
+     * Remove errored and timed-out pages, maintain minPages
+     */
+    prune(): number;
+    /**
+     * Get pool statistics
+     */
+    getStats(): PagePoolStats;
+    /**
+     * Shut down the pool and release all resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get a page by id (for diagnostics)
+     */
+    getPage(pageId: string): PooledPage | undefined;
+    /**
+     * Get all pages (for diagnostics)
+     */
+    getAllPages(): PooledPage[];
+    private createPage;
+    private processQueue;
+    private runHealthChecks;
+    private trackAcquisitionTime;
+}
+/**
+ * Create a new browser page pool instance
+ */
+export declare function createBrowserPagePool(config?: Partial<BrowserPagePoolConfig>): BrowserPagePool;
+//# sourceMappingURL=page-pool.d.ts.map

package/dist/integrations/browser/page-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-pool.d.ts","sourceRoot":"","sources":["../../../src/integrations/browser/page-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,UAAU,EACV,qBAAqB,EACrB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAO3B;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,mBAAmB,CAA+C;IAC1E,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;IAGnC,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAInD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACH,OAAO,IAAI,UAAU,GAAG,IAAI;IA8B5B;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAO1C;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAuB7B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU/B;;OAEG;IACH,KAAK,IAAI,MAAM;IA2Bf;;OAEG;IACH,QAAQ,IAAI,aAAa;IAkCzB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAQ3B,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,oBAAoB;CAM7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,eAAe,CAEjB"}

package/dist/integrations/browser/page-pool.js

@@ -0,0 +1,288 @@
+/**
+ * Browser Page Pool
+ *
+ * Manages concurrent browser pages with state tracking for parallel E2E execution.
+ * Follows the ConnectionPoolImpl pattern from src/mcp/connection-pool.ts.
+ *
+ * @module integrations/browser/page-pool
+ */
+import { randomUUID } from 'crypto';
+import { DEFAULT_PAGE_POOL_CONFIG } from './page-pool-types';
+// ============================================================================
+// Browser Page Pool
+// ============================================================================
+/**
+ * Browser Page Pool
+ *
+ * Manages a pool of browser pages for concurrent E2E test execution.
+ * Uses semaphore pattern for thread-safe acquisition and idle set for O(1) lookup.
+ */
+export class BrowserPagePool {
+    pages = new Map();
+    readyPages = new Set();
+    config;
+    healthCheckInterval = null;
+    initialized = false;
+    // Performance tracking
+    totalRequests = 0;
+    cacheHits = 0;
+    acquisitionTimes = [];
+    MAX_SAMPLES = 100;
+    // Semaphore for async acquire
+    acquireQueue = [];
+    processing = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_PAGE_POOL_CONFIG, ...config };
+    }
+    /**
+     * Initialize the pool, pre-warming minPages
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        for (let i = 0; i < this.config.minPages; i++) {
+            this.createPage();
+        }
+        if (this.config.healthCheckIntervalMs > 0) {
+            this.healthCheckInterval = setInterval(() => {
+                this.runHealthChecks();
+            }, this.config.healthCheckIntervalMs);
+            if (this.healthCheckInterval.unref) {
+                this.healthCheckInterval.unref();
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Acquire a ready page from the pool (sync fast path)
+     */
+    acquire() {
+        const start = performance.now();
+        this.totalRequests++;
+        for (const pageId of this.readyPages) {
+            const page = this.pages.get(pageId);
+            if (page && page.health >= this.config.healthThreshold) {
+                page.state = 'busy';
+                page.lastUsedAt = Date.now();
+                this.readyPages.delete(pageId);
+                this.cacheHits++;
+                this.trackAcquisitionTime(performance.now() - start);
+                return page;
+            }
+            this.readyPages.delete(pageId);
+        }
+        // Try to create a new page if under capacity (not a cache hit — page is new)
+        if (this.pages.size < this.config.maxPages) {
+            const page = this.createPage();
+            page.state = 'busy';
+            this.readyPages.delete(page.id);
+            this.trackAcquisitionTime(performance.now() - start);
+            return page;
+        }
+        this.trackAcquisitionTime(performance.now() - start);
+        return null;
+    }
+    /**
+     * Acquire a page asynchronously (thread-safe for concurrent callers)
+     */
+    acquireAsync() {
+        return new Promise((resolve) => {
+            this.acquireQueue.push(resolve);
+            this.processQueue();
+        });
+    }
+    /**
+     * Release a page back to the pool.
+     * If there are pending acquireAsync waiters, resolves the next one immediately.
+     */
+    release(pageId) {
+        const page = this.pages.get(pageId);
+        if (!page)
+            return;
+        page.state = 'ready';
+        page.lastUsedAt = Date.now();
+        page.requestsServed++;
+        if (page.health >= this.config.healthThreshold) {
+            // If a waiter is queued, give this page directly to them
+            if (this.acquireQueue.length > 0) {
+                const resolve = this.acquireQueue.shift();
+                page.state = 'busy';
+                page.lastUsedAt = Date.now();
+                this.totalRequests++;
+                this.cacheHits++;
+                resolve(page);
+                return;
+            }
+            this.readyPages.add(pageId);
+        }
+    }
+    /**
+     * Mark a page as errored
+     */
+    markError(pageId) {
+        const page = this.pages.get(pageId);
+        if (!page)
+            return;
+        page.state = 'error';
+        page.errorCount++;
+        page.health = Math.max(0, page.health - 0.3);
+        this.readyPages.delete(pageId);
+    }
+    /**
+     * Remove errored and timed-out pages, maintain minPages
+     */
+    prune() {
+        const now = Date.now();
+        const toRemove = [];
+        for (const [id, page] of this.pages) {
+            const isError = page.state === 'error' || page.health < this.config.healthThreshold;
+            const isIdleExpired = page.state === 'ready' && now - page.lastUsedAt > this.config.idleTimeoutMs;
+            if (isError || isIdleExpired) {
+                toRemove.push(id);
+            }
+        }
+        for (const id of toRemove) {
+            this.pages.delete(id);
+            this.readyPages.delete(id);
+        }
+        // Maintain minimum pages
+        while (this.pages.size < this.config.minPages) {
+            this.createPage();
+        }
+        return toRemove.length;
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        let readyCount = 0;
+        let busyCount = 0;
+        let errorCount = 0;
+        for (const page of this.pages.values()) {
+            switch (page.state) {
+                case 'ready':
+                    readyCount++;
+                    break;
+                case 'busy':
+                    busyCount++;
+                    break;
+                case 'error':
+                    errorCount++;
+                    break;
+            }
+        }
+        const avg = this.acquisitionTimes.length > 0
+            ? this.acquisitionTimes.reduce((a, b) => a + b, 0) / this.acquisitionTimes.length
+            : 0;
+        return {
+            totalPages: this.pages.size,
+            readyPages: readyCount,
+            busyPages: busyCount,
+            errorPages: errorCount,
+            poolHitRate: this.totalRequests > 0 ? this.cacheHits / this.totalRequests : 0,
+            avgAcquisitionTimeMs: avg,
+        };
+    }
+    /**
+     * Shut down the pool and release all resources
+     */
+    async shutdown() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        for (const page of this.pages.values()) {
+            page.state = 'closed';
+        }
+        this.pages.clear();
+        this.readyPages.clear();
+        this.initialized = false;
+        // Reject any pending acquire requests
+        for (const resolve of this.acquireQueue) {
+            resolve(null);
+        }
+        this.acquireQueue = [];
+    }
+    /**
+     * Get a page by id (for diagnostics)
+     */
+    getPage(pageId) {
+        return this.pages.get(pageId);
+    }
+    /**
+     * Get all pages (for diagnostics)
+     */
+    getAllPages() {
+        return Array.from(this.pages.values());
+    }
+    // ==========================================================================
+    // Private
+    // ==========================================================================
+    createPage() {
+        const id = `page-${randomUUID().split('-')[0]}`;
+        const now = Date.now();
+        const page = {
+            id,
+            state: 'ready',
+            createdAt: now,
+            lastUsedAt: now,
+            health: 1.0,
+            errorCount: 0,
+            requestsServed: 0,
+        };
+        this.pages.set(id, page);
+        this.readyPages.add(id);
+        return page;
+    }
+    processQueue() {
+        if (this.processing || this.acquireQueue.length === 0)
+            return;
+        this.processing = true;
+        const resolve = this.acquireQueue.shift();
+        try {
+            resolve(this.acquire());
+        }
+        finally {
+            this.processing = false;
+            if (this.acquireQueue.length > 0) {
+                setImmediate(() => this.processQueue());
+            }
+        }
+    }
+    runHealthChecks() {
+        for (const page of this.pages.values()) {
+            if (page.state === 'closed')
+                continue;
+            // Degrade health based on error rate
+            const total = page.requestsServed + page.errorCount;
+            if (total > 0) {
+                const errorRate = page.errorCount / total;
+                page.health = Math.max(0, 1 - errorRate * 0.8);
+            }
+            const wasReady = this.readyPages.has(page.id);
+            const isHealthy = page.health >= this.config.healthThreshold;
+            if (page.state === 'ready' && !isHealthy) {
+                page.state = 'error';
+                this.readyPages.delete(page.id);
+            }
+            else if (page.state === 'error' && isHealthy && !wasReady) {
+                page.state = 'ready';
+                this.readyPages.add(page.id);
+            }
+        }
+        this.prune();
+    }
+    trackAcquisitionTime(ms) {
+        this.acquisitionTimes.push(ms);
+        if (this.acquisitionTimes.length > this.MAX_SAMPLES) {
+            this.acquisitionTimes.shift();
+        }
+    }
+}
+/**
+ * Create a new browser page pool instance
+ */
+export function createBrowserPagePool(config) {
+    return new BrowserPagePool(config);
+}
+//# sourceMappingURL=page-pool.js.map

package/dist/integrations/browser/page-pool.js.map

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

package/dist/integrations/browser/resource-blocking.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Resource Blocking for Browser Automation
+ *
+ * Inspired by Scrapling's resource filtering patterns.
+ * Blocks non-essential resources (images, fonts, tracking) during E2E tests
+ * to improve page load speed and reduce flakiness.
+ *
+ * @module integrations/browser/resource-blocking
+ */
+/**
+ * Categories of resources that can be blocked
+ */
+export type ResourceCategory = 'image' | 'font' | 'media' | 'stylesheet' | 'tracking' | 'advertising' | 'websocket';
+/**
+ * Configuration for resource blocking
+ */
+export interface ResourceBlockingConfig {
+    /** Enable resource blocking */
+    enabled: boolean;
+    /** Resource categories to block */
+    blockedCategories: ResourceCategory[];
+    /** URL patterns to always allow (overrides blocked categories) */
+    allowPatterns?: string[];
+    /** URL patterns to always block (in addition to categories) */
+    blockPatterns?: string[];
+}
+/**
+ * Preset names for resource blocking configurations
+ */
+export type ResourceBlockingPreset = 'functional' | 'visual' | 'performance';
+/**
+ * Determine if a request should be blocked based on URL, resource type, and config.
+ *
+ * @param url - The request URL
+ * @param resourceType - The CDP/Playwright resource type string (e.g., 'image', 'script', 'font')
+ * @param config - The resource blocking configuration
+ * @returns true if the request should be blocked
+ */
+export declare function shouldBlockRequest(url: string, resourceType: string, config: ResourceBlockingConfig): boolean;
+/**
+ * Get a resource blocking preset by name.
+ *
+ * @param name - Preset name or a ResourceBlockingConfig object (passed through)
+ * @returns A ResourceBlockingConfig
+ */
+export declare function getResourceBlockingPreset(name: ResourceBlockingPreset | ResourceBlockingConfig): ResourceBlockingConfig;
+//# sourceMappingURL=resource-blocking.d.ts.map

package/dist/integrations/browser/resource-blocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-blocking.d.ts","sourceRoot":"","sources":["../../../src/integrations/browser/resource-blocking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,MAAM,GACN,OAAO,GACP,YAAY,GACZ,UAAU,GACV,aAAa,GACb,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;AAsG7E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAuCT;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,sBAAsB,GAAG,sBAAsB,GACpD,sBAAsB,CAUxB"}