notebooklm-mcp-ultimate 2.2.1

package/dist/index.js

@@ -0,0 +1,439 @@
+#!/usr/bin/env node
+/**
+ * NotebookLM MCP Server
+ *
+ * MCP Server for Google NotebookLM - Chat with Gemini 2.5 through NotebookLM
+ * with session support and human-like behavior!
+ *
+ * Features:
+ * - Session-based contextual conversations
+ * - Auto re-login on session expiry
+ * - Human-like typing and mouse movements
+ * - Persistent browser fingerprint
+ * - Stealth mode with Patchright
+ * - Claude Code integration via npx
+ *
+ * Usage:
+ *   npx notebooklm-mcp
+ *   node dist/index.js
+ *
+ * Environment Variables:
+ *   NOTEBOOK_URL - Default NotebookLM notebook URL
+ *   AUTO_LOGIN_ENABLED - Enable automatic login (true/false)
+ *   LOGIN_EMAIL - Google email for auto-login
+ *   LOGIN_PASSWORD - Google password for auto-login
+ *   HEADLESS - Run browser in headless mode (true/false)
+ *   MAX_SESSIONS - Maximum concurrent sessions (default: 10)
+ *   SESSION_TIMEOUT - Session timeout in seconds (default: 900)
+ *
+ * Based on the Python NotebookLM API implementation
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { AuthManager } from "./auth/auth-manager.js";
+import { SessionManager } from "./session/session-manager.js";
+import { NotebookLibrary } from "./library/notebook-library.js";
+import { ToolHandlers, buildToolDefinitions } from "./tools/index.js";
+import { ResourceHandlers } from "./resources/resource-handlers.js";
+import { SettingsManager } from "./utils/settings-manager.js";
+import { CliHandler } from "./utils/cli-handler.js";
+import { CONFIG } from "./config.js";
+import { log } from "./utils/logger.js";
+/** Single source of truth for the server version — must match package.json. */
+const SERVER_VERSION = "2.0.0";
+/**
+ * Validate that required arguments are present on a tool call.
+ * Throws a descriptive error when any required field is missing.
+ */
+function validateArgs(args, required, toolName) {
+    if (!args) {
+        throw new Error(`${toolName}: arguments are required`);
+    }
+    for (const field of required) {
+        if (args[field] === undefined || args[field] === null) {
+            throw new Error(`${toolName}: missing required argument '${field}'`);
+        }
+    }
+}
+/**
+ * Main MCP Server Class
+ */
+class NotebookLMMCPServer {
+    server;
+    authManager;
+    sessionManager;
+    library;
+    toolHandlers;
+    resourceHandlers;
+    settingsManager;
+    toolDefinitions;
+    constructor() {
+        // Initialize MCP Server
+        this.server = new Server({
+            name: "notebooklm-mcp",
+            version: SERVER_VERSION,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                resourceTemplates: {},
+                prompts: {},
+                completions: {}, // Required for completion/complete support
+                logging: {},
+            },
+        });
+        // Initialize managers
+        this.authManager = new AuthManager();
+        this.sessionManager = new SessionManager(this.authManager);
+        this.library = new NotebookLibrary();
+        this.settingsManager = new SettingsManager();
+        // Initialize handlers
+        this.toolHandlers = new ToolHandlers(this.sessionManager, this.authManager, this.library);
+        this.resourceHandlers = new ResourceHandlers(this.library);
+        // Build and Filter tool definitions
+        const allTools = buildToolDefinitions(this.library);
+        this.toolDefinitions = this.settingsManager.filterTools(allTools);
+        // Setup handlers
+        this.setupHandlers();
+        this.setupShutdownHandlers();
+        const activeSettings = this.settingsManager.getEffectiveSettings();
+        log.info("🚀 NotebookLM MCP Server initialized");
+        log.info(`  Version: ${SERVER_VERSION}`);
+        log.info(`  Node: ${process.version}`);
+        log.info(`  Platform: ${process.platform}`);
+        log.info(`  Profile: ${activeSettings.profile} (${this.toolDefinitions.length} tools active)`);
+    }
+    /**
+     * Setup MCP request handlers
+     */
+    setupHandlers() {
+        // Register Resource Handlers (Resources, Templates, Completions)
+        this.resourceHandlers.registerHandlers(this.server);
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            log.info("📋 [MCP] list_tools request received");
+            return {
+                tools: this.toolDefinitions,
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const progressToken = args?._meta?.progressToken;
+            log.info(`🔧 [MCP] Tool call: ${name}`);
+            if (progressToken) {
+                log.info(`  📊 Progress token: ${progressToken}`);
+            }
+            // Create progress callback function
+            const sendProgress = async (message, progress, total) => {
+                if (progressToken) {
+                    await this.server.notification({
+                        method: "notifications/progress",
+                        params: {
+                            progressToken,
+                            message,
+                            ...(progress !== undefined && { progress }),
+                            ...(total !== undefined && { total }),
+                        },
+                    });
+                    log.dim(`  📊 Progress: ${message}`);
+                }
+            };
+            try {
+                let result;
+                switch (name) {
+                    case "ask_question":
+                        validateArgs(args, ["question"], "ask_question");
+                        result = await this.toolHandlers.handleAskQuestion(args, sendProgress);
+                        break;
+                    case "add_notebook":
+                        validateArgs(args, ["url", "name", "description", "topics"], "add_notebook");
+                        result = await this.toolHandlers.handleAddNotebook(args);
+                        break;
+                    case "list_notebooks":
+                        result = await this.toolHandlers.handleListNotebooks();
+                        break;
+                    case "get_notebook":
+                        validateArgs(args, ["id"], "get_notebook");
+                        result = await this.toolHandlers.handleGetNotebook(args);
+                        break;
+                    case "select_notebook":
+                        validateArgs(args, ["id"], "select_notebook");
+                        result = await this.toolHandlers.handleSelectNotebook(args);
+                        break;
+                    case "update_notebook":
+                        result = await this.toolHandlers.handleUpdateNotebook(args);
+                        break;
+                    case "remove_notebook":
+                        result = await this.toolHandlers.handleRemoveNotebook(args);
+                        break;
+                    case "search_notebooks":
+                        result = await this.toolHandlers.handleSearchNotebooks(args);
+                        break;
+                    case "get_library_stats":
+                        result = await this.toolHandlers.handleGetLibraryStats();
+                        break;
+                    case "list_sessions":
+                        result = await this.toolHandlers.handleListSessions();
+                        break;
+                    case "close_session":
+                        validateArgs(args, ["session_id"], "close_session");
+                        result = await this.toolHandlers.handleCloseSession(args);
+                        break;
+                    case "reset_session":
+                        result = await this.toolHandlers.handleResetSession(args);
+                        break;
+                    case "get_health":
+                        result = await this.toolHandlers.handleGetHealth();
+                        break;
+                    case "setup_auth":
+                        result = await this.toolHandlers.handleSetupAuth(args, sendProgress);
+                        break;
+                    case "re_auth":
+                        result = await this.toolHandlers.handleReAuth(args, sendProgress);
+                        break;
+                    // Content Generation Tools
+                    case "generate_faq":
+                        result = await this.toolHandlers.handleGenerateFAQ(args, sendProgress);
+                        break;
+                    case "generate_briefing":
+                        result = await this.toolHandlers.handleGenerateBriefing(args, sendProgress);
+                        break;
+                    case "generate_timeline":
+                        result = await this.toolHandlers.handleGenerateTimeline(args, sendProgress);
+                        break;
+                    case "generate_outline":
+                        result = await this.toolHandlers.handleGenerateOutline(args, sendProgress);
+                        break;
+                    case "generate_study_guide":
+                        result = await this.toolHandlers.handleGenerateStudyGuide(args, sendProgress);
+                        break;
+                    case "generate_flashcards":
+                        result = await this.toolHandlers.handleGenerateFlashcards(args, sendProgress);
+                        break;
+                    case "generate_quiz":
+                        result = await this.toolHandlers.handleGenerateQuiz(args, sendProgress);
+                        break;
+                    case "generate_mindmap":
+                        result = await this.toolHandlers.handleGenerateMindMap(args, sendProgress);
+                        break;
+                    case "suggest_questions":
+                        result = await this.toolHandlers.handleSuggestQuestions(args, sendProgress);
+                        break;
+                    // Audio Studio Tools
+                    case "get_audio_status":
+                        result = await this.toolHandlers.handleGetAudioStatus(args, sendProgress);
+                        break;
+                    case "create_audio":
+                        result = await this.toolHandlers.handleCreateAudio(args, sendProgress);
+                        break;
+                    case "update_audio":
+                        result = await this.toolHandlers.handleUpdateAudio(args, sendProgress);
+                        break;
+                    case "delete_audio":
+                        result = await this.toolHandlers.handleDeleteAudio(args, sendProgress);
+                        break;
+                    case "download_audio":
+                        result = await this.toolHandlers.handleDownloadAudio(args, sendProgress);
+                        break;
+                    // Source Management Tools
+                    case "list_sources":
+                        result = await this.toolHandlers.handleListSources(args, sendProgress);
+                        break;
+                    case "add_url_source":
+                        validateArgs(args, ["url"], "add_url_source");
+                        result = await this.toolHandlers.handleAddURLSource(args, sendProgress);
+                        break;
+                    case "add_text_source":
+                        result = await this.toolHandlers.handleAddTextSource(args, sendProgress);
+                        break;
+                    case "add_youtube_source":
+                        result = await this.toolHandlers.handleAddYouTubeSource(args, sendProgress);
+                        break;
+                    case "add_drive_source":
+                        result = await this.toolHandlers.handleAddDriveSource(args, sendProgress);
+                        break;
+                    case "delete_source":
+                        validateArgs(args, ["source_id"], "delete_source");
+                        result = await this.toolHandlers.handleDeleteSource(args, sendProgress);
+                        break;
+                    case "summarize_source":
+                        result = await this.toolHandlers.handleSummarizeSource(args, sendProgress);
+                        break;
+                    // Research Tools
+                    case "discover_sources":
+                        result = await this.toolHandlers.handleDiscoverSources(args, sendProgress);
+                        break;
+                    case "import_source":
+                        result = await this.toolHandlers.handleImportSource(args, sendProgress);
+                        break;
+                    case "research_topic":
+                        result = await this.toolHandlers.handleResearchTopic(args, sendProgress);
+                        break;
+                    // Notebook CRUD Tools (API-based)
+                    case "create_notebook_remote":
+                        result = await this.toolHandlers.handleCreateNotebookRemote(args, sendProgress);
+                        break;
+                    case "rename_notebook_remote":
+                        validateArgs(args, ["notebook_id", "new_title"], "rename_notebook_remote");
+                        result = await this.toolHandlers.handleRenameNotebookRemote(args, sendProgress);
+                        break;
+                    case "delete_notebook_remote":
+                        validateArgs(args, ["notebook_id"], "delete_notebook_remote");
+                        result = await this.toolHandlers.handleDeleteNotebookRemote(args, sendProgress);
+                        break;
+                    case "add_file_source":
+                        result = await this.toolHandlers.handleAddFileSource(args, sendProgress);
+                        break;
+                    case "cleanup_data":
+                        result = await this.toolHandlers.handleCleanupData(args);
+                        break;
+                    default:
+                        log.error(`❌ [MCP] Unknown tool: ${name}`);
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        success: false,
+                                        error: `Unknown tool: ${name}`,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                }
+                // Return result
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                log.error(`❌ [MCP] Tool execution error: ${errorMessage}`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    /**
+     * Setup graceful shutdown handlers
+     */
+    setupShutdownHandlers() {
+        let shuttingDown = false;
+        const shutdown = async (signal) => {
+            if (shuttingDown) {
+                return;
+            }
+            shuttingDown = true;
+            log.info(`\n🛑 Received ${signal}, shutting down gracefully...`);
+            try {
+                // Cleanup tool handlers (closes all sessions)
+                await this.toolHandlers.cleanup();
+                // Close server
+                await this.server.close();
+                log.success("✅ Shutdown complete");
+                process.exit(0);
+            }
+            catch (error) {
+                log.error(`❌ Error during shutdown: ${error}`);
+                process.exit(1);
+            }
+        };
+        const requestShutdown = (signal) => {
+            void shutdown(signal);
+        };
+        process.on("SIGINT", () => requestShutdown("SIGINT"));
+        process.on("SIGTERM", () => requestShutdown("SIGTERM"));
+        process.on("uncaughtException", (error) => {
+            log.error(`💥 Uncaught exception: ${error}`);
+            log.error(error.stack || "");
+            requestShutdown("uncaughtException");
+        });
+        process.on("unhandledRejection", (reason, promise) => {
+            log.error(`💥 Unhandled rejection at: ${promise}`);
+            log.error(`Reason: ${reason}`);
+            requestShutdown("unhandledRejection");
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        log.info("🎯 Starting NotebookLM MCP Server...");
+        log.info("");
+        log.info("📝 Configuration:");
+        log.info(`  Config Dir: ${CONFIG.configDir}`);
+        log.info(`  Data Dir: ${CONFIG.dataDir}`);
+        log.info(`  Headless: ${CONFIG.headless}`);
+        log.info(`  Max Sessions: ${CONFIG.maxSessions}`);
+        log.info(`  Session Timeout: ${CONFIG.sessionTimeout}s`);
+        log.info(`  Stealth: ${CONFIG.stealthEnabled}`);
+        log.info("");
+        // Create stdio transport
+        const transport = new StdioServerTransport();
+        // Connect server to transport
+        await this.server.connect(transport);
+        log.success("✅ MCP Server connected via stdio");
+        log.success("🎉 Ready to receive requests from Claude Code!");
+        log.info("");
+        log.info("💡 Available tools:");
+        for (const tool of this.toolDefinitions) {
+            const desc = tool.description ? tool.description.split('\n')[0] : 'No description'; // First line only
+            log.info(`  - ${tool.name}: ${desc.substring(0, 80)}...`);
+        }
+        log.info("");
+        log.info("📖 For documentation, see: README.md");
+        log.info("📖 For MCP details, see: MCP_INFOS.md");
+        log.info("");
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Handle CLI commands
+    const args = process.argv.slice(2);
+    if (args.length > 0 && args[0] === "config") {
+        const cli = new CliHandler();
+        await cli.handleCommand(args);
+        process.exit(0);
+    }
+    // Print banner
+    console.error("╔══════════════════════════════════════════════════════════╗");
+    console.error("║                                                          ║");
+    console.error(`║           NotebookLM MCP Server v${SERVER_VERSION}                 ║`);
+    console.error("║                                                          ║");
+    console.error("║   Chat with Gemini 2.5 through NotebookLM via MCP       ║");
+    console.error("║                                                          ║");
+    console.error("╚══════════════════════════════════════════════════════════╝");
+    console.error("");
+    try {
+        const server = new NotebookLMMCPServer();
+        await server.start();
+    }
+    catch (error) {
+        log.error(`💥 Fatal error starting server: ${error}`);
+        if (error instanceof Error) {
+            log.error(error.stack || "");
+        }
+        process.exit(1);
+    }
+}
+// Run the server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,+EAA+E;AAC/E,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;GAGG;AACH,SAAS,YAAY,CACnB,IAAyC,EACzC,QAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,0BAA0B,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,gCAAgC,KAAK,GAAG,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,mBAAmB;IACf,MAAM,CAAS;IACf,WAAW,CAAc;IACzB,cAAc,CAAiB;IAC/B,OAAO,CAAkB;IACzB,YAAY,CAAe;IAC3B,gBAAgB,CAAmB;IACnC,eAAe,CAAkB;IACjC,eAAe,CAAS;IAEhC;QACE,wBAAwB;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB;YACE,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,cAAc;SACxB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,iBAAiB,EAAE,EAAE;gBACrB,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,EAAE,EAAE,2CAA2C;gBAC5D,OAAO,EAAE,EAAE;aACZ;SACF,CACF,CAAC;QAEF,sBAAsB;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE7C,sBAAsB;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAClC,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,CACb,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE3D,oCAAoC;QACpC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAW,CAAC;QAC9D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAElE,iBAAiB;QACjB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,cAAc,cAAc,EAAE,CAAC,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,cAAc,cAAc,CAAC,OAAO,KAAK,IAAI,CAAC,eAAe,CAAC,MAAM,gBAAgB,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,iEAAiE;QACjE,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpD,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAC/D,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACjD,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,eAAe;aAC5B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,aAAa,GAAI,IAAY,EAAE,KAAK,EAAE,aAAa,CAAC;YAE1D,GAAG,CAAC,IAAI,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;YACxC,IAAI,aAAa,EAAE,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,wBAAwB,aAAa,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,oCAAoC;YACpC,MAAM,YAAY,GAAG,KAAK,EAAE,OAAe,EAAE,QAAiB,EAAE,KAAc,EAAE,EAAE;gBAChF,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;wBAC7B,MAAM,EAAE,wBAAwB;wBAChC,MAAM,EAAE;4BACN,aAAa;4BACb,OAAO;4BACP,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;4BAC3C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;yBACtC;qBACF,CAAC,CAAC;oBACH,GAAG,CAAC,GAAG,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC;gBACH,IAAI,MAAM,CAAC;gBAEX,QAAQ,IAAI,EAAE,CAAC;oBACb,KAAK,cAAc;wBACjB,YAAY,CAAC,IAA+B,EAAE,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;wBAC5E,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAMC,EACD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,cAAc;wBACjB,YAAY,CAAC,IAA+B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;wBACxG,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAQC,CACF,CAAC;wBACF,MAAM;oBAER,KAAK,gBAAgB;wBACnB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;wBACvD,MAAM;oBAER,KAAK,cAAc;wBACjB,YAAY,CAAC,IAA+B,EAAE,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;wBACtE,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAAsB,CACvB,CAAC;wBACF,MAAM;oBAER,KAAK,iBAAiB;wBACpB,YAAY,CAAC,IAA+B,EAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;wBACzE,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CACnD,IAAsB,CACvB,CAAC;wBACF,MAAM;oBAER,KAAK,iBAAiB;wBACpB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CACnD,IASC,CACF,CAAC;wBACF,MAAM;oBAER,KAAK,iBAAiB;wBACpB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CACnD,IAAsB,CACvB,CAAC;wBACF,MAAM;oBAER,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CACpD,IAAyB,CAC1B,CAAC;wBACF,MAAM;oBAER,KAAK,mBAAmB;wBACtB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC;wBACzD,MAAM;oBAER,KAAK,eAAe;wBAClB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;wBACtD,MAAM;oBAER,KAAK,eAAe;wBAClB,YAAY,CAAC,IAA+B,EAAE,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC,CAAC;wBAC/E,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAA8B,CAC/B,CAAC;wBACF,MAAM;oBAER,KAAK,eAAe;wBAClB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAA8B,CAC/B,CAAC;wBACF,MAAM;oBAER,KAAK,YAAY;wBACf,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;wBACnD,MAAM;oBAER,KAAK,YAAY;wBACf,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAC9C,IAAkC,EAClC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,SAAS;wBACZ,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAC3C,IAAkC,EAClC,YAAY,CACb,CAAC;wBACF,MAAM;oBAGV,2BAA2B;oBAC3B,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,mBAAmB;wBACtB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CACrD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,mBAAmB;wBACtB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CACrD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CACpD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,sBAAsB;wBACzB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,CACvD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,qBAAqB;wBACxB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,CACvD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,eAAe;wBAClB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CACpD,IAAuD,EACvD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,mBAAmB;wBACtB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CACrD,IAAgC,EAChC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,qBAAqB;oBACrB,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CACnD,IAAgC,EAChC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAMC,EACD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAKC,EACD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAAgC,EAChC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,gBAAgB;wBACnB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAClD,IAAgC,EAChC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,0BAA0B;oBAC1B,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAAgC,EAChC,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,gBAAgB;wBACnB,YAAY,CAAC,IAA+B,EAAE,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;wBACzE,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAA6C,EAC7C,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,iBAAiB;wBACpB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAClD,IAAgE,EAChE,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,oBAAoB;wBACvB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CACrD,IAAqD,EACrD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CACnD,IAAiD,EACjD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,eAAe;wBAClB,YAAY,CAAC,IAA+B,EAAE,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;wBAC9E,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAAmD,EACnD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CACpD,IAAmD,EACnD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,iBAAiB;oBACjB,KAAK,kBAAkB;wBACrB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CACpD,IAA+C,EAC/C,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,eAAe;wBAClB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACjD,IAA6C,EAC7C,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,gBAAgB;wBACnB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAClD,IAAsE,EACtE,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,kCAAkC;oBAClC,KAAK,wBAAwB;wBAC3B,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,0BAA0B,CACzD,IAA0B,EAC1B,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,wBAAwB;wBAC3B,YAAY,CAAC,IAA+B,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,wBAAwB,CAAC,CAAC;wBACtG,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,0BAA0B,CACzD,IAAkD,EAClD,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,wBAAwB;wBAC3B,YAAY,CAAC,IAA+B,EAAE,CAAC,aAAa,CAAC,EAAE,wBAAwB,CAAC,CAAC;wBACzF,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,0BAA0B,CACzD,IAA+B,EAC/B,YAAY,CACb,CAAC;wBACF,MAAM;oBAER,KAAK,iBAAiB;wBACpB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAClD,IAAkD,EAClD,YAAY,CACb,CAAC;wBACF,MAAM;oBAEN,KAAK,cAAc;wBACjB,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAChD,IAA4B,CAC7B,CAAC;wBACF,MAAM;oBAER;wBACE,GAAG,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;wBAC3C,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wCACE,OAAO,EAAE,KAAK;wCACd,KAAK,EAAE,iBAAiB,IAAI,EAAE;qCAC/B,EACD,IAAI,EACJ,CAAC,CACF;iCACF;6BACF;yBACF,CAAC;gBACN,CAAC;gBAED,gBAAgB;gBAChB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,GAAG,CAAC,KAAK,CAAC,iCAAiC,YAAY,EAAE,CAAC,CAAC;gBAE3D,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY;6BACpB,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,YAAY,GAAG,IAAI,CAAC;YAEpB,GAAG,CAAC,IAAI,CAAC,iBAAiB,MAAM,+BAA+B,CAAC,CAAC;YAEjE,IAAI,CAAC;gBACH,8CAA8C;gBAC9C,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAElC,eAAe;gBACf,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAE1B,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,EAAE;YACzC,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QAExD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,GAAG,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;YAC7C,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC7B,eAAe,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YACnD,GAAG,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YACnD,GAAG,CAAC,KAAK,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;YAC/B,eAAe,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,GAAG,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEb,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,8BAA8B;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAErC,GAAG,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,kBAAkB;YACtG,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,sBAAsB;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,eAAe;IACf,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,sCAAsC,cAAc,oBAAoB,CAAC,CAAC;IACxF,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC7E,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,IAAI,EAAE,CAAC"}

package/dist/library/notebook-library.d.ts

@@ -0,0 +1,79 @@
+/**
+ * NotebookLM Library Manager
+ *
+ * Manages a persistent library of NotebookLM notebooks.
+ * Allows Claude to autonomously add, remove, and switch between
+ * multiple notebooks based on the task at hand.
+ */
+import type { NotebookEntry, AddNotebookInput, UpdateNotebookInput, LibraryStats } from "./types.js";
+export declare class NotebookLibrary {
+    private libraryPath;
+    private library;
+    constructor();
+    /**
+     * Load library from disk, or create default if not exists
+     */
+    private loadLibrary;
+    /**
+     * Create default library from current CONFIG
+     */
+    private createDefaultLibrary;
+    /**
+     * Save library to disk.
+     *
+     * Thread-safety note: All library mutation methods (addNotebook, updateNotebook,
+     * removeNotebook, etc.) are fully synchronous — they perform no awaits. Node.js
+     * is single-threaded, so synchronous code cannot interleave with other event-loop
+     * callbacks. The in-memory state (this.library) is therefore always consistent
+     * before each save. If any mutation method becomes async in the future, introduce
+     * explicit serialization (e.g., a Promise-based write queue) before proceeding.
+     */
+    private saveLibrary;
+    /**
+     * Generate a unique ID from a string (slug format).
+     * Falls back to a timestamp-based ID when the name contains no alphanumeric
+     * characters (e.g., "!!!"), which would otherwise produce an empty slug.
+     */
+    private generateId;
+    /**
+     * Add a new notebook to the library
+     */
+    addNotebook(input: AddNotebookInput): NotebookEntry;
+    /**
+     * List all notebooks in library
+     */
+    listNotebooks(): NotebookEntry[];
+    /**
+     * Get a specific notebook by ID
+     */
+    getNotebook(id: string): NotebookEntry | null;
+    /**
+     * Get the currently active notebook
+     */
+    getActiveNotebook(): NotebookEntry | null;
+    /**
+     * Select a notebook as active
+     */
+    selectNotebook(id: string): NotebookEntry;
+    /**
+     * Update notebook metadata
+     */
+    updateNotebook(input: UpdateNotebookInput): NotebookEntry;
+    /**
+     * Remove notebook from library
+     */
+    removeNotebook(id: string): boolean;
+    /**
+     * Increment use count for a notebook
+     */
+    incrementUseCount(id: string): NotebookEntry | null;
+    /**
+     * Get library statistics
+     */
+    getStats(): LibraryStats;
+    /**
+     * Search notebooks by query (searches name, description, topics)
+     */
+    searchNotebooks(query: string): NotebookEntry[];
+}
+//# sourceMappingURL=notebook-library.d.ts.map

package/dist/library/notebook-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-library.d.ts","sourceRoot":"","sources":["../../src/library/notebook-library.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,aAAa,EAEb,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAU;;IAczB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoC5B;;;;;;;;;OASG;IACH,OAAO,CAAC,WAAW;IAanB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa;IA8CnD;;OAEG;IACH,aAAa,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI7C;;OAEG;IACH,iBAAiB,IAAI,aAAa,GAAG,IAAI;IAOzC;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAwBzC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa;IA4BzD;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAuBnC;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAoBnD;;OAEG;IACH,QAAQ,IAAI,YAAY;IAmBxB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;CAUhD"}