@pan-sec/notebooklm-mcp 1.4.0

package/dist/session/session-timeout.js

@@ -0,0 +1,281 @@
+/**
+ * Session Timeout Manager for NotebookLM MCP Server
+ *
+ * Provides configurable session timeout enforcement:
+ * - Hard timeout: Maximum session lifetime (default: 8 hours)
+ * - Inactivity timeout: Auto-logout after idle period (default: 30 minutes)
+ * - Warning callbacks before timeout
+ * - Memory scrubbing on timeout
+ *
+ * Added by Pantheon Security for hardened fork.
+ */
+import { audit } from "../utils/audit-logger.js";
+import { log } from "../utils/logger.js";
+/**
+ * Get timeout configuration from environment
+ */
+function getDefaultConfig() {
+    const maxLifetimeSec = parseInt(process.env.NLMCP_SESSION_MAX_LIFETIME || "28800", 10); // 8 hours
+    const inactivitySec = parseInt(process.env.NLMCP_SESSION_INACTIVITY_TIMEOUT || "1800", 10); // 30 minutes
+    const warningBeforeSec = parseInt(process.env.NLMCP_SESSION_WARNING_BEFORE || "300", 10); // 5 minutes
+    return {
+        maxLifetimeMs: maxLifetimeSec * 1000,
+        inactivityTimeoutMs: inactivitySec * 1000,
+        warningBeforeMs: warningBeforeSec * 1000,
+        enableHardTimeout: process.env.NLMCP_SESSION_HARD_TIMEOUT !== "false",
+        enableInactivityTimeout: process.env.NLMCP_SESSION_INACTIVITY !== "false",
+    };
+}
+/**
+ * Session Timeout Manager
+ *
+ * Manages session timeouts with configurable lifetime and inactivity limits.
+ */
+export class SessionTimeoutManager {
+    config;
+    sessions = new Map();
+    checkInterval = null;
+    onTimeout = null;
+    onWarning = null;
+    constructor(config) {
+        this.config = { ...getDefaultConfig(), ...config };
+        // Start periodic check
+        this.startPeriodicCheck();
+        log.info(`🕐 Session timeout manager initialized`);
+        log.info(`   Max lifetime: ${this.formatDuration(this.config.maxLifetimeMs)}`);
+        log.info(`   Inactivity timeout: ${this.formatDuration(this.config.inactivityTimeoutMs)}`);
+    }
+    /**
+     * Format duration for logging
+     */
+    formatDuration(ms) {
+        const seconds = Math.floor(ms / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    /**
+     * Register a new session
+     */
+    startSession(sessionId) {
+        const now = Date.now();
+        this.sessions.set(sessionId, {
+            sessionId,
+            createdAt: now,
+            lastActivity: now,
+            warningIssued: false,
+            inactivityWarningIssued: false,
+        });
+        log.info(`🕐 Session ${sessionId} registered with timeout manager`);
+        audit.session("session_timeout_started", sessionId, {
+            max_lifetime_ms: this.config.maxLifetimeMs,
+            inactivity_timeout_ms: this.config.inactivityTimeoutMs,
+        });
+    }
+    /**
+     * Update session activity (reset inactivity timer)
+     */
+    touchSession(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (state) {
+            state.lastActivity = Date.now();
+            state.inactivityWarningIssued = false; // Reset warning after activity
+        }
+    }
+    /**
+     * Remove a session from tracking
+     */
+    removeSession(sessionId) {
+        this.sessions.delete(sessionId);
+        log.info(`🕐 Session ${sessionId} removed from timeout manager`);
+    }
+    /**
+     * Check if a session has expired
+     */
+    isExpired(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state) {
+            return { expired: false };
+        }
+        const now = Date.now();
+        // Check hard timeout (max lifetime)
+        if (this.config.enableHardTimeout) {
+            const age = now - state.createdAt;
+            if (age >= this.config.maxLifetimeMs) {
+                return { expired: true, reason: "lifetime" };
+            }
+        }
+        // Check inactivity timeout
+        if (this.config.enableInactivityTimeout) {
+            const inactive = now - state.lastActivity;
+            if (inactive >= this.config.inactivityTimeoutMs) {
+                return { expired: true, reason: "inactivity" };
+            }
+        }
+        return { expired: false };
+    }
+    /**
+     * Get time remaining for a session
+     */
+    getTimeRemaining(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (!state) {
+            return null;
+        }
+        const now = Date.now();
+        const lifetimeRemaining = this.config.enableHardTimeout
+            ? Math.max(0, this.config.maxLifetimeMs - (now - state.createdAt))
+            : Infinity;
+        const inactivityRemaining = this.config.enableInactivityTimeout
+            ? Math.max(0, this.config.inactivityTimeoutMs - (now - state.lastActivity))
+            : Infinity;
+        return {
+            lifetime: lifetimeRemaining,
+            inactivity: inactivityRemaining,
+        };
+    }
+    /**
+     * Get session info for all tracked sessions
+     */
+    getAllSessionsInfo() {
+        const now = Date.now();
+        const results = [];
+        for (const state of this.sessions.values()) {
+            const remaining = this.getTimeRemaining(state.sessionId);
+            results.push({
+                sessionId: state.sessionId,
+                createdAt: state.createdAt,
+                lastActivity: state.lastActivity,
+                ageMs: now - state.createdAt,
+                inactiveMs: now - state.lastActivity,
+                lifetimeRemainingMs: remaining?.lifetime ?? 0,
+                inactivityRemainingMs: remaining?.inactivity ?? 0,
+            });
+        }
+        return results;
+    }
+    /**
+     * Set callback for when a session times out
+     */
+    setTimeoutCallback(callback) {
+        this.onTimeout = callback;
+    }
+    /**
+     * Set callback for timeout warnings
+     */
+    setWarningCallback(callback) {
+        this.onWarning = callback;
+    }
+    /**
+     * Start periodic timeout check
+     */
+    startPeriodicCheck() {
+        // Check every 30 seconds
+        this.checkInterval = setInterval(() => {
+            this.checkAllSessions();
+        }, 30000);
+        // Don't prevent process exit
+        this.checkInterval.unref();
+    }
+    /**
+     * Check all sessions for expiry and warnings
+     */
+    async checkAllSessions() {
+        const now = Date.now();
+        for (const state of this.sessions.values()) {
+            // Check for expiry
+            const expiry = this.isExpired(state.sessionId);
+            if (expiry.expired && expiry.reason) {
+                log.warning(`🕐 Session ${state.sessionId} expired due to ${expiry.reason}`);
+                await audit.session("session_timeout_expired", state.sessionId, {
+                    reason: expiry.reason,
+                    age_ms: now - state.createdAt,
+                    inactive_ms: now - state.lastActivity,
+                });
+                if (this.onTimeout) {
+                    await this.onTimeout(state.sessionId, expiry.reason);
+                }
+                this.sessions.delete(state.sessionId);
+                continue;
+            }
+            // Check for warnings
+            const remaining = this.getTimeRemaining(state.sessionId);
+            if (!remaining)
+                continue;
+            // Lifetime warning
+            if (this.config.enableHardTimeout &&
+                !state.warningIssued &&
+                remaining.lifetime <= this.config.warningBeforeMs) {
+                state.warningIssued = true;
+                log.warning(`🕐 Session ${state.sessionId} will expire in ${this.formatDuration(remaining.lifetime)} (max lifetime)`);
+                if (this.onWarning) {
+                    this.onWarning(state.sessionId, "lifetime", remaining.lifetime);
+                }
+                await audit.session("session_timeout_warning", state.sessionId, {
+                    reason: "lifetime",
+                    remaining_ms: remaining.lifetime,
+                });
+            }
+            // Inactivity warning
+            if (this.config.enableInactivityTimeout &&
+                !state.inactivityWarningIssued &&
+                remaining.inactivity <= this.config.warningBeforeMs) {
+                state.inactivityWarningIssued = true;
+                log.warning(`🕐 Session ${state.sessionId} will expire in ${this.formatDuration(remaining.inactivity)} (inactivity)`);
+                if (this.onWarning) {
+                    this.onWarning(state.sessionId, "inactivity", remaining.inactivity);
+                }
+                await audit.session("session_timeout_warning", state.sessionId, {
+                    reason: "inactivity",
+                    remaining_ms: remaining.inactivity,
+                });
+            }
+        }
+    }
+    /**
+     * Stop the timeout manager
+     */
+    stop() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+        this.sessions.clear();
+        log.info(`🕐 Session timeout manager stopped`);
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        log.info(`🕐 Session timeout config updated`);
+    }
+}
+/**
+ * Global timeout manager instance
+ */
+let globalTimeoutManager = null;
+/**
+ * Get or create the global timeout manager
+ */
+export function getSessionTimeoutManager() {
+    if (!globalTimeoutManager) {
+        globalTimeoutManager = new SessionTimeoutManager();
+    }
+    return globalTimeoutManager;
+}
+//# sourceMappingURL=session-timeout.js.map

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

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

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"}