notelm-mcp 1.2.1

package/dist/src/scripts/health-check.js

@@ -0,0 +1,100 @@
+/**
+ * UI Health Check Script
+ *
+ * Verifies:
+ * 1. Authentication status (cookies)
+ * 2. NotebookLM connectivity (navigation)
+ * 3. Chat Input Selector validation (critical for operation)
+ *
+ * Usage:
+ *   npx tsx src/scripts/health-check.ts
+ */
+import { AuthManager } from "../auth/auth-manager.js";
+import { SessionManager } from "../session/session-manager.js";
+import { CONFIG } from "../config.js";
+import { log } from "../utils/logger.js";
+import { NOTEBOOKLM_URL_PREFIX } from "../constants.js";
+async function runHealthCheck() {
+    log.info("🏥 Starting NotebookLM MCP Health Check...");
+    log.info(`  📅 Date: ${new Date().toISOString()}`);
+    log.info(`  🔗 Notebook URL: ${CONFIG.notebookUrl || "Not set (will use default/random)"}`);
+    const authManager = new AuthManager();
+    const sessionManager = new SessionManager(authManager);
+    let success = false;
+    try {
+        // 1. Check Authentication State
+        log.info("\n🔍 1. Checking Authentication State...");
+        const statePath = await authManager.getValidStatePath();
+        if (!statePath) {
+            log.error("  ❌ No valid authentication state found.");
+            log.info("  💡 Run 'setup_auth' to authenticate first.");
+            process.exit(1);
+        }
+        log.success("  ✅ Valid authentication state found");
+        // 2. Initialize Browser Session (Headless)
+        log.info("\n🔍 2. Initializing Browser Session...");
+        // Force specific notebook URL if set, or use default if available
+        const notebookUrl = CONFIG.notebookUrl;
+        if (!notebookUrl) {
+            log.error("  ❌ NOTEBOOK_URL env var is not set. Cannot run UI check without a target notebook.");
+            process.exit(1);
+        }
+        const session = await sessionManager.getOrCreateSession("health-check-session", notebookUrl, true // Force headless for health check
+        );
+        // 3. Verify Navigation
+        log.info("\n🔍 3. Verifying Navigation...");
+        await session.init();
+        const page = session.getPage();
+        if (!page) {
+            throw new Error("Page initialization failed");
+        }
+        const url = page.url();
+        if (url.startsWith(NOTEBOOKLM_URL_PREFIX)) {
+            log.success(`  ✅ Navigated to NotebookLM: ${url.substring(0, 50)}...`);
+        }
+        else {
+            log.error(`  ❌ Navigation failed. Current URL: ${url}`);
+            throw new Error("Navigation failed");
+        }
+        // 4. Validate Selectors
+        log.info("\n🔍 4. Validating UI Selectors...");
+        // Access private findChatInput via any cast for testing, or use public method if available
+        // BrowserSession doesn't expose findChatInput publicly, but ask() uses it.
+        // We can manually check using the constants.
+        // Actually, let's use the session methods if possible, or just replicate the check
+        // Since we are inside the codebase, we can import CHAT_INPUT_SELECTORS
+        // We can't easily access private method, but we can verify if we can find the element
+        // Let's use internal page instance
+        const { CHAT_INPUT_SELECTORS } = await import("../constants.js");
+        let foundSelector = null;
+        for (const selector of CHAT_INPUT_SELECTORS) {
+            if (await page.isVisible(selector)) {
+                foundSelector = selector;
+                break;
+            }
+        }
+        if (foundSelector) {
+            log.success(`  ✅ Chat Input found using selector: "${foundSelector}"`);
+        }
+        else {
+            log.error("  ❌ Chat Input NOT found with any known selector!");
+            log.error(`  Tried: ${CHAT_INPUT_SELECTORS.join(", ")}`);
+            throw new Error("UI Selector Validation Failed");
+        }
+        // Success!
+        success = true;
+        log.success("\n✨ Health Check PASSED! System is fully operational.");
+    }
+    catch (error) {
+        log.error(`\n💥 Health Check FAILED: ${error}`);
+        success = false;
+    }
+    finally {
+        // Cleanup
+        log.info("\n🧹 Cleaning up...");
+        await sessionManager.closeAllSessions();
+        process.exit(success ? 0 : 1);
+    }
+}
+runHealthCheck();
+//# sourceMappingURL=health-check.js.map

package/dist/src/scripts/health-check.js.map

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

package/dist/src/session/browser-session.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Browser Session
+ *
+ * Represents a single browser session for NotebookLM interactions.
+ *
+ * Features:
+ * - Human-like question typing
+ * - Streaming response detection
+ * - Auto-login on session expiry
+ * - Session activity tracking
+ * - Chat history reset
+ *
+ * Based on the Python implementation from browser_session.py
+ */
+import type { Page } from "patchright";
+import { SharedContextManager } from "./shared-context-manager.js";
+import { AuthManager } from "../auth/auth-manager.js";
+import type { SessionInfo, ProgressCallback } from "../types.js";
+export declare class BrowserSession {
+    readonly sessionId: string;
+    readonly notebookUrl: string;
+    readonly createdAt: number;
+    lastActivity: number;
+    messageCount: number;
+    private context;
+    private sharedContextManager;
+    private authManager;
+    private page;
+    private initialized;
+    constructor(sessionId: string, sharedContextManager: SharedContextManager, authManager: AuthManager, notebookUrl: string);
+    /**
+     * Initialize the session by creating a page and navigating to the notebook
+     */
+    init(): Promise<void>;
+    /**
+     * Wait for NotebookLM interface to be ready
+     *
+     * IMPORTANT: Matches Python implementation EXACTLY!
+     * - Uses SPECIFIC selectors (textarea.query-box-input)
+     * - Checks ONLY for "visible" state (NOT disabled!)
+     * - NO placeholder checks (let NotebookLM handle that!)
+     *
+     * Based on Python _wait_for_ready() from browser_session.py:104-113
+     */
+    private waitForNotebookLMReady;
+    private isPageClosedSafe;
+    /**
+     * Ensure the session is authenticated, perform auto-login if needed
+     */
+    private ensureAuthenticated;
+    private getOriginFromUrl;
+    /**
+     * Safely restore sessionStorage when the page is on the expected origin
+     */
+    private restoreSessionStorage;
+    /**
+     * Ask a question to NotebookLM
+     */
+    ask(question: string, sendProgress?: ProgressCallback): Promise<string>;
+    /**
+     * Find the chat input element
+     *
+     * IMPORTANT: Matches Python implementation EXACTLY!
+     * - Uses SPECIFIC selectors from Python
+     * - Checks ONLY visibility (NOT disabled state!)
+     *
+     * Based on Python ask() method from browser_session.py:166-171
+     */
+    private findChatInput;
+    /**
+     * Detect if a rate limit error occurred
+     *
+     * Searches the page for error messages indicating rate limit/quota exhaustion.
+     * Free NotebookLM accounts have 50 queries/day limit.
+     *
+     * @returns true if rate limit error detected, false otherwise
+     */
+    private detectRateLimitError;
+    /**
+     * Reset the chat history (start a new conversation)
+     */
+    reset(): Promise<void>;
+    /**
+     * Close the session
+     */
+    close(): Promise<void>;
+    /**
+     * Update last activity timestamp
+     */
+    updateActivity(): void;
+    /**
+     * Check if session has expired (inactive for too long)
+     */
+    isExpired(timeoutSeconds: number): boolean;
+    /**
+     * Get session information
+     */
+    getInfo(): SessionInfo;
+    /**
+     * Get the underlying page (for advanced operations)
+     */
+    getPage(): Page | null;
+    /**
+     * Check if session is initialized
+     */
+    isInitialized(): boolean;
+}
+//# sourceMappingURL=browser-session.d.ts.map

package/dist/src/session/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../../../src/session/browser-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAkB,IAAI,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQtD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKjE,qBAAa,cAAc;IACzB,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,WAAW,CAAkB;gBAGnC,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,oBAAoB,EAC1C,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM;IAarB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqF3B;;;;;;;;;OASG;YACW,sBAAsB;IA4CpC,OAAO,CAAC,gBAAgB;IAexB;;OAEG;YACW,mBAAmB;IAwEjC,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;YACW,qBAAqB;IA6DnC;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiH7E;;;;;;;;OAQG;YACW,aAAa;IAoC3B;;;;;;;OAOG;YACW,oBAAoB;IAuFlC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAK1C;;OAEG;IACH,OAAO,IAAI,WAAW;IAatB;;OAEG;IACH,OAAO,IAAI,IAAI,GAAG,IAAI;IAItB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}