@jackwener/opencli 1.7.22 → 1.8.1

package/clis/notebooklm/generate-slides.js

@@ -0,0 +1,106 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { callNotebooklmRpc } from './rpc.js';
+import { buildNotebooklmNotebookUrl, listNotebooklmSourcesViaRpc, parseNotebooklmNotebookTarget, requireNotebooklmExecute, requireNotebooklmSession } from './utils.js';
+
+const NOTEBOOKLM_CREATE_ARTIFACT_RPC_ID = 'R7cb6c';
+const SLIDE_DECK_CONFIG_BLOCK = [2, null, null, [1, null, null, null, null, null, null, null, null, null, [1]], [[1, 4, 2, 3, 6]]];
+const ARTIFACT_UUID_RE = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;
+
+function toExcludedUuidSet(excludedIds) {
+    return new Set(excludedIds.map((id) => String(id ?? '').toLowerCase()).filter(Boolean));
+}
+
+export function buildCreateSlidesArgs(projectId, sourceIds, options = {}) {
+    const sourceTuples = sourceIds.map((id) => [[id]]);
+    const language = options.language || 'en';
+    const length = Number.isInteger(options.length) ? options.length : 3;
+    return [
+        SLIDE_DECK_CONFIG_BLOCK,
+        projectId,
+        [
+            null,
+            null,
+            8,
+            sourceTuples,
+            null,
+            null,
+            null, null, null, null, null, null, null, null, null, null,
+            [[null, language, 1, length]],
+        ],
+    ];
+}
+
+export function parseSlidesIdFromResult(result, excludedIds = []) {
+    const excluded = toExcludedUuidSet(excludedIds);
+    if (typeof result === 'string' && ARTIFACT_UUID_RE.test(result) && !excluded.has(result.toLowerCase())) return result;
+    const stack = [result];
+    while (stack.length) {
+        const node = stack.shift();
+        if (typeof node === 'string' && ARTIFACT_UUID_RE.test(node) && !excluded.has(node.toLowerCase())) return node;
+        if (Array.isArray(node)) for (const child of node) stack.push(child);
+        else if (node && typeof node === 'object') for (const v of Object.values(node)) stack.push(v);
+    }
+    return '';
+}
+
+export function parseSlideDeckLength(value) {
+    if (value === undefined || value === '') return 3;
+    const length = Number(value);
+    if (!Number.isInteger(length) || length <= 0) {
+        throw new ArgumentError('--length must be a positive integer');
+    }
+    return length;
+}
+
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'generate-slides',
+    access: 'write',
+    description: 'Trigger a Slide Deck (AI presentation) generation for a NotebookLM notebook, using all of its sources',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        { name: 'notebook', positional: true, required: true, help: 'Notebook id from `notebooklm list` or full notebook URL' },
+        { name: 'length', help: 'Slide deck length: 1=Short, 3=Default (default 3)' },
+        { name: 'language', help: 'Language code (default en)' },
+        { name: 'execute', type: 'boolean', help: 'Actually trigger remote NotebookLM slide deck generation' },
+    ],
+    columns: ['notebook_id', 'slides_id', 'source_count', 'status', 'notebook_url'],
+    func: async (page, kwargs) => {
+        const notebookId = parseNotebooklmNotebookTarget(String(kwargs.notebook ?? ''));
+        const length = parseSlideDeckLength(kwargs.length);
+        const language = String(kwargs.language ?? 'en').trim() || 'en';
+        requireNotebooklmExecute(kwargs.execute, 'generate NotebookLM slides');
+        try {
+            await page.goto(buildNotebooklmNotebookUrl(notebookId));
+            await page.wait(2);
+        }
+        catch (error) {
+            throw new CommandExecutionError(`Failed to open NotebookLM notebook ${notebookId}: ${error?.message || error}`);
+        }
+        await requireNotebooklmSession(page);
+        const sources = await listNotebooklmSourcesViaRpc(page);
+        const sourceIds = sources.map((s) => s.id).filter((id) => typeof id === 'string' && id);
+        if (sourceIds.length === 0) {
+            throw new EmptyResultError('notebooklm generate-slides', 'The notebook has no sources; add a source before generating a slide deck.');
+        }
+        const rpc = await callNotebooklmRpc(page, NOTEBOOKLM_CREATE_ARTIFACT_RPC_ID, buildCreateSlidesArgs(notebookId, sourceIds, { length, language }));
+        const slidesId = parseSlidesIdFromResult(rpc.result, [notebookId, ...sourceIds]);
+        if (!slidesId) {
+            throw new CommandExecutionError('NotebookLM CreateArtifact (slides) RPC returned no slide-deck id; the server may have rejected the request.');
+        }
+        return [{
+            notebook_id: notebookId,
+            slides_id: slidesId,
+            source_count: sourceIds.length,
+            status: 'pending',
+            notebook_url: buildNotebooklmNotebookUrl(notebookId),
+        }];
+    },
+});
+
+export const __test__ = { SLIDE_DECK_CONFIG_BLOCK, buildCreateSlidesArgs, parseSlideDeckLength, parseSlidesIdFromResult };

package/clis/notebooklm/generate-slides.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ArgumentError } from '@jackwener/opencli/errors';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { __test__ } from './generate-slides.js';
+
+const { SLIDE_DECK_CONFIG_BLOCK, buildCreateSlidesArgs, parseSlideDeckLength, parseSlidesIdFromResult } = __test__;
+
+describe('notebooklm generate-slides', () => {
+    it('SLIDE_DECK_CONFIG_BLOCK reuses the same R7cb6c config envelope as audio', () => {
+        expect(SLIDE_DECK_CONFIG_BLOCK).toEqual([
+            2, null, null,
+            [1, null, null, null, null, null, null, null, null, null, [1]],
+            [[1, 4, 2, 3, 6]],
+        ]);
+    });
+
+    it('buildCreateSlidesArgs matches the live-captured slide-deck wire format', () => {
+        const projectId = '17e2b882-6a01-4c6c-9262-0738dfa2abee';
+        const sourceA = '493b9ddd-453b-4523-b638-bb560b37723c';
+        const sourceB = '182508cf-9afd-4db5-8640-2f8cafcc7111';
+        expect(buildCreateSlidesArgs(projectId, [sourceA, sourceB])).toEqual([
+            [2, null, null, [1, null, null, null, null, null, null, null, null, null, [1]], [[1, 4, 2, 3, 6]]],
+            projectId,
+            [
+                null, null, 8,
+                [[[sourceA]], [[sourceB]]],
+                null, null,
+                null, null, null, null, null, null, null, null, null, null,
+                [[null, 'en', 1, 3]],
+            ],
+        ]);
+    });
+
+    it('buildCreateSlidesArgs honours --language and --length overrides', () => {
+        const args = buildCreateSlidesArgs('pid', ['s1'], { language: 'zh', length: 1 });
+        expect(args[2][16]).toEqual([[null, 'zh', 1, 1]]);
+    });
+
+    it('parseSlideDeckLength defaults empty values and rejects invalid input', () => {
+        expect(parseSlideDeckLength(undefined)).toBe(3);
+        expect(parseSlideDeckLength('')).toBe(3);
+        expect(parseSlideDeckLength('1')).toBe(1);
+        expect(() => parseSlideDeckLength('many')).toThrow(ArgumentError);
+        expect(() => parseSlideDeckLength(0)).toThrow(ArgumentError);
+    });
+
+    it('parseSlidesIdFromResult finds a UUID-shaped slides id anywhere in the tree', () => {
+        const id = '1f8ada7d-cb33-49a4-8498-c5b81c1a899d';
+        expect(parseSlidesIdFromResult([[id, 'opencli-slides-test']])).toBe(id);
+        expect(parseSlidesIdFromResult({ artifactId: id })).toBe(id);
+    });
+
+    it('parseSlidesIdFromResult ignores non-UUID strings and empty inputs', () => {
+        expect(parseSlidesIdFromResult([[null, 'opencli-slides-test']])).toBe('');
+        expect(parseSlidesIdFromResult({})).toBe('');
+        expect(parseSlidesIdFromResult([])).toBe('');
+        expect(parseSlidesIdFromResult(null)).toBe('');
+    });
+
+    it('parseSlidesIdFromResult skips notebook/source ids before selecting the generated deck id', () => {
+        const notebookId = '17e2b882-6a01-4c6c-9262-0738dfa2abee';
+        const sourceId = '493b9ddd-453b-4523-b638-bb560b37723c';
+        const slidesId = '1f8ada7d-cb33-49a4-8498-c5b81c1a899d';
+        expect(parseSlidesIdFromResult([notebookId, [[sourceId]], [slidesId]], [notebookId, sourceId])).toBe(slidesId);
+    });
+
+    it('refuses to trigger remote slide generation without --execute', async () => {
+        const command = getRegistry().get('notebooklm/generate-slides');
+        const page = { goto: vi.fn() };
+        await expect(command.func(page, {
+            notebook: '17e2b882-6a01-4c6c-9262-0738dfa2abee',
+        })).rejects.toThrow(ArgumentError);
+        expect(page.goto).not.toHaveBeenCalled();
+    });
+});

package/clis/notebooklm/open.test.js

@@ -23,18 +23,18 @@ describe('notebooklm open', () => {
         mockRequireNotebooklmSession.mockReset();
         mockRequireNotebooklmSession.mockResolvedValue(undefined);
         mockGetNotebooklmPageState.mockResolvedValue({
-            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            url: 'https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345',
             title: 'Browser Automation',
             hostname: 'notebooklm.google.com',
             kind: 'notebook',
-            notebookId: 'nb-demo',
+            notebookId: '17e2b882-1234-1234-1234-abcdef012345',
             loginRequired: false,
             notebookCount: 1,
         });
         mockReadCurrentNotebooklm.mockResolvedValue({
-            id: 'nb-demo',
+            id: '17e2b882-1234-1234-1234-abcdef012345',
             title: 'Browser Automation',
-            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            url: 'https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345',
             source: 'current-page',
         });
     });
@@ -43,12 +43,12 @@ describe('notebooklm open', () => {
             goto: vi.fn(async () => { }),
             wait: vi.fn(async () => { }),
         };
-        const result = await command.func(page, { notebook: 'nb-demo' });
-        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+        const result = await command.func(page, { notebook: '17e2b882-1234-1234-1234-abcdef012345' });
+        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345');
         expect(result).toEqual([{
-                id: 'nb-demo',
+                id: '17e2b882-1234-1234-1234-abcdef012345',
                 title: 'Browser Automation',
-                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                url: 'https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345',
                 source: 'current-page',
             }]);
     });
@@ -57,7 +57,7 @@ describe('notebooklm open', () => {
             goto: vi.fn(async () => { }),
             wait: vi.fn(async () => { }),
         };
-        await command.func(page, { notebook: 'https://notebooklm.google.com/notebook/nb-demo?pli=1' });
-        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+        await command.func(page, { notebook: 'https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345?pli=1' });
+        expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/17e2b882-1234-1234-1234-abcdef012345');
     });
 });

package/clis/notebooklm/rpc.js

@@ -1,5 +1,13 @@
 import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
 import { NOTEBOOKLM_DOMAIN } from './shared.js';
+
+export function unwrapNotebooklmEvaluateResult(payload) {
+    if (payload && typeof payload === 'object' && !Array.isArray(payload) && 'session' in payload && 'data' in payload) {
+        return payload.data;
+    }
+    return payload;
+}
+
 export function extractNotebooklmPageAuthFromHtml(html, sourcePath = '/', preferredTokens) {
     const csrfMatch = html.match(/"SNlM0e":"([^"]+)"/);
     const sessionMatch = html.match(/"FdrFJe":"([^"]+)"/);
@@ -8,26 +16,30 @@ export function extractNotebooklmPageAuthFromHtml(html, sourcePath = '/', prefer
     if (!csrfToken || !sessionId) {
         throw new CliError('NOTEBOOKLM_TOKENS', 'NotebookLM page tokens were not found in the current page HTML', 'Open the NotebookLM notebook page in Chrome, wait for it to finish loading, then retry with --verbose if it still fails.');
     }
-    return { csrfToken, sessionId, sourcePath: sourcePath || '/' };
+    return { csrfToken, sessionId, sourcePath: sourcePath || '/', authuser: preferredTokens?.authuser ?? '' };
 }
 async function probeNotebooklmPageAuth(page) {
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const wiz = window.WIZ_global_data || {};
     const html = document.documentElement.innerHTML;
+    const authMatch = (location.search || '').match(/[?&]authuser=(\\d+)/);
+    const pathMatch = (location.pathname || '').match(/^\\/u\\/(\\d+)\\//);
     return {
       html,
       sourcePath: location.pathname || '/',
       readyState: document.readyState || '',
       csrfToken: typeof wiz.SNlM0e === 'string' ? wiz.SNlM0e : '',
       sessionId: typeof wiz.FdrFJe === 'string' ? wiz.FdrFJe : '',
+      authuser: authMatch ? authMatch[1] : (pathMatch ? pathMatch[1] : ''),
     };
-  })()`);
+  })()`));
     return {
         html: String(raw?.html ?? ''),
         sourcePath: String(raw?.sourcePath ?? '/'),
         readyState: String(raw?.readyState ?? ''),
         csrfToken: String(raw?.csrfToken ?? ''),
         sessionId: String(raw?.sessionId ?? ''),
+        authuser: String(raw?.authuser ?? ''),
     };
 }
 export async function getNotebooklmPageAuth(page) {
@@ -35,7 +47,7 @@ export async function getNotebooklmPageAuth(page) {
     for (let attempt = 0; attempt < 2; attempt += 1) {
         const probe = await probeNotebooklmPageAuth(page);
         try {
-            return extractNotebooklmPageAuthFromHtml(probe.html, probe.sourcePath, { csrfToken: probe.csrfToken, sessionId: probe.sessionId });
+            return extractNotebooklmPageAuthFromHtml(probe.html, probe.sourcePath, { csrfToken: probe.csrfToken, sessionId: probe.sessionId, authuser: probe.authuser });
         }
         catch (error) {
             lastError = error;
@@ -130,7 +142,7 @@ export async function fetchNotebooklmInPage(page, url, options = {}) {
     const method = options.method ?? 'GET';
     const headers = options.headers ?? {};
     const body = options.body ?? '';
-    const raw = await page.evaluate(`(async () => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(async () => {
     const request = {
       url: ${JSON.stringify(url)},
       method: ${JSON.stringify(method)},
@@ -151,7 +163,7 @@ export async function fetchNotebooklmInPage(page, url, options = {}) {
       body: await response.text(),
       finalUrl: response.url,
     };
-  })()`);
+  })()`));
     return {
         ok: Boolean(raw?.ok),
         status: Number(raw?.status ?? 0),
@@ -162,8 +174,10 @@ export async function fetchNotebooklmInPage(page, url, options = {}) {
 export async function callNotebooklmRpc(page, rpcId, params, options = {}) {
     const auth = await getNotebooklmPageAuth(page);
     const requestBody = buildNotebooklmRpcBody(rpcId, params, auth.csrfToken);
+    const authuser = auth.authuser || '';
     const url = `https://${NOTEBOOKLM_DOMAIN}/_/LabsTailwindUi/data/batchexecute` +
         `?rpcids=${rpcId}&source-path=${encodeURIComponent(auth.sourcePath)}` +
+        (authuser ? `&authuser=${encodeURIComponent(authuser)}` : '') +
         `&hl=${encodeURIComponent(options.hl ?? 'en')}` +
         `&f.sid=${encodeURIComponent(auth.sessionId)}&rt=c`;
     const response = await fetchNotebooklmInPage(page, url, {

package/clis/notebooklm/rpc.test.js

@@ -1,7 +1,13 @@
 import { describe, expect, it, vi } from 'vitest';
 import { AuthRequiredError } from '@jackwener/opencli/errors';
-import { buildNotebooklmRpcBody, extractNotebooklmRpcResult, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, } from './rpc.js';
+import { buildNotebooklmRpcBody, extractNotebooklmRpcResult, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, unwrapNotebooklmEvaluateResult, } from './rpc.js';
 describe('notebooklm rpc transport', () => {
+    it('unwraps Browser Bridge evaluate envelopes', () => {
+        const data = { ok: true };
+        expect(unwrapNotebooklmEvaluateResult({ session: 'site:notebooklm:abc', data })).toBe(data);
+        expect(unwrapNotebooklmEvaluateResult(data)).toBe(data);
+    });
+
     it('extracts auth tokens from the page html via page evaluation', async () => {
         const page = {
             evaluate: vi.fn(async (script) => {
@@ -16,9 +22,27 @@ describe('notebooklm rpc transport', () => {
             csrfToken: 'csrf-123',
             sessionId: 'sess-456',
             sourcePath: '/',
+            authuser: '',
         });
         expect(page.evaluate).toHaveBeenCalledTimes(1);
     });
+    it('extracts auth tokens when page evaluation is wrapped in a Browser Bridge envelope', async () => {
+        const page = {
+            evaluate: vi.fn(async () => ({
+                session: 'site:notebooklm:abc',
+                data: {
+                    html: '<html>"SNlM0e":"csrf-123","FdrFJe":"sess-456"</html>',
+                    sourcePath: '/notebook/nb-demo',
+                },
+            })),
+        };
+        await expect(getNotebooklmPageAuth(page)).resolves.toEqual({
+            csrfToken: 'csrf-123',
+            sessionId: 'sess-456',
+            sourcePath: '/notebook/nb-demo',
+            authuser: '',
+        });
+    });
     it('falls back to WIZ_global_data tokens when html regex data is missing', async () => {
         const page = {
             evaluate: vi.fn(async () => ({
@@ -33,6 +57,7 @@ describe('notebooklm rpc transport', () => {
             csrfToken: 'csrf-wiz',
             sessionId: 'sess-wiz',
             sourcePath: '/notebook/nb-demo',
+            authuser: '',
         });
     });
     it('retries token extraction once when the first probe returns no tokens', async () => {
@@ -58,6 +83,7 @@ describe('notebooklm rpc transport', () => {
             csrfToken: 'csrf-123',
             sessionId: 'sess-456',
             sourcePath: '/notebook/nb-demo',
+            authuser: '',
         });
         expect(page.evaluate).toHaveBeenCalledTimes(2);
     });

package/clis/notebooklm/utils.js

@@ -1,6 +1,6 @@
-import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
+import { ArgumentError, AuthRequiredError, CliError, CommandExecutionError } from '@jackwener/opencli/errors';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, } from './shared.js';
-import { callNotebooklmRpc, getNotebooklmPageAuth, } from './rpc.js';
+import { callNotebooklmRpc, getNotebooklmPageAuth, unwrapNotebooklmEvaluateResult, } from './rpc.js';
 export { buildNotebooklmRpcBody, extractNotebooklmRpcResult, fetchNotebooklmInPage, getNotebooklmPageAuth, parseNotebooklmChunkedResponse, stripNotebooklmAntiXssi, } from './rpc.js';
 const NOTEBOOKLM_LIST_RPC_ID = 'wXbhsf';
 const NOTEBOOKLM_NOTEBOOK_DETAIL_RPC_ID = 'rLM1Ne';
@@ -13,28 +13,61 @@ function unwrapNotebooklmSingletonResult(result) {
     }
     return current;
 }
+export function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
 export function parseNotebooklmIdFromUrl(url) {
     const match = url.match(/\/notebook\/([^/?#]+)/);
     return match?.[1] ?? '';
 }
+const NOTEBOOK_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function ensureNotebookUuid(candidate) {
+    if (!NOTEBOOK_UUID_RE.test(candidate)) {
+        throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', `NotebookLM notebook id "${candidate}" is not a valid UUID`, 'Pass a notebook id from `opencli notebooklm list` or a full notebook URL like https://notebooklm.google.com/notebook/<uuid>.');
+    }
+    return candidate;
+}
 export function parseNotebooklmNotebookTarget(value) {
     const normalized = value.trim();
     if (!normalized) {
         throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook id is required', 'Pass a notebook id from `opencli notebooklm list` or a full notebook URL.');
     }
     if (/^https?:\/\//i.test(normalized)) {
+        let parsed;
+        try {
+            parsed = new URL(normalized);
+        }
+        catch {
+            throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook URL is invalid', 'Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.');
+        }
+        if (parsed.protocol !== 'https:' || parsed.hostname !== NOTEBOOKLM_DOMAIN || parsed.username || parsed.password || parsed.port) {
+            throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook URL must be a canonical https://notebooklm.google.com URL', 'Pass a notebook id from `opencli notebooklm list` or a full NotebookLM notebook URL.');
+        }
         const notebookId = parseNotebooklmIdFromUrl(normalized);
-        if (notebookId)
-            return notebookId;
-        throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook URL is invalid', 'Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<id>.');
+        if (!notebookId) {
+            throw new CliError('NOTEBOOKLM_INVALID_NOTEBOOK', 'NotebookLM notebook URL is invalid', 'Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.');
+        }
+        return ensureNotebookUuid(notebookId);
     }
     const pathMatch = normalized.match(/(?:^|\/)notebook\/([^/?#]+)/);
     if (pathMatch?.[1])
-        return pathMatch[1];
-    return normalized;
+        return ensureNotebookUuid(pathMatch[1]);
+    return ensureNotebookUuid(normalized);
+}
+export function getNotebooklmAuthuser() {
+    const v = process.env.OPENCLI_NOTEBOOKLM_AUTHUSER;
+    return typeof v === 'string' && /^\d+$/.test(v) ? v : '';
+}
+export function requireNotebooklmExecute(value, action) {
+    if (value !== true) {
+        throw new ArgumentError(`Refusing to ${action}: pass --execute to perform this NotebookLM write`);
+    }
 }
 export function buildNotebooklmNotebookUrl(notebookId) {
-    return new URL(`/notebook/${encodeURIComponent(notebookId)}`, NOTEBOOKLM_HOME_URL).toString();
+    const u = new URL(`/notebook/${encodeURIComponent(notebookId)}`, NOTEBOOKLM_HOME_URL);
+    const authuser = getNotebooklmAuthuser();
+    if (authuser) u.searchParams.set('authuser', authuser);
+    return u.toString();
 }
 export function classifyNotebooklmPage(url) {
     try {
@@ -401,6 +434,42 @@ export async function getNotebooklmDetailViaRpc(page) {
     const rpc = await callNotebooklmRpc(page, NOTEBOOKLM_NOTEBOOK_DETAIL_RPC_ID, [state.notebookId, null, [2], null, 0]);
     return parseNotebooklmNotebookDetailResult(rpc.result);
 }
+export async function getNotebooklmNotebookDetailById(page, notebookId) {
+    const rpc = await callNotebooklmRpc(page, NOTEBOOKLM_NOTEBOOK_DETAIL_RPC_ID, [notebookId, null, [2], null, 0]);
+    return { detail: parseNotebooklmNotebookDetailResult(rpc.result), sources: parseNotebooklmSourceListResult(rpc.result) };
+}
+export async function verifyNotebooklmNotebookExists(page, notebookId, action) {
+    try {
+        const { detail } = await getNotebooklmNotebookDetailById(page, notebookId);
+        if (!detail || detail.id !== notebookId) {
+            throw new CommandExecutionError(`NotebookLM ${action} succeeded but the notebook ${notebookId} was not found in the post-write verification`);
+        }
+        return detail;
+    }
+    catch (error) {
+        if (error instanceof AuthRequiredError || error instanceof CommandExecutionError)
+            throw error;
+        throw new CommandExecutionError(`NotebookLM ${action} post-write verification failed: ${error?.message || error}`);
+    }
+}
+export async function verifyNotebooklmSourceAdded(page, notebookId, sourceId, action) {
+    try {
+        const { detail, sources } = await getNotebooklmNotebookDetailById(page, notebookId);
+        if (!detail || detail.id !== notebookId) {
+            throw new CommandExecutionError(`NotebookLM ${action} succeeded but the notebook ${notebookId} was not found in the post-write verification`);
+        }
+        const matched = sources.find((s) => s.id === sourceId);
+        if (!matched) {
+            throw new CommandExecutionError(`NotebookLM ${action} succeeded but source ${sourceId} did not appear in the notebook's source list`);
+        }
+        return matched;
+    }
+    catch (error) {
+        if (error instanceof AuthRequiredError || error instanceof CommandExecutionError)
+            throw error;
+        throw new CommandExecutionError(`NotebookLM ${action} post-write verification failed: ${error?.message || error}`);
+    }
+}
 export async function listNotebooklmSourcesViaRpc(page) {
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook' || !state.notebookId)
@@ -434,7 +503,7 @@ export async function listNotebooklmNotesFromPage(page) {
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook' || !state.notebookId)
         return [];
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     return Array.from(document.querySelectorAll('artifact-library-note')).map((node) => {
       const titleNode = node.querySelector('.artifact-title');
       return {
@@ -442,7 +511,7 @@ export async function listNotebooklmNotesFromPage(page) {
         text: (node.innerText || node.textContent || '').replace(/\\s+/g, ' ').trim(),
       };
     });
-  })()`);
+  })()`));
     if (!Array.isArray(raw) || raw.length === 0)
         return [];
     return parseNotebooklmNoteListRawRows(raw, state.notebookId, state.url || `https://${NOTEBOOKLM_DOMAIN}/notebook/${state.notebookId}`);
@@ -451,13 +520,13 @@ export async function readNotebooklmSummaryFromPage(page) {
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook' || !state.notebookId)
         return null;
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
     const title = normalize(document.querySelector('.notebook-title, h1, [data-testid="notebook-title"]')?.textContent || document.title || '');
     const summaryNode = document.querySelector('.notebook-summary, .summary-content, [class*="summary"]');
     const summary = normalize(summaryNode?.textContent || '');
     return { title, summary };
-  })()`);
+  })()`));
     return parseNotebooklmSummaryRawRow(raw, state.notebookId, state.url || `https://${NOTEBOOKLM_DOMAIN}/notebook/${state.notebookId}`);
 }
 export async function getNotebooklmSummaryViaRpc(page) {
@@ -499,7 +568,7 @@ export async function readNotebooklmVisibleNoteFromPage(page) {
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook' || !state.notebookId)
         return null;
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const normalizeText = (value) => (value || '').replace(/\\u00a0/g, ' ').replace(/\\r\\n/g, '\\n').trim();
     const titleNode = document.querySelector('.note-header__editable-title');
     const title = titleNode instanceof HTMLInputElement || titleNode instanceof HTMLTextAreaElement
@@ -516,7 +585,7 @@ export async function readNotebooklmVisibleNoteFromPage(page) {
       title: normalizeText(title),
       content: normalizeText(content),
     };
-  })()`);
+  })()`));
     return parseNotebooklmVisibleNoteRawRow(raw, state.notebookId, state.url || `https://${NOTEBOOKLM_DOMAIN}/notebook/${state.notebookId}`);
 }
 export async function ensureNotebooklmHome(page) {
@@ -526,11 +595,18 @@ export async function ensureNotebooklmHome(page) {
     const currentKind = currentUrl ? classifyNotebooklmPage(currentUrl) : 'unknown';
     if (currentKind === 'home')
         return;
-    await page.goto(NOTEBOOKLM_HOME_URL);
-    await page.wait(2);
+    const authuser = getNotebooklmAuthuser();
+    const target = authuser ? `${NOTEBOOKLM_HOME_URL}?authuser=${encodeURIComponent(authuser)}` : NOTEBOOKLM_HOME_URL;
+    try {
+        await page.goto(target);
+        await page.wait(2);
+    }
+    catch (error) {
+        throw new CommandExecutionError(`Failed to open NotebookLM home: ${error?.message || error}`);
+    }
 }
 export async function getNotebooklmPageState(page) {
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const url = window.location.href;
     const title = document.title || '';
     const hostname = window.location.hostname || '';
@@ -557,7 +633,7 @@ export async function getNotebooklmPageState(page) {
       .reduce((count, href, index, list) => list.indexOf(href) === index ? count + 1 : count, 0);
 
     return { url, title, hostname, kind, notebookId, loginRequired, notebookCount, path };
-  })()`);
+  })()`));
     const state = {
         url: String(raw?.url ?? ''),
         title: normalizeNotebooklmTitle(raw?.title, 'NotebookLM'),
@@ -582,7 +658,7 @@ export async function getNotebooklmPageState(page) {
     return state;
 }
 export async function readCurrentNotebooklm(page) {
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const url = window.location.href;
     const match = url.match(/\\/notebook\\/([^/?#]+)/);
     if (!match) return null;
@@ -595,7 +671,7 @@ export async function readCurrentNotebooklm(page) {
       url,
       source: 'current-page',
     };
-  })()`);
+  })()`));
     if (!raw)
         return null;
     return {
@@ -608,7 +684,7 @@ export async function readCurrentNotebooklm(page) {
     };
 }
 export async function listNotebooklmLinks(page) {
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const rows = [];
     const seen = new Set();
 
@@ -656,7 +732,7 @@ export async function listNotebooklmLinks(page) {
     }
 
     return rows;
-  })()`);
+  })()`));
     if (!Array.isArray(raw))
         return [];
     return raw
@@ -671,7 +747,7 @@ export async function listNotebooklmLinks(page) {
         .filter((row) => row.id && row.url);
 }
 export async function listNotebooklmSourcesFromPage(page) {
-    const raw = await page.evaluate(`(() => {
+    const raw = unwrapNotebooklmEvaluateResult(await page.evaluate(`(() => {
     const notebookMatch = window.location.href.match(/\\/notebook\\/([^/?#]+)/);
     const notebookId = notebookMatch ? notebookMatch[1] : '';
     if (!notebookId) return [];
@@ -721,7 +797,7 @@ export async function listNotebooklmSourcesFromPage(page) {
       });
     }
     return rows;
-  })()`);
+  })()`));
     if (!Array.isArray(raw))
         return [];
     return raw.filter((row) => row.id && row.title);