@roomi-fields/notebooklm-mcp 1.1.2

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
+Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,548 @@
+<div align="center">
+
+# NotebookLM MCP Server
+
+**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-2025-green.svg)](https://modelcontextprotocol.io/)
+[![npm](https://img.shields.io/npm/v/@roomi-fields/notebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp)
+[![GitHub](https://img.shields.io/github/stars/roomi-fields/notebooklm-mcp-http?style=social)](https://github.com/roomi-fields/notebooklm-mcp-http)
+
+[MCP Installation](#mcp-installation) • [HTTP REST API](#http-rest-api) • [Why NotebookLM](#why-notebooklm-not-local-rag) • [Examples](#real-world-example) • [Documentation](./deployment/docs/)
+
+</div>
+
+---
+
+## 🚀 Two Ways to Use This Server
+
+### 1️⃣ **HTTP REST API** (New! Recommended for n8n, Zapier, Make.com)
+
+Use NotebookLM from **any tool** via HTTP REST API:
+
+```bash
+# Install and start HTTP server
+npm install
+npm run build
+npm run start:http
+
+# Query NotebookLM via REST
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
+```
+
+**Perfect for:**
+- ✅ n8n workflows and automation
+- ✅ Zapier, Make.com integrations
+- ✅ Custom web applications
+- ✅ Backend APIs
+
+**👉 Full HTTP setup guide:** [deployment/docs/01-INSTALL.md](./deployment/docs/01-INSTALL.md)
+
+---
+
+### 2️⃣ **MCP stdio** (For Claude Code, Cursor, Codex)
+
+Use NotebookLM directly from your AI coding assistant:
+
+```bash
+# Claude Code
+claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+
+# Codex
+codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+
+# Cursor (add to ~/.cursor/mcp.json)
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+
+**Perfect for:**
+- ✅ Claude Code, Cursor, Codex
+- ✅ Any MCP-compatible AI assistant
+- ✅ Direct CLI integration
+
+---
+
+## The Problem
+
+When you tell Claude Code or Cursor to "search through my local documentation", here's what happens:
+- **Massive token consumption**: Searching through documentation means reading multiple files repeatedly
+- **Inaccurate retrieval**: Searches for keywords, misses context and connections between docs
+- **Hallucinations**: When it can't find something, it invents plausible-sounding APIs
+- **Expensive & slow**: Each question requires re-reading multiple files
+
+## The Solution
+
+Let your tools chat directly with [**NotebookLM**](https://notebooklm.google/) — Google's **zero-hallucination knowledge base** powered by Gemini 2.5 that provides intelligent, synthesized answers from your docs.
+
+```
+Your Task → Agent/n8n asks NotebookLM → Gemini synthesizes answer → Correct output
+```
+
+**The real advantage**: No more manual copy-paste. Your agent/workflow asks NotebookLM directly and gets answers back. Build deep understanding through automatic follow-ups.
+
+---
+
+## Why NotebookLM, Not Local RAG?
+
+| Approach | Token Cost | Setup Time | Hallucinations | Answer Quality |
+|----------|------------|------------|----------------|----------------|
+| **Feed docs to Claude** | 🔴 Very high (multiple file reads) | Instant | Yes - fills gaps | Variable retrieval |
+| **Web search** | 🟡 Medium | Instant | High - unreliable sources | Hit or miss |
+| **Local RAG** | 🟡 Medium-High | Hours (embeddings, chunking) | Medium - retrieval gaps | Depends on setup |
+| **NotebookLM MCP** | 🟢 Minimal | 5 minutes | **Zero** - refuses if unknown | Expert synthesis |
+
+### What Makes NotebookLM Superior?
+
+1. **Pre-processed by Gemini**: Upload docs once, get instant expert knowledge
+2. **Natural language Q&A**: Not just retrieval — actual understanding and synthesis
+3. **Multi-source correlation**: Connects information across 50+ documents
+4. **Citation-backed**: Every answer includes source references
+5. **No infrastructure**: No vector DBs, embeddings, or chunking strategies needed
+
+---
+
+## HTTP REST API
+
+### Quick Start
+
+```powershell
+# 1. Clone and install
+git clone <repo-url> D:\notebooklm-http
+cd D:\notebooklm-http
+npm install
+npm run build
+
+# 2. Configure authentication (one-time)
+npm run setup-auth
+# Chrome opens → log in with Google → close Chrome
+
+# 3. Add your first notebook
+npm run start:http
+# In another terminal:
+curl -X POST http://localhost:3000/notebooks \
+  -H "Content-Type: application/json" \
+  -d '{
+    "url": "https://notebooklm.google.com/notebook/YOUR-NOTEBOOK-ID",
+    "name": "My Knowledge Base",
+    "description": "My documentation",
+    "topics": ["docs", "api"]
+  }'
+
+# 4. Query NotebookLM
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X"}'
+
+# 5. Validate installation (optional)
+.\deployment\scripts\test-server.ps1
+```
+
+**👉 See [Testing Guide](./deployment/scripts/README.md) for automated test suite**
+
+### API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/health` | Check server health |
+| `POST` | `/ask` | Ask a question to NotebookLM |
+| `GET` | `/notebooks` | List all notebooks |
+| `POST` | `/notebooks` | Add notebook (with live validation) |
+| `DELETE` | `/notebooks/:id` | Remove a notebook |
+| `PUT` | `/notebooks/:id/activate` | Set active notebook |
+| `GET` | `/sessions` | List active sessions |
+| `DELETE` | `/sessions/:id` | Close a session |
+
+**👉 Full API documentation:** [deployment/docs/03-API.md](./deployment/docs/03-API.md)
+
+### n8n Integration
+
+Perfect for n8n workflows:
+
+```json
+{
+  "nodes": [
+    {
+      "name": "Ask NotebookLM",
+      "type": "n8n-nodes-base.httpRequest",
+      "parameters": {
+        "method": "POST",
+        "url": "http://your-server:3000/ask",
+        "jsonParameters": true,
+        "bodyParametersJson": {
+          "question": "{{ $json.query }}",
+          "notebook_id": "my-notebook"
+        }
+      }
+    }
+  ]
+}
+```
+
+**👉 n8n guide:** [deployment/docs/04-N8N-INTEGRATION.md](./deployment/docs/04-N8N-INTEGRATION.md)
+
+### Installation & Documentation
+
+- 📖 [**Installation Guide**](./deployment/docs/01-INSTALL.md) — Step-by-step setup
+- 🔧 [**Configuration**](./deployment/docs/02-CONFIGURATION.md) — Environment variables, security
+- 📡 [**API Reference**](./deployment/docs/03-API.md) — Complete endpoint documentation
+- 📚 [**Notebook Library**](./deployment/docs/06-NOTEBOOK-LIBRARY.md) — Multi-notebook management
+- ✅ [**Testing Suite**](./deployment/scripts/README.md) — Automated validation scripts
+- 🐛 [**Troubleshooting**](./deployment/docs/05-TROUBLESHOOTING.md) — Common issues
+
+---
+
+## MCP Installation
+
+<details>
+<summary>Claude Code</summary>
+
+```bash
+claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+```
+</details>
+
+<details>
+<summary>Codex</summary>
+
+```bash
+codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+```
+</details>
+
+<details>
+<summary>Gemini</summary>
+
+```bash
+gemini mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+```
+</details>
+
+<details>
+<summary>Cursor</summary>
+
+Add to `~/.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary>amp</summary>
+
+```bash
+amp mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+```
+</details>
+
+<details>
+<summary>VS Code</summary>
+
+```bash
+code --add-mcp '{"name":"notebooklm","command":"npx","args":["@roomi-fields/notebooklm-mcp@latest"]}'
+```
+</details>
+
+<details>
+<summary>Other MCP clients</summary>
+
+**Generic MCP config:**
+```json
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+</details>
+
+### MCP Quick Start
+
+1. **Install** the MCP server (see above)
+
+2. **Authenticate** (one-time)
+
+Say in your chat (Claude/Codex):
+```
+"Log me in to NotebookLM"
+```
+*A Chrome window opens → log in with Google*
+
+3. **Create your knowledge base**
+
+Go to [notebooklm.google.com](https://notebooklm.google.com) → Create notebook → Upload your docs:
+- 📄 PDFs, Google Docs, markdown files
+- 🔗 Websites, GitHub repos
+- 🎥 YouTube videos
+- 📚 Multiple sources per notebook
+
+Share: **⚙️ Share → Anyone with link → Copy**
+
+4. **Let Claude use it**
+
+```
+"I'm building with [library]. Here's my NotebookLM: [link]"
+```
+
+**That's it.** Claude now asks NotebookLM whatever it needs, building expertise before writing code.
+
+---
+
+## Alternative: Claude Code Skill
+
+**Prefer Claude Code Skills over MCP?** This server is now also available as a native Claude Code Skill with a simpler setup:
+
+**NotebookLM Claude Code Skill** - Available separately for advanced Claude Code workflows
+
+**Key differences:**
+- **MCP Server** (this repo): Persistent sessions, works with Claude Code, Codex, Cursor, and other MCP clients
+- **HTTP REST API** (this repo): Works with n8n, Zapier, Make.com, any HTTP client
+- **Claude Code Skill**: Simpler setup, Python-based, stateless queries, works only with local Claude Code
+
+All use the same browser automation technology and provide zero-hallucination answers from your NotebookLM notebooks.
+
+---
+
+## Real-World Example
+
+### Building an n8n Workflow Without Hallucinations
+
+**Challenge**: n8n's API is new — Claude hallucinates node names and functions.
+
+**Solution**:
+1. Downloaded complete n8n documentation → merged into manageable chunks
+2. Uploaded to NotebookLM
+3. Told Claude: *"Build me a Gmail spam filter workflow. Use this NotebookLM: [link]"*
+
+**Watch the AI-to-AI conversation:**
+
+```
+Claude → "How does Gmail integration work in n8n?"
+NotebookLM → "Use Gmail Trigger with polling, or Gmail node with Get Many..."
+
+Claude → "How to decode base64 email body?"
+NotebookLM → "Body is base64url encoded in payload.parts, use Function node..."
+
+Claude → "How to parse OpenAI response as JSON?"
+NotebookLM → "Set responseFormat to json, use {{ $json.spam }} in IF node..."
+
+Claude → "What about error handling if the API fails?"
+NotebookLM → "Use Error Trigger node with Continue On Fail enabled..."
+
+Claude → ✅ "Here's your complete workflow JSON..."
+```
+
+**Result**: Perfect workflow on first try. No debugging hallucinated APIs.
+
+---
+
+## Core Features
+
+### **Zero Hallucinations**
+NotebookLM refuses to answer if information isn't in your docs. No invented APIs.
+
+### **Multi-Notebook Library**
+Manage multiple NotebookLM notebooks with automatic validation, duplicate detection, and smart selection.
+
+### **Autonomous Research**
+Claude asks follow-up questions automatically, building complete understanding before coding.
+
+### **Deep, Iterative Research**
+- Claude automatically asks follow-up questions to build complete understanding
+- Each answer triggers deeper questions until Claude has all the details
+- Example: For n8n workflow, Claude asked multiple sequential questions about Gmail integration, error handling, and data transformation
+
+### **HTTP REST API**
+Use NotebookLM from n8n, Zapier, Make.com, or any HTTP client. No MCP required.
+
+### **Cross-Tool Sharing**
+Set up once, use everywhere. Claude Code, Codex, Cursor, n8n — all can access the same library.
+
+---
+
+## Architecture
+
+```mermaid
+graph LR
+    A[Your Task] --> B[Claude/n8n/HTTP Client]
+    B --> C[MCP/HTTP Server]
+    C --> D[Chrome Automation]
+    D --> E[NotebookLM]
+    E --> F[Gemini 2.5]
+    F --> G[Your Docs]
+    G --> F
+    F --> E
+    E --> D
+    D --> C
+    C --> B
+    B --> H[Accurate Output]
+```
+
+---
+
+## Common Commands (MCP Mode)
+
+| Intent | Say | Result |
+|--------|-----|--------|
+| Authenticate | *"Open NotebookLM auth setup"* or *"Log me in to NotebookLM"* | Chrome opens for login |
+| Add notebook | *"Add [link] to library"* | Saves notebook with metadata |
+| List notebooks | *"Show our notebooks"* | Lists all saved notebooks |
+| Research first | *"Research this in NotebookLM before coding"* | Multi-question session |
+| Select notebook | *"Use the React notebook"* | Sets active notebook |
+| Update notebook | *"Update notebook tags"* | Modify metadata |
+| Remove notebook | *"Remove [notebook] from library"* | Deletes from library |
+| View browser | *"Show me the browser"* | Watch live NotebookLM chat |
+| Fix auth | *"Repair NotebookLM authentication"* | Clears and re-authenticates |
+| Switch account | *"Re-authenticate with different Google account"* | Changes account |
+| Clean restart | *"Run NotebookLM cleanup"* | Removes all data for fresh start |
+
+---
+
+## Comparison to Alternatives
+
+### vs. Downloading docs locally
+- **You**: Download docs → Claude: "search through these files"
+- **Problem**: Claude reads thousands of files → massive token usage, often misses connections
+- **NotebookLM**: Pre-indexed by Gemini, semantic understanding across all docs
+
+### vs. Web search
+- **You**: "Research X online"
+- **Problem**: Outdated info, hallucinated examples, unreliable sources
+- **NotebookLM**: Only your trusted docs, always current, with citations
+
+### vs. Local RAG setup
+- **You**: Set up embeddings, vector DB, chunking strategy, retrieval pipeline
+- **Problem**: Hours of setup, tuning retrieval, still gets "creative" with gaps
+- **NotebookLM**: Upload docs → done. Google handles everything.
+
+---
+
+## FAQ
+
+**Is it really zero hallucinations?**
+Yes. NotebookLM is specifically designed to only answer from uploaded sources. If it doesn't know, it says so.
+
+**What about rate limits?**
+Free tier has daily query limits per Google account. Quick account switching supported for continued research.
+
+**How secure is this?**
+Chrome runs locally. Your credentials never leave your machine. Use a dedicated Google account if concerned.
+
+**Can I see what's happening?**
+Yes! Say *"Show me the browser"* (MCP mode) or set `HEADLESS=false` (HTTP mode) to watch the live NotebookLM conversation.
+
+**What makes this better than Claude's built-in knowledge?**
+Your docs are always current. No training cutoff. No hallucinations. Perfect for new libraries, internal APIs, or fast-moving projects.
+
+---
+
+## The Bottom Line
+
+**Without NotebookLM**: Write code → Find it's wrong → Debug hallucinated APIs → Repeat
+
+**With NotebookLM**: Research first → Write correct code → Ship faster
+
+Stop debugging hallucinations. Start shipping accurate code.
+
+---
+
+## Disclaimer
+
+This tool automates browser interactions with NotebookLM to make your workflow more efficient. However, a few friendly reminders:
+
+**About browser automation:**
+While I've built in humanization features (realistic typing speeds, natural delays, mouse movements) to make the automation behave more naturally, I can't guarantee Google won't detect or flag automated usage. I recommend using a dedicated Google account for automation rather than your primary account—think of it like web scraping: probably fine, but better safe than sorry!
+
+**About CLI tools and AI agents:**
+CLI tools like Claude Code, Codex, and similar AI-powered assistants are incredibly powerful, but they can make mistakes. Please use them with care and awareness:
+- Always review changes before committing or deploying
+- Test in safe environments first
+- Keep backups of important work
+- Remember: AI agents are assistants, not infallible oracles
+
+I built this tool for myself because I was tired of the copy-paste dance between NotebookLM and my editor. I'm sharing it in the hope it helps others too, but I can't take responsibility for any issues, data loss, or account problems that might occur. Use at your own discretion and judgment.
+
+That said, if you run into problems or have questions, feel free to open an issue on GitHub. I'm happy to help troubleshoot!
+
+---
+
+## Roadmap
+
+Future features planned for upcoming releases:
+
+### 🚀 Stateless Server Mode
+**Goal**: Run the HTTP server without keeping a terminal window open permanently.
+
+**Planned options:**
+- **PM2 integration** (Recommended): Cross-platform process manager with auto-restart, monitoring, and logs
+  - Simple setup: `pm2 start npm --name "notebooklm-http" -- run start:http`
+  - Automatic startup on system boot
+  - Built-in log rotation and monitoring
+- **Windows Service**: Native Windows service installation via `nssm` or `node-windows`
+- **Serverless-ready mode**: Lambda/cold-start compatible with lazy browser session initialization
+
+**Status**: Planned for v1.2.0
+
+### 🤖 Auto-fill Notebook Metadata
+**Goal**: Automatically generate notebook name, description, and keywords when adding a notebook.
+
+**How it works:**
+1. When adding a notebook with empty metadata, automatically ask NotebookLM:
+   - "If you had to name this notebook in one word, what would it be?"
+   - "Give me 10 relevant keywords for this content"
+   - "Describe this notebook in one sentence"
+2. Parse the response and auto-populate metadata fields
+3. Available as both automatic mode (on add) and manual command (`/notebooks/:id/auto-fill`)
+
+**Benefits:**
+- No more manual metadata entry
+- Consistent, AI-generated descriptions
+- Better notebook organization and searchability
+
+**Status**: Planned for v1.2.0 or v1.3.0
+
+### 💡 Have an idea?
+[Open a discussion](https://github.com/roomi-fields/notebooklm-mcp-http/discussions) to suggest new features!
+
+---
+
+## Contributing
+
+Found a bug? Have a feature idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp-http/issues) or submit a PR!
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
+
+## License
+
+MIT — Use freely in your projects.
+
+See [LICENSE](./LICENSE) for details.
+
+---
+
+<div align="center">
+
+Built with frustration about hallucinated APIs, powered by Google's NotebookLM
+
+⭐ [Star on GitHub](https://github.com/roomi-fields/notebooklm-mcp-http) if this saves you debugging time!
+
+</div>

package/dist/auth/auth-manager.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Authentication Manager for NotebookLM
+ *
+ * Handles:
+ * - Interactive login (headful browser for setup)
+ * - Auto-login with credentials (email/password from ENV)
+ * - Browser state persistence (cookies + localStorage + sessionStorage)
+ * - Cookie expiry validation
+ * - State expiry checks (24h file age)
+ * - Hard reset for clean start
+ *
+ * Based on the Python implementation from auth.py
+ */
+import type { BrowserContext, Page } from "patchright";
+import type { ProgressCallback } from "../types.js";
+export declare class AuthManager {
+    private stateFilePath;
+    private sessionFilePath;
+    constructor();
+    /**
+     * Save entire browser state (cookies + localStorage)
+     */
+    saveBrowserState(context: BrowserContext, page?: Page): Promise<boolean>;
+    /**
+     * Check if saved browser state exists
+     */
+    hasSavedState(): Promise<boolean>;
+    /**
+     * Get path to saved browser state
+     */
+    getStatePath(): string | null;
+    /**
+     * Get valid state path (checks expiry)
+     */
+    getValidStatePath(): Promise<string | null>;
+    /**
+     * Load sessionStorage from file
+     */
+    loadSessionStorage(): Promise<Record<string, string> | null>;
+    /**
+     * Validate if saved state is still valid
+     */
+    validateState(context: BrowserContext): Promise<boolean>;
+    /**
+     * Validate if critical authentication cookies are still valid
+     */
+    validateCookiesExpiry(context: BrowserContext): Promise<boolean>;
+    /**
+     * Check if the saved state file is too old (>24 hours)
+     */
+    isStateExpired(): Promise<boolean>;
+    /**
+     * Perform interactive login
+     * User will see a browser window and login manually
+     *
+     * SIMPLE & RELIABLE: Just wait for URL to change to notebooklm.google.com
+     */
+    performLogin(page: Page, sendProgress?: ProgressCallback): Promise<boolean>;
+    /**
+     * Attempt to authenticate using configured credentials
+     */
+    loginWithCredentials(context: BrowserContext, page: Page, email: string, password: string): Promise<boolean>;
+    /**
+     * Wait for Google to redirect to NotebookLM after successful login (SIMPLE & RELIABLE)
+     *
+     * Just checks if URL changes to notebooklm.google.com - no complex UI element searching!
+     * Matches the simplified approach used in performLogin().
+     */
+    private waitForRedirectAfterLogin;
+    /**
+     * Wait for NotebookLM to load (SIMPLE & RELIABLE)
+     *
+     * Just checks if URL starts with notebooklm.google.com - no complex UI element searching!
+     * Matches the simplified approach used in performLogin().
+     */
+    private waitForNotebook;
+    /**
+     * Handle possible account chooser
+     */
+    private handleAccountChooser;
+    /**
+     * Fill email identifier field with human-like typing
+     */
+    private fillIdentifier;
+    /**
+     * Fill password field with human-like typing
+     */
+    private fillPassword;
+    /**
+     * Click text element
+     */
+    private clickText;
+    /**
+     * Mask email for logging
+     */
+    private maskEmail;
+    /**
+     * Load authentication state from a specific file path
+     */
+    loadAuthState(context: BrowserContext, statePath: string): Promise<boolean>;
+    /**
+     * Perform interactive setup (for setup_auth tool)
+     * Opens a PERSISTENT browser for manual login
+     *
+     * CRITICAL: Uses the SAME persistent context as runtime!
+     * This ensures cookies are automatically saved to the Chrome profile.
+     *
+     * Benefits over temporary browser:
+     * - Session cookies persist correctly (Playwright bug workaround)
+     * - Same fingerprint as runtime
+     * - No need for addCookies() workarounds
+     * - Automatic cookie persistence via Chrome profile
+     *
+     * @param sendProgress Optional progress callback
+     * @param overrideHeadless Optional override for headless mode (true = visible, false = headless)
+     *                         If not provided, defaults to true (visible) for setup
+     */
+    performSetup(sendProgress?: ProgressCallback, overrideHeadless?: boolean): Promise<boolean>;
+    /**
+     * Clear ALL authentication data for account switching
+     *
+     * CRITICAL: This deletes EVERYTHING to ensure only ONE account is active:
+     * - All state.json files (cookies, localStorage)
+     * - sessionStorage files
+     * - Chrome profile directory (browser fingerprint, cache, etc.)
+     *
+     * Use this BEFORE authenticating a new account!
+     */
+    clearAllAuthData(): Promise<void>;
+    /**
+     * Clear all saved authentication state
+     */
+    clearState(): Promise<boolean>;
+    /**
+     * HARD RESET: Completely delete ALL authentication state
+     */
+    hardResetState(): Promise<boolean>;
+}
+//# sourceMappingURL=auth-manager.d.ts.map