@roomi-fields/notebooklm-mcp 1.1.2

package/dist/session/session-manager.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Session Manager
+ *
+ * Manages multiple parallel browser sessions for NotebookLM API
+ *
+ * Features:
+ * - Session lifecycle management
+ * - Auto-cleanup of inactive sessions
+ * - Resource limits (max concurrent sessions)
+ * - Shared PERSISTENT browser fingerprint (ONE context for all sessions)
+ *
+ * Based on the Python implementation from session_manager.py
+ */
+import { AuthManager } from "../auth/auth-manager.js";
+import { BrowserSession } from "./browser-session.js";
+import type { SessionInfo } from "../types.js";
+export declare class SessionManager {
+    private authManager;
+    private sharedContextManager;
+    private sessions;
+    private maxSessions;
+    private sessionTimeout;
+    private cleanupInterval?;
+    constructor(authManager: AuthManager);
+    /**
+     * Generate a unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Get existing session or create a new one
+     *
+     * @param sessionId Optional session ID to reuse existing session
+     * @param notebookUrl Notebook URL for the session
+     * @param overrideHeadless Optional override for headless mode (true = show browser)
+     */
+    getOrCreateSession(sessionId?: string, notebookUrl?: string, overrideHeadless?: boolean): Promise<BrowserSession>;
+    /**
+     * Get an existing session by ID
+     */
+    getSession(sessionId: string): BrowserSession | null;
+    /**
+     * Close and remove a specific session
+     */
+    closeSession(sessionId: string): Promise<boolean>;
+    /**
+     * Close all sessions that are using the provided notebook URL
+     */
+    closeSessionsForNotebook(url: string): Promise<number>;
+    /**
+     * Clean up all inactive sessions
+     */
+    cleanupInactiveSessions(): Promise<number>;
+    /**
+     * Clean up the oldest session to make space
+     */
+    private cleanupOldestSession;
+    /**
+     * Close all sessions (used during shutdown)
+     */
+    closeAllSessions(): Promise<void>;
+    /**
+     * Get all sessions info
+     */
+    getAllSessionsInfo(): SessionInfo[];
+    /**
+     * Get aggregate stats
+     */
+    getStats(): {
+        active_sessions: number;
+        max_sessions: number;
+        session_timeout: number;
+        oldest_session_seconds: number;
+        total_messages: number;
+    };
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAE7B,WAAW,EAAE,WAAW;IAwBpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;OAMG;IACG,kBAAkB,CACtB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,cAAc,CAAC;IAmF1B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAIpD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBvD;;OAEG;IACG,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB5D;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAsChD;;OAEG;YACW,oBAAoB;IA+BlC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BvC;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAInC;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;KACxB;CAoBF"}

package/dist/session/session-manager.js

@@ -0,0 +1,273 @@
+/**
+ * Session Manager
+ *
+ * Manages multiple parallel browser sessions for NotebookLM API
+ *
+ * Features:
+ * - Session lifecycle management
+ * - Auto-cleanup of inactive sessions
+ * - Resource limits (max concurrent sessions)
+ * - Shared PERSISTENT browser fingerprint (ONE context for all sessions)
+ *
+ * Based on the Python implementation from session_manager.py
+ */
+import { BrowserSession } from "./browser-session.js";
+import { SharedContextManager } from "./shared-context-manager.js";
+import { CONFIG } from "../config.js";
+import { log } from "../utils/logger.js";
+import { randomBytes } from "crypto";
+export class SessionManager {
+    authManager;
+    sharedContextManager;
+    sessions = new Map();
+    maxSessions;
+    sessionTimeout;
+    cleanupInterval;
+    constructor(authManager) {
+        this.authManager = authManager;
+        this.sharedContextManager = new SharedContextManager(authManager);
+        this.maxSessions = CONFIG.maxSessions;
+        this.sessionTimeout = CONFIG.sessionTimeout;
+        log.info("🎯 SessionManager initialized");
+        log.info(`  Max sessions: ${this.maxSessions}`);
+        log.info(`  Timeout: ${this.sessionTimeout}s (${Math.floor(this.sessionTimeout / 60)} minutes)`);
+        const cleanupIntervalSeconds = Math.max(60, Math.min(Math.floor(this.sessionTimeout / 2), 300));
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupInactiveSessions().catch((error) => {
+                log.warning(`⚠️  Error during automatic session cleanup: ${error}`);
+            });
+        }, cleanupIntervalSeconds * 1000);
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId() {
+        return randomBytes(4).toString("hex");
+    }
+    /**
+     * Get existing session or create a new one
+     *
+     * @param sessionId Optional session ID to reuse existing session
+     * @param notebookUrl Notebook URL for the session
+     * @param overrideHeadless Optional override for headless mode (true = show browser)
+     */
+    async getOrCreateSession(sessionId, notebookUrl, overrideHeadless) {
+        // Determine target notebook URL
+        const targetUrl = (notebookUrl || CONFIG.notebookUrl || "").trim();
+        if (!targetUrl) {
+            throw new Error("Notebook URL is required to create a session");
+        }
+        if (!targetUrl.startsWith("http")) {
+            throw new Error("Notebook URL must be an absolute URL");
+        }
+        // Generate ID if not provided
+        if (!sessionId) {
+            sessionId = this.generateSessionId();
+            log.info(`🆕 Auto-generated session ID: ${sessionId}`);
+        }
+        // Check if browser visibility mode needs to change
+        if (overrideHeadless !== undefined) {
+            if (this.sharedContextManager.needsHeadlessModeChange(overrideHeadless)) {
+                log.warning(`🔄 Browser visibility changed - closing all sessions to recreate browser context...`);
+                const currentMode = this.sharedContextManager.getCurrentHeadlessMode();
+                log.info(`  Switching from ${currentMode ? 'HEADLESS' : 'VISIBLE'} to ${overrideHeadless ? 'VISIBLE' : 'HEADLESS'}`);
+                // Close all sessions (they all use the same context)
+                await this.closeAllSessions();
+                log.success(`  ✅ All sessions closed, browser context will be recreated with new mode`);
+            }
+        }
+        // Return existing session if found
+        if (this.sessions.has(sessionId)) {
+            const session = this.sessions.get(sessionId);
+            if (session.notebookUrl !== targetUrl) {
+                log.warning(`♻️  Replacing session ${sessionId} with new notebook URL`);
+                await session.close();
+                this.sessions.delete(sessionId);
+            }
+            else {
+                session.updateActivity();
+                log.success(`♻️  Reusing existing session ${sessionId}`);
+                return session;
+            }
+        }
+        // Check if we need to free up space
+        if (this.sessions.size >= this.maxSessions) {
+            log.warning(`⚠️  Max sessions (${this.maxSessions}) reached, cleaning up...`);
+            const freed = await this.cleanupOldestSession();
+            if (!freed) {
+                throw new Error(`Max sessions (${this.maxSessions}) reached and no inactive sessions to clean up`);
+            }
+        }
+        // Create new session
+        log.info(`🆕 Creating new session ${sessionId}...`);
+        if (overrideHeadless !== undefined) {
+            log.info(`  Show browser: ${overrideHeadless}`);
+        }
+        try {
+            // Ensure the shared context exists (ONE fingerprint for all sessions!)
+            await this.sharedContextManager.getOrCreateContext(overrideHeadless);
+            // Create and initialize session
+            const session = new BrowserSession(sessionId, this.sharedContextManager, this.authManager, targetUrl);
+            await session.init();
+            this.sessions.set(sessionId, session);
+            log.success(`✅ Session ${sessionId} created (${this.sessions.size}/${this.maxSessions} active)`);
+            return session;
+        }
+        catch (error) {
+            log.error(`❌ Failed to create session: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Get an existing session by ID
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId) || null;
+    }
+    /**
+     * Close and remove a specific session
+     */
+    async closeSession(sessionId) {
+        if (!this.sessions.has(sessionId)) {
+            log.warning(`⚠️  Session ${sessionId} not found`);
+            return false;
+        }
+        const session = this.sessions.get(sessionId);
+        await session.close();
+        this.sessions.delete(sessionId);
+        log.success(`✅ Session ${sessionId} closed (${this.sessions.size}/${this.maxSessions} active)`);
+        return true;
+    }
+    /**
+     * Close all sessions that are using the provided notebook URL
+     */
+    async closeSessionsForNotebook(url) {
+        let closed = 0;
+        for (const [sessionId, session] of Array.from(this.sessions.entries())) {
+            if (session.notebookUrl === url) {
+                try {
+                    await session.close();
+                }
+                catch (error) {
+                    log.warning(`  ⚠️  Error closing ${sessionId}: ${error}`);
+                }
+                finally {
+                    this.sessions.delete(sessionId);
+                    closed++;
+                }
+            }
+        }
+        if (closed > 0) {
+            log.warning(`🧹 Closed ${closed} session(s) using removed notebook (${this.sessions.size}/${this.maxSessions} active)`);
+        }
+        return closed;
+    }
+    /**
+     * Clean up all inactive sessions
+     */
+    async cleanupInactiveSessions() {
+        const inactiveSessions = [];
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (session.isExpired(this.sessionTimeout)) {
+                inactiveSessions.push(sessionId);
+            }
+        }
+        if (inactiveSessions.length === 0) {
+            return 0;
+        }
+        log.warning(`🧹 Cleaning up ${inactiveSessions.length} inactive sessions...`);
+        for (const sessionId of inactiveSessions) {
+            try {
+                const session = this.sessions.get(sessionId);
+                const age = (Date.now() - session.createdAt) / 1000;
+                const inactive = (Date.now() - session.lastActivity) / 1000;
+                log.warning(`  🗑️  ${sessionId}: age=${age.toFixed(0)}s, inactive=${inactive.toFixed(0)}s, messages=${session.messageCount}`);
+                await session.close();
+                this.sessions.delete(sessionId);
+            }
+            catch (error) {
+                log.warning(`  ⚠️  Error cleaning up ${sessionId}: ${error}`);
+            }
+        }
+        log.success(`✅ Cleaned up ${inactiveSessions.length} sessions (${this.sessions.size}/${this.maxSessions} active)`);
+        return inactiveSessions.length;
+    }
+    /**
+     * Clean up the oldest session to make space
+     */
+    async cleanupOldestSession() {
+        if (this.sessions.size === 0) {
+            return false;
+        }
+        // Find oldest session
+        let oldestId = null;
+        let oldestTime = Infinity;
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (session.createdAt < oldestTime) {
+                oldestTime = session.createdAt;
+                oldestId = sessionId;
+            }
+        }
+        if (!oldestId) {
+            return false;
+        }
+        const oldestSession = this.sessions.get(oldestId);
+        const age = (Date.now() - oldestSession.createdAt) / 1000;
+        log.warning(`🗑️  Removing oldest session ${oldestId} (age: ${age.toFixed(0)}s)`);
+        await oldestSession.close();
+        this.sessions.delete(oldestId);
+        return true;
+    }
+    /**
+     * Close all sessions (used during shutdown)
+     */
+    async closeAllSessions() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        if (this.sessions.size === 0) {
+            log.warning("🛑 Closing shared context (no active sessions)...");
+            await this.sharedContextManager.closeContext();
+            log.success("✅ All sessions closed");
+            return;
+        }
+        log.warning(`🛑 Closing all ${this.sessions.size} sessions...`);
+        for (const sessionId of Array.from(this.sessions.keys())) {
+            try {
+                const session = this.sessions.get(sessionId);
+                await session.close();
+                this.sessions.delete(sessionId);
+            }
+            catch (error) {
+                log.warning(`  ⚠️  Error closing ${sessionId}: ${error}`);
+            }
+        }
+        // Close the shared context
+        await this.sharedContextManager.closeContext();
+        log.success("✅ All sessions closed");
+    }
+    /**
+     * Get all sessions info
+     */
+    getAllSessionsInfo() {
+        return Array.from(this.sessions.values()).map((session) => session.getInfo());
+    }
+    /**
+     * Get aggregate stats
+     */
+    getStats() {
+        const sessionsInfo = this.getAllSessionsInfo();
+        const totalMessages = sessionsInfo.reduce((sum, info) => sum + info.message_count, 0);
+        const oldestSessionSeconds = Math.max(...sessionsInfo.map((info) => info.age_seconds), 0);
+        return {
+            active_sessions: sessionsInfo.length,
+            max_sessions: this.maxSessions,
+            session_timeout: this.sessionTimeout,
+            oldest_session_seconds: oldestSessionSeconds,
+            total_messages: totalMessages,
+        };
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,OAAO,cAAc;IACjB,WAAW,CAAc;IACzB,oBAAoB,CAAuB;IAC3C,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAClD,WAAW,CAAS;IACpB,cAAc,CAAS;IACvB,eAAe,CAAkB;IAEzC,YAAY,WAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAClE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAE5C,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC1C,GAAG,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CACN,cAAc,IAAI,CAAC,cAAc,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC,WAAW,CACvF,CAAC;QAEF,MAAM,sBAAsB,GAAG,IAAI,CAAC,GAAG,CACrC,EAAE,EACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CACnD,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC7C,GAAG,CAAC,OAAO,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CACtB,SAAkB,EAClB,WAAoB,EACpB,gBAA0B;QAE1B,gCAAgC;QAChC,MAAM,SAAS,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,mDAAmD;QACnD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,oBAAoB,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,OAAO,CAAC,qFAAqF,CAAC,CAAC;gBACnG,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,CAAC;gBACvE,GAAG,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,OAAO,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBAErH,qDAAqD;gBACrD,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC9B,GAAG,CAAC,OAAO,CAAC,0EAA0E,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACtC,GAAG,CAAC,OAAO,CAAC,yBAAyB,SAAS,wBAAwB,CAAC,CAAC;gBACxE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,cAAc,EAAE,CAAC;gBACzB,GAAG,CAAC,OAAO,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;gBACzD,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,GAAG,CAAC,OAAO,CAAC,qBAAqB,IAAI,CAAC,WAAW,2BAA2B,CAAC,CAAC;YAC9E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,CAAC,WAAW,gDAAgD,CAClF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,GAAG,CAAC,IAAI,CAAC,2BAA2B,SAAS,KAAK,CAAC,CAAC;QACpD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,mBAAmB,gBAAgB,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC;YACH,uEAAuE;YACvE,MAAM,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;YAErE,gCAAgC;YAChC,MAAM,OAAO,GAAG,IAAI,cAAc,CAChC,SAAS,EACT,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,WAAW,EAChB,SAAS,CACV,CAAC;YACF,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YAErB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,GAAG,CAAC,OAAO,CACT,aAAa,SAAS,aAAa,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,UAAU,CACpF,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,GAAG,CAAC,OAAO,CAAC,eAAe,SAAS,YAAY,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC9C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEhC,GAAG,CAAC,OAAO,CACT,aAAa,SAAS,YAAY,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,UAAU,CACnF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAAC,GAAW;QACxC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACvE,IAAI,OAAO,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,GAAG,CAAC,OAAO,CAAC,uBAAuB,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;gBAC5D,CAAC;wBAAS,CAAC;oBACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAChC,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,GAAG,CAAC,OAAO,CACT,aAAa,MAAM,uCAAuC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,UAAU,CAC3G,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB;QAC3B,MAAM,gBAAgB,GAAa,EAAE,CAAC;QAEtC,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC3C,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,GAAG,CAAC,OAAO,CAAC,kBAAkB,gBAAgB,CAAC,MAAM,uBAAuB,CAAC,CAAC;QAE9E,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;gBAC9C,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;gBACpD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;gBAE5D,GAAG,CAAC,OAAO,CACT,UAAU,SAAS,SAAS,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,OAAO,CAAC,YAAY,EAAE,CAClH,CAAC;gBAEF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,OAAO,CAAC,2BAA2B,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,GAAG,CAAC,OAAO,CACT,gBAAgB,gBAAgB,CAAC,MAAM,cAAc,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,UAAU,CACtG,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sBAAsB;QACtB,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,SAAS,GAAG,UAAU,EAAE,CAAC;gBACnC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;gBAC/B,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACnD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QAE1D,GAAG,CAAC,OAAO,CAAC,gCAAgC,QAAQ,UAAU,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAElF,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC;YACjE,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,CAAC;QAEhE,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;gBAC9C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,OAAO,CAAC,uBAAuB,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC;QAE/C,GAAG,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,QAAQ;QAON,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE/C,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CACvC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,EACvC,CAAC,CACF,CAAC;QACF,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAC/C,CAAC,CACF,CAAC;QAEF,OAAO;YACL,eAAe,EAAE,YAAY,CAAC,MAAM;YACpC,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,sBAAsB,EAAE,oBAAoB;YAC5C,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;CACF"}

package/dist/session/shared-context-manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Shared Context Manager with Persistent Chrome Profile
+ *
+ * Manages ONE global persistent BrowserContext for ALL sessions.
+ * This is critical for avoiding bot detection:
+ *
+ * - Google tracks browser fingerprints (Canvas, WebGL, Audio, Fonts, etc.)
+ * - Multiple contexts = Multiple fingerprints = Suspicious!
+ * - ONE persistent context = ONE consistent fingerprint = Normal user
+ * - Persistent user_data_dir = SAME fingerprint across all app restarts!
+ *
+ * Based on the Python implementation from shared_context_manager.py
+ */
+import type { BrowserContext } from "patchright";
+import { AuthManager } from "../auth/auth-manager.js";
+/**
+ * Shared Context Manager
+ *
+ * Benefits:
+ * 1. ONE consistent browser fingerprint for all sessions
+ * 2. Fingerprint persists across app restarts (user_data_dir)
+ * 3. Mimics real user behavior (one browser, multiple tabs)
+ * 4. Google sees: "Same browser since day 1"
+ */
+export declare class SharedContextManager {
+    private authManager;
+    private globalContext;
+    private contextCreatedAt;
+    private currentProfileDir;
+    private isIsolatedProfile;
+    private currentHeadlessMode;
+    constructor(authManager: AuthManager);
+    /**
+     * Get the global shared persistent context, or create new if needed
+     *
+     * Context is recreated only when:
+     * - First time (no context exists in this app instance)
+     * - Context was closed/invalid
+     *
+     * Note: Auth expiry does NOT recreate context - we reuse the SAME
+     * fingerprint and just re-login!
+     *
+     * @param overrideHeadless Optional override for headless mode (true = show browser)
+     */
+    getOrCreateContext(overrideHeadless?: boolean): Promise<BrowserContext>;
+    /**
+     * Check if global context needs to be recreated
+     */
+    private needsRecreation;
+    /**
+     * Create/Load the global PERSISTENT context with Chrome user_data_dir
+     *
+     * This is THE KEY to fingerprint persistence!
+     *
+     * First time:
+     * - Chrome creates new profile in user_data_dir
+     * - Generates fingerprint (Canvas, WebGL, Audio, etc.)
+     * - Saves everything to disk
+     *
+     * Subsequent starts:
+     * - Chrome loads profile from user_data_dir
+     * - SAME fingerprint as before! ✅
+     * - Google sees: "Same browser since day 1"
+     *
+     * @param overrideHeadless Optional override for headless mode (true = show browser)
+     */
+    private recreateContext;
+    /**
+     * Manually close the global context (e.g., on shutdown)
+     *
+     * Note: This closes the context for ALL sessions!
+     * Chrome will save everything to user_data_dir automatically.
+     */
+    closeContext(): Promise<void>;
+    private prepareIsolatedProfileDir;
+    private pruneIsolatedProfiles;
+    private safeRemoveIsolatedProfile;
+    /**
+     * Get information about the global persistent context
+     */
+    getContextInfo(): {
+        exists: boolean;
+        age_seconds?: number;
+        age_hours?: number;
+        fingerprint_id?: string;
+        user_data_dir: string;
+        persistent: boolean;
+    };
+    /**
+     * Get the current headless mode of the browser context
+     *
+     * @returns boolean | null - true if headless, false if visible, null if no context exists
+     */
+    getCurrentHeadlessMode(): boolean | null;
+    /**
+     * Check if the browser context needs to be recreated due to headless mode change
+     *
+     * @param overrideHeadless - Optional override for headless mode (true = show browser)
+     * @returns boolean - true if context needs to be recreated with new mode
+     */
+    needsHeadlessModeChange(overrideHeadless?: boolean): boolean;
+    /**
+     * Get context ID for logging
+     */
+    private getContextId;
+}
+//# sourceMappingURL=shared-context-manager.d.ts.map

package/dist/session/shared-context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-context-manager.d.ts","sourceRoot":"","sources":["../../src/session/shared-context-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAItD;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,mBAAmB,CAAwB;gBAEvC,WAAW,EAAE,WAAW;IAapC;;;;;;;;;;;OAWG;IACG,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB7E;;OAEG;YACW,eAAe;IAqB7B;;;;;;;;;;;;;;;;OAgBG;YACW,eAAe;IA+H7B;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAkCrB,yBAAyB;YA2BzB,qBAAqB;YAwDrB,yBAAyB;IAgBvC;;OAEG;IACH,cAAc,IAAI;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,OAAO,CAAC;KACrB;IAwBD;;;;OAIG;IACH,sBAAsB,IAAI,OAAO,GAAG,IAAI;IAIxC;;;;;OAKG;IACH,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO;IAuB5D;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}