@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/utils/smart-goto.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Smart Goto - Wraps page.goto() with fast auth redirect detection.
+ *
+ * Instead of waiting 30s for a timeout on auth-redirected pages (e.g. Google Search Console),
+ * detects redirects to known auth domains via `framenavigated` events within milliseconds
+ * and returns useful information in ~2 seconds.
+ */
+import { Page, HTTPResponse } from 'puppeteer-core';
+export interface DomStabilityResult {
+    stable: boolean;
+    elementCount: number;
+    iterations: number;
+}
+/**
+ * Wait for DOM element count to stabilize after initial page load.
+ * SPA frameworks (React, Vue, Angular) render content asynchronously after
+ * domcontentloaded — this heuristic detects when rendering is complete by
+ * monitoring element count changes.
+ *
+ * Zero-cost on static pages (first check passes immediately).
+ * Bounded to maxWaitMs (default 1500ms) total.
+ */
+export declare function waitForDomStability(page: Page, options?: {
+    intervalMs?: number;
+    maxIterations?: number;
+    threshold?: number;
+}): Promise<DomStabilityResult>;
+export interface SmartGotoResult {
+    response: HTTPResponse | null;
+    authRedirect?: {
+        from: string;
+        to: string;
+        host: string;
+    };
+}
+export declare function smartGoto(page: Page, url: string, options?: {
+    timeout?: number;
+}): Promise<SmartGotoResult>;
+//# sourceMappingURL=smart-goto.d.ts.map

package/dist/utils/smart-goto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-goto.d.ts","sourceRoot":"","sources":["../../src/utils/smart-goto.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAS,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAAC,kBAAkB,CAAC,CAmC7B;AAwBD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/utils/smart-goto.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Smart Goto - Wraps page.goto() with fast auth redirect detection.
+ *
+ * Instead of waiting 30s for a timeout on auth-redirected pages (e.g. Google Search Console),
+ * detects redirects to known auth domains via `framenavigated` events within milliseconds
+ * and returns useful information in ~2 seconds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForDomStability = waitForDomStability;
+exports.smartGoto = smartGoto;
+const defaults_1 = require("../config/defaults");
+/**
+ * Wait for DOM element count to stabilize after initial page load.
+ * SPA frameworks (React, Vue, Angular) render content asynchronously after
+ * domcontentloaded — this heuristic detects when rendering is complete by
+ * monitoring element count changes.
+ *
+ * Zero-cost on static pages (first check passes immediately).
+ * Bounded to maxWaitMs (default 1500ms) total.
+ */
+async function waitForDomStability(page, options) {
+    const intervalMs = options?.intervalMs ?? 500;
+    const maxIterations = options?.maxIterations ?? 3;
+    const threshold = options?.threshold ?? 0.2;
+    let previousCount = 0;
+    let iterations = 0;
+    try {
+        previousCount = await page.evaluate(() => document.querySelectorAll('*').length);
+    }
+    catch {
+        return { stable: true, elementCount: 0, iterations: 0 };
+    }
+    for (let i = 0; i < maxIterations; i++) {
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        iterations++;
+        let currentCount = previousCount;
+        try {
+            currentCount = await page.evaluate(() => document.querySelectorAll('*').length);
+        }
+        catch {
+            // Page navigated away or was closed — treat as stable
+            return { stable: true, elementCount: previousCount, iterations };
+        }
+        const delta = Math.abs(currentCount - previousCount) / Math.max(previousCount, 1);
+        if (delta <= threshold) {
+            return { stable: true, elementCount: currentCount, iterations };
+        }
+        previousCount = currentCount;
+    }
+    return { stable: false, elementCount: previousCount, iterations };
+}
+const AUTH_DOMAINS = [
+    'accounts.google.com',
+    'login.microsoftonline.com',
+    'auth0.com',
+    'okta.com',
+    'login.salesforce.com',
+    'appleid.apple.com',
+    'github.com/login',
+    // Supabase
+    'supabase.co/auth',
+    'supabase.com/auth',
+    // Firebase
+    'firebaseapp.com/__/auth',
+    'identitytoolkit.googleapis.com',
+    // Other OAuth providers
+    'cognito-idp.',
+    'login.yahoo.com',
+    'nid.naver.com',
+    'kauth.kakao.com',
+    'access.line.me',
+];
+async function smartGoto(page, url, options) {
+    const timeout = options?.timeout ?? defaults_1.DEFAULT_NAVIGATION_TIMEOUT_MS;
+    let authRedirect = undefined;
+    let resolveRedirect = null;
+    const redirectDetected = new Promise((resolve) => {
+        resolveRedirect = resolve;
+    });
+    const onFrameNavigated = (frame) => {
+        if (frame !== page.mainFrame())
+            return;
+        const currentUrl = frame.url();
+        if (isAuthRedirect(currentUrl, url)) {
+            authRedirect = {
+                from: url,
+                to: currentUrl,
+                host: new URL(currentUrl).hostname,
+            };
+            resolveRedirect?.();
+        }
+    };
+    page.on('framenavigated', onFrameNavigated);
+    try {
+        const response = await Promise.race([
+            page.goto(url, { waitUntil: 'domcontentloaded', timeout }),
+            // When auth redirect detected, wait 1.5s for DOMContentLoaded chance, then return
+            redirectDetected.then(() => new Promise((resolve) => setTimeout(() => resolve(null), 1500))),
+        ]);
+        // Only wait for DOM stability if no auth redirect was detected
+        if (!authRedirect) {
+            const stability = await waitForDomStability(page);
+            // Log if DOM was still changing (useful for debugging SPA issues)
+            if (!stability.stable) {
+                console.error(`[smartGoto] DOM not stable after ${stability.iterations} checks (${stability.elementCount} elements)`);
+            }
+        }
+        return { response, authRedirect };
+    }
+    catch (err) {
+        // If we already detected an auth redirect, return it instead of throwing
+        if (authRedirect)
+            return { response: null, authRedirect };
+        throw err;
+    }
+    finally {
+        page.off('framenavigated', onFrameNavigated);
+    }
+}
+function isAuthRedirect(currentUrl, originalUrl) {
+    try {
+        const current = new URL(currentUrl);
+        const original = new URL(originalUrl);
+        if (current.hostname === original.hostname)
+            return false;
+        return (AUTH_DOMAINS.some((d) => current.hostname.includes(d)) ||
+            /\/(login|signin|sign-in|auth|sso|oauth)/i.test(current.pathname));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=smart-goto.js.map

package/dist/utils/smart-goto.js.map

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

package/dist/utils/url-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Extract the hostname from a URL string. Returns empty string on failure.
+ */
+export declare function extractHostname(url: string): string;
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/utils/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../src/utils/url-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/utils/url-utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHostname = extractHostname;
+/**
+ * Extract the hostname from a URL string. Returns empty string on failure.
+ */
+function extractHostname(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=url-utils.js.map

package/dist/utils/url-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.js","sourceRoot":"","sources":["../../src/utils/url-utils.ts"],"names":[],"mappings":";;AAGA,0CAMC;AATD;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/utils/visual-summary.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Visual Summary - Generates a lightweight text description of visible page state
+ *
+ * After click/navigate actions, extracts enough context (~100-150 tokens) for
+ * LLMs to understand the current page state without requiring follow-up screenshots.
+ */
+import type { Page } from 'puppeteer-core';
+/**
+ * Generate a lightweight text description of the visible page state.
+ *
+ * Extracts URL, title, scroll position, active elements, visible panel content,
+ * headings, and form state — formatted for LLM consumption (~100-200 tokens).
+ *
+ * Returns an empty string on any error (non-blocking, fail-safe).
+ */
+export declare function generateVisualSummary(page: Page): Promise<string>;
+//# sourceMappingURL=visual-summary.d.ts.map

package/dist/utils/visual-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-summary.d.ts","sourceRoot":"","sources":["../../src/utils/visual-summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA+M3C;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAavE"}

package/dist/utils/visual-summary.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Visual Summary - Generates a lightweight text description of visible page state
+ *
+ * After click/navigate actions, extracts enough context (~100-150 tokens) for
+ * LLMs to understand the current page state without requiring follow-up screenshots.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateVisualSummary = generateVisualSummary;
+// Script injected into the page to extract visible state in one evaluate call
+const EXTRACT_STATE_SCRIPT = `(() => {
+  try {
+    // Deep querySelectorAll that pierces open shadow roots
+    function deepQSA(root, sel) {
+      var results = [];
+      try { var m = root.querySelectorAll(sel); for (var i = 0; i < m.length; i++) results.push(m[i]); } catch(e) {}
+      var all = root.querySelectorAll('*');
+      for (var j = 0; j < all.length; j++) {
+        if (all[j].shadowRoot) {
+          var sr = deepQSA(all[j].shadowRoot, sel);
+          for (var k = 0; k < sr.length; k++) results.push(sr[k]);
+        }
+      }
+      return results;
+    }
+
+    const url = location.href;
+    const title = document.title;
+
+    // Scroll position
+    const scrollX = Math.round(window.scrollX);
+    const scrollY = Math.round(window.scrollY);
+    const scrollHeight = document.documentElement.scrollHeight || document.body.scrollHeight || 0;
+    const clientHeight = document.documentElement.clientHeight || window.innerHeight || 0;
+
+    // Active/focused element (follows shadow root chain)
+    let activeEl = null;
+    try {
+      let el = document.activeElement;
+      while (el && el.shadowRoot && el.shadowRoot.activeElement) {
+        el = el.shadowRoot.activeElement;
+      }
+      if (el && el !== document.body && el !== document.documentElement) {
+        const tag = el.tagName.toLowerCase();
+        const label =
+          el.getAttribute('aria-label') ||
+          el.getAttribute('title') ||
+          el.getAttribute('name') ||
+          (el.textContent || '').trim().slice(0, 40);
+        const ariaSelected = el.getAttribute('aria-selected');
+        const ariaCurrent = el.getAttribute('aria-current');
+        const isActive = el.classList.contains('active');
+        activeEl = { tag, label, ariaSelected, ariaCurrent, isActive };
+      }
+    } catch (e) {}
+
+    // Visible scrollable panels (role=tabpanel, [class*=panel], [class*=content], main, article)
+    const panelSelectors = [
+      '[role="tabpanel"]',
+      'main',
+      'article',
+      '[class*="panel"]',
+      '[class*="content"]',
+    ];
+    const panels = [];
+    const seenPanels = new Set();
+    for (const sel of panelSelectors) {
+      if (panels.length >= 3) break;
+      let found;
+      try { found = deepQSA(document, sel); } catch (e) { continue; }
+      for (const el of found) {
+        if (panels.length >= 3) break;
+        if (seenPanels.has(el)) continue;
+        const rect = el.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0) continue;
+        if (rect.bottom < 0 || rect.top > window.innerHeight) continue;
+        const text = (el.textContent || '').trim().replace(/\\s+/g, ' ').slice(0, 100);
+        if (!text) continue;
+        seenPanels.add(el);
+        panels.push(text);
+      }
+    }
+
+    // Active tab/button states (aria-selected, aria-current, .active)
+    const activeStates = [];
+    try {
+      const candidates = deepQSA(document,
+        '[aria-selected="true"], [aria-current], .active, [class*="tab--active"], [class*="tab-active"]'
+      );
+      for (const el of candidates) {
+        if (activeStates.length >= 5) break;
+        const rect = el.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0) continue;
+        const tag = el.tagName.toLowerCase();
+        const text = (el.textContent || '').trim().slice(0, 40);
+        const ariaSelected = el.getAttribute('aria-selected');
+        const ariaCurrent = el.getAttribute('aria-current');
+        const qualifier = ariaSelected === 'true' ? 'aria-selected' : ariaCurrent ? 'aria-current' : 'active';
+        if (text) activeStates.push({ tag, text, qualifier });
+      }
+    } catch (e) {}
+
+    // Visible form state (inputs, selects, checkboxes)
+    const formState = [];
+    try {
+      const inputs = deepQSA(document, 'input:not([type="hidden"]), select, textarea');
+      for (const el of inputs) {
+        if (formState.length >= 5) break;
+        const rect = el.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0) continue;
+        if (rect.bottom < 0 || rect.top > window.innerHeight) continue;
+        const tag = el.tagName.toLowerCase();
+        const type = el.getAttribute('type') || tag;
+        const name = el.getAttribute('name') || el.getAttribute('aria-label') || el.getAttribute('placeholder') || '';
+        if (type === 'checkbox' || type === 'radio') {
+          formState.push({ type, name, checked: el.checked });
+        } else if (tag === 'select') {
+          const opt = el.options[el.selectedIndex];
+          const val = opt ? (opt.text || opt.value).slice(0, 30) : '';
+          if (val) formState.push({ type: 'select', name, value: val });
+        } else {
+          const val = (el.value || '').slice(0, 40);
+          if (val) formState.push({ type, name, value: val });
+        }
+      }
+    } catch (e) {}
+
+    // Visible headings for section context
+    const headings = [];
+    try {
+      const hEls = deepQSA(document, 'h1, h2, h3, h4');
+      for (const el of hEls) {
+        if (headings.length >= 4) break;
+        const rect = el.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0) continue;
+        if (rect.bottom < 0 || rect.top > window.innerHeight) continue;
+        const tag = el.tagName.toLowerCase();
+        const text = (el.textContent || '').trim().slice(0, 50);
+        if (text) headings.push({ tag, text });
+      }
+    } catch (e) {}
+
+    return { url, title, scrollX, scrollY, scrollHeight, clientHeight, panels, activeStates, formState, headings, activeEl };
+  } catch (e) {
+    return null;
+  }
+})()`;
+/**
+ * Format extracted page state into a compact multi-line string.
+ */
+function formatPageState(state) {
+    const lines = [];
+    // Line 1: URL, title, scroll position
+    const scrollPct = state.scrollHeight > 0
+        ? Math.round((state.scrollY / (state.scrollHeight - state.clientHeight || state.scrollHeight)) * 100)
+        : 0;
+    const titleShort = state.title.slice(0, 60);
+    lines.push(`[Page State] url: ${state.url} | title: "${titleShort}" | scroll: ${state.scrollY}/${state.scrollHeight} (${scrollPct}%)`);
+    // Active focused element (deduplicated with activeStates)
+    if (state.activeEl) {
+        const { tag, label, ariaSelected, ariaCurrent, isActive } = state.activeEl;
+        const qualifier = ariaSelected === 'true' ? ' (aria-selected)' : ariaCurrent ? ' (aria-current)' : isActive ? ' (active)' : '';
+        if (label)
+            lines.push(`[Active] ${tag} "${label}"${qualifier}`);
+    }
+    // Active tab/button states
+    if (state.activeStates.length > 0) {
+        const parts = state.activeStates.map(s => `${s.tag} "${s.text}" (${s.qualifier})`);
+        lines.push(`[Selected] ${parts.join(' | ')}`);
+    }
+    // Visible panels
+    if (state.panels.length > 0) {
+        const parts = state.panels.map((p, i) => `Panel ${i + 1}: "${p}"`);
+        lines.push(`[Visible] ${parts.join(' | ')}`);
+    }
+    // Headings
+    if (state.headings.length > 0) {
+        const parts = state.headings.map(h => `${h.tag}: "${h.text}"`);
+        lines.push(`[Headings] ${parts.join(' | ')}`);
+    }
+    // Form state
+    if (state.formState.length > 0) {
+        const parts = state.formState.map(f => {
+            if (f.type === 'checkbox' || f.type === 'radio') {
+                return `${f.name || f.type}=${f.checked ? 'checked' : 'unchecked'}`;
+            }
+            return `${f.name || f.type}="${f.value}"`;
+        });
+        lines.push(`[Form] ${parts.join(' | ')}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a lightweight text description of the visible page state.
+ *
+ * Extracts URL, title, scroll position, active elements, visible panel content,
+ * headings, and form state — formatted for LLM consumption (~100-200 tokens).
+ *
+ * Returns an empty string on any error (non-blocking, fail-safe).
+ */
+async function generateVisualSummary(page) {
+    try {
+        const state = await Promise.race([
+            page.evaluate(EXTRACT_STATE_SCRIPT),
+            new Promise((resolve) => setTimeout(() => resolve(null), 3000)),
+        ]);
+        if (!state)
+            return '';
+        return formatPageState(state);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=visual-summary.js.map

package/dist/utils/visual-summary.js.map

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

package/dist/utils/with-timeout.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Race a promise against a timeout. Rejects with an OpenChromeTimeoutError if the timeout fires first.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label?: string): Promise<T>;
+//# sourceMappingURL=with-timeout.d.ts.map

package/dist/utils/with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.d.ts","sourceRoot":"","sources":["../../src/utils/with-timeout.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,SAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAM/F"}

package/dist/utils/with-timeout.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTimeout = withTimeout;
+const timeout_1 = require("../errors/timeout");
+/**
+ * Race a promise against a timeout. Rejects with an OpenChromeTimeoutError if the timeout fires first.
+ */
+function withTimeout(promise, ms, label = 'Operation') {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new timeout_1.OpenChromeTimeoutError(label, ms)), ms);
+    });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
+//# sourceMappingURL=with-timeout.js.map

package/dist/utils/with-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.js","sourceRoot":"","sources":["../../src/utils/with-timeout.ts"],"names":[],"mappings":";;AAKA,kCAMC;AAXD,+CAA2D;AAE3D;;GAEG;AACH,SAAgB,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,KAAK,GAAG,WAAW;IACjF,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gCAAsB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Version utility - reads version from package.json to avoid hardcoded strings
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,UAAU,IAAI,MAAM,CAUnC"}

package/dist/version.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Version utility - reads version from package.json to avoid hardcoded strings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+let _version = null;
+function getVersion() {
+    if (!_version) {
+        try {
+            const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf8'));
+            _version = pkg.version;
+        }
+        catch {
+            _version = 'unknown';
+        }
+    }
+    return _version;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,gCAUC;AAfD,2BAAkC;AAClC,+BAA4B;AAE5B,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC,SAAgB,UAAU;IACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACpF,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,QAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1 @@
+{"name": "@iflow-mcp/shaun0927-openchrome", "version": "1.7.13", "description": "Open-source browser automation MCP server. Control your real Chrome from any AI agent.", "main": "dist/index.js", "bin": {"iflow-mcp-shaun0927-openchrome": "./dist/cli/index.js"}, "scripts": {"build": "tsc -p tsconfig.cli.json && tsc -p tsconfig.json", "build:cli": "tsc -p tsconfig.cli.json", "build:src": "tsc -p tsconfig.json", "dev": "tsc -p tsconfig.cli.json --watch", "start": "node dist/cli/index.js serve", "check": "node dist/cli/index.js check", "benchmark": "ts-node tests/benchmark/run.ts", "benchmark:ci": "ts-node tests/benchmark/run.ts --ci", "test": "jest", "test:coverage": "jest --coverage", "lint": "eslint src --ext .ts", "clean": "rimraf dist", "prepare": "npm run build"}, "keywords": ["openchrome", "mcp", "mcp-server", "browser-automation", "parallel-sessions", "cdp", "chrome", "chrome-devtools-protocol", "ai-agent", "puppeteer"], "author": "shaun0927", "license": "MIT", "repository": {"type": "git", "url": "git+https://github.com/shaun0927/openchrome.git"}, "bugs": {"url": "https://github.com/shaun0927/openchrome/issues"}, "homepage": "https://github.com/shaun0927/openchrome#readme", "devDependencies": {"@types/chrome": "^0.1.36", "@types/jest": "^29.5.0", "@types/node": "^20.0.0", "@types/proper-lockfile": "^4.1.4", "@types/uuid": "^9.0.8", "@types/write-file-atomic": "^4.0.3", "@typescript-eslint/eslint-plugin": "^7.0.0", "@typescript-eslint/parser": "^7.0.0", "eslint": "^8.57.0", "jest": "^29.7.0", "rimraf": "^5.0.0", "ts-jest": "^29.1.0", "ts-node": "^10.9.2", "typescript": "^5.4.0"}, "dependencies": {"commander": "^12.0.0", "proper-lockfile": "^4.1.2", "puppeteer-core": "^23.11.1", "uuid": "^9.0.0", "write-file-atomic": "^5.0.1"}, "engines": {"node": ">=18.0.0"}, "files": ["dist", "assets", "README.md", "LICENSE"]}