agent-web-interface 4.4.0 → 4.5.1

package/dist/src/browser/page-network-recorder.js

@@ -0,0 +1,306 @@
+/**
+ * Page Network Recorder
+ *
+ * Records network request/response details per page for the
+ * list_network_calls and search_network_calls tools.
+ *
+ * Uses Puppeteer page events (request, requestfinished, requestfailed)
+ * to capture entries. Memory-bounded via a ring buffer with
+ * configurable max entries.
+ *
+ * Follows the same lifecycle pattern as PageNetworkTracker:
+ * attach() → markNavigation() → detach()
+ */
+/** Maximum post data size to store (bytes) */
+const MAX_POST_DATA_SIZE = 2048;
+/** Default maximum number of entries to retain */
+const DEFAULT_MAX_ENTRIES = 1000;
+/** Headers worth keeping on requests */
+const KEPT_REQUEST_HEADERS = new Set([
+    'content-type',
+    'accept',
+    'content-length',
+    'x-requested-with',
+]);
+/** Headers worth keeping on responses */
+const KEPT_RESPONSE_HEADERS = new Set([
+    'content-type',
+    'content-length',
+    'cache-control',
+    'location',
+]);
+/**
+ * Records network request/response details for a single page.
+ *
+ * Uses a ring buffer (fixed-size array with head pointer) for O(1)
+ * insertion and eviction instead of Array.shift().
+ */
+export class PageNetworkRecorder {
+    // Ring buffer: fixed-size array, head points to oldest entry
+    buffer;
+    head = 0;
+    count = 0;
+    nextId = 1;
+    navigationId = 0;
+    maxEntries;
+    page = null;
+    generation = 0;
+    currentGeneration = 0;
+    /** Map from HTTPRequest to NetworkEntry for response correlation */
+    pending = new Map();
+    onRequest = null;
+    onRequestFinished = null;
+    onRequestFailed = null;
+    constructor(maxEntries = DEFAULT_MAX_ENTRIES) {
+        this.maxEntries = maxEntries;
+        this.buffer = new Array(maxEntries).fill(null);
+    }
+    attach(page) {
+        if (this.page) {
+            this.detach();
+        }
+        this.page = page;
+        this.generation++;
+        this.currentGeneration = this.generation;
+        this.createAndAttachHandlers(page);
+    }
+    detach() {
+        if (this.page) {
+            this.removeHandlers(this.page);
+        }
+        this.onRequest = null;
+        this.onRequestFinished = null;
+        this.onRequestFailed = null;
+        this.page = null;
+        this.pending.clear();
+    }
+    markNavigation() {
+        this.navigationId++;
+        this.generation++;
+        this.currentGeneration = this.generation;
+        this.pending.clear();
+        if (this.page) {
+            this.removeHandlers(this.page);
+            this.createAndAttachHandlers(this.page);
+        }
+    }
+    getEntries(filter, offset = 0, limit = 25) {
+        const filtered = this.applyFilter(filter);
+        return {
+            total: filtered.length,
+            entries: filtered.slice(offset, offset + limit),
+        };
+    }
+    search(urlPattern, isRegex = false, filter, limit = 25) {
+        const combinedFilter = {
+            ...filter,
+            url_pattern: urlPattern,
+            url_regex: isRegex,
+        };
+        const filtered = this.applyFilter(combinedFilter);
+        return { total: filtered.length, entries: filtered.slice(0, limit) };
+    }
+    clear() {
+        this.buffer = new Array(this.maxEntries).fill(null);
+        this.head = 0;
+        this.count = 0;
+        this.pending.clear();
+        this.nextId = 1;
+    }
+    getStats() {
+        let pendingCount = 0;
+        let failedCount = 0;
+        const byType = {};
+        for (const entry of this.iterEntries()) {
+            if (entry.status === null && !entry.failed)
+                pendingCount++;
+            if (entry.failed)
+                failedCount++;
+            byType[entry.resource_type] = (byType[entry.resource_type] ?? 0) + 1;
+        }
+        return {
+            total: this.count,
+            pending: pendingCount,
+            failed: failedCount,
+            by_resource_type: byType,
+        };
+    }
+    isAttached() {
+        return this.page !== null;
+    }
+    // --- Private methods ---
+    /** Iterate entries in insertion order (oldest first). */
+    *iterEntries() {
+        for (let i = 0; i < this.count; i++) {
+            const idx = (this.head + i) % this.maxEntries;
+            const entry = this.buffer[idx];
+            if (entry)
+                yield entry;
+        }
+    }
+    /** Compile a URL regex once, with a safety check for pathological patterns. */
+    compileUrlRegex(pattern) {
+        try {
+            return new RegExp(pattern);
+        }
+        catch {
+            return null;
+        }
+    }
+    applyFilter(filter) {
+        if (!filter)
+            return Array.from(this.iterEntries());
+        // Pre-compile regex once instead of per-entry
+        let urlRegex = null;
+        if (filter.url_pattern && filter.url_regex) {
+            urlRegex = this.compileUrlRegex(filter.url_pattern);
+        }
+        const results = [];
+        for (const e of this.iterEntries()) {
+            if (filter.method && e.method.toUpperCase() !== filter.method.toUpperCase())
+                continue;
+            if (filter.resource_type && e.resource_type !== filter.resource_type)
+                continue;
+            if (filter.status_min != null && (e.status === null || e.status < filter.status_min))
+                continue;
+            if (filter.status_max != null && (e.status === null || e.status > filter.status_max))
+                continue;
+            if (filter.failed_only && !e.failed)
+                continue;
+            if (filter.url_pattern) {
+                if (urlRegex) {
+                    if (!urlRegex.test(e.url))
+                        continue;
+                }
+                else if (filter.url_regex) {
+                    // Regex compilation failed — fall back to substring
+                    if (!e.url.includes(filter.url_pattern))
+                        continue;
+                }
+                else {
+                    if (!e.url.includes(filter.url_pattern))
+                        continue;
+                }
+            }
+            results.push(e);
+        }
+        return results;
+    }
+    /** Add an entry, evicting the oldest if at capacity. O(1). */
+    addEntry(entry) {
+        if (this.count >= this.maxEntries) {
+            // Overwrite oldest entry at head
+            this.buffer[this.head] = entry;
+            this.head = (this.head + 1) % this.maxEntries;
+            // No need to clean up pending — evicted entries that are still pending
+            // will simply not be found in the pending Map lookup (harmless no-op)
+        }
+        else {
+            const idx = (this.head + this.count) % this.maxEntries;
+            this.buffer[idx] = entry;
+            this.count++;
+        }
+    }
+    pickHeaders(headers, kept) {
+        const result = {};
+        for (const key of Object.keys(headers)) {
+            if (kept.has(key.toLowerCase())) {
+                result[key.toLowerCase()] = headers[key];
+            }
+        }
+        return result;
+    }
+    createAndAttachHandlers(page) {
+        const gen = this.currentGeneration;
+        this.onRequest = (req) => {
+            if (this.currentGeneration !== gen)
+                return;
+            if (req.resourceType() === 'websocket')
+                return;
+            let postData = req.postData() ?? null;
+            if (postData && postData.length > MAX_POST_DATA_SIZE) {
+                postData = postData.slice(0, MAX_POST_DATA_SIZE) + '…[truncated]';
+            }
+            const entry = {
+                id: this.nextId++,
+                url: req.url(),
+                method: req.method(),
+                resource_type: req.resourceType(),
+                is_navigation: req.isNavigationRequest(),
+                request_headers: this.pickHeaders(req.headers(), KEPT_REQUEST_HEADERS),
+                post_data: postData,
+                started_at: Date.now(),
+                status: null,
+                status_text: null,
+                response_headers: null,
+                mime_type: null,
+                duration_ms: null,
+                failed: false,
+                failure_text: null,
+                navigation_id: this.navigationId,
+            };
+            this.addEntry(entry);
+            this.pending.set(req, entry);
+        };
+        this.onRequestFinished = (req) => {
+            if (this.currentGeneration !== gen)
+                return;
+            const entry = this.pending.get(req);
+            if (!entry)
+                return;
+            this.pending.delete(req);
+            const response = req.response();
+            if (response) {
+                entry.status = response.status();
+                entry.status_text = response.statusText();
+                entry.response_headers = this.pickHeaders(response.headers(), KEPT_RESPONSE_HEADERS);
+                const ct = response.headers()['content-type'];
+                entry.mime_type = ct ? ct.split(';')[0].trim() : null;
+            }
+            entry.duration_ms = Date.now() - entry.started_at;
+        };
+        this.onRequestFailed = (req) => {
+            if (this.currentGeneration !== gen)
+                return;
+            const entry = this.pending.get(req);
+            if (!entry)
+                return;
+            this.pending.delete(req);
+            entry.failed = true;
+            entry.failure_text = req.failure()?.errorText ?? null;
+            entry.duration_ms = Date.now() - entry.started_at;
+        };
+        page.on('request', this.onRequest);
+        page.on('requestfinished', this.onRequestFinished);
+        page.on('requestfailed', this.onRequestFailed);
+    }
+    removeHandlers(page) {
+        if (this.onRequest)
+            page.off('request', this.onRequest);
+        if (this.onRequestFinished)
+            page.off('requestfinished', this.onRequestFinished);
+        if (this.onRequestFailed)
+            page.off('requestfailed', this.onRequestFailed);
+    }
+}
+// --- Global Registry ---
+const recorders = new WeakMap();
+export function getOrCreateRecorder(page, maxEntries) {
+    let recorder = recorders.get(page);
+    if (!recorder) {
+        recorder = new PageNetworkRecorder(maxEntries);
+        recorders.set(page, recorder);
+    }
+    return recorder;
+}
+export function removeRecorder(page) {
+    const recorder = recorders.get(page);
+    if (recorder) {
+        recorder.detach();
+        recorders.delete(page);
+    }
+}
+export function hasRecorder(page) {
+    return recorders.has(page);
+}
+//# sourceMappingURL=page-network-recorder.js.map

package/dist/src/browser/page-network-recorder.js.map

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

package/dist/src/browser/session-manager.d.ts

@@ -10,12 +10,17 @@ import type { ConnectionHealth } from '../state/health.types.js';
 import type { ConnectionState, ConnectionStateChangeEvent, StorageState, LaunchOptions, ConnectOptions } from './session-manager.types.js';
 /** Type alias for Puppeteer Page (exported for downstream use) */
 export type { Page };
+/** Default user data directory for persistent browser profiles */
+export declare const DEFAULT_USER_DATA_DIR: string;
 /**
  * Manages browser lifecycle and page creation.
  *
  * Supports two modes:
  * - launch(): Start a new browser instance
  * - connect(): Connect to an existing browser via CDP
+ *
+ * Each SessionController owns its own SessionManager instance for
+ * per-session browser isolation.
  */
 export declare class SessionManager {
     private browser;
@@ -31,11 +36,18 @@ export declare class SessionManager {
     private browserDisconnectHandler;
     /** Last known WebSocket endpoint, saved during detach() for potential reconnection */
     private _lastWsEndpoint;
+    /** Promise for in-flight launch/connect operation */
+    private _connectionPromise;
     constructor();
     /**
      * Get current connection state
      */
     get connectionState(): ConnectionState;
+    /**
+     * Get the in-flight connection promise, if any.
+     * Callers can await this instead of starting a duplicate launch/connect.
+     */
+    get connectionPromise(): Promise<void> | null;
     /**
      * Get the last known WebSocket endpoint URL.
      * Saved during detach() for potential reconnection to the same browser.
@@ -56,6 +68,10 @@ export declare class SessionManager {
      * @throws BrowserSessionError if browser is already running or connection in progress
      */
     launch(options?: LaunchOptions): Promise<void>;
+    /**
+     * Internal launch implementation with timeout.
+     */
+    private _doLaunch;
     /**
      * Connect to an existing browser via CDP.
      *
@@ -80,6 +96,10 @@ export declare class SessionManager {
      * ```
      */
     connect(options?: ConnectOptions): Promise<void>;
+    /**
+     * Internal connect implementation.
+     */
+    private _doConnect;
     /**
      * Get the number of pages in the browser context.
      *

package/dist/src/browser/session-manager.d.ts.map

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