notebooklm-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agmmnn
+
+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,249 @@
+# notebooklm-sdk
+
+A lightweight, zero-dependency TypeScript SDK for the NotebookLM API. Works with Node.js, Bun, and Deno.
+
+## Installation
+
+```bash
+npm install notebooklm-sdk
+# or
+bun add notebooklm-sdk
+```
+
+## Authentication
+
+This SDK uses **manual cookie auth only** — no Playwright, no headless browser. You extract your cookies once and pass them in.
+
+**Option 1 — Raw cookie string** (from browser DevTools → Network tab → copy `Cookie` request header):
+```bash
+NOTEBOOKLM_COOKIE="SID=...; HSID=...; ..."
+```
+
+**Option 2 — Playwright `storage_state.json`** (JSON array of cookie objects):
+```bash
+NOTEBOOKLM_COOKIE='[{"name":"SID","value":"...","domain":".google.com",...}]'
+```
+
+Then connect:
+```typescript
+import { NotebookLMClient } from "notebooklm-sdk";
+
+const client = await NotebookLMClient.connect({
+  cookies: process.env.NOTEBOOKLM_COOKIE,
+});
+```
+
+## API Reference
+
+### Notebooks
+
+```typescript
+const notebooks = await client.notebooks.list();
+const nb = await client.notebooks.get(notebookId);
+const { notebookId } = await client.notebooks.create("My Notebook");
+await client.notebooks.rename(notebookId, "New Title");
+await client.notebooks.delete(notebookId);
+
+const summary = await client.notebooks.getSummary(notebookId);
+const description = await client.notebooks.getDescription(notebookId);
+// description.summary, description.suggestedTopics
+```
+
+### Sources
+
+```typescript
+const sources = await client.sources.list(notebookId);
+const source = await client.sources.get(notebookId, sourceId);
+
+// Add sources
+const { sourceId } = await client.sources.addUrl(notebookId, "https://example.com");
+const { sourceId } = await client.sources.addText(notebookId, "My text", "My Title");
+const { sourceId } = await client.sources.addFile(notebookId, buffer, "file.pdf");
+
+// Poll until ready (status: "ready")
+const source = await client.sources.waitUntilReady(notebookId, sourceId);
+
+await client.sources.delete(notebookId, sourceId);
+```
+
+### Artifacts
+
+Generate AI artifacts from notebook sources:
+
+```typescript
+// Audio podcast
+const { artifactId } = await client.artifacts.createAudio(notebookId, {
+  format: AudioFormat.DEEP_DIVE,  // DEEP_DIVE | BRIEF | CRITIQUE | DEBATE
+  length: AudioLength.DEFAULT,    // SHORT | DEFAULT | LONG
+  language: "en",
+});
+
+// Video
+const { artifactId } = await client.artifacts.createVideo(notebookId, {
+  format: VideoFormat.EXPLAINER,  // EXPLAINER | BRIEF | CINEMATIC
+});
+
+// Quiz / Flashcards
+const { artifactId } = await client.artifacts.createQuiz(notebookId, {
+  difficulty: QuizDifficulty.MEDIUM,
+  quantity: QuizQuantity.STANDARD,
+});
+const { artifactId } = await client.artifacts.createFlashcards(notebookId);
+
+// Report (markdown)
+const { artifactId } = await client.artifacts.createReport(notebookId, {
+  format: "briefing_doc",  // "briefing_doc" | "study_guide" | "blog_post" | "custom"
+  language: "en",
+});
+
+// Other artifact types
+await client.artifacts.createInfographic(notebookId);
+await client.artifacts.createSlideDeck(notebookId);
+await client.artifacts.createMindMap(notebookId);
+```
+
+Poll and download:
+
+```typescript
+// Wait until ready
+const artifact = await client.artifacts.waitUntilReady(notebookId, artifactId);
+
+// Download
+const audioBuffer = await client.artifacts.downloadAudio(notebookId, artifactId);
+const videoBuffer = await client.artifacts.downloadVideo(notebookId, artifactId);
+const markdown = await client.artifacts.getReportMarkdown(notebookId, artifactId);
+const html = await client.artifacts.getInteractiveHtml(notebookId, artifactId); // quiz/flashcards
+```
+
+### Chat
+
+```typescript
+// Ask a question
+const result = await client.chat.ask(notebookId, "What is this about?");
+console.log(result.answer);
+console.log(result.references); // [{ sourceId, title, url }]
+
+// Follow-up (pass conversationId to continue the thread)
+const result2 = await client.chat.ask(notebookId, "Tell me more.", {
+  conversationId: result.conversationId,
+});
+
+// Fetch conversation history
+const lastConvId = await client.chat.getLastConversationId(notebookId);
+const turns = await client.chat.getConversationTurns(notebookId, lastConvId);
+```
+
+### Notes
+
+```typescript
+const { notes, mindMaps } = await client.notes.list(notebookId);
+
+const { noteId } = await client.notes.create(notebookId, "# My Note\n\nContent here.");
+await client.notes.update(notebookId, noteId, "Updated content.");
+await client.notes.delete(notebookId, noteId);
+```
+
+### Research
+
+```typescript
+// Start a fast web search or deep research
+const task = await client.research.start(notebookId, "Latest advances in quantum computing", "web", "deep");
+
+// Poll for results
+const result = await client.research.poll(notebookId);
+
+if (result.status === "completed") {
+  console.log(result.summary);
+  console.log(`Found ${result.sources.length} sources.`);
+  
+  // Import desired sources into the notebook
+  await client.research.importSources(notebookId, result.taskId, result.sources.slice(0, 2));
+}
+```
+
+### Sharing
+
+```typescript
+const status = await client.sharing.getStatus(notebookId);
+// status.isPublic, status.sharedUsers, status.shareUrl
+
+// Enable/disable public link sharing
+await client.sharing.setPublic(notebookId, true);
+
+// Share with a specific user
+await client.sharing.addUser(notebookId, "user@example.com", SharePermission.VIEWER);
+await client.sharing.updateUser(notebookId, "user@example.com", SharePermission.EDITOR);
+await client.sharing.removeUser(notebookId, "user@example.com");
+```
+
+### Settings
+
+```typescript
+const lang = await client.settings.getOutputLanguage(); // "en"
+await client.settings.setOutputLanguage("ja");
+```
+
+## Examples
+
+Runnable scripts in [`examples/`](./examples). Requires `.env` with `NOTEBOOKLM_COOKIE`.
+
+| Script | What it does |
+|--------|-------------|
+| `basic.ts` | List notebooks and sources |
+| `report.ts` | Generate and download a report |
+| `audio.ts` | Generate a podcast (long wait) |
+| `download.ts` | Download all completed artifacts (audio, video, reports, quiz, flashcards) |
+| `chat.ts` | Ask questions and follow up |
+| `research.ts` | Start a web research session and import sources |
+| `settings.ts` | Check output language and sharing status |
+
+```bash
+bunx dotenv -e .env -- bunx tsx examples/basic.ts
+```
+
+## Error Handling
+
+All errors extend `NotebookLMError`:
+
+```typescript
+import { ArtifactNotReadyError, AuthError, RateLimitError } from "notebooklm-sdk";
+
+try {
+  await client.artifacts.downloadAudio(notebookId, artifactId);
+} catch (err) {
+  if (err instanceof ArtifactNotReadyError) { /* artifact still processing */ }
+  if (err instanceof AuthError) { /* cookies expired */ }
+  if (err instanceof RateLimitError) { /* back off */ }
+}
+```
+
+Error classes: `AuthError`, `RateLimitError`, `NetworkError`, `ServerError`, `RPCError`, `RPCTimeoutError`, `ArtifactNotReadyError`, `ArtifactNotFoundError`, `SourceAddError`, `SourceProcessingError`, `SourceTimeoutError`, and more.
+
+## Project Structure
+
+```
+src/
+├── client.ts          — NotebookLMClient
+├── auth.ts            — Cookie auth, token fetching
+├── index.ts           — Public exports
+├── api/
+│   ├── artifacts.ts   — Audio, video, quiz, report, slide deck, infographic, mind map
+│   ├── chat.ts        — Chat / Q&A
+│   ├── notebooks.ts   — CRUD + summary
+│   ├── notes.ts       — Notes + mind maps
+│   ├── settings.ts    — User settings
+│   ├── sharing.ts     — Notebook sharing
+│   └── sources.ts     — URL, text, file sources
+├── rpc/
+│   ├── core.ts        — HTTP + decode pipeline
+│   ├── encoder.ts     — Request encoding
+│   └── decoder.ts     — Response decoding
+└── types/
+    ├── enums.ts       — RPC method IDs, format options, status codes
+    ├── errors.ts      — Error hierarchy
+    └── models.ts      — Interfaces + response parsers
+```
+
+## License
+
+MIT

package/dist/errors.cjs

@@ -0,0 +1,193 @@
+'use strict';
+
+// src/types/errors.ts
+var NotebookLMError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+  }
+};
+var NetworkError = class extends NotebookLMError {
+  methodId;
+  originalError;
+  constructor(message, opts = {}) {
+    super(message);
+    this.methodId = opts.methodId;
+    this.originalError = opts.originalError;
+  }
+};
+var RPCTimeoutError = class extends NetworkError {
+};
+var RPCError = class extends NotebookLMError {
+  methodId;
+  rawResponse;
+  rpcCode;
+  foundIds;
+  constructor(message, opts = {}) {
+    super(message);
+    this.methodId = opts.methodId;
+    this.rawResponse = opts.rawResponse ? opts.rawResponse.slice(0, 500) : void 0;
+    this.rpcCode = opts.rpcCode;
+    this.foundIds = opts.foundIds ?? [];
+  }
+};
+var AuthError = class extends RPCError {
+};
+var RateLimitError = class extends RPCError {
+  retryAfter;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.retryAfter = opts.retryAfter;
+  }
+};
+var ServerError = class extends RPCError {
+  statusCode;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.statusCode = opts.statusCode;
+  }
+};
+var ClientError = class extends RPCError {
+  statusCode;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.statusCode = opts.statusCode;
+  }
+};
+var NotebookError = class extends NotebookLMError {
+};
+var NotebookNotFoundError = class extends NotebookError {
+  notebookId;
+  constructor(notebookId) {
+    super(`Notebook not found: ${notebookId}`);
+    this.notebookId = notebookId;
+  }
+};
+var SourceError = class extends NotebookLMError {
+};
+var SourceNotFoundError = class extends SourceError {
+  sourceId;
+  constructor(sourceId) {
+    super(`Source not found: ${sourceId}`);
+    this.sourceId = sourceId;
+  }
+};
+var SourceAddError = class extends SourceError {
+  url;
+  cause;
+  constructor(url, opts = {}) {
+    super(
+      opts.message ?? `Failed to add source: ${url}
+Possible causes:
+  - URL is invalid or inaccessible
+  - Content is behind a paywall or requires authentication
+  - Rate limiting or quota exceeded`
+    );
+    this.url = url;
+    this.cause = opts.cause;
+  }
+};
+var SourceProcessingError = class extends SourceError {
+  sourceId;
+  status;
+  constructor(sourceId, status = 3, message) {
+    super(message ?? `Source ${sourceId} failed to process`);
+    this.sourceId = sourceId;
+    this.status = status;
+  }
+};
+var SourceTimeoutError = class extends SourceError {
+  sourceId;
+  timeout;
+  lastStatus;
+  constructor(sourceId, timeout, lastStatus) {
+    const statusInfo = lastStatus != null ? ` (last status: ${lastStatus})` : "";
+    super(`Source ${sourceId} not ready after ${timeout.toFixed(1)}s${statusInfo}`);
+    this.sourceId = sourceId;
+    this.timeout = timeout;
+    this.lastStatus = lastStatus;
+  }
+};
+var ArtifactError = class extends NotebookLMError {
+};
+var ArtifactNotFoundError = class extends ArtifactError {
+  artifactId;
+  artifactType;
+  constructor(artifactId, artifactType) {
+    const typeInfo = artifactType ? ` ${artifactType}` : "";
+    super(`${typeInfo.trim() || "Artifact"} ${artifactId} not found`);
+    this.artifactId = artifactId;
+    this.artifactType = artifactType;
+  }
+};
+var ArtifactNotReadyError = class extends ArtifactError {
+  artifactType;
+  artifactId;
+  status;
+  constructor(artifactType, opts = {}) {
+    const base = opts.artifactId ? `${artifactType} artifact ${opts.artifactId} is not ready` : `No completed ${artifactType} found`;
+    const statusInfo = opts.status ? ` (status: ${opts.status})` : "";
+    super(`${base}${statusInfo}`);
+    this.artifactType = artifactType;
+    this.artifactId = opts.artifactId;
+    this.status = opts.status;
+  }
+};
+var ArtifactParseError = class extends ArtifactError {
+  artifactType;
+  artifactId;
+  details;
+  cause;
+  constructor(artifactType, opts = {}) {
+    let msg = `Failed to parse ${artifactType} artifact`;
+    if (opts.artifactId) msg += ` ${opts.artifactId}`;
+    if (opts.details) msg += `: ${opts.details}`;
+    super(msg);
+    this.artifactType = artifactType;
+    this.artifactId = opts.artifactId;
+    this.details = opts.details;
+    this.cause = opts.cause;
+  }
+};
+var ArtifactDownloadError = class extends ArtifactError {
+  artifactType;
+  artifactId;
+  details;
+  cause;
+  constructor(artifactType, opts = {}) {
+    let msg = `Failed to download ${artifactType} artifact`;
+    if (opts.artifactId) msg += ` ${opts.artifactId}`;
+    if (opts.details) msg += `: ${opts.details}`;
+    super(msg);
+    this.artifactType = artifactType;
+    this.artifactId = opts.artifactId;
+    this.details = opts.details;
+    this.cause = opts.cause;
+  }
+};
+var ChatError = class extends NotebookLMError {
+};
+
+exports.ArtifactDownloadError = ArtifactDownloadError;
+exports.ArtifactError = ArtifactError;
+exports.ArtifactNotFoundError = ArtifactNotFoundError;
+exports.ArtifactNotReadyError = ArtifactNotReadyError;
+exports.ArtifactParseError = ArtifactParseError;
+exports.AuthError = AuthError;
+exports.ChatError = ChatError;
+exports.ClientError = ClientError;
+exports.NetworkError = NetworkError;
+exports.NotebookError = NotebookError;
+exports.NotebookLMError = NotebookLMError;
+exports.NotebookNotFoundError = NotebookNotFoundError;
+exports.RPCError = RPCError;
+exports.RPCTimeoutError = RPCTimeoutError;
+exports.RateLimitError = RateLimitError;
+exports.ServerError = ServerError;
+exports.SourceAddError = SourceAddError;
+exports.SourceError = SourceError;
+exports.SourceNotFoundError = SourceNotFoundError;
+exports.SourceProcessingError = SourceProcessingError;
+exports.SourceTimeoutError = SourceTimeoutError;
+//# sourceMappingURL=errors.cjs.map
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/errors.ts"],"names":[],"mappings":"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","file":"errors.cjs","sourcesContent":["/**\n * All exceptions for notebooklm-sdk.\n *\n * All errors extend NotebookLMError so you can catch everything with:\n *   try { ... } catch (e) { if (e instanceof NotebookLMError) ... }\n */\n\nexport class NotebookLMError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = this.constructor.name;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Network (transport-level, before RPC processing)\n// ---------------------------------------------------------------------------\n\nexport class NetworkError extends NotebookLMError {\n  readonly methodId?: string;\n  readonly originalError?: Error;\n\n  constructor(message: string, opts: { methodId?: string; originalError?: Error } = {}) {\n    super(message);\n    this.methodId = opts.methodId;\n    this.originalError = opts.originalError;\n  }\n}\n\nexport class RPCTimeoutError extends NetworkError {}\n\n// ---------------------------------------------------------------------------\n// RPC Protocol (after connection established)\n// ---------------------------------------------------------------------------\n\nexport class RPCError extends NotebookLMError {\n  readonly methodId?: string;\n  readonly rawResponse?: string;\n  readonly rpcCode?: string | number;\n  readonly foundIds: string[];\n\n  constructor(\n    message: string,\n    opts: {\n      methodId?: string;\n      rawResponse?: string;\n      rpcCode?: string | number;\n      foundIds?: string[];\n    } = {},\n  ) {\n    super(message);\n    this.methodId = opts.methodId;\n    this.rawResponse = opts.rawResponse ? opts.rawResponse.slice(0, 500) : undefined;\n    this.rpcCode = opts.rpcCode;\n    this.foundIds = opts.foundIds ?? [];\n  }\n}\n\nexport class AuthError extends RPCError {}\n\nexport class RateLimitError extends RPCError {\n  readonly retryAfter?: number;\n\n  constructor(\n    message: string,\n    opts: {\n      retryAfter?: number;\n      methodId?: string;\n      rawResponse?: string;\n      rpcCode?: string | number;\n      foundIds?: string[];\n    } = {},\n  ) {\n    super(message, opts);\n    this.retryAfter = opts.retryAfter;\n  }\n}\n\nexport class ServerError extends RPCError {\n  readonly statusCode?: number;\n\n  constructor(\n    message: string,\n    opts: {\n      statusCode?: number;\n      methodId?: string;\n      rawResponse?: string;\n      rpcCode?: string | number;\n    } = {},\n  ) {\n    super(message, opts);\n    this.statusCode = opts.statusCode;\n  }\n}\n\nexport class ClientError extends RPCError {\n  readonly statusCode?: number;\n\n  constructor(\n    message: string,\n    opts: {\n      statusCode?: number;\n      methodId?: string;\n      rawResponse?: string;\n      rpcCode?: string | number;\n    } = {},\n  ) {\n    super(message, opts);\n    this.statusCode = opts.statusCode;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Domain: Notebooks\n// ---------------------------------------------------------------------------\n\nexport class NotebookError extends NotebookLMError {}\n\nexport class NotebookNotFoundError extends NotebookError {\n  readonly notebookId: string;\n\n  constructor(notebookId: string) {\n    super(`Notebook not found: ${notebookId}`);\n    this.notebookId = notebookId;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Domain: Sources\n// ---------------------------------------------------------------------------\n\nexport class SourceError extends NotebookLMError {}\n\nexport class SourceNotFoundError extends SourceError {\n  readonly sourceId: string;\n\n  constructor(sourceId: string) {\n    super(`Source not found: ${sourceId}`);\n    this.sourceId = sourceId;\n  }\n}\n\nexport class SourceAddError extends SourceError {\n  readonly url: string;\n  readonly cause?: Error;\n\n  constructor(url: string, opts: { cause?: Error; message?: string } = {}) {\n    super(\n      opts.message ??\n        `Failed to add source: ${url}\\n` +\n          \"Possible causes:\\n\" +\n          \"  - URL is invalid or inaccessible\\n\" +\n          \"  - Content is behind a paywall or requires authentication\\n\" +\n          \"  - Rate limiting or quota exceeded\",\n    );\n    this.url = url;\n    this.cause = opts.cause;\n  }\n}\n\nexport class SourceProcessingError extends SourceError {\n  readonly sourceId: string;\n  readonly status: number;\n\n  constructor(sourceId: string, status = 3, message?: string) {\n    super(message ?? `Source ${sourceId} failed to process`);\n    this.sourceId = sourceId;\n    this.status = status;\n  }\n}\n\nexport class SourceTimeoutError extends SourceError {\n  readonly sourceId: string;\n  readonly timeout: number;\n  readonly lastStatus?: number;\n\n  constructor(sourceId: string, timeout: number, lastStatus?: number) {\n    const statusInfo = lastStatus != null ? ` (last status: ${lastStatus})` : \"\";\n    super(`Source ${sourceId} not ready after ${timeout.toFixed(1)}s${statusInfo}`);\n    this.sourceId = sourceId;\n    this.timeout = timeout;\n    this.lastStatus = lastStatus;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Domain: Artifacts\n// ---------------------------------------------------------------------------\n\nexport class ArtifactError extends NotebookLMError {}\n\nexport class ArtifactNotFoundError extends ArtifactError {\n  readonly artifactId: string;\n  readonly artifactType?: string;\n\n  constructor(artifactId: string, artifactType?: string) {\n    const typeInfo = artifactType ? ` ${artifactType}` : \"\";\n    super(`${typeInfo.trim() || \"Artifact\"} ${artifactId} not found`);\n    this.artifactId = artifactId;\n    this.artifactType = artifactType;\n  }\n}\n\nexport class ArtifactNotReadyError extends ArtifactError {\n  readonly artifactType: string;\n  readonly artifactId?: string;\n  readonly status?: string;\n\n  constructor(artifactType: string, opts: { artifactId?: string; status?: string } = {}) {\n    const base = opts.artifactId\n      ? `${artifactType} artifact ${opts.artifactId} is not ready`\n      : `No completed ${artifactType} found`;\n    const statusInfo = opts.status ? ` (status: ${opts.status})` : \"\";\n    super(`${base}${statusInfo}`);\n    this.artifactType = artifactType;\n    this.artifactId = opts.artifactId;\n    this.status = opts.status;\n  }\n}\n\nexport class ArtifactParseError extends ArtifactError {\n  readonly artifactType: string;\n  readonly artifactId?: string;\n  readonly details?: string;\n  readonly cause?: Error;\n\n  constructor(\n    artifactType: string,\n    opts: { details?: string; artifactId?: string; cause?: Error } = {},\n  ) {\n    let msg = `Failed to parse ${artifactType} artifact`;\n    if (opts.artifactId) msg += ` ${opts.artifactId}`;\n    if (opts.details) msg += `: ${opts.details}`;\n    super(msg);\n    this.artifactType = artifactType;\n    this.artifactId = opts.artifactId;\n    this.details = opts.details;\n    this.cause = opts.cause;\n  }\n}\n\nexport class ArtifactDownloadError extends ArtifactError {\n  readonly artifactType: string;\n  readonly artifactId?: string;\n  readonly details?: string;\n  readonly cause?: Error;\n\n  constructor(\n    artifactType: string,\n    opts: { details?: string; artifactId?: string; cause?: Error } = {},\n  ) {\n    let msg = `Failed to download ${artifactType} artifact`;\n    if (opts.artifactId) msg += ` ${opts.artifactId}`;\n    if (opts.details) msg += `: ${opts.details}`;\n    super(msg);\n    this.artifactType = artifactType;\n    this.artifactId = opts.artifactId;\n    this.details = opts.details;\n    this.cause = opts.cause;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Domain: Chat\n// ---------------------------------------------------------------------------\n\nexport class ChatError extends NotebookLMError {}\n"]}

package/dist/errors.d.cts

@@ -0,0 +1,134 @@
+/**
+ * All exceptions for notebooklm-sdk.
+ *
+ * All errors extend NotebookLMError so you can catch everything with:
+ *   try { ... } catch (e) { if (e instanceof NotebookLMError) ... }
+ */
+declare class NotebookLMError extends Error {
+    constructor(message: string);
+}
+declare class NetworkError extends NotebookLMError {
+    readonly methodId?: string;
+    readonly originalError?: Error;
+    constructor(message: string, opts?: {
+        methodId?: string;
+        originalError?: Error;
+    });
+}
+declare class RPCTimeoutError extends NetworkError {
+}
+declare class RPCError extends NotebookLMError {
+    readonly methodId?: string;
+    readonly rawResponse?: string;
+    readonly rpcCode?: string | number;
+    readonly foundIds: string[];
+    constructor(message: string, opts?: {
+        methodId?: string;
+        rawResponse?: string;
+        rpcCode?: string | number;
+        foundIds?: string[];
+    });
+}
+declare class AuthError extends RPCError {
+}
+declare class RateLimitError extends RPCError {
+    readonly retryAfter?: number;
+    constructor(message: string, opts?: {
+        retryAfter?: number;
+        methodId?: string;
+        rawResponse?: string;
+        rpcCode?: string | number;
+        foundIds?: string[];
+    });
+}
+declare class ServerError extends RPCError {
+    readonly statusCode?: number;
+    constructor(message: string, opts?: {
+        statusCode?: number;
+        methodId?: string;
+        rawResponse?: string;
+        rpcCode?: string | number;
+    });
+}
+declare class ClientError extends RPCError {
+    readonly statusCode?: number;
+    constructor(message: string, opts?: {
+        statusCode?: number;
+        methodId?: string;
+        rawResponse?: string;
+        rpcCode?: string | number;
+    });
+}
+declare class NotebookError extends NotebookLMError {
+}
+declare class NotebookNotFoundError extends NotebookError {
+    readonly notebookId: string;
+    constructor(notebookId: string);
+}
+declare class SourceError extends NotebookLMError {
+}
+declare class SourceNotFoundError extends SourceError {
+    readonly sourceId: string;
+    constructor(sourceId: string);
+}
+declare class SourceAddError extends SourceError {
+    readonly url: string;
+    readonly cause?: Error;
+    constructor(url: string, opts?: {
+        cause?: Error;
+        message?: string;
+    });
+}
+declare class SourceProcessingError extends SourceError {
+    readonly sourceId: string;
+    readonly status: number;
+    constructor(sourceId: string, status?: number, message?: string);
+}
+declare class SourceTimeoutError extends SourceError {
+    readonly sourceId: string;
+    readonly timeout: number;
+    readonly lastStatus?: number;
+    constructor(sourceId: string, timeout: number, lastStatus?: number);
+}
+declare class ArtifactError extends NotebookLMError {
+}
+declare class ArtifactNotFoundError extends ArtifactError {
+    readonly artifactId: string;
+    readonly artifactType?: string;
+    constructor(artifactId: string, artifactType?: string);
+}
+declare class ArtifactNotReadyError extends ArtifactError {
+    readonly artifactType: string;
+    readonly artifactId?: string;
+    readonly status?: string;
+    constructor(artifactType: string, opts?: {
+        artifactId?: string;
+        status?: string;
+    });
+}
+declare class ArtifactParseError extends ArtifactError {
+    readonly artifactType: string;
+    readonly artifactId?: string;
+    readonly details?: string;
+    readonly cause?: Error;
+    constructor(artifactType: string, opts?: {
+        details?: string;
+        artifactId?: string;
+        cause?: Error;
+    });
+}
+declare class ArtifactDownloadError extends ArtifactError {
+    readonly artifactType: string;
+    readonly artifactId?: string;
+    readonly details?: string;
+    readonly cause?: Error;
+    constructor(artifactType: string, opts?: {
+        details?: string;
+        artifactId?: string;
+        cause?: Error;
+    });
+}
+declare class ChatError extends NotebookLMError {
+}
+
+export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, AuthError, ChatError, ClientError, NetworkError, NotebookError, NotebookLMError, NotebookNotFoundError, RPCError, RPCTimeoutError, RateLimitError, ServerError, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError };