notebooklm-mcp-ultimate 2.2.1

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

@@ -0,0 +1,156 @@
+/**
+ * Notebook CRUD Tool Definitions
+ *
+ * Tools for creating and managing notebooks directly in NotebookLM.
+ * These operations use the API directly (not browser automation).
+ */
+export const notebookCRUDTools = [
+    {
+        name: "add_file_source",
+        description: `Upload a local file as a source to a NotebookLM notebook.
+
+## Supported Formats
+PDF, documents (docx, txt), images, audio files
+
+## Parameters
+- notebook_id (required): UUID of the target notebook
+- file_path (required): Absolute path to the file on disk
+
+## Example
+User: "Add my research paper to the AI notebook"
+You: Get file path and notebook ID, then call add_file_source
+
+## Notes
+- Uses browser automation (slightly slower than API)
+- File must exist and be accessible
+- Large files may take longer to upload`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                notebook_id: {
+                    type: "string",
+                    description: "The notebook ID to add source to (UUID format)",
+                },
+                file_path: {
+                    type: "string",
+                    description: "Absolute path to the file to upload",
+                },
+            },
+            required: ["notebook_id", "file_path"],
+        },
+    },
+    {
+        name: "create_notebook_remote",
+        description: `Create a new notebook directly in NotebookLM.
+
+## What It Does
+Creates a new empty notebook in your NotebookLM account via the API.
+Returns the notebook ID and URL for immediate use.
+
+## When to Use
+- User wants to create a fresh notebook for a new topic
+- Starting a new research project
+- Need to organize sources into a new collection
+
+## Parameters
+- title (optional): Name for the notebook. Defaults to "Untitled notebook"
+
+## Example
+User: "Create a notebook for my Python learning"
+You: Call create_notebook_remote with title="Python Learning"
+
+## Notes
+- The created notebook will be empty (no sources)
+- Use add_url_source, add_text_source, etc. to add content
+- The notebook is created in the authenticated user's account`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Name for the new notebook (optional, defaults to 'Untitled notebook')",
+                },
+            },
+        },
+    },
+    {
+        name: "rename_notebook_remote",
+        description: `Rename a notebook directly in NotebookLM.
+
+## What It Does
+Changes the title of an existing notebook via the API.
+This updates the actual notebook in NotebookLM, not just local library metadata.
+
+## When to Use
+- User wants to rename an existing notebook
+- Correcting typos in notebook names
+- Updating notebook name to reflect new scope
+
+## Parameters
+- notebook_id (required): The notebook ID to rename
+- new_title (required): The new name for the notebook
+
+## Example
+User: "Rename my AI notebook to 'Machine Learning Fundamentals'"
+You: Get notebook ID from list_notebooks, then call rename_notebook_remote
+
+## Notes
+- This changes the name in NotebookLM, visible to all who have access
+- Different from update_notebook which only updates local library metadata`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                notebook_id: {
+                    type: "string",
+                    description: "The notebook ID to rename (UUID format)",
+                },
+                new_title: {
+                    type: "string",
+                    description: "The new title for the notebook",
+                },
+            },
+            required: ["notebook_id", "new_title"],
+        },
+    },
+    {
+        name: "delete_notebook_remote",
+        description: `DANGEROUS - Delete a notebook from NotebookLM permanently.
+
+## What It Does
+Permanently deletes a notebook and ALL its sources from NotebookLM.
+This action CANNOT be undone.
+
+## Confirmation Required
+ALWAYS confirm with the user before calling this tool:
+"Are you sure you want to PERMANENTLY DELETE '[notebook_name]' and all its sources? This cannot be undone."
+
+## When to Use
+- User explicitly asks to delete a notebook from NotebookLM
+- Cleaning up unused notebooks
+
+## Parameters
+- notebook_id (required): The notebook ID to delete
+
+## Example
+User: "Delete my old test notebook"
+You: "Are you sure you want to permanently delete 'Test Notebook' and all its X sources?"
+User: "Yes, delete it"
+You: Call delete_notebook_remote
+
+## Notes
+- Different from remove_notebook which only removes from local library
+- This deletes from NotebookLM servers permanently
+- All sources, notes, and generated content will be lost`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                notebook_id: {
+                    type: "string",
+                    description: "The notebook ID to delete (UUID format)",
+                },
+            },
+            required: ["notebook_id"],
+        },
+    },
+];
+//# sourceMappingURL=notebook-crud.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-crud.js","sourceRoot":"","sources":["../../../src/tools/definitions/notebook-crud.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAW;IACvC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT;;;;;;;;;;;;;;;;wCAgBkC;QACpC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;SACvC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT;;;;;;;;;;;;;;;;;;;;;8DAqBwD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uEAAuE;iBACrF;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT;;;;;;;;;;;;;;;;;;;;;2EAqBqE;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;SACvC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT;;;;;;;;;;;;;;;;;;;;;;;;;;yDA0BmD;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;CACF,CAAC"}

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/research.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Research Tool Definitions
+ *
+ * MCP tool definitions for research and source discovery.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Discover Sources tool
+ */
+export declare const discoverSourcesTool: Tool;
+/**
+ * Import Source tool
+ */
+export declare const importSourceTool: Tool;
+/**
+ * Research Topic tool
+ */
+export declare const researchTopicTool: Tool;
+/**
+ * All research tools
+ */
+export declare const researchTools: Tool[];
+//# sourceMappingURL=research.d.ts.map

package/dist/tools/definitions/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/research.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAyBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA2B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA8B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAAI,EAI/B,CAAC"}

package/dist/tools/definitions/research.js

@@ -0,0 +1,108 @@
+/**
+ * Research Tool Definitions
+ *
+ * MCP tool definitions for research and source discovery.
+ */
+/**
+ * Discover Sources tool
+ */
+export const discoverSourcesTool = {
+    name: 'discover_sources',
+    description: `Discover potential sources for a research topic.
+
+Returns:
+- Search query suggestions optimized for finding quality sources
+- Recommended source types (academic papers, documentation, etc.)
+- Tips for finding relevant content
+
+Use this to get ideas for sources to add to your notebook.
+After finding sources, use import_source to add them.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: {
+                type: 'string',
+                description: 'The research topic or subject to find sources for.',
+            },
+            notebook_id: {
+                type: 'string',
+                description: 'Optional notebook ID. If not provided, uses the active notebook.',
+            },
+        },
+        required: ['topic'],
+    },
+};
+/**
+ * Import Source tool
+ */
+export const importSourceTool = {
+    name: 'import_source',
+    description: `Import a source URL into a notebook.
+
+Validates the URL and adds it as a source to the notebook.
+Supported sources:
+- Web pages (Wikipedia, documentation sites, etc.)
+- YouTube videos
+- Google Drive files
+- Academic papers (arXiv, etc.)
+- GitHub repositories
+
+The source will be processed and indexed for Q&A and content generation.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL of the source to import.',
+            },
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to import into. If not provided, uses the active notebook.',
+            },
+        },
+        required: ['url'],
+    },
+};
+/**
+ * Research Topic tool
+ */
+export const researchTopicTool = {
+    name: 'research_topic',
+    description: `Research a topic and optionally auto-import sources.
+
+This is a workflow tool that:
+1. Generates search queries for the topic
+2. Suggests source types to look for
+3. Optionally auto-imports starter sources (Wikipedia, etc.)
+
+Use this as a starting point for building a research notebook.
+You can then manually add more specific sources using import_source.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: {
+                type: 'string',
+                description: 'The research topic or subject.',
+            },
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to research in. If not provided, uses the active notebook.',
+            },
+            auto_import: {
+                type: 'boolean',
+                description: 'If true, automatically imports starter sources (e.g., Wikipedia). Default: false.',
+                default: false,
+            },
+        },
+        required: ['topic'],
+    },
+};
+/**
+ * All research tools
+ */
+export const researchTools = [
+    discoverSourcesTool,
+    importSourceTool,
+    researchTopicTool,
+];
+//# sourceMappingURL=research.js.map

package/dist/tools/definitions/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/tools/definitions/research.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACrC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;sDAQqC;IAClD,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aACpE;YACD,WAAW,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAClF;SACJ;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAS;IAClC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;yEAUwD;IACrE,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,GAAG,EAAE;gBACD,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAClD;YACD,WAAW,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+EAA+E;aAC/F;SACJ;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KACpB;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACnC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;qEAQoD;IACjE,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAChD;YACD,WAAW,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+EAA+E;aAC/F;YACD,WAAW,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mFAAmF;gBAChG,OAAO,EAAE,KAAK;aACjB;SACJ;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACjC,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;CACpB,CAAC"}

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"}

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

@@ -0,0 +1,41 @@
+export const sessionManagementTools = [
+    {
+        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",
+            properties: {},
+        },
+    },
+    {
+        name: "close_session",
+        description: "Close a specific session by session ID. Ask before closing if the user might still need it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "The session ID to close",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
+    {
+        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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "The session ID to reset",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
+];
+//# sourceMappingURL=session-management.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-management.js","sourceRoot":"","sources":["../../../src/tools/definitions/session-management.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAW;IAC5C;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,2EAA2E;YAC3E,6EAA6E;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yDAAyD;YACzD,6EAA6E;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;CACF,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Source Management Tool Definitions
+ *
+ * MCP tool definitions for managing sources in NotebookLM notebooks.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * List Sources tool
+ */
+export declare const listSourcesTool: Tool;
+/**
+ * Add URL Source tool
+ */
+export declare const addURLSourceTool: Tool;
+/**
+ * Add Text Source tool
+ */
+export declare const addTextSourceTool: Tool;
+/**
+ * Add YouTube Source tool
+ */
+export declare const addYouTubeSourceTool: Tool;
+/**
+ * Add Google Drive Source tool
+ */
+export declare const addDriveSourceTool: Tool;
+/**
+ * Delete Source tool
+ */
+export declare const deleteSourceTool: Tool;
+/**
+ * Summarize Source tool
+ */
+export declare const summarizeSourceTool: Tool;
+/**
+ * All source management tools
+ */
+export declare const sourceManagementTools: Tool[];
+//# sourceMappingURL=source-management.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-management.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/source-management.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IAqB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA0B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA6B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,IAyBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,IA0BhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAyB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,IA0BjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAAI,EAQvC,CAAC"}