@roomi-fields/notebooklm-mcp 1.3.3 → 1.3.5

package/dist/tools/index.js

@@ -11,112 +11,112 @@
  *
  * Based on the Python implementation from tools/*.py
  */
-import { CONFIG, applyBrowserOptions } from "../config.js";
-import { log } from "../utils/logger.js";
-import { RateLimitError } from "../errors.js";
-import { CleanupManager } from "../utils/cleanup-manager.js";
+import { CONFIG, applyBrowserOptions } from '../config.js';
+import { log } from '../utils/logger.js';
+import { RateLimitError } from '../errors.js';
+import { CleanupManager } from '../utils/cleanup-manager.js';
 /**
  * Build dynamic tool description for ask_question based on active notebook or library
  */
 function buildAskQuestionDescription(library) {
     const active = library.getActiveNotebook();
     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)
-\`\`\`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 })
-\`\`\`
-
-## 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):
-\`\`\`
-Q: "How do I handle errors in n8n?"
-A: [basic answer]
-→ Implement → Probably missing edge cases!
-\`\`\`
-
-Good (deep):
-\`\`\`
-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!
-\`\`\`
-    
-## 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)
+        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)
+\`\`\`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 })
+\`\`\`
+
+## 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):
+\`\`\`
+Q: "How do I handle errors in n8n?"
+A: [basic answer]
+→ Implement → Probably missing edge cases!
+\`\`\`
+
+Good (deep):
+\`\`\`
+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!
+\`\`\`
+    
+## 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'.
-
+        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.`;
     }
 }
@@ -126,495 +126,495 @@ Tip: Tell the user you can manage NotebookLM library and ask which notebook to u
 export function buildToolDefinitions(library) {
     return [
         {
-            name: "ask_question",
+            name: 'ask_question',
             description: buildAskQuestionDescription(library),
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     question: {
-                        type: "string",
-                        description: "The question to ask NotebookLM",
+                        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.",
+                        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.",
+                        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.",
+                        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.",
+                        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.",
+                        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)",
+                                type: 'boolean',
+                                description: 'Show browser window (default: from ENV or false)',
                             },
                             headless: {
-                                type: "boolean",
-                                description: "Run browser in headless mode (default: true)",
+                                type: 'boolean',
+                                description: 'Run browser in headless mode (default: true)',
                             },
                             timeout_ms: {
-                                type: "number",
-                                description: "Browser operation timeout in milliseconds (default: 30000)",
+                                type: 'number',
+                                description: 'Browser operation timeout in milliseconds (default: 30000)',
                             },
                             stealth: {
-                                type: "object",
-                                description: "Human-like behavior settings to avoid detection",
+                                type: 'object',
+                                description: 'Human-like behavior settings to avoid detection',
                                 properties: {
                                     enabled: {
-                                        type: "boolean",
-                                        description: "Master switch for all stealth features (default: true)",
+                                        type: 'boolean',
+                                        description: 'Master switch for all stealth features (default: true)',
                                     },
                                     random_delays: {
-                                        type: "boolean",
-                                        description: "Random delays between actions (default: true)",
+                                        type: 'boolean',
+                                        description: 'Random delays between actions (default: true)',
                                     },
                                     human_typing: {
-                                        type: "boolean",
-                                        description: "Human-like typing patterns (default: true)",
+                                        type: 'boolean',
+                                        description: 'Human-like typing patterns (default: true)',
                                     },
                                     mouse_movements: {
-                                        type: "boolean",
-                                        description: "Realistic mouse movements (default: true)",
+                                        type: 'boolean',
+                                        description: 'Realistic mouse movements (default: true)',
                                     },
                                     typing_wpm_min: {
-                                        type: "number",
-                                        description: "Minimum typing speed in WPM (default: 160)",
+                                        type: 'number',
+                                        description: 'Minimum typing speed in WPM (default: 160)',
                                     },
                                     typing_wpm_max: {
-                                        type: "number",
-                                        description: "Maximum typing speed in WPM (default: 240)",
+                                        type: 'number',
+                                        description: 'Maximum typing speed in WPM (default: 240)',
                                     },
                                     delay_min_ms: {
-                                        type: "number",
-                                        description: "Minimum delay between actions in ms (default: 100)",
+                                        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)",
+                                        type: 'number',
+                                        description: 'Maximum delay between actions in ms (default: 400)',
                                     },
                                 },
                             },
                             viewport: {
-                                type: "object",
-                                description: "Browser viewport size",
+                                type: 'object',
+                                description: 'Browser viewport size',
                                 properties: {
                                     width: {
-                                        type: "number",
-                                        description: "Viewport width in pixels (default: 1920)",
+                                        type: 'number',
+                                        description: 'Viewport width in pixels (default: 1920)',
                                     },
                                     height: {
-                                        type: "number",
-                                        description: "Viewport height in pixels (default: 1080)",
+                                        type: 'number',
+                                        description: 'Viewport height in pixels (default: 1080)',
                                     },
                                 },
                             },
                         },
                     },
                 },
-                required: ["question"],
+                required: ['question'],
             },
         },
         {
-            name: "auto_discover_notebook",
-            description: `🚀 AUTO-DISCOVERY — Automatically generate notebook metadata via NotebookLM (RECOMMENDED)
-
-## When to Use
-- User provides NotebookLM URL and wants quick/automatic setup
-- User prefers not to manually specify metadata
-- Default choice for adding notebooks
-
-## Workflow
-1) User provides NotebookLM URL
-2) Ask confirmation: "Add '[URL]' with auto-generated metadata?"
-3) Call this tool → NotebookLM generates name, description, tags
-4) Show generated metadata to user for review
-
-## Benefits
-- ✅ 30 seconds vs 5 minutes manual entry
-- ✅ Zero-friction notebook addition
-- ✅ Consistent metadata quality
-- ✅ Discovers topics user might not think of
-
-## Example
-User: "Add this NotebookLM: https://notebooklm.google.com/notebook/abc123"
-You: "Add this notebook with auto-generated metadata?"
-User: "Yes"
-You: Call auto_discover_notebook(url="https://...")
-→ Returns: {name: "n8n-workflow-guide", description: "...", tags: [...]}
-
-## Fallback
-If auto-discovery fails (rare), use add_notebook tool for manual entry.
-
-## 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
-
+            name: 'auto_discover_notebook',
+            description: `🚀 AUTO-DISCOVERY — Automatically generate notebook metadata via NotebookLM (RECOMMENDED)
+
+## When to Use
+- User provides NotebookLM URL and wants quick/automatic setup
+- User prefers not to manually specify metadata
+- Default choice for adding notebooks
+
+## Workflow
+1) User provides NotebookLM URL
+2) Ask confirmation: "Add '[URL]' with auto-generated metadata?"
+3) Call this tool → NotebookLM generates name, description, tags
+4) Show generated metadata to user for review
+
+## Benefits
+- ✅ 30 seconds vs 5 minutes manual entry
+- ✅ Zero-friction notebook addition
+- ✅ Consistent metadata quality
+- ✅ Discovers topics user might not think of
+
+## Example
+User: "Add this NotebookLM: https://notebooklm.google.com/notebook/abc123"
+You: "Add this notebook with auto-generated metadata?"
+User: "Yes"
+You: Call auto_discover_notebook(url="https://...")
+→ Returns: {name: "n8n-workflow-guide", description: "...", tags: [...]}
+
+## Fallback
+If auto-discovery fails (rare), use add_notebook tool for manual entry.
+
+## 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",
+                type: 'object',
                 properties: {
                     url: {
-                        type: "string",
-                        description: "The NotebookLM notebook URL",
+                        type: 'string',
+                        description: 'The NotebookLM notebook URL',
                     },
                 },
-                required: ["url"],
+                required: ['url'],
             },
         },
         {
-            name: "add_notebook",
-            description: `📝 MANUAL ENTRY — Add notebook with manually specified metadata (use auto_discover_notebook instead)
-
-## When to Use
-- Auto-discovery failed or unavailable
-- User has specific metadata requirements
-- User prefers manual control
-
-## Conversation Workflow (Mandatory)
-When the user says: "I have a NotebookLM with X"
-
-**FIRST:** Try auto_discover_notebook for faster setup
-**ONLY IF** user refuses auto-discovery or it fails:
-
-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
-- Prefer auto_discover_notebook when possible
-- Do not guess metadata — ask concisely
-- Confirm summary before calling the tool
-
-## Example
-User: "I have a notebook with n8n docs"
-You: "Want me to auto-generate the metadata?" (offer auto_discover_notebook first)
-User: "No, I'll specify it myself"
-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
-
+            name: 'add_notebook',
+            description: `📝 MANUAL ENTRY — Add notebook with manually specified metadata (use auto_discover_notebook instead)
+
+## When to Use
+- Auto-discovery failed or unavailable
+- User has specific metadata requirements
+- User prefers manual control
+
+## Conversation Workflow (Mandatory)
+When the user says: "I have a NotebookLM with X"
+
+**FIRST:** Try auto_discover_notebook for faster setup
+**ONLY IF** user refuses auto-discovery or it fails:
+
+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
+- Prefer auto_discover_notebook when possible
+- Do not guess metadata — ask concisely
+- Confirm summary before calling the tool
+
+## Example
+User: "I have a notebook with n8n docs"
+You: "Want me to auto-generate the metadata?" (offer auto_discover_notebook first)
+User: "No, I'll specify it myself"
+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",
+                type: 'object',
                 properties: {
                     url: {
-                        type: "string",
-                        description: "The NotebookLM notebook URL",
+                        type: 'string',
+                        description: 'The NotebookLM notebook URL',
                     },
                     name: {
-                        type: "string",
+                        type: 'string',
                         description: "Display name for the notebook (e.g., 'n8n Documentation')",
                     },
                     description: {
-                        type: "string",
-                        description: "What knowledge/content is in this notebook",
+                        type: 'string',
+                        description: 'What knowledge/content is in this notebook',
                     },
                     topics: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "Topics covered in this notebook",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Topics covered in this notebook',
                     },
                     content_types: {
-                        type: "array",
-                        items: { type: "string" },
+                        type: 'array',
+                        items: { type: 'string' },
                         description: "Types of content (e.g., ['documentation', 'examples', 'best practices'])",
                     },
                     use_cases: {
-                        type: "array",
-                        items: { type: "string" },
+                        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",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Optional tags for organization',
                     },
                 },
-                required: ["url", "name", "description", "topics"],
+                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.",
+            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",
+                type: 'object',
                 properties: {},
             },
         },
         {
-            name: "get_notebook",
-            description: "Get detailed information about a specific notebook by ID",
+            name: 'get_notebook',
+            description: 'Get detailed information about a specific notebook by ID',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     id: {
-                        type: "string",
-                        description: "The notebook ID",
+                        type: 'string',
+                        description: 'The notebook ID',
                     },
                 },
-                required: ["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"
+            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",
+                type: 'object',
                 properties: {
                     id: {
-                        type: "string",
-                        description: "The notebook ID to activate",
+                        type: 'string',
+                        description: 'The notebook ID to activate',
                     },
                 },
-                required: ["id"],
+                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
-
+            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",
+                type: 'object',
                 properties: {
                     id: {
-                        type: "string",
-                        description: "The notebook ID to update",
+                        type: 'string',
+                        description: 'The notebook ID to update',
                     },
                     name: {
-                        type: "string",
-                        description: "New display name",
+                        type: 'string',
+                        description: 'New display name',
                     },
                     description: {
-                        type: "string",
-                        description: "New description",
+                        type: 'string',
+                        description: 'New description',
                     },
                     topics: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "New topics list",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'New topics list',
                     },
                     content_types: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "New content types",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'New content types',
                     },
                     use_cases: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "New use cases",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'New use cases',
                     },
                     tags: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "New tags",
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'New tags',
                     },
                     url: {
-                        type: "string",
-                        description: "New notebook URL",
+                        type: 'string',
+                        description: 'New notebook URL',
                     },
                 },
-                required: ["id"],
+                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?"
+            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",
+                type: 'object',
                 properties: {
                     id: {
-                        type: "string",
-                        description: "The notebook ID to remove",
+                        type: 'string',
+                        description: 'The notebook ID to remove',
                     },
                 },
-                required: ["id"],
+                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.",
+            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",
+                type: 'object',
                 properties: {
                     query: {
-                        type: "string",
-                        description: "Search query",
+                        type: 'string',
+                        description: 'Search query',
                     },
                 },
-                required: ["query"],
+                required: ['query'],
             },
         },
         {
-            name: "get_library_stats",
-            description: "Get statistics about your notebook library (total notebooks, usage, etc.)",
+            name: 'get_library_stats',
+            description: 'Get statistics about your notebook library (total notebooks, usage, etc.)',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {},
             },
         },
         {
-            name: "list_sessions",
-            description: "List all active sessions with stats (age, message count, last activity). " +
-                "Use to continue the most relevant session instead of starting from scratch.",
+            name: 'list_sessions',
+            description: 'List all active sessions with stats (age, message count, last activity). ' +
+                'Use to continue the most relevant session instead of starting from scratch.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {},
             },
         },
         {
-            name: "close_session",
-            description: "Close a specific session by session ID. Ask before closing if the user might still need it.",
+            name: 'close_session',
+            description: 'Close a specific session by session ID. Ask before closing if the user might still need it.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     session_id: {
-                        type: "string",
-                        description: "The session ID to close",
+                        type: 'string',
+                        description: 'The session ID to close',
                     },
                 },
-                required: ["session_id"],
+                required: ['session_id'],
             },
         },
         {
-            name: "reset_session",
+            name: 'reset_session',
             description: "Reset a session's chat history (keep same session ID). " +
-                "Use for a clean slate when the task changes; ask the user before resetting.",
+                'Use for a clean slate when the task changes; ask the user before resetting.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     session_id: {
-                        type: "string",
-                        description: "The session ID to reset",
+                        type: 'string',
+                        description: 'The session ID to reset',
                     },
                 },
-                required: ["session_id"],
+                required: ['session_id'],
             },
         },
         {
-            name: "get_health",
-            description: "Get server health status including authentication state, active sessions, and configuration. " +
-                "Use this to verify the server is ready before starting research workflows.\n\n" +
-                "If authenticated=false and having persistent issues:\n" +
-                "Consider running cleanup_data(preserve_library=true) + setup_auth for fresh start with clean browser session.",
+            name: 'get_health',
+            description: 'Get server health status including authentication state, active sessions, and configuration. ' +
+                'Use this to verify the server is ready before starting research workflows.\n\n' +
+                'If authenticated=false and having persistent issues:\n' +
+                'Consider running cleanup_data(preserve_library=true) + setup_auth for fresh start with clean browser session.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {},
             },
         },
         {
-            name: "setup_auth",
-            description: "Google authentication for NotebookLM access - opens a browser window for manual login to your Google account. " +
-                "Returns immediately after opening the browser. You have up to 10 minutes to complete the login. " +
+            name: 'setup_auth',
+            description: 'Google authentication for NotebookLM access - opens a browser window for manual login to your Google account. ' +
+                'Returns immediately after opening the browser. You have up to 10 minutes to complete the login. ' +
                 "Use 'get_health' tool afterwards to verify authentication was saved successfully. " +
-                "Use this for first-time authentication or when auto-login credentials are not available. " +
-                "IMPORTANT: If already authenticated, this tool will skip re-authentication. " +
+                'Use this for first-time authentication or when auto-login credentials are not available. ' +
+                'IMPORTANT: If already authenticated, this tool will skip re-authentication. ' +
                 "For switching accounts or rate-limit workarounds, use 're_auth' tool instead.\n\n" +
-                "TROUBLESHOOTING for persistent auth issues:\n" +
-                "If setup_auth fails or you encounter browser/session issues:\n" +
-                "1. Ask user to close ALL Chrome/Chromium instances\n" +
-                "2. Run cleanup_data(confirm=true, preserve_library=true) to clean old data\n" +
-                "3. Run setup_auth again for fresh start\n" +
-                "This helps resolve conflicts from old browser sessions and installation data.",
+                'TROUBLESHOOTING for persistent auth issues:\n' +
+                'If setup_auth fails or you encounter browser/session issues:\n' +
+                '1. Ask user to close ALL Chrome/Chromium instances\n' +
+                '2. Run cleanup_data(confirm=true, preserve_library=true) to clean old data\n' +
+                '3. Run setup_auth again for fresh start\n' +
+                'This helps resolve conflicts from old browser sessions and installation data.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     show_browser: {
-                        type: "boolean",
-                        description: "Show browser window (simple version). Default: true for setup. " +
-                            "For advanced control, use browser_options instead.",
+                        type: 'boolean',
+                        description: 'Show browser window (simple version). Default: true for setup. ' +
+                            'For advanced control, use browser_options instead.',
                     },
                     browser_options: {
-                        type: "object",
-                        description: "Optional browser settings. Control visibility, timeouts, and stealth behavior.",
+                        type: 'object',
+                        description: 'Optional browser settings. Control visibility, timeouts, and stealth behavior.',
                         properties: {
                             show: {
-                                type: "boolean",
-                                description: "Show browser window (default: true for setup)",
+                                type: 'boolean',
+                                description: 'Show browser window (default: true for setup)',
                             },
                             headless: {
-                                type: "boolean",
-                                description: "Run browser in headless mode (default: false for setup)",
+                                type: 'boolean',
+                                description: 'Run browser in headless mode (default: false for setup)',
                             },
                             timeout_ms: {
-                                type: "number",
-                                description: "Browser operation timeout in milliseconds (default: 30000)",
+                                type: 'number',
+                                description: 'Browser operation timeout in milliseconds (default: 30000)',
                             },
                         },
                     },
@@ -622,65 +622,65 @@ User: "Yes" → call remove_notebook`,
             },
         },
         {
-            name: "de_auth",
-            description: "De-authenticate (logout) - Clears all authentication data for security. " +
-                "Use this when:\n" +
-                "- User wants to log out for security reasons\n" +
-                "- Removing credentials before shutting down\n" +
-                "- Clearing auth without immediately re-authenticating\n\n" +
-                "This will:\n" +
-                "1. Close all active browser sessions\n" +
-                "2. Delete all saved authentication data (cookies, Chrome profile)\n" +
-                "3. Preserve notebook library and other data\n\n" +
-                "IMPORTANT: After de_auth, the server will need re-authentication via setup_auth or re_auth before making queries.\n\n" +
+            name: 'de_auth',
+            description: 'De-authenticate (logout) - Clears all authentication data for security. ' +
+                'Use this when:\n' +
+                '- User wants to log out for security reasons\n' +
+                '- Removing credentials before shutting down\n' +
+                '- Clearing auth without immediately re-authenticating\n\n' +
+                'This will:\n' +
+                '1. Close all active browser sessions\n' +
+                '2. Delete all saved authentication data (cookies, Chrome profile)\n' +
+                '3. Preserve notebook library and other data\n\n' +
+                'IMPORTANT: After de_auth, the server will need re-authentication via setup_auth or re_auth before making queries.\n\n' +
                 "Use 'get_health' to verify de-authentication was successful (authenticated: false).",
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {},
             },
         },
         {
-            name: "re_auth",
-            description: "Switch to a different Google account or re-authenticate. " +
-                "Use this when:\n" +
-                "- NotebookLM rate limit is reached (50 queries/day for free accounts)\n" +
-                "- You want to switch to a different Google account\n" +
-                "- Authentication is broken and needs a fresh start\n\n" +
-                "This will:\n" +
-                "1. Close all active browser sessions\n" +
-                "2. Delete all saved authentication data (cookies, Chrome profile)\n" +
-                "3. Open browser for fresh Google login\n\n" +
+            name: 're_auth',
+            description: 'Switch to a different Google account or re-authenticate. ' +
+                'Use this when:\n' +
+                '- NotebookLM rate limit is reached (50 queries/day for free accounts)\n' +
+                '- You want to switch to a different Google account\n' +
+                '- Authentication is broken and needs a fresh start\n\n' +
+                'This will:\n' +
+                '1. Close all active browser sessions\n' +
+                '2. Delete all saved authentication data (cookies, Chrome profile)\n' +
+                '3. Open browser for fresh Google login\n\n' +
                 "After completion, use 'get_health' to verify authentication.\n\n" +
-                "TROUBLESHOOTING for persistent auth issues:\n" +
-                "If re_auth fails repeatedly:\n" +
-                "1. Ask user to close ALL Chrome/Chromium instances\n" +
-                "2. Run cleanup_data(confirm=false, preserve_library=true) to preview old files\n" +
-                "3. Run cleanup_data(confirm=true, preserve_library=true) to clean everything except library\n" +
-                "4. Run re_auth again for completely fresh start\n" +
-                "This removes old installation data and browser sessions that can cause conflicts.",
+                'TROUBLESHOOTING for persistent auth issues:\n' +
+                'If re_auth fails repeatedly:\n' +
+                '1. Ask user to close ALL Chrome/Chromium instances\n' +
+                '2. Run cleanup_data(confirm=false, preserve_library=true) to preview old files\n' +
+                '3. Run cleanup_data(confirm=true, preserve_library=true) to clean everything except library\n' +
+                '4. Run re_auth again for completely fresh start\n' +
+                'This removes old installation data and browser sessions that can cause conflicts.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     show_browser: {
-                        type: "boolean",
-                        description: "Show browser window (simple version). Default: true for re-auth. " +
-                            "For advanced control, use browser_options instead.",
+                        type: 'boolean',
+                        description: 'Show browser window (simple version). Default: true for re-auth. ' +
+                            'For advanced control, use browser_options instead.',
                     },
                     browser_options: {
-                        type: "object",
-                        description: "Optional browser settings. Control visibility, timeouts, and stealth behavior.",
+                        type: 'object',
+                        description: 'Optional browser settings. Control visibility, timeouts, and stealth behavior.',
                         properties: {
                             show: {
-                                type: "boolean",
-                                description: "Show browser window (default: true for re-auth)",
+                                type: 'boolean',
+                                description: 'Show browser window (default: true for re-auth)',
                             },
                             headless: {
-                                type: "boolean",
-                                description: "Run browser in headless mode (default: false for re-auth)",
+                                type: 'boolean',
+                                description: 'Run browser in headless mode (default: false for re-auth)',
                             },
                             timeout_ms: {
-                                type: "number",
-                                description: "Browser operation timeout in milliseconds (default: 30000)",
+                                type: 'number',
+                                description: 'Browser operation timeout in milliseconds (default: 30000)',
                             },
                         },
                     },
@@ -688,42 +688,42 @@ User: "Yes" → call remove_notebook`,
             },
         },
         {
-            name: "cleanup_data",
-            description: "ULTRATHINK Deep Cleanup - Scans entire system for ALL NotebookLM MCP data files across 8 categories. Always runs in deep mode, shows categorized preview before deletion.\n\n" +
-                "⚠️ CRITICAL: Close ALL Chrome/Chromium instances BEFORE running this tool! Open browsers can prevent cleanup and cause issues.\n\n" +
-                "Categories scanned:\n" +
-                "1. Legacy Installation (notebooklm-mcp-nodejs) - Old paths with -nodejs suffix\n" +
-                "2. Current Installation (notebooklm-mcp) - Active data, browser profiles, library\n" +
-                "3. NPM/NPX Cache - Cached installations from npx\n" +
-                "4. Claude CLI MCP Logs - MCP server logs from Claude CLI\n" +
-                "5. Temporary Backups - Backup directories in system temp\n" +
-                "6. Claude Projects Cache - Project-specific cache (optional)\n" +
-                "7. Editor Logs (Cursor/VSCode) - MCP logs from code editors (optional)\n" +
-                "8. Trash Files - Deleted notebooklm files in system trash (optional)\n\n" +
-                "Works cross-platform (Linux, Windows, macOS). Safe by design: shows detailed preview before deletion, requires explicit confirmation.\n\n" +
-                "LIBRARY PRESERVATION: Set preserve_library=true to keep your notebook library.json file while cleaning everything else.\n\n" +
-                "RECOMMENDED WORKFLOW for fresh start:\n" +
-                "1. Ask user to close ALL Chrome/Chromium instances\n" +
-                "2. Run cleanup_data(confirm=false, preserve_library=true) to preview\n" +
-                "3. Run cleanup_data(confirm=true, preserve_library=true) to execute\n" +
-                "4. Run setup_auth or re_auth for fresh browser session\n\n" +
-                "Use cases: Clean reinstall, troubleshooting auth issues, removing all traces before uninstall, cleaning old browser sessions and installation data.",
+            name: 'cleanup_data',
+            description: 'ULTRATHINK Deep Cleanup - Scans entire system for ALL NotebookLM MCP data files across 8 categories. Always runs in deep mode, shows categorized preview before deletion.\n\n' +
+                '⚠️ CRITICAL: Close ALL Chrome/Chromium instances BEFORE running this tool! Open browsers can prevent cleanup and cause issues.\n\n' +
+                'Categories scanned:\n' +
+                '1. Legacy Installation (notebooklm-mcp-nodejs) - Old paths with -nodejs suffix\n' +
+                '2. Current Installation (notebooklm-mcp) - Active data, browser profiles, library\n' +
+                '3. NPM/NPX Cache - Cached installations from npx\n' +
+                '4. Claude CLI MCP Logs - MCP server logs from Claude CLI\n' +
+                '5. Temporary Backups - Backup directories in system temp\n' +
+                '6. Claude Projects Cache - Project-specific cache (optional)\n' +
+                '7. Editor Logs (Cursor/VSCode) - MCP logs from code editors (optional)\n' +
+                '8. Trash Files - Deleted notebooklm files in system trash (optional)\n\n' +
+                'Works cross-platform (Linux, Windows, macOS). Safe by design: shows detailed preview before deletion, requires explicit confirmation.\n\n' +
+                'LIBRARY PRESERVATION: Set preserve_library=true to keep your notebook library.json file while cleaning everything else.\n\n' +
+                'RECOMMENDED WORKFLOW for fresh start:\n' +
+                '1. Ask user to close ALL Chrome/Chromium instances\n' +
+                '2. Run cleanup_data(confirm=false, preserve_library=true) to preview\n' +
+                '3. Run cleanup_data(confirm=true, preserve_library=true) to execute\n' +
+                '4. Run setup_auth or re_auth for fresh browser session\n\n' +
+                'Use cases: Clean reinstall, troubleshooting auth issues, removing all traces before uninstall, cleaning old browser sessions and installation data.',
             inputSchema: {
-                type: "object",
+                type: 'object',
                 properties: {
                     confirm: {
-                        type: "boolean",
-                        description: "Confirmation flag. Tool shows preview first, then user confirms deletion. " +
-                            "Set to true only after user has reviewed the preview and explicitly confirmed.",
+                        type: 'boolean',
+                        description: 'Confirmation flag. Tool shows preview first, then user confirms deletion. ' +
+                            'Set to true only after user has reviewed the preview and explicitly confirmed.',
                     },
                     preserve_library: {
-                        type: "boolean",
-                        description: "Preserve library.json file during cleanup. Default: false. " +
-                            "Set to true to keep your notebook library while deleting everything else (browser data, caches, logs).",
+                        type: 'boolean',
+                        description: 'Preserve library.json file during cleanup. Default: false. ' +
+                            'Set to true to keep your notebook library while deleting everything else (browser data, caches, logs).',
                         default: false,
                     },
                 },
-                required: ["confirm"],
+                required: ['confirm'],
             },
         },
     ];
@@ -772,7 +772,7 @@ export class ToolHandlers {
                             `  { "question": "...", "notebook_url": "https://notebooklm.google.com/notebook/..." }`);
                     }
                     else {
-                        const availableIds = allNotebooks.map(n => n.id).join(', ');
+                        const availableIds = allNotebooks.map((n) => n.id).join(', ');
                         throw new Error(`Notebook not found: '${notebook_id}'\n\n` +
                             `Available notebooks: ${availableIds}\n\n` +
                             `To list all notebooks: GET /notebooks\n` +
@@ -806,7 +806,7 @@ export class ToolHandlers {
                             `   GET /notebooks to list available notebooks`);
                     }
                     else {
-                        const availableIds = allNotebooks.map(n => `${n.id} (${n.name})`).join('\n   - ');
+                        const availableIds = allNotebooks.map((n) => `${n.id} (${n.name})`).join('\n   - ');
                         throw new Error(`❌ No notebook specified.\n\n` +
                             `Available notebooks:\n   - ${availableIds}\n\n` +
                             `Please specify one of:\n` +
@@ -817,7 +817,7 @@ export class ToolHandlers {
                 }
             }
             // Progress: Getting or creating session
-            await sendProgress?.("Getting or creating browser session...", 1, 5);
+            await sendProgress?.('Getting or creating browser session...', 1, 5);
             // Apply browser options temporarily
             const originalConfig = { ...CONFIG };
             const effectiveConfig = applyBrowserOptions(browser_options, show_browser);
@@ -838,7 +838,7 @@ export class ToolHandlers {
                 // Get or create session (with headless override to handle mode changes)
                 const session = await this.sessionManager.getOrCreateSession(session_id, resolvedNotebookUrl, overrideHeadless);
                 // Progress: Asking question
-                await sendProgress?.("Asking question to NotebookLM...", 2, 5);
+                await sendProgress?.('Asking question to NotebookLM...', 2, 5);
                 // Ask the question (pass progress callback)
                 const rawAnswer = await session.ask(question, sendProgress);
                 // Note: FOLLOW_UP_REMINDER removed for cleaner responses
@@ -846,7 +846,7 @@ export class ToolHandlers {
                 // Get session info
                 const sessionInfo = session.getInfo();
                 const result = {
-                    status: "success",
+                    status: 'success',
                     question,
                     answer,
                     session_id: session.sessionId,
@@ -858,7 +858,7 @@ export class ToolHandlers {
                     },
                 };
                 // Progress: Complete
-                await sendProgress?.("Question answered successfully!", 5, 5);
+                await sendProgress?.('Question answered successfully!', 5, 5);
                 log.success(`✅ [TOOL] ask_question completed successfully`);
                 return {
                     success: true,
@@ -873,15 +873,15 @@ export class ToolHandlers {
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             // Special handling for rate limit errors
-            if (error instanceof RateLimitError || errorMessage.toLowerCase().includes("rate limit")) {
+            if (error instanceof RateLimitError || errorMessage.toLowerCase().includes('rate limit')) {
                 log.error(`🚫 [TOOL] Rate limit detected`);
                 return {
                     success: false,
-                    error: "NotebookLM rate limit reached (50 queries/day for free accounts).\n\n" +
-                        "You can:\n" +
+                    error: 'NotebookLM rate limit reached (50 queries/day for free accounts).\n\n' +
+                        'You can:\n' +
                         "1. Use the 're_auth' tool to login with a different Google account\n" +
-                        "2. Wait until tomorrow for the quota to reset\n" +
-                        "3. Upgrade to Google AI Pro/Ultra for 5x higher limits\n\n" +
+                        '2. Wait until tomorrow for the quota to reset\n' +
+                        '3. Upgrade to Google AI Pro/Ultra for 5x higher limits\n\n' +
                         `Original error: ${errorMessage}`,
                 };
             }
@@ -945,7 +945,7 @@ export class ToolHandlers {
                 return {
                     success: true,
                     data: {
-                        status: "success",
+                        status: 'success',
                         message: `Session ${session_id} closed successfully`,
                         session_id,
                     },
@@ -989,7 +989,7 @@ export class ToolHandlers {
             return {
                 success: true,
                 data: {
-                    status: "success",
+                    status: 'success',
                     message: `Session ${session_id} reset successfully`,
                     session_id,
                 },
@@ -1016,9 +1016,9 @@ export class ToolHandlers {
             // Get session stats
             const stats = this.sessionManager.getStats();
             const result = {
-                status: "ok",
+                status: 'ok',
                 authenticated,
-                notebook_url: CONFIG.notebookUrl || "not configured",
+                notebook_url: CONFIG.notebookUrl || 'not configured',
                 active_sessions: stats.active_sessions,
                 max_sessions: stats.max_sessions,
                 session_timeout: stats.session_timeout,
@@ -1027,9 +1027,9 @@ export class ToolHandlers {
                 auto_login_enabled: CONFIG.autoLoginEnabled,
                 stealth_enabled: CONFIG.stealthEnabled,
                 // Add troubleshooting tip if not authenticated
-                ...((!authenticated) && {
-                    troubleshooting_tip: "For fresh start with clean browser session: Close all Chrome instances → " +
-                        "cleanup_data(confirm=true, preserve_library=true) → setup_auth"
+                ...(!authenticated && {
+                    troubleshooting_tip: 'For fresh start with clean browser session: Close all Chrome instances → ' +
+                        'cleanup_data(confirm=true, preserve_library=true) → setup_auth',
                 }),
             };
             log.success(`✅ [TOOL] get_health completed`);
@@ -1056,7 +1056,7 @@ export class ToolHandlers {
     async handleSetupAuth(args, sendProgress) {
         const { show_browser, browser_options } = args;
         // CRITICAL: Send immediate progress to reset timeout from the very start
-        await sendProgress?.("Initializing authentication setup...", 0, 10);
+        await sendProgress?.('Initializing authentication setup...', 0, 10);
         log.info(`🔧 [TOOL] setup_auth called`);
         if (show_browser !== undefined) {
             log.info(`  Show browser: ${show_browser}`);
@@ -1068,22 +1068,22 @@ export class ToolHandlers {
         Object.assign(CONFIG, effectiveConfig);
         try {
             // Progress: Starting
-            await sendProgress?.("Preparing authentication browser...", 1, 10);
+            await sendProgress?.('Preparing authentication browser...', 1, 10);
             log.info(`  🌐 Opening browser for interactive login...`);
             // Progress: Opening browser
-            await sendProgress?.("Opening browser window...", 2, 10);
+            await sendProgress?.('Opening browser window...', 2, 10);
             // Perform setup with progress updates (uses CONFIG internally)
             const success = await this.authManager.performSetup(sendProgress);
             const durationSeconds = (Date.now() - startTime) / 1000;
             if (success) {
                 // Progress: Complete
-                await sendProgress?.("Authentication saved successfully!", 10, 10);
+                await sendProgress?.('Authentication saved successfully!', 10, 10);
                 log.success(`✅ [TOOL] setup_auth completed (${durationSeconds.toFixed(1)}s)`);
                 return {
                     success: true,
                     data: {
-                        status: "authenticated",
-                        message: "Successfully authenticated and saved browser state",
+                        status: 'authenticated',
+                        message: 'Successfully authenticated and saved browser state',
                         authenticated: true,
                         duration_seconds: durationSeconds,
                     },
@@ -1093,7 +1093,7 @@ export class ToolHandlers {
                 log.error(`❌ [TOOL] setup_auth failed (${durationSeconds.toFixed(1)}s)`);
                 return {
                     success: false,
-                    error: "Authentication failed or was cancelled",
+                    error: 'Authentication failed or was cancelled',
                 };
             }
         }
@@ -1127,19 +1127,19 @@ export class ToolHandlers {
         log.info(`🔧 [TOOL] de_auth called`);
         try {
             // 1. Close all active sessions
-            log.info("  🛑 Closing all sessions...");
+            log.info('  🛑 Closing all sessions...');
             await this.sessionManager.closeAllSessions();
-            log.success("  ✅ All sessions closed");
+            log.success('  ✅ All sessions closed');
             // 2. Clear all auth data
-            log.info("  🗑️  Clearing all authentication data...");
+            log.info('  🗑️  Clearing all authentication data...');
             await this.authManager.clearAllAuthData();
-            log.success("  ✅ Authentication data cleared");
+            log.success('  ✅ Authentication data cleared');
             log.success(`✅ [TOOL] de_auth completed - Successfully logged out`);
             return {
                 success: true,
                 data: {
-                    status: "de-authenticated",
-                    message: "Successfully logged out. Use setup_auth or re_auth to authenticate again.",
+                    status: 'de-authenticated',
+                    message: 'Successfully logged out. Use setup_auth or re_auth to authenticate again.',
                     authenticated: false,
                 },
             };
@@ -1164,7 +1164,7 @@ export class ToolHandlers {
      */
     async handleReAuth(args, sendProgress) {
         const { show_browser, browser_options } = args;
-        await sendProgress?.("Preparing re-authentication...", 0, 12);
+        await sendProgress?.('Preparing re-authentication...', 0, 12);
         log.info(`🔧 [TOOL] re_auth called`);
         if (show_browser !== undefined) {
             log.info(`  Show browser: ${show_browser}`);
@@ -1176,26 +1176,26 @@ export class ToolHandlers {
         Object.assign(CONFIG, effectiveConfig);
         try {
             // 1. De-authenticate first (logout)
-            await sendProgress?.("De-authenticating...", 1, 12);
-            log.info("  🔓 De-authenticating (logout)...");
+            await sendProgress?.('De-authenticating...', 1, 12);
+            log.info('  🔓 De-authenticating (logout)...');
             const deAuthResult = await this.handleDeAuth();
             if (!deAuthResult.success) {
                 throw new Error(`De-authentication failed: ${deAuthResult.error}`);
             }
-            log.success("  ✅ De-authentication complete");
+            log.success('  ✅ De-authentication complete');
             // 2. Perform fresh setup
-            await sendProgress?.("Starting fresh authentication...", 3, 12);
-            log.info("  🌐 Starting fresh authentication setup...");
+            await sendProgress?.('Starting fresh authentication...', 3, 12);
+            log.info('  🌐 Starting fresh authentication setup...');
             const success = await this.authManager.performSetup(sendProgress);
             const durationSeconds = (Date.now() - startTime) / 1000;
             if (success) {
-                await sendProgress?.("Re-authentication complete!", 12, 12);
+                await sendProgress?.('Re-authentication complete!', 12, 12);
                 log.success(`✅ [TOOL] re_auth completed (${durationSeconds.toFixed(1)}s)`);
                 return {
                     success: true,
                     data: {
-                        status: "authenticated",
-                        message: "Successfully re-authenticated with new account. All previous sessions have been closed.",
+                        status: 'authenticated',
+                        message: 'Successfully re-authenticated with new account. All previous sessions have been closed.',
                         authenticated: true,
                         duration_seconds: durationSeconds,
                     },
@@ -1205,7 +1205,7 @@ export class ToolHandlers {
                 log.error(`❌ [TOOL] re_auth failed (${durationSeconds.toFixed(1)}s)`);
                 return {
                     success: false,
-                    error: "Re-authentication failed or was cancelled",
+                    error: 'Re-authentication failed or was cancelled',
                 };
             }
         }
@@ -1244,7 +1244,7 @@ export class ToolHandlers {
                 topics: metadata.tags, // tags → topics
                 content_types: ['documentation'],
                 use_cases: metadata.tags.slice(0, 3), // Use first 3 tags as use cases
-                auto_generated: true
+                auto_generated: true,
             };
             // Add notebook to library
             const notebook = await this.library.addNotebook(notebookInput);
@@ -1492,7 +1492,7 @@ export class ToolHandlers {
         const cleanupManager = new CleanupManager();
         try {
             // Always run in deep mode
-            const mode = "deep";
+            const mode = 'deep';
             if (!confirm) {
                 // Preview mode - show what would be deleted
                 log.info(`  📋 Generating cleanup preview (mode: ${mode})...`);
@@ -1503,7 +1503,7 @@ export class ToolHandlers {
                 return {
                     success: true,
                     data: {
-                        status: "preview",
+                        status: 'preview',
                         mode,
                         preview: {
                             categories: preview.categories,
@@ -1519,36 +1519,23 @@ export class ToolHandlers {
                 const result = await cleanupManager.performCleanup(mode, preserve_library);
                 if (result.success) {
                     log.success(`✅ [TOOL] cleanup_data completed - deleted ${result.deletedPaths.length} items`);
-                    return {
-                        success: true,
-                        data: {
-                            status: "completed",
-                            mode,
-                            result: {
-                                deletedPaths: result.deletedPaths,
-                                failedPaths: result.failedPaths,
-                                totalSizeBytes: result.totalSizeBytes,
-                                categorySummary: result.categorySummary,
-                            },
-                        },
-                    };
                 }
                 else {
                     log.warning(`⚠️  [TOOL] cleanup_data completed with ${result.failedPaths.length} errors`);
-                    return {
-                        success: true,
-                        data: {
-                            status: "partial",
-                            mode,
-                            result: {
-                                deletedPaths: result.deletedPaths,
-                                failedPaths: result.failedPaths,
-                                totalSizeBytes: result.totalSizeBytes,
-                                categorySummary: result.categorySummary,
-                            },
-                        },
-                    };
                 }
+                return {
+                    success: result.success,
+                    data: {
+                        status: result.success ? 'completed' : 'partial',
+                        mode,
+                        result: {
+                            deletedPaths: result.deletedPaths,
+                            failedPaths: result.failedPaths,
+                            totalSizeBytes: result.totalSizeBytes,
+                            categorySummary: result.categorySummary,
+                        },
+                    },
+                };
             }
         }
         catch (error) {