notelm-mcp 1.2.1

package/dist/tests/mocks/handlers.js

@@ -0,0 +1,55 @@
+import { http, HttpResponse } from 'msw';
+export const googleOAuthHandlers = [
+    // Mock OAuth2 Auth Code Flow
+    http.get('https://accounts.google.com/o/oauth2/v2/auth', () => {
+        const mockAuthCode = 'mock_auth_code_12345';
+        // Simulate redirect back to localhost
+        return HttpResponse.redirect(`http://localhost:3000/callback?code=${mockAuthCode}`);
+    }),
+    // Mock Token Exchange
+    http.post('https://oauth2.googleapis.com/token', () => {
+        return HttpResponse.json({
+            access_token: 'mock_access_token',
+            refresh_token: 'mock_refresh_token',
+            expires_in: 3600,
+            token_type: 'Bearer',
+        });
+    }),
+    // Mock User Info
+    http.get('https://www.googleapis.com/oauth2/v3/userinfo', () => {
+        return HttpResponse.json({
+            sub: '123456789',
+            name: 'Test User',
+            email: 'test@example.com',
+            picture: 'https://example.com/avatar.jpg'
+        });
+    }),
+];
+export const notebookLMHandlers = [
+    // Mock Chat API
+    http.post('https://notebooklm.google.com/api/chat', async () => {
+        // Ideally we would parse the request body to give context-aware responses
+        // const body = await request.json();
+        return HttpResponse.json({
+            response: `Mocked response from NotebookLM.`,
+            sources: [
+                { title: 'Mock Source 1', snippet: 'Relevant content...' }
+            ],
+            thinking_time: 1000,
+        });
+    }),
+    // Mock Notebooks List
+    http.get('https://notebooklm.google.com/api/notebooks', () => {
+        return HttpResponse.json({
+            notebooks: [
+                { id: 'mock-001', title: 'Test Notebook 1' },
+                { id: 'mock-002', title: 'Test Notebook 2' },
+            ]
+        });
+    }),
+];
+export const handlers = [
+    ...googleOAuthHandlers,
+    ...notebookLMHandlers,
+];
+//# sourceMappingURL=handlers.js.map

package/dist/tests/mocks/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../tests/mocks/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AAEzC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,6BAA6B;IAC7B,IAAI,CAAC,GAAG,CAAC,8CAA8C,EAAE,GAAG,EAAE;QAC1D,MAAM,YAAY,GAAG,sBAAsB,CAAC;QAC5C,sCAAsC;QACtC,OAAO,YAAY,CAAC,QAAQ,CACxB,uCAAuC,YAAY,EAAE,CACxD,CAAC;IACN,CAAC,CAAC;IAEF,sBAAsB;IACtB,IAAI,CAAC,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAClD,OAAO,YAAY,CAAC,IAAI,CAAC;YACrB,YAAY,EAAE,mBAAmB;YACjC,aAAa,EAAE,oBAAoB;YACnC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACvB,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,iBAAiB;IACjB,IAAI,CAAC,GAAG,CAAC,+CAA+C,EAAE,GAAG,EAAE;QAC3D,OAAO,YAAY,CAAC,IAAI,CAAC;YACrB,GAAG,EAAE,WAAW;YAChB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,gCAAgC;SAC5C,CAAC,CAAC;IACP,CAAC,CAAC;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,gBAAgB;IAChB,IAAI,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QAC3D,0EAA0E;QAC1E,qCAAqC;QAErC,OAAO,YAAY,CAAC,IAAI,CAAC;YACrB,QAAQ,EAAE,kCAAkC;YAC5C,OAAO,EAAE;gBACL,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB,EAAE;aAC7D;YACD,aAAa,EAAE,IAAI;SACtB,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,sBAAsB;IACtB,IAAI,CAAC,GAAG,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACzD,OAAO,YAAY,CAAC,IAAI,CAAC;YACrB,SAAS,EAAE;gBACP,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBAC5C,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE;aAC/C;SACJ,CAAC,CAAC;IACP,CAAC,CAAC;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,GAAG,mBAAmB;IACtB,GAAG,kBAAkB;CACxB,CAAC"}

package/dist/tests/mocks/setup.d.ts

@@ -0,0 +1,3 @@
+import { Page } from '@playwright/test';
+export declare function setupMSW(page: Page): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/tests/mocks/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../tests/mocks/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA8BxC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,iBAoDxC"}

package/dist/tests/mocks/setup.js

@@ -0,0 +1,77 @@
+// import { setupWorker } from 'msw/browser'; // createWorker doesn't exist, use setupWorker if needed
+// However, typically for E2E we might want to intercept at network layer.
+// Providing a simple setup function.
+// import { handlers } from './handlers.js';
+// For Playwright, we often use page.route to intercept, but MSW has a cleaner integration.
+// Since we are running in Node context (Playwright runner) but browser is separate, 
+// we can use MSW's http interceptor if we were doing API tests, 
+// OR we can use page.route handler generator if we want to mock network requests made by the browser.
+//
+// A common pattern for Playwright + MSW is to load the service worker in the browser,
+// OR simply use Playwright's network interception to fulfill requests based on MSW handlers.
+//
+// For simplicity and robustness without Service Worker complexity in this environment:
+// We will manually map MSW handlers to Playwright page.route if needed, 
+// BUT the simplest "MSW-like" approach in Playwright is just using page.route directly.
+//
+// However, to stick to the doc's "MSW" strategy, let's assume we want to use 'msw' library.
+// The doc example showed `setupMSW(page, handlers)`. Let's implement that helper.
+// 
+// Note: Direct MSW integration with Playwright often involves experimental loaders or manual routing.
+// We will implement a helper that uses Playwright's `page.route` to handle requests using MSW logic 
+// or simply mimics it if MSW integration is too complex to setup in one go without a plugin.
+//
+// Actually, let's stick to true MSW if possible, but given the constraints, 
+// I will implement a `setupMSW` that uses `page.route` to fulfill requests 
+// corresponding to our handlers. This is more robust than trying to inject a Service Worker.
+export async function setupMSW(page) {
+    // This is a simplified implementation that manually routes specific URL patterns 
+    // to return the JSON defined in our handlers. 
+    // Real MSW integration is more involved. 
+    // To strictly follow the doc's "Strategy 1", we will implement the routing manually here 
+    // to achieve the EFFECT of MSW without the full boilerplate of a Service Worker build step.
+    // 1. Mock Notebooks List
+    await page.route('**/api/notebooks', async (route) => {
+        await route.fulfill({
+            status: 200,
+            contentType: 'application/json',
+            body: JSON.stringify({
+                notebooks: [
+                    { id: 'mock-001', title: 'Test Notebook 1' },
+                    { id: 'mock-002', title: 'Test Notebook 2' },
+                ]
+            })
+        });
+    });
+    // 2. Mock Chat
+    await page.route('**/api/chat', async (route) => {
+        await route.fulfill({
+            status: 200,
+            contentType: 'application/json',
+            body: JSON.stringify({
+                response: `Mocked response from NotebookLM.`,
+                sources: [
+                    { title: 'Mock Source 1', snippet: 'Relevant content...' }
+                ],
+                thinking_time: 1000,
+            })
+        });
+    });
+    // 3. Mock OAuth (simplified)
+    await page.route('https://accounts.google.com/**', async (route) => {
+        // If we are fully mocking, we might not even hit this if we start internally.
+        // But if app redirects here, we redirect back.
+        const url = new URL(route.request().url());
+        if (url.pathname.includes('auth')) {
+            await route.fulfill({
+                status: 302,
+                headers: { Location: 'http://localhost:3000/callback?code=mock_code' }
+            });
+        }
+        else {
+            await route.continue();
+        }
+    });
+    console.log('MSW (Simulated) initialized');
+}
+//# sourceMappingURL=setup.js.map

package/dist/tests/mocks/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../tests/mocks/setup.ts"],"names":[],"mappings":"AACA,sGAAsG;AACtG,0EAA0E;AAC1E,qCAAqC;AAErC,4CAA4C;AAE5C,2FAA2F;AAC3F,qFAAqF;AACrF,iEAAiE;AACjE,sGAAsG;AACtG,EAAE;AACF,sFAAsF;AACtF,6FAA6F;AAC7F,EAAE;AACF,uFAAuF;AACvF,yEAAyE;AACzE,wFAAwF;AACxF,EAAE;AACF,4FAA4F;AAC5F,kFAAkF;AAClF,GAAG;AACH,sGAAsG;AACtG,qGAAqG;AACrG,6FAA6F;AAC7F,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,6FAA6F;AAE7F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAU;IACrC,kFAAkF;IAClF,+CAA+C;IAC/C,0CAA0C;IAC1C,0FAA0F;IAC1F,4FAA4F;IAE5F,yBAAyB;IACzB,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;QAC/C,MAAM,KAAK,CAAC,OAAO,CAAC;YAChB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,kBAAkB;YAC/B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,SAAS,EAAE;oBACP,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE;oBAC5C,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE;iBAC/C;aACJ,CAAC;SACL,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;QAC1C,MAAM,KAAK,CAAC,OAAO,CAAC;YAChB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,kBAAkB;YAC/B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,QAAQ,EAAE,kCAAkC;gBAC5C,OAAO,EAAE;oBACL,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB,EAAE;iBAC7D;gBACD,aAAa,EAAE,IAAI;aACtB,CAAC;SACL,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;QAC7D,8EAA8E;QAC9E,+CAA+C;QAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,OAAO,CAAC;gBAChB,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,QAAQ,EAAE,+CAA+C,EAAE;aACzE,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC/C,CAAC"}

package/dist/tools/definitions/ask-question.d.ts

@@ -0,0 +1,8 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { NotebookLibrary } from "../../library/notebook-library.js";
+/**
+ * Build dynamic tool description for ask_question based on active notebook or library
+ */
+export declare function buildAskQuestionDescription(library: NotebookLibrary): string;
+export declare const askQuestionTool: Tool;
+//# sourceMappingURL=ask-question.d.ts.map

package/dist/tools/definitions/ask-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-question.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/ask-question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAuG5E;AAED,eAAO,MAAM,eAAe,EAAE,IA4G7B,CAAC"}

package/dist/tools/definitions/ask-question.js

@@ -0,0 +1,211 @@
+/**
+ * Build dynamic tool description for ask_question based on active notebook or library
+ */
+export function buildAskQuestionDescription(library) {
+    const active = library.getActiveNotebook();
+    const bt = "`"; // Backtick helper to avoid template literal issues
+    if (active) {
+        const topics = active.topics.join(", ");
+        const useCases = active.use_cases.map((uc) => `  - ${uc}`).join("\n");
+        return `# Conversational Research Partner (NotebookLM • Gemini 2.5 • Session RAG)
+
+**Active Notebook:** ${active.name}
+**Content:** ${active.description}
+**Topics:** ${topics}
+
+> Auth tip: If login is required, use the prompt 'notebooklm.auth-setup' and then verify with the 'get_health' tool. If authentication later fails (e.g., expired cookies), use the prompt 'notebooklm.auth-repair'.
+
+## What This Tool Is
+- Full conversational research with Gemini (LLM) grounded on your notebook sources
+- Session-based: each follow-up uses prior context for deeper, more precise answers
+- Source-cited responses designed to minimize hallucinations
+
+## When To Use
+${useCases}
+
+## Rules (Important)
+- Always prefer continuing an existing session for the same task
+- If you start a new thread, create a new session and keep its session_id
+- Ask clarifying questions before implementing; do not guess missing details
+- If multiple notebooks could apply, propose the top 1–2 and ask which to use
+- If task context changes, ask to reset the session or switch notebooks
+- If authentication fails, use the prompts 'notebooklm.auth-repair' (or 'notebooklm.auth-setup') and verify with 'get_health'
+- After every NotebookLM answer: pause, compare with the user's goal, and only respond if you are 100% sure the information is complete. Otherwise, plan the next NotebookLM question in the same session.
+
+## Session Flow (Recommended)
+${bt}${bt}${bt}javascript
+// 1) Start broad (no session_id → creates one)
+ask_question({ question: "Give me an overview of [topic]" })
+// ← Save: result.session_id
+
+// 2) Go specific (same session)
+ask_question({ question: "Key APIs/methods?", session_id })
+
+// 3) Cover pitfalls (same session)
+ask_question({ question: "Common edge cases + gotchas?", session_id })
+
+// 4) Ask for production example (same session)
+ask_question({ question: "Show a production-ready example", session_id })
+${bt}${bt}${bt}
+
+## Automatic Multi-Pass Strategy (Host-driven)
+- Simple prompts return once-and-done answers.
+- For complex prompts, the host should issue follow-up calls:
+  1. Implementation plan (APIs, dependencies, configuration, authentication).
+  2. Pitfalls, gaps, validation steps, missing prerequisites.
+- Keep the same session_id for all follow-ups, review NotebookLM's answer, and ask more questions until the problem is fully resolved.
+- Before replying to the user, double-check: do you truly have everything? If not, queue another ask_question immediately.
+
+## 🔥 REAL EXAMPLE
+
+Task: "Implement error handling in n8n workflow"
+
+Bad (shallow):
+${bt}${bt}${bt}
+Q: "How do I handle errors in n8n?"
+A: [basic answer]
+→ Implement → Probably missing edge cases!
+${bt}${bt}${bt}
+
+Good (deep):
+${bt}${bt}${bt}
+Q1: "What are n8n's error handling mechanisms?" (session created)
+A1: [Overview of error handling]
+
+Q2: "What's the recommended pattern for API errors?" (same session)
+A2: [Specific patterns, uses context from Q1]
+
+Q3: "How do I handle retry logic and timeouts?" (same session)
+A3: [Detailed approach, builds on Q1+Q2]
+
+Q4: "Show me a production example with all these patterns" (same session)
+A4: [Complete example with full context]
+
+→ NOW implement with confidence!
+${bt}${bt}${bt}
+    
+## Notebook Selection
+- Default: active notebook (${active.id})
+- Or set notebook_id to use a library notebook
+- Or set notebook_url for ad-hoc notebooks (not in library)
+- If ambiguous which notebook fits, ASK the user which to use`;
+    }
+    else {
+        return `# Conversational Research Partner (NotebookLM • Gemini 2.5 • Session RAG)
+
+## No Active Notebook
+- Visit https://notebooklm.google to create a notebook and get a share link
+- Use **add_notebook** to add it to your library (explains how to get the link)
+- Use **list_notebooks** to show available sources
+- Use **select_notebook** to set one active
+
+> Auth tip: If login is required, use the prompt 'notebooklm.auth-setup' and then verify with the 'get_health' tool. If authentication later fails (e.g., expired cookies), use the prompt 'notebooklm.auth-repair'.
+
+Tip: Tell the user you can manage NotebookLM library and ask which notebook to use for the current task.`;
+    }
+}
+export const askQuestionTool = {
+    name: "ask_question",
+    // Description will be set dynamically using buildAskQuestionDescription
+    description: "Dynamic description placeholder",
+    inputSchema: {
+        type: "object",
+        properties: {
+            question: {
+                type: "string",
+                description: "The question to ask NotebookLM",
+            },
+            session_id: {
+                type: "string",
+                description: "Optional session ID for contextual conversations. If omitted, a new session is created.",
+            },
+            notebook_id: {
+                type: "string",
+                description: "Optional notebook ID from your library. If omitted, uses the active notebook. " +
+                    "Use list_notebooks to see available notebooks.",
+            },
+            notebook_url: {
+                type: "string",
+                description: "Optional notebook URL (overrides notebook_id). Use this for ad-hoc queries to notebooks not in your library.",
+            },
+            show_browser: {
+                type: "boolean",
+                description: "Show browser window for debugging (simple version). " +
+                    "For advanced control (typing speed, stealth, etc.), use browser_options instead.",
+            },
+            browser_options: {
+                type: "object",
+                description: "Optional browser behavior settings. Claude can control everything: " +
+                    "visibility, typing speed, stealth mode, timeouts. Useful for debugging or fine-tuning.",
+                properties: {
+                    show: {
+                        type: "boolean",
+                        description: "Show browser window (default: from ENV or false)",
+                    },
+                    headless: {
+                        type: "boolean",
+                        description: "Run browser in headless mode (default: true)",
+                    },
+                    timeout_ms: {
+                        type: "number",
+                        description: "Browser operation timeout in milliseconds (default: 30000)",
+                    },
+                    stealth: {
+                        type: "object",
+                        description: "Human-like behavior settings to avoid detection",
+                        properties: {
+                            enabled: {
+                                type: "boolean",
+                                description: "Master switch for all stealth features (default: true)",
+                            },
+                            random_delays: {
+                                type: "boolean",
+                                description: "Random delays between actions (default: true)",
+                            },
+                            human_typing: {
+                                type: "boolean",
+                                description: "Human-like typing patterns (default: true)",
+                            },
+                            mouse_movements: {
+                                type: "boolean",
+                                description: "Realistic mouse movements (default: true)",
+                            },
+                            typing_wpm_min: {
+                                type: "number",
+                                description: "Minimum typing speed in WPM (default: 160)",
+                            },
+                            typing_wpm_max: {
+                                type: "number",
+                                description: "Maximum typing speed in WPM (default: 240)",
+                            },
+                            delay_min_ms: {
+                                type: "number",
+                                description: "Minimum delay between actions in ms (default: 100)",
+                            },
+                            delay_max_ms: {
+                                type: "number",
+                                description: "Maximum delay between actions in ms (default: 400)",
+                            },
+                        },
+                    },
+                    viewport: {
+                        type: "object",
+                        description: "Browser viewport size",
+                        properties: {
+                            width: {
+                                type: "number",
+                                description: "Viewport width in pixels (default: 1920)",
+                            },
+                            height: {
+                                type: "number",
+                                description: "Viewport height in pixels (default: 1080)",
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        required: ["question"],
+    },
+};
+//# sourceMappingURL=ask-question.js.map

package/dist/tools/definitions/ask-question.js.map

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

package/dist/tools/definitions/notebook-management.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const notebookManagementTools: Tool[];
+//# sourceMappingURL=notebook-management.d.ts.map

package/dist/tools/definitions/notebook-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-management.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/notebook-management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,eAAO,MAAM,uBAAuB,EAAE,IAAI,EAwPzC,CAAC"}

package/dist/tools/definitions/notebook-management.js

@@ -0,0 +1,243 @@
+export const notebookManagementTools = [
+    {
+        name: "add_notebook",
+        description: `PERMISSION REQUIRED — Only when user explicitly asks to add a notebook.
+
+## Conversation Workflow (Mandatory)
+When the user says: "I have a NotebookLM with X"
+
+1) Ask URL: "What is the NotebookLM URL?"
+2) Ask content: "What knowledge is inside?" (1–2 sentences)
+3) Ask topics: "Which topics does it cover?" (3–5)
+4) Ask use cases: "When should we consult it?"
+5) Propose metadata and confirm:
+   - Name: [suggested]
+   - Description: [from user]
+   - Topics: [list]
+   - Use cases: [list]
+   "Add it to your library now?"
+6) Only after explicit "Yes" → call this tool
+
+## Rules
+- Do not add without user permission
+- Do not guess metadata — ask concisely
+- Confirm summary before calling the tool
+
+## Example
+User: "I have a notebook with n8n docs"
+You: Ask URL → content → topics → use cases; propose summary
+User: "Yes"
+You: Call add_notebook
+
+## How to Get a NotebookLM Share Link
+
+Visit https://notebooklm.google/ → Login (free: 100 notebooks, 50 sources each, 500k words, 50 daily queries)
+1) Click "+ New" (top right) → Upload sources (docs, knowledge)
+2) Click "Share" (top right) → Select "Anyone with the link"
+3) Click "Copy link" (bottom left) → Give this link to Claude
+
+(Upgraded: Google AI Pro/Ultra gives 5x higher limits)`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The NotebookLM notebook URL",
+                },
+                name: {
+                    type: "string",
+                    description: "Display name for the notebook (e.g., 'n8n Documentation')",
+                },
+                description: {
+                    type: "string",
+                    description: "What knowledge/content is in this notebook",
+                },
+                topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Topics covered in this notebook",
+                },
+                content_types: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Types of content (e.g., ['documentation', 'examples', 'best practices'])",
+                },
+                use_cases: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "When should Claude use this notebook (e.g., ['Implementing n8n workflows'])",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional tags for organization",
+                },
+            },
+            required: ["url", "name", "description", "topics"],
+        },
+    },
+    {
+        name: "list_notebooks",
+        description: "List all library notebooks with metadata (name, topics, use cases, URL). " +
+            "Use this to present options, then ask which notebook to use for the task.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_notebook",
+        description: "Get detailed information about a specific notebook by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The notebook ID",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "select_notebook",
+        description: `Set a notebook as the active default (used when ask_question has no notebook_id).
+
+## When To Use
+- User switches context: "Let's work on React now"
+- User asks explicitly to activate a notebook
+- Obvious task change requires another notebook
+
+## Auto-Switching
+- Safe to auto-switch if the context is clear and you announce it:
+  "Switching to React notebook for this task..."
+- If ambiguous, ask: "Switch to [notebook] for this task?"
+
+## Example
+User: "Now let's build the React frontend"
+You: "Switching to React notebook..." (call select_notebook)`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The notebook ID to activate",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "update_notebook",
+        description: `Update notebook metadata based on user intent.
+
+## Pattern
+1) Identify target notebook and fields (topics, description, use_cases, tags, url)
+2) Propose the exact change back to the user
+3) After explicit confirmation, call this tool
+
+## Examples
+- User: "React notebook also covers Next.js 14"
+  You: "Add 'Next.js 14' to topics for React?"
+  User: "Yes" → call update_notebook
+
+- User: "Include error handling in n8n description"
+  You: "Update the n8n description to mention error handling?"
+  User: "Yes" → call update_notebook
+
+Tip: You may update multiple fields at once if requested.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The notebook ID to update",
+                },
+                name: {
+                    type: "string",
+                    description: "New display name",
+                },
+                description: {
+                    type: "string",
+                    description: "New description",
+                },
+                topics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New topics list",
+                },
+                content_types: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New content types",
+                },
+                use_cases: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New use cases",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New tags",
+                },
+                url: {
+                    type: "string",
+                    description: "New notebook URL",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "remove_notebook",
+        description: `Dangerous — requires explicit user confirmation.
+
+## Confirmation Workflow
+1) User requests removal ("Remove the React notebook")
+2) Look up full name to confirm
+3) Ask: "Remove '[notebook_name]' from your library? (Does not delete the actual NotebookLM notebook)"
+4) Only on explicit "Yes" → call remove_notebook
+
+Never remove without permission or based on assumptions.
+
+Example:
+User: "Delete the old React notebook"
+You: "Remove 'React Best Practices' from your library?"
+User: "Yes" → call remove_notebook`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The notebook ID to remove",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "search_notebooks",
+        description: "Search library by query (name, description, topics, tags). " +
+            "Use to propose relevant notebooks for the task and then ask which to use.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "get_library_stats",
+        description: "Get statistics about your notebook library (total notebooks, usage, etc.)",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];
+//# sourceMappingURL=notebook-management.js.map

package/dist/tools/definitions/notebook-management.js.map

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

package/dist/tools/definitions/session-management.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const sessionManagementTools: Tool[];
+//# sourceMappingURL=session-management.d.ts.map

package/dist/tools/definitions/session-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-management.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/session-management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,eAAO,MAAM,sBAAsB,EAAE,IAAI,EAyCxC,CAAC"}