@roomi-fields/notebooklm-mcp 1.3.5 → 1.5.0

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

@@ -0,0 +1,364 @@
+/**
+ * Content Manager
+ *
+ * Handles NotebookLM content operations:
+ * - Source/document upload
+ * - Content generation (audio, briefing, study guides, etc.)
+ * - Content listing and download
+ *
+ * Uses Playwright to interact with NotebookLM's web interface.
+ */
+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';
+export declare class ContentManager {
+    private page;
+    constructor(page: Page);
+    /**
+     * Add a source to the current notebook
+     */
+    addSource(input: SourceUploadInput): Promise<SourceUploadResult>;
+    /**
+     * Click the "Add source" button
+     */
+    private clickAddSource;
+    /**
+     * Ensure we're on the Sources panel
+     */
+    private ensureSourcesPanel;
+    /**
+     * Debug helper to log page content for selector debugging
+     */
+    private debugPageContent;
+    /**
+     * Wait for upload dialog to appear
+     */
+    private waitForUploadDialog;
+    /**
+     * Upload a local file
+     */
+    private uploadFile;
+    /**
+     * Upload from URL
+     */
+    private uploadUrl;
+    /**
+     * Upload text content
+     */
+    private uploadText;
+    /**
+     * Upload from Google Drive
+     */
+    private uploadGoogleDrive;
+    /**
+     * Upload YouTube video
+     */
+    private uploadYouTube;
+    /**
+     * Click the upload/add button
+     */
+    private clickUploadButton;
+    /**
+     * Wait for source to finish processing
+     * @param sourceName The name we expect the source to have
+     * @param _textPreview Optional first words of text (for text sources - NotebookLM may use this as name)
+     * @param expectedNotebookUuid Optional UUID of the notebook we expect to be on (to detect redirects)
+     */
+    private waitForSourceProcessing;
+    /**
+     * Send a message in the chat interface (without waiting for response)
+     * This is the new way to generate content in NotebookLM
+     * Uses the same typing and submission approach as ask_question for reliability
+     */
+    private sendChatMessage;
+    /**
+     * Wait for generated content to appear in chat
+     * Uses the same proven approach as /ask endpoint (waitForLatestAnswer with full timeout)
+     */
+    private waitForGeneratedContent;
+    /**
+     * Scroll chat container to bottom to ensure latest messages are visible
+     */
+    private scrollChatToBottom;
+    /**
+     * Generate content (audio overview, presentation, report)
+     *
+     * Supported content types:
+     * - audio_overview: Uses real Studio UI buttons for audio podcast generation
+     * - video: Uses generic ContentGenerator for video generation (with format, language, style options)
+     * - infographic: Uses generic ContentGenerator for infographic generation (with format options)
+     * - presentation: Uses generic ContentGenerator for slides generation (with format options)
+     * - report: Uses generic ContentGenerator for briefing document generation (with format options)
+     * - data_table: Uses generic ContentGenerator for data table generation (with format options)
+     *
+     * NOTE: Other content types (study_guide, faq, timeline, table_of_contents)
+     * were removed because they only sent chat prompts instead of clicking actual
+     * NotebookLM Studio buttons.
+     */
+    generateContent(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate content using the generic ContentGenerator
+     *
+     * This method handles all content types except audio_overview:
+     * - video: With format (brief/explainer), language, and visual style options
+     * - infographic: With format (horizontal/vertical) and language options
+     * - presentation: With format (overview/detailed) and language options
+     * - report: With format (summary/detailed) and language options
+     * - data_table: With format (simple/detailed) and language options
+     *
+     * @param input Content generation input with all options
+     * @returns Content generation result
+     */
+    private generateGenericContent;
+    /**
+     * Generate Audio Overview (podcast)
+     *
+     * NOTE (Dec 2024): NotebookLM UI has changed significantly.
+     * Audio generation now works via chat requests or may require specific UI interaction.
+     * This method attempts both approaches.
+     */
+    generateAudioOverview(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate Presentation/Slides using the generic ContentGenerator
+     *
+     * This uses the generic content generation architecture that:
+     * 1. Navigates to Studio panel
+     * 2. Looks for presentation/slides button
+     * 3. Falls back to chat-based generation if button not found
+     *
+     * @param input Content generation input with optional custom instructions
+     * @returns Content generation result
+     */
+    generatePresentation(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate Report/Briefing Document using the generic ContentGenerator
+     *
+     * Creates a comprehensive briefing document (2,000-3,000 words) that summarizes
+     * key findings, insights, and recommendations from notebook sources.
+     * Can be exported as PDF or DOCX format.
+     *
+     * This uses the generic content generation architecture that:
+     * 1. Navigates to Studio panel
+     * 2. Looks for briefing/report button
+     * 3. Falls back to chat-based generation if button not found
+     *
+     * @param input Content generation input with optional custom instructions
+     * @returns Content generation result with text content
+     */
+    generateReport(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate Infographic using the generic ContentGenerator
+     *
+     * Creates a visual infographic from the notebook sources.
+     * Supports two formats:
+     * - horizontal (16:9): Landscape format for presentations/displays
+     * - vertical (9:16): Portrait format for social media/mobile
+     *
+     * This uses the generic content generation architecture that:
+     * 1. Navigates to Studio panel
+     * 2. Looks for infographic button
+     * 3. Falls back to chat-based generation if button not found
+     *
+     * @param input Content generation input with optional custom instructions and format
+     * @returns Content generation result
+     */
+    generateInfographic(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate a Data Table using the generic ContentGenerator
+     *
+     * Creates a structured table that organizes key information from notebook sources.
+     * The generated table can be exported as CSV or Excel format.
+     *
+     * @param input Content generation input with optional custom instructions
+     * @returns Content generation result with table data
+     */
+    generateDataTable(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Generate a Video using the generic ContentGenerator
+     *
+     * Creates a video summary that visually explains the main topics from notebook sources.
+     * Video generation may take several minutes depending on content complexity.
+     *
+     * Supported formats:
+     * - brief: Short video summary (2-3 minutes)
+     * - explainer: Detailed explanation video (5-10 minutes)
+     *
+     * This uses the generic content generation architecture that:
+     * 1. Navigates to Studio panel
+     * 2. Looks for video generation button
+     * 3. Falls back to chat-based generation if button not found
+     *
+     * @param input Content generation input with optional custom instructions and format
+     * @returns Content generation result with video data
+     */
+    generateVideo(input: ContentGenerationInput): Promise<ContentGenerationResult>;
+    /**
+     * Navigate to Discussion panel (chat)
+     */
+    private navigateToDiscussion;
+    /**
+     * Navigate to Studio panel
+     */
+    private navigateToStudio;
+    /**
+     * Add custom instructions for content generation
+     */
+    private addCustomInstructions;
+    /**
+     * Wait for audio generation to complete
+     */
+    private waitForAudioGeneration;
+    /**
+     * Get overview of notebook content (sources and generated content)
+     */
+    getContentOverview(): Promise<NotebookContentOverview>;
+    /**
+     * List all sources in the notebook
+     */
+    listSources(): Promise<NotebookSource[]>;
+    /**
+     * Delete a source from the current notebook
+     *
+     * @param input - Either sourceId or sourceName to identify the source to delete
+     * @returns Result indicating success or failure
+     */
+    deleteSource(input: SourceDeleteInput): Promise<SourceDeleteResult>;
+    /**
+     * Find a source element by ID or name
+     */
+    private findSourceElement;
+    /**
+     * Open the source menu (3-dot menu)
+     */
+    private openSourceMenu;
+    /**
+     * Click the delete option in the menu
+     */
+    private clickDeleteOption;
+    /**
+     * Confirm deletion if a confirmation dialog appears
+     */
+    private confirmDeletion;
+    /**
+     * List all generated content
+     */
+    listGeneratedContent(): Promise<GeneratedContent[]>;
+    /**
+     * Download generated content (audio, video, infographic)
+     *
+     * For media content types that produce downloadable files:
+     * - audio_overview: WAV audio file
+     * - video: MP4 video file
+     * - infographic: PNG image file
+     *
+     * Note: Text-based content (report, presentation, data_table) is returned
+     * directly in the generation response, not as downloadable files.
+     *
+     * @param contentType Type of content to download
+     * @param outputPath Optional path to save the file
+     * @returns Download result with file path
+     */
+    downloadContent(contentType: ContentType, outputPath?: string): Promise<ContentDownloadResult>;
+    /**
+     * Get panel configuration for a content type
+     */
+    private getContentPanelConfig;
+    /**
+     * Navigate to content panel
+     */
+    private navigateToContentPanel;
+    /**
+     * Find download button on the page
+     */
+    private findDownloadButton;
+    /**
+     * Get audio source URL directly from audio element
+     */
+    private getAudioSourceUrl;
+    /**
+     * Download audio content
+     * @deprecated Use downloadContent('audio_overview', outputPath) instead
+     */
+    downloadAudio(outputPath?: string): Promise<ContentDownloadResult>;
+    /**
+     * Export presentation to Google Slides
+     * Finds and clicks the "Open in Slides" button to get the Google Slides URL
+     */
+    private exportPresentationToGoogleSlides;
+    /**
+     * Export data table to Google Sheets
+     * Finds and clicks the "Open in Sheets" button to get the Google Sheets URL
+     */
+    private exportDataTableToGoogleSheets;
+    /**
+     * Create a note in the NotebookLM Studio panel
+     *
+     * Notes are user-created annotations that appear in the notebook's Studio panel.
+     * They allow you to save research findings, summaries, or key insights.
+     *
+     * @param input Note input with title and content
+     * @returns NoteResult with success status
+     */
+    createNote(input: NoteInput): Promise<NoteResult>;
+    /**
+     * Debug helper to log Studio panel elements
+     */
+    private debugStudioElements;
+    /**
+     * Save the current chat/discussion to a note
+     *
+     * This method extracts all messages from the NotebookLM chat/discussion panel
+     * and creates a note with the chat summary.
+     *
+     * @param input Optional input with custom title
+     * @returns SaveChatToNoteResult with success status and message count
+     */
+    saveChatToNote(input?: SaveChatToNoteInput): Promise<SaveChatToNoteResult>;
+    /**
+     * Internal method to perform the save chat to note operation
+     */
+    private performSaveChatToNote;
+    /**
+     * Extract chat messages from the Discussion panel
+     *
+     * @returns Array of message objects with role (user/assistant) and content
+     */
+    private extractChatMessages;
+    /**
+     * Format extracted chat messages as a note
+     *
+     * @param messages Array of chat messages
+     * @param title Note title
+     * @returns Formatted note content
+     */
+    private formatChatAsNote;
+    /**
+     * Convert a note to a source document in NotebookLM
+     *
+     * This feature allows users to convert an existing note into a source,
+     * making the note content available for RAG queries. The method:
+     * 1. Finds the note by title or ID in the Studio panel
+     * 2. Attempts to use NotebookLM's native "Convert to source" feature if available
+     * 3. Falls back to extracting note content and creating a text source if not
+     *
+     * @param input Note identification (title or ID)
+     * @returns NoteToSourceResult with source information
+     */
+    convertNoteToSource(input: NoteToSourceInput): Promise<NoteToSourceResult>;
+    /**
+     * Find a note element in the Studio panel by title or ID
+     */
+    private findNoteElement;
+    /**
+     * Try to use NotebookLM's native "Convert to source" or "Add to sources" feature
+     */
+    private tryNativeNoteToSourceConversion;
+    /**
+     * Open the menu for a note element
+     */
+    private openNoteMenu;
+    /**
+     * Extract the content of a note for fallback conversion
+     */
+    private extractNoteContent;
+}
+//# sourceMappingURL=content-manager.d.ts.map

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

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