notelm-mcp 1.2.1

package/dist/library/notebook-library.js

@@ -0,0 +1,279 @@
+/**
+ * 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 fs from "fs";
+import path from "path";
+import { CONFIG } from "../config.js";
+import { log } from "../utils/logger.js";
+export class NotebookLibrary {
+    libraryPath;
+    library;
+    constructor() {
+        this.libraryPath = path.join(CONFIG.dataDir, "library.json");
+        this.library = this.loadLibrary();
+        log.info("📚 NotebookLibrary initialized");
+        log.info(`  Library path: ${this.libraryPath}`);
+        log.info(`  Notebooks: ${this.library.notebooks.length}`);
+        if (this.library.active_notebook_id) {
+            log.info(`  Active: ${this.library.active_notebook_id}`);
+        }
+    }
+    /**
+     * Load library from disk, or create default if not exists
+     */
+    loadLibrary() {
+        try {
+            if (fs.existsSync(this.libraryPath)) {
+                const data = fs.readFileSync(this.libraryPath, "utf-8");
+                const library = JSON.parse(data);
+                log.success(`  ✅ Loaded library with ${library.notebooks.length} notebooks`);
+                return library;
+            }
+        }
+        catch (error) {
+            log.warning(`  ⚠️  Failed to load library: ${error}`);
+        }
+        // Create default library with current CONFIG as first entry
+        log.info("  🆕 Creating new library...");
+        const defaultLibrary = this.createDefaultLibrary();
+        this.saveLibrary(defaultLibrary);
+        return defaultLibrary;
+    }
+    /**
+     * Create default library from current CONFIG
+     */
+    createDefaultLibrary() {
+        const hasConfig = CONFIG.notebookUrl &&
+            CONFIG.notebookDescription &&
+            CONFIG.notebookDescription !== "General knowledge base - configure NOTEBOOK_DESCRIPTION to help Claude understand what's in this notebook";
+        const notebooks = [];
+        if (hasConfig) {
+            // Create first entry from CONFIG
+            const id = this.generateId(CONFIG.notebookDescription);
+            notebooks.push({
+                id,
+                url: CONFIG.notebookUrl,
+                name: CONFIG.notebookDescription.substring(0, 50), // First 50 chars as name
+                description: CONFIG.notebookDescription,
+                topics: CONFIG.notebookTopics,
+                content_types: CONFIG.notebookContentTypes,
+                use_cases: CONFIG.notebookUseCases,
+                added_at: new Date().toISOString(),
+                last_used: new Date().toISOString(),
+                use_count: 0,
+                tags: [],
+            });
+            log.success(`  ✅ Created default notebook: ${id}`);
+        }
+        return {
+            notebooks,
+            active_notebook_id: notebooks.length > 0 ? notebooks[0].id : null,
+            last_modified: new Date().toISOString(),
+            version: "1.0.0",
+        };
+    }
+    /**
+     * Save library to disk
+     */
+    saveLibrary(library) {
+        try {
+            library.last_modified = new Date().toISOString();
+            const data = JSON.stringify(library, null, 2);
+            fs.writeFileSync(this.libraryPath, data, "utf-8");
+            this.library = library;
+            log.success(`  💾 Library saved (${library.notebooks.length} notebooks)`);
+        }
+        catch (error) {
+            log.error(`  ❌ Failed to save library: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Generate a unique ID from a string (slug format)
+     */
+    generateId(name) {
+        const base = name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, "")
+            .substring(0, 30);
+        // Ensure uniqueness
+        let id = base;
+        let counter = 1;
+        while (this.library.notebooks.some((n) => n.id === id)) {
+            id = `${base}-${counter}`;
+            counter++;
+        }
+        return id;
+    }
+    /**
+     * Add a new notebook to the library
+     */
+    addNotebook(input) {
+        log.info(`📝 Adding notebook: ${input.name}`);
+        // Generate ID
+        const id = this.generateId(input.name);
+        // Create entry
+        const notebook = {
+            id,
+            url: input.url,
+            name: input.name,
+            description: input.description,
+            topics: input.topics,
+            content_types: input.content_types || ["documentation", "examples"],
+            use_cases: input.use_cases || [
+                `Learning about ${input.name}`,
+                `Implementing features with ${input.name}`,
+            ],
+            added_at: new Date().toISOString(),
+            last_used: new Date().toISOString(),
+            use_count: 0,
+            tags: input.tags || [],
+        };
+        // Add to library
+        const updated = { ...this.library };
+        updated.notebooks.push(notebook);
+        // Set as active if it's the first notebook
+        if (updated.notebooks.length === 1) {
+            updated.active_notebook_id = id;
+        }
+        this.saveLibrary(updated);
+        log.success(`✅ Notebook added: ${id}`);
+        return notebook;
+    }
+    /**
+     * List all notebooks in library
+     */
+    listNotebooks() {
+        return this.library.notebooks;
+    }
+    /**
+     * Get a specific notebook by ID
+     */
+    getNotebook(id) {
+        return this.library.notebooks.find((n) => n.id === id) || null;
+    }
+    /**
+     * Get the currently active notebook
+     */
+    getActiveNotebook() {
+        if (!this.library.active_notebook_id) {
+            return null;
+        }
+        return this.getNotebook(this.library.active_notebook_id);
+    }
+    /**
+     * Select a notebook as active
+     */
+    selectNotebook(id) {
+        const notebook = this.getNotebook(id);
+        if (!notebook) {
+            throw new Error(`Notebook not found: ${id}`);
+        }
+        log.info(`🎯 Selecting notebook: ${id}`);
+        const updated = { ...this.library };
+        updated.active_notebook_id = id;
+        // Update last_used
+        const notebookIndex = updated.notebooks.findIndex((n) => n.id === id);
+        updated.notebooks[notebookIndex] = {
+            ...notebook,
+            last_used: new Date().toISOString(),
+        };
+        this.saveLibrary(updated);
+        log.success(`✅ Active notebook: ${id}`);
+        return updated.notebooks[notebookIndex];
+    }
+    /**
+     * Update notebook metadata
+     */
+    updateNotebook(input) {
+        const notebook = this.getNotebook(input.id);
+        if (!notebook) {
+            throw new Error(`Notebook not found: ${input.id}`);
+        }
+        log.info(`📝 Updating notebook: ${input.id}`);
+        const updated = { ...this.library };
+        const index = updated.notebooks.findIndex((n) => n.id === input.id);
+        updated.notebooks[index] = {
+            ...notebook,
+            ...(input.name && { name: input.name }),
+            ...(input.description && { description: input.description }),
+            ...(input.topics && { topics: input.topics }),
+            ...(input.content_types && { content_types: input.content_types }),
+            ...(input.use_cases && { use_cases: input.use_cases }),
+            ...(input.tags && { tags: input.tags }),
+            ...(input.url && { url: input.url }),
+        };
+        this.saveLibrary(updated);
+        log.success(`✅ Notebook updated: ${input.id}`);
+        return updated.notebooks[index];
+    }
+    /**
+     * Remove notebook from library
+     */
+    removeNotebook(id) {
+        const notebook = this.getNotebook(id);
+        if (!notebook) {
+            return false;
+        }
+        log.info(`🗑️  Removing notebook: ${id}`);
+        const updated = { ...this.library };
+        updated.notebooks = updated.notebooks.filter((n) => n.id !== id);
+        // If we removed the active notebook, select another one
+        if (updated.active_notebook_id === id) {
+            updated.active_notebook_id =
+                updated.notebooks.length > 0 ? updated.notebooks[0].id : null;
+        }
+        this.saveLibrary(updated);
+        log.success(`✅ Notebook removed: ${id}`);
+        return true;
+    }
+    /**
+     * Increment use count for a notebook
+     */
+    incrementUseCount(id) {
+        const notebookIndex = this.library.notebooks.findIndex((n) => n.id === id);
+        if (notebookIndex === -1) {
+            return null;
+        }
+        const notebook = this.library.notebooks[notebookIndex];
+        const updated = { ...this.library };
+        const updatedNotebook = {
+            ...notebook,
+            use_count: notebook.use_count + 1,
+            last_used: new Date().toISOString(),
+        };
+        updated.notebooks[notebookIndex] = updatedNotebook;
+        this.saveLibrary(updated);
+        return updatedNotebook;
+    }
+    /**
+     * Get library statistics
+     */
+    getStats() {
+        const totalQueries = this.library.notebooks.reduce((sum, n) => sum + n.use_count, 0);
+        const mostUsed = this.library.notebooks.reduce((max, n) => n.use_count > (max?.use_count || 0) ? n : max, null);
+        return {
+            total_notebooks: this.library.notebooks.length,
+            active_notebook: this.library.active_notebook_id,
+            most_used_notebook: mostUsed?.id || null,
+            total_queries: totalQueries,
+            last_modified: this.library.last_modified,
+        };
+    }
+    /**
+     * Search notebooks by query (searches name, description, topics)
+     */
+    searchNotebooks(query) {
+        const lowerQuery = query.toLowerCase();
+        return this.library.notebooks.filter((n) => n.name.toLowerCase().includes(lowerQuery) ||
+            n.description.toLowerCase().includes(lowerQuery) ||
+            n.topics.some((t) => t.toLowerCase().includes(lowerQuery)) ||
+            n.tags?.some((t) => t.toLowerCase().includes(lowerQuery)));
+    }
+}
+//# sourceMappingURL=notebook-library.js.map

package/dist/library/notebook-library.js.map

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

package/dist/library/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * NotebookLM Library Types
+ *
+ * Defines the structure for managing multiple NotebookLM notebooks
+ * in a persistent library that Claude can manage autonomously.
+ */
+/**
+ * Single notebook entry in the library
+ */
+export interface NotebookEntry {
+    id: string;
+    url: string;
+    name: string;
+    description: string;
+    topics: string[];
+    content_types: string[];
+    use_cases: string[];
+    added_at: string;
+    last_used: string;
+    use_count: number;
+    tags?: string[];
+}
+/**
+ * The complete notebook library
+ */
+export interface Library {
+    notebooks: NotebookEntry[];
+    active_notebook_id: string | null;
+    last_modified: string;
+    version: string;
+}
+/**
+ * Input for adding a new notebook
+ */
+export interface AddNotebookInput {
+    url: string;
+    name: string;
+    description: string;
+    topics: string[];
+    content_types?: string[];
+    use_cases?: string[];
+    tags?: string[];
+}
+/**
+ * Input for updating a notebook
+ */
+export interface UpdateNotebookInput {
+    id: string;
+    name?: string;
+    description?: string;
+    topics?: string[];
+    content_types?: string[];
+    use_cases?: string[];
+    tags?: string[];
+    url?: string;
+}
+/**
+ * Statistics about library usage
+ */
+export interface LibraryStats {
+    total_notebooks: number;
+    active_notebook: string | null;
+    most_used_notebook: string | null;
+    total_queries: number;
+    last_modified: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/library/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/library/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAE5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IAGpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/library/types.js

@@ -0,0 +1,8 @@
+/**
+ * NotebookLM Library Types
+ *
+ * Defines the structure for managing multiple NotebookLM notebooks
+ * in a persistent library that Claude can manage autonomously.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/library/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/library/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/playwright.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@playwright/test").PlaywrightTestConfig<{}, {}>;
+export default _default;
+//# sourceMappingURL=playwright.config.d.ts.map

package/dist/playwright.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.config.d.ts","sourceRoot":"","sources":["../playwright.config.ts"],"names":[],"mappings":";AAGA,wBAoCG"}

package/dist/playwright.config.js

@@ -0,0 +1,38 @@
+import { defineConfig } from '@playwright/test';
+// import { CONFIG } from './src/config.js';
+export default defineConfig({
+    testDir: './tests/e2e',
+    timeout: 30000,
+    expect: {
+        timeout: 5000,
+    },
+    fullyParallel: true,
+    forbidOnly: !!process.env.CI,
+    retries: process.env.CI ? 2 : 0,
+    workers: process.env.CI ? 1 : undefined,
+    reporter: 'html',
+    use: {
+        actionTimeout: 0,
+        trace: 'on-first-retry',
+        viewport: { width: 1280, height: 720 },
+    },
+    projects: [
+        {
+            name: 'mocked',
+            use: {
+                baseURL: 'http://localhost:3000',
+                // Mocked tests don't need real browser state
+            },
+            testMatch: /.*mocked.spec.ts/,
+        },
+        {
+            name: 'authenticated',
+            use: {
+                baseURL: 'https://notebooklm.google.com',
+                storageState: '.auth/user-state.json',
+            },
+            testMatch: /.*authenticated.spec.ts/,
+        },
+    ],
+});
+//# sourceMappingURL=playwright.config.js.map

package/dist/playwright.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.config.js","sourceRoot":"","sources":["../playwright.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,4CAA4C;AAE5C,eAAe,YAAY,CAAC;IACxB,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE;QACJ,OAAO,EAAE,IAAI;KAChB;IACD,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;IAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;IACvC,QAAQ,EAAE,MAAM;IAEhB,GAAG,EAAE;QACD,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;KACzC;IAED,QAAQ,EAAE;QACN;YACI,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE;gBACD,OAAO,EAAE,uBAAuB;gBAChC,6CAA6C;aAChD;YACD,SAAS,EAAE,kBAAkB;SAChC;QACD;YACI,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE;gBACD,OAAO,EAAE,+BAA+B;gBACxC,YAAY,EAAE,uBAAuB;aACxC;YACD,SAAS,EAAE,yBAAyB;SACvC;KACJ;CACJ,CAAC,CAAC"}

package/dist/resources/resource-handlers.d.ts

@@ -0,0 +1,22 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { NotebookLibrary } from "../library/notebook-library.js";
+/**
+ * Handlers for MCP Resource-related requests
+ */
+export declare class ResourceHandlers {
+    private library;
+    constructor(library: NotebookLibrary);
+    /**
+     * Register all resource handlers to the server
+     */
+    registerHandlers(server: Server): void;
+    /**
+     * Return notebook IDs matching the provided input (case-insensitive contains)
+     */
+    private completeNotebookIds;
+    /**
+     * Build a completion payload for MCP responses
+     */
+    private buildCompletion;
+}
+//# sourceMappingURL=resource-handlers.d.ts.map

package/dist/resources/resource-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-handlers.d.ts","sourceRoot":"","sources":["../../src/resources/resource-handlers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAIpC;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkN7C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,eAAe;CAQxB"}

package/dist/resources/resource-handlers.js

@@ -0,0 +1,216 @@
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, CompleteRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { log } from "../utils/logger.js";
+/**
+ * Handlers for MCP Resource-related requests
+ */
+export class ResourceHandlers {
+    library;
+    constructor(library) {
+        this.library = library;
+    }
+    /**
+     * Register all resource handlers to the server
+     */
+    registerHandlers(server) {
+        // List available resources
+        server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            log.info("📚 [MCP] list_resources request received");
+            const notebooks = this.library.listNotebooks();
+            const resources = [
+                {
+                    uri: "notebooklm://library",
+                    name: "Notebook Library",
+                    description: "Complete notebook library with all available knowledge sources. " +
+                        "Read this to discover what notebooks are available. " +
+                        "⚠️ If you think a notebook might help with the user's task, " +
+                        "ASK THE USER FOR PERMISSION before consulting it: " +
+                        "'Should I consult the [notebook] for this task?'",
+                    mimeType: "application/json",
+                },
+            ];
+            // Add individual notebook resources
+            for (const notebook of notebooks) {
+                resources.push({
+                    uri: `notebooklm://library/${notebook.id}`,
+                    name: notebook.name,
+                    description: `${notebook.description} | Topics: ${notebook.topics.join(", ")} | ` +
+                        `💡 Use ask_question to query this notebook (ask user permission first if task isn't explicitly about these topics)`,
+                    mimeType: "application/json",
+                });
+            }
+            // Add legacy metadata resource for backwards compatibility
+            const active = this.library.getActiveNotebook();
+            if (active) {
+                resources.push({
+                    uri: "notebooklm://metadata",
+                    name: "Active Notebook Metadata (Legacy)",
+                    description: "Information about the currently active notebook. " +
+                        "DEPRECATED: Use notebooklm://library instead for multi-notebook support. " +
+                        "⚠️ Always ask user permission before using notebooks for tasks they didn't explicitly mention.",
+                    mimeType: "application/json",
+                });
+            }
+            return { resources };
+        });
+        // List resource templates
+        server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+            log.info("📑 [MCP] list_resource_templates request received");
+            return {
+                resourceTemplates: [
+                    {
+                        uriTemplate: "notebooklm://library/{id}",
+                        name: "Notebook by ID",
+                        description: "Access a specific notebook from your library by ID. " +
+                            "Provides detailed metadata about the notebook including topics, use cases, and usage statistics. " +
+                            "💡 Use the 'id' parameter from list_notebooks to access specific notebooks.",
+                        mimeType: "application/json",
+                    },
+                ],
+            };
+        });
+        // Read resource content
+        server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            log.info(`📖 [MCP] read_resource request: ${uri}`);
+            // Handle library resource
+            if (uri === "notebooklm://library") {
+                const notebooks = this.library.listNotebooks();
+                const stats = this.library.getStats();
+                const active = this.library.getActiveNotebook();
+                const libraryData = {
+                    active_notebook: active
+                        ? {
+                            id: active.id,
+                            name: active.name,
+                            description: active.description,
+                            topics: active.topics,
+                        }
+                        : null,
+                    notebooks: notebooks.map((nb) => ({
+                        id: nb.id,
+                        name: nb.name,
+                        description: nb.description,
+                        topics: nb.topics,
+                        content_types: nb.content_types,
+                        use_cases: nb.use_cases,
+                        url: nb.url,
+                        use_count: nb.use_count,
+                        last_used: nb.last_used,
+                        tags: nb.tags,
+                    })),
+                    stats,
+                };
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(libraryData, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Handle individual notebook resource
+            if (uri.startsWith("notebooklm://library/")) {
+                const prefix = "notebooklm://library/";
+                const encodedId = uri.slice(prefix.length);
+                if (!encodedId) {
+                    throw new Error("Notebook resource requires an ID (e.g. notebooklm://library/{id})");
+                }
+                let id;
+                try {
+                    id = decodeURIComponent(encodedId);
+                }
+                catch {
+                    throw new Error(`Invalid notebook identifier encoding: ${encodedId}`);
+                }
+                if (!/^[a-z0-9][a-z0-9-]{0,62}$/i.test(id)) {
+                    throw new Error(`Invalid notebook identifier: ${encodedId}. Notebook IDs may only contain letters, numbers, and hyphens.`);
+                }
+                const notebook = this.library.getNotebook(id);
+                if (!notebook) {
+                    throw new Error(`Notebook not found: ${id}`);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(notebook, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Legacy metadata resource (backwards compatibility)
+            if (uri === "notebooklm://metadata") {
+                const active = this.library.getActiveNotebook();
+                if (!active) {
+                    throw new Error("No active notebook. Use notebooklm://library to see all notebooks.");
+                }
+                const metadata = {
+                    description: active.description,
+                    topics: active.topics,
+                    content_types: active.content_types,
+                    use_cases: active.use_cases,
+                    notebook_url: active.url,
+                    notebook_id: active.id,
+                    last_used: active.last_used,
+                    use_count: active.use_count,
+                    note: "DEPRECATED: Use notebooklm://library or notebooklm://library/{id} instead",
+                };
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(metadata, null, 2),
+                        },
+                    ],
+                };
+            }
+            throw new Error(`Unknown resource: ${uri}`);
+        });
+        // Argument completions (for prompt arguments and resource templates)
+        server.setRequestHandler(CompleteRequestSchema, async (request) => {
+            const { ref, argument } = request.params;
+            try {
+                if (ref?.type === "ref/resource") {
+                    // Complete variables for resource templates
+                    const uri = String(ref.uri || "");
+                    // Notebook by ID template
+                    if (uri === "notebooklm://library/{id}" && argument?.name === "id") {
+                        const values = this.completeNotebookIds(argument?.value);
+                        return this.buildCompletion(values);
+                    }
+                }
+            }
+            catch (e) {
+                log.warning(`⚠️  [MCP] completion error: ${e}`);
+            }
+            return { completion: { values: [], total: 0 } };
+        });
+    }
+    /**
+     * Return notebook IDs matching the provided input (case-insensitive contains)
+     */
+    completeNotebookIds(input) {
+        const query = String(input ?? "").toLowerCase();
+        return this.library
+            .listNotebooks()
+            .map((nb) => nb.id)
+            .filter((id) => id.toLowerCase().includes(query))
+            .slice(0, 50);
+    }
+    /**
+     * Build a completion payload for MCP responses
+     */
+    buildCompletion(values) {
+        return {
+            completion: {
+                values,
+                total: values.length,
+            },
+        };
+    }
+}
+//# sourceMappingURL=resource-handlers.js.map