notebooklm-mcp-ultimate 2.2.1

package/dist/operations/hybrid-executor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Hybrid Executor
+ *
+ * Provides API-first execution with browser fallback for improved reliability.
+ * This is a simplified version focusing on core retry and fallback logic.
+ */
+/**
+ * Options for hybrid execution
+ */
+export interface HybridExecutionOptions {
+    /** Maximum number of retries for API operation */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds */
+    retryDelay?: number;
+    /** Whether to use exponential backoff */
+    exponentialBackoff?: boolean;
+    /** Timeout for each operation in milliseconds */
+    timeout?: number;
+}
+/**
+ * Result of hybrid execution
+ */
+export interface HybridExecutionResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    executionMethod: 'api' | 'browser' | 'failed';
+    retriesUsed: number;
+}
+/**
+ * Execute with API-first strategy and browser fallback
+ *
+ * @param apiOperation - Primary API operation to execute
+ * @param browserOperation - Fallback browser operation (optional)
+ * @param options - Execution options
+ * @returns Hybrid execution result
+ */
+export declare function executeWithFallback<T>(apiOperation: () => Promise<T>, browserOperation?: () => Promise<T>, options?: HybridExecutionOptions): Promise<HybridExecutionResult<T>>;
+/**
+ * Execute API operation with retry logic only (no browser fallback)
+ *
+ * @param operation - API operation to execute
+ * @param options - Execution options
+ * @returns Execution result
+ */
+export declare function executeWithRetry<T>(operation: () => Promise<T>, options?: HybridExecutionOptions): Promise<HybridExecutionResult<T>>;
+//# sourceMappingURL=hybrid-executor.d.ts.map

package/dist/operations/hybrid-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-executor.d.ts","sourceRoot":"","sources":["../../src/operations/hybrid-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;CACvB;AAkCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACvC,YAAY,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC9B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAuEnC;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAEnC"}

package/dist/operations/hybrid-executor.js

@@ -0,0 +1,114 @@
+/**
+ * Hybrid Executor
+ *
+ * Provides API-first execution with browser fallback for improved reliability.
+ * This is a simplified version focusing on core retry and fallback logic.
+ */
+import { log } from '../utils/logger.js';
+/**
+ * Default options
+ */
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    retryDelay: 1000,
+    exponentialBackoff: true,
+    timeout: 30000,
+};
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Execute operation with timeout
+ */
+async function withTimeout(operation, timeoutMs) {
+    return Promise.race([
+        operation(),
+        new Promise((_, reject) => setTimeout(() => reject(new Error('Operation timeout')), timeoutMs)),
+    ]);
+}
+/**
+ * Execute with API-first strategy and browser fallback
+ *
+ * @param apiOperation - Primary API operation to execute
+ * @param browserOperation - Fallback browser operation (optional)
+ * @param options - Execution options
+ * @returns Hybrid execution result
+ */
+export async function executeWithFallback(apiOperation, browserOperation, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let retriesUsed = 0;
+    let lastError;
+    // Try API operation with retries
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            log.info(`🔄 Attempting API operation (attempt ${attempt + 1}/${opts.maxRetries + 1})`);
+            const result = await withTimeout(apiOperation, opts.timeout);
+            log.success(`✅ API operation succeeded on attempt ${attempt + 1}`);
+            return {
+                success: true,
+                data: result,
+                executionMethod: 'api',
+                retriesUsed: attempt,
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            retriesUsed = attempt;
+            if (attempt < opts.maxRetries) {
+                const delay = opts.exponentialBackoff
+                    ? opts.retryDelay * Math.pow(2, attempt)
+                    : opts.retryDelay;
+                log.warning(`⚠️  API attempt ${attempt + 1} failed: ${lastError.message}. Retrying in ${delay}ms...`);
+                await sleep(delay);
+            }
+            else {
+                log.error(`❌ API operation failed after ${attempt + 1} attempts`);
+            }
+        }
+    }
+    // If browser operation is provided, try it as fallback
+    if (browserOperation) {
+        try {
+            log.info('🌐 Falling back to browser operation...');
+            const result = await withTimeout(browserOperation, opts.timeout);
+            log.success('✅ Browser operation succeeded');
+            return {
+                success: true,
+                data: result,
+                executionMethod: 'browser',
+                retriesUsed,
+            };
+        }
+        catch (error) {
+            const browserError = error instanceof Error ? error : new Error(String(error));
+            log.error(`❌ Browser operation also failed: ${browserError.message}`);
+            return {
+                success: false,
+                error: `Both API and browser operations failed. Last API error: ${lastError?.message}. Browser error: ${browserError.message}`,
+                executionMethod: 'failed',
+                retriesUsed,
+            };
+        }
+    }
+    // No browser fallback available
+    return {
+        success: false,
+        error: `API operation failed after ${retriesUsed + 1} attempts: ${lastError?.message}`,
+        executionMethod: 'failed',
+        retriesUsed,
+    };
+}
+/**
+ * Execute API operation with retry logic only (no browser fallback)
+ *
+ * @param operation - API operation to execute
+ * @param options - Execution options
+ * @returns Execution result
+ */
+export async function executeWithRetry(operation, options = {}) {
+    return executeWithFallback(operation, undefined, options);
+}
+//# sourceMappingURL=hybrid-executor.js.map

package/dist/operations/hybrid-executor.js.map

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

package/dist/operations/notebook-crud-operations.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Notebook CRUD Operations for NotebookLM
+ *
+ * Provides high-level operations for creating and renaming notebooks
+ * directly via the NotebookLM API (not browser automation).
+ *
+ * Supported operations:
+ * - Create notebook
+ * - Rename notebook (remote)
+ */
+/**
+ * Result of a notebook CRUD operation
+ */
+export interface NotebookCRUDResult {
+    success: boolean;
+    notebookId?: string;
+    title?: string;
+    error?: string;
+    url?: string;
+}
+/**
+ * Create a new notebook in NotebookLM
+ *
+ * @param title - Optional title for the notebook (defaults to "Untitled notebook")
+ * @returns Result with notebook ID and URL
+ */
+export declare function createNotebook(title?: string): Promise<NotebookCRUDResult>;
+/**
+ * Rename a notebook in NotebookLM
+ *
+ * @param notebookId - The notebook ID to rename
+ * @param newTitle - The new title for the notebook
+ * @returns Result indicating success or failure
+ */
+export declare function renameNotebook(notebookId: string, newTitle: string): Promise<NotebookCRUDResult>;
+/**
+ * Delete a notebook in NotebookLM
+ *
+ * @param notebookId - The notebook ID to delete
+ * @returns Result indicating success or failure
+ */
+export declare function deleteNotebookRemote(notebookId: string): Promise<NotebookCRUDResult>;
+/**
+ * Upload a file source to a notebook via browser automation
+ * Supports PDF, docs, images, audio files
+ *
+ * @param notebookId - The notebook ID to add source to
+ * @param filePath - Absolute path to the file to upload
+ * @returns Result with upload status
+ */
+export declare function addFileSource(notebookId: string, filePath: string): Promise<NotebookCRUDResult>;
+//# sourceMappingURL=notebook-crud-operations.d.ts.map

package/dist/operations/notebook-crud-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-crud-operations.d.ts","sourceRoot":"","sources":["../../src/operations/notebook-crud-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAChC,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA6C7B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAwC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAgF7B"}

package/dist/operations/notebook-crud-operations.js

@@ -0,0 +1,248 @@
+/**
+ * Notebook CRUD Operations for NotebookLM
+ *
+ * Provides high-level operations for creating and renaming notebooks
+ * directly via the NotebookLM API (not browser automation).
+ *
+ * Supported operations:
+ * - Create notebook
+ * - Rename notebook (remote)
+ */
+import { getAPIClient } from '../api/index.js';
+import { initializeAPIClientWithCookies } from '../auth/cookie-store.js';
+import { log } from '../utils/logger.js';
+import { chromium } from 'patchright';
+import { AuthManager } from '../auth/auth-manager.js';
+import * as fs from 'fs';
+import * as path from 'path';
+/** Validates notebook ID format (basic non-empty check) */
+function validateNotebookId(notebookId) {
+    if (!notebookId || typeof notebookId !== 'string' || !notebookId.trim()) {
+        return 'Notebook ID is required';
+    }
+    return null; // Valid
+}
+/**
+ * Get an initialized API client
+ */
+async function getInitializedClient() {
+    const client = getAPIClient();
+    // Check if already initialized
+    if (client.hasValidAuth()) {
+        return client;
+    }
+    // Try to initialize from cookie store
+    const success = await initializeAPIClientWithCookies(client);
+    if (!success) {
+        log.warning('API client not initialized. Please run setup_auth.');
+        return null;
+    }
+    return client;
+}
+/**
+ * Create a new notebook in NotebookLM
+ *
+ * @param title - Optional title for the notebook (defaults to "Untitled notebook")
+ * @returns Result with notebook ID and URL
+ */
+export async function createNotebook(title) {
+    const client = await getInitializedClient();
+    if (!client) {
+        return {
+            success: false,
+            error: 'API client not initialized. Please run setup_auth first.',
+        };
+    }
+    try {
+        log.info(`Creating notebook${title ? `: ${title}` : ''}...`);
+        const notebookId = await client.createNotebook(title);
+        if (!notebookId) {
+            return {
+                success: false,
+                error: 'Failed to create notebook - no ID returned',
+            };
+        }
+        const url = `https://notebooklm.google.com/notebook/${notebookId}`;
+        log.success(`Notebook created: ${notebookId}`);
+        return {
+            success: true,
+            notebookId,
+            title: title || 'Untitled notebook',
+            url,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to create notebook: ${error}`,
+        };
+    }
+}
+/**
+ * Rename a notebook in NotebookLM
+ *
+ * @param notebookId - The notebook ID to rename
+ * @param newTitle - The new title for the notebook
+ * @returns Result indicating success or failure
+ */
+export async function renameNotebook(notebookId, newTitle) {
+    const idError = validateNotebookId(notebookId);
+    if (idError) {
+        return { success: false, error: idError, notebookId };
+    }
+    if (!newTitle || typeof newTitle !== 'string' || !newTitle.trim()) {
+        return { success: false, error: 'New title is required and must be non-empty', notebookId };
+    }
+    const client = await getInitializedClient();
+    if (!client) {
+        return {
+            success: false,
+            error: 'API client not initialized. Please run setup_auth first.',
+        };
+    }
+    try {
+        log.info(`Renaming notebook ${notebookId} to "${newTitle}"...`);
+        const success = await client.renameNotebook(notebookId, newTitle);
+        if (!success) {
+            return {
+                success: false,
+                error: 'Failed to rename notebook',
+                notebookId,
+            };
+        }
+        log.success(`Notebook renamed to: ${newTitle}`);
+        return {
+            success: true,
+            notebookId,
+            title: newTitle,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to rename notebook: ${error}`,
+            notebookId,
+        };
+    }
+}
+/**
+ * Delete a notebook in NotebookLM
+ *
+ * @param notebookId - The notebook ID to delete
+ * @returns Result indicating success or failure
+ */
+export async function deleteNotebookRemote(notebookId) {
+    const idError = validateNotebookId(notebookId);
+    if (idError) {
+        return { success: false, error: idError, notebookId };
+    }
+    const client = await getInitializedClient();
+    if (!client) {
+        return {
+            success: false,
+            error: 'API client not initialized. Please run setup_auth first.',
+        };
+    }
+    try {
+        log.info(`Deleting notebook ${notebookId}...`);
+        const success = await client.deleteNotebook(notebookId);
+        if (!success) {
+            return {
+                success: false,
+                error: 'Failed to delete notebook',
+                notebookId,
+            };
+        }
+        log.success(`Notebook deleted: ${notebookId}`);
+        return {
+            success: true,
+            notebookId,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to delete notebook: ${error}`,
+            notebookId,
+        };
+    }
+}
+/**
+ * Upload a file source to a notebook via browser automation
+ * Supports PDF, docs, images, audio files
+ *
+ * @param notebookId - The notebook ID to add source to
+ * @param filePath - Absolute path to the file to upload
+ * @returns Result with upload status
+ */
+export async function addFileSource(notebookId, filePath) {
+    const idError = validateNotebookId(notebookId);
+    if (idError) {
+        return { success: false, error: idError, notebookId };
+    }
+    // Validate path is absolute and not traversing
+    if (!path.isAbsolute(filePath)) {
+        return { success: false, error: 'File path must be absolute', notebookId };
+    }
+    const normalizedPath = path.normalize(filePath);
+    if (normalizedPath !== filePath || filePath.includes('..')) {
+        return { success: false, error: 'Invalid file path (path traversal not allowed)', notebookId };
+    }
+    // Validate file exists
+    if (!fs.existsSync(filePath)) {
+        return {
+            success: false,
+            error: `File not found: ${filePath}`,
+            notebookId,
+        };
+    }
+    const authManager = new AuthManager();
+    const statePath = await authManager.getValidStatePath();
+    if (!statePath) {
+        return {
+            success: false,
+            error: 'Not authenticated. Please run setup_auth first.',
+            notebookId,
+        };
+    }
+    let browser;
+    try {
+        log.info(`Uploading file to notebook ${notebookId}: ${path.basename(filePath)}`);
+        // Launch browser with saved state
+        browser = await chromium.launch({ headless: true });
+        const context = await browser.newContext({ storageState: statePath });
+        const page = await context.newPage();
+        // Navigate to notebook
+        const notebookUrl = `https://notebooklm.google.com/notebook/${notebookId}`;
+        await page.goto(notebookUrl, { waitUntil: 'networkidle', timeout: 30000 });
+        // Click "Add sources" button
+        await page.click('button:has-text("Add sources")', { timeout: 10000 });
+        await page.waitForTimeout(1000);
+        // Click "Upload files" button in dialog
+        await page.click('button:has-text("Upload files")', { timeout: 10000 });
+        // Wait for file input and set file
+        const fileInput = await page.waitForSelector('input[type="file"]', { timeout: 10000 });
+        await fileInput.setInputFiles(filePath);
+        // Wait for upload to complete (source appears in list)
+        await page.waitForSelector('.source-item, [class*="source"]', { timeout: 60000 });
+        log.success(`File uploaded: ${path.basename(filePath)}`);
+        return {
+            success: true,
+            notebookId,
+            title: path.basename(filePath),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to upload file: ${error}`,
+            notebookId,
+        };
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+    }
+}
+//# sourceMappingURL=notebook-crud-operations.js.map

package/dist/operations/notebook-crud-operations.js.map

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

package/dist/operations/research-operations.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Research Operations for NotebookLM
+ *
+ * Provides research and source discovery operations.
+ *
+ * Note: NotebookLM API doesn't have native research/discovery endpoints,
+ * so these operations provide suggestions and workflows rather than
+ * actual web search functionality.
+ */
+/**
+ * Result of a research operation
+ */
+export interface ResearchOperationResult {
+    success: boolean;
+    suggestions?: string[];
+    sources?: string[];
+    message?: string;
+    error?: string;
+    notebookId?: string;
+}
+/**
+ * Discover potential sources for a topic
+ *
+ * Returns search query suggestions and recommended source types.
+ * Users can then manually search and use import_source to add them.
+ */
+export declare function discoverSources(topic: string, notebookId?: string): Promise<ResearchOperationResult>;
+/**
+ * Import a source URL into a notebook
+ *
+ * Validates the URL and adds it as a source.
+ * This is a wrapper around addURLSource with additional validation.
+ */
+export declare function importSource(url: string, notebookId: string): Promise<ResearchOperationResult>;
+/**
+ * Research a topic and optionally import sources
+ *
+ * Combines discovery and import in a single workflow.
+ * If autoImport is true, attempts to import suggested sources.
+ */
+export declare function researchTopic(topic: string, notebookId: string, autoImport?: boolean): Promise<ResearchOperationResult>;
+//# sourceMappingURL=research-operations.d.ts.map

package/dist/operations/research-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-operations.d.ts","sourceRoot":"","sources":["../../src/operations/research-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAqBD;;;;;GAKG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAkElC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,OAAe,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAiDlC"}