@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/utils/atomic-file.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Atomic file operations for safe concurrent access
+ * Prevents race conditions when multiple processes access the same file
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFileAtomicSafe = writeFileAtomicSafe;
+exports.readFileSafe = readFileSafe;
+exports.backupFile = backupFile;
+exports.restoreFromBackup = restoreFromBackup;
+exports.listBackups = listBackups;
+exports.cleanupBackups = cleanupBackups;
+exports.acquireLock = acquireLock;
+exports.isLocked = isLocked;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const write_file_atomic_1 = __importDefault(require("write-file-atomic"));
+const lockfile = __importStar(require("proper-lockfile"));
+/**
+ * Write file atomically using temp file + rename pattern
+ * This ensures the file is never in a partial/corrupt state
+ */
+async function writeFileAtomicSafe(filePath, data, options = {}) {
+    const { backup = false, lockTimeout = 10000 } = options;
+    const content = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    // Ensure directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Create backup if requested and file exists
+    if (backup && fs.existsSync(filePath)) {
+        await backupFile(filePath);
+    }
+    // Use write-file-atomic for safe writing
+    await (0, write_file_atomic_1.default)(filePath, content, { encoding: 'utf8' });
+}
+/**
+ * Read file safely with JSON validation
+ */
+async function readFileSafe(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { success: false, error: 'File does not exist' };
+        }
+        const content = fs.readFileSync(filePath, 'utf8');
+        // Try to parse as JSON
+        try {
+            const data = JSON.parse(content);
+            return { success: true, data };
+        }
+        catch (parseError) {
+            // Check if it's a corruption pattern (two JSON objects concatenated)
+            if (content.includes('}{')) {
+                return {
+                    success: false,
+                    error: 'JSON parse error - corruption detected',
+                    corrupted: true,
+                };
+            }
+            return {
+                success: false,
+                error: `JSON parse error: ${parseError.message}`,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Read error: ${error.message}`,
+        };
+    }
+}
+/**
+ * Create a backup of a file
+ */
+async function backupFile(filePath, backupDir) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File does not exist: ${filePath}`);
+    }
+    // Default backup directory
+    const defaultBackupDir = path.join(os.homedir(), '.openchrome', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    // Ensure backup directory exists
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // Generate backup filename with timestamp
+    const basename = path.basename(filePath);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupName = `${basename}.${timestamp}.bak`;
+    const backupPath = path.join(targetDir, backupName);
+    // Copy file to backup location
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+/**
+ * Restore a file from backup
+ */
+async function restoreFromBackup(backupPath, targetPath) {
+    if (!fs.existsSync(backupPath)) {
+        throw new Error(`Backup file does not exist: ${backupPath}`);
+    }
+    // Ensure target directory exists
+    const targetDir = path.dirname(targetPath);
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // Use atomic write to restore
+    const content = fs.readFileSync(backupPath, 'utf8');
+    await writeFileAtomicSafe(targetPath, content);
+}
+/**
+ * Get list of available backups for a file
+ */
+function listBackups(originalFilename, backupDir) {
+    const defaultBackupDir = path.join(os.homedir(), '.openchrome', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    if (!fs.existsSync(targetDir)) {
+        return [];
+    }
+    const basename = path.basename(originalFilename);
+    const pattern = new RegExp(`^${basename.replace(/\./g, '\\.')}\\..*\\.bak$`);
+    return fs
+        .readdirSync(targetDir)
+        .filter((file) => pattern.test(file))
+        .sort()
+        .reverse(); // Most recent first
+}
+/**
+ * Clean up old backups, keeping only the specified number
+ */
+function cleanupBackups(originalFilename, keepCount = 5, backupDir) {
+    const backups = listBackups(originalFilename, backupDir);
+    const toDelete = backups.slice(keepCount);
+    const defaultBackupDir = path.join(os.homedir(), '.openchrome', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    for (const backup of toDelete) {
+        const backupPath = path.join(targetDir, backup);
+        try {
+            fs.unlinkSync(backupPath);
+        }
+        catch {
+            // Ignore deletion errors
+        }
+    }
+    return toDelete.length;
+}
+/**
+ * Acquire a file lock with timeout
+ */
+async function acquireLock(filePath, timeout = 10000) {
+    // Ensure file exists for locking
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, '{}');
+    }
+    const release = await lockfile.lock(filePath, {
+        retries: {
+            retries: Math.ceil(timeout / 100),
+            factor: 1,
+            minTimeout: 100,
+            maxTimeout: 100,
+        },
+    });
+    return release;
+}
+/**
+ * Check if a file is currently locked
+ */
+async function isLocked(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    return lockfile.check(filePath);
+}
+//# sourceMappingURL=atomic-file.js.map

package/dist/utils/atomic-file.js.map

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

package/dist/utils/dom-delta.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DOM Delta Feedback - Captures what changed in the DOM after an action
+ *
+ * Injects a MutationObserver before an action, collects mutations after,
+ * and formats a compact delta string that tells the LLM what happened
+ * without needing a screenshot.
+ */
+import type { Page } from 'puppeteer-core';
+export interface DomDeltaOptions {
+    /**
+     * Time to wait for DOM to settle after action (ms). Default: 150.
+     *
+     * For keyboard/type actions where immediate feedback is expected,
+     * callers can pass a lower value (e.g. settleMs: 50) to reduce latency.
+     * For click actions that trigger animations or async network requests,
+     * a higher value (e.g. settleMs: 300-500) may be appropriate.
+     */
+    settleMs?: number;
+    /** Maximum characters for the delta string. Default: 500 */
+    maxChars?: number;
+}
+export interface DomDeltaResult<T> {
+    result: T;
+    delta: string;
+}
+/**
+ * Execute an action while capturing DOM mutations.
+ *
+ * Injects a MutationObserver before the action, waits for the DOM to settle
+ * after the action, then collects and formats the changes.
+ *
+ * If the action causes a page navigation, the observer is destroyed —
+ * we detect this via URL change and report the navigation instead.
+ */
+export declare function withDomDelta<T>(page: Page, action: () => Promise<T>, options?: DomDeltaOptions): Promise<DomDeltaResult<T>>;
+//# sourceMappingURL=dom-delta.d.ts.map

package/dist/utils/dom-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-delta.d.ts","sourceRoot":"","sources":["../../src/utils/dom-delta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAiPD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAkF5B"}

package/dist/utils/dom-delta.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * DOM Delta Feedback - Captures what changed in the DOM after an action
+ *
+ * Injects a MutationObserver before an action, collects mutations after,
+ * and formats a compact delta string that tells the LLM what happened
+ * without needing a screenshot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDomDelta = withDomDelta;
+const safe_title_1 = require("./safe-title");
+// Script injected into the page to set up the MutationObserver
+const INJECT_OBSERVER_SCRIPT = `(() => {
+  const delta = {
+    preUrl: location.href,
+    preTitle: document.title,
+    preScroll: { x: window.scrollX, y: window.scrollY },
+    mutations: []
+  };
+
+  const IGNORE_TAGS = new Set(['SCRIPT', 'STYLE', 'LINK', 'META', 'NOSCRIPT']);
+  const MAX_MUTATIONS = 15;
+  const observerConfig = {
+    childList: true,
+    subtree: true,
+    attributes: true,
+    attributeOldValue: true,
+    attributeFilter: ['class', 'style', 'hidden', 'disabled', 'aria-expanded',
+                       'aria-hidden', 'open', 'checked', 'value', 'src', 'href']
+  };
+  var shadowObservers = [];
+
+  function observeShadowRoot(sr) {
+    var obs = new MutationObserver(handleRecords);
+    obs.observe(sr, observerConfig);
+    shadowObservers.push(obs);
+  }
+
+  function checkForNewShadowRoots(node) {
+    if (node.shadowRoot) observeShadowRoot(node.shadowRoot);
+    var desc = node.querySelectorAll ? node.querySelectorAll('*') : [];
+    for (var i = 0; i < desc.length; i++) {
+      if (desc[i].shadowRoot) observeShadowRoot(desc[i].shadowRoot);
+    }
+  }
+
+  function handleRecords(records) {
+    if (delta.mutations.length >= MAX_MUTATIONS) return;
+
+    for (const r of records) {
+      if (delta.mutations.length >= MAX_MUTATIONS) break;
+
+      if (r.type === 'childList') {
+        for (const n of r.addedNodes) {
+          if (delta.mutations.length >= MAX_MUTATIONS) break;
+          if (n.nodeType !== 1) continue;
+          const el = n;
+          // Detect new open shadow roots on added elements
+          checkForNewShadowRoots(el);
+          if (IGNORE_TAGS.has(el.tagName)) continue;
+          const role = el.getAttribute && el.getAttribute('role');
+          const tag = el.tagName.toLowerCase();
+          const text = (el.textContent || '').trim().slice(0, 40);
+          const label = role ? tag + '[role="' + role + '"]' : tag;
+          delta.mutations.push({ type: 'added', label, text });
+        }
+        for (const n of r.removedNodes) {
+          if (delta.mutations.length >= MAX_MUTATIONS) break;
+          if (n.nodeType !== 1) continue;
+          const el = n;
+          if (IGNORE_TAGS.has(el.tagName)) continue;
+          const role = el.getAttribute && el.getAttribute('role');
+          const tag = el.tagName.toLowerCase();
+          const text = (el.textContent || '').trim().slice(0, 40);
+          const label = role ? tag + '[role="' + role + '"]' : tag;
+          delta.mutations.push({ type: 'removed', label, text });
+        }
+      }
+
+      if (r.type === 'attributes') {
+        if (delta.mutations.length >= MAX_MUTATIONS) break;
+        const el = r.target;
+        if (el.nodeType !== 1) continue;
+        if (IGNORE_TAGS.has(el.tagName)) continue;
+        const attr = r.attributeName;
+        const oldVal = r.oldValue;
+        const newVal = el.getAttribute(attr);
+        if (oldVal === newVal) continue;
+        // Skip pure CSS animation class changes
+        if (attr === 'class') {
+          const oldClasses = new Set((oldVal || '').split(/\\s+/));
+          const newClasses = new Set((newVal || '').split(/\\s+/));
+          const added = [...newClasses].filter(c => !oldClasses.has(c));
+          const removed = [...oldClasses].filter(c => !newClasses.has(c));
+          const allChanges = [...added, ...removed];
+          const isAnimOnly = allChanges.every(c =>
+            /^(animate|fade|slide|transition|entering|leaving|active|ng-|v-)/i.test(c)
+          );
+          if (isAnimOnly && allChanges.length > 0) continue;
+        }
+        const tag = el.tagName.toLowerCase();
+        const id = el.id ? '#' + el.id : '';
+        const label = tag + id;
+        const oldStr = oldVal != null ? String(oldVal).slice(0, 30) : 'null';
+        const newStr = newVal != null ? String(newVal).slice(0, 30) : 'null';
+        delta.mutations.push({ type: 'attribute', label, attr, oldVal: oldStr, newVal: newStr });
+      }
+    }
+  }
+
+  const observer = new MutationObserver(handleRecords);
+
+  // Disconnect any previous observers to avoid global collision on concurrent calls
+  if (window.__ocObserver) {
+    try { window.__ocObserver.disconnect(); } catch(e) {}
+  }
+  if (window.__ocShadowObservers) {
+    for (var i = 0; i < window.__ocShadowObservers.length; i++) {
+      try { window.__ocShadowObservers[i].disconnect(); } catch(e) {}
+    }
+  }
+
+  observer.observe(document.body || document.documentElement, observerConfig);
+
+  // Walk existing open shadow roots and observe them
+  function walkForShadowRoots(root) {
+    var allEls = root.querySelectorAll('*');
+    for (var i = 0; i < allEls.length; i++) {
+      if (allEls[i].shadowRoot) {
+        observeShadowRoot(allEls[i].shadowRoot);
+        walkForShadowRoots(allEls[i].shadowRoot);
+      }
+    }
+  }
+  walkForShadowRoots(document);
+
+  window.__ocDelta = delta;
+  window.__ocObserver = observer;
+  window.__ocShadowObservers = shadowObservers;
+})()`;
+// Script to collect mutations after action
+const COLLECT_DELTA_SCRIPT = `(() => {
+  try {
+    if (!window.__ocObserver) return null;
+    window.__ocObserver.disconnect();
+    // Disconnect shadow root observers
+    if (window.__ocShadowObservers) {
+      for (var i = 0; i < window.__ocShadowObservers.length; i++) {
+        try { window.__ocShadowObservers[i].disconnect(); } catch(e) {}
+      }
+    }
+    const d = window.__ocDelta;
+    if (!d) return null;
+
+    const result = {
+      urlChanged: location.href !== d.preUrl,
+      newUrl: location.href !== d.preUrl ? location.href : null,
+      titleChanged: document.title !== d.preTitle,
+      newTitle: document.title !== d.preTitle ? document.title : null,
+      scrollChanged: window.scrollX !== d.preScroll.x || window.scrollY !== d.preScroll.y,
+      scroll: { x: Math.round(window.scrollX), y: Math.round(window.scrollY) },
+      preScroll: d.preScroll,
+      mutations: d.mutations
+    };
+
+    // Cleanup
+    delete window.__ocDelta;
+    delete window.__ocObserver;
+    delete window.__ocShadowObservers;
+
+    return result;
+  } catch (e) {
+    return null;
+  }
+})()`;
+/**
+ * Format collected delta into a compact readable string
+ */
+function formatDelta(delta, maxChars) {
+    const lines = [];
+    // Deduplicate mutations: collapse identical entries
+    const seen = new Set();
+    const uniqueMutations = delta.mutations.filter(m => {
+        const key = `${m.type}|${m.label}|${m.text || ''}|${m.attr || ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // Cap at 10 per type
+    const added = uniqueMutations.filter(m => m.type === 'added').slice(0, 10);
+    const removed = uniqueMutations.filter(m => m.type === 'removed').slice(0, 10);
+    const changed = uniqueMutations.filter(m => m.type === 'attribute').slice(0, 10);
+    for (const m of added) {
+        const text = m.text ? `: "${m.text}"` : '';
+        lines.push(`+ ${m.label}${text}`);
+    }
+    for (const m of removed) {
+        const text = m.text ? `: "${m.text}"` : '';
+        lines.push(`- ${m.label}${text}`);
+    }
+    for (const m of changed) {
+        lines.push(`~ ${m.label}: ${m.attr} ${m.oldVal}\u2192${m.newVal}`);
+    }
+    if (delta.urlChanged && delta.newUrl) {
+        lines.push(`URL: ${delta.newUrl}`);
+    }
+    if (delta.titleChanged && delta.newTitle) {
+        lines.push(`Title: "${delta.newTitle}"`);
+    }
+    if (delta.scrollChanged) {
+        lines.push(`Scroll: ${delta.preScroll.x},${delta.preScroll.y} \u2192 ${delta.scroll.x},${delta.scroll.y}`);
+    }
+    if (lines.length === 0)
+        return '';
+    let result = '\n[DOM Delta]\n' + lines.join('\n');
+    if (result.length > maxChars) {
+        result = result.slice(0, maxChars - 3) + '...';
+    }
+    return result;
+}
+/**
+ * Execute an action while capturing DOM mutations.
+ *
+ * Injects a MutationObserver before the action, waits for the DOM to settle
+ * after the action, then collects and formats the changes.
+ *
+ * If the action causes a page navigation, the observer is destroyed —
+ * we detect this via URL change and report the navigation instead.
+ */
+async function withDomDelta(page, action, options) {
+    const settleMs = options?.settleMs ?? 150;
+    const maxChars = options?.maxChars ?? 500;
+    let preUrl;
+    try {
+        preUrl = page.url();
+    }
+    catch {
+        preUrl = '';
+    }
+    // Inject the MutationObserver
+    try {
+        await Promise.race([
+            page.evaluate(INJECT_OBSERVER_SCRIPT),
+            new Promise((resolve) => setTimeout(resolve, 5000)),
+        ]);
+    }
+    catch {
+        // If injection fails (e.g., page not ready), just run the action without delta
+        const result = await action();
+        return { result, delta: '' };
+    }
+    // Listen for navigation that would destroy the observer
+    let navigated = false;
+    const onNav = () => { navigated = true; };
+    page.on('framenavigated', onNav);
+    // Execute the action (try/finally ensures observer cleanup on failure)
+    let result;
+    try {
+        result = await action();
+    }
+    catch (e) {
+        page.off('framenavigated', onNav);
+        // Try to disconnect observer on failure
+        try {
+            await page.evaluate('window.__ocObserver && window.__ocObserver.disconnect(); if (window.__ocShadowObservers) { for (var i = 0; i < window.__ocShadowObservers.length; i++) { try { window.__ocShadowObservers[i].disconnect(); } catch(e) {} } }');
+        }
+        catch { }
+        throw e;
+    }
+    // Wait for DOM to settle
+    await new Promise(resolve => setTimeout(resolve, settleMs));
+    // Check if navigation occurred (observer would be destroyed)
+    let postUrl;
+    try {
+        postUrl = page.url();
+    }
+    catch {
+        postUrl = '';
+    }
+    page.off('framenavigated', onNav);
+    if (navigated || (postUrl && preUrl && postUrl !== preUrl)) {
+        // Page navigated — observer is gone
+        let title = '';
+        try {
+            title = await (0, safe_title_1.safeTitle)(page);
+        }
+        catch {
+            // ignore
+        }
+        let delta = `\n[Page navigated: ${postUrl}]`;
+        if (title) {
+            delta += `\n[Title: "${title}"]`;
+        }
+        return { result, delta };
+    }
+    // Collect mutations
+    try {
+        const collected = await Promise.race([
+            page.evaluate(COLLECT_DELTA_SCRIPT),
+            new Promise((resolve) => setTimeout(() => resolve(null), 5000)),
+        ]);
+        if (!collected) {
+            return { result, delta: '' };
+        }
+        const delta = formatDelta(collected, maxChars);
+        return { result, delta };
+    }
+    catch {
+        // Collection failed (page might have navigated or crashed)
+        return { result, delta: '' };
+    }
+}
+//# sourceMappingURL=dom-delta.js.map

package/dist/utils/dom-delta.js.map

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