@jackwener/opencli 1.5.5 → 1.5.7

package/dist/clis/notebooklm/bind-current.js

@@ -0,0 +1,29 @@
+import { cli, Strategy } from '../../registry.js';
+import { bindCurrentTab } from '../../browser/daemon-client.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { parseNotebooklmIdFromUrl } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'bind-current',
+    aliases: ['use'],
+    description: 'Bind the current active NotebookLM notebook tab into the site:notebooklm workspace',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['workspace', 'tab_id', 'notebook_id', 'title', 'url'],
+    func: async () => {
+        const result = await bindCurrentTab(`site:${NOTEBOOKLM_SITE}`, {
+            matchDomain: NOTEBOOKLM_DOMAIN,
+            matchPathPrefix: '/notebook/',
+        });
+        return [{
+                workspace: result.workspace ?? `site:${NOTEBOOKLM_SITE}`,
+                tab_id: result.tabId ?? null,
+                notebook_id: result.url ? parseNotebooklmIdFromUrl(result.url) : '',
+                title: result.title ?? '',
+                url: result.url ?? '',
+            }];
+    },
+});

package/dist/clis/notebooklm/bind-current.test.d.ts

@@ -0,0 +1 @@
+import './bind-current.js';

package/dist/clis/notebooklm/bind-current.test.js

@@ -0,0 +1,35 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockBindCurrentTab } = vi.hoisted(() => ({
+    mockBindCurrentTab: vi.fn(),
+}));
+vi.mock('../../browser/daemon-client.js', () => ({
+    bindCurrentTab: mockBindCurrentTab,
+}));
+import { getRegistry } from '../../registry.js';
+import './bind-current.js';
+describe('notebooklm bind-current', () => {
+    const command = getRegistry().get('notebooklm/bind-current');
+    beforeEach(() => {
+        mockBindCurrentTab.mockReset();
+    });
+    it('binds the current notebook tab into site:notebooklm', async () => {
+        mockBindCurrentTab.mockResolvedValue({
+            workspace: 'site:notebooklm',
+            tabId: 123,
+            title: 'Bound Notebook',
+            url: 'https://notebooklm.google.com/notebook/nb-live',
+        });
+        const result = await command.func({}, {});
+        expect(mockBindCurrentTab).toHaveBeenCalledWith('site:notebooklm', {
+            matchDomain: 'notebooklm.google.com',
+            matchPathPrefix: '/notebook/',
+        });
+        expect(result).toEqual([{
+                workspace: 'site:notebooklm',
+                tab_id: 123,
+                notebook_id: 'nb-live',
+                title: 'Bound Notebook',
+                url: 'https://notebooklm.google.com/notebook/nb-live',
+            }]);
+    });
+});

package/dist/clis/notebooklm/binding.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/binding.test.js

@@ -0,0 +1,44 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockBindCurrentTab } = vi.hoisted(() => ({
+    mockBindCurrentTab: vi.fn(),
+}));
+vi.mock('../../browser/daemon-client.js', () => ({
+    bindCurrentTab: mockBindCurrentTab,
+}));
+import { ensureNotebooklmNotebookBinding } from './utils.js';
+describe('notebooklm automatic binding', () => {
+    const originalEndpoint = process.env.OPENCLI_CDP_ENDPOINT;
+    beforeEach(() => {
+        mockBindCurrentTab.mockReset();
+        if (originalEndpoint === undefined)
+            delete process.env.OPENCLI_CDP_ENDPOINT;
+        else
+            process.env.OPENCLI_CDP_ENDPOINT = originalEndpoint;
+    });
+    it('does nothing when the current page is already a notebook page', async () => {
+        const page = {
+            getCurrentUrl: async () => 'https://notebooklm.google.com/notebook/nb-demo',
+        };
+        await expect(ensureNotebooklmNotebookBinding(page)).resolves.toBe(false);
+        expect(mockBindCurrentTab).not.toHaveBeenCalled();
+    });
+    it('best-effort binds a notebook page through the browser bridge when currently on home', async () => {
+        const page = {
+            getCurrentUrl: async () => 'https://notebooklm.google.com/',
+        };
+        mockBindCurrentTab.mockResolvedValue({});
+        await expect(ensureNotebooklmNotebookBinding(page)).resolves.toBe(true);
+        expect(mockBindCurrentTab).toHaveBeenCalledWith('site:notebooklm', {
+            matchDomain: 'notebooklm.google.com',
+            matchPathPrefix: '/notebook/',
+        });
+    });
+    it('skips daemon binding in direct CDP mode', async () => {
+        process.env.OPENCLI_CDP_ENDPOINT = 'ws://127.0.0.1:9222/devtools/page/1';
+        const page = {
+            getCurrentUrl: async () => 'https://notebooklm.google.com/',
+        };
+        await expect(ensureNotebooklmNotebookBinding(page)).resolves.toBe(false);
+        expect(mockBindCurrentTab).not.toHaveBeenCalled();
+    });
+});

package/dist/clis/notebooklm/compat.test.d.ts

@@ -0,0 +1,3 @@
+import './bind-current.js';
+import './get.js';
+import './note-list.js';

package/dist/clis/notebooklm/compat.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './bind-current.js';
+import './get.js';
+import './note-list.js';
+describe('notebooklm compatibility aliases', () => {
+    it('registers use as a compatibility alias for bind-current', () => {
+        expect(getRegistry().get('notebooklm/use')).toBe(getRegistry().get('notebooklm/bind-current'));
+    });
+    it('registers metadata as a compatibility alias for get', () => {
+        expect(getRegistry().get('notebooklm/metadata')).toBe(getRegistry().get('notebooklm/get'));
+    });
+    it('registers notes-list as a compatibility alias for note-list', () => {
+        expect(getRegistry().get('notebooklm/notes-list')).toBe(getRegistry().get('notebooklm/note-list'));
+    });
+});

package/dist/clis/notebooklm/current.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/current.js

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, readCurrentNotebooklm, requireNotebooklmSession } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'current',
+    description: 'Show metadata for the currently opened NotebookLM notebook tab',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['id', 'title', 'url', 'source'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm current', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const current = await readCurrentNotebooklm(page);
+        if (!current) {
+            throw new EmptyResultError('opencli notebooklm current', 'NotebookLM notebook metadata was not found on the current page.');
+        }
+        return [current];
+    },
+});

package/dist/clis/notebooklm/get.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/get.js

@@ -0,0 +1,37 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmDetailViaRpc, getNotebooklmPageState, readCurrentNotebooklm, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'get',
+    aliases: ['metadata'],
+    description: 'Get rich metadata for the currently opened NotebookLM notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['id', 'title', 'emoji', 'source_count', 'created_at', 'updated_at', 'url', 'source'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm get', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const rpcRow = await getNotebooklmDetailViaRpc(page).catch(() => null);
+        if (rpcRow)
+            return [rpcRow];
+        const current = await readCurrentNotebooklm(page);
+        if (!current) {
+            throw new EmptyResultError('opencli notebooklm get', 'NotebookLM notebook metadata was not found on the current page.');
+        }
+        return [{
+                ...current,
+                emoji: null,
+                source_count: null,
+                updated_at: null,
+            }];
+    },
+});

package/dist/clis/notebooklm/history.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/history.js

@@ -0,0 +1,25 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, listNotebooklmHistoryViaRpc, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'history',
+    description: 'List NotebookLM conversation history threads in the current notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['thread_id', 'item_count', 'preview', 'source', 'notebook_id', 'url'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm history', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const rows = await listNotebooklmHistoryViaRpc(page);
+        return rows;
+    },
+});

package/dist/clis/notebooklm/history.test.d.ts

@@ -0,0 +1 @@
+import './history.js';

package/dist/clis/notebooklm/history.test.js

@@ -0,0 +1,58 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockListNotebooklmHistoryViaRpc, mockGetNotebooklmPageState, mockRequireNotebooklmSession, } = vi.hoisted(() => ({
+    mockListNotebooklmHistoryViaRpc: vi.fn(),
+    mockGetNotebooklmPageState: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        listNotebooklmHistoryViaRpc: mockListNotebooklmHistoryViaRpc,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './history.js';
+describe('notebooklm history', () => {
+    const history = getRegistry().get('notebooklm/history');
+    beforeEach(() => {
+        mockListNotebooklmHistoryViaRpc.mockReset();
+        mockGetNotebooklmPageState.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+    });
+    it('lists notebook history threads from the browser rpc', async () => {
+        mockListNotebooklmHistoryViaRpc.mockResolvedValue([
+            {
+                notebook_id: 'nb-demo',
+                thread_id: '28e0f2cb-4591-45a3-a661-7653666f7c78',
+                item_count: 0,
+                preview: 'Summarize this notebook',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+        const result = await history.func({}, {});
+        expect(result).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                thread_id: '28e0f2cb-4591-45a3-a661-7653666f7c78',
+                item_count: 0,
+                preview: 'Summarize this notebook',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+    });
+});

package/dist/clis/notebooklm/list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/list.js

@@ -0,0 +1,35 @@
+import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmHome, listNotebooklmLinks, listNotebooklmViaRpc, readCurrentNotebooklm, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'list',
+    description: 'List NotebookLM notebooks via in-page batchexecute RPC in the current logged-in session',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['title', 'id', 'is_owner', 'created_at', 'source', 'url'],
+    func: async (page) => {
+        const currentFallback = await readCurrentNotebooklm(page).catch(() => null);
+        await ensureNotebooklmHome(page);
+        await requireNotebooklmSession(page);
+        try {
+            const rpcRows = await listNotebooklmViaRpc(page);
+            if (rpcRows.length > 0)
+                return rpcRows;
+        }
+        catch (error) {
+            if (error instanceof AuthRequiredError)
+                throw error;
+        }
+        const domRows = await listNotebooklmLinks(page);
+        if (domRows.length > 0)
+            return domRows;
+        if (currentFallback)
+            return [currentFallback];
+        return [];
+    },
+});

package/dist/clis/notebooklm/note-list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/note-list.js

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, getNotebooklmPageState, listNotebooklmNotesFromPage, requireNotebooklmSession, } from './utils.js';
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'note-list',
+    aliases: ['notes-list'],
+    description: 'List saved notes from the Studio panel of the current NotebookLM notebook',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['title', 'created_at', 'source', 'url'],
+    func: async (page) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm note-list', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const rows = await listNotebooklmNotesFromPage(page);
+        if (rows.length > 0)
+            return rows;
+        throw new EmptyResultError('opencli notebooklm note-list', 'No NotebookLM notes are visible in the Studio panel. Reload the notebook page or close the note editor and retry.');
+    },
+});

package/dist/clis/notebooklm/note-list.test.d.ts

@@ -0,0 +1 @@
+import './note-list.js';

package/dist/clis/notebooklm/note-list.test.js

@@ -0,0 +1,56 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockListNotebooklmNotesFromPage, mockGetNotebooklmPageState, mockRequireNotebooklmSession } = vi.hoisted(() => ({
+    mockListNotebooklmNotesFromPage: vi.fn(),
+    mockGetNotebooklmPageState: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        listNotebooklmNotesFromPage: mockListNotebooklmNotesFromPage,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './note-list.js';
+describe('notebooklm note-list', () => {
+    const command = getRegistry().get('notebooklm/note-list');
+    beforeEach(() => {
+        mockListNotebooklmNotesFromPage.mockReset();
+        mockGetNotebooklmPageState.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+    });
+    it('lists notebook notes from the Studio panel', async () => {
+        mockListNotebooklmNotesFromPage.mockResolvedValue([
+            {
+                notebook_id: 'nb-demo',
+                title: '新建笔记',
+                created_at: '6 分钟前',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'studio-list',
+            },
+        ]);
+        const result = await command.func({}, {});
+        expect(result).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                title: '新建笔记',
+                created_at: '6 分钟前',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'studio-list',
+            },
+        ]);
+    });
+});

package/dist/clis/notebooklm/notes-get.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/notebooklm/notes-get.js

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import { ensureNotebooklmNotebookBinding, findNotebooklmNoteRow, getNotebooklmPageState, listNotebooklmNotesFromPage, readNotebooklmVisibleNoteFromPage, requireNotebooklmSession, } from './utils.js';
+function matchesNoteTitle(title, query) {
+    const needle = query.trim().toLowerCase();
+    if (!needle)
+        return false;
+    const normalized = title.trim().toLowerCase();
+    return normalized === needle || normalized.includes(needle);
+}
+cli({
+    site: NOTEBOOKLM_SITE,
+    name: 'notes-get',
+    description: 'Get one note from the current NotebookLM notebook by title from the visible note editor',
+    domain: NOTEBOOKLM_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'note',
+            positional: true,
+            required: true,
+            help: 'Note title or id from the current notebook',
+        },
+    ],
+    columns: ['title', 'content', 'source', 'url'],
+    func: async (page, kwargs) => {
+        await ensureNotebooklmNotebookBinding(page);
+        await requireNotebooklmSession(page);
+        const state = await getNotebooklmPageState(page);
+        if (state.kind !== 'notebook') {
+            throw new EmptyResultError('opencli notebooklm notes-get', 'Open a specific NotebookLM notebook tab first, then retry.');
+        }
+        const query = typeof kwargs.note === 'string' ? kwargs.note : String(kwargs.note ?? '');
+        const visible = await readNotebooklmVisibleNoteFromPage(page);
+        if (visible && matchesNoteTitle(visible.title, query))
+            return [visible];
+        const rows = await listNotebooklmNotesFromPage(page);
+        const listed = findNotebooklmNoteRow(rows, query);
+        if (listed) {
+            throw new EmptyResultError('opencli notebooklm notes-get', `Note "${query}" is listed in Studio, but opencli currently reads note content only from the visible note editor. Open that note in NotebookLM, then retry.`);
+        }
+        throw new EmptyResultError('opencli notebooklm notes-get', `Note "${query}" was not found in the current notebook.`);
+    },
+});

package/dist/clis/notebooklm/notes-get.test.d.ts

@@ -0,0 +1 @@
+import './notes-get.js';

package/dist/clis/notebooklm/notes-get.test.js

@@ -0,0 +1,72 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockListNotebooklmNotesFromPage, mockReadNotebooklmVisibleNoteFromPage, mockGetNotebooklmPageState, mockRequireNotebooklmSession, } = vi.hoisted(() => ({
+    mockListNotebooklmNotesFromPage: vi.fn(),
+    mockReadNotebooklmVisibleNoteFromPage: vi.fn(),
+    mockGetNotebooklmPageState: vi.fn(),
+    mockRequireNotebooklmSession: vi.fn(),
+}));
+vi.mock('./utils.js', async () => {
+    const actual = await vi.importActual('./utils.js');
+    return {
+        ...actual,
+        listNotebooklmNotesFromPage: mockListNotebooklmNotesFromPage,
+        readNotebooklmVisibleNoteFromPage: mockReadNotebooklmVisibleNoteFromPage,
+        getNotebooklmPageState: mockGetNotebooklmPageState,
+        requireNotebooklmSession: mockRequireNotebooklmSession,
+    };
+});
+import { getRegistry } from '../../registry.js';
+import './notes-get.js';
+describe('notebooklm notes-get', () => {
+    const command = getRegistry().get('notebooklm/notes-get');
+    beforeEach(() => {
+        mockListNotebooklmNotesFromPage.mockReset();
+        mockReadNotebooklmVisibleNoteFromPage.mockReset();
+        mockGetNotebooklmPageState.mockReset();
+        mockRequireNotebooklmSession.mockReset();
+        mockRequireNotebooklmSession.mockResolvedValue(undefined);
+        mockGetNotebooklmPageState.mockResolvedValue({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Browser Automation',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 1,
+        });
+    });
+    it('returns the currently visible note editor content when the title matches', async () => {
+        mockReadNotebooklmVisibleNoteFromPage.mockResolvedValue({
+            notebook_id: 'nb-demo',
+            title: '新建笔记',
+            content: '第一段\\n第二段',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'studio-editor',
+        });
+        const result = await command.func({}, { note: '新建笔记' });
+        expect(result).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                title: '新建笔记',
+                content: '第一段\\n第二段',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'studio-editor',
+            },
+        ]);
+    });
+    it('explains the current visible-note limitation when the target note is listed but not open', async () => {
+        mockReadNotebooklmVisibleNoteFromPage.mockResolvedValue(null);
+        mockListNotebooklmNotesFromPage.mockResolvedValue([
+            {
+                notebook_id: 'nb-demo',
+                title: '新建笔记',
+                created_at: '6 分钟前',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'studio-list',
+            },
+        ]);
+        await expect(command.func({}, { note: '新建笔记' })).rejects.toMatchObject({
+            hint: expect.stringMatching(/currently reads note content only from the visible note editor/i),
+        });
+    });
+});

package/dist/clis/notebooklm/rpc.d.ts

@@ -0,0 +1,36 @@
+import type { IPage } from '../../types.js';
+export type NotebooklmPageAuth = {
+    csrfToken: string;
+    sessionId: string;
+    sourcePath: string;
+};
+export type NotebooklmFetchResponse = {
+    ok: boolean;
+    status: number;
+    body: string;
+    finalUrl: string;
+};
+export type NotebooklmRpcCallResult = {
+    auth: NotebooklmPageAuth;
+    url: string;
+    requestBody: string;
+    response: NotebooklmFetchResponse;
+    result: unknown;
+};
+export declare function extractNotebooklmPageAuthFromHtml(html: string, sourcePath?: string, preferredTokens?: {
+    csrfToken?: string;
+    sessionId?: string;
+}): NotebooklmPageAuth;
+export declare function getNotebooklmPageAuth(page: IPage): Promise<NotebooklmPageAuth>;
+export declare function buildNotebooklmRpcBody(rpcId: string, params: unknown[] | Record<string, unknown> | null, csrfToken: string): string;
+export declare function stripNotebooklmAntiXssi(rawBody: string): string;
+export declare function parseNotebooklmChunkedResponse(rawBody: string): unknown[];
+export declare function extractNotebooklmRpcResult(rawBody: string, rpcId: string): unknown;
+export declare function fetchNotebooklmInPage(page: IPage, url: string, options?: {
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: string;
+}): Promise<NotebooklmFetchResponse>;
+export declare function callNotebooklmRpc(page: IPage, rpcId: string, params: unknown[] | Record<string, unknown> | null, options?: {
+    hl?: string;
+}): Promise<NotebooklmRpcCallResult>;