notebooklm-mcp-ultimate 2.2.1

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

@@ -0,0 +1,224 @@
+/**
+ * Source Management Tool Definitions
+ *
+ * MCP tool definitions for managing sources in NotebookLM notebooks.
+ */
+/**
+ * List Sources tool
+ */
+export const listSourcesTool = {
+    name: 'list_sources',
+    description: `List all sources in a NotebookLM notebook.
+
+Returns information about each source including:
+- Source ID
+- Title
+- Type (URL, text, YouTube, Google Drive, etc.)
+- Creation date
+- Status
+
+Use this to see what sources are available in a notebook before performing other operations.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to list sources from. If not provided, uses the active notebook.',
+            },
+        },
+    },
+};
+/**
+ * Add URL Source tool
+ */
+export const addURLSourceTool = {
+    name: 'add_url_source',
+    description: `Add a URL as a source to a NotebookLM notebook.
+
+The URL will be fetched and its content will be added to the notebook.
+Supported URL types:
+- Web pages (HTML)
+- PDF documents
+- Text files
+- Other publicly accessible content
+
+The source will be processed and indexed for Q&A and content generation.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to add the source to. If not provided, uses the active notebook.',
+            },
+            url: {
+                type: 'string',
+                description: 'The URL to add as a source. Must be a valid, publicly accessible URL.',
+            },
+        },
+        required: ['url'],
+    },
+};
+/**
+ * Add Text Source tool
+ */
+export const addTextSourceTool = {
+    name: 'add_text_source',
+    description: `Add text content as a source to a NotebookLM notebook.
+
+Use this to add:
+- Pasted text
+- Notes
+- Transcripts
+- Any custom text content
+
+The text will be indexed and available for Q&A and content generation.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to add the source to. If not provided, uses the active notebook.',
+            },
+            title: {
+                type: 'string',
+                description: 'Title for the text source (e.g., "Meeting Notes", "Research Summary").',
+            },
+            content: {
+                type: 'string',
+                description: 'The text content to add as a source.',
+            },
+        },
+        required: ['title', 'content'],
+    },
+};
+/**
+ * Add YouTube Source tool
+ */
+export const addYouTubeSourceTool = {
+    name: 'add_youtube_source',
+    description: `Add a YouTube video as a source to a NotebookLM notebook.
+
+The video's transcript will be extracted and added to the notebook.
+This allows you to:
+- Ask questions about video content
+- Generate summaries of videos
+- Create study materials from educational videos
+
+Note: The video must have captions/subtitles available.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to add the source to. If not provided, uses the active notebook.',
+            },
+            youtube_url: {
+                type: 'string',
+                description: 'YouTube video URL (e.g., https://www.youtube.com/watch?v=... or https://youtu.be/...).',
+            },
+        },
+        required: ['youtube_url'],
+    },
+};
+/**
+ * Add Google Drive Source tool
+ */
+export const addDriveSourceTool = {
+    name: 'add_drive_source',
+    description: `Add a Google Drive file as a source to a NotebookLM notebook.
+
+Supported file types:
+- Google Docs
+- Google Slides
+- Google Sheets
+- PDF files
+- Other supported formats
+
+The file must be accessible to the authenticated Google account.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook to add the source to. If not provided, uses the active notebook.',
+            },
+            file_id: {
+                type: 'string',
+                description: 'Google Drive file ID (found in the file URL: https://drive.google.com/file/d/FILE_ID/...).',
+            },
+        },
+        required: ['file_id'],
+    },
+};
+/**
+ * Delete Source tool
+ */
+export const deleteSourceTool = {
+    name: 'delete_source',
+    description: `Delete a source from a NotebookLM notebook.
+
+This permanently removes the source and its content from the notebook.
+The source will no longer be available for:
+- Q&A
+- Content generation
+- Audio overviews
+
+Use list_sources first to get the source ID.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook containing the source. If not provided, uses the active notebook.',
+            },
+            source_id: {
+                type: 'string',
+                description: 'ID of the source to delete (obtained from list_sources).',
+            },
+        },
+        required: ['source_id'],
+    },
+};
+/**
+ * Summarize Source tool
+ */
+export const summarizeSourceTool = {
+    name: 'summarize_source',
+    description: `Get summary and metadata for a specific source in a notebook.
+
+Returns:
+- Source title
+- Source type
+- Creation date
+- Status
+- Basic metadata
+
+For detailed content summaries, use the content generation tools (generate_briefing, etc.).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'ID of the notebook containing the source. If not provided, uses the active notebook.',
+            },
+            source_id: {
+                type: 'string',
+                description: 'ID of the source to summarize (obtained from list_sources).',
+            },
+        },
+        required: ['source_id'],
+    },
+};
+/**
+ * All source management tools
+ */
+export const sourceManagementTools = [
+    listSourcesTool,
+    addURLSourceTool,
+    addTextSourceTool,
+    addYouTubeSourceTool,
+    addDriveSourceTool,
+    deleteSourceTool,
+    summarizeSourceTool,
+];
+//# sourceMappingURL=source-management.js.map

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

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

package/dist/tools/definitions/studio.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Audio Studio Tool Definitions
+ *
+ * Defines MCP tools for managing audio overviews (podcast-style summaries)
+ * generated by NotebookLM's Audio Overview feature.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Get Audio Status tool
+ */
+export declare const getAudioStatusTool: Tool;
+/**
+ * Create Audio tool
+ */
+export declare const createAudioTool: Tool;
+/**
+ * Update Audio tool
+ */
+export declare const updateAudioTool: Tool;
+/**
+ * Delete Audio tool
+ */
+export declare const deleteAudioTool: Tool;
+/**
+ * Download Audio tool
+ */
+export declare const downloadAudioTool: Tool;
+/**
+ * All audio studio tools
+ */
+export declare const studioTools: Tool[];
+/**
+ * Studio tool names for filtering
+ */
+export declare const studioToolNames: string[];
+//# sourceMappingURL=studio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/studio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAiBhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IA2C7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IAkC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IAiB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAkB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,IAAI,EAM7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,UAAiC,CAAC"}

package/dist/tools/definitions/studio.js

@@ -0,0 +1,153 @@
+/**
+ * Audio Studio Tool Definitions
+ *
+ * Defines MCP tools for managing audio overviews (podcast-style summaries)
+ * generated by NotebookLM's Audio Overview feature.
+ */
+/**
+ * Get Audio Status tool
+ */
+export const getAudioStatusTool = {
+    name: 'get_audio_status',
+    title: 'Get Audio Status',
+    description: 'Check the status of the audio overview for a notebook. ' +
+        'Returns whether audio exists, is generating, or is ready to play.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'The notebook ID to check audio status for. If not provided, uses the currently selected notebook.',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Create Audio tool
+ */
+export const createAudioTool = {
+    name: 'create_audio',
+    title: 'Create Audio Overview',
+    description: 'Generate a new audio overview (podcast-style summary) for a notebook. ' +
+        'The audio is created by two AI hosts discussing the content. ' +
+        'Generation takes a few minutes. Use get_audio_status to check progress.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'The notebook ID to create audio for. If not provided, uses the currently selected notebook.',
+            },
+            custom_instructions: {
+                type: 'string',
+                description: 'Optional custom instructions for the audio generation. ' +
+                    'Example: "Focus on the main arguments" or "Explain concepts for beginners".',
+            },
+            focus_topics: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional list of topics to focus on in the audio.',
+            },
+            target_audience: {
+                type: 'string',
+                enum: ['general', 'expert', 'student'],
+                description: 'Target audience for the audio. Affects tone and complexity. ' +
+                    'Default is "general".',
+            },
+            wait_for_completion: {
+                type: 'boolean',
+                description: 'If true, wait for audio generation to complete before returning. ' +
+                    'Default is false (returns immediately after starting generation).',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Update Audio tool
+ */
+export const updateAudioTool = {
+    name: 'update_audio',
+    title: 'Update Audio Overview',
+    description: 'Re-generate the audio overview with new instructions. ' +
+        'This deletes the existing audio and creates a new one.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'The notebook ID to update audio for. If not provided, uses the currently selected notebook.',
+            },
+            custom_instructions: {
+                type: 'string',
+                description: 'New custom instructions for the audio generation.',
+            },
+            focus_topics: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'New list of topics to focus on.',
+            },
+            target_audience: {
+                type: 'string',
+                enum: ['general', 'expert', 'student'],
+                description: 'New target audience for the audio.',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Delete Audio tool
+ */
+export const deleteAudioTool = {
+    name: 'delete_audio',
+    title: 'Delete Audio Overview',
+    description: 'Delete the audio overview for a notebook. ' +
+        'This permanently removes the generated audio.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'The notebook ID to delete audio for. If not provided, uses the currently selected notebook.',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Download Audio tool
+ */
+export const downloadAudioTool = {
+    name: 'download_audio',
+    title: 'Get Audio Download URL',
+    description: 'Get the download URL for the audio overview. ' +
+        'Returns a URL that can be used to download or play the audio file. ' +
+        'The URL is temporary and may expire.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            notebook_id: {
+                type: 'string',
+                description: 'The notebook ID to get audio URL for. If not provided, uses the currently selected notebook.',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * All audio studio tools
+ */
+export const studioTools = [
+    getAudioStatusTool,
+    createAudioTool,
+    updateAudioTool,
+    deleteAudioTool,
+    downloadAudioTool,
+];
+/**
+ * Studio tool names for filtering
+ */
+export const studioToolNames = studioTools.map((t) => t.name);
+//# sourceMappingURL=studio.js.map

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

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

package/dist/tools/definitions/system.d.ts

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

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

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

package/dist/tools/definitions/system.js

@@ -0,0 +1,143 @@
+export const systemTools = [
+    {
+        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",
+            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. " +
+            "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. " +
+            "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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                show_browser: {
+                    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.",
+                    properties: {
+                        show: {
+                            type: "boolean",
+                            description: "Show browser window (default: true for setup)",
+                        },
+                        headless: {
+                            type: "boolean",
+                            description: "Run browser in headless mode (default: false for setup)",
+                        },
+                        timeout_ms: {
+                            type: "number",
+                            description: "Browser operation timeout in milliseconds (default: 30000)",
+                        },
+                    },
+                },
+            },
+        },
+    },
+    {
+        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.",
+        inputSchema: {
+            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.",
+                },
+                browser_options: {
+                    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)",
+                        },
+                        headless: {
+                            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)",
+                        },
+                    },
+                },
+            },
+        },
+    },
+    {
+        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",
+            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.",
+                },
+                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).",
+                    default: false,
+                },
+            },
+            required: ["confirm"],
+        },
+    },
+];
+//# sourceMappingURL=system.js.map

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

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

package/dist/tools/definitions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Aggregates tool definitions from sub-modules.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { NotebookLibrary } from "../library/notebook-library.js";
+/**
+ * Build Tool Definitions with NotebookLibrary context
+ */
+export declare function buildToolDefinitions(library: NotebookLibrary): Tool[];
+//# sourceMappingURL=definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAcjE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,CAkBrE"}

package/dist/tools/definitions.js

@@ -0,0 +1,36 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Aggregates tool definitions from sub-modules.
+ */
+import { askQuestionTool, buildAskQuestionDescription, } from "./definitions/ask-question.js";
+import { notebookManagementTools } from "./definitions/notebook-management.js";
+import { sessionManagementTools } from "./definitions/session-management.js";
+import { systemTools } from "./definitions/system.js";
+import { contentGenerationTools } from "./definitions/content-generation.js";
+import { studioTools } from "./definitions/studio.js";
+import { sourceManagementTools } from "./definitions/source-management.js";
+import { researchTools } from "./definitions/research.js";
+import { notebookCRUDTools } from "./definitions/notebook-crud.js";
+/**
+ * Build Tool Definitions with NotebookLibrary context
+ */
+export function buildToolDefinitions(library) {
+    // Update the description for ask_question based on the library state
+    const dynamicAskQuestionTool = {
+        ...askQuestionTool,
+        description: buildAskQuestionDescription(library),
+    };
+    return [
+        dynamicAskQuestionTool,
+        ...notebookManagementTools,
+        ...notebookCRUDTools,
+        ...sessionManagementTools,
+        ...systemTools,
+        ...contentGenerationTools,
+        ...studioTools,
+        ...sourceManagementTools,
+        ...researchTools,
+    ];
+}
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,qEAAqE;IACrE,MAAM,sBAAsB,GAAG;QAC7B,GAAG,eAAe;QAClB,WAAW,EAAE,2BAA2B,CAAC,OAAO,CAAC;KAClD,CAAC;IAEF,OAAO;QACL,sBAAsB;QACtB,GAAG,uBAAuB;QAC1B,GAAG,iBAAiB;QACpB,GAAG,sBAAsB;QACzB,GAAG,WAAW;QACd,GAAG,sBAAsB;QACzB,GAAG,WAAW;QACd,GAAG,qBAAqB;QACxB,GAAG,aAAa;KACjB,CAAC;AACJ,CAAC"}