notelm-mcp 1.2.1

package/dist/src/utils/settings-manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Settings Manager
+ *
+ * Handles persistent configuration for the NotebookLM MCP Server.
+ * Manages profiles, disabled tools, and environment variable overrides.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export type ProfileName = "minimal" | "standard" | "full";
+export interface Settings {
+    profile: ProfileName;
+    disabledTools: string[];
+    customSettings?: Record<string, any>;
+}
+export declare class SettingsManager {
+    private settingsPath;
+    private settings;
+    constructor();
+    /**
+     * Load settings from file, falling back to defaults
+     */
+    private loadSettings;
+    /**
+     * Save current settings to file
+     */
+    saveSettings(newSettings: Partial<Settings>): Promise<void>;
+    /**
+     * Get effective configuration (merging File settings with Env Vars)
+     */
+    getEffectiveSettings(): Settings;
+    /**
+     * Filter tools based on effective configuration
+     */
+    filterTools(allTools: Tool[]): Tool[];
+    getSettingsPath(): string;
+    getProfiles(): Record<ProfileName, string[]>;
+}
+//# sourceMappingURL=settings-manager.d.ts.map

package/dist/src/utils/settings-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/settings-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AA8BD,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAW;;IAQ3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE;;OAEG;IACH,oBAAoB,IAAI,QAAQ;IAmBhC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE;IAmBrC,eAAe,IAAI,MAAM;IAIzB,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAG7C"}

package/dist/src/utils/settings-manager.js

@@ -0,0 +1,121 @@
+/**
+ * Settings Manager
+ *
+ * Handles persistent configuration for the NotebookLM MCP Server.
+ * Manages profiles, disabled tools, and environment variable overrides.
+ */
+import fs from "fs/promises";
+import { existsSync, mkdirSync, readFileSync } from "fs";
+import path from "path";
+import { CONFIG } from "../config.js";
+import { log } from "./logger.js";
+const DEFAULT_SETTINGS = {
+    profile: "full",
+    disabledTools: [],
+};
+const PROFILES = {
+    minimal: [
+        "ask_question",
+        "get_health",
+        "list_notebooks",
+        "select_notebook",
+        "get_notebook" // Added as it is read-only and useful
+    ],
+    standard: [
+        "ask_question",
+        "get_health",
+        "list_notebooks",
+        "select_notebook",
+        "get_notebook",
+        "setup_auth",
+        "list_sessions",
+        "add_notebook",
+        "update_notebook",
+        "search_notebooks"
+    ],
+    full: ["*"] // All tools
+};
+export class SettingsManager {
+    settingsPath;
+    settings;
+    constructor() {
+        // Use the config directory from env-paths defined in config.ts
+        this.settingsPath = path.join(CONFIG.configDir, "settings.json");
+        this.settings = this.loadSettings();
+    }
+    /**
+     * Load settings from file, falling back to defaults
+     */
+    loadSettings() {
+        try {
+            // Ensure config dir exists
+            if (!existsSync(CONFIG.configDir)) {
+                mkdirSync(CONFIG.configDir, { recursive: true });
+            }
+            if (existsSync(this.settingsPath)) {
+                // Use the already imported readFileSync for synchronous file reading
+                const data = readFileSync(this.settingsPath, "utf-8");
+                return { ...DEFAULT_SETTINGS, ...JSON.parse(data) };
+            }
+        }
+        catch (error) {
+            log.warning(`⚠️  Failed to load settings: ${error}. Using defaults.`);
+        }
+        return { ...DEFAULT_SETTINGS };
+    }
+    /**
+     * Save current settings to file
+     */
+    async saveSettings(newSettings) {
+        this.settings = { ...this.settings, ...newSettings };
+        try {
+            await fs.writeFile(this.settingsPath, JSON.stringify(this.settings, null, 2), "utf-8");
+        }
+        catch (error) {
+            throw new Error(`Failed to save settings: ${error}`);
+        }
+    }
+    /**
+     * Get effective configuration (merging File settings with Env Vars)
+     */
+    getEffectiveSettings() {
+        const envProfile = process.env.NOTEBOOKLM_PROFILE;
+        const envDisabled = process.env.NOTEBOOKLM_DISABLED_TOOLS;
+        const effectiveProfile = (envProfile && PROFILES[envProfile]) ? envProfile : this.settings.profile;
+        let effectiveDisabled = [...this.settings.disabledTools];
+        if (envDisabled) {
+            const envDisabledList = envDisabled.split(",").map(t => t.trim());
+            effectiveDisabled = [...new Set([...effectiveDisabled, ...envDisabledList])];
+        }
+        return {
+            profile: effectiveProfile,
+            disabledTools: effectiveDisabled,
+            customSettings: this.settings.customSettings
+        };
+    }
+    /**
+     * Filter tools based on effective configuration
+     */
+    filterTools(allTools) {
+        const { profile, disabledTools } = this.getEffectiveSettings();
+        const allowedTools = PROFILES[profile];
+        return allTools.filter(tool => {
+            // 1. Check if allowed by profile (unless profile is full/wildcard)
+            if (!allowedTools.includes("*") && !allowedTools.includes(tool.name)) {
+                return false;
+            }
+            // 2. Check if explicitly disabled
+            if (disabledTools.includes(tool.name)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    getSettingsPath() {
+        return this.settingsPath;
+    }
+    getProfiles() {
+        return PROFILES;
+    }
+}
+//# sourceMappingURL=settings-manager.js.map

package/dist/src/utils/settings-manager.js.map

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

package/dist/src/utils/stealth-utils.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Stealth utilities for human-like browser behavior
+ *
+ * This module provides functions to simulate realistic human interactions:
+ * - Human-like typing (speed configurable via CONFIG.typingWpmMin/Max)
+ * - Realistic mouse movements (Bezier curves with jitter)
+ * - Random delays (normal distribution)
+ * - Smooth scrolling
+ * - Reading pauses
+ *
+ * Based on the Python implementation from stealth_utils.py
+ */
+import type { Page } from "patchright";
+/**
+ * Sleep for specified milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Generate random integer between min and max (inclusive)
+ */
+export declare function randomInt(min: number, max: number): number;
+/**
+ * Generate random float between min and max
+ */
+export declare function randomFloat(min: number, max: number): number;
+/**
+ * Generate random character (for typos)
+ */
+export declare function randomChar(): string;
+/**
+ * Generate Gaussian (normal) distributed random number
+ * Uses Box-Muller transform
+ */
+export declare function gaussian(mean: number, stdDev: number): number;
+/**
+ * Add a random delay to simulate human thinking/reaction time
+ * Uses normal distribution for more realistic delays
+ *
+ * @param minMs Minimum delay in milliseconds (default: from CONFIG)
+ * @param maxMs Maximum delay in milliseconds (default: from CONFIG)
+ */
+export declare function randomDelay(minMs?: number, maxMs?: number): Promise<void>;
+/**
+ * Type text in a human-like manner with variable speed and optional typos
+ *
+ * Simulates realistic typing patterns:
+ * - Variable speed (45-65 WPM by default)
+ * - Occasional typos (2% chance)
+ * - Longer pauses after punctuation
+ * - Realistic character delays
+ *
+ * @param page Playwright page instance
+ * @param selector CSS selector of input element
+ * @param text Text to type
+ * @param options Typing options (wpm, withTypos)
+ */
+export declare function humanType(page: Page, selector: string, text: string, options?: {
+    wpm?: number;
+    withTypos?: boolean;
+}): Promise<void>;
+/**
+ * Move mouse in a realistic curved path to target coordinates
+ * Uses Bezier-like curves with jitter for natural movement
+ *
+ * @param page Playwright page instance
+ * @param targetX Target X coordinate (default: random)
+ * @param targetY Target Y coordinate (default: random)
+ * @param steps Number of steps in movement (default: random 10-25)
+ */
+export declare function randomMouseMovement(page: Page, targetX?: number, targetY?: number, steps?: number): Promise<void>;
+/**
+ * Click an element with realistic human behavior
+ * Includes mouse movement, pause, and click
+ *
+ * @param page Playwright page instance
+ * @param selector CSS selector of element to click
+ * @param withMouseMovement Whether to move mouse first (default: true)
+ */
+export declare function realisticClick(page: Page, selector: string, withMouseMovement?: boolean): Promise<void>;
+/**
+ * Scroll the page smoothly like a human
+ * Uses multiple small steps for smooth animation
+ *
+ * @param page Playwright page instance
+ * @param amount Scroll amount in pixels (default: random 100-400)
+ * @param direction Scroll direction ("down" or "up")
+ */
+export declare function smoothScroll(page: Page, amount?: number, direction?: "up" | "down"): Promise<void>;
+/**
+ * Pause as if reading text, based on length
+ * Calculates realistic reading time based on text length and WPM
+ *
+ * @param textLength Number of characters to "read"
+ * @param wpm Reading speed in words per minute (default: random 200-250)
+ */
+export declare function readingPause(textLength: number, wpm?: number): Promise<void>;
+/**
+ * Add small random mouse movements to simulate natural fidgeting
+ *
+ * @param page Playwright page instance
+ * @param iterations Number of small movements (default: 3)
+ */
+export declare function randomMouseJitter(page: Page, iterations?: number): Promise<void>;
+/**
+ * Hover over an element with realistic mouse movement
+ *
+ * @param page Playwright page instance
+ * @param selector CSS selector of element to hover
+ */
+export declare function hoverElement(page: Page, selector: string): Promise<void>;
+/**
+ * Simulate reading a page with scrolling and pauses
+ * Adds realistic behavior of scrolling and reading content
+ *
+ * @param page Playwright page instance
+ */
+export declare function simulateReadingPage(page: Page): Promise<void>;
+declare const _default: {
+    sleep: typeof sleep;
+    randomInt: typeof randomInt;
+    randomFloat: typeof randomFloat;
+    randomChar: typeof randomChar;
+    gaussian: typeof gaussian;
+    randomDelay: typeof randomDelay;
+    humanType: typeof humanType;
+    randomMouseMovement: typeof randomMouseMovement;
+    realisticClick: typeof realisticClick;
+    smoothScroll: typeof smoothScroll;
+    readingPause: typeof readingPause;
+    randomMouseJitter: typeof randomMouseJitter;
+    hoverElement: typeof hoverElement;
+    simulateReadingPage: typeof simulateReadingPage;
+};
+export default _default;
+//# sourceMappingURL=stealth-utils.d.ts.map

package/dist/src/utils/stealth-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/stealth-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC;;GAEG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7D;AAMD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAsBf;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,OAAO,CAAC,IAAI,CAAC,CAwEf;AAMD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAuCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,iBAAiB,GAAE,OAAc,GAChC,OAAO,CAAC,IAAI,CAAC,CAgCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,GAAE,IAAI,GAAG,MAAe,GAChC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlF;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAaf;AAMD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9E;AAMD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnE;;;;;;;;;;;;;;;;;AAMD,wBAeE"}