@roomi-fields/notebooklm-mcp 2.0.4 → 2.1.0

package/README.md

@@ -4,7 +4,7 @@
 
 **Automate Google NotebookLM at scale. 33-endpoint HTTP REST API for n8n / Zapier / Make / curl, plus an MCP server for Claude Code / Cursor / Codex. Citation-backed Q&A, full Studio generation (audio · video · infographic · report · presentation · data table), multi-account rotation with auto-reauth.**
 
-> v2.0.4 — production-grade, batch-tested on overnight runs of 1 000+ questions. Tools are now a namespaced tree (`notebook_ask`, `source_add`, `session_list`…) with MCP `annotations` + `outputSchema` on every tool — **the old flat names still work as aliases, nothing breaks**. See the [changelog](./CHANGELOG.md) for the full mapping. [Compare with `PleasePrompto/notebooklm-mcp` v2.0.0](https://roomi-fields.github.io/notebooklm-mcp/compare) to see when this project is the right pick (REST API, full Studio, auto-reauth) and when the MCP-only upstream is.
+> v2.1.0 — production-grade, batch-tested on overnight runs of 1 000+ questions. Tools are now a namespaced tree (`notebook_ask`, `source_add`, `session_list`…) with MCP `annotations` + `outputSchema` on every tool — **the old flat names still work as aliases, nothing breaks**. See the [changelog](./CHANGELOG.md) for the full mapping. [Compare with `PleasePrompto/notebooklm-mcp` v2.0.0](https://roomi-fields.github.io/notebooklm-mcp/compare) to see when this project is the right pick (REST API, full Studio, auto-reauth) and when the MCP-only upstream is.
 
 <!-- Badges -->
 

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

@@ -10,6 +10,7 @@
  */
 import type { Page } from 'patchright';
 import type { SourceUploadInput, SourceUploadResult, SourceDeleteInput, SourceDeleteResult, ContentType, ContentGenerationInput, ContentGenerationResult, NotebookSource, GeneratedContent, NotebookContentOverview, ContentDownloadResult, NoteInput, NoteResult, SaveChatToNoteInput, SaveChatToNoteResult, NoteToSourceInput, NoteToSourceResult } from './types.js';
+import type { NoteListResult, NoteGetInput, NoteGetResult } from '../types.js';
 export declare class ContentManager {
     private page;
     constructor(page: Page);
@@ -368,5 +369,14 @@ export declare class ContentManager {
      * Extract the content of a note for fallback conversion
      */
     private extractNoteContent;
+    /**
+     * List all notes in the NotebookLM Studio panel.
+     * Handles scrolling inside the Studio panel to ensure all notes are loaded.
+     */
+    listNotes(): Promise<NoteListResult>;
+    /**
+     * Get the title and text content of a specific note by title or ID.
+     */
+    getNoteContent(input: NoteGetInput): Promise<NoteGetResult>;
 }
 //# sourceMappingURL=content-manager.d.ts.map

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

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

package/dist/content/content-manager.js

@@ -4009,6 +4009,8 @@ export class ContentManager {
     ) {
         // Selectors for note items in the Studio panel
         const noteItemSelectors = [
+            'artifact-library-note',
+            '[class*="artifact-item-button"]',
             '.note-item',
             '[data-item="note"]',
             '.notes-list-item',
@@ -4046,7 +4048,7 @@ export class ContentManager {
                         }
                         // Also check specific title elements
                         try {
-                            const titleText = await el.$eval('.note-title, .title, [class*="title"], [class*="name"], h3, h4', (e) => e.textContent?.trim() || '');
+                            const titleText = await el.$eval('.artifact-title, [class*="artifact-title"], .note-title, .title, [class*="title"], [class*="name"], h3, h4', (e) => e.textContent?.trim() || '');
                             if (titleText.toLowerCase().includes(noteTitle.toLowerCase())) {
                                 return el;
                             }
@@ -4248,7 +4250,209 @@ export class ContentManager {
             // Method 1: Click the note to open it and extract content
             await noteElement.click();
             await randomDelay(500, 1000);
-            // Look for expanded note content
+            /* @SDD:T1.1.1:START Implement robust table and note content DOM walker serialization */
+            // Wait for the note viewer to be visible
+            try {
+                await this.page.waitForSelector('labs-tailwind-doc-viewer:visible, note-editor:visible, .ProseMirror:visible', { timeout: 5000 });
+            }
+            catch {
+                log.warning('  ⚠️ Timeout waiting for note viewer to be visible, attempting fallback...');
+            }
+            // Try serialization on the active viewer element
+            const activeViewerSelector = 'labs-tailwind-doc-viewer:visible, note-editor:visible, .ProseMirror:visible';
+            const activeViewer = await this.page.$(activeViewerSelector);
+            if (activeViewer) {
+                const serialized = await activeViewer.evaluate((viewerEl) => {
+                    // Inline serialization helper for text nodes and elements
+                    function serializeInline(node) {
+                        let text = '';
+                        const childNodes = Array.from(node.childNodes);
+                        if (childNodes.length === 0) {
+                            return node.textContent || '';
+                        }
+                        for (const child of childNodes) {
+                            if (child.nodeType === 3) {
+                                // Node.TEXT_NODE
+                                text += child.textContent;
+                            }
+                            else if (child.nodeType === 1) {
+                                // Node.ELEMENT_NODE
+                                const elNode = child;
+                                const tagName = elNode.tagName.toLowerCase();
+                                const childText = serializeInline(elNode);
+                                if (tagName === 'b' || tagName === 'strong') {
+                                    text += `**${childText}**`;
+                                }
+                                else if (tagName === 'i' || tagName === 'em') {
+                                    text += `*${childText}*`;
+                                }
+                                else if (tagName === 'code' || elNode.classList.contains('code')) {
+                                    text += `\`${childText}\``;
+                                }
+                                else if (tagName === 'a') {
+                                    const href = elNode.getAttribute('href') || '';
+                                    text += `[${childText}](${href})`;
+                                }
+                                else {
+                                    text += childText;
+                                }
+                            }
+                        }
+                        return text;
+                    }
+                    const elementListRenderer = viewerEl.querySelector('element-list-renderer');
+                    if (!elementListRenderer) {
+                        // ProseMirror / semantic HTML fallback
+                        const editor = viewerEl.querySelector('.ProseMirror') || viewerEl;
+                        function serializeNode(node) {
+                            if (node.nodeType === 3) {
+                                // Node.TEXT_NODE
+                                return node.textContent || '';
+                            }
+                            if (node.nodeType !== 1) {
+                                // Node.ELEMENT_NODE
+                                return '';
+                            }
+                            const elNode = node;
+                            const tagName = elNode.tagName.toLowerCase();
+                            if (tagName === 'b' || tagName === 'strong') {
+                                return `**${Array.from(elNode.childNodes).map(serializeNode).join('')}**`;
+                            }
+                            if (tagName === 'i' || tagName === 'em') {
+                                return `*${Array.from(elNode.childNodes).map(serializeNode).join('')}*`;
+                            }
+                            if (tagName === 'code') {
+                                return `\`${elNode.textContent || ''}\``;
+                            }
+                            if (tagName === 'p') {
+                                return `${Array.from(elNode.childNodes).map(serializeNode).join('')}\n\n`;
+                            }
+                            if (tagName === 'h1') {
+                                return `# ${Array.from(elNode.childNodes).map(serializeNode).join('')}\n\n`;
+                            }
+                            if (tagName === 'h2') {
+                                return `## ${Array.from(elNode.childNodes).map(serializeNode).join('')}\n\n`;
+                            }
+                            if (tagName === 'h3') {
+                                return `### ${Array.from(elNode.childNodes).map(serializeNode).join('')}\n\n`;
+                            }
+                            if (tagName === 'ul') {
+                                return `${Array.from(elNode.childNodes).map(serializeNode).join('')}\n`;
+                            }
+                            if (tagName === 'li') {
+                                return `* ${Array.from(elNode.childNodes).map(serializeNode).join('')}\n`;
+                            }
+                            if (tagName === 'table') {
+                                let tableMd = '\n';
+                                const rows = Array.from(elNode.querySelectorAll('tr'));
+                                rows.forEach((row, rowIndex) => {
+                                    const cells = Array.from(row.querySelectorAll('th, td'));
+                                    const cellTexts = cells.map((cell) => Array.from(cell.childNodes).map(serializeNode).join('').trim());
+                                    tableMd += `| ${cellTexts.join(' | ')} |\n`;
+                                    if (rowIndex === 0) {
+                                        const separator = cellTexts.map(() => '---');
+                                        tableMd += `| ${separator.join(' | ')} |\n`;
+                                    }
+                                });
+                                return tableMd + '\n';
+                            }
+                            if (tagName === 'pre') {
+                                return `\n\`\`\`\n${elNode.textContent?.trim() || ''}\n\`\`\`\n\n`;
+                            }
+                            return Array.from(elNode.childNodes).map(serializeNode).join('');
+                        }
+                        return Array.from(editor.childNodes)
+                            .map(serializeNode)
+                            .join('')
+                            .replace(/\n{3,}/g, '\n\n')
+                            .trim();
+                    }
+                    let markdown = '';
+                    const structuralElements = Array.from(elementListRenderer.children);
+                    function processStructuralElement(el) {
+                        const tableView = el.querySelector('table-element-view');
+                        if (tableView) {
+                            const table = tableView.querySelector('table');
+                            if (table) {
+                                const rows = Array.from(table.querySelectorAll('tr'));
+                                if (rows.length === 0)
+                                    return;
+                                let tableMarkdown = '\n';
+                                rows.forEach((row, rowIndex) => {
+                                    const cells = Array.from(row.querySelectorAll('th, td'));
+                                    const cellTexts = cells.map((cell) => {
+                                        const paragraph = cell.querySelector('.paragraph');
+                                        if (paragraph) {
+                                            return serializeInline(paragraph).trim();
+                                        }
+                                        return serializeInline(cell).trim();
+                                    });
+                                    tableMarkdown += `| ${cellTexts.join(' | ')} |\n`;
+                                    if (rowIndex === 0) {
+                                        const separator = cellTexts.map(() => '---');
+                                        tableMarkdown += `| ${separator.join(' | ')} |\n`;
+                                    }
+                                });
+                                markdown += tableMarkdown + '\n';
+                            }
+                            return;
+                        }
+                        const paragraphView = el.querySelector('paragraph-element-view');
+                        if (paragraphView) {
+                            const textContainer = paragraphView.querySelector('.paragraph');
+                            if (textContainer) {
+                                const text = serializeInline(textContainer).trim();
+                                if (!text)
+                                    return;
+                                if (textContainer.classList.contains('list-item') ||
+                                    textContainer.tagName.toLowerCase() === 'li') {
+                                    markdown += `* ${text}\n`;
+                                }
+                                else if (textContainer.classList.contains('heading1')) {
+                                    markdown += `\n# ${text}\n\n`;
+                                }
+                                else if (textContainer.classList.contains('heading2')) {
+                                    markdown += `\n## ${text}\n\n`;
+                                }
+                                else if (textContainer.classList.contains('heading3')) {
+                                    markdown += `\n### ${text}\n\n`;
+                                }
+                                else {
+                                    if (!textContainer.classList.contains('table-paragraph')) {
+                                        markdown += `${text}\n\n`;
+                                    }
+                                }
+                            }
+                            return;
+                        }
+                        const preEl = el.querySelector('pre, code');
+                        if (preEl) {
+                            markdown += `\n\`\`\`\n${preEl.textContent?.trim() || ''}\n\`\`\`\n\n`;
+                            return;
+                        }
+                    }
+                    for (const structuralEl of structuralElements) {
+                        const tagName = structuralEl.tagName.toLowerCase();
+                        if (tagName !== 'labs-tailwind-structural-element-view-v2') {
+                            if (tagName === 'ul' || tagName === 'ol') {
+                                const nestedElements = Array.from(structuralEl.querySelectorAll('labs-tailwind-structural-element-view-v2'));
+                                for (const nestedEl of nestedElements) {
+                                    processStructuralElement(nestedEl);
+                                }
+                            }
+                            continue;
+                        }
+                        processStructuralElement(structuralEl);
+                    }
+                    return markdown.replace(/\n{3,}/g, '\n\n').trim();
+                });
+                if (serialized && serialized.length > 10) {
+                    log.info(`  ✅ Serialized note content via DOM walker (${serialized.length} chars)`);
+                    return noteTitle ? `# ${noteTitle}\n\n${serialized}` : serialized;
+                }
+            }
+            /* @SDD:T1.1.1:END */
+            // Fallback method to existing selectors
             const contentSelectors = [
                 // Note body/content areas
                 '.note-content',
@@ -4318,5 +4522,132 @@ export class ContentManager {
             return null;
         }
     }
+    /**
+     * List all notes in the NotebookLM Studio panel.
+     * Handles scrolling inside the Studio panel to ensure all notes are loaded.
+     */
+    async listNotes() {
+        log.info(`📚 Listing notes in Studio panel...`);
+        try {
+            // Step 1: Ensure we are in the Studio panel
+            await this.navigateToStudio();
+            await randomDelay(1000, 2000);
+            // Step 2: Locate the scrollable container in the Studio panel
+            const scrollContainerSelector = '.studio-panel, [class*="studio-panel"]';
+            const containerExists = (await this.page.locator(scrollContainerSelector).count()) > 0;
+            if (containerExists) {
+                // Scroll the panel down a few times to trigger lazy load of old notes
+                log.info('  ⏳ Scrolling Studio panel to load all notes...');
+                for (let i = 0; i < 5; i++) {
+                    await this.page.evaluate((selector) => {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const panel = globalThis.document.querySelector(selector);
+                        if (panel) {
+                            panel.scrollTop = panel.scrollHeight;
+                        }
+                    }, scrollContainerSelector);
+                    await randomDelay(300, 500);
+                }
+            }
+            // Step 3: Scrape note elements from the DOM
+            const notes = [];
+            const seenTitles = new Set();
+            // Selectors based on verified DOM structure
+            const noteItemSelector = 'artifact-library-note, [class*="artifact-item-button"]';
+            const noteElements = await this.page.locator(noteItemSelector).all();
+            log.info(`  🔍 Found ${noteElements.length} candidate note elements`);
+            for (const el of noteElements) {
+                try {
+                    const titleText = (await el
+                        .locator('.artifact-title, [class*="artifact-title"]')
+                        .first()
+                        .textContent()) || '';
+                    const detailsText = (await el
+                        .locator('.artifact-details, [class*="artifact-details"]')
+                        .first()
+                        .textContent()) || '';
+                    const noteId = (await el.getAttribute('data-note-id')) ||
+                        (await el.getAttribute('data-id')) ||
+                        undefined;
+                    const title = titleText.trim();
+                    if (title && !seenTitles.has(title)) {
+                        seenTitles.add(title);
+                        notes.push({
+                            id: noteId,
+                            title,
+                            details: detailsText.trim() || undefined,
+                        });
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            log.success(`  ✅ Successfully listed ${notes.length} notes`);
+            return { success: true, notes };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            log.error(`  ❌ Failed to list notes: ${errorMsg}`);
+            return { success: false, notes: [], error: errorMsg };
+        }
+    }
+    /**
+     * Get the title and text content of a specific note by title or ID.
+     */
+    async getNoteContent(input) {
+        const { noteTitle, noteId } = input;
+        log.info(`📄 Fetching content of note: "${noteTitle || noteId}"`);
+        try {
+            await this.navigateToStudio();
+            await randomDelay(500, 1000);
+            // Reuse existing helper to find the note element
+            const noteElement = await this.findNoteElement(noteTitle, noteId);
+            if (!noteElement) {
+                return {
+                    success: false,
+                    title: noteTitle || '',
+                    content: '',
+                    error: `Note not found: "${noteTitle || noteId}"`,
+                };
+            }
+            // Reuse existing helper to click note, wait, and extract content text
+            const content = await this.extractNoteContent(noteElement, noteTitle);
+            // Close the note popover/editor if open to return to clean state
+            try {
+                await this.page.keyboard.press('Escape');
+                await randomDelay(200, 400);
+            }
+            catch {
+                // Ignore escape errors
+            }
+            if (content) {
+                log.success(`  ✅ Retrieved note content (${content.length} characters)`);
+                return {
+                    success: true,
+                    title: noteTitle || '',
+                    content,
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    title: noteTitle || '',
+                    content: '',
+                    error: 'Could not extract content from note editor.',
+                };
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            log.error(`  ❌ Failed to get note content: ${errorMsg}`);
+            return {
+                success: false,
+                title: noteTitle || '',
+                content: '',
+                error: errorMsg,
+            };
+        }
+    }
 }
 //# sourceMappingURL=content-manager.js.map