openchrome-mcp 1.2.3 → 1.2.5

package/dist/chrome/profile-manager.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * ProfileManager - Persistent OpenChrome Profile Architecture
+ *
+ * Manages a persistent Chrome profile directory at ~/.openchrome/profile/
+ * instead of creating disposable temp profiles on every launch.
+ * Provides atomic cookie sync using the SQLite backup API.
+ */
+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.ProfileManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+// ---------------------------------------------------------------------------
+// ProfileManager
+// ---------------------------------------------------------------------------
+/**
+ * Manages persistent OpenChrome Chrome profiles and cookie synchronisation.
+ *
+ * Key responsibilities:
+ * - Maintain a reusable profile at `~/.openchrome/profile/` so cookies and
+ *   session data survive across OpenChrome restarts.
+ * - Track whether the persistent profile is stale relative to the real
+ *   Chrome profile using lightweight file-stat hashing.
+ * - Perform atomic cookie sync via the `sqlite3` CLI `.backup` command when
+ *   available, falling back to a plain file copy otherwise.
+ * - Decide which profile directory Chrome should use (`resolveProfile`).
+ */
+class ProfileManager {
+    // -------------------------------------------------------------------------
+    // Constants (configurable via Object.defineProperty for testing)
+    // -------------------------------------------------------------------------
+    /** Root directory for the persistent OpenChrome profile. */
+    static PERSISTENT_PROFILE_DIR = path.join(os.homedir(), '.openchrome', 'profile');
+    /** Path to the JSON file that tracks the last sync state. */
+    static SYNC_METADATA_PATH = path.join(os.homedir(), '.openchrome', 'sync-metadata.json');
+    /** Cookie data is considered fresh if synced within this window (30 min). */
+    static COOKIE_FRESHNESS_MS = 30 * 60 * 1000;
+    // -------------------------------------------------------------------------
+    // Public methods
+    // -------------------------------------------------------------------------
+    /**
+     * Return the persistent profile directory, creating it (including the
+     * `Default/` subdirectory) if it does not already exist.
+     */
+    getOrCreatePersistentProfile() {
+        const profileDir = ProfileManager.PERSISTENT_PROFILE_DIR;
+        const defaultDir = path.join(profileDir, 'Default');
+        if (!fs.existsSync(profileDir)) {
+            fs.mkdirSync(profileDir, { recursive: true });
+            console.error(`[ProfileManager] Created persistent profile directory: ${profileDir}`);
+        }
+        if (!fs.existsSync(defaultDir)) {
+            fs.mkdirSync(defaultDir, { recursive: true });
+        }
+        return profileDir;
+    }
+    /**
+     * Determine whether the persistent profile needs a fresh cookie sync from
+     * `sourceDir`.
+     *
+     * Returns `true` when:
+     * - No sync metadata exists (never synced before), OR
+     * - The source Cookies file has changed since the last sync (different
+     *   mtime or size), OR
+     * - The last sync is older than `COOKIE_FRESHNESS_MS`.
+     */
+    needsSync(sourceDir) {
+        const metadata = this.getSyncMetadata();
+        if (!metadata) {
+            return true; // Never synced
+        }
+        // Compute current hash of the source Cookies file
+        const sourceCookiesPath = path.join(sourceDir, 'Default', 'Cookies');
+        let currentHash;
+        try {
+            const stat = fs.statSync(sourceCookiesPath);
+            currentHash = `${stat.mtimeMs}:${stat.size}`;
+        }
+        catch {
+            // Cookies file doesn't exist in source — no sync possible
+            if (!metadata) {
+                console.error('[ProfileManager] Source Cookies not found and no prior sync — persistent profile will have no cookies');
+            }
+            return false;
+        }
+        if (currentHash !== metadata.sourceProfileHash) {
+            return true; // Source has changed
+        }
+        if (Date.now() - metadata.lastSyncTimestamp > ProfileManager.COOKIE_FRESHNESS_MS) {
+            return true; // Stale
+        }
+        return false;
+    }
+    /**
+     * Synchronise cookies (and Preferences) from `sourceDir` into `destDir`.
+     *
+     * Uses the `sqlite3` CLI `.backup` command for an atomic, consistent
+     * snapshot of the Cookies database. Falls back to a plain file copy when
+     * `sqlite3` is not available.
+     *
+     * After a successful sync the metadata file is updated via
+     * `updateSyncMetadata`.
+     *
+     * @returns `{ atomic: true, success: true }` when sqlite3 backup was used,
+     *          `{ atomic: false, success: true }` when the plain-copy fallback was used,
+     *          `{ atomic: false, success: false }` when all methods failed.
+     */
+    syncCookies(sourceDir, destDir) {
+        try {
+            const destDefault = path.join(destDir, 'Default');
+            fs.mkdirSync(destDefault, { recursive: true });
+            // --- 1. Copy Local State -----------------------------------------------
+            const localStateSrc = path.join(sourceDir, 'Local State');
+            if (fs.existsSync(localStateSrc)) {
+                fs.copyFileSync(localStateSrc, path.join(destDir, 'Local State'));
+            }
+            // --- 2. Sync Cookies (atomic via sqlite3, or plain copy fallback) ------
+            const sourceCookiesPath = path.join(sourceDir, 'Default', 'Cookies');
+            const destCookiesPath = path.join(destDefault, 'Cookies');
+            let atomic = false;
+            if (fs.existsSync(sourceCookiesPath)) {
+                const sqlite3Available = this._isSqlite3Available();
+                if (sqlite3Available) {
+                    // Atomic backup using the SQLite .backup command.
+                    // This works even when Chrome is actively writing to the DB.
+                    // Uses execFileSync (no shell) to prevent injection via path characters.
+                    (0, child_process_1.execFileSync)('sqlite3', [
+                        sourceCookiesPath,
+                        `.backup '${destCookiesPath.replace(/'/g, "''")}'`,
+                    ], { stdio: 'ignore', timeout: 10000 });
+                    // .backup produces a clean WAL-checkpoint DB — remove stale WAL/SHM/journal
+                    // at the destination so Chrome doesn't get confused.
+                    for (const suffix of ['Cookies-wal', 'Cookies-shm', 'Cookies-journal']) {
+                        const stale = path.join(destDefault, suffix);
+                        if (fs.existsSync(stale)) {
+                            try {
+                                fs.unlinkSync(stale);
+                            }
+                            catch {
+                                // Non-fatal
+                            }
+                        }
+                    }
+                    atomic = true;
+                }
+                else {
+                    // sqlite3 not available — fall back to plain file copy (same as
+                    // the legacy copyEssentialProfileData behaviour).
+                    console.error('[ProfileManager] sqlite3 not found, falling back to non-atomic cookie copy');
+                    const cookieFiles = [
+                        'Cookies',
+                        'Cookies-wal',
+                        'Cookies-shm',
+                        'Cookies-journal',
+                    ];
+                    for (const file of cookieFiles) {
+                        const src = path.join(sourceDir, 'Default', file);
+                        if (fs.existsSync(src)) {
+                            try {
+                                fs.copyFileSync(src, path.join(destDefault, file));
+                            }
+                            catch {
+                                // Individual file copy failure is non-fatal
+                            }
+                        }
+                    }
+                    atomic = false;
+                }
+            }
+            // --- 3. Copy and patch Preferences ------------------------------------
+            const prefsSrc = path.join(sourceDir, 'Default', 'Preferences');
+            if (fs.existsSync(prefsSrc)) {
+                try {
+                    const prefsContent = fs.readFileSync(prefsSrc, 'utf8');
+                    const prefs = JSON.parse(prefsContent);
+                    // Prevent "Chrome didn't shut down correctly" prompt
+                    if (prefs.profile) {
+                        prefs.profile.exit_type = 'Normal';
+                        prefs.profile.exited_cleanly = true;
+                    }
+                    // Suppress session restore so copied profile doesn't reopen old tabs
+                    if (!prefs.session)
+                        prefs.session = {};
+                    prefs.session.restore_on_startup = 5; // 5 = open new tab page
+                    delete prefs.session.startup_urls;
+                    fs.writeFileSync(path.join(destDefault, 'Preferences'), JSON.stringify(prefs));
+                }
+                catch {
+                    // JSON parse failed — skip Preferences entirely.
+                    // Chrome will create fresh defaults.
+                }
+            }
+            // --- 4. Update metadata -----------------------------------------------
+            this.updateSyncMetadata(sourceDir);
+            console.error(`[ProfileManager] Cookie sync complete (atomic=${atomic}) from ${sourceDir} → ${destDir}`);
+            return { atomic, success: true };
+        }
+        catch (err) {
+            console.error('[ProfileManager] syncCookies failed (non-fatal):', err);
+            return { atomic: false, success: false };
+        }
+    }
+    /**
+     * Read the current sync metadata from disk.
+     *
+     * @returns Parsed `SyncMetadata` or `null` if the file does not exist or
+     *          cannot be parsed.
+     */
+    getSyncMetadata() {
+        try {
+            const raw = fs.readFileSync(ProfileManager.SYNC_METADATA_PATH, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Persist sync metadata for `sourceDir` using a temp-file + rename pattern
+     * to prevent corruption on concurrent writes.
+     */
+    updateSyncMetadata(sourceDir) {
+        try {
+            // Compute source hash
+            const sourceCookiesPath = path.join(sourceDir, 'Default', 'Cookies');
+            let sourceProfileHash = '';
+            try {
+                const stat = fs.statSync(sourceCookiesPath);
+                sourceProfileHash = `${stat.mtimeMs}:${stat.size}`;
+            }
+            catch {
+                // Cookies file missing — leave hash empty
+            }
+            const existing = this.getSyncMetadata();
+            const updated = {
+                lastSyncTimestamp: Date.now(),
+                sourceProfileHash,
+                syncCount: existing ? existing.syncCount + 1 : 1,
+                sourceProfileDir: sourceDir,
+            };
+            const metaPath = ProfileManager.SYNC_METADATA_PATH;
+            const metaDir = path.dirname(metaPath);
+            // Ensure parent directory exists
+            if (!fs.existsSync(metaDir)) {
+                fs.mkdirSync(metaDir, { recursive: true });
+            }
+            // Atomic write: write to temp file, then rename
+            const tmpPath = `${metaPath}.tmp-${Date.now()}`;
+            fs.writeFileSync(tmpPath, JSON.stringify(updated, null, 2), 'utf8');
+            fs.renameSync(tmpPath, metaPath);
+        }
+        catch (err) {
+            console.error('[ProfileManager] updateSyncMetadata failed (non-fatal):', err);
+        }
+    }
+    /**
+     * Determine which Chrome `userDataDir` to use and whether a cookie sync
+     * was performed.
+     *
+     * Priority order:
+     * 1. `explicitUserDataDir` — caller has specified an exact directory.
+     * 2. `useTempProfile` or `usingHeadlessShell` — create a fresh temp dir.
+     * 3. `realProfileDir` exists and **not** locked — use real profile directly.
+     * 4. `realProfileDir` exists and **is** locked — use persistent profile,
+     *    syncing cookies from the real profile when stale.
+     * 5. No `realProfileDir` — use persistent profile without a sync.
+     */
+    resolveProfile(options) {
+        const { realProfileDir, isProfileLocked, explicitUserDataDir, useTempProfile, usingHeadlessShell, } = options;
+        // 1. Explicit user-data-dir
+        if (explicitUserDataDir) {
+            return {
+                userDataDir: explicitUserDataDir,
+                profileType: 'explicit',
+                syncPerformed: false,
+            };
+        }
+        // 2. Temp profile requested or headless-shell (no profile support)
+        if (useTempProfile || usingHeadlessShell) {
+            const tempDir = path.join(os.tmpdir(), `openchrome-${Date.now()}`);
+            return {
+                userDataDir: tempDir,
+                profileType: 'temp',
+                syncPerformed: false,
+            };
+        }
+        // 3. Real profile available and NOT locked
+        if (realProfileDir && !isProfileLocked) {
+            return {
+                userDataDir: realProfileDir,
+                profileType: 'real',
+                syncPerformed: false,
+            };
+        }
+        // 4. Real profile exists but IS locked — use persistent profile
+        if (realProfileDir && isProfileLocked) {
+            const persistentDir = this.getOrCreatePersistentProfile();
+            if (!this.needsSync(realProfileDir)) {
+                // Persistent profile is fresh — reuse without re-sync
+                return {
+                    userDataDir: persistentDir,
+                    profileType: 'persistent',
+                    syncPerformed: false,
+                };
+            }
+            // Stale — sync cookies from real profile into persistent profile
+            const syncResult = this.syncCookies(realProfileDir, persistentDir);
+            return {
+                userDataDir: persistentDir,
+                profileType: 'persistent',
+                syncPerformed: syncResult.atomic || syncResult.success,
+            };
+        }
+        // 5. No real profile at all — use persistent profile (no sync needed)
+        const persistentDir = this.getOrCreatePersistentProfile();
+        return {
+            userDataDir: persistentDir,
+            profileType: 'persistent',
+            syncPerformed: false,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /** Check whether the `sqlite3` CLI is available on PATH. */
+    _isSqlite3Available() {
+        try {
+            (0, child_process_1.execFileSync)(os.platform() === 'win32' ? 'where' : 'which', ['sqlite3'], { stdio: 'ignore', timeout: 3000 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.ProfileManager = ProfileManager;
+//# sourceMappingURL=profile-manager.js.map

package/dist/chrome/profile-manager.js.map

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

package/dist/chrome/sqlite-cookie-copy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Atomic SQLite Cookie Copy
+ *
+ * Chrome stores cookies in a SQLite database using WAL (Write-Ahead Log) mode.
+ * The database state spans up to three files: `Cookies`, `Cookies-wal`, and
+ * `Cookies-shm`. A naive sequential `fs.copyFileSync` of these files while
+ * Chrome is writing produces an inconsistent copy — the main DB and WAL may
+ * represent different transaction states, causing Chrome to silently discard
+ * the corrupted database and start with an empty cookie jar.
+ *
+ * This module implements a 3-tier fallback chain for atomic cookie copying:
+ *   1. `better-sqlite3` — VACUUM INTO for a clean, synchronous atomic copy
+ *   2. `sqlite3` CLI — `.backup` command via child_process
+ *   3. Raw `fs.copyFileSync` — last resort, copies main DB only (no WAL/SHM)
+ */
+export interface CookieCopyResult {
+    method: 'better-sqlite3' | 'sqlite3-cli' | 'file-copy' | 'none';
+    success: boolean;
+    warning?: string;
+}
+/**
+ * @internal Attempt atomic copy via better-sqlite3's VACUUM INTO.
+ */
+declare function attemptBetterSqlite3Copy(sourcePath: string, destPath: string): void;
+/**
+ * @internal Mutable dispatch table for testability.
+ * Tests can spy on `_deps.attemptBetterSqlite3Copy` to control the fallback chain.
+ */
+export declare const _deps: {
+    attemptBetterSqlite3Copy: typeof attemptBetterSqlite3Copy;
+};
+/**
+ * Copy the Chrome Cookies SQLite database from one Default profile directory
+ * to another using a 3-tier fallback chain for atomic consistency:
+ *
+ *   Tier 1: better-sqlite3 `VACUUM INTO` — synchronous, atomic, WAL-aware
+ *   Tier 2: sqlite3 CLI `.backup` — atomic, WAL-aware, no npm dep required
+ *   Tier 3: fs.copyFileSync — fast but non-atomic; recent WAL transactions may be absent
+ *
+ * @param sourceDefaultDir Path to the source Chrome `Default` profile directory
+ * @param destDefaultDir Path to the destination `Default` directory (must already exist)
+ * @returns Result indicating which method succeeded, or `none` if all failed
+ */
+export declare function copyCookiesAtomic(sourceDefaultDir: string, destDefaultDir: string): CookieCopyResult;
+export {};
+//# sourceMappingURL=sqlite-cookie-copy.d.ts.map

package/dist/chrome/sqlite-cookie-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-cookie-copy.d.ts","sourceRoot":"","sources":["../../src/chrome/sqlite-cookie-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,iBAAS,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY5E;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;;CAEjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,GACrB,gBAAgB,CAsDlB"}

package/dist/chrome/sqlite-cookie-copy.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Atomic SQLite Cookie Copy
+ *
+ * Chrome stores cookies in a SQLite database using WAL (Write-Ahead Log) mode.
+ * The database state spans up to three files: `Cookies`, `Cookies-wal`, and
+ * `Cookies-shm`. A naive sequential `fs.copyFileSync` of these files while
+ * Chrome is writing produces an inconsistent copy — the main DB and WAL may
+ * represent different transaction states, causing Chrome to silently discard
+ * the corrupted database and start with an empty cookie jar.
+ *
+ * This module implements a 3-tier fallback chain for atomic cookie copying:
+ *   1. `better-sqlite3` — VACUUM INTO for a clean, synchronous atomic copy
+ *   2. `sqlite3` CLI — `.backup` command via child_process
+ *   3. Raw `fs.copyFileSync` — last resort, copies main DB only (no WAL/SHM)
+ */
+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._deps = void 0;
+exports.copyCookiesAtomic = copyCookiesAtomic;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * @internal Attempt atomic copy via better-sqlite3's VACUUM INTO.
+ */
+function attemptBetterSqlite3Copy(sourcePath, destPath) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const Database = require('better-sqlite3');
+    const db = new Database(sourcePath, { readonly: true, fileMustExist: true });
+    try {
+        // VACUUM INTO creates a fully checkpointed, single-file copy —
+        // no WAL file is produced and no WAL file needs to be present.
+        const escapedDest = destPath.replace(/'/g, "''");
+        db.exec(`VACUUM INTO '${escapedDest}'`);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * @internal Mutable dispatch table for testability.
+ * Tests can spy on `_deps.attemptBetterSqlite3Copy` to control the fallback chain.
+ */
+exports._deps = {
+    attemptBetterSqlite3Copy,
+};
+/**
+ * Copy the Chrome Cookies SQLite database from one Default profile directory
+ * to another using a 3-tier fallback chain for atomic consistency:
+ *
+ *   Tier 1: better-sqlite3 `VACUUM INTO` — synchronous, atomic, WAL-aware
+ *   Tier 2: sqlite3 CLI `.backup` — atomic, WAL-aware, no npm dep required
+ *   Tier 3: fs.copyFileSync — fast but non-atomic; recent WAL transactions may be absent
+ *
+ * @param sourceDefaultDir Path to the source Chrome `Default` profile directory
+ * @param destDefaultDir Path to the destination `Default` directory (must already exist)
+ * @returns Result indicating which method succeeded, or `none` if all failed
+ */
+function copyCookiesAtomic(sourceDefaultDir, destDefaultDir) {
+    const sourcePath = path.join(sourceDefaultDir, 'Cookies');
+    const destPath = path.join(destDefaultDir, 'Cookies');
+    // Guard: source Cookies file must exist
+    if (!fs.existsSync(sourcePath)) {
+        return {
+            method: 'none',
+            success: false,
+            warning: 'Source Cookies file not found',
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Tier 1: better-sqlite3 — VACUUM INTO (synchronous, atomic, WAL-aware)
+    // -------------------------------------------------------------------------
+    try {
+        // VACUUM INTO requires the destination to not exist; remove stale file first.
+        if (fs.existsSync(destPath)) {
+            fs.unlinkSync(destPath);
+        }
+        exports._deps.attemptBetterSqlite3Copy(sourcePath, destPath);
+        return { method: 'better-sqlite3', success: true };
+    }
+    catch {
+        // better-sqlite3 not installed, or VACUUM INTO failed — fall through
+    }
+    // -------------------------------------------------------------------------
+    // Tier 2: sqlite3 CLI — .backup command
+    // -------------------------------------------------------------------------
+    try {
+        (0, child_process_1.execFileSync)('sqlite3', [sourcePath, `.backup '${destPath.replace(/'/g, "''")}'`], {
+            timeout: 5000,
+            stdio: 'ignore',
+        });
+        return { method: 'sqlite3-cli', success: true };
+    }
+    catch {
+        // sqlite3 CLI not available or backup failed — fall through
+    }
+    // -------------------------------------------------------------------------
+    // Tier 3: Raw file copy (last resort — non-atomic, WAL not included)
+    // -------------------------------------------------------------------------
+    try {
+        fs.copyFileSync(sourcePath, destPath);
+        // Explicitly do NOT copy WAL/SHM files — an inconsistent WAL applied to
+        // a partial main-db snapshot is worse than no WAL at all.
+        const warning = 'Used non-atomic file copy (sqlite3 unavailable). Some recent cookies may be missing.';
+        return { method: 'file-copy', success: true, warning };
+    }
+    catch {
+        const warning = 'All cookie copy methods failed.';
+        return { method: 'none', success: false, warning };
+    }
+}
+//# sourceMappingURL=sqlite-cookie-copy.js.map

package/dist/chrome/sqlite-cookie-copy.js.map

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

package/dist/config/defaults.d.ts

@@ -17,4 +17,12 @@ export declare const DEFAULT_VIEWPORT: {
 export declare const DEFAULT_NAVIGATION_TIMEOUT_MS = 30000;
 /** Maximum number of candidate elements returned by element-finding queries. */
 export declare const MAX_SEARCH_CANDIDATES = 30;
+/** CDP protocol timeout in milliseconds. Prevents 180s default hangs. */
+export declare const DEFAULT_PROTOCOL_TIMEOUT_MS = 30000;
+/** Screenshot-specific timeout. Shorter than protocol timeout for fast fallback. */
+export declare const DEFAULT_SCREENSHOT_TIMEOUT_MS = 15000;
+/** Maximum number of tabs (targets) per worker. Oldest tab is closed when limit is reached. */
+export declare const DEFAULT_MAX_TARGETS_PER_WORKER = 5;
+/** Memory pressure threshold in bytes (500MB). Below this free memory, aggressive cleanup triggers. */
+export declare const DEFAULT_MEMORY_PRESSURE_THRESHOLD: number;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;CAAyC,CAAC;AAEvE,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,KAAK,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;CAAyC,CAAC;AAEvE,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,+FAA+F;AAC/F,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,uGAAuG;AACvG,eAAO,MAAM,iCAAiC,QAAoB,CAAC"}

package/dist/config/defaults.js

@@ -6,7 +6,7 @@
  * Update this single file instead of hunting across tools/cdp/chrome.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_SEARCH_CANDIDATES = exports.DEFAULT_NAVIGATION_TIMEOUT_MS = exports.DEFAULT_VIEWPORT = exports.MAX_OUTPUT_CHARS = exports.DEFAULT_SCREENSHOT_QUALITY = void 0;
+exports.DEFAULT_MEMORY_PRESSURE_THRESHOLD = exports.DEFAULT_MAX_TARGETS_PER_WORKER = exports.DEFAULT_SCREENSHOT_TIMEOUT_MS = exports.DEFAULT_PROTOCOL_TIMEOUT_MS = exports.MAX_SEARCH_CANDIDATES = exports.DEFAULT_NAVIGATION_TIMEOUT_MS = exports.DEFAULT_VIEWPORT = exports.MAX_OUTPUT_CHARS = exports.DEFAULT_SCREENSHOT_QUALITY = void 0;
 /** WebP screenshot quality (0-100). Directly affects LLM token consumption via base64 size. */
 exports.DEFAULT_SCREENSHOT_QUALITY = 60;
 /** Maximum characters returned in page content output (read_page, DOM serializer, batch_paginate). */
@@ -17,4 +17,12 @@ exports.DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
 exports.DEFAULT_NAVIGATION_TIMEOUT_MS = 30000;
 /** Maximum number of candidate elements returned by element-finding queries. */
 exports.MAX_SEARCH_CANDIDATES = 30;
+/** CDP protocol timeout in milliseconds. Prevents 180s default hangs. */
+exports.DEFAULT_PROTOCOL_TIMEOUT_MS = 30000;
+/** Screenshot-specific timeout. Shorter than protocol timeout for fast fallback. */
+exports.DEFAULT_SCREENSHOT_TIMEOUT_MS = 15000;
+/** Maximum number of tabs (targets) per worker. Oldest tab is closed when limit is reached. */
+exports.DEFAULT_MAX_TARGETS_PER_WORKER = 5;
+/** Memory pressure threshold in bytes (500MB). Below this free memory, aggressive cleanup triggers. */
+exports.DEFAULT_MEMORY_PRESSURE_THRESHOLD = 500 * 1024 * 1024;
 //# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+FAA+F;AAClF,QAAA,0BAA0B,GAAG,EAAE,CAAC;AAE7C,sGAAsG;AACzF,QAAA,gBAAgB,GAAG,KAAK,CAAC;AAEtC,2CAA2C;AAC9B,QAAA,gBAAgB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAW,CAAC;AAEvE,kDAAkD;AACrC,QAAA,6BAA6B,GAAG,KAAK,CAAC;AAEnD,gFAAgF;AACnE,QAAA,qBAAqB,GAAG,EAAE,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+FAA+F;AAClF,QAAA,0BAA0B,GAAG,EAAE,CAAC;AAE7C,sGAAsG;AACzF,QAAA,gBAAgB,GAAG,KAAK,CAAC;AAEtC,2CAA2C;AAC9B,QAAA,gBAAgB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAW,CAAC;AAEvE,kDAAkD;AACrC,QAAA,6BAA6B,GAAG,KAAK,CAAC;AAEnD,gFAAgF;AACnE,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAExC,yEAAyE;AAC5D,QAAA,2BAA2B,GAAG,KAAK,CAAC;AAEjD,oFAAoF;AACvE,QAAA,6BAA6B,GAAG,KAAK,CAAC;AAEnD,+FAA+F;AAClF,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAEhD,uGAAuG;AAC1F,QAAA,iCAAiC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/config/global.d.ts

@@ -14,6 +14,8 @@ export interface GlobalConfig {
     useHeadlessShell?: boolean;
     /** Run Chrome in headless mode (default: true when auto-launch is enabled) */
     headless?: boolean;
+    /** If true, quit running Chrome to reuse the real profile instead of using temp profile (default: false) */
+    restartChrome?: boolean;
     /** Chrome Pool settings for managing multiple Chrome instances */
     pool?: {
         /** Enable the Chrome pool (default: true) */