@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/utils/page-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-diagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/page-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,aAAa,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC7E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA6CjF"}

package/dist/utils/page-diagnostics.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPageDiagnostics = getPageDiagnostics;
+exports.detectBlockingPage = detectBlockingPage;
+/**
+ * Get basic page diagnostics for failure reporting.
+ * Lightweight - single evaluate call.
+ */
+async function getPageDiagnostics(page) {
+    try {
+        return await page.evaluate(() => {
+            let framework = null;
+            if (document.querySelector('[data-reactroot], #__next, #root[data-reactroot]'))
+                framework = 'react';
+            else if (document.querySelector('[data-v-], #app[data-v-]'))
+                framework = 'vue';
+            else if (document.querySelector('[ng-version], [_nghost]'))
+                framework = 'angular';
+            // Count elements including those inside open shadow roots
+            function deepElementCount(root) {
+                let count = root.querySelectorAll('*').length;
+                const allEls = root.querySelectorAll('*');
+                for (let i = 0; i < allEls.length; i++) {
+                    if (allEls[i].shadowRoot) {
+                        count += deepElementCount(allEls[i].shadowRoot);
+                    }
+                }
+                return count;
+            }
+            return {
+                url: location.href,
+                readyState: document.readyState,
+                totalElements: deepElementCount(document),
+                framework,
+                title: document.title.substring(0, 100),
+            };
+        });
+    }
+    catch {
+        return {
+            url: 'unknown',
+            readyState: 'unknown',
+            totalElements: 0,
+            framework: null,
+            title: 'unknown',
+        };
+    }
+}
+/**
+ * Detect if the page is showing a blocking verification/captcha/access-denied page.
+ * Returns null if page appears normal.
+ */
+async function detectBlockingPage(page) {
+    try {
+        return await page.evaluate(() => {
+            const title = document.title.toLowerCase();
+            const bodyText = document.body?.innerText?.substring(0, 1000).toLowerCase() || '';
+            // CAPTCHA detection (includes Cloudflare Turnstile)
+            if (bodyText.includes('captcha') ||
+                bodyText.includes('recaptcha') ||
+                document.querySelector('iframe[src*="captcha"], iframe[src*="recaptcha"], iframe[src*="challenges.cloudflare.com"], .g-recaptcha, .h-captcha, .cf-turnstile')) {
+                return { type: 'captcha', detail: document.title };
+            }
+            // Bot verification
+            if (bodyText.includes('verify you are human') ||
+                bodyText.includes('are you a robot') ||
+                bodyText.includes('bot protection') ||
+                bodyText.includes('automated access') ||
+                bodyText.includes('please verify') ||
+                title.includes('robot check') ||
+                title.includes('security check') ||
+                title.includes('just a moment')) { // Cloudflare
+                return { type: 'bot-check', detail: document.title };
+            }
+            // Access denied
+            if (title.includes('access denied') ||
+                title.includes('403 forbidden') ||
+                title.includes('forbidden') ||
+                (bodyText.includes('access denied') && bodyText.length < 500)) {
+                return { type: 'access-denied', detail: document.title };
+            }
+            // JS required
+            if (bodyText.includes('please enable javascript') ||
+                bodyText.includes('javascript is required') ||
+                bodyText.includes('this site requires javascript')) {
+                return { type: 'js-required', detail: 'Page requires JavaScript' };
+            }
+            return null;
+        });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=page-diagnostics.js.map

package/dist/utils/page-diagnostics.js.map

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

package/dist/utils/pagination-detector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pagination Detector - Detects pagination patterns in browser pages.
+ *
+ * Runs DOM inspection via page.evaluate() and returns a structured
+ * PaginationInfo describing the type of pagination and suggested strategy.
+ */
+import type { Page } from 'puppeteer-core';
+export interface PaginationInfo {
+    type: 'numbered' | 'next_button' | 'load_more' | 'infinite_scroll' | 'cursor' | 'viewer' | 'none';
+    hasNext: boolean;
+    hasPrev: boolean;
+    currentPage?: number;
+    totalPages?: number;
+    nextAction?: {
+        tool: string;
+        args: Record<string, unknown>;
+    };
+    urlPattern?: string;
+    suggestedStrategy: string;
+}
+export declare function detectPagination(page: Page, tabId: string): Promise<PaginationInfo>;
+//# sourceMappingURL=pagination-detector.d.ts.map

package/dist/utils/pagination-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-detector.d.ts","sourceRoot":"","sources":["../../src/utils/pagination-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClG,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA0UzF"}

package/dist/utils/pagination-detector.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * Pagination Detector - Detects pagination patterns in browser pages.
+ *
+ * Runs DOM inspection via page.evaluate() and returns a structured
+ * PaginationInfo describing the type of pagination and suggested strategy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPagination = detectPagination;
+async function detectPagination(page, tabId) {
+    try {
+        const result = await page.evaluate(() => {
+            // ---------------------------------------------------------------
+            // 1. PDF/Slide Viewer detection
+            // ---------------------------------------------------------------
+            const hasViewerContainer = !!document.querySelector('#viewerContainer') ||
+                !!document.querySelector('.pdfViewer') ||
+                !!document.querySelector('[data-page-number]');
+            const canvasInPage = !!document.querySelector('.page canvas') ||
+                !!document.querySelector('[id^="page"] canvas') ||
+                !!document.querySelector('canvas[aria-label]');
+            // Page count text patterns: "Page X of Y", "X / Y", "X/Y"
+            const bodyText = document.body.innerText || '';
+            const pageCountMatch = bodyText.match(/[Pp]age\s+(\d+)\s+of\s+(\d+)/) ||
+                bodyText.match(/(\d+)\s*\/\s*(\d+)/) ||
+                null;
+            // Slide presentation viewers
+            const hasRevealJs = !!window.Reveal;
+            const hasGoogleSlides = !!document.querySelector('.punch-present-iframe, [data-slide-id]');
+            const hasFeatpaper = !!document.querySelector('[class*="featpaper"], [class*="slideshare"]');
+            if (hasViewerContainer || canvasInPage || hasRevealJs || hasGoogleSlides || hasFeatpaper) {
+                let currentPage;
+                let totalPages;
+                if (pageCountMatch) {
+                    currentPage = parseInt(pageCountMatch[1], 10);
+                    totalPages = parseInt(pageCountMatch[2], 10);
+                }
+                else {
+                    // Try numeric inputs used in PDF viewers
+                    const pageInput = document.querySelector('input[id*="page"], input[aria-label*="page" i], input[aria-label*="Page" i]');
+                    if (pageInput) {
+                        const val = parseInt(pageInput.value, 10);
+                        if (!isNaN(val))
+                            currentPage = val;
+                    }
+                    // Total pages from span patterns
+                    const totalEl = document.querySelector('#numPages, [id*="numPages"], [class*="numPages"], [class*="total-pages"]');
+                    if (totalEl && totalEl.textContent) {
+                        const n = parseInt(totalEl.textContent.replace(/\D/g, ''), 10);
+                        if (!isNaN(n) && n > 0)
+                            totalPages = n;
+                    }
+                }
+                const hasNext = totalPages === undefined || (currentPage !== undefined && currentPage < totalPages);
+                const hasPrev = currentPage !== undefined && currentPage > 1;
+                return {
+                    type: 'viewer',
+                    hasNext,
+                    hasPrev,
+                    currentPage,
+                    totalPages,
+                };
+            }
+            // ---------------------------------------------------------------
+            // 2. Numbered pagination
+            // ---------------------------------------------------------------
+            const paginationContainer = document.querySelector('.pagination') ||
+                document.querySelector('[role="navigation"][aria-label*="page" i]') ||
+                document.querySelector('[role="navigation"][aria-label*="pagination" i]') ||
+                document.querySelector('nav.pagination') ||
+                document.querySelector('[class*="pagination"]');
+            if (paginationContainer) {
+                const links = Array.from(paginationContainer.querySelectorAll('a, button'));
+                const pageNumbers = links
+                    .map((el) => parseInt((el.textContent || '').trim(), 10))
+                    .filter((n) => !isNaN(n) && n > 0);
+                const isSequential = pageNumbers.length >= 2 &&
+                    pageNumbers.every((n, i) => i === 0 || n === pageNumbers[i - 1] + 1);
+                if (isSequential || pageNumbers.length >= 3) {
+                    // Try to find current page
+                    const activeEl = paginationContainer.querySelector('[aria-current="page"]') ||
+                        paginationContainer.querySelector('.active') ||
+                        paginationContainer.querySelector('[class*="current"]') ||
+                        paginationContainer.querySelector('[class*="active"]');
+                    let currentPage;
+                    if (activeEl) {
+                        const n = parseInt((activeEl.textContent || '').trim(), 10);
+                        if (!isNaN(n))
+                            currentPage = n;
+                    }
+                    const totalPages = pageNumbers.length > 0 ? Math.max(...pageNumbers) : undefined;
+                    const hasNext = currentPage !== undefined && totalPages !== undefined
+                        ? currentPage < totalPages
+                        : true;
+                    const hasPrev = currentPage !== undefined ? currentPage > 1 : false;
+                    // URL pattern detection
+                    const url = window.location.href;
+                    let urlPattern;
+                    let urlTemplate;
+                    const pageParamMatch = url.match(/[?&]page=(\d+)/);
+                    const offsetParamMatch = url.match(/[?&]offset=(\d+)/);
+                    const pathPageMatch = url.match(/\/page\/(\d+)/);
+                    if (pageParamMatch) {
+                        urlPattern = '?page=N';
+                        urlTemplate = url.replace(/([?&]page=)\d+/, '$1{page}');
+                    }
+                    else if (offsetParamMatch) {
+                        urlPattern = '?offset=N';
+                        urlTemplate = url.replace(/([?&]offset=)\d+/, '$1{offset}');
+                    }
+                    else if (pathPageMatch) {
+                        urlPattern = '/page/N';
+                        urlTemplate = url.replace(/\/page\/\d+/, '/page/{page}');
+                    }
+                    return {
+                        type: 'numbered',
+                        hasNext,
+                        hasPrev,
+                        currentPage,
+                        totalPages,
+                        urlPattern,
+                        urlTemplate,
+                    };
+                }
+            }
+            // ---------------------------------------------------------------
+            // 3. Next/Prev button detection
+            // ---------------------------------------------------------------
+            const nextButtonSelectors = [
+                '[aria-label*="next" i]',
+                '[rel="next"]',
+                '.next-page',
+                '.next',
+                '[class*="next-page"]',
+                '[class*="nextPage"]',
+                '[class*="btn-next"]',
+            ];
+            let nextSelector;
+            for (const sel of nextButtonSelectors) {
+                const el = document.querySelector(sel);
+                if (el && el.offsetParent !== null) {
+                    // Visible element
+                    const tag = el.tagName.toLowerCase();
+                    const classes = Array.from(el.classList).slice(0, 2).join('.');
+                    nextSelector = classes ? `${tag}.${classes}` : sel;
+                    break;
+                }
+            }
+            // Also check buttons with "next" text
+            if (!nextSelector) {
+                const buttons = Array.from(document.querySelectorAll('button, a'));
+                for (const btn of buttons) {
+                    const text = (btn.textContent || '').trim().toLowerCase();
+                    if (text === 'next' || text === 'next page' || text === '›' || text === '»' || text === '>') {
+                        const tag = btn.tagName.toLowerCase();
+                        const classes = Array.from(btn.classList).slice(0, 2).join('.');
+                        nextSelector = classes ? `${tag}.${classes}` : tag;
+                        break;
+                    }
+                }
+            }
+            if (nextSelector) {
+                // Check for prev
+                const prevExists = !!document.querySelector('[aria-label*="prev" i]') ||
+                    !!document.querySelector('[rel="prev"]') ||
+                    !!document.querySelector('.prev-page') ||
+                    !!document.querySelector('.prev') ||
+                    !!document.querySelector('[class*="prev-page"]');
+                return {
+                    type: 'next_button',
+                    hasNext: true,
+                    hasPrev: prevExists,
+                    nextSelector,
+                };
+            }
+            // ---------------------------------------------------------------
+            // 4. Load More button detection
+            // ---------------------------------------------------------------
+            const loadMorePhrases = ['load more', 'show more', 'see more', '더 보기', 'load more results', 'view more'];
+            const allButtons = Array.from(document.querySelectorAll('button, a, [role="button"]'));
+            let loadMoreSelector;
+            for (const btn of allButtons) {
+                const text = (btn.textContent || '').trim().toLowerCase();
+                if (loadMorePhrases.some((phrase) => text === phrase || text.startsWith(phrase))) {
+                    const tag = btn.tagName.toLowerCase();
+                    const classes = Array.from(btn.classList).slice(0, 2).join('.');
+                    loadMoreSelector = classes ? `${tag}.${classes}` : tag;
+                    break;
+                }
+            }
+            if (loadMoreSelector) {
+                return {
+                    type: 'load_more',
+                    hasNext: true,
+                    hasPrev: false,
+                    nextSelector: loadMoreSelector,
+                };
+            }
+            // ---------------------------------------------------------------
+            // 5. Infinite scroll detection
+            // ---------------------------------------------------------------
+            const isScrollable = document.body.scrollHeight > 1.5 * window.innerHeight;
+            const hasSentinel = !!document.querySelector('[class*="sentinel"]') ||
+                !!document.querySelector('[class*="infinite"]') ||
+                !!document.querySelector('[data-infinite]') ||
+                !!document.querySelector('[class*="load-trigger"]');
+            if (isScrollable && (hasSentinel || document.body.scrollHeight > 2 * window.innerHeight)) {
+                return {
+                    type: 'infinite_scroll',
+                    hasNext: true,
+                    hasPrev: false,
+                };
+            }
+            // ---------------------------------------------------------------
+            // 6. None / fallback
+            // ---------------------------------------------------------------
+            return {
+                type: 'none',
+                hasNext: false,
+                hasPrev: false,
+            };
+        });
+        // Build the final PaginationInfo with nextAction and suggestedStrategy
+        const info = {
+            type: result.type,
+            hasNext: result.hasNext,
+            hasPrev: result.hasPrev,
+            currentPage: result.currentPage,
+            totalPages: result.totalPages,
+            urlPattern: result.urlPattern,
+            suggestedStrategy: '',
+        };
+        switch (result.type) {
+            case 'viewer': {
+                const n = result.totalPages;
+                if (n !== undefined) {
+                    info.suggestedStrategy = `This is a paginated viewer with ${n} pages. Use batch_paginate(strategy='keyboard', totalPages=${n}) to extract all pages in a single call.`;
+                }
+                else {
+                    info.suggestedStrategy = "This is a paginated viewer. Use batch_paginate(strategy='keyboard') to extract all pages via keyboard navigation.";
+                }
+                info.nextAction = { tool: 'computer', args: { action: 'key', text: 'ArrowRight' } };
+                break;
+            }
+            case 'numbered': {
+                if (result.urlPattern && result.urlTemplate && result.totalPages) {
+                    info.suggestedStrategy = `URL pagination detected (${result.urlPattern}). Use batch_paginate(strategy='url', urlTemplate='${result.urlTemplate}', totalPages=${result.totalPages}) for parallel extraction.`;
+                }
+                else if (result.totalPages) {
+                    info.suggestedStrategy = `Numbered pagination detected with ${result.totalPages} pages. Use batch_paginate(strategy='click') to iterate through all pages.`;
+                }
+                else {
+                    info.suggestedStrategy = "Numbered pagination detected. Use batch_paginate(strategy='click') to iterate through pages.";
+                }
+                break;
+            }
+            case 'next_button': {
+                const sel = result.nextSelector ?? '[aria-label*="next" i]';
+                info.suggestedStrategy = `Next button detected. Use batch_paginate(strategy='click', nextSelector='${sel}') for server-side bulk extraction.`;
+                info.nextAction = { tool: 'click', args: { selector: sel } };
+                break;
+            }
+            case 'load_more': {
+                const sel = result.nextSelector ?? 'button';
+                info.suggestedStrategy = `'Load more' button found. Use batch_paginate(strategy='click', nextSelector='${sel}') for bulk extraction.`;
+                info.nextAction = { tool: 'click', args: { selector: sel } };
+                break;
+            }
+            case 'infinite_scroll': {
+                info.suggestedStrategy = "Infinite scroll detected. Use batch_paginate(strategy='scroll') to auto-scroll and extract all content.";
+                break;
+            }
+            case 'cursor':
+            case 'none':
+            default: {
+                info.suggestedStrategy = 'No pagination detected. All content is available on the current page.';
+                break;
+            }
+        }
+        return info;
+    }
+    catch {
+        // Detection failures are non-fatal — return none
+        return {
+            type: 'none',
+            hasNext: false,
+            hasPrev: false,
+            suggestedStrategy: 'Pagination detection failed.',
+        };
+    }
+}
+//# sourceMappingURL=pagination-detector.js.map

package/dist/utils/pagination-detector.js.map

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

package/dist/utils/pid-manager.d.ts

@@ -0,0 +1,6 @@
+export declare function getPidFilePath(port: number): string;
+export declare function cleanStalePids(port: number): number;
+export declare function writePidFile(port: number): void;
+export declare function removePidFile(port: number): void;
+export declare function listActivePids(port: number): number[];
+//# sourceMappingURL=pid-manager.d.ts.map

package/dist/utils/pid-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-manager.d.ts","sourceRoot":"","sources":["../../src/utils/pid-manager.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAqCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAU/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiBhD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGrD"}

package/dist/utils/pid-manager.js

@@ -0,0 +1,135 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPidFilePath = getPidFilePath;
+exports.cleanStalePids = cleanStalePids;
+exports.writePidFile = writePidFile;
+exports.removePidFile = removePidFile;
+exports.listActivePids = listActivePids;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const LOG_PREFIX = "[openchrome:pid]";
+function getPidFilePath(port) {
+    return path.join(os.tmpdir(), `openchrome-${port}.pid`);
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM = process exists but we lack permission to signal it (common on Windows)
+        if (err.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+function readPids(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf8");
+        return content.split("\n").map(l => l.trim()).filter(l => l.length > 0).map(l => parseInt(l, 10)).filter(p => !isNaN(p) && p > 0);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            console.error(`${LOG_PREFIX} Failed to read PID file at ${filePath}:`, err);
+        }
+        return [];
+    }
+}
+function writePids(filePath, pids) {
+    const tmpPath = `${filePath}.${process.pid}.tmp`;
+    const content = pids.join("\n") + (pids.length > 0 ? "\n" : "");
+    try {
+        fs.writeFileSync(tmpPath, content, { encoding: "utf8", flag: "w" });
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (err) {
+        console.error(`${LOG_PREFIX} Failed to write PID file at ${filePath}:`, err);
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { /* ignore */ }
+    }
+}
+function cleanStalePids(port) {
+    const filePath = getPidFilePath(port);
+    const pids = readPids(filePath);
+    if (pids.length === 0)
+        return 0;
+    const alivePids = pids.filter(pid => isPidAlive(pid));
+    const removedCount = pids.length - alivePids.length;
+    if (removedCount > 0) {
+        console.error(`${LOG_PREFIX} Cleaning ${removedCount} stale PID(s) from ${filePath}`);
+        writePids(filePath, alivePids);
+    }
+    return removedCount;
+}
+function writePidFile(port) {
+    const filePath = getPidFilePath(port);
+    cleanStalePids(port);
+    const pids = readPids(filePath);
+    if (!pids.includes(process.pid)) {
+        pids.push(process.pid);
+        writePids(filePath, pids);
+        console.error(`${LOG_PREFIX} Registered PID ${process.pid} in ${filePath}`);
+    }
+    process.once("exit", () => { removePidFile(port); });
+}
+function removePidFile(port) {
+    const filePath = getPidFilePath(port);
+    const pids = readPids(filePath);
+    const remaining = pids.filter(pid => pid !== process.pid);
+    if (remaining.length === 0) {
+        try {
+            fs.unlinkSync(filePath);
+            console.error(`${LOG_PREFIX} Removed PID file ${filePath} (no active PIDs remain)`);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT") {
+                console.error(`${LOG_PREFIX} Failed to delete PID file at ${filePath}:`, err);
+            }
+        }
+    }
+    else {
+        writePids(filePath, remaining);
+        console.error(`${LOG_PREFIX} Deregistered PID ${process.pid} from ${filePath}`);
+    }
+}
+function listActivePids(port) {
+    const filePath = getPidFilePath(port);
+    return readPids(filePath).filter(pid => isPidAlive(pid));
+}
+//# sourceMappingURL=pid-manager.js.map

package/dist/utils/pid-manager.js.map

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

package/dist/utils/puppeteer-helpers.d.ts

@@ -0,0 +1,8 @@
+import type { Target } from 'puppeteer-core';
+/**
+ * Extract the internal CDP target ID from a Puppeteer Target.
+ * Uses an internal property — centralized here so there is only one place to update
+ * if Puppeteer changes the internal API.
+ */
+export declare function getTargetId(target: Target): string;
+//# sourceMappingURL=puppeteer-helpers.d.ts.map

package/dist/utils/puppeteer-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/puppeteer-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/utils/puppeteer-helpers.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTargetId = getTargetId;
+/**
+ * Extract the internal CDP target ID from a Puppeteer Target.
+ * Uses an internal property — centralized here so there is only one place to update
+ * if Puppeteer changes the internal API.
+ */
+function getTargetId(target) {
+    return target._targetId;
+}
+//# sourceMappingURL=puppeteer-helpers.js.map

package/dist/utils/puppeteer-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-helpers.js","sourceRoot":"","sources":["../../src/utils/puppeteer-helpers.ts"],"names":[],"mappings":";;AAOA,kCAEC;AAPD;;;;GAIG;AACH,SAAgB,WAAW,CAAC,MAAc;IACxC,OAAQ,MAA2C,CAAC,SAAS,CAAC;AAChE,CAAC"}