@roomi-fields/notebooklm-mcp 1.1.2

package/dist/session/shared-context-manager.js

@@ -0,0 +1,447 @@
+/**
+ * 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 { chromium } from "patchright";
+import { CONFIG } from "../config.js";
+import { log } from "../utils/logger.js";
+import fs from "fs";
+import path from "path";
+/**
+ * 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 class SharedContextManager {
+    authManager;
+    globalContext = null;
+    contextCreatedAt = null;
+    currentProfileDir = null;
+    isIsolatedProfile = false;
+    currentHeadlessMode = null;
+    constructor(authManager) {
+        this.authManager = authManager;
+        log.info("🌐 SharedContextManager initialized (PERSISTENT MODE)");
+        log.info(`  Chrome Profile: ${CONFIG.chromeProfileDir}`);
+        log.success("  Fingerprint: PERSISTENT across restarts! 🎯");
+        // Cleanup old isolated profiles at startup (best-effort)
+        if (CONFIG.cleanupInstancesOnStartup) {
+            void this.pruneIsolatedProfiles("startup");
+        }
+    }
+    /**
+     * 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)
+     */
+    async getOrCreateContext(overrideHeadless) {
+        // Check if headless mode needs to be changed (e.g., show_browser=true)
+        // If yes, close the browser so it gets recreated with the new mode
+        if (this.needsHeadlessModeChange(overrideHeadless)) {
+            log.warning("🔄 Headless mode change detected - recreating browser context...");
+            await this.closeContext();
+        }
+        if (await this.needsRecreation()) {
+            log.warning("🔄 Creating/Loading persistent context...");
+            await this.recreateContext(overrideHeadless);
+        }
+        else {
+            log.success("♻️  Reusing existing persistent context");
+        }
+        return this.globalContext;
+    }
+    /**
+     * Check if global context needs to be recreated
+     */
+    async needsRecreation() {
+        // No context exists yet (first time or after manual close)
+        if (!this.globalContext) {
+            log.info("  ℹ️  No context exists yet");
+            return true;
+        }
+        // Async validity check (will throw if closed)
+        try {
+            await this.globalContext.cookies();
+            log.dim("  ✅ Context still valid (browser open)");
+            return false;
+        }
+        catch (error) {
+            log.warning("  ⚠️  Context appears closed - will recreate");
+            this.globalContext = null;
+            this.contextCreatedAt = null;
+            this.currentHeadlessMode = null;
+            return true;
+        }
+    }
+    /**
+     * 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)
+     */
+    async recreateContext(overrideHeadless) {
+        // Close old context if exists
+        if (this.globalContext) {
+            try {
+                log.info("  🗑️  Closing old context...");
+                await this.globalContext.close();
+            }
+            catch (error) {
+                log.warning(`  ⚠️  Error closing old context: ${error}`);
+            }
+        }
+        // Check for saved auth
+        const statePath = await this.authManager.getValidStatePath();
+        if (statePath) {
+            log.success(`  📂 Found auth state: ${statePath}`);
+            log.info("  💡 Will load cookies into persistent profile");
+        }
+        else {
+            log.warning("  🆕 No saved auth - fresh persistent profile");
+            log.info("  💡 First login will save auth to persistent profile");
+        }
+        // Determine headless mode: use override if provided, otherwise use CONFIG
+        const shouldBeHeadless = overrideHeadless !== undefined ? !overrideHeadless : CONFIG.headless;
+        if (overrideHeadless !== undefined) {
+            log.info(`  Browser visibility override: ${overrideHeadless ? 'VISIBLE' : 'HEADLESS'}`);
+        }
+        // Build launch options for persistent context
+        // NOTE: userDataDir is passed as first parameter, NOT in options!
+        const launchOptions = {
+            headless: shouldBeHeadless,
+            channel: "chrome",
+            viewport: CONFIG.viewport,
+            locale: "en-US",
+            timezoneId: "Europe/Berlin",
+            // ✅ CRITICAL FIX: Pass storageState directly at launch!
+            // This is the PROPER way to handle session cookies (Playwright bug workaround)
+            // Benefits:
+            // - Session cookies persist correctly
+            // - No need for addCookies() workarounds
+            // - Chrome loads everything automatically
+            ...(statePath && { storageState: statePath }),
+            args: [
+                "--disable-blink-features=AutomationControlled",
+                "--disable-dev-shm-usage",
+                "--no-first-run",
+                "--no-default-browser-check",
+            ],
+        };
+        // 🔥 CRITICAL: launchPersistentContext creates/loads Chrome profile
+        // Strategy handling for concurrent instances
+        const baseProfile = CONFIG.chromeProfileDir;
+        const strategy = CONFIG.profileStrategy;
+        const tryLaunch = async (userDataDir) => {
+            log.info("  🚀 Launching persistent Chrome context...");
+            log.dim(`  📍 Profile location: ${userDataDir}`);
+            if (statePath) {
+                log.info(`  📄 Loading auth state: ${statePath}`);
+            }
+            return chromium.launchPersistentContext(userDataDir, launchOptions);
+        };
+        try {
+            if (strategy === "isolated") {
+                const isolatedDir = await this.prepareIsolatedProfileDir(baseProfile);
+                this.globalContext = await tryLaunch(isolatedDir);
+                this.currentProfileDir = isolatedDir;
+                this.isIsolatedProfile = true;
+            }
+            else {
+                // single or auto → first try base
+                this.globalContext = await tryLaunch(baseProfile);
+                this.currentProfileDir = baseProfile;
+                this.isIsolatedProfile = false;
+            }
+        }
+        catch (e) {
+            const msg = String(e?.message || e);
+            const isSingleton = /ProcessSingleton|SingletonLock|profile is already in use/i.test(msg);
+            if (strategy === "single" || !isSingleton) {
+                // hard fail
+                if (isSingleton && strategy === "single") {
+                    log.error("❌ Chrome profile already in use and strategy=single. Close other instance or set NOTEBOOK_PROFILE_STRATEGY=auto/isolated.");
+                }
+                throw e;
+            }
+            // auto strategy with lock → fall back to isolated instance dir
+            log.warning("⚠️  Base Chrome profile in use by another process. Falling back to isolated per-instance profile...");
+            const isolatedDir = await this.prepareIsolatedProfileDir(baseProfile);
+            this.globalContext = await tryLaunch(isolatedDir);
+            this.currentProfileDir = isolatedDir;
+            this.isIsolatedProfile = true;
+        }
+        this.contextCreatedAt = Date.now();
+        this.currentHeadlessMode = shouldBeHeadless;
+        // Track close event to force recreation next time
+        try {
+            this.globalContext.on("close", () => {
+                log.warning("  🛑 Persistent context was closed externally");
+                this.globalContext = null;
+                this.contextCreatedAt = null;
+                this.currentHeadlessMode = null;
+            });
+        }
+        catch { }
+        // Validate cookies if we loaded state
+        if (statePath) {
+            try {
+                if (await this.authManager.validateCookiesExpiry(this.globalContext)) {
+                    log.success("  ✅ Authentication state loaded successfully");
+                    log.success("  🎯 Session cookies persisted correctly!");
+                }
+                else {
+                    log.warning("  ⚠️  Cookies expired - will need re-login");
+                }
+            }
+            catch (error) {
+                log.warning(`  ⚠️  Could not validate auth state: ${error}`);
+            }
+        }
+        log.success("✅ Persistent context ready!");
+        log.dim(`  Context ID: ${this.getContextId()}`);
+        log.dim(`  Chrome Profile: ${CONFIG.chromeProfileDir}`);
+        log.success("  🎯 Fingerprint: PERSISTENT (same across restarts!)");
+    }
+    /**
+     * 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.
+     */
+    async closeContext() {
+        if (this.globalContext) {
+            log.warning("🛑 Closing persistent context...");
+            log.info("  💾 Chrome is saving profile to disk...");
+            try {
+                await this.globalContext.close();
+                this.globalContext = null;
+                this.contextCreatedAt = null;
+                this.currentHeadlessMode = null;
+                log.success("✅ Persistent context closed");
+                log.success(`  💾 Profile saved: ${this.currentProfileDir || CONFIG.chromeProfileDir}`);
+            }
+            catch (error) {
+                log.error(`❌ Error closing context: ${error}`);
+            }
+        }
+        // Best-effort cleanup on shutdown
+        if (CONFIG.cleanupInstancesOnShutdown) {
+            try {
+                // If this process used an isolated profile, remove it now
+                if (this.isIsolatedProfile && this.currentProfileDir) {
+                    await this.safeRemoveIsolatedProfile(this.currentProfileDir);
+                }
+            }
+            catch (err) {
+                log.warning(`  ⚠️  Cleanup (self) failed: ${err}`);
+            }
+            try {
+                await this.pruneIsolatedProfiles("shutdown");
+            }
+            catch (err) {
+                log.warning(`  ⚠️  Cleanup (prune) failed: ${err}`);
+            }
+        }
+    }
+    async prepareIsolatedProfileDir(baseProfile) {
+        const stamp = `${process.pid}-${Date.now()}`;
+        const dir = path.join(CONFIG.chromeInstancesDir, `instance-${stamp}`);
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            if (CONFIG.cloneProfileOnIsolated && fs.existsSync(baseProfile)) {
+                log.info("  🧬 Cloning base Chrome profile into isolated instance (may take time)...");
+                // Best-effort clone without locks
+                await fs.promises.cp(baseProfile, dir, {
+                    recursive: true,
+                    errorOnExist: false,
+                    force: true,
+                    filter: (src) => {
+                        const bn = path.basename(src);
+                        return !/^Singleton/i.test(bn) && !bn.endsWith(".lock") && !bn.endsWith(".tmp");
+                    },
+                });
+                log.success("  ✅ Clone complete");
+            }
+            else {
+                log.info("  🧪 Using fresh isolated Chrome profile (no clone)");
+            }
+        }
+        catch (err) {
+            log.warning(`  ⚠️  Could not prepare isolated profile: ${err}`);
+        }
+        return dir;
+    }
+    async pruneIsolatedProfiles(phase) {
+        const root = CONFIG.chromeInstancesDir;
+        let entries;
+        try {
+            const names = await fs.promises.readdir(root, { withFileTypes: true });
+            entries = [];
+            for (const d of names) {
+                if (!d.isDirectory())
+                    continue;
+                const p = path.join(root, d.name);
+                try {
+                    const st = await fs.promises.stat(p);
+                    entries.push({ path: p, mtimeMs: st.mtimeMs });
+                }
+                catch { }
+            }
+        }
+        catch {
+            return; // directory absent is fine
+        }
+        if (entries.length === 0)
+            return;
+        const now = Date.now();
+        const ttlMs = CONFIG.instanceProfileTtlHours * 3600 * 1000;
+        const maxCount = Math.max(0, CONFIG.instanceProfileMaxCount);
+        // Sort newest first
+        entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        const keep = new Set();
+        const toDelete = new Set();
+        // Keep newest up to maxCount
+        for (let i = 0; i < entries.length; i++) {
+            const e = entries[i];
+            const ageMs = now - e.mtimeMs;
+            const overTtl = ttlMs > 0 && ageMs > ttlMs;
+            const overCount = i >= maxCount;
+            const isCurrent = this.currentProfileDir && path.resolve(e.path) === path.resolve(this.currentProfileDir);
+            if (!isCurrent && (overTtl || overCount)) {
+                toDelete.add(e.path);
+            }
+            else {
+                keep.add(e.path);
+            }
+        }
+        if (toDelete.size === 0)
+            return;
+        log.info(`🧹 Pruning isolated profiles (${phase})...`);
+        for (const p of toDelete) {
+            try {
+                await this.safeRemoveIsolatedProfile(p);
+                log.dim(`  🗑️  removed ${p}`);
+            }
+            catch (err) {
+                log.warning(`  ⚠️  Failed to remove ${p}: ${err}`);
+            }
+        }
+    }
+    async safeRemoveIsolatedProfile(dir) {
+        // Never remove the base profile
+        if (path.resolve(dir) === path.resolve(CONFIG.chromeProfileDir))
+            return;
+        // Only remove within instances root
+        if (!path.resolve(dir).startsWith(path.resolve(CONFIG.chromeInstancesDir)))
+            return;
+        // Best-effort: try removing typical lock files first, then the directory
+        try {
+            await fs.promises.rm(dir, { recursive: true, force: true });
+        }
+        catch (err) {
+            // If rm is not available in older node, fallback to rmdir
+            try {
+                await fs.promises.rmdir(dir, { recursive: true });
+            }
+            catch { }
+        }
+    }
+    /**
+     * Get information about the global persistent context
+     */
+    getContextInfo() {
+        if (!this.globalContext) {
+            return {
+                exists: false,
+                user_data_dir: CONFIG.chromeProfileDir,
+                persistent: true,
+            };
+        }
+        const ageSeconds = this.contextCreatedAt
+            ? (Date.now() - this.contextCreatedAt) / 1000
+            : undefined;
+        const ageHours = ageSeconds ? ageSeconds / 3600 : undefined;
+        return {
+            exists: true,
+            age_seconds: ageSeconds,
+            age_hours: ageHours,
+            fingerprint_id: this.getContextId(),
+            user_data_dir: CONFIG.chromeProfileDir,
+            persistent: true,
+        };
+    }
+    /**
+     * Get the current headless mode of the browser context
+     *
+     * @returns boolean | null - true if headless, false if visible, null if no context exists
+     */
+    getCurrentHeadlessMode() {
+        return this.currentHeadlessMode;
+    }
+    /**
+     * 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) {
+        // No context exists yet = will be created with correct mode anyway
+        if (this.currentHeadlessMode === null) {
+            return false;
+        }
+        // Calculate target headless mode
+        // If override is specified, use it (!overrideHeadless because true = show browser = headless false)
+        // Otherwise, use CONFIG.headless (which may have been temporarily modified by browser_options)
+        const targetHeadless = overrideHeadless !== undefined
+            ? !overrideHeadless
+            : CONFIG.headless;
+        // Compare with current mode
+        const needsChange = this.currentHeadlessMode !== targetHeadless;
+        if (needsChange) {
+            log.info(`  Browser mode change detected: ${this.currentHeadlessMode ? 'HEADLESS' : 'VISIBLE'} → ${targetHeadless ? 'HEADLESS' : 'VISIBLE'}`);
+        }
+        return needsChange;
+    }
+    /**
+     * Get context ID for logging
+     */
+    getContextId() {
+        if (!this.globalContext) {
+            return "none";
+        }
+        // Use object hash as ID
+        return `ctx-${this.globalContext._guid || "unknown"}`;
+    }
+}
+//# sourceMappingURL=shared-context-manager.js.map

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

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

package/dist/tools/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * MCP Tool Implementations
+ *
+ * Implements all MCP tools for NotebookLM integration:
+ * - ask_question: Ask NotebookLM with session support
+ * - list_sessions: List all active sessions
+ * - close_session: Close a specific session
+ * - reset_session: Reset session chat history
+ * - get_health: Server health check
+ * - setup_auth: Interactive authentication setup
+ *
+ * Based on the Python implementation from tools/*.py
+ */
+import { SessionManager } from "../session/session-manager.js";
+import { AuthManager } from "../auth/auth-manager.js";
+import { NotebookLibrary } from "../library/notebook-library.js";
+import type { AddNotebookInput, UpdateNotebookInput } from "../library/types.js";
+import { type BrowserOptions } from "../config.js";
+import type { AskQuestionResult, ToolResult, Tool, ProgressCallback } from "../types.js";
+/**
+ * Build Tool Definitions with NotebookLibrary context
+ */
+export declare function buildToolDefinitions(library: NotebookLibrary): Tool[];
+/**
+ * MCP Tool Handlers
+ */
+export declare class ToolHandlers {
+    private sessionManager;
+    private authManager;
+    private library;
+    constructor(sessionManager: SessionManager, authManager: AuthManager, library: NotebookLibrary);
+    /**
+     * Handle ask_question tool
+     */
+    handleAskQuestion(args: {
+        question: string;
+        session_id?: string;
+        notebook_id?: string;
+        notebook_url?: string;
+        show_browser?: boolean;
+        browser_options?: BrowserOptions;
+    }, sendProgress?: ProgressCallback): Promise<ToolResult<AskQuestionResult>>;
+    /**
+     * Handle list_sessions tool
+     */
+    handleListSessions(): Promise<ToolResult<{
+        active_sessions: number;
+        max_sessions: number;
+        session_timeout: number;
+        oldest_session_seconds: number;
+        total_messages: number;
+        sessions: Array<{
+            id: string;
+            created_at: number;
+            last_activity: number;
+            age_seconds: number;
+            inactive_seconds: number;
+            message_count: number;
+            notebook_url: string;
+        }>;
+    }>>;
+    /**
+     * Handle close_session tool
+     */
+    handleCloseSession(args: {
+        session_id: string;
+    }): Promise<ToolResult<{
+        status: string;
+        message: string;
+        session_id: string;
+    }>>;
+    /**
+     * Handle reset_session tool
+     */
+    handleResetSession(args: {
+        session_id: string;
+    }): Promise<ToolResult<{
+        status: string;
+        message: string;
+        session_id: string;
+    }>>;
+    /**
+     * Handle get_health tool
+     */
+    handleGetHealth(): Promise<ToolResult<{
+        status: string;
+        authenticated: boolean;
+        notebook_url: string;
+        active_sessions: number;
+        max_sessions: number;
+        session_timeout: number;
+        total_messages: number;
+        headless: boolean;
+        auto_login_enabled: boolean;
+        stealth_enabled: boolean;
+        troubleshooting_tip?: string;
+    }>>;
+    /**
+     * Handle setup_auth tool
+     *
+     * Opens a browser window for manual login with live progress updates.
+     * The operation waits synchronously for login completion (up to 10 minutes).
+     */
+    handleSetupAuth(args: {
+        show_browser?: boolean;
+        browser_options?: BrowserOptions;
+    }, sendProgress?: ProgressCallback): Promise<ToolResult<{
+        status: string;
+        message: string;
+        authenticated: boolean;
+        duration_seconds?: number;
+    }>>;
+    /**
+     * Handle re_auth tool
+     *
+     * Performs a complete re-authentication:
+     * 1. Closes all active browser sessions
+     * 2. Deletes all saved authentication data (cookies, Chrome profile)
+     * 3. Opens browser for fresh Google login
+     *
+     * Use for switching Google accounts or recovering from rate limits.
+     */
+    handleReAuth(args: {
+        show_browser?: boolean;
+        browser_options?: BrowserOptions;
+    }, sendProgress?: ProgressCallback): Promise<ToolResult<{
+        status: string;
+        message: string;
+        authenticated: boolean;
+        duration_seconds?: number;
+    }>>;
+    /**
+     * Handle add_notebook tool
+     */
+    handleAddNotebook(args: AddNotebookInput): Promise<ToolResult<{
+        notebook: any;
+    }>>;
+    /**
+     * Handle list_notebooks tool
+     */
+    handleListNotebooks(): Promise<ToolResult<{
+        notebooks: any[];
+        active_notebook_id: string | null;
+    }>>;
+    /**
+     * Handle get_notebook tool
+     */
+    handleGetNotebook(args: {
+        id: string;
+    }): Promise<ToolResult<{
+        notebook: any;
+    }>>;
+    /**
+     * Handle select_notebook tool
+     */
+    handleSelectNotebook(args: {
+        id: string;
+    }): Promise<ToolResult<{
+        notebook: any;
+    }>>;
+    /**
+     * Handle update_notebook tool
+     */
+    handleUpdateNotebook(args: UpdateNotebookInput): Promise<ToolResult<{
+        notebook: any;
+    }>>;
+    /**
+     * Handle remove_notebook tool
+     */
+    handleRemoveNotebook(args: {
+        id: string;
+    }): Promise<ToolResult<{
+        removed: boolean;
+        closed_sessions: number;
+    }>>;
+    /**
+     * Handle search_notebooks tool
+     */
+    handleSearchNotebooks(args: {
+        query: string;
+    }): Promise<ToolResult<{
+        notebooks: any[];
+    }>>;
+    /**
+     * Handle get_library_stats tool
+     */
+    handleGetLibraryStats(): Promise<ToolResult<any>>;
+    /**
+     * Handle cleanup_data tool
+     *
+     * ULTRATHINK Deep Cleanup - scans entire system for ALL NotebookLM MCP files
+     */
+    handleCleanupData(args: {
+        confirm: boolean;
+        preserve_library?: boolean;
+    }): Promise<ToolResult<{
+        status: string;
+        mode: string;
+        preview?: {
+            categories: Array<{
+                name: string;
+                description: string;
+                paths: string[];
+                totalBytes: number;
+                optional: boolean;
+            }>;
+            totalPaths: number;
+            totalSizeBytes: number;
+        };
+        result?: {
+            deletedPaths: string[];
+            failedPaths: string[];
+            totalSizeBytes: number;
+            categorySummary: Record<string, {
+                count: number;
+                bytes: number;
+            }>;
+        };
+    }>>;
+    /**
+     * Cleanup all resources (called on server shutdown)
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map