cdp-mcp-server 5.0.3 → 5.1.0

package/dist/utils/wait.d.ts

@@ -19,31 +19,6 @@ export declare function sleep(ms: number): Promise<void>;
  * - `"commit"` — returns immediately (navigation response received)
  */
 export declare function waitForReadyState(cdpSend: CdpSend, sessionId: string, waitUntil: WaitUntil, timeout: number): Promise<void>;
-export interface CompletionResult {
-    /** The value returned by the wrapped action. */
-    result: unknown;
-    /** Human-readable summary of observed network events. */
-    networkEvents: string[];
-}
-/**
- * Wrap an action and wait for any triggered navigation / network requests
- * to settle.  Mirrors Playwright's auto-waiting after click, fill, etc.
- *
- * The caller must supply callbacks for network-monitoring state because
- * the monitor is owned by the server, not by this utility.
- */
-export declare function waitForCompletion(cdpSend: CdpSend, sessionId: string, actionFn: () => Promise<unknown>, opts?: {
-    timeout?: number;
-    /** Enable network domain (idempotent). */
-    enableNetworkMonitoring?: () => Promise<void>;
-    /** Return a Map of requestId → request metadata. */
-    getNetworkRequests?: () => Map<string, {
-        url: string;
-        method: string;
-        type?: string;
-        status?: number;
-    }>;
-}): Promise<CompletionResult>;
 /**
  * Poll until `text` appears in the page body, or timeout expires.
  * Returns `true` if found, `false` on timeout.

package/dist/utils/wait.js

@@ -60,82 +60,6 @@ export async function waitForReadyState(cdpSend, sessionId, waitUntil, timeout)
         }
     }
 }
-/**
- * Wrap an action and wait for any triggered navigation / network requests
- * to settle.  Mirrors Playwright's auto-waiting after click, fill, etc.
- *
- * The caller must supply callbacks for network-monitoring state because
- * the monitor is owned by the server, not by this utility.
- */
-export async function waitForCompletion(cdpSend, sessionId, actionFn, opts = {}) {
-    const timeout = opts.timeout ?? 5000;
-    const completedEvents = [];
-    // Optionally enable network monitoring
-    if (opts.enableNetworkMonitoring) {
-        await opts.enableNetworkMonitoring();
-    }
-    // Snapshot current request IDs before the action
-    const reqMap = opts.getNetworkRequests?.() ?? new Map();
-    const prevRequestIds = new Set(reqMap.keys());
-    // Execute the action
-    const result = await actionFn();
-    // Brief pause to let triggered requests appear
-    await sleep(150);
-    // Detect new requests
-    const currentReqMap = opts.getNetworkRequests?.() ?? new Map();
-    const pendingRequests = new Map();
-    let navigationDetected = false;
-    for (const [reqId, req] of currentReqMap) {
-        if (!prevRequestIds.has(reqId) && !req.status) {
-            pendingRequests.set(reqId, req);
-            if ((req.type ?? '').toLowerCase() === 'document') {
-                navigationDetected = true;
-            }
-        }
-    }
-    // Wait for page load on navigation
-    if (navigationDetected) {
-        const navTimeout = Math.min(timeout * 2, 10000);
-        const start = Date.now();
-        while (Date.now() - start < navTimeout) {
-            try {
-                const r = await cdpSend('Runtime.evaluate', { expression: 'document.readyState', returnByValue: true }, sessionId, 3000);
-                if (r.result.value === 'complete')
-                    break;
-            }
-            catch {
-                /* page transitioning */
-            }
-            await sleep(300);
-        }
-        completedEvents.push('[NAV] Page navigation detected and loaded');
-    }
-    // Wait for pending XHR/fetch to complete
-    if (pendingRequests.size > 0 && opts.getNetworkRequests) {
-        const start = Date.now();
-        while (Date.now() - start < timeout && pendingRequests.size > 0) {
-            const updatedMap = opts.getNetworkRequests();
-            for (const [reqId] of pendingRequests) {
-                const updated = updatedMap.get(reqId);
-                if (updated?.status) {
-                    completedEvents.push(`[${(updated.type ?? 'XHR').toUpperCase()}] ${updated.method} ${updated.url.substring(0, 80)} → ${updated.status}`);
-                    pendingRequests.delete(reqId);
-                }
-            }
-            if (pendingRequests.size > 0)
-                await sleep(100);
-        }
-        // Report timed-out requests
-        for (const [, req] of pendingRequests) {
-            completedEvents.push(`[PENDING] ${req.method} ${req.url.substring(0, 80)} (still loading)`);
-        }
-    }
-    // Extra settling if any network activity occurred
-    if (completedEvents.length > 0) {
-        await sleep(200);
-    }
-    return { result, networkEvents: completedEvents };
-}
 // ─── waitForText ────────────────────────────────────────────────────
 /**
  * Poll until `text` appears in the page body, or timeout expires.

package/dist/utils/wait.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-mcp-server",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "description": "The power user's browser MCP — connects to your real Chrome/Edge/Brave with full DevTools capabilities",
   "type": "module",
   "main": "dist/index.js",

package/dist/utils/retry.d.ts

@@ -1,40 +0,0 @@
-/**
- * Retry utilities for transient CDP failures and stale element refs.
- *
- * Provides generic retries with configurable back-off, plus a
- * specialised wrapper for element-resolution actions that need
- * Playwright-style auto-waiting.
- */
-export interface RetryOptions {
-    /** Maximum number of attempts (default: 3). */
-    maxAttempts?: number;
-    /** Initial delay between attempts in ms (default: 500). */
-    delayMs?: number;
-    /** Multiplier applied to the delay after each failure (default: 2). */
-    backoffMultiplier?: number;
-    /** Predicate: return `true` to retry, `false` to rethrow immediately. */
-    retryOn?: (error: Error) => boolean;
-}
-/**
- * Retry `fn` up to `maxAttempts` times with exponential back-off.
- *
- * @example
- * const result = await withRetry(() => fetchSomething(), {
- *   maxAttempts: 4,
- *   delayMs: 300,
- *   retryOn: (e) => e.message.includes('ECONNRESET'),
- * });
- */
-export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-/**
- * Retry wrapper tuned for element resolution and actionability checks.
- *
- * Uses the same logic as the server.js `withRetry` — poll with a fixed
- * interval until timeout, fast-failing on errors that can never recover
- * (stale uid refs, missing params).
- *
- * @param fn        - Async function to retry (resolve element → act on it)
- * @param timeout   - Overall timeout in ms (default: 5 000)
- * @param interval  - Polling interval in ms (default: 200)
- */
-export declare function retryElementAction<T>(fn: () => Promise<T>, timeout?: number, interval?: number): Promise<T>;

package/dist/utils/retry.js

@@ -1,75 +0,0 @@
-/**
- * Retry utilities for transient CDP failures and stale element refs.
- *
- * Provides generic retries with configurable back-off, plus a
- * specialised wrapper for element-resolution actions that need
- * Playwright-style auto-waiting.
- */
-import { sleep } from './wait.js';
-// ─── withRetry ──────────────────────────────────────────────────────
-/**
- * Retry `fn` up to `maxAttempts` times with exponential back-off.
- *
- * @example
- * const result = await withRetry(() => fetchSomething(), {
- *   maxAttempts: 4,
- *   delayMs: 300,
- *   retryOn: (e) => e.message.includes('ECONNRESET'),
- * });
- */
-export async function withRetry(fn, options = {}) {
-    const { maxAttempts = 3, delayMs = 500, backoffMultiplier = 2, retryOn, } = options;
-    let lastError;
-    let currentDelay = delayMs;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-        try {
-            return await fn();
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-            // If a predicate was supplied and it says "don't retry", rethrow now
-            if (retryOn && !retryOn(lastError))
-                throw lastError;
-            // Last attempt — don't wait, just throw
-            if (attempt === maxAttempts)
-                break;
-            await sleep(currentDelay);
-            currentDelay = Math.round(currentDelay * backoffMultiplier);
-        }
-    }
-    throw lastError;
-}
-// ─── retryElementAction ─────────────────────────────────────────────
-/**
- * Retry wrapper tuned for element resolution and actionability checks.
- *
- * Uses the same logic as the server.js `withRetry` — poll with a fixed
- * interval until timeout, fast-failing on errors that can never recover
- * (stale uid refs, missing params).
- *
- * @param fn        - Async function to retry (resolve element → act on it)
- * @param timeout   - Overall timeout in ms (default: 5 000)
- * @param interval  - Polling interval in ms (default: 200)
- */
-export async function retryElementAction(fn, timeout = 5000, interval = 200) {
-    const deadline = Date.now() + timeout;
-    let lastError;
-    while (true) {
-        try {
-            return await fn();
-        }
-        catch (e) {
-            lastError = e instanceof Error ? e : new Error(String(e));
-            const msg = lastError.message;
-            // Fast-fail on errors that won't recover with retries
-            if (msg.includes('ref=') && msg.includes('not found'))
-                throw lastError;
-            if (msg.includes('Provide either'))
-                throw lastError;
-            if (Date.now() + interval > deadline)
-                throw lastError;
-            await sleep(interval);
-        }
-    }
-}
-//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAelC,uEAAuE;AAEvE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,OAAO,GAAG,GAAG,EACb,iBAAiB,GAAG,CAAC,EACrB,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,IAAI,SAA4B,CAAC;IACjC,IAAI,YAAY,GAAG,OAAO,CAAC;IAE3B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhE,qEAAqE;YACrE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,MAAM,SAAS,CAAC;YAEpD,wCAAwC;YACxC,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM;YAEnC,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;YAC1B,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,uEAAuE;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAoB,EACpB,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,GAAG;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACtC,IAAI,SAA4B,CAAC;IAEjC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;YAE9B,sDAAsD;YACtD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,MAAM,SAAS,CAAC;YACvE,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAE,MAAM,SAAS,CAAC;YAEpD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,QAAQ;gBAAE,MAAM,SAAS,CAAC;YACtD,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC"}