notebooklm-sdk 0.3.2 → 0.3.4

package/dist/index.js

@@ -309,356 +309,176 @@ var init_enums = __esm({
   }
 });
 
+// src/api/artifacts.ts
+init_enums();
+
 // src/types/errors.ts
-var NotebookLMError, NetworkError, RPCTimeoutError, RPCError, AuthError, RateLimitError, ServerError, ClientError, NotebookError, NotebookNotFoundError, SourceError, SourceNotFoundError, SourceAddError, SourceProcessingError, SourceTimeoutError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, ArtifactDownloadError, ChatError;
-var init_errors = __esm({
-  "src/types/errors.ts"() {
-    NotebookLMError = class extends Error {
-      constructor(message) {
-        super(message);
-        this.name = this.constructor.name;
-      }
-    };
-    NetworkError = class extends NotebookLMError {
-      methodId;
-      originalError;
-      constructor(message, opts = {}) {
-        super(message);
-        this.methodId = opts.methodId;
-        this.originalError = opts.originalError;
-      }
-    };
-    RPCTimeoutError = class extends NetworkError {
-    };
-    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 ?? [];
-      }
-    };
-    AuthError = class extends RPCError {
-    };
-    RateLimitError = class extends RPCError {
-      retryAfter;
-      constructor(message, opts = {}) {
-        super(message, opts);
-        this.retryAfter = opts.retryAfter;
-      }
-    };
-    ServerError = class extends RPCError {
-      statusCode;
-      constructor(message, opts = {}) {
-        super(message, opts);
-        this.statusCode = opts.statusCode;
-      }
-    };
-    ClientError = class extends RPCError {
-      statusCode;
-      constructor(message, opts = {}) {
-        super(message, opts);
-        this.statusCode = opts.statusCode;
-      }
-    };
-    NotebookError = class extends NotebookLMError {
-    };
-    NotebookNotFoundError = class extends NotebookError {
-      notebookId;
-      constructor(notebookId) {
-        super(`Notebook not found: ${notebookId}`);
-        this.notebookId = notebookId;
-      }
-    };
-    SourceError = class extends NotebookLMError {
-    };
-    SourceNotFoundError = class extends SourceError {
-      sourceId;
-      constructor(sourceId) {
-        super(`Source not found: ${sourceId}`);
-        this.sourceId = sourceId;
-      }
-    };
-    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;
-      }
-    };
-    SourceProcessingError = class extends SourceError {
-      sourceId;
-      status;
-      constructor(sourceId, status = 3, message) {
-        super(message ?? `Source ${sourceId} failed to process`);
-        this.sourceId = sourceId;
-        this.status = status;
-      }
-    };
-    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;
-      }
-    };
-    ArtifactError = class extends NotebookLMError {
-    };
-    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;
-      }
-    };
-    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;
-      }
-    };
-    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;
-      }
-    };
-    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;
-      }
-    };
-    ChatError = class extends NotebookLMError {
-    };
+var NotebookLMError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
   }
-});
-
-// src/auth.ts
-var auth_exports = {};
-__export(auth_exports, {
-  buildCookieHeader: () => buildCookieHeader,
-  buildGoogleCookieHeader: () => buildGoogleCookieHeader,
-  connect: () => connect,
-  fetchTokens: () => fetchTokens,
-  loadCookiesFromFile: () => loadCookiesFromFile,
-  loadCookiesFromMap: () => loadCookiesFromMap,
-  loadCookiesFromObject: () => loadCookiesFromObject,
-  loadCookiesFromString: () => loadCookiesFromString
-});
-function loadCookiesFromFile(filePath) {
-  let raw;
-  try {
-    raw = readFileSync(filePath, "utf-8");
-  } catch {
-    throw new AuthError(`Session file not found: ${filePath}
-Run: npx notebooklm-sdk login`);
+};
+var NetworkError = class extends NotebookLMError {
+  methodId;
+  originalError;
+  constructor(message, opts = {}) {
+    super(message);
+    this.methodId = opts.methodId;
+    this.originalError = opts.originalError;
   }
-  return extractCookiesFromStorageState(JSON.parse(raw));
-}
-function loadCookiesFromObject(storageState) {
-  return extractCookiesFromStorageState(storageState);
-}
-function buildGoogleCookieHeader(storageState) {
-  const map = {};
-  for (const c of storageState.cookies ?? []) {
-    if (c.domain === ".google.com" && c.name && c.value) {
-      map[c.name] = map[c.name] ?? c.value;
-    }
+};
+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 ?? [];
   }
-  return buildCookieHeader(map);
-}
-function loadCookiesFromMap(map) {
-  return { ...map };
-}
-function loadCookiesFromString(cookieStr) {
-  const map = {};
-  for (const part of cookieStr.split(/;\s*/)) {
-    const idx = part.indexOf("=");
-    if (idx > 0) {
-      const name = part.slice(0, idx).trim();
-      const value = part.slice(idx + 1).trim();
-      if (name) map[name] = value;
-    }
+};
+var AuthError = class extends RPCError {
+};
+var RateLimitError = class extends RPCError {
+  retryAfter;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.retryAfter = opts.retryAfter;
   }
-  return map;
-}
-function extractCookiesFromStorageState(storageState) {
-  const cookies = {};
-  for (const cookie of storageState.cookies ?? []) {
-    const { domain, name, value } = cookie;
-    if (!isAllowedDomain(domain) || !name) continue;
-    const isBase = domain === ".google.com";
-    if (!(name in cookies) || isBase) {
-      cookies[name] = value;
-    }
+};
+var ServerError = class extends RPCError {
+  statusCode;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.statusCode = opts.statusCode;
   }
-  if (!cookies["SID"]) {
-    throw new AuthError(
-      "Missing required cookie: SID. Session may be invalid or expired.\nRun: npx notebooklm-sdk login"
-    );
+};
+var ClientError = class extends RPCError {
+  statusCode;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.statusCode = opts.statusCode;
   }
-  return cookies;
-}
-function isAllowedDomain(domain) {
-  if (domain === ".google.com" || domain === "notebooklm.google.com" || domain === ".googleusercontent.com") {
-    return true;
+};
+var NotebookError = class extends NotebookLMError {
+};
+var NotebookNotFoundError = class extends NotebookError {
+  notebookId;
+  constructor(notebookId) {
+    super(`Notebook not found: ${notebookId}`);
+    this.notebookId = notebookId;
   }
-  if (domain.startsWith(".google.")) {
-    return true;
+};
+var SourceError = class extends NotebookLMError {
+};
+var SourceNotFoundError = class extends SourceError {
+  sourceId;
+  constructor(sourceId) {
+    super(`Source not found: ${sourceId}`);
+    this.sourceId = sourceId;
   }
-  return false;
-}
-function buildCookieHeader(cookies) {
-  return Object.entries(cookies).map(([k, v]) => `${k}=${v}`).join("; ");
-}
-async function fetchTokens(cookies) {
-  const cookieHeader = buildCookieHeader(cookies);
-  const response = await fetch(NOTEBOOKLM_URL, {
-    headers: { Cookie: cookieHeader },
-    redirect: "follow"
-  });
-  if (!response.ok) {
-    throw new AuthError(`Failed to fetch NotebookLM page: HTTP ${response.status}`);
+};
+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;
   }
-  const finalUrl = response.url;
-  if (isGoogleAuthRedirect(finalUrl)) {
-    throw new AuthError(`Redirected to login page: ${finalUrl}. Cookies may be expired.`);
+};
+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;
   }
-  const html = await response.text();
-  const csrfToken = extractCsrfToken(html, finalUrl);
-  const sessionId = extractSessionId(html, finalUrl);
-  return { csrfToken, sessionId };
-}
-function extractCsrfToken(html, finalUrl) {
-  const match = /"SNlM0e"\s*:\s*"([^"]+)"/.exec(html);
-  if (!match?.[1]) {
-    if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
-      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
-    }
-    throw new AuthError("CSRF token (SNlM0e) not found in NotebookLM page HTML.");
+};
+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;
   }
-  return match[1];
-}
-function extractSessionId(html, finalUrl) {
-  const match = /"FdrFJe"\s*:\s*"([^"]+)"/.exec(html);
-  if (!match?.[1]) {
-    if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
-      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
-    }
-    throw new AuthError("Session ID (FdrFJe) not found in NotebookLM page HTML.");
+};
+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;
   }
-  return match[1];
-}
-function isGoogleAuthRedirect(url) {
-  return url.includes("accounts.google.com") || url.includes("signin");
-}
-async function connect(opts = {}) {
-  let cookieMap;
-  let googleCookieHeader = null;
-  if (opts.cookies) {
-    cookieMap = loadCookiesFromString(opts.cookies);
-  } else if (opts.cookiesFile) {
-    cookieMap = loadCookiesFromFile(opts.cookiesFile);
-  } else if (opts.cookiesObject) {
-    if ("cookies" in opts.cookiesObject && Array.isArray(opts.cookiesObject.cookies)) {
-      const storageState = opts.cookiesObject;
-      cookieMap = loadCookiesFromObject(storageState);
-      googleCookieHeader = buildGoogleCookieHeader(storageState);
-    } else {
-      cookieMap = loadCookiesFromMap(opts.cookiesObject);
-    }
-  } else {
-    const envCookies = process.env["NOTEBOOKLM_COOKIES"];
-    const envFile = process.env["NOTEBOOKLM_COOKIES_FILE"];
-    if (envFile) {
-      cookieMap = loadCookiesFromFile(envFile);
-    } else if (existsSync(DEFAULT_SESSION_FILE)) {
-      const raw = readFileSync(DEFAULT_SESSION_FILE, "utf-8");
-      const storageState = JSON.parse(raw);
-      cookieMap = loadCookiesFromObject(storageState);
-      googleCookieHeader = buildGoogleCookieHeader(storageState);
-    } else if (existsSync("storage_state.json")) {
-      const raw = readFileSync("storage_state.json", "utf-8");
-      const storageState = JSON.parse(raw);
-      cookieMap = loadCookiesFromObject(storageState);
-      googleCookieHeader = buildGoogleCookieHeader(storageState);
-    } else if (envCookies) {
-      cookieMap = loadCookiesFromString(envCookies);
-    } else {
-      throw new AuthError("No session found. Run: npx notebooklm-sdk login");
-    }
+};
+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;
   }
-  const { csrfToken, sessionId } = await fetchTokens(cookieMap);
-  const cookieHeader = buildCookieHeader(cookieMap);
-  return {
-    cookies: cookieMap,
-    csrfToken,
-    sessionId,
-    cookieHeader,
-    googleCookieHeader: googleCookieHeader ?? cookieHeader
-  };
-}
-var DEFAULT_SESSION_FILE, NOTEBOOKLM_URL;
-var init_auth = __esm({
-  "src/auth.ts"() {
-    init_errors();
-    DEFAULT_SESSION_FILE = join(homedir(), ".notebooklm", "session.json");
-    NOTEBOOKLM_URL = "https://notebooklm.google.com/";
+};
+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;
   }
-});
-
-// src/api/artifacts.ts
-init_enums();
-init_errors();
+};
+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 {
+};
 
 // src/types/models.ts
 init_enums();
@@ -1118,17 +938,60 @@ ${opts.extraInstructions}` : cfg.prompt;
   // Polling / download
   // ---------------------------------------------------------------------------
   /** Poll until artifact reaches completed/failed status. */
-  async waitUntilReady(notebookId, artifactId, timeout = 300, pollInterval = 3) {
+  async waitUntilReady(notebookId, artifactId, timeout = 1800, pollInterval = 3) {
+    return this.pollUntilReady(notebookId, artifactId, {
+      timeoutSecs: timeout,
+      intervalSecs: pollInterval
+    });
+  }
+  /** Poll until artifact is fully ready, with optional progress hooks and cancellation. */
+  async pollUntilReady(notebookId, artifactId, opts = {}) {
+    const timeout = opts.timeoutSecs ?? 1800;
+    const pollInterval = opts.intervalSecs ?? 3;
     const deadline = Date.now() + timeout * 1e3;
+    let lastStatus = null;
     while (Date.now() < deadline) {
+      this.throwIfAborted(opts.signal);
+      const status = await this.pollStatus(notebookId, artifactId);
+      lastStatus = status;
+      if (opts.onTick) await opts.onTick(status);
       const artifact = await this.get(notebookId, artifactId);
-      if (artifact?.status === "completed") return artifact;
-      if (artifact?.status === "failed") {
-        throw new ArtifactNotReadyError(artifact.kind, { artifactId, status: "failed" });
+      if (artifact?.status === "completed") {
+        if (artifact.kind === "audio" && !artifact.audioUrl || artifact.kind === "video" && !artifact.videoUrl) {
+          await sleep(pollInterval * 1e3);
+          continue;
+        }
+        return artifact;
+      }
+      if (artifact?.status === "failed" || status.status === "failed") {
+        throw new ArtifactNotReadyError(artifact?.kind ?? "artifact", {
+          artifactId,
+          status: "failed"
+        });
       }
       await sleep(pollInterval * 1e3);
     }
-    throw new ArtifactNotReadyError("artifact", { artifactId, status: "timeout" });
+    throw new ArtifactNotReadyError("artifact", {
+      artifactId,
+      status: lastStatus?.status ?? "timeout"
+    });
+  }
+  throwIfAborted(signal) {
+    if (!signal?.aborted) return;
+    throw new Error("Artifact polling aborted");
+  }
+  /** Get the current status of a generated artifact without waiting. */
+  async pollStatus(notebookId, artifactId) {
+    const rawList = await this._listRaw(notebookId);
+    for (const item of rawList) {
+      if (!Array.isArray(item) || item[0] !== artifactId) continue;
+      const statusCode = typeof item[4] === "number" ? item[4] : null;
+      return {
+        artifactId,
+        status: statusCode != null ? artifactStatusFromCode(statusCode) : "pending"
+      };
+    }
+    return { artifactId, status: "pending" };
   }
   /** Download audio content as a Buffer. */
   async downloadAudio(notebookId, artifactId) {
@@ -1380,14 +1243,14 @@ function isTrustedDomain(url) {
 
 // src/api/chat.ts
 init_enums();
-init_errors();
 var QUERY_URL = "https://notebooklm.google.com/_/LabsTailwindUi/data/google.internal.labs.tailwind.orchestration.v1.LabsTailwindOrchestrationService/GenerateFreeFormStreamed";
 var DEFAULT_BL = "boq_labs-tailwind-frontend_20260301.03_p0";
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var ChatAPI = class {
-  constructor(rpc, auth) {
+  constructor(rpc, auth, refreshAuth) {
     this.rpc = rpc;
     this.auth = auth;
+    this.refreshAuth = refreshAuth;
   }
   conversationCache = /* @__PURE__ */ new Map();
   reqid = Math.floor(Math.random() * 9e5) + 1e5;
@@ -1417,20 +1280,7 @@ var ChatAPI = class {
     const bodyParts = [`f.req=${encodeURIComponent(fReq)}`];
     if (this.auth.csrfToken) bodyParts.push(`at=${encodeURIComponent(this.auth.csrfToken)}`);
     const body = bodyParts.join("&") + "&";
-    let response;
-    try {
-      response = await fetch(`${QUERY_URL}?${urlParams.toString()}`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
-          Cookie: this.auth.cookieHeader
-        },
-        body
-      });
-    } catch (e) {
-      throw new ChatError(`Chat request failed: ${String(e)}`);
-    }
-    if (!response.ok) throw new ChatError(`Chat request failed: HTTP ${response.status}`);
+    const response = await this._postChatRequest(`${QUERY_URL}?${urlParams.toString()}`, body);
     const text = await response.text();
     const { answer, conversationId: serverConvId, references } = parseStreamingResponse(text);
     const finalConvId = serverConvId ?? conversationId;
@@ -1490,12 +1340,47 @@ var ChatAPI = class {
     }
     return null;
   }
+  async getHistory(notebookId, limit = 100, conversationId) {
+    const convId = conversationId ?? await this.getLastConversationId(notebookId);
+    if (!convId) return [];
+    const params = [[], null, null, convId, limit];
+    const result = await this.rpc.call(RPCMethod.GET_CONVERSATION_TURNS, params, {
+      sourcePath: `/notebook/${notebookId}`,
+      allowNull: true
+    });
+    if (!Array.isArray(result) || !Array.isArray(result[0])) return [];
+    const rawTurns = [...result[0]].reverse();
+    const history = [];
+    let i = 0;
+    while (i < rawTurns.length) {
+      const turn = rawTurns[i];
+      if (!Array.isArray(turn) || turn.length < 3) {
+        i++;
+        continue;
+      }
+      if (turn[2] === 1 && turn.length > 3) {
+        const query = typeof turn[3] === "string" ? turn[3] : "";
+        let answer = "";
+        const next = rawTurns[i + 1];
+        if (Array.isArray(next) && next.length > 4 && next[2] === 2) {
+          try {
+            answer = String(next[4][0][0] ?? "");
+          } catch {
+          }
+          i++;
+        }
+        history.push([query, answer]);
+      }
+      i++;
+    }
+    return history;
+  }
   /**
    * Low-level chat configuration. Set goal, response length, and optional
    * custom instructions directly. Persists on the server per notebook.
    * Use `setMode()` for preset combinations instead.
    */
-  async configure(notebookId, goal, length, customPrompt) {
+  async configure(notebookId, goal = ChatGoal.DEFAULT, length = ChatResponseLength.DEFAULT, customPrompt) {
     if (goal === ChatGoal.CUSTOM && !customPrompt) {
       throw new Error("customPrompt is required when goal is ChatGoal.CUSTOM");
     }
@@ -1527,6 +1412,14 @@ var ChatAPI = class {
       this.conversationCache.clear();
     }
   }
+  getCachedTurns(conversationId) {
+    const turns = this.conversationCache.get(conversationId) ?? [];
+    return turns.map((turn) => ({
+      query: turn.query,
+      answer: turn.answer,
+      turnNumber: turn.turnNumber
+    }));
+  }
   _buildHistory(conversationId) {
     const turns = this.conversationCache.get(conversationId) ?? [];
     if (!turns.length) return null;
@@ -1537,6 +1430,27 @@ var ChatAPI = class {
     }
     return history;
   }
+  async _postChatRequest(url, body, retried = false) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+          Cookie: this.auth.cookieHeader
+        },
+        body
+      });
+    } catch (e) {
+      throw new ChatError(`Chat request failed: ${String(e)}`);
+    }
+    if ((response.status === 401 || response.status === 403) && !retried && this.refreshAuth) {
+      await this.refreshAuth();
+      return this._postChatRequest(url, body, true);
+    }
+    if (!response.ok) throw new ChatError(`Chat request failed: HTTP ${response.status}`);
+    return response;
+  }
 };
 function parseStreamingResponse(rawText) {
   let text = rawText;
@@ -1693,6 +1607,12 @@ var NotebooksAPI = class {
   async removeFromRecent(notebookId) {
     await this.rpc.call(RPCMethod.REMOVE_RECENTLY_VIEWED, [notebookId], { allowNull: true });
   }
+  async getRaw(notebookId) {
+    const params = [notebookId, null, [2], null, 0];
+    return this.rpc.call(RPCMethod.GET_NOTEBOOK, params, {
+      sourcePath: `/notebook/${notebookId}`
+    });
+  }
   async getDescription(notebookId) {
     const params = [notebookId, [2]];
     const result = await this.rpc.call(RPCMethod.SUMMARIZE, params, {
@@ -1720,6 +1640,41 @@ var NotebooksAPI = class {
     }
     return { summary, suggestedTopics };
   }
+  async share(notebookId, publicAccess = true, artifactId) {
+    const shareOptions = publicAccess ? [1] : [0];
+    const params = artifactId ? [shareOptions, notebookId, artifactId] : [shareOptions, notebookId];
+    await this.rpc.call(RPCMethod.SHARE_ARTIFACT, params, {
+      sourcePath: `/notebook/${notebookId}`,
+      allowNull: true
+    });
+    return {
+      public: publicAccess,
+      url: publicAccess ? this.getShareUrl(notebookId, artifactId) : null,
+      artifactId: artifactId ?? null
+    };
+  }
+  getShareUrl(notebookId, artifactId) {
+    const baseUrl = `https://notebooklm.google.com/notebook/${notebookId}`;
+    return artifactId ? `${baseUrl}?artifactId=${artifactId}` : baseUrl;
+  }
+  async getMetadata(notebookId) {
+    const raw = await this.getRaw(notebookId);
+    const notebookData = Array.isArray(raw) && raw.length > 0 && Array.isArray(raw[0]) ? raw[0] : [];
+    const notebook = parseNotebook(notebookData);
+    const sourcesRaw = Array.isArray(notebookData[1]) ? notebookData[1] : [];
+    const sources = sourcesRaw.filter((source) => Array.isArray(source) && source.length > 0).map((source) => parseSource(source));
+    return {
+      id: notebook.id,
+      title: notebook.title,
+      createdAt: notebook.createdAt,
+      isOwner: notebook.isOwner,
+      sources: sources.map((source) => ({
+        kind: source.kind,
+        title: source.title,
+        url: source.url
+      }))
+    };
+  }
 };
 
 // src/api/notes.ts
@@ -1732,6 +1687,10 @@ var NotesAPI = class {
     const all = await this._fetchAll(notebookId);
     return all.filter((n) => !this._isMindMap(n.content));
   }
+  async get(notebookId, noteId) {
+    const all = await this._fetchAll(notebookId);
+    return all.find((note) => note.id === noteId) ?? null;
+  }
   async listMindMaps(notebookId) {
     const all = await this._fetchAll(notebookId);
     return all.filter((n) => this._isMindMap(n.content));
@@ -1763,6 +1722,9 @@ var NotesAPI = class {
     });
     return true;
   }
+  async deleteMindMap(notebookId, mindMapId) {
+    return this.delete(notebookId, mindMapId);
+  }
   async _fetchAll(notebookId) {
     const result = await this.rpc.call(RPCMethod.GET_NOTES_AND_MIND_MAPS, [notebookId], {
       sourcePath: `/notebook/${notebookId}`,
@@ -2139,7 +2101,6 @@ function parseShareStatus(data, notebookId) {
 
 // src/api/sources.ts
 init_enums();
-init_errors();
 var UPLOAD_URL = "https://notebooklm.google.com/upload/_/";
 var SourcesAPI = class {
   constructor(rpc, auth) {
@@ -2422,6 +2383,29 @@ var SourcesAPI = class {
     });
     return true;
   }
+  async rename(notebookId, sourceId, newTitle) {
+    const params = [null, [sourceId], [[[newTitle]]]];
+    const result = await this.rpc.call(RPCMethod.UPDATE_SOURCE, params, {
+      sourcePath: `/notebook/${notebookId}`,
+      allowNull: true
+    });
+    if (Array.isArray(result) && result.length > 0) {
+      try {
+        const parsed = parseSource(result);
+        return parsed.title ? parsed : { ...parsed, title: newTitle };
+      } catch {
+      }
+    }
+    return {
+      id: sourceId,
+      title: newTitle,
+      url: null,
+      kind: "unknown",
+      createdAt: null,
+      status: "ready",
+      _typeCode: null
+    };
+  }
   async waitUntilReady(notebookId, sourceId, timeout = 120, initialInterval = 1, maxInterval = 10, backoffFactor = 1.5) {
     const deadline = Date.now() + timeout * 1e3;
     let interval = initialInterval;
@@ -2440,6 +2424,20 @@ var SourcesAPI = class {
     }
     throw new SourceTimeoutError(sourceId, timeout, lastStatus);
   }
+  async waitForSources(notebookId, sourceIds, timeout = 120, initialInterval = 1, maxInterval = 10, backoffFactor = 1.5) {
+    return Promise.all(
+      sourceIds.map(
+        (sourceId) => this.waitUntilReady(
+          notebookId,
+          sourceId,
+          timeout,
+          initialInterval,
+          maxInterval,
+          backoffFactor
+        )
+      )
+    );
+  }
 };
 function extractSourceId(result) {
   if (Array.isArray(result)) {
@@ -2472,18 +2470,169 @@ function extractAllText(data, maxDepth = 100) {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-
-// src/index.ts
-init_auth();
-
-// src/client.ts
-init_auth();
-
-// src/rpc/core.ts
-init_errors();
+var DEFAULT_SESSION_FILE = join(homedir(), ".notebooklm", "session.json");
+function loadCookiesFromFile(filePath) {
+  let raw;
+  try {
+    raw = readFileSync(filePath, "utf-8");
+  } catch {
+    throw new AuthError(`Session file not found: ${filePath}
+Run: npx notebooklm-sdk login`);
+  }
+  return extractCookiesFromStorageState(JSON.parse(raw));
+}
+function loadCookiesFromObject(storageState) {
+  return extractCookiesFromStorageState(storageState);
+}
+function buildGoogleCookieHeader(storageState) {
+  const map = {};
+  for (const c of storageState.cookies ?? []) {
+    if (c.domain === ".google.com" && c.name && c.value) {
+      map[c.name] = map[c.name] ?? c.value;
+    }
+  }
+  return buildCookieHeader(map);
+}
+function loadCookiesFromMap(map) {
+  return { ...map };
+}
+function loadCookiesFromString(cookieStr) {
+  const map = {};
+  for (const part of cookieStr.split(/;\s*/)) {
+    const idx = part.indexOf("=");
+    if (idx > 0) {
+      const name = part.slice(0, idx).trim();
+      const value = part.slice(idx + 1).trim();
+      if (name) map[name] = value;
+    }
+  }
+  return map;
+}
+function extractCookiesFromStorageState(storageState) {
+  const cookies = {};
+  for (const cookie of storageState.cookies ?? []) {
+    const { domain, name, value } = cookie;
+    if (!isAllowedDomain(domain) || !name) continue;
+    const isBase = domain === ".google.com";
+    if (!(name in cookies) || isBase) {
+      cookies[name] = value;
+    }
+  }
+  if (!cookies["SID"]) {
+    throw new AuthError(
+      "Missing required cookie: SID. Session may be invalid or expired.\nRun: npx notebooklm-sdk login"
+    );
+  }
+  return cookies;
+}
+function isAllowedDomain(domain) {
+  if (domain === ".google.com" || domain === "notebooklm.google.com" || domain === ".googleusercontent.com") {
+    return true;
+  }
+  if (domain.startsWith(".google.")) {
+    return true;
+  }
+  return false;
+}
+function buildCookieHeader(cookies) {
+  return Object.entries(cookies).map(([k, v]) => `${k}=${v}`).join("; ");
+}
+var NOTEBOOKLM_URL = "https://notebooklm.google.com/";
+async function fetchTokens(cookies) {
+  const cookieHeader = buildCookieHeader(cookies);
+  const response = await fetch(NOTEBOOKLM_URL, {
+    headers: { Cookie: cookieHeader },
+    redirect: "follow"
+  });
+  if (!response.ok) {
+    throw new AuthError(`Failed to fetch NotebookLM page: HTTP ${response.status}`);
+  }
+  const finalUrl = response.url;
+  if (isGoogleAuthRedirect(finalUrl)) {
+    throw new AuthError(`Redirected to login page: ${finalUrl}. Cookies may be expired.`);
+  }
+  const html = await response.text();
+  const csrfToken = extractCsrfToken(html, finalUrl);
+  const sessionId = extractSessionId(html, finalUrl);
+  return { csrfToken, sessionId };
+}
+async function refreshAuthTokens(auth) {
+  const { csrfToken, sessionId } = await fetchTokens(auth.cookies);
+  auth.csrfToken = csrfToken;
+  auth.sessionId = sessionId;
+  return auth;
+}
+function extractCsrfToken(html, finalUrl) {
+  const match = /"SNlM0e"\s*:\s*"([^"]+)"/.exec(html);
+  if (!match?.[1]) {
+    if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
+      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
+    }
+    throw new AuthError("CSRF token (SNlM0e) not found in NotebookLM page HTML.");
+  }
+  return match[1];
+}
+function extractSessionId(html, finalUrl) {
+  const match = /"FdrFJe"\s*:\s*"([^"]+)"/.exec(html);
+  if (!match?.[1]) {
+    if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
+      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
+    }
+    throw new AuthError("Session ID (FdrFJe) not found in NotebookLM page HTML.");
+  }
+  return match[1];
+}
+function isGoogleAuthRedirect(url) {
+  return url.includes("accounts.google.com") || url.includes("signin");
+}
+async function connect(opts = {}) {
+  let cookieMap;
+  let googleCookieHeader = null;
+  if (opts.cookies) {
+    cookieMap = loadCookiesFromString(opts.cookies);
+  } else if (opts.cookiesFile) {
+    cookieMap = loadCookiesFromFile(opts.cookiesFile);
+  } else if (opts.cookiesObject) {
+    if ("cookies" in opts.cookiesObject && Array.isArray(opts.cookiesObject.cookies)) {
+      const storageState = opts.cookiesObject;
+      cookieMap = loadCookiesFromObject(storageState);
+      googleCookieHeader = buildGoogleCookieHeader(storageState);
+    } else {
+      cookieMap = loadCookiesFromMap(opts.cookiesObject);
+    }
+  } else {
+    const envCookies = process.env["NOTEBOOKLM_COOKIES"];
+    const envFile = process.env["NOTEBOOKLM_COOKIES_FILE"];
+    if (envFile) {
+      cookieMap = loadCookiesFromFile(envFile);
+    } else if (existsSync(DEFAULT_SESSION_FILE)) {
+      const raw = readFileSync(DEFAULT_SESSION_FILE, "utf-8");
+      const storageState = JSON.parse(raw);
+      cookieMap = loadCookiesFromObject(storageState);
+      googleCookieHeader = buildGoogleCookieHeader(storageState);
+    } else if (existsSync("storage_state.json")) {
+      const raw = readFileSync("storage_state.json", "utf-8");
+      const storageState = JSON.parse(raw);
+      cookieMap = loadCookiesFromObject(storageState);
+      googleCookieHeader = buildGoogleCookieHeader(storageState);
+    } else if (envCookies) {
+      cookieMap = loadCookiesFromString(envCookies);
+    } else {
+      throw new AuthError("No session found. Run: npx notebooklm-sdk login");
+    }
+  }
+  const { csrfToken, sessionId } = await fetchTokens(cookieMap);
+  const cookieHeader = buildCookieHeader(cookieMap);
+  return {
+    cookies: cookieMap,
+    csrfToken,
+    sessionId,
+    cookieHeader,
+    googleCookieHeader: googleCookieHeader ?? cookieHeader
+  };
+}
 
 // src/rpc/decoder.ts
-init_errors();
 function stripAntiXSSI(response) {
   if (response.startsWith(")]}'")) {
     const match = /\)\]\}'\r?\n/.exec(response);
@@ -2667,11 +2816,13 @@ var DEFAULT_TIMEOUT_MS = 3e4;
 var RPCCore = class {
   auth;
   timeoutMs;
-  constructor(auth, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  refreshAuth;
+  constructor(auth, timeoutMs = DEFAULT_TIMEOUT_MS, refreshAuth) {
     this.auth = auth;
     this.timeoutMs = timeoutMs;
+    this.refreshAuth = refreshAuth;
   }
-  async call(methodId, params, opts = {}) {
+  async call(methodId, params, opts = {}, retried = false) {
     const sourcePath = opts.sourcePath ?? "/";
     const allowNull = opts.allowNull ?? false;
     const timeoutMs = opts.timeoutMs ?? this.timeoutMs;
@@ -2718,6 +2869,10 @@ var RPCCore = class {
         });
       }
       if (status === 401 || status === 403) {
+        if (!retried && this.refreshAuth) {
+          await this.refreshAuth();
+          return this.call(methodId, params, opts, true);
+        }
         throw new AuthError(`HTTP ${status} calling ${methodId}: authentication required`, {
           methodId
         });
@@ -2770,12 +2925,13 @@ var RPCCore = class {
 var NotebookLMClient = class _NotebookLMClient {
   constructor(auth, opts = {}) {
     this.auth = auth;
-    const rpc = new RPCCore(auth, opts.timeoutMs);
+    const refreshAuth = this.refreshTokens.bind(this);
+    const rpc = new RPCCore(auth, opts.timeoutMs, refreshAuth);
     this.notebooks = new NotebooksAPI(rpc);
     this.sources = new SourcesAPI(rpc, auth);
     this.notes = new NotesAPI(rpc);
     this.artifacts = new ArtifactsAPI(rpc, auth, this.notes);
-    this.chat = new ChatAPI(rpc, auth);
+    this.chat = new ChatAPI(rpc, auth, refreshAuth);
     this.research = new ResearchAPI(rpc);
     this.settings = new SettingsAPI(rpc);
     this.sharing = new SharingAPI(rpc);
@@ -2788,6 +2944,7 @@ var NotebookLMClient = class _NotebookLMClient {
   research;
   settings;
   sharing;
+  refreshPromise = null;
   /**
    * Connect to NotebookLM using cookies.
    * Fetches CSRF and session tokens from the NotebookLM homepage.
@@ -2800,16 +2957,17 @@ var NotebookLMClient = class _NotebookLMClient {
    * Refresh CSRF and session tokens (e.g. if they expire mid-session).
    */
   async refreshTokens() {
-    const { fetchTokens: fetchTokens2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
-    const { csrfToken, sessionId } = await fetchTokens2(this.auth.cookies);
-    this.auth.csrfToken = csrfToken;
-    this.auth.sessionId = sessionId;
+    if (!this.refreshPromise) {
+      this.refreshPromise = refreshAuthTokens(this.auth).then(() => void 0).finally(() => {
+        this.refreshPromise = null;
+      });
+    }
+    await this.refreshPromise;
   }
 };
 
 // src/index.ts
 init_enums();
-init_errors();
 
 export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, ArtifactTypeCode, ArtifactsAPI, AudioFormat, AudioLength, AuthError, ChatAPI, ChatError, ChatGoal, ChatMode, ChatResponseLength, ClientError, DriveMimeType, ExportType, InfographicDetail, InfographicOrientation, InfographicStyle, NetworkError, NotebookError, NotebookLMClient, NotebookLMError, NotebookNotFoundError, NotebooksAPI, NotesAPI, QuizDifficulty, QuizQuantity, RPCError, RPCMethod, RPCTimeoutError, RateLimitError, ResearchAPI, ServerError, SettingsAPI, ShareAccess, SharePermission, ShareViewLevel, SharingAPI, SlideDeckFormat, SlideDeckLength, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError, SourcesAPI, VideoFormat, VideoStyle, connect };
 //# sourceMappingURL=index.js.map