playwriter 0.0.16 → 0.0.21

package/dist/start-relay-server.d.ts

@@ -1,6 +1,4 @@
 export declare function startServer({ port }?: {
     port?: number;
-}): Promise<{
-    close(): void;
-}>;
+}): Promise<import("./extension/cdp-relay.js").RelayServer>;
 //# sourceMappingURL=start-relay-server.d.ts.map

package/dist/start-relay-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-relay-server.d.ts","sourceRoot":"","sources":["../src/start-relay-server.ts"],"names":[],"mappings":"AAuCA,wBAAsB,WAAW,CAAC,EAAE,IAAY,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO;;GAmBzE"}
+{"version":3,"file":"start-relay-server.d.ts","sourceRoot":"","sources":["../src/start-relay-server.ts"],"names":[],"mappings":"AAsBA,wBAAsB,WAAW,CAAC,EAAE,IAAY,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,2DAmBzE"}

package/dist/start-relay-server.js

@@ -1,20 +1,7 @@
 import { startPlayWriterCDPRelayServer } from './extension/cdp-relay.js';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import util from 'node:util';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const logFilePath = path.join(__dirname, '..', 'relay-server.log');
+import { createFileLogger } from './create-logger.js';
 process.title = 'playwriter-ws-server';
-fs.writeFileSync(logFilePath, '');
-const log = (...args) => {
-    const message = args.map(arg => typeof arg === 'string' ? arg : util.inspect(arg, { depth: null, colors: false })).join(' ');
-    return fs.promises.appendFile(logFilePath, message + '\n');
-};
-const logger = {
-    log,
-    error: log
-};
+const logger = createFileLogger();
 process.on('uncaughtException', async (err) => {
     await logger.error('Uncaught Exception:', err);
     process.exit(1);
@@ -29,7 +16,7 @@ process.on('exit', async (code) => {
 export async function startServer({ port = 19988 } = {}) {
     const server = await startPlayWriterCDPRelayServer({ port, logger });
     console.log('CDP Relay Server running. Press Ctrl+C to stop.');
-    console.log('Logs are being written to:', logFilePath);
+    console.log('Logs are being written to:', logger.logFilePath);
     process.on('SIGINT', () => {
         console.log('\nShutting down...');
         server.close();

package/dist/start-relay-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-relay-server.js","sourceRoot":"","sources":["../src/start-relay-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start-relay-server.js","sourceRoot":"","sources":["../src/start-relay-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,CAAC,KAAK,GAAG,sBAAsB,CAAA;AAEtC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;AAEjC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5C,MAAM,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAChD,MAAM,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAChC,MAAM,MAAM,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAE,IAAI,GAAG,KAAK,KAAwB,EAAE;IACxE,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAEpE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAA;IAC9D,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IAE7D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;QACjC,MAAM,CAAC,KAAK,EAAE,CAAA;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;QACjC,MAAM,CAAC,KAAK,EAAE,CAAA;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AACD,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -2,4 +2,7 @@ export declare function getCdpUrl({ port, host }?: {
     port?: number;
     host?: string;
 }): string;
+export declare function getDataDir(): string;
+export declare function ensureDataDir(): string;
+export declare const LOG_FILE_PATH: string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,EAAE,IAAY,EAAE,IAAkB,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,UAGpG"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,EAAE,IAAY,EAAE,IAAkB,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,UAGpG;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAcD,eAAO,MAAM,aAAa,QAAmB,CAAA"}

package/dist/utils.js

@@ -1,5 +1,41 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { xdgData } from 'xdg-basedir';
 export function getCdpUrl({ port = 19988, host = '127.0.0.1' } = {}) {
     const id = `${Math.random().toString(36).substring(2, 15)}_${Date.now()}`;
     return `ws://${host}:${port}/cdp/${id}`;
 }
+export function getDataDir() {
+    const dataDir = xdgData || path.join(os.homedir(), '.local', 'share');
+    return path.join(dataDir, 'playwriter');
+}
+export function ensureDataDir() {
+    const dataDir = getDataDir();
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    return dataDir;
+}
+function getLogsDir() {
+    return path.join(getDataDir(), 'logs');
+}
+function getLogFilePath() {
+    if (process.env.PLAYWRITER_LOG_PATH) {
+        return process.env.PLAYWRITER_LOG_PATH;
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    return path.join(getLogsDir(), `relay-server-${timestamp}.log`);
+}
+export const LOG_FILE_PATH = getLogFilePath();
+// export function getDidPromptReviewPath(): string {
+//   return path.join(getDataDir(), 'did-prompt-review')
+// }
+// export function hasReviewedPrompt(): boolean {
+//   return fs.existsSync(getDidPromptReviewPath())
+// }
+// export function markPromptReviewed(): void {
+//   ensureDataDir()
+//   fs.writeFileSync(getDidPromptReviewPath(), new Date().toISOString())
+// }
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,WAAW,KAAuC,EAAE;IACnG,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IACzE,OAAO,QAAQ,IAAI,IAAI,IAAI,QAAQ,EAAE,EAAE,CAAA;AACzC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,WAAW,KAAuC,EAAE;IACnG,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IACzE,OAAO,QAAQ,IAAI,IAAI,IAAI,QAAQ,EAAE,EAAE,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAA;IACxC,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,gBAAgB,SAAS,MAAM,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,EAAE,CAAA;AAE7C,qDAAqD;AACrD,wDAAwD;AACxD,IAAI;AAEJ,iDAAiD;AACjD,mDAAmD;AACnD,IAAI;AAEJ,+CAA+C;AAC/C,oBAAoB;AACpB,yEAAyE;AACzE,IAAI"}

package/dist/wait-for-page-load.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from 'playwright-core';
+export interface WaitForPageLoadOptions {
+    page: Page;
+    timeout?: number;
+    pollInterval?: number;
+    minWait?: number;
+}
+export interface WaitForPageLoadResult {
+    success: boolean;
+    readyState: string;
+    pendingRequests: string[];
+    waitTimeMs: number;
+    timedOut: boolean;
+}
+export declare function waitForPageLoad(options: WaitForPageLoadOptions): Promise<WaitForPageLoadResult>;
+//# sourceMappingURL=wait-for-page-load.d.ts.map

package/dist/wait-for-page-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-page-load.d.ts","sourceRoot":"","sources":["../src/wait-for-page-load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AA0C3C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmHrG"}

package/dist/wait-for-page-load.js

@@ -0,0 +1,126 @@
+const FILTERED_DOMAINS = [
+    'doubleclick',
+    'googlesyndication',
+    'googleadservices',
+    'google-analytics',
+    'googletagmanager',
+    'facebook.net',
+    'fbcdn.net',
+    'twitter.com',
+    'linkedin.com',
+    'hotjar',
+    'mixpanel',
+    'segment.io',
+    'segment.com',
+    'newrelic',
+    'datadoghq',
+    'sentry.io',
+    'fullstory',
+    'amplitude',
+    'intercom',
+    'crisp.chat',
+    'zdassets.com',
+    'zendesk',
+    'tawk.to',
+    'hubspot',
+    'marketo',
+    'pardot',
+    'optimizely',
+    'crazyegg',
+    'mouseflow',
+    'clarity.ms',
+    'bing.com/bat',
+    'ads.',
+    'analytics.',
+    'tracking.',
+    'pixel.',
+];
+const FILTERED_EXTENSIONS = ['.gif', '.ico', '.cur', '.woff', '.woff2', '.ttf', '.otf', '.eot'];
+export async function waitForPageLoad(options) {
+    const { page, timeout = 30000, pollInterval = 100, minWait = 500 } = options;
+    const startTime = Date.now();
+    let timedOut = false;
+    let lastReadyState = '';
+    let lastPendingRequests = [];
+    const checkPageReady = async () => {
+        const result = await page.evaluate(({ filteredDomains, filteredExtensions, stuckThreshold, slowResourceThreshold }) => {
+            const doc = globalThis.document;
+            const readyState = doc.readyState;
+            if (readyState !== 'complete') {
+                return { ready: false, readyState, pendingRequests: [`document.readyState: ${readyState}`] };
+            }
+            const resources = performance.getEntriesByType('resource');
+            const now = performance.now();
+            const pendingRequests = resources
+                .filter((r) => {
+                if (r.responseEnd > 0) {
+                    return false;
+                }
+                const elapsed = now - r.startTime;
+                const url = r.name.toLowerCase();
+                if (url.startsWith('data:')) {
+                    return false;
+                }
+                if (filteredDomains.some((domain) => url.includes(domain))) {
+                    return false;
+                }
+                if (elapsed > stuckThreshold) {
+                    return false;
+                }
+                if (elapsed > slowResourceThreshold && filteredExtensions.some((ext) => url.includes(ext))) {
+                    return false;
+                }
+                return true;
+            })
+                .map((r) => r.name);
+            return {
+                ready: pendingRequests.length === 0,
+                readyState,
+                pendingRequests,
+            };
+        }, {
+            filteredDomains: FILTERED_DOMAINS,
+            filteredExtensions: FILTERED_EXTENSIONS,
+            stuckThreshold: 10000,
+            slowResourceThreshold: 3000,
+        });
+        return result;
+    };
+    await new Promise((resolve) => setTimeout(resolve, minWait));
+    while (Date.now() - startTime < timeout) {
+        try {
+            const { ready, readyState, pendingRequests } = await checkPageReady();
+            lastReadyState = readyState;
+            lastPendingRequests = pendingRequests;
+            if (ready) {
+                return {
+                    success: true,
+                    readyState,
+                    pendingRequests: [],
+                    waitTimeMs: Date.now() - startTime,
+                    timedOut: false,
+                };
+            }
+        }
+        catch (e) {
+            console.error('[waitForPageLoad] page.evaluate failed:', e);
+            return {
+                success: false,
+                readyState: 'error',
+                pendingRequests: ['page.evaluate failed - page may have closed or navigated'],
+                waitTimeMs: Date.now() - startTime,
+                timedOut: false,
+            };
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    timedOut = true;
+    return {
+        success: false,
+        readyState: lastReadyState,
+        pendingRequests: lastPendingRequests.slice(0, 10),
+        waitTimeMs: Date.now() - startTime,
+        timedOut,
+    };
+}
+//# sourceMappingURL=wait-for-page-load.js.map

package/dist/wait-for-page-load.js.map

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

package/package.json

@@ -1,11 +1,20 @@
 {
   "name": "playwriter",
   "description": "",
-  "version": "0.0.16",
+  "version": "0.0.21",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": "https://github.com/remorses/playwriter",
+  "scripts": {
+    "build": "rm -rf dist *.tsbuildinfo && mkdir dist && cp src/resource.md src/prompt.md dist/ && vite-node scripts/download-selector-generator.ts && tsc",
+    "prepublishOnly": "pnpm build",
+    "watch": "tsc -w",
+    "typecheck": "tsc --noEmit",
+    "mcp": "vite-node src/mcp.ts",
+    "test": "vitest run -u",
+    "test:watch": "vitest"
+  },
   "bin": "./bin.js",
   "files": [
     "dist",
@@ -21,10 +30,12 @@
     "@mizchi/selector-generator": "1.50.0-next",
     "@types/chrome": "^0.0.315",
     "@types/node": "^24.10.1",
+    "@types/ws": "^8.18.1",
     "@vitest/ui": "^4.0.8",
+    "image-size": "^2.0.2",
+    "mcp-extension": "workspace:*",
     "vite-node": "^5.0.0",
-    "vitest": "^4.0.8",
-    "mcp-extension": "0.0.52"
+    "vitest": "^4.0.8"
   },
   "dependencies": {
     "@hono/node-server": "^1.19.6",
@@ -38,14 +49,7 @@
     "string-dedent": "^3.0.2",
     "user-agents": "^1.1.669",
     "ws": "^8.18.3",
+    "xdg-basedir": "^5.1.0",
     "zod": "^3"
-  },
-  "scripts": {
-    "build": "rm -rf dist *.tsbuildinfo && mkdir dist && cp src/resource.md src/prompt.md dist/ && tsc",
-    "watch": "tsc -w",
-    "typecheck": "tsc --noEmit",
-    "mcp": "vite-node src/mcp.ts",
-    "test": "vitest run -u",
-    "test:watch": "vitest"
   }
-}
+}

package/src/cdp-session.ts

@@ -0,0 +1,156 @@
+import WebSocket from 'ws'
+import type { Page } from 'playwright-core'
+import type { ProtocolMapping } from 'devtools-protocol/types/protocol-mapping.js'
+import type { CDPResponseBase, CDPEventBase } from './cdp-types.js'
+
+interface PendingRequest {
+  resolve: (result: unknown) => void
+  reject: (error: Error) => void
+}
+
+export class CDPSession {
+  private ws: WebSocket
+  private pendingRequests = new Map<number, PendingRequest>()
+  private eventListeners = new Map<string, Set<(params: unknown) => void>>()
+  private messageId = 0
+  private sessionId: string | null = null
+
+  constructor(ws: WebSocket) {
+    this.ws = ws
+    this.ws.on('message', (data) => {
+      try {
+        const message = JSON.parse(data.toString()) as CDPResponseBase | CDPEventBase
+
+        if ('id' in message) {
+          const response = message as CDPResponseBase
+          const pending = this.pendingRequests.get(response.id)
+          if (pending) {
+            this.pendingRequests.delete(response.id)
+            if (response.error) {
+              pending.reject(new Error(response.error.message))
+            } else {
+              pending.resolve(response.result)
+            }
+          }
+        } else if ('method' in message) {
+          const event = message as CDPEventBase
+          if (event.sessionId === this.sessionId || !event.sessionId) {
+            const listeners = this.eventListeners.get(event.method)
+            if (listeners) {
+              for (const listener of listeners) {
+                listener(event.params)
+              }
+            }
+          }
+        }
+      } catch (e) {
+        console.error('[CDPSession] Message handling error:', e)
+      }
+    })
+  }
+
+  setSessionId(sessionId: string) {
+    this.sessionId = sessionId
+  }
+
+  send<K extends keyof ProtocolMapping.Commands>(
+    method: K,
+    params?: ProtocolMapping.Commands[K]['paramsType'][0],
+  ): Promise<ProtocolMapping.Commands[K]['returnType']> {
+    const id = ++this.messageId
+    const message: Record<string, unknown> = { id, method, params }
+    if (this.sessionId) {
+      message.sessionId = this.sessionId
+    }
+
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.pendingRequests.delete(id)
+        reject(new Error(`CDP command timeout: ${method}`))
+      }, 30000)
+
+      this.pendingRequests.set(id, {
+        resolve: (result) => {
+          clearTimeout(timeout)
+          resolve(result as ProtocolMapping.Commands[K]['returnType'])
+        },
+        reject: (error) => {
+          clearTimeout(timeout)
+          reject(error)
+        },
+      })
+
+      try {
+        this.ws.send(JSON.stringify(message))
+      } catch (error) {
+        clearTimeout(timeout)
+        this.pendingRequests.delete(id)
+        reject(error instanceof Error ? error : new Error(String(error)))
+      }
+    })
+  }
+
+  on<K extends keyof ProtocolMapping.Events>(event: K, callback: (params: ProtocolMapping.Events[K][0]) => void) {
+    if (!this.eventListeners.has(event)) {
+      this.eventListeners.set(event, new Set())
+    }
+    this.eventListeners.get(event)!.add(callback as (params: unknown) => void)
+  }
+
+  off<K extends keyof ProtocolMapping.Events>(event: K, callback: (params: ProtocolMapping.Events[K][0]) => void) {
+    this.eventListeners.get(event)?.delete(callback as (params: unknown) => void)
+  }
+
+  detach() {
+    try {
+      for (const pending of this.pendingRequests.values()) {
+        pending.reject(new Error('CDPSession detached'))
+      }
+      this.pendingRequests.clear()
+      this.eventListeners.clear()
+      this.ws.close()
+    } catch (e) {
+      console.error('[CDPSession] WebSocket close error:', e)
+    }
+  }
+}
+
+export async function getCDPSessionForPage({ page, wsUrl }: { page: Page; wsUrl: string }): Promise<CDPSession> {
+  const ws = new WebSocket(wsUrl)
+
+  await new Promise<void>((resolve, reject) => {
+    ws.on('open', resolve)
+    ws.on('error', reject)
+  })
+
+  const cdp = new CDPSession(ws)
+
+  const pages = page.context().pages()
+  const pageIndex = pages.indexOf(page)
+  if (pageIndex === -1) {
+    cdp.detach()
+    throw new Error('Page not found in context')
+  }
+
+  const { targetInfos } = await cdp.send('Target.getTargets')
+  const pageTargets = targetInfos.filter((t) => t.type === 'page')
+
+  if (pageIndex >= pageTargets.length) {
+    cdp.detach()
+    throw new Error(`Page index ${pageIndex} out of bounds (${pageTargets.length} targets)`)
+  }
+
+  const target = pageTargets[pageIndex]
+  if (target.url !== page.url()) {
+    cdp.detach()
+    throw new Error(`URL mismatch: page has "${page.url()}" but target has "${target.url}"`)
+  }
+
+  const { sessionId } = await cdp.send('Target.attachToTarget', {
+    targetId: target.targetId,
+    flatten: true,
+  })
+  cdp.setSessionId(sessionId)
+
+  return cdp
+}

package/src/cdp-types.ts

@@ -48,6 +48,12 @@ export type CDPEventBase = {
 
 export type CDPMessage = CDPCommand | CDPResponse | CDPEvent;
 
+export type RelayServerEvents = {
+  'cdp:command': (data: { clientId: string; command: CDPCommand }) => void
+  'cdp:event': (data: { event: CDPEventBase; sessionId?: string }) => void
+  'cdp:response': (data: { clientId: string; response: CDPResponseBase; command: CDPCommand }) => void
+}
+
 export { Protocol, ProtocolMapping };
 
 // types tests. to see if types are right with some simple examples

package/src/create-logger.ts

@@ -0,0 +1,56 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import util from 'node:util'
+import { LOG_FILE_PATH } from './utils.js'
+
+export type Logger = {
+  log(...args: unknown[]): Promise<void>
+  error(...args: unknown[]): Promise<void>
+  logFilePath: string
+}
+
+function cleanupOldLogs(logsDir: string): void {
+  if (!fs.existsSync(logsDir)) {
+    return
+  }
+  const files = fs.readdirSync(logsDir)
+    .filter((f) => f.startsWith('relay-server-') && f.endsWith('.log'))
+    .map((f) => ({
+      name: f,
+      path: path.join(logsDir, f),
+      mtime: fs.statSync(path.join(logsDir, f)).mtime.getTime(),
+    }))
+    .sort((a, b) => b.mtime - a.mtime)
+  
+  if (files.length > 10) {
+    files.slice(10).forEach((f) => {
+      fs.unlinkSync(f.path)
+    })
+  }
+}
+
+export function createFileLogger({ logFilePath }: { logFilePath?: string } = {}): Logger {
+  const resolvedLogFilePath = logFilePath || LOG_FILE_PATH
+  const logDir = path.dirname(resolvedLogFilePath)
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true })
+  }
+  cleanupOldLogs(logDir)
+  fs.writeFileSync(resolvedLogFilePath, '')
+
+  let queue: Promise<void> = Promise.resolve()
+
+  const log = (...args: unknown[]): Promise<void> => {
+    const message = args.map(arg =>
+      typeof arg === 'string' ? arg : util.inspect(arg, { depth: null, colors: false })
+    ).join(' ')
+    queue = queue.then(() => fs.promises.appendFile(resolvedLogFilePath, message + '\n'))
+    return queue
+  }
+
+  return {
+    log,
+    error: log,
+    logFilePath: resolvedLogFilePath,
+  }
+}